@vibeframe/cli 0.113.10 → 0.113.11

package/dist/tools/manifest/index.js

@@ -4756,15 +4756,15 @@ async function loadKokoroRuntime() {
 }
 async function loadKokoroFromWorkspace(baseDir = process.cwd()) {
   try {
-    const { readFile: readFile45 } = await import("node:fs/promises");
-    const { join: join27, resolve: resolve66 } = await import("node:path");
+    const { readFile: readFile46 } = await import("node:fs/promises");
+    const { join: join28, resolve: resolve66 } = await import("node:path");
     const { pathToFileURL } = await import("node:url");
     const pkgDir = resolve66(baseDir, "node_modules", "kokoro-js");
-    const pkg = JSON.parse(await readFile45(join27(pkgDir, "package.json"), "utf-8"));
+    const pkg = JSON.parse(await readFile46(join28(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(join27(pkgDir, entry)).href);
+    const mod = await import(pathToFileURL(join28(pkgDir, entry)).href);
     return mod.KokoroTTS ?? null;
   } catch {
     return null;
@@ -4775,20 +4775,20 @@ async function loadBundledKokoroRuntime(runtimeDir = process.env.VIBE_KOKORO_RUN
   if (!base)
     return null;
   try {
-    const { readFile: readFile45, writeFile: writeFile51, mkdir: mkdir26 } = await import("node:fs/promises");
-    const { join: join27, resolve: resolve66 } = await import("node:path");
+    const { readFile: readFile46, writeFile: writeFile51, mkdir: mkdir26 } = await import("node:fs/promises");
+    const { join: join28, resolve: resolve66 } = await import("node:path");
     const { pathToFileURL } = await import("node:url");
     const { homedir: homedir6 } = await import("node:os");
     const transformersDir = resolve66(base, "node_modules", "@huggingface", "transformers");
     const ortDistDir = resolve66(base, "node_modules", "onnxruntime-web", "dist");
-    const transformers = await import(pathToFileURL(join27(transformersDir, "dist", "transformers.web.js")).href);
-    const cacheRoot = join27(homedir6(), ".cache", "vibeframe", "models");
+    const transformers = await import(pathToFileURL(join28(transformersDir, "dist", "transformers.web.js")).href);
+    const cacheRoot = join28(homedir6(), ".cache", "vibeframe", "models");
     transformers.env.allowLocalModels = false;
     transformers.env.useCustomCache = true;
     transformers.env.customCache = {
       async match(key) {
         try {
-          return new Response(await readFile45(join27(cacheRoot, encodeURIComponent(String(key)))));
+          return new Response(await readFile46(join28(cacheRoot, encodeURIComponent(String(key)))));
         } catch {
           return void 0;
         }
@@ -4797,7 +4797,7 @@ async function loadBundledKokoroRuntime(runtimeDir = process.env.VIBE_KOKORO_RUN
         try {
           const buf = Buffer.from(await response.arrayBuffer());
           await mkdir26(cacheRoot, { recursive: true });
-          await writeFile51(join27(cacheRoot, encodeURIComponent(String(key))), buf);
+          await writeFile51(join28(cacheRoot, encodeURIComponent(String(key))), buf);
         } catch {
         }
       }
@@ -31196,10 +31196,57 @@ var init_composer_resolve = __esm({
   }
 });
 
+// src/commands/_shared/transcribe-narration.ts
+import { existsSync as existsSync9 } from "node:fs";
+import { readFile as readFile9 } from "node:fs/promises";
+import { join as join9 } from "node:path";
+async function transcribeNarrationWords(audioAbsPath, opts) {
+  try {
+    const whisper = new WhisperProvider();
+    await whisper.initialize({ apiKey: opts.apiKey });
+    const audioBytes = await readFile9(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 = join9(projectDir, beatTranscriptRelPath(beatId));
+  if (!existsSync9(abs)) return void 0;
+  try {
+    const parsed = JSON.parse(await readFile9(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,
@@ -31209,15 +31256,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 createHash4 } from "node:crypto";
-import { existsSync as existsSync9, mkdirSync } from "node:fs";
-import { mkdir as mkdir6, readFile as readFile9, writeFile as writeFile12 } from "node:fs/promises";
-import { dirname as dirname5, join as join9, resolve as resolve12 } from "node:path";
+import { existsSync as existsSync10, mkdirSync } from "node:fs";
+import { mkdir as mkdir6, readFile as readFile10, writeFile as writeFile12 } from "node:fs/promises";
+import { dirname as dirname5, join as join10, resolve as resolve12 } from "node:path";
 import { runHyperframeLint as runHyperframeLint2 } from "@hyperframes/producer";
 function buildSystemPrompt(ctx) {
   return `You are a Hyperframes composition author. The skill content below
@@ -31251,6 +31299,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;
@@ -31413,7 +31501,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 ===
 
@@ -31433,7 +31521,7 @@ function computeCacheKey(parts) {
   return createHash4("sha256").update(parts.provider).update("\u241E").update(parts.model).update("\u241E").update(parts.systemPrompt).update("\u241E").update(parts.userPrompt).digest("hex");
 }
 function defaultCacheDir() {
-  return join9(USER_CACHE_DIR, "compose-scenes");
+  return join10(USER_CACHE_DIR, "compose-scenes");
 }
 function extractHtml(responseText) {
   const fenced = responseText.match(/```html\s*\n([\s\S]*?)\n```/);
@@ -31457,9 +31545,9 @@ async function composeBeatHtml(ctx, overrides) {
     model: settings.model
   });
   const cacheDir = ctx.cacheDir ?? defaultCacheDir();
-  const cachePath = join9(cacheDir, `${cacheKey}.html`);
-  if (existsSync9(cachePath)) {
-    const html2 = await readFile9(cachePath, "utf-8");
+  const cachePath = join10(cacheDir, `${cacheKey}.html`);
+  if (existsSync10(cachePath)) {
+    const html2 = await readFile10(cachePath, "utf-8");
     return { html: html2, cached: true, cacheKey, model: settings.model, provider: ctx.provider };
   }
   if (!ctx.apiKey) {
@@ -31595,14 +31683,14 @@ async function executeComposeScenesWithSkills(params, outputDir, overrides) {
   const projectRoot = params.project ? resolve12(outputDir, params.project) : resolve12(outputDir);
   const designPath = resolve12(projectRoot, params.design ?? "DESIGN.md");
   const storyboardPath = resolve12(projectRoot, params.storyboard ?? "STORYBOARD.md");
-  if (!existsSync9(designPath)) {
+  if (!existsSync10(designPath)) {
     return { success: false, error: `DESIGN.md not found at ${designPath}` };
   }
-  if (!existsSync9(storyboardPath)) {
+  if (!existsSync10(storyboardPath)) {
     return { success: false, error: `STORYBOARD.md not found at ${storyboardPath}` };
   }
-  const designMd = await readFile9(designPath, "utf-8");
-  const storyboardMd = await readFile9(storyboardPath, "utf-8");
+  const designMd = await readFile10(designPath, "utf-8");
+  const storyboardMd = await readFile10(storyboardPath, "utf-8");
   const { global: storyboardGlobal, beats } = parseStoryboard(storyboardMd);
   if (beats.length === 0) {
     return {
@@ -31622,7 +31710,7 @@ async function executeComposeScenesWithSkills(params, outputDir, overrides) {
     provider = params.composer ?? "claude";
     apiKey = "";
   }
-  const compositionsDir = join9(projectRoot, "compositions");
+  const compositionsDir = join10(projectRoot, "compositions");
   await mkdir6(compositionsDir, { recursive: true });
   let finalDurations = /* @__PURE__ */ new Map();
   try {
@@ -31636,6 +31724,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,
@@ -31646,11 +31735,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 = join9(compositionsDir, `scene-${beat.id}.html`);
+        const compositionPath = join10(compositionsDir, `scene-${beat.id}.html`);
         await mkdir6(dirname5(compositionPath), { recursive: true });
         await writeFile12(compositionPath, result.html, "utf-8");
         if (result.cached) {
@@ -31729,7 +31819,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";
@@ -31741,6 +31831,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: {
@@ -31764,6 +31855,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);
@@ -31849,22 +31941,22 @@ var init_compose_scenes_skills = __esm({
 });
 
 // src/commands/_shared/compose-prompts.ts
-import { existsSync as existsSync10 } from "node:fs";
-import { readFile as readFile10 } from "node:fs/promises";
-import { join as join10, relative as relative4, resolve as resolve13 } from "node:path";
+import { existsSync as existsSync11 } from "node:fs";
+import { readFile as readFile11 } from "node:fs/promises";
+import { join as join11, relative as relative4, resolve as resolve13 } from "node:path";
 async function getComposePrompts(opts) {
   const projectDir = resolve13(opts.projectDir);
-  const designPath = join10(projectDir, "DESIGN.md");
-  const storyboardPath = join10(projectDir, "STORYBOARD.md");
-  const skillPath = join10(projectDir, "SKILL.md");
-  const compositionsDir = join10(projectDir, "compositions");
+  const designPath = join11(projectDir, "DESIGN.md");
+  const storyboardPath = join11(projectDir, "STORYBOARD.md");
+  const skillPath = join11(projectDir, "SKILL.md");
+  const compositionsDir = join11(projectDir, "compositions");
   const warnings = [];
   const baseError = (msg) => ({
     success: false,
     projectDir,
     designReference: "DESIGN.md",
     storyboardReference: "STORYBOARD.md",
-    skillReference: existsSync10(skillPath) ? "SKILL.md" : null,
+    skillReference: existsSync11(skillPath) ? "SKILL.md" : null,
     compositionsDir: "compositions",
     beats: [],
     instructions: [],
@@ -31872,18 +31964,18 @@ async function getComposePrompts(opts) {
     warnings,
     error: msg
   });
-  if (!existsSync10(designPath)) {
+  if (!existsSync11(designPath)) {
     return baseError(`DESIGN.md not found at ${designPath}. Run \`vibe scene init <dir>\` first.`);
   }
-  if (!existsSync10(storyboardPath)) {
+  if (!existsSync11(storyboardPath)) {
     return baseError(`STORYBOARD.md not found at ${storyboardPath}. Run \`vibe scene init <dir>\` to create a starter, or add STORYBOARD.md with per-beat cues.`);
   }
-  if (!existsSync10(skillPath)) {
+  if (!existsSync11(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 readFile10(storyboardPath, "utf-8");
+  const storyboardMd = await readFile11(storyboardPath, "utf-8");
   const parsed = parseStoryboard(storyboardMd);
   if (parsed.beats.length === 0) {
     return baseError(`STORYBOARD.md has no \`## Beat \u2026\` headings.`);
@@ -31905,28 +31997,33 @@ async function getComposePrompts(opts) {
     finalDurations = await resolveProjectBeatDurations(projectDir);
   } catch {
   }
-  const result = beats.map((beat) => {
-    const outputPathAbs = join10(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: existsSync10(outputPathAbs)
-    };
-  });
-  const skillRef = existsSync10(skillPath) ? "SKILL.md" : null;
+  const result = await Promise.all(
+    beats.map(async (beat) => {
+      const outputPathAbs = join11(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: existsSync11(outputPathAbs)
+      };
+    })
+  );
+  const skillRef = existsSync11(skillPath) ? "SKILL.md" : null;
   const instructions = buildInstructions({
     skillRef,
     beatCount: result.length,
@@ -31974,13 +32071,14 @@ var init_compose_prompts = __esm({
     init_compose_scenes_skills();
     init_root_sync();
     init_bundle();
+    init_transcribe_narration();
   }
 });
 
 // src/commands/_shared/sub-comp-duration-sync.ts
-import { existsSync as existsSync12 } from "node:fs";
-import { readFile as readFile12 } from "node:fs/promises";
-import { join as join12, resolve as resolve15 } from "node:path";
+import { existsSync as existsSync13 } from "node:fs";
+import { readFile as readFile13 } from "node:fs/promises";
+import { join as join13, resolve as resolve15 } from "node:path";
 function syncSubCompositionDurationHtml(html, beatId, newDurationSec, fileRel) {
   const compositionId = `scene-${beatId}`;
   const file = fileRel ?? `compositions/${compositionId}.html`;
@@ -32072,15 +32170,15 @@ async function createSubCompDurationSyncPlans(opts) {
   const results = [];
   for (const beat of opts.beats) {
     const fileRel = `compositions/scene-${beat.id}.html`;
-    const filePath = join12(projectDir, fileRel);
-    if (!existsSync12(filePath)) continue;
+    const filePath = join13(projectDir, fileRel);
+    if (!existsSync13(filePath)) continue;
     const newDurationSec = await resolveSyncedBeatDuration({
       projectDir,
       beatDuration: beat.duration,
       narrationPath: beat.narrationPath,
       sceneDurationSec: beat.sceneDurationSec
     });
-    const html = await readFile12(filePath, "utf-8");
+    const html = await readFile13(filePath, "utf-8");
     const outcome = syncSubCompositionDurationHtml(html, beat.id, newDurationSec, fileRel);
     results.push({ ...outcome, file: fileRel, beatId: beat.id });
   }
@@ -32104,7 +32202,7 @@ var init_sub_comp_duration_sync = __esm({
 });
 
 // src/commands/_shared/scene-repair.ts
-import { readFile as readFile13, writeFile as writeFile14 } from "node:fs/promises";
+import { readFile as readFile14, writeFile as writeFile14 } 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) {
@@ -32150,7 +32248,7 @@ async function executeSceneRepair(opts) {
   }
   for (const target of targets) {
     const rel = relative5(projectDir, target.abs) || target.abs;
-    const html = await readFile13(target.abs, "utf-8");
+    const html = await readFile14(target.abs, "utf-8");
     const findings = lintHtml(html, rel, target.isSub);
     const { html: nextHtml, fixedCodes } = applyMechanicalFixes(html, findings);
     if (fixedCodes.length > 0) {
@@ -32522,15 +32620,15 @@ var init_storyboard_edit = __esm({
 });
 
 // src/pipeline/renderers/chrome.ts
-import { existsSync as existsSync14 } from "node:fs";
+import { existsSync as existsSync15 } from "node:fs";
 import { homedir as homedir5 } from "node:os";
-import { join as join13 } from "node:path";
+import { join as join14 } from "node:path";
 function findChrome() {
   const candidates = [
     process.env.HYPERFRAMES_CHROME_PATH,
     process.env.CHROME_PATH,
     // puppeteer auto-downloaded headless shell
-    join13(
+    join14(
       homedir5(),
       ".cache",
       "puppeteer",
@@ -32548,7 +32646,7 @@ function findChrome() {
     "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe"
   ];
   for (const c of candidates) {
-    if (c && existsSync14(c)) return c;
+    if (c && existsSync15(c)) return c;
   }
   return void 0;
 }
@@ -32580,7 +32678,7 @@ var init_ffmpeg_gate = __esm({
 });
 
 // src/commands/_shared/scene-audio-scan.ts
-import { readFile as readFile15 } from "node:fs/promises";
+import { readFile as readFile16 } from "node:fs/promises";
 import { resolve as resolve18 } from "node:path";
 function parseRootClips(rootHtml) {
   const clips = [];
@@ -32621,7 +32719,7 @@ function makeFsCompositionReader(projectDir) {
   return async (compositionSrcRel) => {
     const abs = resolve18(projectDir, compositionSrcRel);
     try {
-      return await readFile15(abs, "utf-8");
+      return await readFile16(abs, "utf-8");
     } catch {
       return null;
     }
@@ -32821,9 +32919,9 @@ __export(scene_render_exports, {
   qualityToCrf: () => qualityToCrf
 });
 import { execFile as execFile2 } from "node:child_process";
-import { existsSync as existsSync15 } from "node:fs";
-import { mkdir as mkdir9, readFile as readFile16, stat as stat3, writeFile as writeFile16 } from "node:fs/promises";
-import { resolve as resolve20, relative as relative7, dirname as dirname8, basename as basename4, join as join14, isAbsolute } from "node:path";
+import { existsSync as existsSync16 } from "node:fs";
+import { mkdir as mkdir9, readFile as readFile17, stat as stat3, writeFile as writeFile16 } from "node:fs/promises";
+import { resolve as resolve20, relative as relative7, dirname as dirname8, basename as basename4, join as join15, isAbsolute } from "node:path";
 import { promisify as promisify2 } from "node:util";
 import {
   createRenderJob,
@@ -32915,7 +33013,7 @@ async function executeSceneRender(opts = {}) {
   }
   let autoSyncApplied = false;
   let autoSyncWarning;
-  if (!opts.beatId && existsSync15(join14(projectDir, "STORYBOARD.md"))) {
+  if (!opts.beatId && existsSync16(join15(projectDir, "STORYBOARD.md"))) {
     try {
       const rootPlan = await createProjectRootSyncPlan({ projectDir });
       const subPlans = await createSubCompDurationSyncPlans({
@@ -33007,7 +33105,7 @@ async function executeSceneRender(opts = {}) {
   let audioMuxWarning;
   try {
     opts.onProgress?.(0.95, "Mixing audio");
-    const rootHtml = await readFile16(resolve20(projectDir, root), "utf-8");
+    const rootHtml = await readFile17(resolve20(projectDir, root), "utf-8");
     const audios = await scanSceneAudio({ projectDir, rootHtml });
     audioCount = audios.length;
     if (audios.length > 0) {
@@ -33092,11 +33190,11 @@ async function safeStat(p) {
 }
 async function prepareBeatRenderRoot(opts) {
   const root = `.vibeframe/tmp/render-beat-${sanitizeFileSegment(opts.beatId)}.html`;
-  const reportPath = join14(opts.projectDir, "build-report.json");
+  const reportPath = join15(opts.projectDir, "build-report.json");
   const retryWith = [
     `vibe build ${opts.projectDir} --beat ${opts.beatId} --stage sync --json`
   ];
-  if (!existsSync15(reportPath)) {
+  if (!existsSync16(reportPath)) {
     return {
       success: false,
       root,
@@ -33107,7 +33205,7 @@ async function prepareBeatRenderRoot(opts) {
   }
   let report;
   try {
-    report = JSON.parse(await readFile16(reportPath, "utf-8"));
+    report = JSON.parse(await readFile17(reportPath, "utf-8"));
   } catch (error) {
     return {
       success: false,
@@ -33176,8 +33274,8 @@ async function prepareBeatRenderRoot(opts) {
     durationSec,
     narrationPath
   });
-  await mkdir9(dirname8(join14(opts.projectDir, root)), { recursive: true });
-  await writeFile16(join14(opts.projectDir, root), html, "utf-8");
+  await mkdir9(dirname8(join15(opts.projectDir, root)), { recursive: true });
+  await writeFile16(join15(opts.projectDir, root), html, "utf-8");
   return {
     success: true,
     root,
@@ -33241,7 +33339,7 @@ function reportedBeatAssetPaths(beat) {
   ]);
 }
 async function writeRenderReport(projectDir, result) {
-  const reportPath = join14(projectDir, "render-report.json");
+  const reportPath = join15(projectDir, "render-report.json");
   try {
     await writeFile16(
       reportPath,
@@ -33283,7 +33381,7 @@ async function writeRenderReport(projectDir, result) {
 }
 function pathExists3(projectDir, value) {
   const abs = isAbsolute(value) ? value : resolve20(projectDir, value);
-  return existsSync15(abs);
+  return existsSync16(abs);
 }
 function stringValue(value) {
   return typeof value === "string" && value.length > 0 ? value : void 0;
@@ -33356,7 +33454,7 @@ var init_concurrency = __esm({
 });
 
 // src/commands/_shared/build-asset-reference.ts
-import { existsSync as existsSync16 } from "node:fs";
+import { existsSync as existsSync17 } from "node:fs";
 import { extname as extname3, isAbsolute as isAbsolute2, relative as relative8, resolve as resolve21, sep } from "node:path";
 function resolveTypedAssetReference(projectDir, kind, value) {
   const raw = stringOrUndefined2(value);
@@ -33387,7 +33485,7 @@ function resolveReference(projectDir, kind, raw, source, forcedError) {
   const absPath = isAbsolute2(raw) ? resolve21(raw) : resolve21(projectDir, raw);
   const rel = relative8(resolve21(projectDir), absPath);
   const withinProject = rel.length > 0 && !rel.startsWith("..") && !isAbsolute2(rel);
-  const exists = withinProject && existsSync16(absPath);
+  const exists = withinProject && existsSync17(absPath);
   let error = forcedError;
   if (!error && inferred && inferred !== kind && !isNarrationAudioReference(kind, ext)) {
     error = `Asset reference "${raw}" is a ${inferred} asset, not ${kind}.`;
@@ -33574,9 +33672,9 @@ var init_build_backdrop_prompt = __esm({
 });
 
 // src/commands/_shared/build-plan.ts
-import { existsSync as existsSync17 } from "node:fs";
-import { readFile as readFile17 } from "node:fs/promises";
-import { dirname as dirname9, join as join15, resolve as resolve22 } from "node:path";
+import { existsSync as existsSync18 } from "node:fs";
+import { readFile as readFile18 } from "node:fs/promises";
+import { dirname as dirname9, join as join16, resolve as resolve22 } from "node:path";
 function backdropCostUsd(quality) {
   return quality === "hd" ? 0.2 : 0.05;
 }
@@ -33585,11 +33683,11 @@ async function createBuildPlan(opts) {
   loadPlanEnv(projectDir);
   const stage = opts.stage ?? "all";
   const config2 = await readProjectConfig(projectDir);
-  const storyboardPath = join15(projectDir, "STORYBOARD.md");
+  const storyboardPath = join16(projectDir, "STORYBOARD.md");
   const warnings = [];
   const retryWith = [];
   const providerResolution = [];
-  if (!existsSync17(storyboardPath)) {
+  if (!existsSync18(storyboardPath)) {
     const validation2 = {
       ok: false,
       issues: [
@@ -33618,7 +33716,7 @@ async function createBuildPlan(opts) {
       validation: validation2
     });
   }
-  const storyboardMd = await readFile17(storyboardPath, "utf-8");
+  const storyboardMd = await readFile18(storyboardPath, "utf-8");
   const validation = validateStoryboardMarkdown(storyboardMd);
   const validationIssues = [...validation.issues];
   const parsed = parseStoryboard(storyboardMd);
@@ -33644,7 +33742,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) => !existsSync17(join15(projectDir, `compositions/scene-${beat.id}.html`)));
+  const needsComposer = includeCompose && mode !== "agent" && sourceBeats.some((beat) => !existsSync18(join16(projectDir, `compositions/scene-${beat.id}.html`)));
   const resolved = await resolvePlanProviders({
     projectDir,
     config: config2,
@@ -33792,7 +33890,7 @@ async function createBuildPlan(opts) {
       active: includeAssets
     }) : null;
     const compositionPath = `compositions/scene-${beat.id}.html`;
-    const compositionExists = existsSync17(join15(projectDir, compositionPath));
+    const compositionExists = existsSync18(join16(projectDir, compositionPath));
     for (const asset of [narration, backdrop, keyframe, video, music]) {
       if (!asset) continue;
       if (asset.referenceError) {
@@ -33861,7 +33959,7 @@ async function createBuildPlan(opts) {
     }
   }
   const validationOk = !validationIssues.some((issue) => issue.severity === "error");
-  if (!existsSync17(join15(projectDir, config2.config.composition.entry))) {
+  if (!existsSync18(join16(projectDir, config2.config.composition.entry))) {
     missing.add("root-composition");
     if (validationOk) retryWith.push(`vibe build ${projectDir} --stage sync --json`);
   }
@@ -33895,7 +33993,7 @@ async function createBuildPlan(opts) {
     }
     if (referenced.size > 0) {
       const toGenerate = resolveCharacters(parsed.frontmatter).filter(
-        (c) => referenced.has(c.name) && c.prompt && (opts.force || !existsSync17(join15(projectDir, `assets/character-${c.name}.png`)))
+        (c) => referenced.has(c.name) && c.prompt && (opts.force || !existsSync18(join16(projectDir, `assets/character-${c.name}.png`)))
       );
       if (toGenerate.length > 0) {
         estimatedCostUsd += toGenerate.length * backdropCostUsd(opts.imageQuality ?? "hd");
@@ -34008,8 +34106,8 @@ function assetPlan(opts) {
       reason: ready ? "referenced-asset" : "invalid-reference"
     };
   }
-  const canonicalExists = existsSync17(join15(opts.projectDir, opts.path));
-  const cacheHit = opts.cache ? existsSync17(join15(opts.projectDir, opts.cache.path)) : false;
+  const canonicalExists = existsSync18(join16(opts.projectDir, opts.path));
+  const cacheHit = opts.cache ? existsSync18(join16(opts.projectDir, opts.cache.path)) : false;
   const freshness = assetFreshnessFromMetadata({
     projectDir: opts.projectDir,
     kind: opts.kind,
@@ -34207,7 +34305,7 @@ async function firstConfiguredComposer(projectDir) {
 }
 function firstExisting2(projectDir, paths) {
   for (const path2 of paths) {
-    if (existsSync17(join15(projectDir, path2))) return path2;
+    if (existsSync18(join16(projectDir, path2))) return path2;
   }
   return null;
 }
@@ -34248,12 +34346,12 @@ function unique3(items) {
   return [...new Set(items.filter((item) => item.length > 0))];
 }
 function loadPlanEnv(projectDir) {
-  (0, import_dotenv2.config)({ path: join15(projectDir, ".env"), quiet: true });
+  (0, import_dotenv2.config)({ path: join16(projectDir, ".env"), quiet: true });
   (0, import_dotenv2.config)({ path: resolve22(process.cwd(), ".env"), quiet: true });
   let dir = process.cwd();
   while (dir !== dirname9(dir)) {
-    if (existsSync17(join15(dir, "pnpm-workspace.yaml"))) {
-      (0, import_dotenv2.config)({ path: join15(dir, ".env"), quiet: true });
+    if (existsSync18(join16(dir, "pnpm-workspace.yaml"))) {
+      (0, import_dotenv2.config)({ path: join16(dir, ".env"), quiet: true });
       return;
     }
     dir = dirname9(dir);
@@ -34315,7 +34413,7 @@ var init_validate = __esm({
 // src/commands/generate/music.ts
 import { resolve as resolve24 } from "node:path";
 import { writeFile as writeFile17 } from "node:fs/promises";
-import { existsSync as existsSync18 } from "node:fs";
+import { existsSync as existsSync19 } from "node:fs";
 async function executeMusic(options) {
   try {
     const provider = options.provider || "elevenlabs";
@@ -34468,7 +34566,7 @@ function registerMusicCommand(parent) {
         if (options.melody) {
           spinner2.text = "Uploading melody reference...";
           const absPath = resolve24(process.cwd(), options.melody);
-          if (!existsSync18(absPath)) {
+          if (!existsSync19(absPath)) {
             spinner2.fail(`Melody file not found: ${options.melody}`);
             exitWithError(notFoundError(options.melody));
           }
@@ -34601,9 +34699,9 @@ __export(scene_build_exports, {
   executeSceneBuild: () => executeSceneBuild,
   resolveSceneBuildMode: () => resolveSceneBuildMode
 });
-import { existsSync as existsSync19, readFileSync as readFileSync3 } from "node:fs";
-import { copyFile as copyFile3, mkdir as mkdir10, readFile as readFile18, rm, writeFile as writeFile18 } from "node:fs/promises";
-import { dirname as dirname10, join as join16, resolve as resolve25 } from "node:path";
+import { existsSync as existsSync20, readFileSync as readFileSync3 } from "node:fs";
+import { copyFile as copyFile3, mkdir as mkdir10, readFile as readFile19, rm, writeFile as writeFile18 } from "node:fs/promises";
+import { dirname as dirname10, join as join17, resolve as resolve25 } from "node:path";
 async function executeSceneBuild(opts) {
   const startedAt = Date.now();
   const projectDir = resolve25(opts.projectDir);
@@ -34622,7 +34720,7 @@ async function executeSceneBuild(opts) {
     );
   }
   let sceneRepair = skippedSceneRepairSummary();
-  const storyboardPath = join16(projectDir, "STORYBOARD.md");
+  const storyboardPath = join17(projectDir, "STORYBOARD.md");
   const buildPlan = await createBuildPlan({
     projectDir,
     stage: selectedStage,
@@ -34673,8 +34771,8 @@ async function executeSceneBuild(opts) {
   }
   if (!buildPlan.validation.ok) {
     let invalidBeats = [];
-    if (existsSync19(storyboardPath)) {
-      invalidBeats = parseStoryboard(await readFile18(storyboardPath, "utf-8")).beats;
+    if (existsSync20(storyboardPath)) {
+      invalidBeats = parseStoryboard(await readFile19(storyboardPath, "utf-8")).beats;
     }
     return finishBuildResult({
       success: false,
@@ -34698,7 +34796,7 @@ async function executeSceneBuild(opts) {
       totalLatencyMs: Date.now() - startedAt
     });
   }
-  if (!existsSync19(storyboardPath)) {
+  if (!existsSync20(storyboardPath)) {
     return finishBuildResult({
       success: false,
       phase: "failed",
@@ -34712,7 +34810,7 @@ async function executeSceneBuild(opts) {
       totalLatencyMs: Date.now() - startedAt
     });
   }
-  const storyboardMd = await readFile18(storyboardPath, "utf-8");
+  const storyboardMd = await readFile19(storyboardPath, "utf-8");
   const parsed = parseStoryboard(storyboardMd);
   if (parsed.beats.length === 0) {
     return finishBuildResult({
@@ -34819,6 +34917,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
@@ -34906,9 +35005,9 @@ async function executeSceneBuild(opts) {
   let composeData;
   if (shouldRunStage(selectedStage, "compose")) {
     if (mode === "agent") {
-      const compositionsDir = join16(projectDir, "compositions");
+      const compositionsDir = join17(projectDir, "compositions");
       const missingBeats = activeBeats.filter(
-        (b) => !existsSync19(join16(compositionsDir, `scene-${b.id}.html`))
+        (b) => !existsSync20(join17(compositionsDir, `scene-${b.id}.html`))
       );
       if (missingBeats.length > 0) {
         const plan = await getComposePrompts({ projectDir, beatId: opts.beatId });
@@ -34997,8 +35096,8 @@ async function executeSceneBuild(opts) {
   if (stageReports.compose.status === "done") {
     for (const beat of activeBeats) {
       const videoRel = `assets/video-${beat.id}.mp4`;
-      const compositionAbs = join16(projectDir, "compositions", `scene-${beat.id}.html`);
-      if (!existsSync19(join16(projectDir, videoRel)) || !existsSync19(compositionAbs)) continue;
+      const compositionAbs = join17(projectDir, "compositions", `scene-${beat.id}.html`);
+      if (!existsSync20(join17(projectDir, videoRel)) || !existsSync20(compositionAbs)) continue;
       const html = readFileSync3(compositionAbs, "utf-8");
       if (!html.includes(videoRel)) {
         warnings.push(
@@ -35056,7 +35155,7 @@ async function executeSceneBuild(opts) {
     });
   }
   if (shouldRunStage(selectedStage, "sync")) {
-    if (!existsSync19(join16(projectDir, "index.html"))) {
+    if (!existsSync20(join17(projectDir, "index.html"))) {
       await scaffoldSceneProject({
         dir: projectDir,
         name: projectDir.split(/[\\/]/).filter(Boolean).pop(),
@@ -35201,6 +35300,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,
@@ -35318,7 +35420,7 @@ async function dispatchNarration(beat, ctx) {
       return {
         status: "cached",
         path: existingRel,
-        durationSec: await safeAudioDuration(join16(ctx.projectDir, existingRel)),
+        durationSec: await safeAudioDuration(join17(ctx.projectDir, existingRel)),
         provider: metadata?.provider,
         cachePath: metadata?.cachePath,
         cacheKey: metadata?.cacheKey,
@@ -35342,9 +35444,9 @@ async function dispatchNarration(beat, ctx) {
     voice,
     ext: resolution.audioExtension
   });
-  const cacheAbs = join16(ctx.projectDir, cache.path);
+  const cacheAbs = join17(ctx.projectDir, cache.path);
   const rel = `assets/narration-${beat.id}.${resolution.audioExtension}`;
-  const abs = join16(ctx.projectDir, rel);
+  const abs = join17(ctx.projectDir, rel);
   if (existingRel && !ctx.force && isFreshCanonicalAsset({
     projectDir: ctx.projectDir,
     kind: "narration",
@@ -35358,7 +35460,7 @@ async function dispatchNarration(beat, ctx) {
     return {
       status: "cached",
       path: existingRel,
-      durationSec: await safeAudioDuration(join16(ctx.projectDir, existingRel)),
+      durationSec: await safeAudioDuration(join17(ctx.projectDir, existingRel)),
       provider: resolution.provider,
       cachePath: cache.path,
       cacheKey: cache.key,
@@ -35366,7 +35468,7 @@ async function dispatchNarration(beat, ctx) {
       freshness: "fresh"
     };
   }
-  if (existsSync19(cacheAbs) && !ctx.force) {
+  if (existsSync20(cacheAbs) && !ctx.force) {
     await mkdir10(dirname10(abs), { recursive: true });
     await copyFile3(cacheAbs, abs);
     await writeAssetMetadata({
@@ -35401,8 +35503,8 @@ async function dispatchNarration(beat, ctx) {
   await mkdir10(dirname10(abs), { recursive: true });
   await writeFile18(abs, result.audioBuffer);
   for (const otherExt of ["mp3", "wav"]) {
-    const sibling = join16(ctx.projectDir, `assets/narration-${beat.id}.${otherExt}`);
-    if (sibling !== abs && existsSync19(sibling)) await rm(sibling, { force: true });
+    const sibling = join17(ctx.projectDir, `assets/narration-${beat.id}.${otherExt}`);
+    if (sibling !== abs && existsSync20(sibling)) await rm(sibling, { force: true });
   }
   await mkdir10(dirname10(cacheAbs), { recursive: true });
   await writeFile18(cacheAbs, result.audioBuffer);
@@ -35434,6 +35536,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 = join17(ctx.projectDir, relPath);
+  const narrationFresh = narration.status === "generated";
+  if (existsSync20(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(join17(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 mkdir10(dirname10(abs), { recursive: true });
+  await writeFile18(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}.`,
@@ -35451,7 +35589,7 @@ async function buildCharacters(characters, ctx) {
   const size = ctx.imageSize ?? "1536x1024";
   for (const character of characters) {
     if (character.imagePath) {
-      if (existsSync19(join16(ctx.projectDir, character.imagePath))) {
+      if (existsSync20(join17(ctx.projectDir, character.imagePath))) {
         paths.set(character.name, character.imagePath);
         ctx.onProgress({ type: "character-cached", name: character.name, path: character.imagePath });
       } else {
@@ -35464,7 +35602,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 = join16(ctx.projectDir, rel);
+    const abs = join17(ctx.projectDir, rel);
     const metadataOptions = { quality: ctx.imageQuality, size };
     const cache = characterCacheDescriptor({
       name: character.name,
@@ -35473,7 +35611,7 @@ async function buildCharacters(characters, ctx) {
       quality: ctx.imageQuality,
       size
     });
-    if (existsSync19(abs) && !ctx.force) {
+    if (existsSync20(abs) && !ctx.force) {
       const metadata = readAssetMetadata(ctx.projectDir, "character", character.name);
       if (!metadata || isFreshCanonicalAsset({
         projectDir: ctx.projectDir,
@@ -35489,8 +35627,8 @@ async function buildCharacters(characters, ctx) {
         continue;
       }
     }
-    const cacheAbs = join16(ctx.projectDir, cache.path);
-    if (existsSync19(cacheAbs) && !ctx.force) {
+    const cacheAbs = join17(ctx.projectDir, cache.path);
+    if (existsSync20(cacheAbs) && !ctx.force) {
       await mkdir10(dirname10(abs), { recursive: true });
       await copyFile3(cacheAbs, abs);
       await writeAssetMetadata({
@@ -35556,7 +35694,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 = join16(ctx.projectDir, rel);
+  const abs = join17(ctx.projectDir, rel);
   const size = ctx.imageSize ?? "1536x1024";
   const ratio = imageRatioForSize(size);
   const metadataOptions = { quality: ctx.imageQuality, size, ratio };
@@ -35569,7 +35707,7 @@ async function dispatchBackdrop(beat, ctx) {
     ratio
   });
   const metadataPath = assetMetadataPath("backdrop", beat.id);
-  if (existsSync19(abs) && !ctx.force) {
+  if (existsSync20(abs) && !ctx.force) {
     const metadata = readAssetMetadata(ctx.projectDir, "backdrop", beat.id);
     if (!metadata || isFreshCanonicalAsset({
       projectDir: ctx.projectDir,
@@ -35592,8 +35730,8 @@ async function dispatchBackdrop(beat, ctx) {
       };
     }
   }
-  const cacheAbs = join16(ctx.projectDir, cache.path);
-  if (existsSync19(cacheAbs) && !ctx.force) {
+  const cacheAbs = join17(ctx.projectDir, cache.path);
+  if (existsSync20(cacheAbs) && !ctx.force) {
     await mkdir10(dirname10(abs), { recursive: true });
     await copyFile3(cacheAbs, abs);
     await writeAssetMetadata({
@@ -35725,7 +35863,7 @@ async function editKeyframeImage(prompt3, sheetBuffers, ctx, ratio) {
 }
 async function ensureKeyframe(beat, ctx, keyframeCue, characterRefsRel) {
   const rel = `assets/keyframe-${beat.id}.png`;
-  const abs = join16(ctx.projectDir, rel);
+  const abs = join17(ctx.projectDir, rel);
   const size = ctx.imageSize ?? "1536x1024";
   const ratio = imageRatioForSize(size);
   const metadataOptions = { quality: ctx.imageQuality, size, ratio };
@@ -35738,7 +35876,7 @@ async function ensureKeyframe(beat, ctx, keyframeCue, characterRefsRel) {
     ratio,
     characters: characterRefsRel
   });
-  if (existsSync19(abs) && !ctx.force) {
+  if (existsSync20(abs) && !ctx.force) {
     const metadata = readAssetMetadata(ctx.projectDir, "keyframe", beat.id);
     if (!metadata || isFreshCanonicalAsset({
       projectDir: ctx.projectDir,
@@ -35752,8 +35890,8 @@ async function ensureKeyframe(beat, ctx, keyframeCue, characterRefsRel) {
       return { status: "cached", rel };
     }
   }
-  const cacheAbs = join16(ctx.projectDir, cache.path);
-  if (existsSync19(cacheAbs) && !ctx.force) {
+  const cacheAbs = join17(ctx.projectDir, cache.path);
+  if (existsSync20(cacheAbs) && !ctx.force) {
     await mkdir10(dirname10(abs), { recursive: true });
     await copyFile3(cacheAbs, abs);
     await writeAssetMetadata({
@@ -35771,8 +35909,8 @@ async function ensureKeyframe(beat, ctx, keyframeCue, characterRefsRel) {
   }
   const sheetBuffers = [];
   for (const relPath of characterRefsRel) {
-    const sheetAbs = join16(ctx.projectDir, relPath);
-    if (existsSync19(sheetAbs)) sheetBuffers.push(await readFile18(sheetAbs));
+    const sheetAbs = join17(ctx.projectDir, relPath);
+    if (existsSync20(sheetAbs)) sheetBuffers.push(await readFile19(sheetAbs));
   }
   const imgCtx = {
     projectDir: ctx.projectDir,
@@ -35841,9 +35979,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) => join16(ctx.projectDir, p));
+  const characterRefsAbs = characterRefsRel.map((p) => join17(ctx.projectDir, p));
   const rel = `assets/video-${beat.id}.mp4`;
-  const abs = join16(ctx.projectDir, rel);
+  const abs = join17(ctx.projectDir, rel);
   const cache = videoCacheDescriptor({
     beatId: beat.id,
     cue: prompt3,
@@ -35855,7 +35993,7 @@ async function dispatchVideo(beat, ctx, keyframe) {
     keyframe: keyframeCue
   });
   const metadataPath = assetMetadataPath("video", beat.id);
-  if (existsSync19(abs) && !ctx.force) {
+  if (existsSync20(abs) && !ctx.force) {
     const metadata = readAssetMetadata(ctx.projectDir, "video", beat.id);
     if (!metadata || isFreshCanonicalAsset({
       projectDir: ctx.projectDir,
@@ -35878,8 +36016,8 @@ async function dispatchVideo(beat, ctx, keyframe) {
       };
     }
   }
-  const cacheAbs = join16(ctx.projectDir, cache.path);
-  if (existsSync19(cacheAbs) && !ctx.force) {
+  const cacheAbs = join17(ctx.projectDir, cache.path);
+  if (existsSync20(cacheAbs) && !ctx.force) {
     await mkdir10(dirname10(abs), { recursive: true });
     await copyFile3(cacheAbs, abs);
     await writeAssetMetadata({
@@ -35910,7 +36048,7 @@ async function dispatchVideo(beat, ctx, keyframe) {
     ctx.onProgress({ type: "video-skipped", beatId: beat.id, reason });
     return { status: "skipped" };
   }
-  const keyframeImageAbs = keyframeImageRel ? join16(ctx.projectDir, keyframeImageRel) : void 0;
+  const keyframeImageAbs = keyframeImageRel ? join17(ctx.projectDir, keyframeImageRel) : void 0;
   loadSceneBuildEnv(ctx.projectDir);
   const result = await executeVideoGenerate({
     prompt: prompt3,
@@ -35934,7 +36072,7 @@ async function dispatchVideo(beat, ctx, keyframe) {
     ctx.onProgress({ type: "video-failed", beatId: beat.id, error });
     return { status: "failed", error };
   }
-  if (result.status === "completed" && existsSync19(abs)) {
+  if (result.status === "completed" && existsSync20(abs)) {
     await mkdir10(dirname10(cacheAbs), { recursive: true });
     await copyFile3(abs, cacheAbs);
     await writeAssetMetadata({
@@ -36002,7 +36140,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 = join16(ctx.projectDir, rel);
+  const abs = join17(ctx.projectDir, rel);
   const duration = normalizeMusicDuration(beat.duration);
   const cache = musicCacheDescriptor({
     beatId: beat.id,
@@ -36011,7 +36149,7 @@ async function dispatchMusic(beat, ctx) {
     duration
   });
   const metadataPath = assetMetadataPath("music", beat.id);
-  if (existsSync19(abs) && !ctx.force) {
+  if (existsSync20(abs) && !ctx.force) {
     const metadata = readAssetMetadata(ctx.projectDir, "music", beat.id);
     if (!metadata || isFreshCanonicalAsset({
       projectDir: ctx.projectDir,
@@ -36035,8 +36173,8 @@ async function dispatchMusic(beat, ctx) {
       };
     }
   }
-  const cacheAbs = join16(ctx.projectDir, cache.path);
-  if (existsSync19(cacheAbs) && !ctx.force) {
+  const cacheAbs = join17(ctx.projectDir, cache.path);
+  if (existsSync20(cacheAbs) && !ctx.force) {
     await mkdir10(dirname10(abs), { recursive: true });
     await copyFile3(cacheAbs, abs);
     await writeAssetMetadata({
@@ -36110,7 +36248,7 @@ async function dispatchMusic(beat, ctx) {
       metadataPath
     };
   }
-  if (!existsSync19(abs)) {
+  if (!existsSync20(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 };
@@ -36146,12 +36284,12 @@ async function dispatchMusic(beat, ctx) {
   };
 }
 function loadSceneBuildEnv(projectDir) {
-  (0, import_dotenv3.config)({ path: join16(projectDir, ".env"), quiet: true });
+  (0, import_dotenv3.config)({ path: join17(projectDir, ".env"), quiet: true });
   (0, import_dotenv3.config)({ path: resolve25(process.cwd(), ".env"), quiet: true });
   let dir = process.cwd();
   while (dir !== dirname10(dir)) {
-    if (existsSync19(join16(dir, "pnpm-workspace.yaml"))) {
-      (0, import_dotenv3.config)({ path: join16(dir, ".env"), quiet: true });
+    if (existsSync20(join17(dir, "pnpm-workspace.yaml"))) {
+      (0, import_dotenv3.config)({ path: join17(dir, ".env"), quiet: true });
       return;
     }
     dir = dirname10(dir);
@@ -36367,7 +36505,7 @@ function mergeBeatOutcomes(base, updates) {
 }
 function firstExisting3(projectDir, relPaths) {
   for (const rel of relPaths) {
-    if (existsSync19(join16(projectDir, rel))) return rel;
+    if (existsSync20(join17(projectDir, rel))) return rel;
   }
   return null;
 }
@@ -36398,7 +36536,7 @@ async function apiKeyForVideoProvider(provider, projectDir) {
   return getApiKeyFromConfig(providerKey, { cwd: projectDir });
 }
 async function finalizeBuildResult(projectDir, startedAt, result) {
-  const reportPath = join16(projectDir, "build-report.json");
+  const reportPath = join17(projectDir, "build-report.json");
   if (result.stageReports) {
     for (const report of Object.values(result.stageReports)) {
       if (report.status === "pending") report.status = "skipped";
@@ -36557,7 +36695,7 @@ function normalizeReportDuration(value) {
 }
 function buildReportComposition(projectDir, result, beatId) {
   const path2 = `compositions/scene-${beatId}.html`;
-  const exists = existsSync19(join16(projectDir, path2));
+  const exists = existsSync20(join17(projectDir, path2));
   const written = composeWrittenEntry(result, beatId);
   if (written) {
     return {
@@ -36614,8 +36752,8 @@ function summarizeBuildBeats(projectDir, beats) {
   let compositionsReady = 0;
   for (const beat of beats) {
     if (beatAssetsReady(beat)) assetsReady += 1;
-    const compositionPath = join16(projectDir, "compositions", `scene-${beat.beatId}.html`);
-    if (existsSync19(compositionPath)) {
+    const compositionPath = join17(projectDir, "compositions", `scene-${beat.beatId}.html`);
+    if (existsSync20(compositionPath)) {
       compositionsReady += 1;
     } else {
       needsAuthor.push(beat.beatId);
@@ -36657,6 +36795,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();
@@ -36785,18 +36925,18 @@ __export(ai_audio_exports, {
   executeVoiceClone: () => executeVoiceClone
 });
 import { resolve as resolve27, dirname as dirname11, basename as basename5, extname as extname4 } from "node:path";
-import { readFile as readFile19, writeFile as writeFile19 } from "node:fs/promises";
-import { existsSync as existsSync20 } from "node:fs";
+import { readFile as readFile20, writeFile as writeFile19 } from "node:fs/promises";
+import { existsSync as existsSync21 } 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 = resolve27(process.cwd(), audioPath);
-    if (!existsSync20(absPath)) return { success: false, error: `File not found: ${absPath}` };
+    if (!existsSync21(absPath)) return { success: false, error: `File not found: ${absPath}` };
     const whisper = new WhisperProvider();
     await whisper.initialize({ apiKey: key });
-    const audioBuffer = await readFile19(absPath);
+    const audioBuffer = await readFile20(absPath);
     const audioBlob = new Blob([audioBuffer]);
     const result = await whisper.transcribe(audioBlob, language);
     if (result.status === "failed") {
@@ -36826,8 +36966,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 = resolve27(process.cwd(), audioPath);
-    if (!existsSync20(absPath)) return { success: false, error: `File not found: ${absPath}` };
-    const audioBuffer = await readFile19(absPath);
+    if (!existsSync21(absPath)) return { success: false, error: `File not found: ${absPath}` };
+    const audioBuffer = await readFile20(absPath);
     const elevenlabs = new ElevenLabsProvider();
     await elevenlabs.initialize({ apiKey: key });
     const result = await elevenlabs.isolateVocals(audioBuffer);
@@ -36852,8 +36992,8 @@ async function executeVoiceClone(options) {
     const audioBuffers = [];
     for (const samplePath of samplePaths) {
       const absPath = resolve27(process.cwd(), samplePath);
-      if (!existsSync20(absPath)) return { success: false, error: `File not found: ${samplePath}` };
-      const buffer = await readFile19(absPath);
+      if (!existsSync21(absPath)) return { success: false, error: `File not found: ${samplePath}` };
+      const buffer = await readFile20(absPath);
       audioBuffers.push(buffer);
     }
     const elevenlabs = new ElevenLabsProvider();
@@ -36874,7 +37014,7 @@ async function executeDub(options) {
   const { mediaPath, language, source, voice, analyzeOnly, output } = options;
   try {
     const absPath = resolve27(process.cwd(), mediaPath);
-    if (!existsSync20(absPath)) return { success: false, error: `File not found: ${absPath}` };
+    if (!existsSync21(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;
@@ -36891,7 +37031,7 @@ async function executeDub(options) {
     }
     const whisper = new WhisperProvider();
     await whisper.initialize({ apiKey: openaiKey });
-    const audioBuffer = await readFile19(audioPath);
+    const audioBuffer = await readFile20(audioPath);
     const audioBlob = new Blob([audioBuffer]);
     const transcriptResult = await whisper.transcribe(audioBlob, source);
     if (transcriptResult.status === "failed" || !transcriptResult.segments) {
@@ -37002,8 +37142,8 @@ async function executeDuck(options) {
     if (!commandExists("ffmpeg")) return { success: false, error: "FFmpeg not found" };
     const absMusicPath = resolve27(process.cwd(), musicPath);
     const absVoicePath = resolve27(process.cwd(), voicePath);
-    if (!existsSync20(absMusicPath)) return { success: false, error: `Music file not found: ${absMusicPath}` };
-    if (!existsSync20(absVoicePath)) return { success: false, error: `Voice file not found: ${absVoicePath}` };
+    if (!existsSync21(absMusicPath)) return { success: false, error: `Music file not found: ${absMusicPath}` };
+    if (!existsSync21(absVoicePath)) return { success: false, error: `Voice file not found: ${absVoicePath}` };
     const defaultOutput = resolve27(dirname11(absMusicPath), `${basename5(absMusicPath, extname4(absMusicPath))}-ducked${extname4(absMusicPath)}`);
     const outputPath = resolve27(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`;
@@ -37017,7 +37157,7 @@ async function executeDuck(options) {
       "-y",
       outputPath
     ], { timeout: 12e4, maxBuffer: 50 * 1024 * 1024 });
-    if (!existsSync20(outputPath)) return { success: false, error: "FFmpeg failed to create output" };
+    if (!existsSync21(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)}` };
@@ -37033,8 +37173,8 @@ var init_ai_audio = __esm({
 });
 
 // src/commands/_shared/edit/silence-cut.ts
-import { existsSync as existsSync21 } from "node:fs";
-import { readFile as readFile20 } from "node:fs/promises";
+import { existsSync as existsSync22 } from "node:fs";
+import { readFile as readFile21 } from "node:fs/promises";
 async function detectSilencePeriods(videoPath, noiseThreshold, minDuration) {
   const totalDuration = await getVideoDuration(videoPath);
   const { stdout, stderr } = await execSafe(
@@ -37084,7 +37224,7 @@ async function detectSilencePeriodsWithGemini(videoPath, minDuration, options) {
   }
   const gemini = new GeminiProvider();
   await gemini.initialize({ apiKey: geminiApiKey });
-  const videoBuffer = await readFile20(videoPath);
+  const videoBuffer = await readFile21(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.
 
@@ -37160,7 +37300,7 @@ async function executeSilenceCut(options) {
     analyzeOnly = false,
     useGemini = false
   } = options;
-  if (!existsSync21(videoPath)) {
+  if (!existsSync22(videoPath)) {
     return { success: false, error: `Video not found: ${videoPath}` };
   }
   if (!commandExists("ffmpeg")) {
@@ -37268,11 +37408,11 @@ var init_silence_cut = __esm({
 });
 
 // src/commands/_shared/edit/jump-cut.ts
-import { existsSync as existsSync22 } from "node:fs";
-import { readFile as readFile21, writeFile as writeFile20, mkdir as mkdir11 } from "node:fs/promises";
-import { join as join17 } from "node:path";
+import { existsSync as existsSync23 } from "node:fs";
+import { readFile as readFile22, writeFile as writeFile20, mkdir as mkdir11 } from "node:fs/promises";
+import { join as join18 } from "node:path";
 async function transcribeWithWords(audioPath, apiKey, language) {
-  const audioBuffer = await readFile21(audioPath);
+  const audioBuffer = await readFile22(audioPath);
   const audioBlob = new Blob([audioBuffer]);
   const formData = new FormData();
   formData.append("file", audioBlob, "audio.wav");
@@ -37331,7 +37471,7 @@ async function executeJumpCut(options) {
     analyzeOnly = false,
     apiKey
   } = options;
-  if (!existsSync22(videoPath)) {
+  if (!existsSync23(videoPath)) {
     return { success: false, error: `Video not found: ${videoPath}` };
   }
   if (!commandExists("ffmpeg")) {
@@ -37350,7 +37490,7 @@ async function executeJumpCut(options) {
   try {
     const tmpDir = `/tmp/vibe_jumpcut_${Date.now()}`;
     await mkdir11(tmpDir, { recursive: true });
-    const audioPath = join17(tmpDir, "audio.wav");
+    const audioPath = join18(tmpDir, "audio.wav");
     try {
       await execSafe(
         "ffmpeg",
@@ -37404,7 +37544,7 @@ async function executeJumpCut(options) {
       const segmentPaths = [];
       for (let i = 0; i < segments.length; i++) {
         const seg = segments[i];
-        const segPath = join17(tmpDir, `seg-${i.toString().padStart(4, "0")}.ts`);
+        const segPath = join18(tmpDir, `seg-${i.toString().padStart(4, "0")}.ts`);
         const duration = seg.end - seg.start;
         await execSafe(
           "ffmpeg",
@@ -37427,7 +37567,7 @@ async function executeJumpCut(options) {
         segmentPaths.push(segPath);
       }
       const concatList = segmentPaths.map((p) => `file '${p}'`).join("\n");
-      const listPath = join17(tmpDir, "concat.txt");
+      const listPath = join18(tmpDir, "concat.txt");
       await writeFile20(listPath, concatList);
       await execSafe(
         "ffmpeg",
@@ -37534,8 +37674,8 @@ __export(remotion_exports, {
   wrapComponentWithVideo: () => wrapComponentWithVideo
 });
 import { writeFile as writeFile21, mkdir as mkdir12, rm as rm2, copyFile as copyFile4 } from "node:fs/promises";
-import { existsSync as existsSync23 } from "node:fs";
-import { join as join18 } from "node:path";
+import { existsSync as existsSync24 } from "node:fs";
+import { join as join19 } from "node:path";
 import { tmpdir } from "node:os";
 import { createHash as createHash6 } from "node:crypto";
 async function ensureRemotionInstalled() {
@@ -37554,7 +37694,7 @@ async function ensureRemotionInstalled() {
   }
 }
 async function scaffoldRemotionProject(componentCode, componentName, opts) {
-  const dir = join18(tmpdir(), `vibe_motion_${Date.now()}`);
+  const dir = join19(tmpdir(), `vibe_motion_${Date.now()}`);
   await mkdir12(dir, { recursive: true });
   const deps = {
     remotion: REMOTION_VERSION,
@@ -37573,7 +37713,7 @@ async function scaffoldRemotionProject(componentCode, componentName, opts) {
     dependencies: deps
   };
   const packageJsonStr = JSON.stringify(packageJson, null, 2);
-  await writeFile21(join18(dir, "package.json"), packageJsonStr);
+  await writeFile21(join19(dir, "package.json"), packageJsonStr);
   const tsconfig = {
     compilerOptions: {
       target: "ES2020",
@@ -37585,8 +37725,8 @@ async function scaffoldRemotionProject(componentCode, componentName, opts) {
       skipLibCheck: true
     }
   };
-  await writeFile21(join18(dir, "tsconfig.json"), JSON.stringify(tsconfig, null, 2));
-  await writeFile21(join18(dir, "Component.tsx"), componentCode);
+  await writeFile21(join19(dir, "tsconfig.json"), JSON.stringify(tsconfig, null, 2));
+  await writeFile21(join19(dir, "Component.tsx"), componentCode);
   const rootCode = `import { registerRoot, Composition } from "remotion";
 import { ${componentName} } from "./Component";
 
@@ -37605,14 +37745,14 @@ const Root = () => {
 
 registerRoot(Root);
 `;
-  await writeFile21(join18(dir, "Root.tsx"), rootCode);
+  await writeFile21(join19(dir, "Root.tsx"), rootCode);
   const depsHash = createHash6("md5").update(packageJsonStr).digest("hex").slice(0, 12);
-  const cacheMarker = join18(REMOTION_CACHE_DIR, `.deps-${depsHash}`);
-  const cachedModules = join18(REMOTION_CACHE_DIR, "node_modules");
-  if (existsSync23(cacheMarker) && existsSync23(cachedModules)) {
+  const cacheMarker = join19(REMOTION_CACHE_DIR, `.deps-${depsHash}`);
+  const cachedModules = join19(REMOTION_CACHE_DIR, "node_modules");
+  if (existsSync24(cacheMarker) && existsSync24(cachedModules)) {
     const { symlink } = await import("node:fs/promises");
     try {
-      await symlink(cachedModules, join18(dir, "node_modules"), "dir");
+      await symlink(cachedModules, join19(dir, "node_modules"), "dir");
     } catch {
       await this_npmInstall(dir);
     }
@@ -37620,12 +37760,12 @@ registerRoot(Root);
     await this_npmInstall(dir);
     try {
       await mkdir12(REMOTION_CACHE_DIR, { recursive: true });
-      await writeFile21(join18(REMOTION_CACHE_DIR, "package.json"), packageJsonStr);
-      if (existsSync23(join18(dir, "node_modules"))) {
+      await writeFile21(join19(REMOTION_CACHE_DIR, "package.json"), packageJsonStr);
+      if (existsSync24(join19(dir, "node_modules"))) {
         const { rename: rename5, symlink } = await import("node:fs/promises");
-        await rename5(join18(dir, "node_modules"), cachedModules).catch(() => {
+        await rename5(join19(dir, "node_modules"), cachedModules).catch(() => {
         });
-        await symlink(cachedModules, join18(dir, "node_modules"), "dir").catch(() => {
+        await symlink(cachedModules, join19(dir, "node_modules"), "dir").catch(() => {
         });
         await writeFile21(cacheMarker, depsHash);
       }
@@ -37662,7 +37802,7 @@ async function renderMotion(options) {
     }
   );
   try {
-    const entryPoint = join18(dir, "Root.tsx");
+    const entryPoint = join19(dir, "Root.tsx");
     const { execFile: execFile3 } = await import("node:child_process");
     const { promisify: promisify3 } = await import("node:util");
     const execFileAsync3 = promisify3(execFile3);
@@ -37795,10 +37935,10 @@ async function renderWithEmbeddedImage(options) {
     }
   );
   try {
-    const publicDir = join18(dir, "public");
+    const publicDir = join19(dir, "public");
     await mkdir12(publicDir, { recursive: true });
-    await copyFile4(options.imagePath, join18(publicDir, options.imageFileName));
-    const entryPoint = join18(dir, "Root.tsx");
+    await copyFile4(options.imagePath, join19(publicDir, options.imageFileName));
+    const entryPoint = join19(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");
@@ -37859,10 +37999,10 @@ async function renderWithEmbeddedVideo(options) {
     }
   );
   try {
-    const publicDir = join18(dir, "public");
+    const publicDir = join19(dir, "public");
     await mkdir12(publicDir, { recursive: true });
-    await copyFile4(options.videoPath, join18(publicDir, options.videoFileName));
-    const entryPoint = join18(dir, "Root.tsx");
+    await copyFile4(options.videoPath, join19(publicDir, options.videoFileName));
+    const entryPoint = join19(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");
@@ -38278,14 +38418,14 @@ var init_remotion = __esm({
     "use strict";
     init_exec_safe();
     REMOTION_VERSION = "4.0.447";
-    REMOTION_CACHE_DIR = join18(tmpdir(), "vibe_remotion_cache");
+    REMOTION_CACHE_DIR = join19(tmpdir(), "vibe_remotion_cache");
   }
 });
 
 // src/commands/_shared/edit/caption.ts
-import { existsSync as existsSync24 } from "node:fs";
-import { readFile as readFile22, writeFile as writeFile22, mkdir as mkdir13 } from "node:fs/promises";
-import { dirname as dirname12, basename as basename6, extname as extname5, join as join19 } from "node:path";
+import { existsSync as existsSync25 } from "node:fs";
+import { readFile as readFile23, writeFile as writeFile22, mkdir as mkdir13 } from "node:fs/promises";
+import { dirname as dirname12, basename as basename6, extname as extname5, join as join20 } from "node:path";
 function getCaptionForceStyle(style, fontSize, fontColor, position) {
   const alignment = position === "top" ? 8 : position === "center" ? 5 : 2;
   const marginV = position === "center" ? 0 : 30;
@@ -38313,7 +38453,7 @@ async function executeCaption(options) {
     position = "bottom",
     apiKey
   } = options;
-  if (!existsSync24(videoPath)) {
+  if (!existsSync25(videoPath)) {
     return { success: false, error: `Video not found: ${videoPath}` };
   }
   if (!commandExists("ffmpeg")) {
@@ -38332,8 +38472,8 @@ async function executeCaption(options) {
   try {
     const tmpDir = `/tmp/vibe_caption_${Date.now()}`;
     await mkdir13(tmpDir, { recursive: true });
-    const audioPath = join19(tmpDir, "audio.wav");
-    const srtPath = join19(tmpDir, "captions.srt");
+    const audioPath = join20(tmpDir, "audio.wav");
+    const srtPath = join20(tmpDir, "captions.srt");
     try {
       await execSafe(
         "ffmpeg",
@@ -38354,7 +38494,7 @@ async function executeCaption(options) {
       );
       const whisper = new WhisperProvider();
       await whisper.initialize({ apiKey: openaiKey });
-      const audioBuffer = await readFile22(audioPath);
+      const audioBuffer = await readFile23(audioPath);
       const audioBlob = new Blob([audioBuffer]);
       const transcriptResult = await whisper.transcribe(audioBlob, language);
       if (transcriptResult.status === "failed" || !transcriptResult.segments || transcriptResult.segments.length === 0) {
@@ -38402,7 +38542,7 @@ async function executeCaption(options) {
         const remotionErr = await ensureRemotionInstalled2();
         if (remotionErr) {
           const outputDir2 = dirname12(outputPath);
-          const outputSrtPath2 = join19(
+          const outputSrtPath2 = join20(
             outputDir2,
             basename6(outputPath, extname5(outputPath)) + ".srt"
           );
@@ -38441,7 +38581,7 @@ SRT saved to: ${outputSrtPath2}` };
         });
         if (!renderResult.success) {
           const outputDir2 = dirname12(outputPath);
-          const outputSrtPath2 = join19(
+          const outputSrtPath2 = join20(
             outputDir2,
             basename6(outputPath, extname5(outputPath)) + ".srt"
           );
@@ -38454,7 +38594,7 @@ SRT saved to: ${outputSrtPath2}`
         }
       }
       const outputDir = dirname12(outputPath);
-      const outputSrtPath = join19(
+      const outputSrtPath = join20(
         outputDir,
         basename6(outputPath, extname5(outputPath)) + ".srt"
       );
@@ -38491,10 +38631,10 @@ var init_caption = __esm({
 });
 
 // src/commands/_shared/edit/noise-reduce.ts
-import { existsSync as existsSync25 } from "node:fs";
+import { existsSync as existsSync26 } from "node:fs";
 async function executeNoiseReduce(options) {
   const { inputPath, outputPath, strength = "medium", noiseFloor } = options;
-  if (!existsSync25(inputPath)) {
+  if (!existsSync26(inputPath)) {
     return { success: false, error: `File not found: ${inputPath}` };
   }
   if (!commandExists("ffmpeg")) {
@@ -38551,7 +38691,7 @@ var init_noise_reduce = __esm({
 });
 
 // src/commands/_shared/edit/fade.ts
-import { existsSync as existsSync26 } from "node:fs";
+import { existsSync as existsSync27 } from "node:fs";
 async function executeFade(options) {
   const {
     videoPath,
@@ -38561,7 +38701,7 @@ async function executeFade(options) {
     audioOnly = false,
     videoOnly = false
   } = options;
-  if (!existsSync26(videoPath)) {
+  if (!existsSync27(videoPath)) {
     return { success: false, error: `Video not found: ${videoPath}` };
   }
   if (!commandExists("ffmpeg")) {
@@ -38628,8 +38768,8 @@ var init_fade = __esm({
 });
 
 // src/commands/_shared/edit/translate-srt.ts
-import { existsSync as existsSync27 } from "node:fs";
-import { readFile as readFile23, writeFile as writeFile23 } from "node:fs/promises";
+import { existsSync as existsSync28 } from "node:fs";
+import { readFile as readFile24, writeFile as writeFile23 } from "node:fs/promises";
 async function executeTranslateSrt(options) {
   const {
     srtPath,
@@ -38639,11 +38779,11 @@ async function executeTranslateSrt(options) {
     sourceLanguage,
     apiKey
   } = options;
-  if (!existsSync27(srtPath)) {
+  if (!existsSync28(srtPath)) {
     return { success: false, error: `SRT file not found: ${srtPath}` };
   }
   try {
-    const srtContent = await readFile23(srtPath, "utf-8");
+    const srtContent = await readFile24(srtPath, "utf-8");
     const segments = parseSRT(srtContent);
     if (segments.length === 0) {
       return { success: false, error: "No subtitle segments found in SRT file" };
@@ -38756,7 +38896,7 @@ var init_translate_srt = __esm({
 });
 
 // src/commands/_shared/edit/text-overlay.ts
-import { existsSync as existsSync28 } from "node:fs";
+import { existsSync as existsSync29 } from "node:fs";
 import { resolve as resolve28 } from "node:path";
 function detectSystemFont() {
   const platform = process.platform;
@@ -38767,7 +38907,7 @@ function detectSystemFont() {
       "/Library/Fonts/Arial.ttf"
     ];
     for (const f of candidates) {
-      if (existsSync28(f)) return f;
+      if (existsSync29(f)) return f;
     }
   } else if (platform === "linux") {
     const candidates = [
@@ -38776,7 +38916,7 @@ function detectSystemFont() {
       "/usr/share/fonts/TTF/DejaVuSans-Bold.ttf"
     ];
     for (const f of candidates) {
-      if (existsSync28(f)) return f;
+      if (existsSync29(f)) return f;
     }
   } else if (platform === "win32") {
     const candidates = [
@@ -38784,7 +38924,7 @@ function detectSystemFont() {
       "C:\\Windows\\Fonts\\segoeui.ttf"
     ];
     for (const f of candidates) {
-      if (existsSync28(f)) return f;
+      if (existsSync29(f)) return f;
     }
   }
   return null;
@@ -38805,7 +38945,7 @@ async function applyTextOverlays(options) {
   }
   const absVideoPath = resolve28(process.cwd(), videoPath);
   const absOutputPath = resolve28(process.cwd(), outputPath);
-  if (!existsSync28(absVideoPath)) {
+  if (!existsSync29(absVideoPath)) {
     return { success: false, error: `Video not found: ${absVideoPath}` };
   }
   if (!commandExists("ffmpeg")) {
@@ -38986,7 +39126,7 @@ var init_ai_edit = __esm({
 
 // src/commands/ai-edit-cli.ts
 import { resolve as resolve29, extname as extname6, basename as basename7 } from "node:path";
-import { existsSync as existsSync29 } from "node:fs";
+import { existsSync as existsSync30 } 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:
@@ -39003,7 +39143,7 @@ No API key needed (FFmpeg only). Use --use-gemini for smart detection (requires
         validateOutputPath(options.output);
       }
       const absVideoPath = resolve29(process.cwd(), videoPath);
-      if (!existsSync29(absVideoPath)) {
+      if (!existsSync30(absVideoPath)) {
         exitWithError(notFoundError(absVideoPath));
       }
       if (!commandExists("ffmpeg")) {
@@ -39111,7 +39251,7 @@ Requires: OPENAI_API_KEY (Whisper transcription) + FFmpeg`).action(async (videoP
         validateOutputPath(options.output);
       }
       const absVideoPath = resolve29(process.cwd(), videoPath);
-      if (!existsSync29(absVideoPath)) {
+      if (!existsSync30(absVideoPath)) {
         exitWithError(notFoundError(absVideoPath));
       }
       if (!commandExists("ffmpeg")) {
@@ -39192,7 +39332,7 @@ Requires: OPENAI_API_KEY (Whisper transcription) + FFmpeg`).action(async (videoP
         validateOutputPath(options.output);
       }
       const absInputPath = resolve29(process.cwd(), inputPath);
-      if (!existsSync29(absInputPath)) {
+      if (!existsSync30(absInputPath)) {
         exitWithError(notFoundError(absInputPath));
       }
       if (!commandExists("ffmpeg")) {
@@ -39258,7 +39398,7 @@ Requires: OPENAI_API_KEY (Whisper transcription) + FFmpeg`).action(async (videoP
         validateOutputPath(options.output);
       }
       const absVideoPath = resolve29(process.cwd(), videoPath);
-      if (!existsSync29(absVideoPath)) {
+      if (!existsSync30(absVideoPath)) {
         exitWithError(notFoundError(absVideoPath));
       }
       if (!commandExists("ffmpeg")) {
@@ -39333,7 +39473,7 @@ Requires: OPENAI_API_KEY (Whisper transcription) + FFmpeg`).action(async (videoP
         exitWithError(usageError("Target language required. Use -t or --target"));
       }
       const absSrtPath = resolve29(process.cwd(), srtPath);
-      if (!existsSync29(absSrtPath)) {
+      if (!existsSync30(absSrtPath)) {
         exitWithError(notFoundError(absSrtPath));
       }
       if (options.dryRun) {
@@ -39409,7 +39549,7 @@ Requires: OPENAI_API_KEY (Whisper transcription) + FFmpeg`).action(async (videoP
       }
       if (options.fillers) rejectControlChars(options.fillers);
       const absVideoPath = resolve29(process.cwd(), videoPath);
-      if (!existsSync29(absVideoPath)) {
+      if (!existsSync30(absVideoPath)) {
         exitWithError(notFoundError(absVideoPath));
       }
       if (!commandExists("ffmpeg")) {
@@ -39902,8 +40042,8 @@ var init_project_resolver = __esm({
 });
 
 // src/commands/_shared/execute-fill-gaps.ts
-import { existsSync as existsSync30 } from "node:fs";
-import { readFile as readFile24, writeFile as writeFile24, mkdir as mkdir14, rename as renameFs } from "node:fs/promises";
+import { existsSync as existsSync31 } from "node:fs";
+import { readFile as readFile25, writeFile as writeFile24, mkdir as mkdir14, rename as renameFs } from "node:fs/promises";
 import { resolve as resolve31, dirname as dirname13 } from "node:path";
 function detectVideoGaps(videoClips, totalDuration) {
   const gaps = [];
@@ -39960,7 +40100,7 @@ function analyzeGapFillability(gaps, videoClips, sources) {
 }
 async function uploadFrameToImgbb(framePath, imgbbApiKey) {
   try {
-    const frameBuffer = await readFile24(framePath);
+    const frameBuffer = await readFile25(framePath);
     const frameBase64 = frameBuffer.toString("base64");
     const formData = new FormData();
     formData.append("key", imgbbApiKey);
@@ -39985,14 +40125,14 @@ async function executeFillGaps(options) {
   try {
     onProgress("Loading timeline...");
     const filePath = await resolveTimelineFile(options.projectPath);
-    if (!existsSync30(filePath)) {
+    if (!existsSync31(filePath)) {
       return {
         success: false,
         error: `Timeline file not found: ${filePath}`,
         humanLines
       };
     }
-    const content = await readFile24(filePath, "utf-8");
+    const content = await readFile25(filePath, "utf-8");
     const data = JSON.parse(content);
     const project = Project.fromJSON(data);
     const clips = project.getClips().sort((a, b) => a.startTime - b.startTime);
@@ -40120,7 +40260,7 @@ async function executeFillGaps(options) {
     }
     const projectDir = dirname13(filePath);
     const footageDir = options.dir ? resolve31(process.cwd(), options.dir) : resolve31(projectDir, "footage");
-    if (!existsSync30(footageDir)) {
+    if (!existsSync31(footageDir)) {
       await mkdir14(footageDir, { recursive: true });
     }
     humanLines.push("Generating AI Videos");
@@ -40440,8 +40580,8 @@ __export(ai_motion_exports, {
   registerMotionCommand: () => registerMotionCommand
 });
 import { resolve as resolve32 } from "node:path";
-import { existsSync as existsSync31 } from "node:fs";
-import { readFile as readFile25, writeFile as writeFile25 } from "node:fs/promises";
+import { existsSync as existsSync32 } from "node:fs";
+import { readFile as readFile26, writeFile as writeFile25 } from "node:fs/promises";
 async function getOptionalGoogleApiKey() {
   const configKey = await getApiKeyFromConfig("google");
   if (configKey) return configKey;
@@ -40488,7 +40628,7 @@ async function executeMotion(options) {
       };
     }
     const imagePath = resolve32(process.cwd(), options.image);
-    const imageBuffer = await readFile25(imagePath);
+    const imageBuffer = await readFile26(imagePath);
     const gemini = new GeminiProvider();
     await gemini.initialize({ apiKey: geminiApiKey });
     const analysisResult = await gemini.analyzeImage(
@@ -40525,7 +40665,7 @@ Use this image analysis to inform the color palette, typography placement, and o
     }
     if (geminiApiKey) {
       const videoPath = resolve32(process.cwd(), options.video);
-      const videoBuffer = await readFile25(videoPath);
+      const videoBuffer = await readFile26(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:
@@ -40556,10 +40696,10 @@ Use this video understanding to place motion graphics in safe zones, match the c
   let result;
   if (options.fromTsx) {
     const tsxPath = resolve32(process.cwd(), options.fromTsx);
-    if (!existsSync31(tsxPath)) {
+    if (!existsSync32(tsxPath)) {
       return { success: false, error: `TSX file not found: ${tsxPath}` };
     }
-    const existingCode = await readFile25(tsxPath, "utf-8");
+    const existingCode = await readFile26(tsxPath, "utf-8");
     if (useGemini) {
       const gemini = new GeminiProvider();
       await gemini.initialize({ apiKey });
@@ -41088,7 +41228,7 @@ __export(project_builder_exports, {
   resolveSourceUrl: () => resolveSourceUrl
 });
 import { mkdtemp, mkdir as mkdir15, copyFile as copyFile5, writeFile as writeFile26, rm as rm3, readdir as readdir3 } from "node:fs/promises";
-import { existsSync as existsSync32 } from "node:fs";
+import { existsSync as existsSync33 } from "node:fs";
 import { tmpdir as tmpdir2 } from "node:os";
 import { createRequire } from "node:module";
 import * as path from "node:path";
@@ -41100,7 +41240,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 (!existsSync32(resolved)) {
+    if (!existsSync33(resolved)) {
       throw new Error(`Source file not found: ${resolved} (from source id=${source.id})`);
     }
     const dest = path.join(assetsDir, path.basename(resolved));
@@ -41237,7 +41377,7 @@ __export(motion_overlay_exports, {
   registerMotionOverlayCommand: () => registerMotionOverlayCommand
 });
 import { mkdir as mkdir16 } from "node:fs/promises";
-import { existsSync as existsSync33 } from "node:fs";
+import { existsSync as existsSync34 } from "node:fs";
 import { basename as basename9, dirname as dirname15, extname as extname7, resolve as resolve34 } from "node:path";
 function normalizeUnderstand2(value) {
   return value === "off" || value === "required" || value === "auto" ? value : "auto";
@@ -41368,11 +41508,11 @@ async function executeMotionOverlay(options) {
   const validationError = assertValidRequest(options);
   if (validationError) return { success: false, error: validationError };
   const absVideo = resolve34(process.cwd(), options.videoPath);
-  if (!existsSync33(absVideo)) return { success: false, error: `Video file not found: ${absVideo}` };
+  if (!existsSync34(absVideo)) return { success: false, error: `Video file not found: ${absVideo}` };
   const outputPath = options.output ? resolve34(process.cwd(), options.output) : defaultOverlayOutput(options.videoPath);
   if (options.asset) {
     const absAsset = resolve34(process.cwd(), options.asset);
-    if (!existsSync33(absAsset)) return { success: false, error: `Lottie asset not found: ${absAsset}` };
+    if (!existsSync34(absAsset)) return { success: false, error: `Lottie asset not found: ${absAsset}` };
     const [videoDuration, size] = await Promise.all([
       ffprobeDuration(absVideo),
       ffprobeVideoSize(absVideo)
@@ -41539,7 +41679,7 @@ __export(edit_cmd_exports, {
   executeUpscale: () => executeUpscale
 });
 import { resolve as resolve35, dirname as dirname16 } from "node:path";
-import { readFile as readFile26, writeFile as writeFile27, mkdir as mkdir17 } from "node:fs/promises";
+import { readFile as readFile27, writeFile as writeFile27, mkdir as mkdir17 } from "node:fs/promises";
 async function executeGrade(options) {
   const { videoPath, style, preset, output, analyzeOnly, apiKey } = options;
   try {
@@ -41580,7 +41720,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");
@@ -41974,7 +42114,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) {
@@ -42107,7 +42247,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,
@@ -42236,7 +42376,7 @@ Run 'vibe schema edit.<command>' for structured parameter info.
         const imageBuffers = [];
         for (const imagePath of imagePaths) {
           const absPath = resolve35(process.cwd(), imagePath);
-          const buffer = await readFile26(absPath);
+          const buffer = await readFile27(absPath);
           imageBuffers.push(buffer);
         }
         let result;
@@ -42513,8 +42653,8 @@ __export(ai_image_exports, {
   executeThumbnailBestFrame: () => executeThumbnailBestFrame
 });
 import { resolve as resolve37, dirname as dirname18 } from "node:path";
-import { readFile as readFile27, writeFile as writeFile29, mkdir as mkdir19 } from "node:fs/promises";
-import { existsSync as existsSync35 } from "node:fs";
+import { readFile as readFile28, writeFile as writeFile29, mkdir as mkdir19 } from "node:fs/promises";
+import { existsSync as existsSync36 } from "node:fs";
 async function executeImageGenerate(options) {
   const {
     prompt: prompt3,
@@ -42658,10 +42798,10 @@ async function executeGeminiEdit(options) {
     const imageBuffers = [];
     for (const imagePath of imagePaths) {
       const absPath = resolve37(process.cwd(), imagePath);
-      if (!existsSync35(absPath)) {
+      if (!existsSync36(absPath)) {
         return { success: false, error: `Image not found: ${absPath}` };
       }
-      const buffer = await readFile27(absPath);
+      const buffer = await readFile28(absPath);
       imageBuffers.push(buffer);
     }
     const gemini = new GeminiProvider();
@@ -42706,7 +42846,7 @@ async function executeThumbnailBestFrame(options) {
     model = "flash",
     apiKey
   } = options;
-  if (!existsSync35(videoPath)) {
+  if (!existsSync36(videoPath)) {
     return { success: false, error: `Video not found: ${videoPath}` };
   }
   if (!commandExists("ffmpeg")) {
@@ -42719,7 +42859,7 @@ async function executeThumbnailBestFrame(options) {
   try {
     const gemini = new GeminiProvider();
     await gemini.initialize({ apiKey: googleKey });
-    const videoData = await readFile27(videoPath);
+    const videoData = await readFile28(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, {
@@ -42740,7 +42880,7 @@ async function executeThumbnailBestFrame(options) {
       reason = reasonMatch[1];
     }
     await execSafe("ffmpeg", ["-ss", String(timestamp), "-i", videoPath, "-frames:v", "1", "-q:v", "2", outputPath, "-y"], { timeout: 6e4, maxBuffer: 50 * 1024 * 1024 });
-    if (!existsSync35(outputPath)) {
+    if (!existsSync36(outputPath)) {
       return { success: false, error: "FFmpeg failed to extract frame" };
     }
     return {
@@ -42771,9 +42911,9 @@ __export(ai_analyze_exports, {
   executeGeminiVideo: () => executeGeminiVideo,
   registerAnalyzeCommands: () => registerAnalyzeCommands
 });
-import { readFile as readFile28 } from "node:fs/promises";
+import { readFile as readFile29 } from "node:fs/promises";
 import { extname as extname8, resolve as resolve38 } from "node:path";
-import { existsSync as existsSync36 } from "node:fs";
+import { existsSync as existsSync37 } from "node:fs";
 async function executeGeminiVideo(options) {
   try {
     const apiKey = await getApiKey("GOOGLE_API_KEY", "Google");
@@ -42787,10 +42927,10 @@ async function executeGeminiVideo(options) {
       videoData = options.source;
     } else {
       const absPath = resolve38(process.cwd(), options.source);
-      if (!existsSync36(absPath)) {
+      if (!existsSync37(absPath)) {
         return { success: false, error: `File not found: ${absPath}` };
       }
-      videoData = await readFile28(absPath);
+      videoData = await readFile29(absPath);
     }
     const gemini = new GeminiProvider();
     await gemini.initialize({ apiKey });
@@ -42855,10 +42995,10 @@ async function executeAnalyze(options) {
         imageBuffer = Buffer.from(await response.arrayBuffer());
       } else {
         const absPath = resolve38(process.cwd(), source);
-        if (!existsSync36(absPath)) {
+        if (!existsSync37(absPath)) {
           return { success: false, error: `File not found: ${absPath}` };
         }
-        imageBuffer = await readFile28(absPath);
+        imageBuffer = await readFile29(absPath);
       }
       const result2 = await gemini.analyzeImage(imageBuffer, options.prompt, {
         model: modelId,
@@ -42890,10 +43030,10 @@ async function executeAnalyze(options) {
       videoData = Buffer.from(await response.arrayBuffer());
     } else {
       const absPath = resolve38(process.cwd(), source);
-      if (!existsSync36(absPath)) {
+      if (!existsSync37(absPath)) {
         return { success: false, error: `File not found: ${absPath}` };
       }
-      videoData = await readFile28(absPath);
+      videoData = await readFile29(absPath);
     }
     const result = await gemini.analyzeVideo(videoData, options.prompt, {
       model: modelId,
@@ -43027,9 +43167,9 @@ __export(ai_review_exports, {
   executeReview: () => executeReview,
   registerReviewCommand: () => registerReviewCommand
 });
-import { readFile as readFile29, rename as rename3 } from "node:fs/promises";
+import { readFile as readFile30, rename as rename3 } from "node:fs/promises";
 import { resolve as resolve39 } from "node:path";
-import { existsSync as existsSync37 } from "node:fs";
+import { existsSync as existsSync38 } from "node:fs";
 function parseReviewFeedback(response) {
   let cleaned = response.trim();
   if (cleaned.startsWith("```json")) {
@@ -43061,7 +43201,7 @@ async function executeReview(options) {
     model = "flash"
   } = options;
   const absVideoPath = resolve39(process.cwd(), videoPath);
-  if (!existsSync37(absVideoPath)) {
+  if (!existsSync38(absVideoPath)) {
     return { success: false, error: `Video not found: ${absVideoPath}` };
   }
   const apiKey = process.env.GOOGLE_API_KEY || await getApiKey("GOOGLE_API_KEY", "Google");
@@ -43074,8 +43214,8 @@ async function executeReview(options) {
   let storyboardContext = "";
   if (storyboardPath) {
     const absStoryboardPath = resolve39(process.cwd(), storyboardPath);
-    if (existsSync37(absStoryboardPath)) {
-      const content = await readFile29(absStoryboardPath, "utf-8");
+    if (existsSync38(absStoryboardPath)) {
+      const content = await readFile30(absStoryboardPath, "utf-8");
       storyboardContext = `
 
 Original storyboard for reference:
@@ -43117,7 +43257,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 readFile29(absVideoPath);
+  const videoData = await readFile30(absVideoPath);
   const analysisResult = await gemini.analyzeVideo(videoData, reviewPrompt, {
     model: modelId
   });
@@ -43172,7 +43312,7 @@ Score each category 1-10. Prefer beatIssues when you can map a problem to a stor
     }
   }
   if (verify && result.outputPath) {
-    const verifyVideoData = await readFile29(result.outputPath);
+    const verifyVideoData = await readFile30(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>}',
@@ -43636,7 +43776,7 @@ var init_sanitize = __esm({
 
 // src/commands/generate/storyboard.ts
 import { resolve as resolve46 } from "node:path";
-import { readFile as readFile33, writeFile as writeFile33 } from "node:fs/promises";
+import { readFile as readFile34, writeFile as writeFile33 } from "node:fs/promises";
 async function executeStoryboard(options) {
   const { content, duration, creativity = "low", output, apiKey } = options;
   try {
@@ -43684,7 +43824,7 @@ function registerStoryboardCommand(parent) {
       let textContent = content;
       if (options.file) {
         const filePath = resolve46(process.cwd(), content);
-        textContent = await readFile33(filePath, "utf-8");
+        textContent = await readFile34(filePath, "utf-8");
       }
       if (options.dryRun) {
         outputSuccess({
@@ -44077,7 +44217,7 @@ var init_speech = __esm({
 
 // src/commands/generate/thumbnail.ts
 import { resolve as resolve48, dirname as dirname20, basename as basename13, extname as extname9 } from "node:path";
-import { existsSync as existsSync40 } from "node:fs";
+import { existsSync as existsSync41 } from "node:fs";
 import { writeFile as writeFile35, mkdir as mkdir21 } 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) => {
@@ -44089,7 +44229,7 @@ function registerThumbnailCommand(parent) {
       }
       if (options.bestFrame) {
         const absVideoPath = resolve48(process.cwd(), options.bestFrame);
-        if (!existsSync40(absVideoPath)) {
+        if (!existsSync41(absVideoPath)) {
           exitWithError(notFoundError(absVideoPath));
         }
         if (!commandExists("ffmpeg")) {
@@ -46273,7 +46413,7 @@ var init_dist3 = __esm({
 
 // src/commands/generate/video.ts
 import { resolve as resolve52 } from "node:path";
-import { readFile as readFile34, writeFile as writeFile39 } from "node:fs/promises";
+import { readFile as readFile35, writeFile as writeFile39 } 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>",
@@ -46384,7 +46524,7 @@ Examples:
       let isImageToVideo = false;
       if (options.image) {
         const imagePath = resolve52(process.cwd(), options.image);
-        const imageBuffer = await readFile34(imagePath);
+        const imageBuffer = await readFile35(imagePath);
         const ext = options.image.toLowerCase().split(".").pop();
         const mimeTypes = {
           jpg: "image/jpeg",
@@ -46624,7 +46764,7 @@ Examples:
         let lastFrame;
         if (options.lastFrame) {
           const lastFramePath = resolve52(process.cwd(), options.lastFrame);
-          const lastFrameBuffer = await readFile34(lastFramePath);
+          const lastFrameBuffer = await readFile35(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")}`;
@@ -46634,7 +46774,7 @@ Examples:
           refImages = [];
           for (const refPath of options.refImages.slice(0, 3)) {
             const absRefPath = resolve52(process.cwd(), refPath);
-            const refBuffer = await readFile34(absRefPath);
+            const refBuffer = await readFile35(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 });
@@ -46766,7 +46906,7 @@ Examples:
         if (seedanceEndImagePath && seedanceReferences.length === 0) {
           try {
             const absEndImagePath = resolve52(process.cwd(), seedanceEndImagePath);
-            const endImageBuffer = await readFile34(absEndImagePath);
+            const endImageBuffer = await readFile35(absEndImagePath);
             const ext = seedanceEndImagePath.toLowerCase().split(".").pop();
             const mimeType = ext === "jpg" || ext === "jpeg" ? "image/jpeg" : `image/${ext || "png"}`;
             const uploadHost = await resolveUploadHost();
@@ -46883,7 +47023,7 @@ async function fileInputToUrlOrDataUri2(input, fallbackMimeType) {
     return input;
   }
   const absPath = resolve52(process.cwd(), input);
-  const buffer = await readFile34(absPath);
+  const buffer = await readFile35(absPath);
   return `data:${mimeTypeForPath2(input, fallbackMimeType)};base64,${buffer.toString("base64")}`;
 }
 function mimeTypeForPath2(path2, fallback2) {
@@ -47891,7 +48031,7 @@ __export(detect_exports, {
   executeDetectScenes: () => executeDetectScenes,
   executeDetectSilence: () => executeDetectSilence
 });
-import { readFile as readFile39, writeFile as writeFile44 } from "node:fs/promises";
+import { readFile as readFile40, writeFile as writeFile44 } from "node:fs/promises";
 import { resolve as resolve57, basename as basename15 } from "node:path";
 async function executeDetectScenes(options) {
   try {
@@ -48135,7 +48275,7 @@ var init_detect = __esm({
         }
         if (options.project) {
           const projectPath = resolve57(process.cwd(), options.project);
-          const content = await readFile39(projectPath, "utf-8");
+          const content = await readFile40(projectPath, "utf-8");
           const data = JSON.parse(content);
           const project = Project.fromJSON(data);
           let source = project.getSources().find((s) => s.url === absPath);
@@ -52986,8 +53126,8 @@ init_scene_project();
 init_project_config();
 init_cost_tier();
 import { resolve as resolve17, relative as relative6, dirname as dirname6 } from "node:path";
-import { mkdir as mkdir8, readFile as readFile14, writeFile as writeFile15, access as access4, copyFile as copyFile2 } from "node:fs/promises";
-import { existsSync as existsSync13 } from "node:fs";
+import { mkdir as mkdir8, readFile as readFile15, writeFile as writeFile15, access as access4, copyFile as copyFile2 } from "node:fs/promises";
+import { existsSync as existsSync14 } from "node:fs";
 
 // src/commands/_shared/scene-html-emit.ts
 var SCENE_PRESETS = [
@@ -53556,15 +53696,16 @@ function deriveInstallHosts(detected) {
 
 // src/commands/scene.ts
 init_compose_prompts();
+init_transcribe_narration();
 
 // src/commands/_shared/scene-submit.ts
 init_compose_scenes_skills();
 init_scene_lint();
 init_storyboard_parse();
 init_root_sync();
-import { existsSync as existsSync11 } from "node:fs";
-import { mkdir as mkdir7, readFile as readFile11, writeFile as writeFile13 } from "node:fs/promises";
-import { join as join11, resolve as resolve14 } from "node:path";
+import { existsSync as existsSync12 } from "node:fs";
+import { mkdir as mkdir7, readFile as readFile12, writeFile as writeFile13 } from "node:fs/promises";
+import { join as join12, resolve as resolve14 } from "node:path";
 async function executeSceneSubmit(opts) {
   const projectDir = resolve14(opts.projectDir);
   const beatId = opts.beatId.trim();
@@ -53578,15 +53719,15 @@ async function executeSceneSubmit(opts) {
     warnings: [],
     retryWith: []
   };
-  const storyboardPath = join11(projectDir, "STORYBOARD.md");
-  if (!existsSync11(storyboardPath)) {
+  const storyboardPath = join12(projectDir, "STORYBOARD.md");
+  if (!existsSync12(storyboardPath)) {
     return {
       ...base,
       success: false,
       error: `STORYBOARD.md not found at ${storyboardPath}. Run \`vibe init <dir>\` first.`
     };
   }
-  const parsed = parseStoryboard(await readFile11(storyboardPath, "utf-8"));
+  const parsed = parseStoryboard(await readFile12(storyboardPath, "utf-8"));
   const beat = parsed.beats.find((b) => b.id === beatId);
   if (!beat) {
     const available = parsed.beats.map((b) => b.id).join(", ") || "(none)";
@@ -53656,8 +53797,8 @@ async function executeSceneSubmit(opts) {
   if (opts.validateOnly) {
     return { ...base, success: true };
   }
-  const absPath = join11(projectDir, scenePath);
-  await mkdir7(join11(projectDir, "compositions"), { recursive: true });
+  const absPath = join12(projectDir, scenePath);
+  await mkdir7(join12(projectDir, "compositions"), { recursive: true });
   await writeFile13(absPath, html.endsWith("\n") ? html : `${html}
 `, "utf-8");
   return {
@@ -53858,7 +53999,7 @@ sceneCommand.command("submit").description(
     }
     html = Buffer.concat(chunks).toString("utf-8");
   } else if (options.file) {
-    html = await readFile14(resolve17(String(options.file)), "utf-8");
+    html = await readFile15(resolve17(String(options.file)), "utf-8");
   } else {
     exitWithError(
       usageError(
@@ -54188,8 +54329,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 && existsSync13(value)) {
-    return (await readFile14(value, "utf-8")).trim();
+  if (looksLikePath && existsSync14(value)) {
+    return (await readFile15(value, "utf-8")).trim();
   }
   return value.trim();
 }
@@ -54228,7 +54369,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 readFile14(rootPath, "utf-8");
+  const rootHtmlBefore = await readFile15(rootPath, "utf-8");
   let dims = readRootDims(rootHtmlBefore);
   if (!dims) {
     const cfg2 = await loadVibeProjectConfig(projectDir);
@@ -54304,31 +54445,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 readFile14(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 writeFile15(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 writeFile15(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"
+        );
       }
     }
   }
@@ -54437,7 +54567,7 @@ async function executeSceneAdd(opts) {
   const shouldSyncStoryboard = opts.syncStoryboard !== false && await pathExists2(storyboardAbsPath);
   if (shouldSyncStoryboard) {
     opts.onProgress?.("Syncing STORYBOARD.md...");
-    const before = await readFile14(storyboardAbsPath, "utf-8");
+    const before = await readFile15(storyboardAbsPath, "utf-8");
     const synced = upsertStoryboardBeat(before, {
       beatId: id,
       title: opts.headline,
@@ -54479,7 +54609,7 @@ async function executeSceneAdd(opts) {
     });
     const blockingIssue = syncPlan.issues.find((issue) => issue.severity === "error");
     if (blockingIssue) return errResult(blockingIssue.message);
-    const rootHtmlAfterSync = await readFile14(rootPath, "utf-8");
+    const rootHtmlAfterSync = await readFile15(rootPath, "utf-8");
     start = readClipStart(rootHtmlAfterSync, id) ?? 0;
   } else {
     start = nextSceneStart(rootHtmlBefore, SCENE_OVERLAP_SECONDS);
@@ -54653,7 +54783,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") && existsSync13(resolve17(root, "index.html"))) {
+  if (defaultProject && root !== "index.html" && !root.toLowerCase().endsWith(".html") && existsSync14(resolve17(root, "index.html"))) {
     return { projectDir: resolve17(root), rootRel: "index.html" };
   }
   return { projectDir: resolve17(project), rootRel: root };
@@ -55522,7 +55652,7 @@ init_exec_safe();
 init_remotion();
 import { resolve as resolve36, dirname as dirname17, basename as basename10 } from "node:path";
 import { writeFile as writeFile28, mkdir as mkdir18, rm as rm4 } from "node:fs/promises";
-import { existsSync as existsSync34 } from "node:fs";
+import { existsSync as existsSync35 } from "node:fs";
 import { tmpdir as tmpdir3 } from "node:os";
 var ASS_STYLES = ["karaoke-sweep", "typewriter"];
 var SENTENCE_BREAKS = /[.!?]/;
@@ -55703,7 +55833,7 @@ async function executeAnimatedCaption(options) {
     const groups = groupWords(transcript.words, { wordsPerGroup, maxChars });
     const absOutputPath = resolve36(process.cwd(), outputPath);
     const outDir = dirname17(absOutputPath);
-    if (!existsSync34(outDir)) {
+    if (!existsSync35(outDir)) {
       await mkdir18(outDir, { recursive: true });
     }
     if (tier === "ass") {
@@ -56250,14 +56380,14 @@ init_ai_review();
 init_dist2();
 init_engine();
 init_ai_helpers();
-import { readFile as readFile30, writeFile as writeFile30 } from "node:fs/promises";
+import { readFile as readFile31, writeFile as writeFile30 } from "node:fs/promises";
 import { resolve as resolve40 } 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 = resolve40(process.cwd(), options.projectPath);
-    const content = await readFile30(filePath, "utf-8");
+    const content = await readFile31(filePath, "utf-8");
     const data = JSON.parse(content);
     const project = Project.fromJSON(data);
     const gemini = new GeminiProvider();
@@ -56294,9 +56424,9 @@ init_project_config();
 init_scene_lint();
 init_root_sync();
 init_review_report();
-import { existsSync as existsSync38 } from "node:fs";
-import { readdir as readdir4, readFile as readFile31, stat as stat5 } from "node:fs/promises";
-import { basename as basename11, isAbsolute as isAbsolute5, join as join21, relative as relative11, resolve as resolve41 } from "node:path";
+import { existsSync as existsSync39 } from "node:fs";
+import { readdir as readdir4, readFile as readFile32, stat as stat5 } from "node:fs/promises";
+import { basename as basename11, isAbsolute as isAbsolute5, join as join22, relative as relative11, resolve as resolve41 } from "node:path";
 async function inspectProject(opts) {
   const projectDir = resolve41(opts.projectDir);
   const issues = [];
@@ -56310,7 +56440,7 @@ async function inspectProject(opts) {
     assets: { checked: 0, missing: [], stale: [], unknownFreshness: [] },
     rootSync: { ok: null, issueCount: 0, issues: [] }
   };
-  if (!existsSync38(projectDir) || !await isDirectory(projectDir)) {
+  if (!existsSync39(projectDir) || !await isDirectory(projectDir)) {
     issues.push({
       severity: "error",
       code: "PROJECT_NOT_FOUND",
@@ -56325,15 +56455,15 @@ async function inspectProject(opts) {
     );
   }
   const coreFiles = {
-    storyboard: join21(projectDir, "STORYBOARD.md"),
-    design: join21(projectDir, "DESIGN.md"),
-    config: join21(projectDir, "vibe.config.json"),
-    legacyConfig: join21(projectDir, "vibe.project.yaml"),
-    buildReport: join21(projectDir, "build-report.json"),
-    root: join21(projectDir, "index.html")
+    storyboard: join22(projectDir, "STORYBOARD.md"),
+    design: join22(projectDir, "DESIGN.md"),
+    config: join22(projectDir, "vibe.config.json"),
+    legacyConfig: join22(projectDir, "vibe.project.yaml"),
+    buildReport: join22(projectDir, "build-report.json"),
+    root: join22(projectDir, "index.html")
   };
   for (const [name, path2] of Object.entries(coreFiles)) {
-    checks.files[name] = existsSync38(path2);
+    checks.files[name] = existsSync39(path2);
   }
   let beatIds = [];
   let inspectedBeatIds = [];
@@ -56347,7 +56477,7 @@ async function inspectProject(opts) {
     });
     retryWith.push(`vibe init ${projectDir} --from "<brief>" --json`);
   } else {
-    const storyboard = await readFile31(coreFiles.storyboard, "utf-8");
+    const storyboard = await readFile32(coreFiles.storyboard, "utf-8");
     const validation = validateStoryboardMarkdown(storyboard);
     storyboardBeats = validation.beats;
     beatIds = validation.beats.map((beat) => beat.id);
@@ -56389,7 +56519,7 @@ async function inspectProject(opts) {
       suggestedFix: "Create DESIGN.md or rerun `vibe init --from` in a new project."
     });
   } else {
-    const design = await readFile31(coreFiles.design, "utf-8");
+    const design = await readFile32(coreFiles.design, "utf-8");
     for (const issue of designPlaceholderIssues(design)) {
       issues.push(issue);
     }
@@ -56414,20 +56544,20 @@ async function inspectProject(opts) {
     });
     retryWith.push(`vibe build ${projectDir} --stage sync --json`);
   }
-  const compositionsDir = join21(projectDir, "compositions");
-  const existingComps = existsSync38(compositionsDir) ? new Set(await listHtmlBasenames(compositionsDir)) : /* @__PURE__ */ new Set();
+  const compositionsDir = join22(projectDir, "compositions");
+  const existingComps = existsSync39(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(join21("compositions", file));
+      checks.compositions.missing.push(join22("compositions", file));
       issues.push({
         severity: "error",
         code: "MISSING_COMPOSITION",
         message: `Composition for beat "${beatId}" is missing.`,
-        file: join21("compositions", file),
+        file: join22("compositions", file),
         scene: beatId,
         beatId,
         suggestedFix: "Run `vibe build --stage compose --json`."
@@ -56489,7 +56619,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 === join21("compositions", `scene-${opts.beatId}.html`)
+        (file) => file.file === "index.html" || file.file === join22("compositions", `scene-${opts.beatId}.html`)
       ) : lint.files;
       const lintCounts = countLintFindings(lintFiles);
       checks.lint = {
@@ -56635,7 +56765,7 @@ function projectSourceReports(checks) {
 async function inspectBuildReport(projectDir, reportPath, beatId, checks, issues, retryWith, storyboardBeats) {
   checks.buildReport.exists = true;
   try {
-    const report = JSON.parse(await readFile31(reportPath, "utf-8"));
+    const report = JSON.parse(await readFile32(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);
@@ -56772,7 +56902,7 @@ function inspectReportedAsset(opts) {
   opts.checks.assets.checked++;
   if (isExternalRef2(opts.value)) return;
   const abs = isAbsolute5(opts.value) ? opts.value : resolve41(opts.projectDir, opts.value);
-  if (existsSync38(abs)) return;
+  if (existsSync39(abs)) return;
   opts.checks.assets.missing.push(opts.value);
   opts.issues.push({
     severity: "warning",
@@ -56866,9 +56996,9 @@ init_exec_safe();
 init_project_config();
 init_storyboard_parse();
 init_review_report();
-import { existsSync as existsSync39 } from "node:fs";
-import { readdir as readdir5, readFile as readFile32, stat as stat6 } from "node:fs/promises";
-import { basename as basename12, isAbsolute as isAbsolute6, join as join22, relative as relative12, resolve as resolve42 } from "node:path";
+import { existsSync as existsSync40 } from "node:fs";
+import { readdir as readdir5, readFile as readFile33, stat as stat6 } from "node:fs/promises";
+import { basename as basename12, isAbsolute as isAbsolute6, join as join23, relative as relative12, resolve as resolve42 } from "node:path";
 var VIDEO_EXTENSIONS = /* @__PURE__ */ new Set([".mp4", ".mov", ".webm", ".m4v"]);
 var DEFAULT_AI_MODEL = "flash";
 var BLACK_FRAME_MIN_DURATION_SEC = 1;
@@ -57369,11 +57499,11 @@ async function inspectRender(opts) {
 }
 async function renderExpectsAudio(projectDir, beatId) {
   const root = resolve42(projectDir);
-  const rootHtml = await readTextIfExists(join22(root, "index.html"));
+  const rootHtml = await readTextIfExists(join23(root, "index.html"));
   if (rootHtml && rootHtmlExpectsAudio(rootHtml, beatId)) return true;
-  const buildReport = await readJsonIfExists(join22(root, "build-report.json"));
+  const buildReport = await readJsonIfExists(join23(root, "build-report.json"));
   if (buildReportExpectsAudio(buildReport, beatId)) return true;
-  const storyboard = await readTextIfExists(join22(root, "STORYBOARD.md"));
+  const storyboard = await readTextIfExists(join23(root, "STORYBOARD.md"));
   if (!storyboard) return false;
   try {
     const parsed = parseStoryboard(storyboard);
@@ -57384,7 +57514,7 @@ async function renderExpectsAudio(projectDir, beatId) {
         `assets/narration-${beat.id}.wav`,
         `assets/music-${beat.id}.mp3`,
         `assets/music-${beat.id}.wav`
-      ].some((asset) => existsSync39(join22(root, asset)))
+      ].some((asset) => existsSync40(join23(root, asset)))
     );
   } catch {
     return false;
@@ -57492,8 +57622,8 @@ async function maybeWriteRenderReport(projectDir, opts, result) {
 }
 function renderSourceReports(projectDir, videoPath, checks) {
   const reports = [];
-  if (existsSync39(join22(projectDir, "build-report.json"))) reports.push("build-report.json");
-  if (existsSync39(join22(projectDir, "render-report.json"))) reports.push("render-report.json");
+  if (existsSync40(join23(projectDir, "build-report.json"))) reports.push("build-report.json");
+  if (existsSync40(join23(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");
@@ -57506,31 +57636,31 @@ function renderSourceReports(projectDir, videoPath, checks) {
 async function resolveRenderVideoPath(projectDir, explicit, beatId) {
   if (explicit) {
     const candidate = resolve42(process.cwd(), explicit);
-    return existsSync39(candidate) ? candidate : null;
+    return existsSync40(candidate) ? candidate : null;
   }
-  const renderReportPath = join22(projectDir, "render-report.json");
-  if (existsSync39(renderReportPath)) {
+  const renderReportPath = join23(projectDir, "render-report.json");
+  if (existsSync40(renderReportPath)) {
     try {
-      const report = JSON.parse(await readFile32(renderReportPath, "utf-8"));
+      const report = JSON.parse(await readFile33(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 && existsSync39(candidate)) return candidate;
+        if (candidate && existsSync40(candidate)) return candidate;
       }
     } catch {
     }
   }
-  const reportPath = join22(projectDir, "build-report.json");
-  if (!beatId && existsSync39(reportPath)) {
+  const reportPath = join23(projectDir, "build-report.json");
+  if (!beatId && existsSync40(reportPath)) {
     try {
-      const report = JSON.parse(await readFile32(reportPath, "utf-8"));
+      const report = JSON.parse(await readFile33(reportPath, "utf-8"));
       const candidate = resolveReportedPath(projectDir, report.outputPath);
-      if (candidate && existsSync39(candidate)) return candidate;
+      if (candidate && existsSync40(candidate)) return candidate;
     } catch {
     }
   }
-  const rendersDir = join22(projectDir, "renders");
-  if (!existsSync39(rendersDir)) return null;
+  const rendersDir = join23(projectDir, "renders");
+  if (!existsSync40(rendersDir)) return null;
   const entries = await readdir5(rendersDir, { withFileTypes: true });
   const candidates = [];
   for (const entry of entries) {
@@ -57538,7 +57668,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(sanitizeFileSegment2(beatId))) continue;
-    const full = join22(rendersDir, entry.name);
+    const full = join23(rendersDir, entry.name);
     const info = await stat6(full);
     candidates.push({ path: full, mtimeMs: info.mtimeMs });
   }
@@ -57556,14 +57686,14 @@ async function runAiRenderReview(projectDir, videoPath, model) {
   });
 }
 function resolveStoryboardPath(projectDir) {
-  const storyboardPath = join22(projectDir, "STORYBOARD.md");
-  return existsSync39(storyboardPath) ? storyboardPath : null;
+  const storyboardPath = join23(projectDir, "STORYBOARD.md");
+  return existsSync40(storyboardPath) ? storyboardPath : null;
 }
 async function expectedDurationFromBuildReport(projectDir, beatId) {
-  const reportPath = join22(projectDir, "build-report.json");
-  if (!existsSync39(reportPath)) return void 0;
+  const reportPath = join23(projectDir, "build-report.json");
+  if (!existsSync40(reportPath)) return void 0;
   try {
-    const report = JSON.parse(await readFile32(reportPath, "utf-8"));
+    const report = JSON.parse(await readFile33(reportPath, "utf-8"));
     const beats = beatId ? (report.beats ?? []).filter((beat) => beat.id === beatId) : report.beats ?? [];
     const durations = beats.map(
       (beat) => parseOptionalNumber2(beat.sceneDurationSec) ?? parseOptionalNumber2(beat.narration?.sceneDurationSec)
@@ -57575,10 +57705,10 @@ async function expectedDurationFromBuildReport(projectDir, beatId) {
   }
 }
 async function beatTimingsFromBuildReport(projectDir, beatId) {
-  const reportPath = join22(projectDir, "build-report.json");
-  if (!existsSync39(reportPath)) return [];
+  const reportPath = join23(projectDir, "build-report.json");
+  if (!existsSync40(reportPath)) return [];
   try {
-    const report = JSON.parse(await readFile32(reportPath, "utf-8"));
+    const report = JSON.parse(await readFile33(reportPath, "utf-8"));
     const source = report.beats ?? [];
     const selected = beatId ? source.filter((beat) => beat.id === beatId) : source;
     let cursor = 0;
@@ -57604,17 +57734,17 @@ async function beatTimingsFromBuildReport(projectDir, beatId) {
 }
 async function buildRenderReviewProjectContext(projectDir) {
   const parts = [];
-  const storyboard = await readTextIfExists(join22(projectDir, "STORYBOARD.md"));
+  const storyboard = await readTextIfExists(join23(projectDir, "STORYBOARD.md"));
   if (storyboard) {
     parts.push(`STORYBOARD.md:
 ${truncateText(storyboard, 4e3)}`);
     parts.push(`Storyboard beat cue summary:
 ${storyboardBeatCueSummary(storyboard)}`);
   }
-  const design = await readTextIfExists(join22(projectDir, "DESIGN.md"));
+  const design = await readTextIfExists(join23(projectDir, "DESIGN.md"));
   if (design) parts.push(`DESIGN.md:
 ${truncateText(design, 4e3)}`);
-  const buildReport = await readTextIfExists(join22(projectDir, "build-report.json"));
+  const buildReport = await readTextIfExists(join23(projectDir, "build-report.json"));
   if (buildReport) parts.push(`build-report.json:
 ${truncateText(buildReport, 6e3)}`);
   const timings = await beatTimingsFromBuildReport(projectDir);
@@ -57642,9 +57772,9 @@ function storyboardBeatCueSummary(storyboard) {
   }
 }
 async function readTextIfExists(path2) {
-  if (!existsSync39(path2)) return null;
+  if (!existsSync40(path2)) return null;
   try {
-    return await readFile32(path2, "utf-8");
+    return await readFile33(path2, "utf-8");
   } catch {
     return null;
   }
@@ -58462,16 +58592,16 @@ var generateTools = [
 ];
 
 // src/tools/manifest/storyboard.ts
-import { existsSync as existsSync42 } from "node:fs";
-import { readFile as readFile36, writeFile as writeFile41 } from "node:fs/promises";
+import { existsSync as existsSync43 } from "node:fs";
+import { readFile as readFile37, writeFile as writeFile41 } from "node:fs/promises";
 import { resolve as resolve54 } from "node:path";
 init_storyboard_parse();
 init_storyboard_edit();
 
 // src/commands/_shared/storyboard-revise.ts
-import { existsSync as existsSync41 } from "node:fs";
-import { readFile as readFile35, writeFile as writeFile40 } from "node:fs/promises";
-import { join as join23, resolve as resolve53 } from "node:path";
+import { existsSync as existsSync42 } from "node:fs";
+import { readFile as readFile36, writeFile as writeFile40 } from "node:fs/promises";
+import { join as join24, resolve as resolve53 } from "node:path";
 
 // src/agent/adapters/index.ts
 init_openai2();
@@ -58523,9 +58653,9 @@ init_storyboard_parse();
 init_storyboard_edit();
 async function executeStoryboardRevision(opts) {
   const projectDir = resolve53(opts.projectDir);
-  const storyboardPath = join23(projectDir, "STORYBOARD.md");
+  const storyboardPath = join24(projectDir, "STORYBOARD.md");
   const retryWith = [`vibe storyboard revise ${projectDir} --from "<request>" --dry-run --json`];
-  if (!existsSync41(storyboardPath)) {
+  if (!existsSync42(storyboardPath)) {
     return failureResult({
       projectDir,
       storyboardPath,
@@ -58535,7 +58665,7 @@ async function executeStoryboardRevision(opts) {
       retryWith: [`vibe init ${projectDir} --from "<brief>" --json`]
     });
   }
-  const currentStoryboard = await readFile35(storyboardPath, "utf-8");
+  const currentStoryboard = await readFile36(storyboardPath, "utf-8");
   const projectConfig = await readProjectConfig(projectDir);
   const explicitComposer = opts.composer ?? projectConfig.config.providers.composer ?? void 0;
   let provider = explicitComposer ?? "claude";
@@ -58758,18 +58888,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(join23(projectDir, "DESIGN.md"));
-  const buildReportJson = await readOptionalJsonText(join23(projectDir, "build-report.json"));
+  const designMd = await readOptionalText(join24(projectDir, "DESIGN.md"));
+  const buildReportJson = await readOptionalJsonText(join24(projectDir, "build-report.json"));
   return { designMd, buildReportJson };
 }
 async function readOptionalText(path2) {
-  if (!existsSync41(path2)) return null;
-  return readFile35(path2, "utf-8");
+  if (!existsSync42(path2)) return null;
+  return readFile36(path2, "utf-8");
 }
 async function readOptionalJsonText(path2) {
-  if (!existsSync41(path2)) return null;
+  if (!existsSync42(path2)) return null;
   try {
-    const parsed = JSON.parse(await readFile35(path2, "utf-8"));
+    const parsed = JSON.parse(await readFile36(path2, "utf-8"));
     return JSON.stringify(parsed, null, 2);
   } catch {
     return null;
@@ -58814,8 +58944,8 @@ var projectDirSchema = external_exports.object({
 });
 async function readStoryboard(projectDir) {
   const path2 = resolve54(projectDir, "STORYBOARD.md");
-  if (!existsSync42(path2)) return null;
-  return { path: path2, markdown: await readFile36(path2, "utf-8") };
+  if (!existsSync43(path2)) return null;
+  return { path: path2, markdown: await readFile37(path2, "utf-8") };
 }
 var storyboardListTool = defineTool({
   name: "storyboard_list",
@@ -59074,7 +59204,7 @@ var storyboardTools = [
 // src/tools/manifest/remix.ts
 import { writeFile as writeFile46 } from "node:fs/promises";
 import { tmpdir as tmpdir4 } from "node:os";
-import { join as join24 } from "node:path";
+import { join as join25 } from "node:path";
 
 // src/commands/ai-script-pipeline.ts
 var import_yaml6 = __toESM(require_dist2(), 1);
@@ -59084,9 +59214,9 @@ init_config();
 init_audio();
 init_ai_helpers();
 init_video_utils();
-import { readFile as readFile37, writeFile as writeFile42, unlink as unlink3, rename as rename4 } from "node:fs/promises";
+import { readFile as readFile38, writeFile as writeFile42, unlink as unlink3, rename as rename4 } from "node:fs/promises";
 import { resolve as resolve55, extname as extname10 } from "node:path";
-import { existsSync as existsSync43 } from "node:fs";
+import { existsSync as existsSync44 } from "node:fs";
 
 // src/commands/_shared/video-providers.ts
 init_source();
@@ -59245,16 +59375,16 @@ async function executeRegenerateScene(options) {
   };
   try {
     const outputDir = resolve55(process.cwd(), options.projectDir);
-    if (!existsSync43(outputDir)) {
+    if (!existsSync44(outputDir)) {
       return { ...result, error: `Project directory not found: ${outputDir}` };
     }
     const yamlPath = resolve55(outputDir, "storyboard.yaml");
     const jsonPath = resolve55(outputDir, "storyboard.json");
-    const storyboardPath = existsSync43(yamlPath) ? yamlPath : existsSync43(jsonPath) ? jsonPath : null;
+    const storyboardPath = existsSync44(yamlPath) ? yamlPath : existsSync44(jsonPath) ? jsonPath : null;
     if (!storyboardPath) {
       return { ...result, error: `Storyboard not found in: ${outputDir} (expected storyboard.yaml or storyboard.json)` };
     }
-    const storyboardContent = await readFile37(storyboardPath, "utf-8");
+    const storyboardContent = await readFile38(storyboardPath, "utf-8");
     const segments = storyboardPath.endsWith(".yaml") ? (0, import_yaml6.parse)(storyboardContent).scenes : JSON.parse(storyboardContent);
     for (const sceneNum of options.scenes) {
       if (sceneNum < 1 || sceneNum > segments.length) {
@@ -59343,15 +59473,15 @@ IMPORTANT - Character appearance must match exactly: ${characterDesc}`;
         const refSceneNum = options.referenceScene;
         if (refSceneNum && refSceneNum >= 1 && refSceneNum <= segments.length && refSceneNum !== sceneNum) {
           const refImagePath = resolve55(outputDir, `scene-${refSceneNum}.png`);
-          if (existsSync43(refImagePath)) {
-            referenceImageBuffer = await readFile37(refImagePath);
+          if (existsSync44(refImagePath)) {
+            referenceImageBuffer = await readFile38(refImagePath);
           }
         } else if (!refSceneNum) {
           for (let i = 1; i <= segments.length; i++) {
             if (i !== sceneNum) {
               const otherImagePath = resolve55(outputDir, `scene-${i}.png`);
-              if (existsSync43(otherImagePath)) {
-                referenceImageBuffer = await readFile37(otherImagePath);
+              if (existsSync44(otherImagePath)) {
+                referenceImageBuffer = await readFile38(otherImagePath);
                 break;
               }
             }
@@ -59439,11 +59569,11 @@ Generate the single-person scene image now.`;
       }
       if (regenerateVideo && videoApiKey) {
         options.onProgress?.(`Scene ${sceneNum}: regenerating video (${options.generator || "grok"})...`);
-        if (!existsSync43(imagePath)) {
+        if (!existsSync44(imagePath)) {
           result.failedScenes.push(sceneNum);
           continue;
         }
-        const imageBuffer = await readFile37(imagePath);
+        const imageBuffer = await readFile38(imagePath);
         const videoDuration = segment.duration > 5 ? 10 : 5;
         const maxRetries = options.retries ?? DEFAULT_VIDEO_RETRIES;
         if (options.generator === "grok") {
@@ -59651,9 +59781,9 @@ Generate the single-person scene image now.`;
 }
 
 // src/commands/ai-highlights.ts
-import { readFile as readFile38, writeFile as writeFile43, mkdir as mkdir23 } from "node:fs/promises";
+import { readFile as readFile39, writeFile as writeFile43, mkdir as mkdir23 } from "node:fs/promises";
 import { resolve as resolve56, dirname as dirname22, basename as basename14, extname as extname11 } from "node:path";
-import { existsSync as existsSync44 } from "node:fs";
+import { existsSync as existsSync45 } from "node:fs";
 init_dist2();
 init_engine();
 init_api_key();
@@ -59684,7 +59814,7 @@ function filterHighlights(highlights, options) {
 async function executeHighlights(options) {
   try {
     const absPath = resolve56(process.cwd(), options.media);
-    if (!existsSync44(absPath)) {
+    if (!existsSync45(absPath)) {
       return { success: false, highlights: [], totalDuration: 0, totalHighlightDuration: 0, error: `File not found: ${absPath}` };
     }
     const ext = extname11(absPath).toLowerCase();
@@ -59703,7 +59833,7 @@ async function executeHighlights(options) {
       sourceDuration = await ffprobeDuration(absPath);
       const gemini = new GeminiProvider();
       await gemini.initialize({ apiKey: geminiApiKey });
-      const videoBuffer = await readFile38(absPath);
+      const videoBuffer = await readFile39(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.` : "";
@@ -59797,10 +59927,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 readFile38(audioPath);
+      const audioBuffer = await readFile39(audioPath);
       const audioBlob = new Blob([audioBuffer]);
       const transcriptResult = await whisper.transcribe(audioBlob, options.language);
-      if (tempAudioPath && existsSync44(tempAudioPath)) {
+      if (tempAudioPath && existsSync45(tempAudioPath)) {
         const { unlink: unlinkFile } = await import("node:fs/promises");
         await unlinkFile(tempAudioPath).catch(() => {
         });
@@ -59887,7 +60017,7 @@ async function executeAutoShorts(options) {
       return { success: false, shorts: [], error: "FFmpeg not found" };
     }
     const absPath = resolve56(process.cwd(), options.video);
-    if (!existsSync44(absPath)) {
+    if (!existsSync45(absPath)) {
       return { success: false, shorts: [], error: `File not found: ${absPath}` };
     }
     const targetDuration = options.duration ?? 60;
@@ -59900,7 +60030,7 @@ async function executeAutoShorts(options) {
       }
       const gemini = new GeminiProvider();
       await gemini.initialize({ apiKey: geminiApiKey });
-      const videoBuffer = await readFile38(absPath);
+      const videoBuffer = await readFile39(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.
@@ -59977,7 +60107,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 readFile38(tempAudio);
+      const audioBuffer = await readFile39(tempAudio);
       const audioBlob = new Blob([audioBuffer]);
       const transcript = await whisper.transcribe(audioBlob, options.language);
       try {
@@ -60015,7 +60145,7 @@ Analyze both VISUALS (expressions, actions, scene changes) and AUDIO (speech, re
       };
     }
     const outputDir = options.outputDir ? resolve56(process.cwd(), options.outputDir) : dirname22(absPath);
-    if (options.outputDir && !existsSync44(outputDir)) {
+    if (options.outputDir && !existsSync45(outputDir)) {
       await mkdir23(outputDir, { recursive: true });
     }
     const result = {
@@ -60094,8 +60224,8 @@ Analyze both VISUALS (expressions, actions, scene changes) and AUDIO (speech, re
 // src/pipeline/executor.ts
 var import_yaml7 = __toESM(require_dist2(), 1);
 import { resolve as resolve58 } from "node:path";
-import { readFile as readFile40, writeFile as writeFile45, mkdir as mkdir24 } from "node:fs/promises";
-import { existsSync as existsSync45 } from "node:fs";
+import { readFile as readFile41, writeFile as writeFile45, mkdir as mkdir24 } from "node:fs/promises";
+import { existsSync as existsSync46 } from "node:fs";
 
 // src/pipeline/resolver.ts
 function resolveStepParams(params, completedSteps) {
@@ -60508,10 +60638,10 @@ async function ensureActionsRegistered() {
 }
 async function loadPipeline(filePath) {
   const absPath = resolve58(process.cwd(), filePath);
-  if (!existsSync45(absPath)) {
+  if (!existsSync46(absPath)) {
     throw new Error(`Pipeline file not found: ${absPath}`);
   }
-  const content = await readFile40(absPath, "utf-8");
+  const content = await readFile41(absPath, "utf-8");
   const manifest2 = (0, import_yaml7.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");
@@ -60534,8 +60664,8 @@ async function executePipeline(manifest2, options = {}) {
   const startTime = Date.now();
   if (options.resume) {
     const checkpointPath = resolve58(outputDir, CHECKPOINT_FILE);
-    if (existsSync45(checkpointPath)) {
-      const checkpointContent = await readFile40(checkpointPath, "utf-8");
+    if (existsSync46(checkpointPath)) {
+      const checkpointContent = await readFile41(checkpointPath, "utf-8");
       const checkpoint = (0, import_yaml7.parse)(checkpointContent);
       for (const cs of checkpoint.completedSteps) {
         completedSteps.set(cs.id, {
@@ -60807,7 +60937,7 @@ var pipelineRunTool = defineTool({
     let resolvedPath = args.pipelinePath;
     let tempPath;
     if (args.pipelineYaml) {
-      tempPath = join24(tmpdir4(), `vibe-mcp-pipeline-${Date.now()}.yaml`);
+      tempPath = join25(tmpdir4(), `vibe-mcp-pipeline-${Date.now()}.yaml`);
       await writeFile46(tempPath, args.pipelineYaml, "utf-8");
       resolvedPath = tempPath;
     }
@@ -60981,10 +61111,10 @@ init_project_resolver();
 // src/tools/manifest/_project-io.ts
 init_engine();
 init_project_resolver();
-import { readFile as readFile41, writeFile as writeFile47 } from "node:fs/promises";
+import { readFile as readFile42, writeFile as writeFile47 } from "node:fs/promises";
 async function loadProject(projectPath, cwd) {
   const absPath = await resolveTimelineFile(projectPath, cwd);
-  const content = await readFile41(absPath, "utf-8");
+  const content = await readFile42(absPath, "utf-8");
   const data = JSON.parse(content);
   return { project: Project.fromJSON(data), absPath };
 }
@@ -61334,12 +61464,12 @@ init_engine();
 
 // src/commands/_shared/project-list.ts
 init_storyboard_parse();
-import { readdir as readdir6, readFile as readFile42, stat as stat7 } from "node:fs/promises";
-import { existsSync as existsSync46 } from "node:fs";
-import { join as join25, resolve as resolve60 } from "node:path";
+import { readdir as readdir6, readFile as readFile43, stat as stat7 } from "node:fs/promises";
+import { existsSync as existsSync47 } from "node:fs";
+import { join as join26, resolve as resolve60 } from "node:path";
 async function executeProjectList(opts = {}) {
   const workspaceDir = resolve60(opts.workspaceDir ?? ".");
-  if (!existsSync46(workspaceDir)) {
+  if (!existsSync47(workspaceDir)) {
     return {
       success: false,
       workspaceDir,
@@ -61356,11 +61486,11 @@ async function executeProjectList(opts = {}) {
     if (entry.name === "node_modules") continue;
     if (entry.name.startsWith(".")) continue;
     if (entry.name.startsWith("_")) {
-      archivedCount += await countProjects(join25(workspaceDir, entry.name));
+      archivedCount += await countProjects(join26(workspaceDir, entry.name));
       continue;
     }
-    const projectDir = join25(workspaceDir, entry.name);
-    if (!existsSync46(join25(projectDir, "STORYBOARD.md"))) continue;
+    const projectDir = join26(workspaceDir, entry.name);
+    if (!existsSync47(join26(projectDir, "STORYBOARD.md"))) continue;
     projects.push(await describeProject(entry.name, projectDir));
   }
   projects.sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
@@ -61370,7 +61500,7 @@ async function countProjects(dir) {
   try {
     const entries = await readdir6(dir, { withFileTypes: true });
     return entries.filter(
-      (e) => e.isDirectory() && existsSync46(join25(dir, e.name, "STORYBOARD.md"))
+      (e) => e.isDirectory() && existsSync47(join26(dir, e.name, "STORYBOARD.md"))
     ).length;
   } catch {
     return 0;
@@ -61381,8 +61511,8 @@ async function describeProject(name, projectDir) {
   let storyboardDurationSec = 0;
   const timestamps = [];
   try {
-    const storyboardPath = join25(projectDir, "STORYBOARD.md");
-    const parsed = parseStoryboard(await readFile42(storyboardPath, "utf-8"));
+    const storyboardPath = join26(projectDir, "STORYBOARD.md");
+    const parsed = parseStoryboard(await readFile43(storyboardPath, "utf-8"));
     beats = parsed.beats.length;
     storyboardDurationSec = Number(
       parsed.beats.reduce((sum, beat) => sum + (beat.duration ?? 0), 0).toFixed(2)
@@ -61393,8 +61523,8 @@ async function describeProject(name, projectDir) {
   let buildStatus;
   let buildUpdatedAt;
   try {
-    const reportPath = join25(projectDir, "build-report.json");
-    const report = JSON.parse(await readFile42(reportPath, "utf-8"));
+    const reportPath = join26(projectDir, "build-report.json");
+    const report = JSON.parse(await readFile43(reportPath, "utf-8"));
     buildStatus = report.status ?? report.phase;
     buildUpdatedAt = report.updatedAt;
     timestamps.push((await stat7(reportPath)).mtimeMs);
@@ -61402,12 +61532,12 @@ async function describeProject(name, projectDir) {
   }
   let latestRender;
   try {
-    const rendersDir = join25(projectDir, "renders");
+    const rendersDir = join26(projectDir, "renders");
     const files = await readdir6(rendersDir);
     let newest;
     for (const file of files) {
       if (!/\.(mp4|webm|mov)$/i.test(file)) continue;
-      const { mtimeMs } = await stat7(join25(rendersDir, file));
+      const { mtimeMs } = await stat7(join26(rendersDir, file));
       if (!newest || mtimeMs > newest.mtimeMs) newest = { file, mtimeMs };
     }
     if (newest) {
@@ -61541,7 +61671,7 @@ init_exec_safe();
 init_output();
 init_validate();
 init_project_resolver();
-import { readFile as readFile43, access as access6 } from "node:fs/promises";
+import { readFile as readFile44, access as access6 } from "node:fs/promises";
 import { resolve as resolve62, basename as basename17 } from "node:path";
 import { spawn } from "node:child_process";
 function timelineBaseName(path2) {
@@ -61618,7 +61748,7 @@ async function runExport(projectPath, outputPath, options = {}) {
       };
     }
     const filePath = await resolveTimelineFile(projectPath);
-    const content = await readFile43(filePath, "utf-8");
+    const content = await readFile44(filePath, "utf-8");
     const data = JSON.parse(content);
     const project = Project.fromJSON(data);
     const summary = project.getSummary();
@@ -61742,7 +61872,7 @@ Run 'vibe schema export' for structured parameter info.`).action(async (projectP
     }
     spinner2.text = "Loading project...";
     const filePath = await resolveTimelineFile(projectPath);
-    const content = await readFile43(filePath, "utf-8");
+    const content = await readFile44(filePath, "utf-8");
     const data = JSON.parse(content);
     const project = Project.fromJSON(data);
     const summary = project.getSummary();
@@ -62340,14 +62470,14 @@ function getPresetSettings(preset, aspectRatio2) {
 }
 async function runHyperframesExport(projectPath, options, spinner2, startedAt) {
   spinner2.text = "Loading project...";
-  const { readFile: readFile45 } = await import("node:fs/promises");
+  const { readFile: readFile46 } = await import("node:fs/promises");
   const { resolve: resolve66 } = await import("node:path");
   const { Project: Project2 } = await Promise.resolve().then(() => (init_engine(), engine_exports));
   const { createHyperframesBackend: createHyperframesBackend2 } = await Promise.resolve().then(() => (init_hyperframes(), hyperframes_exports));
   const { exitWithError: exitWithError2, generalError: generalError2, outputSuccess: outputSuccess2 } = await Promise.resolve().then(() => (init_output(), output_exports));
   const chalk2 = (await Promise.resolve().then(() => (init_source(), source_exports))).default;
   const filePath = await resolveTimelineFile(projectPath);
-  const content = await readFile45(filePath, "utf-8");
+  const content = await readFile46(filePath, "utf-8");
   const project = Project2.fromJSON(JSON.parse(content));
   const state = project.getState();
   const outputPath = options.output ? resolve66(process.cwd(), options.output) : resolve66(process.cwd(), `${timelineBaseName(projectPath)}.${options.format ?? "mp4"}`);
@@ -62416,8 +62546,8 @@ var exportVideoTool = defineTool({
 var exportTools = [exportVideoTool];
 
 // src/tools/manifest/agent-only.ts
-import { readFile as readFile44, writeFile as writeFile50, readdir as readdir7, stat as stat8, access as access7, unlink as unlink4 } from "node:fs/promises";
-import { resolve as resolve64, join as join26, basename as basename18, extname as extname12 } from "node:path";
+import { readFile as readFile45, writeFile as writeFile50, readdir as readdir7, stat as stat8, access as access7, unlink as unlink4 } from "node:fs/promises";
+import { resolve as resolve64, join as join27, basename as basename18, extname as extname12 } from "node:path";
 init_engine();
 init_exec_safe();
 init_project_resolver();
@@ -62495,7 +62625,7 @@ var fsListTool = defineTool({
       const results = [];
       for (const entry of entries) {
         if (args.pattern && !matchPattern(entry.name, args.pattern)) continue;
-        const fullPath = join26(absPath, entry.name);
+        const fullPath = join27(absPath, entry.name);
         const stats = await stat8(fullPath);
         if (entry.isDirectory()) {
           results.push(`[DIR]  ${entry.name}/`);
@@ -62524,7 +62654,7 @@ var fsReadTool = defineTool({
   async execute(args, ctx) {
     try {
       const absPath = resolve64(ctx.workingDirectory, args.path);
-      const content = await readFile44(absPath, "utf-8");
+      const content = await readFile45(absPath, "utf-8");
       const maxLength = 4e3;
       const truncated = content.length > maxLength;
       const output = truncated ? content.substring(0, maxLength) + "\n... (truncated)" : content;
@@ -62597,7 +62727,7 @@ var batchImportTool = defineTool({
   async execute(args, ctx) {
     try {
       const filePath = resolve64(ctx.workingDirectory, args.project);
-      const content = await readFile44(filePath, "utf-8");
+      const content = await readFile45(filePath, "utf-8");
       const data = JSON.parse(content);
       const project = Project.fromJSON(data);
       const dirPath = resolve64(ctx.workingDirectory, args.directory);
@@ -62608,7 +62738,7 @@ var batchImportTool = defineTool({
       const scanDir = async (dir) => {
         const entries = await readdir7(dir, { withFileTypes: true });
         for (const entry of entries) {
-          const entryPath = join26(dir, entry.name);
+          const entryPath = join27(dir, entry.name);
           if (entry.isDirectory() && recursive) {
             await scanDir(entryPath);
           } else if (entry.isFile()) {
@@ -62669,7 +62799,7 @@ var batchConcatTool = defineTool({
   async execute(args, ctx) {
     try {
       const filePath = resolve64(ctx.workingDirectory, args.project);
-      const content = await readFile44(filePath, "utf-8");
+      const content = await readFile45(filePath, "utf-8");
       const data = JSON.parse(content);
       const project = Project.fromJSON(data);
       const sourceIds = args.sourceIds ?? [];
@@ -62740,7 +62870,7 @@ var batchApplyEffectTool = defineTool({
   async execute(args, ctx) {
     try {
       const filePath = resolve64(ctx.workingDirectory, args.project);
-      const content = await readFile44(filePath, "utf-8");
+      const content = await readFile45(filePath, "utf-8");
       const data = JSON.parse(content);
       const project = Project.fromJSON(data);
       const clipIds = args.clipIds ?? [];
@@ -62795,7 +62925,7 @@ var timelineClearTool = defineTool({
   async execute(args, ctx) {
     try {
       const filePath = await resolveTimelineFile(args.project, ctx.workingDirectory);
-      const content = await readFile44(filePath, "utf-8");
+      const content = await readFile45(filePath, "utf-8");
       const data = JSON.parse(content);
       const project = Project.fromJSON(data);
       const what = args.what ?? "clips";
@@ -62872,7 +63002,7 @@ var projectSetTool = defineTool({
   async execute(args, ctx) {
     try {
       const filePath = await resolveTimelineFile(args.projectPath, ctx.workingDirectory);
-      const content = await readFile44(filePath, "utf-8");
+      const content = await readFile45(filePath, "utf-8");
       const data = JSON.parse(content);
       const project = Project.fromJSON(data);
       const updates = [];
@@ -63146,8 +63276,8 @@ var mediaCompressTool = defineTool({
         ],
         { maxBuffer: 50 * 1024 * 1024 }
       );
-      const inputBuf = await readFile44(absInput);
-      const outputBuf = await readFile44(outputPath);
+      const inputBuf = await readFile45(absInput);
+      const outputBuf = await readFile45(outputPath);
       const inputSize = inputBuf.length;
       const outputSize = outputBuf.length;
       const reduction = (inputSize - outputSize) / inputSize * 100;