| # 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 |
|
|
