motionloom 2.3.0 → 2.5.0

package/examples/agent-consumer/ai-pilot-scout/chatgpt-pose-generation-prompt.md

@@ -0,0 +1,78 @@
+# ChatGPT handoff — Scout v3 walk poses
+
+## Mục tiêu
+
+Tạo **ba file PNG riêng biệt** cho walk cycle của Scout v3: `contact-right`, `passing`, và `contact-left`. Đây là **source asset** cho MotionLoom, không phải ảnh minh họa. Vì vậy, mỗi output phải có duy nhất một robot, kích thước canvas cố định, padding đo được, và không có chi tiết nền hay hiệu ứng có thể làm sai phép đo alpha/geometry.
+
+> **Trust boundary:** Mọi output từ ChatGPT là `ai_generated`. Prompt không cấp `artist_authored`, `production_eligible`, `production_approved`, hoặc runtime approval. MotionLoom sẽ đo lại bytes PNG, alpha, padding, contamination và hash trước khi ingest.
+
+## Chuẩn bị trong ChatGPT
+
+Tải **một ảnh tham chiếu duy nhất**: `motionloom-ai-pilot-scout-v3-idle-alpha.png`. Hãy gửi **từng prompt một**, tải file PNG nguyên gốc của từng kết quả, và không dùng screenshot hay ảnh đã nén lại.
+
+| Pose | Tên file khi tải về | Mục đích |
+|---|---|---|
+| Contact right | `motionloom-ai-pilot-scout-v3-chatgpt-contact-right.png` | Chân phải chạm đất ở phía trước. |
+| Passing | `motionloom-ai-pilot-scout-v3-chatgpt-passing.png` | Hai chân đi qua nhau dưới thân. |
+| Contact left | `motionloom-ai-pilot-scout-v3-chatgpt-contact-left.png` | Chân trái chạm đất ở phía trước. |
+
+## Prompt chung — dán kèm từng pose
+
+```text
+Use the uploaded image only as the identity reference for one game-ready pixel-art sprite frame.
+
+Create exactly ONE 1920 × 1920 PNG image of the same small cream-and-orange scout robot. Preserve the reference’s 3/4 front-facing camera angle, silhouette, palette, pixel density, head antenna, torso emblem, limbs, and apparent scale. The robot must be centered horizontally and fully visible.
+
+POSE INSTRUCTION: [REPLACE THIS LINE WITH ONE POSE BLOCK BELOW]
+
+SOURCE-ASSET CONTRACT:
+- Use a genuinely transparent background if supported. Otherwise use one perfectly flat solid #00FF00 green background only.
+- Keep at least 180 px completely empty padding on all four canvas edges.
+- Keep the robot’s feet on an invisible common baseline; do not crop any body part.
+- Produce only the robot. Do not add a floor, cast shadow, reflection, glow, scenery, props, text, watermark, label, checkerboard, frame border, gradient, texture, noise, line, disconnected pixel cluster, or any second object.
+- Use crisp pixel-art edges; do not add an anti-aliased halo or motion blur.
+- Return the image only, not a collage, animation sheet, UI mockup, explanation, or multiple alternatives.
+
+This is a deterministic animation source asset, not a concept-art request.
+```
+
+## Ba pose block
+
+### 1. `contact-right`
+
+```text
+Walk-cycle contact-right: the right foot is forward and flat on the baseline, while the left foot trails behind. Both feet are fully visible. The body leans only slightly forward in a natural walk rhythm; do not change the robot design.
+```
+
+### 2. `passing`
+
+```text
+Walk-cycle passing pose: the legs pass beneath the body; one knee is slightly forward and one foot passes the planted leg. Both feet remain fully visible and the torso stays centered over the same baseline. Do not change the robot design.
+```
+
+### 3. `contact-left`
+
+```text
+Walk-cycle contact-left: the left foot is forward and flat on the baseline, while the right foot trails behind. Both feet are fully visible. The body leans only slightly forward in a natural walk rhythm; do not change the robot design.
+```
+
+## Cách bàn giao
+
+Sau khi tải về, đặt ba PNG ở một thư mục và cung cấp cho MotionLoom. Kèm theo một note tối thiểu như sau; nếu ChatGPT UI không hiển thị model/version, ghi `not_exposed_by_ui` thay vì suy đoán.
+
+```json
+{
+  "provider": "chatgpt",
+  "authority": "ai_generated",
+  "master_reference": "motionloom-ai-pilot-scout-v3-idle-alpha.png",
+  "model": "not_exposed_by_ui",
+  "task_id": "motionloom-scout-v3-chatgpt-walk-YYYYMMDD",
+  "outputs": [
+    "motionloom-ai-pilot-scout-v3-chatgpt-contact-right.png",
+    "motionloom-ai-pilot-scout-v3-chatgpt-passing.png",
+    "motionloom-ai-pilot-scout-v3-chatgpt-contact-left.png"
+  ]
+}
+```
+
+MotionLoom sẽ dùng bytes thật để tính SHA-256, kiểm tra alpha/padding/contamination, đo geometry, xây provenance và chỉ sau đó chạy Artifact Intake. Một frame không đạt sẽ chặn toàn bộ cycle; không thay frame lỗi bằng idle lặp hoặc cấp approval thủ công.

