asset

Der asset:-Namespace versammelt die Kommandos, mit denen du Asset-Dateien in einem Vault direkt ansprichst — Binärdateien unter assets/, die als Beilage zu Entitäten leben (Fotos, Audio, Video, PDF). Sie tauchen in zwei Rollen auf: als formale Repräsentation im Frontmatter (representations:) oder als Body-Einbettung im Fließtext einer Entität (![alt](../assets/...)). Beide Rollen verwenden dieselben Asset-Dateien, unterscheiden sich aber im Werkzeug-Pfad.

Grundgedanke

Apparat behandelt Assets als zweitrangig gegenüber Entitäten: Sie tragen keine eigenständigen Metadaten — weder Tags noch Beziehungen noch Beschreibungen. Ihre gesamte Bedeutung bekommen sie über die Entitäten, die auf sie verweisen. Der Dateiname folgt derselben Konvention wie bei Entitäten: YYYY-MM-DD--slug--nanoid.<ext>.

Ein Rename ändert nur den Slug-Teil; das Datumspräfix und vor allem die NanoID bleiben unverändert. Damit bleibt die Asset-Identität über seine gesamte Lebenszeit stabil, während sein lesbarer Name ergonomisch anpassbar ist.

Verfügbare Kommandos

• asset embed — eine Datei in assets/ importieren und den fertigen Markdown-Einbettungs­ausdruck (![alt](../assets/...)) auf stdout schreiben. Gedacht für Bilder, Videos oder PDFs, die im Fließtext einer Entität auftauchen sollen, statt als formale Repräsentation.
• asset rename — den Slug einer Asset-Datei ändern. Sämtliche Entitäten, die das Asset als Body-Einbettung oder representations-Eintrag referenzieren, werden im selben Journal-Schritt mitgezogen.
• asset delete — ein verwaistes Asset (auf das keine Entität mehr verweist) in den Papierkorb verschieben. Referenzierte Assets werden abgelehnt; wiederherstellbar über den Papierkorb.

Wo verwandte Aktionen leben

• Repräsentationen anhängen (Asset gehört formal zur Entität, taucht im Frontmatter unter representations: auf) läuft über entity attach. asset embed ist das Pendant für den anderen Fall — Asset als illustrierende Beilage im Fließtext.
• Asset-Referenzen lösen geschieht über entity detach. Sobald die letzte Entität aufhört, ein Asset zu referenzieren, gilt es als „verwaist", wird beim nächsten vault validate gemeldet und lässt sich per asset delete in den Papierkorb räumen.
• Asset-Metadaten wohnen auf den Entitäten. Wer die Beschreibung eines Fotos ändern will, bearbeitet die Entität, die es trägt — das Asset selbst trägt keine eigenen Metadaten.