@impractical-ai/motion 0.1.14 → 0.1.15

package/README.md

@@ -1,16 +1,16 @@
 # Impractical Motion CLI
 
-<!-- ARRIVAL-DRIFT-STANDARD START -->
-## Default motion: arrival and residual drift
+<!-- MOTION-STANDARD START -->
+## Default motion: arrival, hold and exit
 
-Foreground motion defaults to an energetic arrival, strong deceleration, and small continuing travel through the reading hold. Compose a deterministic residual trajectory with the native entrance; do not stop and restart with a disconnected tween. “Settled” and “hold” mean readable and visually stable, with subtle nonzero travel unless an explicit freeze, exact alignment or reduced-motion mode requires stillness.
+Each foreground element follows one continuous trajectory: it arrives with energy, decelerates strongly to near-zero speed for the reading hold, then accelerates into its exit or its next authored move. Shape this with the entrance and exit eases themselves; there is no separate drift layer, no constant velocity floor and no perpetual creep. Finish the visible travel quickly: during the hold the ease tail moves the subject less than about 0.5 output px in total, so “settled” and “hold” mean visually still and readable. Exits ease in (or in-out) from that near-zero state, so nothing starts from a dead stop. This applies to whole entities, not to every element inside them: a card, product window, headline block or logo lockup arrives, holds and exits as one unit, and its children (labels, icons, rows, words, buttons) ride with it. Don't recurse and give each child its own arrival, deceleration and exit; that reads as fidgeting and splits attention. Children may still have their own discrete actions inside the hold (text typing in, a toggle flipping, a row highlighting, a number counting), but not their own arrive/hold/exit motion.
 
-Use the Rox `ambientOffset(seconds, amount, phase)` pattern: native 960×540 product groups start around amount 3.2–4, text around 0.8–1. Keep a signed velocity floor with gentle curvature, not a pure sine bob. Move attached labels, controls, connectors and shadows together, avoid double drift, preserve 3D hierarchy, and verify reverse/retimed seeks and late-hold displacement.
+Why no creep: exports render in headless Linux Chromium, which snaps slowly moving text and elements to whole pixels, so a slow drift of about 1 px/s shows up as a visible 1 px tick every ~0.9 s. Move attached labels, controls, connectors and shadows together with their subject, preserve 3D hierarchy, and verify reverse/retimed seeks.
 
-The host owns the background environment. Animate foreground objects only; never move or retime the background to simulate object motion. Reusable foregrounds should be transparent. Keep one primary focus and room around it; purposeful object camera moves remain welcome, and a generic card is not the default visual container.
+The host owns the background environment. Animate foreground objects only; never move or retime the background to simulate object motion. Reusable foregrounds should be transparent. Make things breathe: only one focus at a time, with generous negative space and comfortable margins around it. Keep supporting context subordinate; sequence competing text and actions. Let the focal idea land and be read before handing attention to the next event. If crowded, remove or sequence content before shrinking it. Check entry, hold and exit as well as playback. Purposeful object camera moves remain welcome; a generic card is not the default visual container.
 
 Full specification: [motion standard](../docs/motion-standard.md).
-<!-- ARRIVAL-DRIFT-STANDARD END -->
+<!-- MOTION-STANDARD END -->
 
 Connect Claude Code, Codex, Cursor, or OpenCode to Impractical Motion through
 its MCP server.
@@ -134,5 +134,11 @@ Opt-in flags on the MCP process, for testing quality interventions without touch
 - `IMPRACTICAL_MOTION_LIBRARY_FILE=<path>` — overlay locally generated motion-library
   guidance onto the live catalog.
 
+With quality-loop checks active, text-density findings (`OVERLOADED`) from `get_motion`
+are advisory and never refuse `export_video`: UI labels can exceed the density threshold
+without making a beat unreadable. Review the findings and simplify crowded beats when needed.
+Other shot-list and study-timing findings still refuse export once per draft revision in each
+MCP session; a second attempt on that revision can pass that gate. Other export gates still apply.
+
 If authorization is rejected, rerun the setup command. If the configuration file is malformed,
 the CLI reports its exact path instead of silently ignoring it.

