asset rename

Benennt eine Asset-Datei um: ein neuer Slug wandert in den Dateinamen, alle Entitäten, die das Asset referenzieren, werden mitgezogen. Datumspräfix, NanoID und Dateiendung bleiben unverändert.

Die NanoID ist die stabile Identität eines Assets und ändert sich nie — der Rename fasst ausschließlich die lesbare Kosmetik an.

Einfachster Fall

apparat asset rename Ab123456 gespraech-max-mustermann

Apparat sucht im aktiven Vault die Asset-Datei mit dieser NanoID, berechnet den neuen Dateinamen und führt den Rename aus. Bestätigungszeile nach Erfolg:

Renamed asset "Ab123456" in vault "recherche":
  old: assets/2024-11-03--interview-max--Ab123456.mp3
  new: assets/2024-11-03--gespraech-max-mustermann--Ab123456.mp3

Wird das Asset in Entitäten referenziert (Body-Einbettungen wie ![Alt](../assets/<basename>) oder representations:-Einträge im Frontmatter), meldet Apparat die betroffenen Dateien:

  rewritten linkers: 2
    - content/2024-11-03--foto-notiz--Ll123456.md
    - content/2024-11-03--interview-max--Mx123456.md

Die Umschrift läuft im selben Journal wie entity rename: bricht der Rename mitten in der Propagation ab (Stromausfall, Ctrl-C), setzt der nächste apparat-Aufruf den Sweep automatisch dort fort, wo er aufgehört hat.

Was der Slug ist

Der Slug ist der Teil zwischen Datumspräfix und NanoID im Dateinamen. Apparat normalisiert ihn nach denselben Regeln wie bei entity new:

• Kleinschreibung, Umlaute transliteriert (ä → ae, ß → ss),
• Leerzeichen und Sonderzeichen zu Bindestrichen,
• maximal 60 Zeichen, an Wortgrenzen abgeschnitten.

Ein bereits sauberer Slug wandert unverändert durch. Wenn die Normalisierung denselben Slug ergibt wie der aktuelle, bleibt die Datei unberührt und Apparat meldet:

Asset "Ab123456" already carries the requested slug — nothing to do.

Vault-Auswahl

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

apparat asset rename Ab123456 aufnahme --vault=recherche
apparat asset rename Ab123456 aufnahme --vault=/home/max/vaults/recherche

Wirkungs­bereich

Der Rename fasst ausschließlich den Slug-Anteil des Dateinamens an. NanoID, Datum und Datei-Endung bleiben gleich; eine andere Endung erreichst du über einen neuen Import mit anschließendem entity detach, nicht über asset rename. Der Inhalt der Binärdatei bleibt bit-identisch — die Datei wird atomar an ihren neuen Pfad bewegt. Apparat schreibt ausschließlich in Dateien des Vault-content/-Verzeichnisses; externe Notizen, Build-Artefakte oder Backups bleiben unberührt.

Fehler

• „Asset id "…" is not a valid NanoId." — das übergebene ID-Argument hat nicht das NanoID-Format [A-Za-z0-9]{8}.
• „No asset with id "…" in vault "…"." — kein Asset mit dieser NanoID im Vault gefunden. Prüfe per ls assets/, ob die ID stimmt.
• „Multiple assets with id "…"." — seltener Rand­fall: zwei Asset-Dateien tragen dieselbe NanoID. Das darf nicht sein; korrigiere den Konflikt per Hand (eine Datei umbenennen oder löschen) und wiederhole den Aufruf.
• „Asset filename "…" does not match the schema YYYY-MM-DD--slug--nanoid.ext." — die aktuell vorhandene Datei folgt nicht der erwarteten Namens­konvention. Per vault validate prüfbar.
• „Asset slug "…" normalises to an empty value." — der übergebene Slug-String enthielt nur Zeichen, die beim Normalisieren wegfallen (z.B. reine Satzzeichen). Tippe einen nicht-leeren Slug.
• „Target filename "…" already exists in vault "…"." — im gleichen Datum/mit gleicher NanoID existiert bereits eine Datei mit dem Ziel-Slug. Sehr unwahrscheinlicher Rand­fall; ein kurzer Blick ins Verzeichnis klärt auf.