chemenu/kb/concepts/problems/Write-Once Frontmatter Fields.md

type, concept_type, tags, created, modified, related, sources, provenance, summary

type	concept_type	tags	created	modified	related	sources	provenance	summary
types/concept.md	problem	wikitool frontmatter tooling idempotenz repair	2026-08-31	2026-08-31	exemplifies wikitool see-also Denylist over Allowlist see-also Detect-Repair Asymmetry see-also Diff-Reviewable Agent Edits see-also Command Round-Trip Integrity	Source - Conversation - Write-Once Frontmatter Fields and touch --set Session 2026-08-31 Source - Conversation - Two Round-Trip Defects Found by an Ingest Session 2026-08-31	sourced	Defektklasse, in der ein Feld nur beim Anlegen der Seite schreibbar ist und danach unerreichbar bleibt, weil kein Mutationsbefehl es kennt und new nicht idempotent ist

Write-Once Frontmatter Fields

Typ: Problem

Definition

Ein Write-Once-Feld ist ein Frontmatter-Feld, das der Anlegebefehl schreibt und danach kein Befehl mehr ändern kann. Es entsteht nicht durch eine Regel, sondern durch eine Lücke: das Schema deklariert das Feld, das Gerüst füllt es, und die Mutationsbefehle decken es nicht ab. Der Wert, den der erste Aufruf gesetzt hat, ist damit der endgültige.

Die drei Auswege, die einem Agenten dann bleiben, schließen sich gegenseitig aus. Handeditierung ist das, was der Stack verhindern soll. Die Seite zu löschen und neu anzulegen zerreißt jede Referenz, die schon auf sie zeigt - Wikilinks, Fußnoten-Zitate und die Referenz-Arrays anderer Seiten hängen am Titel. Und der Anlegebefehl selbst ist nicht idempotent, lässt sich also nicht einfach mit korrigierten Werten wiederholen. Das Fenster für den richtigen Wert ist genau einen Befehl breit¹ .

Kernpunkte

• Die Lücke ist eine Kombination, kein einzelner Defekt. Erst Schema plus fehlender Mutationsbefehl plus nicht-idempotentes new plus Referenzbindung an den Titel machen einen Tippfehler dauerhaft. Jede dieser Eigenschaften für sich ist harmlos.
• Sie trifft die Felder, die keiner Seite und keinem Seitentitel gehören. touch deckte die Felder ab, die die Seite selbst beschreiben (modified, summary, provenance, confidence_base), xref die Seiten-Referenz-Arrays. tags:, raw_files: und source_url: sind keines von beidem¹ .
• Der Beleg, dass es eine Rate ist und kein Unfall: drei Fehlschläge in drei aufeinanderfolgenden Ingests desselben Tages, an zwei verschiedenen Feldern, von drei verschiedenen Agenten. Einer davon war ein nachgestelltes Komma im --set tags=-Wert¹ .
• Der Fall, an dem es sichtbar wurde: Diff-Reviewable Agent Edits behielt nach einem solchen Ingest dauerhaft nur [agent-workflow]. Der zuständige Agent prüfte alle drei Auswege und verwarf jeden mit dem richtigen Grund - genau das Verhalten, das die Regeln verlangen, und genau der Punkt, an dem sie ohne Werkzeug in eine Sackgasse führen¹ .
• Geschlossen in Stack 1.4.0 (Commit dbe2f73) durch touch --set/--add/--remove: schreibbar ist, was das Schema des Seitentyps deklariert, abzüglich einer kurzen Sperrliste (siehe Denylist over Allowlist). --add und --remove arbeiten auf einzelnen Elementen eines Listenfelds, --remove gelingt auch bei einem nicht vorhandenen Element und meldet das - idempotent, weil ein Reparaturbefehl, der sich beim zweiten Lauf verweigert, nicht skriptbar ist, aber nie still, weil ein stiller No-op wie eine gelungene Entfernung aussieht¹ .
• Die Klasse kehrte am selben Tag an einer anderen Feldgruppe wieder. new source --set entities=… schrieb die Referenz-Arrays einer Source-Seite genau einmal; xref link-source fasste sie nicht an, xref add lehnte sie ab, und touch sperrt sie über seine Denylist. Damit war eine Source-Seite nach dem Anlegen in ihren eigenen entities:/concepts: unerreichbar - dieselbe Lücke wie bei tags:, nur an den Feldern, die eine andere Zuständigkeit haben. Geschlossen mit 1.6.0 (Commit ce03749, Gitea-Issue #18), indem xref link-source beide Richtungen schreibt²
• Abgrenzung zu Detect-Repair Asymmetry: Dort meldet ein Check einen Defekt, für den es keinen Reparaturbefehl gibt. Hier gibt es nicht einmal zwingend einen Befund - ein falsches tags: fällt keinem Check auf. Der raw_files:-Fall gehört zu beiden: er wird gemeldet und war nicht reparierbar.
• Der Existenzcheck bleibt am Feld, nicht am Schema. Ein per touch geschriebenes raw_files: wird gegen das Dateisystem geprüft wie beim Anlegen. Das ist I/O und keine Datenform, also kann kein Schema es ausdrücken¹ .

Beispiele

• wikitool - tags: und raw_files: waren bis 1.4.0 nur beim Anlegen schreibbar (Gitea-Issue #14, geschlossen)
• Diff-Reviewable Agent Edits - die Seite, die stundenlang unreparierbar war und den Fall belegt

Wann zu verwenden

• Beim Ergänzen eines Schema-Felds: prüfen, welcher Befehl es nach dem Anlegen noch ändert. Gibt es keinen, ist das Feld write-once ausgeliefert.
• Bei der Bewertung eines nicht-idempotenten Anlegebefehls: die Frage ist nicht, wie oft er falsch aufgerufen wird, sondern was ein einziger falscher Aufruf dauerhaft festschreibt.

Wann NICHT zu verwenden

• Für Felder, die absichtlich unveränderlich sind, weil ihre Änderung eine andere Operation ist: type: ändert Schema und Verzeichnis der Seite und gehört in den Seiten-Lebenszyklus, confidence: ist abgeleitet und nicht autorisiert. Eine gesperrte Zuständigkeit ist keine Lücke.
• Für generierte Dateien. Dass kb/index.md nicht von Hand geschrieben wird, ist Invariante 1 und kein Defekt.

Beziehungen

Siehe auch

• Source - Conversation - Write-Once Frontmatter Fields and touch --set Session 2026-08-31
• Source - Conversation - Two Round-Trip Defects Found by an Ingest Session 2026-08-31

Fußnoten

Beziehungen

• exemplifies: wikitool
• see-also: Denylist over Allowlist
• see-also: Detect-Repair Asymmetry
• see-also: Diff-Reviewable Agent Edits
• see-also: Command Round-Trip Integrity

---

1. Source - Conversation - Write-Once Frontmatter Fields and touch --set Session 2026-08-31 ↩︎

2. Source - Conversation - Two Round-Trip Defects Found by an Ingest Session 2026-08-31 ↩︎