motionloom 2.6.1 → 2.7.0

package/examples/agent-consumer/asset-consistency/action-sequence/verifier-evidence/walk.03.json

@@ -0,0 +1,26 @@
+{
+  "schema_version": "0.1",
+  "contract": "action-separation-verifier-evidence",
+  "sequence_id": "hero-walk-v1",
+  "action_id": "walk",
+  "frame_id": "walk.03",
+  "frame_index": 3,
+  "image_sha256": "161d906dc850cd3d3ee970b97406fc36bcdf1c34222ac94171a05672bf64d957",
+  "identity_lock_sha256": "59d6b09622b19839b8c9342fb043965ea3f515c8979d769284d413f60a5f7e2d",
+  "generator_agent_id": "motionloom-generator-v1",
+  "verifier_id": "motionloom-separation-verifier-v1",
+  "result": {
+    "expected_action": "walk",
+    "top_competitor": "run",
+    "margin": 0.32999999999999996,
+    "threshold": 0.2,
+    "status": "pass",
+    "method": "independent-action-rubric-v1"
+  },
+  "result_sha256": "259be183f714d57cec7721127c0dfe61b552e8fbcbb189b782b662ed57ac138b",
+  "provenance": {
+    "kind": "separate_verifier_artifact",
+    "producer_id": "motionloom-independent-verifier-v1",
+    "run_id": "fixture-run-2026-08-22"
+  }
+}

package/examples/agent-consumer/asset-planning/pixellab-hero-256x448-request.json

@@ -0,0 +1,43 @@
+{
+  "schema_version": "0.1",
+  "request_id": "hero-attack-pixellab-256x448",
+  "asset_id": "hero.character.attack",
+  "asset_kind": "frame_sequence",
+  "target": {
+    "canvas": {"width": 256, "height": 448},
+    "frame_count": 8,
+    "fps": 8,
+    "alpha_mode": "straight",
+    "pixel_art": true,
+    "anchor": "footline"
+  },
+  "generation_policy": {
+    "frame_isolation": "required",
+    "allow_crop": false,
+    "allow_stretch": false,
+    "allow_silent_resize": false,
+    "allow_provider_batch_as_provisional": true,
+    "integer_scale_only": true
+  },
+  "project_context": {
+    "runtime": "custom-2d-game-runtime",
+    "framework": "canvas-sprite-runtime",
+    "existing_assets": ["examples/agent-consumer/asset-consistency/assets/hero-frame-00.png"],
+    "rig_requirements": ["preserve footline and pivot across frames", "keep action-specific frame identity"],
+    "provenance_requirements": ["generation receipt", "hash-bound export manifest", "human review"],
+    "validation_requirements": ["MotionLoom frame geometry", "MotionLoom action separation", "MotionLoom Dev Lab review"]
+  },
+  "actions": [
+    {
+      "action_id": "attack",
+      "positive_cues": ["forward sword swing", "weight shifts into strike", "weapon leads the silhouette"],
+      "negative_cues": ["walking cycle", "running cycle", "jumping", "idle stance"],
+      "frame_count": 8
+    }
+  ],
+  "references": [
+    {"id": "hero-identity", "role": "identity"},
+    {"id": "hero-style", "role": "style"},
+    {"id": "attack-pose-reference", "role": "pose"}
+  ]
+}

package/examples/agent-consumer/devlab-live-sprite/README.md

