Honeycomb und Control-Patch

README.md

@@ -5,6 +5,8 @@ Eigenständiger Go-Dienst für Agent, lokale Knowledgebase, GLPI-Knowledgebase u
 ## Kernfunktionen
 
 - Fullscreen-Canvas mit 3D-Hirnform, semantischen Cortex-Regionen und hierarchischem Level-of-Detail.
+- Umschaltbare Honeycomb-Ansicht: gleichmäßig verteilte Notes in einer automatisch skalierten 3D-Gehirnwabe, ohne Edge-Rendering.
+- Laufzeitsteuerung für Learning und Thinking sowie getrennte Kategorie-Filter für Lernen, Anzeige und AI-THINK.
 - Echtzeitaktivierung über Server-Sent Events: Nodes glühen, aggregierte Edges leuchten und Partikel folgen tatsächlichen Wissenspfaden.
 - Ingest lokaler produktiver Knowledge-JSONs sowie separater AI-THINK-Staging-Dateien.
 - Optionaler read-only Ingest sichtbarer Beiträge aus der GLPI-Knowledgebase.
@@ -119,6 +121,31 @@ curl -X POST http://localhost:8090/api/flush
 
 Mehr Details: [`PERSISTENCE.md`](PERSISTENCE.md).
 
+## Laufzeitsteuerung und Honeycomb
+
+Die untere Steuerleiste enthält direkte Schalter für **LEARNING**, **THINKING**, **NEURAL** und **HONEYCOMB**. Sind Learning und Thinking deaktiviert, bleibt das System im Living-Modus; eingehende Agent- oder KB-Anfragen können weiterhin die tatsächlich verwendeten Notes aktivieren.
+
+Über **FILTER** lassen sich drei unabhängige Kategorienlisten pflegen:
+
+- **Lernen**: neue Embeddings nur für passende Kategorien;
+- **Anzeige**: Browser-Rendering nur für passende Notes;
+- **Thinking**: neue AI-THINK-Kandidaten nur innerhalb der gewählten Kategorien.
+
+Leere Listen bedeuten „alle Kategorien“. Die Werte werden über die vorhandene Persistenzqueue in `runtime-settings.json` geschrieben.
+
+```env
+BRAIN_LEARNING_ENABLED=true
+BRAIN_THINKING_ENABLED=true
+BRAIN_LEARNING_CATEGORIES=
+BRAIN_DISPLAY_CATEGORIES=
+BRAIN_THINKING_CATEGORIES=
+BRAIN_DEFAULT_VIEW=neural
+```
+
+Honeycomb rendert nur `knowledge`, `ai-think` und `external`. Ein 3D-Gitter mit einheitlichem Punktabstand wird auf die Gehirngeometrie beschnitten und automatisch an die sichtbare Anzahl von Notes angepasst. Edges, LOD-Gruppen und Cortex-Flächen bleiben dort unsichtbar; bei einer Anfrage leuchten nur die referenzierten Notes.
+
+Mehr Details: [`RUNTIME-CONTROLS-HONEYCOMB.md`](RUNTIME-CONTROLS-HONEYCOMB.md).
+
 ## Autonome Anreicherung
 
 Der Worker arbeitet bewusst sequenziell:
@@ -150,6 +177,9 @@ curl -X POST 'http://localhost:8090/api/enrich?async=1'
 | `GET` | `/api/status` | Gesamtstatus inklusive Ollama-Pool, GLPI-KB und Persistenzqueue |
 | `GET` | `/api/graph` | vollständiger aktueller In-Memory-Graph |
 | `GET` | `/api/analysis` | strukturelle Graphanalyse |
+| `GET` | `/api/runtime-settings` | aktuelle Learning-, Thinking-, Filter- und View-Einstellungen |
+| `PUT` | `/api/runtime-settings` | Laufzeiteinstellungen ändern und gebündelt persistieren |
+| `GET` | `/api/categories` | verfügbare Note-Kategorien mit Anzahl |
 | `GET` | `/api/stream` | SSE-Aktivitätsstrom |
 | `POST` | `/api/query` | programmatische Wissensanfrage; in der Fullscreen-UI verborgen |
 | `POST` | `/api/events` | optionale Agent-/KB-Telemetrie |