motionloom 2.2.0 → 2.4.0

package/schemas/asset-identity.schema.json

@@ -0,0 +1,117 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://motionloom.dev/schemas/asset-identity.schema.json",
+  "title": "MotionLoom Asset Identity Contract",
+  "description": "Stable identity and derivation locks shared by generated or code-authored runtime variants.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "asset_id", "asset_kind", "identity", "derivation"],
+  "properties": {
+    "schema_version": { "const": "0.1" },
+    "asset_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9._/-]{2,127}$" },
+    "asset_kind": {
+      "type": "string",
+      "enum": ["character", "prop", "effect", "background", "tile", "ui", "rig"]
+    },
+    "identity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["subject_id", "reference_hashes", "camera", "coordinate_system", "scale", "pivot", "palette_lock"],
+      "properties": {
+        "subject_id": { "type": "string", "minLength": 1 },
+        "reference_hashes": {
+          "type": "array",
+          "items": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+          "minItems": 1,
+          "uniqueItems": true
+        },
+        "camera": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["projection", "width", "height", "focal_length"],
+          "properties": {
+            "projection": { "enum": ["orthographic", "perspective"] },
+            "width": { "type": "integer", "minimum": 1 },
+            "height": { "type": "integer", "minimum": 1 },
+            "focal_length": { "type": "number", "exclusiveMinimum": 0 }
+          }
+        },
+        "coordinate_system": { "enum": ["screen_y_down", "world_y_up"] },
+        "scale": { "type": "number", "exclusiveMinimum": 0 },
+        "pivot": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["x", "y", "space"],
+          "properties": {
+            "x": { "type": "number", "minimum": 0, "maximum": 1 },
+            "y": { "type": "number", "minimum": 0, "maximum": 1 },
+            "space": { "enum": ["normalized_canvas", "world"] }
+          }
+        },
+        "palette_lock": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["colors", "delta_e_tolerance"],
+          "properties": {
+            "colors": {
+              "type": "array",
+              "items": { "type": "string", "pattern": "^#[0-9a-fA-F]{6}$" },
+              "minItems": 1,
+              "uniqueItems": true
+            },
+            "delta_e_tolerance": { "type": "number", "minimum": 0, "maximum": 100 }
+          }
+        },
+        "style_profile": { "type": "string", "minLength": 1 },
+        "lighting_profile": { "type": "string", "minLength": 1 }
+      }
+    },
+    "derivation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["origin", "source_refs"],
+      "properties": {
+        "origin": { "enum": ["ai_generated", "ai_assisted", "ai_assisted_human_reviewed", "artist_authored", "code_authored", "unknown"] },
+        "generator": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["model", "task_id", "prompt_hash"],
+          "properties": {
+            "model": { "type": "string", "minLength": 1 },
+            "task_id": { "type": "string", "minLength": 1 },
+            "prompt_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+            "seed": { "type": ["integer", "string"] },
+            "tool_version": { "type": "string" }
+          }
+        },
+        "source_refs": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "minItems": 1
+        },
+        "derivation_chain": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["step", "operation", "input_hashes", "output_hash"],
+            "properties": {
+              "step": { "type": "integer", "minimum": 0 },
+              "operation": { "type": "string", "minLength": 1 },
+              "input_hashes": { "type": "array", "items": { "type": "string", "pattern": "^[a-f0-9]{64}$" } },
+              "output_hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+            }
+          }
+        }
+      }
+    },
+    "provenance_ref": { "type": "string", "minLength": 1 },
+    "notes": { "type": "string" }
+  },
+  "allOf": [
+    {
+      "if": {"properties": {"derivation": {"properties": {"origin": {"enum": ["ai_generated", "ai_assisted", "ai_assisted_human_reviewed"]}}, "required": ["origin"]}}, "required": ["derivation"]},
+      "then": {"properties": {"derivation": {"required": ["generator"]}}}
+    }
+  ]
+}

package/schemas/asset-provenance.schema.json

