motionloom 2.2.0 → 2.4.0

package/examples/agent-consumer/ai-pilot-scout/README.md

@@ -0,0 +1,39 @@
+# AI Scout Pilot Ingest
+
+This example is a **real-byte, local workspace flow** for an AI-generated four-frame scout robot pilot. The repository does not version the generated PNG bytes. Run the portable builder against four user-held, alpha-isolated PNG frames; it copies the source bytes into `.motionloom/pilots/ai-pilot-scout/`, measures the alpha geometry, and produces the JSON contracts there.
+
+The pilot uses `authority: ai_generated` and stays **review-required**. Its receipt is explicitly a post-hoc, hash-bound ingest record because a provider-native ImageGen receipt was not exported. The result may demonstrate that all bundle links and measured geometry validate. It must never be interpreted as artist-authored authority, provider provenance completeness, runtime verification, production eligibility, or human approval.
+
+If a provider returns a fully opaque dark canvas despite a transparency request, run `scripts/isolate-alpha-background.py` first only when the background is visibly high-contrast and edge-connected. It rejects residual opaque pixels at the canvas edge by default, because those normally indicate contamination instead of a safely isolated sprite. The tool emits an alpha-isolation report, but that report is evidence of a deterministic post-process, not proof of source alpha or approval. Review the result visually before building the bundle.
+
+```bash
+python3 scripts/build-ai-pilot.py \
+  --idle /absolute/path/scout-idle-transparent.png \
+  --contact-right /absolute/path/scout-contact-right-transparent.png \
+  --passing /absolute/path/scout-passing-transparent.png \
+  --contact-left /absolute/path/scout-contact-left-transparent.png \
+  --overwrite
+
+python3 scripts/artifact-intake.py report \
+  --root . \
+  --registry artifact-adapter-registry.json \
+  --controls .motionloom/pilots/ai-pilot-scout/controls.json \
+  --receipt .motionloom/pilots/ai-pilot-scout/receipt.json \
+  --export-manifest .motionloom/pilots/ai-pilot-scout/export.json \
+  --output .motionloom/pilots/ai-pilot-scout/artifact-intake-report.json
+
+python3 scripts/runtime-candidate.py report \
+  --root . \
+  --input .motionloom/pilots/ai-pilot-scout/candidate.json \
+  --output .motionloom/pilots/ai-pilot-scout/runtime-candidate-report.json
+```
+
+Use `--frame-url ID=URL` when the four frames are hosted for Dev Lab. The builder carries those URLs only in `devlab-pilot-evidence.json`; it does not treat URL reachability as evidence of quality, runtime behavior, review, or approval.
+
+> The builder rejects ordinary RGB files and a fully opaque image. A visible checkerboard painted into an RGB PNG is **not** transparency. This restriction makes frame geometry and contamination checks meaningful.
+
+When any source fails preflight, the builder exits non-zero and writes only `partial-handoff.json` beside the copied source bytes. That handoff binds the original SHA-256, any measurable alpha/canvas/padding metrics, provider identity and exact refusal reasons. It deliberately does **not** emit `controls.json`, a receipt, candidate, runtime render or Dev Lab review link. Replace the source independently; do not resample, add transparent margins or edit metadata to make rejected bytes pass.
+
+## Current pilot handoff
+
+The checked-in [`partial-handoff.json`](partial-handoff.json) records the current real-byte pilot boundary: one v3 master was alpha-isolated, visually checked and retained outside this repository; the independent walk phases could not be generated before the image quota was exhausted. No intake bundle, runtime candidate, render evidence or Dev Lab candidate has been emitted from a repeated idle image. Resume only with three independently generated and reviewed action frames, then run the exact commands above.

package/examples/agent-consumer/ai-pilot-scout/chatgpt-geometry-correction-prompt.md

@@ -0,0 +1,55 @@
+# ChatGPT corrective prompt — Scout v3 walk frames
+
+Upload **only** `motionloom-ai-pilot-scout-v3-idle-alpha.png` as the reference image. Generate each requested pose in a separate turn and download the original PNG, not a screenshot.
+
+> Treat the reference as a locked production-pilot sprite sheet source. Preserve the robot exactly; change only the limb pose required by the requested walk phase.
+
+## Non-negotiable output contract
+
+Copy this block into **every** generation request, then append one pose block below.
+
+```text
+Use the attached Scout v3 idle sprite as the exact visual and geometry reference.
+
+Create ONE complete 2D pixel-art character sprite on a 1920 × 1920 pixel canvas. The canvas background must be truly transparent (RGBA alpha 0), with no black, checkerboard, coloured, shadow, floor, glow, particles, text, border, duplicate character, crop, or prop.
+
+Do not redesign, restyle, zoom, crop, rotate, mirror, recolor, or change the camera. Keep the cream/orange/black/cyan robot identity, head, antenna, face, shoulder pads, torso, hands, feet, palette, pixel density, outlines, and apparent scale from the reference. Draw the entire robot at the same approximate scale as the reference, vertically standing on the same baseline.
+
+Geometry requirements: leave at least 120 px transparent padding on all four canvas edges. Keep the opaque character approximately 800 px wide by 1450 px tall, centered near x=940, with the feet baseline near y=1626. The character must not occupy more than 55% of canvas width. Use crisp hard pixel edges only; do not add anti-aliased blur.
+
+This is an AI-generated source asset for a review-only MotionLoom pilot. It must not imply artist authorship, production approval, runtime approval, or a licence.
+```
+
+## Pose 1 — contact right
+
+Append this after the contract:
+
+```text
+Pose: walk cycle contact-right. The robot’s RIGHT foot is planted forward at the baseline; the LEFT leg trails slightly behind. Counter-swing the arms naturally. Keep both feet fully visible and preserve the locked body scale and centered composition.
+
+Return only the single transparent-background PNG. Save it as: motionloom-ai-pilot-scout-v3-chatgpt-contact-right.png
+```
+
+## Pose 2 — passing
+
+Append this after the contract:
+
+```text
+Pose: walk cycle passing phase. One leg passes beneath the body with a compact, balanced gait; the body remains upright and the foot baseline stays near y=1626. Counter-swing the arms naturally. Keep both feet fully visible and preserve the locked body scale and centered composition.
+
+Return only the single transparent-background PNG. Save it as: motionloom-ai-pilot-scout-v3-chatgpt-passing.png
+```
+
+## Pose 3 — contact left
+
+Append this after the contract:
+
+```text
+Pose: walk cycle contact-left. The robot’s LEFT foot is planted forward at the baseline; the RIGHT leg trails slightly behind. This must be the complementary phase to contact-right, not a mirror/redesign. Counter-swing the arms naturally. Keep both feet fully visible and preserve the locked body scale and centered composition.
+
+Return only the single transparent-background PNG. Save it as: motionloom-ai-pilot-scout-v3-chatgpt-contact-left.png
+```
+
+## Before sending files back
+
+Do not flatten the PNG or put it on a black background. Send the three original downloaded files to MotionLoom in the order above and retain the ChatGPT conversation/task context if available. MotionLoom will measure alpha, padding, identity geometry and file hashes independently; satisfying the prompt does not approve the candidate.

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}
+}