jbergner
a6bc71fb3a
release-tag / Resolve release metadata (push) Successful in 30s
release-tag / Build knowledge (push) Failing after 4m51s
release-tag / Build control (push) Failing after 5m0s
release-tag / Build agent (push) Failing after 5m0s
release-tag / Build agent-data-init (push) Failing after 5m5s
release-tag / Build neuroforge-worker (push) Failing after 5m7s
release-tag / Build neuroforge (push) Failing after 5m9s
84 lines
4.6 KiB
Markdown
84 lines
4.6 KiB
Markdown
# Kontroll- und Berechtigungsmatrix
|
|
|
|
| Capability | Agent | KB Editor | NeuroForge App API | NeuroForge Admin | Control Center |
|
|
|---|---:|---:|---:|---:|---:|
|
|
| GLPI lesen | ja | nein | nein | nein | nein |
|
|
| GLPI schreiben | nur Policy-gated | nein | nein | nein | nein |
|
|
| Produktive KB lesen | ja | ja | indirekt über Sync | nein | nein |
|
|
| Produktive KB schreiben | nein | ja | nein | nein | nein |
|
|
| KB-Staging schreiben | nein | ja | über getrennten KB Integration Token möglich | nein | nein |
|
|
| KB-Staging promoten | nein | ja | nein | nein | nein |
|
|
| Knowledge-Vektoren upserten | ja, App Key | nein | ja | ja | nein |
|
|
| Knowledge-Vektoren suchen | ja, App Key | nein | ja | ja | nein |
|
|
| NeuroForge Config ändern | nein | nein | nein | ja | nein |
|
|
| NeuroForge Secrets lesen/rotieren | nein | nein | nein | ja | nein |
|
|
| Systemstatus lesen | eigene Readiness | eigene Health | Stats mit App Key | ja | aggregiert read-only |
|
|
| Obsidian-Export | Live-Sicht inkl. GLPI-Relations | kanonische KB | nein | nein | verlinkt Ziel-UI |
|
|
| Human Outcome erfassen | ja, authentifizierter Techniker | nein | empfängt nur validated outcome | sichtbar/admin | Status read-only |
|
|
| Trusted Outcome-Source setzen | nein | nein | **serverseitig fest** | ja | nein |
|
|
| SearXNG Research | nein | nein | Research Engine via SearXNG | konfigurierbar | Status read-only |
|
|
| Autonomy aktivieren | nein | nein | nein | Betreiber/Admin bzw. Env | Status read-only |
|
|
|
|
## Credentials
|
|
|
|
- `NEUROFORGE_ADMIN_TOKEN`: nur Betreiber/Admin.
|
|
- `NEUROFORGE_APP_API_KEY`: Agent und read-only Control-Stats; keine Admin-Config.
|
|
- `NEUROFORGE_WORKER_TOKEN`: nur NeuroForge Worker.
|
|
- `NEUROFORGE_METRICS_TOKEN`: nur Metrics-Scraper.
|
|
- `KB_INTEGRATION_TOKEN`: ausschließlich maschineller Staging-Ingress.
|
|
- `BASIC_AUTH_USER/PASSWORD`: Knowledgebase-Editor.
|
|
- `WEB_USERNAME/PASSWORD`: Agent-Webzugang.
|
|
- `SEARXNG_SECRET`: nur optionaler SearXNG-Container/Betreiber.
|
|
- GLPI-Credentials: ausschließlich Agent.
|
|
|
|
## Failure-Policy
|
|
|
|
| Einstellung | NeuroForge nicht erreichbar | Verhalten |
|
|
|---|---|---|
|
|
| `local` | irrelevant | Agent bleibt vollständig lokal |
|
|
| `dual` | Fehler wird geloggt | lokale Vektoren bleiben erhalten |
|
|
| `neuroforge` + fail-open | Fehler wird geloggt | lokale/lexikalische Evidenz soweit verfügbar |
|
|
| `neuroforge` + fail-closed | Fehler wird propagiert | semantischer Schritt blockiert kontrolliert |
|
|
|
|
## Outcome-Learning Failure-Policy
|
|
|
|
| Einstellung | NeuroForge-Sync nach Technikerentscheidung | Verhalten |
|
|
|---|---|---|
|
|
| `OUTCOME_LEARNING_ENABLED=false` | nicht ausgeführt | kein Outcome-Learning |
|
|
| enabled + `FAIL_OPEN=false` | Fehler | lokaler Audit bleibt `failed`, UI meldet Fehler |
|
|
| enabled + `FAIL_OPEN=true` | Fehler | lokaler Audit bleibt `failed`, Workflow darf fortfahren |
|
|
| enabled + Sync OK | Erfolg | Audit `learned` + NeuroForge Memory-ID |
|
|
|
|
## Nicht lernende Kontrollinformationen
|
|
|
|
Folgende Informationen bleiben absichtlich außerhalb des NeuroForge-Learnings:
|
|
|
|
- GLPI OAuth/API-Secrets
|
|
- Auto-Reply-Policy
|
|
- Eskalationsregeln
|
|
- Idempotenz-/Run-State
|
|
- Schreibfreigaben
|
|
- Source-Allowlisten
|
|
- Review-/Promotion-Status
|
|
|
|
## v1.3 zusätzliche Daten- und Aktionsgrenzen
|
|
|
|
| Akteur | Outcome suchen | Outcome lernen | Outcome superseden | Quality Replay | Auto-Reply autorisieren |
|
|
|---|---:|---:|---:|---:|---:|
|
|
| GLPI Agent App-Key | ja, nur aktives validated Outcome API | ja, accepted/corrected | indirekt nur über neue korrigierte Revision | nein über NeuroForge; eigener read-only Agent-Endpunkt | nur über bestehende Agent-Policies + freigegebene KB |
|
|
| Agent Web-Operator | indirekt sichtbar | explizit bestätigen/korrigieren | durch Korrektur | ja, authentifiziert/read-only | nicht durch Outcome allein |
|
|
| NeuroForge Admin | technische Brain-Administration | technisch ja | technisch ja | nein | nein |
|
|
| Control Center | Status/Konfiguration sichtbar | nein | nein | Verfügbarkeit sichtbar | nein |
|
|
| Research/SearXNG | nein | Research-Evidence, nicht trusted outcome | nein | nein | nein |
|
|
|
|
`POST /api/v1/integrations/outcomes/search` akzeptiert den NeuroForge App-Key und liefert ausschließlich aktive Memories der serverseitig festgelegten Outcome-Provenance. Es ist kein generischer Memory-Search-Endpunkt und gewährt keine Admin-Funktionen.
|
|
|
|
### v1.4 graph scopes
|
|
|
|
| Actor | Capability | Credential | Write authority |
|
|
|---|---|---|---|
|
|
| Control -> Agent | runs/evidence/learning graphs | `CONTROL_READ_TOKEN` | none |
|
|
| Control -> NeuroForge | research/brain graph | app API key | none through graph endpoints |
|
|
| Control -> embedded Engineering Graph | structural read | none/internal | none |
|
|
| Optional Codebase Memory MCP | developer code analysis | local process / allowed root | none in platform |
|