@@ -0,0 +1,183 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/lenhonbp/MotionLoom/blob/main/schemas/asset-provenance.schema.json",
+  "title": "MotionLoom asset provenance contract",
+  "description": "Asset-level origin, authority, readiness and human-governance contract. This schema never treats an Agent assertion as human approval.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "provenance_id", "asset", "authority", "readiness", "files", "license", "provenance_chain", "created_at"],
+  "properties": {
+    "schema_version": {"const": "1.0"},
+    "provenance_id": {"type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{2,127}$"},
+    "task_id": {"type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{2,127}$"},
+    "scene": {"type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{1,63}$"},
+    "created_at": {"type": "string", "format": "date-time"},
+    "asset": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "path", "type", "framework"],
+      "properties": {
+        "id": {"type": "string", "minLength": 1},
+        "path": {"type": "string", "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$)).+"},
+        "type": {"type": "string", "minLength": 1},
+        "framework": {"type": "string", "minLength": 1},
+        "version": {"type": "string", "minLength": 1}
+      }
+    },
+    "authority": {
+      "type": "string",
+      "enum": ["ai_generated", "ai_assisted", "ai_assisted_human_reviewed", "artist_authored", "code_authored", "unknown"]
+    },
+    "readiness": {
+      "type": "string",
+      "enum": ["blocked", "runtime_ready", "review_required", "production_eligible", "production_approved"]
+    },
+    "generator": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["model", "task_id", "source", "generated_at"],
+      "properties": {
+        "model": {"type": "string", "minLength": 1},
+        "task_id": {"type": "string", "minLength": 1},
+        "source": {"type": "string", "minLength": 1},
+        "generated_at": {"type": "string", "format": "date-time"},
+        "prompt_hash": {"type": "string", "pattern": "^[a-f0-9]{64}$"},
+        "agent": {"type": "string", "minLength": 1}
+      }
+    },
+    "human_attestation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["attestor", "attestor_type", "decision", "attested_at", "user_confirmed"],
+      "properties": {
+        "attestor": {"type": "string", "minLength": 1},
+        "attestor_type": {"type": "string", "enum": ["artist", "user"]},
+        "decision": {"type": "string", "enum": ["artist_authored", "accepted", "rejected"]},
+        "attested_at": {"type": "string", "format": "date-time"},
+        "user_confirmed": {"const": true},
+        "signature": {"type": "string", "minLength": 1}
+      }
+    },
+    "human_review": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["reviewer", "decision", "scope", "reviewed_at", "user_confirmed"],
+      "properties": {
+        "reviewer": {"type": "string", "minLength": 1},
+        "decision": {"type": "string", "enum": ["approved", "rejected", "changes_requested"]},
+        "scope": {"type": "string", "minLength": 1},
+        "reviewed_at": {"type": "string", "format": "date-time"},
+        "user_confirmed": {"const": true},
+        "notes": {"type": "string"}
+      }
+    },
+    "human_approval": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["issued_by", "decision", "approved_at", "user_confirmed"],
+      "properties": {
+        "issued_by": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["id", "type"],
+          "properties": {
+            "id": {"type": "string", "minLength": 1},
+            "type": {"type": "string", "enum": ["user", "artist"]}
+          }
+        },
+        "decision": {"const": "approved"},
+        "approved_at": {"type": "string", "format": "date-time"},
+        "user_confirmed": {"const": true},
+        "notes": {"type": "string"}
+      }
+    },
+    "license": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["spdx", "source", "attribution"],
+      "properties": {
+        "spdx": {"type": "string", "minLength": 1},
+        "source": {"type": "string", "minLength": 1},
+        "attribution": {"type": "string", "minLength": 1}
+      }
+    },
+    "files": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["path", "role", "sha256"],
+        "properties": {
+          "path": {"type": "string", "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$)).+"},
+          "role": {"type": "string", "minLength": 1},
+          "sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"},
+          "bytes": {"type": "integer", "minimum": 0}
+        }
+      }
+    },
+    "provenance_chain": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["step", "actor", "source", "timestamp"],
+        "properties": {
+          "step": {"type": "string", "minLength": 1},
+          "actor": {"type": "string", "minLength": 1},
+          "source": {"type": "string", "minLength": 1},
+          "timestamp": {"type": "string", "format": "date-time"},
+          "sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"}
+        }
+      }
+    },
+    "runtime_evidence": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "runtime", "tested_at"],
+      "properties": {
+        "status": {"type": "string", "enum": ["pass", "fail", "not_run"]},
+        "runtime": {"type": "string", "minLength": 1},
+        "tested_at": {"type": "string", "format": "date-time"},
+        "evidence_path": {"type": "string", "minLength": 1},
+        "sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"}
+      }
+    },
+    "full_gate": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "quality_gate", "visual_truth", "license", "checked_at"],
+      "properties": {
+        "status": {"type": "string", "enum": ["pass", "fail", "not_run"]},
+        "quality_gate": {"const": "pass"},
+        "visual_truth": {"const": "pass"},
+        "license": {"const": "pass"},
+        "checked_at": {"type": "string", "format": "date-time"},
+        "report_path": {"type": "string", "minLength": 1}
+      }
+    }
+  },
+  "allOf": [
+    {
+      "if": {"required": ["authority"], "properties": {"authority": {"enum": ["ai_generated", "ai_assisted", "ai_assisted_human_reviewed"]}}},
+      "then": {"required": ["generator"]}
+    },
+    {
+      "if": {"required": ["authority"], "properties": {"authority": {"const": "artist_authored"}}},
+      "then": {"required": ["human_attestation"]}
+    },
+    {
+      "if": {"required": ["authority"], "properties": {"authority": {"const": "unknown"}}},
+      "then": {"properties": {"readiness": {"const": "blocked"}}}
+    },
+    {
+      "if": {"required": ["readiness"], "properties": {"readiness": {"const": "production_approved"}}},
+      "then": {"required": ["human_approval", "full_gate"]}
+    },
+    {
+      "if": {"required": ["readiness"], "properties": {"readiness": {"const": "production_eligible"}}},
+      "then": {"required": ["full_gate"]}
+    }
+  ]
+}

