motionloom 2.6.1 → 2.7.0

package/artifact-adapter-registry.json

@@ -1,8 +1,11 @@
 {
   "schema_version": "0.1",
   "registry_id": "motionloom-artifact-adapters",
-  "generated_at": "2026-08-15T00:00:00Z",
-  "selection_policy": {"require_verified": true, "allow_scaffold_only": false},
+  "generated_at": "2026-08-22T00:00:00Z",
+  "selection_policy": {
+    "require_verified": true,
+    "allow_scaffold_only": false
+  },
   "adapters": [
     {
       "adapter_id": "fixture.local-artifact-intake",
@@ -11,13 +14,489 @@
       "adapter_version": "0.1",
       "invocation_mode": "none",
       "cost_class": "included",
-      "inputs": ["hash-bound-fixture", "control-track"],
-      "outputs": ["generation-receipt", "export-manifest"],
-      "compatibility": {"os": ["linux", "macos", "windows"]},
-      "evidence": [{"path": "docs/research/agent-skill-ecosystem-notes.md", "sha256": "18472ccd959191a4e769675b142076fa3c0103629d67b5be992fa524730cc530", "kind": "static"}],
-      "limitations": ["Fixture adapter is regression evidence only and never generates an asset."],
+      "inputs": [
+        "hash-bound-fixture",
+        "control-track"
+      ],
+      "outputs": [
+        "generation-receipt",
+        "export-manifest",
+        "frame_sequence"
+      ],
+      "compatibility": {
+        "os": [
+          "linux",
+          "macos",
+          "windows"
+        ]
+      },
+      "capabilities": {
+        "canvas": {
+          "max_width": 8192,
+          "max_height": 8192,
+          "shapes": [
+            "square",
+            "portrait",
+            "landscape"
+          ]
+        },
+        "frame_behavior": {
+          "mode": "single_frame",
+          "single_frame": true,
+          "max_frames_per_request": 1
+        },
+        "adaptation": [
+          "pad_to_target",
+          "integer_upscale"
+        ]
+      },
+      "evidence": [
+        {
+          "path": "docs/research/agent-skill-ecosystem-notes.md",
+          "sha256": "18472ccd959191a4e769675b142076fa3c0103629d67b5be992fa524730cc530",
+          "kind": "static"
+        }
+      ],
+      "limitations": [
+        "Fixture adapter is regression evidence only and never generates an asset."
+      ],
       "risk_level": "low",
-      "side_effect_level": "read"
+      "side_effect_level": "read",
+      "availability": {
+        "status": "available",
+        "environment": "repository fixture",
+        "reason": "static regression fixture is present in the repository"
+      }
+    },
+    {
+      "adapter_id": "manual.import-frame-sequence",
+      "kind": "manual_import",
+      "status": "static_validated",
+      "adapter_version": "0.1",
+      "invocation_mode": "manual",
+      "cost_class": "external",
+      "inputs": [
+        "user-provided-images",
+        "reference-images",
+        "control-track"
+      ],
+      "outputs": [
+        "image",
+        "frame_sequence",
+        "generation-receipt",
+        "export-manifest"
+      ],
+      "compatibility": {
+        "os": [
+          "linux",
+          "macos",
+          "windows"
+        ]
+      },
+      "capabilities": {
+        "canvas": {
+          "max_width": 16384,
+          "max_height": 16384,
+          "shapes": [
+            "square",
+            "portrait",
+            "landscape"
+          ]
+        },
+        "frame_behavior": {
+          "mode": "single_frame",
+          "single_frame": true,
+          "max_frames_per_request": 1
+        },
+        "adaptation": [
+          "pad_to_target",
+          "integer_upscale"
+        ]
+      },
+      "evidence": [
+        {
+          "path": "docs/research/ai-animation-tools-2026-report.md",
+          "sha256": "f1050dd77ecffd8ad4ff87cb66f7bb147998bd2743862f57606890a0305a1e37",
+          "kind": "static"
+        }
+      ],
+      "limitations": [
+        "This adapter does not generate or authenticate provider output; it imports user-managed bytes and remains review_required."
+      ],
+      "risk_level": "medium",
+      "side_effect_level": "user_review_required",
+      "availability": {
+        "status": "known",
+        "environment": "user-managed",
+        "reason": "route is known to MotionLoom but requires user-provided frame files"
+      }
+    },
+    {
+      "adapter_id": "pixellab.animate-skeleton",
+      "kind": "external_provider",
+      "status": "scaffold_only",
+      "adapter_version": "0.1",
+      "invocation_mode": "api",
+      "cost_class": "external",
+      "inputs": [
+        "reference-images",
+        "skeleton-poses",
+        "control-track",
+        "action-cues"
+      ],
+      "outputs": [
+        "frame_sequence",
+        "generation-receipt"
+      ],
+      "compatibility": {
+        "os": [
+          "linux",
+          "macos",
+          "windows"
+        ]
+      },
+      "capabilities": {
+        "official_docs": [
+          "https://api.pixellab.ai/v2/docs",
+          "https://www.pixellab.ai/docs/tools/animate-with-skeleton"
+        ],
+        "canvas": {
+          "shapes": [
+            "square"
+          ],
+          "allowed_sizes": [
+            [
+              16,
+              16
+            ],
+            [
+              32,
+              32
+            ],
+            [
+              64,
+              64
+            ],
+            [
+              128,
+              128
+            ],
+            [
+              256,
+              256
+            ]
+          ],
+          "max_width": 256,
+          "max_height": 256
+        },
+        "frame_behavior": {
+          "mode": "batch_animation",
+          "single_frame": false,
+          "max_frames_per_request": 4,
+          "frame_count_policy": "fixed"
+        },
+        "adaptation": [
+          "pad_to_target",
+          "integer_upscale"
+        ]
+      },
+      "evidence": [
+        {
+          "path": "docs/research/ai-animation-tools-2026-report.md",
+          "sha256": "f1050dd77ecffd8ad4ff87cb66f7bb147998bd2743862f57606890a0305a1e37",
+          "kind": "static"
+        }
+      ],
+      "limitations": [
+        "PixelLab skeleton animation is square-canvas and batch-oriented; a non-square target such as 256x448 requires explicit transparent padding and independent post-export envelopes.",
+        "The adapter is metadata-only and does not call PixelLab, store Bearer tokens or prove a provider-native job receipt.",
+        "A batch animation is not equivalent to required per-frame isolated generation."
+      ],
+      "risk_level": "medium",
+      "side_effect_level": "remote_write",
+      "availability": {
+        "status": "unknown",
+        "environment": "external API/extension",
+        "reason": "API key, subscription and provider connectivity are not asserted by the registry"
+      }
+    },
+    {
+      "adapter_id": "pixellab.create-animated-object-character",
+      "kind": "external_provider",
+      "status": "scaffold_only",
+      "adapter_version": "0.1",
+      "invocation_mode": "api",
+      "cost_class": "external",
+      "inputs": [
+        "text-description",
+        "action-cues",
+        "control-track"
+      ],
+      "outputs": [
+        "frame_sequence",
+        "generation-receipt"
+      ],
+      "compatibility": {
+        "os": [
+          "linux",
+          "macos",
+          "windows"
+        ]
+      },
+      "capabilities": {
+        "official_docs": [
+          "https://api.pixellab.ai/v2/docs",
+          "https://www.pixellab.ai/docs/tools/text2animation"
+        ],
+        "canvas": {
+          "shapes": [
+            "square"
+          ],
+          "allowed_sizes": [
+            [
+              32,
+              32
+            ],
+            [
+              64,
+              64
+            ],
+            [
+              128,
+              128
+            ],
+            [
+              256,
+              256
+            ]
+          ],
+          "max_width": 256,
+          "max_height": 256
+        },
+        "frame_behavior": {
+          "mode": "batch_animation",
+          "single_frame": false,
+          "frame_count_policy": "depends_on_canvas_size",
+          "limits_by_canvas": [
+            {
+              "canvas": [
+                32,
+                32
+              ],
+              "max_frames_per_request": 16
+            },
+            {
+              "canvas": [
+                64,
+                64
+              ],
+              "max_frames_per_request": 16
+            },
+            {
+              "canvas": [
+                128,
+                128
+              ],
+              "max_frames_per_request": 4
+            },
+            {
+              "canvas": [
+                256,
+                256
+              ],
+              "max_frames_per_request": 4
+            }
+          ]
+        },
+        "adaptation": [
+          "pad_to_target",
+          "integer_upscale"
+        ]
+      },
+      "evidence": [
+        {
+          "path": "docs/research/ai-animation-tools-2026-report.md",
+          "sha256": "f1050dd77ecffd8ad4ff87cb66f7bb147998bd2743862f57606890a0305a1e37",
+          "kind": "static"
+        }
+      ],
+      "limitations": [
+        "This route creates a new animated object or character from text and an action; it is not the existing-reference Animate with text route.",
+        "The documented tool supports square 32x32, 64x64, 128x128 and 256x256 canvas sizes with frame output depending on canvas-size tier; non-square targets require explicit adaptation.",
+        "The adapter is metadata-only and does not invoke PixelLab, store Bearer tokens or prove provider-native task metadata.",
+        "Batch output must not silently satisfy a per-frame isolation requirement."
+      ],
+      "risk_level": "medium",
+      "side_effect_level": "remote_write",
+      "availability": {
+        "status": "unknown",
+        "environment": "external API/extension",
+        "reason": "API key, subscription and provider connectivity are not asserted by the registry"
+      }
+    },
+    {
+      "adapter_id": "pixellab.animate-with-text",
+      "kind": "external_provider",
+      "status": "scaffold_only",
+      "adapter_version": "0.1",
+      "invocation_mode": "api",
+      "cost_class": "external",
+      "inputs": [
+        "reference-images",
+        "action-cues",
+        "control-track"
+      ],
+      "outputs": [
+        "frame_sequence",
+        "generation-receipt"
+      ],
+      "compatibility": {
+        "os": [
+          "linux",
+          "macos",
+          "windows"
+        ]
+      },
+      "availability": {
+        "status": "unknown",
+        "environment": "external API/extension",
+        "reason": "API key, subscription and provider connectivity are not asserted by the registry"
+      },
+      "capabilities": {
+        "official_docs": [
+          "https://api.pixellab.ai/v2/docs",
+          "https://www.pixellab.ai/docs/tools/animation"
+        ],
+        "canvas": {
+          "shapes": [
+            "square"
+          ],
+          "allowed_sizes": [
+            [
+              32,
+              32
+            ],
+            [
+              64,
+              64
+            ],
+            [
+              128,
+              128
+            ]
+          ],
+          "max_width": 128,
+          "max_height": 128
+        },
+        "frame_behavior": {
+          "mode": "batch_animation",
+          "single_frame": false,
+          "max_frames_per_request": 4,
+          "frame_count_policy": "fixed"
+        },
+        "adaptation": [
+          "pad_to_target",
+          "integer_upscale"
+        ]
+      },
+      "evidence": [
+        {
+          "path": "docs/research/ai-animation-tools-2026-report.md",
+          "sha256": "f1050dd77ecffd8ad4ff87cb66f7bb147998bd2743862f57606890a0305a1e37",
+          "kind": "static"
+        }
+      ],
+      "limitations": [
+        "This route animates an existing reference image with text/action instructions; it is distinct from Create animated object/character.",
+        "The official route generates four animation frames or conditioned frames in its documented workflows; target canvas and provider export details still require a verified receipt before execution.",
+        "The adapter is metadata-only and does not invoke PixelLab, store Bearer tokens or prove provider-native task metadata.",
+        "Batch output must not silently satisfy a per-frame isolation requirement."
+      ],
+      "risk_level": "medium",
+      "side_effect_level": "remote_write"
+    },
+    {
+      "adapter_id": "pixellab.animation-to-animation",
+      "kind": "external_provider",
+      "status": "scaffold_only",
+      "adapter_version": "0.1",
+      "invocation_mode": "api",
+      "cost_class": "external",
+      "inputs": [
+        "reference-images",
+        "animation-reference",
+        "action-cues",
+        "control-track"
+      ],
+      "outputs": [
+        "frame_sequence",
+        "generation-receipt"
+      ],
+      "compatibility": {
+        "os": [
+          "linux",
+          "macos",
+          "windows"
+        ]
+      },
+      "capabilities": {
+        "official_docs": [
+          "https://api.pixellab.ai/v2/docs",
+          "https://www.pixellab.ai/docs/tools/animation-to-animation"
+        ],
+        "canvas": {
+          "shapes": [
+            "square"
+          ],
+          "allowed_sizes": [
+            [
+              16,
+              16
+            ],
+            [
+              32,
+              32
+            ],
+            [
+              64,
+              64
+            ],
+            [
+              128,
+              128
+            ]
+          ],
+          "max_width": 128,
+          "max_height": 128
+        },
+        "frame_behavior": {
+          "mode": "batch_animation",
+          "single_frame": false,
+          "frame_count_policy": "depends_on_canvas_size"
+        },
+        "adaptation": [
+          "pad_to_target",
+          "integer_upscale"
+        ]
+      },
+      "evidence": [
+        {
+          "path": "docs/research/ai-animation-tools-2026-report.md",
+          "sha256": "f1050dd77ecffd8ad4ff87cb66f7bb147998bd2743862f57606890a0305a1e37",
+          "kind": "static"
+        }
+      ],
+      "limitations": [
+        "Animation-to-animation uses square canvas sizes and batch generation; use it as a provisional source only when the project accepts post-export isolation and validation.",
+        "The adapter is metadata-only and does not invoke PixelLab or prove a provider-native job receipt."
+      ],
+      "risk_level": "medium",
+      "side_effect_level": "remote_write",
+      "availability": {
+        "status": "unknown",
+        "environment": "external API/extension",
+        "reason": "API key, subscription and provider connectivity are not asserted by the registry"
+      }
     },
     {
       "adapter_id": "internal.imagegen",
@@ -26,13 +505,47 @@
       "adapter_version": "0.1",
       "invocation_mode": "agent-mediated",
       "cost_class": "included",
-      "inputs": ["reference-images", "control-track", "prompt-hash"],
-      "outputs": ["image", "frame-sequence", "generation-receipt"],
-      "compatibility": {"os": ["linux", "macos", "windows"]},
-      "evidence": [{"path": "docs/research/agent-skill-ecosystem-notes.md", "sha256": "18472ccd959191a4e769675b142076fa3c0103629d67b5be992fa524730cc530", "kind": "static"}],
-      "limitations": ["Adapter imports Agent-mediated ImageGen output only; it does not invoke ImageGen or prove a model, seed, license, rig compatibility, runtime quality or human approval."],
+      "inputs": [
+        "reference-images",
+        "control-track",
+        "prompt-hash"
+      ],
+      "outputs": [
+        "image",
+        "frame-sequence",
+        "generation-receipt"
+      ],
+      "compatibility": {
+        "os": [
+          "linux",
+          "macos",
+          "windows"
+        ]
+      },
+      "capabilities": {
+        "frame_behavior": {
+          "mode": "unknown",
+          "single_frame": false
+        }
+      },
+      "evidence": [
+        {
+          "path": "docs/research/agent-skill-ecosystem-notes.md",
+          "sha256": "18472ccd959191a4e769675b142076fa3c0103629d67b5be992fa524730cc530",
+          "kind": "static"
+        }
+      ],
+      "limitations": [
+        "Adapter imports Agent-mediated ImageGen output only; it does not invoke ImageGen or prove a model, seed, license, rig compatibility, runtime quality or human approval.",
+        "Canvas and isolation capabilities are intentionally unknown until a real export contract is supplied."
+      ],
       "risk_level": "medium",
-      "side_effect_level": "user_review_required"
+      "side_effect_level": "user_review_required",
+      "availability": {
+        "status": "unknown",
+        "environment": "agent-mediated",
+        "reason": "current Agent tool availability must be resolved outside static registry metadata"
+      }
     },
     {
       "adapter_id": "openai.chatgpt",
@@ -41,13 +554,48 @@
       "adapter_version": "0.1",
       "invocation_mode": "manual",
       "cost_class": "external",
-      "inputs": ["user-provided-images", "reference-images", "control-track", "prompt-hash"],
-      "outputs": ["image", "frame-sequence", "generation-receipt"],
-      "compatibility": {"os": ["linux", "macos", "windows"]},
-      "evidence": [{"path": "docs/research/agent-skill-ecosystem-notes.md", "sha256": "18472ccd959191a4e769675b142076fa3c0103629d67b5be992fa524730cc530", "kind": "static"}],
-      "limitations": ["Adapter imports user-provided ChatGPT output only; it does not invoke ChatGPT, verify a provider-native task ID, prove a model, seed, license, rig compatibility, runtime quality or human approval."],
+      "inputs": [
+        "user-provided-images",
+        "reference-images",
+        "control-track",
+        "prompt-hash"
+      ],
+      "outputs": [
+        "image",
+        "frame-sequence",
+        "generation-receipt"
+      ],
+      "compatibility": {
+        "os": [
+          "linux",
+          "macos",
+          "windows"
+        ]
+      },
+      "capabilities": {
+        "frame_behavior": {
+          "mode": "unknown",
+          "single_frame": false
+        }
+      },
+      "evidence": [
+        {
+          "path": "docs/research/agent-skill-ecosystem-notes.md",
+          "sha256": "18472ccd959191a4e769675b142076fa3c0103629d67b5be992fa524730cc530",
+          "kind": "static"
+        }
+      ],
+      "limitations": [
+        "Adapter imports user-provided ChatGPT output only; it does not invoke ChatGPT, verify a provider-native task ID, prove a model, seed, license, rig compatibility, runtime quality or human approval.",
+        "Canvas and isolation capabilities are unknown until the user supplies a provider-specific export contract."
+      ],
       "risk_level": "medium",
-      "side_effect_level": "user_review_required"
+      "side_effect_level": "user_review_required",
+      "availability": {
+        "status": "unknown",
+        "environment": "user-mediated",
+        "reason": "user session/output availability is not asserted by static registry metadata"
+      }
     }
   ]
 }