package/examples/agent-consumer/ai-pilot-scout/partial-handoff.json

@@ -0,0 +1,73 @@
+{
+  "contract": "motionloom-ai-pilot-partial-handoff",
+  "version": 1,
+  "asset_id": "character.scout-robot.ai-pilot",
+  "state": "partial",
+  "authority": "ai_generated",
+  "production_approved": false,
+  "completed": {
+    "master_frame": "v3 idle source alpha-isolated and visually checked",
+    "source_quality": "clean padding confirmed; minor pixel-edge irregularities remain review-visible",
+    "guard_coverage": [
+      "RGB/opaque source rejection",
+      "edge-connected alpha isolation report",
+      "residual-edge rejection",
+      "clean-padding geometry rejection"
+    ]
+  },
+  "blocked": {
+    "reason": "Independent ChatGPT action frames were received but rejected pre-ingest because their 1254x1254 source canvas, tight padding, and subject proportions do not satisfy the reviewed 1920x1920 master geometry contract.",
+    "missing_frames": [
+      "contact-right",
+      "passing",
+      "contact-left"
+    ],
+    "not_emitted": [
+      "controls.json",
+      "generation receipt",
+      "export manifest",
+      "asset consistency contract",
+      "Artifact Intake report",
+      "runtime candidate",
+      "runtime render evidence",
+      "Dev Lab review candidate"
+    ]
+  },
+  "rejected_source_attempts": [
+    {
+      "provider": "openai-chatgpt",
+      "authority": "ai_generated",
+      "state": "rejected_pre_ingest",
+      "reason": "No resampling, transparent padding, or metadata edit may be used to bypass the measured source-geometry gate.",
+      "frames": [
+        {
+          "role": "contact-right",
+          "sha256": "d26deada40d35349411f08890ff0dfe6610997170b9fd100ea3bd65536f6623c",
+          "canvas": [1254, 1254],
+          "alpha_bbox": [97, 71, 1113, 1141],
+          "padding": {"left": 97, "top": 71, "right": 44, "bottom": 42}
+        },
+        {
+          "role": "passing",
+          "sha256": "164f6dad075babe30595e9f4e617940b35450f68cc709a0f4cf648d79756edb7",
+          "canvas": [1254, 1254],
+          "alpha_bbox": [41, 39, 1177, 1191],
+          "padding": {"left": 41, "top": 39, "right": 36, "bottom": 24}
+        },
+        {
+          "role": "contact-left",
+          "sha256": "b278e2e4a8e0cdb2ac82b0650b0ca70d1284729937d4a7c0a545a180c1331b0a",
+          "canvas": [1254, 1254],
+          "alpha_bbox": [31, 61, 1179, 1153],
+          "padding": {"left": 31, "top": 61, "right": 44, "bottom": 40}
+        }
+      ]
+    }
+  ],
+  "resume_requirements": [
+    "Create three independent action frames from the reviewed master; do not repeat idle as action frames.",
+    "Run alpha isolation with hash reports and visual checks for all four frames.",
+    "Run build-ai-pilot, Artifact Intake, asset-consistency and runtime-candidate without bypassing a failed gate.",
+    "Render the candidate and hand it to Dev Lab with review_required still true."
+  ]
+}

