graph stats
graph stats zeigt eine Ein-Bildschirm-Zusammenfassung des Graph-Index: wie viele Entitäten und Assets liegen darin, wie ist die Typ-Verteilung, welche Relationen kommen wie oft vor und wie groß ist die SQLite-Datei. Reine Leseabfrage — keine Seiteneffekte, keine Dateimutation, kein Rebuild.
Wofür ist das?
Zwei Szenarien nutzen das Kommando regelmäßig:
- Vault-Diagnostik — „wie groß ist mein Vault wirklich geworden?". Eine kurze Zahl nach einer großen Import-Aktion oder nach dem ersten
graph rebuildgibt sofort einen Eindruck, ob die Zahl plausibel ist. - Type- und Relations-Drift — wenn die Typ-Tabelle
personUNDPersonzeigt, oderworks_atUNDemployed_at, weißt du sofort, dass die Konsolidierung auf dieses Feld gleich laufen sollte.
Aufruf
apparat graph stats
Ohne --vault gilt die gewohnte Vault-Auflösung (CWD, einziger registrierter Vault, sonst interaktive Auswahl). Der Graph-Index wird bei Bedarf lazy geöffnet; wenn die Datei noch nicht existiert (Vault wurde nie gerebuilt), zeigt das Kommando alle Zählungen mit Null.
Beispielausgabe
Vault "recherche" — graph statistics: Entities: 128 Assets: 37 Edges: 412 Entity types: person 64 project 22 conference 14 document 12 concept 16 Relations: references 201 embeds 88 works_at 42 knows 28 talks_about 53 Graph file: .apparat/graph.sqlite (2.3 MB)
Typ- und Relations-Blöcke sind nach Count absteigend sortiert (bei Gleichstand alphabetisch), damit die interessanten Zeilen zuerst kommen. Die Dateigröße ist die reine SQLite-Datei — Kanten, Knoten, FTS-Index und Statistik-Tabellen zusammen.
Optionen
| Option | Bedeutung |
|---|---|
| `--vault=<name | url |
Exit-Codes
| Code | Bedeutung |
|---|---|
| 0 | Statistik ausgegeben. |
| 1 | Vault-Auflösung oder Graph-Öffnen schlug fehl. |
Verwandte Aufgaben
graph stats liefert reine Lese-Statistik aus dem Graph. Wenn die Zahlen zu niedrig wirken (du hast gerade 20 Entitäten importiert, der Graph zeigt 5), bringst du ihn mit graph rebuild auf Stand — oder lässt die Dateibeobachtung laufen. Verwaiste Verlinkungen oder andere Konsistenzprobleme zeigt vault validate.