glpi-neural-brain/ARCHITECTURE.md

Architektur und Vertrauensgrenzen

Agent knowledge/ ──ro──┐
Agent runs.jsonl ──ro──┼──► Ingest ─► Graph + Vectors ─► Retrieval/Inference ─► SSE/Web UI
KB staging/ ──────rw───┘                               │
                                                     ├──► AI Edge (staging)
                                                     ├──► optional SearXNG evidence
                                                     └──► AI-THINK JSON in staging

Edge-Klassen

• categorized_as, mentions, derived_from: deterministisch aus JSON.
• research_evidence: aus einer explizit gestarteten Recherche, weiterhin staging.
• related_to, depends_on, supports, contradicts, extends, same_topic, caused_by: Qwen-Inferenz mit Confidence und Evidence.
• rejected: intern gespeicherte Prüfung ohne sichtbare Beziehung; verhindert Endlosschleifen.

Ereignismodell

Activity ist von der Graph-Persistenz getrennt. Eine Anfrage verändert deshalb nicht automatisch die Wissensbasis. Erst der sequenzielle Enrichment-Schritt darf eine neue Edge oder einen AI-THINK-Entwurf anlegen.

Datenhoheit

Produktive JSON-Dateien werden niemals verändert. Der einzige schreibende Fremdpfad ist das explizit konfigurierte Staging-Verzeichnis. Alle Dateien werden atomar über Temporärdatei und Rename geschrieben.