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).
This commit is contained in:
HMS MediaEngine Agent
@@ -0,0 +1,20 @@
|
||||
{
|
||||
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
||||
"$id": "hms/schemas/cluster/cluster_message_v1.schema.json",
|
||||
"title": "HMS Cluster Message v1",
|
||||
"description": "PLAN.md §6.5: Jede Cluster-Nachricht enthält mindestens cluster_id, node_id, command_id, Sequenz, Projekt-Revision, Absenderzeit und Trace-ID.",
|
||||
"type": "object",
|
||||
"required": ["cluster_id", "node_id", "command_id", "sequence", "project_revision", "sender_time_ns", "trace_id"],
|
||||
"properties": {
|
||||
"cluster_id": {"type": "string", "format": "uuid"},
|
||||
"node_id": {"type": "string", "format": "uuid"},
|
||||
"command_id": {"type": "string", "format": "uuid"},
|
||||
"sequence": {"type": "integer", "minimum": 0},
|
||||
"project_revision": {"type": "integer", "minimum": 0},
|
||||
"sender_time_ns": {"type": "integer", "minimum": 0},
|
||||
"trace_id": {"type": "string", "format": "uuid"},
|
||||
"execute_at_show_time_ns": {"type": ["integer", "null"], "minimum": 0},
|
||||
"status": {"enum": ["accepted", "armed", "executed", "failed"]},
|
||||
"payload": {"type": "object"}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,18 @@
|
||||
{
|
||||
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
||||
"$id": "hms/schemas/ipc/envelope_v1.schema.json",
|
||||
"title": "HMS IPC Envelope v1",
|
||||
"description": "PLAN.md §6.2: Jede IPC-Nachricht besitzt mindestens diese Felder.",
|
||||
"type": "object",
|
||||
"required": ["protocol_version", "message_id", "type", "revision", "monotonic_timestamp_ns", "payload"],
|
||||
"properties": {
|
||||
"protocol_version": {"const": 1},
|
||||
"message_id": {"type": "string", "format": "uuid"},
|
||||
"type": {"enum": ["command", "event", "snapshot", "ack", "error", "telemetry"]},
|
||||
"revision": {"type": "integer", "minimum": 0},
|
||||
"monotonic_timestamp_ns": {"type": "integer", "minimum": 0},
|
||||
"payload": {"type": "object"},
|
||||
"idempotency_key": {"type": "string"}
|
||||
},
|
||||
"additionalProperties": false
|
||||
}
|
||||
@@ -0,0 +1,91 @@
|
||||
{
|
||||
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
||||
"$id": "hms/schemas/plugin/plugin_manifest_v1.schema.json",
|
||||
"title": "HMS Plugin Manifest v1",
|
||||
"description": "PLAN.md §14.3: Plugin-Manifest mit Backend-Entrypoints, Parameters und Adaptive Quality.",
|
||||
"type": "object",
|
||||
"required": ["schema_version", "id", "name", "version", "api_version", "kind", "vendor", "entrypoints", "capabilities", "failure_mode"],
|
||||
"properties": {
|
||||
"schema_version": {"const": 1},
|
||||
"id": {"type": "string", "pattern": "^[a-z0-9._-]{5,}$"},
|
||||
"name": {"type": "string", "minLength": 1},
|
||||
"version": {"type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+$"},
|
||||
"api_version": {"const": 1},
|
||||
"kind": {"enum": ["source", "generator", "filter", "transition", "mixer", "output", "control", "automation"]},
|
||||
"vendor": {"type": "string", "minLength": 1},
|
||||
"entrypoints": {
|
||||
"type": "object",
|
||||
"minProperties": 1,
|
||||
"additionalProperties": {
|
||||
"type": "object",
|
||||
"required": ["type", "passes"],
|
||||
"properties": {
|
||||
"type": {"type": "string"},
|
||||
"passes": {
|
||||
"type": "array",
|
||||
"minItems": 1,
|
||||
"items": {"type": "object"}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"capabilities": {
|
||||
"type": "object",
|
||||
"required": ["minimum_tier", "supported_backends"],
|
||||
"properties": {
|
||||
"minimum_tier": {"enum": ["DESKTOP_FULL", "DESKTOP_LITE", "PI_LITE", "HEADLESS_CONTROL"]},
|
||||
"requires_input_texture": {"type": "boolean"},
|
||||
"supported_backends": {
|
||||
"type": "array",
|
||||
"items": {"enum": ["d3d11", "gl", "gles"]},
|
||||
"minItems": 1
|
||||
}
|
||||
}
|
||||
},
|
||||
"adaptive_quality": {
|
||||
"type": "object",
|
||||
"required": ["default", "variants"],
|
||||
"properties": {
|
||||
"default": {"type": "string"},
|
||||
"variants": {
|
||||
"type": "array",
|
||||
"minItems": 1,
|
||||
"items": {
|
||||
"type": "object",
|
||||
"required": ["id"],
|
||||
"properties": {
|
||||
"id": {"type": "string"},
|
||||
"internal_scale": {"type": "number", "exclusiveMinimum": 0, "maximum": 1},
|
||||
"samples": {"type": "integer", "minimum": 1}
|
||||
}
|
||||
}
|
||||
},
|
||||
"transition_ms": {"type": "number", "minimum": 0},
|
||||
"semantic_parameters_unchanged": {"type": "array", "items": {"type": "string"}}
|
||||
}
|
||||
},
|
||||
"parameters": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "object",
|
||||
"required": ["id", "label", "type", "default"],
|
||||
"properties": {
|
||||
"id": {"type": "string", "minLength": 1},
|
||||
"label": {"type": "string", "minLength": 1},
|
||||
"type": {"enum": ["float", "int", "enum", "bool", "color"]},
|
||||
"minimum": {"type": "number"},
|
||||
"maximum": {"type": "number"},
|
||||
"default": {},
|
||||
"values": {"type": "array"},
|
||||
"dmx_slots": {
|
||||
"type": "array",
|
||||
"maxItems": 8,
|
||||
"items": {"type": "integer", "minimum": 1, "maximum": 8}
|
||||
},
|
||||
"curve": {"type": "string"}
|
||||
}
|
||||
}
|
||||
},
|
||||
"failure_mode": {"enum": ["bypass", "hold", "black"]}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,60 @@
|
||||
{
|
||||
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
||||
"$id": "hms/schemas/project/project_v1.schema.json",
|
||||
"title": "HMS Project v1",
|
||||
"description": "PLAN.md §10, §24: Projektdatei mit schema_version und stabilen UUIDs. Phase 0: Kernfelder; Layer-/Effektschnitt wird in Phase 2 vollständig ausgebaut.",
|
||||
"type": "object",
|
||||
"required": ["schema_version", "id", "name", "created_at", "updated_at", "compositions"],
|
||||
"properties": {
|
||||
"schema_version": {"const": 1},
|
||||
"id": {"type": "string", "format": "uuid"},
|
||||
"name": {"type": "string", "minLength": 1},
|
||||
"created_at": {"type": "string", "format": "date-time"},
|
||||
"updated_at": {"type": "string", "format": "date-time"},
|
||||
"settings": {"type": "object"},
|
||||
"media_assets": {"type": "array", "items": {"type": "object"}},
|
||||
"compositions": {
|
||||
"type": "array",
|
||||
"items": {
|
||||
"type": "object",
|
||||
"required": ["id", "name", "width", "height", "fps", "color_space", "layers"],
|
||||
"properties": {
|
||||
"id": {"type": "string", "format": "uuid"},
|
||||
"name": {"type": "string"},
|
||||
"width": {"type": "integer", "minimum": 16, "maximum": 8192},
|
||||
"height": {"type": "integer", "minimum": 16, "maximum": 8192},
|
||||
"fps": {"type": "number", "exclusiveMinimum": 0},
|
||||
"color_space": {"enum": ["sRGB", "linear"]},
|
||||
"background_color": {"type": "string"},
|
||||
"duration": {"type": ["number", "null"]},
|
||||
"layers": {
|
||||
"type": "array",
|
||||
"maxItems": 64,
|
||||
"items": {
|
||||
"type": "object",
|
||||
"required": ["id", "name", "layer_type"],
|
||||
"properties": {
|
||||
"id": {"type": "string", "format": "uuid"},
|
||||
"name": {"type": "string"},
|
||||
"enabled": {"type": "boolean"},
|
||||
"layer_type": {"enum": ["media", "image", "solid", "generator", "adjustment", "group"]},
|
||||
"opacity": {"type": "number", "minimum": 0, "maximum": 1},
|
||||
"blend_mode": {"enum": ["normal", "add", "multiply", "screen", "lighten", "darken", "difference", "overlay", "alpha_premultiplied"]},
|
||||
"effects": {
|
||||
"type": "array",
|
||||
"maxItems": 2,
|
||||
"items": {"type": "object"}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
},
|
||||
"scenes": {"type": "array", "items": {"type": "object"}},
|
||||
"timelines": {"type": "array", "items": {"type": "object"}},
|
||||
"outputs": {"type": "array", "items": {"type": "object"}},
|
||||
"control_bindings": {"type": "array", "items": {"type": "object"}},
|
||||
"plugin_requirements": {"type": "array", "items": {"type": "object"}}
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user