package/examples/agent-consumer/artifact-intake/hero-motion-controls.json

@@ -0,0 +1,15 @@
+{
+  "schema_version": "0.1",
+  "control_id": "hero-motion-pilot-controls",
+  "asset_id": "character/hero-male",
+  "created_at": "2026-08-15T00:00:00Z",
+  "references": [
+    {"id": "hero-frame-zero", "path": "examples/agent-consumer/asset-consistency/assets/hero-frame-00.png", "sha256": "75ce90653a01a23bcfab1aef83647d6364d3edbf6e4a44b84c635338c12b9248", "role": "identity"}
+  ],
+  "tracks": [
+    {"id": "hero-identity-lock", "kind": "identity", "binding": "required", "value_hash": "c24b2cb26f222d5b5febf77d8c79fca50e0dcf0d0b6961f52e58d8ee60e0d351"},
+    {"id": "hero-style-lock", "kind": "style", "binding": "required", "value_hash": "5a8430e6968ec460c5ed504d216e82ccdb923369b2ba5c284ed6328fae2a36cc"},
+    {"id": "hero-walk-poses", "kind": "pose", "binding": "required", "value_hash": "2eb4b7dcbf9ae8e41ae4178205616152fa40c2d5cc55617e6e0d32d832e0d9c9", "samples": 4}
+  ],
+  "output_profile": {"kind": "frame_sequence", "fps": 12, "expected_frame_count": 4, "loop": true}
+}

package/examples/agent-consumer/artifact-intake/hero-motion-export.json

@@ -0,0 +1,14 @@
+{
+  "schema_version": "0.1",
+  "manifest_id": "hero-motion-pilot-export",
+  "asset_id": "character/hero-male",
+  "created_at": "2026-08-15T00:00:00Z",
+  "receipt_ref": "examples/agent-consumer/artifact-intake/hero-motion-receipt.json",
+  "control_track_ref": "examples/agent-consumer/artifact-intake/hero-motion-controls.json",
+  "outputs": [
+    {"path": "examples/agent-consumer/asset-consistency/assets/hero-frame-00.png", "role": "frame-00", "sha256": "75ce90653a01a23bcfab1aef83647d6364d3edbf6e4a44b84c635338c12b9248", "bytes": 97, "target": "preview"},
+    {"path": "examples/agent-consumer/asset-consistency/assets/hero-frame-01.png", "role": "frame-01", "sha256": "1eaf21df83ed49e490ceb7db1e1a14c58e5227bcb4f1fd79a70e8ad3ee7d38ad", "bytes": 97, "target": "runtime_candidate"},
+    {"path": "examples/agent-consumer/asset-consistency/assets/hero-frame-02.png", "role": "frame-02", "sha256": "de88659cb7a57ae9c10b6e3e84e04e54bdc07e9971d5c42160a315d41b38fbc3", "bytes": 97, "target": "runtime_candidate"},
+    {"path": "examples/agent-consumer/asset-consistency/assets/hero-frame-03.png", "role": "frame-03", "sha256": "161d906dc850cd3d3ee970b97406fc36bcdf1c34222ac94171a05672bf64d957", "bytes": 97, "target": "runtime_candidate"}
+  ]
+}

package/examples/agent-consumer/artifact-intake/hero-motion-provenance.json