package/assets/impractical/SKILL.md

@@ -5,17 +5,17 @@ description: Create and refine studio-quality motion-graphics launch videos with
 
 # Impractical Motion
 
-<!-- ARRIVAL-DRIFT-STANDARD START -->
-## Default motion: arrival and residual drift
+<!-- MOTION-STANDARD START -->
+## Default motion: arrival, hold and exit
 
-Foreground motion defaults to an energetic arrival, strong deceleration, and small continuing travel through the reading hold. Compose a deterministic residual trajectory with the native entrance; do not stop and restart with a disconnected tween. “Settled” and “hold” mean readable and visually stable, with subtle nonzero travel unless an explicit freeze, exact alignment or reduced-motion mode requires stillness.
+Each foreground element follows one continuous trajectory: it arrives with energy, decelerates strongly to near-zero speed for the reading hold, then accelerates into its exit or its next authored move. Shape this with the entrance and exit eases themselves; there is no separate drift layer, no constant velocity floor and no perpetual creep. Finish the visible travel quickly: during the hold the ease tail moves the subject less than about 0.5 output px in total, so “settled” and “hold” mean visually still and readable. Exits ease in (or in-out) from that near-zero state, so nothing starts from a dead stop. This applies to whole entities, not to every element inside them: a card, product window, headline block or logo lockup arrives, holds and exits as one unit, and its children (labels, icons, rows, words, buttons) ride with it. Don't recurse and give each child its own arrival, deceleration and exit; that reads as fidgeting and splits attention. Children may still have their own discrete actions inside the hold (text typing in, a toggle flipping, a row highlighting, a number counting), but not their own arrive/hold/exit motion.
 
-Use the Rox `ambientOffset(seconds, amount, phase)` pattern: native 960×540 product groups start around amount 3.2–4, text around 0.8–1. Keep a signed velocity floor with gentle curvature, not a pure sine bob. Move attached labels, controls, connectors and shadows together, avoid double drift, preserve 3D hierarchy, and verify reverse/retimed seeks and late-hold displacement.
+Why no creep: exports render in headless Linux Chromium, which snaps slowly moving text and elements to whole pixels, so a slow drift of about 1 px/s shows up as a visible 1 px tick every ~0.9 s. Move attached labels, controls, connectors and shadows together with their subject, preserve 3D hierarchy, and verify reverse/retimed seeks.
 
-The host owns the background environment. Animate foreground objects only; never move or retime the background to simulate object motion. Reusable foregrounds should be transparent. Keep one primary focus and room around it; purposeful object camera moves remain welcome, and a generic card is not the default visual container.
+The host owns the background environment. Animate foreground objects only; never move or retime the background to simulate object motion. Reusable foregrounds should be transparent. Make things breathe: only one focus at a time, with generous negative space and comfortable margins around it. Keep supporting context subordinate; sequence competing text and actions. Let the focal idea land and be read before handing attention to the next event. If crowded, remove or sequence content before shrinking it. Check entry, hold and exit as well as playback. Purposeful object camera moves remain welcome; a generic card is not the default visual container.
 
-For the complete trajectory and review checks, read `motion_context` → `guidance.director` before authoring.
-<!-- ARRIVAL-DRIFT-STANDARD END -->
+For the complete standard and review checks, read `motion_context` → `guidance.director` before authoring.
+<!-- MOTION-STANDARD END -->
 
 You direct the video yourself. Impractical provides the engine, the preview
 build, the render, and the studio the user tweaks in — you provide the

package/dist/{api-VLQHOCLI.js → api-UXWCLV7P.js}

@@ -15,8 +15,8 @@ import {
   waitForJobs,
   withAdmissionReceipt,
   withMeteredCall
-} from "./chunk-O3BUN66P.js";
-import "./chunk-7SNCVSTA.js";
+} from "./chunk-2VIBS7AS.js";
+import "./chunk-52D5QRLI.js";
 import "./chunk-77HVPD4G.js";
 export {
   ApiContractError,

package/dist/{chunk-O3BUN66P.js → chunk-2VIBS7AS.js}

@@ -2,9 +2,9 @@
 import {
   PRODUCTION_APP_URL,
   PRODUCTION_SUPABASE_URL
-} from "./chunk-7SNCVSTA.js";
+} from "./chunk-52D5QRLI.js";
 