package/schemas/atlas-contract.schema.json

@@ -0,0 +1,48 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://motionloom.dev/schemas/atlas-contract.schema.json",
+  "title": "MotionLoom Atlas Contract",
+  "description": "Deterministic atlas geometry and contamination boundary contract.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "image", "allow_rotation", "padding_px", "extrude_px", "regions"],
+  "properties": {
+    "schema_version": { "const": "0.1" },
+    "image": { "type": "string", "minLength": 1 },
+    "allow_rotation": { "const": false },
+    "padding_px": { "type": "integer", "minimum": 0 },
+    "extrude_px": { "type": "integer", "minimum": 0 },
+    "require_transparent_outside_regions": { "type": "boolean" },
+    "regions": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["region_id", "frame_id", "rect", "trim", "pivot"],
+        "properties": {
+          "region_id": { "type": "string", "minLength": 1 },
+          "frame_id": { "type": "string", "minLength": 1 },
+          "rect": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["x", "y", "width", "height"],
+            "properties": {
+              "x": { "type": "integer", "minimum": 0 },
+              "y": { "type": "integer", "minimum": 0 },
+              "width": { "type": "integer", "minimum": 1 },
+              "height": { "type": "integer", "minimum": 1 }
+            }
+          },
+          "trim": { "type": "boolean" },
+          "pivot": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["x", "y"],
+            "properties": { "x": { "type": "number" }, "y": { "type": "number" } }
+          }
+        }
+      }
+    }
+  }
+}