@@ -0,0 +1,30 @@
+# Canonical live Dev Lab sprite fixture
+
+This fixture is a small, hash-bindable sprite-sequence runtime for exercising the Dev Lab live path from a clean checkout. It deliberately contains two review-required actions, `idle` and `reverse`, so the Action Library coverage gate can be observed moving from `1/2` to `2/2`.
+
+The PNG files are deterministic repository fixtures. They are suitable for runtime-control and provenance-contract testing; they are **not** a claim about production art quality, identity fidelity, licensing, authorship or user approval.
+
+## Run the live binding check
+
+From the repository root:
+
+```bash
+python3 - <<'PY'
+import importlib.util
+import sys
+from pathlib import Path
+
+root = Path(".").resolve()
+sys.path.insert(0, str(root / "scripts"))
+path = root / "scripts/review-hook.py"
+spec = importlib.util.spec_from_file_location("motionloom_review_hook", path)
+module = importlib.util.module_from_spec(spec)
+spec.loader.exec_module(module)
+bundle = module.runtime_bundle(root / "examples/agent-consumer/devlab-live-sprite")
+assert bundle and bundle["mode"] == "sprite-sequence"
+assert bundle["animations"] == ["idle", "reverse"]
+print(bundle["bundle_sha256"])
+PY
+```
+
+To use the fixture in an actual review task, copy it into a rendered scene directory as `devlab-runtime.json` and run `motionloom review-hook prepare --task-dir <task-dir> --lab-url <dev-lab-url>`. Open the exact emitted candidate URL, inspect both actions, exercise play/pause/restart/seek/step/speed/loop, and obtain explicit user approval before any PR workflow.

package/examples/agent-consumer/devlab-live-sprite/devlab-runtime.json

@@ -0,0 +1,61 @@
+{
+  "schema_version": "1.0",
+  "mode": "sprite-sequence",
+  "files": [
+    "frames/idle-00.png",
+    "frames/idle-01.png",
+    "frames/idle-02.png",
+    "frames/reverse-00.png",
+    "frames/reverse-01.png",
+    "frames/reverse-02.png"
+  ],
+  "default_animation": "idle",
+  "animations": [
+    {
+      "id": "idle",
+      "fps": 6,
+      "frames": [
+        "frames/idle-00.png",
+        "frames/idle-01.png",
+        "frames/idle-02.png"
+      ],
+      "loop": true,
+      "review_required": true
+    },
+    {
+      "id": "reverse",
+      "fps": 6,
+      "frames": [
+        "frames/reverse-00.png",
+        "frames/reverse-01.png",
+        "frames/reverse-02.png"
+      ],
+      "loop": false,
+      "review_required": true
+    }
+  ],
+  "controls": {
+    "play": true,
+    "pause": true,
+    "restart": true,
+    "seek": true,
+    "step": true,
+    "speed": true,
+    "loop": true
+  },
+  "viewport": {
+    "canvas_width": 1920,
+    "canvas_height": 1920,
+    "pixel_art": false
+  },
+  "review_policy": {
+    "require_all_animations": true
+  },
+  "action_separation": {
+    "status": "pass",
+    "action_id": "sprite-sequence",
+    "frame_count": 6,
+    "passing_frame_count": 6,
+    "forbidden_action_ids": ["cross-action-mix"]
+  }
+}

package/examples/agent-consumer/frame-generation-lock/hero-walk-lock.json

