Phase 1: Cluster-Fundament – Nachrichten, Registry, Paarung, Discovery

- 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
This commit is contained in:
HMS MediaEngine Agent
2026-09-11 01:06:26 +02:00
parent 80dc10de22
commit c4574927fd
14 changed files with 1190 additions and 14 deletions
+6 -3
View File
@@ -10,6 +10,8 @@ mit ADR und Freigabe (PLAN.md §1).
- 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)
@@ -20,6 +22,7 @@ mit ADR und Freigabe (PLAN.md §1).
- ADR-0006: Frontend React vs. Svelte (Entscheidung zu Beginn Phase 5)
- ADR-0007: Typprüfung mypy vs. pyright
- weitere gemäß Bauplan §32 (Persistenz, Preview, Show-Codec, Ownership,
Display-Abstraktion, Adaptive-Quality-Policy, Discovery, Clusterprotokoll,
Paarung/TLS, Clock-Sync, UI-Design-Tokens)
- 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)