package/schemas/control-track.schema.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/lenhonbp/MotionLoom/blob/main/schemas/control-track.schema.json",
+  "title": "MotionLoom generation control track",
+  "description": "Hash-bound generation controls. It stores no prompt plaintext, API token or approval assertion.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "control_id", "asset_id", "references", "tracks", "output_profile", "created_at"],
+  "properties": {
+    "schema_version": {"const": "0.1"},
+    "control_id": {"type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{2,127}$"},
+    "asset_id": {"type": "string", "minLength": 1},
+    "created_at": {"type": "string", "format": "date-time"},
+    "references": {"type": "array", "minItems": 1, "items": {"type": "object", "additionalProperties": false, "required": ["id", "path", "sha256", "role"], "properties": {"id": {"type": "string", "minLength": 1}, "path": {"type": "string", "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$)).+"}, "sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"}, "role": {"type": "string", "enum": ["identity", "style", "pose", "camera", "motion", "palette", "lighting", "other"]}}}},
+    "tracks": {"type": "array", "minItems": 1, "items": {"type": "object", "additionalProperties": false, "required": ["id", "kind", "binding", "value_hash"], "properties": {"id": {"type": "string", "minLength": 1}, "kind": {"type": "string", "enum": ["identity", "style", "camera", "motion", "pose", "seed", "negative_prompt", "lighting", "source"]}, "binding": {"type": "string", "enum": ["required", "advisory", "not_applicable"]}, "value_hash": {"type": "string", "pattern": "^[a-f0-9]{64}$"}, "samples": {"type": "integer", "minimum": 0}}}},
+    "output_profile": {"type": "object", "additionalProperties": false, "required": ["kind"], "properties": {"kind": {"type": "string", "enum": ["image", "frame_sequence", "sprite_atlas", "layered_map", "video", "rigged_2d", "rigged_3d", "runtime_scene"]}, "fps": {"type": "number", "exclusiveMinimum": 0}, "expected_frame_count": {"type": "integer", "minimum": 1}, "loop": {"type": "boolean"}}}
+  }
+}

package/schemas/export-manifest.schema.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/lenhonbp/MotionLoom/blob/main/schemas/export-manifest.schema.json",
+  "title": "MotionLoom artifact export manifest",
+  "description": "Binds an output set to its receipt and control track for downstream runtime and Dev Lab evidence. It does not certify production readiness.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "manifest_id", "asset_id", "receipt_ref", "control_track_ref", "outputs", "created_at"],
+  "properties": {
+    "schema_version": {"const": "0.1"},
+    "manifest_id": {"type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{2,127}$"},
+    "asset_id": {"type": "string", "minLength": 1},
+    "created_at": {"type": "string", "format": "date-time"},
+    "receipt_ref": {"type": "string", "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$)).+"},
+    "control_track_ref": {"type": "string", "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$)).+"},
+    "runtime_evidence_ref": {"type": "string", "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$)).+"},
+    "outputs": {"type": "array", "minItems": 1, "items": {"type": "object", "additionalProperties": false, "required": ["path", "role", "sha256", "bytes", "target"], "properties": {"path": {"type": "string", "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$)).+"}, "role": {"type": "string", "minLength": 1}, "sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"}, "bytes": {"type": "integer", "minimum": 0}, "target": {"type": "string", "enum": ["runtime_candidate", "preview", "archive"]}}}}
+  }
+}

package/schemas/frame-geometry.schema.json