@@ -0,0 +1,20 @@
+{
+  "schema_version": "1.0",
+  "provenance_id": "hero-motion-pilot-provenance",
+  "task_id": "artifact-intake-example",
+  "scene": "hero-walk-fixture",
+  "created_at": "2026-08-15T00:00:00Z",
+  "asset": {"id": "character/hero-male", "path": "examples/agent-consumer/asset-consistency/assets/hero-frame-00.png", "type": "runtime-pilot", "framework": "body-rig"},
+  "authority": "ai_generated",
+  "readiness": "runtime_ready",
+  "generator": {"model": "fixture-model", "task_id": "artifact-intake-example", "source": "fixture.local-artifact-intake", "generated_at": "2026-08-15T00:00:00Z"},
+  "license": {"spdx": "UNLICENSED", "source": "MotionLoom fixture", "attribution": "not required"},
+  "files": [
+    {"path": "examples/agent-consumer/asset-consistency/assets/hero-frame-00.png", "role": "frame-00", "sha256": "75ce90653a01a23bcfab1aef83647d6364d3edbf6e4a44b84c635338c12b9248"},
+    {"path": "examples/agent-consumer/asset-consistency/assets/hero-frame-01.png", "role": "frame-01", "sha256": "1eaf21df83ed49e490ceb7db1e1a14c58e5227bcb4f1fd79a70e8ad3ee7d38ad"},
+    {"path": "examples/agent-consumer/asset-consistency/assets/hero-frame-02.png", "role": "frame-02", "sha256": "de88659cb7a57ae9c10b6e3e84e04e54bdc07e9971d5c42160a315d41b38fbc3"},
+    {"path": "examples/agent-consumer/asset-consistency/assets/hero-frame-03.png", "role": "frame-03", "sha256": "161d906dc850cd3d3ee970b97406fc36bcdf1c34222ac94171a05672bf64d957"}
+  ],
+  "provenance_chain": [{"step": "generate", "actor": "fixture:local-artifact-intake", "source": "MotionLoom regression fixture", "timestamp": "2026-08-15T00:00:00Z"}],
+  "runtime_evidence": {"status": "not_run", "runtime": "fixture-only", "tested_at": "2026-08-15T00:00:00Z"}
+}

package/examples/agent-consumer/artifact-intake/hero-motion-receipt.json

@@ -0,0 +1,16 @@
+{
+  "schema_version": "0.1",
+  "receipt_id": "hero-motion-pilot-receipt",
+  "created_at": "2026-08-15T00:00:00Z",
+  "asset": {"id": "character/hero-male", "kind": "frame_sequence", "intended_use": "runtime_candidate"},
+  "authority": "ai_generated",
+  "provider": {"adapter_id": "fixture.local-artifact-intake", "kind": "fixture", "invocation_mode": "none", "task_id": "artifact-intake-example", "model": "fixture-model", "generated_at": "2026-08-15T00:00:00Z", "cost_class": "included", "prompt_hash": "65e32d0806160325a1cb3936963bbab4e2bdf1f65ee6d544fd484b5cb844cd9f"},
+  "control_track_ref": "examples/agent-consumer/artifact-intake/hero-motion-controls.json",
+  "provenance_ref": "examples/agent-consumer/artifact-intake/hero-motion-provenance.json",
+  "outputs": [
+    {"path": "examples/agent-consumer/asset-consistency/assets/hero-frame-00.png", "role": "frame-00", "sha256": "75ce90653a01a23bcfab1aef83647d6364d3edbf6e4a44b84c635338c12b9248", "bytes": 97},
+    {"path": "examples/agent-consumer/asset-consistency/assets/hero-frame-01.png", "role": "frame-01", "sha256": "1eaf21df83ed49e490ceb7db1e1a14c58e5227bcb4f1fd79a70e8ad3ee7d38ad", "bytes": 97},
+    {"path": "examples/agent-consumer/asset-consistency/assets/hero-frame-02.png", "role": "frame-02", "sha256": "de88659cb7a57ae9c10b6e3e84e04e54bdc07e9971d5c42160a315d41b38fbc3", "bytes": 97},
+    {"path": "examples/agent-consumer/asset-consistency/assets/hero-frame-03.png", "role": "frame-03", "sha256": "161d906dc850cd3d3ee970b97406fc36bcdf1c34222ac94171a05672bf64d957", "bytes": 97}
+  ]
+}

package/examples/agent-consumer/asset-consistency/forest-layered-map.json

