Implement Phase 3 Agentic Edge Validation in ingestion_processor.py and related documentation updates

Introduce a new method for persisting rejected edges for audit purposes, enhancing traceability and validation logic. Update the decision engine to utilize a generic fallback template for improved error handling during LLM validation. Revise documentation across multiple files to reflect the new versioning, context, and features related to Phase 3 validation, including automatic mirror edges and note-scope zones. This update ensures better graph integrity and validation accuracy in the ingestion process.
This commit is contained in:
Lars committed 2026-01-12 07:45:54 +01:00
1 parent b19f91c3ee
commit 742792770c
18 files changed
+1110 -119

No files matched your search

+21 -3
View File
@@ -1,10 +1,10 @@
---
doc_type: operations_manual
audience: admin, devops
scope: deployment, maintenance, backup, edge_registry, moe, lazy_prompts
scope: deployment, maintenance, backup, edge_registry, moe, lazy_prompts, agentic_validation
status: active
version: 3.1.1
context: "Installationsanleitung, Systemd-Units und Wartungsprozesse für Mindnet v3.1.1 inklusive WP-25a Mixture of Experts (MoE) und WP-25b Lazy-Prompt-Orchestration Konfiguration."
version: 4.5.8
context: "Installationsanleitung, Systemd-Units und Wartungsprozesse für Mindnet v4.5.8 inklusive WP-25a Mixture of Experts (MoE), WP-25b Lazy-Prompt-Orchestration und WP-24c Phase 3 Agentic Edge Validation Konfiguration."
---
# Admin Operations Guide
@@ -246,6 +246,24 @@ Bevor du spezifische Fehler behebst, führe diese Checks durch:
1. Füge fehlende Typen als Aliase in `01_edge_vocabulary.md` hinzu
2. Oder verwende kanonische Typen aus der Registry
**Fehler: "Phase 3 Validierung schlägt fehl" (WP-24c v4.5.8)**
* **Symptom:** Links in `### Unzugeordnete Kanten` werden nicht validiert oder abgelehnt.
* **Diagnose:** Prüfe Logs auf `🚀 [PHASE 3]` und `🚫 [PHASE 3] REJECTED`.
* **Lösung:**
1. Prüfe `MINDNET_LLM_VALIDATION_HEADERS` in `.env` (Standard: `Unzugeordnete Kanten,Edge Pool,Candidates`)
2. Prüfe `MINDNET_LLM_VALIDATION_HEADER_LEVEL` (Standard: `3` für `###`)
3. Prüfe `llm_profiles.yaml` - `ingest_validator` Profil muss existieren
4. Prüfe LLM-Verfügbarkeit (Ollama/OpenRouter)
5. **Hinweis:** Transiente Fehler (Netzwerk) erlauben die Kante, permanente Fehler lehnen sie ab
**Fehler: "Note-Scope Links werden nicht erkannt" (WP-24c v4.2.0)**
* **Symptom:** Links in `## Smart Edges` Zonen werden nicht als Note-Scope behandelt.
* **Diagnose:** Prüfe Logs auf Note-Scope Extraktion.
* **Lösung:**
1. Prüfe `MINDNET_NOTE_SCOPE_ZONE_HEADERS` in `.env` (Standard: `Smart Edges,Relationen,Global Links`)
2. Prüfe `MINDNET_NOTE_SCOPE_HEADER_LEVEL` (Standard: `2` für `##`)
3. Header-Namen müssen exakt (case-insensitive) übereinstimmen
#### Performance-Optimierung
**Problem: Langsame Chat-Antworten**