@@ -0,0 +1,79 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://motionloom.dev/schemas/frame-geometry.schema.json",
+  "title": "MotionLoom Frame Geometry Contract",
+  "description": "Measured geometry for action frames; measurements are validated against pixels, not trusted from AI self-reporting.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "asset_identity", "canvas", "invariants", "frames"],
+  "properties": {
+    "schema_version": { "const": "0.1" },
+    "asset_identity": { "type": "string", "minLength": 1 },
+    "canvas": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["width", "height", "color_space", "alpha_mode"],
+      "properties": {
+        "width": { "type": "integer", "minimum": 1 },
+        "height": { "type": "integer", "minimum": 1 },
+        "color_space": { "enum": ["srgb", "linear-srgb"] },
+        "alpha_mode": { "enum": ["straight", "premultiplied"] }
+      }
+    },
+    "invariants": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["pivot_tolerance_px", "footline_tolerance_px", "bbox_drift_tolerance_px", "min_alpha_pixels"],
+      "properties": {
+        "pivot_tolerance_px": { "type": "number", "minimum": 0 },
+        "footline_tolerance_px": { "type": "number", "minimum": 0 },
+        "bbox_drift_tolerance_px": { "type": "number", "minimum": 0 },
+        "min_alpha_pixels": { "type": "integer", "minimum": 1 },
+        "allow_external_opaque_pixels": { "type": "boolean" }
+      }
+    },
+    "frames": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["frame_id", "image", "rect", "alpha_bbox", "pivot", "footline_px", "safe_rect", "sha256"],
+        "properties": {
+          "frame_id": { "type": "string", "pattern": "^[a-z0-9][a-z0-9._-]{1,63}$" },
+          "image": { "type": "string", "minLength": 1 },
+          "rect": { "$ref": "#/$defs/rect" },
+          "alpha_bbox": { "$ref": "#/$defs/rect" },
+          "pivot": { "$ref": "#/$defs/point" },
+          "footline_px": { "type": "number" },
+          "safe_rect": { "$ref": "#/$defs/rect" },
+          "bleed_margin_px": { "type": "integer", "minimum": 0 },
+          "sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "rect": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["x", "y", "width", "height"],
+      "properties": {
+        "x": { "type": "integer", "minimum": 0 },
+        "y": { "type": "integer", "minimum": 0 },
+        "width": { "type": "integer", "minimum": 1 },
+        "height": { "type": "integer", "minimum": 1 }
+      }
+    },
+    "point": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["x", "y", "space"],
+      "properties": {
+        "x": { "type": "number" },
+        "y": { "type": "number" },
+        "space": { "enum": ["pixels", "normalized"] }
+      }
+    }
+  }
+}

package/schemas/generation-receipt.schema.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/lenhonbp/MotionLoom/blob/main/schemas/generation-receipt.schema.json",
+  "title": "MotionLoom generation receipt",
+  "description": "Provider-neutral, hash-bound receipt for generated or imported visual artifacts. A receipt is evidence, never human approval.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "receipt_id", "asset", "authority", "provider", "control_track_ref", "provenance_ref", "outputs", "created_at"],
+  "properties": {
+    "schema_version": {"const": "0.1"},
+    "receipt_id": {"type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{2,127}$"},
+    "created_at": {"type": "string", "format": "date-time"},
+    "asset": {"type": "object", "additionalProperties": false, "required": ["id", "kind", "intended_use"], "properties": {"id": {"type": "string", "minLength": 1}, "kind": {"type": "string", "enum": ["image", "frame_sequence", "sprite_atlas", "layered_map", "video", "rigged_2d", "rigged_3d", "runtime_scene"]}, "intended_use": {"type": "string", "enum": ["pilot", "runtime_candidate", "reference_only"]}}},
+    "authority": {"type": "string", "enum": ["ai_generated", "ai_assisted", "ai_assisted_human_reviewed", "artist_authored", "code_authored", "unknown"]},
+    "provider": {"type": "object", "additionalProperties": false, "required": ["adapter_id", "kind", "invocation_mode", "task_id", "model", "generated_at", "cost_class"], "properties": {"adapter_id": {"type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{2,127}$"}, "kind": {"type": "string", "enum": ["fixture", "internal_skill", "external_provider", "manual_import"]}, "invocation_mode": {"type": "string", "enum": ["none", "manual", "agent-mediated", "api"]}, "task_id": {"type": "string", "minLength": 1}, "model": {"type": "string", "minLength": 1}, "generated_at": {"type": "string", "format": "date-time"}, "cost_class": {"type": "string", "enum": ["included", "metered", "external", "unknown"]}, "prompt_hash": {"type": "string", "pattern": "^[a-f0-9]{64}$"}}},
+    "control_track_ref": {"type": "string", "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$)).+"},
+    "provenance_ref": {"type": "string", "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$)).+"},
+    "outputs": {"type": "array", "minItems": 1, "items": {"type": "object", "additionalProperties": false, "required": ["path", "role", "sha256", "bytes"], "properties": {"path": {"type": "string", "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$)).+"}, "role": {"type": "string", "minLength": 1}, "sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"}, "bytes": {"type": "integer", "minimum": 0}}}}
+  }
+}

