@vibeframe/cli 0.115.1 → 0.115.2

package/dist/index.js

@@ -7768,7 +7768,7 @@ function errorMessage(error) {
   return error instanceof Error ? error.message : "Unknown error";
 }
 function sleep(ms) {
-  return new Promise((resolve86) => setTimeout(resolve86, ms));
+  return new Promise((resolve87) => setTimeout(resolve87, ms));
 }
 var ProviderHttpError;
 var init_http = __esm({
@@ -11655,14 +11655,14 @@ async function loadKokoroRuntime() {
 async function loadKokoroFromWorkspace(baseDir = process.cwd()) {
   try {
     const { readFile: readFile55 } = await import("node:fs/promises");
-    const { join: join33, resolve: resolve86 } = await import("node:path");
+    const { join: join34, resolve: resolve87 } = await import("node:path");
     const { pathToFileURL } = await import("node:url");
-    const pkgDir = resolve86(baseDir, "node_modules", "kokoro-js");
-    const pkg = JSON.parse(await readFile55(join33(pkgDir, "package.json"), "utf-8"));
+    const pkgDir = resolve87(baseDir, "node_modules", "kokoro-js");
+    const pkg = JSON.parse(await readFile55(join34(pkgDir, "package.json"), "utf-8"));
     const entry = pkg.exports?.node?.import ?? pkg.exports?.default ?? pkg.module ?? pkg.main;
     if (!entry)
       return null;
-    const mod = await import(pathToFileURL(join33(pkgDir, entry)).href);
+    const mod = await import(pathToFileURL(join34(pkgDir, entry)).href);
     return mod.KokoroTTS ?? null;
   } catch {
     return null;
@@ -11673,20 +11673,20 @@ async function loadBundledKokoroRuntime(runtimeDir = process.env.VIBE_KOKORO_RUN
   if (!base)
     return null;
   try {
-    const { readFile: readFile55, writeFile: writeFile56, mkdir: mkdir30 } = await import("node:fs/promises");
-    const { join: join33, resolve: resolve86 } = await import("node:path");
+    const { readFile: readFile55, writeFile: writeFile57, mkdir: mkdir31 } = await import("node:fs/promises");
+    const { join: join34, resolve: resolve87 } = await import("node:path");
     const { pathToFileURL } = await import("node:url");
     const { homedir: homedir8 } = await import("node:os");
-    const transformersDir = resolve86(base, "node_modules", "@huggingface", "transformers");
-    const ortDistDir = resolve86(base, "node_modules", "onnxruntime-web", "dist");
-    const transformers = await import(pathToFileURL(join33(transformersDir, "dist", "transformers.web.js")).href);
-    const cacheRoot = join33(homedir8(), ".cache", "vibeframe", "models");
+    const transformersDir = resolve87(base, "node_modules", "@huggingface", "transformers");
+    const ortDistDir = resolve87(base, "node_modules", "onnxruntime-web", "dist");
+    const transformers = await import(pathToFileURL(join34(transformersDir, "dist", "transformers.web.js")).href);
+    const cacheRoot = join34(homedir8(), ".cache", "vibeframe", "models");
     transformers.env.allowLocalModels = false;
     transformers.env.useCustomCache = true;
     transformers.env.customCache = {
       async match(key) {
         try {
-          return new Response(await readFile55(join33(cacheRoot, encodeURIComponent(String(key)))));
+          return new Response(await readFile55(join34(cacheRoot, encodeURIComponent(String(key)))));
         } catch {
           return void 0;
         }
@@ -11694,8 +11694,8 @@ async function loadBundledKokoroRuntime(runtimeDir = process.env.VIBE_KOKORO_RUN
       async put(key, response) {
         try {
           const buf = Buffer.from(await response.arrayBuffer());
-          await mkdir30(cacheRoot, { recursive: true });
-          await writeFile56(join33(cacheRoot, encodeURIComponent(String(key))), buf);
+          await mkdir31(cacheRoot, { recursive: true });
+          await writeFile57(join34(cacheRoot, encodeURIComponent(String(key))), buf);
         } catch {
         }
       }
@@ -12470,7 +12470,7 @@ var init_RunwayProvider = __esm({
        * Sleep helper
        */
       sleep(ms) {
-        return new Promise((resolve86) => setTimeout(resolve86, ms));
+        return new Promise((resolve87) => setTimeout(resolve87, ms));
       }
     };
     RunwayProvider.API_VERSION = "2024-11-06";
@@ -12911,7 +12911,7 @@ var init_KlingProvider = __esm({
        * Sleep helper
        */
       sleep(ms) {
-        return new Promise((resolve86) => setTimeout(resolve86, ms));
+        return new Promise((resolve87) => setTimeout(resolve87, ms));
       }
     };
     klingProvider = new KlingProvider();
@@ -13229,7 +13229,7 @@ var init_GrokProvider = __esm({
         }
       }
       sleep(ms) {
-        return new Promise((resolve86) => setTimeout(resolve86, ms));
+        return new Promise((resolve87) => setTimeout(resolve87, ms));
       }
     };
     grokProvider = new GrokProvider();
@@ -13264,11 +13264,11 @@ var require_middleware = __commonJS({
     "use strict";
     var __awaiter = exports && exports.__awaiter || function(thisArg, _arguments, P, generator) {
       function adopt(value) {
-        return value instanceof P ? value : new P(function(resolve86) {
-          resolve86(value);
+        return value instanceof P ? value : new P(function(resolve87) {
+          resolve87(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve86, reject) {
+      return new (P || (P = Promise))(function(resolve87, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -13284,7 +13284,7 @@ var require_middleware = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve86(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve87(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -13369,11 +13369,11 @@ var require_response = __commonJS({
     "use strict";
     var __awaiter = exports && exports.__awaiter || function(thisArg, _arguments, P, generator) {
       function adopt(value) {
-        return value instanceof P ? value : new P(function(resolve86) {
-          resolve86(value);
+        return value instanceof P ? value : new P(function(resolve87) {
+          resolve87(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve86, reject) {
+      return new (P || (P = Promise))(function(resolve87, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -13389,7 +13389,7 @@ var require_response = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve86(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve87(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -13496,11 +13496,11 @@ var require_utils = __commonJS({
     "use strict";
     var __awaiter = exports && exports.__awaiter || function(thisArg, _arguments, P, generator) {
       function adopt(value) {
-        return value instanceof P ? value : new P(function(resolve86) {
-          resolve86(value);
+        return value instanceof P ? value : new P(function(resolve87) {
+          resolve87(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve86, reject) {
+      return new (P || (P = Promise))(function(resolve87, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -13516,7 +13516,7 @@ var require_utils = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve86(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve87(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -13609,7 +13609,7 @@ var require_utils = __commonJS({
     }
     function sleep3(ms) {
       return __awaiter(this, void 0, void 0, function* () {
-        return new Promise((resolve86) => setTimeout(resolve86, ms));
+        return new Promise((resolve87) => setTimeout(resolve87, ms));
       });
     }
   }
@@ -13621,11 +13621,11 @@ var require_retry = __commonJS({
     "use strict";
     var __awaiter = exports && exports.__awaiter || function(thisArg, _arguments, P, generator) {
       function adopt(value) {
-        return value instanceof P ? value : new P(function(resolve86) {
-          resolve86(value);
+        return value instanceof P ? value : new P(function(resolve87) {
+          resolve87(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve86, reject) {
+      return new (P || (P = Promise))(function(resolve87, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -13641,7 +13641,7 @@ var require_retry = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve86(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve87(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -13848,11 +13848,11 @@ var require_request = __commonJS({
     "use strict";
     var __awaiter = exports && exports.__awaiter || function(thisArg, _arguments, P, generator) {
       function adopt(value) {
-        return value instanceof P ? value : new P(function(resolve86) {
-          resolve86(value);
+        return value instanceof P ? value : new P(function(resolve87) {
+          resolve87(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve86, reject) {
+      return new (P || (P = Promise))(function(resolve87, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -13868,7 +13868,7 @@ var require_request = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve86(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve87(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -13955,11 +13955,11 @@ var require_storage = __commonJS({
     "use strict";
     var __awaiter = exports && exports.__awaiter || function(thisArg, _arguments, P, generator) {
       function adopt(value) {
-        return value instanceof P ? value : new P(function(resolve86) {
-          resolve86(value);
+        return value instanceof P ? value : new P(function(resolve87) {
+          resolve87(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve86, reject) {
+      return new (P || (P = Promise))(function(resolve87, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -13975,7 +13975,7 @@ var require_storage = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve86(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve87(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -14303,11 +14303,11 @@ var require_auth = __commonJS({
     "use strict";
     var __awaiter = exports && exports.__awaiter || function(thisArg, _arguments, P, generator) {
       function adopt(value) {
-        return value instanceof P ? value : new P(function(resolve86) {
-          resolve86(value);
+        return value instanceof P ? value : new P(function(resolve87) {
+          resolve87(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve86, reject) {
+      return new (P || (P = Promise))(function(resolve87, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -14323,7 +14323,7 @@ var require_auth = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve86(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve87(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -14362,11 +14362,11 @@ var require_streaming = __commonJS({
     "use strict";
     var __awaiter = exports && exports.__awaiter || function(thisArg, _arguments, P, generator) {
       function adopt(value) {
-        return value instanceof P ? value : new P(function(resolve86) {
-          resolve86(value);
+        return value instanceof P ? value : new P(function(resolve87) {
+          resolve87(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve86, reject) {
+      return new (P || (P = Promise))(function(resolve87, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -14382,7 +14382,7 @@ var require_streaming = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve86(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve87(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -14615,7 +14615,7 @@ var require_streaming = __commonJS({
           query: options.queryParams
         });
         this.options = options;
-        this.donePromise = new Promise((resolve86, reject) => {
+        this.donePromise = new Promise((resolve87, reject) => {
           if (this.streamClosed) {
             reject(new response_1.ApiError({
               message: "Streaming connection is already closed.",
@@ -14626,11 +14626,11 @@ var require_streaming = __commonJS({
           }
           this.signal.addEventListener("abort", () => {
             var _a2;
-            resolve86((_a2 = this.currentData) !== null && _a2 !== void 0 ? _a2 : {});
+            resolve87((_a2 = this.currentData) !== null && _a2 !== void 0 ? _a2 : {});
           });
           this.on("done", (data) => {
             this.streamClosed = true;
-            resolve86(data);
+            resolve87(data);
           });
           this.on("error", (error) => {
             this.streamClosed = true;
@@ -14655,7 +14655,7 @@ var require_streaming = __commonJS({
             if (data) {
               yield yield __await(data);
             }
-            yield __await(new Promise((resolve86) => setTimeout(resolve86, 16)));
+            yield __await(new Promise((resolve87) => setTimeout(resolve87, 16)));
           }
         });
       }
@@ -14700,11 +14700,11 @@ var require_queue = __commonJS({
     "use strict";
     var __awaiter = exports && exports.__awaiter || function(thisArg, _arguments, P, generator) {
       function adopt(value) {
-        return value instanceof P ? value : new P(function(resolve86) {
-          resolve86(value);
+        return value instanceof P ? value : new P(function(resolve87) {
+          resolve87(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve86, reject) {
+      return new (P || (P = Promise))(function(resolve87, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -14720,7 +14720,7 @@ var require_queue = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve86(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve87(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -14855,7 +14855,7 @@ var require_queue = __commonJS({
               }
               return doneStatus;
             }
-            return new Promise((resolve86, reject) => {
+            return new Promise((resolve87, reject) => {
               var _a;
               let pollingTimeoutId;
               const pollInterval = "pollInterval" in options && typeof options.pollInterval === "number" ? (_a = options.pollInterval) !== null && _a !== void 0 ? _a : DEFAULT_POLL_INTERVAL : DEFAULT_POLL_INTERVAL;
@@ -14887,7 +14887,7 @@ var require_queue = __commonJS({
                   }
                   if (requestStatus.status === "COMPLETED") {
                     clearScheduledTasks();
-                    resolve86(requestStatus);
+                    resolve87(requestStatus);
                     return;
                   }
                   pollingTimeoutId = setTimeout(poll, pollInterval);
@@ -16848,11 +16848,11 @@ var require_realtime = __commonJS({
     "use strict";
     var __awaiter = exports && exports.__awaiter || function(thisArg, _arguments, P, generator) {
       function adopt(value) {
-        return value instanceof P ? value : new P(function(resolve86) {
-          resolve86(value);
+        return value instanceof P ? value : new P(function(resolve87) {
+          resolve87(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve86, reject) {
+      return new (P || (P = Promise))(function(resolve87, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -16868,7 +16868,7 @@ var require_realtime = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve86(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve87(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -17193,11 +17193,11 @@ var require_client = __commonJS({
     "use strict";
     var __awaiter = exports && exports.__awaiter || function(thisArg, _arguments, P, generator) {
       function adopt(value) {
-        return value instanceof P ? value : new P(function(resolve86) {
-          resolve86(value);
+        return value instanceof P ? value : new P(function(resolve87) {
+          resolve87(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve86, reject) {
+      return new (P || (P = Promise))(function(resolve87, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -17213,7 +17213,7 @@ var require_client = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve86(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve87(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -17915,7 +17915,7 @@ var init_ReplicateProvider = __esm({
        * Sleep helper
        */
       sleep(ms) {
-        return new Promise((resolve86) => setTimeout(resolve86, ms));
+        return new Promise((resolve87) => setTimeout(resolve87, ms));
       }
       /**
        * Generate music from text prompt using MusicGen
@@ -26399,7 +26399,7 @@ async function prompt(question, hidden = false) {
     input: process.stdin,
     output: process.stdout
   });
-  return new Promise((resolve86) => {
+  return new Promise((resolve87) => {
     if (hidden && process.stdin.isTTY) {
       process.stdout.write(question);
       let input = "";
@@ -26413,7 +26413,7 @@ async function prompt(question, hidden = false) {
           process.stdin.removeListener("data", onData);
           process.stdout.write("\n");
           rl.close();
-          resolve86(input);
+          resolve87(input);
         } else if (char === "") {
           process.exit(1);
         } else if (char === "\x7F" || char === "\b") {
@@ -26428,7 +26428,7 @@ async function prompt(question, hidden = false) {
     } else {
       rl.question(question, (answer) => {
         rl.close();
-        resolve86(answer);
+        resolve87(answer);
       });
     }
   });
@@ -26802,6 +26802,7 @@ var init_storyboard_parse = __esm({
       "backdrop",
       "video",
       "keyframe",
+      "provider",
       "motion",
       "voice",
       "music",
@@ -27097,7 +27098,7 @@ var init_storyboard_edit = __esm({
     HEADING_RE2 = /^##\s+(.+?)\s*$/gm;
     LEADING_CUE_RE = /^(\s*)```ya?ml\s*\n([\s\S]*?)\n```\s*(?:\n|$)/;
     ALLOWED_CUE_KEYS = new Set(STORYBOARD_CUE_KEYS);
-    STRING_CUE_KEYS = /* @__PURE__ */ new Set(["narration", "backdrop", "video", "keyframe", "motion", "voice", "music", "asset", "eyebrow", "title", "caption", "kicker", "sub"]);
+    STRING_CUE_KEYS = /* @__PURE__ */ new Set(["narration", "backdrop", "video", "keyframe", "provider", "motion", "voice", "music", "asset", "eyebrow", "title", "caption", "kicker", "sub"]);
     MAX_RECOMMENDED_BEAT_SEC = 15;
   }
 });
@@ -33448,16 +33449,16 @@ async function prompt2(question) {
     input,
     output: process.stdout
   });
-  return new Promise((resolve86) => {
+  return new Promise((resolve87) => {
     rl.question(question, (answer) => {
       rl.close();
-      resolve86(answer);
+      resolve87(answer);
     });
   });
 }
 async function promptHidden(question, opts = {}) {
   const input = getTTYInputStream();
-  return new Promise((resolve86) => {
+  return new Promise((resolve87) => {
     let value = "";
     if (typeof input.setRawMode === "function") {
       input.setRawMode(true);
@@ -33471,7 +33472,7 @@ async function promptHidden(question, opts = {}) {
           input.setRawMode(false);
           input.removeListener("data", onData);
           process.stdout.write("\n");
-          resolve86(value);
+          resolve87(value);
         } else if (char === "") {
           input.setRawMode(false);
           process.stdout.write("\n");
@@ -33497,7 +33498,7 @@ async function promptHidden(question, opts = {}) {
       const rl = createInterface2({ input, output: process.stdout });
       rl.question(question, (answer) => {
         rl.close();
-        resolve86(answer);
+        resolve87(answer);
       });
     }
   });
@@ -33505,7 +33506,7 @@ async function promptHidden(question, opts = {}) {
 async function promptSelect(_question, options, defaultIndex = 0, opts = {}) {
   const input = getTTYInputStream();
   if (typeof input.setRawMode === "function") {
-    return new Promise((resolve86) => {
+    return new Promise((resolve87) => {
       let selected = defaultIndex;
       const render = () => {
         if (renderCount > 0) {
@@ -33533,7 +33534,7 @@ async function promptSelect(_question, options, defaultIndex = 0, opts = {}) {
           input.setRawMode(false);
           input.removeListener("data", onData);
           process.stdout.write("\n");
-          resolve86(selected);
+          resolve87(selected);
         } else if (char === "") {
           input.setRawMode(false);
           process.stdout.write("\n");
@@ -33543,7 +33544,7 @@ async function promptSelect(_question, options, defaultIndex = 0, opts = {}) {
           input.setRawMode(false);
           input.removeListener("data", onData);
           process.stdout.write("\n");
-          resolve86(opts.backIndex);
+          resolve87(opts.backIndex);
         } else if (char === "\x1B[A" || char === "k") {
           selected = (selected - 1 + options.length) % options.length;
           render();
@@ -33557,7 +33558,7 @@ async function promptSelect(_question, options, defaultIndex = 0, opts = {}) {
           input.removeListener("data", onData);
           render();
           process.stdout.write("\n");
-          resolve86(selected);
+          resolve87(selected);
         }
       };
       const onData = (chunk) => {
@@ -33581,7 +33582,7 @@ async function promptSelect(_question, options, defaultIndex = 0, opts = {}) {
 async function promptConfirm(question, defaultYes = true) {
   const input = getTTYInputStream();
   if (typeof input.setRawMode === "function") {
-    return new Promise((resolve86) => {
+    return new Promise((resolve87) => {
       const options = ["Yes", "No"];
       let selected = defaultYes ? 0 : 1;
       let renderCount = 0;
@@ -33611,7 +33612,7 @@ async function promptConfirm(question, defaultYes = true) {
           finished = true;
           input.setRawMode(false);
           input.removeListener("data", onData);
-          resolve86(selected === 0);
+          resolve87(selected === 0);
         } else if (char === "") {
           input.setRawMode(false);
           process.stdout.write("\n");
@@ -33625,14 +33626,14 @@ async function promptConfirm(question, defaultYes = true) {
           input.setRawMode(false);
           input.removeListener("data", onData);
           render();
-          resolve86(true);
+          resolve87(true);
         } else if (char === "n" || char === "N") {
           selected = 1;
           finished = true;
           input.setRawMode(false);
           input.removeListener("data", onData);
           render();
-          resolve86(false);
+          resolve87(false);
         }
       };
       const onData = (chunk) => {
@@ -33651,7 +33652,7 @@ async function promptMultiSelect(_question, options, defaultSelected = [], opts
   const input = getTTYInputStream();
   const selected = options.map((_, i) => Boolean(defaultSelected[i]));
   if (typeof input.setRawMode === "function") {
-    return new Promise((resolve86) => {
+    return new Promise((resolve87) => {
       let cursor = 0;
       let renderCount = 0;
       let userToggled = false;
@@ -33681,7 +33682,7 @@ async function promptMultiSelect(_question, options, defaultSelected = [], opts
         for (let i = 0; i < selected.length; i++) {
           if (selected[i]) result.push(i);
         }
-        resolve86(result);
+        resolve87(result);
       };
       let finished = false;
       const handleChar = (char) => {
@@ -35648,7 +35649,7 @@ function unique(items) {
   ];
 }
 function sleep2(ms) {
-  return new Promise((resolve86) => setTimeout(resolve86, ms));
+  return new Promise((resolve87) => setTimeout(resolve87, ms));
 }
 var LOCAL_JOB_ORPHAN_AFTER_MS;
 var init_status_jobs = __esm({
@@ -58291,6 +58292,7 @@ function backdropCacheDescriptor(opts) {
     beatId: opts.beatId,
     cue: opts.cue,
     provider: opts.provider,
+    model: opts.model,
     quality: opts.quality,
     size: opts.size,
     ratio: opts.ratio,
@@ -58302,6 +58304,7 @@ function characterCacheDescriptor(opts) {
     name: opts.name,
     cue: opts.cue,
     provider: opts.provider,
+    model: opts.model,
     quality: opts.quality,
     size: opts.size,
     ext: "png"
@@ -58311,6 +58314,7 @@ function keyframeCacheDescriptor(opts) {
   return cacheAssetDescriptor("keyframe", {
     beatId: opts.beatId,
     cue: opts.cue,
+    model: opts.model,
     provider: opts.provider,
     quality: opts.quality,
     size: opts.size,
@@ -58411,7 +58415,8 @@ async function createBuildPlan(opts) {
   const stage = opts.stage ?? "all";
   const config2 = await readProjectConfig(projectDir);
   const kindPolicy = kindAssetPolicy(config2.config.kind);
-  const skipBackdrop = opts.skipBackdrop ?? kindPolicy.skipBackdrop ?? false;
+  const composerIsFootage = stringOrUndefined3(opts.composer)?.toLowerCase() === "footage";
+  const skipBackdrop = opts.skipBackdrop ?? (composerIsFootage ? true : kindPolicy.skipBackdrop ?? false);
   const skipKeyframe = opts.skipKeyframe ?? kindPolicy.skipKeyframe ?? false;
   const skipVideo = opts.skipVideo ?? kindPolicy.skipVideo ?? false;
   const storyboardPath2 = join24(projectDir, "STORYBOARD.md");
@@ -58530,7 +58535,8 @@ async function createBuildPlan(opts) {
       provider: resolved.image.resolved,
       quality: imageQuality,
       size: imageSize2,
-      ratio: imageRatio
+      ratio: imageRatio,
+      model: opts.imageModel
     }) : null;
     const videoCache = (videoPrompt || keyframePrompt) && !videoReference ? videoCacheDescriptor({
       beatId: beat.id,
@@ -58545,7 +58551,8 @@ async function createBuildPlan(opts) {
       provider: resolved.image.resolved,
       quality: imageQuality,
       size: imageSize2,
-      ratio: imageRatio
+      ratio: imageRatio,
+      model: opts.imageModel
     }) : null;
     const musicCache = musicPrompt && !musicReference ? musicCacheDescriptor({
       beatId: beat.id,
@@ -59020,6 +59027,17 @@ async function keyedProviderResolution(opts, projectDir) {
 }
 async function resolveComposerProvider(input, projectDir) {
   const requested = input.value.toLowerCase();
+  if (requested === "template" || requested === "footage") {
+    return {
+      kind: "composer",
+      requested: input.requested,
+      resolved: requested,
+      source: input.source,
+      requiresKey: false,
+      configured: true,
+      retryWith: []
+    };
+  }
   const explicit = isComposerProvider(requested) ? requested : void 0;
   const resolved = explicit ?? await firstConfiguredComposer(projectDir) ?? "claude";
   const configKey = composerConfigKey(resolved);
@@ -59494,9 +59512,422 @@ var init_compose_aivideo = __esm({
   }
 });
 
+// src/commands/_shared/footage-assemble.ts
+import { existsSync as existsSync48 } from "node:fs";
+import { mkdir as mkdir24, writeFile as writeFile44 } from "node:fs/promises";
+import { dirname as dirname19, isAbsolute as isAbsolute6, join as join26, resolve as resolve58 } from "node:path";
+function planFootageTimeline(inputs, opts = {}) {
+  if (inputs.length === 0) {
+    throw new Error("No clips to assemble.");
+  }
+  const fadeSec = opts.fadeSec ?? FOOTAGE_DEFAULTS.fadeSec;
+  const narrationLeadSec = opts.narrationLeadSec ?? FOOTAGE_DEFAULTS.narrationLeadSec;
+  const narrationTailSec = opts.narrationTailSec ?? FOOTAGE_DEFAULTS.narrationTailSec;
+  const warnings = [];
+  let transitionSec = opts.transitionSec ?? FOOTAGE_DEFAULTS.transitionSec;
+  if (inputs.length > 1) {
+    const shortest = Math.min(...inputs.map((c) => c.clipDurationSec));
+    const maxTransition = round3(Math.max(0, shortest / 2 - 0.05));
+    if (transitionSec > maxTransition) {
+      warnings.push(
+        `Transition ${transitionSec}s exceeds half the shortest clip (${shortest}s); clamped to ${maxTransition}s.`
+      );
+      transitionSec = maxTransition;
+    }
+  }
+  const beats = [];
+  let cursor = 0;
+  for (let i = 0; i < inputs.length; i++) {
+    const input = inputs[i];
+    const isFirst = i === 0;
+    const isLast = i === inputs.length - 1;
+    const startSec = round3(cursor);
+    const inSegmentOffset = (isFirst ? 0 : transitionSec / 2) + narrationLeadSec;
+    let segmentDurationSec = input.clipDurationSec;
+    let narrationStartSec;
+    if (input.narrationDurationSec !== void 0) {
+      narrationStartSec = round3(startSec + inSegmentOffset);
+      const tail = isLast ? Math.max(narrationTailSec, fadeSec) : narrationTailSec;
+      const required = inSegmentOffset + input.narrationDurationSec + tail;
+      segmentDurationSec = Math.max(segmentDurationSec, required);
+    }
+    segmentDurationSec = round3(segmentDurationSec);
+    const extendedSec = round3(segmentDurationSec - input.clipDurationSec);
+    if (extendedSec > 0) {
+      warnings.push(
+        `Beat "${input.id}": narration outruns the clip; last frame held for ${extendedSec}s.`
+      );
+    }
+    beats.push({
+      id: input.id,
+      clipDurationSec: input.clipDurationSec,
+      narrationDurationSec: input.narrationDurationSec,
+      segmentDurationSec,
+      extendedSec,
+      startSec,
+      narrationStartSec
+    });
+    cursor = startSec + segmentDurationSec - (isLast ? 0 : transitionSec);
+  }
+  return {
+    beats,
+    transitionSec,
+    fadeSec,
+    totalDurationSec: round3(cursor),
+    warnings
+  };
+}
+function buildFootageAssembleArgs(opts) {
+  const { plan, sources, narrationPaths, musicPath, outputPath } = opts;
+  const width = opts.width ?? FOOTAGE_DEFAULTS.width;
+  const height = opts.height ?? FOOTAGE_DEFAULTS.height;
+  const fps = opts.fps ?? FOOTAGE_DEFAULTS.fps;
+  const crf = opts.crf ?? (opts.finish ? FOOTAGE_DEFAULTS.finishCrf : FOOTAGE_DEFAULTS.crf);
+  const musicVolume = opts.musicVolume ?? FOOTAGE_DEFAULTS.musicVolume;
+  const total = plan.totalDurationSec;
+  const fade = plan.fadeSec;
+  const args = ["-y"];
+  for (let i = 0; i < sources.length; i++) {
+    const source = sources[i];
+    if (source.kind === "image") {
+      args.push(
+        "-loop",
+        "1",
+        "-framerate",
+        String(fps),
+        "-t",
+        String(plan.beats[i].segmentDurationSec),
+        "-i",
+        source.path
+      );
+    } else {
+      args.push("-i", source.path);
+    }
+  }
+  const narrationEntries = [...narrationPaths.entries()].sort(([a], [b]) => a - b);
+  const narrationInputIndex = /* @__PURE__ */ new Map();
+  for (const [beatIndex, path2] of narrationEntries) {
+    narrationInputIndex.set(beatIndex, sources.length + narrationInputIndex.size);
+    args.push("-i", path2);
+  }
+  let musicInputIndex;
+  if (musicPath) {
+    musicInputIndex = sources.length + narrationInputIndex.size;
+    args.push("-stream_loop", "-1", "-i", musicPath);
+  }
+  const filters = [];
+  for (let i = 0; i < sources.length; i++) {
+    const seg = plan.beats[i].segmentDurationSec;
+    if (sources[i].kind === "image") {
+      const rate = round6((FOOTAGE_DEFAULTS.kenburnsMaxZoom - 1) / Math.max(1, seg * fps));
+      filters.push(
+        `[${i}:v]scale=${width * 2}:${height * 2}:force_original_aspect_ratio=increase,crop=${width * 2}:${height * 2},zoompan=z='min(pzoom+${rate},${FOOTAGE_DEFAULTS.kenburnsMaxZoom})':x='iw/2-(iw/zoom/2)':y='ih/2-(ih/zoom/2)':d=1:s=${width}x${height}:fps=${fps},setsar=1,settb=AVTB,format=yuv420p[v${i}]`
+      );
+      continue;
+    }
+    const extend = plan.beats[i].extendedSec;
+    const tpad = extend > 0 ? `,tpad=stop_mode=clone:stop_duration=${extend}` : "";
+    filters.push(
+      `[${i}:v]scale=${width}:${height}:force_original_aspect_ratio=increase,crop=${width}:${height},setsar=1,fps=${fps},settb=AVTB,format=yuv420p${tpad}[v${i}]`
+    );
+  }
+  let videoLabel = "[v0]";
+  for (let i = 1; i < sources.length; i++) {
+    const out = `[vx${i}]`;
+    filters.push(
+      `${videoLabel}[v${i}]xfade=transition=fade:duration=${plan.transitionSec}:offset=${plan.beats[i].startSec}${out}`
+    );
+    videoLabel = out;
+  }
+  const finishChain = opts.finish ? `${FOOTAGE_DEFAULTS.finish.join(",")},` : "";
+  filters.push(
+    `${videoLabel}${finishChain}fade=t=in:st=0:d=${fade},fade=t=out:st=${round3(Math.max(0, total - fade))}:d=${fade}[vout]`
+  );
+  let audioLabel;
+  if (narrationInputIndex.size > 0) {
+    const delayed = [];
+    for (const [beatIndex, inputIndex] of narrationInputIndex) {
+      const ms = Math.round((plan.beats[beatIndex].narrationStartSec ?? 0) * 1e3);
+      const label = `[nd${beatIndex}]`;
+      filters.push(`[${inputIndex}:a]adelay=${ms}:all=1${label}`);
+      delayed.push(label);
+    }
+    if (delayed.length === 1) {
+      filters.push(`${delayed[0]}anull[nar]`);
+    } else {
+      filters.push(`${delayed.join("")}amix=inputs=${delayed.length}:normalize=0[nar]`);
+    }
+    audioLabel = "[nar]";
+  }
+  if (musicInputIndex !== void 0) {
+    filters.push(
+      `[${musicInputIndex}:a]atrim=0:${total},asetpts=PTS-STARTPTS,volume=${musicVolume}[mb]`
+    );
+    if (audioLabel) {
+      const { thresholdDb, ratio, attackMs, releaseMs } = FOOTAGE_DEFAULTS.duck;
+      const thresholdLinear = round3(Math.pow(10, thresholdDb / 20));
+      filters.push(
+        `${audioLabel}asplit=2[narA][narSC]`,
+        `[mb][narSC]sidechaincompress=threshold=${thresholdLinear}:ratio=${ratio}:attack=${attackMs}:release=${releaseMs}[mduck]`,
+        `[mduck][narA]amix=inputs=2:normalize=0[mix]`
+      );
+      audioLabel = "[mix]";
+    } else {
+      audioLabel = "[mb]";
+    }
+  }
+  if (audioLabel) {
+    filters.push(
+      `${audioLabel}apad,atrim=0:${total},afade=t=out:st=${round3(Math.max(0, total - fade))}:d=${fade}[aout]`
+    );
+  }
+  args.push("-filter_complex", filters.join(";"), "-map", "[vout]");
+  if (audioLabel) {
+    args.push("-map", "[aout]", "-c:a", "aac", "-b:a", "192k");
+  } else {
+    args.push("-an");
+  }
+  args.push(
+    "-c:v",
+    "libx264",
+    "-crf",
+    String(crf),
+    "-pix_fmt",
+    "yuv420p",
+    "-movflags",
+    "+faststart",
+    "-t",
+    String(total),
+    outputPath
+  );
+  return args;
+}
+async function executeFootageAssemble(opts) {
+  const projectDir = resolve58(opts.projectDir);
+  const outputRel = opts.output ?? DEFAULT_FOOTAGE_OUTPUT;
+  const outputPath = isAbsolute6(outputRel) ? outputRel : resolve58(projectDir, outputRel);
+  if (!ffmpegToolsAvailable()) {
+    return {
+      success: false,
+      dryRun: Boolean(opts.dryRun),
+      outputPath,
+      error: "FFmpeg toolchain (ffmpeg + ffprobe) not found in PATH.",
+      suggestion: "Install with: brew install ffmpeg (macOS) or apt install ffmpeg (Linux)."
+    };
+  }
+  let beats;
+  try {
+    const md = await loadStoryboardMarkdown(projectDir);
+    beats = parseStoryboard(md).beats;
+  } catch (err) {
+    return {
+      success: false,
+      dryRun: Boolean(opts.dryRun),
+      outputPath,
+      error: err instanceof Error ? err.message : String(err),
+      suggestion: "Run inside a vibe scene project (needs STORYBOARD.md / scenes/)."
+    };
+  }
+  if (beats.length === 0) {
+    return {
+      success: false,
+      dryRun: Boolean(opts.dryRun),
+      outputPath,
+      error: "STORYBOARD.md has no beats to assemble."
+    };
+  }
+  const missing = [];
+  const sourceRels = [];
+  const kenburnsBeatIds = [];
+  for (const beat of beats) {
+    const clipRel = `assets/video-${beat.id}.mp4`;
+    if (existsSync48(join26(projectDir, clipRel))) {
+      sourceRels.push({ rel: clipRel, kind: "video" });
+      continue;
+    }
+    const keyframeRel = `assets/keyframe-${beat.id}.png`;
+    if (existsSync48(join26(projectDir, keyframeRel))) {
+      sourceRels.push({ rel: keyframeRel, kind: "image" });
+      kenburnsBeatIds.push(beat.id);
+      continue;
+    }
+    missing.push(`${beat.id} (${clipRel})`);
+    sourceRels.push({ rel: clipRel, kind: "video" });
+  }
+  if (missing.length > 0) {
+    return {
+      success: false,
+      dryRun: Boolean(opts.dryRun),
+      outputPath,
+      error: `No clip or keyframe for beat(s): ${missing.join(", ")}.`,
+      suggestion: `Generate them first: vibe build ${projectDir} --stage assets --json`
+    };
+  }
+  const narrationRels = /* @__PURE__ */ new Map();
+  for (let i = 0; i < beats.length; i++) {
+    const rel = ["mp3", "wav"].map((ext) => `assets/narration-${beats[i].id}.${ext}`).find((r) => existsSync48(join26(projectDir, r)));
+    if (rel) narrationRels.set(i, rel);
+  }
+  const music = resolveMusicBed(projectDir, beats[0]?.id, opts.music);
+  if (!music.ok) {
+    return {
+      success: false,
+      dryRun: Boolean(opts.dryRun),
+      outputPath,
+      error: music.error
+    };
+  }
+  const inputs = [];
+  for (let i = 0; i < beats.length; i++) {
+    const clipDurationSec = sourceRels[i].kind === "image" ? beats[i].duration ?? FOOTAGE_DEFAULTS.kenburnsSec : round3(await ffprobeDuration(join26(projectDir, sourceRels[i].rel)));
+    const narrationRel = narrationRels.get(i);
+    const narrationDurationSec = narrationRel ? round3(await ffprobeDuration(join26(projectDir, narrationRel))) : void 0;
+    inputs.push({ id: beats[i].id, clipDurationSec, narrationDurationSec });
+  }
+  const plan = planFootageTimeline(inputs, {
+    transitionSec: opts.transitionSec,
+    fadeSec: opts.fadeSec
+  });
+  const musicVolume = opts.musicVolume ?? FOOTAGE_DEFAULTS.musicVolume;
+  const report = {
+    schemaVersion: "1",
+    kind: "footage-assemble",
+    project: projectDir,
+    output: outputPath,
+    totalDurationSec: plan.totalDurationSec,
+    transitionSec: plan.transitionSec,
+    fadeSec: plan.fadeSec,
+    beats: plan.beats.map((b, i) => ({
+      ...b,
+      clip: sourceRels[i].rel,
+      source: sourceRels[i].kind === "image" ? "keyframe-kenburns" : "clip",
+      narration: narrationRels.get(i)
+    })),
+    music: music.rel ? {
+      path: music.rel,
+      source: music.source,
+      volume: musicVolume,
+      ducked: narrationRels.size > 0
+    } : null,
+    finish: opts.finish ? { filters: [...FOOTAGE_DEFAULTS.finish] } : null,
+    warnings: [
+      ...plan.warnings,
+      ...kenburnsBeatIds.map(
+        (id) => `Beat "${id}": no generated clip; keyframe ken-burns fallback used.`
+      )
+    ],
+    nextActions: [
+      {
+        id: "inspect-footage-cut",
+        kind: "command",
+        label: "Inspect the assembled cut",
+        command: `vibe inspect render ${outputPath} --cheap --json`,
+        fixOwner: "vibe",
+        costTier: "free",
+        safeToAutoRun: true,
+        requiresConfirmation: false,
+        reason: "Verify duration, black frames, and audio coverage without watching the video."
+      },
+      ...kenburnsBeatIds.map((id) => ({
+        id: `regenerate-clip-${id}`,
+        kind: "command",
+        label: `Regenerate the missing clip for beat "${id}"`,
+        command: `vibe build ${projectDir} --beat ${id} --stage assets --force --json`,
+        fixOwner: "vibe",
+        costTier: "very-high",
+        safeToAutoRun: false,
+        requiresConfirmation: true,
+        reason: `Beat "${id}" shipped as a ken-burns still; regenerating the clip restores real motion.`
+      }))
+    ]
+  };
+  if (opts.dryRun) {
+    return { success: true, dryRun: true, outputPath, report };
+  }
+  await mkdir24(dirname19(outputPath), { recursive: true });
+  const args = buildFootageAssembleArgs({
+    sources: sourceRels.map((s) => ({ path: join26(projectDir, s.rel), kind: s.kind })),
+    plan,
+    narrationPaths: new Map(
+      [...narrationRels.entries()].map(([i, rel]) => [i, join26(projectDir, rel)])
+    ),
+    musicPath: music.rel ? isAbsolute6(music.rel) ? music.rel : join26(projectDir, music.rel) : void 0,
+    outputPath,
+    musicVolume,
+    finish: opts.finish
+  });
+  try {
+    await execSafe("ffmpeg", args, { timeout: 6e5 });
+  } catch (err) {
+    return {
+      success: false,
+      dryRun: false,
+      outputPath,
+      report,
+      error: `FFmpeg assembly failed: ${err instanceof Error ? err.message : String(err)}`,
+      suggestion: "Re-run with --dry-run --json to inspect the planned timeline."
+    };
+  }
+  const reportPath = join26(projectDir, "assemble-report.json");
+  await writeFile44(reportPath, `${JSON.stringify(report, null, 2)}
+`, "utf-8");
+  return { success: true, dryRun: false, outputPath, reportPath, report };
+}
+function resolveMusicBed(projectDir, firstBeatId, flag) {
+  if (flag === "none") return { ok: true, source: "flag" };
+  if (flag) {
+    const abs = isAbsolute6(flag) ? flag : join26(projectDir, flag);
+    if (!existsSync48(abs)) return { ok: false, error: `Music file not found: ${abs}` };
+    return { ok: true, rel: flag, source: "flag" };
+  }
+  const candidates = ["assets/music.mp3", "assets/music.wav"];
+  if (firstBeatId) {
+    candidates.push(`assets/music-${firstBeatId}.mp3`, `assets/music-${firstBeatId}.wav`);
+  }
+  const rel = candidates.find((r) => existsSync48(join26(projectDir, r)));
+  return { ok: true, rel, source: "auto" };
+}
+var FOOTAGE_DEFAULTS, round3, round6, DEFAULT_FOOTAGE_OUTPUT;
+var init_footage_assemble = __esm({
+  "src/commands/_shared/footage-assemble.ts"() {
+    "use strict";
+    init_exec_safe();
+    init_ffmpeg_gate();
+    init_storyboard_parse();
+    init_storyboard_source();
+    FOOTAGE_DEFAULTS = {
+      transitionSec: 0.5,
+      fadeSec: 0.6,
+      narrationLeadSec: 0.35,
+      narrationTailSec: 0.4,
+      width: 1920,
+      height: 1080,
+      fps: 30,
+      crf: 18,
+      finishCrf: 23,
+      musicVolume: 0.35,
+      duck: { thresholdDb: -30, ratio: 3, attackMs: 20, releaseMs: 200 },
+      /**
+       * The cinematic finish pass: subtle vignette + temporal film grain, applied
+       * before the head/tail fades. These are the field-tested values that pull
+       * provider clips away from the too-clean "AI look"; the fades multiply over
+       * them so blacks stay black.
+       */
+      finish: ["vignette=angle=PI/5", "noise=alls=7:allf=t"],
+      /** Base segment length for a ken-burns keyframe fallback (no clip to probe). */
+      kenburnsSec: 4,
+      /** Slow-push ceiling for the ken-burns zoom. */
+      kenburnsMaxZoom: 1.1
+    };
+    round3 = (n) => Math.round(n * 1e3) / 1e3;
+    round6 = (n) => Math.round(n * 1e6) / 1e6;
+    DEFAULT_FOOTAGE_OUTPUT = "renders/footage.mp4";
+  }
+});
+
 // src/commands/_shared/scene-audio-scan.ts
 import { readFile as readFile41 } from "node:fs/promises";
-import { resolve as resolve58 } from "node:path";
+import { resolve as resolve59 } from "node:path";
 function parseRootClips(rootHtml) {
   const clips = [];
   const clipRegex = /<div\b[^>]*class="clip"[^>]*>/gi;
@@ -59534,7 +59965,7 @@ function parseSceneAudios(compositionHtml) {
 }
 function makeFsCompositionReader(projectDir) {
   return async (compositionSrcRel) => {
-    const abs = resolve58(projectDir, compositionSrcRel);
+    const abs = resolve59(projectDir, compositionSrcRel);
     try {
       return await readFile41(abs, "utf-8");
     } catch {
@@ -59553,7 +59984,7 @@ async function scanSceneAudio(opts) {
     for (const audio of audios) {
       out.push({
         srcRel: audio.srcRel,
-        srcAbs: resolve58(opts.projectDir, audio.srcRel),
+        srcAbs: resolve59(opts.projectDir, audio.srcRel),
         absoluteStart: clip.start + audio.localStart,
         durationHint: audio.durationHint,
         clipDurationCap: clip.duration - audio.localStart,
@@ -59568,7 +59999,7 @@ async function scanSceneAudio(opts) {
   for (const audio of rootAudios) {
     out.push({
       srcRel: audio.srcRel,
-      srcAbs: resolve58(opts.projectDir, audio.srcRel),
+      srcAbs: resolve59(opts.projectDir, audio.srcRel),
       absoluteStart: audio.localStart,
       durationHint: audio.durationHint,
       clipDurationCap: Math.max(0, maxClipEnd - audio.localStart),
@@ -59603,7 +60034,7 @@ var init_scene_audio_scan = __esm({
 
 // src/commands/_shared/scene-audio-mux.ts
 import { rename as rename4, unlink } from "node:fs/promises";
-import { resolve as resolve59, dirname as dirname19, extname as extname13, basename as basename20 } from "node:path";
+import { resolve as resolve60, dirname as dirname20, extname as extname13, basename as basename20 } from "node:path";
 function buildAudioMuxFilter(audios) {
   if (audios.length === 0) return null;
   const labels = [];
@@ -59663,8 +60094,8 @@ async function muxAudioIntoVideo(opts) {
     return { success: true, outputPath: opts.videoPath, audioCount: 0 };
   }
   const ext = extname13(opts.videoPath) || `.${opts.format}`;
-  const tmpPath = resolve59(
-    dirname19(opts.videoPath),
+  const tmpPath = resolve60(
+    dirname20(opts.videoPath),
     `.${basename20(opts.videoPath, ext)}.muxing${ext}`
   );
   const args = ["-y", "-loglevel", "error", "-i", opts.videoPath];
@@ -59726,15 +60157,15 @@ var init_scene_audio_mux = __esm({
 });
 
 // src/commands/_shared/scene-assemble.ts
-import { existsSync as existsSync48 } from "node:fs";
+import { existsSync as existsSync49 } from "node:fs";
 import { readFile as readFile42 } from "node:fs/promises";
-import { resolve as resolve60, isAbsolute as isAbsolute6 } from "node:path";
+import { resolve as resolve61, isAbsolute as isAbsolute7 } from "node:path";
 async function executeSceneAssemble(opts) {
-  const projectDir = resolve60(opts.projectDir);
+  const projectDir = resolve61(opts.projectDir);
   const root = opts.root ?? "index.html";
   const format = opts.format ?? "mp4";
-  const videoPath = isAbsolute6(opts.videoPath) ? opts.videoPath : resolve60(projectDir, opts.videoPath);
-  if (!existsSync48(videoPath)) {
+  const videoPath = isAbsolute7(opts.videoPath) ? opts.videoPath : resolve61(projectDir, opts.videoPath);
+  if (!existsSync49(videoPath)) {
     return {
       success: false,
       audioCount: 0,
@@ -59743,8 +60174,8 @@ async function executeSceneAssemble(opts) {
       error: `Video not found: ${videoPath}. Render it first (e.g. \`vibe render --silent\`).`
     };
   }
-  const rootPath = resolve60(projectDir, root);
-  if (!existsSync48(rootPath)) {
+  const rootPath = resolve61(projectDir, root);
+  if (!existsSync49(rootPath)) {
     return {
       success: false,
       audioCount: 0,
@@ -59811,9 +60242,9 @@ __export(scene_render_exports, {
   qualityToCrf: () => qualityToCrf2
 });
 import { execFile as execFile2 } from "node:child_process";
-import { existsSync as existsSync49 } from "node:fs";
-import { mkdir as mkdir24, readFile as readFile43, stat as stat8, writeFile as writeFile44 } from "node:fs/promises";
-import { resolve as resolve61, relative as relative10, dirname as dirname20, basename as basename21, join as join26, isAbsolute as isAbsolute7 } from "node:path";
+import { existsSync as existsSync50 } from "node:fs";
+import { mkdir as mkdir25, readFile as readFile43, stat as stat8, writeFile as writeFile45 } from "node:fs/promises";
+import { resolve as resolve62, relative as relative10, dirname as dirname21, basename as basename21, join as join27, isAbsolute as isAbsolute8 } from "node:path";
 import { promisify as promisify2 } from "node:util";
 import {
   createRenderJob,
@@ -59826,9 +60257,9 @@ function defaultOutputPath(opts) {
   const fmt = opts.format ?? "mp4";
   const now = opts.now ?? /* @__PURE__ */ new Date();
   const stamp = now.toISOString().replace(/[:T]/g, "-").replace(/\..+$/, "");
-  const name = (opts.projectName ?? basename21(resolve61(opts.projectDir))) || "scene";
+  const name = (opts.projectName ?? basename21(resolve62(opts.projectDir))) || "scene";
   const beat = opts.beatId ? `-${sanitizeFileSegment2(opts.beatId)}` : "";
-  return resolve61(opts.projectDir, "renders", `${name}${beat}-${stamp}.${fmt}`);
+  return resolve62(opts.projectDir, "renders", `${name}${beat}-${stamp}.${fmt}`);
 }
 function buildRenderConfig(opts) {
   const quality = opts.quality ?? "standard";
@@ -59866,7 +60297,7 @@ function buildMediaOpenCommand(action, filePath, platform3 = process.platform) {
       display: ["cmd", ...args].map(quoteCliArg).join(" ")
     };
   }
-  const target = action === "reveal" ? dirname20(filePath) : filePath;
+  const target = action === "reveal" ? dirname21(filePath) : filePath;
   return {
     command: "xdg-open",
     args: [target],
@@ -59874,7 +60305,7 @@ function buildMediaOpenCommand(action, filePath, platform3 = process.platform) {
   };
 }
 async function executeSceneRender(opts = {}) {
-  const projectDir = resolve61(opts.projectDir ?? ".");
+  const projectDir = resolve62(opts.projectDir ?? ".");
   const projectConfig = await readProjectConfig(projectDir);
   const engine = projectConfig.config.composition.engine;
   if (engine !== "hyperframes") {
@@ -59905,7 +60336,7 @@ async function executeSceneRender(opts = {}) {
   }
   let autoSyncApplied = false;
   let autoSyncWarning;
-  if (!opts.beatId && existsSync49(join26(projectDir, "STORYBOARD.md"))) {
+  if (!opts.beatId && existsSync50(join27(projectDir, "STORYBOARD.md"))) {
     try {
       const rootPlan = await createProjectRootSyncPlan({ projectDir });
       const subPlans = await createSubCompDurationSyncPlans({
@@ -59947,7 +60378,7 @@ async function executeSceneRender(opts = {}) {
       kind: "render",
       beat: opts.beatId ?? null,
       root,
-      error: `Root composition not found: ${resolve61(projectDir, root)}. Run \`vibe build ${projectDir}\` once to create the render scaffold, or scaffold it up front with \`vibe init <dir> --profile full\`.`
+      error: `Root composition not found: ${resolve62(projectDir, root)}. Run \`vibe build ${projectDir}\` once to create the render scaffold, or scaffold it up front with \`vibe init <dir> --profile full\`.`
     };
   }
   const chrome = await preflightChrome();
@@ -59961,8 +60392,8 @@ async function executeSceneRender(opts = {}) {
     };
   }
   const projectName = projectConfig.config.name;
-  const outputPath = opts.output ? resolve61(projectDir, opts.output) : defaultOutputPath({ projectDir, projectName, format: opts.format, beatId: opts.beatId });
-  await mkdir24(dirname20(outputPath), { recursive: true });
+  const outputPath = opts.output ? resolve62(projectDir, opts.output) : defaultOutputPath({ projectDir, projectName, format: opts.format, beatId: opts.beatId });
+  await mkdir25(dirname21(outputPath), { recursive: true });
   const config2 = buildRenderConfig({
     fps: opts.fps,
     quality: opts.quality,
@@ -60074,11 +60505,11 @@ async function safeStat(p) {
 }
 async function prepareBeatRenderRoot(opts) {
   const root = `.vibeframe/tmp/render-beat-${sanitizeFileSegment2(opts.beatId)}.html`;
-  const reportPath = join26(opts.projectDir, "build-report.json");
+  const reportPath = join27(opts.projectDir, "build-report.json");
   const retryWith = [
     `vibe build ${opts.projectDir} --beat ${opts.beatId} --stage sync --json`
   ];
-  if (!existsSync49(reportPath)) {
+  if (!existsSync50(reportPath)) {
     return {
       success: false,
       root,
@@ -60158,8 +60589,8 @@ async function prepareBeatRenderRoot(opts) {
     durationSec,
     narrationPath
   });
-  await mkdir24(dirname20(join26(opts.projectDir, root)), { recursive: true });
-  await writeFile44(join26(opts.projectDir, root), html, "utf-8");
+  await mkdir25(dirname21(join27(opts.projectDir, root)), { recursive: true });
+  await writeFile45(join27(opts.projectDir, root), html, "utf-8");
   return {
     success: true,
     root,
@@ -60223,9 +60654,9 @@ function reportedBeatAssetPaths(beat) {
   ]);
 }
 async function writeRenderReport(projectDir, result) {
-  const reportPath = join26(projectDir, "render-report.json");
+  const reportPath = join27(projectDir, "render-report.json");
   try {
-    await writeFile44(
+    await writeFile45(
       reportPath,
       JSON.stringify(
         {
@@ -60264,8 +60695,8 @@ async function writeRenderReport(projectDir, result) {
   }
 }
 function pathExists3(projectDir, value) {
-  const abs = isAbsolute7(value) ? value : resolve61(projectDir, value);
-  return existsSync49(abs);
+  const abs = isAbsolute8(value) ? value : resolve62(projectDir, value);
+  return existsSync50(abs);
 }
 function stringValue(value) {
   return typeof value === "string" && value.length > 0 ? value : void 0;
@@ -60318,14 +60749,15 @@ var init_scene_build_mode = __esm({
 var scene_build_exports = {};
 __export(scene_build_exports, {
   executeSceneBuild: () => executeSceneBuild,
+  isLikenessRejection: () => isLikenessRejection,
   resolveSceneBuildMode: () => resolveSceneBuildMode
 });
-import { existsSync as existsSync50, readFileSync as readFileSync2 } from "node:fs";
-import { copyFile as copyFile5, mkdir as mkdir25, readFile as readFile44, rm as rm5, writeFile as writeFile45 } from "node:fs/promises";
-import { dirname as dirname21, join as join27, resolve as resolve62 } from "node:path";
+import { existsSync as existsSync51, readFileSync as readFileSync2 } from "node:fs";
+import { copyFile as copyFile5, mkdir as mkdir26, readFile as readFile44, rm as rm5, writeFile as writeFile46 } from "node:fs/promises";
+import { dirname as dirname22, join as join28, resolve as resolve63 } from "node:path";
 function readProjectKindSync(projectDir) {
   try {
-    const raw = readFileSync2(join27(projectDir, "vibe.config.json"), "utf-8");
+    const raw = readFileSync2(join28(projectDir, "vibe.config.json"), "utf-8");
     const k = JSON.parse(raw).kind;
     return typeof k === "string" && isSceneKind(k) ? k : "cinema";
   } catch {
@@ -60334,16 +60766,17 @@ function readProjectKindSync(projectDir) {
 }
 async function executeSceneBuild(opts) {
   const startedAt = Date.now();
-  const projectDir = resolve62(opts.projectDir);
+  const projectDir = resolve63(opts.projectDir);
   const onProgress = opts.onProgress ?? (() => {
   });
   const projectKind = readProjectKindSync(projectDir);
   const kindPolicy = kindAssetPolicy(projectKind);
   const composer = opts.composer ?? composerDefaultForKind(projectKind);
-  const skipBackdrop = opts.skipBackdrop ?? kindPolicy.skipBackdrop ?? false;
+  const skipBackdrop = opts.skipBackdrop ?? (composer === "footage" ? true : kindPolicy.skipBackdrop ?? false);
   const skipKeyframe = opts.skipKeyframe ?? kindPolicy.skipKeyframe ?? false;
   const skipVideoAssets = opts.skipVideo ?? kindPolicy.skipVideo ?? false;
-  const mode = composer === "template" ? "batch" : resolveSceneBuildMode(opts);
+  const skipTranscript = opts.skipTranscript ?? composer === "footage";
+  const mode = composer === "template" || composer === "footage" ? "batch" : resolveSceneBuildMode(opts);
   const selectedStage = opts.stage ?? (opts.skipRender ? "sync" : "all");
   const skipVideoStopsRender = (opts.skipVideo ?? false) && (selectedStage === "all" || selectedStage === "render");
   const effectiveSkipRender = (opts.skipRender ?? false) || skipVideoStopsRender;
@@ -60356,7 +60789,7 @@ async function executeSceneBuild(opts) {
     );
   }
   let sceneRepair = skippedSceneRepairSummary();
-  const storyboardPath2 = join27(projectDir, "STORYBOARD.md");
+  const storyboardPath2 = join28(projectDir, "STORYBOARD.md");
   const buildPlan = await createBuildPlan({
     projectDir,
     stage: selectedStage,
@@ -60372,8 +60805,10 @@ async function executeSceneBuild(opts) {
     imageProvider: opts.imageProvider,
     imageQuality: opts.imageQuality,
     imageSize: opts.imageSize,
+    imageModel: opts.imageModel,
     videoProvider: opts.videoProvider,
     musicProvider: opts.musicProvider,
+    skipTranscript,
     composer,
     force: opts.force
   });
@@ -60426,7 +60861,7 @@ async function executeSceneBuild(opts) {
   }
   if (!buildPlan.validation.ok) {
     let invalidBeats = [];
-    if (existsSync50(storyboardPath2)) {
+    if (existsSync51(storyboardPath2)) {
       invalidBeats = parseStoryboard(await loadStoryboardMarkdown(projectDir)).beats;
     }
     return finishBuildResult({
@@ -60451,7 +60886,7 @@ async function executeSceneBuild(opts) {
       totalLatencyMs: Date.now() - startedAt
     });
   }
-  if (!existsSync50(storyboardPath2)) {
+  if (!existsSync51(storyboardPath2)) {
     return finishBuildResult({
       success: false,
       phase: "failed",
@@ -60546,6 +60981,7 @@ async function executeSceneBuild(opts) {
             imageProvider,
             imageSize: opts.imageSize ?? "1536x1024",
             imageQuality: opts.imageQuality ?? "hd",
+            imageModel: opts.imageModel,
             force: opts.force ?? false,
             onProgress
           }
@@ -60567,6 +61003,7 @@ async function executeSceneBuild(opts) {
         musicProvider,
         imageQuality: opts.imageQuality ?? "hd",
         imageSize: opts.imageSize ?? "1536x1024",
+        imageModel: opts.imageModel,
         skipNarration: opts.skipNarration ?? false,
         skipBackdrop,
         skipVideo: skipVideoAssets,
@@ -60656,7 +61093,7 @@ async function executeSceneBuild(opts) {
       totalLatencyMs: Date.now() - startedAt
     });
   }
-  if (shouldRunStage(selectedStage, "transcript") && !(opts.skipTranscript ?? false)) {
+  if (shouldRunStage(selectedStage, "transcript") && !skipTranscript) {
     const { statuses } = await runTranscriptStage(activeBeats, beatOutcomes, {
       projectDir,
       force: opts.force ?? false,
@@ -60685,9 +61122,9 @@ async function executeSceneBuild(opts) {
   }
   if (shouldRunStage(selectedStage, "compose")) {
     if (mode === "agent") {
-      const compositionsDir = join27(projectDir, "compositions");
+      const compositionsDir = join28(projectDir, "compositions");
       const missingBeats = activeBeats.filter(
-        (b) => !existsSync50(join27(compositionsDir, `scene-${b.id}.html`))
+        (b) => !existsSync51(join28(compositionsDir, `scene-${b.id}.html`))
       );
       if (missingBeats.length > 0) {
         const plan = await getComposePrompts({ projectDir, beatId: opts.beatId });
@@ -60721,6 +61158,8 @@ async function executeSceneBuild(opts) {
       }
       onProgress({ type: "phase-start", phase: "compose" });
       stageReports.compose.status = "done";
+    } else if (composer === "footage") {
+      stageReports.compose.status = "skipped";
     } else if (composer === "template") {
       onProgress({ type: "phase-start", phase: "compose" });
       try {
@@ -60760,8 +61199,8 @@ async function executeSceneBuild(opts) {
   if (stageReports.compose.status === "done") {
     for (const beat of composer === "template" ? [] : activeBeats) {
       const videoRel = `assets/video-${beat.id}.mp4`;
-      const compositionAbs = join27(projectDir, "compositions", `scene-${beat.id}.html`);
-      if (!existsSync50(join27(projectDir, videoRel)) || !existsSync50(compositionAbs)) continue;
+      const compositionAbs = join28(projectDir, "compositions", `scene-${beat.id}.html`);
+      if (!existsSync51(join28(projectDir, videoRel)) || !existsSync51(compositionAbs)) continue;
       const html = readFileSync2(compositionAbs, "utf-8");
       if (!html.includes(videoRel)) {
         warnings.push(
@@ -60816,8 +61255,8 @@ async function executeSceneBuild(opts) {
       totalLatencyMs: Date.now() - startedAt
     });
   }
-  if (shouldRunStage(selectedStage, "sync")) {
-    if (!existsSync50(join27(projectDir, "index.html"))) {
+  if (composer !== "footage" && shouldRunStage(selectedStage, "sync")) {
+    if (!existsSync51(join28(projectDir, "index.html"))) {
       await scaffoldSceneProject({
         dir: projectDir,
         name: projectDir.split(/[\\/]/).filter(Boolean).pop(),
@@ -60886,7 +61325,50 @@ async function executeSceneBuild(opts) {
   }
   let outputPath;
   let renderResult;
-  if (shouldRunStage(selectedStage, "render")) {
+  let footageReport;
+  if (composer === "footage" && shouldRunStage(selectedStage, "render")) {
+    onProgress({ type: "phase-start", phase: "render" });
+    onProgress({ type: "render-start" });
+    const assembled = await executeFootageAssemble({ projectDir, finish: true });
+    if (!assembled.success) {
+      stageReports.render.status = "failed";
+      const renderRetryWith = unique5([
+        ...retryWith,
+        `vibe build ${projectDir} --stage assets --json`,
+        `vibe assemble ${projectDir} --footage --dry-run --json`
+      ]);
+      stageReports.render.retryWith = unique5([
+        ...stageReports.render.retryWith,
+        ...renderRetryWith
+      ]);
+      return finishBuildResult({
+        success: false,
+        phase: "failed",
+        mode,
+        selectedStage,
+        code: "FOOTAGE_ASSEMBLE_FAILED",
+        error: `footage assemble failed: ${assembled.error ?? "unknown"}`,
+        message: `footage assemble failed: ${assembled.error ?? "unknown"}`,
+        suggestion: assembled.suggestion ?? "Ensure every beat has a generated clip (run --stage assets), then retry.",
+        recoverable: true,
+        beats: beatOutcomes,
+        estimatedCostUsd: buildPlan.estimatedCostUsd,
+        costUsd: stageReports.assets.costUsd + stageReports.compose.costUsd,
+        stageReports,
+        sceneRepair,
+        warnings,
+        retryWith: renderRetryWith,
+        status: "failed",
+        currentStage: "render",
+        totalLatencyMs: Date.now() - startedAt
+      });
+    }
+    outputPath = assembled.outputPath;
+    footageReport = assembled.report;
+    warnings.push(...assembled.report?.warnings ?? []);
+    onProgress({ type: "render-done", outputPath });
+    stageReports.render.status = "done";
+  } else if (shouldRunStage(selectedStage, "render")) {
     onProgress({ type: "phase-start", phase: "render" });
     onProgress({ type: "render-start" });
     renderResult = await executeSceneRender({ projectDir });
@@ -60941,6 +61423,7 @@ async function executeSceneBuild(opts) {
     beats: beatOutcomes,
     outputPath,
     renderResult,
+    footageReport,
     estimatedCostUsd: buildPlan.estimatedCostUsd,
     costUsd: stageReports.assets.costUsd + stageReports.compose.costUsd,
     stageReports,
@@ -61075,7 +61558,7 @@ async function dispatchNarration(beat, ctx) {
       return {
         status: "cached",
         path: existingRel,
-        durationSec: await safeAudioDuration(join27(ctx.projectDir, existingRel)),
+        durationSec: await safeAudioDuration(join28(ctx.projectDir, existingRel)),
         provider: metadata?.provider,
         cachePath: metadata?.cachePath,
         cacheKey: metadata?.cacheKey,
@@ -61099,9 +61582,9 @@ async function dispatchNarration(beat, ctx) {
     voice,
     ext: resolution.audioExtension
   });
-  const cacheAbs = join27(ctx.projectDir, cache.path);
+  const cacheAbs = join28(ctx.projectDir, cache.path);
   const rel = `assets/narration-${beat.id}.${resolution.audioExtension}`;
-  const abs = join27(ctx.projectDir, rel);
+  const abs = join28(ctx.projectDir, rel);
   if (existingRel && !ctx.force && isFreshCanonicalAsset({
     projectDir: ctx.projectDir,
     kind: "narration",
@@ -61115,7 +61598,7 @@ async function dispatchNarration(beat, ctx) {
     return {
       status: "cached",
       path: existingRel,
-      durationSec: await safeAudioDuration(join27(ctx.projectDir, existingRel)),
+      durationSec: await safeAudioDuration(join28(ctx.projectDir, existingRel)),
       provider: resolution.provider,
       cachePath: cache.path,
       cacheKey: cache.key,
@@ -61123,8 +61606,8 @@ async function dispatchNarration(beat, ctx) {
       freshness: "fresh"
     };
   }
-  if (existsSync50(cacheAbs) && !ctx.force) {
-    await mkdir25(dirname21(abs), { recursive: true });
+  if (existsSync51(cacheAbs) && !ctx.force) {
+    await mkdir26(dirname22(abs), { recursive: true });
     await copyFile5(cacheAbs, abs);
     await writeAssetMetadata({
       projectDir: ctx.projectDir,
@@ -61155,14 +61638,14 @@ async function dispatchNarration(beat, ctx) {
     ctx.onProgress({ type: "narration-failed", beatId: beat.id, error });
     return { status: "failed", error };
   }
-  await mkdir25(dirname21(abs), { recursive: true });
-  await writeFile45(abs, result.audioBuffer);
+  await mkdir26(dirname22(abs), { recursive: true });
+  await writeFile46(abs, result.audioBuffer);
   for (const otherExt of ["mp3", "wav"]) {
-    const sibling = join27(ctx.projectDir, `assets/narration-${beat.id}.${otherExt}`);
-    if (sibling !== abs && existsSync50(sibling)) await rm5(sibling, { force: true });
+    const sibling = join28(ctx.projectDir, `assets/narration-${beat.id}.${otherExt}`);
+    if (sibling !== abs && existsSync51(sibling)) await rm5(sibling, { force: true });
   }
-  await mkdir25(dirname21(cacheAbs), { recursive: true });
-  await writeFile45(cacheAbs, result.audioBuffer);
+  await mkdir26(dirname22(cacheAbs), { recursive: true });
+  await writeFile46(cacheAbs, result.audioBuffer);
   await writeAssetMetadata({
     projectDir: ctx.projectDir,
     kind: "narration",
@@ -61194,8 +61677,8 @@ async function dispatchNarration(beat, ctx) {
 async function dispatchTranscript(beat, narrationPath, narrationFresh, ctx) {
   if (!narrationPath) return "skipped";
   const relPath = beatTranscriptRelPath(beat.id);
-  const abs = join27(ctx.projectDir, relPath);
-  if (existsSync50(abs) && !ctx.force && !narrationFresh) {
+  const abs = join28(ctx.projectDir, relPath);
+  if (existsSync51(abs) && !ctx.force && !narrationFresh) {
     ctx.onProgress({ type: "transcript-cached", beatId: beat.id, path: relPath });
     return "cached";
   }
@@ -61208,7 +61691,7 @@ async function dispatchTranscript(beat, narrationPath, narrationFresh, ctx) {
     });
     return "skipped";
   }
-  const words = await transcribeNarrationWords(join27(ctx.projectDir, narrationPath), { apiKey });
+  const words = await transcribeNarrationWords(join28(ctx.projectDir, narrationPath), { apiKey });
   if (words.length === 0) {
     ctx.onProgress({
       type: "transcript-skipped",
@@ -61218,8 +61701,8 @@ async function dispatchTranscript(beat, narrationPath, narrationFresh, ctx) {
     return "skipped";
   }
   try {
-    await mkdir25(dirname21(abs), { recursive: true });
-    await writeFile45(abs, JSON.stringify(words, null, 2), "utf-8");
+    await mkdir26(dirname22(abs), { recursive: true });
+    await writeFile46(abs, JSON.stringify(words, null, 2), "utf-8");
   } catch (err) {
     ctx.onProgress({
       type: "transcript-skipped",
@@ -61266,7 +61749,7 @@ async function buildCharacters(characters, ctx) {
   const size = ctx.imageSize ?? "1536x1024";
   for (const character of characters) {
     if (character.imagePath) {
-      if (existsSync50(join27(ctx.projectDir, character.imagePath))) {
+      if (existsSync51(join28(ctx.projectDir, character.imagePath))) {
         paths.set(character.name, character.imagePath);
         ctx.onProgress({ type: "character-cached", name: character.name, path: character.imagePath });
       } else {
@@ -61279,16 +61762,17 @@ async function buildCharacters(characters, ctx) {
     if (!character.prompt) continue;
     const prompt3 = characterSheetPrompt(character.name, character.prompt);
     const rel = `assets/character-${character.name}.png`;
-    const abs = join27(ctx.projectDir, rel);
+    const abs = join28(ctx.projectDir, rel);
     const metadataOptions = { quality: ctx.imageQuality, size };
     const cache = characterCacheDescriptor({
       name: character.name,
       cue: prompt3,
       provider: ctx.imageProvider,
       quality: ctx.imageQuality,
-      size
+      size,
+      model: ctx.imageModel
     });
-    if (existsSync50(abs) && !ctx.force) {
+    if (existsSync51(abs) && !ctx.force) {
       const metadata = readAssetMetadata(ctx.projectDir, "character", character.name);
       if (!metadata || isFreshCanonicalAsset({
         projectDir: ctx.projectDir,
@@ -61304,9 +61788,9 @@ async function buildCharacters(characters, ctx) {
         continue;
       }
     }
-    const cacheAbs = join27(ctx.projectDir, cache.path);
-    if (existsSync50(cacheAbs) && !ctx.force) {
-      await mkdir25(dirname21(abs), { recursive: true });
+    const cacheAbs = join28(ctx.projectDir, cache.path);
+    if (existsSync51(cacheAbs) && !ctx.force) {
+      await mkdir26(dirname22(abs), { recursive: true });
       await copyFile5(cacheAbs, abs);
       await writeAssetMetadata({
         projectDir: ctx.projectDir,
@@ -61329,7 +61813,8 @@ async function buildCharacters(characters, ctx) {
         projectDir: ctx.projectDir,
         imageProvider: ctx.imageProvider,
         imageSize: size,
-        imageQuality: ctx.imageQuality
+        imageQuality: ctx.imageQuality,
+        imageModel: ctx.imageModel
       },
       imageRatioForSize(size)
     );
@@ -61338,10 +61823,10 @@ async function buildCharacters(characters, ctx) {
       ctx.onProgress({ type: "character-failed", name: character.name, error: generated.error });
       continue;
     }
-    await mkdir25(dirname21(abs), { recursive: true });
-    await writeFile45(abs, generated.buffer);
-    await mkdir25(dirname21(cacheAbs), { recursive: true });
-    await writeFile45(cacheAbs, generated.buffer);
+    await mkdir26(dirname22(abs), { recursive: true });
+    await writeFile46(abs, generated.buffer);
+    await mkdir26(dirname22(cacheAbs), { recursive: true });
+    await writeFile46(cacheAbs, generated.buffer);
     await writeAssetMetadata({
       projectDir: ctx.projectDir,
       kind: "character",
@@ -61371,7 +61856,7 @@ async function dispatchBackdrop(beat, ctx) {
   if (!cue) return { status: "no-cue" };
   const prompt3 = augmentBackdropPrompt(cue);
   const rel = `assets/backdrop-${beat.id}.png`;
-  const abs = join27(ctx.projectDir, rel);
+  const abs = join28(ctx.projectDir, rel);
   const size = ctx.imageSize ?? "1536x1024";
   const ratio = imageRatioForSize(size);
   const metadataOptions = { quality: ctx.imageQuality, size, ratio };
@@ -61381,10 +61866,11 @@ async function dispatchBackdrop(beat, ctx) {
     provider: ctx.imageProvider,
     quality: ctx.imageQuality,
     size,
-    ratio
+    ratio,
+    model: ctx.imageModel
   });
   const metadataPath = assetMetadataPath("backdrop", beat.id);
-  if (existsSync50(abs) && !ctx.force) {
+  if (existsSync51(abs) && !ctx.force) {
     const metadata = readAssetMetadata(ctx.projectDir, "backdrop", beat.id);
     if (!metadata || isFreshCanonicalAsset({
       projectDir: ctx.projectDir,
@@ -61407,9 +61893,9 @@ async function dispatchBackdrop(beat, ctx) {
       };
     }
   }
-  const cacheAbs = join27(ctx.projectDir, cache.path);
-  if (existsSync50(cacheAbs) && !ctx.force) {
-    await mkdir25(dirname21(abs), { recursive: true });
+  const cacheAbs = join28(ctx.projectDir, cache.path);
+  if (existsSync51(cacheAbs) && !ctx.force) {
+    await mkdir26(dirname22(abs), { recursive: true });
     await copyFile5(cacheAbs, abs);
     await writeAssetMetadata({
       projectDir: ctx.projectDir,
@@ -61439,11 +61925,11 @@ async function dispatchBackdrop(beat, ctx) {
     ctx.onProgress({ type: "backdrop-failed", beatId: beat.id, error });
     return { status: "failed", error };
   }
-  await mkdir25(dirname21(abs), { recursive: true });
+  await mkdir26(dirname22(abs), { recursive: true });
   const buffer = generated.buffer;
-  await writeFile45(abs, buffer);
-  await mkdir25(dirname21(cacheAbs), { recursive: true });
-  await writeFile45(cacheAbs, buffer);
+  await writeFile46(abs, buffer);
+  await mkdir26(dirname22(cacheAbs), { recursive: true });
+  await writeFile46(cacheAbs, buffer);
   await writeAssetMetadata({
     projectDir: ctx.projectDir,
     kind: "backdrop",
@@ -61485,7 +61971,9 @@ async function generateBackdropImage(prompt3, ctx, ratio) {
     const provider2 = new OpenAIImageProvider();
     await provider2.initialize({ apiKey });
     const result2 = await provider2.generateImage(prompt3, {
-      model: "gpt-image-2",
+      // CLI input is free-form; an alias the provider doesn't know fails the
+      // API call and surfaces as a beat-scoped backdrop/keyframe error.
+      model: ctx.imageModel ?? "gpt-image-2",
       size: ctx.imageSize,
       quality: ctx.imageQuality
     });
@@ -61495,7 +61983,7 @@ async function generateBackdropImage(prompt3, ctx, ratio) {
     const provider2 = new GeminiProvider();
     await provider2.initialize({ apiKey });
     const result2 = await provider2.generateImage(prompt3, {
-      model: "flash",
+      model: ctx.imageModel ?? "flash",
       aspectRatio: ratio
     });
     return imageBufferFromResult(result2);
@@ -61528,7 +62016,7 @@ async function editKeyframeImage(prompt3, sheetBuffers, ctx, ratio) {
     const provider2 = new GeminiProvider();
     await provider2.initialize({ apiKey });
     const result2 = await provider2.editImage(sheetBuffers, prompt3, {
-      model: "flash",
+      model: ctx.imageModel ?? "flash",
       aspectRatio: ratio
     });
     return imageBufferFromResult(result2);
@@ -61540,7 +62028,7 @@ async function editKeyframeImage(prompt3, sheetBuffers, ctx, ratio) {
 }
 async function ensureKeyframe(beat, ctx, keyframeCue, characterRefsRel) {
   const rel = `assets/keyframe-${beat.id}.png`;
-  const abs = join27(ctx.projectDir, rel);
+  const abs = join28(ctx.projectDir, rel);
   const size = ctx.imageSize ?? "1536x1024";
   const ratio = imageRatioForSize(size);
   const metadataOptions = { quality: ctx.imageQuality, size, ratio };
@@ -61551,9 +62039,10 @@ async function ensureKeyframe(beat, ctx, keyframeCue, characterRefsRel) {
     quality: ctx.imageQuality,
     size,
     ratio,
-    characters: characterRefsRel
+    characters: characterRefsRel,
+    model: ctx.imageModel
   });
-  if (existsSync50(abs) && !ctx.force) {
+  if (existsSync51(abs) && !ctx.force) {
     const metadata = readAssetMetadata(ctx.projectDir, "keyframe", beat.id);
     if (!metadata || isFreshCanonicalAsset({
       projectDir: ctx.projectDir,
@@ -61567,9 +62056,9 @@ async function ensureKeyframe(beat, ctx, keyframeCue, characterRefsRel) {
       return { status: "cached", rel };
     }
   }
-  const cacheAbs = join27(ctx.projectDir, cache.path);
-  if (existsSync50(cacheAbs) && !ctx.force) {
-    await mkdir25(dirname21(abs), { recursive: true });
+  const cacheAbs = join28(ctx.projectDir, cache.path);
+  if (existsSync51(cacheAbs) && !ctx.force) {
+    await mkdir26(dirname22(abs), { recursive: true });
     await copyFile5(cacheAbs, abs);
     await writeAssetMetadata({
       projectDir: ctx.projectDir,
@@ -61586,22 +62075,23 @@ async function ensureKeyframe(beat, ctx, keyframeCue, characterRefsRel) {
   }
   const sheetBuffers = [];
   for (const relPath of characterRefsRel) {
-    const sheetAbs = join27(ctx.projectDir, relPath);
-    if (existsSync50(sheetAbs)) sheetBuffers.push(await readFile44(sheetAbs));
+    const sheetAbs = join28(ctx.projectDir, relPath);
+    if (existsSync51(sheetAbs)) sheetBuffers.push(await readFile44(sheetAbs));
   }
   const imgCtx = {
     projectDir: ctx.projectDir,
     imageProvider: ctx.imageProvider,
     imageSize: size,
-    imageQuality: ctx.imageQuality
+    imageQuality: ctx.imageQuality,
+    imageModel: ctx.imageModel
   };
   const identityLock = "Keep the EXACT same person and face as the reference image(s): identical facial features (eyes, nose shape, jawline), skin tone and complexion, hairstyle, hair color, and wardrobe. Do not restyle or change the face. Change only the scene, pose, framing, and lighting. ";
   const generated = sheetBuffers.length > 0 ? await editKeyframeImage(`${identityLock}${keyframeCue}`, sheetBuffers, imgCtx, ratio) : await generateBackdropImage(keyframeCue, imgCtx, ratio);
   if (!generated.success) return { status: "failed", error: generated.error };
-  await mkdir25(dirname21(abs), { recursive: true });
-  await writeFile45(abs, generated.buffer);
-  await mkdir25(dirname21(cacheAbs), { recursive: true });
-  await writeFile45(cacheAbs, generated.buffer);
+  await mkdir26(dirname22(abs), { recursive: true });
+  await writeFile46(abs, generated.buffer);
+  await mkdir26(dirname22(cacheAbs), { recursive: true });
+  await writeFile46(cacheAbs, generated.buffer);
   await writeAssetMetadata({
     projectDir: ctx.projectDir,
     kind: "keyframe",
@@ -61655,14 +62145,16 @@ async function dispatchVideo(beat, ctx, keyframe) {
   const keyframeCue = stringOrUndefined4(beat.cues?.keyframe);
   const prompt3 = stringOrUndefined4(beat.cues?.video) ?? keyframeCue;
   if (!prompt3) return { status: "no-cue" };
+  const providerCue = stringOrUndefined4(beat.cues?.provider);
+  const requestedProvider = providerCue ? resolveBuildVideoProvider(providerCue) : ctx.videoProvider;
   const characterRefsRel = beatCharacterNames(beat.cues).map((name) => ctx.characterPaths?.get(name)).filter((p) => typeof p === "string");
-  const characterRefsAbs = characterRefsRel.map((p) => join27(ctx.projectDir, p));
+  const characterRefsAbs = characterRefsRel.map((p) => join28(ctx.projectDir, p));
   const rel = `assets/video-${beat.id}.mp4`;
-  const abs = join27(ctx.projectDir, rel);
+  const abs = join28(ctx.projectDir, rel);
   const cache = videoCacheDescriptor({
     beatId: beat.id,
     cue: prompt3,
-    provider: ctx.videoProvider,
+    provider: requestedProvider,
     duration: normalizeVideoDuration(beat.duration),
     // Keyframe mode keys the clip to the keyframe prompt; refs feed the keyframe,
     // not the clip directly.
@@ -61670,14 +62162,14 @@ async function dispatchVideo(beat, ctx, keyframe) {
     keyframe: keyframeCue
   });
   const metadataPath = assetMetadataPath("video", beat.id);
-  if (existsSync50(abs) && !ctx.force) {
+  if (existsSync51(abs) && !ctx.force) {
     const metadata = readAssetMetadata(ctx.projectDir, "video", beat.id);
     if (!metadata || isFreshCanonicalAsset({
       projectDir: ctx.projectDir,
       kind: "video",
       beatId: beat.id,
       cue: prompt3,
-      provider: ctx.videoProvider,
+      provider: requestedProvider,
       options: { duration: normalizeVideoDuration(beat.duration), ratio: "16:9" },
       cacheKey: cache.key
     })) {
@@ -61685,7 +62177,7 @@ async function dispatchVideo(beat, ctx, keyframe) {
       return {
         status: "cached",
         path: rel,
-        provider: metadata?.provider ?? ctx.videoProvider,
+        provider: metadata?.provider ?? requestedProvider,
         cachePath: metadata?.cachePath ?? cache.path,
         cacheKey: metadata?.cacheKey ?? cache.key,
         metadataPath,
@@ -61693,16 +62185,16 @@ async function dispatchVideo(beat, ctx, keyframe) {
       };
     }
   }
-  const cacheAbs = join27(ctx.projectDir, cache.path);
-  if (existsSync50(cacheAbs) && !ctx.force) {
-    await mkdir25(dirname21(abs), { recursive: true });
+  const cacheAbs = join28(ctx.projectDir, cache.path);
+  if (existsSync51(cacheAbs) && !ctx.force) {
+    await mkdir26(dirname22(abs), { recursive: true });
     await copyFile5(cacheAbs, abs);
     await writeAssetMetadata({
       projectDir: ctx.projectDir,
       kind: "video",
       beatId: beat.id,
       cue: prompt3,
-      provider: ctx.videoProvider,
+      provider: requestedProvider,
       options: { duration: normalizeVideoDuration(beat.duration), ratio: "16:9" },
       cacheKey: cache.key,
       canonicalPath: rel,
@@ -61712,7 +62204,7 @@ async function dispatchVideo(beat, ctx, keyframe) {
     return {
       status: "cached",
       path: rel,
-      provider: ctx.videoProvider,
+      provider: requestedProvider,
       cachePath: cache.path,
       cacheKey: cache.key,
       metadataPath,
@@ -61725,11 +62217,11 @@ async function dispatchVideo(beat, ctx, keyframe) {
     ctx.onProgress({ type: "video-skipped", beatId: beat.id, reason });
     return { status: "skipped" };
   }
-  const keyframeImageAbs = keyframeImageRel ? join27(ctx.projectDir, keyframeImageRel) : void 0;
+  const keyframeImageAbs = keyframeImageRel ? join28(ctx.projectDir, keyframeImageRel) : void 0;
   loadSceneBuildEnv(ctx.projectDir);
-  const result = await executeVideoGenerate({
+  const generateWith = (provider, apiKey) => executeVideoGenerate({
     prompt: prompt3,
-    provider: ctx.videoProvider,
+    provider,
     duration: normalizeVideoDuration(beat.duration),
     ratio: "16:9",
     output: abs,
@@ -61742,22 +62234,44 @@ async function dispatchVideo(beat, ctx, keyframe) {
     // track carries audio), so the model's generated audio is never used. Disable
     // it: it's wasted, and Seedance's audio moderation can spuriously fail a beat.
     generateAudio: false,
-    apiKey: await apiKeyForVideoProvider(ctx.videoProvider, ctx.projectDir)
+    apiKey
   });
+  let activeProvider = requestedProvider;
+  let result = await generateWith(
+    activeProvider,
+    await apiKeyForVideoProvider(activeProvider, ctx.projectDir)
+  );
   if (!result.success || !result.taskId) {
     const error = result.error ?? "video generation did not return a task id";
-    ctx.onProgress({ type: "video-failed", beatId: beat.id, error });
-    return { status: "failed", error };
+    const runwayKey = isLikenessRejection(error) && activeProvider !== "runway" ? await apiKeyForVideoProvider("runway", ctx.projectDir) : void 0;
+    if (!runwayKey) {
+      ctx.onProgress({ type: "video-failed", beatId: beat.id, error });
+      return { status: "failed", error };
+    }
+    ctx.onProgress({
+      type: "video-fallback",
+      beatId: beat.id,
+      from: activeProvider,
+      to: "runway",
+      reason: error
+    });
+    activeProvider = "runway";
+    result = await generateWith(activeProvider, runwayKey);
+    if (!result.success || !result.taskId) {
+      const fallbackError = result.error ?? "video generation did not return a task id";
+      ctx.onProgress({ type: "video-failed", beatId: beat.id, error: fallbackError });
+      return { status: "failed", error: fallbackError };
+    }
   }
-  if (result.status === "completed" && existsSync50(abs)) {
-    await mkdir25(dirname21(cacheAbs), { recursive: true });
+  if (result.status === "completed" && existsSync51(abs)) {
+    await mkdir26(dirname22(cacheAbs), { recursive: true });
     await copyFile5(abs, cacheAbs);
     await writeAssetMetadata({
       projectDir: ctx.projectDir,
       kind: "video",
       beatId: beat.id,
       cue: prompt3,
-      provider: result.provider ?? ctx.videoProvider,
+      provider: result.provider ?? activeProvider,
       options: { duration: normalizeVideoDuration(beat.duration), ratio: "16:9" },
       cacheKey: cache.key,
       canonicalPath: rel,
@@ -61767,12 +62281,12 @@ async function dispatchVideo(beat, ctx, keyframe) {
       type: "video-generated",
       beatId: beat.id,
       path: rel,
-      provider: result.provider ?? ctx.videoProvider
+      provider: result.provider ?? activeProvider
     });
     return {
       status: "generated",
       path: rel,
-      provider: result.provider ?? ctx.videoProvider,
+      provider: result.provider ?? activeProvider,
       cachePath: cache.path,
       cacheKey: cache.key,
       metadataPath,
@@ -61781,7 +62295,7 @@ async function dispatchVideo(beat, ctx, keyframe) {
   }
   const job = await createAndWriteJobRecord({
     jobType: "generate-video",
-    provider: result.provider ?? ctx.videoProvider,
+    provider: result.provider ?? activeProvider,
     providerTaskId: result.taskId,
     providerTaskType: keyframeImageAbs ? "image2video" : "text2video",
     status: "running",
@@ -61817,7 +62331,7 @@ async function dispatchMusic(beat, ctx) {
   const prompt3 = stringOrUndefined4(beat.cues?.music);
   if (!prompt3) return { status: "no-cue" };
   const rel = `assets/music-${beat.id}.mp3`;
-  const abs = join27(ctx.projectDir, rel);
+  const abs = join28(ctx.projectDir, rel);
   const duration = normalizeMusicDuration(beat.duration);
   const cache = musicCacheDescriptor({
     beatId: beat.id,
@@ -61826,7 +62340,7 @@ async function dispatchMusic(beat, ctx) {
     duration
   });
   const metadataPath = assetMetadataPath("music", beat.id);
-  if (existsSync50(abs) && !ctx.force) {
+  if (existsSync51(abs) && !ctx.force) {
     const metadata = readAssetMetadata(ctx.projectDir, "music", beat.id);
     if (!metadata || isFreshCanonicalAsset({
       projectDir: ctx.projectDir,
@@ -61850,9 +62364,9 @@ async function dispatchMusic(beat, ctx) {
       };
     }
   }
-  const cacheAbs = join27(ctx.projectDir, cache.path);
-  if (existsSync50(cacheAbs) && !ctx.force) {
-    await mkdir25(dirname21(abs), { recursive: true });
+  const cacheAbs = join28(ctx.projectDir, cache.path);
+  if (existsSync51(cacheAbs) && !ctx.force) {
+    await mkdir26(dirname22(abs), { recursive: true });
     await copyFile5(cacheAbs, abs);
     await writeAssetMetadata({
       projectDir: ctx.projectDir,
@@ -61925,12 +62439,12 @@ async function dispatchMusic(beat, ctx) {
       metadataPath
     };
   }
-  if (!existsSync50(abs)) {
+  if (!existsSync51(abs)) {
     const error = result.outputPath ? `music output was not written at ${abs}` : "music generation did not return an output file";
     ctx.onProgress({ type: "music-failed", beatId: beat.id, error });
     return { status: "failed", error };
   }
-  await mkdir25(dirname21(cacheAbs), { recursive: true });
+  await mkdir26(dirname22(cacheAbs), { recursive: true });
   await copyFile5(abs, cacheAbs);
   await writeAssetMetadata({
     projectDir: ctx.projectDir,
@@ -61961,15 +62475,15 @@ async function dispatchMusic(beat, ctx) {
   };
 }
 function loadSceneBuildEnv(projectDir) {
-  (0, import_dotenv4.config)({ path: join27(projectDir, ".env"), quiet: true });
-  (0, import_dotenv4.config)({ path: resolve62(process.cwd(), ".env"), quiet: true });
+  (0, import_dotenv4.config)({ path: join28(projectDir, ".env"), quiet: true });
+  (0, import_dotenv4.config)({ path: resolve63(process.cwd(), ".env"), quiet: true });
   let dir = process.cwd();
-  while (dir !== dirname21(dir)) {
-    if (existsSync50(join27(dir, "pnpm-workspace.yaml"))) {
-      (0, import_dotenv4.config)({ path: join27(dir, ".env"), quiet: true });
+  while (dir !== dirname22(dir)) {
+    if (existsSync51(join28(dir, "pnpm-workspace.yaml"))) {
+      (0, import_dotenv4.config)({ path: join28(dir, ".env"), quiet: true });
       return;
     }
-    dir = dirname21(dir);
+    dir = dirname22(dir);
   }
 }
 async function skipped(kind, beatId, reason, ctx) {
@@ -62183,7 +62697,7 @@ function mergeBeatOutcomes(base, updates) {
 }
 function firstExisting3(projectDir, relPaths) {
   for (const rel of relPaths) {
-    if (existsSync50(join27(projectDir, rel))) return rel;
+    if (existsSync51(join28(projectDir, rel))) return rel;
   }
   return null;
 }
@@ -62206,6 +62720,9 @@ function resolveBuildMusicProvider(value) {
   const provider = String(value ?? "elevenlabs").toLowerCase();
   return provider === "replicate" ? "replicate" : "elevenlabs";
 }
+function isLikenessRejection(error) {
+  return typeof error === "string" && /likeness(es)? of real people/i.test(error);
+}
 function stringOrUndefined4(value) {
   return typeof value === "string" && value.trim().length > 0 ? value : void 0;
 }
@@ -62214,7 +62731,7 @@ async function apiKeyForVideoProvider(provider, projectDir) {
   return getApiKeyFromConfig(providerKey, { cwd: projectDir });
 }
 async function finalizeBuildResult(projectDir, startedAt, result, reportResult = result) {
-  const reportPath = join27(projectDir, "build-report.json");
+  const reportPath = join28(projectDir, "build-report.json");
   for (const source of /* @__PURE__ */ new Set([result, reportResult])) {
     if (source.stageReports) {
       for (const report of Object.values(source.stageReports)) {
@@ -62234,7 +62751,7 @@ async function finalizeBuildResult(projectDir, startedAt, result, reportResult =
   const withMeta = decorate(result);
   const reportMeta = reportResult === result ? withMeta : decorate(reportResult);
   try {
-    await writeFile45(
+    await writeFile46(
       reportPath,
       JSON.stringify(toBuildReport(projectDir, reportMeta), null, 2) + "\n",
       "utf-8"
@@ -62377,7 +62894,7 @@ function normalizeReportDuration(value) {
 }
 function buildReportComposition(projectDir, result, beatId) {
   const path2 = `compositions/scene-${beatId}.html`;
-  const exists = existsSync50(join27(projectDir, path2));
+  const exists = existsSync51(join28(projectDir, path2));
   if (result.stageReports?.compose.status === "failed") return { path: path2, exists, status: "failed" };
   if (result.phase === "needs-author" && !exists) return { path: path2, exists, status: "needs-author" };
   if (exists) return { path: path2, exists, status: "exists" };
@@ -62424,8 +62941,8 @@ function summarizeBuildBeats(projectDir, beats) {
   let compositionsReady = 0;
   for (const beat of beats) {
     if (beatAssetsReady(beat)) assetsReady += 1;
-    const compositionPath = join27(projectDir, "compositions", `scene-${beat.beatId}.html`);
-    if (existsSync50(compositionPath)) {
+    const compositionPath = join28(projectDir, "compositions", `scene-${beat.beatId}.html`);
+    if (existsSync51(compositionPath)) {
       compositionsReady += 1;
     } else {
       needsAuthor.push(beat.beatId);
@@ -62465,6 +62982,7 @@ var init_scene_build = __esm({
     init_ffmpeg_gate();
     init_concurrency();
     init_compose_aivideo();
+    init_footage_assemble();
     init_scene_project();
     init_compose_prompts();
     init_config();
@@ -62560,16 +63078,16 @@ __export(ai_audio_exports, {
   executeTranscribe: () => executeTranscribe,
   executeVoiceClone: () => executeVoiceClone
 });
-import { resolve as resolve72, dirname as dirname23, basename as basename22, extname as extname14 } from "node:path";
-import { readFile as readFile46, writeFile as writeFile46 } from "node:fs/promises";
-import { existsSync as existsSync55 } from "node:fs";
+import { resolve as resolve73, dirname as dirname24, basename as basename22, extname as extname14 } from "node:path";
+import { readFile as readFile46, writeFile as writeFile47 } from "node:fs/promises";
+import { existsSync as existsSync56 } from "node:fs";
 async function executeTranscribe(options) {
   const { audioPath, language, output, format, apiKey } = options;
   try {
     const key = apiKey || process.env.OPENAI_API_KEY;
     if (!key) return { success: false, error: "OPENAI_API_KEY required" };
-    const absPath = resolve72(process.cwd(), audioPath);
-    if (!existsSync55(absPath)) return { success: false, error: `File not found: ${absPath}` };
+    const absPath = resolve73(process.cwd(), audioPath);
+    if (!existsSync56(absPath)) return { success: false, error: `File not found: ${absPath}` };
     const whisper = new WhisperProvider();
     await whisper.initialize({ apiKey: key });
     const audioBuffer = await readFile46(absPath);
@@ -62580,10 +63098,10 @@ async function executeTranscribe(options) {
     }
     let outputPath;
     if (output) {
-      outputPath = resolve72(process.cwd(), output);
+      outputPath = resolve73(process.cwd(), output);
       const fmt = detectFormat(output, format);
       const content = formatTranscript(result, fmt);
-      await writeFile46(outputPath, content, "utf-8");
+      await writeFile47(outputPath, content, "utf-8");
     }
     return {
       success: true,
@@ -62601,8 +63119,8 @@ async function executeIsolate(options) {
   try {
     const key = apiKey || process.env.ELEVENLABS_API_KEY;
     if (!key) return { success: false, error: "ELEVENLABS_API_KEY required" };
-    const absPath = resolve72(process.cwd(), audioPath);
-    if (!existsSync55(absPath)) return { success: false, error: `File not found: ${absPath}` };
+    const absPath = resolve73(process.cwd(), audioPath);
+    if (!existsSync56(absPath)) return { success: false, error: `File not found: ${absPath}` };
     const audioBuffer = await readFile46(absPath);
     const elevenlabs = new ElevenLabsProvider();
     await elevenlabs.initialize({ apiKey: key });
@@ -62610,8 +63128,8 @@ async function executeIsolate(options) {
     if (!result.success || !result.audioBuffer) {
       return { success: false, error: result.error || "Audio isolation failed" };
     }
-    const outputPath = resolve72(process.cwd(), output);
-    await writeFile46(outputPath, result.audioBuffer);
+    const outputPath = resolve73(process.cwd(), output);
+    await writeFile47(outputPath, result.audioBuffer);
     return { success: true, outputPath };
   } catch (error) {
     return { success: false, error: `Audio isolation failed: ${error instanceof Error ? error.message : String(error)}` };
@@ -62627,8 +63145,8 @@ async function executeVoiceClone(options) {
     }
     const audioBuffers = [];
     for (const samplePath of samplePaths) {
-      const absPath = resolve72(process.cwd(), samplePath);
-      if (!existsSync55(absPath)) return { success: false, error: `File not found: ${samplePath}` };
+      const absPath = resolve73(process.cwd(), samplePath);
+      if (!existsSync56(absPath)) return { success: false, error: `File not found: ${samplePath}` };
       const buffer = await readFile46(absPath);
       audioBuffers.push(buffer);
     }
@@ -62649,8 +63167,8 @@ async function executeVoiceClone(options) {
 async function executeDub(options) {
   const { mediaPath, language, source, voice, analyzeOnly, output } = options;
   try {
-    const absPath = resolve72(process.cwd(), mediaPath);
-    if (!existsSync55(absPath)) return { success: false, error: `File not found: ${absPath}` };
+    const absPath = resolve73(process.cwd(), mediaPath);
+    if (!existsSync56(absPath)) return { success: false, error: `File not found: ${absPath}` };
     const openaiKey = process.env.OPENAI_API_KEY;
     const anthropicKey = process.env.ANTHROPIC_API_KEY;
     const elevenlabsKey = process.env.ELEVENLABS_API_KEY;
@@ -62661,7 +63179,7 @@ async function executeDub(options) {
     const isVideo = [".mp4", ".mov", ".avi", ".mkv", ".webm"].includes(ext);
     let audioPath = absPath;
     if (isVideo) {
-      const tempAudioPath = resolve72(dirname23(absPath), `temp-audio-${Date.now()}.mp3`);
+      const tempAudioPath = resolve73(dirname24(absPath), `temp-audio-${Date.now()}.mp3`);
       execSafeSync("ffmpeg", ["-i", absPath, "-vn", "-acodec", "mp3", "-y", tempAudioPath]);
       audioPath = tempAudioPath;
     }
@@ -62710,7 +63228,7 @@ ${segmentTexts}`,
     }
     if (analyzeOnly) {
       if (output) {
-        const timingPath = resolve72(process.cwd(), output);
+        const timingPath = resolve73(process.cwd(), output);
         const timingData = {
           sourcePath: absPath,
           sourceLanguage: transcriptResult.detectedLanguage || source || "auto",
@@ -62722,14 +63240,14 @@ ${segmentTexts}`,
             translated: translatedSegments[i]?.text || s.text
           }))
         };
-        await writeFile46(timingPath, JSON.stringify(timingData, null, 2));
+        await writeFile47(timingPath, JSON.stringify(timingData, null, 2));
       }
       return {
         success: true,
         sourceLanguage: transcriptResult.detectedLanguage || source || "auto",
         targetLanguage: language,
         segmentCount: segments.length,
-        outputPath: output ? resolve72(process.cwd(), output) : void 0
+        outputPath: output ? resolve73(process.cwd(), output) : void 0
       };
     }
     const elevenlabs = new ElevenLabsProvider();
@@ -62743,9 +63261,9 @@ ${segmentTexts}`,
     }
     const combinedBuffer = Buffer.concat(dubbedBuffers);
     const outputExt = isVideo ? ".mp3" : extname14(absPath);
-    const defaultOutputPath2 = resolve72(dirname23(absPath), `${basename22(absPath, extname14(absPath))}-${language}${outputExt}`);
-    const finalOutputPath = resolve72(process.cwd(), output || defaultOutputPath2);
-    await writeFile46(finalOutputPath, combinedBuffer);
+    const defaultOutputPath2 = resolve73(dirname24(absPath), `${basename22(absPath, extname14(absPath))}-${language}${outputExt}`);
+    const finalOutputPath = resolve73(process.cwd(), output || defaultOutputPath2);
+    await writeFile47(finalOutputPath, combinedBuffer);
     if (isVideo && audioPath !== absPath) {
       try {
         const { unlink: unlink3 } = await import("node:fs/promises");
@@ -62776,12 +63294,12 @@ async function executeDuck(options) {
   } = options;
   try {
     if (!commandExists("ffmpeg")) return { success: false, error: "FFmpeg not found" };
-    const absMusicPath = resolve72(process.cwd(), musicPath);
-    const absVoicePath = resolve72(process.cwd(), voicePath);
-    if (!existsSync55(absMusicPath)) return { success: false, error: `Music file not found: ${absMusicPath}` };
-    if (!existsSync55(absVoicePath)) return { success: false, error: `Voice file not found: ${absVoicePath}` };
-    const defaultOutput = resolve72(dirname23(absMusicPath), `${basename22(absMusicPath, extname14(absMusicPath))}-ducked${extname14(absMusicPath)}`);
-    const outputPath = resolve72(process.cwd(), output || defaultOutput);
+    const absMusicPath = resolve73(process.cwd(), musicPath);
+    const absVoicePath = resolve73(process.cwd(), voicePath);
+    if (!existsSync56(absMusicPath)) return { success: false, error: `Music file not found: ${absMusicPath}` };
+    if (!existsSync56(absVoicePath)) return { success: false, error: `Voice file not found: ${absVoicePath}` };
+    const defaultOutput = resolve73(dirname24(absMusicPath), `${basename22(absMusicPath, extname14(absMusicPath))}-ducked${extname14(absMusicPath)}`);
+    const outputPath = resolve73(process.cwd(), output || defaultOutput);
     const filter = `[1:a]asplit=2[sc][mix];[0:a][sc]sidechaincompress=threshold=${threshold}dB:ratio=${ratio}:attack=${attack}:release=${release}[ducked];[ducked][mix]amix=inputs=2:duration=longest`;
     await execSafe("ffmpeg", [
       "-i",
@@ -62793,7 +63311,7 @@ async function executeDuck(options) {
       "-y",
       outputPath
     ], { timeout: 12e4, maxBuffer: 50 * 1024 * 1024 });
-    if (!existsSync55(outputPath)) return { success: false, error: "FFmpeg failed to create output" };
+    if (!existsSync56(outputPath)) return { success: false, error: "FFmpeg failed to create output" };
     return { success: true, outputPath };
   } catch (error) {
     return { success: false, error: `Audio ducking failed: ${error instanceof Error ? error.message : String(error)}` };
@@ -62809,9 +63327,9 @@ var init_ai_audio = __esm({
 });
 
 // src/pipeline/executor.ts
-import { resolve as resolve73 } from "node:path";
-import { readFile as readFile47, writeFile as writeFile47, mkdir as mkdir27 } from "node:fs/promises";
-import { existsSync as existsSync56 } from "node:fs";
+import { resolve as resolve74 } from "node:path";
+import { readFile as readFile47, writeFile as writeFile48, mkdir as mkdir28 } from "node:fs/promises";
+import { existsSync as existsSync57 } from "node:fs";
 function maxCostFor(action) {
   const cmd = ACTION_METADATA[action]?.command;
   if (!cmd) return 0;
@@ -62822,9 +63340,9 @@ function registerAction(action, handler) {
 }
 function getOutput(params, outputDir, defaultName) {
   if (params.output && typeof params.output === "string") {
-    return resolve73(outputDir, params.output);
+    return resolve74(outputDir, params.output);
   }
-  return resolve73(outputDir, defaultName);
+  return resolve74(outputDir, defaultName);
 }
 function stringParam(value) {
   return typeof value === "string" && value.trim() !== "" ? value : void 0;
@@ -63054,7 +63572,7 @@ async function ensureActionsRegistered() {
     const { executeSceneBuild: executeSceneBuild2 } = await Promise.resolve().then(() => (init_scene_build(), scene_build_exports));
     const projectRel = params.project ?? ".";
     const r = await executeSceneBuild2({
-      projectDir: resolve73(outputDir, projectRel),
+      projectDir: resolve74(outputDir, projectRel),
       mode: params.mode,
       composer: params.composer,
       skipNarration: params.skipNarration,
@@ -63064,6 +63582,7 @@ async function ensureActionsRegistered() {
       voice: params.voice,
       imageProvider: params.imageProvider,
       imageQuality: params.quality,
+      imageModel: params.imageModel,
       force: params.force
     });
     return {
@@ -63079,7 +63598,7 @@ async function ensureActionsRegistered() {
     const { executeSceneRender: executeSceneRender2 } = await Promise.resolve().then(() => (init_scene_render(), scene_render_exports));
     const projectRel = params.project ?? ".";
     const r = await executeSceneRender2({
-      projectDir: resolve73(outputDir, projectRel),
+      projectDir: resolve74(outputDir, projectRel),
       root: params.root,
       output: params.output,
       fps: params.fps,
@@ -63103,8 +63622,8 @@ async function ensureActionsRegistered() {
   });
 }
 async function loadPipeline(filePath) {
-  const absPath = resolve73(process.cwd(), filePath);
-  if (!existsSync56(absPath)) {
+  const absPath = resolve74(process.cwd(), filePath);
+  if (!existsSync57(absPath)) {
     throw new Error(`Pipeline file not found: ${absPath}`);
   }
   const content = await readFile47(absPath, "utf-8");
@@ -63122,14 +63641,14 @@ async function loadPipeline(filePath) {
 }
 async function executePipeline(manifest2, options = {}) {
   await ensureActionsRegistered();
-  const outputDir = resolve73(process.cwd(), options.outputDir || `${manifest2.name}-output`);
-  await mkdir27(outputDir, { recursive: true });
+  const outputDir = resolve74(process.cwd(), options.outputDir || `${manifest2.name}-output`);
+  await mkdir28(outputDir, { recursive: true });
   const completedSteps = /* @__PURE__ */ new Map();
   const results = [];
   const startTime = Date.now();
   if (options.resume) {
-    const checkpointPath = resolve73(outputDir, CHECKPOINT_FILE);
-    if (existsSync56(checkpointPath)) {
+    const checkpointPath = resolve74(outputDir, CHECKPOINT_FILE);
+    if (existsSync57(checkpointPath)) {
       const checkpointContent = await readFile47(checkpointPath, "utf-8");
       const checkpoint = (0, import_yaml8.parse)(checkpointContent);
       for (const cs of checkpoint.completedSteps) {
@@ -63248,8 +63767,8 @@ async function executePipeline(manifest2, options = {}) {
           data: s.data
         }))
       };
-      await writeFile47(
-        resolve73(outputDir, CHECKPOINT_FILE),
+      await writeFile48(
+        resolve74(outputDir, CHECKPOINT_FILE),
         (0, import_yaml8.stringify)(checkpoint, { indent: 2 }),
         "utf-8"
       );
@@ -67717,7 +68236,7 @@ var init_elicit = __esm({
 });
 
 // src/tools/manifest/scene.ts
-import { resolve as resolve74, relative as relative11 } from "node:path";
+import { resolve as resolve75, relative as relative11 } from "node:path";
 function summariseLint(result) {
   return {
     ok: result.ok,
@@ -67952,7 +68471,7 @@ var init_scene2 = __esm({
       description: "Scaffold a new VibeFrame video scene project. Supports minimal, agent, and full profiles; full includes the current HTML render backend metadata. Idempotent: re-running keeps user-authored files and merges backend config instead of overwriting. No API keys required.",
       schema: sceneInitSchema,
       async execute(args, ctx) {
-        const dir = resolve74(ctx.workingDirectory, args.dir);
+        const dir = resolve75(ctx.workingDirectory, args.dir);
         const result = await scaffoldSceneProject({
           dir,
           name: args.name,
@@ -68007,7 +68526,7 @@ var init_scene2 = __esm({
       description: "Add a single scene to an existing scene project. Optionally generates narration audio (ElevenLabs) and/or a backdrop image (Gemini/OpenAI), then emits compositions/scene-<id>.html with a paused GSAP timeline. By default, syncs STORYBOARD.md and rebuilds root refs from it; set syncStoryboard:false for root-only insertion. Use skipAudio:true and skipImage:true for text-only scenes that need no API calls.",
       schema: sceneAddSchema,
       async execute(args, ctx) {
-        const projectDir = args.projectDir ? resolve74(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
+        const projectDir = args.projectDir ? resolve75(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
         const result = await executeSceneAdd({
           name: args.name,
           preset: args.preset ?? "simple",
@@ -68073,7 +68592,7 @@ var init_scene2 = __esm({
       description: "Validate every scene file in a project against the public Hyperframes lint rules (in-process, no Chrome required). Returns errors, warnings, and info findings per file. Optional fix:true mechanically repairs `timed_element_missing_clip_class` only \u2014 other issues surface with fixHints.",
       schema: sceneLintSchema,
       async execute(args, ctx) {
-        const projectDir = args.projectDir ? resolve74(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
+        const projectDir = args.projectDir ? resolve75(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
         const result = await runProjectLint({
           projectDir,
           rootRel: args.root,
@@ -68112,7 +68631,7 @@ var init_scene2 = __esm({
       description: "Apply deterministic mechanical scene repairs. Currently uses the safe lint auto-fix allow-list and never performs semantic creative rewrites.",
       schema: sceneRepairSchema,
       async execute(args, ctx) {
-        const projectDir = args.projectDir ? resolve74(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
+        const projectDir = args.projectDir ? resolve75(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
         const result = await executeSceneRepair({
           projectDir,
           rootRel: args.root,
@@ -68150,7 +68669,7 @@ var init_scene2 = __esm({
       description: "Render a scene project to MP4/WebM/MOV via the Hyperframes producer. Requires Chrome installed locally. Output defaults to renders/<projectName>-<isoStamp>.<format>. Long runs: over MCP, calls exceeding ~45s return immediately with { promoted: true, jobId, status: 'running' } \u2014 poll status_job every 15-30s until completed/failed instead of re-invoking render. Emits MCP progress notifications when the client supplies a progressToken.",
       schema: sceneRenderSchema,
       async execute(args, ctx) {
-        const projectDir = args.projectDir ? resolve74(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
+        const projectDir = args.projectDir ? resolve75(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
         const runRender = (report) => executeSceneRender({
           projectDir,
           root: args.root,
@@ -68203,6 +68722,9 @@ var init_scene2 = __esm({
       videoProvider: external_exports.enum(["seedance", "grok", "kling", "runway", "veo"]).optional().describe("Video provider for per-beat video cues. Default seedance."),
       musicProvider: external_exports.enum(["elevenlabs", "replicate"]).optional().describe("Music provider for per-beat music cues. Default elevenlabs."),
       imageQuality: external_exports.enum(["standard", "hd"]).optional().describe("OpenAI image quality. Default 'standard'."),
+      imageModel: external_exports.string().optional().describe(
+        "Image model for keyframes/backdrops/character sheets (gemini: flash|pro, openai: gpt-image-2). Provider default when omitted."
+      ),
       imageSize: external_exports.enum(["1024x1024", "1536x1024", "1024x1536"]).optional().describe("OpenAI image size. Default '1536x1024' (cinematic 16:9-ish)."),
       maxCostUsd: external_exports.number().optional().describe("Fail before provider spend when estimated cost exceeds this USD cap."),
       force: external_exports.boolean().optional().describe("Re-dispatch primitives even when cached assets exist.")
@@ -68239,7 +68761,7 @@ var init_scene2 = __esm({
             }
           }
         }
-        const projectDir = args.projectDir ? resolve74(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
+        const projectDir = args.projectDir ? resolve75(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
         const runBuild = (report) => executeSceneBuild({
           projectDir,
           stage: args.stage,
@@ -68257,6 +68779,7 @@ var init_scene2 = __esm({
           videoProvider: args.videoProvider,
           musicProvider: args.musicProvider,
           imageQuality: args.imageQuality,
+          imageModel: args.imageModel,
           imageSize: args.imageSize,
           maxCostUsd: args.maxCostUsd,
           force: args.force,
@@ -68295,7 +68818,7 @@ var init_scene2 = __esm({
       description: "Install the Hyperframes composition rules into a scene project by running upstream's installer (`npx skills add heygen-com/hyperframes`). Lands at .agents/skills/hyperframes/ and is picked up by ~19 agents, with symlinks for the ones that want their own directory. Skips when the rules are already available in the project or globally unless force is set. Needs network access. Build and render do not read these files - they exist so you can read the rules while authoring scene HTML.",
       schema: sceneInstallSkillSchema,
       async execute(args, ctx) {
-        const projectDir = resolve74(ctx.workingDirectory, args.projectDir);
+        const projectDir = resolve75(ctx.workingDirectory, args.projectDir);
         const result = await installHyperframesSkill({
           projectDir,
           global: args.global ?? false,
@@ -68340,7 +68863,7 @@ var init_scene2 = __esm({
       description: "Emit the per-beat compose plan for the host agent to author scene HTML itself. Reads STORYBOARD.md + DESIGN.md and returns each beat's outputPath + userPrompt + cues + body, plus the path to the Hyperframes rules (skillReference) and DESIGN.md (visual identity). The host agent writes each compositions/scene-<id>.html file directly \u2014 VibeFrame makes NO LLM call here, and there is no internal-LLM fallback: authoring is always the host agent's job. Hosts that cannot write files (e.g. Claude Desktop) submit each authored beat with scene_submit instead. Pairs with scene_install_skill, which fetches the rules from upstream when the agent does not already have them.",
       schema: sceneComposePromptsSchema,
       async execute(args, ctx) {
-        const projectDir = resolve74(ctx.workingDirectory, args.projectDir);
+        const projectDir = resolve75(ctx.workingDirectory, args.projectDir);
         const result = await getComposePrompts({
           projectDir,
           beatId: args.beat
@@ -68384,7 +68907,7 @@ var init_scene2 = __esm({
       description: "Submit host-authored Hyperframes scene HTML for one beat. Validates with the same lint as the batch composer and writes compositions/scene-<id>.html on pass; on lint errors it returns the findings WITHOUT writing so you can fix and resubmit. This completes agent-mode compose for hosts that cannot write files (e.g. Claude Desktop): build (mode agent) \u2192 needs-author plan \u2192 author each beat from its composePrompts userPrompt \u2192 scene_submit per beat \u2192 build (stage sync) \u2192 render. No internal LLM call \u2014 the submitting agent is the composer.",
       schema: sceneSubmitSchema,
       async execute(args, ctx) {
-        const projectDir = args.projectDir ? resolve74(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
+        const projectDir = args.projectDir ? resolve75(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
         const result = await executeSceneSubmit({
           projectDir,
           beatId: args.beat,
@@ -69047,13 +69570,13 @@ var init_edit = __esm({
 });
 
 // src/commands/ai-suggest-edit.ts
-import { readFile as readFile48, writeFile as writeFile48 } from "node:fs/promises";
-import { resolve as resolve75 } from "node:path";
+import { readFile as readFile48, writeFile as writeFile49 } from "node:fs/promises";
+import { resolve as resolve76 } from "node:path";
 async function executeSuggestEdit(options) {
   try {
     const apiKey = options.apiKey ?? process.env.GOOGLE_API_KEY;
     if (!apiKey) return { success: false, error: "GOOGLE_API_KEY required for suggest" };
-    const filePath = resolve75(process.cwd(), options.projectPath);
+    const filePath = resolve76(process.cwd(), options.projectPath);
     const content = await readFile48(filePath, "utf-8");
     const data = JSON.parse(content);
     const project = Project.fromJSON(data);
@@ -69065,7 +69588,7 @@ async function executeSuggestEdit(options) {
       const first = suggestions[0];
       const applied = applySuggestion(project, first);
       if (applied) {
-        await writeFile48(filePath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
+        await writeFile49(filePath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
         return {
           success: true,
           suggestions,
@@ -69094,7 +69617,7 @@ var init_ai_suggest_edit = __esm({
 });
 
 // src/tools/manifest/inspect.ts
-import { resolve as resolve76 } from "node:path";
+import { resolve as resolve77 } from "node:path";
 var PROJECT_DIR_DESCRIPTION2, inspectProjectTool, inspectRenderTool, analyzeMediaTool, analyzeSuggestTool, inspectTools;
 var init_inspect = __esm({
   "src/tools/manifest/inspect.ts"() {
@@ -69120,11 +69643,11 @@ var init_inspect = __esm({
         report: external_exports.boolean().optional().describe("Write review-report.json. Default true.")
       }),
       async execute(args, ctx) {
-        const projectDir = args.projectDir ? resolve76(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
+        const projectDir = args.projectDir ? resolve77(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
         const result = await inspectProject({
           projectDir,
           beatId: args.beat,
-          outputPath: args.outputPath ? resolve76(ctx.workingDirectory, args.outputPath) : void 0,
+          outputPath: args.outputPath ? resolve77(ctx.workingDirectory, args.outputPath) : void 0,
           writeReport: args.report !== false
         });
         return {
@@ -69160,13 +69683,13 @@ var init_inspect = __esm({
         dryRun: external_exports.boolean().optional().describe("Preview resolved inputs without probing video or calling Gemini.")
       }),
       async execute(args, ctx) {
-        const projectDir = args.projectDir ? resolve76(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
+        const projectDir = args.projectDir ? resolve77(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
         if (args.dryRun) {
           const result2 = await previewInspectRender({
             projectDir,
             beatId: args.beat,
-            videoPath: args.videoPath ? resolve76(ctx.workingDirectory, args.videoPath) : void 0,
-            outputPath: args.outputPath ? resolve76(ctx.workingDirectory, args.outputPath) : void 0,
+            videoPath: args.videoPath ? resolve77(ctx.workingDirectory, args.videoPath) : void 0,
+            outputPath: args.outputPath ? resolve77(ctx.workingDirectory, args.outputPath) : void 0,
             writeReport: args.report !== false,
             ai: args.ai === true,
             model: args.model
@@ -69187,8 +69710,8 @@ var init_inspect = __esm({
         const result = await inspectRender({
           projectDir,
           beatId: args.beat,
-          videoPath: args.videoPath ? resolve76(ctx.workingDirectory, args.videoPath) : void 0,
-          outputPath: args.outputPath ? resolve76(ctx.workingDirectory, args.outputPath) : void 0,
+          videoPath: args.videoPath ? resolve77(ctx.workingDirectory, args.videoPath) : void 0,
+          outputPath: args.outputPath ? resolve77(ctx.workingDirectory, args.outputPath) : void 0,
           writeReport: args.report !== false,
           ai: args.ai === true,
           model: args.model
@@ -69621,12 +70144,12 @@ var init_generate2 = __esm({
 });
 
 // src/tools/manifest/storyboard.ts
-import { existsSync as existsSync57 } from "node:fs";
-import { readFile as readFile49, writeFile as writeFile49 } from "node:fs/promises";
-import { resolve as resolve77 } from "node:path";
+import { existsSync as existsSync58 } from "node:fs";
+import { readFile as readFile49, writeFile as writeFile50 } from "node:fs/promises";
+import { resolve as resolve78 } from "node:path";
 async function readStoryboard2(projectDir) {
-  const path2 = resolve77(projectDir, "STORYBOARD.md");
-  if (!existsSync57(path2)) return null;
+  const path2 = resolve78(projectDir, "STORYBOARD.md");
+  if (!existsSync58(path2)) return null;
   return { path: path2, markdown: await readFile49(path2, "utf-8") };
 }
 var PROJECT_DIR_DESCRIPTION3, projectDirSchema, storyboardListTool, storyboardValidateTool, storyboardGetTool, storyboardSetTool, storyboardMoveTool, storyboardReviseTool, planTool, storyboardTools;
@@ -69652,7 +70175,7 @@ var init_storyboard2 = __esm({
       description: "List beats, ids, durations, and cue blocks from a project's STORYBOARD.md.",
       schema: projectDirSchema,
       async execute(args, ctx) {
-        const projectDir = args.projectDir ? resolve77(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
+        const projectDir = args.projectDir ? resolve78(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
         const file = await readStoryboard2(projectDir);
         if (!file) return { success: false, error: `STORYBOARD.md not found in ${projectDir}` };
         const parsed = parseStoryboard(file.markdown);
@@ -69680,7 +70203,7 @@ var init_storyboard2 = __esm({
       description: "Validate STORYBOARD.md beat ids and cue blocks.",
       schema: projectDirSchema,
       async execute(args, ctx) {
-        const projectDir = args.projectDir ? resolve77(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
+        const projectDir = args.projectDir ? resolve78(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
         const file = await readStoryboard2(projectDir);
         if (!file) return { success: false, error: `STORYBOARD.md not found in ${projectDir}` };
         const result = validateStoryboardMarkdown(file.markdown);
@@ -69715,7 +70238,7 @@ var init_storyboard2 = __esm({
         beat: external_exports.string().describe("Beat id to return.")
       }),
       async execute(args, ctx) {
-        const projectDir = args.projectDir ? resolve77(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
+        const projectDir = args.projectDir ? resolve78(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
         const file = await readStoryboard2(projectDir);
         if (!file) return { success: false, error: `STORYBOARD.md not found in ${projectDir}` };
         const beat = getStoryboardBeat(file.markdown, args.beat);
@@ -69743,7 +70266,7 @@ var init_storyboard2 = __esm({
         unset: external_exports.boolean().optional().describe("Remove the cue key.")
       }),
       async execute(args, ctx) {
-        const projectDir = args.projectDir ? resolve77(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
+        const projectDir = args.projectDir ? resolve78(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
         const file = await readStoryboard2(projectDir);
         if (!file) return { success: false, error: `STORYBOARD.md not found in ${projectDir}` };
         try {
@@ -69754,7 +70277,7 @@ var init_storyboard2 = __esm({
             value,
             unset: args.unset
           });
-          await writeFile49(file.path, next, "utf-8");
+          await writeFile50(file.path, next, "utf-8");
           return {
             success: true,
             data: { beat: args.beat, key: args.key },
@@ -69778,7 +70301,7 @@ var init_storyboard2 = __esm({
         after: external_exports.string().describe("Beat id that should precede the moved beat.")
       }),
       async execute(args, ctx) {
-        const projectDir = args.projectDir ? resolve77(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
+        const projectDir = args.projectDir ? resolve78(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
         const file = await readStoryboard2(projectDir);
         if (!file) return { success: false, error: `STORYBOARD.md not found in ${projectDir}` };
         try {
@@ -69786,7 +70309,7 @@ var init_storyboard2 = __esm({
             beatId: args.beat,
             afterBeatId: args.after
           });
-          await writeFile49(file.path, next, "utf-8");
+          await writeFile50(file.path, next, "utf-8");
           return {
             success: true,
             data: { beat: args.beat, after: args.after },
@@ -69812,7 +70335,7 @@ var init_storyboard2 = __esm({
         dryRun: external_exports.boolean().optional().describe("Preview the revised storyboard without writing.")
       }),
       async execute(args, ctx) {
-        const projectDir = args.projectDir ? resolve77(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
+        const projectDir = args.projectDir ? resolve78(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
         const result = await executeStoryboardRevision({
           projectDir,
           request: args.request,
@@ -69857,7 +70380,7 @@ var init_storyboard2 = __esm({
         force: external_exports.boolean().optional().describe("Plan regeneration even when outputs exist.")
       }),
       async execute(args, ctx) {
-        const projectDir = args.projectDir ? resolve77(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
+        const projectDir = args.projectDir ? resolve78(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
         const plan = await createBuildPlan({
           projectDir,
           stage: args.stage,
@@ -69900,9 +70423,9 @@ var init_storyboard2 = __esm({
 });
 
 // src/tools/manifest/design.ts
-import { existsSync as existsSync58 } from "node:fs";
+import { existsSync as existsSync59 } from "node:fs";
 import { readFile as readFile50 } from "node:fs/promises";
-import { resolve as resolve78, join as join29 } from "node:path";
+import { resolve as resolve79, join as join30 } from "node:path";
 var PROJECT_DIR_DESCRIPTION4, projectDirSchema2, designValidateTool, designTools;
 var init_design = __esm({
   "src/tools/manifest/design.ts"() {
@@ -69923,9 +70446,9 @@ var init_design = __esm({
       description: "Validate DESIGN.md front-matter color/typography tokens and sections (google-labs design.md format).",
       schema: projectDirSchema2,
       async execute(args, ctx) {
-        const projectDir = args.projectDir ? resolve78(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
-        const path2 = join29(projectDir, "DESIGN.md");
-        if (!existsSync58(path2)) return { success: false, error: `DESIGN.md not found in ${projectDir}` };
+        const projectDir = args.projectDir ? resolve79(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
+        const path2 = join30(projectDir, "DESIGN.md");
+        if (!existsSync59(path2)) return { success: false, error: `DESIGN.md not found in ${projectDir}` };
         const md = await readFile50(path2, "utf-8");
         const issues = validateDesignMarkdown(md);
         const design = parseDesign(md);
@@ -69949,9 +70472,9 @@ var init_design = __esm({
 });
 
 // src/tools/manifest/remix.ts
-import { writeFile as writeFile50 } from "node:fs/promises";
+import { writeFile as writeFile51 } from "node:fs/promises";
 import { tmpdir as tmpdir4 } from "node:os";
-import { join as join30 } from "node:path";
+import { join as join31 } from "node:path";
 var pipelineHighlightsTool, pipelineAutoShortsTool, pipelineRunTool, remixTools;
 var init_remix = __esm({
   "src/tools/manifest/remix.ts"() {
@@ -70064,8 +70587,8 @@ var init_remix = __esm({
         let resolvedPath = args.pipelinePath;
         let tempPath;
         if (args.pipelineYaml) {
-          tempPath = join30(tmpdir4(), `vibe-mcp-pipeline-${Date.now()}.yaml`);
-          await writeFile50(tempPath, args.pipelineYaml, "utf-8");
+          tempPath = join31(tmpdir4(), `vibe-mcp-pipeline-${Date.now()}.yaml`);
+          await writeFile51(tempPath, args.pipelineYaml, "utf-8");
           resolvedPath = tempPath;
         }
         try {
@@ -70210,7 +70733,7 @@ var init_detect2 = __esm({
 });
 
 // src/tools/manifest/_project-io.ts
-import { readFile as readFile51, writeFile as writeFile51 } from "node:fs/promises";
+import { readFile as readFile51, writeFile as writeFile52 } from "node:fs/promises";
 async function loadProject2(projectPath, cwd) {
   const absPath = await resolveTimelineFile(projectPath, cwd);
   const content = await readFile51(absPath, "utf-8");
@@ -70218,7 +70741,7 @@ async function loadProject2(projectPath, cwd) {
   return { project: Project.fromJSON(data), absPath };
 }
 async function saveProject(absPath, project) {
-  await writeFile51(absPath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
+  await writeFile52(absPath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
 }
 var init_project_io = __esm({
   "src/tools/manifest/_project-io.ts"() {
@@ -70229,8 +70752,8 @@ var init_project_io = __esm({
 });
 
 // src/tools/manifest/timeline.ts
-import { mkdir as mkdir28, writeFile as writeFile52 } from "node:fs/promises";
-import { basename as basename23, resolve as resolve79 } from "node:path";
+import { mkdir as mkdir29, writeFile as writeFile53 } from "node:fs/promises";
+import { basename as basename23, resolve as resolve80 } from "node:path";
 var MEDIA_TYPES, timelineCreateTool, timelineInfoTool, timelineAddSourceTool, timelineAddClipTool, timelineSplitClipTool, timelineTrimClipTool, timelineMoveClipTool, timelineDeleteClipTool, timelineDuplicateClipTool, timelineAddEffectTool, timelineAddTrackTool, timelineListTool, timelineTools;
 var init_timeline = __esm({
   "src/tools/manifest/timeline.ts"() {
@@ -70268,18 +70791,18 @@ var init_timeline = __esm({
         fps: external_exports.number().optional().describe("Frames per second (default: 30)")
       }),
       async execute(args, ctx) {
-        const projectName = args.name === "." ? basename23(ctx.workingDirectory) : basename23(resolve79(ctx.workingDirectory, args.name));
+        const projectName = args.name === "." ? basename23(ctx.workingDirectory) : basename23(resolve80(ctx.workingDirectory, args.name));
         const project = new Project(projectName);
         if (args.fps) project.setFrameRate(args.fps);
         let outputPath;
         if (args.outputPath) {
-          outputPath = resolve79(ctx.workingDirectory, args.outputPath);
+          outputPath = resolve80(ctx.workingDirectory, args.outputPath);
         } else {
-          const dirPath = resolve79(ctx.workingDirectory, args.name);
-          await mkdir28(dirPath, { recursive: true });
-          outputPath = resolve79(dirPath, TIMELINE_FILENAME);
+          const dirPath = resolve80(ctx.workingDirectory, args.name);
+          await mkdir29(dirPath, { recursive: true });
+          outputPath = resolve80(dirPath, TIMELINE_FILENAME);
         }
-        await writeFile52(outputPath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
+        await writeFile53(outputPath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
         return {
           success: true,
           data: { name: projectName, outputPath },
@@ -70331,7 +70854,7 @@ var init_timeline = __esm({
       }),
       async execute(args, ctx) {
         const { project, absPath } = await loadProject2(args.projectPath, ctx.workingDirectory);
-        const mediaPath = resolve79(ctx.workingDirectory, args.mediaPath);
+        const mediaPath = resolve80(ctx.workingDirectory, args.mediaPath);
         const ext = mediaPath.split(".").pop()?.toLowerCase() ?? "";
         const source = project.addSource({
           name: args.name ?? mediaPath.split("/").pop() ?? "media",
@@ -70578,11 +71101,11 @@ var init_timeline = __esm({
 
 // src/commands/_shared/project-list.ts
 import { readdir as readdir8, readFile as readFile52, stat as stat9 } from "node:fs/promises";
-import { existsSync as existsSync59 } from "node:fs";
-import { join as join31, resolve as resolve80 } from "node:path";
+import { existsSync as existsSync60 } from "node:fs";
+import { join as join32, resolve as resolve81 } from "node:path";
 async function executeProjectList(opts = {}) {
-  const workspaceDir = resolve80(opts.workspaceDir ?? ".");
-  if (!existsSync59(workspaceDir)) {
+  const workspaceDir = resolve81(opts.workspaceDir ?? ".");
+  if (!existsSync60(workspaceDir)) {
     return {
       success: false,
       workspaceDir,
@@ -70599,11 +71122,11 @@ async function executeProjectList(opts = {}) {
     if (entry.name === "node_modules") continue;
     if (entry.name.startsWith(".")) continue;
     if (entry.name.startsWith("_")) {
-      archivedCount += await countProjects(join31(workspaceDir, entry.name));
+      archivedCount += await countProjects(join32(workspaceDir, entry.name));
       continue;
     }
-    const projectDir = join31(workspaceDir, entry.name);
-    if (!existsSync59(join31(projectDir, "STORYBOARD.md"))) continue;
+    const projectDir = join32(workspaceDir, entry.name);
+    if (!existsSync60(join32(projectDir, "STORYBOARD.md"))) continue;
     projects.push(await describeProject(entry.name, projectDir));
   }
   projects.sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
@@ -70613,7 +71136,7 @@ async function countProjects(dir) {
   try {
     const entries = await readdir8(dir, { withFileTypes: true });
     return entries.filter(
-      (e) => e.isDirectory() && existsSync59(join31(dir, e.name, "STORYBOARD.md"))
+      (e) => e.isDirectory() && existsSync60(join32(dir, e.name, "STORYBOARD.md"))
     ).length;
   } catch {
     return 0;
@@ -70624,7 +71147,7 @@ async function describeProject(name, projectDir) {
   let storyboardDurationSec = 0;
   const timestamps = [];
   try {
-    const storyboardPath2 = join31(projectDir, "STORYBOARD.md");
+    const storyboardPath2 = join32(projectDir, "STORYBOARD.md");
     const parsed = parseStoryboard(await loadStoryboardMarkdown(projectDir));
     beats = parsed.beats.length;
     storyboardDurationSec = Number(
@@ -70636,7 +71159,7 @@ async function describeProject(name, projectDir) {
   let buildStatus;
   let buildUpdatedAt;
   try {
-    const reportPath = join31(projectDir, "build-report.json");
+    const reportPath = join32(projectDir, "build-report.json");
     const report = JSON.parse(await readFile52(reportPath, "utf-8"));
     buildStatus = report.status ?? report.phase;
     buildUpdatedAt = report.updatedAt;
@@ -70645,12 +71168,12 @@ async function describeProject(name, projectDir) {
   }
   let latestRender;
   try {
-    const rendersDir = join31(projectDir, "renders");
+    const rendersDir = join32(projectDir, "renders");
     const files = await readdir8(rendersDir);
     let newest;
     for (const file of files) {
       if (!/\.(mp4|webm|mov)$/i.test(file)) continue;
-      const { mtimeMs } = await stat9(join31(rendersDir, file));
+      const { mtimeMs } = await stat9(join32(rendersDir, file));
       if (!newest || mtimeMs > newest.mtimeMs) newest = { file, mtimeMs };
     }
     if (newest) {
@@ -70682,8 +71205,8 @@ var init_project_list = __esm({
 });
 
 // src/tools/manifest/project.ts
-import { resolve as resolve81 } from "node:path";
-import { writeFile as writeFile53 } from "node:fs/promises";
+import { resolve as resolve82 } from "node:path";
+import { writeFile as writeFile54 } from "node:fs/promises";
 var projectListTool, projectCreateTool, projectInfoTool, projectTools;
 var init_project2 = __esm({
   "src/tools/manifest/project.ts"() {
@@ -70707,7 +71230,7 @@ var init_project2 = __esm({
       }),
       async execute(args, ctx) {
         const result = await executeProjectList({
-          workspaceDir: args.dir ? resolve81(ctx.workingDirectory, args.dir) : ctx.workingDirectory
+          workspaceDir: args.dir ? resolve82(ctx.workingDirectory, args.dir) : ctx.workingDirectory
         });
         if (!result.success) {
           return { success: false, error: result.error ?? "project list failed" };
@@ -70744,10 +71267,10 @@ var init_project2 = __esm({
         fps: external_exports.number().optional().describe("Frames per second (default: 30)")
       }),
       async execute(args, ctx) {
-        const outputPath = resolve81(ctx.workingDirectory, args.outputPath ?? `${args.name}.vibe.json`);
+        const outputPath = resolve82(ctx.workingDirectory, args.outputPath ?? `${args.name}.vibe.json`);
         const project = new Project(args.name);
         if (args.fps) project.setFrameRate(args.fps);
-        await writeFile53(outputPath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
+        await writeFile54(outputPath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
         return {
           success: true,
           data: { name: args.name, outputPath },
@@ -70794,7 +71317,7 @@ var init_project2 = __esm({
 
 // src/commands/export.ts
 import { readFile as readFile53, access as access7 } from "node:fs/promises";
-import { resolve as resolve82 } from "node:path";
+import { resolve as resolve83 } from "node:path";
 import { spawn as spawn3 } from "node:child_process";
 async function getMediaDuration(filePath, mediaType, defaultImageDuration = 5) {
   if (mediaType === "image") {
@@ -70866,7 +71389,7 @@ async function runExport(projectPath, outputPath, options = {}) {
         message: "Project has no clips to export"
       };
     }
-    const finalOutputPath = resolve82(process.cwd(), outputPath);
+    const finalOutputPath = resolve83(process.cwd(), outputPath);
     const basePresetSettings = getPresetSettings(preset, summary.aspectRatio);
     const presetSettings = applyCustomOverrides(basePresetSettings, { bitrate, fps, resolution, codec });
     const clips = project.getClips().sort((a, b) => a.startTime - b.startTime);
@@ -71262,7 +71785,7 @@ function buildFFmpegArgs(clips, sources, presetSettings, outputPath, options, so
   return args;
 }
 function runFFmpegProcess(ffmpegPath, args, onProgress) {
-  return new Promise((resolve86, reject) => {
+  return new Promise((resolve87, reject) => {
     const ffmpeg = spawn3(ffmpegPath, args, {
       stdio: ["pipe", "pipe", "pipe"]
     });
@@ -71286,7 +71809,7 @@ function runFFmpegProcess(ffmpegPath, args, onProgress) {
     });
     ffmpeg.on("close", (code) => {
       if (code === 0) {
-        resolve86();
+        resolve87();
       } else {
         const errorMatch = stderr.match(/Error.*$/m);
         const errorMsg = errorMatch ? errorMatch[0] : `FFmpeg exited with code ${code}`;
@@ -71439,7 +71962,7 @@ var init_export = __esm({
 });
 
 // src/tools/manifest/export.ts
-import { resolve as resolve83 } from "node:path";
+import { resolve as resolve84 } from "node:path";
 var exportVideoTool, exportTools;
 var init_export2 = __esm({
   "src/tools/manifest/export.ts"() {
@@ -71462,8 +71985,8 @@ var init_export2 = __esm({
         overwrite: external_exports.boolean().optional().describe("Overwrite existing output file (default: false)")
       }),
       async execute(args, ctx) {
-        const projectPath = resolve83(ctx.workingDirectory, args.projectPath);
-        const outputPath = resolve83(ctx.workingDirectory, args.outputPath);
+        const projectPath = resolve84(ctx.workingDirectory, args.projectPath);
+        const outputPath = resolve84(ctx.workingDirectory, args.outputPath);
         const result = await runExport(projectPath, outputPath, {
           preset: args.preset,
           format: args.format,
@@ -71482,8 +72005,8 @@ var init_export2 = __esm({
 });
 
 // src/tools/manifest/agent-only.ts
-import { readFile as readFile54, writeFile as writeFile54, readdir as readdir9, stat as stat10, access as access8, unlink as unlink2 } from "node:fs/promises";
-import { resolve as resolve84, join as join32, basename as basename24, extname as extname15 } from "node:path";
+import { readFile as readFile54, writeFile as writeFile55, readdir as readdir9, stat as stat10, access as access8, unlink as unlink2 } from "node:fs/promises";
+import { resolve as resolve85, join as join33, basename as basename24, extname as extname15 } from "node:path";
 function matchPattern(filename, pattern) {
   const regex2 = new RegExp(
     "^" + pattern.replace(/\./g, "\\.").replace(/\*/g, ".*").replace(/\?/g, ".") + "$",
@@ -71563,12 +72086,12 @@ var init_agent_only = __esm({
       async execute(args, ctx) {
         const dirPath = args.path ?? ".";
         try {
-          const absPath = resolve84(ctx.workingDirectory, dirPath);
+          const absPath = resolve85(ctx.workingDirectory, dirPath);
           const entries = await readdir9(absPath, { withFileTypes: true });
           const results = [];
           for (const entry of entries) {
             if (args.pattern && !matchPattern(entry.name, args.pattern)) continue;
-            const fullPath = join32(absPath, entry.name);
+            const fullPath = join33(absPath, entry.name);
             const stats = await stat10(fullPath);
             if (entry.isDirectory()) {
               results.push(`[DIR]  ${entry.name}/`);
@@ -71596,7 +72119,7 @@ var init_agent_only = __esm({
       }),
       async execute(args, ctx) {
         try {
-          const absPath = resolve84(ctx.workingDirectory, args.path);
+          const absPath = resolve85(ctx.workingDirectory, args.path);
           const content = await readFile54(absPath, "utf-8");
           const maxLength = 4e3;
           const truncated = content.length > maxLength;
@@ -71621,8 +72144,8 @@ var init_agent_only = __esm({
       }),
       async execute(args, ctx) {
         try {
-          const absPath = resolve84(ctx.workingDirectory, args.path);
-          await writeFile54(absPath, args.content, "utf-8");
+          const absPath = resolve85(ctx.workingDirectory, args.path);
+          await writeFile55(absPath, args.content, "utf-8");
           return { success: true, data: { bytes: args.content.length }, humanLines: [`File written: ${args.path} (${formatSize(args.content.length)})`] };
         } catch (error) {
           return { success: false, error: `Failed to write file: ${error instanceof Error ? error.message : String(error)}` };
@@ -71641,7 +72164,7 @@ var init_agent_only = __esm({
         path: external_exports.string().describe("Path to check")
       }),
       async execute(args, ctx) {
-        const absPath = resolve84(ctx.workingDirectory, args.path);
+        const absPath = resolve85(ctx.workingDirectory, args.path);
         try {
           await access8(absPath);
           const stats = await stat10(absPath);
@@ -71669,11 +72192,11 @@ var init_agent_only = __esm({
       }),
       async execute(args, ctx) {
         try {
-          const filePath = resolve84(ctx.workingDirectory, args.project);
+          const filePath = resolve85(ctx.workingDirectory, args.project);
           const content = await readFile54(filePath, "utf-8");
           const data = JSON.parse(content);
           const project = Project.fromJSON(data);
-          const dirPath = resolve84(ctx.workingDirectory, args.directory);
+          const dirPath = resolve85(ctx.workingDirectory, args.directory);
           const filterExts = args.filter ? args.filter.split(",").map((e) => e.trim().toLowerCase()) : null;
           const imageDuration = args.imageDuration ?? 5;
           const recursive = args.recursive ?? false;
@@ -71681,7 +72204,7 @@ var init_agent_only = __esm({
           const scanDir = async (dir) => {
             const entries = await readdir9(dir, { withFileTypes: true });
             for (const entry of entries) {
-              const entryPath = join32(dir, entry.name);
+              const entryPath = join33(dir, entry.name);
               if (entry.isDirectory() && recursive) {
                 await scanDir(entryPath);
               } else if (entry.isFile()) {
@@ -71708,7 +72231,7 @@ var init_agent_only = __esm({
             const source = project.addSource({ name: mediaName, type: mediaType, url: mediaFile, duration });
             addedSources.push({ id: source.id, name: mediaName, type: mediaType });
           }
-          await writeFile54(filePath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
+          await writeFile55(filePath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
           return {
             success: true,
             data: { count: addedSources.length, sources: addedSources },
@@ -71741,7 +72264,7 @@ var init_agent_only = __esm({
       }),
       async execute(args, ctx) {
         try {
-          const filePath = resolve84(ctx.workingDirectory, args.project);
+          const filePath = resolve85(ctx.workingDirectory, args.project);
           const content = await readFile54(filePath, "utf-8");
           const data = JSON.parse(content);
           const project = Project.fromJSON(data);
@@ -71778,7 +72301,7 @@ var init_agent_only = __esm({
             createdClips.push({ id: clip.id, sourceName: source.name, startTime: currentTime, duration: source.duration });
             currentTime += source.duration + gap;
           }
-          await writeFile54(filePath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
+          await writeFile55(filePath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
           const totalDuration = currentTime - gap - startTime;
           return {
             success: true,
@@ -71812,7 +72335,7 @@ var init_agent_only = __esm({
       }),
       async execute(args, ctx) {
         try {
-          const filePath = resolve84(ctx.workingDirectory, args.project);
+          const filePath = resolve85(ctx.workingDirectory, args.project);
           const content = await readFile54(filePath, "utf-8");
           const data = JSON.parse(content);
           const project = Project.fromJSON(data);
@@ -71841,7 +72364,7 @@ var init_agent_only = __esm({
             });
             if (effect) appliedEffects.push({ clipId: clip.id, effectId: effect.id });
           }
-          await writeFile54(filePath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
+          await writeFile55(filePath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
           return {
             success: true,
             data: { applied: appliedEffects.length, effectType: args.effectType },
@@ -71910,7 +72433,7 @@ var init_agent_only = __esm({
               removed.sources++;
             }
           }
-          await writeFile54(filePath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
+          await writeFile55(filePath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
           const parts = [];
           if (removed.clips > 0) parts.push(`${removed.clips} clips`);
           if (removed.tracks > 0) parts.push(`${removed.tracks} tracks`);
@@ -71961,7 +72484,7 @@ var init_agent_only = __esm({
             project.setFrameRate(args.fps);
             updates.push(`Frame Rate: ${args.fps} fps`);
           }
-          await writeFile54(filePath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
+          await writeFile55(filePath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
           return {
             success: true,
             data: { updates },
@@ -72104,7 +72627,7 @@ var init_agent_only = __esm({
       }),
       async execute(args, ctx) {
         try {
-          const absPath = resolve84(ctx.workingDirectory, args.path);
+          const absPath = resolve85(ctx.workingDirectory, args.path);
           const { stdout } = await execSafe(
             "ffprobe",
             ["-v", "quiet", "-print_format", "json", "-show_format", "-show_streams", absPath],
@@ -72193,10 +72716,10 @@ Audio:`);
       }),
       async execute(args, ctx) {
         try {
-          const absInput = resolve84(ctx.workingDirectory, args.input);
+          const absInput = resolve85(ctx.workingDirectory, args.input);
           const ext = args.input.split(".").pop() || "mp4";
           const baseName = args.input.replace(/\.[^/.]+$/, "");
-          const outputPath = args.output ? resolve84(ctx.workingDirectory, args.output) : resolve84(ctx.workingDirectory, `${baseName}-compressed.${ext}`);
+          const outputPath = args.output ? resolve85(ctx.workingDirectory, args.output) : resolve85(ctx.workingDirectory, `${baseName}-compressed.${ext}`);
           const crfValues = { low: 28, medium: 23, high: 18 };
           const crf = crfValues[args.quality ?? "medium"];
           await execSafe(
@@ -72256,8 +72779,8 @@ Audio:`);
       }),
       async execute(args, ctx) {
         try {
-          const absInput = resolve84(ctx.workingDirectory, args.input);
-          const absOutput = resolve84(ctx.workingDirectory, args.output);
+          const absInput = resolve85(ctx.workingDirectory, args.input);
+          const absOutput = resolve85(ctx.workingDirectory, args.output);
           const codecMap = {
             h264: "libx264",
             h265: "libx265",
@@ -72310,11 +72833,11 @@ Audio:`);
           };
         }
         try {
-          const absOutput = resolve84(ctx.workingDirectory, args.output);
+          const absOutput = resolve85(ctx.workingDirectory, args.output);
           if (args.reencode) {
             const ffmpegArgs = [];
             for (const i of args.inputs) {
-              ffmpegArgs.push("-i", resolve84(ctx.workingDirectory, i));
+              ffmpegArgs.push("-i", resolve85(ctx.workingDirectory, i));
             }
             const filterComplex = args.inputs.map((_, i) => `[${i}:v][${i}:a]`).join("");
             ffmpegArgs.push(
@@ -72329,9 +72852,9 @@ Audio:`);
             );
             await execSafe("ffmpeg", ffmpegArgs, { maxBuffer: 100 * 1024 * 1024 });
           } else {
-            const tempList = resolve84(ctx.workingDirectory, `concat-list-${Date.now()}.txt`);
-            const listContent = args.inputs.map((i) => `file '${resolve84(ctx.workingDirectory, i)}'`).join("\n");
-            await writeFile54(tempList, listContent, "utf-8");
+            const tempList = resolve85(ctx.workingDirectory, `concat-list-${Date.now()}.txt`);
+            const listContent = args.inputs.map((i) => `file '${resolve85(ctx.workingDirectory, i)}'`).join("\n");
+            await writeFile55(tempList, listContent, "utf-8");
             try {
               await execSafe(
                 "ffmpeg",
@@ -72427,7 +72950,7 @@ var init_walkthrough = __esm({
 });
 
 // src/tools/manifest/status.ts
-import { resolve as resolve85 } from "node:path";
+import { resolve as resolve86 } from "node:path";
 var PROJECT_DIR_DESCRIPTION5, statusJobTool, statusProjectTool, statusTools;
 var init_status = __esm({
   "src/tools/manifest/status.ts"() {
@@ -72451,7 +72974,7 @@ var init_status = __esm({
         output: external_exports.string().optional().describe("Download result media to this path when complete.")
       }),
       async execute(args, ctx) {
-        const projectDir = args.projectDir ? resolve85(ctx.workingDirectory, args.projectDir) : findProjectRoot(ctx.workingDirectory);
+        const projectDir = args.projectDir ? resolve86(ctx.workingDirectory, args.projectDir) : findProjectRoot(ctx.workingDirectory);
         const record = await readJobRecord(args.jobId, projectDir);
         if (!record) return { success: false, error: `Job not found: ${args.jobId}` };
         const result = args.refresh === false ? makeJobStatusResult(record, {
@@ -72460,7 +72983,7 @@ var init_status = __esm({
           warnings: []
         }) : await refreshJobRecord(record, {
           wait: args.wait,
-          output: args.output ? resolve85(ctx.workingDirectory, args.output) : void 0,
+          output: args.output ? resolve86(ctx.workingDirectory, args.output) : void 0,
           workingDirectory: ctx.workingDirectory
         });
         return {
@@ -72485,7 +73008,7 @@ var init_status = __esm({
         refresh: external_exports.boolean().optional().describe("Refresh active supported jobs before summarizing. Default false.")
       }),
       async execute(args, ctx) {
-        const projectDir = args.projectDir ? resolve85(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
+        const projectDir = args.projectDir ? resolve86(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
         const result = await inspectProjectStatus(projectDir, { refresh: args.refresh === true });
         return {
           success: true,
@@ -72774,7 +73297,7 @@ init_source();
 // package.json
 var package_default = {
   name: "@vibeframe/cli",
-  version: "0.115.1",
+  version: "0.115.2",
   description: "Frontier AI video generation for coding agents - Seedance, Runway, Veo, and Kling on your own keys, behind a hard cost cap",
   private: false,
   license: "MIT",
@@ -79649,12 +80172,12 @@ function resolveCopier() {
 async function copyToClipboard(text) {
   const opener = resolveCopier();
   if (!opener) return false;
-  return new Promise((resolve86) => {
+  return new Promise((resolve87) => {
     let settled = false;
     const finish = (ok) => {
       if (settled) return;
       settled = true;
-      resolve86(ok);
+      resolve87(ok);
     };
     try {
       const child = spawn2(opener.command, opener.args, {
@@ -82991,8 +83514,8 @@ init_scene_build();
 init_build_plan();
 init_storyboard_parse();
 init_output();
-import { resolve as resolve63, join as join28 } from "node:path";
-import { readFileSync as readFileSync3, existsSync as existsSync51 } from "node:fs";
+import { resolve as resolve64, join as join29 } from "node:path";
+import { readFileSync as readFileSync3, existsSync as existsSync52 } from "node:fs";
 var VALID_MODES2 = ["agent", "batch", "auto"];
 var VALID_STAGES2 = ["assets", "transcript", "compose", "sync", "render", "all"];
 var VALID_IMAGE_PROVIDERS2 = ["openai", "gemini", "grok"];
@@ -83000,14 +83523,17 @@ var VALID_VIDEO_PROVIDERS2 = ["seedance", "grok", "kling", "runway", "veo"];
 var VALID_MUSIC_PROVIDERS2 = ["elevenlabs", "replicate"];
 var buildCommand = new Command("build").description("Build a VibeFrame video project from STORYBOARD.md").argument("[project-dir]", "Video project directory", ".").option("--stage <stage>", `Build stage: ${VALID_STAGES2.join("|")}`, "all").option("--beat <id>", "Restrict asset/compose work to one beat id").option("--mode <mode>", "Retained for compatibility; scene HTML is always authored by your host agent unless --composer template is set", "auto").option(
   "--composer <provider>",
-  "Set to `template` for the deterministic AI-video composer (concat bg + lower-thirds, no model). Omit to let the host agent author each scene."
+  "Set to `template` for the deterministic AI-video composer (concat bg + lower-thirds, no model) or `footage` for the crossfade footage cut (clips + narration + music, no HTML render). Omit to let the host agent author each scene."
 ).option("--max-cost <usd>", "Fail before provider spend when estimated cost exceeds this USD cap").option("--skip-narration", "Don't dispatch TTS even when beats declare narration cues").option("--skip-backdrop", "Don't dispatch image-gen even when beats declare backdrop cues").option("--skip-video", "Don't dispatch video generation even when beats declare video cues").option(
   "--skip-keyframe",
   "Don't generate keyframe stills (review keyframes first with --skip-video, then build)"
 ).option("--skip-music", "Don't dispatch music generation even when beats declare music cues").option(
   "--skip-transcript",
   "Don't transcribe narration for word-sync (default: transcribe when narration + OpenAI key exist)"
-).option("--skip-render", "Compose only - don't render to MP4").option("--tts <provider>", "TTS provider: auto|elevenlabs|openai|kokoro").option("--voice <id>", "Voice id").option("--image-provider <name>", `Image provider: ${VALID_IMAGE_PROVIDERS2.join("|")}`).option("--video-provider <name>", `Video provider: ${VALID_VIDEO_PROVIDERS2.join("|")}`).option("--music-provider <name>", `Music provider: ${VALID_MUSIC_PROVIDERS2.join("|")}`).option("--quality <q>", "Image quality: standard|hd", "hd").option("--image-size <s>", "Image size: 1024x1024|1536x1024|1024x1536", "1536x1024").option("--force", "Re-dispatch primitives even when assets already exist").option("--dry-run", "Preview parameters without dispatching").addHelpText(
+).option("--skip-render", "Compose only - don't render to MP4").option("--tts <provider>", "TTS provider: auto|elevenlabs|openai|kokoro").option("--voice <id>", "Voice id").option("--image-provider <name>", `Image provider: ${VALID_IMAGE_PROVIDERS2.join("|")}`).option(
+  "--image-model <model>",
+  "Image model for keyframes/backdrops/character sheets (gemini: flash|pro, openai: gpt-image-2). Provider default when omitted."
+).option("--video-provider <name>", `Video provider: ${VALID_VIDEO_PROVIDERS2.join("|")}`).option("--music-provider <name>", `Music provider: ${VALID_MUSIC_PROVIDERS2.join("|")}`).option("--quality <q>", "Image quality: standard|hd", "hd").option("--image-size <s>", "Image size: 1024x1024|1536x1024|1024x1536", "1536x1024").option("--force", "Re-dispatch primitives even when assets already exist").option("--dry-run", "Preview parameters without dispatching").addHelpText(
   "after",
   `
 Examples:
@@ -83018,7 +83544,7 @@ Examples:
 Advanced equivalent: \`vibe scene build\`.`
 ).action(async (projectDirArg, options) => {
   const startedAt = Date.now();
-  const projectDir = resolve63(projectDirArg);
+  const projectDir = resolve64(projectDirArg);
   const mode = String(options.mode ?? "auto");
   if (!VALID_MODES2.includes(mode)) {
     exitWithError(
@@ -83075,6 +83601,7 @@ Advanced equivalent: \`vibe scene build\`.`
     videoProvider,
     musicProvider,
     imageQuality: options.quality,
+    imageModel: options.imageModel,
     imageSize: options.imageSize,
     force: options.force ?? false
   };
@@ -83094,6 +83621,7 @@ Advanced equivalent: \`vibe scene build\`.`
       voice: options.voice,
       imageProvider,
       imageQuality: options.quality,
+      imageModel: options.imageModel,
       imageSize: options.imageSize,
       videoProvider,
       musicProvider,
@@ -83168,6 +83696,7 @@ Advanced equivalent: \`vibe scene build\`.`
     videoProvider,
     musicProvider,
     imageQuality: options.quality,
+    imageModel: options.imageModel,
     imageSize: options.imageSize,
     force: options.force,
     onProgress: (e) => {
@@ -83350,8 +83879,8 @@ function buildPlanValidationFailureData(plan) {
   };
 }
 function estimateBuildCost(params) {
-  const storyboardPath2 = join28(params.projectDir, "STORYBOARD.md");
-  if (!existsSync51(storyboardPath2)) return null;
+  const storyboardPath2 = join29(params.projectDir, "STORYBOARD.md");
+  if (!existsSync52(storyboardPath2)) return null;
   let beats = 0;
   try {
     const md = readFileSync3(storyboardPath2, "utf-8");
@@ -83485,7 +84014,7 @@ init_source();
 init_ora();
 init_scene_render();
 init_output();
-import { resolve as resolve64 } from "node:path";
+import { resolve as resolve65 } from "node:path";
 var VALID_FPS = [24, 30, 60];
 var VALID_QUALITIES = ["draft", "standard", "high"];
 var VALID_FORMATS = ["mp4", "webm", "mov"];
@@ -83496,7 +84025,7 @@ Examples:
 
 Alias note: this is the project-level entrypoint for \`vibe scene render\`.`).action(async (projectDirArg, options) => {
   const startedAt = Date.now();
-  const projectDir = resolve64(projectDirArg);
+  const projectDir = resolve65(projectDirArg);
   const fps = parseFps(String(options.fps));
   const quality = parseQuality(String(options.quality));
   const format = parseFormat(String(options.format));
@@ -83638,7 +84167,7 @@ init_source();
 init_ora();
 init_scene_render();
 init_output();
-import { resolve as resolve65 } from "node:path";
+import { resolve as resolve66 } from "node:path";
 var VALID_FPS2 = [24, 30, 60];
 var VALID_QUALITIES2 = ["draft", "standard", "high"];
 var VALID_FORMATS2 = ["mp4", "webm", "mov"];
@@ -83656,7 +84185,7 @@ Examples:
   $ vibe preview my-video --beat hook
   $ vibe preview my-video --fps 30   # override the cheap default`).action(async (projectDirArg, options) => {
   const startedAt = Date.now();
-  const projectDir = resolve65(projectDirArg);
+  const projectDir = resolve66(projectDirArg);
   const fps = parseFps2(String(options.fps));
   const quality = parseQuality2(String(options.quality));
   const format = parseFormat2(String(options.format));
@@ -83793,21 +84322,35 @@ init_esm();
 init_source();
 init_ora();
 init_scene_assemble();
+init_footage_assemble();
 init_output();
-import { resolve as resolve66 } from "node:path";
+import { resolve as resolve67 } from "node:path";
 var VALID_FORMATS3 = ["mp4", "webm", "mov"];
 var DEFAULT_VIDEO = "preview.mp4";
-var assembleCommand = new Command("assemble").description("Mux a scene project's audio onto an already-rendered (silent) video").argument("[project-dir]", "Video project directory", ".").option("--video <path>", `Rendered video to add audio to (default: ${DEFAULT_VIDEO})`, DEFAULT_VIDEO).option("--root <file>", "Root composition file", "index.html").option("--format <f>", `Output container: ${VALID_FORMATS3.join("|")}`, "mp4").option("--dry-run", "Preview parameters without muxing").addHelpText("after", `
-The assemble stage lays the project's <audio> elements onto a silent video in
-one FFmpeg pass (-c:v copy, no re-encode). Pair it with \`vibe render --silent\`:
+var assembleCommand = new Command("assemble").description(
+  "Mux a scene project's audio onto a rendered video, or crossfade-cut its generated clips (--footage)"
+).argument("[project-dir]", "Video project directory", ".").option("--video <path>", `Rendered video to add audio to (default: ${DEFAULT_VIDEO})`, DEFAULT_VIDEO).option("--root <file>", "Root composition file", "index.html").option("--format <f>", `Output container: ${VALID_FORMATS3.join("|")}`, "mp4").option("--footage", "Assemble assets/video-<beat>.mp4 clips into one cinematic cut (no HTML render)").option("-o, --output <path>", "Footage-cut output path (default: renders/footage.mp4)").option("--transition <sec>", "Footage crossfade length in seconds", "0.5").option("--fade <sec>", "Footage fade-from/to-black length in seconds", "0.6").option("--music <path>", 'Footage music bed: a file path or "none" (default: auto-detect assets/music*)').option("--music-volume <v>", "Footage music-bed volume before ducking (0-1)", "0.35").option("--finish", "Footage cinematic finish: vignette + film grain before the fades").option("--dry-run", "Preview parameters without muxing").addHelpText("after", `
+The default assemble stage lays the project's <audio> elements onto a silent
+video in one FFmpeg pass (-c:v copy, no re-encode). Pair it with \`vibe render
+--silent\`:
 
   $ vibe render my-video --silent -o draft.mp4
   $ vibe assemble my-video --video draft.mp4
 
-Plain \`vibe render\` already renders + assembles in one shot - use this only when
-you want the two steps separated (e.g. swap the audio bed without re-rendering).`).action(async (projectDirArg, options) => {
+With --footage the project's generated clips become the picture: they are
+crossfade-concatenated in beat order, narration is laid at computed offsets,
+an optional music bed is ducked under it, and the head/tail fade to black -
+one FFmpeg pass, no HTML composition or browser capture. Timing comes from
+the real files (ffprobe), and assemble-report.json records every offset:
+
+  $ vibe build my-video --stage assets --json     # clips + narration
+  $ vibe assemble my-video --footage --json`).action(async (projectDirArg, options) => {
   const startedAt = Date.now();
-  const projectDir = resolve66(projectDirArg);
+  const projectDir = resolve67(projectDirArg);
+  if (options.footage) {
+    await runFootageAssemble(projectDir, options, startedAt);
+    return;
+  }
   const format = parseFormat3(String(options.format));
   const video = String(options.video ?? DEFAULT_VIDEO);
   const params = { projectDir, root: options.root, video, format };
@@ -83844,6 +84387,73 @@ you want the two steps separated (e.g. swap the audio bed without re-rendering).
   }
   printAssembleResult(spinner2, result);
 });
+async function runFootageAssemble(projectDir, options, startedAt) {
+  const transitionSec = parseSeconds("--transition", options.transition);
+  const fadeSec = parseSeconds("--fade", options.fade);
+  const musicVolume = parseSeconds("--music-volume", options.musicVolume);
+  const spinner2 = isJsonMode() || isQuietMode() || options.dryRun ? null : ora("Assembling footage cut...").start();
+  const result = await executeFootageAssemble({
+    projectDir,
+    output: options.output,
+    transitionSec,
+    fadeSec,
+    music: options.music,
+    musicVolume,
+    finish: Boolean(options.finish),
+    dryRun: Boolean(options.dryRun)
+  });
+  if (!result.success) {
+    spinner2?.fail("Footage assemble failed");
+    exitWithError(generalError(result.error ?? "Footage assemble failed", result.suggestion));
+  }
+  if (isJsonMode() || isQuietMode()) {
+    outputSuccess({ command: "assemble", startedAt, dryRun: result.dryRun, data: { ...result } });
+    return;
+  }
+  printFootageResult(spinner2, result);
+}
+function printFootageResult(spinner2, result) {
+  const report = result.report;
+  if (result.dryRun) {
+    console.log();
+    console.log(source_default.bold.cyan("VibeFrame Assemble - footage dry run"));
+  } else {
+    spinner2?.succeed(source_default.green(`Footage cut assembled: ${result.outputPath}`));
+    console.log();
+    console.log(source_default.bold.cyan("Footage cut"));
+  }
+  console.log(source_default.dim("-".repeat(60)));
+  if (report) {
+    console.log(`  Output:     ${source_default.bold(report.output)}`);
+    console.log(`  Duration:   ${source_default.bold(`${report.totalDurationSec}s`)}`);
+    console.log(`  Transition: ${report.transitionSec}s crossfade, ${report.fadeSec}s head/tail fade`);
+    console.log(
+      `  Music:      ${report.music ? `${report.music.path}${report.music.ducked ? " (ducked)" : ""}` : source_default.dim("none")}`
+    );
+    for (const beat of report.beats) {
+      const narration = beat.narrationStartSec !== void 0 ? ` nar@${beat.narrationStartSec}s` : "";
+      const extended = beat.extendedSec > 0 ? source_default.yellow(` +${beat.extendedSec}s hold`) : "";
+      console.log(
+        `    ${beat.id.padEnd(12)} ${String(beat.startSec).padStart(7)}s  ${beat.segmentDurationSec}s${narration}${extended}`
+      );
+    }
+    for (const warning of report.warnings) console.log(source_default.yellow(`  Warning: ${warning}`));
+  }
+  if (result.dryRun) {
+    console.log();
+    console.log(source_default.dim("No FFmpeg pass ran; nothing was written."));
+  } else if (result.reportPath) {
+    console.log(`  Report:     ${result.reportPath}`);
+  }
+}
+function parseSeconds(flag, value) {
+  if (value === void 0) return void 0;
+  const n = Number.parseFloat(String(value));
+  if (!Number.isFinite(n) || n < 0) {
+    exitWithError(usageError(`Invalid ${flag}: ${String(value)}`, "Expected a non-negative number."));
+  }
+  return n;
+}
 function printAssembleDryRun(projectDirArg, params) {
   console.log();
   console.log(source_default.bold.cyan("VibeFrame Assemble - dry run"));
@@ -83879,7 +84489,7 @@ init_source();
 init_cost_tier();
 init_status_jobs();
 init_output();
-import { resolve as resolve67 } from "node:path";
+import { resolve as resolve68 } from "node:path";
 var statusCommand = new Command("status").description("Inspect local async jobs and project workflow status").addHelpText("after", `
 Examples:
   $ vibe status job job_abc123 --json
@@ -83890,7 +84500,7 @@ Examples:
 statusCommand.command("job").description("Show one async job status").argument("<job-id>", "Local job id from a no-wait command").option("--project <dir>", "Project directory containing .vibeframe/jobs").option("--no-refresh", "Read local job record only; do not call provider APIs").option("--wait", "Wait for completion when the provider status helper supports it").option("-o, --output <path>", "Download result media when complete").action(async (jobId, options) => {
   const startedAt = Date.now();
   try {
-    const projectDir = options.project ? resolve67(options.project) : findProjectRoot();
+    const projectDir = options.project ? resolve68(options.project) : findProjectRoot();
     const record = await readJobRecord(jobId, projectDir);
     if (!record) {
       exitWithError(generalError(`Job not found: ${jobId}`, `Run 'vibe status project ${projectDir} --json' to list known jobs.`));
@@ -83918,7 +84528,7 @@ applyTier(statusCommand.commands[statusCommand.commands.length - 1], "free");
 statusCommand.command("project").description("Summarize build, review, and async job status for a project").argument("[project-dir]", "VibeFrame project directory", ".").option("--refresh", "Refresh active supported jobs before summarizing").action(async (projectDirArg, options) => {
   const startedAt = Date.now();
   try {
-    const result = await inspectProjectStatus(resolve67(projectDirArg), {
+    const result = await inspectProjectStatus(resolve68(projectDirArg), {
       refresh: options.refresh === true
     });
     if (isJsonMode()) {
@@ -84025,8 +84635,8 @@ init_dist2();
 init_exec_safe();
 init_exec_safe();
 init_api_key();
-import { existsSync as existsSync52 } from "node:fs";
-import { resolve as resolve68 } from "node:path";
+import { existsSync as existsSync53 } from "node:fs";
+import { resolve as resolve69 } from "node:path";
 init_composer_resolve();
 init_cost_tier();
 init_install_skill();
@@ -84157,13 +84767,13 @@ async function runDiagnostics() {
         installed = false;
       }
     } else if (toolName === "chrome") {
-      const { existsSync: existsSync60 } = await import("node:fs");
+      const { existsSync: existsSync61 } = await import("node:fs");
       const { homedir: homedir8 } = await import("node:os");
-      const { join: join33 } = await import("node:path");
+      const { join: join34 } = await import("node:path");
       const chromePaths = [
         process.env.HYPERFRAMES_CHROME_PATH,
         process.env.CHROME_PATH,
-        join33(
+        join34(
           homedir8(),
           ".cache",
           "puppeteer",
@@ -84178,7 +84788,7 @@ async function runDiagnostics() {
         "/usr/bin/chromium",
         "/usr/bin/chromium-browser"
       ];
-      installed = chromePaths.some((p) => p && existsSync60(p));
+      installed = chromePaths.some((p) => p && existsSync61(p));
     } else {
       installed = commandExists(toolName);
     }
@@ -84218,7 +84828,7 @@ async function runDiagnostics() {
   }
   const projectFiles = ["AGENTS.md", "CLAUDE.md", "vibe.project.yaml"].map((rel) => ({
     path: rel,
-    exists: existsSync52(resolve68(cwd, rel))
+    exists: existsSync53(resolve69(cwd, rel))
   }));
   const projectInitialized = projectFiles.some((f) => f.exists);
   const nearestProjectConfigPath = await findProjectConfigPath(cwd);
@@ -84236,7 +84846,7 @@ async function runDiagnostics() {
   } catch (err) {
     if (!(err instanceof ComposerResolveError)) throw err;
   }
-  const sceneProjectInCwd = existsSync52(resolve68(cwd, "STORYBOARD.md"));
+  const sceneProjectInCwd = existsSync53(resolve69(cwd, "STORYBOARD.md"));
   const skillInstalled = hyperframesSkillAvailable(cwd);
   const skillPath = resolveSkillReference(cwd);
   return {
@@ -84589,7 +85199,7 @@ init_esm();
 init_source();
 init_exec_safe();
 init_cost_tier();
-import { resolve as resolve69 } from "node:path";
+import { resolve as resolve70 } from "node:path";
 init_output();
 var hostCommand = new Command("host").description("Set up Codex, Claude, and Cursor app integrations").addHelpText(
   "after",
@@ -84603,7 +85213,7 @@ Examples:
 );
 hostCommand.command("list").description("List supported app hosts and integration surfaces").action(() => {
   const startedAt = Date.now();
-  const hosts = hostDefinitions(resolve69(".")).map((host) => ({
+  const hosts = hostDefinitions(resolve70(".")).map((host) => ({
     id: host.id,
     label: host.label,
     surfaces: host.surfaces,
@@ -84630,7 +85240,7 @@ applyTier(hostCommand.commands[hostCommand.commands.length - 1], "free");
 hostCommand.command("setup").description("Print or write Codex/Claude/Cursor MCP and project integration config").argument("[host]", `Host target: ${HOST_SELECTIONS.join(" | ")}`, "all").argument("[project-dir]", "Project directory for project-scoped config", ".").option("--write", "Write config files instead of printing snippets only").option("--dry-run", "Show file actions without writing").option("--force", "Replace an existing vibeframe MCP entry").action(async (hostArg, projectDirArg, options) => {
   const startedAt = Date.now();
   const selection = validateHostSelection(hostArg);
-  const projectDir = resolve69(projectDirArg);
+  const projectDir = resolve70(projectDirArg);
   const ids = resolveHostSelection(selection);
   const defs = hostDefinitions(projectDir).filter((host) => ids.includes(host.id));
   const plans = [];
@@ -84664,7 +85274,7 @@ applyTier(hostCommand.commands[hostCommand.commands.length - 1], "free");
 hostCommand.command("doctor").description("Check Codex/Claude/Cursor app integration readiness").argument("[host]", `Host target: ${HOST_SELECTIONS.join(" | ")}`, "all").argument("[project-dir]", "Project directory to inspect", ".").action(async (hostArg, projectDirArg) => {
   const startedAt = Date.now();
   const selection = validateHostSelection(hostArg);
-  const projectDir = resolve69(projectDirArg);
+  const projectDir = resolve70(projectDirArg);
   const ids = resolveHostSelection(selection);
   const defs = hostDefinitions(projectDir).filter((host) => ids.includes(host.id));
   const hosts = await Promise.all(defs.map((host) => inspectHost(host, projectDir)));
@@ -84784,10 +85394,10 @@ init_exec_safe();
 init_detect();
 init_ai_edit();
 init_output();
-import { resolve as resolve70 } from "node:path";
-import { existsSync as existsSync53 } from "node:fs";
-import { mkdir as mkdir26, rm as rm6 } from "node:fs/promises";
-var DEMO_DIR = resolve70(process.cwd(), ".vibeframe-demo");
+import { resolve as resolve71 } from "node:path";
+import { existsSync as existsSync54 } from "node:fs";
+import { mkdir as mkdir27, rm as rm6 } from "node:fs/promises";
+var DEMO_DIR = resolve71(process.cwd(), ".vibeframe-demo");
 async function generateTestVideo(outputPath) {
   const filter = [
     // Video: color bars with text
@@ -84816,7 +85426,7 @@ async function generateTestVideo(outputPath) {
       "-y",
       outputPath
     ], { timeout: 3e4, maxBuffer: 50 * 1024 * 1024 });
-    return existsSync53(outputPath);
+    return existsSync54(outputPath);
   } catch {
     try {
       await execSafe("ffmpeg", [
@@ -84842,7 +85452,7 @@ async function generateTestVideo(outputPath) {
         "-y",
         outputPath
       ], { timeout: 3e4, maxBuffer: 50 * 1024 * 1024 });
-      return existsSync53(outputPath);
+      return existsSync54(outputPath);
     } catch {
       return false;
     }
@@ -84866,8 +85476,8 @@ var demoCommand = new Command("demo").description("Run sample edits on a test vi
     console.log(source_default.dim("  " + "\u2500".repeat(50)));
     console.log();
   }
-  await mkdir26(DEMO_DIR, { recursive: true });
-  const testVideo = resolve70(DEMO_DIR, "test-input.mp4");
+  await mkdir27(DEMO_DIR, { recursive: true });
+  const testVideo = resolve71(DEMO_DIR, "test-input.mp4");
   const genSpinner = !isJson ? ora("Generating test video...").start() : null;
   const generated = await generateTestVideo(testVideo);
   if (!generated) {
@@ -84896,7 +85506,7 @@ var demoCommand = new Command("demo").description("Run sample edits on a test vi
       name: "Silence Cut",
       description: "Removing silent segments",
       run: async () => {
-        const output = resolve70(DEMO_DIR, "silence-cut.mp4");
+        const output = resolve71(DEMO_DIR, "silence-cut.mp4");
         const r = await executeSilenceCut({ videoPath: testVideo, outputPath: output, padding: 0.1 });
         if (r.success && r.totalDuration && r.silentDuration) {
           return { success: true, detail: `Removed ${r.silentDuration.toFixed(1)}s silence (${r.totalDuration.toFixed(1)}s \u2192 ${(r.totalDuration - r.silentDuration).toFixed(1)}s)` };
@@ -84908,7 +85518,7 @@ var demoCommand = new Command("demo").description("Run sample edits on a test vi
       name: "Noise Reduce",
       description: "Reducing background noise",
       run: async () => {
-        const output = resolve70(DEMO_DIR, "noise-reduced.mp4");
+        const output = resolve71(DEMO_DIR, "noise-reduced.mp4");
         const r = await executeNoiseReduce({ inputPath: testVideo, outputPath: output, strength: "medium" });
         return { success: r.success, detail: r.success ? `Cleaned audio \u2192 ${output}` : r.error };
       }
@@ -84917,7 +85527,7 @@ var demoCommand = new Command("demo").description("Run sample edits on a test vi
       name: "Fade Effects",
       description: "Adding fade in/out",
       run: async () => {
-        const output = resolve70(DEMO_DIR, "faded.mp4");
+        const output = resolve71(DEMO_DIR, "faded.mp4");
         const r = await executeFade({ videoPath: testVideo, outputPath: output, fadeIn: 1, fadeOut: 1 });
         return { success: r.success, detail: r.success ? `1s fade in + 1s fade out \u2192 ${output}` : r.error };
       }
@@ -84984,20 +85594,20 @@ var demoCommand = new Command("demo").description("Run sample edits on a test vi
 
 // src/commands/context.ts
 init_esm();
-import { existsSync as existsSync54 } from "node:fs";
+import { existsSync as existsSync55 } from "node:fs";
 import { readFile as readFile45 } from "node:fs/promises";
-import { resolve as resolve71, dirname as dirname22 } from "node:path";
+import { resolve as resolve72, dirname as dirname23 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 var __filename = fileURLToPath2(import.meta.url);
-var __dirname = dirname22(__filename);
+var __dirname = dirname23(__filename);
 function resolveContextPath(baseDir = __dirname) {
   const candidates = [
     // Bundled package layout: packages/cli/dist/index.js -> packages/cli/CONTEXT.md
-    resolve71(baseDir, "../CONTEXT.md"),
+    resolve72(baseDir, "../CONTEXT.md"),
     // Source/dev layout: packages/cli/src/commands/context.ts -> packages/cli/CONTEXT.md
-    resolve71(baseDir, "../../CONTEXT.md")
+    resolve72(baseDir, "../../CONTEXT.md")
   ];
-  return candidates.find((candidate) => existsSync54(candidate)) ?? null;
+  return candidates.find((candidate) => existsSync55(candidate)) ?? null;
 }
 var contextCommand = new Command("context").description("Print CLI context/guidelines for AI agent integration").option("--format <format>", "Output format: markdown | json", "markdown").action(async (_options, cmd) => {
   const options = {
@@ -86052,7 +86662,7 @@ async function startAgent(options = {}) {
   console.log();
   console.log(source_default.dim("  Commands: exit \xB7 reset \xB7 tools \xB7 context"));
   console.log();
-  return new Promise((resolve86) => {
+  return new Promise((resolve87) => {
     if (typeof process.stdin.ref === "function") {
       process.stdin.ref();
     }
@@ -86159,7 +86769,7 @@ async function startAgent(options = {}) {
       clearInterval(keepalive);
       console.log();
       console.log(source_default.dim("Goodbye!"));
-      resolve86();
+      resolve87();
     });
     rl.prompt();
   });
@@ -86433,8 +87043,8 @@ init_source();
 init_config();
 init_schema();
 init_api_key();
-import { access as access9, writeFile as writeFile55, mkdir as mkdir29 } from "node:fs/promises";
-import { dirname as dirname24 } from "node:path";
+import { access as access9, writeFile as writeFile56, mkdir as mkdir30 } from "node:fs/promises";
+import { dirname as dirname25 } from "node:path";
 var BANNER_SHOWN_PATH = `${USER_CONFIG_DIR}/.banner-shown`;
 async function isFirstRun() {
   try {
@@ -86453,8 +87063,8 @@ async function isFirstRun() {
 }
 async function markBannerShown() {
   try {
-    await mkdir29(dirname24(BANNER_SHOWN_PATH), { recursive: true });
-    await writeFile55(BANNER_SHOWN_PATH, (/* @__PURE__ */ new Date()).toISOString());
+    await mkdir30(dirname25(BANNER_SHOWN_PATH), { recursive: true });
+    await writeFile56(BANNER_SHOWN_PATH, (/* @__PURE__ */ new Date()).toISOString());
   } catch {
   }
 }