smlflg/MultiHarnessStudio

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

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