package/schemas/layered-map.schema.json

@@ -0,0 +1,75 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://motionloom.dev/schemas/layered-map.schema.json",
+  "title": "MotionLoom Layered Map Contract",
+  "description": "Multi-layer background contract for deterministic camera, parallax and seam validation.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "map_id", "coordinate_system", "world_bounds", "camera", "layers"],
+  "properties": {
+    "schema_version": { "const": "0.1" },
+    "map_id": { "type": "string", "minLength": 1 },
+    "coordinate_system": { "enum": ["world_y_up", "screen_y_down"] },
+    "world_bounds": { "$ref": "#/$defs/rect" },
+    "camera": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["viewport_width", "viewport_height", "safe_bounds"],
+      "properties": {
+        "viewport_width": { "type": "number", "exclusiveMinimum": 0 },
+        "viewport_height": { "type": "number", "exclusiveMinimum": 0 },
+        "safe_bounds": { "$ref": "#/$defs/rect" },
+        "seam_tolerance": { "type": "number", "minimum": 0, "maximum": 1 }
+      }
+    },
+    "layers": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["layer_id", "image", "z_index", "parallax", "anchor", "tileable", "world_bounds", "camera_safe_bounds"],
+        "properties": {
+          "layer_id": { "type": "string", "minLength": 1 },
+          "role": { "enum": ["sky", "far", "mid", "near", "ground", "occluder", "foreground", "fx"] },
+          "image": { "type": "string", "minLength": 1 },
+          "z_index": { "type": "integer" },
+          "parallax": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["x", "y"],
+            "properties": {
+              "x": { "type": "number", "minimum": 0 },
+              "y": { "type": "number", "minimum": 0 },
+              "reference": { "enum": ["camera", "world"] }
+            }
+          },
+          "anchor": { "enum": ["top_left", "center", "bottom_left", "world_origin"] },
+          "tileable": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["x", "y"],
+            "properties": { "x": { "type": "boolean" }, "y": { "type": "boolean" } }
+          },
+          "world_bounds": { "$ref": "#/$defs/rect" },
+          "camera_safe_bounds": { "$ref": "#/$defs/rect" },
+          "blend": { "enum": ["normal", "add", "multiply", "screen"] },
+          "opacity": { "type": "number", "minimum": 0, "maximum": 1 }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "rect": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["x", "y", "width", "height"],
+      "properties": {
+        "x": { "type": "number" },
+        "y": { "type": "number" },
+        "width": { "type": "number", "exclusiveMinimum": 0 },
+        "height": { "type": "number", "exclusiveMinimum": 0 }
+      }
+    }
+  }
+}

package/schemas/rig-adapter-registry.schema.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/lenhonbp/MotionLoom/blob/main/schemas/rig-adapter-registry.schema.json",
+  "title": "MotionLoom rig runtime adapter registry",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "registry_id", "generated_at", "adapters"],
+  "properties": {
+    "schema_version": {"const": "0.1"},
+    "registry_id": {"type": "string", "minLength": 1},
+    "generated_at": {"type": "string", "format": "date-time"},
+    "adapters": {"type": "array", "minItems": 1, "items": {"type": "object", "additionalProperties": false, "required": ["adapter_id", "target", "framework", "status", "evidence", "limitations"], "properties": {"adapter_id": {"type": "string", "minLength": 1}, "target": {"type": "string", "minLength": 1}, "framework": {"type": "string", "minLength": 1}, "status": {"type": "string", "enum": ["verified", "project_integrated", "static_validated", "scaffold_only", "disabled"]}, "evidence": {"type": "array", "minItems": 1, "items": {"type": "object", "required": ["path", "sha256"], "properties": {"path": {"type": "string"}, "sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"}}, "additionalProperties": true}}, "limitations": {"type": "array", "items": {"type": "string"}}}}}
+  }
+}