HMS MediaEngine Agent
c4574927fd
- hms_cluster: ClusterMessage (§6.5: Pflichtfelder, Sequenzen, Revisionen, execute_at, Trace-ID), CommandTracker (idempotent, vorwärts-only: accepted->armed->executed/failed) - NodeRegistry: online/degraded/stale/offline über Schwellen, UI-Kategorien discovered/paired/unknown/incompatible/offline, Doppel-Node-ID blockiert, IP-Wechsel erhaelt node_id (§6.3, §6.5) - Pairing: PIN (TTL 120s, Versuchslimit), Fingerprint (SHA-256 gruppiert), Token nur als Hash, Scopes read/control/content_sync/admin, Ablauf + sofortiger Widerruf (§6.3, §27.1, ADR-0010) - Discovery-Modell: _hmsmedia._tcp.local. TXT ohne Secrets, Capability- Digest, persistente manuelle Fallback-Liste (ADR-0009) - ADR-0009 (mDNS + Fallback) und ADR-0010 (Paarung) dokumentiert - 25 Unit-Tests; Gesamtsuite 183 Tests gruen, Ruff gruen
Architecture Decision Records
Vorlage: _template.md. Nummerierung fortlaufend. Abweichungen vom Bauplan nur
mit ADR und Freigabe (PLAN.md §1).
Angenommen
- ADR-0001: Python-Version-Pin 3.13
- ADR-0002: GStreamer-Pin 1.28.6 (Windows)
- ADR-0003: IPC – lokales TCP + length-prefixed MessagePack v1
- ADR-0008: Build-first-Strategie – verzögerte Hardware-Validierung (Auftraggeber-Freigabe 2026-09-11)
- ADR-0009: Node-Discovery – mDNS/DNS-SD mit manueller Fallback-Liste
- ADR-0010: Node-Paarung – PIN/Fingerprint, Token-Scopes, Widerruf
Vorläufig angenommen (Bestätigung im Windows-Durchlauf, ADR-0008)
- ADR-0004: Nativer Renderkern – Rust auf dem GStreamer-D3D11-Elementpfad
- ADR-0005: Packaging – Nuitka Onefolder (Fallback PyInstaller)
Offen
- ADR-0006: Frontend – React vs. Svelte (Entscheidung zu Beginn Phase 5)
- ADR-0007: Typprüfung – mypy vs. pyright
- weitere gemäß Bauplan §32 (Persistenz → erledigt in Phase 1 ohne eigene ADR-Nummer, da §24-Vorgaben 1:1 umgesetzt; Preview, Show-Codec, Ownership, Display-Abstraktion, Adaptive-Quality-Policy, Clusterprotokoll-Transport, TLS-Details, Clock-Sync, UI-Design-Tokens)