-// src/config.ts
+// cli/src/config.ts
 import {
   chmodSync,
   existsSync,
@@ -106,7 +106,7 @@ function requireConfig() {
   return config;
 }
 
-// src/api.ts
+// cli/src/api.ts
 import { AsyncLocalStorage } from "node:async_hooks";
 import { randomUUID } from "node:crypto";
 var admissionContext = new AsyncLocalStorage();

package/dist/{chunk-7SNCVSTA.js → chunk-52D5QRLI.js}

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 
-// package.json
+// cli/package.json
 var package_default = {
   name: "@impractical-ai/motion",
-  version: "0.1.14",
+  version: "0.1.15",
   private: false,
   description: "Create and refine Impractical Motion videos from coding agents and the terminal.",
   homepage: "https://github.com/Openpod/impractical-motion#readme",
@@ -49,7 +49,7 @@ var package_default = {
   }
 };
 
-// src/constants.ts
+// cli/src/constants.ts
 if (package_default.name !== "@impractical-ai/motion" || typeof package_default.version !== "string" || !package_default.version) {
   throw new Error("The packaged CLI manifest is missing valid release metadata");
 }
@@ -57,7 +57,7 @@ var PRODUCTION_APP_URL = "https://motion.impractical.ai";
 var PRODUCTION_SUPABASE_URL = "https://uaxjweednprtbhbceify.supabase.co";
 var PACKAGE_NAME = "@impractical-ai/motion";
 var PACKAGE_VERSION = package_default.version;
-var BUILD_COMMIT = "e734492" ? "e734492" : "dev";
+var BUILD_COMMIT = "e3a238b6" ? "e3a238b6" : "dev";
 var BUILD_ID = `${PACKAGE_VERSION}+${BUILD_COMMIT}`;
 var PACKAGE_COMMAND = `npx --yes ${PACKAGE_NAME}`;
 

package/dist/{chunk-L5ERED5A.js → chunk-TPFRXA7C.js}

@@ -7,16 +7,16 @@ import {
   loadConfig,
   recoverCorruptConfig,
   saveConfig
-} from "./chunk-O3BUN66P.js";
+} from "./chunk-2VIBS7AS.js";
 import {
   PACKAGE_COMMAND,
   PACKAGE_NAME,
   PACKAGE_VERSION,
   PRODUCTION_APP_URL,
   PRODUCTION_SUPABASE_URL
-} from "./chunk-7SNCVSTA.js";
+} from "./chunk-52D5QRLI.js";
 
