@vibeframe/cli 0.78.0 → 0.79.0

package/dist/index.js

@@ -29771,7 +29771,7 @@ __export(remotion_exports, {
   wrapComponentWithVideo: () => wrapComponentWithVideo
 });
 import { writeFile as writeFile10, mkdir as mkdir6, rm, copyFile as copyFile2 } from "node:fs/promises";
-import { existsSync as existsSync8 } from "node:fs";
+import { existsSync as existsSync9 } from "node:fs";
 import { join as join7 } from "node:path";
 import { tmpdir } from "node:os";
 import { createHash as createHash3 } from "node:crypto";
@@ -29846,7 +29846,7 @@ registerRoot(Root);
   const depsHash = createHash3("md5").update(packageJsonStr).digest("hex").slice(0, 12);
   const cacheMarker = join7(REMOTION_CACHE_DIR, `.deps-${depsHash}`);
   const cachedModules = join7(REMOTION_CACHE_DIR, "node_modules");
-  if (existsSync8(cacheMarker) && existsSync8(cachedModules)) {
+  if (existsSync9(cacheMarker) && existsSync9(cachedModules)) {
     const { symlink } = await import("node:fs/promises");
     try {
       await symlink(cachedModules, join7(dir, "node_modules"), "dir");
@@ -29858,7 +29858,7 @@ registerRoot(Root);
     try {
       await mkdir6(REMOTION_CACHE_DIR, { recursive: true });
       await writeFile10(join7(REMOTION_CACHE_DIR, "package.json"), packageJsonStr);
-      if (existsSync8(join7(dir, "node_modules"))) {
+      if (existsSync9(join7(dir, "node_modules"))) {
         const { rename: rename5, symlink } = await import("node:fs/promises");
         await rename5(join7(dir, "node_modules"), cachedModules).catch(() => {
         });
@@ -30526,7 +30526,7 @@ __export(ai_motion_exports, {
   registerMotionCommand: () => registerMotionCommand
 });
 import { resolve as resolve12 } from "node:path";
-import { existsSync as existsSync9 } from "node:fs";
+import { existsSync as existsSync10 } from "node:fs";
 import { readFile as readFile10, writeFile as writeFile11 } from "node:fs/promises";
 async function executeMotion(options) {
   const modelAlias = options.model || "sonnet";
@@ -30574,7 +30574,7 @@ Use this image analysis to inform the color palette, typography placement, and o
   let result;
   if (options.fromTsx) {
     const tsxPath = resolve12(process.cwd(), options.fromTsx);
-    if (!existsSync9(tsxPath)) {
+    if (!existsSync10(tsxPath)) {
       return { success: false, error: `TSX file not found: ${tsxPath}` };
     }
     const existingCode = await readFile10(tsxPath, "utf-8");
@@ -31778,7 +31778,7 @@ var init_speech = __esm({
 // src/commands/generate/music.ts
 import { resolve as resolve17 } from "node:path";
 import { writeFile as writeFile16 } from "node:fs/promises";
-import { existsSync as existsSync10 } from "node:fs";
+import { existsSync as existsSync11 } from "node:fs";
 async function executeMusic(options) {
   try {
     const provider = options.provider || "elevenlabs";
@@ -31835,7 +31835,7 @@ async function executeMusic(options) {
   }
 }
 function registerMusicCommand(parent) {
-  parent.command("music").description("Generate background music from a text prompt (ElevenLabs or Replicate MusicGen)").argument("<prompt>", "Description of the music to generate").option("-p, --provider <provider>", "Provider: elevenlabs (default, up to 10min), replicate (MusicGen, max 30s)", "elevenlabs").option("-k, --api-key <key>", "API key (or set ELEVENLABS_API_KEY / REPLICATE_API_TOKEN env)").option("-d, --duration <seconds>", "Duration in seconds (elevenlabs: 3-600, replicate: 1-30)", "8").option("--instrumental", "Force instrumental music, no vocals (ElevenLabs only)").option("--melody <file>", "Reference melody audio file for conditioning (Replicate only)").option("--model <model>", "Model variant (Replicate only): large, stereo-large, melody-large, stereo-melody-large", "stereo-large").option("-o, --output <path>", "Output audio file path", "music.mp3").option("--no-wait", "Don't wait for generation to complete (Replicate async mode)").option("--dry-run", "Preview parameters without executing").action(async (prompt3, options) => {
+  parent.command("music").description("Generate background music from a text prompt (ElevenLabs or Replicate MusicGen)").argument("<prompt>", "Description of the music to generate").option("-p, --provider <provider>", "Provider: elevenlabs (default, up to 10min), replicate (MusicGen, max 30s)", "elevenlabs").option("-k, --api-key <key>", "API key (or set ELEVENLABS_API_KEY / REPLICATE_API_TOKEN env)").option("-d, --duration <seconds>", "Duration in seconds (elevenlabs: 3-600, replicate: 1-30)", "8").option("--instrumental", "Force instrumental music, no vocals (ElevenLabs only)").option("--melody <file>", "Reference melody audio file for conditioning (Replicate only)").option("-m, --model <model>", "Model variant (Replicate only): large, stereo-large, melody-large, stereo-melody-large", "stereo-large").option("-o, --output <path>", "Output audio file path", "music.mp3").option("--no-wait", "Don't wait for generation to complete (Replicate async mode)").option("--dry-run", "Preview parameters without executing").action(async (prompt3, options) => {
     const startedAt = Date.now();
     try {
       rejectControlChars(prompt3);
@@ -31913,7 +31913,7 @@ function registerMusicCommand(parent) {
         if (options.melody) {
           spinner2.text = "Uploading melody reference...";
           const absPath = resolve17(process.cwd(), options.melody);
-          if (!existsSync10(absPath)) {
+          if (!existsSync11(absPath)) {
             spinner2.fail(`Melody file not found: ${options.melody}`);
             exitWithError(notFoundError(options.melody));
           }
@@ -32004,7 +32004,7 @@ __export(ai_image_exports, {
 });
 import { resolve as resolve18, dirname as dirname5 } from "node:path";
 import { readFile as readFile12, writeFile as writeFile17, mkdir as mkdir8 } from "node:fs/promises";
-import { existsSync as existsSync11 } from "node:fs";
+import { existsSync as existsSync12 } from "node:fs";
 async function executeImageGenerate(options) {
   const {
     prompt: prompt3,
@@ -32148,7 +32148,7 @@ async function executeGeminiEdit(options) {
     const imageBuffers = [];
     for (const imagePath of imagePaths) {
       const absPath = resolve18(process.cwd(), imagePath);
-      if (!existsSync11(absPath)) {
+      if (!existsSync12(absPath)) {
         return { success: false, error: `Image not found: ${absPath}` };
       }
       const buffer = await readFile12(absPath);
@@ -32196,7 +32196,7 @@ async function executeThumbnailBestFrame(options) {
     model = "flash",
     apiKey
   } = options;
-  if (!existsSync11(videoPath)) {
+  if (!existsSync12(videoPath)) {
     return { success: false, error: `Video not found: ${videoPath}` };
   }
   if (!commandExists("ffmpeg")) {
@@ -32236,7 +32236,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 (!existsSync11(outputPath)) {
+    if (!existsSync12(outputPath)) {
       return { success: false, error: "FFmpeg failed to extract frame" };
     }
     return {
@@ -32262,7 +32262,7 @@ var init_ai_image = __esm({
 
 // src/commands/generate/thumbnail.ts
 import { resolve as resolve19, dirname as dirname6, basename as basename3, extname as extname2 } from "node:path";
-import { existsSync as existsSync12 } from "node:fs";
+import { existsSync as existsSync13 } from "node:fs";
 import { writeFile as writeFile18, mkdir as mkdir9 } 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: flash, latest, pro (default: flash)", "flash").action(async (description, options) => {
@@ -32274,7 +32274,7 @@ function registerThumbnailCommand(parent) {
       }
       if (options.bestFrame) {
         const absVideoPath = resolve19(process.cwd(), options.bestFrame);
-        if (!existsSync12(absVideoPath)) {
+        if (!existsSync13(absVideoPath)) {
           exitWithError(notFoundError(absVideoPath));
         }
         if (!commandExists("ffmpeg")) {
@@ -32975,6 +32975,15 @@ Examples:
       if (options.output) {
         validateOutputPath(options.output);
       }
+      if (options.count !== void 0) {
+        const n = parseInt(options.count, 10);
+        if (!Number.isFinite(n) || n < 1 || n > 10) {
+          exitWithError(usageError(
+            `Invalid --count: ${options.count}`,
+            "Must be an integer between 1 and 10."
+          ));
+        }
+      }
       const imageRegistry = getProvidersFor("image");
       const validProviders = [...imageRegistry.map((p) => p.name), "runway"];
       const providerEnvMap = Object.fromEntries(
@@ -34654,7 +34663,7 @@ var init_video_providers = __esm({
 // src/commands/ai-script-pipeline.ts
 import { readFile as readFile13, writeFile as writeFile23, unlink as unlink2, rename as rename2 } from "node:fs/promises";
 import { resolve as resolve24, extname as extname3 } from "node:path";
-import { existsSync as existsSync13 } from "node:fs";
+import { existsSync as existsSync14 } from "node:fs";
 async function executeRegenerateScene(options) {
   const result = {
     success: false,
@@ -34663,12 +34672,12 @@ async function executeRegenerateScene(options) {
   };
   try {
     const outputDir = resolve24(process.cwd(), options.projectDir);
-    if (!existsSync13(outputDir)) {
+    if (!existsSync14(outputDir)) {
       return { ...result, error: `Project directory not found: ${outputDir}` };
     }
     const yamlPath = resolve24(outputDir, "storyboard.yaml");
     const jsonPath = resolve24(outputDir, "storyboard.json");
-    const storyboardPath = existsSync13(yamlPath) ? yamlPath : existsSync13(jsonPath) ? jsonPath : null;
+    const storyboardPath = existsSync14(yamlPath) ? yamlPath : existsSync14(jsonPath) ? jsonPath : null;
     if (!storyboardPath) {
       return { ...result, error: `Storyboard not found in: ${outputDir} (expected storyboard.yaml or storyboard.json)` };
     }
@@ -34761,14 +34770,14 @@ IMPORTANT - Character appearance must match exactly: ${characterDesc}`;
         const refSceneNum = options.referenceScene;
         if (refSceneNum && refSceneNum >= 1 && refSceneNum <= segments.length && refSceneNum !== sceneNum) {
           const refImagePath = resolve24(outputDir, `scene-${refSceneNum}.png`);
-          if (existsSync13(refImagePath)) {
+          if (existsSync14(refImagePath)) {
             referenceImageBuffer = await readFile13(refImagePath);
           }
         } else if (!refSceneNum) {
           for (let i = 1; i <= segments.length; i++) {
             if (i !== sceneNum) {
               const otherImagePath = resolve24(outputDir, `scene-${i}.png`);
-              if (existsSync13(otherImagePath)) {
+              if (existsSync14(otherImagePath)) {
                 referenceImageBuffer = await readFile13(otherImagePath);
                 break;
               }
@@ -34857,7 +34866,7 @@ Generate the single-person scene image now.`;
       }
       if (regenerateVideo && videoApiKey) {
         options.onProgress?.(`Scene ${sceneNum}: regenerating video (${options.generator || "grok"})...`);
-        if (!existsSync13(imagePath)) {
+        if (!existsSync14(imagePath)) {
           result.failedScenes.push(sceneNum);
           continue;
         }
@@ -35119,6 +35128,15 @@ Examples:
       if (options.output) {
         validateOutputPath(options.output);
       }
+      if (options.duration !== void 0) {
+        const d = parseFloat(options.duration);
+        if (!Number.isFinite(d) || d <= 0 || d > 60) {
+          exitWithError(usageError(
+            `Invalid --duration: ${options.duration}`,
+            "Must be a positive number \u2264 60 seconds."
+          ));
+        }
+      }
       const validProviders = ["runway", "kling", "veo", "grok", "seedance", "fal"];
       const videoEnvMap = {
         grok: "XAI_API_KEY",
@@ -35631,7 +35649,7 @@ Run 'vibe schema generate.<command>' for structured parameter info.
 });
 
 // src/commands/_shared/edit/silence-cut.ts
-import { existsSync as existsSync14 } from "node:fs";
+import { existsSync as existsSync15 } from "node:fs";
 import { readFile as readFile15 } from "node:fs/promises";
 async function detectSilencePeriods(videoPath, noiseThreshold, minDuration) {
   const totalDuration = await getVideoDuration(videoPath);
@@ -35763,7 +35781,7 @@ async function executeSilenceCut(options) {
     analyzeOnly = false,
     useGemini = false
   } = options;
-  if (!existsSync14(videoPath)) {
+  if (!existsSync15(videoPath)) {
     return { success: false, error: `Video not found: ${videoPath}` };
   }
   if (!commandExists("ffmpeg")) {
@@ -35871,7 +35889,7 @@ var init_silence_cut = __esm({
 });
 
 // src/commands/_shared/edit/jump-cut.ts
-import { existsSync as existsSync15 } from "node:fs";
+import { existsSync as existsSync16 } from "node:fs";
 import { readFile as readFile16, writeFile as writeFile25, mkdir as mkdir11 } from "node:fs/promises";
 import { join as join8 } from "node:path";
 async function transcribeWithWords(audioPath, apiKey, language) {
@@ -35934,7 +35952,7 @@ async function executeJumpCut(options) {
     analyzeOnly = false,
     apiKey
   } = options;
-  if (!existsSync15(videoPath)) {
+  if (!existsSync16(videoPath)) {
     return { success: false, error: `Video not found: ${videoPath}` };
   }
   if (!commandExists("ffmpeg")) {
@@ -36220,7 +36238,7 @@ var init_helpers = __esm({
 });
 
 // src/commands/_shared/edit/caption.ts
-import { existsSync as existsSync16 } from "node:fs";
+import { existsSync as existsSync17 } from "node:fs";
 import { readFile as readFile17, writeFile as writeFile26, mkdir as mkdir12 } from "node:fs/promises";
 import { dirname as dirname8, basename as basename5, extname as extname4, join as join9 } from "node:path";
 function getCaptionForceStyle(style, fontSize, fontColor, position) {
@@ -36250,7 +36268,7 @@ async function executeCaption(options) {
     position = "bottom",
     apiKey
   } = options;
-  if (!existsSync16(videoPath)) {
+  if (!existsSync17(videoPath)) {
     return { success: false, error: `Video not found: ${videoPath}` };
   }
   if (!commandExists("ffmpeg")) {
@@ -36428,10 +36446,10 @@ var init_caption = __esm({
 });
 
 // src/commands/_shared/edit/noise-reduce.ts
-import { existsSync as existsSync17 } from "node:fs";
+import { existsSync as existsSync18 } from "node:fs";
 async function executeNoiseReduce(options) {
   const { inputPath, outputPath, strength = "medium", noiseFloor } = options;
-  if (!existsSync17(inputPath)) {
+  if (!existsSync18(inputPath)) {
     return { success: false, error: `File not found: ${inputPath}` };
   }
   if (!commandExists("ffmpeg")) {
@@ -36488,7 +36506,7 @@ var init_noise_reduce = __esm({
 });
 
 // src/commands/_shared/edit/fade.ts
-import { existsSync as existsSync18 } from "node:fs";
+import { existsSync as existsSync19 } from "node:fs";
 async function executeFade(options) {
   const {
     videoPath,
@@ -36498,7 +36516,7 @@ async function executeFade(options) {
     audioOnly = false,
     videoOnly = false
   } = options;
-  if (!existsSync18(videoPath)) {
+  if (!existsSync19(videoPath)) {
     return { success: false, error: `Video not found: ${videoPath}` };
   }
   if (!commandExists("ffmpeg")) {
@@ -36565,7 +36583,7 @@ var init_fade = __esm({
 });
 
 // src/commands/_shared/edit/translate-srt.ts
-import { existsSync as existsSync19 } from "node:fs";
+import { existsSync as existsSync20 } from "node:fs";
 import { readFile as readFile18, writeFile as writeFile27 } from "node:fs/promises";
 async function executeTranslateSrt(options) {
   const {
@@ -36576,7 +36594,7 @@ async function executeTranslateSrt(options) {
     sourceLanguage,
     apiKey
   } = options;
-  if (!existsSync19(srtPath)) {
+  if (!existsSync20(srtPath)) {
     return { success: false, error: `SRT file not found: ${srtPath}` };
   }
   try {
@@ -36693,7 +36711,7 @@ var init_translate_srt = __esm({
 });
 
 // src/commands/_shared/edit/text-overlay.ts
-import { existsSync as existsSync20 } from "node:fs";
+import { existsSync as existsSync21 } from "node:fs";
 import { resolve as resolve26 } from "node:path";
 function detectSystemFont() {
   const platform = process.platform;
@@ -36704,7 +36722,7 @@ function detectSystemFont() {
       "/Library/Fonts/Arial.ttf"
     ];
     for (const f of candidates) {
-      if (existsSync20(f)) return f;
+      if (existsSync21(f)) return f;
     }
   } else if (platform === "linux") {
     const candidates = [
@@ -36713,7 +36731,7 @@ function detectSystemFont() {
       "/usr/share/fonts/TTF/DejaVuSans-Bold.ttf"
     ];
     for (const f of candidates) {
-      if (existsSync20(f)) return f;
+      if (existsSync21(f)) return f;
     }
   } else if (platform === "win32") {
     const candidates = [
@@ -36721,7 +36739,7 @@ function detectSystemFont() {
       "C:\\Windows\\Fonts\\segoeui.ttf"
     ];
     for (const f of candidates) {
-      if (existsSync20(f)) return f;
+      if (existsSync21(f)) return f;
     }
   }
   return null;
@@ -36742,7 +36760,7 @@ async function applyTextOverlays(options) {
   }
   const absVideoPath = resolve26(process.cwd(), videoPath);
   const absOutputPath = resolve26(process.cwd(), outputPath);
-  if (!existsSync20(absVideoPath)) {
+  if (!existsSync21(absVideoPath)) {
     return { success: false, error: `Video not found: ${absVideoPath}` };
   }
   if (!commandExists("ffmpeg")) {
@@ -36923,12 +36941,12 @@ var init_ai_edit = __esm({
 
 // src/commands/ai-edit-cli.ts
 import { resolve as resolve27, extname as extname5, basename as basename6 } from "node:path";
-import { existsSync as existsSync21 } from "node:fs";
+import { existsSync as existsSync22 } 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", "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:
   $ vibe edit silence-cut interview.mp4 -o clean.mp4
-  $ vibe ed sc podcast.mp4 -o trimmed.mp4 -n -25 -d 1.0
+  $ vibe ed sc podcast.mp4 -o trimmed.mp4 --noise -25 --min-duration 1.0
   $ vibe ed sc video.mp4 --use-gemini -o smart-cut.mp4    # AI-powered detection
   $ vibe ed sc video.mp4 --analyze-only                    # Detect only, no cut
   $ vibe ed sc video.mp4 --dry-run --json
@@ -36940,7 +36958,7 @@ No API key needed (FFmpeg only). Use --use-gemini for smart detection (requires
         validateOutputPath(options.output);
       }
       const absVideoPath = resolve27(process.cwd(), videoPath);
-      if (!existsSync21(absVideoPath)) {
+      if (!existsSync22(absVideoPath)) {
         exitWithError(notFoundError(absVideoPath));
       }
       if (!commandExists("ffmpeg")) {
@@ -37029,9 +37047,9 @@ No API key needed (FFmpeg only). Use --use-gemini for smart detection (requires
   aiCommand.command("caption").alias("cap").description("Transcribe and burn styled captions onto video (Whisper + FFmpeg)").argument("<video>", "Video file path").option("-o, --output <path>", "Output file path (default: <name>-captioned.<ext>)").option("--style <style>", "Caption style: minimal, bold, outline, karaoke (default: bold)", "bold").option("--font-size <pixels>", "Override auto-calculated font size").option("--color <color>", "Font color (default: white)", "white").option("-l, --language <lang>", "Language code for transcription (e.g., en, ko)").option("--position <pos>", "Caption position: top, center, bottom (default: bottom)", "bottom").option("-k, --api-key <key>", "OpenAI API key (or set OPENAI_API_KEY env)").option("--dry-run", "Preview parameters without executing").addHelpText("after", `
 Examples:
   $ vibe edit caption video.mp4 -o captioned.mp4
-  $ vibe ed cap video.mp4 -o out.mp4 -s bold --position top
+  $ vibe ed cap video.mp4 -o out.mp4 --style bold --position top
   $ vibe ed cap video.mp4 -o out.mp4 -l ko              # Korean transcription
-  $ vibe ed cap video.mp4 -o out.mp4 -s karaoke          # Karaoke-style
+  $ vibe ed cap video.mp4 -o out.mp4 --style karaoke     # Karaoke-style
   $ vibe ed cap video.mp4 --dry-run --json
 
 Requires: OPENAI_API_KEY (Whisper transcription) + FFmpeg`).action(async (videoPath, options) => {
@@ -37041,7 +37059,7 @@ Requires: OPENAI_API_KEY (Whisper transcription) + FFmpeg`).action(async (videoP
         validateOutputPath(options.output);
       }
       const absVideoPath = resolve27(process.cwd(), videoPath);
-      if (!existsSync21(absVideoPath)) {
+      if (!existsSync22(absVideoPath)) {
         exitWithError(notFoundError(absVideoPath));
       }
       if (!commandExists("ffmpeg")) {
@@ -37122,7 +37140,7 @@ Requires: OPENAI_API_KEY (Whisper transcription) + FFmpeg`).action(async (videoP
         validateOutputPath(options.output);
       }
       const absInputPath = resolve27(process.cwd(), inputPath);
-      if (!existsSync21(absInputPath)) {
+      if (!existsSync22(absInputPath)) {
         exitWithError(notFoundError(absInputPath));
       }
       if (!commandExists("ffmpeg")) {
@@ -37188,7 +37206,7 @@ Requires: OPENAI_API_KEY (Whisper transcription) + FFmpeg`).action(async (videoP
         validateOutputPath(options.output);
       }
       const absVideoPath = resolve27(process.cwd(), videoPath);
-      if (!existsSync21(absVideoPath)) {
+      if (!existsSync22(absVideoPath)) {
         exitWithError(notFoundError(absVideoPath));
       }
       if (!commandExists("ffmpeg")) {
@@ -37263,7 +37281,7 @@ Requires: OPENAI_API_KEY (Whisper transcription) + FFmpeg`).action(async (videoP
         exitWithError(usageError("Target language required. Use -t or --target"));
       }
       const absSrtPath = resolve27(process.cwd(), srtPath);
-      if (!existsSync21(absSrtPath)) {
+      if (!existsSync22(absSrtPath)) {
         exitWithError(notFoundError(absSrtPath));
       }
       if (options.dryRun) {
@@ -37339,7 +37357,7 @@ Requires: OPENAI_API_KEY (Whisper transcription) + FFmpeg`).action(async (videoP
       }
       if (options.fillers) rejectControlChars(options.fillers);
       const absVideoPath = resolve27(process.cwd(), videoPath);
-      if (!existsSync21(absVideoPath)) {
+      if (!existsSync22(absVideoPath)) {
         exitWithError(notFoundError(absVideoPath));
       }
       if (!commandExists("ffmpeg")) {
@@ -37439,7 +37457,7 @@ var init_ai_edit_cli = __esm({
 });
 
 // src/commands/_shared/execute-fill-gaps.ts
-import { existsSync as existsSync22 } from "node:fs";
+import { existsSync as existsSync23 } from "node:fs";
 import { readFile as readFile19, writeFile as writeFile28, mkdir as mkdir13, rename as renameFs } from "node:fs/promises";
 import { resolve as resolve28, dirname as dirname9 } from "node:path";
 function detectVideoGaps(videoClips, totalDuration) {
@@ -37522,7 +37540,7 @@ async function executeFillGaps(options) {
   try {
     onProgress("Loading project...");
     const filePath = resolve28(process.cwd(), options.projectPath);
-    if (!existsSync22(filePath)) {
+    if (!existsSync23(filePath)) {
       return {
         success: false,
         error: `Project file not found: ${filePath}`,
@@ -37657,7 +37675,7 @@ async function executeFillGaps(options) {
     }
     const projectDir = dirname9(filePath);
     const footageDir = options.dir ? resolve28(process.cwd(), options.dir) : resolve28(projectDir, "footage");
-    if (!existsSync22(footageDir)) {
+    if (!existsSync23(footageDir)) {
       await mkdir13(footageDir, { recursive: true });
     }
     humanLines.push("Generating AI Videos");
@@ -38178,12 +38196,12 @@ var init_edit_cmd = __esm({
       `
 Examples:
   $ vibe edit silence-cut interview.mp4 -o clean.mp4
-  $ vibe edit caption video.mp4 -o captioned.mp4 -s bold
+  $ vibe edit caption video.mp4 -o captioned.mp4 --style bold
   $ vibe edit grade video.mp4 -o graded.mp4 --preset cinematic-warm
   $ vibe edit reframe landscape.mp4 -o vertical.mp4 -a 9:16
   $ vibe edit image photo.png "add sunset background" -o edited.png
-  $ vibe edit text-overlay video.mp4 -t "Title" -s center-bold -o out.mp4
-  $ vibe edit noise-reduce noisy.mp4 -o clean.mp4 -s high
+  $ vibe edit text-overlay video.mp4 --text "Title" --style center-bold -o out.mp4
+  $ vibe edit noise-reduce noisy.mp4 -o clean.mp4 --strength high
   $ vibe edit fade video.mp4 -o faded.mp4 --fade-in 1 --fade-out 1
 
 API Keys (varies by subcommand):
@@ -38930,7 +38948,7 @@ __export(ai_analyze_exports, {
 });
 import { readFile as readFile21 } from "node:fs/promises";
 import { extname as extname6, resolve as resolve30 } from "node:path";
-import { existsSync as existsSync23 } from "node:fs";
+import { existsSync as existsSync24 } from "node:fs";
 async function executeGeminiVideo(options) {
   try {
     const apiKey = await getApiKey("GOOGLE_API_KEY", "Google");
@@ -38949,7 +38967,7 @@ async function executeGeminiVideo(options) {
       videoData = options.source;
     } else {
       const absPath = resolve30(process.cwd(), options.source);
-      if (!existsSync23(absPath)) {
+      if (!existsSync24(absPath)) {
         return { success: false, error: `File not found: ${absPath}` };
       }
       videoData = await readFile21(absPath);
@@ -39022,7 +39040,7 @@ async function executeAnalyze(options) {
         imageBuffer = Buffer.from(await response.arrayBuffer());
       } else {
         const absPath = resolve30(process.cwd(), source);
-        if (!existsSync23(absPath)) {
+        if (!existsSync24(absPath)) {
           return { success: false, error: `File not found: ${absPath}` };
         }
         imageBuffer = await readFile21(absPath);
@@ -39057,7 +39075,7 @@ async function executeAnalyze(options) {
       videoData = Buffer.from(await response.arrayBuffer());
     } else {
       const absPath = resolve30(process.cwd(), source);
-      if (!existsSync23(absPath)) {
+      if (!existsSync24(absPath)) {
         return { success: false, error: `File not found: ${absPath}` };
       }
       videoData = await readFile21(absPath);
@@ -39196,7 +39214,7 @@ __export(ai_review_exports, {
 });
 import { readFile as readFile22, rename as rename3 } from "node:fs/promises";
 import { resolve as resolve31 } from "node:path";
-import { existsSync as existsSync24 } from "node:fs";
+import { existsSync as existsSync25 } from "node:fs";
 function parseReviewFeedback(response) {
   let cleaned = response.trim();
   if (cleaned.startsWith("```json")) {
@@ -39221,7 +39239,7 @@ function parseReviewFeedback(response) {
 async function executeReview(options) {
   const { videoPath, storyboardPath, autoApply = false, verify = false, model = "flash" } = options;
   const absVideoPath = resolve31(process.cwd(), videoPath);
-  if (!existsSync24(absVideoPath)) {
+  if (!existsSync25(absVideoPath)) {
     return { success: false, error: `Video not found: ${absVideoPath}` };
   }
   const apiKey = process.env.GOOGLE_API_KEY || await getApiKey("GOOGLE_API_KEY", "Google");
@@ -39231,7 +39249,7 @@ async function executeReview(options) {
   let storyboardContext = "";
   if (storyboardPath) {
     const absStoryboardPath = resolve31(process.cwd(), storyboardPath);
-    if (existsSync24(absStoryboardPath)) {
+    if (existsSync25(absStoryboardPath)) {
       const content = await readFile22(absStoryboardPath, "utf-8");
       storyboardContext = `
 
@@ -39437,7 +39455,7 @@ var init_ai_review = __esm({
 // src/commands/ai-highlights.ts
 import { readFile as readFile26, writeFile as writeFile33, mkdir as mkdir15 } from "node:fs/promises";
 import { resolve as resolve35, dirname as dirname12, basename as basename8, extname as extname8 } from "node:path";
-import { existsSync as existsSync27 } from "node:fs";
+import { existsSync as existsSync28 } from "node:fs";
 function filterHighlights(highlights, options) {
   let filtered = highlights.filter((h) => h.confidence >= options.threshold);
   filtered.sort((a, b) => b.confidence - a.confidence);
@@ -39477,7 +39495,7 @@ function truncate(text, maxLength) {
 async function executeHighlights(options) {
   try {
     const absPath = resolve35(process.cwd(), options.media);
-    if (!existsSync27(absPath)) {
+    if (!existsSync28(absPath)) {
       return { success: false, highlights: [], totalDuration: 0, totalHighlightDuration: 0, error: `File not found: ${absPath}` };
     }
     const ext = extname8(absPath).toLowerCase();
@@ -39593,7 +39611,7 @@ Analyze both what is SHOWN (visual cues, actions, expressions) and what is SAID
       const audioBuffer = await readFile26(audioPath);
       const audioBlob = new Blob([audioBuffer]);
       const transcriptResult = await whisper.transcribe(audioBlob, options.language);
-      if (tempAudioPath && existsSync27(tempAudioPath)) {
+      if (tempAudioPath && existsSync28(tempAudioPath)) {
         const { unlink: unlinkFile } = await import("node:fs/promises");
         await unlinkFile(tempAudioPath).catch(() => {
         });
@@ -39680,7 +39698,7 @@ async function executeAutoShorts(options) {
       return { success: false, shorts: [], error: "FFmpeg not found" };
     }
     const absPath = resolve35(process.cwd(), options.video);
-    if (!existsSync27(absPath)) {
+    if (!existsSync28(absPath)) {
       return { success: false, shorts: [], error: `File not found: ${absPath}` };
     }
     const targetDuration = options.duration ?? 60;
@@ -39808,7 +39826,7 @@ Analyze both VISUALS (expressions, actions, scene changes) and AUDIO (speech, re
       };
     }
     const outputDir = options.outputDir ? resolve35(process.cwd(), options.outputDir) : dirname12(absPath);
-    if (options.outputDir && !existsSync27(outputDir)) {
+    if (options.outputDir && !existsSync28(outputDir)) {
       await mkdir15(outputDir, { recursive: true });
     }
     const result = {
@@ -39891,7 +39909,7 @@ function registerHighlightsCommands(aiCommand) {
         validateOutputPath(options.output);
       }
       const absPath = resolve35(process.cwd(), mediaPath);
-      if (!existsSync27(absPath)) {
+      if (!existsSync28(absPath)) {
         exitWithError(notFoundError(absPath));
       }
       if (options.dryRun) {
@@ -40078,7 +40096,7 @@ Analyze both what is SHOWN (visual cues, actions, expressions) and what is SAID
         const transcriptResult = await whisper.transcribe(audioBlob, options.language);
         if (transcriptResult.status === "failed" || !transcriptResult.segments) {
           transcribeSpinner.fail("Transcription failed");
-          if (tempAudioPath && existsSync27(tempAudioPath)) {
+          if (tempAudioPath && existsSync28(tempAudioPath)) {
             const { unlink: unlinkFile } = await import("node:fs/promises");
             await unlinkFile(tempAudioPath).catch(() => {
             });
@@ -40086,7 +40104,7 @@ Analyze both what is SHOWN (visual cues, actions, expressions) and what is SAID
           exitWithError(apiError(`Transcription failed: ${transcriptResult.error}`, true));
         }
         transcribeSpinner.succeed(source_default.green(`Transcribed ${transcriptResult.segments.length} segments`));
-        if (tempAudioPath && existsSync27(tempAudioPath)) {
+        if (tempAudioPath && existsSync28(tempAudioPath)) {
           const { unlink: unlinkFile } = await import("node:fs/promises");
           await unlinkFile(tempAudioPath).catch(() => {
           });
@@ -40192,7 +40210,7 @@ Analyze both what is SHOWN (visual cues, actions, expressions) and what is SAID
         validateOutputPath(options.output);
       }
       const absPath = resolve35(process.cwd(), videoPath);
-      if (!existsSync27(absPath)) {
+      if (!existsSync28(absPath)) {
         exitWithError(notFoundError(absPath));
       }
       if (options.dryRun) {
@@ -40385,7 +40403,7 @@ Analyze both VISUALS (expressions, actions, scene changes) and AUDIO (speech, re
         return;
       }
       const outputDir = options.outputDir ? resolve35(process.cwd(), options.outputDir) : dirname12(absPath);
-      if (options.outputDir && !existsSync27(outputDir)) {
+      if (options.outputDir && !existsSync28(outputDir)) {
         await mkdir15(outputDir, { recursive: true });
       }
       for (let i = 0; i < selectedHighlights.length; i++) {
@@ -40402,7 +40420,7 @@ Analyze both VISUALS (expressions, actions, scene changes) and AUDIO (speech, re
           outputPath = resolve35(outputDir, `${baseName}-short-${i + 1}.mp4`);
         }
         const parentDir = dirname12(outputPath);
-        if (!existsSync27(parentDir)) {
+        if (!existsSync28(parentDir)) {
           await mkdir15(parentDir, { recursive: true });
         }
         const { stdout: probeOut } = await execSafe("ffprobe", [
@@ -40477,7 +40495,7 @@ var init_ai_highlights = __esm({
 // src/commands/ai-animated-caption.ts
 import { resolve as resolve36, dirname as dirname13, basename as basename9 } from "node:path";
 import { writeFile as writeFile34, mkdir as mkdir16, rm as rm2 } from "node:fs/promises";
-import { existsSync as existsSync28 } from "node:fs";
+import { existsSync as existsSync29 } from "node:fs";
 import { tmpdir as tmpdir2 } from "node:os";
 function groupWords(words, options = {}) {
   if (words.length === 0) return [];
@@ -40654,7 +40672,7 @@ async function executeAnimatedCaption(options) {
     const groups = groupWords(transcript.words, { wordsPerGroup, maxChars });
     const absOutputPath = resolve36(process.cwd(), outputPath);
     const outDir = dirname13(absOutputPath);
-    if (!existsSync28(outDir)) {
+    if (!existsSync29(outDir)) {
       await mkdir16(outDir, { recursive: true });
     }
     if (tier === "ass") {
@@ -50603,7 +50621,7 @@ var init_detect = __esm({
 });
 
 // src/pipeline/renderers/chrome.ts
-import { existsSync as existsSync31 } from "node:fs";
+import { existsSync as existsSync32 } from "node:fs";
 import { homedir as homedir5 } from "node:os";
 import { join as join11 } from "node:path";
 function findChrome() {
@@ -50629,7 +50647,7 @@ function findChrome() {
     "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe"
   ];
   for (const c of candidates) {
-    if (c && existsSync31(c)) return c;
+    if (c && existsSync32(c)) return c;
   }
   return void 0;
 }
@@ -50884,7 +50902,7 @@ __export(scene_render_exports, {
   qualityToCrf: () => qualityToCrf
 });
 import { mkdir as mkdir18, readFile as readFile32, stat as stat4 } from "node:fs/promises";
-import { existsSync as existsSync32 } from "node:fs";
+import { existsSync as existsSync33 } from "node:fs";
 import { resolve as resolve45, relative as relative6, dirname as dirname16, basename as basename16 } from "node:path";
 import {
   createRenderJob,
@@ -50902,7 +50920,7 @@ function defaultOutputPath(opts) {
 }
 async function readProjectName(projectDir) {
   const cfgPath = resolve45(projectDir, "vibe.project.yaml");
-  if (!existsSync32(cfgPath)) return void 0;
+  if (!existsSync33(cfgPath)) return void 0;
   try {
     const raw = await (await import("node:fs/promises")).readFile(cfgPath, "utf-8");
     const parsed = (0, import_yaml7.parse)(raw);
@@ -51032,7 +51050,7 @@ __export(scene_build_exports, {
   executeSceneBuild: () => executeSceneBuild,
   resolveSceneBuildMode: () => resolveSceneBuildMode
 });
-import { existsSync as existsSync33 } from "node:fs";
+import { existsSync as existsSync34 } from "node:fs";
 import { mkdir as mkdir19, readFile as readFile33, writeFile as writeFile38 } from "node:fs/promises";
 import { dirname as dirname17, join as join12, resolve as resolve46 } from "node:path";
 async function executeSceneBuild(opts) {
@@ -51042,7 +51060,7 @@ async function executeSceneBuild(opts) {
   });
   const mode = resolveSceneBuildMode(opts);
   const storyboardPath = join12(projectDir, "STORYBOARD.md");
-  if (!existsSync33(storyboardPath)) {
+  if (!existsSync34(storyboardPath)) {
     return failBeforePrimitives(
       `STORYBOARD.md not found at ${storyboardPath}. Run \`vibe scene init <dir>\` to create a starter, or add STORYBOARD.md with per-beat cues.`,
       startedAt
@@ -51078,7 +51096,7 @@ async function executeSceneBuild(opts) {
   if (mode === "agent") {
     const compositionsDir = join12(projectDir, "compositions");
     const missingBeats = parsed.beats.filter(
-      (b) => !existsSync33(join12(compositionsDir, `scene-${b.id}.html`))
+      (b) => !existsSync34(join12(compositionsDir, `scene-${b.id}.html`))
     );
     if (missingBeats.length > 0) {
       const plan = await getComposePrompts({ projectDir });
@@ -51126,7 +51144,7 @@ async function executeSceneBuild(opts) {
     }
     composeData = composeResult.data;
   }
-  if (!existsSync33(join12(projectDir, "index.html"))) {
+  if (!existsSync34(join12(projectDir, "index.html"))) {
     await scaffoldSceneProject({
       dir: projectDir,
       name: projectDir.split(/[\\/]/).filter(Boolean).pop(),
@@ -51186,7 +51204,7 @@ async function dispatchNarration(beat, ctx) {
   if (!text) return { status: "no-cue" };
   for (const ext of ["mp3", "wav"]) {
     const rel2 = `assets/narration-${beat.id}.${ext}`;
-    if (existsSync33(join12(ctx.projectDir, rel2)) && !ctx.force) {
+    if (existsSync34(join12(ctx.projectDir, rel2)) && !ctx.force) {
       ctx.onProgress({ type: "narration-cached", beatId: beat.id, path: rel2 });
       return { status: "cached", path: rel2 };
     }
@@ -51227,7 +51245,7 @@ async function dispatchBackdrop(beat, ctx) {
   }
   const rel = `assets/backdrop-${beat.id}.png`;
   const abs = join12(ctx.projectDir, rel);
-  if (existsSync33(abs) && !ctx.force) {
+  if (existsSync34(abs) && !ctx.force) {
     ctx.onProgress({ type: "backdrop-cached", beatId: beat.id, path: rel });
     return { status: "cached", path: rel };
   }
@@ -51265,7 +51283,7 @@ function loadSceneBuildEnv(projectDir) {
   (0, import_dotenv3.config)({ path: resolve46(process.cwd(), ".env"), quiet: true });
   let dir = process.cwd();
   while (dir !== dirname17(dir)) {
-    if (existsSync33(join12(dir, "pnpm-workspace.yaml"))) {
+    if (existsSync34(join12(dir, "pnpm-workspace.yaml"))) {
       (0, import_dotenv3.config)({ path: join12(dir, ".env"), quiet: true });
       return;
     }
@@ -51296,7 +51314,7 @@ function resolveSceneBuildMode(opts) {
 }
 async function syncRootClipReferences(beats, projectDir, outcomes) {
   const rootPath = join12(projectDir, "index.html");
-  if (!existsSync33(rootPath)) return;
+  if (!existsSync34(rootPath)) return;
   const html = await readFile33(rootPath, "utf-8");
   let cursor = 0;
   const clipLines = [];
@@ -51747,14 +51765,14 @@ __export(ai_audio_exports, {
 });
 import { resolve as resolve53, dirname as dirname19, basename as basename17, extname as extname12 } from "node:path";
 import { readFile as readFile36, writeFile as writeFile40 } from "node:fs/promises";
-import { existsSync as existsSync36 } from "node:fs";
+import { existsSync as existsSync37 } 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 = resolve53(process.cwd(), audioPath);
-    if (!existsSync36(absPath)) return { success: false, error: `File not found: ${absPath}` };
+    if (!existsSync37(absPath)) return { success: false, error: `File not found: ${absPath}` };
     const whisper = new WhisperProvider();
     await whisper.initialize({ apiKey: key });
     const audioBuffer = await readFile36(absPath);
@@ -51787,7 +51805,7 @@ async function executeIsolate(options) {
     const key = apiKey || process.env.ELEVENLABS_API_KEY;
     if (!key) return { success: false, error: "ELEVENLABS_API_KEY required" };
     const absPath = resolve53(process.cwd(), audioPath);
-    if (!existsSync36(absPath)) return { success: false, error: `File not found: ${absPath}` };
+    if (!existsSync37(absPath)) return { success: false, error: `File not found: ${absPath}` };
     const audioBuffer = await readFile36(absPath);
     const elevenlabs = new ElevenLabsProvider();
     await elevenlabs.initialize({ apiKey: key });
@@ -51813,7 +51831,7 @@ async function executeVoiceClone(options) {
     const audioBuffers = [];
     for (const samplePath of samplePaths) {
       const absPath = resolve53(process.cwd(), samplePath);
-      if (!existsSync36(absPath)) return { success: false, error: `File not found: ${samplePath}` };
+      if (!existsSync37(absPath)) return { success: false, error: `File not found: ${samplePath}` };
       const buffer = await readFile36(absPath);
       audioBuffers.push(buffer);
     }
@@ -51835,7 +51853,7 @@ async function executeDub(options) {
   const { mediaPath, language, source, voice, analyzeOnly, output } = options;
   try {
     const absPath = resolve53(process.cwd(), mediaPath);
-    if (!existsSync36(absPath)) return { success: false, error: `File not found: ${absPath}` };
+    if (!existsSync37(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;
@@ -51963,8 +51981,8 @@ async function executeDuck(options) {
     if (!commandExists("ffmpeg")) return { success: false, error: "FFmpeg not found" };
     const absMusicPath = resolve53(process.cwd(), musicPath);
     const absVoicePath = resolve53(process.cwd(), voicePath);
-    if (!existsSync36(absMusicPath)) return { success: false, error: `Music file not found: ${absMusicPath}` };
-    if (!existsSync36(absVoicePath)) return { success: false, error: `Voice file not found: ${absVoicePath}` };
+    if (!existsSync37(absMusicPath)) return { success: false, error: `Music file not found: ${absMusicPath}` };
+    if (!existsSync37(absVoicePath)) return { success: false, error: `Voice file not found: ${absVoicePath}` };
     const defaultOutput = resolve53(dirname19(absMusicPath), `${basename17(absMusicPath, extname12(absMusicPath))}-ducked${extname12(absMusicPath)}`);
     const outputPath = resolve53(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`;
@@ -51978,7 +51996,7 @@ async function executeDuck(options) {
       "-y",
       outputPath
     ], { timeout: 12e4, maxBuffer: 50 * 1024 * 1024 });
-    if (!existsSync36(outputPath)) return { success: false, error: "FFmpeg failed to create output" };
+    if (!existsSync37(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)}` };
@@ -51996,7 +52014,7 @@ var init_ai_audio = __esm({
 // src/pipeline/executor.ts
 import { resolve as resolve54 } from "node:path";
 import { readFile as readFile37, writeFile as writeFile41, mkdir as mkdir21 } from "node:fs/promises";
-import { existsSync as existsSync37 } from "node:fs";
+import { existsSync as existsSync38 } from "node:fs";
 function maxCostFor(action) {
   const cmd = ACTION_METADATA[action]?.command;
   if (!cmd) return 0;
@@ -52213,7 +52231,7 @@ async function ensureActionsRegistered() {
 }
 async function loadPipeline(filePath) {
   const absPath = resolve54(process.cwd(), filePath);
-  if (!existsSync37(absPath)) {
+  if (!existsSync38(absPath)) {
     throw new Error(`Pipeline file not found: ${absPath}`);
   }
   const content = await readFile37(absPath, "utf-8");
@@ -52238,7 +52256,7 @@ async function executePipeline(manifest2, options = {}) {
   const startTime = Date.now();
   if (options.resume) {
     const checkpointPath = resolve54(outputDir, CHECKPOINT_FILE);
-    if (existsSync37(checkpointPath)) {
+    if (existsSync38(checkpointPath)) {
       const checkpointContent = await readFile37(checkpointPath, "utf-8");
       const checkpoint = (0, import_yaml8.parse)(checkpointContent);
       for (const cs of checkpoint.completedSteps) {
@@ -59644,7 +59662,7 @@ __export(project_builder_exports, {
   resolveSourceUrl: () => resolveSourceUrl
 });
 import { mkdtemp, mkdir as mkdir22, copyFile as copyFile3, writeFile as writeFile46, rm as rm4, readdir as readdir3 } from "node:fs/promises";
-import { existsSync as existsSync38 } from "node:fs";
+import { existsSync as existsSync39 } from "node:fs";
 import { tmpdir as tmpdir4 } from "node:os";
 import { createRequire } from "node:module";
 import * as path from "node:path";
@@ -59656,7 +59674,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 (!existsSync38(resolved)) {
+    if (!existsSync39(resolved)) {
       throw new Error(`Source file not found: ${resolved} (from source id=${source.id})`);
     }
     const dest = path.join(assetsDir, path.basename(resolved));
@@ -60494,11 +60512,11 @@ var init_export = __esm({
     ).option("--overwrite", "Overwrite output file if exists", false).option("--gap-fill <strategy>", "Gap filling strategy (black, extend)", "extend").option("--backend <name>", "Render backend: ffmpeg (default) | hyperframes (experimental)", "ffmpeg").option("--bitrate <value>", "Video bitrate (e.g. 5000k, 8M) \u2014 overrides preset").option("--fps <number>", "Frames per second (e.g. 24, 30, 60) \u2014 overrides preset").option("--resolution <WxH>", "Output resolution (e.g. 1920x1080) \u2014 overrides preset").option("--codec <codec>", "Video codec: h264 (default) | h265 | vp9 \u2014 overrides preset").option("--dry-run", "Preview parameters without executing").addHelpText("after", `
 Examples:
   $ vibe export project.vibe.json -o output.mp4
-  $ vibe export project.vibe.json -o output.mp4 -p high -y
-  $ vibe export project.vibe.json -o output.webm -f webm
-  $ vibe export project.vibe.json -o output.gif -f gif
+  $ vibe export project.vibe.json -o output.mp4 --preset high --overwrite
+  $ vibe export project.vibe.json -o output.webm --format webm
+  $ vibe export project.vibe.json -o output.gif --format gif
   $ vibe export project.vibe.json -o out.mp4 --bitrate 5000k --fps 24 --codec h265
-  $ vibe export project.vibe.json -o out.mp4 -p high --fps 60
+  $ vibe export project.vibe.json -o out.mp4 --preset high --fps 60
 
 Cost: Free (no API keys needed). Requires FFmpeg.
 GIF format: 15fps, no audio, looping. Good for previews and sharing.
@@ -61634,28 +61652,31 @@ narration / backdrop intent.
 ## Quick-draft path
 
 \`\`\`bash
-vibe scene init my-promo -r 16:9 -d 30
+vibe init my-promo -r 16:9 -d 30
 vibe scene add intro --style announcement \\
     --headline "Ship videos, not clicks"
 vibe scene lint
 vibe render my-promo
 \`\`\`
 
-\`vibe scene init\` is **idempotent** \u2014 running it on an existing
-Hyperframes directory merges \`hyperframes.json\` instead of clobbering it.
-Safe to invoke on user-provided projects.
+\`vibe init\` is **idempotent** \u2014 running it on an existing Hyperframes
+directory merges \`hyperframes.json\` instead of clobbering it. Safe to
+invoke on user-provided projects.
 
 ## Subcommands
 
 \`\`\`bash
-vibe scene init <dir> [-r 16:9|9:16|1:1|4:5] [-d <sec>] [--visual-style "<name>"]
+# Project flow (top-level \u2014 preferred entry points)
+vibe init <dir> [-r 16:9|9:16|1:1|4:5] [-d <sec>] [--visual-style "<name>"]
+vibe build [<dir>] [--mode agent|batch|auto]         # H3 dispatch
+vibe render [<dir>] [--fps 30] [--quality standard] [--format mp4]
+
+# Lower-level scene authoring
 vibe scene list-styles [<name>]                   # list / show vendored visual identities
 vibe scene install-skill [<dir>] [--host all]  # retroactive composition-rules install
 vibe scene add <name> --style <preset> [...]
 vibe scene compose-prompts [<dir>] [--beat <id>]   # H2: emit plan, no LLM call
 vibe scene lint [<root>] [--json] [--fix]
-vibe scene render [<root>] [--fps 30] [--quality standard] [--format mp4]
-vibe build [<dir>] [--mode agent|batch|auto]         # H3 dispatch
 \`\`\`
 
 ## Style presets (for \`vibe scene add --style\`)
@@ -61709,7 +61730,7 @@ and surface the error to the user.
 | Generate narration + image, then author scene | \`vibe scene add\` |
 | Generate a full scenes project from a STORYBOARD | \`vibe build\` |
 | Hand-tweak a single scene's animation | edit \`compositions/<file>.html\` directly |
-| Render the project | \`vibe render\` *or* \`vibe scene render\` for lower-level control |
+| Render the project | \`vibe render\` (one canonical entry point) |
 | Lint | \`vibe scene lint\` *or* \`npx hyperframes lint\` (equivalent) |
 
 The \`vibe\` CLI adds asset generation, AI orchestration, and pipeline
@@ -61837,12 +61858,12 @@ overlay, etc.) \u2014 useful at the tail of a pipeline.
         ],
         relatedCommands: [
           "vibe init",
+          "vibe build",
+          "vibe render",
           "vibe scene list-styles",
           "vibe scene install-skill",
           "vibe scene compose-prompts",
-          "vibe build",
           "vibe scene lint",
-          "vibe scene render",
           "vibe scene add"
         ]
       },
@@ -62166,7 +62187,7 @@ init_source();
 // package.json
 var package_default = {
   name: "@vibeframe/cli",
-  version: "0.78.0",
+  version: "0.79.0",
   description: "VibeFrame CLI - natural language video editing from the terminal",
   private: false,
   license: "MIT",
@@ -62578,6 +62599,7 @@ init_engine();
 init_validate();
 init_output();
 import { readFile as readFile9, writeFile as writeFile9 } from "node:fs/promises";
+import { existsSync as existsSync8 } from "node:fs";
 import { resolve as resolve11, basename as basename2, extname } from "node:path";
 var timelineCommand = new Command("timeline").description("Timeline editing commands").addHelpText("after", `
 Examples:
@@ -62928,6 +62950,9 @@ timelineCommand.command("list").description("List timeline contents").argument("
   const startedAt = Date.now();
   try {
     const filePath = resolve11(process.cwd(), projectPath);
+    if (!existsSync8(filePath)) {
+      exitWithError(notFoundError(projectPath));
+    }
     const content = await readFile9(filePath, "utf-8");
     const data = JSON.parse(content);
     const project = Project.fromJSON(data);
@@ -63548,16 +63573,16 @@ init_output();
 init_validate();
 import { resolve as resolve33, dirname as dirname11, basename as basename7, extname as extname7 } from "node:path";
 import { readFile as readFile24, writeFile as writeFile31 } from "node:fs/promises";
-import { existsSync as existsSync25 } from "node:fs";
+import { existsSync as existsSync26 } from "node:fs";
 var audioCommand = new Command("audio").alias("au").description("Audio operations (transcribe, TTS, voice clone, ducking)").addHelpText(
   "after",
   `
 Examples:
-  $ vibe audio transcribe interview.mp3 -o transcript.srt -f srt
+  $ vibe audio transcribe interview.mp3 -o transcript.srt --format srt
   $ vibe audio transcribe video.mp4 -l ko                  # Specify language
   $ vibe audio list-voices                                  # List available voices
   $ vibe audio isolate song.mp3 -o vocals.mp3
-  $ vibe audio clone-voice sample.mp3 -n "my-voice"
+  $ vibe audio clone-voice sample.mp3 --name "my-voice"
   $ vibe audio dub video.mp4 -l ko -o dubbed.mp4
   $ vibe audio duck music.mp3 --voice narration.mp3 -o ducked.mp3
 
@@ -63752,7 +63777,7 @@ audioCommand.command("clone-voice").description("Clone a voice from audio sample
     const audioBuffers = [];
     for (const samplePath of samples) {
       const absPath = resolve33(process.cwd(), samplePath);
-      if (!existsSync25(absPath)) {
+      if (!existsSync26(absPath)) {
         spinner2.fail(`File not found: ${samplePath}`);
         exitWithError(notFoundError(samplePath));
       }
@@ -63813,7 +63838,7 @@ audioCommand.command("dub").description("Dub audio/video to another language (tr
       exitWithError(usageError("Target language is required. Use -l or --language"));
     }
     const absPath = resolve33(process.cwd(), mediaPath);
-    if (!existsSync25(absPath)) {
+    if (!existsSync26(absPath)) {
       exitWithError(notFoundError(mediaPath));
     }
     const openaiKey = await requireApiKey("OPENAI_API_KEY", "OpenAI");
@@ -64056,7 +64081,7 @@ init_esm();
 init_source();
 init_ora();
 import { resolve as resolve37, basename as basename10 } from "node:path";
-import { existsSync as existsSync29 } from "node:fs";
+import { existsSync as existsSync30 } from "node:fs";
 
 // src/commands/ai-script-pipeline-cli.ts
 init_source();
@@ -64067,19 +64092,19 @@ init_ai_script_pipeline();
 init_output();
 import { readFile as readFile25, writeFile as writeFile32 } from "node:fs/promises";
 import { resolve as resolve34 } from "node:path";
-import { existsSync as existsSync26 } from "node:fs";
+import { existsSync as existsSync27 } from "node:fs";
 function registerScriptPipelineCommands(aiCommand) {
   aiCommand.command("regenerate-scene").description("Regenerate a specific scene in a script-to-video output directory").argument("<project-dir>", "Path to the script-to-video output directory").requiredOption("--scene <numbers>", "Scene number(s) to regenerate (1-based), e.g., 3 or 3,4,5").option("--video-only", "Only regenerate video").option("--narration-only", "Only regenerate narration").option("--image-only", "Only regenerate image").option("--generator <engine>", "Video generator: grok | kling | runway | veo", "grok").option("-i, --image-provider <provider>", "Image provider: gemini | openai | grok", "gemini").option("--voice <id>", "ElevenLabs voice ID for narration").option("-a, --aspect-ratio <ratio>", "Aspect ratio: 16:9 | 9:16 | 1:1", "16:9").option("--retries <count>", "Number of retries for video generation failures", String(DEFAULT_VIDEO_RETRIES)).option("--reference-scene <num>", "Use another scene's image as reference for character consistency").option("--dry-run", "Preview parameters without executing").action(async (projectDir, options) => {
     const startedAt = Date.now();
     try {
       const outputDir = resolve34(process.cwd(), projectDir);
       const projectPath = resolve34(outputDir, "project.vibe.json");
-      if (!existsSync26(outputDir)) {
+      if (!existsSync27(outputDir)) {
         exitWithError(notFoundError(outputDir));
       }
       const yamlPath = resolve34(outputDir, "storyboard.yaml");
       const jsonPath = resolve34(outputDir, "storyboard.json");
-      const storyboardPath = existsSync26(yamlPath) ? yamlPath : existsSync26(jsonPath) ? jsonPath : null;
+      const storyboardPath = existsSync27(yamlPath) ? yamlPath : existsSync27(jsonPath) ? jsonPath : null;
       const storyboardIsYaml = storyboardPath === yamlPath;
       if (!storyboardPath) {
         exitWithError(notFoundError(`${outputDir}/storyboard.{yaml,json}`));
@@ -64177,7 +64202,7 @@ function registerScriptPipelineCommands(aiCommand) {
         exitWithError(apiError(result.error || "Scene regeneration failed", true));
       }
       spinner2.succeed(source_default.green(`Regenerated ${result.regeneratedScenes.length} scene(s)`));
-      if (existsSync26(projectPath) && result.regeneratedScenes.length > 0) {
+      if (existsSync27(projectPath) && result.regeneratedScenes.length > 0) {
         const updateSpinner = ora("\u{1F4E6} Updating project file...").start();
         try {
           const updatedContent = await readFile25(storyboardPath, "utf-8");
@@ -64191,7 +64216,7 @@ function registerScriptPipelineCommands(aiCommand) {
             const imagePath = resolve34(outputDir, `scene-${sceneNum}.png`);
             const videoSource = projectData.state.sources.find((s) => s.name === `Scene ${sceneNum}`);
             if (videoSource) {
-              const hasVideo = existsSync26(videoPath);
+              const hasVideo = existsSync27(videoPath);
               videoSource.url = hasVideo ? videoPath : imagePath;
               videoSource.type = hasVideo ? "video" : "image";
               videoSource.duration = segment.duration;
@@ -64255,9 +64280,9 @@ Two flows \u2014 pick by intent:
 
 Examples (REMIX):
   $ vibe remix highlights long-video.mp4 -o highlights.json -d 60
-  $ vibe remix auto-shorts long-video.mp4 -o shorts/ -n 3 --add-captions
-  $ vibe remix animated-caption video.mp4 -o captioned.mp4 -s highlight
-  $ vibe remix animated-caption video.mp4 -o out.mp4 -s karaoke-sweep --fast
+  $ vibe remix auto-shorts long-video.mp4 -o shorts/ --count 3 --add-captions
+  $ vibe remix animated-caption video.mp4 -o captioned.mp4 --style highlight
+  $ vibe remix animated-caption video.mp4 -o out.mp4 --style karaoke-sweep --fast
 
 Provider API Keys:
   highlights:          GOOGLE_API_KEY (Gemini analysis)
@@ -64282,8 +64307,8 @@ pipelineCommand.command("animated-caption").description("Add animated captions w
   `
 Examples:
   $ vibe remix animated-caption video.mp4 -o captioned.mp4
-  $ vibe remix animated-caption video.mp4 -o out.mp4 -s bounce
-  $ vibe remix animated-caption video.mp4 -o out.mp4 -s karaoke-sweep --fast
+  $ vibe remix animated-caption video.mp4 -o out.mp4 --style bounce
+  $ vibe remix animated-caption video.mp4 -o out.mp4 --style karaoke-sweep --fast
 
 Styles:
   highlight (default)  TikTok-style background highlight on active word (Remotion)
@@ -64299,7 +64324,7 @@ Required API Key: OPENAI_API_KEY (Whisper transcription)
   const startedAt = Date.now();
   try {
     const absVideoPath = resolve37(process.cwd(), videoPath);
-    if (!existsSync29(absVideoPath)) {
+    if (!existsSync30(absVideoPath)) {
       exitWithError(notFoundError(absVideoPath));
     }
     if (!ANIMATED_CAPTION_STYLES.includes(options.style)) {
@@ -69400,7 +69425,7 @@ init_agent_host_detect();
 init_scene_project();
 init_visual_styles();
 init_install_skill();
-import { existsSync as existsSync30 } from "node:fs";
+import { existsSync as existsSync31 } from "node:fs";
 import { mkdir as mkdir17, readFile as readFile30, writeFile as writeFile37 } from "node:fs/promises";
 import { basename as basename14, dirname as dirname14, resolve as resolve42 } from "node:path";
 
@@ -69691,7 +69716,7 @@ var initCommand = new Command("init").description("Scaffold a VibeFrame project
   const wantsGemini = targetHosts.includes("gemini-cli");
   const wantsCrossTool = targetHosts.some((h) => h !== "claude-code");
   const actions = [];
-  if (!existsSync30(projectDir)) {
+  if (!existsSync31(projectDir)) {
     if (options.dryRun) {
       actions.push({ path: projectDir, status: "would-write", reason: "(would create directory)" });
     } else {
@@ -69937,7 +69962,7 @@ function resolveTargets(agent) {
   return [agent];
 }
 async function writeIfMissing(absPath, content, force, dryRun) {
-  const exists = existsSync30(absPath);
+  const exists = existsSync31(absPath);
   if (exists && !force) {
     return { path: absPath, status: "skipped-exists", reason: "(use --force to overwrite)" };
   }
@@ -69950,7 +69975,7 @@ async function writeIfMissing(absPath, content, force, dryRun) {
 }
 async function mergeGitignore(absPath, additions, dryRun) {
   const marker = "# VibeFrame";
-  if (!existsSync30(absPath)) {
+  if (!existsSync31(absPath)) {
     if (dryRun) return { path: absPath, status: "would-write" };
     await writeFile37(absPath, additions.trimStart(), "utf-8");
     return { path: absPath, status: "wrote" };
@@ -70293,7 +70318,7 @@ init_composer_resolve();
 init_scene_build();
 init_output();
 import { access as access6 } from "node:fs/promises";
-import { existsSync as existsSync34 } from "node:fs";
+import { existsSync as existsSync35 } from "node:fs";
 import { resolve as resolve49 } from "node:path";
 var COMMAND_KEY_MAP = getCommandKeyMap();
 var FREE_COMMANDS = [
@@ -70407,7 +70432,7 @@ async function runDiagnostics() {
         installed = false;
       }
     } else if (toolName === "chrome") {
-      const { existsSync: existsSync39 } = await import("node:fs");
+      const { existsSync: existsSync40 } = await import("node:fs");
       const { homedir: homedir6 } = await import("node:os");
       const { join: join16 } = await import("node:path");
       const chromePaths = [
@@ -70420,7 +70445,7 @@ async function runDiagnostics() {
         "/usr/bin/chromium",
         "/usr/bin/chromium-browser"
       ];
-      installed = chromePaths.some((p) => p && existsSync39(p));
+      installed = chromePaths.some((p) => p && existsSync40(p));
     } else {
       installed = commandExists(toolName);
     }
@@ -70451,7 +70476,7 @@ async function runDiagnostics() {
   const cwd = process.cwd();
   const projectFiles = ["AGENTS.md", "CLAUDE.md", "vibe.project.yaml"].map((rel) => ({
     path: rel,
-    exists: existsSync34(resolve49(cwd, rel))
+    exists: existsSync35(resolve49(cwd, rel))
   }));
   const projectInitialized = projectFiles.some((f) => f.exists);
   const hosts = detectAgentHosts();
@@ -70466,8 +70491,8 @@ async function runDiagnostics() {
   } catch (err) {
     if (!(err instanceof ComposerResolveError)) throw err;
   }
-  const sceneProjectInCwd = existsSync34(resolve49(cwd, "STORYBOARD.md"));
-  const skillInstalled = existsSync34(resolve49(cwd, "SKILL.md"));
+  const sceneProjectInCwd = existsSync35(resolve49(cwd, "STORYBOARD.md"));
+  const skillInstalled = existsSync35(resolve49(cwd, "SKILL.md"));
   return {
     system: {
       node: { version: nodeVersion, ok: true },
@@ -70633,7 +70658,7 @@ init_detect();
 init_ai_edit();
 init_output();
 import { resolve as resolve50 } from "node:path";
-import { existsSync as existsSync35 } from "node:fs";
+import { existsSync as existsSync36 } from "node:fs";
 import { mkdir as mkdir20, rm as rm3 } from "node:fs/promises";
 var DEMO_DIR = resolve50(process.cwd(), ".vibeframe-demo");
 async function generateTestVideo(outputPath) {
@@ -70664,7 +70689,7 @@ async function generateTestVideo(outputPath) {
       "-y",
       outputPath
     ], { timeout: 3e4, maxBuffer: 50 * 1024 * 1024 });
-    return existsSync35(outputPath);
+    return existsSync36(outputPath);
   } catch {
     try {
       await execSafe("ffmpeg", [
@@ -70690,7 +70715,7 @@ async function generateTestVideo(outputPath) {
         "-y",
         outputPath
       ], { timeout: 3e4, maxBuffer: 50 * 1024 * 1024 });
-      return existsSync35(outputPath);
+      return existsSync36(outputPath);
     } catch {
       return false;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibeframe/cli",
-  "version": "0.78.0",
+  "version": "0.79.0",
   "description": "VibeFrame CLI - natural language video editing from the terminal",
   "private": false,
   "license": "MIT",
@@ -182,8 +182,8 @@
     "tsx": "^4.21.0",
     "typescript": "^5.3.3",
     "vitest": "^1.2.2",
-    "@vibeframe/core": "0.78.0",
-    "@vibeframe/ai-providers": "0.78.0"
+    "@vibeframe/ai-providers": "0.79.0",
+    "@vibeframe/core": "0.79.0"
   },
   "engines": {
     "node": ">=20"