vault doctor

Prüft die Konfigurationsdateien deiner Sammlungen auf Beschädigung und stellt sie aus einer automatischen Sicherung wieder her. Gedacht für den Fall „meine Sammlung startet plötzlich nicht mehr": Wenn eine Konfigurationsdatei durch einen externen Editor, einen Sync-Konflikt oder einen Speicherfehler unlesbar geworden ist, meldet sich sonst jeder Befehl und jede Web-Seite mit einer Fehlermeldung. vault doctor ist die eine Stelle, an der sich das gezielt beheben lässt.

Es arbeitet eine Ebene unter vault validate und vault repair: Die beiden prüfen und reparieren die Inhalte einer Sammlung — doctor kümmert sich um die Konfiguration, ohne die eine Sammlung gar nicht erst geladen werden kann.

Prüfen

apparat vault doctor

Wenn alles in Ordnung ist:

✅ All vault configuration files are intact.

Wenn eine Datei beschädigt ist:

⚠ Found 1 corrupt configuration file(s):
  [vault manifest] /pfad/zur/sammlung/.apparat/manifest.json
    Vault manifest at "…/manifest.json" is not valid JSON: Syntax error
    Backup available for restore.

⚠ Re-run with --restore to restore 1 file(s) from backup.

Zu jeder beschädigten Datei steht die genaue Ursache und ob eine Sicherung zur Wiederherstellung bereitliegt. Der Befehl endet mit Exit-Code 1, solange ein Defekt besteht — so lässt sich der Zustand skriptgesteuert abfragen.

Wiederherstellen: `--restore`

apparat vault doctor --restore

Restored /pfad/zur/sammlung/.apparat/manifest.json (vault manifest) from backup.

✅ Restored 1 configuration file(s) from backup. Re-run `apparat vault doctor` to confirm.

Jede beschädigte Datei, für die eine Sicherung existiert, wird aus dieser zurückgeschrieben. Dateien ohne Sicherung bleiben unangetastet und werden weiterhin gemeldet — der Befehl täuscht nie eine Reparatur vor, die er nicht durchführen konnte. Prüfe nach dem Wiederherstellen mit einem erneuten apparat vault doctor, dass nichts übrig geblieben ist.

Was geprüft wird

Das Manifest jeder registrierten Sammlung — die kleine Datei mit der kanonischen URL und dem Namen der Sammlung.
Die Mount-Registry — die Zuordnung von Sammlungs-URLs zu lokalen Pfaden. Ist diese beschädigt, ist gar keine Sammlung mehr auffindbar; deshalb wird sie zuerst geprüft und, wenn defekt, allein gemeldet.

Fehlende Dateien sind kein Fall für doctor — es geht ausschließlich um Dateien, die vorhanden, aber unlesbar sind. Eine ganz fehlende Sammlung meldet vault list.

Woher die Sicherung kommt

Bei jeder Änderung an einer dieser Konfigurationsdateien legt Apparat automatisch eine Sicherung der vorherigen Fassung daneben (eine .bak-Datei). Es wird immer genau die letzte gute Fassung aufbewahrt — kein Archiv über mehrere Stände, sondern der eine Zustand, der zum Wiederherstellen gebraucht wird. Deshalb funktioniert --restore nur für Dateien, die seit ihrer Anlage mindestens einmal geändert wurden; eine frisch angelegte, noch nie geänderte Datei hat noch keine Sicherung.

Zusammenspiel mit dem Web-Hinweis