@@ -0,0 +1,53 @@
+{
+  "schema_version": "0.1",
+  "map_id": "forest-demo",
+  "coordinate_system": "world_y_up",
+  "world_bounds": {"x": 0, "y": 0, "width": 128, "height": 72},
+  "camera": {
+    "viewport_width": 32,
+    "viewport_height": 18,
+    "safe_bounds": {"x": 16, "y": 8, "width": 96, "height": 56},
+    "seam_tolerance": 0.08
+  },
+  "layers": [
+    {
+      "layer_id": "forest.back",
+      "role": "far",
+      "image": "assets/forest-back.png",
+      "z_index": 0,
+      "parallax": {"x": 0.2, "y": 0.2, "reference": "camera"},
+      "anchor": "top_left",
+      "tileable": {"x": true, "y": false},
+      "world_bounds": {"x": 0, "y": 0, "width": 128, "height": 72},
+      "camera_safe_bounds": {"x": 16, "y": 8, "width": 96, "height": 56},
+      "blend": "normal",
+      "opacity": 1
+    },
+    {
+      "layer_id": "forest.mid",
+      "role": "mid",
+      "image": "assets/forest-mid.png",
+      "z_index": 1,
+      "parallax": {"x": 0.5, "y": 0.5, "reference": "camera"},
+      "anchor": "center",
+      "tileable": {"x": false, "y": false},
+      "world_bounds": {"x": 0, "y": 0, "width": 128, "height": 72},
+      "camera_safe_bounds": {"x": 16, "y": 8, "width": 96, "height": 56},
+      "blend": "normal",
+      "opacity": 0.85
+    },
+    {
+      "layer_id": "forest.front",
+      "role": "foreground",
+      "image": "assets/forest-front.png",
+      "z_index": 2,
+      "parallax": {"x": 0.8, "y": 0.8, "reference": "camera"},
+      "anchor": "bottom_left",
+      "tileable": {"x": false, "y": false},
+      "world_bounds": {"x": 0, "y": 0, "width": 128, "height": 72},
+      "camera_safe_bounds": {"x": 16, "y": 8, "width": 96, "height": 56},
+      "blend": "normal",
+      "opacity": 1
+    }
+  ]
+}

package/examples/agent-consumer/asset-consistency/hero-atlas-contract.json

@@ -0,0 +1,24 @@
+{
+  "schema_version": "0.1",
+  "image": "assets/hero-atlas.png",
+  "allow_rotation": false,
+  "padding_px": 1,
+  "extrude_px": 1,
+  "require_transparent_outside_regions": true,
+  "regions": [
+    {
+      "region_id": "hero.walk.00",
+      "frame_id": "walk.00",
+      "rect": {"x": 1, "y": 0, "width": 6, "height": 8},
+      "trim": false,
+      "pivot": {"x": 4, "y": 7}
+    },
+    {
+      "region_id": "hero.walk.01",
+      "frame_id": "walk.01",
+      "rect": {"x": 9, "y": 0, "width": 6, "height": 8},
+      "trim": false,
+      "pivot": {"x": 4, "y": 7}
+    }
+  ]
+}

package/examples/agent-consumer/asset-consistency/hero-identity.json

@@ -0,0 +1,51 @@
+{
+  "schema_version": "0.1",
+  "asset_id": "character/hero-male",
+  "asset_kind": "character",
+  "identity": {
+    "subject_id": "hero-male",
+    "reference_hashes": [
+      "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
+    ],
+    "camera": {
+      "projection": "orthographic",
+      "width": 256,
+      "height": 256,
+      "focal_length": 50
+    },
+    "coordinate_system": "screen_y_down",
+    "scale": 1,
+    "pivot": {
+      "x": 0.5,
+      "y": 0.875,
+      "space": "normalized_canvas"
+    },
+    "palette_lock": {
+      "colors": ["#2864D7", "#96B4D2", "#281E50"],
+      "delta_e_tolerance": 4
+    },
+    "style_profile": "clean-orthographic-pilot",
+    "lighting_profile": "flat-key-light"
+  },
+  "derivation": {
+    "origin": "ai_generated",
+    "generator": {
+      "model": "fixture-generator",
+      "task_id": "asset-consistency-fixture",
+      "prompt_hash": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+      "seed": 20260815,
+      "tool_version": "fixture-1"
+    },
+    "source_refs": ["fixture://motionloom/asset-consistency/hero-male"],
+    "derivation_chain": [
+      {
+        "step": 0,
+        "operation": "deterministic-fixture-generation",
+        "input_hashes": ["aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"],
+        "output_hash": "cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc"
+      }
+    ]
+  },
+  "provenance_ref": "../ai-generated-pilot-provenance.json",
+  "notes": "Synthetic contract fixture only; runtime-ready examples never imply production art or approval."
+}

