entity

Der entity:-Namespace versammelt alle Kommandos, die einzelne Entitäten innerhalb eines Vaults anfassen: anlegen, anzeigen, suchen, umbenennen, bearbeiten, Beziehungen setzen und lösen, importieren, löschen. Operationen, die den Vault als Ganzes betreffen, liegen im vault:-Namespace.

Verfügbare Kommandos

• entity new — eine neue Entität anlegen (interaktiv mit geführtem Fragebogen oder nicht-interaktiv per Flags).
• entity list — Entitäten eines Vaults tabellarisch auflisten mit Filtern für Typ, Tag und Volltext-Suche.
• entity show — eine einzelne Entität formatiert ausgeben: Metadaten-Header, Repräsentationen, externe Verweise, Body-Preview oder vollständig.
• entity search — Volltextsuche im Standard­modus, Bedeutungssuche mit --semantic, kombinierte Suche mit --hybrid.
• entity similar — Notizen finden, die thematisch zu einer Referenz-Entität passen.
• entity rename — Titel und Slug einer Entität ändern; der Dateiname folgt, die NanoID bleibt stabil.
• entity edit — den Fließtext einer Entität bearbeiten (interaktiv im $EDITOR oder per Flags); Frontmatter bleibt unberührt.
• entity meta — Frontmatter bearbeiten (geführter Walkthrough, Flags oder roher YAML-Editor); Body bleibt unberührt.
• entity attach — Binärdateien als Repräsentationen an eine bestehende Entität hängen; das nachträgliche Gegenstück zu entity new --attach.
• entity external — einen externen URL-Verweis an eine bestehende Entität hängen.
• entity detach — eine Repräsentation oder einen externen Verweis aus einer Entität entfernen; die Binärdatei bleibt stehen.
• entity link — eine typisierte Beziehung von einer Entität zu einer anderen setzen (works_at, knows, …); Relations-Name wird gegen den Vault-Katalog konsolidiert.
• entity unlink — einzelne Kante wieder entfernen; disambiguiert automatisch oder interaktiv, wenn mehrere Relations auf dasselbe Ziel zeigen.
• entity import — eine externe Markdown-Datei aufnehmen oder eine irreguläre Datei im Vault (defektes Frontmatter, falscher Dateiname) sanieren; ein gemeinsamer Walkthrough für beide Fälle.
• entity delete — eine Entität per Soft-Delete in den Vault-Trash verschieben; reversibel bis vault trash empty.

Was zu Entitäten gehört

Eine Entität ist eine Markdown-Datei mit YAML-Frontmatter im content/-Verzeichnis des Vaults — die kleinste eigenständige Informations­einheit. Details zum Modell: Grundbegriffe — Entität.

Alle Entity-Kommandos operieren auf einem konkreten Vault. Ohne --vault lokalisiert Apparat ihn automatisch (aktuelles Arbeitsverzeichnis → einziger registrierter Vault → interaktive Auswahl), mit --vault übersteuerst du diese Auflösung — siehe jeweilige Kommando-Seite.

Was die Entitäts-Kommandos zusätzlich nutzen

Beim Umbenennen einer Entität schreibt Apparat eingehende Links in anderen Notizen aktiv mit um. Beim Konsistenz-Check (vault validate) zeigen sich Asset-Dateien, die in assets/ liegen, aber nirgends mehr verwendet werden. Beides setzt voraus, dass der Beziehungs-Graph aktuell ist — bei normalem Arbeiten passiert das automatisch.