Epic: Engine-Distribution — verlässlich, versioniert, einbettbar (Runtime + SDK + Installer + CI)

[geisten]

Ziel

Die Distribution & Konsumierbarkeit der geisten-Engine verlässlich, versioniert und einbettbar machen. geisten ist eine Engine, die von Anwendungen konsumiert wird — nie eine direkt heruntergeladene Endnutzer-App. Dieses Epic bündelt die Arbeit, die den Konsum über alle Zielumgebungen hinweg verlässlich, versioniert, updatefähig macht (Design-Interview 2026-07-12).

Leitentscheidungen (der Rahmen für alle Sub-Issues)

• Primär: die Runtime (geist --serve + dynamic-tools-v1) — sprachagnostisch, prozess-isoliert, gehärtet. Sekundär: das libgeist-SDK zum In-Process-Einbetten.
• Kompatibilitätsvertrag = Protokollversion + SHA-256-Checksum + Start-Health-Handshake. Binary-Semver ist informativ; Update = Binary gleicher Protokollversion tauschen. SHA-256 reicht (keine signierte Provenance).
• Interop-Oberflächen (OpenAI-kompatibel, MCP) leben in separaten Konsumenten-Projekten, nicht im Core — der Core bleibt Socket-only, dependency-free, gehärtet.
• v1 ist non-streaming; Streaming ist als additiver Erweiterungspunkt reserviert (kein Sackgassen-Protokoll).
• Alle gelieferten Umgebungen müssen in CI getestet sein — keine stille Lücke.

Gebündelte Issues

Primärer Pfad (Runtime + Vertrag)

• Release: dynamic-tools-v1 Runtime-Artefakt (wiederverwendbar; HA Phase 5 = erster Konsument) #87 — Release: dynamic-tools-v1 Runtime-Artefakt (wiederverwendbar; HA = erster Konsument)
• dynamic-tools-v1: Kompatibilitätsvertrag dokumentieren + Streaming additiv reservieren #92 — dynamic-tools-v1: Kompatibilitätsvertrag dokumentieren + Streaming additiv reservieren

User-facing Install & sekundärer Einbett-Pfad

• install.sh: x86_64-Support + SHA-256-Verifikation im curl|sh-Pfad #90 — install.sh: x86_64-Support + SHA-256-Verifikation im curl|sh-Pfad
• libgeist als versioniertes SDK-Release-Artefakt (sekundärer Einbett-Pfad) #91 — libgeist als versioniertes SDK-Release-Artefakt (sekundärer Einbett-Pfad)

Querschnitts-Qualitätsgate

• CI/CD: alle Zielumgebungen testen — x86_64-Test-Leg fehlt, int/e2e nur auf arm64 #93 — CI/CD: alle Zielumgebungen testen (x86_64-Test-Leg fehlt; int/e2e nur auf arm64)

Abhängigkeiten / Reihenfolge

1. Release: dynamic-tools-v1 Runtime-Artefakt (wiederverwendbar; HA Phase 5 = erster Konsument) #87 + dynamic-tools-v1: Kompatibilitätsvertrag dokumentieren + Streaming additiv reservieren #92 sind der Kern (Runtime-Artefakt + der Vertrag, auf den alle bauen).
2. install.sh: x86_64-Support + SHA-256-Verifikation im curl|sh-Pfad #90 hängt an Release: dynamic-tools-v1 Runtime-Artefakt (wiederverwendbar; HA Phase 5 = erster Konsument) #87 (nutzt die veröffentlichten Artefakte + SHA256SUMS).
3. libgeist als versioniertes SDK-Release-Artefakt (sekundärer Einbett-Pfad) #91 ist parallel (sekundär).
4. CI/CD: alle Zielumgebungen testen — x86_64-Test-Leg fehlt, int/e2e nur auf arm64 #93 unterlegt alle — kein Release/Installer/SDK gilt als „verlässlich", bevor die Zielumgebung in CI getestet ist.

Definition of Done (Epic)

• Ein versioniertes, checksummtes Runtime-Artefakt existiert, das ein beliebiger Konsument über Protokollversion + Checksum + Health-Handshake pinnen und durch Binary-Tausch updaten kann (Release: dynamic-tools-v1 Runtime-Artefakt (wiederverwendbar; HA Phase 5 = erster Konsument) #87, dynamic-tools-v1: Kompatibilitätsvertrag dokumentieren + Streaming additiv reservieren #92).
• Der curl|sh-Pfad installiert checksum-verifiziert auf allen drei gelieferten Plattformen (install.sh: x86_64-Support + SHA-256-Verifikation im curl|sh-Pfad #90).
• Ein libgeist-SDK-Artefakt (lib + Header) je Plattform ist released und mit einem Smoke-Beispiel belegt (libgeist als versioniertes SDK-Release-Artefakt (sekundärer Einbett-Pfad) #91).
• Die CI testet jede gelieferte Umgebung (macos-arm64, linux-arm64, linux-x86_64 AVX-512 + scalar-Fallback), inkl. int/e2e auf x86_64 und der musl-static-Release-Variante (CI/CD: alle Zielumgebungen testen — x86_64-Test-Leg fehlt, int/e2e nur auf arm64 #93).
• Kein gelieferter Pfad (Runtime, Installer, SDK) ist ungetestet oder unversioniert.

Ausdrücklich nicht in diesem Epic

• HA-Integration/Policy (→ geisten/geist-home-assistant).
• OpenAI-/MCP-Interop-Gateways (→ separate Konsumenten-Projekte).
• Per-Sprache-Bindings (Swift/Kotlin) / Mobile (späterer Track).