package/examples/agent-consumer/asset-consistency/hero-walk-action-set.json

@@ -0,0 +1,27 @@
+{
+  "schema_version": "0.1",
+  "asset_identity": "character/hero-male",
+  "actions": [
+    {
+      "action_id": "walk",
+      "fps": 12,
+      "frames": [
+        "assets/hero-frame-00.png",
+        "assets/hero-frame-01.png",
+        "assets/hero-frame-02.png",
+        "assets/hero-frame-03.png"
+      ],
+      "loop": true,
+      "events": ["footstep.left", "footstep.right"],
+      "required_sockets": ["hand.r", "foot.l", "foot.r"]
+    }
+  ],
+  "invariants": {
+    "canvas_width": 8,
+    "canvas_height": 8,
+    "pivot_tolerance_px": 0.01,
+    "footline_tolerance_px": 0.01,
+    "bbox_drift_tolerance_px": 0,
+    "min_alpha_pixels": 1
+  }
+}

package/examples/agent-consumer/asset-consistency/hero-walk-frame-geometry.json

@@ -0,0 +1,63 @@
+{
+  "schema_version": "0.1",
+  "asset_identity": "character/hero-male",
+  "canvas": {
+    "width": 8,
+    "height": 8,
+    "color_space": "srgb",
+    "alpha_mode": "straight"
+  },
+  "invariants": {
+    "pivot_tolerance_px": 0.01,
+    "footline_tolerance_px": 0.01,
+    "bbox_drift_tolerance_px": 0,
+    "min_alpha_pixels": 1,
+    "allow_external_opaque_pixels": false
+  },
+  "frames": [
+    {
+      "frame_id": "walk.00",
+      "image": "assets/hero-frame-00.png",
+      "rect": {"x": 0, "y": 0, "width": 8, "height": 8},
+      "alpha_bbox": {"x": 2, "y": 1, "width": 4, "height": 5},
+      "pivot": {"x": 4, "y": 7, "space": "pixels"},
+      "footline_px": 6,
+      "safe_rect": {"x": 1, "y": 0, "width": 6, "height": 7},
+      "bleed_margin_px": 1,
+      "sha256": "75ce90653a01a23bcfab1aef83647d6364d3edbf6e4a44b84c635338c12b9248"
+    },
+    {
+      "frame_id": "walk.01",
+      "image": "assets/hero-frame-01.png",
+      "rect": {"x": 0, "y": 0, "width": 8, "height": 8},
+      "alpha_bbox": {"x": 2, "y": 1, "width": 4, "height": 5},
+      "pivot": {"x": 4, "y": 7, "space": "pixels"},
+      "footline_px": 6,
+      "safe_rect": {"x": 1, "y": 0, "width": 6, "height": 7},
+      "bleed_margin_px": 1,
+      "sha256": "1eaf21df83ed49e490ceb7db1e1a14c58e5227bcb4f1fd79a70e8ad3ee7d38ad"
+    },
+    {
+      "frame_id": "walk.02",
+      "image": "assets/hero-frame-02.png",
+      "rect": {"x": 0, "y": 0, "width": 8, "height": 8},
+      "alpha_bbox": {"x": 2, "y": 1, "width": 4, "height": 5},
+      "pivot": {"x": 4, "y": 7, "space": "pixels"},
+      "footline_px": 6,
+      "safe_rect": {"x": 1, "y": 0, "width": 6, "height": 7},
+      "bleed_margin_px": 1,
+      "sha256": "de88659cb7a57ae9c10b6e3e84e04e54bdc07e9971d5c42160a315d41b38fbc3"
+    },
+    {
+      "frame_id": "walk.03",
+      "image": "assets/hero-frame-03.png",
+      "rect": {"x": 0, "y": 0, "width": 8, "height": 8},
+      "alpha_bbox": {"x": 2, "y": 1, "width": 4, "height": 5},
+      "pivot": {"x": 4, "y": 7, "space": "pixels"},
+      "footline_px": 6,
+      "safe_rect": {"x": 1, "y": 0, "width": 6, "height": 7},
+      "bleed_margin_px": 1,
+      "sha256": "161d906dc850cd3d3ee970b97406fc36bcdf1c34222ac94171a05672bf64d957"
+    }
+  ]
+}

