Files

T

HMS MediaEngine Agent 362e089be0 AUFGERAUMT: Root auf 10 sichtbare Elemente reduziert

Der Nutzer hat recht: Der Ordner war voller Entwicklungs-Muell.
Jetzt ist sauber getrennt:

ROOT (was der Nutzer sieht und braucht):
- run.py                     = das Programm
- hms_app/                   = der Anwendungscode
- HMS MediaEngine.app        = macOS Doppelklick-Starter
- HMS-Start.vbs              = Windows Doppelklick-Starter
- HMS-Install.vbs             = Windows Erst-Installation
- HMS-Mac-Install.command     = macOS Homebrew-Installation
- HMS-Portable-Install.command = macOS Portable-Installation (16GB-Fix)
- installer_gui.py           = grafischer Installer
- launcher.pyw + launcher_core.py = interne Start-Logik
- LIESMICH.txt               = 10-Zeilen-Kurzanleitung
- .gitignore

_entwicklung/ (alles andere, NICHT benoetigt):
- packages/ apps/ native/ plugins/ tools/ schemas/ tests/ docs/
  build/ fixture_profiles/
- PLAN.md STATUS.md ERRORS.md TEST_REPORT.md CHANGELOG.md README.md
- pyproject.toml uv.lock setup_*.sh/ps1 make_mac_app.py

Diese Trennung gilt ab sofort fuer alle Commits. Der Nutzer kann
_entwicklung/ loeschen wenn er Platz braucht - die App laeuft ohne.

Verifiziert: App startet nach Aufraeumen unveraendert (Health 200).

2026-09-11 23:44:06 +02:00

850 B

Raw Blame History

ADR-0003: IPC – lokales TCP mit length-prefixed MessagePack

Status: Angenommen (Bauplan-Vorgabe §6.2; umgesetzt in packages/protocol)
Datum: 2026-09-10
Phase: 0

Entscheidung

Control Core ↔ Renderer kommunizieren über lokales TCP auf 127.0.0.1 mit length-prefixed MessagePack (4-Byte-Big-Endian-Länge, Protokollversion 1, Idempotency-Keys; Heartbeat ab Phase 1). JSON ausschließlich im Debugmodus.

Alternativen

Named Pipes/Unix Sockets: plattformspezifische API-Unterschiede, kein Nutzen im Spike.
JSON-Lines: langsamer und größer; nur für Debug erlaubt (§6.2).

Folgen

hms_protocol definiert Envelope, Framing und Idempotency-Registry mit Unit-Tests.
IPC bindet niemals an eine externe Netzwerkschnittstelle (§6.2).

Freigabe

Direkte Umsetzung der normativen Vorgabe PLAN.md §6.2.

850 B Raw Blame History Unescape Escape