vault repair

Behebt die mechanisch sicher reparierbaren Befunde eines Vaults — und ausschließlich diese. Alles, was sich nicht eindeutig und verlustfrei automatisch lösen lässt, wird gemeldet und unangetastet gelassen. Das Gegenstück zu vault validate: validate zeigt alle Befunde, repair räumt den sicheren Teil davon weg.

Einfachster Fall

apparat vault repair

Wenn es nichts mechanisch Reparierbares gibt:

✅ Vault "recherche" has no mechanically repairable findings.

Wenn etwas behoben wurde:

Cleared 1 stale journal entry:
  - soft_delete-20260419T…-Zzzz0000
Backfilled 2 missing sidecars:
  - 2026-04-12--screenshot--Az3kLm9p.png
  - 2026-04-18--diagramm--Bx4kLm9p.png
Rebuilt the graph index to recompute the sidecars.

✅ Repaired 3 finding(s) in vault "recherche". Run `apparat vault validate` to confirm.

Was repair anfasst

Nur die Klassen, deren Behebung deterministisch und ohne Informationsverlust ist:

• Abgelaufene Journal-Einträge einer längst beendeten Operation (älter als das 24-Stunden-Wiederherstellungsfenster) werden entfernt — der Markdown-Bestand ist die Quelle der Wahrheit, der abgeleitete Index wird ohnehin neu aufgebaut.
• Verwaiste Prüfsummen-Dateien (eine .sha256 ohne zugehörige Datei) werden gelöscht.
• Fehlende Prüfsummen werden neu berechnet, kaputte neu geschrieben — über einen Graph-Neuaufbau.

Schema-Fehler, kaputte Verweise, ein Prüfsummen-Konflikt (die gespeicherte Prüfsumme passt nicht mehr zum Datei-Inhalt) und Konfigurationsdefekte bleiben gemeldet, aber unberührt: Ein Schema-Fix ist nicht erratbar, ein Verweis-Fix eine inhaltliche Entscheidung, und eine automatische Neuberechnung eines abweichenden Prüfsummen-Werts würde eine mögliche Datenbeschädigung stillschweigend überdecken. Diese Befunde listet repair am Ende unter „Left untouched" auf, damit nie der falsche Eindruck entsteht, alles sei sauber.

Trockenlauf: --dry-run

Zeigt, was repair täte, ohne etwas zu ändern:

apparat vault repair --dry-run

Would clear 1 stale journal entry:
  - soft_delete-20260419T…-Zzzz0000

⚠ Dry run — 1 finding(s) would be repaired in vault "recherche". Re-run without --dry-run to apply.

Zusammenspiel mit dem Web-Hinweis

Im Web macht die Oberfläche nur aufmerksam: Sobald in einer Sammlung ein strukturelles Problem gefunden wurde, hebt sich der Menüpunkt Aufräumen hervor (samt Anzahl der Probleme), und im Aufräumen-Bereich erscheint ein auffälliger Hinweis, auf der Kommandozeile zu analysieren und zu reparieren. Der eigentliche Eingriff passiert hier — mit vault validate zum Ansehen und vault repair zum Beheben des sicheren Teils.