# 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