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 Datei­mutation, kein Rebuild.

Wofür ist das?

Zwei Szenarien nutzen das Kommando regelmäßig:

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 Datei­größ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 Datei­beobachtung laufen. Verwaiste Verlinkungen oder andere Konsistenz­probleme zeigt vault validate.