vault register

Nimmt einen bereits bestehenden Vault-Ordner in die Mount-Registry auf, ohne das Manifest neu zu schreiben. Gedacht für Vaults, die auf dem System schon existieren — aus git clone, aus einem Backup, manuell kopiert — und deren kanonische URL aus dem Manifest selbst kommen soll.

Grundaufruf

apparat vault register ~/vaults/recherche

Apparat liest ~/vaults/recherche/.apparat/manifest.json, extrahiert die url daraus und fügt sie zusammen mit dem Pfad in die Registry ein.

Beispiel-Ausgabe:

 Registered vault "recherche" in the mount registry.
  URL:      https://apparat.example.com/vaults/recherche
  Path:     /home/max/vaults/recherche
  Registry: /home/max/.config/apparat/mounts.yaml

Abgrenzung zu vault init

• vault init erzeugt einen neuen Vault: legt content/, assets/, .apparat/ an, schreibt ein frisches Manifest mit neuer URL und trägt den Eintrag in der Registry ein. Für einen schon existierenden Ordner mit Manifest würde das dessen URL überschreiben — genau der falsche Effekt.
• vault register geht davon aus, dass der Ordner bereits ein gültiges Manifest trägt. Es wird nichts am Ordnerinhalt geändert, nur die Registry-Datei wird erweitert. Die kanonische URL bleibt wie im Manifest hinterlegt.

Typisches Szenario: auf dem neuen Laptop installierst du Apparat, klonst einen existierenden Vault-Ordner per git clone, und bindest ihn per vault register an.

Fehler

• „Vault path must not be empty" — das positionale Argument fehlt oder ist leer.
• „Vault path "…" does not exist" — der übergebene Pfad zeigt ins Leere.
• „Vault manifest not found at "…"" — im angegebenen Ordner gibt es kein .apparat/manifest.json. Prüfe, ob du den richtigen Vault-Root übergeben hast (nicht content/ oder ein Unter­verzeichnis).
• „Mount registry already contains URL "…"" — die URL aus dem Manifest ist bereits in der Registry registriert (evtl. zeigt der alte Eintrag auf einen anderen Pfad). Entferne den Alt-Eintrag mit vault unregister, bevor du den neuen Pfad registrierst.
• „Vault manifest at "…": field "url" must be a non-empty string" — das Manifest ist defekt. Repariere es (z.B. per Texteditor) oder, wenn du den Vault neu aufsetzen willst, benutze vault init in einem frischen Verzeichnis.

Verwandte Kommandos

• vault list — zeigt alle registrierten Vaults samt Status.
• vault unregister — Gegenstück: Eintrag ohne Dateien-Löschung aus der Registry nehmen.