vault

Der vault:-Namespace versammelt alle Kommandos, die einen Vault als Ganzes betreffen: anlegen, registrieren, prüfen, nicht-konforme Dateien listen, Trash verwalten. Operationen auf einzelnen Entitäten innerhalb eines Vaults liegen im entity:-Namespace.

Verfügbare Kommandos

• vault init — einen neuen Vault anlegen: Verzeichnisstruktur (content/, assets/, .apparat/), Manifest, Registrierung in der Mount-Registry.
• vault list — alle registrierten Vaults auflisten mit Status-Probe (ok / missing / mismatched); optional --json.
• vault register — einen bestehenden Vault-Ordner (z.B. aus git clone) in die Mount-Registry aufnehmen, ohne das Manifest neu zu schreiben.
• vault unregister — einen Registry-Eintrag entfernen, ohne die Vault-Dateien anzutasten; Identifier ist URL oder Pfad.
• vault validate — einen Vault gegen die Spec prüfen: harte Pflichtfeld-Fehler und Konventionsbrüche unterscheiden; Exit-Codes 0/1/2 für CI; optional --json für maschinenlesbare Ausgabe.
• vault repair — den mechanisch sicher reparierbaren Teil der validate-Befunde beheben (abgelaufene Journale, Prüfsummen-Dateien); der Rest bleibt gemeldet, aber unberührt. Mit --dry-run nur anzeigen.
• vault scan — alle registrierten Vaults im Hintergrund prüfen und den Zustand je Vault festhalten; speist den passiven Integritäts-Hinweis der Web-Oberfläche.
• vault doctor — beschädigte Konfigurationsdateien (Manifest, Mount-Registry) erkennen und aus ihrer automatischen Sicherung wiederherstellen. Die Ebene unter validate/repair: für den Fall „meine Sammlung startet nicht mehr".
• vault irregular — nicht-konforme Dateien im Vault anzeigen: Entitäten ohne NanoID-Suffix, mit defektem Frontmatter oder fehlenden Pflichtfeldern, plus Assets mit falschem Dateinamen. Die schnelle Arbeitsliste für „was muss ich sanieren?".
• vault trash list — den Trash eines Vaults tabellarisch auflisten: welche Entitäten sind soft-gelöscht, wann wurden sie entfernt.
• vault trash restore — eine soft-gelöschte Entität aus dem Trash zurück nach content/ holen.
• vault trash empty — einen oder alle Trash-Einträge endgültig entfernen und Tombstones für die betroffenen NanoIDs schreiben.

Was zu Vaults gehört

Ein Vault ist der eigenständige Wissensraum — Verzeichnisstruktur, Manifest mit kanonischer URL, und ein Eintrag in der Mount-Registry, der Vault-URL auf lokalen Pfad abbildet. Details zum Modell findest du in Grundbegriffe — Vault.

Im Alltag greift --vault in den Kommandos dieses Namespace entweder auf diese Registry (per URL oder Name) oder direkt auf einen Pfad im Dateisystem zurück. Die Auflösungsreihenfolge ist in jedem Kommando gleich und dort beschrieben.