@@ -1,8 +1,21 @@
 {
-  "schema_version": "0.1",
+  "schema_version": "0.2",
   "lock_id": "hero-walk-v1",
   "asset_identity": "character/hero-male",
   "action_id": "walk",
+  "sequence_id": "hero-walk-v1",
+  "forbidden_action_ids": ["run", "jump", "attack"],
+  "action_manifest": "asset-consistency/action-sequence/hero-walk-action-manifest.json",
+  "action_contract": {
+    "positive_cues": [
+      "alternating contact and passing phases with an upright body",
+      "weight transfers along the shared footline with a natural counter-swing"
+    ],
+    "negative_cues": [
+      "no airborne jump, attack wind-up, or running stride",
+      "no casting, hurt, dodge, or second character silhouette"
+    ]
+  },
   "reference": {
     "image": "asset-consistency/assets/hero-frame-00.png",
     "sha256": "75ce90653a01a23bcfab1aef83647d6364d3edbf6e4a44b84c635338c12b9248",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "motionloom",
-  "version": "2.6.1",
+  "version": "2.7.0",
   "type": "module",
   "packageManager": "pnpm@11.20.0",
   "description": "MotionLoom: project-aware animation Skill with Agent interoperability, graph, provenance, Motion IR, runtime telemetry, Visual Truth, Remediation Learning, DSSE-compatible signed attestation, external evidence verification and Dev Lab review.",
@@ -60,9 +60,18 @@
     "schemas/control-track.schema.json",
     "schemas/export-manifest.schema.json",
     "schemas/artifact-adapter-registry.schema.json",
+    "schemas/action-separation-verifier-evidence.schema.json",
+    "schemas/asset-generation-request.schema.json",
+    "schemas/asset-generation-plan.schema.json",
+    "schemas/asset-adaptation.schema.json",
+    "scripts/asset-adapt.mjs",
     "artifact-adapter-registry.json",
     "examples/agent-consumer/artifact-intake",
     "tests/scripts/test_artifact_intake.py",
+    "scripts/asset-generation-plan.py",
+    "examples/agent-consumer/asset-planning",
+    "tests/scripts/test_asset_generation_plan.py",
+    "tests/scripts/test_asset_adapt.py",
     "scripts/runtime-candidate.py",
     "schemas/runtime-candidate.schema.json",
     "examples/agent-consumer/runtime-candidate",
@@ -133,6 +142,7 @@
     "test": "python3 tests/scripts/run_tests.py",
     "validate": "npm run quality:attestation",
     "doctor": "node bin/motionloom.mjs doctor --json",
+    "doctor:runtime": "node bin/motionloom.mjs doctor --runtime --json",
     "init": "node bin/motionloom.mjs init",
     "setup": "node bin/motionloom.mjs setup",
     "setup:dry": "node bin/motionloom.mjs setup --dry-run",
@@ -181,6 +191,10 @@
     "asset-provenance:check": "node bin/motionloom.mjs asset-provenance check --input examples/agent-consumer/ai-generated-pilot-provenance.json --root examples/agent-consumer --mode runtime --json",
     "asset:consistency": "node bin/motionloom.mjs asset-consistency validate --kind frame-geometry --input examples/agent-consumer/asset-consistency/hero-walk-frame-geometry.json --root examples/agent-consumer/asset-consistency --json",
     "asset:audit": "node bin/motionloom.mjs asset-consistency report --kind frame-geometry --input examples/agent-consumer/asset-consistency/hero-walk-frame-geometry.json --root examples/agent-consumer/asset-consistency --json",
+    "action:separation": "node bin/motionloom.mjs action-separation validate --input examples/agent-consumer/asset-consistency/action-sequence/hero-walk-action-manifest.json --root examples/agent-consumer/asset-consistency --json",
+    "asset:plan": "node bin/motionloom.mjs asset-generation-plan plan --request examples/agent-consumer/asset-planning/pixellab-hero-256x448-request.json --project-root . --json",
+    "asset:adapt:smoke": "node bin/motionloom.mjs asset-adapt pad --input examples/agent-consumer/asset-consistency/assets/hero-frame-00.png --output /tmp/motionloom-adapt-smoke.png --width 16 --height 16 --anchor center --report /tmp/motionloom-adapt-smoke.json --json",
+    "frame:preflight": "node bin/motionloom.mjs frame-set-preflight --input examples/agent-consumer/asset-consistency/hero-walk-frame-geometry.json --root examples/agent-consumer/asset-consistency --action-manifest examples/agent-consumer/asset-consistency/action-sequence/hero-walk-action-manifest.json --json",
     "artifact:intake": "node bin/motionloom.mjs artifact-intake intake --root . --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 --json",
     "runtime:candidate": "node bin/motionloom.mjs runtime-candidate validate --root . --input examples/agent-consumer/runtime-candidate/hero-walk-candidate.json --json",
     "rig:compatibility": "node bin/motionloom.mjs rig-compatibility validate --root . --registry rig-adapter-registry.json --input examples/agent-consumer/rig-compatibility/hero-walk-fixture-rig.json --json",

package/references/multi-frame-asset-generation.md

@@ -2,6 +2,20 @@
 
 This contract applies whenever MotionLoom or an Agent creates two or more source frames for the same character, object, effect or other frame-based animation. It is automatic: the user should not have to ask for consistent frame geometry, isolated source frames or atlas hygiene.
 
+## Plan the provider before generating
+
+Before calling PixelLab, ImageGen, ChatGPT or another provider, create a provider-neutral request that describes the real runtime target. The request must include the target canvas, frame count, alpha mode, pixel-art policy, action cues and whether one source frame per request is required:
+
+```bash
+motionloom asset-generation-plan plan \
+  --request examples/agent-consumer/asset-planning/pixellab-hero-256x448-request.json \
+  --project-root . --json
+```
+
+Treat the result as a MotionLoom recommendation, not an approval. The planner first assesses the project/task, then separates `recommendation_status` from `execution_status`. A provisional or scaffold route may remain a useful normal-planning recommendation when its project fit is strong; strict execution still requires the active execution policy. User preference is visible and may influence ranking, but cannot override a hard incompatibility. For example, PixelLab animation tools documented with square canvases can be used as a provisional source for a `256x448` target only through an explicit transparent-padding plan and post-export action/frame validation; the planner must not silently crop, stretch, or claim that batch output satisfies per-frame isolation. If no route is execution-eligible, normal planning should still expose safe provisional/manual options while strict mode fails closed.
+
+The registry is provider-neutral and metadata-driven. A provider adapter remains `scaffold_only` until real export bytes, generation receipt, target-runtime evidence and human review have been recorded. Availability is separate from registry existence: an unknown or unavailable route may be shown as a MotionLoom option, but the Agent must resolve connectivity before execution. Bearer tokens belong in the connector/secret layer and never in requests, prompts, receipts or project manifests.
+
 ## Default source policy
 
 Generated source frames are **isolated-frame assets**, not a pose sheet.
@@ -44,7 +58,7 @@ The lock binds:
 - center, pivot, footline, safe rectangle and minimum transparent padding;
 - target measured alpha-bounds plus permitted width/height drift;
 - appearance features that must be preserved and changes that are forbidden;
-- a hard source policy of one isolated frame per image, no pose sheet and no post-generation resize;
+- a hard source policy of one isolated frame per image, no pose sheet and no silent post-generation resize;
 - every `frame_id`, its pose intent and its unique PNG output path;
 - the post-generation `frame-geometry` contract used by deterministic preflight;
 - a review-only trust boundary with `approval: false`.
@@ -61,10 +75,31 @@ motionloom frame-generation-lock compose \
   --root src/output/<scene> --frame-id <action.frame-id> --json
 ```
 
-For batch planning, `compose-all` emits one independent instruction per frame while preserving the same lock hash and reference hash. It does **not** authorize asking a provider for one multi-frame canvas; each returned instruction still represents one isolated source image.
+For batch planning, `compose-all` emits one independent instruction per frame while preserving the same lock hash and reference hash. It does **not** authorize asking a provider for one multi-frame canvas; each returned instruction still represents one isolated source image. If the selected provider only emits a batch animation, record it as provisional and create independent envelopes after export; do not promote it to an isolated-source pass automatically.
 
 If the reference bytes change, an output path escapes the asset root, two frames target the same PNG, the lock permits a pose sheet/post-resize, or the trust boundary is weakened, validation fails closed before generation.
 
+## Keep action identity across isolated frames
+
+Isolated canvases prevent neighboring pixels from leaking into a crop, but they do not prove that a frame belongs to the intended action. For every multi-frame action, use an action-scoped manifest with one immutable `sequence_id`, `action_id`, `identity_lock_sha256`, ordered `frame_index` values and explicit `forbidden_action_ids`. Each image must have a frame envelope binding those fields to the image SHA-256.
+
+The action verifier must record `expected_action`, `top_competitor`, `margin`, `threshold` and `status`. A generator-created envelope is only declared evidence; independent verification requires a separate hash-bound verifier artifact. A low margin, competitor mismatch or missing verifier provenance is **quarantined**, not silently relabeled or moved to another action. Validate the manifest before packing:
+
+```bash
+motionloom action-separation validate \\
+  --input src/output/<scene>/<action>-action-manifest.json \\
+  --root src/output/<scene> --json
+
+motionloom frame-set-preflight \\
+  --input src/output/<scene>/<action>-frame-geometry.json \\
+  --root src/output/<scene> \\
+  --action-manifest src/output/<scene>/<action>-action-manifest.json --json
+```
+
+A contact sheet may be generated after isolated frames pass as a review projection, but it is never the production source. When one frame is ambiguous, regenerate that frame from the accepted anchor and the same action lock; do not auto-move it, use a neighboring action as a reference, or let the agent infer its action from the filename.
+
+See [`docs/ACTION-SEPARATION.md`](../docs/ACTION-SEPARATION.md) for the manifest/envelope contract and quarantine policy.
+
 ## Validate incrementally
 
 Do not generate the complete action and only inspect it at the end. After each candidate frame:

package/schemas/action-separation-verifier-evidence.schema.json

@@ -0,0 +1,43 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://motionloom.dev/schemas/action-separation-verifier-evidence.schema.json",
+  "title": "MotionLoom Action Separation Verifier Evidence",
+  "description": "Separate verifier artifact bound to one frame result. Hashes verify binding integrity, not the truthfulness of an asserted producer identity.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "contract", "sequence_id", "action_id", "frame_id", "frame_index", "image_sha256", "identity_lock_sha256", "generator_agent_id", "verifier_id", "result", "result_sha256", "provenance"],
+  "properties": {
+    "schema_version": {"const": "0.1"},
+    "contract": {"const": "action-separation-verifier-evidence"},
+    "sequence_id": {"type": "string", "pattern": "^[a-z0-9][a-z0-9._-]{1,95}$"},
+    "action_id": {"type": "string", "pattern": "^[a-z0-9][a-z0-9._-]{1,63}$"},
+    "frame_id": {"type": "string", "pattern": "^[a-z0-9][a-z0-9._-]{1,63}$"},
+    "frame_index": {"type": "integer", "minimum": 0},
+    "image_sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"},
+    "identity_lock_sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"},
+    "generator_agent_id": {"type": "string", "pattern": "^[a-z0-9][a-z0-9._-]{1,63}$"},
+    "verifier_id": {"type": "string", "pattern": "^[a-z0-9][a-z0-9._-]{1,63}$"},
+    "result": {
+      "type": "object", "additionalProperties": false,
+      "required": ["expected_action", "top_competitor", "margin", "threshold", "status", "method"],
+      "properties": {
+        "expected_action": {"type": "string", "pattern": "^[a-z0-9][a-z0-9._-]{1,63}$"},
+        "top_competitor": {"type": "string", "pattern": "^[a-z0-9][a-z0-9._-]{1,63}$"},
+        "margin": {"type": "number", "minimum": 0},
+        "threshold": {"type": "number", "minimum": 0},
+        "status": {"enum": ["pass", "quarantined"]},
+        "method": {"type": "string", "minLength": 1}
+      }
+    },
+    "result_sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"},
+    "provenance": {
+      "type": "object", "additionalProperties": false,
+      "required": ["kind", "producer_id", "run_id"],
+      "properties": {
+        "kind": {"const": "separate_verifier_artifact"},
+        "producer_id": {"type": "string", "pattern": "^[a-z0-9][a-z0-9._-]{1,63}$"},
+        "run_id": {"type": "string", "minLength": 1}
+      }
+    }
+  }
+}

package/schemas/action-sequence-manifest.schema.json

@@ -0,0 +1,48 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://motionloom.dev/schemas/action-sequence-manifest.schema.json",
+  "title": "MotionLoom Action Sequence Manifest",
+  "description": "Manifest binding for isolated frame sequences and explicitly classified action-separation evidence.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "sequence_id", "asset_identity", "action_id", "identity_lock_sha256", "generator_agent_id", "forbidden_action_ids", "actions", "frames", "status", "approval"],
+  "properties": {
+    "schema_version": {"const": "0.2"},
+    "sequence_id": {"type": "string", "pattern": "^[a-z0-9][a-z0-9._-]{1,95}$"},
+    "asset_identity": {"type": "string", "minLength": 1},
+    "action_id": {"type": "string", "pattern": "^[a-z0-9][a-z0-9._-]{1,63}$"},
+    "identity_lock_sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"},
+    "generator_agent_id": {"type": "string", "pattern": "^[a-z0-9][a-z0-9._-]{1,63}$"},
+    "forbidden_action_ids": {
+      "type": "array", "minItems": 1, "uniqueItems": true,
+      "items": {"type": "string", "pattern": "^[a-z0-9][a-z0-9._-]{1,63}$"}
+    },
+    "actions": {
+      "type": "array", "minItems": 2,
+      "items": {
+        "type": "object", "additionalProperties": false,
+        "required": ["action_id", "positive_cues", "negative_cues"],
+        "properties": {
+          "action_id": {"type": "string", "pattern": "^[a-z0-9][a-z0-9._-]{1,63}$"},
+          "positive_cues": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}},
+          "negative_cues": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}}
+        }
+      }
+    },
+    "frames": {
+      "type": "array", "minItems": 2,
+      "items": {
+        "type": "object", "additionalProperties": false,
+        "required": ["frame_index", "frame_id", "image", "envelope"],
+        "properties": {
+          "frame_index": {"type": "integer", "minimum": 0},
+          "frame_id": {"type": "string", "pattern": "^[a-z0-9][a-z0-9._-]{1,63}$"},
+          "image": {"type": "string", "pattern": "^.+\\.png$"},
+          "envelope": {"type": "string", "pattern": "^.+\\.json$"}
+        }
+      }
+    },
+    "status": {"enum": ["review_required", "quarantined"]},
+    "approval": {"const": false}
+  }
+}

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

@@ -11,6 +11,6 @@
     "registry_id": {"type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{2,127}$"},
     "generated_at": {"type": "string", "format": "date-time"},
     "selection_policy": {"type": "object", "additionalProperties": false, "required": ["require_verified", "allow_scaffold_only"], "properties": {"require_verified": {"type": "boolean"}, "allow_scaffold_only": {"type": "boolean"}}},
-    "adapters": {"type": "array", "minItems": 1, "items": {"type": "object", "additionalProperties": false, "required": ["adapter_id", "kind", "status", "adapter_version", "invocation_mode", "cost_class", "inputs", "outputs", "compatibility", "evidence", "limitations", "risk_level", "side_effect_level"], "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"]}, "status": {"type": "string", "enum": ["verified", "scaffold_only", "static_validated", "project_integrated", "disabled"]}, "adapter_version": {"type": "string", "minLength": 1}, "invocation_mode": {"type": "string", "enum": ["none", "manual", "agent-mediated", "api"]}, "cost_class": {"type": "string", "enum": ["included", "metered", "external", "unknown"]}, "inputs": {"type": "array", "items": {"type": "string"}}, "outputs": {"type": "array", "items": {"type": "string"}}, "compatibility": {"type": "object", "additionalProperties": false, "required": ["os"], "properties": {"os": {"type": "array", "items": {"type": "string"}}, "browsers": {"type": "array", "items": {"type": "string"}}}}, "evidence": {"type": "array", "minItems": 1, "items": {"type": "object", "additionalProperties": false, "required": ["path", "sha256", "kind"], "properties": {"path": {"type": "string", "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$)).+"}, "sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"}, "kind": {"type": "string", "enum": ["runtime", "ci", "browser", "static"]}}}}, "limitations": {"type": "array", "items": {"type": "string"}}, "risk_level": {"type": "string", "enum": ["low", "medium", "high"]}, "side_effect_level": {"type": "string", "enum": ["read", "local_write", "user_review_required", "remote_write"]}}}}
+    "adapters": {"type": "array", "minItems": 1, "items": {"type": "object", "additionalProperties": false, "required": ["adapter_id", "kind", "status", "adapter_version", "invocation_mode", "cost_class", "inputs", "outputs", "compatibility", "evidence", "limitations", "risk_level", "side_effect_level"], "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"]}, "status": {"type": "string", "enum": ["verified", "scaffold_only", "static_validated", "project_integrated", "disabled"]}, "adapter_version": {"type": "string", "minLength": 1}, "invocation_mode": {"type": "string", "enum": ["none", "manual", "agent-mediated", "api"]}, "cost_class": {"type": "string", "enum": ["included", "metered", "external", "unknown"]}, "inputs": {"type": "array", "items": {"type": "string"}}, "outputs": {"type": "array", "items": {"type": "string"}}, "compatibility": {"type": "object", "additionalProperties": false, "required": ["os"], "properties": {"os": {"type": "array", "items": {"type": "string"}}, "browsers": {"type": "array", "items": {"type": "string"}}}}, "availability": {"type": "object", "additionalProperties": false, "properties": {"status": {"type": "string", "enum": ["known", "available", "unavailable", "unknown"]}, "environment": {"type": "string"}, "checked_at": {"type": "string", "format": "date-time"}, "reason": {"type": "string"}}}, "capabilities": {"type": "object", "additionalProperties": false, "properties": {"official_docs": {"type": "array", "items": {"type": "string", "format": "uri"}}, "canvas": {"type": "object", "additionalProperties": false, "properties": {"shapes": {"type": "array", "items": {"type": "string", "enum": ["square", "portrait", "landscape"]}}, "allowed_sizes": {"type": "array", "items": {"type": "array", "minItems": 2, "maxItems": 2, "items": {"type": "integer", "minimum": 1}}}, "max_width": {"type": "integer", "minimum": 1}, "max_height": {"type": "integer", "minimum": 1}}}, "frame_behavior": {"type": "object", "additionalProperties": false, "properties": {"mode": {"type": "string", "enum": ["single_frame", "batch_animation", "interpolation", "unknown"]}, "single_frame": {"type": "boolean"}, "max_frames_per_request": {"type": "integer", "minimum": 1}, "frame_count_policy": {"type": "string", "enum": ["fixed", "depends_on_canvas_size", "unknown"]}, "limits_by_canvas": {"type": "array", "items": {"type": "object", "additionalProperties": false, "required": ["canvas", "max_frames_per_request"], "properties": {"canvas": {"type": "array", "minItems": 2, "maxItems": 2, "items": {"type": "integer", "minimum": 1}}, "max_frames_per_request": {"type": "integer", "minimum": 1}}}}}}, "adaptation": {"type": "array", "items": {"type": "string", "enum": ["pad_to_target", "provider_native_resize", "tile_stitch", "integer_upscale"]}}}}, "evidence": {"type": "array", "minItems": 1, "items": {"type": "object", "additionalProperties": false, "required": ["path", "sha256", "kind"], "properties": {"path": {"type": "string", "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$)).+"}, "sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"}, "kind": {"type": "string", "enum": ["runtime", "ci", "browser", "static"]}}}}, "limitations": {"type": "array", "items": {"type": "string"}}, "risk_level": {"type": "string", "enum": ["low", "medium", "high"]}, "side_effect_level": {"type": "string", "enum": ["read", "local_write", "user_review_required", "remote_write"]}}}}
   }
 }

package/schemas/asset-adaptation.schema.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/lenhonbp/MotionLoom/blob/main/schemas/asset-adaptation.schema.json",
+  "title": "MotionLoom asset adaptation report",
+  "description": "Deterministic canvas adaptation evidence. It does not grant approval or production eligibility.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["contract", "schema_version", "operation", "status", "approval", "production_approved", "source", "output", "transform"],
+  "properties": {
+    "contract": {"const": "motionloom-asset-adaptation"},
+    "schema_version": {"const": "0.1"},
+    "operation": {"const": "pad"},
+    "status": {"const": "built"},
+    "approval": {"const": false},
+    "production_approved": {"const": false},
+    "source": {"type": "object", "additionalProperties": false, "required": ["path", "sha256", "canvas"], "properties": {"path": {"type": "string", "minLength": 1}, "sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"}, "canvas": {"type": "array", "minItems": 2, "maxItems": 2, "items": {"type": "integer", "minimum": 1}}}},
+    "output": {"type": "object", "additionalProperties": false, "required": ["path", "sha256", "canvas"], "properties": {"path": {"type": "string", "minLength": 1}, "sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"}, "canvas": {"type": "array", "minItems": 2, "maxItems": 2, "items": {"type": "integer", "minimum": 1}}}},
+    "transform": {"type": "object", "additionalProperties": false, "required": ["scale", "x", "y", "anchor", "crop", "stretch", "interpolation"], "properties": {"scale": {"type": "integer", "minimum": 1}, "x": {"type": "integer", "minimum": 0}, "y": {"type": "integer", "minimum": 0}, "anchor": {"type": "string", "enum": ["center", "footline"]}, "crop": {"const": false}, "stretch": {"const": false}, "interpolation": {"const": "nearest-neighbour"}}},
+    "note": {"type": "string"}
+  }
+}

package/schemas/asset-generation-plan.schema.json

@@ -0,0 +1,77 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/lenhonbp/MotionLoom/blob/main/schemas/asset-generation-plan.schema.json",
+  "title": "MotionLoom project-aware asset generation plan",
+  "description": "Advisory MotionLoom assessment. Recommendations never grant execution authorization or approval.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "contract", "schema_version", "producer", "source", "identity", "status", "decision", "execution_decision",
+    "approval", "production_approved", "request", "project", "registry", "providers", "selection",
+    "recommendations", "agent_guidance", "next_steps", "warnings"
+  ],
+  "properties": {
+    "contract": {"const": "motionloom-asset-generation-plan"},
+    "schema_version": {"const": "0.2"},
+    "producer": {"const": "MotionLoom"},
+    "source": {"type": "string", "minLength": 1},
+    "identity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["product", "role"],
+      "properties": {"product": {"const": "MotionLoom"}, "role": {"type": "string", "minLength": 1}}
+    },
+    "status": {"const": "plan_only"},
+    "decision": {"type": "string", "enum": ["recommendations_available", "compatible_execution_route_available", "execution_route_requires_review_or_adaptation", "no_execution_eligible_route", "no_safe_recommendation_available"]},
+    "execution_decision": {"type": "string", "enum": ["compatible_execution_route_available", "execution_route_requires_review_or_adaptation", "no_execution_eligible_route"]},
+    "approval": {"const": false},
+    "production_approved": {"const": false},
+    "request": {"type": "object"},
+    "project": {"type": "object"},
+    "registry": {"type": "object"},
+    "providers": {"type": "array", "items": {"type": "object"}},
+    "selection": {
+      "type": "object",
+      "required": ["policy", "eligible_count", "provisional_count", "blocked_count", "recommendation_count"],
+      "properties": {
+        "policy": {"type": "object"},
+        "eligible_count": {"type": "integer", "minimum": 0},
+        "provisional_count": {"type": "integer", "minimum": 0},
+        "blocked_count": {"type": "integer", "minimum": 0},
+        "recommendation_count": {"type": "integer", "minimum": 0}
+      }
+    },
+    "recommendations": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["adapter_id", "recommendation_status", "execution_status", "execution_evidence_status", "execution_eligible", "user_preference", "availability", "project_fit", "rationale", "agent_guidance", "approval"],
+        "properties": {
+          "adapter_id": {"type": "string"},
+          "recommendation_status": {"type": "string", "enum": ["recommended", "acceptable", "not_recommended"]},
+          "execution_status": {"type": "string", "enum": ["verified", "provisional", "blocked"]},
+          "execution_evidence_status": {"type": "string", "enum": ["verified", "provisional"]},
+          "execution_eligible": {"type": "boolean"},
+          "user_preference": {"type": "object"},
+          "availability": {"type": "object"},
+          "project_fit": {"type": "string", "enum": ["high", "medium", "low"]},
+          "rationale": {"type": "array", "items": {"type": "string"}},
+          "agent_guidance": {"type": "object"},
+          "approval": {"const": false}
+        }
+      }
+    },
+    "agent_guidance": {
+      "type": "object",
+      "required": ["recommended_by", "summary", "next_step", "validation_route"],
+      "properties": {
+        "recommended_by": {"const": "MotionLoom"},
+        "summary": {"type": "string"},
+        "next_step": {"type": "string"},
+        "validation_route": {"type": "array", "items": {"type": "string"}}
+      }
+    },
+    "next_steps": {"type": "array", "items": {"type": "string"}},
+    "warnings": {"type": "array", "items": {"type": "string"}}
+  }
+}