-// src/onboarding.ts
+// cli/src/onboarding.ts
 import {
   chmodSync,
   existsSync,
@@ -33,7 +33,7 @@ import { fileURLToPath } from "node:url";
 import { spawnSync } from "node:child_process";
 import { createRequire } from "node:module";
 
-// src/workspaces.ts
+// cli/src/workspaces.ts
 var UNSUPPORTED = {
   supported: false,
   keyScope: null,
@@ -73,7 +73,7 @@ function grantScope(grant) {
   return grant.scope === "user" ? "user" : "org";
 }
 
-// src/onboarding.ts
+// cli/src/onboarding.ts
 var CLAUDE_MARKETPLACE = "Openpod/impractical-agent-plugins";
 var CLAUDE_PLUGIN = "impractical-motion@impractical";
 var CLAUDE_MARKETPLACE_NAME = "impractical";

package/dist/{commands-3PIMUGYP.js → commands-MJSGITIZ.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   setup
-} from "./chunk-L5ERED5A.js";
+} from "./chunk-TPFRXA7C.js";
 import {
   invoke,
   invokeAt,
@@ -11,15 +11,15 @@ import {
   saveConfig,
   studioLink,
   waitForJobs
-} from "./chunk-O3BUN66P.js";
-import "./chunk-7SNCVSTA.js";
+} from "./chunk-2VIBS7AS.js";
+import "./chunk-52D5QRLI.js";
 import "./chunk-77HVPD4G.js";
 
-// src/commands.ts
+// cli/src/commands.ts
 import { readFileSync as readFileSync2, writeFileSync } from "node:fs";
 import { randomBytes } from "node:crypto";
 
-// src/media.ts
+// cli/src/media.ts
 import { readFileSync, statSync } from "node:fs";
 import { basename, extname } from "node:path";
 var MAX_UPLOAD_BYTES = 3e8;
@@ -79,7 +79,7 @@ async function uploadAsset(input) {
   return registered.assetId;
 }
 
-// ../src/studio/sampleLogos.ts
+// src/studio/sampleLogos.ts
 var SAMPLE_LOGOS = [
   {
     id: "bolt",
@@ -117,7 +117,7 @@ function sampleLogo(id) {
   return SAMPLE_LOGOS.find((s) => s.id === id);
 }
 
-// ../src/studio/templates.ts
+// src/studio/templates.ts
 var esc = (s) => s.replace(/\\/g, "\\\\").replace(/'/g, "\\'");
 var escTemplate = (s) => s.replace(/\\/g, "\\\\").replace(/`/g, "\\`").replace(/\$\{/g, "\\${");
 var num = (v, fallback) => {
@@ -1091,7 +1091,7 @@ var TEMPLATES = [
   blank
 ];
 
-// ../src/studio/parseFiles.ts
+// src/studio/parseFiles.ts
 var FENCE = /```([^\n`]*)\n([\s\S]*?)```/g;
 var DROP = /* @__PURE__ */ new Set([
   "index.tsx",
@@ -1143,7 +1143,7 @@ function parseSceneFiles(pasted) {
   return files;
 }
 
-// ../src/shared/local-project.ts
+// src/shared/local-project.ts
 var LOCAL_PROJECT_ID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
 var LOCAL_SCENE_NAME_RE = /^[a-z0-9][a-z0-9-]{0,63}$/;
 function isLocalProjectId(value) {
@@ -1163,7 +1163,7 @@ function localProjectMarker(input) {
 `;
 }
 
-// ../src/shared/initial-files.ts
+// src/shared/initial-files.ts
 var TITLE_TEMPLATE = TEMPLATES.find((t) => t.id === "title-card");
 var BLANK_DIRECTION = TEMPLATES.find((t) => t.id === "blank").generate({});
 var defaultParams = (t) => Object.fromEntries(t.params.map((p) => [p.key, p.default]));
@@ -1201,10 +1201,10 @@ function buildInitialFiles(input) {
   };
 }
 
-// ../src/shared/video-models.ts
+// src/shared/video-models.ts
 var DEFAULT_OPENROUTER_VIDEO_MODEL = "anthropic/claude-opus-5";
 
-// ../src/shared/video-clone-command.ts
+// src/shared/video-clone-command.ts
 var TOKEN = /^[A-Za-z0-9_-]{43}$/;
 var SHARE_HOSTS = /* @__PURE__ */ new Set(["impractical.ai", "www.impractical.ai", "impractical-video-shares.vercel.app"]);
 function videoShareToken(source) {
@@ -1218,7 +1218,7 @@ function videoShareToken(source) {
   throw new Error("Use an Impractical video share URL: https://impractical.ai/v/<token>");
 }
 
-// src/clone-video-project.ts
+// cli/src/clone-video-project.ts
 async function cloneVideoProject(source, json = false) {
   const token = videoShareToken(source);
   const result = await invoke("video-shares", { action: "clone", token });
@@ -1234,7 +1234,7 @@ async function cloneVideoProject(source, json = false) {
   console.log(`Use Impractical to open project ${result.projectId} and help me iterate on this video.`);
 }
 
-// src/video-sharing.ts
+// cli/src/video-sharing.ts
 import { openAsBlob } from "node:fs";
 import { readFile, stat } from "node:fs/promises";
 import { basename as basename2, extname as extname2 } from "node:path";
@@ -1335,7 +1335,7 @@ async function shareVideo(rest, flags) {
   }
 }
 
-// src/commands.ts
+// cli/src/commands.ts
 var flagString = (flags, name) => {
   const value = flags[name];
   if (Array.isArray(value)) return value[value.length - 1];
@@ -1438,9 +1438,14 @@ async function generate(flags) {
   }
   const projectId = flagString(flags, "project");
   const feedback = flagString(flags, "feedback");
-  const append = Boolean(projectId && feedback);
+  if (projectId && feedback) {
+    throw new Error(
+      "Projects have one draft now. To revise this video, edit its draft with the MCP tools edit_draft_file / write_draft_files; every save is kept as a version."
+    );
+  }
+  const append = false;
   const slug = flagString(flags, "slug") ?? `${slugify(valueProp)}-${randomBytes(2).toString("hex")}`;
-  const directorIds = (flagString(flags, "directors") ?? "d1,d2").split(",").map((d) => d.trim());
+  const directorIds = (flagString(flags, "directors") ?? "d1").split(",").map((d) => d.trim()).slice(0, 1);
   const files = buildInitialFiles({ valueProp, appCode, brand: brand2 });
   const prepared = await invoke("prepare-generation", {
     ...projectId ? { projectId } : {},

package/dist/index.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import {
   PACKAGE_VERSION
-} from "./chunk-7SNCVSTA.js";
+} from "./chunk-52D5QRLI.js";
 import "./chunk-77HVPD4G.js";
 
-// src/cli-args.ts
+// cli/src/cli-args.ts
 import { parseArgs } from "node:util";
 var CLI_OPTIONS = {
   key: { type: "string" },
@@ -48,7 +48,7 @@ function parseCliArgs(args) {
   });
 }
 
-// src/cli-runtime.ts
+// cli/src/cli-runtime.ts
 var HELP = `impractical \u2014 Impractical Motion from your terminal (and your coding agent)
 
 Setup
@@ -65,7 +65,7 @@ Agents
 Make videos
   generate --value-prop "..." [--directors d1,d2] [--vibe confident]
            [--code-file app.md] [--brand <slug>] [--asset file ...]
-           [--project <id> --feedback "..."] [--model <id>] [--wait]
+           [--project <id>] [--model <id>] [--wait]
   status   --project <id> | --jobs <id,id> [--wait]
   export   [draftId] [--wait] [--out video.mp4]
 
@@ -157,14 +157,14 @@ async function runCli(args, deps) {
   throw new Error(`Unknown command "${[command, ...rest].join(" ")}"`);
 }
 
-// src/index.ts
+// cli/src/index.ts
 runCli(process.argv.slice(2), {
   writeLine: (line) => console.log(line),
-  loadCommands: () => import("./commands-3PIMUGYP.js"),
-  loadApi: () => import("./api-VLQHOCLI.js"),
-  loadMcp: () => import("./stdio-M2YRHGFJ.js")
+  loadCommands: () => import("./commands-MJSGITIZ.js"),
+  loadApi: () => import("./api-UXWCLV7P.js"),
+  loadMcp: () => import("./stdio-LWBKGIWN.js")
 }).catch(async (error) => {
-  const { ApiError } = await import("./api-VLQHOCLI.js");
+  const { ApiError } = await import("./api-UXWCLV7P.js");
   if (error instanceof ApiError) {
     console.error(`Error (${error.status} from ${error.fn}): ${error.message}`);
     if (error.status === 429) console.error("Weekly MCP allowance reached. Upgrade or wait for Monday UTC.");

package/dist/{main-BEONOBG5.js → main-GQ76ZNJB.js}

@@ -4,9 +4,9 @@ import {
   __require
 } from "./chunk-77HVPD4G.js";
 
-// node_modules/esbuild/lib/main.js
+// cli/node_modules/esbuild/lib/main.js
 var require_main = __commonJS({
-  "node_modules/esbuild/lib/main.js"(exports, module) {
+  "cli/node_modules/esbuild/lib/main.js"(exports, module) {
     var __defProp = Object.defineProperty;
     var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
     var __getOwnPropNames = Object.getOwnPropertyNames;