vault rename

Ändert den Anzeigenamen einer Sammlung — den Namen, der in vault list, im Sammlungs-Wähler der Web-Oberfläche und in Meldungen der Kommandos auftaucht. Nützlich, wenn der Name aus der Anlage nicht mehr passt: aus „recherche" wird „Recherche 2026", aus dem hastigen Arbeitstitel der Name, unter dem du die Sammlung wirklich kennst.

Grundaufruf

apparat vault rename "Recherche 2026" --vault recherche

Beispiel-Ausgabe:

✅ Vault renamed from "recherche" to "Recherche 2026"
  Path: /home/max/vaults/recherche
  URL:  https://apparat.example.com/vaults/recherche

Ohne --vault nimmt Apparat die Sammlung, in deren Verzeichnis du gerade stehst; gibt es nur eine einzige registrierte Sammlung, wird sie genommen. Sonst fragt Apparat interaktiv nach — dieselbe Auflösung wie bei vault validate und vault repair.

Der Name ist frei: Leerzeichen, Umlaute und Satzzeichen sind erlaubt, führende und folgende Leerzeichen werden abgeschnitten. Nur leer darf er nicht sein.

Anzeigename und Identität

Eine Sammlung hat zwei Namen, und nur einer davon ist frei:

• Der Anzeigename steht im Manifest und darf sich jederzeit ändern. Genau ihn schreibt dieses Kommando.
• Der Verzeichnisname ist die Identität der Sammlung: er steckt im Pfad auf der Platte, in der abgeleiteten URL und in der Web-Adresse — und bleibt beim Umbenennen unverändert.

Das Umbenennen fasst allein den Anzeigenamen an; die URL (an ihr hängen Verweise aus anderen Sammlungen), das Anlage-Datum und sämtliche Inhalte bleiben, wie sie sind, und die Mount-Registry führt sich über URL und Pfad, nicht über den Anzeigenamen — sie braucht also kein Update.

Verzeichnisnamen oder URL zu wechseln ist kein Umbenennen, sondern ein Umzug: die Sammlung abmelden, auf der Platte verschieben und neu registrieren.

Fehler

• „Vault name must not be empty" — der übergebene Name besteht nur aus Leerzeichen.
• „No vault found at path …" — --vault zeigt auf ein Verzeichnis, in dem keine Sammlung liegt. vault list zeigt, was registriert ist.
• „Multiple vaults registered; pass --vault explicitly in non-interactive mode" — im Skript-Betrieb kann Apparat nicht nachfragen; gib die Sammlung explizit an.

Verwandte Kommandos

• vault list — zeigt die Anzeigenamen aller registrierten Sammlungen.
• vault init — legt eine Sammlung an; dort wird der Name zum ersten Mal gesetzt (--name).
• vault unregister — meldet eine Sammlung ab, ohne ihre Dateien anzutasten.