package/examples/agent-consumer/rig-compatibility/hero-walk-fixture-rig.json

@@ -0,0 +1,13 @@
+{
+  "schema_version": "0.1",
+  "rig_id": "hero-walk-fixture-rig",
+  "asset_id": "character/hero-male",
+  "authority": "ai_generated",
+  "source": {"kind": "fixture_contract", "path": "examples/agent-consumer/artifact-intake/hero-motion-controls.json", "sha256": "12248cf9644e1ed65dd75d4a513345b7a37fe1f5029386de38f8cc09a15bdf5b"},
+  "candidate": {"path": "examples/agent-consumer/runtime-candidate/hero-walk-candidate.json", "sha256": "c9abbfc77a6a4cc61e1554dae465110cd4eaf6652c74d85279c8c1ab970eb044"},
+  "bones": [{"id": "root"}, {"id": "torso", "parent": "root"}, {"id": "hand.r", "parent": "torso"}, {"id": "foot.l", "parent": "root"}, {"id": "foot.r", "parent": "root"}],
+  "sockets": [{"id": "hand.r", "bone": "hand.r"}, {"id": "foot.l", "bone": "foot.l"}, {"id": "foot.r", "bone": "foot.r"}],
+  "actions": [{"id": "walk", "events": ["footstep.left", "footstep.right"]}],
+  "requirements": {"sockets": ["hand.r", "foot.l", "foot.r"], "actions": ["walk"], "events": ["footstep.left", "footstep.right"]},
+  "runtime": {"adapter_id": "motionloom.sprite-frame-sequence", "target": "sprite", "review_required": true}
+}

package/examples/agent-consumer/rive-package-gate/README.md

@@ -0,0 +1,20 @@
+# Rive package gate — real package handoff
+
+This directory intentionally contains **no fake production `.riv` package**. Put a concrete package here only after it exists, then create a manifest that binds its bytes, provenance and runtime proof.
+
+```text
+hero.riv
+hero-provenance.json
+hero-runtime-evidence.json
+hero-rive-package.json
+```
+
+The manifest must use `runtime.adapter_id: "motionloom.rive-runtime"`, list declared state-machine/input/event controls, and preserve `review_required: true`. In strict mode, runtime evidence must bind `source_sha256` to the exact `hero.riv` bytes and report a passing ready Rive framework capture.
+
+```bash
+npx --yes motionloom rive-gate validate \
+  --input examples/agent-consumer/rive-package-gate/hero-rive-package.json \
+  --root . --strict --json
+```
+
+> A passing gate means only that the package is ready for runtime testing and human review. It never creates artist authority, production eligibility, production approval, a Git push, or a pull request.

package/examples/agent-consumer/runtime-candidate/hero-walk-candidate.json

