@vibeframe/cli 0.113.9 → 0.113.11

package/dist/index.js

@@ -11631,15 +11631,15 @@ async function loadKokoroRuntime() {
 }
 async function loadKokoroFromWorkspace(baseDir = process.cwd()) {
   try {
-    const { readFile: readFile56 } = await import("node:fs/promises");
-    const { join: join30, resolve: resolve86 } = await import("node:path");
+    const { readFile: readFile57 } = await import("node:fs/promises");
+    const { join: join31, resolve: resolve86 } = await import("node:path");
     const { pathToFileURL } = await import("node:url");
     const pkgDir = resolve86(baseDir, "node_modules", "kokoro-js");
-    const pkg = JSON.parse(await readFile56(join30(pkgDir, "package.json"), "utf-8"));
+    const pkg = JSON.parse(await readFile57(join31(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(join30(pkgDir, entry)).href);
+    const mod = await import(pathToFileURL(join31(pkgDir, entry)).href);
     return mod.KokoroTTS ?? null;
   } catch {
     return null;
@@ -11650,20 +11650,20 @@ async function loadBundledKokoroRuntime(runtimeDir = process.env.VIBE_KOKORO_RUN
   if (!base)
     return null;
   try {
-    const { readFile: readFile56, writeFile: writeFile61, mkdir: mkdir31 } = await import("node:fs/promises");
-    const { join: join30, resolve: resolve86 } = await import("node:path");
+    const { readFile: readFile57, writeFile: writeFile61, mkdir: mkdir31 } = await import("node:fs/promises");
+    const { join: join31, resolve: resolve86 } = 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(join30(transformersDir, "dist", "transformers.web.js")).href);
-    const cacheRoot = join30(homedir8(), ".cache", "vibeframe", "models");
+    const transformers = await import(pathToFileURL(join31(transformersDir, "dist", "transformers.web.js")).href);
+    const cacheRoot = join31(homedir8(), ".cache", "vibeframe", "models");
     transformers.env.allowLocalModels = false;
     transformers.env.useCustomCache = true;
     transformers.env.customCache = {
       async match(key) {
         try {
-          return new Response(await readFile56(join30(cacheRoot, encodeURIComponent(String(key)))));
+          return new Response(await readFile57(join31(cacheRoot, encodeURIComponent(String(key)))));
         } catch {
           return void 0;
         }
@@ -11672,7 +11672,7 @@ async function loadBundledKokoroRuntime(runtimeDir = process.env.VIBE_KOKORO_RUN
         try {
           const buf = Buffer.from(await response.arrayBuffer());
           await mkdir31(cacheRoot, { recursive: true });
-          await writeFile61(join30(cacheRoot, encodeURIComponent(String(key))), buf);
+          await writeFile61(join31(cacheRoot, encodeURIComponent(String(key))), buf);
         } catch {
         }
       }
@@ -29972,10 +29972,57 @@ var init_composer_resolve = __esm({
   }
 });
 
+// src/commands/_shared/transcribe-narration.ts
+import { existsSync as existsSync7 } from "node:fs";
+import { readFile as readFile8 } from "node:fs/promises";
+import { join as join6 } from "node:path";
+async function transcribeNarrationWords(audioAbsPath, opts) {
+  try {
+    const whisper = new WhisperProvider();
+    await whisper.initialize({ apiKey: opts.apiKey });
+    const audioBytes = await readFile8(audioAbsPath);
+    const audioBlob = new Blob([new Uint8Array(audioBytes)]);
+    const transcript = await whisper.transcribe(audioBlob, void 0, {
+      granularity: "word",
+      language: opts.language
+    });
+    if (transcript.status === "completed" && transcript.words?.length) {
+      return transcript.words.map((w) => ({ text: w.text, start: w.start, end: w.end }));
+    }
+    return [];
+  } catch {
+    return [];
+  }
+}
+function beatTranscriptRelPath(beatId) {
+  return `assets/transcript-${beatId}.json`;
+}
+async function readBeatTranscript(projectDir, beatId) {
+  const abs = join6(projectDir, beatTranscriptRelPath(beatId));
+  if (!existsSync7(abs)) return void 0;
+  try {
+    const parsed = JSON.parse(await readFile8(abs, "utf-8"));
+    if (!Array.isArray(parsed)) return void 0;
+    const words = parsed.filter(
+      (w) => typeof w === "object" && w !== null && typeof w.text === "string" && Number.isFinite(w.start) && Number.isFinite(w.end)
+    ).map((w) => ({ text: w.text, start: w.start, end: w.end }));
+    return words.length > 0 ? words : void 0;
+  } catch {
+    return void 0;
+  }
+}
+var init_transcribe_narration = __esm({
+  "src/commands/_shared/transcribe-narration.ts"() {
+    "use strict";
+    init_dist2();
+  }
+});
+
 // src/commands/_shared/compose-scenes-skills.ts
 var compose_scenes_skills_exports = {};
 __export(compose_scenes_skills_exports, {
   ComposeBeatError: () => ComposeBeatError,
+  TRANSCRIPT_PROMPT_MAX_WORDS: () => TRANSCRIPT_PROMPT_MAX_WORDS,
   buildSystemPrompt: () => buildSystemPrompt,
   buildUserPrompt: () => buildUserPrompt,
   composeBeatHtml: () => composeBeatHtml,
@@ -29985,15 +30032,16 @@ __export(compose_scenes_skills_exports, {
   executeComposeScenesWithSkills: () => executeComposeScenesWithSkills,
   extractHtml: () => extractHtml,
   formatLintFeedback: () => formatLintFeedback,
+  formatTranscriptSection: () => formatTranscriptSection,
   lintBeatHtml: () => lintBeatHtml
 });
 import Anthropic from "@anthropic-ai/sdk";
 import OpenAI from "openai";
 import { GoogleGenerativeAI } from "@google/generative-ai";
 import { createHash as createHash2 } from "node:crypto";
-import { existsSync as existsSync7, mkdirSync } from "node:fs";
-import { mkdir as mkdir5, readFile as readFile8, writeFile as writeFile8 } from "node:fs/promises";
-import { dirname as dirname3, join as join6, resolve as resolve11 } from "node:path";
+import { existsSync as existsSync8, mkdirSync } from "node:fs";
+import { mkdir as mkdir5, readFile as readFile9, writeFile as writeFile8 } from "node:fs/promises";
+import { dirname as dirname3, join as join7, resolve as resolve11 } from "node:path";
 import { runHyperframeLint as runHyperframeLint2 } from "@hyperframes/producer";
 function buildSystemPrompt(ctx) {
   return `You are a Hyperframes composition author. The skill content below
@@ -30027,6 +30075,46 @@ function formatBeatCues(cues) {
   }
   return lines.join("\n") + "\n";
 }
+function formatTranscriptSection(transcript, maxWords = TRANSCRIPT_PROMPT_MAX_WORDS) {
+  if (!transcript || transcript.length === 0) return "";
+  const round = (n) => Number(Math.max(0, n).toFixed(2));
+  const noAudioRule = "This is for VISUAL sync only \u2014 do NOT add an `<audio>` tag or invent SFX; the narration audio is wired separately by the root timeline. If this beat is visual-only (no on-screen text), you may ignore these timings.";
+  if (transcript.length <= maxWords) {
+    const pairs = transcript.map((w) => `[${round(w.start)}, ${JSON.stringify(w.text)}]`).join(", ");
+    return `
+
+=== Narration word timings (seconds) ===
+
+Whisper word-level start times for this beat's narration. If you author captions
+or kinetic typography, reveal each word at its start time with absolute-time
+GSAP tweens, e.g.
+\`tl.fromTo('.caption .word[data-i="0"]', { opacity: 0, y: 10 }, { opacity: 1, y: 0, duration: 0.18 }, ${round(
+      transcript[0].start
+    )});\`
+${noAudioRule}
+
+word starts (word-level): ${pairs}`;
+  }
+  const phraseCount = Math.max(1, Math.floor(maxWords / 2));
+  const chunkSize = Math.ceil(transcript.length / phraseCount);
+  const anchors = [];
+  for (let i = 0; i < transcript.length; i += chunkSize) {
+    const chunk = transcript.slice(i, i + chunkSize);
+    const text = chunk.map((w) => w.text).join(" ");
+    anchors.push(`[${round(chunk[0].start)}, ${JSON.stringify(text)}]`);
+  }
+  return `
+
+=== Narration timings (approximate, phrase-level) ===
+
+This beat's narration is long (${transcript.length} words), so timings are
+grouped into phrase-level anchors (start time of each phrase). Use them to PACE
+caption / kinetic-type reveals across the beat \u2014 they are approximate, not
+per-word truth.
+${noAudioRule}
+
+phrase starts (approximate): ${anchors.join(", ")}`;
+}
 function buildUserPrompt(ctx) {
   const compositionId = `scene-${ctx.beat.id}`;
   const durLiteral = ctx.finalDurationSec !== void 0 ? String(ctx.finalDurationSec) : void 0;
@@ -30117,6 +30205,13 @@ ${finalDurationBullet}
 - If the beat cues include \`narration\`, do not embed an \`<audio>\` tag in the
   scene fragment. The root timeline wires \`assets/narration-${ctx.beat.id}.wav\`
   or \`assets/narration-${ctx.beat.id}.mp3\` separately.
+- Do NOT invent sound effects. This scene fragment is visual-only: never add
+  an \`<audio>\` tag, and never imply ambient/foley SFX (keyboard clicks, whoosh,
+  applause, room tone) that the beat did not explicitly request. Audio comes
+  only from the beat's explicit \`narration\` and \`music\` cues, wired by the
+  root timeline. If the beat declares an explicit \`sfx\` cue, treat it as intent
+  for the storyboard author \u2014 still do not embed it here \u2014 and only when it is
+  clearly tied to the beat's narration/motion; ignore orphaned or generic SFX.
 - **\`.clip\` elements get visibility control from the framework but NO
   sizing.** Always give \`.clip\` explicit fill via CSS:
   \`{ position: absolute; inset: 0; }\` (or equivalent
@@ -30182,7 +30277,7 @@ ${ctx.storyboardGlobal || "(no global direction)"}
 
 ## ${ctx.beat.heading}
 ${formatBeatCues(ctx.beat.cues)}${cueDurationNote}
-${ctx.beat.body}
+${ctx.beat.body}${formatTranscriptSection(ctx.transcript)}
 
 === Output format ===
 
@@ -30202,7 +30297,7 @@ function computeCacheKey(parts) {
   return createHash2("sha256").update(parts.provider).update("\u241E").update(parts.model).update("\u241E").update(parts.systemPrompt).update("\u241E").update(parts.userPrompt).digest("hex");
 }
 function defaultCacheDir() {
-  return join6(USER_CACHE_DIR, "compose-scenes");
+  return join7(USER_CACHE_DIR, "compose-scenes");
 }
 function extractHtml(responseText) {
   const fenced = responseText.match(/```html\s*\n([\s\S]*?)\n```/);
@@ -30226,9 +30321,9 @@ async function composeBeatHtml(ctx, overrides) {
     model: settings.model
   });
   const cacheDir = ctx.cacheDir ?? defaultCacheDir();
-  const cachePath = join6(cacheDir, `${cacheKey}.html`);
-  if (existsSync7(cachePath)) {
-    const html2 = await readFile8(cachePath, "utf-8");
+  const cachePath = join7(cacheDir, `${cacheKey}.html`);
+  if (existsSync8(cachePath)) {
+    const html2 = await readFile9(cachePath, "utf-8");
     return { html: html2, cached: true, cacheKey, model: settings.model, provider: ctx.provider };
   }
   if (!ctx.apiKey) {
@@ -30364,14 +30459,14 @@ async function executeComposeScenesWithSkills(params, outputDir, overrides) {
   const projectRoot = params.project ? resolve11(outputDir, params.project) : resolve11(outputDir);
   const designPath = resolve11(projectRoot, params.design ?? "DESIGN.md");
   const storyboardPath2 = resolve11(projectRoot, params.storyboard ?? "STORYBOARD.md");
-  if (!existsSync7(designPath)) {
+  if (!existsSync8(designPath)) {
     return { success: false, error: `DESIGN.md not found at ${designPath}` };
   }
-  if (!existsSync7(storyboardPath2)) {
+  if (!existsSync8(storyboardPath2)) {
     return { success: false, error: `STORYBOARD.md not found at ${storyboardPath2}` };
   }
-  const designMd = await readFile8(designPath, "utf-8");
-  const storyboardMd = await readFile8(storyboardPath2, "utf-8");
+  const designMd = await readFile9(designPath, "utf-8");
+  const storyboardMd = await readFile9(storyboardPath2, "utf-8");
   const { global: storyboardGlobal, beats } = parseStoryboard(storyboardMd);
   if (beats.length === 0) {
     return {
@@ -30391,7 +30486,7 @@ async function executeComposeScenesWithSkills(params, outputDir, overrides) {
     provider = params.composer ?? "claude";
     apiKey = "";
   }
-  const compositionsDir = join6(projectRoot, "compositions");
+  const compositionsDir = join7(projectRoot, "compositions");
   await mkdir5(compositionsDir, { recursive: true });
   let finalDurations = /* @__PURE__ */ new Map();
   try {
@@ -30405,6 +30500,7 @@ async function executeComposeScenesWithSkills(params, outputDir, overrides) {
     async (beat, beatIndex) => {
       onProgress({ type: "beat-start", beatId: beat.id, beatIndex, totalBeats });
       try {
+        const transcript = await readBeatTranscript(projectRoot, beat.id);
         const result = await composeBeatWithRetry(
           {
             beat,
@@ -30415,11 +30511,12 @@ async function executeComposeScenesWithSkills(params, outputDir, overrides) {
             apiKey,
             effort: params.effort,
             cacheDir: params.cacheDir,
-            finalDurationSec: finalDurations.get(beat.id)
+            finalDurationSec: finalDurations.get(beat.id),
+            transcript
           },
           overrides
         );
-        const compositionPath = join6(compositionsDir, `scene-${beat.id}.html`);
+        const compositionPath = join7(compositionsDir, `scene-${beat.id}.html`);
         await mkdir5(dirname3(compositionPath), { recursive: true });
         await writeFile8(compositionPath, result.html, "utf-8");
         if (result.cached) {
@@ -30498,7 +30595,7 @@ ${failures.map((f) => `  - ${f.beatId}: ${f.error}`).join("\n")}`,
     data: aggregateData
   };
 }
-var MODEL_SETTINGS_BY_PROVIDER, ComposeBeatError, defaultCallLLM, CONFIG_PROVIDER_BY_COMPOSER;
+var MODEL_SETTINGS_BY_PROVIDER, TRANSCRIPT_PROMPT_MAX_WORDS, ComposeBeatError, defaultCallLLM, CONFIG_PROVIDER_BY_COMPOSER;
 var init_compose_scenes_skills = __esm({
   "src/commands/_shared/compose-scenes-skills.ts"() {
     "use strict";
@@ -30510,6 +30607,7 @@ var init_compose_scenes_skills = __esm({
     init_root_sync();
     init_composer_resolve();
     init_config();
+    init_transcribe_narration();
     MODEL_SETTINGS_BY_PROVIDER = {
       // Anthropic Claude Sonnet 4.6 — v0.69 baseline. ~9 s/beat, $3/$15 per MTok.
       claude: {
@@ -30533,6 +30631,7 @@ var init_compose_scenes_skills = __esm({
         high: { model: GEMINI_DEFAULT_TEXT_MODEL, maxTokens: 8e3, costPerMTokIn: 1.5, costPerMTokOut: 9 }
       }
     };
+    TRANSCRIPT_PROMPT_MAX_WORDS = 120;
     ComposeBeatError = class extends Error {
       constructor(code, message, cause) {
         super(message);
@@ -30618,22 +30717,22 @@ var init_compose_scenes_skills = __esm({
 });
 
 // src/commands/_shared/compose-prompts.ts
-import { existsSync as existsSync8 } from "node:fs";
-import { readFile as readFile9 } from "node:fs/promises";
-import { join as join7, relative as relative4, resolve as resolve12 } from "node:path";
+import { existsSync as existsSync9 } from "node:fs";
+import { readFile as readFile10 } from "node:fs/promises";
+import { join as join8, relative as relative4, resolve as resolve12 } from "node:path";
 async function getComposePrompts(opts) {
   const projectDir = resolve12(opts.projectDir);
-  const designPath = join7(projectDir, "DESIGN.md");
-  const storyboardPath2 = join7(projectDir, "STORYBOARD.md");
-  const skillPath = join7(projectDir, "SKILL.md");
-  const compositionsDir = join7(projectDir, "compositions");
+  const designPath = join8(projectDir, "DESIGN.md");
+  const storyboardPath2 = join8(projectDir, "STORYBOARD.md");
+  const skillPath = join8(projectDir, "SKILL.md");
+  const compositionsDir = join8(projectDir, "compositions");
   const warnings = [];
   const baseError = (msg) => ({
     success: false,
     projectDir,
     designReference: "DESIGN.md",
     storyboardReference: "STORYBOARD.md",
-    skillReference: existsSync8(skillPath) ? "SKILL.md" : null,
+    skillReference: existsSync9(skillPath) ? "SKILL.md" : null,
     compositionsDir: "compositions",
     beats: [],
     instructions: [],
@@ -30641,18 +30740,18 @@ async function getComposePrompts(opts) {
     warnings,
     error: msg
   });
-  if (!existsSync8(designPath)) {
+  if (!existsSync9(designPath)) {
     return baseError(`DESIGN.md not found at ${designPath}. Run \`vibe scene init <dir>\` first.`);
   }
-  if (!existsSync8(storyboardPath2)) {
+  if (!existsSync9(storyboardPath2)) {
     return baseError(`STORYBOARD.md not found at ${storyboardPath2}. Run \`vibe scene init <dir>\` to create a starter, or add STORYBOARD.md with per-beat cues.`);
   }
-  if (!existsSync8(skillPath)) {
+  if (!existsSync9(skillPath)) {
     warnings.push(
       "SKILL.md not installed \u2014 host agent won't have Hyperframes rules in context. Run `vibe scene install-skill` to install it."
     );
   }
-  const storyboardMd = await readFile9(storyboardPath2, "utf-8");
+  const storyboardMd = await readFile10(storyboardPath2, "utf-8");
   const parsed = parseStoryboard(storyboardMd);
   if (parsed.beats.length === 0) {
     return baseError(`STORYBOARD.md has no \`## Beat \u2026\` headings.`);
@@ -30674,28 +30773,33 @@ async function getComposePrompts(opts) {
     finalDurations = await resolveProjectBeatDurations(projectDir);
   } catch {
   }
-  const result = beats.map((beat) => {
-    const outputPathAbs = join7(compositionsDir, `scene-${beat.id}.html`);
-    const outputPathRel = relative4(projectDir, outputPathAbs);
-    const finalDurationSec = finalDurations.get(beat.id);
-    const userPrompt = buildUserPrompt({
-      beat,
-      storyboardGlobal: parsed.global,
-      finalDurationSec
-    });
-    return {
-      id: beat.id,
-      heading: beat.heading,
-      outputPath: outputPathRel,
-      duration: beat.duration,
-      finalDurationSec,
-      cues: beat.cues,
-      body: beat.body,
-      userPrompt,
-      exists: existsSync8(outputPathAbs)
-    };
-  });
-  const skillRef = existsSync8(skillPath) ? "SKILL.md" : null;
+  const result = await Promise.all(
+    beats.map(async (beat) => {
+      const outputPathAbs = join8(compositionsDir, `scene-${beat.id}.html`);
+      const outputPathRel = relative4(projectDir, outputPathAbs);
+      const finalDurationSec = finalDurations.get(beat.id);
+      const transcript = await readBeatTranscript(projectDir, beat.id);
+      const userPrompt = buildUserPrompt({
+        beat,
+        storyboardGlobal: parsed.global,
+        finalDurationSec,
+        transcript
+      });
+      return {
+        id: beat.id,
+        heading: beat.heading,
+        outputPath: outputPathRel,
+        duration: beat.duration,
+        finalDurationSec,
+        cues: beat.cues,
+        body: beat.body,
+        userPrompt,
+        transcriptPath: transcript ? beatTranscriptRelPath(beat.id) : void 0,
+        exists: existsSync9(outputPathAbs)
+      };
+    })
+  );
+  const skillRef = existsSync9(skillPath) ? "SKILL.md" : null;
   const instructions = buildInstructions({
     skillRef,
     beatCount: result.length,
@@ -30743,13 +30847,14 @@ var init_compose_prompts = __esm({
     init_compose_scenes_skills();
     init_root_sync();
     init_bundle();
+    init_transcribe_narration();
   }
 });
 
 // src/commands/_shared/scene-submit.ts
-import { existsSync as existsSync9 } from "node:fs";
-import { mkdir as mkdir6, readFile as readFile10, writeFile as writeFile9 } from "node:fs/promises";
-import { join as join8, resolve as resolve13 } from "node:path";
+import { existsSync as existsSync10 } from "node:fs";
+import { mkdir as mkdir6, readFile as readFile11, writeFile as writeFile9 } from "node:fs/promises";
+import { join as join9, resolve as resolve13 } from "node:path";
 async function executeSceneSubmit(opts) {
   const projectDir = resolve13(opts.projectDir);
   const beatId = opts.beatId.trim();
@@ -30763,15 +30868,15 @@ async function executeSceneSubmit(opts) {
     warnings: [],
     retryWith: []
   };
-  const storyboardPath2 = join8(projectDir, "STORYBOARD.md");
-  if (!existsSync9(storyboardPath2)) {
+  const storyboardPath2 = join9(projectDir, "STORYBOARD.md");
+  if (!existsSync10(storyboardPath2)) {
     return {
       ...base,
       success: false,
       error: `STORYBOARD.md not found at ${storyboardPath2}. Run \`vibe init <dir>\` first.`
     };
   }
-  const parsed = parseStoryboard(await readFile10(storyboardPath2, "utf-8"));
+  const parsed = parseStoryboard(await readFile11(storyboardPath2, "utf-8"));
   const beat = parsed.beats.find((b) => b.id === beatId);
   if (!beat) {
     const available = parsed.beats.map((b) => b.id).join(", ") || "(none)";
@@ -30841,8 +30946,8 @@ async function executeSceneSubmit(opts) {
   if (opts.validateOnly) {
     return { ...base, success: true };
   }
-  const absPath = join8(projectDir, scenePath);
-  await mkdir6(join8(projectDir, "compositions"), { recursive: true });
+  const absPath = join9(projectDir, scenePath);
+  await mkdir6(join9(projectDir, "compositions"), { recursive: true });
   await writeFile9(absPath, html.endsWith("\n") ? html : `${html}
 `, "utf-8");
   return {
@@ -30866,9 +30971,9 @@ var init_scene_submit = __esm({
 });
 
 // src/commands/_shared/sub-comp-duration-sync.ts
-import { existsSync as existsSync10 } from "node:fs";
-import { readFile as readFile11 } from "node:fs/promises";
-import { join as join9, resolve as resolve14 } from "node:path";
+import { existsSync as existsSync11 } from "node:fs";
+import { readFile as readFile12 } from "node:fs/promises";
+import { join as join10, resolve as resolve14 } from "node:path";
 function syncSubCompositionDurationHtml(html, beatId, newDurationSec, fileRel) {
   const compositionId = `scene-${beatId}`;
   const file = fileRel ?? `compositions/${compositionId}.html`;
@@ -30960,15 +31065,15 @@ async function createSubCompDurationSyncPlans(opts) {
   const results = [];
   for (const beat of opts.beats) {
     const fileRel = `compositions/scene-${beat.id}.html`;
-    const filePath = join9(projectDir, fileRel);
-    if (!existsSync10(filePath)) continue;
+    const filePath = join10(projectDir, fileRel);
+    if (!existsSync11(filePath)) continue;
     const newDurationSec = await resolveSyncedBeatDuration({
       projectDir,
       beatDuration: beat.duration,
       narrationPath: beat.narrationPath,
       sceneDurationSec: beat.sceneDurationSec
     });
-    const html = await readFile11(filePath, "utf-8");
+    const html = await readFile12(filePath, "utf-8");
     const outcome = syncSubCompositionDurationHtml(html, beat.id, newDurationSec, fileRel);
     results.push({ ...outcome, file: fileRel, beatId: beat.id });
   }
@@ -30993,7 +31098,7 @@ var init_sub_comp_duration_sync = __esm({
 
 // src/commands/_shared/review-report.ts
 import { writeFile as writeFile10 } from "node:fs/promises";
-import { join as join10, resolve as resolve15 } from "node:path";
+import { join as join11, resolve as resolve15 } from "node:path";
 function statusFromIssues(issues) {
   if (issues.some((issue) => issue.severity === "error")) return "fail";
   if (issues.some((issue) => issue.severity === "warning")) return "warn";
@@ -31171,7 +31276,7 @@ function buildReviewReport(opts) {
   });
 }
 function defaultReviewReportPath(projectDir) {
-  return join10(resolve15(projectDir), "review-report.json");
+  return join11(resolve15(projectDir), "review-report.json");
 }
 async function writeReviewReport(path2, report) {
   await writeFile10(path2, JSON.stringify(report, null, 2) + "\n", "utf-8");
@@ -31486,7 +31591,7 @@ var init_review_report = __esm({
 });
 
 // src/commands/_shared/scene-repair.ts
-import { readFile as readFile12, writeFile as writeFile11 } from "node:fs/promises";
+import { readFile as readFile13, writeFile as writeFile11 } from "node:fs/promises";
 import { relative as relative5, resolve as resolve16 } from "node:path";
 import { runHyperframeLint as runHyperframeLint3 } from "@hyperframes/producer";
 async function executeSceneRepair(opts) {
@@ -31532,7 +31637,7 @@ async function executeSceneRepair(opts) {
   }
   for (const target of targets) {
     const rel = relative5(projectDir, target.abs) || target.abs;
-    const html = await readFile12(target.abs, "utf-8");
+    const html = await readFile13(target.abs, "utf-8");
     const findings = lintHtml(html, rel, target.isSub);
     const { html: nextHtml, fixedCodes } = applyMechanicalFixes(html, findings);
     if (fixedCodes.length > 0) {
@@ -31905,8 +32010,8 @@ var init_storyboard_edit = __esm({
 
 // src/commands/scene.ts
 import { resolve as resolve17, relative as relative6, dirname as dirname4 } from "node:path";
-import { mkdir as mkdir7, readFile as readFile13, writeFile as writeFile12, access as access5, copyFile } from "node:fs/promises";
-import { existsSync as existsSync11 } from "node:fs";
+import { mkdir as mkdir7, readFile as readFile14, writeFile as writeFile12, access as access5, copyFile } from "node:fs/promises";
+import { existsSync as existsSync12 } from "node:fs";
 function validateDuration(value) {
   const n = parseFloat(value);
   if (!Number.isFinite(n) || n <= 0 || n > 3600) {
@@ -31970,8 +32075,8 @@ function readClipStart(rootHtml, beatId) {
 async function resolveNarrationText(value) {
   if (!value) return void 0;
   const looksLikePath = /\.[a-z]{2,4}$/i.test(value) || value.includes("/") || value.includes("\\");
-  if (looksLikePath && existsSync11(value)) {
-    return (await readFile13(value, "utf-8")).trim();
+  if (looksLikePath && existsSync12(value)) {
+    return (await readFile14(value, "utf-8")).trim();
   }
   return value.trim();
 }
@@ -32010,7 +32115,7 @@ async function executeSceneAdd(opts) {
   if (!opts.force && await pathExists2(scenePath)) {
     return errResult(`Scene already exists: ${sceneRel}. Re-run with --force to overwrite.`);
   }
-  const rootHtmlBefore = await readFile13(rootPath, "utf-8");
+  const rootHtmlBefore = await readFile14(rootPath, "utf-8");
   let dims = readRootDims(rootHtmlBefore);
   if (!dims) {
     const cfg2 = await loadVibeProjectConfig(projectDir);
@@ -32086,31 +32191,20 @@ async function executeSceneAdd(opts) {
       );
     } else {
       opts.onProgress?.("Transcribing narration (Whisper word-level)...");
-      try {
-        const whisper = new WhisperProvider();
-        await whisper.initialize({ apiKey: whisperKey });
-        const audioBytes = await readFile13(audioAbsPath);
-        const audioBlob = new Blob([new Uint8Array(audioBytes)]);
-        const transcript = await whisper.transcribe(audioBlob, void 0, {
-          granularity: "word",
-          language: opts.transcribeLanguage
-        });
-        if (transcript.status === "completed" && transcript.words?.length) {
-          transcriptRelPath = `assets/transcript-${id}.json`;
-          const transcriptAbs = resolve17(projectDir, transcriptRelPath);
-          await writeFile12(transcriptAbs, JSON.stringify(transcript.words, null, 2), "utf-8");
-          transcriptWordCount = transcript.words.length;
-          transcriptWords = transcript.words.map((w) => ({
-            text: w.text,
-            start: w.start,
-            end: w.end
-          }));
-        } else if (transcript.status === "failed") {
-          opts.onProgress?.(`Transcribe failed: ${transcript.error ?? "unknown error"}`);
-        }
-      } catch (error) {
-        const msg = error instanceof Error ? error.message : String(error);
-        opts.onProgress?.(`Transcribe failed: ${msg}`);
+      const words = await transcribeNarrationWords(audioAbsPath, {
+        apiKey: whisperKey,
+        language: opts.transcribeLanguage
+      });
+      if (words.length > 0) {
+        transcriptRelPath = beatTranscriptRelPath(id);
+        const transcriptAbs = resolve17(projectDir, transcriptRelPath);
+        await writeFile12(transcriptAbs, JSON.stringify(words, null, 2), "utf-8");
+        transcriptWordCount = words.length;
+        transcriptWords = words;
+      } else {
+        opts.onProgress?.(
+          "Transcribe produced no word timings \u2014 narration plays without word-sync"
+        );
       }
     }
   }
@@ -32219,7 +32313,7 @@ async function executeSceneAdd(opts) {
   const shouldSyncStoryboard = opts.syncStoryboard !== false && await pathExists2(storyboardAbsPath);
   if (shouldSyncStoryboard) {
     opts.onProgress?.("Syncing STORYBOARD.md...");
-    const before = await readFile13(storyboardAbsPath, "utf-8");
+    const before = await readFile14(storyboardAbsPath, "utf-8");
     const synced = upsertStoryboardBeat(before, {
       beatId: id,
       title: opts.headline,
@@ -32261,7 +32355,7 @@ async function executeSceneAdd(opts) {
     });
     const blockingIssue = syncPlan.issues.find((issue) => issue.severity === "error");
     if (blockingIssue) return errResult(blockingIssue.message);
-    const rootHtmlAfterSync = await readFile13(rootPath, "utf-8");
+    const rootHtmlAfterSync = await readFile14(rootPath, "utf-8");
     start = readClipStart(rootHtmlAfterSync, id) ?? 0;
   } else {
     start = nextSceneStart(rootHtmlBefore, SCENE_OVERLAP_SECONDS);
@@ -32293,7 +32387,7 @@ async function resolveSceneRepairTarget(rootArg = "index.html", projectArg = "."
   const root = rootArg || "index.html";
   const project = projectArg || ".";
   const defaultProject = project === ".";
-  if (defaultProject && root !== "index.html" && !root.toLowerCase().endsWith(".html") && existsSync11(resolve17(root, "index.html"))) {
+  if (defaultProject && root !== "index.html" && !root.toLowerCase().endsWith(".html") && existsSync12(resolve17(root, "index.html"))) {
     return { projectDir: resolve17(root), rootRel: "index.html" };
   }
   return { projectDir: resolve17(project), rootRel: root };
@@ -32324,6 +32418,7 @@ var init_scene = __esm({
     init_agent_host_detect();
     init_install_skill();
     init_compose_prompts();
+    init_transcribe_narration();
     init_scene_submit();
     init_scene_repair();
     init_root_sync();
@@ -32493,7 +32588,7 @@ Run 'vibe schema scene.<command>' for structured parameter info.`
         }
         html = Buffer.concat(chunks).toString("utf-8");
       } else if (options.file) {
-        html = await readFile13(resolve17(String(options.file)), "utf-8");
+        html = await readFile14(resolve17(String(options.file)), "utf-8");
       } else {
         exitWithError(
           usageError(
@@ -32947,8 +33042,8 @@ __export(remotion_exports, {
   wrapComponentWithVideo: () => wrapComponentWithVideo
 });
 import { writeFile as writeFile14, mkdir as mkdir8, rm, copyFile as copyFile2 } from "node:fs/promises";
-import { existsSync as existsSync13 } from "node:fs";
-import { join as join11 } from "node:path";
+import { existsSync as existsSync14 } from "node:fs";
+import { join as join12 } from "node:path";
 import { tmpdir } from "node:os";
 import { createHash as createHash3 } from "node:crypto";
 async function ensureRemotionInstalled() {
@@ -32967,7 +33062,7 @@ async function ensureRemotionInstalled() {
   }
 }
 async function scaffoldRemotionProject(componentCode, componentName, opts) {
-  const dir = join11(tmpdir(), `vibe_motion_${Date.now()}`);
+  const dir = join12(tmpdir(), `vibe_motion_${Date.now()}`);
   await mkdir8(dir, { recursive: true });
   const deps = {
     remotion: REMOTION_VERSION,
@@ -32986,7 +33081,7 @@ async function scaffoldRemotionProject(componentCode, componentName, opts) {
     dependencies: deps
   };
   const packageJsonStr = JSON.stringify(packageJson, null, 2);
-  await writeFile14(join11(dir, "package.json"), packageJsonStr);
+  await writeFile14(join12(dir, "package.json"), packageJsonStr);
   const tsconfig = {
     compilerOptions: {
       target: "ES2020",
@@ -32998,8 +33093,8 @@ async function scaffoldRemotionProject(componentCode, componentName, opts) {
       skipLibCheck: true
     }
   };
-  await writeFile14(join11(dir, "tsconfig.json"), JSON.stringify(tsconfig, null, 2));
-  await writeFile14(join11(dir, "Component.tsx"), componentCode);
+  await writeFile14(join12(dir, "tsconfig.json"), JSON.stringify(tsconfig, null, 2));
+  await writeFile14(join12(dir, "Component.tsx"), componentCode);
   const rootCode = `import { registerRoot, Composition } from "remotion";
 import { ${componentName} } from "./Component";
 
@@ -33018,14 +33113,14 @@ const Root = () => {
 
 registerRoot(Root);
 `;
-  await writeFile14(join11(dir, "Root.tsx"), rootCode);
+  await writeFile14(join12(dir, "Root.tsx"), rootCode);
   const depsHash = createHash3("md5").update(packageJsonStr).digest("hex").slice(0, 12);
-  const cacheMarker = join11(REMOTION_CACHE_DIR, `.deps-${depsHash}`);
-  const cachedModules = join11(REMOTION_CACHE_DIR, "node_modules");
-  if (existsSync13(cacheMarker) && existsSync13(cachedModules)) {
+  const cacheMarker = join12(REMOTION_CACHE_DIR, `.deps-${depsHash}`);
+  const cachedModules = join12(REMOTION_CACHE_DIR, "node_modules");
+  if (existsSync14(cacheMarker) && existsSync14(cachedModules)) {
     const { symlink } = await import("node:fs/promises");
     try {
-      await symlink(cachedModules, join11(dir, "node_modules"), "dir");
+      await symlink(cachedModules, join12(dir, "node_modules"), "dir");
     } catch {
       await this_npmInstall(dir);
     }
@@ -33033,12 +33128,12 @@ registerRoot(Root);
     await this_npmInstall(dir);
     try {
       await mkdir8(REMOTION_CACHE_DIR, { recursive: true });
-      await writeFile14(join11(REMOTION_CACHE_DIR, "package.json"), packageJsonStr);
-      if (existsSync13(join11(dir, "node_modules"))) {
+      await writeFile14(join12(REMOTION_CACHE_DIR, "package.json"), packageJsonStr);
+      if (existsSync14(join12(dir, "node_modules"))) {
         const { rename: rename5, symlink } = await import("node:fs/promises");
-        await rename5(join11(dir, "node_modules"), cachedModules).catch(() => {
+        await rename5(join12(dir, "node_modules"), cachedModules).catch(() => {
         });
-        await symlink(cachedModules, join11(dir, "node_modules"), "dir").catch(() => {
+        await symlink(cachedModules, join12(dir, "node_modules"), "dir").catch(() => {
         });
         await writeFile14(cacheMarker, depsHash);
       }
@@ -33075,7 +33170,7 @@ async function renderMotion(options) {
     }
   );
   try {
-    const entryPoint = join11(dir, "Root.tsx");
+    const entryPoint = join12(dir, "Root.tsx");
     const { execFile: execFile3 } = await import("node:child_process");
     const { promisify: promisify3 } = await import("node:util");
     const execFileAsync3 = promisify3(execFile3);
@@ -33208,10 +33303,10 @@ async function renderWithEmbeddedImage(options) {
     }
   );
   try {
-    const publicDir = join11(dir, "public");
+    const publicDir = join12(dir, "public");
     await mkdir8(publicDir, { recursive: true });
-    await copyFile2(options.imagePath, join11(publicDir, options.imageFileName));
-    const entryPoint = join11(dir, "Root.tsx");
+    await copyFile2(options.imagePath, join12(publicDir, options.imageFileName));
+    const entryPoint = join12(dir, "Root.tsx");
     const mp4Out = options.outputPath.replace(/\.\w+$/, ".mp4");
     const { execFile: execFileImg } = await import("node:child_process");
     const { promisify: promisifyImg } = await import("node:util");
@@ -33272,10 +33367,10 @@ async function renderWithEmbeddedVideo(options) {
     }
   );
   try {
-    const publicDir = join11(dir, "public");
+    const publicDir = join12(dir, "public");
     await mkdir8(publicDir, { recursive: true });
-    await copyFile2(options.videoPath, join11(publicDir, options.videoFileName));
-    const entryPoint = join11(dir, "Root.tsx");
+    await copyFile2(options.videoPath, join12(publicDir, options.videoFileName));
+    const entryPoint = join12(dir, "Root.tsx");
     const mp4VideoOnly = options.outputPath.replace(/\.\w+$/, "_video_only.mp4");
     const { execFile: execFileVid } = await import("node:child_process");
     const { promisify: promisifyVid } = await import("node:util");
@@ -33691,7 +33786,7 @@ var init_remotion = __esm({
     "use strict";
     init_exec_safe();
     REMOTION_VERSION = "4.0.447";
-    REMOTION_CACHE_DIR = join11(tmpdir(), "vibe_remotion_cache");
+    REMOTION_CACHE_DIR = join12(tmpdir(), "vibe_remotion_cache");
   }
 });
 
@@ -33702,8 +33797,8 @@ __export(ai_motion_exports, {
   registerMotionCommand: () => registerMotionCommand
 });
 import { resolve as resolve19 } from "node:path";
-import { existsSync as existsSync14 } from "node:fs";
-import { readFile as readFile15, writeFile as writeFile15 } from "node:fs/promises";
+import { existsSync as existsSync15 } from "node:fs";
+import { readFile as readFile16, writeFile as writeFile15 } from "node:fs/promises";
 async function getOptionalGoogleApiKey() {
   const configKey = await getApiKeyFromConfig("google");
   if (configKey) return configKey;
@@ -33750,7 +33845,7 @@ async function executeMotion(options) {
       };
     }
     const imagePath = resolve19(process.cwd(), options.image);
-    const imageBuffer = await readFile15(imagePath);
+    const imageBuffer = await readFile16(imagePath);
     const gemini = new GeminiProvider();
     await gemini.initialize({ apiKey: geminiApiKey });
     const analysisResult = await gemini.analyzeImage(
@@ -33787,7 +33882,7 @@ Use this image analysis to inform the color palette, typography placement, and o
     }
     if (geminiApiKey) {
       const videoPath = resolve19(process.cwd(), options.video);
-      const videoBuffer = await readFile15(videoPath);
+      const videoBuffer = await readFile16(videoPath);
       const gemini = new GeminiProvider();
       await gemini.initialize({ apiKey: geminiApiKey });
       const analysisPrompt = options.understandingPrompt || `Analyze this video for motion graphics composition. Return concise production guidance:
@@ -33818,10 +33913,10 @@ Use this video understanding to place motion graphics in safe zones, match the c
   let result;
   if (options.fromTsx) {
     const tsxPath = resolve19(process.cwd(), options.fromTsx);
-    if (!existsSync14(tsxPath)) {
+    if (!existsSync15(tsxPath)) {
       return { success: false, error: `TSX file not found: ${tsxPath}` };
     }
-    const existingCode = await readFile15(tsxPath, "utf-8");
+    const existingCode = await readFile16(tsxPath, "utf-8");
     if (useGemini) {
       const gemini = new GeminiProvider();
       await gemini.initialize({ apiKey });
@@ -34598,7 +34693,7 @@ var init_ai_helpers = __esm({
 
 // src/commands/generate/storyboard.ts
 import { resolve as resolve22 } from "node:path";
-import { readFile as readFile16, writeFile as writeFile18 } from "node:fs/promises";
+import { readFile as readFile17, writeFile as writeFile18 } from "node:fs/promises";
 async function executeStoryboard(options) {
   const { content, duration, creativity = "low", output, apiKey } = options;
   try {
@@ -34646,7 +34741,7 @@ function registerStoryboardCommand(parent) {
       let textContent = content;
       if (options.file) {
         const filePath = resolve22(process.cwd(), content);
-        textContent = await readFile16(filePath, "utf-8");
+        textContent = await readFile17(filePath, "utf-8");
       }
       if (options.dryRun) {
         outputSuccess({
@@ -35718,7 +35813,7 @@ __export(ai_video_exports, {
   executeVideoGenerate: () => executeVideoGenerate,
   executeVideoStatus: () => executeVideoStatus
 });
-import { readFile as readFile17, writeFile as writeFile21 } from "node:fs/promises";
+import { readFile as readFile18, writeFile as writeFile21 } from "node:fs/promises";
 import { resolve as resolve25 } from "node:path";
 async function executeVideoGenerate(options) {
   const {
@@ -35758,7 +35853,7 @@ async function executeVideoGenerate(options) {
     let referenceImageMimeType;
     if (image) {
       const imagePath = resolve25(process.cwd(), image);
-      const imageBuffer = await readFile17(imagePath);
+      const imageBuffer = await readFile18(imagePath);
       const ext = image.toLowerCase().split(".").pop();
       const mimeTypes2 = {
         jpg: "image/jpeg",
@@ -36006,7 +36101,7 @@ async function fileInputToUrlOrDataUri(input, fallbackMimeType) {
     return input;
   }
   const absPath = resolve25(process.cwd(), input);
-  const buffer = await readFile17(absPath);
+  const buffer = await readFile18(absPath);
   return `data:${mimeTypeForPath(input, fallbackMimeType)};base64,${buffer.toString("base64")}`;
 }
 function mimeTypeForPath(path2, fallback2) {
@@ -36258,15 +36353,15 @@ var init_ai_video = __esm({
 });
 
 // src/commands/_shared/build-asset-metadata.ts
-import { existsSync as existsSync15, readFileSync as readFileSync2 } from "node:fs";
+import { existsSync as existsSync16, readFileSync as readFileSync2 } from "node:fs";
 import { mkdir as mkdir10, writeFile as writeFile22 } from "node:fs/promises";
-import { dirname as dirname6, join as join12 } from "node:path";
+import { dirname as dirname6, join as join13 } from "node:path";
 function assetMetadataPath(kind, beatId) {
   return `.vibeframe/assets/${kind}-${beatId}.json`;
 }
 function readAssetMetadata(projectDir, kind, beatId) {
-  const path2 = join12(projectDir, assetMetadataPath(kind, beatId));
-  if (!existsSync15(path2)) return null;
+  const path2 = join13(projectDir, assetMetadataPath(kind, beatId));
+  if (!existsSync16(path2)) return null;
   try {
     const parsed = JSON.parse(readFileSync2(path2, "utf-8"));
     if (parsed.schemaVersion !== "1" || parsed.kind !== kind || parsed.beatId !== beatId || typeof parsed.cacheKey !== "string") {
@@ -36295,7 +36390,7 @@ function isFreshCanonicalAsset(opts) {
 }
 async function writeAssetMetadata(opts) {
   const rel = assetMetadataPath(opts.kind, opts.beatId);
-  const abs = join12(opts.projectDir, rel);
+  const abs = join13(opts.projectDir, rel);
   const metadata = {
     schemaVersion: "1",
     kind: opts.kind,
@@ -36319,20 +36414,20 @@ var init_build_asset_metadata = __esm({
 
 // src/commands/_shared/status-jobs.ts
 import { createHash as createHash5, randomUUID as randomUUID2 } from "node:crypto";
-import { existsSync as existsSync16, statSync as statSync2 } from "node:fs";
-import { copyFile as copyFile3, mkdir as mkdir11, readFile as readFile18, readdir as readdir2, stat as stat4, writeFile as writeFile23 } from "node:fs/promises";
-import { dirname as dirname7, join as join13, parse as parse2, relative as relative7, resolve as resolve26 } from "node:path";
+import { existsSync as existsSync17, statSync as statSync2 } from "node:fs";
+import { copyFile as copyFile3, mkdir as mkdir11, readFile as readFile19, readdir as readdir2, stat as stat4, writeFile as writeFile23 } from "node:fs/promises";
+import { dirname as dirname7, join as join14, parse as parse2, relative as relative7, resolve as resolve26 } from "node:path";
 function isLocalJob(record) {
   return record.jobType === "build" || record.jobType === "render";
 }
 function findProjectRoot(start = process.cwd()) {
   let dir = resolve26(start);
   try {
-    if (existsSync16(dir) && statSync2(dir).isFile()) dir = dirname7(dir);
+    if (existsSync17(dir) && statSync2(dir).isFile()) dir = dirname7(dir);
   } catch {
   }
   for (; ; ) {
-    if (existsSync16(join13(dir, "vibe.config.json")) || existsSync16(join13(dir, "STORYBOARD.md"))) {
+    if (existsSync17(join14(dir, "vibe.config.json")) || existsSync17(join14(dir, "STORYBOARD.md"))) {
       return dir;
     }
     const parent = dirname7(dir);
@@ -36341,7 +36436,7 @@ function findProjectRoot(start = process.cwd()) {
   }
 }
 function jobsDir(projectDir) {
-  return join13(resolve26(projectDir), ".vibeframe", "jobs");
+  return join14(resolve26(projectDir), ".vibeframe", "jobs");
 }
 function normalizeJobStatus(status) {
   const value = String(status ?? "").toLowerCase();
@@ -36413,18 +36508,18 @@ async function readJobRecord(jobId, projectDir) {
   const id = normalizeJobId(jobId);
   const project = resolve26(projectDir ?? findProjectRoot());
   const path2 = jobRecordPath(id, project);
-  if (!existsSync16(path2)) return null;
-  return parseJobRecord(await readFile18(path2, "utf-8"));
+  if (!existsSync17(path2)) return null;
+  return parseJobRecord(await readFile19(path2, "utf-8"));
 }
 async function listJobRecords(projectDir) {
   const dir = jobsDir(projectDir);
-  if (!existsSync16(dir)) return [];
+  if (!existsSync17(dir)) return [];
   const entries = await readdir2(dir, { withFileTypes: true });
   const records = [];
   for (const entry of entries) {
     if (!entry.isFile() || !entry.name.endsWith(".json")) continue;
     try {
-      const parsed = parseJobRecord(await readFile18(join13(dir, entry.name), "utf-8"));
+      const parsed = parseJobRecord(await readFile19(join14(dir, entry.name), "utf-8"));
       if (parsed) records.push(parsed);
     } catch {
     }
@@ -36518,7 +36613,7 @@ async function refreshLocalJobRecord(record, opts) {
     const heartbeatAge = record.heartbeatAt ? Date.now() - new Date(record.heartbeatAt).getTime() : Number.POSITIVE_INFINITY;
     const orphaned = !isPidAlive(record.pid) || heartbeatAge > LOCAL_JOB_ORPHAN_AFTER_MS;
     if (orphaned) {
-      const hint = `The process that ran this ${record.jobType} job is gone. Check ${join13(record.projectDir, record.jobType === "render" ? "render-report.json" : "build-report.json")} \u2014 the work may have completed before the process exited.`;
+      const hint = `The process that ran this ${record.jobType} job is gone. Check ${join14(record.projectDir, record.jobType === "render" ? "render-report.json" : "build-report.json")} \u2014 the work may have completed before the process exited.`;
       warnings.push(hint);
       updated = stripUndefined2({
         ...record,
@@ -36681,7 +36776,7 @@ function normalizeJobId(jobId) {
   return id;
 }
 function jobRecordPath(jobId, projectDir) {
-  return join13(jobsDir(projectDir), `${normalizeJobId(jobId)}.json`);
+  return join14(jobsDir(projectDir), `${normalizeJobId(jobId)}.json`);
 }
 function parseJobRecord(raw) {
   const parsed = JSON.parse(raw);
@@ -36748,7 +36843,7 @@ async function maybeCacheOutput(record) {
 }
 async function maybeWriteCompletedAssetMetadata(record) {
   const kind = assetKindForJob(record);
-  if (record.status !== "completed" || !kind || !record.beatId || !record.assetCue || !record.cacheKey || !record.outputPath || !existsSync16(record.outputPath)) {
+  if (record.status !== "completed" || !kind || !record.beatId || !record.assetCue || !record.cacheKey || !record.outputPath || !existsSync17(record.outputPath)) {
     return;
   }
   try {
@@ -36767,7 +36862,7 @@ async function maybeWriteCompletedAssetMetadata(record) {
   }
 }
 async function refreshBuildReportFromJobs(projectDir, records) {
-  const reportPath = join13(projectDir, "build-report.json");
+  const reportPath = join14(projectDir, "build-report.json");
   const report = await readJson(reportPath);
   if (!report || !Array.isArray(report.beats)) return;
   let changed = false;
@@ -36820,7 +36915,7 @@ async function refreshBuildReportFromJobs(projectDir, records) {
   }
 }
 async function readBuildSummary(projectDir) {
-  const reportPath = join13(projectDir, "build-report.json");
+  const reportPath = join14(projectDir, "build-report.json");
   const report = await readJson(reportPath);
   if (!report) return null;
   const info = await statOrNull(reportPath);
@@ -36843,7 +36938,7 @@ async function readBuildSummary(projectDir) {
   });
 }
 async function readReviewSummary(projectDir) {
-  const reportPath = join13(projectDir, "review-report.json");
+  const reportPath = join14(projectDir, "review-report.json");
   const report = await readJson(reportPath);
   if (!report) return null;
   const info = await statOrNull(reportPath);
@@ -36932,16 +37027,16 @@ async function readProjectBeatReadiness(projectDir, build, records) {
     if (fromBeats) return fromBeats;
     if (build.beats) return augmentBeatReadinessFromJobs(build.beats, records, report?.jobs);
   }
-  const storyboardPath2 = join13(projectDir, "STORYBOARD.md");
-  if (!existsSync16(storyboardPath2)) {
+  const storyboardPath2 = join14(projectDir, "STORYBOARD.md");
+  if (!existsSync17(storyboardPath2)) {
     return { total: 0, assetsReady: 0, compositionsReady: 0, needsAuthor: [] };
   }
   try {
-    const parsed = parseStoryboard(await readFile18(storyboardPath2, "utf-8"));
+    const parsed = parseStoryboard(await readFile19(storyboardPath2, "utf-8"));
     const needsAuthor = [];
     let compositionsReady = 0;
     for (const beat of parsed.beats) {
-      if (existsSync16(join13(projectDir, "compositions", `scene-${beat.id}.html`))) {
+      if (existsSync17(join14(projectDir, "compositions", `scene-${beat.id}.html`))) {
         compositionsReady += 1;
       } else {
         needsAuthor.push(beat.id);
@@ -36959,7 +37054,7 @@ async function readProjectBeatReadiness(projectDir, build, records) {
 }
 function deriveProjectWorkflow(opts) {
   const retryWith = [];
-  const hasStoryboard = existsSync16(join13(opts.project, "STORYBOARD.md"));
+  const hasStoryboard = existsSync17(join14(opts.project, "STORYBOARD.md"));
   if (!hasStoryboard && !opts.build) {
     retryWith.push(`vibe init ${opts.project} --from "<brief>" --json`);
     return { status: "empty", currentStage: "init", retryWith };
@@ -37055,7 +37150,7 @@ function beatReadinessFromBuildBeats(projectDir, beats, records = [], reportJobs
     if (buildBeatAssetsReady(record) || (id ? buildBeatJobsReady(id, records, reportJobs) : false))
       assetsReady += 1;
     const compositionPath = typeof record.compositionPath === "string" ? record.compositionPath : id ? `compositions/scene-${id}.html` : void 0;
-    if (compositionPath && existsSync16(resolve26(projectDir, compositionPath))) {
+    if (compositionPath && existsSync17(resolve26(projectDir, compositionPath))) {
       compositionsReady += 1;
     } else if (id) {
       needsAuthor.push(id);
@@ -37163,7 +37258,7 @@ function projectRelativePath(projectDir, path2) {
 }
 async function readJson(path2) {
   try {
-    return JSON.parse(await readFile18(path2, "utf-8"));
+    return JSON.parse(await readFile19(path2, "utf-8"));
   } catch {
     return null;
   }
@@ -37202,7 +37297,7 @@ var init_status_jobs = __esm({
 // src/commands/generate/music.ts
 import { resolve as resolve27 } from "node:path";
 import { writeFile as writeFile24 } from "node:fs/promises";
-import { existsSync as existsSync17 } from "node:fs";
+import { existsSync as existsSync18 } from "node:fs";
 async function executeMusic(options) {
   try {
     const provider = options.provider || "elevenlabs";
@@ -37355,7 +37450,7 @@ function registerMusicCommand(parent) {
         if (options.melody) {
           spinner2.text = "Uploading melody reference...";
           const absPath = resolve27(process.cwd(), options.melody);
-          if (!existsSync17(absPath)) {
+          if (!existsSync18(absPath)) {
             spinner2.fail(`Melody file not found: ${options.melody}`);
             exitWithError(notFoundError(options.melody));
           }
@@ -37476,8 +37571,8 @@ __export(ai_image_exports, {
   executeThumbnailBestFrame: () => executeThumbnailBestFrame
 });
 import { resolve as resolve28, dirname as dirname8 } from "node:path";
-import { readFile as readFile19, writeFile as writeFile25, mkdir as mkdir12 } from "node:fs/promises";
-import { existsSync as existsSync18 } from "node:fs";
+import { readFile as readFile20, writeFile as writeFile25, mkdir as mkdir12 } from "node:fs/promises";
+import { existsSync as existsSync19 } from "node:fs";
 async function executeImageGenerate(options) {
   const {
     prompt: prompt3,
@@ -37621,10 +37716,10 @@ async function executeGeminiEdit(options) {
     const imageBuffers = [];
     for (const imagePath of imagePaths) {
       const absPath = resolve28(process.cwd(), imagePath);
-      if (!existsSync18(absPath)) {
+      if (!existsSync19(absPath)) {
         return { success: false, error: `Image not found: ${absPath}` };
       }
-      const buffer = await readFile19(absPath);
+      const buffer = await readFile20(absPath);
       imageBuffers.push(buffer);
     }
     const gemini = new GeminiProvider();
@@ -37669,7 +37764,7 @@ async function executeThumbnailBestFrame(options) {
     model = "flash",
     apiKey
   } = options;
-  if (!existsSync18(videoPath)) {
+  if (!existsSync19(videoPath)) {
     return { success: false, error: `Video not found: ${videoPath}` };
   }
   if (!commandExists("ffmpeg")) {
@@ -37682,7 +37777,7 @@ async function executeThumbnailBestFrame(options) {
   try {
     const gemini = new GeminiProvider();
     await gemini.initialize({ apiKey: googleKey });
-    const videoData = await readFile19(videoPath);
+    const videoData = await readFile20(videoPath);
     const analysisPrompt = prompt3 || 'Analyze this video and find the single best frame for a thumbnail. Look for frames that are visually striking, well-composed, emotionally engaging, and representative of the video content. Avoid blurry frames, transitions, or dark scenes. Return ONLY a JSON object: {"timestamp": <seconds as number>, "reason": "<brief explanation>"}';
     const modelId = resolveGeminiTextModel(model);
     const result = await gemini.analyzeVideo(videoData, analysisPrompt, {
@@ -37703,7 +37798,7 @@ async function executeThumbnailBestFrame(options) {
       reason = reasonMatch[1];
     }
     await execSafe("ffmpeg", ["-ss", String(timestamp2), "-i", videoPath, "-frames:v", "1", "-q:v", "2", outputPath, "-y"], { timeout: 6e4, maxBuffer: 50 * 1024 * 1024 });
-    if (!existsSync18(outputPath)) {
+    if (!existsSync19(outputPath)) {
       return { success: false, error: "FFmpeg failed to extract frame" };
     }
     return {
@@ -37729,7 +37824,7 @@ var init_ai_image = __esm({
 
 // src/commands/generate/thumbnail.ts
 import { resolve as resolve29, dirname as dirname9, basename as basename5, extname as extname3 } from "node:path";
-import { existsSync as existsSync19 } from "node:fs";
+import { existsSync as existsSync20 } from "node:fs";
 import { writeFile as writeFile26, mkdir as mkdir13 } from "node:fs/promises";
 function registerThumbnailCommand(parent) {
   parent.command("thumbnail").description("Generate video thumbnail (DALL-E) or extract best frame from video (Gemini)").argument("[description]", "Thumbnail description (for DALL-E generation)").option("-k, --api-key <key>", "API key (OpenAI for generation, Google for best-frame)").option("-o, --output <path>", "Output file path").option("--style <style>", "Platform style: youtube, instagram, tiktok, twitter").option("--best-frame <video>", "Extract best thumbnail frame from video using Gemini AI").option("--prompt <prompt>", "Custom prompt for best-frame analysis").option("--model <model>", `Gemini model: ${GEMINI_TEXT_MODEL_HELP}`, "flash").action(async (description, options) => {
@@ -37741,7 +37836,7 @@ function registerThumbnailCommand(parent) {
       }
       if (options.bestFrame) {
         const absVideoPath = resolve29(process.cwd(), options.bestFrame);
-        if (!existsSync19(absVideoPath)) {
+        if (!existsSync20(absVideoPath)) {
           exitWithError(notFoundError(absVideoPath));
         }
         if (!commandExists("ffmpeg")) {
@@ -39925,7 +40020,7 @@ var init_dist3 = __esm({
 
 // src/commands/generate/video.ts
 import { resolve as resolve33 } from "node:path";
-import { readFile as readFile20, writeFile as writeFile30 } from "node:fs/promises";
+import { readFile as readFile21, writeFile as writeFile30 } from "node:fs/promises";
 function registerVideoCommand(parent) {
   parent.command("video").alias("vid").description("Generate video using AI (Seedance, Grok, Kling, Runway, or Veo)").argument("[prompt]", "Text prompt describing the video (interactive if omitted)").option(
     "-p, --provider <provider>",
@@ -40036,7 +40131,7 @@ Examples:
       let isImageToVideo = false;
       if (options.image) {
         const imagePath = resolve33(process.cwd(), options.image);
-        const imageBuffer = await readFile20(imagePath);
+        const imageBuffer = await readFile21(imagePath);
         const ext = options.image.toLowerCase().split(".").pop();
         const mimeTypes2 = {
           jpg: "image/jpeg",
@@ -40276,7 +40371,7 @@ Examples:
         let lastFrame;
         if (options.lastFrame) {
           const lastFramePath = resolve33(process.cwd(), options.lastFrame);
-          const lastFrameBuffer = await readFile20(lastFramePath);
+          const lastFrameBuffer = await readFile21(lastFramePath);
           const ext = options.lastFrame.toLowerCase().split(".").pop();
           const mimeType = ext === "jpg" || ext === "jpeg" ? "image/jpeg" : `image/${ext || "png"}`;
           lastFrame = `data:${mimeType};base64,${lastFrameBuffer.toString("base64")}`;
@@ -40286,7 +40381,7 @@ Examples:
           refImages = [];
           for (const refPath of options.refImages.slice(0, 3)) {
             const absRefPath = resolve33(process.cwd(), refPath);
-            const refBuffer = await readFile20(absRefPath);
+            const refBuffer = await readFile21(absRefPath);
             const ext = refPath.toLowerCase().split(".").pop();
             const mimeType = ext === "jpg" || ext === "jpeg" ? "image/jpeg" : `image/${ext || "png"}`;
             refImages.push({ base64: refBuffer.toString("base64"), mimeType });
@@ -40418,7 +40513,7 @@ Examples:
         if (seedanceEndImagePath && seedanceReferences.length === 0) {
           try {
             const absEndImagePath = resolve33(process.cwd(), seedanceEndImagePath);
-            const endImageBuffer = await readFile20(absEndImagePath);
+            const endImageBuffer = await readFile21(absEndImagePath);
             const ext = seedanceEndImagePath.toLowerCase().split(".").pop();
             const mimeType = ext === "jpg" || ext === "jpeg" ? "image/jpeg" : `image/${ext || "png"}`;
             const uploadHost = await resolveUploadHost();
@@ -40535,7 +40630,7 @@ async function fileInputToUrlOrDataUri2(input, fallbackMimeType) {
     return input;
   }
   const absPath = resolve33(process.cwd(), input);
-  const buffer = await readFile20(absPath);
+  const buffer = await readFile21(absPath);
   return `data:${mimeTypeForPath2(input, fallbackMimeType)};base64,${buffer.toString("base64")}`;
 }
 function mimeTypeForPath2(path2, fallback2) {
@@ -40708,8 +40803,8 @@ Run 'vibe schema generate.<command>' for structured parameter info.
 });
 
 // src/commands/_shared/edit/silence-cut.ts
-import { existsSync as existsSync20 } from "node:fs";
-import { readFile as readFile21 } from "node:fs/promises";
+import { existsSync as existsSync21 } from "node:fs";
+import { readFile as readFile22 } from "node:fs/promises";
 async function detectSilencePeriods(videoPath, noiseThreshold, minDuration) {
   const totalDuration = await getVideoDuration(videoPath);
   const { stdout, stderr } = await execSafe(
@@ -40759,7 +40854,7 @@ async function detectSilencePeriodsWithGemini(videoPath, minDuration, options) {
   }
   const gemini = new GeminiProvider();
   await gemini.initialize({ apiKey: geminiApiKey });
-  const videoBuffer = await readFile21(videoPath);
+  const videoBuffer = await readFile22(videoPath);
   const modelId = options.model ? resolveGeminiTextModel(options.model) : void 0;
   const prompt3 = `Analyze this video and identify all silent or dead segments where there is NO meaningful content.
 
@@ -40835,7 +40930,7 @@ async function executeSilenceCut(options) {
     analyzeOnly = false,
     useGemini = false
   } = options;
-  if (!existsSync20(videoPath)) {
+  if (!existsSync21(videoPath)) {
     return { success: false, error: `Video not found: ${videoPath}` };
   }
   if (!commandExists("ffmpeg")) {
@@ -40943,11 +41038,11 @@ var init_silence_cut = __esm({
 });
 
 // src/commands/_shared/edit/jump-cut.ts
-import { existsSync as existsSync21 } from "node:fs";
-import { readFile as readFile22, writeFile as writeFile31, mkdir as mkdir15 } from "node:fs/promises";
-import { join as join14 } from "node:path";
+import { existsSync as existsSync22 } from "node:fs";
+import { readFile as readFile23, writeFile as writeFile31, mkdir as mkdir15 } from "node:fs/promises";
+import { join as join15 } from "node:path";
 async function transcribeWithWords(audioPath, apiKey, language) {
-  const audioBuffer = await readFile22(audioPath);
+  const audioBuffer = await readFile23(audioPath);
   const audioBlob = new Blob([audioBuffer]);
   const formData = new FormData();
   formData.append("file", audioBlob, "audio.wav");
@@ -41006,7 +41101,7 @@ async function executeJumpCut(options) {
     analyzeOnly = false,
     apiKey
   } = options;
-  if (!existsSync21(videoPath)) {
+  if (!existsSync22(videoPath)) {
     return { success: false, error: `Video not found: ${videoPath}` };
   }
   if (!commandExists("ffmpeg")) {
@@ -41025,7 +41120,7 @@ async function executeJumpCut(options) {
   try {
     const tmpDir = `/tmp/vibe_jumpcut_${Date.now()}`;
     await mkdir15(tmpDir, { recursive: true });
-    const audioPath = join14(tmpDir, "audio.wav");
+    const audioPath = join15(tmpDir, "audio.wav");
     try {
       await execSafe(
         "ffmpeg",
@@ -41079,7 +41174,7 @@ async function executeJumpCut(options) {
       const segmentPaths = [];
       for (let i = 0; i < segments.length; i++) {
         const seg = segments[i];
-        const segPath = join14(tmpDir, `seg-${i.toString().padStart(4, "0")}.ts`);
+        const segPath = join15(tmpDir, `seg-${i.toString().padStart(4, "0")}.ts`);
         const duration = seg.end - seg.start;
         await execSafe(
           "ffmpeg",
@@ -41102,7 +41197,7 @@ async function executeJumpCut(options) {
         segmentPaths.push(segPath);
       }
       const concatList = segmentPaths.map((p) => `file '${p}'`).join("\n");
-      const listPath = join14(tmpDir, "concat.txt");
+      const listPath = join15(tmpDir, "concat.txt");
       await writeFile31(listPath, concatList);
       await execSafe(
         "ffmpeg",
@@ -41292,9 +41387,9 @@ var init_helpers = __esm({
 });
 
 // src/commands/_shared/edit/caption.ts
-import { existsSync as existsSync22 } from "node:fs";
-import { readFile as readFile23, writeFile as writeFile32, mkdir as mkdir16 } from "node:fs/promises";
-import { dirname as dirname11, basename as basename6, extname as extname4, join as join15 } from "node:path";
+import { existsSync as existsSync23 } from "node:fs";
+import { readFile as readFile24, writeFile as writeFile32, mkdir as mkdir16 } from "node:fs/promises";
+import { dirname as dirname11, basename as basename6, extname as extname4, join as join16 } from "node:path";
 function getCaptionForceStyle(style, fontSize, fontColor, position) {
   const alignment = position === "top" ? 8 : position === "center" ? 5 : 2;
   const marginV = position === "center" ? 0 : 30;
@@ -41322,7 +41417,7 @@ async function executeCaption(options) {
     position = "bottom",
     apiKey
   } = options;
-  if (!existsSync22(videoPath)) {
+  if (!existsSync23(videoPath)) {
     return { success: false, error: `Video not found: ${videoPath}` };
   }
   if (!commandExists("ffmpeg")) {
@@ -41341,8 +41436,8 @@ async function executeCaption(options) {
   try {
     const tmpDir = `/tmp/vibe_caption_${Date.now()}`;
     await mkdir16(tmpDir, { recursive: true });
-    const audioPath = join15(tmpDir, "audio.wav");
-    const srtPath = join15(tmpDir, "captions.srt");
+    const audioPath = join16(tmpDir, "audio.wav");
+    const srtPath = join16(tmpDir, "captions.srt");
     try {
       await execSafe(
         "ffmpeg",
@@ -41363,7 +41458,7 @@ async function executeCaption(options) {
       );
       const whisper = new WhisperProvider();
       await whisper.initialize({ apiKey: openaiKey });
-      const audioBuffer = await readFile23(audioPath);
+      const audioBuffer = await readFile24(audioPath);
       const audioBlob = new Blob([audioBuffer]);
       const transcriptResult = await whisper.transcribe(audioBlob, language);
       if (transcriptResult.status === "failed" || !transcriptResult.segments || transcriptResult.segments.length === 0) {
@@ -41411,7 +41506,7 @@ async function executeCaption(options) {
         const remotionErr = await ensureRemotionInstalled2();
         if (remotionErr) {
           const outputDir2 = dirname11(outputPath);
-          const outputSrtPath2 = join15(
+          const outputSrtPath2 = join16(
             outputDir2,
             basename6(outputPath, extname4(outputPath)) + ".srt"
           );
@@ -41450,7 +41545,7 @@ SRT saved to: ${outputSrtPath2}` };
         });
         if (!renderResult.success) {
           const outputDir2 = dirname11(outputPath);
-          const outputSrtPath2 = join15(
+          const outputSrtPath2 = join16(
             outputDir2,
             basename6(outputPath, extname4(outputPath)) + ".srt"
           );
@@ -41463,7 +41558,7 @@ SRT saved to: ${outputSrtPath2}`
         }
       }
       const outputDir = dirname11(outputPath);
-      const outputSrtPath = join15(
+      const outputSrtPath = join16(
         outputDir,
         basename6(outputPath, extname4(outputPath)) + ".srt"
       );
@@ -41500,10 +41595,10 @@ var init_caption = __esm({
 });
 
 // src/commands/_shared/edit/noise-reduce.ts
-import { existsSync as existsSync23 } from "node:fs";
+import { existsSync as existsSync24 } from "node:fs";
 async function executeNoiseReduce(options) {
   const { inputPath, outputPath, strength = "medium", noiseFloor } = options;
-  if (!existsSync23(inputPath)) {
+  if (!existsSync24(inputPath)) {
     return { success: false, error: `File not found: ${inputPath}` };
   }
   if (!commandExists("ffmpeg")) {
@@ -41560,7 +41655,7 @@ var init_noise_reduce = __esm({
 });
 
 // src/commands/_shared/edit/fade.ts
-import { existsSync as existsSync24 } from "node:fs";
+import { existsSync as existsSync25 } from "node:fs";
 async function executeFade(options) {
   const {
     videoPath,
@@ -41570,7 +41665,7 @@ async function executeFade(options) {
     audioOnly = false,
     videoOnly = false
   } = options;
-  if (!existsSync24(videoPath)) {
+  if (!existsSync25(videoPath)) {
     return { success: false, error: `Video not found: ${videoPath}` };
   }
   if (!commandExists("ffmpeg")) {
@@ -41637,8 +41732,8 @@ var init_fade = __esm({
 });
 
 // src/commands/_shared/edit/translate-srt.ts
-import { existsSync as existsSync25 } from "node:fs";
-import { readFile as readFile24, writeFile as writeFile33 } from "node:fs/promises";
+import { existsSync as existsSync26 } from "node:fs";
+import { readFile as readFile25, writeFile as writeFile33 } from "node:fs/promises";
 async function executeTranslateSrt(options) {
   const {
     srtPath,
@@ -41648,11 +41743,11 @@ async function executeTranslateSrt(options) {
     sourceLanguage,
     apiKey
   } = options;
-  if (!existsSync25(srtPath)) {
+  if (!existsSync26(srtPath)) {
     return { success: false, error: `SRT file not found: ${srtPath}` };
   }
   try {
-    const srtContent = await readFile24(srtPath, "utf-8");
+    const srtContent = await readFile25(srtPath, "utf-8");
     const segments = parseSRT(srtContent);
     if (segments.length === 0) {
       return { success: false, error: "No subtitle segments found in SRT file" };
@@ -41765,7 +41860,7 @@ var init_translate_srt = __esm({
 });
 
 // src/commands/_shared/edit/text-overlay.ts
-import { existsSync as existsSync26 } from "node:fs";
+import { existsSync as existsSync27 } from "node:fs";
 import { resolve as resolve34 } from "node:path";
 function detectSystemFont() {
   const platform3 = process.platform;
@@ -41776,7 +41871,7 @@ function detectSystemFont() {
       "/Library/Fonts/Arial.ttf"
     ];
     for (const f of candidates) {
-      if (existsSync26(f)) return f;
+      if (existsSync27(f)) return f;
     }
   } else if (platform3 === "linux") {
     const candidates = [
@@ -41785,7 +41880,7 @@ function detectSystemFont() {
       "/usr/share/fonts/TTF/DejaVuSans-Bold.ttf"
     ];
     for (const f of candidates) {
-      if (existsSync26(f)) return f;
+      if (existsSync27(f)) return f;
     }
   } else if (platform3 === "win32") {
     const candidates = [
@@ -41793,7 +41888,7 @@ function detectSystemFont() {
       "C:\\Windows\\Fonts\\segoeui.ttf"
     ];
     for (const f of candidates) {
-      if (existsSync26(f)) return f;
+      if (existsSync27(f)) return f;
     }
   }
   return null;
@@ -41814,7 +41909,7 @@ async function applyTextOverlays(options) {
   }
   const absVideoPath = resolve34(process.cwd(), videoPath);
   const absOutputPath = resolve34(process.cwd(), outputPath);
-  if (!existsSync26(absVideoPath)) {
+  if (!existsSync27(absVideoPath)) {
     return { success: false, error: `Video not found: ${absVideoPath}` };
   }
   if (!commandExists("ffmpeg")) {
@@ -41995,7 +42090,7 @@ var init_ai_edit = __esm({
 
 // src/commands/ai-edit-cli.ts
 import { resolve as resolve35, extname as extname5, basename as basename7 } from "node:path";
-import { existsSync as existsSync27 } from "node:fs";
+import { existsSync as existsSync28 } from "node:fs";
 function registerEditCommands(aiCommand) {
   aiCommand.command("silence-cut").alias("sc").description("Remove silent segments from video (FFmpeg default, or Gemini for smart detection)").argument("<video>", "Video file path").option("-o, --output <path>", "Output file path (default: <name>-cut.<ext>)").option("--noise <dB>", "Silence threshold in dB (default: -30)", "-30").option("-d, --min-duration <seconds>", "Minimum silence duration to cut (default: 0.5)", "0.5").option("--padding <seconds>", "Padding around non-silent segments (default: 0.1)", "0.1").option("--analyze-only", "(deprecated \u2014 use `vibe detect silence`) Only detect silence, don't cut").option("--use-gemini", "Use Gemini Video Understanding for context-aware silence detection").option("-m, --model <model>", "Gemini model (default: flash)").option("--low-res", "Low resolution mode for longer videos (Gemini only)").option("-k, --api-key <key>", "Google API key override (or set GOOGLE_API_KEY env)").option("--dry-run", "Preview parameters without executing").addHelpText("after", `
 Examples:
@@ -42012,7 +42107,7 @@ No API key needed (FFmpeg only). Use --use-gemini for smart detection (requires
         validateOutputPath(options.output);
       }
       const absVideoPath = resolve35(process.cwd(), videoPath);
-      if (!existsSync27(absVideoPath)) {
+      if (!existsSync28(absVideoPath)) {
         exitWithError(notFoundError(absVideoPath));
       }
       if (!commandExists("ffmpeg")) {
@@ -42120,7 +42215,7 @@ Requires: OPENAI_API_KEY (Whisper transcription) + FFmpeg`).action(async (videoP
         validateOutputPath(options.output);
       }
       const absVideoPath = resolve35(process.cwd(), videoPath);
-      if (!existsSync27(absVideoPath)) {
+      if (!existsSync28(absVideoPath)) {
         exitWithError(notFoundError(absVideoPath));
       }
       if (!commandExists("ffmpeg")) {
@@ -42201,7 +42296,7 @@ Requires: OPENAI_API_KEY (Whisper transcription) + FFmpeg`).action(async (videoP
         validateOutputPath(options.output);
       }
       const absInputPath = resolve35(process.cwd(), inputPath);
-      if (!existsSync27(absInputPath)) {
+      if (!existsSync28(absInputPath)) {
         exitWithError(notFoundError(absInputPath));
       }
       if (!commandExists("ffmpeg")) {
@@ -42267,7 +42362,7 @@ Requires: OPENAI_API_KEY (Whisper transcription) + FFmpeg`).action(async (videoP
         validateOutputPath(options.output);
       }
       const absVideoPath = resolve35(process.cwd(), videoPath);
-      if (!existsSync27(absVideoPath)) {
+      if (!existsSync28(absVideoPath)) {
         exitWithError(notFoundError(absVideoPath));
       }
       if (!commandExists("ffmpeg")) {
@@ -42342,7 +42437,7 @@ Requires: OPENAI_API_KEY (Whisper transcription) + FFmpeg`).action(async (videoP
         exitWithError(usageError("Target language required. Use -t or --target"));
       }
       const absSrtPath = resolve35(process.cwd(), srtPath);
-      if (!existsSync27(absSrtPath)) {
+      if (!existsSync28(absSrtPath)) {
         exitWithError(notFoundError(absSrtPath));
       }
       if (options.dryRun) {
@@ -42418,7 +42513,7 @@ Requires: OPENAI_API_KEY (Whisper transcription) + FFmpeg`).action(async (videoP
       }
       if (options.fillers) rejectControlChars(options.fillers);
       const absVideoPath = resolve35(process.cwd(), videoPath);
-      if (!existsSync27(absVideoPath)) {
+      if (!existsSync28(absVideoPath)) {
         exitWithError(notFoundError(absVideoPath));
       }
       if (!commandExists("ffmpeg")) {
@@ -42518,8 +42613,8 @@ var init_ai_edit_cli = __esm({
 });
 
 // src/commands/_shared/execute-fill-gaps.ts
-import { existsSync as existsSync28 } from "node:fs";
-import { readFile as readFile25, writeFile as writeFile34, mkdir as mkdir17, rename as renameFs } from "node:fs/promises";
+import { existsSync as existsSync29 } from "node:fs";
+import { readFile as readFile26, writeFile as writeFile34, mkdir as mkdir17, rename as renameFs } from "node:fs/promises";
 import { resolve as resolve36, dirname as dirname12 } from "node:path";
 function detectVideoGaps(videoClips, totalDuration) {
   const gaps = [];
@@ -42576,7 +42671,7 @@ function analyzeGapFillability(gaps, videoClips, sources) {
 }
 async function uploadFrameToImgbb(framePath, imgbbApiKey) {
   try {
-    const frameBuffer = await readFile25(framePath);
+    const frameBuffer = await readFile26(framePath);
     const frameBase64 = frameBuffer.toString("base64");
     const formData = new FormData();
     formData.append("key", imgbbApiKey);
@@ -42601,14 +42696,14 @@ async function executeFillGaps(options) {
   try {
     onProgress("Loading timeline...");
     const filePath = await resolveTimelineFile(options.projectPath);
-    if (!existsSync28(filePath)) {
+    if (!existsSync29(filePath)) {
       return {
         success: false,
         error: `Timeline file not found: ${filePath}`,
         humanLines
       };
     }
-    const content = await readFile25(filePath, "utf-8");
+    const content = await readFile26(filePath, "utf-8");
     const data = JSON.parse(content);
     const project = Project.fromJSON(data);
     const clips = project.getClips().sort((a, b) => a.startTime - b.startTime);
@@ -42736,7 +42831,7 @@ async function executeFillGaps(options) {
     }
     const projectDir = dirname12(filePath);
     const footageDir = options.dir ? resolve36(process.cwd(), options.dir) : resolve36(projectDir, "footage");
-    if (!existsSync28(footageDir)) {
+    if (!existsSync29(footageDir)) {
       await mkdir17(footageDir, { recursive: true });
     }
     humanLines.push("Generating AI Videos");
@@ -43050,15 +43145,15 @@ var init_ai_fill_gaps = __esm({
 });
 
 // src/pipeline/renderers/chrome.ts
-import { existsSync as existsSync29 } from "node:fs";
+import { existsSync as existsSync30 } from "node:fs";
 import { homedir as homedir5 } from "node:os";
-import { join as join16 } from "node:path";
+import { join as join17 } from "node:path";
 function findChrome() {
   const candidates = [
     process.env.HYPERFRAMES_CHROME_PATH,
     process.env.CHROME_PATH,
     // puppeteer auto-downloaded headless shell
-    join16(
+    join17(
       homedir5(),
       ".cache",
       "puppeteer",
@@ -43076,7 +43171,7 @@ function findChrome() {
     "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe"
   ];
   for (const c of candidates) {
-    if (c && existsSync29(c)) return c;
+    if (c && existsSync30(c)) return c;
   }
   return void 0;
 }
@@ -43322,7 +43417,7 @@ __export(project_builder_exports, {
   resolveSourceUrl: () => resolveSourceUrl
 });
 import { mkdtemp, mkdir as mkdir18, copyFile as copyFile4, writeFile as writeFile35, rm as rm2, readdir as readdir3 } from "node:fs/promises";
-import { existsSync as existsSync30 } from "node:fs";
+import { existsSync as existsSync31 } from "node:fs";
 import { tmpdir as tmpdir2 } from "node:os";
 import { createRequire } from "node:module";
 import * as path from "node:path";
@@ -43334,7 +43429,7 @@ async function buildTempProject(state, projectFileDir) {
   for (const source of state.sources) {
     if (copied.has(source.id)) continue;
     const resolved = resolveSourceUrl(source.url, projectFileDir);
-    if (!existsSync30(resolved)) {
+    if (!existsSync31(resolved)) {
       throw new Error(`Source file not found: ${resolved} (from source id=${source.id})`);
     }
     const dest = path.join(assetsDir, path.basename(resolved));
@@ -43471,7 +43566,7 @@ __export(motion_overlay_exports, {
   registerMotionOverlayCommand: () => registerMotionOverlayCommand
 });
 import { mkdir as mkdir19 } from "node:fs/promises";
-import { existsSync as existsSync31 } from "node:fs";
+import { existsSync as existsSync32 } from "node:fs";
 import { basename as basename9, dirname as dirname14, extname as extname6, resolve as resolve38 } from "node:path";
 function normalizeUnderstand2(value) {
   return value === "off" || value === "required" || value === "auto" ? value : "auto";
@@ -43602,11 +43697,11 @@ async function executeMotionOverlay(options) {
   const validationError = assertValidRequest(options);
   if (validationError) return { success: false, error: validationError };
   const absVideo = resolve38(process.cwd(), options.videoPath);
-  if (!existsSync31(absVideo)) return { success: false, error: `Video file not found: ${absVideo}` };
+  if (!existsSync32(absVideo)) return { success: false, error: `Video file not found: ${absVideo}` };
   const outputPath = options.output ? resolve38(process.cwd(), options.output) : defaultOverlayOutput(options.videoPath);
   if (options.asset) {
     const absAsset = resolve38(process.cwd(), options.asset);
-    if (!existsSync31(absAsset)) return { success: false, error: `Lottie asset not found: ${absAsset}` };
+    if (!existsSync32(absAsset)) return { success: false, error: `Lottie asset not found: ${absAsset}` };
     const [videoDuration, size] = await Promise.all([
       ffprobeDuration(absVideo),
       ffprobeVideoSize(absVideo)
@@ -43773,7 +43868,7 @@ __export(edit_cmd_exports, {
   executeUpscale: () => executeUpscale
 });
 import { resolve as resolve39, dirname as dirname15 } from "node:path";
-import { readFile as readFile26, writeFile as writeFile36, mkdir as mkdir20 } from "node:fs/promises";
+import { readFile as readFile27, writeFile as writeFile36, mkdir as mkdir20 } from "node:fs/promises";
 async function executeGrade(options) {
   const { videoPath, style, preset, output, analyzeOnly, apiKey } = options;
   try {
@@ -43814,7 +43909,7 @@ async function executeSpeedRamp(options) {
     await execSafe("ffmpeg", ["-i", absPath, "-vn", "-acodec", "libmp3lame", "-q:a", "2", tempAudio, "-y"]);
     const whisper = new WhisperProvider();
     await whisper.initialize({ apiKey: openaiKey });
-    const audioBuffer = await readFile26(tempAudio);
+    const audioBuffer = await readFile27(tempAudio);
     const transcript = await whisper.transcribe(new Blob([audioBuffer]), language);
     try {
       const { unlink: unlink5 } = await import("node:fs/promises");
@@ -44208,7 +44303,7 @@ Run 'vibe schema edit.<command>' for structured parameter info.
         spinner2.text = "Transcribing audio...";
         const whisper = new WhisperProvider();
         await whisper.initialize({ apiKey: openaiApiKey });
-        const audioBuffer = await readFile26(tempAudio);
+        const audioBuffer = await readFile27(tempAudio);
         const audioBlob = new Blob([audioBuffer]);
         const transcript = await whisper.transcribe(audioBlob, options.language);
         if (!transcript.segments || transcript.segments.length === 0) {
@@ -44341,7 +44436,7 @@ Run 'vibe schema edit.<command>' for structured parameter info.
         for (let i = 1; i <= numKeyframes && i <= 30; i++) {
           const framePath = `${tempDir}/frame-${i.toString().padStart(4, "0")}.jpg`;
           try {
-            const frameBuffer = await readFile26(framePath);
+            const frameBuffer = await readFile27(framePath);
             const frameBase64 = frameBuffer.toString("base64");
             const result = await claude.analyzeFrameForReframe(frameBase64, options.aspect, {
               focusMode: options.focus,
@@ -44470,7 +44565,7 @@ Run 'vibe schema edit.<command>' for structured parameter info.
         const imageBuffers = [];
         for (const imagePath of imagePaths) {
           const absPath = resolve39(process.cwd(), imagePath);
-          const buffer = await readFile26(absPath);
+          const buffer = await readFile27(absPath);
           imageBuffers.push(buffer);
         }
         let result;
@@ -44746,9 +44841,9 @@ __export(ai_analyze_exports, {
   executeGeminiVideo: () => executeGeminiVideo,
   registerAnalyzeCommands: () => registerAnalyzeCommands
 });
-import { readFile as readFile27 } from "node:fs/promises";
+import { readFile as readFile28 } from "node:fs/promises";
 import { extname as extname7, resolve as resolve40 } from "node:path";
-import { existsSync as existsSync32 } from "node:fs";
+import { existsSync as existsSync33 } from "node:fs";
 async function executeGeminiVideo(options) {
   try {
     const apiKey = await getApiKey("GOOGLE_API_KEY", "Google");
@@ -44762,10 +44857,10 @@ async function executeGeminiVideo(options) {
       videoData = options.source;
     } else {
       const absPath = resolve40(process.cwd(), options.source);
-      if (!existsSync32(absPath)) {
+      if (!existsSync33(absPath)) {
         return { success: false, error: `File not found: ${absPath}` };
       }
-      videoData = await readFile27(absPath);
+      videoData = await readFile28(absPath);
     }
     const gemini = new GeminiProvider();
     await gemini.initialize({ apiKey });
@@ -44830,10 +44925,10 @@ async function executeAnalyze(options) {
         imageBuffer = Buffer.from(await response.arrayBuffer());
       } else {
         const absPath = resolve40(process.cwd(), source);
-        if (!existsSync32(absPath)) {
+        if (!existsSync33(absPath)) {
           return { success: false, error: `File not found: ${absPath}` };
         }
-        imageBuffer = await readFile27(absPath);
+        imageBuffer = await readFile28(absPath);
       }
       const result2 = await gemini.analyzeImage(imageBuffer, options.prompt, {
         model: modelId,
@@ -44865,10 +44960,10 @@ async function executeAnalyze(options) {
       videoData = Buffer.from(await response.arrayBuffer());
     } else {
       const absPath = resolve40(process.cwd(), source);
-      if (!existsSync32(absPath)) {
+      if (!existsSync33(absPath)) {
         return { success: false, error: `File not found: ${absPath}` };
       }
-      videoData = await readFile27(absPath);
+      videoData = await readFile28(absPath);
     }
     const result = await gemini.analyzeVideo(videoData, options.prompt, {
       model: modelId,
@@ -45002,9 +45097,9 @@ __export(ai_review_exports, {
   executeReview: () => executeReview,
   registerReviewCommand: () => registerReviewCommand
 });
-import { readFile as readFile28, rename as rename2 } from "node:fs/promises";
+import { readFile as readFile29, rename as rename2 } from "node:fs/promises";
 import { resolve as resolve41 } from "node:path";
-import { existsSync as existsSync33 } from "node:fs";
+import { existsSync as existsSync34 } from "node:fs";
 function parseReviewFeedback(response) {
   let cleaned = response.trim();
   if (cleaned.startsWith("```json")) {
@@ -45036,7 +45131,7 @@ async function executeReview(options) {
     model = "flash"
   } = options;
   const absVideoPath = resolve41(process.cwd(), videoPath);
-  if (!existsSync33(absVideoPath)) {
+  if (!existsSync34(absVideoPath)) {
     return { success: false, error: `Video not found: ${absVideoPath}` };
   }
   const apiKey = process.env.GOOGLE_API_KEY || await getApiKey("GOOGLE_API_KEY", "Google");
@@ -45049,8 +45144,8 @@ async function executeReview(options) {
   let storyboardContext = "";
   if (storyboardPath2) {
     const absStoryboardPath = resolve41(process.cwd(), storyboardPath2);
-    if (existsSync33(absStoryboardPath)) {
-      const content = await readFile28(absStoryboardPath, "utf-8");
+    if (existsSync34(absStoryboardPath)) {
+      const content = await readFile29(absStoryboardPath, "utf-8");
       storyboardContext = `
 
 Original storyboard for reference:
@@ -45092,7 +45187,7 @@ ${projectContext}` : "";
 Score each category 1-10. Prefer beatIssues when you can map a problem to a storyboard beat or timestamp. Use the exact beatId values from the storyboard or beat timing summary, and include timeRange in seconds for every localized finding. In particular, flag narration/visual mismatches, overly static holds, and audio-visual sync problems as beatIssues. Use category issue arrays only for problems that cannot be localized to a beat. For fixable issues, provide an FFmpeg filter in autoFixable. Be specific and practical.${storyboardContext}${extraProjectContext}`;
   const gemini = new GeminiProvider();
   await gemini.initialize({ apiKey });
-  const videoData = await readFile28(absVideoPath);
+  const videoData = await readFile29(absVideoPath);
   const analysisResult = await gemini.analyzeVideo(videoData, reviewPrompt, {
     model: modelId
   });
@@ -45147,7 +45242,7 @@ Score each category 1-10. Prefer beatIssues when you can map a problem to a stor
     }
   }
   if (verify && result.outputPath) {
-    const verifyVideoData = await readFile28(result.outputPath);
+    const verifyVideoData = await readFile29(result.outputPath);
     const verifyResult = await gemini.analyzeVideo(
       verifyVideoData,
       'Rate this video overall quality on a scale of 1-10. Return ONLY a JSON object: {"score": <number>}',
@@ -45275,9 +45370,9 @@ var init_ai_review = __esm({
 });
 
 // src/commands/_shared/scene-inspect.ts
-import { existsSync as existsSync34 } from "node:fs";
-import { readdir as readdir4, readFile as readFile29, stat as stat5 } from "node:fs/promises";
-import { basename as basename10, isAbsolute as isAbsolute3, join as join18, relative as relative8, resolve as resolve42 } from "node:path";
+import { existsSync as existsSync35 } from "node:fs";
+import { readdir as readdir4, readFile as readFile30, stat as stat5 } from "node:fs/promises";
+import { basename as basename10, isAbsolute as isAbsolute3, join as join19, relative as relative8, resolve as resolve42 } from "node:path";
 async function inspectProject(opts) {
   const projectDir = resolve42(opts.projectDir);
   const issues = [];
@@ -45291,7 +45386,7 @@ async function inspectProject(opts) {
     assets: { checked: 0, missing: [], stale: [], unknownFreshness: [] },
     rootSync: { ok: null, issueCount: 0, issues: [] }
   };
-  if (!existsSync34(projectDir) || !await isDirectory(projectDir)) {
+  if (!existsSync35(projectDir) || !await isDirectory(projectDir)) {
     issues.push({
       severity: "error",
       code: "PROJECT_NOT_FOUND",
@@ -45306,15 +45401,15 @@ async function inspectProject(opts) {
     );
   }
   const coreFiles = {
-    storyboard: join18(projectDir, "STORYBOARD.md"),
-    design: join18(projectDir, "DESIGN.md"),
-    config: join18(projectDir, "vibe.config.json"),
-    legacyConfig: join18(projectDir, "vibe.project.yaml"),
-    buildReport: join18(projectDir, "build-report.json"),
-    root: join18(projectDir, "index.html")
+    storyboard: join19(projectDir, "STORYBOARD.md"),
+    design: join19(projectDir, "DESIGN.md"),
+    config: join19(projectDir, "vibe.config.json"),
+    legacyConfig: join19(projectDir, "vibe.project.yaml"),
+    buildReport: join19(projectDir, "build-report.json"),
+    root: join19(projectDir, "index.html")
   };
   for (const [name, path2] of Object.entries(coreFiles)) {
-    checks.files[name] = existsSync34(path2);
+    checks.files[name] = existsSync35(path2);
   }
   let beatIds = [];
   let inspectedBeatIds = [];
@@ -45328,7 +45423,7 @@ async function inspectProject(opts) {
     });
     retryWith.push(`vibe init ${projectDir} --from "<brief>" --json`);
   } else {
-    const storyboard = await readFile29(coreFiles.storyboard, "utf-8");
+    const storyboard = await readFile30(coreFiles.storyboard, "utf-8");
     const validation = validateStoryboardMarkdown(storyboard);
     storyboardBeats = validation.beats;
     beatIds = validation.beats.map((beat) => beat.id);
@@ -45370,7 +45465,7 @@ async function inspectProject(opts) {
       suggestedFix: "Create DESIGN.md or rerun `vibe init --from` in a new project."
     });
   } else {
-    const design = await readFile29(coreFiles.design, "utf-8");
+    const design = await readFile30(coreFiles.design, "utf-8");
     for (const issue of designPlaceholderIssues(design)) {
       issues.push(issue);
     }
@@ -45395,20 +45490,20 @@ async function inspectProject(opts) {
     });
     retryWith.push(`vibe build ${projectDir} --stage sync --json`);
   }
-  const compositionsDir = join18(projectDir, "compositions");
-  const existingComps = existsSync34(compositionsDir) ? new Set(await listHtmlBasenames(compositionsDir)) : /* @__PURE__ */ new Set();
+  const compositionsDir = join19(projectDir, "compositions");
+  const existingComps = existsSync35(compositionsDir) ? new Set(await listHtmlBasenames(compositionsDir)) : /* @__PURE__ */ new Set();
   checks.compositions.expected = inspectedBeatIds.length;
   for (const beatId of inspectedBeatIds) {
     const file = `scene-${beatId}.html`;
     if (existingComps.has(file)) {
       checks.compositions.found++;
     } else {
-      checks.compositions.missing.push(join18("compositions", file));
+      checks.compositions.missing.push(join19("compositions", file));
       issues.push({
         severity: "error",
         code: "MISSING_COMPOSITION",
         message: `Composition for beat "${beatId}" is missing.`,
-        file: join18("compositions", file),
+        file: join19("compositions", file),
         scene: beatId,
         beatId,
         suggestedFix: "Run `vibe build --stage compose --json`."
@@ -45470,7 +45565,7 @@ async function inspectProject(opts) {
     try {
       const lint = await runProjectLint({ projectDir });
       const lintFiles = opts.beatId ? lint.files.filter(
-        (file) => file.file === "index.html" || file.file === join18("compositions", `scene-${opts.beatId}.html`)
+        (file) => file.file === "index.html" || file.file === join19("compositions", `scene-${opts.beatId}.html`)
       ) : lint.files;
       const lintCounts = countLintFindings(lintFiles);
       checks.lint = {
@@ -45616,7 +45711,7 @@ function projectSourceReports(checks) {
 async function inspectBuildReport(projectDir, reportPath, beatId, checks, issues, retryWith, storyboardBeats) {
   checks.buildReport.exists = true;
   try {
-    const report = JSON.parse(await readFile29(reportPath, "utf-8"));
+    const report = JSON.parse(await readFile30(reportPath, "utf-8"));
     if (typeof report.outputPath === "string") checks.buildReport.outputPath = report.outputPath;
     const reportBeats = report.beats ?? [];
     const selectedReportBeats = reportBeats.filter((item) => !beatId || item.id === beatId);
@@ -45753,7 +45848,7 @@ function inspectReportedAsset(opts) {
   opts.checks.assets.checked++;
   if (isExternalRef(opts.value)) return;
   const abs = isAbsolute3(opts.value) ? opts.value : resolve42(opts.projectDir, opts.value);
-  if (existsSync34(abs)) return;
+  if (existsSync35(abs)) return;
   opts.checks.assets.missing.push(opts.value);
   opts.issues.push({
     severity: "warning",
@@ -45852,9 +45947,9 @@ var init_scene_inspect = __esm({
 });
 
 // src/commands/_shared/render-inspect.ts
-import { existsSync as existsSync35 } from "node:fs";
-import { readdir as readdir5, readFile as readFile30, stat as stat6 } from "node:fs/promises";
-import { basename as basename11, isAbsolute as isAbsolute4, join as join19, relative as relative9, resolve as resolve43 } from "node:path";
+import { existsSync as existsSync36 } from "node:fs";
+import { readdir as readdir5, readFile as readFile31, stat as stat6 } from "node:fs/promises";
+import { basename as basename11, isAbsolute as isAbsolute4, join as join20, relative as relative9, resolve as resolve43 } from "node:path";
 function parseBlackdetectOutput(output) {
   const ranges = [];
   const regex2 = /black_start:(-?\d+(?:\.\d+)?)\s+black_end:(-?\d+(?:\.\d+)?)\s+black_duration:(-?\d+(?:\.\d+)?)/g;
@@ -46340,11 +46435,11 @@ async function inspectRender(opts) {
 }
 async function renderExpectsAudio(projectDir, beatId) {
   const root = resolve43(projectDir);
-  const rootHtml = await readTextIfExists(join19(root, "index.html"));
+  const rootHtml = await readTextIfExists(join20(root, "index.html"));
   if (rootHtml && rootHtmlExpectsAudio(rootHtml, beatId)) return true;
-  const buildReport = await readJsonIfExists(join19(root, "build-report.json"));
+  const buildReport = await readJsonIfExists(join20(root, "build-report.json"));
   if (buildReportExpectsAudio(buildReport, beatId)) return true;
-  const storyboard = await readTextIfExists(join19(root, "STORYBOARD.md"));
+  const storyboard = await readTextIfExists(join20(root, "STORYBOARD.md"));
   if (!storyboard) return false;
   try {
     const parsed = parseStoryboard(storyboard);
@@ -46355,7 +46450,7 @@ async function renderExpectsAudio(projectDir, beatId) {
         `assets/narration-${beat.id}.wav`,
         `assets/music-${beat.id}.mp3`,
         `assets/music-${beat.id}.wav`
-      ].some((asset) => existsSync35(join19(root, asset)))
+      ].some((asset) => existsSync36(join20(root, asset)))
     );
   } catch {
     return false;
@@ -46463,8 +46558,8 @@ async function maybeWriteRenderReport(projectDir, opts, result) {
 }
 function renderSourceReports(projectDir, videoPath, checks) {
   const reports = [];
-  if (existsSync35(join19(projectDir, "build-report.json"))) reports.push("build-report.json");
-  if (existsSync35(join19(projectDir, "render-report.json"))) reports.push("render-report.json");
+  if (existsSync36(join20(projectDir, "build-report.json"))) reports.push("build-report.json");
+  if (existsSync36(join20(projectDir, "render-report.json"))) reports.push("render-report.json");
   if (videoPath) reports.push(displayPath(videoPath));
   if (checks.durationSec !== void 0 || checks.width !== void 0 || checks.height !== void 0) {
     reports.push("ffprobe");
@@ -46477,31 +46572,31 @@ function renderSourceReports(projectDir, videoPath, checks) {
 async function resolveRenderVideoPath(projectDir, explicit, beatId) {
   if (explicit) {
     const candidate = resolve43(process.cwd(), explicit);
-    return existsSync35(candidate) ? candidate : null;
+    return existsSync36(candidate) ? candidate : null;
   }
-  const renderReportPath = join19(projectDir, "render-report.json");
-  if (existsSync35(renderReportPath)) {
+  const renderReportPath = join20(projectDir, "render-report.json");
+  if (existsSync36(renderReportPath)) {
     try {
-      const report = JSON.parse(await readFile30(renderReportPath, "utf-8"));
+      const report = JSON.parse(await readFile31(renderReportPath, "utf-8"));
       const reportBeat = typeof report.beat === "string" ? report.beat : null;
       if (!beatId && reportBeat === null || beatId && reportBeat === beatId) {
         const candidate = resolveReportedPath(projectDir, report.outputPath);
-        if (candidate && existsSync35(candidate)) return candidate;
+        if (candidate && existsSync36(candidate)) return candidate;
       }
     } catch {
     }
   }
-  const reportPath = join19(projectDir, "build-report.json");
-  if (!beatId && existsSync35(reportPath)) {
+  const reportPath = join20(projectDir, "build-report.json");
+  if (!beatId && existsSync36(reportPath)) {
     try {
-      const report = JSON.parse(await readFile30(reportPath, "utf-8"));
+      const report = JSON.parse(await readFile31(reportPath, "utf-8"));
       const candidate = resolveReportedPath(projectDir, report.outputPath);
-      if (candidate && existsSync35(candidate)) return candidate;
+      if (candidate && existsSync36(candidate)) return candidate;
     } catch {
     }
   }
-  const rendersDir = join19(projectDir, "renders");
-  if (!existsSync35(rendersDir)) return null;
+  const rendersDir = join20(projectDir, "renders");
+  if (!existsSync36(rendersDir)) return null;
   const entries = await readdir5(rendersDir, { withFileTypes: true });
   const candidates = [];
   for (const entry of entries) {
@@ -46509,7 +46604,7 @@ async function resolveRenderVideoPath(projectDir, explicit, beatId) {
     const ext = entry.name.slice(entry.name.lastIndexOf(".")).toLowerCase();
     if (!VIDEO_EXTENSIONS.has(ext)) continue;
     if (beatId && !entry.name.includes(sanitizeFileSegment(beatId))) continue;
-    const full = join19(rendersDir, entry.name);
+    const full = join20(rendersDir, entry.name);
     const info = await stat6(full);
     candidates.push({ path: full, mtimeMs: info.mtimeMs });
   }
@@ -46527,14 +46622,14 @@ async function runAiRenderReview(projectDir, videoPath, model) {
   });
 }
 function resolveStoryboardPath(projectDir) {
-  const storyboardPath2 = join19(projectDir, "STORYBOARD.md");
-  return existsSync35(storyboardPath2) ? storyboardPath2 : null;
+  const storyboardPath2 = join20(projectDir, "STORYBOARD.md");
+  return existsSync36(storyboardPath2) ? storyboardPath2 : null;
 }
 async function expectedDurationFromBuildReport(projectDir, beatId) {
-  const reportPath = join19(projectDir, "build-report.json");
-  if (!existsSync35(reportPath)) return void 0;
+  const reportPath = join20(projectDir, "build-report.json");
+  if (!existsSync36(reportPath)) return void 0;
   try {
-    const report = JSON.parse(await readFile30(reportPath, "utf-8"));
+    const report = JSON.parse(await readFile31(reportPath, "utf-8"));
     const beats = beatId ? (report.beats ?? []).filter((beat) => beat.id === beatId) : report.beats ?? [];
     const durations = beats.map(
       (beat) => parseOptionalNumber(beat.sceneDurationSec) ?? parseOptionalNumber(beat.narration?.sceneDurationSec)
@@ -46546,10 +46641,10 @@ async function expectedDurationFromBuildReport(projectDir, beatId) {
   }
 }
 async function beatTimingsFromBuildReport(projectDir, beatId) {
-  const reportPath = join19(projectDir, "build-report.json");
-  if (!existsSync35(reportPath)) return [];
+  const reportPath = join20(projectDir, "build-report.json");
+  if (!existsSync36(reportPath)) return [];
   try {
-    const report = JSON.parse(await readFile30(reportPath, "utf-8"));
+    const report = JSON.parse(await readFile31(reportPath, "utf-8"));
     const source = report.beats ?? [];
     const selected = beatId ? source.filter((beat) => beat.id === beatId) : source;
     let cursor = 0;
@@ -46575,17 +46670,17 @@ async function beatTimingsFromBuildReport(projectDir, beatId) {
 }
 async function buildRenderReviewProjectContext(projectDir) {
   const parts = [];
-  const storyboard = await readTextIfExists(join19(projectDir, "STORYBOARD.md"));
+  const storyboard = await readTextIfExists(join20(projectDir, "STORYBOARD.md"));
   if (storyboard) {
     parts.push(`STORYBOARD.md:
 ${truncateText(storyboard, 4e3)}`);
     parts.push(`Storyboard beat cue summary:
 ${storyboardBeatCueSummary(storyboard)}`);
   }
-  const design = await readTextIfExists(join19(projectDir, "DESIGN.md"));
+  const design = await readTextIfExists(join20(projectDir, "DESIGN.md"));
   if (design) parts.push(`DESIGN.md:
 ${truncateText(design, 4e3)}`);
-  const buildReport = await readTextIfExists(join19(projectDir, "build-report.json"));
+  const buildReport = await readTextIfExists(join20(projectDir, "build-report.json"));
   if (buildReport) parts.push(`build-report.json:
 ${truncateText(buildReport, 6e3)}`);
   const timings = await beatTimingsFromBuildReport(projectDir);
@@ -46613,9 +46708,9 @@ function storyboardBeatCueSummary(storyboard) {
   }
 }
 async function readTextIfExists(path2) {
-  if (!existsSync35(path2)) return null;
+  if (!existsSync36(path2)) return null;
   try {
-    return await readFile30(path2, "utf-8");
+    return await readFile31(path2, "utf-8");
   } catch {
     return null;
   }
@@ -46909,9 +47004,9 @@ var init_video_providers = __esm({
 });
 
 // src/commands/ai-script-pipeline.ts
-import { readFile as readFile33, writeFile as writeFile39, unlink as unlink2, rename as rename3 } from "node:fs/promises";
+import { readFile as readFile34, writeFile as writeFile39, unlink as unlink2, rename as rename3 } from "node:fs/promises";
 import { resolve as resolve46, extname as extname9 } from "node:path";
-import { existsSync as existsSync37 } from "node:fs";
+import { existsSync as existsSync38 } from "node:fs";
 async function executeRegenerateScene(options) {
   const result = {
     success: false,
@@ -46920,16 +47015,16 @@ async function executeRegenerateScene(options) {
   };
   try {
     const outputDir = resolve46(process.cwd(), options.projectDir);
-    if (!existsSync37(outputDir)) {
+    if (!existsSync38(outputDir)) {
       return { ...result, error: `Project directory not found: ${outputDir}` };
     }
     const yamlPath = resolve46(outputDir, "storyboard.yaml");
     const jsonPath = resolve46(outputDir, "storyboard.json");
-    const storyboardPath2 = existsSync37(yamlPath) ? yamlPath : existsSync37(jsonPath) ? jsonPath : null;
+    const storyboardPath2 = existsSync38(yamlPath) ? yamlPath : existsSync38(jsonPath) ? jsonPath : null;
     if (!storyboardPath2) {
       return { ...result, error: `Storyboard not found in: ${outputDir} (expected storyboard.yaml or storyboard.json)` };
     }
-    const storyboardContent = await readFile33(storyboardPath2, "utf-8");
+    const storyboardContent = await readFile34(storyboardPath2, "utf-8");
     const segments = storyboardPath2.endsWith(".yaml") ? (0, import_yaml6.parse)(storyboardContent).scenes : JSON.parse(storyboardContent);
     for (const sceneNum of options.scenes) {
       if (sceneNum < 1 || sceneNum > segments.length) {
@@ -47018,15 +47113,15 @@ IMPORTANT - Character appearance must match exactly: ${characterDesc}`;
         const refSceneNum = options.referenceScene;
         if (refSceneNum && refSceneNum >= 1 && refSceneNum <= segments.length && refSceneNum !== sceneNum) {
           const refImagePath = resolve46(outputDir, `scene-${refSceneNum}.png`);
-          if (existsSync37(refImagePath)) {
-            referenceImageBuffer = await readFile33(refImagePath);
+          if (existsSync38(refImagePath)) {
+            referenceImageBuffer = await readFile34(refImagePath);
           }
         } else if (!refSceneNum) {
           for (let i = 1; i <= segments.length; i++) {
             if (i !== sceneNum) {
               const otherImagePath = resolve46(outputDir, `scene-${i}.png`);
-              if (existsSync37(otherImagePath)) {
-                referenceImageBuffer = await readFile33(otherImagePath);
+              if (existsSync38(otherImagePath)) {
+                referenceImageBuffer = await readFile34(otherImagePath);
                 break;
               }
             }
@@ -47114,11 +47209,11 @@ Generate the single-person scene image now.`;
       }
       if (regenerateVideo && videoApiKey) {
         options.onProgress?.(`Scene ${sceneNum}: regenerating video (${options.generator || "grok"})...`);
-        if (!existsSync37(imagePath)) {
+        if (!existsSync38(imagePath)) {
           result.failedScenes.push(sceneNum);
           continue;
         }
-        const imageBuffer = await readFile33(imagePath);
+        const imageBuffer = await readFile34(imagePath);
         const videoDuration = segment.duration > 5 ? 10 : 5;
         const maxRetries = options.retries ?? DEFAULT_VIDEO_RETRIES;
         if (options.generator === "grok") {
@@ -47340,9 +47435,9 @@ var init_ai_script_pipeline = __esm({
 });
 
 // src/commands/ai-highlights.ts
-import { readFile as readFile35, writeFile as writeFile41, mkdir as mkdir21 } from "node:fs/promises";
+import { readFile as readFile36, writeFile as writeFile41, mkdir as mkdir21 } from "node:fs/promises";
 import { resolve as resolve48, dirname as dirname17, basename as basename13, extname as extname10 } from "node:path";
-import { existsSync as existsSync39 } from "node:fs";
+import { existsSync as existsSync40 } from "node:fs";
 function filterHighlights(highlights, options) {
   let filtered = highlights.filter((h) => h.confidence >= options.threshold);
   filtered.sort((a, b) => b.confidence - a.confidence);
@@ -47382,7 +47477,7 @@ function truncate(text, maxLength) {
 async function executeHighlights(options) {
   try {
     const absPath = resolve48(process.cwd(), options.media);
-    if (!existsSync39(absPath)) {
+    if (!existsSync40(absPath)) {
       return { success: false, highlights: [], totalDuration: 0, totalHighlightDuration: 0, error: `File not found: ${absPath}` };
     }
     const ext = extname10(absPath).toLowerCase();
@@ -47401,7 +47496,7 @@ async function executeHighlights(options) {
       sourceDuration = await ffprobeDuration(absPath);
       const gemini = new GeminiProvider();
       await gemini.initialize({ apiKey: geminiApiKey });
-      const videoBuffer = await readFile35(absPath);
+      const videoBuffer = await readFile36(absPath);
       const criteriaText = options.criteria === "all" || !options.criteria ? "emotional, informative, and funny moments" : `${options.criteria} moments`;
       const durationText = targetDuration ? `Target a total highlight duration of ${targetDuration} seconds.` : "";
       const countText = maxCount ? `Find up to ${maxCount} highlights.` : "";
@@ -47495,10 +47590,10 @@ Analyze both what is SHOWN (visual cues, actions, expressions) and what is SAID
       }
       const whisper = new WhisperProvider();
       await whisper.initialize({ apiKey: openaiApiKey });
-      const audioBuffer = await readFile35(audioPath);
+      const audioBuffer = await readFile36(audioPath);
       const audioBlob = new Blob([audioBuffer]);
       const transcriptResult = await whisper.transcribe(audioBlob, options.language);
-      if (tempAudioPath && existsSync39(tempAudioPath)) {
+      if (tempAudioPath && existsSync40(tempAudioPath)) {
         const { unlink: unlinkFile } = await import("node:fs/promises");
         await unlinkFile(tempAudioPath).catch(() => {
         });
@@ -47585,7 +47680,7 @@ async function executeAutoShorts(options) {
       return { success: false, shorts: [], error: "FFmpeg not found" };
     }
     const absPath = resolve48(process.cwd(), options.video);
-    if (!existsSync39(absPath)) {
+    if (!existsSync40(absPath)) {
       return { success: false, shorts: [], error: `File not found: ${absPath}` };
     }
     const targetDuration = options.duration ?? 60;
@@ -47598,7 +47693,7 @@ async function executeAutoShorts(options) {
       }
       const gemini = new GeminiProvider();
       await gemini.initialize({ apiKey: geminiApiKey });
-      const videoBuffer = await readFile35(absPath);
+      const videoBuffer = await readFile36(absPath);
       const geminiPrompt = `Analyze this video to find the BEST moments for short-form vertical video content (TikTok, YouTube Shorts, Instagram Reels).
 
 Find ${shortCount * 3} potential clips that are ${targetDuration} seconds or shorter each.
@@ -47675,7 +47770,7 @@ Analyze both VISUALS (expressions, actions, scene changes) and AUDIO (speech, re
       await execSafe("ffmpeg", ["-i", absPath, "-vn", "-acodec", "libmp3lame", "-q:a", "2", tempAudio, "-y"]);
       const whisper = new WhisperProvider();
       await whisper.initialize({ apiKey: openaiApiKey });
-      const audioBuffer = await readFile35(tempAudio);
+      const audioBuffer = await readFile36(tempAudio);
       const audioBlob = new Blob([audioBuffer]);
       const transcript = await whisper.transcribe(audioBlob, options.language);
       try {
@@ -47713,7 +47808,7 @@ Analyze both VISUALS (expressions, actions, scene changes) and AUDIO (speech, re
       };
     }
     const outputDir = options.outputDir ? resolve48(process.cwd(), options.outputDir) : dirname17(absPath);
-    if (options.outputDir && !existsSync39(outputDir)) {
+    if (options.outputDir && !existsSync40(outputDir)) {
       await mkdir21(outputDir, { recursive: true });
     }
     const result = {
@@ -47796,7 +47891,7 @@ function registerHighlightsCommands(aiCommand) {
         validateOutputPath(options.output);
       }
       const absPath = resolve48(process.cwd(), mediaPath);
-      if (!existsSync39(absPath)) {
+      if (!existsSync40(absPath)) {
         exitWithError(notFoundError(absPath));
       }
       if (options.dryRun) {
@@ -47853,7 +47948,7 @@ function registerHighlightsCommands(aiCommand) {
         const geminiSpinner = ora("\u{1F3AC} Analyzing video with Gemini (visual + audio)...").start();
         const gemini = new GeminiProvider();
         await gemini.initialize({ apiKey: geminiApiKey });
-        const videoBuffer = await readFile35(absPath);
+        const videoBuffer = await readFile36(absPath);
         const criteriaText = options.criteria === "all" ? "emotional, informative, and funny moments" : `${options.criteria} moments`;
         const durationText = targetDuration ? `Target a total highlight duration of ${targetDuration} seconds.` : "";
         const countText = maxCount ? `Find up to ${maxCount} highlights.` : "";
@@ -47978,12 +48073,12 @@ Analyze both what is SHOWN (visual cues, actions, expressions) and what is SAID
         const transcribeSpinner = ora("\u{1F4DD} Transcribing with Whisper...").start();
         const whisper = new WhisperProvider();
         await whisper.initialize({ apiKey: openaiApiKey });
-        const audioBuffer = await readFile35(audioPath);
+        const audioBuffer = await readFile36(audioPath);
         const audioBlob = new Blob([audioBuffer]);
         const transcriptResult = await whisper.transcribe(audioBlob, options.language);
         if (transcriptResult.status === "failed" || !transcriptResult.segments) {
           transcribeSpinner.fail("Transcription failed");
-          if (tempAudioPath && existsSync39(tempAudioPath)) {
+          if (tempAudioPath && existsSync40(tempAudioPath)) {
             const { unlink: unlinkFile } = await import("node:fs/promises");
             await unlinkFile(tempAudioPath).catch(() => {
             });
@@ -47991,7 +48086,7 @@ Analyze both what is SHOWN (visual cues, actions, expressions) and what is SAID
           exitWithError(apiError(`Transcription failed: ${transcriptResult.error}`, true));
         }
         transcribeSpinner.succeed(source_default.green(`Transcribed ${transcriptResult.segments.length} segments`));
-        if (tempAudioPath && existsSync39(tempAudioPath)) {
+        if (tempAudioPath && existsSync40(tempAudioPath)) {
           const { unlink: unlinkFile } = await import("node:fs/promises");
           await unlinkFile(tempAudioPath).catch(() => {
           });
@@ -48097,7 +48192,7 @@ Analyze both what is SHOWN (visual cues, actions, expressions) and what is SAID
         validateOutputPath(options.output);
       }
       const absPath = resolve48(process.cwd(), videoPath);
-      if (!existsSync39(absPath)) {
+      if (!existsSync40(absPath)) {
         exitWithError(notFoundError(absPath));
       }
       if (options.dryRun) {
@@ -48147,7 +48242,7 @@ Analyze both what is SHOWN (visual cues, actions, expressions) and what is SAID
         const spinner2 = ora("\u{1F3AC} Analyzing video with Gemini (visual + audio)...").start();
         const gemini = new GeminiProvider();
         await gemini.initialize({ apiKey: geminiApiKey });
-        const videoBuffer = await readFile35(absPath);
+        const videoBuffer = await readFile36(absPath);
         const geminiPrompt = `Analyze this video to find the BEST moments for short-form vertical video content (TikTok, YouTube Shorts, Instagram Reels).
 
 Find ${shortCount * 3} potential clips that are ${targetDuration} seconds or shorter each.
@@ -48244,7 +48339,7 @@ Analyze both VISUALS (expressions, actions, scene changes) and AUDIO (speech, re
         spinner2.text = "Transcribing audio...";
         const whisper = new WhisperProvider();
         await whisper.initialize({ apiKey: openaiApiKey });
-        const audioBuffer = await readFile35(tempAudio);
+        const audioBuffer = await readFile36(tempAudio);
         const audioBlob = new Blob([audioBuffer]);
         const transcript = await whisper.transcribe(audioBlob, options.language);
         try {
@@ -48290,7 +48385,7 @@ Analyze both VISUALS (expressions, actions, scene changes) and AUDIO (speech, re
         return;
       }
       const outputDir = options.outputDir ? resolve48(process.cwd(), options.outputDir) : dirname17(absPath);
-      if (options.outputDir && !existsSync39(outputDir)) {
+      if (options.outputDir && !existsSync40(outputDir)) {
         await mkdir21(outputDir, { recursive: true });
       }
       for (let i = 0; i < selectedHighlights.length; i++) {
@@ -48307,7 +48402,7 @@ Analyze both VISUALS (expressions, actions, scene changes) and AUDIO (speech, re
           outputPath = resolve48(outputDir, `${baseName}-short-${i + 1}.mp4`);
         }
         const parentDir = dirname17(outputPath);
-        if (!existsSync39(parentDir)) {
+        if (!existsSync40(parentDir)) {
           await mkdir21(parentDir, { recursive: true });
         }
         const { stdout: probeOut } = await execSafe("ffprobe", [
@@ -48382,7 +48477,7 @@ var init_ai_highlights = __esm({
 // src/commands/ai-animated-caption.ts
 import { resolve as resolve49, dirname as dirname18, basename as basename14 } from "node:path";
 import { writeFile as writeFile42, mkdir as mkdir22, rm as rm3 } from "node:fs/promises";
-import { existsSync as existsSync40 } from "node:fs";
+import { existsSync as existsSync41 } from "node:fs";
 import { tmpdir as tmpdir3 } from "node:os";
 function groupWords(words, options = {}) {
   if (words.length === 0) return [];
@@ -48559,7 +48654,7 @@ async function executeAnimatedCaption(options) {
     const groups = groupWords(transcript.words, { wordsPerGroup, maxChars });
     const absOutputPath = resolve49(process.cwd(), outputPath);
     const outDir = dirname18(absOutputPath);
-    if (!existsSync40(outDir)) {
+    if (!existsSync41(outDir)) {
       await mkdir22(outDir, { recursive: true });
     }
     if (tier === "ass") {
@@ -58242,7 +58337,7 @@ __export(detect_exports, {
   executeDetectScenes: () => executeDetectScenes,
   executeDetectSilence: () => executeDetectSilence
 });
-import { readFile as readFile37, writeFile as writeFile44 } from "node:fs/promises";
+import { readFile as readFile38, writeFile as writeFile44 } from "node:fs/promises";
 import { resolve as resolve53, basename as basename18 } from "node:path";
 async function executeDetectScenes(options) {
   try {
@@ -58486,7 +58581,7 @@ var init_detect = __esm({
         }
         if (options.project) {
           const projectPath = resolve53(process.cwd(), options.project);
-          const content = await readFile37(projectPath, "utf-8");
+          const content = await readFile38(projectPath, "utf-8");
           const data = JSON.parse(content);
           const project = Project.fromJSON(data);
           let source = project.getSources().find((s) => s.url === absPath);
@@ -60177,14 +60272,14 @@ var init_adapters = __esm({
 });
 
 // src/commands/_shared/storyboard-revise.ts
-import { existsSync as existsSync44 } from "node:fs";
-import { readFile as readFile41, writeFile as writeFile47 } from "node:fs/promises";
-import { join as join22, resolve as resolve57 } from "node:path";
+import { existsSync as existsSync45 } from "node:fs";
+import { readFile as readFile42, writeFile as writeFile47 } from "node:fs/promises";
+import { join as join23, resolve as resolve57 } from "node:path";
 async function executeStoryboardRevision(opts) {
   const projectDir = resolve57(opts.projectDir);
-  const storyboardPath2 = join22(projectDir, "STORYBOARD.md");
+  const storyboardPath2 = join23(projectDir, "STORYBOARD.md");
   const retryWith = [`vibe storyboard revise ${projectDir} --from "<request>" --dry-run --json`];
-  if (!existsSync44(storyboardPath2)) {
+  if (!existsSync45(storyboardPath2)) {
     return failureResult({
       projectDir,
       storyboardPath: storyboardPath2,
@@ -60194,7 +60289,7 @@ async function executeStoryboardRevision(opts) {
       retryWith: [`vibe init ${projectDir} --from "<brief>" --json`]
     });
   }
-  const currentStoryboard = await readFile41(storyboardPath2, "utf-8");
+  const currentStoryboard = await readFile42(storyboardPath2, "utf-8");
   const projectConfig = await readProjectConfig(projectDir);
   const explicitComposer = opts.composer ?? projectConfig.config.providers.composer ?? void 0;
   let provider = explicitComposer ?? "claude";
@@ -60417,18 +60512,18 @@ function diffChangedBeats(before, after) {
   return ids.filter((id) => JSON.stringify(beforeBeats.get(id) ?? null) !== JSON.stringify(afterBeats.get(id) ?? null));
 }
 async function readRevisionContext(projectDir) {
-  const designMd = await readOptionalText(join22(projectDir, "DESIGN.md"));
-  const buildReportJson = await readOptionalJsonText(join22(projectDir, "build-report.json"));
+  const designMd = await readOptionalText(join23(projectDir, "DESIGN.md"));
+  const buildReportJson = await readOptionalJsonText(join23(projectDir, "build-report.json"));
   return { designMd, buildReportJson };
 }
 async function readOptionalText(path2) {
-  if (!existsSync44(path2)) return null;
-  return readFile41(path2, "utf-8");
+  if (!existsSync45(path2)) return null;
+  return readFile42(path2, "utf-8");
 }
 async function readOptionalJsonText(path2) {
-  if (!existsSync44(path2)) return null;
+  if (!existsSync45(path2)) return null;
   try {
-    const parsed = JSON.parse(await readFile41(path2, "utf-8"));
+    const parsed = JSON.parse(await readFile42(path2, "utf-8"));
     return JSON.stringify(parsed, null, 2);
   } catch {
     return null;
@@ -60476,7 +60571,7 @@ var init_storyboard_revise = __esm({
 });
 
 // src/commands/_shared/build-asset-reference.ts
-import { existsSync as existsSync46 } from "node:fs";
+import { existsSync as existsSync47 } from "node:fs";
 import { extname as extname13, isAbsolute as isAbsolute5, relative as relative10, resolve as resolve59, sep } from "node:path";
 function resolveTypedAssetReference(projectDir, kind, value) {
   const raw = stringOrUndefined2(value);
@@ -60507,7 +60602,7 @@ function resolveReference(projectDir, kind, raw, source, forcedError) {
   const absPath = isAbsolute5(raw) ? resolve59(raw) : resolve59(projectDir, raw);
   const rel = relative10(resolve59(projectDir), absPath);
   const withinProject = rel.length > 0 && !rel.startsWith("..") && !isAbsolute5(rel);
-  const exists = withinProject && existsSync46(absPath);
+  const exists = withinProject && existsSync47(absPath);
   let error = forcedError;
   if (!error && inferred && inferred !== kind && !isNarrationAudioReference(kind, ext)) {
     error = `Asset reference "${raw}" is a ${inferred} asset, not ${kind}.`;
@@ -60694,9 +60789,9 @@ var init_build_backdrop_prompt = __esm({
 });
 
 // src/commands/_shared/build-plan.ts
-import { existsSync as existsSync47 } from "node:fs";
-import { readFile as readFile43 } from "node:fs/promises";
-import { dirname as dirname21, join as join23, resolve as resolve60 } from "node:path";
+import { existsSync as existsSync48 } from "node:fs";
+import { readFile as readFile44 } from "node:fs/promises";
+import { dirname as dirname21, join as join24, resolve as resolve60 } from "node:path";
 function backdropCostUsd(quality) {
   return quality === "hd" ? 0.2 : 0.05;
 }
@@ -60705,11 +60800,11 @@ async function createBuildPlan(opts) {
   loadPlanEnv(projectDir);
   const stage = opts.stage ?? "all";
   const config2 = await readProjectConfig(projectDir);
-  const storyboardPath2 = join23(projectDir, "STORYBOARD.md");
+  const storyboardPath2 = join24(projectDir, "STORYBOARD.md");
   const warnings = [];
   const retryWith = [];
   const providerResolution = [];
-  if (!existsSync47(storyboardPath2)) {
+  if (!existsSync48(storyboardPath2)) {
     const validation2 = {
       ok: false,
       issues: [
@@ -60738,7 +60833,7 @@ async function createBuildPlan(opts) {
       validation: validation2
     });
   }
-  const storyboardMd = await readFile43(storyboardPath2, "utf-8");
+  const storyboardMd = await readFile44(storyboardPath2, "utf-8");
   const validation = validateStoryboardMarkdown(storyboardMd);
   const validationIssues = [...validation.issues];
   const parsed = parseStoryboard(storyboardMd);
@@ -60764,7 +60859,7 @@ async function createBuildPlan(opts) {
   const imageQuality = opts.imageQuality ?? config2.config.build.imageQuality ?? "hd";
   const imageSize2 = opts.imageSize ?? config2.config.build.imageSize ?? "1536x1024";
   const imageRatio = imageRatioForSize(imageSize2);
-  const needsComposer = includeCompose && mode !== "agent" && sourceBeats.some((beat) => !existsSync47(join23(projectDir, `compositions/scene-${beat.id}.html`)));
+  const needsComposer = includeCompose && mode !== "agent" && sourceBeats.some((beat) => !existsSync48(join24(projectDir, `compositions/scene-${beat.id}.html`)));
   const resolved = await resolvePlanProviders({
     projectDir,
     config: config2,
@@ -60912,7 +61007,7 @@ async function createBuildPlan(opts) {
       active: includeAssets
     }) : null;
     const compositionPath = `compositions/scene-${beat.id}.html`;
-    const compositionExists = existsSync47(join23(projectDir, compositionPath));
+    const compositionExists = existsSync48(join24(projectDir, compositionPath));
     for (const asset of [narration, backdrop, keyframe, video, music]) {
       if (!asset) continue;
       if (asset.referenceError) {
@@ -60981,7 +61076,7 @@ async function createBuildPlan(opts) {
     }
   }
   const validationOk = !validationIssues.some((issue) => issue.severity === "error");
-  if (!existsSync47(join23(projectDir, config2.config.composition.entry))) {
+  if (!existsSync48(join24(projectDir, config2.config.composition.entry))) {
     missing.add("root-composition");
     if (validationOk) retryWith.push(`vibe build ${projectDir} --stage sync --json`);
   }
@@ -61015,7 +61110,7 @@ async function createBuildPlan(opts) {
     }
     if (referenced.size > 0) {
       const toGenerate = resolveCharacters(parsed.frontmatter).filter(
-        (c) => referenced.has(c.name) && c.prompt && (opts.force || !existsSync47(join23(projectDir, `assets/character-${c.name}.png`)))
+        (c) => referenced.has(c.name) && c.prompt && (opts.force || !existsSync48(join24(projectDir, `assets/character-${c.name}.png`)))
       );
       if (toGenerate.length > 0) {
         estimatedCostUsd += toGenerate.length * backdropCostUsd(opts.imageQuality ?? "hd");
@@ -61128,8 +61223,8 @@ function assetPlan(opts) {
       reason: ready ? "referenced-asset" : "invalid-reference"
     };
   }
-  const canonicalExists = existsSync47(join23(opts.projectDir, opts.path));
-  const cacheHit = opts.cache ? existsSync47(join23(opts.projectDir, opts.cache.path)) : false;
+  const canonicalExists = existsSync48(join24(opts.projectDir, opts.path));
+  const cacheHit = opts.cache ? existsSync48(join24(opts.projectDir, opts.cache.path)) : false;
   const freshness = assetFreshnessFromMetadata({
     projectDir: opts.projectDir,
     kind: opts.kind,
@@ -61327,7 +61422,7 @@ async function firstConfiguredComposer(projectDir) {
 }
 function firstExisting2(projectDir, paths) {
   for (const path2 of paths) {
-    if (existsSync47(join23(projectDir, path2))) return path2;
+    if (existsSync48(join24(projectDir, path2))) return path2;
   }
   return null;
 }
@@ -61368,12 +61463,12 @@ function unique3(items) {
   return [...new Set(items.filter((item) => item.length > 0))];
 }
 function loadPlanEnv(projectDir) {
-  (0, import_dotenv3.config)({ path: join23(projectDir, ".env"), quiet: true });
+  (0, import_dotenv3.config)({ path: join24(projectDir, ".env"), quiet: true });
   (0, import_dotenv3.config)({ path: resolve60(process.cwd(), ".env"), quiet: true });
   let dir = process.cwd();
   while (dir !== dirname21(dir)) {
-    if (existsSync47(join23(dir, "pnpm-workspace.yaml"))) {
-      (0, import_dotenv3.config)({ path: join23(dir, ".env"), quiet: true });
+    if (existsSync48(join24(dir, "pnpm-workspace.yaml"))) {
+      (0, import_dotenv3.config)({ path: join24(dir, ".env"), quiet: true });
       return;
     }
     dir = dirname21(dir);
@@ -61454,7 +61549,7 @@ var init_concurrency = __esm({
 });
 
 // src/commands/_shared/scene-audio-scan.ts
-import { readFile as readFile44 } from "node:fs/promises";
+import { readFile as readFile45 } from "node:fs/promises";
 import { resolve as resolve62 } from "node:path";
 function parseRootClips(rootHtml) {
   const clips = [];
@@ -61495,7 +61590,7 @@ function makeFsCompositionReader(projectDir) {
   return async (compositionSrcRel) => {
     const abs = resolve62(projectDir, compositionSrcRel);
     try {
-      return await readFile44(abs, "utf-8");
+      return await readFile45(abs, "utf-8");
     } catch {
       return null;
     }
@@ -61695,9 +61790,9 @@ __export(scene_render_exports, {
   qualityToCrf: () => qualityToCrf2
 });
 import { execFile as execFile2 } from "node:child_process";
-import { existsSync as existsSync48 } from "node:fs";
-import { mkdir as mkdir25, readFile as readFile45, stat as stat8, writeFile as writeFile49 } from "node:fs/promises";
-import { resolve as resolve64, relative as relative11, dirname as dirname23, basename as basename21, join as join24, isAbsolute as isAbsolute6 } from "node:path";
+import { existsSync as existsSync49 } from "node:fs";
+import { mkdir as mkdir25, readFile as readFile46, stat as stat8, writeFile as writeFile49 } from "node:fs/promises";
+import { resolve as resolve64, relative as relative11, dirname as dirname23, basename as basename21, join as join25, isAbsolute as isAbsolute6 } from "node:path";
 import { promisify as promisify2 } from "node:util";
 import {
   createRenderJob,
@@ -61789,7 +61884,7 @@ async function executeSceneRender(opts = {}) {
   }
   let autoSyncApplied = false;
   let autoSyncWarning;
-  if (!opts.beatId && existsSync48(join24(projectDir, "STORYBOARD.md"))) {
+  if (!opts.beatId && existsSync49(join25(projectDir, "STORYBOARD.md"))) {
     try {
       const rootPlan = await createProjectRootSyncPlan({ projectDir });
       const subPlans = await createSubCompDurationSyncPlans({
@@ -61881,7 +61976,7 @@ async function executeSceneRender(opts = {}) {
   let audioMuxWarning;
   try {
     opts.onProgress?.(0.95, "Mixing audio");
-    const rootHtml = await readFile45(resolve64(projectDir, root), "utf-8");
+    const rootHtml = await readFile46(resolve64(projectDir, root), "utf-8");
     const audios = await scanSceneAudio({ projectDir, rootHtml });
     audioCount = audios.length;
     if (audios.length > 0) {
@@ -61966,11 +62061,11 @@ async function safeStat(p) {
 }
 async function prepareBeatRenderRoot(opts) {
   const root = `.vibeframe/tmp/render-beat-${sanitizeFileSegment2(opts.beatId)}.html`;
-  const reportPath = join24(opts.projectDir, "build-report.json");
+  const reportPath = join25(opts.projectDir, "build-report.json");
   const retryWith = [
     `vibe build ${opts.projectDir} --beat ${opts.beatId} --stage sync --json`
   ];
-  if (!existsSync48(reportPath)) {
+  if (!existsSync49(reportPath)) {
     return {
       success: false,
       root,
@@ -61981,7 +62076,7 @@ async function prepareBeatRenderRoot(opts) {
   }
   let report;
   try {
-    report = JSON.parse(await readFile45(reportPath, "utf-8"));
+    report = JSON.parse(await readFile46(reportPath, "utf-8"));
   } catch (error) {
     return {
       success: false,
@@ -62050,8 +62145,8 @@ async function prepareBeatRenderRoot(opts) {
     durationSec,
     narrationPath
   });
-  await mkdir25(dirname23(join24(opts.projectDir, root)), { recursive: true });
-  await writeFile49(join24(opts.projectDir, root), html, "utf-8");
+  await mkdir25(dirname23(join25(opts.projectDir, root)), { recursive: true });
+  await writeFile49(join25(opts.projectDir, root), html, "utf-8");
   return {
     success: true,
     root,
@@ -62115,7 +62210,7 @@ function reportedBeatAssetPaths(beat) {
   ]);
 }
 async function writeRenderReport(projectDir, result) {
-  const reportPath = join24(projectDir, "render-report.json");
+  const reportPath = join25(projectDir, "render-report.json");
   try {
     await writeFile49(
       reportPath,
@@ -62157,7 +62252,7 @@ async function writeRenderReport(projectDir, result) {
 }
 function pathExists3(projectDir, value) {
   const abs = isAbsolute6(value) ? value : resolve64(projectDir, value);
-  return existsSync48(abs);
+  return existsSync49(abs);
 }
 function stringValue(value) {
   return typeof value === "string" && value.length > 0 ? value : void 0;
@@ -62216,9 +62311,9 @@ __export(scene_build_exports, {
   executeSceneBuild: () => executeSceneBuild,
   resolveSceneBuildMode: () => resolveSceneBuildMode
 });
-import { existsSync as existsSync49, readFileSync as readFileSync3 } from "node:fs";
-import { copyFile as copyFile5, mkdir as mkdir26, readFile as readFile46, rm as rm4, writeFile as writeFile50 } from "node:fs/promises";
-import { dirname as dirname24, join as join25, resolve as resolve65 } from "node:path";
+import { existsSync as existsSync50, readFileSync as readFileSync3 } from "node:fs";
+import { copyFile as copyFile5, mkdir as mkdir26, readFile as readFile47, rm as rm4, writeFile as writeFile50 } from "node:fs/promises";
+import { dirname as dirname24, join as join26, resolve as resolve65 } from "node:path";
 async function executeSceneBuild(opts) {
   const startedAt = Date.now();
   const projectDir = resolve65(opts.projectDir);
@@ -62237,7 +62332,7 @@ async function executeSceneBuild(opts) {
     );
   }
   let sceneRepair = skippedSceneRepairSummary();
-  const storyboardPath2 = join25(projectDir, "STORYBOARD.md");
+  const storyboardPath2 = join26(projectDir, "STORYBOARD.md");
   const buildPlan = await createBuildPlan({
     projectDir,
     stage: selectedStage,
@@ -62288,8 +62383,8 @@ async function executeSceneBuild(opts) {
   }
   if (!buildPlan.validation.ok) {
     let invalidBeats = [];
-    if (existsSync49(storyboardPath2)) {
-      invalidBeats = parseStoryboard(await readFile46(storyboardPath2, "utf-8")).beats;
+    if (existsSync50(storyboardPath2)) {
+      invalidBeats = parseStoryboard(await readFile47(storyboardPath2, "utf-8")).beats;
     }
     return finishBuildResult({
       success: false,
@@ -62313,7 +62408,7 @@ async function executeSceneBuild(opts) {
       totalLatencyMs: Date.now() - startedAt
     });
   }
-  if (!existsSync49(storyboardPath2)) {
+  if (!existsSync50(storyboardPath2)) {
     return finishBuildResult({
       success: false,
       phase: "failed",
@@ -62327,7 +62422,7 @@ async function executeSceneBuild(opts) {
       totalLatencyMs: Date.now() - startedAt
     });
   }
-  const storyboardMd = await readFile46(storyboardPath2, "utf-8");
+  const storyboardMd = await readFile47(storyboardPath2, "utf-8");
   const parsed = parseStoryboard(storyboardMd);
   if (parsed.beats.length === 0) {
     return finishBuildResult({
@@ -62434,6 +62529,7 @@ async function executeSceneBuild(opts) {
         skipVideo: opts.skipVideo ?? false,
         skipKeyframe: opts.skipKeyframe ?? false,
         skipMusic: opts.skipMusic ?? false,
+        skipTranscript: opts.skipTranscript ?? false,
         force: opts.force ?? false,
         onProgress,
         characterPaths
@@ -62521,9 +62617,9 @@ async function executeSceneBuild(opts) {
   let composeData;
   if (shouldRunStage(selectedStage, "compose")) {
     if (mode === "agent") {
-      const compositionsDir = join25(projectDir, "compositions");
+      const compositionsDir = join26(projectDir, "compositions");
       const missingBeats = activeBeats.filter(
-        (b) => !existsSync49(join25(compositionsDir, `scene-${b.id}.html`))
+        (b) => !existsSync50(join26(compositionsDir, `scene-${b.id}.html`))
       );
       if (missingBeats.length > 0) {
         const plan = await getComposePrompts({ projectDir, beatId: opts.beatId });
@@ -62612,8 +62708,8 @@ async function executeSceneBuild(opts) {
   if (stageReports.compose.status === "done") {
     for (const beat of activeBeats) {
       const videoRel = `assets/video-${beat.id}.mp4`;
-      const compositionAbs = join25(projectDir, "compositions", `scene-${beat.id}.html`);
-      if (!existsSync49(join25(projectDir, videoRel)) || !existsSync49(compositionAbs)) continue;
+      const compositionAbs = join26(projectDir, "compositions", `scene-${beat.id}.html`);
+      if (!existsSync50(join26(projectDir, videoRel)) || !existsSync50(compositionAbs)) continue;
       const html = readFileSync3(compositionAbs, "utf-8");
       if (!html.includes(videoRel)) {
         warnings.push(
@@ -62671,7 +62767,7 @@ async function executeSceneBuild(opts) {
     });
   }
   if (shouldRunStage(selectedStage, "sync")) {
-    if (!existsSync49(join25(projectDir, "index.html"))) {
+    if (!existsSync50(join26(projectDir, "index.html"))) {
       await scaffoldSceneProject({
         dir: projectDir,
         name: projectDir.split(/[\\/]/).filter(Boolean).pop(),
@@ -62816,6 +62912,9 @@ async function buildBeatPrimitives(beat, ctx) {
     ctx.skipVideo ? skipped("video", beat.id, "--skip-video", ctx) : dispatchVideo(beat, ctx, keyframe),
     ctx.skipMusic ? skipped("music", beat.id, "--skip-music", ctx) : dispatchMusic(beat, ctx)
   ]);
+  if (!ctx.skipTranscript) {
+    await dispatchTranscript(beat, narration, ctx);
+  }
   return {
     outcome: {
       beatId: beat.id,
@@ -62933,7 +63032,7 @@ async function dispatchNarration(beat, ctx) {
       return {
         status: "cached",
         path: existingRel,
-        durationSec: await safeAudioDuration(join25(ctx.projectDir, existingRel)),
+        durationSec: await safeAudioDuration(join26(ctx.projectDir, existingRel)),
         provider: metadata?.provider,
         cachePath: metadata?.cachePath,
         cacheKey: metadata?.cacheKey,
@@ -62957,9 +63056,9 @@ async function dispatchNarration(beat, ctx) {
     voice,
     ext: resolution.audioExtension
   });
-  const cacheAbs = join25(ctx.projectDir, cache.path);
+  const cacheAbs = join26(ctx.projectDir, cache.path);
   const rel = `assets/narration-${beat.id}.${resolution.audioExtension}`;
-  const abs = join25(ctx.projectDir, rel);
+  const abs = join26(ctx.projectDir, rel);
   if (existingRel && !ctx.force && isFreshCanonicalAsset({
     projectDir: ctx.projectDir,
     kind: "narration",
@@ -62973,7 +63072,7 @@ async function dispatchNarration(beat, ctx) {
     return {
       status: "cached",
       path: existingRel,
-      durationSec: await safeAudioDuration(join25(ctx.projectDir, existingRel)),
+      durationSec: await safeAudioDuration(join26(ctx.projectDir, existingRel)),
       provider: resolution.provider,
       cachePath: cache.path,
       cacheKey: cache.key,
@@ -62981,7 +63080,7 @@ async function dispatchNarration(beat, ctx) {
       freshness: "fresh"
     };
   }
-  if (existsSync49(cacheAbs) && !ctx.force) {
+  if (existsSync50(cacheAbs) && !ctx.force) {
     await mkdir26(dirname24(abs), { recursive: true });
     await copyFile5(cacheAbs, abs);
     await writeAssetMetadata({
@@ -63016,8 +63115,8 @@ async function dispatchNarration(beat, ctx) {
   await mkdir26(dirname24(abs), { recursive: true });
   await writeFile50(abs, result.audioBuffer);
   for (const otherExt of ["mp3", "wav"]) {
-    const sibling = join25(ctx.projectDir, `assets/narration-${beat.id}.${otherExt}`);
-    if (sibling !== abs && existsSync49(sibling)) await rm4(sibling, { force: true });
+    const sibling = join26(ctx.projectDir, `assets/narration-${beat.id}.${otherExt}`);
+    if (sibling !== abs && existsSync50(sibling)) await rm4(sibling, { force: true });
   }
   await mkdir26(dirname24(cacheAbs), { recursive: true });
   await writeFile50(cacheAbs, result.audioBuffer);
@@ -63049,6 +63148,42 @@ async function dispatchNarration(beat, ctx) {
     freshness: "fresh"
   };
 }
+async function dispatchTranscript(beat, narration, ctx) {
+  if (!narration.path) return;
+  const relPath = beatTranscriptRelPath(beat.id);
+  const abs = join26(ctx.projectDir, relPath);
+  const narrationFresh = narration.status === "generated";
+  if (existsSync50(abs) && !ctx.force && !narrationFresh) {
+    ctx.onProgress({ type: "transcript-cached", beatId: beat.id, path: relPath });
+    return;
+  }
+  const apiKey = await getConfiguredApiKey("OPENAI_API_KEY", void 0, { cwd: ctx.projectDir });
+  if (!apiKey) {
+    ctx.onProgress({
+      type: "transcript-skipped",
+      beatId: beat.id,
+      reason: "OPENAI_API_KEY not set \u2014 narration plays but word-sync timings unavailable"
+    });
+    return;
+  }
+  const words = await transcribeNarrationWords(join26(ctx.projectDir, narration.path), { apiKey });
+  if (words.length === 0) {
+    ctx.onProgress({
+      type: "transcript-skipped",
+      beatId: beat.id,
+      reason: "transcription returned no word timings"
+    });
+    return;
+  }
+  await mkdir26(dirname24(abs), { recursive: true });
+  await writeFile50(abs, JSON.stringify(words, null, 2), "utf-8");
+  ctx.onProgress({
+    type: "transcript-generated",
+    beatId: beat.id,
+    path: relPath,
+    wordCount: words.length
+  });
+}
 function characterSheetPrompt(name, description) {
   return [
     `Character reference sheet of an original fictional character named ${name}: ${description}.`,
@@ -63066,7 +63201,7 @@ async function buildCharacters(characters, ctx) {
   const size = ctx.imageSize ?? "1536x1024";
   for (const character of characters) {
     if (character.imagePath) {
-      if (existsSync49(join25(ctx.projectDir, character.imagePath))) {
+      if (existsSync50(join26(ctx.projectDir, character.imagePath))) {
         paths.set(character.name, character.imagePath);
         ctx.onProgress({ type: "character-cached", name: character.name, path: character.imagePath });
       } else {
@@ -63079,7 +63214,7 @@ 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 = join25(ctx.projectDir, rel);
+    const abs = join26(ctx.projectDir, rel);
     const metadataOptions = { quality: ctx.imageQuality, size };
     const cache = characterCacheDescriptor({
       name: character.name,
@@ -63088,7 +63223,7 @@ async function buildCharacters(characters, ctx) {
       quality: ctx.imageQuality,
       size
     });
-    if (existsSync49(abs) && !ctx.force) {
+    if (existsSync50(abs) && !ctx.force) {
       const metadata = readAssetMetadata(ctx.projectDir, "character", character.name);
       if (!metadata || isFreshCanonicalAsset({
         projectDir: ctx.projectDir,
@@ -63104,8 +63239,8 @@ async function buildCharacters(characters, ctx) {
         continue;
       }
     }
-    const cacheAbs = join25(ctx.projectDir, cache.path);
-    if (existsSync49(cacheAbs) && !ctx.force) {
+    const cacheAbs = join26(ctx.projectDir, cache.path);
+    if (existsSync50(cacheAbs) && !ctx.force) {
       await mkdir26(dirname24(abs), { recursive: true });
       await copyFile5(cacheAbs, abs);
       await writeAssetMetadata({
@@ -63171,7 +63306,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 = join25(ctx.projectDir, rel);
+  const abs = join26(ctx.projectDir, rel);
   const size = ctx.imageSize ?? "1536x1024";
   const ratio = imageRatioForSize(size);
   const metadataOptions = { quality: ctx.imageQuality, size, ratio };
@@ -63184,7 +63319,7 @@ async function dispatchBackdrop(beat, ctx) {
     ratio
   });
   const metadataPath = assetMetadataPath("backdrop", beat.id);
-  if (existsSync49(abs) && !ctx.force) {
+  if (existsSync50(abs) && !ctx.force) {
     const metadata = readAssetMetadata(ctx.projectDir, "backdrop", beat.id);
     if (!metadata || isFreshCanonicalAsset({
       projectDir: ctx.projectDir,
@@ -63207,8 +63342,8 @@ async function dispatchBackdrop(beat, ctx) {
       };
     }
   }
-  const cacheAbs = join25(ctx.projectDir, cache.path);
-  if (existsSync49(cacheAbs) && !ctx.force) {
+  const cacheAbs = join26(ctx.projectDir, cache.path);
+  if (existsSync50(cacheAbs) && !ctx.force) {
     await mkdir26(dirname24(abs), { recursive: true });
     await copyFile5(cacheAbs, abs);
     await writeAssetMetadata({
@@ -63340,7 +63475,7 @@ async function editKeyframeImage(prompt3, sheetBuffers, ctx, ratio) {
 }
 async function ensureKeyframe(beat, ctx, keyframeCue, characterRefsRel) {
   const rel = `assets/keyframe-${beat.id}.png`;
-  const abs = join25(ctx.projectDir, rel);
+  const abs = join26(ctx.projectDir, rel);
   const size = ctx.imageSize ?? "1536x1024";
   const ratio = imageRatioForSize(size);
   const metadataOptions = { quality: ctx.imageQuality, size, ratio };
@@ -63353,7 +63488,7 @@ async function ensureKeyframe(beat, ctx, keyframeCue, characterRefsRel) {
     ratio,
     characters: characterRefsRel
   });
-  if (existsSync49(abs) && !ctx.force) {
+  if (existsSync50(abs) && !ctx.force) {
     const metadata = readAssetMetadata(ctx.projectDir, "keyframe", beat.id);
     if (!metadata || isFreshCanonicalAsset({
       projectDir: ctx.projectDir,
@@ -63367,8 +63502,8 @@ async function ensureKeyframe(beat, ctx, keyframeCue, characterRefsRel) {
       return { status: "cached", rel };
     }
   }
-  const cacheAbs = join25(ctx.projectDir, cache.path);
-  if (existsSync49(cacheAbs) && !ctx.force) {
+  const cacheAbs = join26(ctx.projectDir, cache.path);
+  if (existsSync50(cacheAbs) && !ctx.force) {
     await mkdir26(dirname24(abs), { recursive: true });
     await copyFile5(cacheAbs, abs);
     await writeAssetMetadata({
@@ -63386,8 +63521,8 @@ async function ensureKeyframe(beat, ctx, keyframeCue, characterRefsRel) {
   }
   const sheetBuffers = [];
   for (const relPath of characterRefsRel) {
-    const sheetAbs = join25(ctx.projectDir, relPath);
-    if (existsSync49(sheetAbs)) sheetBuffers.push(await readFile46(sheetAbs));
+    const sheetAbs = join26(ctx.projectDir, relPath);
+    if (existsSync50(sheetAbs)) sheetBuffers.push(await readFile47(sheetAbs));
   }
   const imgCtx = {
     projectDir: ctx.projectDir,
@@ -63456,9 +63591,9 @@ async function dispatchVideo(beat, ctx, keyframe) {
   const prompt3 = stringOrUndefined4(beat.cues?.video) ?? keyframeCue;
   if (!prompt3) return { status: "no-cue" };
   const characterRefsRel = beatCharacterNames(beat.cues).map((name) => ctx.characterPaths?.get(name)).filter((p) => typeof p === "string");
-  const characterRefsAbs = characterRefsRel.map((p) => join25(ctx.projectDir, p));
+  const characterRefsAbs = characterRefsRel.map((p) => join26(ctx.projectDir, p));
   const rel = `assets/video-${beat.id}.mp4`;
-  const abs = join25(ctx.projectDir, rel);
+  const abs = join26(ctx.projectDir, rel);
   const cache = videoCacheDescriptor({
     beatId: beat.id,
     cue: prompt3,
@@ -63470,7 +63605,7 @@ async function dispatchVideo(beat, ctx, keyframe) {
     keyframe: keyframeCue
   });
   const metadataPath = assetMetadataPath("video", beat.id);
-  if (existsSync49(abs) && !ctx.force) {
+  if (existsSync50(abs) && !ctx.force) {
     const metadata = readAssetMetadata(ctx.projectDir, "video", beat.id);
     if (!metadata || isFreshCanonicalAsset({
       projectDir: ctx.projectDir,
@@ -63493,8 +63628,8 @@ async function dispatchVideo(beat, ctx, keyframe) {
       };
     }
   }
-  const cacheAbs = join25(ctx.projectDir, cache.path);
-  if (existsSync49(cacheAbs) && !ctx.force) {
+  const cacheAbs = join26(ctx.projectDir, cache.path);
+  if (existsSync50(cacheAbs) && !ctx.force) {
     await mkdir26(dirname24(abs), { recursive: true });
     await copyFile5(cacheAbs, abs);
     await writeAssetMetadata({
@@ -63525,7 +63660,7 @@ async function dispatchVideo(beat, ctx, keyframe) {
     ctx.onProgress({ type: "video-skipped", beatId: beat.id, reason });
     return { status: "skipped" };
   }
-  const keyframeImageAbs = keyframeImageRel ? join25(ctx.projectDir, keyframeImageRel) : void 0;
+  const keyframeImageAbs = keyframeImageRel ? join26(ctx.projectDir, keyframeImageRel) : void 0;
   loadSceneBuildEnv(ctx.projectDir);
   const result = await executeVideoGenerate({
     prompt: prompt3,
@@ -63549,7 +63684,7 @@ async function dispatchVideo(beat, ctx, keyframe) {
     ctx.onProgress({ type: "video-failed", beatId: beat.id, error });
     return { status: "failed", error };
   }
-  if (result.status === "completed" && existsSync49(abs)) {
+  if (result.status === "completed" && existsSync50(abs)) {
     await mkdir26(dirname24(cacheAbs), { recursive: true });
     await copyFile5(abs, cacheAbs);
     await writeAssetMetadata({
@@ -63617,7 +63752,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 = join25(ctx.projectDir, rel);
+  const abs = join26(ctx.projectDir, rel);
   const duration = normalizeMusicDuration(beat.duration);
   const cache = musicCacheDescriptor({
     beatId: beat.id,
@@ -63626,7 +63761,7 @@ async function dispatchMusic(beat, ctx) {
     duration
   });
   const metadataPath = assetMetadataPath("music", beat.id);
-  if (existsSync49(abs) && !ctx.force) {
+  if (existsSync50(abs) && !ctx.force) {
     const metadata = readAssetMetadata(ctx.projectDir, "music", beat.id);
     if (!metadata || isFreshCanonicalAsset({
       projectDir: ctx.projectDir,
@@ -63650,8 +63785,8 @@ async function dispatchMusic(beat, ctx) {
       };
     }
   }
-  const cacheAbs = join25(ctx.projectDir, cache.path);
-  if (existsSync49(cacheAbs) && !ctx.force) {
+  const cacheAbs = join26(ctx.projectDir, cache.path);
+  if (existsSync50(cacheAbs) && !ctx.force) {
     await mkdir26(dirname24(abs), { recursive: true });
     await copyFile5(cacheAbs, abs);
     await writeAssetMetadata({
@@ -63725,7 +63860,7 @@ async function dispatchMusic(beat, ctx) {
       metadataPath
     };
   }
-  if (!existsSync49(abs)) {
+  if (!existsSync50(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 };
@@ -63761,12 +63896,12 @@ async function dispatchMusic(beat, ctx) {
   };
 }
 function loadSceneBuildEnv(projectDir) {
-  (0, import_dotenv4.config)({ path: join25(projectDir, ".env"), quiet: true });
+  (0, import_dotenv4.config)({ path: join26(projectDir, ".env"), quiet: true });
   (0, import_dotenv4.config)({ path: resolve65(process.cwd(), ".env"), quiet: true });
   let dir = process.cwd();
   while (dir !== dirname24(dir)) {
-    if (existsSync49(join25(dir, "pnpm-workspace.yaml"))) {
-      (0, import_dotenv4.config)({ path: join25(dir, ".env"), quiet: true });
+    if (existsSync50(join26(dir, "pnpm-workspace.yaml"))) {
+      (0, import_dotenv4.config)({ path: join26(dir, ".env"), quiet: true });
       return;
     }
     dir = dirname24(dir);
@@ -63982,7 +64117,7 @@ function mergeBeatOutcomes(base, updates) {
 }
 function firstExisting3(projectDir, relPaths) {
   for (const rel of relPaths) {
-    if (existsSync49(join25(projectDir, rel))) return rel;
+    if (existsSync50(join26(projectDir, rel))) return rel;
   }
   return null;
 }
@@ -64013,7 +64148,7 @@ async function apiKeyForVideoProvider(provider, projectDir) {
   return getApiKeyFromConfig(providerKey, { cwd: projectDir });
 }
 async function finalizeBuildResult(projectDir, startedAt, result) {
-  const reportPath = join25(projectDir, "build-report.json");
+  const reportPath = join26(projectDir, "build-report.json");
   if (result.stageReports) {
     for (const report of Object.values(result.stageReports)) {
       if (report.status === "pending") report.status = "skipped";
@@ -64172,7 +64307,7 @@ function normalizeReportDuration(value) {
 }
 function buildReportComposition(projectDir, result, beatId) {
   const path2 = `compositions/scene-${beatId}.html`;
-  const exists = existsSync49(join25(projectDir, path2));
+  const exists = existsSync50(join26(projectDir, path2));
   const written = composeWrittenEntry(result, beatId);
   if (written) {
     return {
@@ -64229,8 +64364,8 @@ function summarizeBuildBeats(projectDir, beats) {
   let compositionsReady = 0;
   for (const beat of beats) {
     if (beatAssetsReady(beat)) assetsReady += 1;
-    const compositionPath = join25(projectDir, "compositions", `scene-${beat.beatId}.html`);
-    if (existsSync49(compositionPath)) {
+    const compositionPath = join26(projectDir, "compositions", `scene-${beat.beatId}.html`);
+    if (existsSync50(compositionPath)) {
       compositionsReady += 1;
     } else {
       needsAuthor.push(beat.beatId);
@@ -64272,6 +64407,8 @@ var init_scene_build = __esm({
     init_compose_scenes_skills();
     init_compose_prompts();
     init_config();
+    init_api_key();
+    init_transcribe_narration();
     init_scene_render();
     init_storyboard_parse();
     init_scene_project();
@@ -64362,18 +64499,18 @@ __export(ai_audio_exports, {
   executeVoiceClone: () => executeVoiceClone
 });
 import { resolve as resolve73, dirname as dirname26, basename as basename22, extname as extname15 } from "node:path";
-import { readFile as readFile48, writeFile as writeFile51 } from "node:fs/promises";
-import { existsSync as existsSync54 } from "node:fs";
+import { readFile as readFile49, writeFile as writeFile51 } from "node:fs/promises";
+import { existsSync as existsSync55 } 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 = resolve73(process.cwd(), audioPath);
-    if (!existsSync54(absPath)) return { success: false, error: `File not found: ${absPath}` };
+    if (!existsSync55(absPath)) return { success: false, error: `File not found: ${absPath}` };
     const whisper = new WhisperProvider();
     await whisper.initialize({ apiKey: key });
-    const audioBuffer = await readFile48(absPath);
+    const audioBuffer = await readFile49(absPath);
     const audioBlob = new Blob([audioBuffer]);
     const result = await whisper.transcribe(audioBlob, language);
     if (result.status === "failed") {
@@ -64403,8 +64540,8 @@ async function executeIsolate(options) {
     const key = apiKey || process.env.ELEVENLABS_API_KEY;
     if (!key) return { success: false, error: "ELEVENLABS_API_KEY required" };
     const absPath = resolve73(process.cwd(), audioPath);
-    if (!existsSync54(absPath)) return { success: false, error: `File not found: ${absPath}` };
-    const audioBuffer = await readFile48(absPath);
+    if (!existsSync55(absPath)) return { success: false, error: `File not found: ${absPath}` };
+    const audioBuffer = await readFile49(absPath);
     const elevenlabs = new ElevenLabsProvider();
     await elevenlabs.initialize({ apiKey: key });
     const result = await elevenlabs.isolateVocals(audioBuffer);
@@ -64429,8 +64566,8 @@ async function executeVoiceClone(options) {
     const audioBuffers = [];
     for (const samplePath of samplePaths) {
       const absPath = resolve73(process.cwd(), samplePath);
-      if (!existsSync54(absPath)) return { success: false, error: `File not found: ${samplePath}` };
-      const buffer = await readFile48(absPath);
+      if (!existsSync55(absPath)) return { success: false, error: `File not found: ${samplePath}` };
+      const buffer = await readFile49(absPath);
       audioBuffers.push(buffer);
     }
     const elevenlabs = new ElevenLabsProvider();
@@ -64451,7 +64588,7 @@ async function executeDub(options) {
   const { mediaPath, language, source, voice, analyzeOnly, output } = options;
   try {
     const absPath = resolve73(process.cwd(), mediaPath);
-    if (!existsSync54(absPath)) return { success: false, error: `File not found: ${absPath}` };
+    if (!existsSync55(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;
@@ -64468,7 +64605,7 @@ async function executeDub(options) {
     }
     const whisper = new WhisperProvider();
     await whisper.initialize({ apiKey: openaiKey });
-    const audioBuffer = await readFile48(audioPath);
+    const audioBuffer = await readFile49(audioPath);
     const audioBlob = new Blob([audioBuffer]);
     const transcriptResult = await whisper.transcribe(audioBlob, source);
     if (transcriptResult.status === "failed" || !transcriptResult.segments) {
@@ -64579,8 +64716,8 @@ async function executeDuck(options) {
     if (!commandExists("ffmpeg")) return { success: false, error: "FFmpeg not found" };
     const absMusicPath = resolve73(process.cwd(), musicPath);
     const absVoicePath = resolve73(process.cwd(), voicePath);
-    if (!existsSync54(absMusicPath)) return { success: false, error: `Music file not found: ${absMusicPath}` };
-    if (!existsSync54(absVoicePath)) return { success: false, error: `Voice file not found: ${absVoicePath}` };
+    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 = resolve73(dirname26(absMusicPath), `${basename22(absMusicPath, extname15(absMusicPath))}-ducked${extname15(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`;
@@ -64594,7 +64731,7 @@ async function executeDuck(options) {
       "-y",
       outputPath
     ], { timeout: 12e4, maxBuffer: 50 * 1024 * 1024 });
-    if (!existsSync54(outputPath)) return { success: false, error: "FFmpeg failed to create output" };
+    if (!existsSync55(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)}` };
@@ -64611,8 +64748,8 @@ var init_ai_audio = __esm({
 
 // src/pipeline/executor.ts
 import { resolve as resolve74 } from "node:path";
-import { readFile as readFile49, writeFile as writeFile52, mkdir as mkdir28 } from "node:fs/promises";
-import { existsSync as existsSync55 } from "node:fs";
+import { readFile as readFile50, writeFile as writeFile52, mkdir as mkdir28 } from "node:fs/promises";
+import { existsSync as existsSync56 } from "node:fs";
 function maxCostFor(action) {
   const cmd = ACTION_METADATA[action]?.command;
   if (!cmd) return 0;
@@ -64927,10 +65064,10 @@ async function ensureActionsRegistered() {
 }
 async function loadPipeline(filePath) {
   const absPath = resolve74(process.cwd(), filePath);
-  if (!existsSync55(absPath)) {
+  if (!existsSync56(absPath)) {
     throw new Error(`Pipeline file not found: ${absPath}`);
   }
-  const content = await readFile49(absPath, "utf-8");
+  const content = await readFile50(absPath, "utf-8");
   const manifest2 = (0, import_yaml8.parse)(content);
   if (!manifest2.name) throw new Error("Pipeline missing 'name' field");
   if (!manifest2.steps || !Array.isArray(manifest2.steps)) throw new Error("Pipeline missing 'steps' array");
@@ -64952,8 +65089,8 @@ async function executePipeline(manifest2, options = {}) {
   const startTime = Date.now();
   if (options.resume) {
     const checkpointPath = resolve74(outputDir, CHECKPOINT_FILE);
-    if (existsSync55(checkpointPath)) {
-      const checkpointContent = await readFile49(checkpointPath, "utf-8");
+    if (existsSync56(checkpointPath)) {
+      const checkpointContent = await readFile50(checkpointPath, "utf-8");
       const checkpoint = (0, import_yaml8.parse)(checkpointContent);
       for (const cs of checkpoint.completedSteps) {
         completedSteps.set(cs.id, {
@@ -70883,14 +71020,14 @@ var init_edit = __esm({
 });
 
 // src/commands/ai-suggest-edit.ts
-import { readFile as readFile50, writeFile as writeFile53 } from "node:fs/promises";
+import { readFile as readFile51, writeFile as writeFile53 } 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 = resolve76(process.cwd(), options.projectPath);
-    const content = await readFile50(filePath, "utf-8");
+    const content = await readFile51(filePath, "utf-8");
     const data = JSON.parse(content);
     const project = Project.fromJSON(data);
     const gemini = new GeminiProvider();
@@ -71655,13 +71792,13 @@ var init_generate2 = __esm({
 });
 
 // src/tools/manifest/storyboard.ts
-import { existsSync as existsSync56 } from "node:fs";
-import { readFile as readFile51, writeFile as writeFile54 } from "node:fs/promises";
+import { existsSync as existsSync57 } from "node:fs";
+import { readFile as readFile52, writeFile as writeFile54 } from "node:fs/promises";
 import { resolve as resolve78 } from "node:path";
 async function readStoryboard2(projectDir) {
   const path2 = resolve78(projectDir, "STORYBOARD.md");
-  if (!existsSync56(path2)) return null;
-  return { path: path2, markdown: await readFile51(path2, "utf-8") };
+  if (!existsSync57(path2)) return null;
+  return { path: path2, markdown: await readFile52(path2, "utf-8") };
 }
 var PROJECT_DIR_DESCRIPTION3, projectDirSchema, storyboardListTool, storyboardValidateTool, storyboardGetTool, storyboardSetTool, storyboardMoveTool, storyboardReviseTool, planTool, storyboardTools;
 var init_storyboard2 = __esm({
@@ -71936,7 +72073,7 @@ var init_storyboard2 = __esm({
 // src/tools/manifest/remix.ts
 import { writeFile as writeFile55 } from "node:fs/promises";
 import { tmpdir as tmpdir4 } from "node:os";
-import { join as join27 } from "node:path";
+import { join as join28 } from "node:path";
 var pipelineHighlightsTool, pipelineAutoShortsTool, pipelineRunTool, pipelineRegenerateSceneTool, remixTools;
 var init_remix = __esm({
   "src/tools/manifest/remix.ts"() {
@@ -72050,7 +72187,7 @@ var init_remix = __esm({
         let resolvedPath = args.pipelinePath;
         let tempPath;
         if (args.pipelineYaml) {
-          tempPath = join27(tmpdir4(), `vibe-mcp-pipeline-${Date.now()}.yaml`);
+          tempPath = join28(tmpdir4(), `vibe-mcp-pipeline-${Date.now()}.yaml`);
           await writeFile55(tempPath, args.pipelineYaml, "utf-8");
           resolvedPath = tempPath;
         }
@@ -72226,10 +72363,10 @@ var init_detect2 = __esm({
 });
 
 // src/tools/manifest/_project-io.ts
-import { readFile as readFile52, writeFile as writeFile56 } from "node:fs/promises";
+import { readFile as readFile53, writeFile as writeFile56 } from "node:fs/promises";
 async function loadProject2(projectPath, cwd) {
   const absPath = await resolveTimelineFile(projectPath, cwd);
-  const content = await readFile52(absPath, "utf-8");
+  const content = await readFile53(absPath, "utf-8");
   const data = JSON.parse(content);
   return { project: Project.fromJSON(data), absPath };
 }
@@ -72593,12 +72730,12 @@ var init_timeline = __esm({
 });
 
 // src/commands/_shared/project-list.ts
-import { readdir as readdir7, readFile as readFile53, stat as stat9 } from "node:fs/promises";
-import { existsSync as existsSync57 } from "node:fs";
-import { join as join28, resolve as resolve80 } from "node:path";
+import { readdir as readdir7, readFile as readFile54, stat as stat9 } from "node:fs/promises";
+import { existsSync as existsSync58 } from "node:fs";
+import { join as join29, resolve as resolve80 } from "node:path";
 async function executeProjectList(opts = {}) {
   const workspaceDir = resolve80(opts.workspaceDir ?? ".");
-  if (!existsSync57(workspaceDir)) {
+  if (!existsSync58(workspaceDir)) {
     return {
       success: false,
       workspaceDir,
@@ -72615,11 +72752,11 @@ async function executeProjectList(opts = {}) {
     if (entry.name === "node_modules") continue;
     if (entry.name.startsWith(".")) continue;
     if (entry.name.startsWith("_")) {
-      archivedCount += await countProjects(join28(workspaceDir, entry.name));
+      archivedCount += await countProjects(join29(workspaceDir, entry.name));
       continue;
     }
-    const projectDir = join28(workspaceDir, entry.name);
-    if (!existsSync57(join28(projectDir, "STORYBOARD.md"))) continue;
+    const projectDir = join29(workspaceDir, entry.name);
+    if (!existsSync58(join29(projectDir, "STORYBOARD.md"))) continue;
     projects.push(await describeProject(entry.name, projectDir));
   }
   projects.sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
@@ -72629,7 +72766,7 @@ async function countProjects(dir) {
   try {
     const entries = await readdir7(dir, { withFileTypes: true });
     return entries.filter(
-      (e) => e.isDirectory() && existsSync57(join28(dir, e.name, "STORYBOARD.md"))
+      (e) => e.isDirectory() && existsSync58(join29(dir, e.name, "STORYBOARD.md"))
     ).length;
   } catch {
     return 0;
@@ -72640,8 +72777,8 @@ async function describeProject(name, projectDir) {
   let storyboardDurationSec = 0;
   const timestamps = [];
   try {
-    const storyboardPath2 = join28(projectDir, "STORYBOARD.md");
-    const parsed = parseStoryboard(await readFile53(storyboardPath2, "utf-8"));
+    const storyboardPath2 = join29(projectDir, "STORYBOARD.md");
+    const parsed = parseStoryboard(await readFile54(storyboardPath2, "utf-8"));
     beats = parsed.beats.length;
     storyboardDurationSec = Number(
       parsed.beats.reduce((sum, beat) => sum + (beat.duration ?? 0), 0).toFixed(2)
@@ -72652,8 +72789,8 @@ async function describeProject(name, projectDir) {
   let buildStatus;
   let buildUpdatedAt;
   try {
-    const reportPath = join28(projectDir, "build-report.json");
-    const report = JSON.parse(await readFile53(reportPath, "utf-8"));
+    const reportPath = join29(projectDir, "build-report.json");
+    const report = JSON.parse(await readFile54(reportPath, "utf-8"));
     buildStatus = report.status ?? report.phase;
     buildUpdatedAt = report.updatedAt;
     timestamps.push((await stat9(reportPath)).mtimeMs);
@@ -72661,12 +72798,12 @@ async function describeProject(name, projectDir) {
   }
   let latestRender;
   try {
-    const rendersDir = join28(projectDir, "renders");
+    const rendersDir = join29(projectDir, "renders");
     const files = await readdir7(rendersDir);
     let newest;
     for (const file of files) {
       if (!/\.(mp4|webm|mov)$/i.test(file)) continue;
-      const { mtimeMs } = await stat9(join28(rendersDir, file));
+      const { mtimeMs } = await stat9(join29(rendersDir, file));
       if (!newest || mtimeMs > newest.mtimeMs) newest = { file, mtimeMs };
     }
     if (newest) {
@@ -72808,7 +72945,7 @@ var init_project2 = __esm({
 });
 
 // src/commands/export.ts
-import { readFile as readFile54, access as access7 } from "node:fs/promises";
+import { readFile as readFile55, access as access7 } from "node:fs/promises";
 import { resolve as resolve82, basename as basename24 } from "node:path";
 import { spawn as spawn3 } from "node:child_process";
 function timelineBaseName(path2) {
@@ -72877,7 +73014,7 @@ async function runExport(projectPath, outputPath, options = {}) {
       };
     }
     const filePath = await resolveTimelineFile(projectPath);
-    const content = await readFile54(filePath, "utf-8");
+    const content = await readFile55(filePath, "utf-8");
     const data = JSON.parse(content);
     const project = Project.fromJSON(data);
     const summary = project.getSummary();
@@ -73443,14 +73580,14 @@ function getPresetSettings(preset, aspectRatio2) {
 }
 async function runHyperframesExport(projectPath, options, spinner2, startedAt) {
   spinner2.text = "Loading project...";
-  const { readFile: readFile56 } = await import("node:fs/promises");
+  const { readFile: readFile57 } = await import("node:fs/promises");
   const { resolve: resolve86 } = 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 readFile56(filePath, "utf-8");
+  const content = await readFile57(filePath, "utf-8");
   const project = Project2.fromJSON(JSON.parse(content));
   const state = project.getState();
   const outputPath = options.output ? resolve86(process.cwd(), options.output) : resolve86(process.cwd(), `${timelineBaseName(projectPath)}.${options.format ?? "mp4"}`);
@@ -73572,7 +73709,7 @@ Run 'vibe schema export' for structured parameter info.`).action(async (projectP
         }
         spinner2.text = "Loading project...";
         const filePath = await resolveTimelineFile(projectPath);
-        const content = await readFile54(filePath, "utf-8");
+        const content = await readFile55(filePath, "utf-8");
         const data = JSON.parse(content);
         const project = Project.fromJSON(data);
         const summary = project.getSummary();
@@ -73707,8 +73844,8 @@ var init_export2 = __esm({
 });
 
 // src/tools/manifest/agent-only.ts
-import { readFile as readFile55, writeFile as writeFile59, readdir as readdir8, stat as stat10, access as access8, unlink as unlink4 } from "node:fs/promises";
-import { resolve as resolve84, join as join29, basename as basename25, extname as extname16 } from "node:path";
+import { readFile as readFile56, writeFile as writeFile59, readdir as readdir8, stat as stat10, access as access8, unlink as unlink4 } from "node:fs/promises";
+import { resolve as resolve84, join as join30, basename as basename25, extname as extname16 } from "node:path";
 function matchPattern(filename, pattern) {
   const regex2 = new RegExp(
     "^" + pattern.replace(/\./g, "\\.").replace(/\*/g, ".*").replace(/\?/g, ".") + "$",
@@ -73793,7 +73930,7 @@ var init_agent_only = __esm({
           const results = [];
           for (const entry of entries) {
             if (args.pattern && !matchPattern(entry.name, args.pattern)) continue;
-            const fullPath = join29(absPath, entry.name);
+            const fullPath = join30(absPath, entry.name);
             const stats = await stat10(fullPath);
             if (entry.isDirectory()) {
               results.push(`[DIR]  ${entry.name}/`);
@@ -73822,7 +73959,7 @@ var init_agent_only = __esm({
       async execute(args, ctx) {
         try {
           const absPath = resolve84(ctx.workingDirectory, args.path);
-          const content = await readFile55(absPath, "utf-8");
+          const content = await readFile56(absPath, "utf-8");
           const maxLength = 4e3;
           const truncated = content.length > maxLength;
           const output = truncated ? content.substring(0, maxLength) + "\n... (truncated)" : content;
@@ -73895,7 +74032,7 @@ var init_agent_only = __esm({
       async execute(args, ctx) {
         try {
           const filePath = resolve84(ctx.workingDirectory, args.project);
-          const content = await readFile55(filePath, "utf-8");
+          const content = await readFile56(filePath, "utf-8");
           const data = JSON.parse(content);
           const project = Project.fromJSON(data);
           const dirPath = resolve84(ctx.workingDirectory, args.directory);
@@ -73906,7 +74043,7 @@ var init_agent_only = __esm({
           const scanDir = async (dir) => {
             const entries = await readdir8(dir, { withFileTypes: true });
             for (const entry of entries) {
-              const entryPath = join29(dir, entry.name);
+              const entryPath = join30(dir, entry.name);
               if (entry.isDirectory() && recursive) {
                 await scanDir(entryPath);
               } else if (entry.isFile()) {
@@ -73967,7 +74104,7 @@ var init_agent_only = __esm({
       async execute(args, ctx) {
         try {
           const filePath = resolve84(ctx.workingDirectory, args.project);
-          const content = await readFile55(filePath, "utf-8");
+          const content = await readFile56(filePath, "utf-8");
           const data = JSON.parse(content);
           const project = Project.fromJSON(data);
           const sourceIds = args.sourceIds ?? [];
@@ -74038,7 +74175,7 @@ var init_agent_only = __esm({
       async execute(args, ctx) {
         try {
           const filePath = resolve84(ctx.workingDirectory, args.project);
-          const content = await readFile55(filePath, "utf-8");
+          const content = await readFile56(filePath, "utf-8");
           const data = JSON.parse(content);
           const project = Project.fromJSON(data);
           const clipIds = args.clipIds ?? [];
@@ -74093,7 +74230,7 @@ var init_agent_only = __esm({
       async execute(args, ctx) {
         try {
           const filePath = await resolveTimelineFile(args.project, ctx.workingDirectory);
-          const content = await readFile55(filePath, "utf-8");
+          const content = await readFile56(filePath, "utf-8");
           const data = JSON.parse(content);
           const project = Project.fromJSON(data);
           const what = args.what ?? "clips";
@@ -74170,7 +74307,7 @@ var init_agent_only = __esm({
       async execute(args, ctx) {
         try {
           const filePath = await resolveTimelineFile(args.projectPath, ctx.workingDirectory);
-          const content = await readFile55(filePath, "utf-8");
+          const content = await readFile56(filePath, "utf-8");
           const data = JSON.parse(content);
           const project = Project.fromJSON(data);
           const updates = [];
@@ -74444,8 +74581,8 @@ Audio:`);
             ],
             { maxBuffer: 50 * 1024 * 1024 }
           );
-          const inputBuf = await readFile55(absInput);
-          const outputBuf = await readFile55(outputPath);
+          const inputBuf = await readFile56(absInput);
+          const outputBuf = await readFile56(outputPath);
           const inputSize = inputBuf.length;
           const outputSize = outputBuf.length;
           const reduction = (inputSize - outputSize) / inputSize * 100;
@@ -74996,7 +75133,7 @@ init_source();
 // package.json
 var package_default = {
   name: "@vibeframe/cli",
-  version: "0.113.9",
+  version: "0.113.11",
   description: "VibeFrame CLI - agentic video workflow runtime",
   private: false,
   license: "MIT",
@@ -75340,8 +75477,8 @@ init_validate();
 init_output();
 init_cost_tier();
 init_project_resolver();
-import { readFile as readFile14, writeFile as writeFile13 } from "node:fs/promises";
-import { existsSync as existsSync12 } from "node:fs";
+import { readFile as readFile15, writeFile as writeFile13 } from "node:fs/promises";
+import { existsSync as existsSync13 } from "node:fs";
 import { resolve as resolve18, basename as basename3, extname } from "node:path";
 var timelineCommand = new Command("timeline").description("Low-level timeline JSON commands").addHelpText(
   "after",
@@ -75390,7 +75527,7 @@ timelineCommand.command("add-source").description("Add a media source to the tim
       return;
     }
     const filePath = await resolveTimelineFile(projectPath);
-    const content = await readFile14(filePath, "utf-8");
+    const content = await readFile15(filePath, "utf-8");
     const data = JSON.parse(content);
     const project = Project.fromJSON(data);
     const absMediaPath = resolve18(process.cwd(), mediaPath);
@@ -75455,7 +75592,7 @@ timelineCommand.command("add-clip").description("Add a clip to the timeline").ar
       return;
     }
     const filePath = await resolveTimelineFile(projectPath);
-    const content = await readFile14(filePath, "utf-8");
+    const content = await readFile15(filePath, "utf-8");
     const data = JSON.parse(content);
     const project = Project.fromJSON(data);
     const source = project.getSource(sourceId);
@@ -75532,7 +75669,7 @@ timelineCommand.command("add-track").description("Add a new track").argument("<p
       return;
     }
     const filePath = await resolveTimelineFile(projectPath);
-    const content = await readFile14(filePath, "utf-8");
+    const content = await readFile15(filePath, "utf-8");
     const data = JSON.parse(content);
     const project = Project.fromJSON(data);
     const existingTracks = project.getTracksByType(type);
@@ -75596,7 +75733,7 @@ timelineCommand.command("add-effect").description("Add an effect to a clip").arg
       return;
     }
     const filePath = await resolveTimelineFile(projectPath);
-    const content = await readFile14(filePath, "utf-8");
+    const content = await readFile15(filePath, "utf-8");
     const data = JSON.parse(content);
     const project = Project.fromJSON(data);
     const clip = project.getClip(clipId);
@@ -75666,7 +75803,7 @@ timelineCommand.command("trim-clip").description("Trim a clip").argument("<proje
       return;
     }
     const filePath = await resolveTimelineFile(projectPath);
-    const content = await readFile14(filePath, "utf-8");
+    const content = await readFile15(filePath, "utf-8");
     const data = JSON.parse(content);
     const project = Project.fromJSON(data);
     const clip = project.getClip(clipId);
@@ -75708,10 +75845,10 @@ timelineCommand.command("list").description("List timeline contents").argument("
   const startedAt = Date.now();
   try {
     const filePath = await resolveTimelineFile(projectPath);
-    if (!existsSync12(filePath)) {
+    if (!existsSync13(filePath)) {
       exitWithError(notFoundError(projectPath));
     }
-    const content = await readFile14(filePath, "utf-8");
+    const content = await readFile15(filePath, "utf-8");
     const data = JSON.parse(content);
     const project = Project.fromJSON(data);
     const showAll = !options.sources && !options.tracks && !options.clips;
@@ -75832,7 +75969,7 @@ timelineCommand.command("split-clip").description("Split a clip at a specific ti
       return;
     }
     const filePath = await resolveTimelineFile(projectPath);
-    const content = await readFile14(filePath, "utf-8");
+    const content = await readFile15(filePath, "utf-8");
     const data = JSON.parse(content);
     const project = Project.fromJSON(data);
     const clip = project.getClip(clipId);
@@ -75894,7 +76031,7 @@ timelineCommand.command("duplicate-clip").description("Duplicate a clip").argume
       return;
     }
     const filePath = await resolveTimelineFile(projectPath);
-    const content = await readFile14(filePath, "utf-8");
+    const content = await readFile15(filePath, "utf-8");
     const data = JSON.parse(content);
     const project = Project.fromJSON(data);
     const clip = project.getClip(clipId);
@@ -75952,7 +76089,7 @@ timelineCommand.command("delete-clip").description("Delete a clip from the timel
       return;
     }
     const filePath = await resolveTimelineFile(projectPath);
-    const content = await readFile14(filePath, "utf-8");
+    const content = await readFile15(filePath, "utf-8");
     const data = JSON.parse(content);
     const project = Project.fromJSON(data);
     const clip = project.getClip(clipId);
@@ -76007,7 +76144,7 @@ timelineCommand.command("move-clip").description("Move a clip to a new position"
       return;
     }
     const filePath = await resolveTimelineFile(projectPath);
-    const content = await readFile14(filePath, "utf-8");
+    const content = await readFile15(filePath, "utf-8");
     const data = JSON.parse(content);
     const project = Project.fromJSON(data);
     const clip = project.getClip(clipId);
@@ -76093,7 +76230,7 @@ init_validate();
 init_cost_tier();
 init_scene_inspect();
 init_render_inspect();
-import { readFile as readFile31, writeFile as writeFile37 } from "node:fs/promises";
+import { readFile as readFile32, writeFile as writeFile37 } from "node:fs/promises";
 import { resolve as resolve44 } from "node:path";
 var VALID_RENDER_AI_MODELS = [
   "flash",
@@ -76446,7 +76583,7 @@ inspectCommand.command("suggest").description("Get AI edit suggestions using Gem
     const apiKey = await requireApiKey("GOOGLE_API_KEY", "Google", options.apiKey);
     const spinner2 = ora("Initializing Gemini...").start();
     const filePath = resolve44(process.cwd(), projectPath);
-    const content = await readFile31(filePath, "utf-8");
+    const content = await readFile32(filePath, "utf-8");
     const data = JSON.parse(content);
     const project = Project.fromJSON(data);
     const gemini = new GeminiProvider();
@@ -76515,8 +76652,8 @@ init_ai_helpers();
 init_output();
 init_validate();
 import { resolve as resolve45, dirname as dirname16, basename as basename12, extname as extname8 } from "node:path";
-import { readFile as readFile32, writeFile as writeFile38 } from "node:fs/promises";
-import { existsSync as existsSync36 } from "node:fs";
+import { readFile as readFile33, writeFile as writeFile38 } from "node:fs/promises";
+import { existsSync as existsSync37 } from "node:fs";
 var audioCommand = new Command("audio").alias("au").description("Audio operations (transcribe, dub, duck, isolate, voice clone)").addHelpText(
   "after",
   `
@@ -76553,7 +76690,7 @@ audioCommand.command("transcribe").description("Transcribe audio using Whisper")
     await whisper.initialize({ apiKey });
     spinner2.text = "Reading audio file...";
     const absPath = resolve45(process.cwd(), audioPath);
-    const audioBuffer = await readFile32(absPath);
+    const audioBuffer = await readFile33(absPath);
     const audioBlob = new Blob([audioBuffer]);
     spinner2.text = "Transcribing...";
     const result = await whisper.transcribe(audioBlob, options.language);
@@ -76657,7 +76794,7 @@ audioCommand.command("isolate").description("Isolate vocals from audio using Ele
     const apiKey = await requireApiKey("ELEVENLABS_API_KEY", "ElevenLabs", options.apiKey);
     const spinner2 = ora("Reading audio file...").start();
     const absPath = resolve45(process.cwd(), audioPath);
-    const audioBuffer = await readFile32(absPath);
+    const audioBuffer = await readFile33(absPath);
     spinner2.text = "Isolating vocals...";
     const elevenlabs = new ElevenLabsProvider();
     await elevenlabs.initialize({ apiKey });
@@ -76728,11 +76865,11 @@ audioCommand.command("clone-voice").description("Clone a voice from audio sample
     const audioBuffers = [];
     for (const samplePath of samples) {
       const absPath = resolve45(process.cwd(), samplePath);
-      if (!existsSync36(absPath)) {
+      if (!existsSync37(absPath)) {
         spinner2.fail(`File not found: ${samplePath}`);
         exitWithError(notFoundError(samplePath));
       }
-      const buffer = await readFile32(absPath);
+      const buffer = await readFile33(absPath);
       audioBuffers.push(buffer);
     }
     spinner2.text = `Cloning voice from ${audioBuffers.length} sample(s)...`;
@@ -76796,7 +76933,7 @@ audioCommand.command("dub").description("Dub audio/video to another language (tr
       exitWithError(usageError("Target language is required. Use -l or --language"));
     }
     const absPath = resolve45(process.cwd(), mediaPath);
-    if (!existsSync36(absPath)) {
+    if (!existsSync37(absPath)) {
       exitWithError(notFoundError(mediaPath));
     }
     const openaiKey = await requireApiKey("OPENAI_API_KEY", "OpenAI");
@@ -76821,7 +76958,7 @@ audioCommand.command("dub").description("Dub audio/video to another language (tr
     spinner2.text = "Transcribing audio...";
     const whisper = new WhisperProvider();
     await whisper.initialize({ apiKey: openaiKey });
-    const audioBuffer = await readFile32(audioPath);
+    const audioBuffer = await readFile33(audioPath);
     const audioBlob = new Blob([audioBuffer]);
     const transcriptResult = await whisper.transcribe(audioBlob, options.source);
     if (transcriptResult.status === "failed" || !transcriptResult.segments) {
@@ -77077,7 +77214,7 @@ init_esm();
 init_source();
 init_ora();
 import { resolve as resolve50, basename as basename15 } from "node:path";
-import { existsSync as existsSync41 } from "node:fs";
+import { existsSync as existsSync42 } from "node:fs";
 
 // src/commands/ai-script-pipeline-cli.ts
 init_source();
@@ -77086,9 +77223,9 @@ var import_yaml7 = __toESM(require_dist2(), 1);
 init_api_key();
 init_ai_script_pipeline();
 init_output();
-import { readFile as readFile34, writeFile as writeFile40 } from "node:fs/promises";
+import { readFile as readFile35, writeFile as writeFile40 } from "node:fs/promises";
 import { resolve as resolve47 } from "node:path";
-import { existsSync as existsSync38 } from "node:fs";
+import { existsSync as existsSync39 } from "node:fs";
 function registerScriptPipelineCommands(aiCommand) {
   aiCommand.command("regenerate-scene", { hidden: true }).description("Regenerate a specific scene in a script-to-video output directory").argument("<project-dir>", "Path to the script-to-video output directory").requiredOption(
     "--scene <numbers>",
@@ -77105,12 +77242,12 @@ function registerScriptPipelineCommands(aiCommand) {
     try {
       const outputDir = resolve47(process.cwd(), projectDir);
       const projectPath = resolve47(outputDir, "timeline.json");
-      if (!existsSync38(outputDir)) {
+      if (!existsSync39(outputDir)) {
         exitWithError(notFoundError(outputDir));
       }
       const yamlPath = resolve47(outputDir, "storyboard.yaml");
       const jsonPath = resolve47(outputDir, "storyboard.json");
-      const storyboardPath2 = existsSync38(yamlPath) ? yamlPath : existsSync38(jsonPath) ? jsonPath : null;
+      const storyboardPath2 = existsSync39(yamlPath) ? yamlPath : existsSync39(jsonPath) ? jsonPath : null;
       const storyboardIsYaml = storyboardPath2 === yamlPath;
       if (!storyboardPath2) {
         exitWithError(notFoundError(`${outputDir}/storyboard.{yaml,json}`));
@@ -77146,7 +77283,7 @@ function registerScriptPipelineCommands(aiCommand) {
         });
         return;
       }
-      const content = await readFile34(storyboardPath2, "utf-8");
+      const content = await readFile35(storyboardPath2, "utf-8");
       const segments = storyboardIsYaml ? (0, import_yaml7.parse)(content).scenes : JSON.parse(content);
       for (const sceneNum of sceneNums) {
         if (sceneNum > segments.length) {
@@ -77229,12 +77366,12 @@ function registerScriptPipelineCommands(aiCommand) {
         exitWithError(apiError(result.error || "Scene regeneration failed", true));
       }
       spinner2.succeed(source_default.green(`Regenerated ${result.regeneratedScenes.length} scene(s)`));
-      if (existsSync38(projectPath) && result.regeneratedScenes.length > 0) {
+      if (existsSync39(projectPath) && result.regeneratedScenes.length > 0) {
         const updateSpinner = ora("Updating timeline file...").start();
         try {
-          const updatedContent = await readFile34(storyboardPath2, "utf-8");
+          const updatedContent = await readFile35(storyboardPath2, "utf-8");
           const updatedSegments = storyboardIsYaml ? (0, import_yaml7.parse)(updatedContent).scenes : JSON.parse(updatedContent);
-          const projectContent = await readFile34(projectPath, "utf-8");
+          const projectContent = await readFile35(projectPath, "utf-8");
           const projectData = JSON.parse(projectContent);
           for (const sceneNum of result.regeneratedScenes) {
             const segment = updatedSegments[sceneNum - 1];
@@ -77245,7 +77382,7 @@ function registerScriptPipelineCommands(aiCommand) {
               (s) => s.name === `Scene ${sceneNum}`
             );
             if (videoSource) {
-              const hasVideo = existsSync38(videoPath);
+              const hasVideo = existsSync39(videoPath);
               videoSource.url = hasVideo ? videoPath : imagePath;
               videoSource.type = hasVideo ? "video" : "image";
               videoSource.duration = segment.duration;
@@ -77370,7 +77507,7 @@ Required API Key: OPENAI_API_KEY (Whisper transcription)
   const startedAt = Date.now();
   try {
     const absVideoPath = resolve50(process.cwd(), videoPath);
-    if (!existsSync41(absVideoPath)) {
+    if (!existsSync42(absVideoPath)) {
       exitWithError(notFoundError(absVideoPath));
     }
     if (!ANIMATED_CAPTION_STYLES.includes(options.style)) {
@@ -81753,8 +81890,8 @@ init_ora();
 init_engine();
 init_output();
 init_cost_tier();
-import { readFile as readFile36, writeFile as writeFile43, readdir as readdir6 } from "node:fs/promises";
-import { resolve as resolve52, basename as basename17, extname as extname12, join as join20 } from "node:path";
+import { readFile as readFile37, writeFile as writeFile43, readdir as readdir6 } from "node:fs/promises";
+import { resolve as resolve52, basename as basename17, extname as extname12, join as join21 } from "node:path";
 var batchCommand = new Command("batch").description("Batch operations for processing multiple items");
 function detectMediaType3(filePath) {
   const ext = extname12(filePath).toLowerCase();
@@ -81812,7 +81949,7 @@ batchCommand.command("import").description("Import multiple media files from a d
       return;
     }
     const filePath = resolve52(process.cwd(), projectPath);
-    const content = await readFile36(filePath, "utf-8");
+    const content = await readFile37(filePath, "utf-8");
     const data = JSON.parse(content);
     const project = Project.fromJSON(data);
     const dirPath = resolve52(process.cwd(), directory);
@@ -81821,7 +81958,7 @@ batchCommand.command("import").description("Import multiple media files from a d
     const scanDir = async (dir) => {
       const entries = await readdir6(dir, { withFileTypes: true });
       for (const entry of entries) {
-        const entryPath = join20(dir, entry.name);
+        const entryPath = join21(dir, entry.name);
         if (entry.isDirectory() && options.recursive) {
           await scanDir(entryPath);
         } else if (entry.isFile()) {
@@ -81890,7 +82027,7 @@ batchCommand.command("concat").description("Concatenate multiple sources into se
       return;
     }
     const filePath = resolve52(process.cwd(), projectPath);
-    const content = await readFile36(filePath, "utf-8");
+    const content = await readFile37(filePath, "utf-8");
     const data = JSON.parse(content);
     const project = Project.fromJSON(data);
     const sources = project.getSources();
@@ -81969,7 +82106,7 @@ batchCommand.command("apply-effect").description("Apply an effect to multiple cl
         return;
       }
       const filePath = resolve52(process.cwd(), projectPath);
-      const content = await readFile36(filePath, "utf-8");
+      const content = await readFile37(filePath, "utf-8");
       const data = JSON.parse(content);
       const project = Project.fromJSON(data);
       const clips = project.getClips();
@@ -82037,7 +82174,7 @@ batchCommand.command("remove-clips").description("Remove multiple clips from the
       return;
     }
     const filePath = resolve52(process.cwd(), projectPath);
-    const content = await readFile36(filePath, "utf-8");
+    const content = await readFile37(filePath, "utf-8");
     const data = JSON.parse(content);
     const project = Project.fromJSON(data);
     const clips = project.getClips();
@@ -82075,7 +82212,7 @@ batchCommand.command("info").description("Show batch processing statistics").arg
   const spinner2 = ora("Loading project...").start();
   try {
     const filePath = resolve52(process.cwd(), projectPath);
-    const content = await readFile36(filePath, "utf-8");
+    const content = await readFile37(filePath, "utf-8");
     const data = JSON.parse(content);
     const project = Project.fromJSON(data);
     const sources = project.getSources();
@@ -82135,7 +82272,7 @@ init_output();
 init_tty();
 init_api_key();
 import { resolve as resolve54 } from "node:path";
-import { access as access6, readFile as readFile38 } from "node:fs/promises";
+import { access as access6, readFile as readFile39 } from "node:fs/promises";
 import { homedir as homedir6 } from "node:os";
 
 // src/utils/key-format.ts
@@ -83336,7 +83473,7 @@ async function showConfig(opts = { verbose: false }) {
   let dotenvKeys = {};
   if (hasCwdEnv) {
     try {
-      const envContent = await readFile38(cwdEnvPath, "utf-8");
+      const envContent = await readFile39(cwdEnvPath, "utf-8");
       dotenvKeys = (0, import_dotenv2.parse)(Buffer.from(envContent));
     } catch {
     }
@@ -83433,8 +83570,8 @@ init_source();
 init_agent_host_detect();
 init_scene_project();
 init_visual_styles();
-import { existsSync as existsSync43 } from "node:fs";
-import { mkdir as mkdir24, readFile as readFile40, writeFile as writeFile46 } from "node:fs/promises";
+import { existsSync as existsSync44 } from "node:fs";
+import { mkdir as mkdir24, readFile as readFile41, writeFile as writeFile46 } from "node:fs/promises";
 import { basename as basename19, dirname as dirname20, resolve as resolve56 } from "node:path";
 
 // src/commands/_shared/storyboard-draft.ts
@@ -83597,10 +83734,10 @@ init_project_config();
 init_install_skill();
 
 // src/commands/_shared/host-integration.ts
-import { existsSync as existsSync42 } from "node:fs";
-import { mkdir as mkdir23, readFile as readFile39, writeFile as writeFile45 } from "node:fs/promises";
+import { existsSync as existsSync43 } from "node:fs";
+import { mkdir as mkdir23, readFile as readFile40, writeFile as writeFile45 } from "node:fs/promises";
 import { homedir as homedir7 } from "node:os";
-import { dirname as dirname19, join as join21, resolve as resolve55 } from "node:path";
+import { dirname as dirname19, join as join22, resolve as resolve55 } from "node:path";
 var HOST_SELECTIONS = [
   "codex",
   "claude",
@@ -83627,7 +83764,7 @@ function hostDefinitions(_projectDir = process.cwd()) {
       label: "OpenAI Codex",
       surfaces: ["shell", "project-guidance", "mcp"],
       guidanceFiles: ["AGENTS.md"],
-      configPath: (dir) => join21(resolve55(dir), ".codex", "config.toml"),
+      configPath: (dir) => join22(resolve55(dir), ".codex", "config.toml"),
       configKind: "codex-toml",
       notes: [
         "Codex reads AGENTS.md and can also load project-scoped .codex/config.toml after the project is trusted.",
@@ -83640,7 +83777,7 @@ function hostDefinitions(_projectDir = process.cwd()) {
       label: "Claude Code",
       surfaces: ["shell", "project-guidance", "mcp"],
       guidanceFiles: ["AGENTS.md", "CLAUDE.md", ".claude/skills/hyperframes/"],
-      configPath: (dir) => join21(resolve55(dir), ".mcp.json"),
+      configPath: (dir) => join22(resolve55(dir), ".mcp.json"),
       configKind: "mcp-json",
       notes: [
         "Claude Code can drive vibe directly through shell plus AGENTS.md/CLAUDE.md.",
@@ -83665,7 +83802,7 @@ function hostDefinitions(_projectDir = process.cwd()) {
       label: "Cursor",
       surfaces: ["shell", "project-guidance", "mcp"],
       guidanceFiles: ["AGENTS.md", ".cursor/rules/hyperframes.mdc"],
-      configPath: (dir) => join21(resolve55(dir), ".cursor", "mcp.json"),
+      configPath: (dir) => join22(resolve55(dir), ".cursor", "mcp.json"),
       configKind: "mcp-json",
       notes: [
         "Cursor can use AGENTS.md/rules for shell-driven work and .cursor/mcp.json for typed MCP tools."
@@ -83706,11 +83843,11 @@ async function planHostSetup(host, projectDir, opts) {
   const warnings = [];
   const nextSteps = hostNextSteps(host);
   for (const relPath of host.guidanceFiles.filter((p) => !p.endsWith("/"))) {
-    const absPath = join21(resolve55(projectDir), relPath);
+    const absPath = join22(resolve55(projectDir), relPath);
     files.push({
       path: absPath,
-      status: existsSync42(absPath) ? "skipped-exists" : "missing",
-      reason: existsSync42(absPath) ? "already present" : "run vibe init --agent all first"
+      status: existsSync43(absPath) ? "skipped-exists" : "missing",
+      reason: existsSync43(absPath) ? "already present" : "run vibe init --agent all first"
     });
   }
   if (!opts.write || opts.dryRun) {
@@ -83754,17 +83891,17 @@ async function inspectHost(host, projectDir) {
   const warnings = [];
   const nextSteps = hostNextSteps(host);
   const guidanceFiles = host.guidanceFiles.map((relPath) => {
-    const absPath = relPath.endsWith("/") ? join21(resolve55(projectDir), relPath) : join21(resolve55(projectDir), relPath);
+    const absPath = relPath.endsWith("/") ? join22(resolve55(projectDir), relPath) : join22(resolve55(projectDir), relPath);
     return {
       path: absPath,
-      status: existsSync42(absPath) ? "skipped-exists" : "missing",
-      reason: existsSync42(absPath) ? "present" : "missing"
+      status: existsSync43(absPath) ? "skipped-exists" : "missing",
+      reason: existsSync43(absPath) ? "present" : "missing"
     };
   });
   let configured = false;
-  if (existsSync42(configPath)) {
+  if (existsSync43(configPath)) {
     try {
-      const content = await readFile39(configPath, "utf-8");
+      const content = await readFile40(configPath, "utf-8");
       if (host.configKind === "codex-toml") {
         configured = /\[mcp_servers\.vibeframe\]/.test(content);
       } else {
@@ -83785,9 +83922,9 @@ async function inspectHost(host, projectDir) {
 }
 async function mergeMcpJson(configPath, opts) {
   let root = {};
-  const exists = existsSync42(configPath);
+  const exists = existsSync43(configPath);
   if (exists) {
-    const raw = await readFile39(configPath, "utf-8");
+    const raw = await readFile40(configPath, "utf-8");
     try {
       root = raw.trim() ? JSON.parse(raw) : {};
     } catch (error) {
@@ -83808,7 +83945,7 @@ async function mergeMcpJson(configPath, opts) {
       if (exists && opts.backup) {
         await writeFile45(
           `${configPath}.bak-${timestamp()}`,
-          await readFile39(configPath, "utf-8"),
+          await readFile40(configPath, "utf-8"),
           "utf-8"
         );
       }
@@ -83830,7 +83967,7 @@ async function mergeMcpJson(configPath, opts) {
   if (exists && opts.backup) {
     await writeFile45(
       `${configPath}.bak-${timestamp()}`,
-      await readFile39(configPath, "utf-8"),
+      await readFile40(configPath, "utf-8"),
       "utf-8"
     );
   }
@@ -83838,7 +83975,7 @@ async function mergeMcpJson(configPath, opts) {
   return { path: configPath, status: exists ? "merged" : "wrote" };
 }
 async function mergeCodexToml(configPath, opts) {
-  const exists = existsSync42(configPath);
+  const exists = existsSync43(configPath);
   const block = `${CODEX_MANAGED_START}
 ${CODEX_MCP_BLOCK}${CODEX_MANAGED_END}`;
   if (!exists) {
@@ -83853,7 +83990,7 @@ ${block}
     );
     return { path: configPath, status: "wrote" };
   }
-  const raw = await readFile39(configPath, "utf-8");
+  const raw = await readFile40(configPath, "utf-8");
   if (raw.includes(CODEX_MANAGED_START)) {
     const updated = raw.replace(
       new RegExp(
@@ -83942,16 +84079,16 @@ function hostNextSteps(host) {
 function claudeDesktopConfigPath() {
   const home = homedir7();
   if (process.platform === "darwin") {
-    return join21(home, "Library", "Application Support", "Claude", "claude_desktop_config.json");
+    return join22(home, "Library", "Application Support", "Claude", "claude_desktop_config.json");
   }
   if (process.platform === "win32") {
-    return join21(
-      process.env.APPDATA ?? join21(home, "AppData", "Roaming"),
+    return join22(
+      process.env.APPDATA ?? join22(home, "AppData", "Roaming"),
       "Claude",
       "claude_desktop_config.json"
     );
   }
-  return join21(home, ".config", "Claude", "claude_desktop_config.json");
+  return join22(home, ".config", "Claude", "claude_desktop_config.json");
 }
 function timestamp() {
   return (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
@@ -84404,7 +84541,7 @@ var initCommand = new Command("init").description("Scaffold a VibeFrame project
   const wantsGemini = targetHosts.includes("gemini-cli");
   const wantsCrossTool = targetHosts.some((h) => h !== "claude-code");
   const actions = [];
-  if (!existsSync43(projectDir)) {
+  if (!existsSync44(projectDir)) {
     if (options.dryRun) {
       actions.push({
         path: projectDir,
@@ -84619,11 +84756,11 @@ async function runSceneInit(projectDirArg, options, startedAt) {
     });
     const storyboardPath2 = resolve56(projectDir, "STORYBOARD.md");
     const designPath = resolve56(projectDir, "DESIGN.md");
-    if (options.force || result.created.includes(storyboardPath2) || !existsSync43(storyboardPath2)) {
+    if (options.force || result.created.includes(storyboardPath2) || !existsSync44(storyboardPath2)) {
       await writeFile46(storyboardPath2, draft.storyboardMd, "utf-8");
       if (!result.created.includes(storyboardPath2)) result.created.push(storyboardPath2);
     }
-    if (options.force || result.created.includes(designPath) || !existsSync43(designPath)) {
+    if (options.force || result.created.includes(designPath) || !existsSync44(designPath)) {
       await writeFile46(designPath, draft.designMd, "utf-8");
       if (!result.created.includes(designPath)) result.created.push(designPath);
     }
@@ -84747,8 +84884,8 @@ function printGroup(label, files, projectDir) {
 }
 async function readBriefOrLiteral(value, cwd) {
   const candidate = resolve56(cwd, value);
-  if (existsSync43(candidate)) {
-    return readFile40(candidate, "utf-8");
+  if (existsSync44(candidate)) {
+    return readFile41(candidate, "utf-8");
   }
   return value;
 }
@@ -84801,7 +84938,7 @@ function normalizeHostAction(status) {
   return "would-write";
 }
 async function writeIfMissing(absPath, content, force, dryRun) {
-  const exists = existsSync43(absPath);
+  const exists = existsSync44(absPath);
   if (exists && !force) {
     return { path: absPath, status: "skipped-exists", reason: "(use --force to overwrite)" };
   }
@@ -84814,12 +84951,12 @@ async function writeIfMissing(absPath, content, force, dryRun) {
 }
 async function mergeGitignore(absPath, additions, dryRun) {
   const marker = "# VibeFrame";
-  if (!existsSync43(absPath)) {
+  if (!existsSync44(absPath)) {
     if (dryRun) return { path: absPath, status: "would-write" };
     await writeFile46(absPath, additions.trimStart(), "utf-8");
     return { path: absPath, status: "wrote" };
   }
-  const existing = await readFile40(absPath, "utf-8");
+  const existing = await readFile41(absPath, "utf-8");
   if (existing.includes(marker)) {
     return { path: absPath, status: "skipped-exists", reason: "(already has VibeFrame block)" };
   }
@@ -84852,8 +84989,8 @@ init_storyboard_revise();
 init_composer_resolve();
 init_cost_tier();
 init_output();
-import { readFile as readFile42, writeFile as writeFile48 } from "node:fs/promises";
-import { existsSync as existsSync45 } from "node:fs";
+import { readFile as readFile43, writeFile as writeFile48 } from "node:fs/promises";
+import { existsSync as existsSync46 } from "node:fs";
 import { resolve as resolve58 } from "node:path";
 var storyboardCommand = new Command("storyboard").description("Read, validate, and safely mutate STORYBOARD.md cue blocks").addHelpText("after", `
 Examples:
@@ -85036,10 +85173,10 @@ storyboardCommand.command("validate").description("Validate cue blocks and beat
 });
 async function readStoryboard(projectDir) {
   const path2 = storyboardPath(projectDir);
-  if (!existsSync45(path2)) {
+  if (!existsSync46(path2)) {
     exitWithError(generalError(`STORYBOARD.md not found at ${path2}`, `Run 'vibe init ${projectDir} --from "<brief>"' first.`));
   }
-  return readFile42(path2, "utf-8");
+  return readFile43(path2, "utf-8");
 }
 function storyboardPath(projectDir) {
   return resolve58(projectDir, "STORYBOARD.md");
@@ -85051,8 +85188,8 @@ function parseComposer(value) {
 }
 async function readBrief(value, cwd) {
   const candidate = resolve58(cwd, value);
-  if (existsSync45(candidate)) {
-    return readFile42(candidate, "utf-8");
+  if (existsSync46(candidate)) {
+    return readFile43(candidate, "utf-8");
   }
   return value;
 }
@@ -85278,8 +85415,8 @@ init_scene_build();
 init_build_plan();
 init_storyboard_parse();
 init_output();
-import { resolve as resolve66, join as join26 } from "node:path";
-import { readFileSync as readFileSync4, existsSync as existsSync50 } from "node:fs";
+import { resolve as resolve66, join as join27 } from "node:path";
+import { readFileSync as readFileSync4, existsSync as existsSync51 } from "node:fs";
 var VALID_MODES2 = ["agent", "batch", "auto"];
 var VALID_STAGES2 = ["assets", "compose", "sync", "render", "all"];
 var VALID_IMAGE_PROVIDERS2 = ["openai", "gemini", "grok"];
@@ -85288,7 +85425,10 @@ 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>", "Build mode: agent|batch|auto", "auto").option("--effort <level>", "Compose effort tier (batch mode only): low|medium|high", "medium").option("--composer <provider>", "Batch composer: claude|openai|gemini").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-render", "Compose only \u2014 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-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 \u2014 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(
   "after",
   `
 Examples:
@@ -85349,6 +85489,7 @@ Advanced equivalent: \`vibe scene build\`.`
     skipVideo: options.skipVideo ?? false,
     skipKeyframe: options.skipKeyframe ?? false,
     skipMusic: options.skipMusic ?? false,
+    skipTranscript: options.skipTranscript ?? false,
     skipRender: options.skipRender ?? false,
     ttsProvider: options.tts,
     voice: options.voice,
@@ -85370,6 +85511,7 @@ Advanced equivalent: \`vibe scene build\`.`
       skipVideo: options.skipVideo,
       skipKeyframe: options.skipKeyframe,
       skipMusic: options.skipMusic,
+      skipTranscript: options.skipTranscript,
       ttsProvider: options.tts,
       voice: options.voice,
       imageProvider,
@@ -85461,6 +85603,7 @@ Advanced equivalent: \`vibe scene build\`.`
     skipVideo: options.skipVideo,
     skipKeyframe: options.skipKeyframe,
     skipMusic: options.skipMusic,
+    skipTranscript: options.skipTranscript,
     skipRender: options.skipRender,
     ttsProvider: options.tts,
     voice: options.voice,
@@ -85473,6 +85616,8 @@ Advanced equivalent: \`vibe scene build\`.`
     onProgress: (e) => {
       if (!spinner2) return;
       if (e.type === "phase-start") spinner2.text = `Phase: ${e.phase}...`;
+      else if (e.type === "transcript-generated")
+        spinner2.text = `Transcribed narration: ${e.beatId} (${e.wordCount} words)`;
       else if (e.type === "render-done") spinner2.text = `Rendered: ${e.outputPath}`;
     }
   });
@@ -85648,8 +85793,8 @@ function buildPlanValidationFailureData(plan) {
   };
 }
 function estimateBuildCost(params) {
-  const storyboardPath2 = join26(params.projectDir, "STORYBOARD.md");
-  if (!existsSync50(storyboardPath2)) return null;
+  const storyboardPath2 = join27(params.projectDir, "STORYBOARD.md");
+  if (!existsSync51(storyboardPath2)) return null;
   let beats = 0;
   try {
     const md = readFileSync4(storyboardPath2, "utf-8");
@@ -86094,7 +86239,7 @@ init_composer_resolve();
 init_cost_tier();
 init_scene_build_mode();
 init_output();
-import { existsSync as existsSync51 } from "node:fs";
+import { existsSync as existsSync52 } from "node:fs";
 import { resolve as resolve69 } from "node:path";
 var COMMAND_KEY_MAP = getCommandKeyMap();
 var FREE_COMMANDS = [
@@ -86222,13 +86367,13 @@ async function runDiagnostics() {
         installed = false;
       }
     } else if (toolName === "chrome") {
-      const { existsSync: existsSync58 } = await import("node:fs");
+      const { existsSync: existsSync59 } = await import("node:fs");
       const { homedir: homedir8 } = await import("node:os");
-      const { join: join30 } = await import("node:path");
+      const { join: join31 } = await import("node:path");
       const chromePaths = [
         process.env.HYPERFRAMES_CHROME_PATH,
         process.env.CHROME_PATH,
-        join30(
+        join31(
           homedir8(),
           ".cache",
           "puppeteer",
@@ -86243,7 +86388,7 @@ async function runDiagnostics() {
         "/usr/bin/chromium",
         "/usr/bin/chromium-browser"
       ];
-      installed = chromePaths.some((p) => p && existsSync58(p));
+      installed = chromePaths.some((p) => p && existsSync59(p));
     } else {
       installed = commandExists(toolName);
     }
@@ -86283,7 +86428,7 @@ async function runDiagnostics() {
   }
   const projectFiles = ["AGENTS.md", "CLAUDE.md", "vibe.project.yaml"].map((rel) => ({
     path: rel,
-    exists: existsSync51(resolve69(cwd, rel))
+    exists: existsSync52(resolve69(cwd, rel))
   }));
   const projectInitialized = projectFiles.some((f) => f.exists);
   const nearestProjectConfigPath = await findProjectConfigPath(cwd);
@@ -86302,8 +86447,8 @@ async function runDiagnostics() {
   } catch (err) {
     if (!(err instanceof ComposerResolveError)) throw err;
   }
-  const sceneProjectInCwd = existsSync51(resolve69(cwd, "STORYBOARD.md"));
-  const skillInstalled = existsSync51(resolve69(cwd, "SKILL.md"));
+  const sceneProjectInCwd = existsSync52(resolve69(cwd, "STORYBOARD.md"));
+  const skillInstalled = existsSync52(resolve69(cwd, "SKILL.md"));
   return {
     system: {
       node: { version: nodeVersion, ok: true },
@@ -86851,7 +86996,7 @@ init_detect();
 init_ai_edit();
 init_output();
 import { resolve as resolve71 } from "node:path";
-import { existsSync as existsSync52 } from "node:fs";
+import { existsSync as existsSync53 } from "node:fs";
 import { mkdir as mkdir27, rm as rm5 } from "node:fs/promises";
 var DEMO_DIR = resolve71(process.cwd(), ".vibeframe-demo");
 async function generateTestVideo(outputPath) {
@@ -86882,7 +87027,7 @@ async function generateTestVideo(outputPath) {
       "-y",
       outputPath
     ], { timeout: 3e4, maxBuffer: 50 * 1024 * 1024 });
-    return existsSync52(outputPath);
+    return existsSync53(outputPath);
   } catch {
     try {
       await execSafe("ffmpeg", [
@@ -86908,7 +87053,7 @@ async function generateTestVideo(outputPath) {
         "-y",
         outputPath
       ], { timeout: 3e4, maxBuffer: 50 * 1024 * 1024 });
-      return existsSync52(outputPath);
+      return existsSync53(outputPath);
     } catch {
       return false;
     }
@@ -87050,8 +87195,8 @@ var demoCommand = new Command("demo").description("Run sample edits on a test vi
 
 // src/commands/context.ts
 init_esm();
-import { existsSync as existsSync53 } from "node:fs";
-import { readFile as readFile47 } from "node:fs/promises";
+import { existsSync as existsSync54 } from "node:fs";
+import { readFile as readFile48 } from "node:fs/promises";
 import { resolve as resolve72, dirname as dirname25 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 var __filename = fileURLToPath2(import.meta.url);
@@ -87063,7 +87208,7 @@ function resolveContextPath(baseDir = __dirname) {
     // Source/dev layout: packages/cli/src/commands/context.ts -> packages/cli/CONTEXT.md
     resolve72(baseDir, "../../CONTEXT.md")
   ];
-  return candidates.find((candidate) => existsSync53(candidate)) ?? null;
+  return candidates.find((candidate) => existsSync54(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 = {
@@ -87169,7 +87314,7 @@ var contextCommand = new Command("context").description("Print CLI context/guide
   try {
     const contextPath = resolveContextPath();
     if (!contextPath) throw new Error("CONTEXT.md not found");
-    const content = await readFile47(contextPath, "utf-8");
+    const content = await readFile48(contextPath, "utf-8");
     console.log(
       content.replace(
         "## Mental model",