vault unregister

Entfernt einen Eintrag aus der Mount-Registry, ohne das Vault-Verzeichnis auf der Festplatte anzutasten. Nützlich, wenn ein Vault umgezogen ist (alter Pfad soll weg), beendet wurde, oder wenn die Registry beim manuellen Editieren durcheinander geraten ist.

Grundaufruf

Per URL:

apparat vault unregister https://apparat.example.com/vaults/recherche

Per lokalem Pfad:

apparat vault unregister /home/max/vaults/recherche

Per Vault-Name (aus dem Manifest):

apparat vault unregister recherche

Beispiel-Ausgabe:

✅ Unregistered vault from the mount registry.
  URL:      https://apparat.example.com/vaults/recherche
  Path:     /home/max/vaults/recherche
  Registry: /home/max/.config/apparat/mounts.yaml
  The vault directory on disk was not touched.

Apparat versucht zunächst, den Identifier als URL zu interpretieren (canonical-tolerant: Groß-/Kleinschreibung von Scheme und Host, Trailing-Slashes etc.). Schlägt das fehl, wird er als Dateisystempfad aufgelöst und gegen die path-Felder der registrierten Einträge verglichen (mit realpath(), falls er auf der Platte existiert). Erst danach kommt der Vault-Name (name aus dem Manifest) als letzte Variante zum Zug — dazu liest Apparat die Manifeste der noch lebenden Einträge ein. Verwaiste Einträge (deren Vault-Verzeichnis verschwunden ist) bleiben damit weiterhin nur per URL oder Pfad löschbar, weil ihr Name nicht mehr ablesbar ist.

Wirkungs­bereich auf der Platte

• Die Vault-Dateien bleiben vollständig liegen. content/, assets/, .apparat/ werden nicht angefasst, das Manifest nicht modifiziert.
• Andere Vaults bleiben unberührt. Selbst wenn mehrere Vaults unter verwandten URLs registriert wären, wird exakt der passende Eintrag entfernt.

Wenn du die Vault-Dateien wirklich loswerden willst, musst du sie im Anschluss manuell löschen (rm -rf …) — das ist Absicht, damit vault unregister nie unbeabsichtigt zerstörerisch wird.

Fehler

• „Vault identifier must not be empty" — das positionale Argument fehlt.
• „No registry entry matches "…" — neither by URL, path, nor vault name" — die Registry kennt diesen Identifier nicht. Überprüfe mit vault list, welche Einträge tatsächlich registriert sind.
• „Failed to write mount registry at "…"" — die Registry-Datei ist nicht schreibbar (Rechte-Problem, mount read-only). Der Eintrag bleibt drin, bis das Schreib­problem behoben ist.

Verwandte Kommandos

• vault list — zeigt, was aktuell registriert ist.
• vault register — Gegenstück zum Hinzufügen eines bestehenden Vault-Ordners.