@@ -0,0 +1,18 @@
+{
+  "schema_version": "0.1",
+  "candidate_id": "hero-walk-fixture-candidate",
+  "asset_id": "character/hero-male",
+  "created_at": "2026-08-15T00:00:00Z",
+  "artifact_intake": {
+    "registry": "artifact-adapter-registry.json",
+    "receipt": "examples/agent-consumer/artifact-intake/hero-motion-receipt.json",
+    "controls": "examples/agent-consumer/artifact-intake/hero-motion-controls.json",
+    "export_manifest": "examples/agent-consumer/artifact-intake/hero-motion-export.json"
+  },
+  "consistency": {
+    "asset_identity": "examples/agent-consumer/asset-consistency/hero-identity.json",
+    "action_set": "examples/agent-consumer/asset-consistency/hero-walk-action-set.json",
+    "frame_geometry": "examples/agent-consumer/asset-consistency/hero-walk-frame-geometry.json"
+  },
+  "runtime": {"target": "sprite", "review_required": true}
+}

package/examples/agent-consumer/runtime-pilot/action-set.json

@@ -0,0 +1,19 @@
+{
+  "schema_version": "0.1",
+  "asset_identity": "runtime/framer-motion-pilot",
+  "actions": [
+    {
+      "action_id": "scrubbable-trajectory",
+      "frames": ["src/output/runtime-pilot-framer/scene.jsx"],
+      "fps": 60,
+      "loop": true,
+      "events": ["checkpoint-00", "checkpoint-50", "checkpoint-100"],
+      "required_sockets": []
+    }
+  ],
+  "invariants": {
+    "checkpoint_percentages": [0, 50, 100],
+    "progress_domain": [0, 1],
+    "runtime_target": "framer-motion"
+  }
+}

package/examples/agent-consumer/runtime-pilot/asset-identity.json

@@ -0,0 +1,44 @@
+{
+  "schema_version": "0.1",
+  "asset_id": "runtime/framer-motion-pilot",
+  "asset_kind": "ui",
+  "identity": {
+    "subject_id": "framer-motion-runtime-pilot",
+    "reference_hashes": [
+      "f4c0e56de842cae6b234566b556e4f07154f8109dde382a474218a9de8b45a8b"
+    ],
+    "camera": {
+      "projection": "orthographic",
+      "width": 512,
+      "height": 512,
+      "focal_length": 50
+    },
+    "coordinate_system": "screen_y_down",
+    "scale": 1,
+    "pivot": {
+      "x": 0.5,
+      "y": 0.5,
+      "space": "normalized_canvas"
+    },
+    "palette_lock": {
+      "colors": ["#2563eb", "#f59e0b", "#0f172a"],
+      "delta_e_tolerance": 0
+    },
+    "style_profile": "code-authored-runtime-pilot",
+    "lighting_profile": "not-applicable"
+  },
+  "derivation": {
+    "origin": "code_authored",
+    "source_refs": ["src/output/runtime-pilot-framer/scene.jsx"],
+    "derivation_chain": [
+      {
+        "step": 0,
+        "operation": "repository-code-authoring",
+        "input_hashes": [],
+        "output_hash": "f4c0e56de842cae6b234566b556e4f07154f8109dde382a474218a9de8b45a8b"
+      }
+    ]
+  },
+  "provenance_ref": "provenance.json",
+  "notes": "Code-authored Framer Motion pilot. Runtime evidence can establish runtime verification only; human review remains required."
+}

package/examples/agent-consumer/runtime-pilot/candidate.json

@@ -0,0 +1,21 @@
+{
+  "schema_version": "0.1",
+  "candidate_id": "runtime-pilot-framer-001",
+  "asset_id": "runtime/framer-motion-pilot",
+  "created_at": "2026-08-15T00:00:00Z",
+  "artifact_intake": {
+    "registry": "artifact-adapter-registry.json",
+    "receipt": "examples/agent-consumer/runtime-pilot/receipt.json",
+    "controls": "examples/agent-consumer/runtime-pilot/controls.json",
+    "export_manifest": "examples/agent-consumer/runtime-pilot/export.json"
+  },
+  "consistency": {
+    "asset_identity": "examples/agent-consumer/runtime-pilot/asset-identity.json",
+    "action_set": "examples/agent-consumer/runtime-pilot/action-set.json"
+  },
+  "runtime": {
+    "target": "framer-motion",
+    "runtime_evidence_ref": "src/output/runtime-pilot-framer/runtime-evidence.json",
+    "review_required": true
+  }
+}