@vibeframe/cli 0.77.0 → 0.79.0

package/dist/index.js

@@ -29396,7 +29396,7 @@ var init_scene = __esm({
     init_agent_host_detect();
     init_install_skill();
     init_compose_prompts();
-    sceneCommand = new Command("scene").description("Lower-level scene authoring (add, lint, styles). For project flow use `vibe init` / `vibe build` / `vibe render`.").addHelpText("after", `
+    sceneCommand = new Command("scene").description("Lower-level scene authoring (add, lint, list-styles). For project flow use `vibe init` / `vibe build` / `vibe render`.").addHelpText("after", `
 Examples:
   $ vibe scene add intro --style announcement \\
       --headline "Welcome to VibeFrame"                   # Headline-only scene
@@ -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");
@@ -30703,7 +30703,7 @@ Use this image analysis to inform the color palette, typography placement, and o
   return { success: true, codePath, componentName: component.name, renderedPath: renderResult.outputPath };
 }
 function registerMotionCommand(aiCommand) {
-  aiCommand.command("motion").description("Generate motion graphics using Claude + Remotion (render & composite)").argument("<description>", "Natural language description of the motion graphic").option("-k, --api-key <key>", "Anthropic API key (or set ANTHROPIC_API_KEY env)").option("-o, --output <path>", "Output file path", "motion.tsx").option("-d, --duration <sec>", "Duration in seconds", "5").option("-w, --width <px>", "Width in pixels", "1920").option("-h, --height <px>", "Height in pixels", "1080").option("--fps <fps>", "Frame rate", "30").option("-s, --style <style>", "Style preset: minimal, corporate, playful, cinematic").option("--render", "Render the generated code with Remotion (output .webm)").option("--video <path>", "Base video to composite the motion graphic onto").option("--image <path>", "Image to analyze with Gemini \u2014 color/mood fed into Claude prompt").option("--from-tsx <path>", "Refine an existing TSX file instead of generating from scratch").option("-m, --model <alias>", "LLM model: sonnet (default), opus, gemini, gemini-3.1-pro", "sonnet").option("--dry-run", "Preview parameters without executing").action(async (description, options) => {
+  aiCommand.command("motion").description("Generate motion graphics using Claude + Remotion (render & composite)").argument("<description>", "Natural language description of the motion graphic").option("-k, --api-key <key>", "Anthropic API key (or set ANTHROPIC_API_KEY env)").option("-o, --output <path>", "Output file path", "motion.tsx").option("-d, --duration <sec>", "Duration in seconds", "5").option("--width <px>", "Width in pixels", "1920").option("--height <px>", "Height in pixels", "1080").option("--fps <fps>", "Frame rate", "30").option("--style <style>", "Style preset: minimal, corporate, playful, cinematic").option("--render", "Render the generated code with Remotion (output .webm)").option("--video <path>", "Base video to composite the motion graphic onto").option("--image <path>", "Image to analyze with Gemini \u2014 color/mood fed into Claude prompt").option("--from-tsx <path>", "Refine an existing TSX file instead of generating from scratch").option("-m, --model <alias>", "LLM model: sonnet (default), opus, gemini, gemini-3.1-pro", "sonnet").option("--dry-run", "Preview parameters without executing").action(async (description, options) => {
     const startedAt = Date.now();
     try {
       if (options.output) {
@@ -31307,7 +31307,7 @@ async function executeStoryboard(options) {
   }
 }
 function registerStoryboardCommand(parent) {
-  parent.command("storyboard").description("Generate video storyboard from content using Claude").argument("<content>", "Content to analyze (text or file path)").option("-k, --api-key <key>", "Anthropic API key (or set ANTHROPIC_API_KEY env)").option("-o, --output <path>", "Output JSON file path").option("-d, --duration <sec>", "Target total duration in seconds").option("-f, --file", "Treat content argument as file path").option("-c, --creativity <level>", "Creativity level: low (default, consistent) or high (varied, unexpected)", "low").option("--dry-run", "Preview parameters without executing").action(async (content, options) => {
+  parent.command("storyboard").description("Generate video storyboard from content using Claude").argument("<content>", "Content to analyze (text or file path)").option("-k, --api-key <key>", "Anthropic API key (or set ANTHROPIC_API_KEY env)").option("-o, --output <path>", "Output JSON file path").option("-d, --duration <sec>", "Target total duration in seconds").option("--file", "Treat content argument as file path").option("--creativity <level>", "Creativity level: low (default, consistent) or high (varied, unexpected)", "low").option("--dry-run", "Preview parameters without executing").action(async (content, options) => {
     const startedAt = Date.now();
     try {
       rejectControlChars(content);
@@ -31625,7 +31625,7 @@ async function executeSpeech(options) {
   }
 }
 function registerSpeechCommand(parent) {
-  parent.command("speech").alias("tts").description("Generate speech from text using ElevenLabs").argument("[text]", "Text to convert to speech (interactive if omitted)").option("-k, --api-key <key>", "ElevenLabs API key (or set ELEVENLABS_API_KEY env)").option("-o, --output <path>", "Output audio file path", "output.mp3").option("-v, --voice <id>", "Voice ID (default: Rachel)", "21m00Tcm4TlvDq8ikWAM").option("--list-voices", "List available voices").option("--fit-duration <seconds>", "Speed up audio to fit target duration (via FFmpeg atempo)", parseFloat).option("--dry-run", "Preview parameters without executing").action(async (text, options) => {
+  parent.command("speech").alias("tts").description("Generate speech from text using ElevenLabs").argument("[text]", "Text to convert to speech (interactive if omitted)").option("-k, --api-key <key>", "ElevenLabs API key (or set ELEVENLABS_API_KEY env)").option("-o, --output <path>", "Output audio file path", "output.mp3").option("--voice <id>", "Voice ID (default: Rachel)", "21m00Tcm4TlvDq8ikWAM").option("--list-voices", "List available voices").option("--fit-duration <seconds>", "Speed up audio to fit target duration (via FFmpeg atempo)", parseFloat).option("--dry-run", "Preview parameters without executing").action(async (text, options) => {
     const startedAt = Date.now();
     try {
       if (!text) {
@@ -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("-m, --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,10 +32262,10 @@ 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("-s, --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) => {
+  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) => {
     const startedAt = Date.now();
     try {
       if (description) rejectControlChars(description);
@@ -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")) {
@@ -32431,7 +32431,7 @@ function getStatusColor(status) {
   }
 }
 function registerVideoStatusCommand(parent) {
-  parent.command("video-status", { hidden: true }).description("Check video generation status (Grok, Runway, or Kling)").argument("<task-id>", "Task ID from video generation").option("-p, --provider <provider>", "Provider: grok, runway, kling", "grok").option("-k, --api-key <key>", "API key (or set XAI_API_KEY / RUNWAY_API_SECRET / KLING_API_KEY env)").option("-t, --type <type>", "Task type: text2video or image2video (Kling only)", "text2video").option("-w, --wait", "Wait for completion").option("-o, --output <path>", "Download video when complete").action(async (taskId, options) => {
+  parent.command("video-status", { hidden: true }).description("Check video generation status (Grok, Runway, or Kling)").argument("<task-id>", "Task ID from video generation").option("-p, --provider <provider>", "Provider: grok, runway, kling", "grok").option("-k, --api-key <key>", "API key (or set XAI_API_KEY / RUNWAY_API_SECRET / KLING_API_KEY env)").option("--type <type>", "Task type: text2video or image2video (Kling only)", "text2video").option("--wait", "Wait for completion").option("-o, --output <path>", "Download video when complete").action(async (taskId, options) => {
     const startedAt = Date.now();
     try {
       const provider = (options.provider || "grok").toLowerCase();
@@ -32664,7 +32664,7 @@ var init_video_status = __esm({
 import { resolve as resolve21 } from "node:path";
 import { writeFile as writeFile20 } from "node:fs/promises";
 function registerVideoExtendCommand(parent) {
-  parent.command("video-extend", { hidden: true }).description("Extend video duration (Kling by video ID, Veo by operation name)").argument("<id>", "Kling video ID or Veo operation name").option("-p, --provider <provider>", "Provider: kling, veo", "kling").option("-k, --api-key <key>", "API key (KLING_API_KEY or GOOGLE_API_KEY)").option("-o, --output <path>", "Output file path").option("--prompt <text>", "Continuation prompt").option("-d, --duration <sec>", "Duration: 5 or 10 (Kling), 4/6/8 (Veo)", "5").option("-n, --negative <prompt>", "Negative prompt (what to avoid, Kling only)").option("--veo-model <model>", "Veo model: 3.0, 3.1, 3.1-fast", "3.1").option("--no-wait", "Start extension and return task ID without waiting").option("--dry-run", "Preview parameters without executing").action(async (id, options) => {
+  parent.command("video-extend", { hidden: true }).description("Extend video duration (Kling by video ID, Veo by operation name)").argument("<id>", "Kling video ID or Veo operation name").option("-p, --provider <provider>", "Provider: kling, veo", "kling").option("-k, --api-key <key>", "API key (KLING_API_KEY or GOOGLE_API_KEY)").option("-o, --output <path>", "Output file path").option("--prompt <text>", "Continuation prompt").option("-d, --duration <sec>", "Duration: 5 or 10 (Kling), 4/6/8 (Veo)", "5").option("--negative <prompt>", "Negative prompt (what to avoid, Kling only)").option("--veo-model <model>", "Veo model: 3.0, 3.1, 3.1-fast", "3.1").option("--no-wait", "Start extension and return task ID without waiting").option("--dry-run", "Preview parameters without executing").action(async (id, options) => {
     const startedAt = Date.now();
     try {
       const provider = (options.provider || "kling").toLowerCase();
@@ -32947,7 +32947,7 @@ import { resolve as resolve22, dirname as dirname7 } from "node:path";
 import { fileURLToPath } from "node:url";
 import { writeFile as writeFile21, mkdir as mkdir10 } from "node:fs/promises";
 function registerImageCommand(parent) {
-  parent.command("image").alias("img").description("Generate image using AI (Gemini, OpenAI gpt-image, Grok, or Runway)").argument("[prompt]", "Image description prompt (interactive if omitted)").option("-p, --provider <provider>", "Provider: openai (default when OPENAI_API_KEY set), gemini, grok, runway").option("-k, --api-key <key>", "API key (or set env: OPENAI_API_KEY, GOOGLE_API_KEY)").option("-o, --output <path>", "Output file path (downloads image)").option("-s, --size <size>", "Image size (openai: 1024x1024, 1536x1024, 1024x1536)", "1024x1024").option("-r, --ratio <ratio>", "Aspect ratio (gemini: 1:1, 1:4, 1:8, 4:1, 8:1, 16:9, 9:16, 3:4, 4:3, etc.)", "1:1").option("--quality <quality>", "Quality: standard, hd (openai only)", "standard").option("--style <style>", "Style: vivid, natural (openai only)", "vivid").option("-n, --count <n>", "Number of images to generate", "1").option("-m, --model <model>", "Model. Gemini: flash, 3.1-flash, latest, pro. OpenAI: 1.5 (default), 2 (gpt-image-2)").option("--dry-run", "Preview parameters without executing").addHelpText("after", `
+  parent.command("image").alias("img").description("Generate image using AI (Gemini, OpenAI gpt-image, Grok, or Runway)").argument("[prompt]", "Image description prompt (interactive if omitted)").option("-p, --provider <provider>", "Provider: openai (default when OPENAI_API_KEY set), gemini, grok, runway").option("-k, --api-key <key>", "API key (or set env: OPENAI_API_KEY, GOOGLE_API_KEY)").option("-o, --output <path>", "Output file path (downloads image)").option("--size <size>", "Image size (openai: 1024x1024, 1536x1024, 1024x1536)", "1024x1024").option("-r, --ratio <ratio>", "Aspect ratio (gemini: 1:1, 1:4, 1:8, 4:1, 8:1, 16:9, 9:16, 3:4, 4:3, etc.)", "1:1").option("--quality <quality>", "Quality: standard, hd (openai only)", "standard").option("--style <style>", "Style: vivid, natural (openai only)", "vivid").option("--count <n>", "Number of images to generate", "1").option("-m, --model <model>", "Model. Gemini: flash, 3.1-flash, latest, pro. OpenAI: 1.5 (default), 2 (gpt-image-2)").option("--dry-run", "Preview parameters without executing").addHelpText("after", `
 Examples:
   $ vibe generate image "a sunset over the ocean" -o sunset.png
   $ vibe gen img "logo design" -o logo.png -p openai
@@ -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;
         }
@@ -35090,7 +35099,7 @@ function registerVideoCommand(parent) {
     "-d, --duration <sec>",
     "Duration in seconds. Seedance accepts 4-15 (`fal` alias supported); Kling accepts 5 or 10; Veo maps to 6 or 8.",
     "5"
-  ).option("-r, --ratio <ratio>", "Aspect ratio: 16:9, 9:16, or 1:1 (auto-detected from image if omitted)").option("-s, --seed <number>", "Random seed for reproducibility (Runway only)").option("-m, --mode <mode>", "Generation mode: std or pro (Kling only)", "std").option("--seedance-model <model>", "Seedance variant: quality or fast (fal.ai only)", "quality").option("-n, --negative <prompt>", "Negative prompt - what to avoid (Kling/Veo)").option("--resolution <res>", "Video resolution: 720p, 1080p, 4k (Veo only)").option("--last-frame <path>", "Last frame image for frame interpolation (Veo only)").option("--ref-images <paths...>", "Reference images for character consistency (Veo 3.1 only, max 3)").option("--person <mode>", "Person generation: allow_all, allow_adult (Veo only)").option("--veo-model <model>", "Veo model: 3.0, 3.1, 3.1-fast (default: 3.1-fast)", "3.1-fast").option("--runway-model <model>", "Runway model: gen4.5 (default, text+image-to-video), gen4_turbo (image-to-video only)", "gen4.5").option("--no-wait", "Start generation and return task ID without waiting").option("--dry-run", "Preview parameters without executing").addHelpText("after", `
+  ).option("-r, --ratio <ratio>", "Aspect ratio: 16:9, 9:16, or 1:1 (auto-detected from image if omitted)").option("--seed <number>", "Random seed for reproducibility (Runway only)").option("--mode <mode>", "Generation mode: std or pro (Kling only)", "std").option("--seedance-model <model>", "Seedance variant: quality or fast (fal.ai only)", "quality").option("--negative <prompt>", "Negative prompt - what to avoid (Kling/Veo)").option("--resolution <res>", "Video resolution: 720p, 1080p, 4k (Veo only)").option("--last-frame <path>", "Last frame image for frame interpolation (Veo only)").option("--ref-images <paths...>", "Reference images for character consistency (Veo 3.1 only, max 3)").option("--person <mode>", "Person generation: allow_all, allow_adult (Veo only)").option("--veo-model <model>", "Veo model: 3.0, 3.1, 3.1-fast (default: 3.1-fast)", "3.1-fast").option("--runway-model <model>", "Runway model: gen4.5 (default, text+image-to-video), gen4_turbo (image-to-video only)", "gen4.5").option("--no-wait", "Start generation and return task ID without waiting").option("--dry-run", "Preview parameters without executing").addHelpText("after", `
 Examples:
   $ vibe generate video "dancing cat" -o cat.mp4                      # Seedance when FAL_KEY is set
   $ vibe gen vid "cinematic city timelapse" -o city.mp4 -p seedance   # Seedance via fal.ai
@@ -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("-n, --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", `
+  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")) {
@@ -37026,12 +37044,12 @@ No API key needed (FFmpeg only). Use --use-gemini for smart detection (requires
       exitWithError(apiError(`Silence cut failed: ${error instanceof Error ? error.message : String(error)}`, true));
     }
   });
-  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("-s, --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", `
+  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")) {
@@ -37115,14 +37133,14 @@ Requires: OPENAI_API_KEY (Whisper transcription) + FFmpeg`).action(async (videoP
       exitWithError(apiError(`Caption failed: ${error instanceof Error ? error.message : String(error)}`, true));
     }
   });
-  aiCommand.command("noise-reduce").description("Remove background noise from audio/video using FFmpeg (no API key needed)").argument("<input>", "Audio or video file path").option("-o, --output <path>", "Output file path (default: <name>-denoised.<ext>)").option("-s, --strength <level>", "Noise reduction strength: low, medium, high (default: medium)", "medium").option("-n, --noise-floor <dB>", "Custom noise floor in dB (overrides strength preset)").option("--dry-run", "Preview parameters without executing").action(async (inputPath, options) => {
+  aiCommand.command("noise-reduce").description("Remove background noise from audio/video using FFmpeg (no API key needed)").argument("<input>", "Audio or video file path").option("-o, --output <path>", "Output file path (default: <name>-denoised.<ext>)").option("--strength <level>", "Noise reduction strength: low, medium, high (default: medium)", "medium").option("--noise-floor <dB>", "Custom noise floor in dB (overrides strength preset)").option("--dry-run", "Preview parameters without executing").action(async (inputPath, options) => {
     const startedAt = Date.now();
     try {
       if (options.output) {
         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")) {
@@ -37253,7 +37271,7 @@ Requires: OPENAI_API_KEY (Whisper transcription) + FFmpeg`).action(async (videoP
       exitWithError(generalError(`Fade failed: ${error instanceof Error ? error.message : String(error)}`));
     }
   });
-  aiCommand.command("translate-srt").description("Translate SRT subtitle file to another language (Claude/OpenAI)").argument("<srt>", "SRT file path").option("-t, --target <language>", "Target language (e.g., ko, es, fr, ja, zh)").option("-o, --output <path>", "Output file path (default: <name>-<target>.srt)").option("-p, --provider <provider>", "Translation provider: claude, openai (default: claude)", "claude").option("--source <language>", "Source language (auto-detected if omitted)").option("-k, --api-key <key>", "API key (or set ANTHROPIC_API_KEY / OPENAI_API_KEY env)").option("--dry-run", "Preview parameters without executing").action(async (srtPath, options) => {
+  aiCommand.command("translate-srt").description("Translate SRT subtitle file to another language (Claude or OpenAI)").argument("<srt>", "SRT file path").option("--target <language>", "Target language (e.g., ko, es, fr, ja, zh)").option("-o, --output <path>", "Output file path (default: <name>-<target>.srt)").option("-p, --provider <provider>", "Translation provider: claude, openai (default: claude)", "claude").option("--source <language>", "Source language (auto-detected if omitted)").option("-k, --api-key <key>", "API key (or set ANTHROPIC_API_KEY / OPENAI_API_KEY env)").option("--dry-run", "Preview parameters without executing").action(async (srtPath, options) => {
     const startedAt = Date.now();
     try {
       if (options.output) {
@@ -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");
@@ -37919,7 +37937,7 @@ var init_execute_fill_gaps = __esm({
 
 // src/commands/ai-fill-gaps.ts
 function registerFillGapsCommand(aiCommand) {
-  aiCommand.command("fill-gaps").description("Fill timeline gaps with AI-generated video (Kling image-to-video)").argument("<project>", "Project file path").option("-p, --provider <provider>", "AI provider (kling)", "kling").option("-o, --output <path>", "Output project path (default: overwrite)").option("-d, --dir <path>", "Directory to save generated videos").option("--prompt <text>", "Custom prompt for video generation").option("--dry-run", "Show gaps without generating").option("-m, --mode <mode>", "Generation mode: std or pro (Kling)", "std").option("-r, --ratio <ratio>", "Aspect ratio: 16:9, 9:16, or 1:1", "16:9").action(async (projectPath, options) => {
+  aiCommand.command("fill-gaps").description("Fill timeline gaps with AI-generated video (Kling image-to-video)").argument("<project>", "Project file path").option("-p, --provider <provider>", "AI provider (kling)", "kling").option("-o, --output <path>", "Output project path (default: overwrite)").option("-d, --dir <path>", "Directory to save generated videos").option("--prompt <text>", "Custom prompt for video generation").option("--dry-run", "Show gaps without generating").option("--mode <mode>", "Generation mode: std or pro (Kling)", "std").option("-r, --ratio <ratio>", "Aspect ratio: 16:9, 9:16, or 1:1", "16:9").action(async (projectPath, options) => {
     try {
       if (options.output) {
         validateOutputPath(options.output);
@@ -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):
@@ -38197,7 +38215,7 @@ Run 'vibe schema edit.<command>' for structured parameter info.
     );
     registerEditCommands(editCommand);
     registerFillGapsCommand(editCommand);
-    editCommand.command("grade").description("Apply AI-generated color grading (Claude + FFmpeg)").argument("<video>", "Video file path").option("-s, --style <prompt>", "Style description (e.g., 'cinematic warm')").option("--preset <name>", "Built-in preset: film-noir, vintage, cinematic-warm, cool-tones, high-contrast, pastel, cyberpunk, horror").option("-o, --output <path>", "Output video file path").option("--analyze-only", "Show filter without applying").option("-k, --api-key <key>", "Anthropic API key (or set ANTHROPIC_API_KEY env)").option("--dry-run", "Preview parameters without executing").action(async (videoPath, options) => {
+    editCommand.command("grade").description("Apply AI-generated color grading (Claude + FFmpeg)").argument("<video>", "Video file path").option("--style <prompt>", "Style description (e.g., 'cinematic warm')").option("--preset <name>", "Built-in preset: film-noir, vintage, cinematic-warm, cool-tones, high-contrast, pastel, cyberpunk, horror").option("-o, --output <path>", "Output video file path").option("--analyze-only", "Show filter without applying").option("-k, --api-key <key>", "Anthropic API key (or set ANTHROPIC_API_KEY env)").option("--dry-run", "Preview parameters without executing").action(async (videoPath, options) => {
       const startedAt = Date.now();
       try {
         if (options.style) rejectControlChars(options.style);
@@ -38285,7 +38303,7 @@ Run 'vibe schema edit.<command>' for structured parameter info.
         exitWithError(apiError(`Color grading failed: ${error.message}`));
       }
     });
-    editCommand.command("text-overlay").description("Apply text overlays to video (FFmpeg drawtext)").argument("<video>", "Video file path").option("-t, --text <texts...>", "Text lines to overlay (repeat for multiple)").option("-s, --style <style>", "Overlay style: lower-third, center-bold, subtitle, minimal", "lower-third").option("--font-size <size>", "Font size in pixels (auto-calculated if omitted)").option("--font-color <color>", "Font color (default: white)", "white").option("--fade <seconds>", "Fade in/out duration in seconds", "0.3").option("--start <seconds>", "Start time in seconds", "0").option("--end <seconds>", "End time in seconds (default: video duration)").option("-o, --output <path>", "Output video file path").option("--dry-run", "Preview parameters without executing").action(async (videoPath, options) => {
+    editCommand.command("text-overlay").description("Apply text overlays to video (FFmpeg drawtext)").argument("<video>", "Video file path").option("--text <texts...>", "Text lines to overlay (repeat for multiple)").option("--style <style>", "Overlay style: lower-third, center-bold, subtitle, minimal", "lower-third").option("--font-size <size>", "Font size in pixels (auto-calculated if omitted)").option("--font-color <color>", "Font color (default: white)", "white").option("--fade <seconds>", "Fade in/out duration in seconds", "0.3").option("--start <seconds>", "Start time in seconds", "0").option("--end <seconds>", "End time in seconds (default: video duration)").option("-o, --output <path>", "Output video file path").option("--dry-run", "Preview parameters without executing").action(async (videoPath, options) => {
       const startedAt = Date.now();
       try {
         if (!options.text || options.text.length === 0) {
@@ -38361,7 +38379,7 @@ Run 'vibe schema edit.<command>' for structured parameter info.
         exitWithError(generalError(`Text overlay failed: ${msg}`));
       }
     });
-    editCommand.command("speed-ramp").description("Apply content-aware speed ramping (Whisper + Claude + FFmpeg)").argument("<video>", "Video file path").option("-o, --output <path>", "Output video file path").option("-s, --style <style>", "Style: dramatic, smooth, action", "dramatic").option("--min-speed <factor>", "Minimum speed factor", "0.25").option("--max-speed <factor>", "Maximum speed factor", "4.0").option("--analyze-only", "Show keyframes without applying").option("-l, --language <lang>", "Language code for transcription").option("-k, --api-key <key>", "Anthropic API key (or set ANTHROPIC_API_KEY env)").option("--dry-run", "Preview parameters without executing").action(async (videoPath, options) => {
+    editCommand.command("speed-ramp").description("Apply content-aware speed ramping (Whisper + Claude + FFmpeg)").argument("<video>", "Video file path").option("-o, --output <path>", "Output video file path").option("--style <style>", "Style: dramatic, smooth, action", "dramatic").option("--min-speed <factor>", "Minimum speed factor", "0.25").option("--max-speed <factor>", "Maximum speed factor", "4.0").option("--analyze-only", "Show keyframes without applying").option("-l, --language <lang>", "Language code for transcription").option("-k, --api-key <key>", "Anthropic API key (or set ANTHROPIC_API_KEY env)").option("--dry-run", "Preview parameters without executing").action(async (videoPath, options) => {
       const startedAt = Date.now();
       try {
         if (options.output) {
@@ -38481,7 +38499,7 @@ Run 'vibe schema edit.<command>' for structured parameter info.
         exitWithError(generalError(`Speed ramping failed: ${msg}`));
       }
     });
-    editCommand.command("reframe").description("Auto-reframe video to different aspect ratio (Claude Vision + FFmpeg)").argument("<video>", "Video file path").option("-a, --aspect <ratio>", "Target aspect ratio: 9:16, 1:1, 4:5", "9:16").option("-f, --focus <mode>", "Focus mode: auto, face, center, action", "auto").option("-o, --output <path>", "Output video file path").option("--analyze-only", "Show crop regions without applying").option("--keyframes <path>", "Export keyframes to JSON file").option("-k, --api-key <key>", "Anthropic API key (or set ANTHROPIC_API_KEY env)").option("--dry-run", "Preview parameters without executing").action(async (videoPath, options) => {
+    editCommand.command("reframe").description("Auto-reframe video to different aspect ratio (Claude Vision + FFmpeg)").argument("<video>", "Video file path").option("-a, --aspect <ratio>", "Target aspect ratio: 9:16, 1:1, 4:5", "9:16").option("--focus <mode>", "Focus mode: auto, face, center, action", "auto").option("-o, --output <path>", "Output video file path").option("--analyze-only", "Show crop regions without applying").option("--keyframes <path>", "Export keyframes to JSON file").option("-k, --api-key <key>", "Anthropic API key (or set ANTHROPIC_API_KEY env)").option("--dry-run", "Preview parameters without executing").action(async (videoPath, options) => {
       const startedAt = Date.now();
       try {
         if (options.output) {
@@ -38628,7 +38646,7 @@ Run 'vibe schema edit.<command>' for structured parameter info.
         exitWithError(generalError(`Reframe failed: ${msg}`));
       }
     });
-    editCommand.command("image").description("Edit image(s) using AI (Gemini/OpenAI/Grok)").argument("<images...>", "Input image file(s) followed by edit prompt").option("-p, --provider <provider>", "Provider: gemini (default), openai, grok", "gemini").option("-k, --api-key <key>", "API key (or set env variable)").option("-o, --output <path>", "Output file path", "edited.png").option("-m, --model <model>", "Model: flash/3.1-flash/latest/pro (Gemini only)", "flash").option("-r, --ratio <ratio>", "Output aspect ratio").option("-s, --size <resolution>", "Resolution: 1K, 2K, 4K (Gemini Pro only)").option("--dry-run", "Preview parameters without executing").action(async (args, options) => {
+    editCommand.command("image").description("Edit image(s) using AI (Gemini, OpenAI, or Grok)").argument("<images...>", "Input image file(s) followed by edit prompt").option("-p, --provider <provider>", "Provider: gemini (default), openai, grok", "gemini").option("-k, --api-key <key>", "API key (or set env variable)").option("-o, --output <path>", "Output file path", "edited.png").option("-m, --model <model>", "Model: flash/3.1-flash/latest/pro (Gemini only)", "flash").option("-r, --ratio <ratio>", "Output aspect ratio").option("--size <resolution>", "Resolution: 1K, 2K, 4K (Gemini Pro only)").option("--dry-run", "Preview parameters without executing").action(async (args, options) => {
       const startedAt = Date.now();
       try {
         if (args.length < 2) {
@@ -38757,7 +38775,7 @@ Run 'vibe schema edit.<command>' for structured parameter info.
         exitWithError(apiError(`Image editing failed: ${msg}`, true));
       }
     });
-    editCommand.command("interpolate").description("Create slow motion with frame interpolation (FFmpeg)").argument("<video>", "Video file path").option("-o, --output <path>", "Output file path").option("-f, --factor <number>", "Slow motion factor: 2, 4, or 8", "2").option("--fps <number>", "Target output FPS").option("--quality <mode>", "Quality: fast or quality", "quality").option("--dry-run", "Preview parameters without executing").action(async (videoPath, options) => {
+    editCommand.command("interpolate").description("Create slow motion with frame interpolation (FFmpeg)").argument("<video>", "Video file path").option("-o, --output <path>", "Output file path").option("--factor <number>", "Slow motion factor: 2, 4, or 8", "2").option("--fps <number>", "Target output FPS").option("--mode <mode>", "Speed/quality tradeoff: fast or quality", "quality").option("--dry-run", "Preview parameters without executing").action(async (videoPath, options) => {
       const startedAt = Date.now();
       try {
         if (options.output) {
@@ -38778,7 +38796,7 @@ Run 'vibe schema edit.<command>' for structured parameter info.
                 videoPath: absPath,
                 factor,
                 fps: options.fps ? parseInt(options.fps) : void 0,
-                quality: options.quality
+                mode: options.mode
               }
             }
           });
@@ -38801,7 +38819,7 @@ Run 'vibe schema edit.<command>' for structured parameter info.
           const [num, den] = fpsOut.trim().split("/").map(Number);
           const originalFps = num / (den || 1);
           const targetFps = options.fps ? parseInt(options.fps) : originalFps * factor;
-          const mi = options.quality === "fast" ? "mi_mode=mci" : "mi_mode=mci:mc_mode=aobmc:me_mode=bidir:vsbmc=1";
+          const mi = options.mode === "fast" ? "mi_mode=mci" : "mi_mode=mci:mc_mode=aobmc:me_mode=bidir:vsbmc=1";
           spinner2.text = `Interpolating frames (${originalFps.toFixed(1)} \u2192 ${targetFps}fps)...`;
           await execSafe("ffmpeg", ["-i", absPath, "-filter:v", `minterpolate='${mi}:fps=${targetFps}',setpts=${factor}*PTS`, "-an", outputPath, "-y"], { timeout: 6e5 });
           spinner2.succeed(source_default.green(`Created ${factor}x slow motion`));
@@ -38839,7 +38857,7 @@ Run 'vibe schema edit.<command>' for structured parameter info.
         exitWithError(generalError(`Frame interpolation failed: ${msg}`));
       }
     });
-    editCommand.command("upscale").description("Upscale video resolution using AI or FFmpeg").argument("<video>", "Video file path").option("-o, --output <path>", "Output file path").option("-s, --scale <factor>", "Scale factor: 2 or 4", "2").option("-m, --model <model>", "Model: real-esrgan, topaz", "real-esrgan").option("--ffmpeg", "Use FFmpeg lanczos (free, no API)").option("-k, --api-key <key>", "Replicate API token (or set REPLICATE_API_TOKEN env)").option("--no-wait", "Start processing and return task ID without waiting").option("--dry-run", "Preview parameters without executing").action(async (videoPath, options) => {
+    editCommand.command("upscale").description("Upscale video resolution using AI or FFmpeg").argument("<video>", "Video file path").option("-o, --output <path>", "Output file path").option("--scale <factor>", "Scale factor: 2 or 4", "2").option("-m, --model <model>", "Model: real-esrgan, topaz", "real-esrgan").option("--ffmpeg", "Use FFmpeg lanczos (free, no API)").option("-k, --api-key <key>", "Replicate API token (or set REPLICATE_API_TOKEN env)").option("--no-wait", "Start processing and return task ID without waiting").option("--dry-run", "Preview parameters without executing").action(async (videoPath, options) => {
       const startedAt = Date.now();
       try {
         if (options.output) {
@@ -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 = `
 
@@ -39332,7 +39350,7 @@ Score each category 1-10. For fixable issues, provide an FFmpeg filter in autoFi
   return result;
 }
 function registerReviewCommand(aiCommand) {
-  aiCommand.command("review").description("Review video quality using Gemini AI and optionally auto-fix issues").argument("<video>", "Video file path").option("-s, --storyboard <path>", "Storyboard JSON file for context").option("--auto-apply", "Automatically apply fixable corrections").option("--verify", "Run verification pass after applying fixes").option("-m, --model <model>", "Gemini model: flash (default), flash-2.5, pro", "flash").option("-o, --output <path>", "Output video file path (for auto-apply)").option("--dry-run", "Preview parameters without executing").action(async (videoPath, options) => {
+  aiCommand.command("review").description("Review video quality using Gemini AI and optionally auto-fix issues").argument("<source>", "Video file path").option("--storyboard <path>", "Storyboard JSON file for context").option("--auto-apply", "Automatically apply fixable corrections").option("--verify", "Run verification pass after applying fixes").option("-m, --model <model>", "Gemini model: flash (default), flash-2.5, pro", "flash").option("-o, --output <path>", "Output video file path (for auto-apply)").option("--dry-run", "Preview parameters without executing").action(async (videoPath, options) => {
     const startedAt = Date.now();
     try {
       if (options.output) {
@@ -39340,7 +39358,7 @@ function registerReviewCommand(aiCommand) {
       }
       if (options.dryRun) {
         outputSuccess({
-          command: "ai review",
+          command: "inspect review",
           startedAt,
           dryRun: true,
           data: {
@@ -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 = {
@@ -39884,14 +39902,14 @@ Analyze both VISUALS (expressions, actions, scene changes) and AUDIO (speech, re
   }
 }
 function registerHighlightsCommands(aiCommand) {
-  aiCommand.command("highlights").description("Extract highlights from long-form video/audio content").argument("<media>", "Video or audio file path").option("-o, --output <path>", "Output JSON file with highlights").option("--project <path>", "Create project with highlight clips").option("-d, --duration <seconds>", "Target highlight reel duration", "60").option("-n, --count <number>", "Maximum number of highlights").option("-t, --threshold <value>", "Confidence threshold (0-1)", "0.7").option("--criteria <type>", "Selection criteria: emotional | informative | funny | all", "all").option("-l, --language <lang>", "Language code for transcription (e.g., en, ko)").option("--use-gemini", "Use Gemini Video Understanding for enhanced visual+audio analysis").option("--low-res", "Use low resolution mode for longer videos (Gemini only)").option("--dry-run", "Preview parameters without executing").action(async (mediaPath, options) => {
+  aiCommand.command("highlights").description("Extract highlights from long-form video/audio content").argument("<media>", "Video or audio file path").option("-o, --output <path>", "Output JSON file with highlights").option("--project <path>", "Create project with highlight clips").option("-d, --duration <seconds>", "Target highlight reel duration", "60").option("--count <number>", "Maximum number of highlights").option("--threshold <value>", "Confidence threshold (0-1)", "0.7").option("--criteria <type>", "Selection criteria: emotional | informative | funny | all", "all").option("-l, --language <lang>", "Language code for transcription (e.g., en, ko)").option("--use-gemini", "Use Gemini Video Understanding for enhanced visual+audio analysis").option("--low-res", "Use low resolution mode for longer videos (Gemini only)").option("--dry-run", "Preview parameters without executing").action(async (mediaPath, options) => {
     const startedAt = Date.now();
     try {
       if (options.output) {
         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(() => {
           });
@@ -40185,14 +40203,14 @@ Analyze both what is SHOWN (visual cues, actions, expressions) and what is SAID
       exitWithError(apiError(`Highlight extraction failed: ${error instanceof Error ? error.message : String(error)}`, true));
     }
   });
-  aiCommand.command("auto-shorts").alias("shorts").description("Auto-generate shorts from long-form video").argument("<video>", "Video file path").option("-o, --output <path>", "Output file (single) or directory (multiple)").option("-d, --duration <seconds>", "Target duration in seconds (15-60)", "60").option("-n, --count <number>", "Number of shorts to generate", "1").option("-a, --aspect <ratio>", "Aspect ratio: 9:16, 1:1", "9:16").option("--output-dir <dir>", "Output directory for multiple shorts").option("--add-captions", "Add auto-generated captions").option("--caption-style <style>", "Caption style: minimal, bold, animated", "bold").option("--analyze-only", "Show segments without generating").option("-l, --language <lang>", "Language code for transcription").option("--use-gemini", "Use Gemini Video Understanding for enhanced visual+audio analysis").option("--low-res", "Use low resolution mode for longer videos (Gemini only)").option("--dry-run", "Preview parameters without executing").action(async (videoPath, options) => {
+  aiCommand.command("auto-shorts").alias("shorts").description("Auto-generate shorts from long-form video").argument("<video>", "Video file path").option("-o, --output <path>", "Output file (single) or directory (multiple)").option("-d, --duration <seconds>", "Target duration in seconds (15-60)", "60").option("--count <number>", "Number of shorts to generate", "1").option("-a, --aspect <ratio>", "Aspect ratio: 9:16, 1:1", "9:16").option("--output-dir <dir>", "Output directory for multiple shorts").option("--add-captions", "Add auto-generated captions").option("--caption-style <style>", "Caption style: minimal, bold, animated", "bold").option("--analyze-only", "Show segments without generating").option("-l, --language <lang>", "Language code for transcription").option("--use-gemini", "Use Gemini Video Understanding for enhanced visual+audio analysis").option("--low-res", "Use low resolution mode for longer videos (Gemini only)").option("--dry-run", "Preview parameters without executing").action(async (videoPath, options) => {
     const startedAt = Date.now();
     try {
       if (options.output) {
         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") {
@@ -50304,15 +50322,14 @@ var init_detect = __esm({
     "use strict";
     init_esm();
     init_source();
-    init_ora();
     init_engine();
     init_exec_safe();
     init_output();
     init_validate();
     detectCommand = new Command("detect").description("Auto-detect scenes, beats, and silences in media");
-    detectCommand.command("scenes").description("Detect scene changes in video").argument("<video>", "Video file path").option("-t, --threshold <value>", "Scene change threshold (0-1)", "0.3").option("-o, --output <path>", "Output JSON file with timestamps").option("-p, --project <path>", "Add scenes as clips to project").option("--dry-run", "Preview parameters without executing").action(async (videoPath, options) => {
+    detectCommand.command("scenes").description("Detect scene changes in video").argument("<video>", "Video file path").option("--threshold <value>", "Scene change threshold (0-1)", "0.3").option("-o, --output <path>", "Output JSON file with timestamps").option("--project <path>", "Add scenes as clips to project").option("--dry-run", "Preview parameters without executing").action(async (videoPath, options) => {
       const startedAt = Date.now();
-      const spinner2 = ora("Detecting scenes...").start();
+      const spinner2 = spinner("Detecting scenes...").start();
       try {
         if (options.output) {
           validateOutputPath(options.output);
@@ -50429,9 +50446,9 @@ var init_detect = __esm({
         exitWithError(generalError(`Scene detection failed: ${msg}`));
       }
     });
-    detectCommand.command("silence").description("Detect silence in audio/video").argument("<media>", "Media file path").option("-n, --noise <dB>", "Noise threshold in dB", "-30").option("-d, --duration <sec>", "Minimum silence duration", "0.5").option("-o, --output <path>", "Output JSON file with timestamps").option("--dry-run", "Preview parameters without executing").action(async (mediaPath, options) => {
+    detectCommand.command("silence").description("Detect silence in audio/video").argument("<media>", "Media file path").option("--noise <dB>", "Noise threshold in dB", "-30").option("-d, --duration <sec>", "Minimum silence duration", "0.5").option("-o, --output <path>", "Output JSON file with timestamps").option("--dry-run", "Preview parameters without executing").action(async (mediaPath, options) => {
       const startedAt = Date.now();
-      const spinner2 = ora("Detecting silence...").start();
+      const spinner2 = spinner("Detecting silence...").start();
       try {
         if (options.output) {
           validateOutputPath(options.output);
@@ -50517,7 +50534,7 @@ var init_detect = __esm({
     });
     detectCommand.command("beats").description("Detect beats in audio (for music sync)").argument("<audio>", "Audio file path").option("-o, --output <path>", "Output JSON file with timestamps").option("--dry-run", "Preview parameters without executing").action(async (audioPath, options) => {
       const startedAt = Date.now();
-      const spinner2 = ora("Detecting beats...").start();
+      const spinner2 = spinner("Detecting beats...").start();
       try {
         if (options.output) {
           validateOutputPath(options.output);
@@ -50604,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() {
@@ -50630,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;
 }
@@ -50885,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,
@@ -50903,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);
@@ -51033,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) {
@@ -51043,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
@@ -51079,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 });
@@ -51127,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(),
@@ -51187,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 };
     }
@@ -51228,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 };
   }
@@ -51266,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;
     }
@@ -51297,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 = [];
@@ -51748,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);
@@ -51788,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 });
@@ -51814,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);
     }
@@ -51836,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;
@@ -51964,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`;
@@ -51979,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)}` };
@@ -51997,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;
@@ -52214,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");
@@ -52239,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) {
@@ -59645,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";
@@ -59657,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));
@@ -60488,18 +60505,18 @@ var init_export = __esm({
     BITRATE_PATTERN = /^\d+(?:\.\d+)?[kKmMgG]?$/;
     RESOLUTION_PATTERN = /^\d+x\d+$/;
     VALID_CODECS = ["h264", "h265", "vp9"];
-    exportCommand = new Command("export").description("Export project to video file").argument("<project>", "Project file path").option("-o, --output <path>", "Output file path").option("-f, --format <format>", "Output format (mp4, webm, mov, gif)", "mp4").option(
-      "-p, --preset <preset>",
+    exportCommand = new Command("export").description("Export project to video file").argument("<project>", "Project file path").option("-o, --output <path>", "Output file path").option("--format <format>", "Output format (mp4, webm, mov, gif)", "mp4").option(
+      "--preset <preset>",
       "Quality preset (draft, standard, high, ultra)",
       "standard"
-    ).option("-y, --overwrite", "Overwrite output file if exists", false).option("-g, --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", `
+    ).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.
@@ -61635,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\`)
@@ -61710,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
@@ -61838,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"
         ]
       },
@@ -62167,7 +62187,7 @@ init_source();
 // package.json
 var package_default = {
   name: "@vibeframe/cli",
-  version: "0.77.0",
+  version: "0.79.0",
   description: "VibeFrame CLI - natural language video editing from the terminal",
   private: false,
   license: "MIT",
@@ -62389,7 +62409,7 @@ async function resolveProjectPath(inputPath) {
   }
   return filePath;
 }
-var projectCommand = new Command("project").description("Project management commands").addHelpText("after", `
+var projectCommand = new Command("project").description("Manage VibeFrame .vibe.json project files (create, info, set)").addHelpText("after", `
 Examples:
   $ vibe project create "my-video" -o project.vibe.json
   $ vibe project create "shorts" -r 9:16 -o vertical.vibe.json
@@ -62398,7 +62418,7 @@ Examples:
 
 Cost: Free (no API keys needed). Projects are saved as .vibe.json files.
 Run 'vibe schema project.<command>' for structured parameter info.`);
-projectCommand.command("create").description("Create a new project").argument("<name>", "Project name or path (e.g., 'my-project' or 'output/my-project')").option("-o, --output <path>", "Output file path (overrides name-based path)").option("-r, --ratio <ratio>", "Aspect ratio (16:9, 9:16, 1:1, 4:5)", "16:9").option("-f, --fps <fps>", "Frame rate", "30").option("--dry-run", "Preview parameters without executing").action(async (name, options) => {
+projectCommand.command("create").description("Create a new project").argument("<name>", "Project name or path (e.g., 'my-project' or 'output/my-project')").option("-o, --output <path>", "Output file path (overrides name-based path)").option("-r, --ratio <ratio>", "Aspect ratio (16:9, 9:16, 1:1, 4:5)", "16:9").option("--fps <fps>", "Frame rate", "30").option("--dry-run", "Preview parameters without executing").action(async (name, options) => {
   const startedAt = Date.now();
   const spinner2 = ora("Creating project...").start();
   try {
@@ -62512,7 +62532,7 @@ projectCommand.command("info").description("Show project information").argument(
     exitWithError(generalError(`Failed to load project: ${msg}`));
   }
 });
-projectCommand.command("set").description("Update project settings").argument("<file>", "Project file path").option("-n, --name <name>", "Project name").option("-r, --ratio <ratio>", "Aspect ratio (16:9, 9:16, 1:1, 4:5)").option("-f, --fps <fps>", "Frame rate").option("--dry-run", "Preview parameters without executing").action(async (file, options) => {
+projectCommand.command("set").description("Update project settings").argument("<file>", "Project file path").option("--name <name>", "Project name").option("-r, --ratio <ratio>", "Aspect ratio (16:9, 9:16, 1:1, 4:5)").option("--fps <fps>", "Frame rate").option("--dry-run", "Preview parameters without executing").action(async (file, options) => {
   const startedAt = Date.now();
   const spinner2 = ora("Updating project...").start();
   try {
@@ -62579,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:
@@ -62592,7 +62613,7 @@ Examples:
 Typical workflow: create project \u2192 add-source \u2192 add-clip \u2192 trim-clip/split-clip \u2192 export
 Cost: Free (no API keys needed).
 Run 'vibe schema timeline.<command>' for structured parameter info.`);
-timelineCommand.command("add-source").description("Add a media source to the project").argument("<project>", "Project file path").argument("<media>", "Media file path").option("-n, --name <name>", "Source name (defaults to filename)").option("-t, --type <type>", "Media type (video, audio, image, lottie)").option("-d, --duration <seconds>", "Duration in seconds (required for images)").option("--dry-run", "Preview parameters without executing").action(async (projectPath, mediaPath, options) => {
+timelineCommand.command("add-source").description("Add a media source to the project").argument("<project>", "Project file path").argument("<media>", "Media file path").option("--name <name>", "Source name (defaults to filename)").option("--type <type>", "Media type (video, audio, image, lottie)").option("-d, --duration <seconds>", "Duration in seconds (required for images)").option("--dry-run", "Preview parameters without executing").action(async (projectPath, mediaPath, options) => {
   const startedAt = Date.now();
   const spinner2 = ora("Adding source...").start();
   try {
@@ -62654,7 +62675,7 @@ timelineCommand.command("add-source").description("Add a media source to the pro
     exitWithError(generalError(`Failed to add source: ${msg}`));
   }
 });
-timelineCommand.command("add-clip").description("Add a clip to the timeline").argument("<project>", "Project file path").argument("<source-id>", "Source ID to use").option("-t, --track <id>", "Track ID (defaults to first matching track)").option("-s, --start <seconds>", "Start time in timeline", "0").option("-d, --duration <seconds>", "Clip duration (defaults to source duration)").option("--offset <seconds>", "Source start offset", "0").option("--dry-run", "Preview parameters without executing").action(async (projectPath, sourceId, options) => {
+timelineCommand.command("add-clip").description("Add a clip to the timeline").argument("<project>", "Project file path").argument("<source-id>", "Source ID to use").option("--track <id>", "Track ID (defaults to first matching track)").option("--start <seconds>", "Start time in timeline", "0").option("-d, --duration <seconds>", "Clip duration (defaults to source duration)").option("--offset <seconds>", "Source start offset", "0").option("--dry-run", "Preview parameters without executing").action(async (projectPath, sourceId, options) => {
   const startedAt = Date.now();
   const spinner2 = ora("Adding clip...").start();
   try {
@@ -62736,7 +62757,7 @@ timelineCommand.command("add-clip").description("Add a clip to the timeline").ar
     exitWithError(generalError(`Failed to add clip: ${msg}`));
   }
 });
-timelineCommand.command("add-track").description("Add a new track").argument("<project>", "Project file path").argument("<type>", "Track type (video, audio)").option("-n, --name <name>", "Track name").option("--dry-run", "Preview parameters without executing").action(async (projectPath, type, options) => {
+timelineCommand.command("add-track").description("Add a new track").argument("<project>", "Project file path").argument("<type>", "Track type (video, audio)").option("--name <name>", "Track name").option("--dry-run", "Preview parameters without executing").action(async (projectPath, type, options) => {
   const startedAt = Date.now();
   const spinner2 = ora("Adding track...").start();
   try {
@@ -62793,7 +62814,7 @@ timelineCommand.command("add-track").description("Add a new track").argument("<p
     exitWithError(generalError(`Failed to add track: ${msg}`));
   }
 });
-timelineCommand.command("add-effect").description("Add an effect to a clip").argument("<project>", "Project file path").argument("<clip-id>", "Clip ID").argument("<effect-type>", "Effect type (fadeIn, fadeOut, blur, brightness, contrast, saturation, speed, volume)").option("-s, --start <seconds>", "Effect start time (relative to clip)", "0").option("-d, --duration <seconds>", "Effect duration (defaults to clip duration)").option("-p, --params <json>", "Effect parameters as JSON", "{}").option("--dry-run", "Preview parameters without executing").action(async (projectPath, clipId, effectType, options) => {
+timelineCommand.command("add-effect").description("Add an effect to a clip").argument("<project>", "Project file path").argument("<clip-id>", "Clip ID").argument("<effect-type>", "Effect type (fadeIn, fadeOut, blur, brightness, contrast, saturation, speed, volume)").option("--start <seconds>", "Effect start time (relative to clip)", "0").option("-d, --duration <seconds>", "Effect duration (defaults to clip duration)").option("--params <json>", "Effect parameters as JSON", "{}").option("--dry-run", "Preview parameters without executing").action(async (projectPath, clipId, effectType, options) => {
   const startedAt = Date.now();
   const spinner2 = ora("Adding effect...").start();
   try {
@@ -62929,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);
@@ -63027,7 +63051,7 @@ timelineCommand.command("list").description("List timeline contents").argument("
     exitWithError(generalError(`Failed to list timeline: ${msg}`));
   }
 });
-timelineCommand.command("split-clip").description("Split a clip at a specific time").argument("<project>", "Project file path").argument("<clip-id>", "Clip ID to split").option("-t, --time <seconds>", "Split time relative to clip start", "0").option("--dry-run", "Preview parameters without executing").action(async (projectPath, clipId, options) => {
+timelineCommand.command("split-clip").description("Split a clip at a specific time").argument("<project>", "Project file path").argument("<clip-id>", "Clip ID to split").option("--time <seconds>", "Split time relative to clip start", "0").option("--dry-run", "Preview parameters without executing").action(async (projectPath, clipId, options) => {
   const startedAt = Date.now();
   const spinner2 = ora("Splitting clip...").start();
   try {
@@ -63089,7 +63113,7 @@ timelineCommand.command("split-clip").description("Split a clip at a specific ti
     exitWithError(generalError(`Failed to split clip: ${msg}`));
   }
 });
-timelineCommand.command("duplicate-clip").description("Duplicate a clip").argument("<project>", "Project file path").argument("<clip-id>", "Clip ID to duplicate").option("-t, --time <seconds>", "Start time for duplicate (default: after original)").option("--dry-run", "Preview parameters without executing").action(async (projectPath, clipId, options) => {
+timelineCommand.command("duplicate-clip").description("Duplicate a clip").argument("<project>", "Project file path").argument("<clip-id>", "Clip ID to duplicate").option("--time <seconds>", "Start time for duplicate (default: after original)").option("--dry-run", "Preview parameters without executing").action(async (projectPath, clipId, options) => {
   const startedAt = Date.now();
   const spinner2 = ora("Duplicating clip...").start();
   try {
@@ -63200,7 +63224,7 @@ timelineCommand.command("delete-clip").description("Delete a clip from the timel
     exitWithError(generalError(`Failed to delete clip: ${msg}`));
   }
 });
-timelineCommand.command("move-clip").description("Move a clip to a new position").argument("<project>", "Project file path").argument("<clip-id>", "Clip ID to move").option("-t, --time <seconds>", "New start time").option("--track <track-id>", "Move to different track").option("--dry-run", "Preview parameters without executing").action(async (projectPath, clipId, options) => {
+timelineCommand.command("move-clip").description("Move a clip to a new position").argument("<project>", "Project file path").argument("<clip-id>", "Clip ID to move").option("--time <seconds>", "New start time").option("--track <track-id>", "Move to different track").option("--dry-run", "Preview parameters without executing").action(async (projectPath, clipId, options) => {
   const startedAt = Date.now();
   const spinner2 = ora("Moving clip...").start();
   try {
@@ -63311,10 +63335,29 @@ Use '--fields response,model' to limit output size.
 Run 'vibe schema inspect.<command>' for structured parameter info.
 `
 );
-analyzeCommand.command("media").description("Analyze any media: images, videos, or YouTube URLs using Gemini").argument("<source>", "Image/video file path, image URL, or YouTube URL").argument("<prompt>", "Analysis prompt (e.g., 'Describe this image', 'Summarize this video')").option("-k, --api-key <key>", "Google API key (or set GOOGLE_API_KEY env)").option("-m, --model <model>", "Model: flash (default), flash-2.5, pro", "flash").option("--fps <number>", "Frames per second for video (default: 1)").option("--start <seconds>", "Start offset in seconds (video only)").option("--end <seconds>", "End offset in seconds (video only)").option("--low-res", "Use low resolution mode (fewer tokens)").option("-v, --verbose", "Show token usage").option("--fields <fields>", "Comma-separated fields to include in output (e.g., response,model)").action(async (source, prompt3, options) => {
+analyzeCommand.command("media").description("Analyze any media: images, videos, or YouTube URLs using Gemini").argument("<source>", "Image/video file path, image URL, or YouTube URL").argument("<prompt>", "Analysis prompt (e.g., 'Describe this image', 'Summarize this video')").option("-k, --api-key <key>", "Google API key (or set GOOGLE_API_KEY env)").option("-m, --model <model>", "Model: flash (default), flash-2.5, pro", "flash").option("--fps <number>", "Frames per second for video (default: 1)").option("--start <seconds>", "Start offset in seconds (video only)").option("--end <seconds>", "End offset in seconds (video only)").option("--low-res", "Use low resolution mode (fewer tokens)").option("--verbose", "Show token usage").option("--fields <fields>", "Comma-separated fields to include in output (e.g., response,model)").option("--dry-run", "Preview parameters without executing").action(async (source, prompt3, options) => {
   const startedAt = Date.now();
   try {
     rejectControlChars(prompt3);
+    if (options.dryRun) {
+      outputSuccess({
+        command: "inspect media",
+        startedAt,
+        dryRun: true,
+        data: {
+          params: {
+            source,
+            prompt: prompt3,
+            model: options.model,
+            fps: options.fps,
+            start: options.start,
+            end: options.end,
+            lowRes: options.lowRes ?? false
+          }
+        }
+      });
+      return;
+    }
     if (options.apiKey) {
       process.env.GOOGLE_API_KEY = options.apiKey;
     } else {
@@ -63344,7 +63387,7 @@ analyzeCommand.command("media").description("Analyze any media: images, videos,
         data.totalTokens = result.totalTokens;
       }
       outputSuccess({
-        command: "analyze media",
+        command: "inspect media",
         startedAt,
         data
       });
@@ -63369,10 +63412,29 @@ analyzeCommand.command("media").description("Analyze any media: images, videos,
     exitWithError(apiError(`Analysis failed: ${error.message}`));
   }
 });
-analyzeCommand.command("video").description("Analyze video using Gemini (summarize, Q&A, extract info)").argument("<source>", "Video file path or YouTube URL").argument("<prompt>", "Analysis prompt (e.g., 'Summarize this video')").option("-k, --api-key <key>", "Google API key (or set GOOGLE_API_KEY env)").option("-m, --model <model>", "Model: flash (default), flash-2.5, pro", "flash").option("--fps <number>", "Frames per second (default: 1, higher for action)").option("--start <seconds>", "Start offset in seconds (for clipping)").option("--end <seconds>", "End offset in seconds (for clipping)").option("--low-res", "Use low resolution mode (fewer tokens, longer videos)").option("-v, --verbose", "Show token usage").option("--fields <fields>", "Comma-separated fields to include in output (e.g., response,model)").action(async (source, prompt3, options) => {
+analyzeCommand.command("video").description("Analyze video using Gemini (summarize, Q&A, extract info)").argument("<source>", "Video file path or YouTube URL").argument("<prompt>", "Analysis prompt (e.g., 'Summarize this video')").option("-k, --api-key <key>", "Google API key (or set GOOGLE_API_KEY env)").option("-m, --model <model>", "Model: flash (default), flash-2.5, pro", "flash").option("--fps <number>", "Frames per second (default: 1, higher for action)").option("--start <seconds>", "Start offset in seconds (for clipping)").option("--end <seconds>", "End offset in seconds (for clipping)").option("--low-res", "Use low resolution mode (fewer tokens, longer videos)").option("--verbose", "Show token usage").option("--fields <fields>", "Comma-separated fields to include in output (e.g., response,model)").option("--dry-run", "Preview parameters without executing").action(async (source, prompt3, options) => {
   const startedAt = Date.now();
   try {
     rejectControlChars(prompt3);
+    if (options.dryRun) {
+      outputSuccess({
+        command: "inspect video",
+        startedAt,
+        dryRun: true,
+        data: {
+          params: {
+            source,
+            prompt: prompt3,
+            model: options.model,
+            fps: options.fps,
+            start: options.start,
+            end: options.end,
+            lowRes: options.lowRes ?? false
+          }
+        }
+      });
+      return;
+    }
     if (options.apiKey) {
       process.env.GOOGLE_API_KEY = options.apiKey;
     } else {
@@ -63402,7 +63464,7 @@ analyzeCommand.command("video").description("Analyze video using Gemini (summari
         data.totalTokens = result.totalTokens;
       }
       outputSuccess({
-        command: "analyze video",
+        command: "inspect video",
         startedAt,
         data
       });
@@ -63427,10 +63489,25 @@ analyzeCommand.command("video").description("Analyze video using Gemini (summari
   }
 });
 registerReviewCommand(analyzeCommand);
-analyzeCommand.command("suggest").description("Get AI edit suggestions using Gemini").argument("<project>", "Project file path").argument("<instruction>", "Natural language instruction").option("-k, --api-key <key>", "Google API key (or set GOOGLE_API_KEY env)").option("--apply", "Apply the first suggestion automatically").action(async (projectPath, instruction, options) => {
+analyzeCommand.command("suggest").description("Get AI edit suggestions using Gemini").argument("<project>", "Project file path").argument("<instruction>", "Natural language instruction").option("-k, --api-key <key>", "Google API key (or set GOOGLE_API_KEY env)").option("--apply", "Apply the first suggestion automatically").option("--dry-run", "Preview parameters without executing").action(async (projectPath, instruction, options) => {
   const startedAt = Date.now();
   try {
     rejectControlChars(instruction);
+    if (options.dryRun) {
+      outputSuccess({
+        command: "inspect suggest",
+        startedAt,
+        dryRun: true,
+        data: {
+          params: {
+            project: projectPath,
+            instruction,
+            apply: options.apply ?? false
+          }
+        }
+      });
+      return;
+    }
     const apiKey = await requireApiKey("GOOGLE_API_KEY", "Google", options.apiKey);
     const spinner2 = ora("Initializing Gemini...").start();
     const filePath = resolve32(process.cwd(), projectPath);
@@ -63445,7 +63522,7 @@ analyzeCommand.command("suggest").description("Get AI edit suggestions using Gem
     spinner2.succeed(source_default.green(`Found ${suggestions.length} suggestion(s)`));
     if (isJsonMode()) {
       outputSuccess({
-        command: "analyze suggest",
+        command: "inspect suggest",
         startedAt,
         data: {
           suggestions: suggestions.map((s) => ({ type: s.type, description: s.description, confidence: s.confidence, clipIds: s.clipIds, params: s.params }))
@@ -63496,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
 
@@ -63518,7 +63595,7 @@ API Keys:
 Run 'vibe schema audio.<command>' for structured parameter info.
 `
 );
-audioCommand.command("transcribe").description("Transcribe audio using Whisper").argument("<audio>", "Audio file path").option("-k, --api-key <key>", "OpenAI API key (or set OPENAI_API_KEY env)").option("-l, --language <lang>", "Language code (e.g., en, ko)").option("-o, --output <path>", "Output file path").option("-f, --format <format>", "Output format: json, srt, vtt (auto-detected from extension)").action(async (audioPath, options) => {
+audioCommand.command("transcribe").description("Transcribe audio using Whisper").argument("<audio>", "Audio file path").option("-k, --api-key <key>", "OpenAI API key (or set OPENAI_API_KEY env)").option("-l, --language <lang>", "Language code (e.g., en, ko)").option("-o, --output <path>", "Output file path").option("--format <format>", "Output format: json, srt, vtt (auto-detected from extension)").action(async (audioPath, options) => {
   const startedAt = Date.now();
   try {
     if (options.output) {
@@ -63656,7 +63733,7 @@ audioCommand.command("isolate").description("Isolate vocals from audio using Ele
     exitWithError(apiError(`Audio isolation failed: ${msg}`, true));
   }
 });
-audioCommand.command("clone-voice").description("Clone a voice from audio samples using ElevenLabs").argument("[samples...]", "Audio sample files (1-25 files)").option("-k, --api-key <key>", "ElevenLabs API key (or set ELEVENLABS_API_KEY env)").option("-n, --name <name>", "Voice name (required)").option("-d, --description <desc>", "Voice description").option("--labels <json>", `Labels as JSON (e.g., '{"accent": "american"}')`).option("--remove-noise", "Remove background noise from samples").option("--list", "List all available voices").option("--dry-run", "Preview parameters without executing").action(async (samples, options) => {
+audioCommand.command("clone-voice").description("Clone a voice from audio samples using ElevenLabs").argument("[samples...]", "Audio sample files (1-25 files)").option("-k, --api-key <key>", "ElevenLabs API key (or set ELEVENLABS_API_KEY env)").option("--name <name>", "Voice name (required)").option("-d, --description <desc>", "Voice description").option("--labels <json>", `Labels as JSON (e.g., '{"accent": "american"}')`).option("--remove-noise", "Remove background noise from samples").option("--list", "List all available voices").option("--dry-run", "Preview parameters without executing").action(async (samples, options) => {
   const startedAt = Date.now();
   try {
     if (options.dryRun) {
@@ -63700,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));
       }
@@ -63742,7 +63819,7 @@ audioCommand.command("clone-voice").description("Clone a voice from audio sample
     exitWithError(apiError(`Voice cloning failed: ${msg}`, true));
   }
 });
-audioCommand.command("dub").description("Dub audio/video to another language (transcribe, translate, TTS)").argument("<media>", "Input media file (video or audio)").option("-l, --language <lang>", "Target language code (e.g., es, ko, ja) (required)").option("--source <lang>", "Source language code (default: auto-detect)").option("-v, --voice <id>", "ElevenLabs voice ID for output").option("--analyze-only", "Only analyze and show timing, don't generate audio").option("-o, --output <path>", "Output file path").option("--dry-run", "Preview parameters without executing").action(async (mediaPath, options) => {
+audioCommand.command("dub").description("Dub audio/video to another language (transcribe, translate, TTS)").argument("<media>", "Input media file (video or audio)").option("-l, --language <lang>", "Target language code (e.g., es, ko, ja) (required)").option("--source <lang>", "Source language code (default: auto-detect)").option("--voice <id>", "ElevenLabs voice ID for output").option("--analyze-only", "Only analyze and show timing, don't generate audio").option("-o, --output <path>", "Output file path").option("--dry-run", "Preview parameters without executing").action(async (mediaPath, options) => {
   const startedAt = Date.now();
   try {
     if (options.dryRun) {
@@ -63761,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");
@@ -63938,7 +64015,7 @@ ${segmentTexts}`,
     exitWithError(apiError(`Dubbing failed: ${msg}`, true));
   }
 });
-audioCommand.command("duck").description("Auto-duck background music when voice is present (FFmpeg)").argument("<music>", "Background music file path").option("-v, --voice <path>", "Voice/narration track (required)").option("-o, --output <path>", "Output audio file path").option("-t, --threshold <dB>", "Sidechain threshold in dB", "-30").option("-r, --ratio <ratio>", "Compression ratio", "3").option("-a, --attack <ms>", "Attack time in ms", "20").option("-l, --release <ms>", "Release time in ms", "200").option("--dry-run", "Preview parameters without executing").action(async (musicPath, options) => {
+audioCommand.command("duck").description("Auto-duck background music when voice is present (FFmpeg)").argument("<music>", "Background music file path").option("--voice <path>", "Voice/narration track (required)").option("-o, --output <path>", "Output audio file path").option("--threshold <dB>", "Sidechain threshold in dB", "-30").option("-r, --ratio <ratio>", "Compression ratio", "3").option("-a, --attack <ms>", "Attack time in ms", "20").option("-l, --release <ms>", "Release time in ms", "200").option("--dry-run", "Preview parameters without executing").action(async (musicPath, options) => {
   const startedAt = Date.now();
   try {
     if (options.dryRun) {
@@ -64004,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();
@@ -64015,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("-g, --generator <engine>", "Video generator: grok | kling | runway | veo", "grok").option("-i, --image-provider <provider>", "Image provider: gemini | openai | grok", "gemini").option("-v, --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) => {
+  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}`));
@@ -64125,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");
@@ -64139,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;
@@ -64203,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)
@@ -64225,13 +64302,13 @@ Run 'vibe schema remix.<command>' for structured parameter info.
 registerScriptPipelineCommands(pipelineCommand);
 registerHighlightsCommands(pipelineCommand);
 var ANIMATED_CAPTION_STYLES = ["highlight", "bounce", "pop-in", "neon", "karaoke-sweep", "typewriter"];
-pipelineCommand.command("animated-caption").description("Add animated captions with word-by-word effects (Whisper + Remotion/ASS)").argument("<video>", "Video file path").option("-s, --style <preset>", "Style preset (default: highlight)", "highlight").option("--highlight-color <color>", "Active word highlight color", "#FFFF00").option("--font-size <px>", "Font size (default: auto based on resolution)").option("--position <pos>", "Caption position: top, center, bottom", "bottom").option("--words-per-group <n>", "Words shown at once (default: auto 3-5)").option("--max-chars <n>", "Max characters per group").option("-l, --language <lang>", "Whisper language hint").option("--fast", "Use ASS/FFmpeg only (no Remotion, forces ASS tier styles)").option("-o, --output <path>", "Output file path").option("--dry-run", "Preview parameters without executing").addHelpText(
+pipelineCommand.command("animated-caption").description("Add animated captions with word-by-word effects (Whisper + Remotion/ASS)").argument("<video>", "Video file path").option("--style <preset>", "Style preset (default: highlight)", "highlight").option("--highlight-color <color>", "Active word highlight color", "#FFFF00").option("--font-size <px>", "Font size (default: auto based on resolution)").option("--position <pos>", "Caption position: top, center, bottom", "bottom").option("--words-per-group <n>", "Words shown at once (default: auto 3-5)").option("--max-chars <n>", "Max characters per group").option("-l, --language <lang>", "Whisper language hint").option("--fast", "Use ASS/FFmpeg only (no Remotion, forces ASS tier styles)").option("-o, --output <path>", "Output file path").option("--dry-run", "Preview parameters without executing").addHelpText(
   "after",
   `
 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)
@@ -64247,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)) {
@@ -68747,7 +68824,7 @@ batchCommand.command("concat").description("Concatenate multiple sources into se
     exitWithError(generalError(`Concat failed: ${msg}`));
   }
 });
-batchCommand.command("apply-effect").description("Apply an effect to multiple clips").argument("<project>", "Project file path").argument("<effect-type>", "Effect type (fadeIn, fadeOut, blur, etc.)").argument("[clip-ids...]", "Clip IDs to apply effect to (or --all)").option("--all", "Apply to all clips", false).option("-d, --duration <seconds>", "Effect duration", "1").option("-s, --start <seconds>", "Effect start time (relative to clip)", "0").option("--intensity <value>", "Effect intensity (0-1)", "1").option("--dry-run", "Preview parameters without executing").action(
+batchCommand.command("apply-effect").description("Apply an effect to multiple clips").argument("<project>", "Project file path").argument("<effect-type>", "Effect type (fadeIn, fadeOut, blur, etc.)").argument("[clip-ids...]", "Clip IDs to apply effect to (or --all)").option("--all", "Apply to all clips", false).option("-d, --duration <seconds>", "Effect duration", "1").option("--start <seconds>", "Effect start time (relative to clip)", "0").option("--intensity <value>", "Effect intensity (0-1)", "1").option("--dry-run", "Preview parameters without executing").action(
   async (projectPath, effectType, clipIds, options) => {
     const startedAt = Date.now();
     const spinner2 = ora("Applying effects...").start();
@@ -69348,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";
 
@@ -69639,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 {
@@ -69885,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)" };
   }
@@ -69898,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" };
@@ -70241,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 = [
@@ -70355,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 = [
@@ -70368,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);
     }
@@ -70399,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();
@@ -70414,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 },
@@ -70581,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) {
@@ -70612,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", [
@@ -70638,7 +70715,7 @@ async function generateTestVideo(outputPath) {
         "-y",
         outputPath
       ], { timeout: 3e4, maxBuffer: 50 * 1024 * 1024 });
-      return existsSync35(outputPath);
+      return existsSync36(outputPath);
     } catch {
       return false;
     }