kb/concepts/ bekommt Areas: layout: fuer concept, Area-Titel aus jedem Type-Spec, Schwellen-Empfehlung im lint (schliesst #59)

Files changed: - CHANGES.md - README.md - VERSION - kb/concepts/Ambient Environment Dependency.md - kb/concepts/Anti-Cramming Heuristic.md - kb/concepts/Audit Trail.md - kb/concepts/BM25.md - kb/concepts/Bulk Operations.md - kb/concepts/CI Integration.md - kb/concepts/COLLECTION.md - kb/concepts/CPPC.md - kb/concepts/Checkpoint Audit.md - kb/concepts/Claude Code Auto Mode.md - kb/concepts/Command Round-Trip Integrity.md - kb/concepts/Confidence Scoring.md - kb/concepts/Consolidation Tiers.md - kb/concepts/Content Quality Control.md - kb/concepts/Context Isolation.md - kb/concepts/Contradiction Resolution.md - kb/concepts/Cross-platform Agent Skills.md - kb/concepts/Crystallization.md - kb/concepts/Delete Rather Than Anonymize.md - kb/concepts/Denylist over Allowlist.md - kb/concepts/Detect-Repair Asymmetry.md - kb/concepts/Diff-Reviewable Agent Edits.md - kb/concepts/Dual Licensing by File Plan.md - kb/concepts/Entity Extraction.md - kb/concepts/Episodic Memory.md - kb/concepts/Event-Driven Automation.md - kb/concepts/Filter on Ingest.md - kb/concepts/Forgetting.md - kb/concepts/Graph Traversal.md - kb/concepts/Green Suite Blind Spot.md - kb/concepts/Hooks.md - kb/concepts/Hybrid Search.md - kb/concepts/INDEX.md - kb/concepts/Implementation Spectrum.md - kb/concepts/Index Scaling.md - kb/concepts/Issue Label Scheme.md - kb/concepts/Iteration and Cost Limits.md - kb/concepts/KB Migration.md - kb/concepts/KB Stack Versioning.md - kb/concepts/Knowledge Compounding.md - kb/concepts/Knowledge Graph.md - kb/concepts/LLM Wiki Pattern.md - kb/concepts/Lint Workflow.md - kb/concepts/MCP-Leseserver.md - kb/concepts/Mass-Update Gate.md - kb/concepts/Memory Lifecycle.md - kb/concepts/Mesh Sync.md - kb/concepts/Modbus.md - kb/concepts/Multi-Agent Collaboration.md - kb/concepts/Naming Convention Conflict.md - kb/concepts/OKF Compatibility.md - kb/concepts/Optional Instance Context File.md - kb/concepts/Personalization Plane.md - kb/concepts/Privacy and Governance.md - kb/concepts/Procedural Memory.md - kb/concepts/Publish-Remote Gate.md - kb/concepts/Quality Scoring.md - kb/concepts/Quality and Self-Correction.md - kb/concepts/RAG.md - kb/concepts/Reciprocal Rank Fusion.md - kb/concepts/SSD TRIM.md - kb/concepts/Scale Ceiling.md - kb/concepts/Self-Healing.md - kb/concepts/Semantic Lint Automation.md - kb/concepts/Semantic Memory.md - kb/concepts/Session Orientation.md - kb/concepts/Shared vs Private.md - kb/concepts/Split Merge Reclassify.md - kb/concepts/Split Threshold.md - kb/concepts/Structural Enforcement over Documented Rule.md - kb/concepts/Stub Threshold.md - kb/concepts/Supersession.md - kb/concepts/Three-Layer Architecture.md - kb/concepts/Token Economics.md - kb/concepts/Typed Relationships.md - kb/concepts/User Management.md - kb/concepts/Vector Search.md - kb/concepts/Work Coordination.md - kb/concepts/Workflow Extraction.md - kb/concepts/Workflow Orchestration.md - kb/concepts/Working Memory.md - kb/concepts/Write-Once Frontmatter Fields.md - kb/concepts/architectures/Consolidation Tiers.md - kb/concepts/architectures/Context Isolation.md - kb/concepts/architectures/Cross-platform Agent Skills.md - kb/concepts/architectures/Episodic Memory.md - kb/concepts/architectures/Hybrid Search.md - kb/concepts/architectures/Implementation Spectrum.md - kb/concepts/architectures/Knowledge Graph.md - kb/concepts/architectures/LLM Wiki Pattern.md - kb/concepts/architectures/MCP-Leseserver.md - kb/concepts/architectures/Memory Lifecycle.md - kb/concepts/architectures/OKF Compatibility.md - kb/concepts/architectures/Optional Instance Context File.md - kb/concepts/architectures/Personalization Plane.md - kb/concepts/architectures/Procedural Memory.md - kb/concepts/architectures/RAG.md - kb/concepts/architectures/Scale Ceiling.md - kb/concepts/architectures/Semantic Memory.md - kb/concepts/architectures/Three-Layer Architecture.md - kb/concepts/architectures/Token Economics.md - kb/concepts/architectures/Working Memory.md - kb/concepts/decisions/Delete Rather Than Anonymize.md - kb/concepts/decisions/Denylist over Allowlist.md - kb/concepts/decisions/Diff-Reviewable Agent Edits.md - kb/concepts/decisions/Dual Licensing by File Plan.md - kb/concepts/decisions/Issue Label Scheme.md - kb/concepts/decisions/KB Stack Versioning.md - kb/concepts/decisions/Structural Enforcement over Documented Rule.md - kb/concepts/patterns/Audit Trail.md - kb/concepts/patterns/BM25.md - kb/concepts/patterns/Command Round-Trip Integrity.md - kb/concepts/patterns/Confidence Scoring.md - kb/concepts/patterns/Contradiction Resolution.md - kb/concepts/patterns/Entity Extraction.md - kb/concepts/patterns/Filter on Ingest.md - kb/concepts/patterns/Forgetting.md - kb/concepts/patterns/Graph Traversal.md - kb/concepts/patterns/Mesh Sync.md - kb/concepts/patterns/Quality Scoring.md - kb/concepts/patterns/Reciprocal Rank Fusion.md - kb/concepts/patterns/Self-Healing.md - kb/concepts/patterns/Shared vs Private.md - kb/concepts/patterns/Typed Relationships.md - kb/concepts/patterns/Vector Search.md - kb/concepts/patterns/Work Coordination.md - kb/concepts/problems/Ambient Environment Dependency.md - kb/concepts/problems/Detect-Repair Asymmetry.md - kb/concepts/problems/Green Suite Blind Spot.md - kb/concepts/problems/Naming Convention Conflict.md - kb/concepts/problems/Write-Once Frontmatter Fields.md - kb/concepts/protocols/CPPC.md - kb/concepts/protocols/Modbus.md - kb/concepts/protocols/SSD TRIM.md - kb/concepts/workflows/Anti-Cramming Heuristic.md - kb/concepts/workflows/Bulk Operations.md - kb/concepts/workflows/CI Integration.md - kb/concepts/workflows/Checkpoint Audit.md - kb/concepts/workflows/Claude Code Auto Mode.md - kb/concepts/workflows/Content Quality Control.md - kb/concepts/workflows/Crystallization.md - kb/concepts/workflows/Event-Driven Automation.md - kb/concepts/workflows/Hooks.md - kb/concepts/workflows/Index Scaling.md - kb/concepts/workflows/Iteration and Cost Limits.md - kb/concepts/workflows/KB Migration.md - kb/concepts/workflows/Knowledge Compounding.md - kb/concepts/workflows/Lint Workflow.md - kb/concepts/workflows/Mass-Update Gate.md - kb/concepts/workflows/Multi-Agent Collaboration.md - kb/concepts/workflows/Privacy and Governance.md - kb/concepts/workflows/Publish-Remote Gate.md - kb/concepts/workflows/Quality and Self-Correction.md - kb/concepts/workflows/Semantic Lint Automation.md - kb/concepts/workflows/Session Orientation.md - kb/concepts/workflows/Split Merge Reclassify.md - kb/concepts/workflows/Split Threshold.md - kb/concepts/workflows/Stub Threshold.md - kb/concepts/workflows/Supersession.md - kb/concepts/workflows/User Management.md - kb/concepts/workflows/Workflow Extraction.md - kb/concepts/workflows/Workflow Orchestration.md - kb/index.md - kb/log.md - tools/CONTRACT.md - tools/README.md - tools/chemenu/catalog.py - tools/chemenu/commands/index_build.py - tools/chemenu/lint_core.py - tools/chemenu/tests/conftest.py - tools/chemenu/tests/test_cite_cmd.py - tools/chemenu/tests/test_git_publish.py - tools/chemenu/tests/test_index_build.py - tools/chemenu/tests/test_lint.py - tools/chemenu/tests/test_new_page.py - tools/chemenu/tests/test_provenance.py - tools/chemenu/tests/test_type_resolver.py - tools/chemenu/tests/test_xref.py - types/concept.md - types/type-spec.md
2026-09-08 10:07:46 +02:00
parent 63b4bb82d9
commit 7f74303a00
103 changed files with 703 additions and 180 deletions
@@ -0,0 +1,123 @@
+---
+type: types/concept.md
+concept_type: problem
+tags: [wikitool, frontmatter, tooling, idempotenz, repair]
+created: 2026-08-31
+modified: 2026-08-31
+related:
+  - exemplifies: wikitool
+  - see-also: Denylist over Allowlist
+  - see-also: Detect-Repair Asymmetry
+  - see-also: Diff-Reviewable Agent Edits
+  - see-also: Command Round-Trip Integrity
+sources: [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]
+confidence: 0.70
+confidence_base: 0.70
+provenance: sourced
+summary: 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[^s-conversation-write-once-frontmatter-fields-and-touch-set-session-2026-08-31].
+
+## 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[^s-conversation-write-once-frontmatter-fields-and-touch-set-session-2026-08-31].
+- **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[^s-conversation-write-once-frontmatter-fields-and-touch-set-session-2026-08-31].
+- **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[^s-conversation-write-once-frontmatter-fields-and-touch-set-session-2026-08-31].
+- **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[^s-conversation-write-once-frontmatter-fields-and-touch-set-session-2026-08-31].
+- **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[^s-conversation-two-round-trip-defects-found-by-an-ingest-session-2026-08-31]
+- **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[^s-conversation-write-once-frontmatter-fields-and-touch-set-session-2026-08-31].
+
+## 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
+
+[^s-conversation-write-once-frontmatter-fields-and-touch-set-session-2026-08-31]: [[Source - Conversation - Write-Once Frontmatter Fields and touch --set Session 2026-08-31]]
+[^s-conversation-two-round-trip-defects-found-by-an-ingest-session-2026-08-31]: [[Source - Conversation - Two Round-Trip Defects Found by an Ingest Session 2026-08-31]]
+
+<!-- wikitool:links -->
+## 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]]
+<!-- /wikitool:links -->