@@ -63,3 +63,19 @@ The canonical `.env.example` now contains these settings explicitly.
|
||||
Never commit `.env`. The tracked file must remain `.env.example` only.
|
||||
If credentials were pasted into issue trackers, chats, CI logs, shell history or screenshots,
|
||||
rotate them before production use.
|
||||
|
||||
## Research → Knowledge Staging (v1.4.5+)
|
||||
|
||||
The autonomous research bridge is controlled independently from Research and Goal Learning:
|
||||
|
||||
```env
|
||||
NEUROFORGE_KB_STAGING_ENABLED=true
|
||||
NEUROFORGE_KB_STAGING_MIN_EVIDENCE=4
|
||||
NEUROFORGE_KB_STAGING_MIN_SOURCES=2
|
||||
NEUROFORGE_KB_STAGING_MIN_CORROBORATIONS=0
|
||||
NEUROFORGE_KB_STAGING_MAX_EVIDENCE=12
|
||||
```
|
||||
|
||||
`NEUROFORGE_KB_STAGING_URL` and `NEUROFORGE_KB_STAGING_TOKEN` are container-internal values owned by the root Compose file. The token is derived from the existing `KB_INTEGRATION_TOKEN`; do not duplicate it under a second operator-managed secret name.
|
||||
|
||||
This bridge can only create/update **human-review staging**. The Knowledge service enforces `auto_reply=false` and does not expose production promotion through this integration token.
|
||||
|
||||
@@ -0,0 +1,28 @@
|
||||
# Migration v1.4.4 → v1.4.5
|
||||
|
||||
Es ist **keine Datenmigration** nötig. Bestehende Research-Runs und Goals werden weiterverwendet; beim NeuroForge-Start wird der Goal-Fortschritt aus den persistierten Research-Runs rückwirkend rekonstruiert.
|
||||
|
||||
## Empfohlene Konfiguration
|
||||
|
||||
```env
|
||||
NEUROFORGE_CONTROLLED_LEARNING=true
|
||||
NEUROFORGE_GOAL_LEARNING_ENABLED=true
|
||||
NEUROFORGE_RESEARCH_ENABLED=true
|
||||
NEUROFORGE_RESEARCH_GOAL_ENABLED=true
|
||||
NEUROFORGE_KB_STAGING_ENABLED=true
|
||||
NEUROFORGE_KB_STAGING_MIN_EVIDENCE=4
|
||||
NEUROFORGE_KB_STAGING_MIN_SOURCES=2
|
||||
NEUROFORGE_KB_STAGING_MIN_CORROBORATIONS=0
|
||||
```
|
||||
|
||||
`KB_INTEGRATION_TOKEN` muss gesetzt sein. Compose reicht denselben Wert ausschließlich als `NEUROFORGE_KB_STAGING_TOKEN` an NeuroForge und als `KB_INTEGRATION_TOKEN` an den Knowledge-Service weiter.
|
||||
|
||||
## Verhalten nach dem Upgrade
|
||||
|
||||
- vorhandene Research-Goals zeigen nach Neustart einen aus ihren historischen Runs berechneten Fortschritt;
|
||||
- beim nächsten qualifizierten Goal-Cycle wird ein Human-Review-Draft angelegt;
|
||||
- weitere Zyklen mit neuer Evidenz aktualisieren denselben aktiven Draft;
|
||||
- ohne neue Evidenz wird der Draft nicht erneut geschrieben;
|
||||
- Promotion bleibt ausschließlich menschlich im Knowledge-Editor möglich.
|
||||
|
||||
Rollback auf v1.4.4 ist möglich. Bereits erzeugte Staging-Dateien sind normale Knowledge-Staging-JSONs und bleiben erhalten; v1.4.4 würde sie lediglich nicht mehr autonom aktualisieren.
|
||||
+24
-5
@@ -1,16 +1,16 @@
|
||||
# Validierung
|
||||
|
||||
Stand: 26.08.2026 — Release v1.4.4
|
||||
Stand: 26.08.2026 — Release v1.4.5
|
||||
|
||||
## Umfang
|
||||
|
||||
- 4 Go-Module im gemeinsamen `go.work`
|
||||
- 159 Go-Dateien
|
||||
- 47.489 Go-Codezeilen inklusive Tests
|
||||
- 281 `Test...`-Testfunktionen
|
||||
- 162 Go-Dateien
|
||||
- 48.303 Go-Codezeilen inklusive Tests
|
||||
- 289 `Test...`-Testfunktionen
|
||||
- 103 produktive Knowledge-JSON-Dateien
|
||||
- 8 Compose-Services inklusive optionalem SearXNG-Profil
|
||||
- reproduzierbarer Engineering-Snapshot: 1.652 Knoten / 6.450 Kanten
|
||||
- reproduzierbarer Engineering-Snapshot: 1.669 Knoten / 6.525 Kanten
|
||||
|
||||
## Vollständige Modulprüfung
|
||||
|
||||
@@ -81,3 +81,22 @@ Vor Produktivfreigabe bleiben Container-Smoke-Test, echte GLPI-/Research-Konnekt
|
||||
- NeuroForge `go test ./...`, `go vet ./...`, `go build ./...`: **OK**
|
||||
- NeuroForge `go test -race ./internal/store ./internal/httpapi`: **OK**
|
||||
- eingebettetes NeuroForge-JavaScript `node --check`: **OK**
|
||||
|
||||
## v1.4.5-spezifische Prüfungen
|
||||
|
||||
- Research→Knowledge-Bridge ist tatsächlich vom NeuroForge-Goal-Cycle bis `POST /api/integrations/staging` verdrahtet: **OK**
|
||||
- Knowledge-Staging erzwingt weiterhin `auto_reply=false`: **OK**
|
||||
- stabiler `integration_key` aktualisiert einen aktiven Goal-Draft statt Duplikate zu erzeugen: **OK**
|
||||
- Goal-Target `100 ... Wissenseinträge` wird gegen `new_evidence` statt fälschlich gegen Source-Anzahl gemessen: **OK**
|
||||
- historische Research-Runs werden zur Progress-Rekonstruktion herangezogen: **OK**
|
||||
- eigene `goal-learning`-/`goal-cycle`-Memories werden aus der nächsten Goal-Evaluation entfernt: **OK**
|
||||
- `NextAction`/Scheduler-Metatext wird nicht mehr als Research-Query verwendet; Screenshot-Fehlmuster `Review the strongest negative evidence ... next cycle` wird explizit abgewiesen: **OK**
|
||||
- persistente Goal-Zähler verhindern Progress-Rückschritt bei bounded/gekürzter Research-Run-Historie: **OK**
|
||||
- Staging-Publisher übermittelt Goal-/Run-/Evidence-/Source-Provenance und speichert Draft-ID/Fehler am Goal: **OK**
|
||||
- vorhandener Draft wird bei einem Zyklus ohne neue Evidenz/Corroboration nicht unnötig neu geschrieben: **OK**
|
||||
- NeuroForge `go test -race ./internal/brain ./internal/store ./internal/httpapi`: **OK**
|
||||
- Knowledge `go test -race ./internal/staging ./cmd/server`: **OK**
|
||||
- Control Center `go test -race ./...`: **OK**
|
||||
- NeuroForge- und Control-Center-JavaScript `node --check`: **OK**
|
||||
- Compose- und SearXNG-YAML Parse: **OK**
|
||||
- Upgrade-Patch `v1.4.4-to-v1.4.5.diff` wurde auf einen unveränderten v1.4.4-Stand mit `git apply --check` und `git apply` angewendet; NeuroForge Brain/Store/Server sowie Knowledge Staging/Server testen danach grün: **OK**
|
||||
|
||||
Reference in New Issue
Block a user