File size: 2,133 Bytes
f2cf4fa | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 | # Spine V1
Spine ist die kanonische Integrationsschicht zwischen:
- `MetaMetaMeta` als Evidence- und Eval-Layer
- `KomandoZentral` als Decision-Layer
- `UEBER_AGENT` als Execution-Layer
- `AgentIDE` als Operator-UI
- `HarnessEcosystem` als Observatory- und Docs-Layer
Diese Implementierung ist absichtlich `spec-first`. Sie definiert:
- kanonische Kernobjekte
- versionierte JSON-Schemas
- eine maschinenlesbare Registry
- einen Beispiel-Run von Intent bis Eval
- ein lokales Validierungsskript
## Kernprinzip
Spine ersetzt keine der bestehenden Runtime- oder UI-Systeme. Spine erzwingt nur, dass alle Systeme dieselben Objekte, IDs und Zustandsuebergaenge sprechen.
Formel:
`Spine = Registry + Schemas + Run-State + Event-Log + Artifact-Index + Adapter-Vertraege`
## Repo-Struktur
- `docs/` Architektur- und Integrationsbeschreibung
- `schemas/` kanonische JSON-Schemas
- `registry/` Systemmanifest, Harness- und Adapter-Registry
- `examples/` durchgaengiger Beispiel-Run
- `scripts/validate_spine.py` lokale Konsistenzpruefung
## Wichtige Kernobjekte
- `TaskRequest`
- `RoutingDecision`
- `RunRecord`
- `ExecutionRequest`
- `ExecutionStatus`
- `RouteTrace`
- `ArtifactManifest`
- `EvalRecord`
- `SpineEvent`
- `SystemManifest`
## Lifecycle
1. `TaskRequest` wird erzeugt.
2. `KomandoZentral` liefert eine `RoutingDecision`.
3. Spine erzeugt oder aktualisiert den `RunRecord`.
4. Ein `ExecutionRequest` wird an die Runtime uebergeben.
5. Runtime meldet `ExecutionStatus`, `RouteTrace` und `ArtifactManifest`.
6. Evidence- und Observatory-Layer konsumieren `EvalRecord` und Event-Historie.
## Validierung
```bash
python3 /home/smlflg/Projekte/MultiHarnessStudio/scripts/validate_spine.py
```
Das Skript validiert:
- dass alle JSON-Dateien parsebar sind
- dass die Kernschemas vorhanden sind
- dass Registry-Eintraege eindeutig sind
- dass der Beispiel-Run intern konsistent ist
## V1 Defaults
- lokal-first
- JSON als Austauschformat
- append-only Event-Historie
- versionierte Schemas
- Registry als Source of Truth fuer Integrationsvertraege
- Adapter duerfen uebersetzen, aber keine Spine-Kernobjekte verbiegen
|