@vibeframe/cli 0.80.1 → 0.81.0

package/dist/index.js

@@ -14372,7 +14372,11 @@ var init_api_keys = __esm({
       showInSetup: true,
       setupDescription: "Seedance 2.0 video gen ($$, default since v0.57)",
       envExampleComment: "fal.ai API Key (Seedance 2.0 video \u2014 default text/image-to-video since v0.57, Artificial Analysis ELO #2)",
-      envExampleUrl: "https://fal.ai/dashboard/keys"
+      envExampleUrl: "https://fal.ai/dashboard/keys",
+      // fal keys are `<key-id>:<key-secret>` (both UUIDs). The colon is the
+      // structural marker — same approach as Kling. Don't pin the UUID shape
+      // since fal could rotate to a different secret format.
+      keyFormat: { prefix: /:/, example: "<key-id>:<key-secret>" }
     });
     defineApiKey({
       configKey: "xai",
@@ -14433,6 +14437,10 @@ var init_api_keys = __esm({
       // not prompted in setup wizard — internal upload host
       envExampleComment: "ImgBB API Key (image hosting \u2014 used by Kling and Seedance for image-to-video uploads)",
       envExampleUrl: "https://api.imgbb.com/",
+      // ImgBB issues 32-character lowercase hex keys. Soft-warn if a pasted
+      // key doesn't match — covers the common "I copied my Kling key by
+      // mistake" failure mode.
+      keyFormat: { prefix: /^[a-f0-9]{32}$/, example: "32-char hex" },
       // ImgBB has no provider class (envvar-only); doctor still shows what it
       // unlocks at the apiKey level.
       commandsUnlocked: [
@@ -17264,18 +17272,18 @@ ${transcriptWithTimestamps}`
     return emptyViralAnalysis("Analysis failed");
   }
 }
-async function suggestPlatformCuts(api, transcriptSegments, viralAnalysis, platform2, clips) {
-  const emptyResult = { platform: platform2.id, segments: [], totalDuration: 0 };
+async function suggestPlatformCuts(api, transcriptSegments, viralAnalysis, platform3, clips) {
+  const emptyResult = { platform: platform3.id, segments: [], totalDuration: 0 };
   const transcriptWithTimestamps = transcriptSegments.map((seg) => `[${seg.startTime.toFixed(1)}s - ${seg.endTime.toFixed(1)}s] ${seg.text}`).join("\n");
   const clipsInfo = clips.map((c) => `[${c.id}] ${c.startTime.toFixed(1)}s - ${(c.startTime + c.duration).toFixed(1)}s (${c.duration.toFixed(1)}s)`).join("\n");
-  const systemPrompt = `You are an expert video editor optimizing content for ${platform2.name}.
+  const systemPrompt = `You are an expert video editor optimizing content for ${platform3.name}.
 
 Platform requirements:
-- Aspect ratio: ${platform2.aspectRatio}
-- Maximum duration: ${platform2.maxDuration}s
-- Ideal duration: ${platform2.idealDuration.min}-${platform2.idealDuration.max}s
-- Needs strong hook: ${platform2.features.hook ? "Yes" : "No"}
-- Needs captions: ${platform2.features.captions ? "Yes" : "No"}
+- Aspect ratio: ${platform3.aspectRatio}
+- Maximum duration: ${platform3.maxDuration}s
+- Ideal duration: ${platform3.idealDuration.min}-${platform3.idealDuration.max}s
+- Needs strong hook: ${platform3.features.hook ? "Yes" : "No"}
+- Needs captions: ${platform3.features.captions ? "Yes" : "No"}
 
 Previous analysis found:
 - Hook strength: ${viralAnalysis.hookStrength}%
@@ -17291,7 +17299,7 @@ Your task:
 
 Respond with JSON only:
 {
-  "platform": "${platform2.id}",
+  "platform": "${platform3.id}",
   "segments": [
     {"sourceClipId": "clip-id", "startTime": 0, "endTime": 45.5, "priority": 1.0}
   ],
@@ -17302,7 +17310,7 @@ Respond with JSON only:
       system: systemPrompt,
       messages: [{
         role: "user",
-        content: `Optimize this video for ${platform2.name}:
+        content: `Optimize this video for ${platform3.name}:
 
 ## Transcript:
 ${transcriptWithTimestamps}
@@ -17998,10 +18006,10 @@ Instruction: ${instruction}`
         }
         return analyzeViralPotential(this.api, transcriptSegments, projectMeta, targetPlatforms);
       }
-      async suggestPlatformCuts(transcriptSegments, viralAnalysis, platform2, clips) {
+      async suggestPlatformCuts(transcriptSegments, viralAnalysis, platform3, clips) {
         if (!this.api)
-          return { platform: platform2.id, segments: [], totalDuration: 0 };
-        return suggestPlatformCuts(this.api, transcriptSegments, viralAnalysis, platform2, clips);
+          return { platform: platform3.id, segments: [], totalDuration: 0 };
+        return suggestPlatformCuts(this.api, transcriptSegments, viralAnalysis, platform3, clips);
       }
       async generateViralCaptions(transcriptSegments, style) {
         if (!this.api)
@@ -33626,7 +33634,7 @@ Examples:
           }
         }
       } else if (provider === "runway") {
-        const { spawn: spawn3 } = await import("child_process");
+        const { spawn: spawn4 } = await import("child_process");
         const __filename2 = fileURLToPath(import.meta.url);
         const __dirname2 = dirname7(__filename2);
         const scriptPath = resolve23(
@@ -33641,7 +33649,7 @@ Examples:
         const args = [scriptPath, prompt3, "-o", outputPath, "-r", options.ratio || "16:9"];
         spinner2.text = "Generating image with Runway (gemini_2.5_flash)...";
         await new Promise((resolvePromise, reject) => {
-          const proc = spawn3("python3", args, {
+          const proc = spawn4("python3", args, {
             env: { ...process.env, RUNWAY_API_SECRET: apiKey },
             stdio: ["ignore", "pipe", "pipe"]
           });
@@ -37001,8 +37009,8 @@ var init_translate_srt = __esm({
 import { existsSync as existsSync21 } from "node:fs";
 import { resolve as resolve27 } from "node:path";
 function detectSystemFont() {
-  const platform2 = process.platform;
-  if (platform2 === "darwin") {
+  const platform3 = process.platform;
+  if (platform3 === "darwin") {
     const candidates = [
       "/System/Library/Fonts/Helvetica.ttc",
       "/System/Library/Fonts/HelveticaNeue.ttc",
@@ -37011,7 +37019,7 @@ function detectSystemFont() {
     for (const f of candidates) {
       if (existsSync21(f)) return f;
     }
-  } else if (platform2 === "linux") {
+  } else if (platform3 === "linux") {
     const candidates = [
       "/usr/share/fonts/truetype/dejavu/DejaVuSans-Bold.ttf",
       "/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf",
@@ -37020,7 +37028,7 @@ function detectSystemFont() {
     for (const f of candidates) {
       if (existsSync21(f)) return f;
     }
-  } else if (platform2 === "win32") {
+  } else if (platform3 === "win32") {
     const candidates = [
       "C:\\Windows\\Fonts\\arial.ttf",
       "C:\\Windows\\Fonts\\segoeui.ttf"
@@ -37071,11 +37079,11 @@ async function applyTextOverlays(options) {
     } = await Promise.resolve().then(() => (init_remotion(), remotion_exports));
     const remotionErr = await ensureRemotionInstalled2();
     if (remotionErr) {
-      const platform2 = process.platform;
+      const platform3 = process.platform;
       let hint = "";
-      if (platform2 === "darwin") {
+      if (platform3 === "darwin") {
         hint = "\n\nFix: brew uninstall ffmpeg && brew install ffmpeg\n(The default homebrew formula includes libfreetype)";
-      } else if (platform2 === "linux") {
+      } else if (platform3 === "linux") {
         hint = "\n\nFix: sudo apt install ffmpeg (Ubuntu/Debian)\n     or rebuild FFmpeg with --enable-libfreetype";
       }
       return {
@@ -51991,6 +51999,126 @@ var init_scene_build = __esm({
   }
 });
 
+// src/utils/key-live-test.ts
+var key_live_test_exports = {};
+__export(key_live_test_exports, {
+  isTestableProvider: () => isTestableProvider,
+  testKey: () => testKey
+});
+async function getOk(url, headers, signal) {
+  try {
+    const res = await fetch(url, { method: "GET", headers, signal });
+    if (res.ok) return { ok: true, status: res.status };
+    return {
+      ok: false,
+      status: res.status,
+      message: `${res.status} ${res.statusText || ""}`.trim()
+    };
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    return { ok: false, message: msg };
+  }
+}
+async function testKey(configKey, key, timeoutMs = DEFAULT_TIMEOUT_MS) {
+  const tester = TESTERS[configKey];
+  if (!tester) {
+    return { ok: false, skipped: true, message: "no tester registered" };
+  }
+  const ctrl = new AbortController();
+  const timer = setTimeout(() => ctrl.abort(), timeoutMs);
+  try {
+    return await tester.test(key, ctrl.signal);
+  } finally {
+    clearTimeout(timer);
+  }
+}
+function isTestableProvider(configKey) {
+  const t = TESTERS[configKey];
+  if (!t) return false;
+  return true;
+}
+var DEFAULT_TIMEOUT_MS, TESTERS;
+var init_key_live_test = __esm({
+  "src/utils/key-live-test.ts"() {
+    "use strict";
+    DEFAULT_TIMEOUT_MS = 5e3;
+    TESTERS = {
+      anthropic: {
+        name: "Anthropic",
+        test: (key, signal) => getOk(
+          "https://api.anthropic.com/v1/models",
+          { "x-api-key": key, "anthropic-version": "2023-06-01" },
+          signal
+        )
+      },
+      openai: {
+        name: "OpenAI",
+        test: (key, signal) => getOk(
+          "https://api.openai.com/v1/models",
+          { Authorization: `Bearer ${key}` },
+          signal
+        )
+      },
+      google: {
+        name: "Google",
+        test: (key, signal) => getOk(
+          `https://generativelanguage.googleapis.com/v1beta/models?key=${encodeURIComponent(key)}`,
+          {},
+          signal
+        )
+      },
+      xai: {
+        name: "xAI",
+        test: (key, signal) => getOk(
+          "https://api.x.ai/v1/models",
+          { Authorization: `Bearer ${key}` },
+          signal
+        )
+      },
+      elevenlabs: {
+        name: "ElevenLabs",
+        test: (key, signal) => getOk("https://api.elevenlabs.io/v1/user", { "xi-api-key": key }, signal)
+      },
+      replicate: {
+        name: "Replicate",
+        test: (key, signal) => getOk(
+          "https://api.replicate.com/v1/account",
+          { Authorization: `Bearer ${key}` },
+          signal
+        )
+      },
+      openrouter: {
+        name: "OpenRouter",
+        test: (key, signal) => getOk(
+          "https://openrouter.ai/api/v1/models",
+          { Authorization: `Bearer ${key}` },
+          signal
+        )
+      },
+      // The four below have no cheap authenticated GET — providing a tester
+      // would either consume a paid API call (fal, Runway), require HMAC
+      // signing per request (Kling), or burn an image upload (ImgBB). We
+      // surface them as `skipped` so the user knows we didn't blank-check.
+      fal: {
+        name: "fal.ai",
+        test: async () => ({ ok: false, skipped: true, message: "no list endpoint" })
+      },
+      kling: {
+        name: "Kling",
+        test: async () => ({ ok: false, skipped: true, message: "HMAC-signed; can't test cheaply" })
+      },
+      runway: {
+        name: "Runway",
+        test: async () => ({ ok: false, skipped: true, message: "POST-only API" })
+      },
+      imgbb: {
+        name: "ImgBB",
+        test: async () => ({ ok: false, skipped: true, message: "would consume an upload" })
+      }
+    };
+  }
+});
+
 // src/pipeline/resolver.ts
 function resolveStepParams(params, completedSteps) {
   const resolved = {};
@@ -58996,10 +59124,10 @@ var init_ai_suggest_edit = __esm({
   }
 });
 
-// src/tools/manifest/analyze.ts
-var analyzeMediaTool, analyzeVideoTool, analyzeReviewTool, analyzeSuggestTool, analyzeTools;
-var init_analyze = __esm({
-  "src/tools/manifest/analyze.ts"() {
+// src/tools/manifest/inspect.ts
+var analyzeMediaTool, analyzeVideoTool, analyzeReviewTool, analyzeSuggestTool, inspectTools;
+var init_inspect = __esm({
+  "src/tools/manifest/inspect.ts"() {
     "use strict";
     init_zod();
     init_define_tool();
@@ -59122,7 +59250,7 @@ var init_analyze = __esm({
         };
       }
     });
-    analyzeTools = [
+    inspectTools = [
       analyzeMediaTool,
       analyzeVideoTool,
       analyzeReviewTool,
@@ -59458,13 +59586,13 @@ var init_generate2 = __esm({
   }
 });
 
-// src/tools/manifest/pipeline.ts
+// src/tools/manifest/remix.ts
 import { writeFile as writeFile43 } from "node:fs/promises";
 import { tmpdir as tmpdir3 } from "node:os";
 import { join as join13 } from "node:path";
-var pipelineHighlightsTool, pipelineAutoShortsTool, pipelineRunTool, pipelineRegenerateSceneTool, pipelineTools;
-var init_pipeline2 = __esm({
-  "src/tools/manifest/pipeline.ts"() {
+var pipelineHighlightsTool, pipelineAutoShortsTool, pipelineRunTool, pipelineRegenerateSceneTool, remixTools;
+var init_remix = __esm({
+  "src/tools/manifest/remix.ts"() {
     "use strict";
     init_zod();
     init_define_tool();
@@ -59647,7 +59775,7 @@ var init_pipeline2 = __esm({
         };
       }
     });
-    pipelineTools = [
+    remixTools = [
       pipelineHighlightsTool,
       pipelineAutoShortsTool,
       pipelineRunTool,
@@ -60471,7 +60599,7 @@ var init_hyperframes = __esm({
 // src/commands/export.ts
 import { readFile as readFile40, access as access8 } from "node:fs/promises";
 import { resolve as resolve61, basename as basename21 } from "node:path";
-import { spawn as spawn2 } from "node:child_process";
+import { spawn as spawn3 } from "node:child_process";
 function timelineBaseName(path2) {
   const name = basename21(path2);
   if (name.endsWith(".vibe.json")) return name.slice(0, -".vibe.json".length);
@@ -60945,7 +61073,7 @@ function buildFFmpegArgs(clips, sources, presetSettings, outputPath, options, so
 }
 function runFFmpegProcess(ffmpegPath, args, onProgress) {
   return new Promise((resolve64, reject) => {
-    const ffmpeg = spawn2(ffmpegPath, args, {
+    const ffmpeg = spawn3(ffmpegPath, args, {
       stdio: ["pipe", "pipe", "pipe"]
     });
     let duration = 0;
@@ -62278,15 +62406,15 @@ var init_walkthrough = __esm({
 var manifest_exports = {};
 __export(manifest_exports, {
   agentOnlyTools: () => agentOnlyTools,
-  analyzeTools: () => analyzeTools,
   audioTools: () => audioTools,
   detectTools: () => detectTools,
   editTools: () => editTools,
   exportTools: () => exportTools,
   generateTools: () => generateTools,
+  inspectTools: () => inspectTools,
   manifest: () => manifest,
-  pipelineTools: () => pipelineTools,
   projectTools: () => projectTools,
+  remixTools: () => remixTools,
   sceneTools: () => sceneTools,
   timelineTools: () => timelineTools,
   walkthroughTools: () => walkthroughTools
@@ -62298,9 +62426,9 @@ var init_manifest = __esm({
     init_scene2();
     init_audio2();
     init_edit();
-    init_analyze();
+    init_inspect();
     init_generate2();
-    init_pipeline2();
+    init_remix();
     init_detect2();
     init_timeline();
     init_project2();
@@ -62311,9 +62439,9 @@ var init_manifest = __esm({
       ...sceneTools,
       ...audioTools,
       ...editTools,
-      ...analyzeTools,
+      ...inspectTools,
       ...generateTools,
-      ...pipelineTools,
+      ...remixTools,
       ...detectTools,
       ...timelineTools,
       ...projectTools,
@@ -62523,7 +62651,7 @@ init_source();
 // package.json
 var package_default = {
   name: "@vibeframe/cli",
-  version: "0.80.1",
+  version: "0.81.0",
   description: "VibeFrame CLI - natural language video editing from the terminal",
   private: false,
   license: "MIT",
@@ -63678,7 +63806,7 @@ function detectMediaType(path2) {
 init_generate();
 init_edit_cmd();
 
-// src/commands/analyze.ts
+// src/commands/inspect.ts
 init_esm();
 init_source();
 init_ora();
@@ -63693,7 +63821,7 @@ init_sanitize();
 init_validate();
 import { readFile as readFile23, writeFile as writeFile30 } from "node:fs/promises";
 import { resolve as resolve33 } from "node:path";
-var analyzeCommand = new Command("inspect").description("Inspect media using AI (images, videos, YouTube URLs)").addHelpText(
+var inspectCommand = new Command("inspect").description("Inspect media using AI (images, videos, YouTube URLs)").addHelpText(
   "after",
   `
 Examples:
@@ -63711,7 +63839,7 @@ 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("--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) => {
+inspectCommand.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);
@@ -63788,7 +63916,7 @@ 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("--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) => {
+inspectCommand.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);
@@ -63864,8 +63992,8 @@ analyzeCommand.command("video").description("Analyze video using Gemini (summari
     exitWithError(apiError(`Video analysis failed: ${error.message}`));
   }
 });
-registerReviewCommand(analyzeCommand);
-analyzeCommand.command("suggest").description("Get AI edit suggestions using Gemini").argument("<project>", "Timeline file or directory").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) => {
+registerReviewCommand(inspectCommand);
+inspectCommand.command("suggest").description("Get AI edit suggestions using Gemini").argument("<project>", "Timeline file or directory").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);
@@ -64452,7 +64580,7 @@ audioCommand.command("duck").description("Auto-duck background music when voice
   }
 });
 
-// src/commands/pipeline.ts
+// src/commands/remix.ts
 init_esm();
 init_source();
 init_ora();
@@ -64637,11 +64765,11 @@ function registerScriptPipelineCommands(aiCommand) {
   });
 }
 
-// src/commands/pipeline.ts
+// src/commands/remix.ts
 init_ai_highlights();
 init_ai_animated_caption();
 init_output();
-var pipelineCommand = new Command("remix").description(
+var remixCommand = new Command("remix").description(
   "Transform existing media (highlights, auto-shorts, animated captions, regenerate-scene)"
 ).addHelpText(
   "after",
@@ -64675,10 +64803,10 @@ Use '--dry-run' to preview parameters before execution.
 Run 'vibe schema remix.<command>' for structured parameter info.
 `
 );
-registerScriptPipelineCommands(pipelineCommand);
-registerHighlightsCommands(pipelineCommand);
+registerScriptPipelineCommands(remixCommand);
+registerHighlightsCommands(remixCommand);
 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("--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(
+remixCommand.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:
@@ -69397,6 +69525,50 @@ function validateKeyFormat(configKey, value) {
   return { ok: false, expected: fmt.example };
 }
 
+// src/utils/clipboard.ts
+import { spawn as spawn2 } from "node:child_process";
+import { platform as platform2 } from "node:os";
+function resolveCopier() {
+  switch (platform2()) {
+    case "darwin":
+      return { command: "pbcopy", args: [] };
+    case "win32":
+      return { command: "clip", args: [] };
+    case "linux":
+    case "freebsd":
+    case "openbsd":
+      if (process.env.WAYLAND_DISPLAY) {
+        return { command: "wl-copy", args: [] };
+      }
+      return { command: "xclip", args: ["-selection", "clipboard"] };
+    default:
+      return null;
+  }
+}
+async function copyToClipboard(text) {
+  const opener = resolveCopier();
+  if (!opener) return false;
+  return new Promise((resolve64) => {
+    let settled = false;
+    const finish = (ok) => {
+      if (settled) return;
+      settled = true;
+      resolve64(ok);
+    };
+    try {
+      const child = spawn2(opener.command, opener.args, {
+        stdio: ["pipe", "ignore", "ignore"],
+        shell: false
+      });
+      child.on("error", () => finish(false));
+      child.on("close", (code) => finish(code === 0));
+      child.stdin.end(text, "utf8");
+    } catch {
+      finish(false);
+    }
+  });
+}
+
 // src/commands/setup.ts
 init_agent_host_detect();
 init_dist2();
@@ -69409,7 +69581,7 @@ var VALID_LLM_PROVIDERS = [
   "xai",
   "openrouter"
 ];
-var setupCommand = new Command("setup").description("Configure VibeFrame (LLM provider, API keys)").option("--reset", "Reset configuration to defaults").option("--full", "Run full setup with all optional providers").option("--show", "Show current configuration (for debugging)").option("--claude-code", "Show Claude Code integration guide").option("-y, --yes", "Non-interactive: write config without prompting (CI / devcontainer)").option("--provider <id>", "Set the Agent LLM provider (claude | openai | gemini | xai | openrouter | ollama)").option("--import-env", "Promote API keys from .env / shell env into config.yaml").addHelpText(
+var setupCommand = new Command("setup").description("Configure VibeFrame (LLM provider, API keys)").option("--reset", "Reset configuration to defaults").option("--full", "Run full setup with all optional providers").option("--show", "Show current configuration (for debugging)").option("-v, --verbose", "With --show: include unset providers + Resolution order + Defaults block").option("--claude-code", "Show Claude Code integration guide").option("-y, --yes", "Non-interactive: write config without prompting (CI / devcontainer)").option("--provider <id>", "Set the Agent LLM provider (claude | openai | gemini | xai | openrouter | ollama)").option("--import-env", "Promote API keys from .env / shell env into config.yaml").addHelpText(
   "after",
   `
 Non-interactive examples (no TTY required):
@@ -69423,7 +69595,7 @@ Non-interactive examples (no TTY required):
     return;
   }
   if (options.show) {
-    await showConfig();
+    await showConfig({ verbose: Boolean(options.verbose) });
     return;
   }
   if (options.reset) {
@@ -69574,7 +69746,7 @@ async function runSetupWizard(fullSetup = false) {
   console.log();
   if (topIndex === 0) {
     await saveConfig(config2);
-    showComplete(config2, "vibe edit silence-cut video.mp4 -o clean.mp4");
+    await showComplete(config2, "vibe edit silence-cut video.mp4 -o clean.mp4");
     return;
   }
   if (topIndex === 3) {
@@ -69595,7 +69767,7 @@ async function runSetupWizard(fullSetup = false) {
     console.log();
     await collectKeys(config2, pipelineKeys);
     await saveConfig(config2);
-    showComplete(config2, "vibe build my-story/   # see CONTRIBUTING.md for STORYBOARD.md format");
+    await showComplete(config2, "vibe build my-story/   # see CONTRIBUTING.md for STORYBOARD.md format");
     return;
   }
   console.log(source_default.dim("2. Features"));
@@ -69617,7 +69789,7 @@ async function runSetupWizard(fullSetup = false) {
     console.log(source_default.dim("  No features selected. You can re-run setup anytime."));
     console.log();
     await saveConfig(config2);
-    showComplete(config2, "vibe --help", []);
+    await showComplete(config2, "vibe --help", []);
     return;
   }
   console.log(source_default.dim("3. API keys"));
@@ -69670,7 +69842,7 @@ async function runSetupWizard(fullSetup = false) {
     console.log();
   }
   await saveConfig(config2);
-  showComplete(config2, selectedFeatures[0].tryCommand, selectedFeatures);
+  await showComplete(config2, selectedFeatures[0].tryCommand, selectedFeatures);
 }
 async function collectKeys(config2, keys) {
   loadEnv();
@@ -69777,14 +69949,15 @@ async function runCustomSetup(config2) {
   }
   console.log();
   await saveConfig(config2);
-  showComplete(config2, "vibe doctor");
+  await showComplete(config2, "vibe doctor");
 }
-function showComplete(config2, defaultTryCommand, features = []) {
+async function showComplete(config2, defaultTryCommand, features = []) {
   console.log(source_default.dim("\u2500".repeat(40)));
   console.log(source_default.green.bold("\u2713 Setup complete!"));
   console.log();
   console.log(source_default.dim(`  Config: ${CONFIG_PATH}`));
   console.log();
+  const primaryTry = features.length > 1 ? features[0].tryCommand : defaultTryCommand;
   if (features.length > 1) {
     console.log(source_default.bold("  Try these:"));
     for (const f of features) {
@@ -69793,6 +69966,12 @@ function showComplete(config2, defaultTryCommand, features = []) {
   } else {
     console.log(`  Try: ${source_default.cyan(defaultTryCommand)}`);
   }
+  if (process.stdout.isTTY) {
+    const copied = await copyToClipboard(primaryTry);
+    if (copied) {
+      console.log(source_default.dim("    \u2713 Copied to clipboard"));
+    }
+  }
   console.log();
   console.log(source_default.bold("  Next steps:"));
   console.log(source_default.dim("    cd <project>; vibe init   Scaffold AGENTS.md / CLAUDE.md / .env.example (project scope)"));
@@ -69849,7 +70028,8 @@ function maskApiKey(key) {
   if (key.length <= 8) return "****";
   return `${key.slice(0, 4)}${"*".repeat(8)}${key.slice(-4)}`;
 }
-async function showConfig() {
+async function showConfig(opts = { verbose: false }) {
+  const { verbose } = opts;
   loadEnv();
   const cwdEnvPath = resolve42(process.cwd(), ".env");
   let hasCwdEnv = false;
@@ -69900,6 +70080,7 @@ async function showConfig() {
     { key: "replicate", name: "Replicate", env: "REPLICATE_API_TOKEN" },
     { key: "openrouter", name: "OpenRouter", env: "OPENROUTER_API_KEY" }
   ];
+  let unsetCount = 0;
   for (const p of providerKeys) {
     const configValue = config2?.providers[p.key];
     const dotenvValue = dotenvKeys[p.env];
@@ -69911,23 +70092,31 @@ async function showConfig() {
       const status = source_default.green("\u2713");
       console.log(`  ${status} ${p.name.padEnd(12)} ${maskApiKey(value)} (${sources.join(" + ")})`);
     } else {
-      const status = source_default.dim("\u25CB");
-      console.log(`  ${status} ${p.name.padEnd(12)} ${source_default.dim("not set")}`);
+      unsetCount++;
+      if (verbose) {
+        const status = source_default.dim("\u25CB");
+        console.log(`  ${status} ${p.name.padEnd(12)} ${source_default.dim("not set")}`);
+      }
     }
   }
+  if (!verbose && unsetCount > 0) {
+    console.log(source_default.dim(`  (${unsetCount} provider${unsetCount === 1 ? "" : "s"} unset \u2014 run with --verbose to list)`));
+  }
   console.log();
-  if (config2) {
-    console.log(source_default.bold("Defaults:"));
-    console.log(`  Aspect Ratio: ${config2.defaults.aspectRatio}`);
-    console.log(`  Export Quality: ${config2.defaults.exportQuality}`);
+  if (verbose) {
+    if (config2) {
+      console.log(source_default.bold("Defaults:"));
+      console.log(`  Aspect Ratio: ${config2.defaults.aspectRatio}`);
+      console.log(`  Export Quality: ${config2.defaults.exportQuality}`);
+      console.log();
+    }
+    console.log(source_default.bold("Resolution order:"));
+    console.log(source_default.dim("  1. --api-key CLI option"));
+    console.log(source_default.dim(`  2. ${CONFIG_PATH}`));
+    console.log(source_default.dim("  3. .env in current directory"));
+    console.log(source_default.dim("  4. Shell environment variables"));
     console.log();
   }
-  console.log(source_default.bold("Resolution order:"));
-  console.log(source_default.dim("  1. --api-key CLI option"));
-  console.log(source_default.dim(`  2. ${CONFIG_PATH}`));
-  console.log(source_default.dim("  3. .env in current directory"));
-  console.log(source_default.dim("  4. Shell environment variables"));
-  console.log();
 }
 
 // src/commands/init.ts
@@ -70846,11 +71035,13 @@ var FREE_COMMANDS = [
   "timeline (all)",
   "batch import/concat"
 ];
-var doctorCommand = new Command("doctor").description("Check system health and available commands").option("--json", "Output in JSON format").addHelpText(
+var doctorCommand = new Command("doctor").description("Check system health and available commands").option("--json", "Output in JSON format").option("-v, --verbose", "Show full report (every provider row, scene composer block, free-command list)").option("--test-keys", "Make a lightweight authenticated request to each provider (validates configured keys; skips providers without a cheap test endpoint)").addHelpText(
   "after",
   `
 Examples:
-  $ vibe doctor              Show system health and capabilities
+  $ vibe doctor              Compact health summary (issues + Ready %)
+  $ vibe doctor --verbose    Full report \u2014 all providers, composer, free commands
+  $ vibe doctor --test-keys  Validate each configured key against its provider
   $ vibe doctor --json       Machine-readable output
 `
 ).action(async (options) => {
@@ -70866,7 +71057,10 @@ Examples:
     });
     return;
   }
-  printReport(results);
+  printReport(results, { verbose: Boolean(options.verbose) });
+  if (options.testKeys) {
+    await runLiveKeyTests(results);
+  }
 });
 var REQUIRED_FFMPEG_FILTERS = {
   drawtext: {
@@ -70920,14 +71114,14 @@ async function runDiagnostics() {
     try {
       const filtersResult = await execSafe("ffmpeg", ["-filters"]);
       const filtersOutput = filtersResult.stdout;
-      const platform2 = process.platform;
+      const platform3 = process.platform;
       ffmpegFilters = {};
       for (const [filterName, info] of Object.entries(REQUIRED_FFMPEG_FILTERS)) {
         const available = filtersOutput.includes(filterName);
         ffmpegFilters[filterName] = {
           available,
           commands: info.commands,
-          ...!available && info.fix[platform2] ? { fix: info.fix[platform2] } : {}
+          ...!available && info.fix[platform3] ? { fix: info.fix[platform3] } : {}
         };
       }
     } catch {
@@ -71029,7 +71223,8 @@ async function runDiagnostics() {
     totalCount
   };
 }
-function printReport(results) {
+function printReport(results, opts = { verbose: false }) {
+  const { verbose } = opts;
   console.log();
   console.log(source_default.bold("  System"));
   const nodeIcon = results.system.node.ok ? source_default.green("OK") : source_default.red("MISSING");
@@ -71058,10 +71253,25 @@ function printReport(results) {
     }
   }
   if (results.system.optionalTools) {
-    for (const [name, info] of Object.entries(results.system.optionalTools)) {
-      if (info.installed) {
-        console.log(`    ${name.padEnd(11)}${source_default.green("OK")}  ${source_default.dim(info.commands.join(", "))}`);
-      } else {
+    const tools = Object.entries(results.system.optionalTools);
+    if (verbose) {
+      for (const [name, info] of tools) {
+        if (info.installed) {
+          console.log(`    ${name.padEnd(11)}${source_default.green("OK")}  ${source_default.dim(info.commands.join(", "))}`);
+        } else {
+          console.log(
+            `    ${name.padEnd(11)}${source_default.yellow("MISSING")}  ${source_default.dim(`needed by: ${info.commands.join(", ")}`)}`
+          );
+          console.log(`               ${source_default.dim(`Install: ${info.install}`)}`);
+        }
+      }
+    } else {
+      const okNames = tools.filter(([, t]) => t.installed).map(([n]) => n);
+      const missing2 = tools.filter(([, t]) => !t.installed);
+      if (okNames.length > 0) {
+        console.log(`    Tools      ${source_default.green("OK")}  ${source_default.dim(okNames.join(", "))}`);
+      }
+      for (const [name, info] of missing2) {
         console.log(
           `    ${name.padEnd(11)}${source_default.yellow("MISSING")}  ${source_default.dim(`needed by: ${info.commands.join(", ")}`)}`
         );
@@ -71083,29 +71293,31 @@ function printReport(results) {
     console.log(`    Project    ${source_default.yellow("NOT INIT")} ${source_default.dim(`Run: vibe init  (cwd: ${results.scope.project.cwd})`)}`);
   }
   console.log(`    Agents     ${source_default.dim(results.scope.agentHosts.summary)}`);
-  console.log();
-  console.log(source_default.bold("  Scene composer (vibe build)"));
-  const sc = results.scope.sceneComposer;
-  const modeBadge = sc.recommendedMode === "agent" ? source_default.cyan("agent") : source_default.dim("batch");
-  const modeNote = sc.recommendedMode === "agent" ? source_default.dim("host agent authors HTML; no internal LLM call") : source_default.dim("CLI's internal LLM authors HTML");
-  console.log(`    Mode (auto)  ${modeBadge}  ${modeNote}`);
-  if (sc.composer) {
-    console.log(
-      `    Batch LLM    ${source_default.green("OK")}     ${source_default.dim(`${composerLabel(sc.composer)} (${sc.composerEnvVar})`)}`
-    );
-  } else {
-    console.log(
-      `    Batch LLM    ${source_default.yellow("--")}     ${source_default.dim("no ANTHROPIC_API_KEY / GOOGLE_API_KEY / OPENAI_API_KEY \u2014 agent-mode only")}`
-    );
-  }
-  if (sc.sceneProjectInCwd) {
-    if (sc.skillInstalled) {
-      console.log(`    SKILL.md     ${source_default.green("OK")}     ${source_default.dim("installed in this scene project")}`);
+  if (verbose) {
+    console.log();
+    console.log(source_default.bold("  Scene composer (vibe build)"));
+    const sc = results.scope.sceneComposer;
+    const modeBadge = sc.recommendedMode === "agent" ? source_default.cyan("agent") : source_default.dim("batch");
+    const modeNote = sc.recommendedMode === "agent" ? source_default.dim("host agent authors HTML; no internal LLM call") : source_default.dim("CLI's internal LLM authors HTML");
+    console.log(`    Mode (auto)  ${modeBadge}  ${modeNote}`);
+    if (sc.composer) {
+      console.log(
+        `    Batch LLM    ${source_default.green("OK")}     ${source_default.dim(`${composerLabel(sc.composer)} (${sc.composerEnvVar})`)}`
+      );
     } else {
-      console.log(`    SKILL.md     ${source_default.yellow("MISSING")} ${source_default.dim("Run: vibe scene install-skill")}`);
+      console.log(
+        `    Batch LLM    ${source_default.yellow("--")}     ${source_default.dim("no ANTHROPIC_API_KEY / GOOGLE_API_KEY / OPENAI_API_KEY \u2014 agent-mode only")}`
+      );
+    }
+    if (sc.sceneProjectInCwd) {
+      if (sc.skillInstalled) {
+        console.log(`    SKILL.md     ${source_default.green("OK")}     ${source_default.dim("installed in this scene project")}`);
+      } else {
+        console.log(`    SKILL.md     ${source_default.yellow("MISSING")} ${source_default.dim("Run: vibe scene install-skill")}`);
+      }
+    } else {
+      console.log(`    SKILL.md     ${source_default.dim("(no STORYBOARD.md in cwd \u2014 skill is per-scene-project)")}`);
     }
-  } else {
-    console.log(`    SKILL.md     ${source_default.dim("(no STORYBOARD.md in cwd \u2014 skill is per-scene-project)")}`);
   }
   console.log();
   console.log(source_default.bold("  API Keys"));
@@ -71122,16 +71334,24 @@ function printReport(results) {
     }
   }
   if (missing.length > 0) {
-    for (const name of missing) {
-      const info = results.providers[name];
+    if (verbose) {
+      for (const name of missing) {
+        const info = results.providers[name];
+        console.log(
+          `    ${source_default.red("--")}  ${info.envVar.padEnd(24)} ${source_default.dim(info.commands.join(", "))}`
+        );
+      }
+    } else {
       console.log(
-        `    ${source_default.red("--")}  ${info.envVar.padEnd(24)} ${source_default.dim(info.commands.join(", "))}`
+        source_default.dim(`    ${missing.length} provider${missing.length === 1 ? "" : "s"} unconfigured (${missing.slice(0, 4).join(", ")}${missing.length > 4 ? ", \u2026" : ""}). Run with --verbose to list.`)
       );
     }
   }
-  console.log();
-  console.log(source_default.bold("  No API key needed"));
-  console.log(`    ${source_default.dim(FREE_COMMANDS.join(", "))}`);
+  if (verbose) {
+    console.log();
+    console.log(source_default.bold("  No API key needed"));
+    console.log(`    ${source_default.dim(FREE_COMMANDS.join(", "))}`);
+  }
   console.log();
   const pct = Math.round(results.readyCount / results.totalCount * 100);
   const readyColor = pct >= 80 ? source_default.green : pct >= 40 ? source_default.yellow : source_default.red;
@@ -71147,6 +71367,32 @@ function printReport(results) {
   }
   console.log();
 }
+async function runLiveKeyTests(results) {
+  console.log();
+  console.log(source_default.bold("  Live key tests"));
+  console.log(source_default.dim("    Hits each provider's cheapest authenticated endpoint with a 5s timeout."));
+  const configured = Object.entries(results.providers).filter(([, info]) => info.configured);
+  if (configured.length === 0) {
+    console.log(source_default.dim("    No keys configured \u2014 nothing to test."));
+    return;
+  }
+  const { testKey: testKey2 } = await Promise.resolve().then(() => (init_key_live_test(), key_live_test_exports));
+  for (const [name, info] of configured) {
+    const value = process.env[info.envVar];
+    if (!value) continue;
+    process.stdout.write(`    ${name.padEnd(12)} `);
+    const result = await testKey2(name, value);
+    if (result.skipped) {
+      console.log(source_default.dim(`SKIP  ${result.message ?? "no test available"}`));
+    } else if (result.ok) {
+      console.log(`${source_default.green("OK")}    ${source_default.dim(`${result.status}`)}`);
+    } else {
+      const detail = result.message ?? `status ${result.status ?? "?"}`;
+      console.log(`${source_default.red("FAIL")}  ${source_default.dim(detail)}`);
+    }
+  }
+  console.log();
+}
 function pickNextStep(results, hasMissingProviders) {
   if (!results.scope.user.configured) {
     return "Next: run 'vibe setup' to configure your user scope (API keys + LLM provider).";
@@ -72518,48 +72764,42 @@ program2.name("vibe").showSuggestionAfterError(true).description("VibeFrame CLI
 }).addHelpText(
   "after",
   `
-Global flags (work with any command):
-  -V, --version  Print version and exit
-  -h, --help     Print help for the command and exit
-  --json         Output JSON (auto-enabled when piped)
-  --fields       Limit output fields (e.g., --fields "path,duration")
-  -q, --quiet    Output only the result value (path, URL, or ID)
-  --stdin        Read options from stdin as JSON (for agent/script use)
-  --describe     Print the command's JSON schema and exit (no execution)
-  --dry-run      Preview without executing (most commands)
-
-Get started (90% of users start here):
-  vibe doctor                  Check system health and API keys
-  vibe setup                   Configure API keys interactively
-  vibe init my-video           Scaffold a video project
-  vibe build my-video          Build STORYBOARD.md into scene compositions/assets
-  vibe render my-video         Render the project to MP4
-  vibe demo                    Try VibeFrame without API keys
-
-One-shot media tools:
-  vibe generate image "..."           Generate a still image
-  vibe generate video "..."           Generate a standalone AI video
-  vibe edit caption clip.mp4 -o out.mp4
-  vibe inspect media clip.mp4 "Summarize this"
-  vibe remix highlights long.mp4 -d 60
-
-Advanced authoring:
-  vibe timeline create my-video       Create low-level timeline JSON
-  vibe scene add intro --headline "Welcome"
-  vibe timeline add-clip my-video <source-id>
-
-Automation & agents:
-  vibe run workflow.yaml              Run a Video-as-YAML pipeline
-  vibe agent                          Natural-language interface
-  vibe schema generate.video          Tool schema for any command
-  vibe walkthrough scene              Step-by-step authoring guide
-
-Cost tiers (per call):
-  Free     detect, edit (silence-cut/fade/noise-reduce), timeline
-  Low      inspect, audio transcribe, generate image               ~$0.01-$0.10
-  High     generate video, edit image                              ~$1-$5
-  V.High   remix (regenerate-scene, highlights, auto-shorts)      ~$5-$50+
-  Tip      Add --dry-run before paid generation to preview the work.
+Common workflows (the alphabetical list above is the full command set;
+this section shows the typical entry points by use case):
+
+  Get started:
+    vibe doctor                         System health + key status
+    vibe setup                          Configure API keys interactively
+    vibe init my-video                  Scaffold a video project
+    vibe build my-video                 Build STORYBOARD.md \u2192 scene assets
+    vibe render my-video                Render the project to MP4
+    vibe demo                           Try VibeFrame without API keys
+
+  One-shot media:
+    vibe generate image "..."           Generate a still image
+    vibe generate video "..."           Generate a standalone AI video
+    vibe edit caption clip.mp4 -o out.mp4
+    vibe inspect media clip.mp4 "Summarize this"
+    vibe remix highlights long.mp4 -d 60
+
+  Authoring:
+    vibe timeline create my-video       Low-level timeline JSON
+    vibe scene add intro --headline "Welcome"
+
+  Automation & agents:
+    vibe run workflow.yaml              Video-as-YAML pipeline
+    vibe agent                          Natural-language interface
+    vibe schema generate.video          JSON schema for any command
+    vibe walkthrough scene              Step-by-step authoring guide
+
+Common-flag note: most commands accept --dry-run to preview cost/output
+before invoking paid providers.
+
+Cost tiers:
+  Free   detect, edit (silence-cut/fade/noise-reduce), timeline
+  Low    inspect, audio transcribe, generate image                ~$0.01\u2013$0.10
+  High   generate video, edit image                               ~$1\u2013$5
+  V.High remix (regenerate-scene, highlights, auto-shorts)       ~$5\u2013$50+
 `
 );
 program2.hook("preAction", async (thisCommand, actionCommand) => {
@@ -72621,9 +72861,9 @@ program2.hook("preAction", async (thisCommand, actionCommand) => {
 });
 program2.addCommand(generateCommand);
 program2.addCommand(editCommand);
-program2.addCommand(analyzeCommand);
+program2.addCommand(inspectCommand);
 program2.addCommand(audioCommand);
-program2.addCommand(pipelineCommand);
+program2.addCommand(remixCommand);
 program2.addCommand(setupCommand);
 program2.addCommand(initCommand);
 program2.addCommand(buildCommand);

package/package.json

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