Phase 0: Repository-Initialisierung nach Bauplan v1.2

- Struktur gemäß §8 (Eigentumsgrenzen), PLAN.md als normative Basis
- Pflichtdokumente: STATUS.md, ERRORS.md, TEST_REPORT.md, CHANGELOG.md, ADRs
- ADR-0001 Python 3.13-Pin, ADR-0002 GStreamer 1.28.6-Pin (Windows),
  ADR-0003 IPC TCP+MessagePack v1
- Kernpakete: hms_protocol, hms_domain, hms_parameter, hms_artnet,
  hms_adaptive, hms_capabilities, hms_plugin_sdk
- Renderer-Spike: D3D11-Primärpfad + Dev-GL-Pfad (§36 Nr. 4-5)
- Control Core: FastAPI REST + WebSocket (§36 Nr. 9)
- Beispielplugins: Passthrough + Gaussian Blur (3 Adaptive-Quality-
  Varianten, HLSL/GLSL/GLES)
- Tools: Art-Net-Emulator, Fixture-Generator (Master32/Layer64-CSV),
  Capability-Probe
- JSON-Schemas: IPC, Plugin, Projekt, Cluster
- 121 Unit-/Integrationstests grün, Ruff grün

Gate 0 bleibt offen: Hardwaremessungen nur auf echter Windows-Referenz-
hardware gültig (§29.7, §33).

tests/integration/test_control_server.py

@@ -0,0 +1,121 @@
+"""Integrationstests Control Core (PLAN.md §6.1B, §23, §36 Nr. 9).
+
+FastAPI-REST + WebSocket mit derselben Parameter-Engine, die auch
+Art-Net bedient (§11: eine autoritative Instanz).
+"""
+
+from __future__ import annotations
+
+import uuid
+
+import pytest
+from fastapi.testclient import TestClient
+from hms_control_server import create_app
+
+
+@pytest.fixture()
+def client() -> TestClient:
+    return TestClient(create_app())
+
+
+def _payload(path: str, value: float) -> dict:
+    return {"parameter_path": path, "value": value}
+
+
+@pytest.fixture()
+def path() -> str:
+    return f"composition/{uuid.uuid4()}/layer/{uuid.uuid4()}/opacity"
+
+
+# ---------- Health/Capabilities ----------
+
+
+def test_health(client: TestClient) -> None:
+    r = client.get("/api/v1/system/health")
+    assert r.status_code == 200
+    assert r.json()["status"] == "ok"
+    assert r.json()["phase"] == 0
+
+
+def test_capabilities_reported_without_fake_tier(client: TestClient) -> None:
+    r = client.get("/api/v1/system/capabilities")
+    assert r.status_code == 200
+    body = r.json()
+    assert body["tier"] is None  # ungeprüft (CPU-only-Umgebung), kein Fake
+
+
+def test_diagnostics_reports_not_connected(client: TestClient) -> None:
+    r = client.get("/api/v1/diagnostics")
+    assert r.status_code == 200
+    assert r.json()["renderer"] == "not_connected"  # IPC-Handshake Phase 1
+
+
+# ---------- Commands (§23.2) ----------
+
+
+def test_parameter_set_command_ack(client: TestClient, path: str) -> None:
+    r = client.post("/api/v1/commands", json={"payload": _payload(path, 0.75)})
+    assert r.status_code == 200
+    body = r.json()
+    assert body["status"] == "ack"
+    assert body["effective"] == pytest.approx(0.75)
+
+
+def test_duplicate_command_id_is_idempotent(client: TestClient, path: str) -> None:
+    cmd = {"command_id": str(uuid.uuid4()), "payload": _payload(path, 0.5)}
+    first = client.post("/api/v1/commands", json=cmd).json()
+    second = client.post("/api/v1/commands", json=cmd).json()
+    assert first["status"] == "ack"
+    assert second.get("duplicate") is True  # gleiches Ack, kein Doppel-Apply
+    assert second["result"]["revision"] == first["revision"]
+
+
+def test_revision_conflict_returns_409(client: TestClient, path: str) -> None:
+    r = client.post(
+        "/api/v1/commands",
+        json={"payload": _payload(path, 0.5), "expected_revision": 999},
+    )
+    assert r.status_code == 409
+    assert r.json()["detail"]["error"] == "REVISION_CONFLICT"
+
+
+def test_invalid_parameter_path_returns_400(client: TestClient) -> None:
+    r = client.post(
+        "/api/v1/commands",
+        json={"payload": _payload("../evil/path", 1.0)},
+    )
+    assert r.status_code == 400
+
+
+def test_unknown_command_type_returns_400(client: TestClient) -> None:
+    r = client.post("/api/v1/commands", json={"type": "renderer.draw", "payload": {}})
+    assert r.status_code == 400
+
+
+def test_parameters_endpoint_reflects_state(client: TestClient, path: str) -> None:
+    client.post("/api/v1/commands", json={"payload": _payload(path, 0.42)})
+    r = client.get("/api/v1/parameters")
+    assert r.status_code == 200
+    assert r.json()["values"][path] == pytest.approx(0.42)
+    assert r.json()["revision"] >= 1
+
+
+# ---------- WebSocket (§23.3) ----------
+
+
+def test_websocket_snapshot_on_connect(client: TestClient, path: str) -> None:
+    client.post("/api/v1/commands", json={"payload": _payload(path, 0.33)})
+    with client.websocket_connect("/ws") as ws:
+        snap = ws.receive_json()
+        assert snap["type"] == "snapshot"
+        assert snap["values"][path] == pytest.approx(0.33)
+
+
+def test_websocket_receives_parameter_updates(client: TestClient, path: str) -> None:
+    with client.websocket_connect("/ws") as ws:
+        ws.receive_json()  # Initial-Snapshot
+        client.post("/api/v1/commands", json={"payload": _payload(path, 0.9)})
+        event = ws.receive_json()
+        assert event["type"] == "parameter.update"
+        assert event["parameter_path"] == path
+        assert event["value"] == pytest.approx(0.9)