docs/appendix.md aktualisiert

docs/appendix.md

@@ -1,7 +1,7 @@
 # Mindnet v2.2 – Appendices & Referenzen
 **Datei:** `docs/mindnet_appendices_v2.2.md`
-**Stand:** 2025-12-07
-**Status:** **FINAL** (Konsolidiert aus WP01–WP04a)
+**Stand:** 2025-12-08
+**Status:** **FINAL**
 **Quellen:** `TYPE_REGISTRY_MANUAL.md`, `chunking_strategy.md`, `mindnet_technical_architecture.md`, `Handbuch.md`.
 
 > Dieses Dokument bündelt Tabellen, Schemata und technische Referenzen, die in den Prozess-Dokumenten (Playbook, Guides) den Lesefluss stören würden.
@@ -10,7 +10,7 @@
 
 ## Anhang A: Typ-Registry Referenz (Default-Werte)
 
-Diese Tabelle zeigt die Standard-Konfiguration der `types.yaml` (Stand v2.2). Diese Werte werden beim Import angewendet, sofern im Frontmatter nichts anderes definiert ist.
+Diese Tabelle zeigt die Standard-Konfiguration der `types.yaml` (Stand v2.2).
 
 | Typ (`type`) | Chunk Profile | Retriever Weight | Edge Defaults (Auto-Kanten) | Beschreibung |
 | :--- | :--- | :--- | :--- | :--- |
@@ -28,7 +28,7 @@ Diese Tabelle zeigt die Standard-Konfiguration der `types.yaml` (Stand v2.2). Di
 
 ## Anhang B: Edge-Typen & Semantik
 
-Referenz aller implementierten Kantenarten (`kind`). Die Spalte "Herkunft" zeigt, durch welchen Mechanismus diese Kante primär entsteht.
+Referenz aller implementierten Kantenarten (`kind`).
 
 | Kind | Herkunft (Primär) | Symmetrisch? | Bedeutung & Nutzung |
 | :--- | :--- | :--- | :--- |
@@ -46,7 +46,7 @@ Referenz aller implementierten Kantenarten (`kind`). Die Spalte "Herkunft" zeigt
 
 ## Anhang C: Datenmodelle (JSON Payloads)
 
-Dies sind die Felder, die effektiv in Qdrant gespeichert werden. Dient als Referenz für Entwickler und Debugging (`payload_dryrun`).
+Dies sind die Felder, die effektiv in Qdrant gespeichert werden.
 
 ### C.1 Note Payload (`mindnet_notes`)
     {
@@ -101,31 +101,27 @@ Diese Variablen steuern das Verhalten der Skripte und Container.
 | `MINDNET_RETRIEVER_CONFIG`| `config/retriever.yaml`| Pfad zur Scoring-Konfiguration. |
 | `MINDNET_HASH_COMPARE` | `Body` | Vergleichsmodus für Import (`Body`, `Frontmatter`, `Full`). |
 | `MINDNET_HASH_SOURCE` | `parsed` | Quelle für Hash (`parsed`, `raw`, `file`). |
-| `MINDNET_HASH_NORMALIZE` | `canonical` | Normalisierung vor Hash (`canonical`, `none`). |
 | `VECTOR_DIM` | `384` | Dimension der Embeddings (Modellabhängig). |
 
 ---
 
 ## Anhang E: Glossar
 
-Zentrale Begriffe des Mindnet-Systems.
-
-* **Callout-Edge:** Eine Kante, die durch einen Obsidian-Callout Block (`> [!edge]`) definiert wird. Dient für Listen.
-* **Chunking:** Prozess des Zerlegens einer Notiz in kleinere, semantische Einheiten (Chunks).
-* **Confidence:** Ein Wert (0.0-1.0), der angibt, wie sicher eine Kante ist. Explizite User-Eingaben haben 1.0, Defaults ~0.7.
-* **Idempotenz:** Eigenschaft des Importers, bei mehrfacher Ausführung das exakt gleiche Ergebnis zu liefern (keine Duplikate).
-* **Inline-Edge:** Eine Kante, die im Fließtext mittels `[[rel:type Ziel]]` definiert wird. Semantisch sehr stark.
-* **Provenance:** Die Herkunft einer Information (z.B. "explicit" vs "rule" vs "inference").
-* **Retriever:** Die Komponente (FastAPI), die Suchanfragen beantwortet und Scores berechnet.
-* **Rule ID:** Ein String, der genau identifiziert, welche Code-Regel eine Kante erzeugt hat (z.B. `edge_defaults:project:depends_on`).
-* **Vault:** Der lokale Ordner mit Markdown-Dateien. Die "Single Source of Truth".
-* **Vector Search:** Suche basierend auf semantischer Ähnlichkeit (Embeddings) statt reiner Stichworte.
+* **Callout-Edge:** Kante via `> [!edge]`.
+* **Chunking:** Zerlegung von Notizen in kleinere Einheiten.
+* **Confidence:** Vertrauenswürdigkeit einer Kante (0.0-1.0).
+* **Explanation Layer:** Komponente, die Scores und Graphen als Begründung liefert.
+* **Feedback Loop:** Prozess des Loggens und Auswertens von User-Reaktionen.
+* **Idempotenz:** Mehrfache Ausführung liefert gleiches Ergebnis.
+* **Inline-Edge:** Kante via `[[rel:type Ziel]]`.
+* **Retriever:** Suchmaschine (FastAPI).
+* **Vault:** Ordner mit Markdown-Dateien.
 
 ---
 
-## Anhang F: Workpackage Status (v2.2)
+## Anhang F: Workpackage Status (v2.2.1)
 
-Status der Module gemäß Programmplan.
+Aktueller Implementierungsstand der Module.
 
 | WP | Titel | Status | Anmerkung |
 | :--- | :--- | :--- | :--- |
@@ -133,8 +129,8 @@ Status der Module gemäß Programmplan.
 | **WP02** | Chunking Strategy | 🟢 Live | Profilbasiertes Chunking aktiv. |
 | **WP03** | Edge Logic / Import | 🟢 Live | Neue Importer-Pipeline mit Provenance. |
 | **WP04a**| Retriever Scoring | 🟢 Live | Hybrider Score (Semantik + Graph). |
-| **WP04b**| Explanation Layer | 🟡 In Arbeit | API liefert Pfade, UI fehlt noch. |
-| **WP04c**| Feedback Loop | 🔴 Geplant | Logging von User-Feedback. |
-| **WP05** | Virtual Schema | 🟡 Teilw. | `types.yaml` aktiv, ACL fehlt. |
+| **WP04b**| Explanation Layer | 🟢 Live | API liefert Reasons & Breakdown. |
+| **WP04c**| Feedback Loop | 🟢 Live | Logging (JSONL) & Traceability aktiv. |
+| **WP05** | Persönlichkeit / Chat | 🟡 Geplant | Nächster Schritt (RAG). |
 | **WP06** | Self-Healing | 🔴 Geplant | Auto-Fixing von Broken Links. |
 | **WP08** | Self-Tuning | 🔴 Geplant | Auto-Adjustment der Gewichte. |