Chemenu 2.1.0 - deterministischer Wissenskompiler

Chemenu kompiliert Rohnotizen zu einem verlinkten, quellengebundenen Wiki:
raw/ -> types/ + tools/ -> kb/ -> reports/. Was mechanisch ist, macht
tools/wikitool; was Urteil braucht, macht ein Agent unter Contracts, deren
Grenzen in Code durchgesetzt sind statt im Prompt.

Dieser Commit ist der Startpunkt der oeffentlichen Historie. Die vorherige
Entwicklung fand in einer privaten Instanz statt und ist nicht Teil dieses
Repositorys; ihre Erzaehlung steht vollstaendig in CHANGES.md, das mit 44
Eintraegen von 0.1.0 bis 2.1.0 erhalten geblieben ist.

Der mitgelieferte Korpus ist ein Testbett und eine Demo: 170 Seiten ueber den
Stack selbst - Gates, Lint, Versionierung, Suche, das Wiki-Muster. Er
dokumentiert das Werkzeug mit den eigenen Mitteln des Werkzeugs.

Lizenz: AGPL-3.0 fuer den Stack (tools/, types/), CC-BY-4.0 fuer die Inhalte.
Die Grenze zwischen beiden ist der Dateiplan, den dist export berechnet -
siehe NOTICE.

kb/concepts/Supersession.md

@@ -0,0 +1,136 @@
+---
+type: types/concept.md
+concept_type: workflow
+tags: [versioning, knowledge, updates, lifecycle]
+created: 2026-07-26
+modified: 2026-08-29
+related: [Memory Lifecycle, Confidence Scoring, Knowledge Graph, LLM Wiki Pattern]
+sources: [Source - LLM Wiki v2]
+confidence: 0.95
+confidence_base: 0.95
+provenance: sourced
+summary: Ablösen alten Wissens durch neue, widersprechende Information; gibt dem Wiki eine Versionierung mit ausdrücklicher Verknüpfung und Erhalt der Historie.
+---
+# Supersession
+
+**Typ:** Workflow (Knowledge Version Control)
+
+## Definition
+
+Supersession ist der Prozess des **expliziten Ersetzens** alten Wissens durch neues Wissen, wenn die neuen Informationen das Alte widersprechen oder aktualisieren. Es stellt Versionskontrolle für Wissen bereit und stellt sicher, dass das Wiki sich im Laufe der Zeit korrekt entwickelt, ohne historischen Kontext zu verlieren.
+
+Dies ist eine Kernkomponente der [[Memory Lifecycle]]-Verwaltung.
+
+## Kernpunkte
+
+### Das Problem
+
+Ohne Supersession:
+- Alte und neue widersprechende Aussagen koexistieren ohne Anzeichen, welche aktuell ist
+- Benutzer müssen widersprechende Informationen manuell abgleichen
+- Das Wiki wird zum Friedhof veralteter Fakten
+- Keine Audit-Trail wie sich Wissen entwickelt hat
+
+### Die Lösung
+
+Wenn neue Informationen **eine bestehende Aussage widersprechen oder aktualisieren**:
+
+1. **Erstelle die neue Aussage** mit aktuellen Informationen
+2. **Verlinke explizit** die neue Aussage mit der alten
+3. **Markiere die alte Aussage** als **supersediert** mit:
+   - Zeitstempel der Supersession
+   - Referenz auf die ersetzende Aussage
+   - Bewahrter Inhalt (für historische Referenz)
+4. **Aktualisiere Querverweise** um auf die neue Aussage zu zeigen
+5. **Erhöhe Konfidenz** der neuen Aussage (erbt von alten + neuen Quellen)
+
+### Supersession-Metadaten
+
+Für jede supersedierte Aussage speichern:
+```yaml
+superseded_by: [claim_id]
+superseded_on: YYYY-MM-DD
+supersession_reason: [contradiction|update|correction]
+original_content: "..."  # Preserved for history
+```
+
+## Arten der Supersession
+
+| Typ | Beschreibung | Beispiel |
+|------|-------------|---------|
+| **Widerspruch** | Neue Info widerspricht direkt alte | „Port ist 1234" → „Port ist 1235" |
+| **Aktualisierung** | Neue Info macht alte Info veraltet | „Nutzt Python 3.8" → „Nutzt Python 3.11" |
+| **Korrektur** | Alte Info war falsch | „Autor ist X" → „Autor ist Y" |
+| **Verfeinerung** | Neue Info fügt wichtiges Detail hinzu | „Nutzt Redis" → „Nutzt Redis 7.0 für Caching" |
+
+## Implementierung
+
+### Auslöser
+
+Supersession kann ausgelöst werden durch:
+- **Manuell:** Benutzer markiert alte Aussage explizit als supersediert
+- **Automatisch:** [[Event-Driven Automation]] erkennt Widerspruch während Ingest
+- **Geplant:** Periodischer Lint identifiziert veraltete Aussagen
+
+### Automatisierungs-Workflow
+
+```
+On new source ingest:
+1. Extract claims from new source
+2. For each claim:
+   a. Check for contradictions with existing claims
+   b. If contradiction found:
+      i. Calculate confidence of both claims
+      ii. If new claim has higher confidence:
+          - Create supersession relationship
+          - Mark old as superseded
+      iii. If old claim has higher confidence:
+          - Flag for human review
+      iv. If equal confidence:
+          - Flag for human review
+   c. If no contradiction, add as new claim
+```
+
+### Konfidenz-Vererbung
+
+Wenn Aussage B Aussage A ersetzt:
+- Aussage B erbt Konfidenz-Boost von Aussagen A's Quellen (falls immer noch gültig)
+- Aussage B's Konfidenz = min(1.0, B_confidence + A_confidence * inheritance_factor)
+- Typischer inheritance_factor = 0.3-0.5
+
+## Vorteile
+
+- **Klarheit:** Klare Anzeige von aktuellen vs. historischen Kenntnissen
+- **Nachverfolgbarkeit:** Vollständige Geschichte wie sich Wissen entwickelt hat
+- **Vertrauen:** Benutzer können die Progression des Verständnisses sehen
+- **Genauigkeit:** Alte, falsche Informationen bleiben nicht erhalten
+- **Wiederherstellung:** Kann rollback, wenn Supersession fehlerhaft war
+
+## Wann zu verwenden
+
+- Jede faktische Aussage, die sich mit der Zeit ändern kann
+- Technische Spezifikationen
+- Versionabhängige Informationen
+- Zeitkritisches Wissen
+- Jeder Bereich mit sich entwickelndem Verständnis
+
+## Wann NICHT zu verwenden
+
+- Subjektive Meinungen
+- Historische Fakten (als-ist bewahren)
+- Definitionen, die sich nicht ändern
+
+## Verwandte Concepts
+
+- [[Memory Lifecycle]] - Übergeordnetes Concept
+- [[Confidence Scoring]] - Bestimmt welche Aussage in Widerspruch gewinnt
+- [[Contradiction Resolution]] - Der Entscheidungsprozess für Supersession
+- [[Knowledge Graph]] - Struktur zur Verfolgung von Supersession-Beziehungen
+- [[LLM Wiki Pattern]] - Gesamtes Pattern
+
+## Siehe auch
+
+- [[Event-Driven Automation]] (für automatisierte Supersession)
+- [[Forgetting]] (komplementärer Mechanismus)
+- [[Self-Healing]] (für automatisierte Supersession-Erkennung)
+- [[Audit Trail]] (zum Nachverfolgen von Supersession-Historie)