asset delete

Löscht ein verwaistes Asset — eine Binärdatei, auf die keine Entität mehr verweist — in den Papierkorb. Die Datei wandert aus assets/ nach .apparat/trash/ und lässt sich von dort jederzeit wiederherstellen, solange der Papierkorb nicht geleert wurde.

Ein Asset gilt als verwaist, sobald die letzte Entität aufhört, es zu referenzieren — weder als Body-Einbettung (![Alt](../assets/...)) noch als representations:-Eintrag im Frontmatter. Genau diese Waisen meldet auch vault validate; asset delete ist der Weg, sie aufzuräumen.

Einfachster Fall

apparat asset delete Orph0123

Apparat sucht im aktiven Vault das Asset mit dieser NanoID, prüft, dass keine Entität es mehr referenziert, fragt nach Bestätigung und verschiebt die Datei in den Papierkorb. Die .sha256-Prüfsummen-Beilage der Datei wandert automatisch mit. Bestätigungszeile nach Erfolg:

Moved asset Orph0123 to trash in vault "recherche".
  Trash file: /home/max/vaults/recherche/.apparat/trash/2026-04-19--altes-foto--Orph0123.png
  Restore later via `apparat vault trash-restore <id>`.

Nur verwaiste Assets

Solange noch eine Entität das Asset einbindet, wird das Löschen verweigert:

Asset Asset0aB is still referenced by 2 entities — detach those references before deleting it.

Das ist Absicht: Anders als beim Löschen einer Entität gibt es für Assets keine Aufräum-Kaskade, die hängende Verweise mitnimmt. Wer das Asset trotzdem loswerden will, löst zuerst die Verknüpfungen — etwa per entity detach oder durch Bearbeiten der einbindenden Entität — und ruft asset delete danach erneut auf.

Bestätigung und Skript-Betrieb

Im interaktiven Betrieb fragt Apparat vor dem Verschieben nach. Für Skripte überspringt --force die Rückfrage:

apparat asset delete Orph0123 --force

Ohne Terminal (etwa in einer Pipeline) und ohne --force bricht das Kommando bewusst ab — unbeaufsichtigtes Löschen ist immer ausdrücklich anzufordern.

Wiederherstellen und endgültig entfernen

Der Papierkorb ist die Sicherheitsleine: ein versehentlich gelöschtes Asset holt vault trash-restore an seinen alten Platz in assets/ zurück, vault trash-list zeigt den Papierkorb-Inhalt (Entitäten wie Assets), und vault trash-empty entfernt Einträge endgültig.

Vault-Auswahl

Wie bei allen Kommandos: ohne --vault greift die übliche Auto-Lokalisierung (CWD-Erkennung, einziger registrierter Vault, interaktive Auswahl). Explizit:

apparat asset delete Orph0123 --vault=recherche
apparat asset delete Orph0123 --vault=/home/max/vaults/recherche

Fehler