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).

apps/renderer/hms_renderer/pipelines.py

@@ -0,0 +1,79 @@
+"""Renderer-Pipeline-Definitionen (PLAN.md §12, §13, §36 Nr. 4–5).
+
+Windows-Primärpfad (§12.6): d3d11h264dec → D3D11Memory → d3d11compositor
+→ d3d11videosink. Kein CPU-Rundweg (Decoder → RAM → Upload verboten).
+
+DevGL-Pfad: Nur für Entwicklung/CI-Umgebungen ohne D3D11; ausdrücklich
+gekennzeichnet, kein stiller Ersatz im Normalbetrieb (§5.2, §33).
+"""
+
+from __future__ import annotations
+
+import shutil
+from dataclasses import dataclass
+
+
+@dataclass(frozen=True)
+class D3D11Pipeline:
+    """Primärpipeline Windows: durchgängig D3D11Memory."""
+
+    video_a: str
+    video_b: str
+    width: int = 1920
+    height: int = 1080
+    fullscreen: bool = True
+
+    def launch_string(self) -> str:
+        sink = "d3d11videosink fullscreen=true" if self.fullscreen else "d3d11videosink"
+        # Zwei Quellen → Compositor → Ausgabe (§36 Nr. 5: zwei Videos GPU-mischen)
+        return (
+            f"d3d11compositor name=mix sink_0::xpos=0 sink_0::ypos=0 "
+            f"sink_0::width={self.width // 2} sink_0::height={self.height} "
+            f"sink_1::xpos={self.width // 2} sink_1::ypos=0 "
+            f"sink_1::width={self.width // 2} sink_1::height={self.height} ! "
+            f"d3d11convert ! video/x-raw(memory:D3D11Memory),format=RGBA,"
+            f"width={self.width},height={self.height} ! {sink} "
+            f"uridecodebin uri=file:///{self.video_a} ! queue ! "
+            f"d3d11convert ! mix. "
+            f"uridecodebin uri=file:///{self.video_b} ! queue ! "
+            f"d3d11convert ! mix."
+        )
+
+
+@dataclass(frozen=True)
+class DevGLPipeline:
+    """Entwicklungspfad ohne D3D11 (explizit gekennzeichnet, kein Normalpfad).
+
+    Nur für CI/Dev ohne Windows-GPU; die Backend-Schnittstelle bleibt
+    identisch (§12.6)."""
+
+    video_a: str
+    video_b: str
+    width: int = 960
+    height: int = 540
+
+    def launch_string(self) -> str:
+        return (
+            f"glvideomixer name=mix ! glimagesink "
+            f"uridecodebin uri=file:///{self.video_a} ! queue ! glupload ! mix. "
+            f"uridecodebin uri=file:///{self.video_b} ! queue ! glupload ! mix."
+        )
+
+
+def build_single_video_pipeline(video: str, d3d11: bool = True) -> str:
+    """Minimale Einzelquellen-Pipeline (§36 Nr. 4: Testvideo → Vollbild)."""
+    if d3d11:
+        return f"uridecodebin uri=file:///{video} ! d3d11convert ! d3d11videosink fullscreen=true"
+    return f"uridecodebin uri=file:///{video} ! glupload ! glimagesink"
+
+
+def build_compositor_pipeline(video_a: str, video_b: str, d3d11: bool = True) -> str:
+    """Zwei-Quellen-Compositing (§36 Nr. 5: GPU-Mischen ohne CPU-Readback)."""
+    if d3d11:
+        return D3D11Pipeline(video_a=video_a, video_b=video_b).launch_string()
+    return DevGLPipeline(video_a=video_a, video_b=video_b).launch_string()
+
+
+def gst_available() -> bool:
+    """True, wenn ein GStreamer-CLI auf dem System liegt (Diagnose, kein Fake)."""
+    return shutil.which("gst-launch-1.0") is not None