@vibeframe/cli 0.111.1 → 0.112.0

package/dist/tools/manifest/index.js

@@ -969,7 +969,7 @@ function errorMessage(error) {
   return error instanceof Error ? error.message : "Unknown error";
 }
 function sleep(ms) {
-  return new Promise((resolve65) => setTimeout(resolve65, ms));
+  return new Promise((resolve66) => setTimeout(resolve66, ms));
 }
 var ProviderHttpError;
 var init_http = __esm({
@@ -4737,15 +4737,15 @@ async function loadKokoroFactory() {
 }
 async function loadKokoroFromWorkspace(baseDir = process.cwd()) {
   try {
-    const { readFile: readFile44 } = await import("node:fs/promises");
-    const { join: join26, resolve: resolve65 } = await import("node:path");
+    const { readFile: readFile45 } = await import("node:fs/promises");
+    const { join: join27, resolve: resolve66 } = await import("node:path");
     const { pathToFileURL } = await import("node:url");
-    const pkgDir = resolve65(baseDir, "node_modules", "kokoro-js");
-    const pkg = JSON.parse(await readFile44(join26(pkgDir, "package.json"), "utf-8"));
+    const pkgDir = resolve66(baseDir, "node_modules", "kokoro-js");
+    const pkg = JSON.parse(await readFile45(join27(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(join26(pkgDir, entry)).href);
+    const mod = await import(pathToFileURL(join27(pkgDir, entry)).href);
     return mod.KokoroTTS ?? null;
   } catch {
     return null;
@@ -5403,7 +5403,7 @@ var init_RunwayProvider = __esm({
        * Sleep helper
        */
       sleep(ms) {
-        return new Promise((resolve65) => setTimeout(resolve65, ms));
+        return new Promise((resolve66) => setTimeout(resolve66, ms));
       }
     };
     RunwayProvider.API_VERSION = "2024-11-06";
@@ -5844,7 +5844,7 @@ var init_KlingProvider = __esm({
        * Sleep helper
        */
       sleep(ms) {
-        return new Promise((resolve65) => setTimeout(resolve65, ms));
+        return new Promise((resolve66) => setTimeout(resolve66, ms));
       }
     };
     klingProvider = new KlingProvider();
@@ -6162,7 +6162,7 @@ var init_GrokProvider = __esm({
         }
       }
       sleep(ms) {
-        return new Promise((resolve65) => setTimeout(resolve65, ms));
+        return new Promise((resolve66) => setTimeout(resolve66, ms));
       }
     };
     grokProvider = new GrokProvider();
@@ -6197,11 +6197,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(resolve65) {
-          resolve65(value);
+        return value instanceof P ? value : new P(function(resolve66) {
+          resolve66(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve65, reject) {
+      return new (P || (P = Promise))(function(resolve66, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -6217,7 +6217,7 @@ var require_middleware = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve65(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve66(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -6302,11 +6302,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(resolve65) {
-          resolve65(value);
+        return value instanceof P ? value : new P(function(resolve66) {
+          resolve66(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve65, reject) {
+      return new (P || (P = Promise))(function(resolve66, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -6322,7 +6322,7 @@ var require_response = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve65(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve66(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -6429,11 +6429,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(resolve65) {
-          resolve65(value);
+        return value instanceof P ? value : new P(function(resolve66) {
+          resolve66(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve65, reject) {
+      return new (P || (P = Promise))(function(resolve66, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -6449,7 +6449,7 @@ var require_utils = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve65(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve66(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -6542,7 +6542,7 @@ var require_utils = __commonJS({
     }
     function sleep4(ms) {
       return __awaiter(this, void 0, void 0, function* () {
-        return new Promise((resolve65) => setTimeout(resolve65, ms));
+        return new Promise((resolve66) => setTimeout(resolve66, ms));
       });
     }
   }
@@ -6554,11 +6554,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(resolve65) {
-          resolve65(value);
+        return value instanceof P ? value : new P(function(resolve66) {
+          resolve66(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve65, reject) {
+      return new (P || (P = Promise))(function(resolve66, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -6574,7 +6574,7 @@ var require_retry = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve65(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve66(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -6781,11 +6781,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(resolve65) {
-          resolve65(value);
+        return value instanceof P ? value : new P(function(resolve66) {
+          resolve66(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve65, reject) {
+      return new (P || (P = Promise))(function(resolve66, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -6801,7 +6801,7 @@ var require_request = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve65(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve66(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -6888,11 +6888,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(resolve65) {
-          resolve65(value);
+        return value instanceof P ? value : new P(function(resolve66) {
+          resolve66(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve65, reject) {
+      return new (P || (P = Promise))(function(resolve66, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -6908,7 +6908,7 @@ var require_storage = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve65(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve66(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -7236,11 +7236,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(resolve65) {
-          resolve65(value);
+        return value instanceof P ? value : new P(function(resolve66) {
+          resolve66(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve65, reject) {
+      return new (P || (P = Promise))(function(resolve66, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -7256,7 +7256,7 @@ var require_auth = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve65(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve66(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -7295,11 +7295,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(resolve65) {
-          resolve65(value);
+        return value instanceof P ? value : new P(function(resolve66) {
+          resolve66(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve65, reject) {
+      return new (P || (P = Promise))(function(resolve66, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -7315,7 +7315,7 @@ var require_streaming = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve65(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve66(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -7548,7 +7548,7 @@ var require_streaming = __commonJS({
           query: options.queryParams
         });
         this.options = options;
-        this.donePromise = new Promise((resolve65, reject) => {
+        this.donePromise = new Promise((resolve66, reject) => {
           if (this.streamClosed) {
             reject(new response_1.ApiError({
               message: "Streaming connection is already closed.",
@@ -7559,11 +7559,11 @@ var require_streaming = __commonJS({
           }
           this.signal.addEventListener("abort", () => {
             var _a2;
-            resolve65((_a2 = this.currentData) !== null && _a2 !== void 0 ? _a2 : {});
+            resolve66((_a2 = this.currentData) !== null && _a2 !== void 0 ? _a2 : {});
           });
           this.on("done", (data) => {
             this.streamClosed = true;
-            resolve65(data);
+            resolve66(data);
           });
           this.on("error", (error) => {
             this.streamClosed = true;
@@ -7588,7 +7588,7 @@ var require_streaming = __commonJS({
             if (data) {
               yield yield __await(data);
             }
-            yield __await(new Promise((resolve65) => setTimeout(resolve65, 16)));
+            yield __await(new Promise((resolve66) => setTimeout(resolve66, 16)));
           }
         });
       }
@@ -7633,11 +7633,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(resolve65) {
-          resolve65(value);
+        return value instanceof P ? value : new P(function(resolve66) {
+          resolve66(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve65, reject) {
+      return new (P || (P = Promise))(function(resolve66, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -7653,7 +7653,7 @@ var require_queue = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve65(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve66(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -7788,7 +7788,7 @@ var require_queue = __commonJS({
               }
               return doneStatus;
             }
-            return new Promise((resolve65, reject) => {
+            return new Promise((resolve66, 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;
@@ -7820,7 +7820,7 @@ var require_queue = __commonJS({
                   }
                   if (requestStatus.status === "COMPLETED") {
                     clearScheduledTasks();
-                    resolve65(requestStatus);
+                    resolve66(requestStatus);
                     return;
                   }
                   pollingTimeoutId = setTimeout(poll, pollInterval);
@@ -9781,11 +9781,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(resolve65) {
-          resolve65(value);
+        return value instanceof P ? value : new P(function(resolve66) {
+          resolve66(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve65, reject) {
+      return new (P || (P = Promise))(function(resolve66, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -9801,7 +9801,7 @@ var require_realtime = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve65(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve66(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -10126,11 +10126,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(resolve65) {
-          resolve65(value);
+        return value instanceof P ? value : new P(function(resolve66) {
+          resolve66(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve65, reject) {
+      return new (P || (P = Promise))(function(resolve66, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -10146,7 +10146,7 @@ var require_client = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve65(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve66(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -10831,7 +10831,7 @@ var init_ReplicateProvider = __esm({
        * Sleep helper
        */
       sleep(ms) {
-        return new Promise((resolve65) => setTimeout(resolve65, ms));
+        return new Promise((resolve66) => setTimeout(resolve66, ms));
       }
       /**
        * Generate music from text prompt using MusicGen
@@ -19591,7 +19591,7 @@ var init_ai_helpers = __esm({
 import { writeFile as writeFile2, unlink, rename } from "node:fs/promises";
 import { resolve as resolve2, basename } from "node:path";
 function sleep2(ms) {
-  return new Promise((resolve65) => setTimeout(resolve65, ms));
+  return new Promise((resolve66) => setTimeout(resolve66, ms));
 }
 async function uploadToImgbb(imageBuffer, apiKey) {
   try {
@@ -20336,7 +20336,7 @@ async function prompt(question, hidden = false) {
     input: process.stdin,
     output: process.stdout
   });
-  return new Promise((resolve65) => {
+  return new Promise((resolve66) => {
     if (hidden && process.stdin.isTTY) {
       process.stdout.write(question);
       let input = "";
@@ -20350,7 +20350,7 @@ async function prompt(question, hidden = false) {
           process.stdin.removeListener("data", onData);
           process.stdout.write("\n");
           rl.close();
-          resolve65(input);
+          resolve66(input);
         } else if (char === "") {
           process.exit(1);
         } else if (char === "\x7F" || char === "\b") {
@@ -20365,7 +20365,7 @@ async function prompt(question, hidden = false) {
     } else {
       rl.question(question, (answer) => {
         rl.close();
-        resolve65(answer);
+        resolve66(answer);
       });
     }
   });
@@ -24993,7 +24993,7 @@ function unique(items) {
   ];
 }
 function sleep3(ms) {
-  return new Promise((resolve65) => setTimeout(resolve65, ms));
+  return new Promise((resolve66) => setTimeout(resolve66, ms));
 }
 var LOCAL_JOB_ORPHAN_AFTER_MS;
 var init_status_jobs = __esm({
@@ -30123,14 +30123,15 @@ async function expectedRootSync(opts) {
   return { block, totalDurationSec: Number(cursor.toFixed(2)), audioRefs };
 }
 async function resolveSyncedBeatDuration(opts) {
-  if (opts.sceneDurationSec !== void 0) return Number(opts.sceneDurationSec.toFixed(2));
   const storyboardMin = opts.beatDuration ?? 3;
-  if (!opts.narrationPath) return Number(storyboardMin.toFixed(2));
+  const reported = opts.sceneDurationSec;
+  if (!opts.narrationPath) return Number((reported ?? storyboardMin).toFixed(2));
+  const probe = opts.probeAudioDuration ?? getAudioDuration;
   try {
-    const audioDuration = await getAudioDuration(join7(opts.projectDir, opts.narrationPath));
-    return Number(Math.max(storyboardMin, audioDuration + 0.5).toFixed(2));
+    const audioDuration = await probe(join7(opts.projectDir, opts.narrationPath));
+    return Number(Math.max(storyboardMin, reported ?? 0, audioDuration + 0.5).toFixed(2));
   } catch {
-    return Number(storyboardMin.toFixed(2));
+    return Number(Math.max(storyboardMin, reported ?? 0).toFixed(2));
   }
 }
 async function resolveProjectBeatDurations(projectDir) {
@@ -31508,6 +31509,22 @@ var init_chrome = __esm({
   }
 });
 
+// src/commands/_shared/ffmpeg-gate.ts
+function ffmpegToolsAvailable() {
+  if (testOverride !== null) return testOverride;
+  if (cached === null) cached = commandExists("ffmpeg") && commandExists("ffprobe");
+  return cached;
+}
+var testOverride, cached;
+var init_ffmpeg_gate = __esm({
+  "src/commands/_shared/ffmpeg-gate.ts"() {
+    "use strict";
+    init_exec_safe();
+    testOverride = null;
+    cached = null;
+  }
+});
+
 // src/commands/_shared/scene-audio-scan.ts
 import { readFile as readFile15 } from "node:fs/promises";
 import { resolve as resolve18 } from "node:path";
@@ -31833,6 +31850,33 @@ async function executeSceneRender(opts = {}) {
       error: `Project directory not found: ${projectDir}`
     };
   }
+  if (!ffmpegToolsAvailable()) {
+    return {
+      success: false,
+      kind: "render",
+      beat: opts.beatId ?? null,
+      code: "FFMPEG_MISSING",
+      error: "FFmpeg (ffmpeg/ffprobe) was not found on PATH; rendering needs it for audio mux and duration checks. Install it (macOS: `brew install ffmpeg`) and retry."
+    };
+  }
+  let autoSyncApplied = false;
+  let autoSyncWarning;
+  if (!opts.beatId && existsSync15(join14(projectDir, "STORYBOARD.md"))) {
+    try {
+      const rootPlan = await createProjectRootSyncPlan({ projectDir });
+      const subPlans = await createSubCompDurationSyncPlans({
+        projectDir,
+        beats: await loadProjectRootSyncBeats(projectDir)
+      });
+      if (rootPlan.changed || subPlans.some((plan) => plan.changed)) {
+        await executeSceneRepair({ projectDir });
+        autoSyncApplied = true;
+        autoSyncWarning = "Narration-synced durations drifted from the composed timeline; root and scene durations were re-synced before rendering (same pass as `vibe build --stage sync`).";
+      }
+    } catch (error) {
+      autoSyncWarning = `Narration drift check skipped: ${error instanceof Error ? error.message : String(error)}`;
+    }
+  }
   let root = opts.root ?? projectConfig.config.composition.entry;
   if (opts.beatId) {
     const prepared = await prepareBeatRenderRoot({
@@ -31949,7 +31993,9 @@ async function executeSceneRender(opts = {}) {
     format: config2.format,
     audioCount,
     audioMuxApplied,
-    audioMuxWarning
+    audioMuxWarning,
+    ...autoSyncApplied ? { autoSyncApplied } : {},
+    ...autoSyncWarning ? { autoSyncWarning } : {}
   };
   if (opts.revealInFinder) {
     try {
@@ -32209,6 +32255,10 @@ var init_scene_render = __esm({
   "src/commands/_shared/scene-render.ts"() {
     "use strict";
     init_chrome();
+    init_ffmpeg_gate();
+    init_root_sync();
+    init_sub_comp_duration_sync();
+    init_scene_repair();
     init_scene_lint();
     init_scene_audio_scan();
     init_scene_audio_mux();
@@ -33659,6 +33709,28 @@ async function executeSceneBuild(opts) {
     providerResolution: buildPlan.providerResolution,
     ...result
   });
+  if (shouldRunStage(selectedStage, "assets") || shouldRunStage(selectedStage, "sync")) {
+    if (!ffmpegToolsAvailable()) {
+      return finishBuildResult({
+        success: false,
+        phase: "failed",
+        mode,
+        selectedStage,
+        code: "FFMPEG_MISSING",
+        error: "ffprobe (part of FFmpeg) was not found on PATH. Narration-synced durations cannot be computed without it.",
+        message: "ffprobe not found on PATH.",
+        suggestion: "Install FFmpeg (macOS: `brew install ffmpeg`), then re-run the build.",
+        recoverable: true,
+        beats: [],
+        stageReports,
+        warnings,
+        retryWith,
+        status: "failed",
+        currentStage: "assets",
+        totalLatencyMs: Date.now() - startedAt
+      });
+    }
+  }
   if (!buildPlan.validation.ok) {
     let invalidBeats = [];
     if (existsSync19(storyboardPath)) {
@@ -35330,6 +35402,7 @@ var init_scene_build = __esm({
     import_dotenv3 = __toESM(require_main(), 1);
     init_dist2();
     init_audio();
+    init_ffmpeg_gate();
     init_concurrency();
     init_compose_scenes_skills();
     init_compose_prompts();
@@ -42510,10 +42583,10 @@ async function prompt2(question) {
     input,
     output: process.stdout
   });
-  return new Promise((resolve65) => {
+  return new Promise((resolve66) => {
     rl.question(question, (answer) => {
       rl.close();
-      resolve65(answer);
+      resolve66(answer);
     });
   });
 }
@@ -53467,10 +53540,13 @@ function mapRenderResultToToolResult(result, projectDir) {
       format: result.format,
       audioCount: result.audioCount,
       audioMuxApplied: result.audioMuxApplied,
-      audioMuxWarning: result.audioMuxWarning
+      audioMuxWarning: result.audioMuxWarning,
+      ...result.autoSyncApplied ? { autoSyncApplied: true } : {},
+      ...result.autoSyncWarning ? { autoSyncWarning: result.autoSyncWarning } : {}
     },
     humanLines: [
       `\u2705 Render complete: ${result.absoluteOutputPath ?? result.outputPath}`,
+      ...result.autoSyncApplied ? [`   auto-sync: narration-synced durations were re-applied before render`] : [],
       `   duration: ${((result.durationMs ?? 0) / 1e3).toFixed(1)}s`,
       `   frames:   ${result.framesRendered ?? "?"}${result.totalFrames ? ` / ${result.totalFrames}` : ""}`,
       `   config:   ${result.fps}fps \xB7 ${result.quality} \xB7 ${result.format}`,
@@ -59688,9 +59764,146 @@ var timelineTools = [
 ];
 
 // src/tools/manifest/project.ts
-import { resolve as resolve60 } from "node:path";
+import { resolve as resolve61 } from "node:path";
 import { writeFile as writeFile49 } from "node:fs/promises";
 init_engine();
+
+// src/commands/_shared/project-list.ts
+init_storyboard_parse();
+import { readdir as readdir6, readFile as readFile42, stat as stat7 } from "node:fs/promises";
+import { existsSync as existsSync46 } from "node:fs";
+import { join as join25, resolve as resolve60 } from "node:path";
+async function executeProjectList(opts = {}) {
+  const workspaceDir = resolve60(opts.workspaceDir ?? ".");
+  if (!existsSync46(workspaceDir)) {
+    return {
+      success: false,
+      workspaceDir,
+      projects: [],
+      archivedCount: 0,
+      error: `Workspace directory not found: ${workspaceDir}`
+    };
+  }
+  const entries = await readdir6(workspaceDir, { withFileTypes: true });
+  const projects = [];
+  let archivedCount = 0;
+  for (const entry of entries) {
+    if (!entry.isDirectory()) continue;
+    if (entry.name === "node_modules") continue;
+    if (entry.name.startsWith(".")) continue;
+    if (entry.name.startsWith("_")) {
+      archivedCount += await countProjects(join25(workspaceDir, entry.name));
+      continue;
+    }
+    const projectDir = join25(workspaceDir, entry.name);
+    if (!existsSync46(join25(projectDir, "STORYBOARD.md"))) continue;
+    projects.push(await describeProject(entry.name, projectDir));
+  }
+  projects.sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
+  return { success: true, workspaceDir, projects, archivedCount };
+}
+async function countProjects(dir) {
+  try {
+    const entries = await readdir6(dir, { withFileTypes: true });
+    return entries.filter(
+      (e) => e.isDirectory() && existsSync46(join25(dir, e.name, "STORYBOARD.md"))
+    ).length;
+  } catch {
+    return 0;
+  }
+}
+async function describeProject(name, projectDir) {
+  let beats = 0;
+  let storyboardDurationSec = 0;
+  const timestamps = [];
+  try {
+    const storyboardPath = join25(projectDir, "STORYBOARD.md");
+    const parsed = parseStoryboard(await readFile42(storyboardPath, "utf-8"));
+    beats = parsed.beats.length;
+    storyboardDurationSec = Number(
+      parsed.beats.reduce((sum, beat) => sum + (beat.duration ?? 0), 0).toFixed(2)
+    );
+    timestamps.push((await stat7(storyboardPath)).mtimeMs);
+  } catch {
+  }
+  let buildStatus;
+  let buildUpdatedAt;
+  try {
+    const reportPath = join25(projectDir, "build-report.json");
+    const report = JSON.parse(await readFile42(reportPath, "utf-8"));
+    buildStatus = report.status ?? report.phase;
+    buildUpdatedAt = report.updatedAt;
+    timestamps.push((await stat7(reportPath)).mtimeMs);
+  } catch {
+  }
+  let latestRender;
+  try {
+    const rendersDir = join25(projectDir, "renders");
+    const files = await readdir6(rendersDir);
+    let newest;
+    for (const file of files) {
+      if (!/\.(mp4|webm|mov)$/i.test(file)) continue;
+      const { mtimeMs } = await stat7(join25(rendersDir, file));
+      if (!newest || mtimeMs > newest.mtimeMs) newest = { file, mtimeMs };
+    }
+    if (newest) {
+      latestRender = { file: newest.file, modifiedAt: new Date(newest.mtimeMs).toISOString() };
+      timestamps.push(newest.mtimeMs);
+    }
+  } catch {
+  }
+  const updatedAt = new Date(
+    timestamps.length > 0 ? Math.max(...timestamps) : (await stat7(projectDir)).mtimeMs
+  ).toISOString();
+  return {
+    name,
+    path: projectDir,
+    beats,
+    storyboardDurationSec,
+    ...buildStatus ? { buildStatus } : {},
+    ...buildUpdatedAt ? { buildUpdatedAt } : {},
+    ...latestRender ? { latestRender } : {},
+    updatedAt
+  };
+}
+
+// src/tools/manifest/project.ts
+var projectListTool = defineTool({
+  name: "project_list",
+  category: "project",
+  cost: "free",
+  title: "List Video Projects",
+  annotations: { readOnly: true, openWorld: false },
+  description: `List every VibeFrame video project in the workspace (directories with a STORYBOARD.md), newest activity first: beat count, storyboard duration, last build status, and the latest render. Directories starting with '_' (e.g. _archive) are skipped and reported as an archived count \u2014 move a project into _archive/ to retire it. Use this to answer "what projects do I have?" before init/build/render.`,
+  schema: external_exports.object({
+    dir: external_exports.string().optional().describe(
+      "Workspace directory to scan. Defaults to the surface's cwd; in MCP hosts this is the configured server workspace."
+    )
+  }),
+  async execute(args, ctx) {
+    const result = await executeProjectList({
+      workspaceDir: args.dir ? resolve61(ctx.workingDirectory, args.dir) : ctx.workingDirectory
+    });
+    if (!result.success) {
+      return { success: false, error: result.error ?? "project list failed" };
+    }
+    return {
+      success: true,
+      data: {
+        workspaceDir: result.workspaceDir,
+        count: result.projects.length,
+        archivedCount: result.archivedCount,
+        projects: result.projects
+      },
+      humanLines: [
+        `\u{1F4C1} ${result.projects.length} project(s) in ${result.workspaceDir}` + (result.archivedCount > 0 ? ` (+${result.archivedCount} archived)` : ""),
+        ...result.projects.map(
+          (p) => `   \u2022 ${p.name} \u2014 ${p.beats} beat(s), ~${p.storyboardDurationSec}s` + (p.buildStatus ? `, build: ${p.buildStatus}` : "") + (p.latestRender ? `, latest render: ${p.latestRender.file}` : "") + ` (updated ${p.updatedAt})`
+        )
+      ]
+    };
+  }
+});
 var projectCreateTool = defineTool({
   name: "project_create",
   category: "project",
@@ -59706,7 +59919,7 @@ var projectCreateTool = defineTool({
     fps: external_exports.number().optional().describe("Frames per second (default: 30)")
   }),
   async execute(args, ctx) {
-    const outputPath = resolve60(ctx.workingDirectory, args.outputPath ?? `${args.name}.vibe.json`);
+    const outputPath = resolve61(ctx.workingDirectory, args.outputPath ?? `${args.name}.vibe.json`);
     const project = new Project(args.name);
     if (args.fps) project.setFrameRate(args.fps);
     await writeFile49(outputPath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
@@ -59747,12 +59960,13 @@ var projectInfoTool = defineTool({
   }
 });
 var projectTools = [
+  projectListTool,
   projectCreateTool,
   projectInfoTool
 ];
 
 // src/tools/manifest/export.ts
-import { resolve as resolve62 } from "node:path";
+import { resolve as resolve63 } from "node:path";
 
 // src/commands/export.ts
 init_esm();
@@ -59763,8 +59977,8 @@ init_exec_safe();
 init_output();
 init_validate();
 init_project_resolver();
-import { readFile as readFile42, access as access6 } from "node:fs/promises";
-import { resolve as resolve61, basename as basename17 } from "node:path";
+import { readFile as readFile43, access as access6 } from "node:fs/promises";
+import { resolve as resolve62, basename as basename17 } from "node:path";
 import { spawn } from "node:child_process";
 function timelineBaseName(path2) {
   const name = basename17(path2);
@@ -59840,7 +60054,7 @@ async function runExport(projectPath, outputPath, options = {}) {
       };
     }
     const filePath = await resolveTimelineFile(projectPath);
-    const content = await readFile42(filePath, "utf-8");
+    const content = await readFile43(filePath, "utf-8");
     const data = JSON.parse(content);
     const project = Project.fromJSON(data);
     const summary = project.getSummary();
@@ -59850,7 +60064,7 @@ async function runExport(projectPath, outputPath, options = {}) {
         message: "Project has no clips to export"
       };
     }
-    const finalOutputPath = resolve61(process.cwd(), outputPath);
+    const finalOutputPath = resolve62(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);
@@ -59964,7 +60178,7 @@ Run 'vibe schema export' for structured parameter info.`).action(async (projectP
     }
     spinner2.text = "Loading project...";
     const filePath = await resolveTimelineFile(projectPath);
-    const content = await readFile42(filePath, "utf-8");
+    const content = await readFile43(filePath, "utf-8");
     const data = JSON.parse(content);
     const project = Project.fromJSON(data);
     const summary = project.getSummary();
@@ -59972,7 +60186,7 @@ Run 'vibe schema export' for structured parameter info.`).action(async (projectP
       spinner2.fail("Project has no clips to export");
       exitWithError(usageError("Project has no clips to export"));
     }
-    const outputPath = options.output ? resolve61(process.cwd(), options.output) : resolve61(
+    const outputPath = options.output ? resolve62(process.cwd(), options.output) : resolve62(
       process.cwd(),
       `${timelineBaseName(projectPath)}.${options.format}`
     );
@@ -60402,7 +60616,7 @@ function buildFFmpegArgs(clips, sources, presetSettings, outputPath, options, so
   return args;
 }
 function runFFmpegProcess(ffmpegPath, args, onProgress) {
-  return new Promise((resolve65, reject) => {
+  return new Promise((resolve66, reject) => {
     const ffmpeg = spawn(ffmpegPath, args, {
       stdio: ["pipe", "pipe", "pipe"]
     });
@@ -60426,7 +60640,7 @@ function runFFmpegProcess(ffmpegPath, args, onProgress) {
     });
     ffmpeg.on("close", (code) => {
       if (code === 0) {
-        resolve65();
+        resolve66();
       } else {
         const errorMatch = stderr.match(/Error.*$/m);
         const errorMsg = errorMatch ? errorMatch[0] : `FFmpeg exited with code ${code}`;
@@ -60562,17 +60776,17 @@ function getPresetSettings(preset, aspectRatio2) {
 }
 async function runHyperframesExport(projectPath, options, spinner2, startedAt) {
   spinner2.text = "Loading project...";
-  const { readFile: readFile44 } = await import("node:fs/promises");
-  const { resolve: resolve65 } = await import("node:path");
+  const { readFile: readFile45 } = await import("node:fs/promises");
+  const { resolve: resolve66 } = await import("node:path");
   const { Project: Project2 } = await Promise.resolve().then(() => (init_engine(), engine_exports));
   const { createHyperframesBackend: createHyperframesBackend2 } = await Promise.resolve().then(() => (init_hyperframes(), hyperframes_exports));
   const { exitWithError: exitWithError2, generalError: generalError2, outputSuccess: outputSuccess2 } = await Promise.resolve().then(() => (init_output(), output_exports));
   const chalk2 = (await Promise.resolve().then(() => (init_source(), source_exports))).default;
   const filePath = await resolveTimelineFile(projectPath);
-  const content = await readFile44(filePath, "utf-8");
+  const content = await readFile45(filePath, "utf-8");
   const project = Project2.fromJSON(JSON.parse(content));
   const state = project.getState();
-  const outputPath = options.output ? resolve65(process.cwd(), options.output) : resolve65(process.cwd(), `${timelineBaseName(projectPath)}.${options.format ?? "mp4"}`);
+  const outputPath = options.output ? resolve66(process.cwd(), options.output) : resolve66(process.cwd(), `${timelineBaseName(projectPath)}.${options.format ?? "mp4"}`);
   const quality = ["draft", "standard", "high"].includes(options.preset ?? "") ? options.preset : "standard";
   const backend = createHyperframesBackend2();
   spinner2.text = "Rendering with Hyperframes...";
@@ -60620,8 +60834,8 @@ var exportVideoTool = defineTool({
     overwrite: external_exports.boolean().optional().describe("Overwrite existing output file (default: false)")
   }),
   async execute(args, ctx) {
-    const projectPath = resolve62(ctx.workingDirectory, args.projectPath);
-    const outputPath = resolve62(ctx.workingDirectory, args.outputPath);
+    const projectPath = resolve63(ctx.workingDirectory, args.projectPath);
+    const outputPath = resolve63(ctx.workingDirectory, args.outputPath);
     const result = await runExport(projectPath, outputPath, {
       preset: args.preset,
       format: args.format,
@@ -60638,8 +60852,8 @@ var exportVideoTool = defineTool({
 var exportTools = [exportVideoTool];
 
 // src/tools/manifest/agent-only.ts
-import { readFile as readFile43, writeFile as writeFile50, readdir as readdir6, stat as stat7, access as access7, unlink as unlink4 } from "node:fs/promises";
-import { resolve as resolve63, join as join25, basename as basename18, extname as extname12 } from "node:path";
+import { readFile as readFile44, writeFile as writeFile50, readdir as readdir7, stat as stat8, access as access7, unlink as unlink4 } from "node:fs/promises";
+import { resolve as resolve64, join as join26, basename as basename18, extname as extname12 } from "node:path";
 init_engine();
 init_exec_safe();
 init_project_resolver();
@@ -60712,13 +60926,13 @@ var fsListTool = defineTool({
   async execute(args, ctx) {
     const dirPath = args.path ?? ".";
     try {
-      const absPath = resolve63(ctx.workingDirectory, dirPath);
-      const entries = await readdir6(absPath, { withFileTypes: true });
+      const absPath = resolve64(ctx.workingDirectory, dirPath);
+      const entries = await readdir7(absPath, { withFileTypes: true });
       const results = [];
       for (const entry of entries) {
         if (args.pattern && !matchPattern(entry.name, args.pattern)) continue;
-        const fullPath = join25(absPath, entry.name);
-        const stats = await stat7(fullPath);
+        const fullPath = join26(absPath, entry.name);
+        const stats = await stat8(fullPath);
         if (entry.isDirectory()) {
           results.push(`[DIR]  ${entry.name}/`);
         } else {
@@ -60745,8 +60959,8 @@ var fsReadTool = defineTool({
   }),
   async execute(args, ctx) {
     try {
-      const absPath = resolve63(ctx.workingDirectory, args.path);
-      const content = await readFile43(absPath, "utf-8");
+      const absPath = resolve64(ctx.workingDirectory, args.path);
+      const content = await readFile44(absPath, "utf-8");
       const maxLength = 4e3;
       const truncated = content.length > maxLength;
       const output = truncated ? content.substring(0, maxLength) + "\n... (truncated)" : content;
@@ -60770,7 +60984,7 @@ var fsWriteTool = defineTool({
   }),
   async execute(args, ctx) {
     try {
-      const absPath = resolve63(ctx.workingDirectory, args.path);
+      const absPath = resolve64(ctx.workingDirectory, args.path);
       await writeFile50(absPath, args.content, "utf-8");
       return { success: true, data: { bytes: args.content.length }, humanLines: [`File written: ${args.path} (${formatSize(args.content.length)})`] };
     } catch (error) {
@@ -60790,10 +61004,10 @@ var fsExistsTool = defineTool({
     path: external_exports.string().describe("Path to check")
   }),
   async execute(args, ctx) {
-    const absPath = resolve63(ctx.workingDirectory, args.path);
+    const absPath = resolve64(ctx.workingDirectory, args.path);
     try {
       await access7(absPath);
-      const stats = await stat7(absPath);
+      const stats = await stat8(absPath);
       const type = stats.isDirectory() ? "directory" : "file";
       return { success: true, data: { exists: true, type }, humanLines: [`${type} exists: ${args.path}`] };
     } catch {
@@ -60818,19 +61032,19 @@ var batchImportTool = defineTool({
   }),
   async execute(args, ctx) {
     try {
-      const filePath = resolve63(ctx.workingDirectory, args.project);
-      const content = await readFile43(filePath, "utf-8");
+      const filePath = resolve64(ctx.workingDirectory, args.project);
+      const content = await readFile44(filePath, "utf-8");
       const data = JSON.parse(content);
       const project = Project.fromJSON(data);
-      const dirPath = resolve63(ctx.workingDirectory, args.directory);
+      const dirPath = resolve64(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;
       const mediaFiles = [];
       const scanDir = async (dir) => {
-        const entries = await readdir6(dir, { withFileTypes: true });
+        const entries = await readdir7(dir, { withFileTypes: true });
         for (const entry of entries) {
-          const entryPath = join25(dir, entry.name);
+          const entryPath = join26(dir, entry.name);
           if (entry.isDirectory() && recursive) {
             await scanDir(entryPath);
           } else if (entry.isFile()) {
@@ -60890,8 +61104,8 @@ var batchConcatTool = defineTool({
   }),
   async execute(args, ctx) {
     try {
-      const filePath = resolve63(ctx.workingDirectory, args.project);
-      const content = await readFile43(filePath, "utf-8");
+      const filePath = resolve64(ctx.workingDirectory, args.project);
+      const content = await readFile44(filePath, "utf-8");
       const data = JSON.parse(content);
       const project = Project.fromJSON(data);
       const sourceIds = args.sourceIds ?? [];
@@ -60961,8 +61175,8 @@ var batchApplyEffectTool = defineTool({
   }),
   async execute(args, ctx) {
     try {
-      const filePath = resolve63(ctx.workingDirectory, args.project);
-      const content = await readFile43(filePath, "utf-8");
+      const filePath = resolve64(ctx.workingDirectory, args.project);
+      const content = await readFile44(filePath, "utf-8");
       const data = JSON.parse(content);
       const project = Project.fromJSON(data);
       const clipIds = args.clipIds ?? [];
@@ -61017,7 +61231,7 @@ var timelineClearTool = defineTool({
   async execute(args, ctx) {
     try {
       const filePath = await resolveTimelineFile(args.project, ctx.workingDirectory);
-      const content = await readFile43(filePath, "utf-8");
+      const content = await readFile44(filePath, "utf-8");
       const data = JSON.parse(content);
       const project = Project.fromJSON(data);
       const what = args.what ?? "clips";
@@ -61094,7 +61308,7 @@ var projectSetTool = defineTool({
   async execute(args, ctx) {
     try {
       const filePath = await resolveTimelineFile(args.projectPath, ctx.workingDirectory);
-      const content = await readFile43(filePath, "utf-8");
+      const content = await readFile44(filePath, "utf-8");
       const data = JSON.parse(content);
       const project = Project.fromJSON(data);
       const updates = [];
@@ -61253,7 +61467,7 @@ var mediaInfoTool = defineTool({
   }),
   async execute(args, ctx) {
     try {
-      const absPath = resolve63(ctx.workingDirectory, args.path);
+      const absPath = resolve64(ctx.workingDirectory, args.path);
       const { stdout } = await execSafe(
         "ffprobe",
         ["-v", "quiet", "-print_format", "json", "-show_format", "-show_streams", absPath],
@@ -61342,10 +61556,10 @@ var mediaCompressTool = defineTool({
   }),
   async execute(args, ctx) {
     try {
-      const absInput = resolve63(ctx.workingDirectory, args.input);
+      const absInput = resolve64(ctx.workingDirectory, args.input);
       const ext = args.input.split(".").pop() || "mp4";
       const baseName = args.input.replace(/\.[^/.]+$/, "");
-      const outputPath = args.output ? resolve63(ctx.workingDirectory, args.output) : resolve63(ctx.workingDirectory, `${baseName}-compressed.${ext}`);
+      const outputPath = args.output ? resolve64(ctx.workingDirectory, args.output) : resolve64(ctx.workingDirectory, `${baseName}-compressed.${ext}`);
       const crfValues = { low: 28, medium: 23, high: 18 };
       const crf = crfValues[args.quality ?? "medium"];
       await execSafe(
@@ -61368,8 +61582,8 @@ var mediaCompressTool = defineTool({
         ],
         { maxBuffer: 50 * 1024 * 1024 }
       );
-      const inputBuf = await readFile43(absInput);
-      const outputBuf = await readFile43(outputPath);
+      const inputBuf = await readFile44(absInput);
+      const outputBuf = await readFile44(outputPath);
       const inputSize = inputBuf.length;
       const outputSize = outputBuf.length;
       const reduction = (inputSize - outputSize) / inputSize * 100;
@@ -61405,8 +61619,8 @@ var mediaConvertTool = defineTool({
   }),
   async execute(args, ctx) {
     try {
-      const absInput = resolve63(ctx.workingDirectory, args.input);
-      const absOutput = resolve63(ctx.workingDirectory, args.output);
+      const absInput = resolve64(ctx.workingDirectory, args.input);
+      const absOutput = resolve64(ctx.workingDirectory, args.output);
       const codecMap = {
         h264: "libx264",
         h265: "libx265",
@@ -61459,11 +61673,11 @@ var mediaConcatTool = defineTool({
       };
     }
     try {
-      const absOutput = resolve63(ctx.workingDirectory, args.output);
+      const absOutput = resolve64(ctx.workingDirectory, args.output);
       if (args.reencode) {
         const ffmpegArgs = [];
         for (const i of args.inputs) {
-          ffmpegArgs.push("-i", resolve63(ctx.workingDirectory, i));
+          ffmpegArgs.push("-i", resolve64(ctx.workingDirectory, i));
         }
         const filterComplex = args.inputs.map((_, i) => `[${i}:v][${i}:a]`).join("");
         ffmpegArgs.push(
@@ -61478,8 +61692,8 @@ var mediaConcatTool = defineTool({
         );
         await execSafe("ffmpeg", ffmpegArgs, { maxBuffer: 100 * 1024 * 1024 });
       } else {
-        const tempList = resolve63(ctx.workingDirectory, `concat-list-${Date.now()}.txt`);
-        const listContent = args.inputs.map((i) => `file '${resolve63(ctx.workingDirectory, i)}'`).join("\n");
+        const tempList = resolve64(ctx.workingDirectory, `concat-list-${Date.now()}.txt`);
+        const listContent = args.inputs.map((i) => `file '${resolve64(ctx.workingDirectory, i)}'`).join("\n");
         await writeFile50(tempList, listContent, "utf-8");
         try {
           await execSafe(
@@ -62010,7 +62224,7 @@ var guideTool = defineTool({
 var guideTools = [guideTool];
 
 // src/tools/manifest/status.ts
-import { resolve as resolve64 } from "node:path";
+import { resolve as resolve65 } from "node:path";
 init_status_jobs();
 var PROJECT_DIR_DESCRIPTION4 = "Project directory. Defaults to the surface's cwd; in MCP hosts, relative paths resolve under the configured server workspace.";
 var statusJobTool = defineTool({
@@ -62028,7 +62242,7 @@ var statusJobTool = defineTool({
     output: external_exports.string().optional().describe("Download result media to this path when complete.")
   }),
   async execute(args, ctx) {
-    const projectDir = args.projectDir ? resolve64(ctx.workingDirectory, args.projectDir) : findProjectRoot(ctx.workingDirectory);
+    const projectDir = args.projectDir ? resolve65(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, {
@@ -62037,7 +62251,7 @@ var statusJobTool = defineTool({
       warnings: []
     }) : await refreshJobRecord(record, {
       wait: args.wait,
-      output: args.output ? resolve64(ctx.workingDirectory, args.output) : void 0,
+      output: args.output ? resolve65(ctx.workingDirectory, args.output) : void 0,
       workingDirectory: ctx.workingDirectory
     });
     return {
@@ -62062,7 +62276,7 @@ var statusProjectTool = defineTool({
     refresh: external_exports.boolean().optional().describe("Refresh active supported jobs before summarizing. Default false.")
   }),
   async execute(args, ctx) {
-    const projectDir = args.projectDir ? resolve64(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
+    const projectDir = args.projectDir ? resolve65(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
     const result = await inspectProjectStatus(projectDir, { refresh: args.refresh === true });
     return {
       success: true,