package/bin/motionloom.mjs

@@ -42,6 +42,8 @@ const PYTHON_COMMANDS = {
   "asset-consistency": "scripts/asset-consistency.py",
   "frame-generation-lock": "scripts/frame-generation-lock.py",
   "frame-set-preflight": "scripts/frame-set-preflight.py",
+  "action-separation": "scripts/action-separation.py",
+  "asset-generation-plan": "scripts/asset-generation-plan.py",
   "artifact-intake": "scripts/artifact-intake.py",
   "runtime-candidate": "scripts/runtime-candidate.py",
   "rig-compatibility": "scripts/rig-compatibility.py",
@@ -50,6 +52,10 @@ const PYTHON_COMMANDS = {
   "alpha-isolate": "scripts/isolate-alpha-background.py",
 };
 
+const DIRECT_NODE_COMMANDS = {
+  "asset-adapt": "scripts/asset-adapt.mjs",
+};
+
 const NODE_COMMANDS = {
   init: "scripts/setup.mjs",
   setup: "scripts/setup.mjs",
@@ -71,6 +77,7 @@ Start here:
   init                   One safe project setup; no animation gate runs
   status                 Short read-only readiness report
   doctor                 Validate the installed Skill package
+  doctor --runtime       Also verify the Playwright Chromium executable
 
 Use when an animation task needs it:
   analyze                Run project analysis and refresh Project Memory
@@ -95,7 +102,10 @@ Use when an animation task needs it:
   asset-provenance       Validate, classify or report asset origin and production readiness
   asset-consistency      Validate frame geometry, atlas contamination and layered-map contracts
   frame-generation-lock  Validate or compose locked per-frame generation instructions
-  frame-set-preflight    Fail closed on shared canvases, scale drift and frame contamination
+  frame-set-preflight    Fail closed on shared canvases, scale drift, frame contamination and action manifest binding
+  action-separation      Validate action-scoped frame manifests and independent competitor-action evidence
+  asset-generation-plan  Produce a MotionLoom project assessment, ranked routes and explicit canvas/frame guidance without invoking APIs
+  asset-adapt             Apply deterministic transparent padding/integer upscale with a hash-bound report
   artifact-intake        Bind generation controls, provenance, adapter metadata and exported bytes
   runtime-candidate      Bind intake exports to consistency contracts before runtime testing
   rig-compatibility      Validate rig bones, sockets, actions, events and runtime adapter evidence
@@ -112,6 +122,7 @@ Cross-platform examples:
   motionloom memory record-decision --project-root . --id ui-easing \\
     --status accepted --summary "Use ease-out for UI entry" --user-confirmed
   motionloom discovery check --root . --json
+  motionloom doctor --runtime --json
   motionloom discovery install-matrix --root . --json
   motionloom capability card --format json
   motionloom visual-truth validate --root . --input src/output/<scene>/visual-truth.json
@@ -119,7 +130,11 @@ Cross-platform examples:
   motionloom asset-provenance check --input <asset-provenance.json> --root <scene-dir> --mode runtime --json
   motionloom asset-consistency validate --kind frame-geometry --input <frame-geometry.json> --root <scene-dir> --json
   motionloom frame-generation-lock compose --input <frame-generation-lock.json> --root <asset-root> --frame-id walk.00 --json
-  motionloom frame-set-preflight --input <frame-geometry.json> --root <asset-root> --json
+  motionloom frame-set-preflight --input <frame-geometry.json> --root <asset-root> --action-manifest <action-sequence.json> --json
+  motionloom action-separation validate --input <action-sequence.json> --root <asset-root> --json
+  motionloom asset-generation-plan plan --request <asset-generation-request.json> --project-root .
+  motionloom asset-generation-plan plan --request <asset-generation-request.json> --project-root . --json --strict
+  motionloom asset-adapt pad --input source.png --output target.png --width 256 --height 448 --anchor footline --report adaptation.json --json
   motionloom artifact-intake intake --root <asset-dir> --registry artifact-adapter-registry.json \\
     --receipt <generation-receipt.json> --controls <control-track.json> --export-manifest <export-manifest.json> --json
   motionloom alpha-isolate <opaque.png> <isolated.png> --report <alpha-report.json>
@@ -138,7 +153,7 @@ if (!command || command === "help" || command === "--help" || command === "-h")
 }
 
 const alias = COMMAND_ALIASES[command];
-const script = alias?.script || NODE_COMMANDS[command] || PYTHON_COMMANDS[command];
+const script = alias?.script || DIRECT_NODE_COMMANDS[command] || NODE_COMMANDS[command] || PYTHON_COMMANDS[command];
 if (!script) {
   console.error(`Unknown MotionLoom command: ${command}`);
   printHelp();
@@ -148,7 +163,9 @@ if (!script) {
 const executable = script.endsWith(".mjs") ? process.execPath : PYTHON;
 const delegatedArgs = alias
   ? [...alias.args, ...args]
-  : NODE_COMMANDS[command] && !["setup", "init"].includes(command)
+  : DIRECT_NODE_COMMANDS[command]
+    ? args
+    : NODE_COMMANDS[command] && !["setup", "init"].includes(command)
     ? [command, ...args]
     : command === "init"
       ? ["init", ...args]