@vibeframe/cli 0.80.0 → 0.81.0

package/dist/index.js

@@ -14298,7 +14298,8 @@ function getSetupProviders() {
     key: k.configKey,
     name: k.label,
     env: k.envVar,
-    desc: k.setupDescription ?? ""
+    desc: k.setupDescription ?? "",
+    url: k.envExampleUrl
   }));
 }
 function getAllApiKeys() {
@@ -14371,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",
@@ -14432,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: [
@@ -17263,18 +17272,18 @@ ${transcriptWithTimestamps}`
     return emptyViralAnalysis("Analysis failed");
   }
 }
-async function suggestPlatformCuts(api, transcriptSegments, viralAnalysis, platform, clips) {
-  const emptyResult = { platform: platform.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 ${platform.name}.
+  const systemPrompt = `You are an expert video editor optimizing content for ${platform3.name}.
 
 Platform requirements:
-- Aspect ratio: ${platform.aspectRatio}
-- Maximum duration: ${platform.maxDuration}s
-- Ideal duration: ${platform.idealDuration.min}-${platform.idealDuration.max}s
-- Needs strong hook: ${platform.features.hook ? "Yes" : "No"}
-- Needs captions: ${platform.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}%
@@ -17290,7 +17299,7 @@ Your task:
 
 Respond with JSON only:
 {
-  "platform": "${platform.id}",
+  "platform": "${platform3.id}",
   "segments": [
     {"sourceClipId": "clip-id", "startTime": 0, "endTime": 45.5, "priority": 1.0}
   ],
@@ -17301,7 +17310,7 @@ Respond with JSON only:
       system: systemPrompt,
       messages: [{
         role: "user",
-        content: `Optimize this video for ${platform.name}:
+        content: `Optimize this video for ${platform3.name}:
 
 ## Transcript:
 ${transcriptWithTimestamps}
@@ -17997,10 +18006,10 @@ Instruction: ${instruction}`
         }
         return analyzeViralPotential(this.api, transcriptSegments, projectMeta, targetPlatforms);
       }
-      async suggestPlatformCuts(transcriptSegments, viralAnalysis, platform, clips) {
+      async suggestPlatformCuts(transcriptSegments, viralAnalysis, platform3, clips) {
         if (!this.api)
-          return { platform: platform.id, segments: [], totalDuration: 0 };
-        return suggestPlatformCuts(this.api, transcriptSegments, viralAnalysis, platform, clips);
+          return { platform: platform3.id, segments: [], totalDuration: 0 };
+        return suggestPlatformCuts(this.api, transcriptSegments, viralAnalysis, platform3, clips);
       }
       async generateViralCaptions(transcriptSegments, style) {
         if (!this.api)
@@ -31526,6 +31535,44 @@ var init_storyboard = __esm({
   }
 });
 
+// src/utils/open-url.ts
+import { spawn } from "node:child_process";
+import { platform } from "node:os";
+async function openUrl(url) {
+  const { command, args } = resolveOpener(url);
+  if (!command) return;
+  try {
+    const child = spawn(command, args, {
+      detached: true,
+      stdio: "ignore",
+      shell: false
+    });
+    child.on("error", () => {
+    });
+    child.unref();
+  } catch {
+  }
+}
+function resolveOpener(url) {
+  switch (platform()) {
+    case "darwin":
+      return { command: "open", args: [url] };
+    case "win32":
+      return { command: "cmd", args: ["/c", "start", "", url] };
+    case "linux":
+    case "freebsd":
+    case "openbsd":
+      return { command: "xdg-open", args: [url] };
+    default:
+      return { command: null, args: [] };
+  }
+}
+var init_open_url = __esm({
+  "src/utils/open-url.ts"() {
+    "use strict";
+  }
+});
+
 // src/utils/tty.ts
 import { createInterface as createInterface2 } from "node:readline";
 import { ReadStream } from "node:tty";
@@ -31579,7 +31626,7 @@ async function prompt2(question) {
     });
   });
 }
-async function promptHidden(question) {
+async function promptHidden(question, opts = {}) {
   const input = getTTYInputStream();
   return new Promise((resolve64) => {
     process.stdout.write(question);
@@ -31598,6 +31645,8 @@ async function promptHidden(question) {
           input.setRawMode(false);
           process.stdout.write("\n");
           process.exit(1);
+        } else if (opts.openHotkeyUrl && value.length === 0 && (char === "o" || char === "O")) {
+          void openUrl(opts.openHotkeyUrl);
         } else if (char === "\x7F" || char === "\b") {
           if (value.length > 0) {
             value = value.slice(0, -1);
@@ -31681,6 +31730,59 @@ async function promptSelect(_question, options, defaultIndex = 0) {
   return index;
 }
 async function promptConfirm(question, defaultYes = true) {
+  const input = getTTYInputStream();
+  if (typeof input.setRawMode === "function") {
+    return new Promise((resolve64) => {
+      const options = ["Yes", "No"];
+      let selected = defaultYes ? 0 : 1;
+      let renderCount = 0;
+      process.stdout.write(`${question}
+`);
+      const render = () => {
+        if (renderCount > 0) {
+          process.stdout.write(`\x1B[${options.length}A`);
+        }
+        for (let i = 0; i < options.length; i++) {
+          const marker = i === selected ? "\x1B[36m\u276F\x1B[0m" : " ";
+          const text = i === selected ? `\x1B[1m${options[i]}\x1B[0m` : options[i];
+          process.stdout.write(`\x1B[2K   ${marker} ${text}
+`);
+        }
+        renderCount++;
+      };
+      render();
+      input.setRawMode(true);
+      input.resume();
+      input.setEncoding("utf8");
+      const onData = (char) => {
+        if (char === "\r" || char === "\n") {
+          input.setRawMode(false);
+          input.removeListener("data", onData);
+          resolve64(selected === 0);
+        } else if (char === "") {
+          input.setRawMode(false);
+          process.stdout.write("\n");
+          process.exit(1);
+        } else if (char === "\x1B[A" || char === "\x1B[B" || char === "k" || char === "j") {
+          selected = selected === 0 ? 1 : 0;
+          render();
+        } else if (char === "y" || char === "Y") {
+          selected = 0;
+          input.setRawMode(false);
+          input.removeListener("data", onData);
+          render();
+          resolve64(true);
+        } else if (char === "n" || char === "N") {
+          selected = 1;
+          input.setRawMode(false);
+          input.removeListener("data", onData);
+          render();
+          resolve64(false);
+        }
+      };
+      input.on("data", onData);
+    });
+  }
   const hint = defaultYes ? "(Y/n)" : "(y/N)";
   const answer = await prompt2(`${question} ${hint}: `);
   if (answer === "") return defaultYes;
@@ -31774,6 +31876,7 @@ var ttyStream;
 var init_tty = __esm({
   "src/utils/tty.ts"() {
     "use strict";
+    init_open_url();
     ttyStream = null;
   }
 });
@@ -33531,7 +33634,7 @@ Examples:
           }
         }
       } else if (provider === "runway") {
-        const { spawn: spawn2 } = await import("child_process");
+        const { spawn: spawn4 } = await import("child_process");
         const __filename2 = fileURLToPath(import.meta.url);
         const __dirname2 = dirname7(__filename2);
         const scriptPath = resolve23(
@@ -33546,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 = spawn2("python3", args, {
+          const proc = spawn4("python3", args, {
             env: { ...process.env, RUNWAY_API_SECRET: apiKey },
             stdio: ["ignore", "pipe", "pipe"]
           });
@@ -36906,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 platform = process.platform;
-  if (platform === "darwin") {
+  const platform3 = process.platform;
+  if (platform3 === "darwin") {
     const candidates = [
       "/System/Library/Fonts/Helvetica.ttc",
       "/System/Library/Fonts/HelveticaNeue.ttc",
@@ -36916,7 +37019,7 @@ function detectSystemFont() {
     for (const f of candidates) {
       if (existsSync21(f)) return f;
     }
-  } else if (platform === "linux") {
+  } else if (platform3 === "linux") {
     const candidates = [
       "/usr/share/fonts/truetype/dejavu/DejaVuSans-Bold.ttf",
       "/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf",
@@ -36925,7 +37028,7 @@ function detectSystemFont() {
     for (const f of candidates) {
       if (existsSync21(f)) return f;
     }
-  } else if (platform === "win32") {
+  } else if (platform3 === "win32") {
     const candidates = [
       "C:\\Windows\\Fonts\\arial.ttf",
       "C:\\Windows\\Fonts\\segoeui.ttf"
@@ -36976,11 +37079,11 @@ async function applyTextOverlays(options) {
     } = await Promise.resolve().then(() => (init_remotion(), remotion_exports));
     const remotionErr = await ensureRemotionInstalled2();
     if (remotionErr) {
-      const platform = process.platform;
+      const platform3 = process.platform;
       let hint = "";
-      if (platform === "darwin") {
+      if (platform3 === "darwin") {
         hint = "\n\nFix: brew uninstall ffmpeg && brew install ffmpeg\n(The default homebrew formula includes libfreetype)";
-      } else if (platform === "linux") {
+      } else if (platform3 === "linux") {
         hint = "\n\nFix: sudo apt install ffmpeg (Ubuntu/Debian)\n     or rebuild FFmpeg with --enable-libfreetype";
       }
       return {
@@ -50813,6 +50916,320 @@ var init_detect = __esm({
   }
 });
 
+// src/commands/_shared/walkthroughs/walkthroughs.ts
+function loadWalkthrough(topic) {
+  const meta = META[topic];
+  const content = CONTENT[topic];
+  if (!meta || !content) {
+    throw new Error(`Unknown walkthrough topic: ${topic}`);
+  }
+  return {
+    topic,
+    title: meta.title,
+    summary: meta.summary,
+    steps: meta.steps,
+    relatedCommands: meta.relatedCommands,
+    content
+  };
+}
+function listWalkthroughs() {
+  return WALKTHROUGH_TOPICS.map((topic) => ({
+    topic,
+    title: META[topic].title,
+    summary: META[topic].summary
+  }));
+}
+function isWalkthroughTopic(value) {
+  return typeof value === "string" && WALKTHROUGH_TOPICS.includes(value);
+}
+var SCENE_WALKTHROUGH, PIPELINE_WALKTHROUGH, META, CONTENT, WALKTHROUGH_TOPICS;
+var init_walkthroughs = __esm({
+  "src/commands/_shared/walkthroughs/walkthroughs.ts"() {
+    "use strict";
+    SCENE_WALKTHROUGH = `# Scene authoring with vibe
+
+A scene project is a directory that is **bilingual**: it works with both
+\`vibe\` and \`npx hyperframes\`. Each scene is one HTML file with scoped CSS
+and a paused GSAP timeline. Cheap to edit, cheap to lint, expensive only
+at render.
+
+\`vibe build\` (v0.60+) is the supported one-shot driver from a
+written storyboard to an MP4. Plan H (v0.70) added \`--mode agent\` so the
+host agent itself authors the per-beat HTML \u2014 no internal LLM call.
+
+## Three authoring paths
+
+| Path | Command | When to use |
+|---|---|---|
+| **One-shot (default, v0.60+)** | \`vibe build [project-dir]\` | STORYBOARD.md has YAML frontmatter + per-beat cues |
+| **High-craft (manual)** | \`DESIGN.md\` + local composition rules in your agent | Maximum control: hand-author each scene |
+| **Quick draft** | \`vibe scene add --style <preset>\` | No agent or no API keys; fast iteration |
+
+Recommend \`vibe build\` whenever the user has a STORYBOARD with
+narration / backdrop intent.
+
+## High-craft path
+
+1. \`vibe init my-promo --visual-style "Swiss Pulse"\` \u2014 seeds
+   \`DESIGN.md\` (palette, typography, motion, transitions) plus the
+   \`vibe.project.yaml\` / \`hyperframes.json\` / \`index.html\` scaffold.
+   In Plan H this **also installs local composition rules** at the
+   right place for your host (\`.claude/skills/hyperframes/\` for Claude
+   Code, \`.cursor/rules/hyperframes.mdc\` for Cursor, universal
+   \`SKILL.md\` for everyone else).
+2. Read \`SKILL.md\` (or the host-specific copy) \u2014 Hyperframes
+   framework rules, motion principles, type system, transition recipes.
+3. Read \`DESIGN.md\` \u2014 project-specific palette / typography / motion
+   signature (visual identity hard-gate).
+4. Author each scene HTML directly under \`compositions/scene-<id>.html\`
+   using the rules from steps 2 and 3. The skill enforces the visual
+   identity contract \u2014 scenes that contradict DESIGN.md fail lint.
+5. \`vibe scene lint --fix\` for mechanical issues, \`vibe render my-promo\`
+   to MP4.
+
+## Quick-draft path
+
+\`\`\`bash
+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 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
+# 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]
+\`\`\`
+
+## Style presets (for \`vibe scene add --style\`)
+
+- **simple** \u2014 backdrop + bottom caption (default)
+- **announcement** \u2014 single huge headline, gradient text
+- **explainer** \u2014 kicker + title + subtitle stack
+- **kinetic-type** \u2014 words animate in word-by-word
+- **product-shot** \u2014 corner label + bottom headline + slow zoom
+
+All presets accept \`--narration <text|file>\`, \`--visuals <prompt>\`,
+\`--headline\`, \`--kicker\`. With \`--narration\`, scene duration auto-derives
+from the generated TTS audio.
+
+## STORYBOARD-to-MP4 (one command, v0.60+)
+
+\`\`\`bash
+vibe init my-promo --visual-style "Swiss Pulse" -d 12
+# (edit STORYBOARD.md with per-beat YAML cues \u2014 narration, backdrop, duration)
+vibe build my-promo
+\`\`\`
+
+\`vibe build\` reads the STORYBOARD frontmatter + per-beat cues,
+dispatches TTS + image-gen per beat, then either:
+
+- **\`--mode agent\`** (default when an agent host is detected) \u2014 emits a
+  \`needs-author\` plan via \`vibe scene compose-prompts\`. The host agent
+  authors each \`compositions/scene-<id>.html\` itself, then re-invoking
+  \`vibe build\` proceeds to lint + render.
+- **\`--mode batch\`** \u2014 VibeFrame runs an internal LLM (Claude / OpenAI /
+  Gemini) to compose the HTML, then renders.
+
+\`VIBE_BUILD_MODE\` env var overrides the auto-resolve.
+
+## Lint feedback loop
+
+\`\`\`bash
+vibe scene lint --json --fix
+\`\`\`
+
+Returns structured findings. The recommended loop: 1) run lint with
+\`--fix\` (mechanical fixes applied), 2) if \`errorCount > 0\`, edit the
+scene HTML, 3) re-lint. Cap retries at 3 \u2014 if errors persist, fall back
+to a template preset (\`vibe scene add <id> --style simple --force\`)
+and surface the error to the user.
+
+## When to use VibeFrame vs raw Hyperframes
+
+| Task | Tool |
+|------|------|
+| 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\` (one canonical entry point) |
+| Lint | \`vibe scene lint\` *or* \`npx hyperframes lint\` (equivalent) |
+
+The \`vibe\` CLI adds asset generation, AI orchestration, and pipeline
+integration on top of Hyperframes' rendering primitives.
+
+## Quality checklist before render
+
+- [ ] \`vibe scene lint\` exits 0 (or only warnings)
+- [ ] \`vibe doctor\` confirms a usable Chrome (required for render)
+- [ ] Root \`data-duration\` matches the sum of clip durations
+- [ ] Aspect ratio in \`vibe.project.yaml\` matches the destination platform
+`;
+    PIPELINE_WALKTHROUGH = `# YAML pipelines (Video as Code)
+
+A pipeline is a YAML manifest with steps that reference each other's
+outputs. \`vibe run pipeline.yaml\` executes them with checkpointing and
+cost estimation.
+
+## Minimal skeleton
+
+\`\`\`yaml
+name: promo-video
+description: 15s product teaser
+steps:
+  - id: backdrop
+    action: generate-image
+    prompt: "sleek product shot on white background"
+    output: backdrop.png
+  - id: scene
+    action: generate-video
+    image: $backdrop.output        # reference previous step output
+    prompt: "slow camera pan"
+    duration: 5
+    output: scene.mp4
+  - id: voice
+    action: generate-tts
+    text: "Meet the new standard."
+    output: voice.mp3
+  - id: final
+    action: compose
+    video: $scene.output
+    audio: $voice.output
+    output: final.mp4
+\`\`\`
+
+## Supported actions
+
+- \`generate-image\`, \`generate-video\`, \`generate-tts\`, \`generate-music\`,
+  \`generate-sound-effect\`, \`generate-storyboard\`, \`generate-motion\`
+- \`edit-silence-cut\`, \`edit-jump-cut\`, \`edit-caption\`, \`edit-grade\`,
+  \`edit-reframe\`, \`edit-speed-ramp\`, \`edit-fade\`, \`edit-noise-reduce\`,
+  \`edit-text-overlay\`, \`edit-fill-gaps\`
+- \`analyze-media\`, \`analyze-video\`, \`analyze-review\`, \`analyze-suggest\`
+- \`audio-transcribe\`, \`audio-isolate\`, \`audio-voice-clone\`, \`audio-dub\`,
+  \`audio-duck\`
+- \`detect-scenes\`, \`detect-silence\`, \`detect-beats\`
+- \`compose\`, \`export\`
+- \`scene-build\` (Plan H one-shot driver) and \`scene-render\`
+- \`compose-scenes-with-skills\` (internal-LLM compose pass)
+
+The full set lives in \`packages/cli/src/pipeline/executor.ts\`.
+
+## Variable references
+
+- \`$<step-id>.output\` \u2014 previous step's output path
+- \`$<step-id>.result.<field>\` \u2014 structured field from JSON result
+- \`\${ENV_VAR}\` \u2014 environment variable
+- Values can be templated: \`"\${SCRIPT_TITLE} - Episode \${EPISODE}"\`
+
+## Running
+
+\`\`\`bash
+vibe run pipeline.yaml --dry-run           # plan + cost estimate, no execution
+vibe run pipeline.yaml                     # execute
+vibe run pipeline.yaml --resume            # retry from last successful step
+vibe run pipeline.yaml --from scene        # start at specific step
+vibe run pipeline.yaml --provider-video kling   # override provider
+\`\`\`
+
+Checkpoints land next to the YAML: \`pipeline.yaml.checkpoint.json\`.
+
+## Authoring tips
+
+1. **Start from a tiny YAML** \u2014 keep it in your project directory and run
+   \`vibe run pipeline.yaml --dry-run\` before spending provider budget.
+2. **Dry-run first** \u2014 you see estimated cost and resolved variable
+   graph before spending API credits.
+3. **Keep step ids short and descriptive** (\`intro\`, \`scene1\`, \`voice\`,
+   \`bgm\`) \u2014 they appear in logs and variable refs.
+4. **Name outputs** with extensions matching the action (\`.mp4\`, \`.mp3\`,
+   \`.png\`, \`.json\`).
+5. **Declare \`budget:\`** on expensive pipelines:
+   \`\`\`yaml
+   budget:
+     tokens: 500_000
+     max_tool_errors: 3
+     cost_usd: 5.00
+   \`\`\`
+6. **Split large pipelines** into smaller YAML files and compose via
+   \`action: run-pipeline\` (nested).
+
+## Converting ad-hoc shell sessions to pipelines
+
+When the user has a working shell sequence, extract steps:
+
+- Each \`vibe ...\` command becomes one step
+- File outputs become step outputs; downstream \`-i <file>\` references
+  become \`$<id>.output\`
+- Shared parameters move to a top-level \`defaults:\` section
+- Wrap the entire chain in a \`name:\` + \`steps:\` skeleton
+
+The \`compose\` action is the catch-all assembly step (audio mux, video
+overlay, etc.) \u2014 useful at the tail of a pipeline.
+`;
+    META = {
+      scene: {
+        title: "Scene authoring with vibe",
+        summary: "Author per-scene HTML compositions and render to MP4 (BUILD flow)",
+        steps: [
+          'Run `vibe init <dir> --visual-style "<style name>"` to scaffold the project + install local composition rules.',
+          "Edit `STORYBOARD.md` with per-beat YAML cues (narration / backdrop / duration).",
+          "Read `SKILL.md` for the framework rules and `DESIGN.md` for the visual-identity hard-gate.",
+          "Run `vibe build <dir>`. With an agent host detected, the CLI emits a `needs-author` plan; the host agent authors each `compositions/scene-<id>.html` and re-invokes to render.",
+          "Run `vibe scene lint --fix` to validate, then `vibe render <dir>` to produce the MP4."
+        ],
+        relatedCommands: [
+          "vibe init",
+          "vibe build",
+          "vibe render",
+          "vibe scene list-styles",
+          "vibe scene install-skill",
+          "vibe scene compose-prompts",
+          "vibe scene lint",
+          "vibe scene add"
+        ]
+      },
+      pipeline: {
+        title: "YAML pipelines (Video as Code)",
+        summary: "Author and run reproducible multi-step video workflows",
+        steps: [
+          "Sketch the workflow as YAML \u2014 `name`, `description`, then `steps:` with `id` + `action` + inputs/outputs.",
+          "Reference previous step outputs via `$<step-id>.output` (or `$<step-id>.result.<field>` for structured returns).",
+          "Run `vibe run pipeline.yaml --dry-run` to see the resolved graph + cost estimate before spending API budget.",
+          "Add a `budget:` block (tokens / cost_usd / max_tool_errors) to cap expensive runs.",
+          "Run `vibe run pipeline.yaml` to execute. Failed steps checkpoint to `pipeline.yaml.checkpoint.json`; resume with `--resume`."
+        ],
+        relatedCommands: [
+          "vibe run",
+          "vibe schema --list",
+          "vibe doctor"
+        ]
+      }
+    };
+    CONTENT = {
+      scene: SCENE_WALKTHROUGH,
+      pipeline: PIPELINE_WALKTHROUGH
+    };
+    WALKTHROUGH_TOPICS = ["scene", "pipeline"];
+  }
+});
+
 // src/pipeline/renderers/chrome.ts
 import { existsSync as existsSync32 } from "node:fs";
 import { homedir as homedir5 } from "node:os";
@@ -51582,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 = {};
@@ -58587,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();
@@ -58713,7 +59250,7 @@ var init_analyze = __esm({
         };
       }
     });
-    analyzeTools = [
+    inspectTools = [
       analyzeMediaTool,
       analyzeVideoTool,
       analyzeReviewTool,
@@ -59049,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();
@@ -59238,7 +59775,7 @@ var init_pipeline2 = __esm({
         };
       }
     });
-    pipelineTools = [
+    remixTools = [
       pipelineHighlightsTool,
       pipelineAutoShortsTool,
       pipelineRunTool,
@@ -60062,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 } 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);
@@ -60536,7 +61073,7 @@ function buildFFmpegArgs(clips, sources, presetSettings, outputPath, options, so
 }
 function runFFmpegProcess(ffmpegPath, args, onProgress) {
   return new Promise((resolve64, reject) => {
-    const ffmpeg = spawn(ffmpegPath, args, {
+    const ffmpeg = spawn3(ffmpegPath, args, {
       stdio: ["pipe", "pipe", "pipe"]
     });
     let duration = 0;
@@ -61819,320 +62356,6 @@ Audio:`);
   }
 });
 
-// src/commands/_shared/walkthroughs/walkthroughs.ts
-function loadWalkthrough(topic) {
-  const meta = META[topic];
-  const content = CONTENT[topic];
-  if (!meta || !content) {
-    throw new Error(`Unknown walkthrough topic: ${topic}`);
-  }
-  return {
-    topic,
-    title: meta.title,
-    summary: meta.summary,
-    steps: meta.steps,
-    relatedCommands: meta.relatedCommands,
-    content
-  };
-}
-function listWalkthroughs() {
-  return WALKTHROUGH_TOPICS.map((topic) => ({
-    topic,
-    title: META[topic].title,
-    summary: META[topic].summary
-  }));
-}
-function isWalkthroughTopic(value) {
-  return typeof value === "string" && WALKTHROUGH_TOPICS.includes(value);
-}
-var SCENE_WALKTHROUGH, PIPELINE_WALKTHROUGH, META, CONTENT, WALKTHROUGH_TOPICS;
-var init_walkthroughs = __esm({
-  "src/commands/_shared/walkthroughs/walkthroughs.ts"() {
-    "use strict";
-    SCENE_WALKTHROUGH = `# Scene authoring with vibe
-
-A scene project is a directory that is **bilingual**: it works with both
-\`vibe\` and \`npx hyperframes\`. Each scene is one HTML file with scoped CSS
-and a paused GSAP timeline. Cheap to edit, cheap to lint, expensive only
-at render.
-
-\`vibe build\` (v0.60+) is the supported one-shot driver from a
-written storyboard to an MP4. Plan H (v0.70) added \`--mode agent\` so the
-host agent itself authors the per-beat HTML \u2014 no internal LLM call.
-
-## Three authoring paths
-
-| Path | Command | When to use |
-|---|---|---|
-| **One-shot (default, v0.60+)** | \`vibe build [project-dir]\` | STORYBOARD.md has YAML frontmatter + per-beat cues |
-| **High-craft (manual)** | \`DESIGN.md\` + local composition rules in your agent | Maximum control: hand-author each scene |
-| **Quick draft** | \`vibe scene add --style <preset>\` | No agent or no API keys; fast iteration |
-
-Recommend \`vibe build\` whenever the user has a STORYBOARD with
-narration / backdrop intent.
-
-## High-craft path
-
-1. \`vibe init my-promo --visual-style "Swiss Pulse"\` \u2014 seeds
-   \`DESIGN.md\` (palette, typography, motion, transitions) plus the
-   \`vibe.project.yaml\` / \`hyperframes.json\` / \`index.html\` scaffold.
-   In Plan H this **also installs local composition rules** at the
-   right place for your host (\`.claude/skills/hyperframes/\` for Claude
-   Code, \`.cursor/rules/hyperframes.mdc\` for Cursor, universal
-   \`SKILL.md\` for everyone else).
-2. Read \`SKILL.md\` (or the host-specific copy) \u2014 Hyperframes
-   framework rules, motion principles, type system, transition recipes.
-3. Read \`DESIGN.md\` \u2014 project-specific palette / typography / motion
-   signature (visual identity hard-gate).
-4. Author each scene HTML directly under \`compositions/scene-<id>.html\`
-   using the rules from steps 2 and 3. The skill enforces the visual
-   identity contract \u2014 scenes that contradict DESIGN.md fail lint.
-5. \`vibe scene lint --fix\` for mechanical issues, \`vibe render my-promo\`
-   to MP4.
-
-## Quick-draft path
-
-\`\`\`bash
-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 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
-# 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]
-\`\`\`
-
-## Style presets (for \`vibe scene add --style\`)
-
-- **simple** \u2014 backdrop + bottom caption (default)
-- **announcement** \u2014 single huge headline, gradient text
-- **explainer** \u2014 kicker + title + subtitle stack
-- **kinetic-type** \u2014 words animate in word-by-word
-- **product-shot** \u2014 corner label + bottom headline + slow zoom
-
-All presets accept \`--narration <text|file>\`, \`--visuals <prompt>\`,
-\`--headline\`, \`--kicker\`. With \`--narration\`, scene duration auto-derives
-from the generated TTS audio.
-
-## STORYBOARD-to-MP4 (one command, v0.60+)
-
-\`\`\`bash
-vibe init my-promo --visual-style "Swiss Pulse" -d 12
-# (edit STORYBOARD.md with per-beat YAML cues \u2014 narration, backdrop, duration)
-vibe build my-promo
-\`\`\`
-
-\`vibe build\` reads the STORYBOARD frontmatter + per-beat cues,
-dispatches TTS + image-gen per beat, then either:
-
-- **\`--mode agent\`** (default when an agent host is detected) \u2014 emits a
-  \`needs-author\` plan via \`vibe scene compose-prompts\`. The host agent
-  authors each \`compositions/scene-<id>.html\` itself, then re-invoking
-  \`vibe build\` proceeds to lint + render.
-- **\`--mode batch\`** \u2014 VibeFrame runs an internal LLM (Claude / OpenAI /
-  Gemini) to compose the HTML, then renders.
-
-\`VIBE_BUILD_MODE\` env var overrides the auto-resolve.
-
-## Lint feedback loop
-
-\`\`\`bash
-vibe scene lint --json --fix
-\`\`\`
-
-Returns structured findings. The recommended loop: 1) run lint with
-\`--fix\` (mechanical fixes applied), 2) if \`errorCount > 0\`, edit the
-scene HTML, 3) re-lint. Cap retries at 3 \u2014 if errors persist, fall back
-to a template preset (\`vibe scene add <id> --style simple --force\`)
-and surface the error to the user.
-
-## When to use VibeFrame vs raw Hyperframes
-
-| Task | Tool |
-|------|------|
-| 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\` (one canonical entry point) |
-| Lint | \`vibe scene lint\` *or* \`npx hyperframes lint\` (equivalent) |
-
-The \`vibe\` CLI adds asset generation, AI orchestration, and pipeline
-integration on top of Hyperframes' rendering primitives.
-
-## Quality checklist before render
-
-- [ ] \`vibe scene lint\` exits 0 (or only warnings)
-- [ ] \`vibe doctor\` confirms a usable Chrome (required for render)
-- [ ] Root \`data-duration\` matches the sum of clip durations
-- [ ] Aspect ratio in \`vibe.project.yaml\` matches the destination platform
-`;
-    PIPELINE_WALKTHROUGH = `# YAML pipelines (Video as Code)
-
-A pipeline is a YAML manifest with steps that reference each other's
-outputs. \`vibe run pipeline.yaml\` executes them with checkpointing and
-cost estimation.
-
-## Minimal skeleton
-
-\`\`\`yaml
-name: promo-video
-description: 15s product teaser
-steps:
-  - id: backdrop
-    action: generate-image
-    prompt: "sleek product shot on white background"
-    output: backdrop.png
-  - id: scene
-    action: generate-video
-    image: $backdrop.output        # reference previous step output
-    prompt: "slow camera pan"
-    duration: 5
-    output: scene.mp4
-  - id: voice
-    action: generate-tts
-    text: "Meet the new standard."
-    output: voice.mp3
-  - id: final
-    action: compose
-    video: $scene.output
-    audio: $voice.output
-    output: final.mp4
-\`\`\`
-
-## Supported actions
-
-- \`generate-image\`, \`generate-video\`, \`generate-tts\`, \`generate-music\`,
-  \`generate-sound-effect\`, \`generate-storyboard\`, \`generate-motion\`
-- \`edit-silence-cut\`, \`edit-jump-cut\`, \`edit-caption\`, \`edit-grade\`,
-  \`edit-reframe\`, \`edit-speed-ramp\`, \`edit-fade\`, \`edit-noise-reduce\`,
-  \`edit-text-overlay\`, \`edit-fill-gaps\`
-- \`analyze-media\`, \`analyze-video\`, \`analyze-review\`, \`analyze-suggest\`
-- \`audio-transcribe\`, \`audio-isolate\`, \`audio-voice-clone\`, \`audio-dub\`,
-  \`audio-duck\`
-- \`detect-scenes\`, \`detect-silence\`, \`detect-beats\`
-- \`compose\`, \`export\`
-- \`scene-build\` (Plan H one-shot driver) and \`scene-render\`
-- \`compose-scenes-with-skills\` (internal-LLM compose pass)
-
-The full set lives in \`packages/cli/src/pipeline/executor.ts\`.
-
-## Variable references
-
-- \`$<step-id>.output\` \u2014 previous step's output path
-- \`$<step-id>.result.<field>\` \u2014 structured field from JSON result
-- \`\${ENV_VAR}\` \u2014 environment variable
-- Values can be templated: \`"\${SCRIPT_TITLE} - Episode \${EPISODE}"\`
-
-## Running
-
-\`\`\`bash
-vibe run pipeline.yaml --dry-run           # plan + cost estimate, no execution
-vibe run pipeline.yaml                     # execute
-vibe run pipeline.yaml --resume            # retry from last successful step
-vibe run pipeline.yaml --from scene        # start at specific step
-vibe run pipeline.yaml --provider-video kling   # override provider
-\`\`\`
-
-Checkpoints land next to the YAML: \`pipeline.yaml.checkpoint.json\`.
-
-## Authoring tips
-
-1. **Start from a tiny YAML** \u2014 keep it in your project directory and run
-   \`vibe run pipeline.yaml --dry-run\` before spending provider budget.
-2. **Dry-run first** \u2014 you see estimated cost and resolved variable
-   graph before spending API credits.
-3. **Keep step ids short and descriptive** (\`intro\`, \`scene1\`, \`voice\`,
-   \`bgm\`) \u2014 they appear in logs and variable refs.
-4. **Name outputs** with extensions matching the action (\`.mp4\`, \`.mp3\`,
-   \`.png\`, \`.json\`).
-5. **Declare \`budget:\`** on expensive pipelines:
-   \`\`\`yaml
-   budget:
-     tokens: 500_000
-     max_tool_errors: 3
-     cost_usd: 5.00
-   \`\`\`
-6. **Split large pipelines** into smaller YAML files and compose via
-   \`action: run-pipeline\` (nested).
-
-## Converting ad-hoc shell sessions to pipelines
-
-When the user has a working shell sequence, extract steps:
-
-- Each \`vibe ...\` command becomes one step
-- File outputs become step outputs; downstream \`-i <file>\` references
-  become \`$<id>.output\`
-- Shared parameters move to a top-level \`defaults:\` section
-- Wrap the entire chain in a \`name:\` + \`steps:\` skeleton
-
-The \`compose\` action is the catch-all assembly step (audio mux, video
-overlay, etc.) \u2014 useful at the tail of a pipeline.
-`;
-    META = {
-      scene: {
-        title: "Scene authoring with vibe",
-        summary: "Author per-scene HTML compositions and render to MP4 (BUILD flow)",
-        steps: [
-          'Run `vibe init <dir> --visual-style "<style name>"` to scaffold the project + install local composition rules.',
-          "Edit `STORYBOARD.md` with per-beat YAML cues (narration / backdrop / duration).",
-          "Read `SKILL.md` for the framework rules and `DESIGN.md` for the visual-identity hard-gate.",
-          "Run `vibe build <dir>`. With an agent host detected, the CLI emits a `needs-author` plan; the host agent authors each `compositions/scene-<id>.html` and re-invokes to render.",
-          "Run `vibe scene lint --fix` to validate, then `vibe render <dir>` to produce the MP4."
-        ],
-        relatedCommands: [
-          "vibe init",
-          "vibe build",
-          "vibe render",
-          "vibe scene list-styles",
-          "vibe scene install-skill",
-          "vibe scene compose-prompts",
-          "vibe scene lint",
-          "vibe scene add"
-        ]
-      },
-      pipeline: {
-        title: "YAML pipelines (Video as Code)",
-        summary: "Author and run reproducible multi-step video workflows",
-        steps: [
-          "Sketch the workflow as YAML \u2014 `name`, `description`, then `steps:` with `id` + `action` + inputs/outputs.",
-          "Reference previous step outputs via `$<step-id>.output` (or `$<step-id>.result.<field>` for structured returns).",
-          "Run `vibe run pipeline.yaml --dry-run` to see the resolved graph + cost estimate before spending API budget.",
-          "Add a `budget:` block (tokens / cost_usd / max_tool_errors) to cap expensive runs.",
-          "Run `vibe run pipeline.yaml` to execute. Failed steps checkpoint to `pipeline.yaml.checkpoint.json`; resume with `--resume`."
-        ],
-        relatedCommands: [
-          "vibe run",
-          "vibe schema --list",
-          "vibe doctor"
-        ]
-      }
-    };
-    CONTENT = {
-      scene: SCENE_WALKTHROUGH,
-      pipeline: PIPELINE_WALKTHROUGH
-    };
-    WALKTHROUGH_TOPICS = ["scene", "pipeline"];
-  }
-});
-
 // src/tools/manifest/walkthrough.ts
 var walkthroughSchema, walkthroughTool, walkthroughTools;
 var init_walkthrough = __esm({
@@ -62183,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
@@ -62203,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();
@@ -62216,9 +62439,9 @@ var init_manifest = __esm({
       ...sceneTools,
       ...audioTools,
       ...editTools,
-      ...analyzeTools,
+      ...inspectTools,
       ...generateTools,
-      ...pipelineTools,
+      ...remixTools,
       ...detectTools,
       ...timelineTools,
       ...projectTools,
@@ -62428,7 +62651,7 @@ init_source();
 // package.json
 var package_default = {
   name: "@vibeframe/cli",
-  version: "0.80.0",
+  version: "0.81.0",
   description: "VibeFrame CLI - natural language video editing from the terminal",
   private: false,
   license: "MIT",
@@ -63583,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();
@@ -63598,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:
@@ -63616,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);
@@ -63693,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);
@@ -63769,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);
@@ -64357,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();
@@ -64542,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",
@@ -64580,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:
@@ -69302,9 +69525,54 @@ 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();
+init_walkthroughs();
 var VALID_LLM_PROVIDERS = [
   "claude",
   "openai",
@@ -69313,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):
@@ -69327,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) {
@@ -69478,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) {
@@ -69499,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"));
@@ -69521,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"));
@@ -69552,8 +69820,11 @@ async function runSetupWizard(fullSetup = false) {
         continue;
       }
       console.log(source_default.dim(`  ${keyDef.what}`));
-      console.log(source_default.dim(`  Get key: ${keyDef.url}`));
-      const newKey = await promptHidden(source_default.cyan(`  ${keyDef.name.padEnd(14)} ${source_default.dim(keyDef.envVar)}: `));
+      console.log(source_default.dim(`  Get key: ${keyDef.url}  [o] open in browser`));
+      const newKey = await promptHidden(
+        source_default.cyan(`  ${keyDef.name.padEnd(14)} ${source_default.dim(keyDef.envVar)}: `),
+        { openHotkeyUrl: keyDef.url }
+      );
       if (newKey.trim()) {
         const trimmed = newKey.trim();
         config2.providers[keyDef.configKey] = trimmed;
@@ -69571,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();
@@ -69587,8 +69858,11 @@ async function collectKeys(config2, keys) {
       continue;
     }
     console.log(source_default.dim(`  ${keyDef.what}`));
-    console.log(source_default.dim(`  Get key: ${keyDef.url}`));
-    const newKey = await promptHidden(source_default.cyan(`  ${keyDef.name.padEnd(14)} ${source_default.dim(keyDef.envVar)}: `));
+    console.log(source_default.dim(`  Get key: ${keyDef.url}  [o] open in browser`));
+    const newKey = await promptHidden(
+      source_default.cyan(`  ${keyDef.name.padEnd(14)} ${source_default.dim(keyDef.envVar)}: `),
+      { openHotkeyUrl: keyDef.url }
+    );
     if (newKey.trim()) {
       const trimmed = newKey.trim();
       config2.providers[keyDef.configKey] = trimmed;
@@ -69639,7 +69913,11 @@ async function runCustomSetup(config2) {
       console.log(`  ${source_default.green("\u2713")} ${p.name.padEnd(12)} ${maskApiKey(existing)} ${source_default.dim(p.desc)}`);
       const change = await promptConfirm(source_default.cyan("    Update?"), false);
       if (change) {
-        const newKey = await promptHidden(source_default.cyan("    New key: "));
+        console.log(source_default.dim(`    Get key: ${p.url}  [o] open in browser`));
+        const newKey = await promptHidden(
+          source_default.cyan("    New key: "),
+          { openHotkeyUrl: p.url }
+        );
         if (newKey.trim()) {
           const trimmed = newKey.trim();
           config2.providers[p.key] = trimmed;
@@ -69652,7 +69930,11 @@ async function runCustomSetup(config2) {
         }
       }
     } else {
-      const newKey = await promptHidden(source_default.cyan(`  ${source_default.dim("\u25CB")} ${p.name.padEnd(12)} ${source_default.dim(p.desc)}: `));
+      console.log(source_default.dim(`  ${source_default.dim("\u25CB")} ${p.name.padEnd(12)} ${source_default.dim(p.desc)}  Get key: ${p.url}  [o] open`));
+      const newKey = await promptHidden(
+        source_default.cyan(`    ${p.env}: `),
+        { openHotkeyUrl: p.url }
+      );
       if (newKey.trim()) {
         const trimmed = newKey.trim();
         config2.providers[p.key] = trimmed;
@@ -69667,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) {
@@ -69683,10 +69966,21 @@ 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)"));
-  console.log(source_default.dim("    vibe walkthrough scene    5-step authoring guide (storyboard \u2192 MP4)"));
+  const hostDetected = detectedAgentHosts().length > 0;
+  for (const w of listWalkthroughs()) {
+    const cmd = `vibe walkthrough ${w.topic}`.padEnd(26);
+    const tag = hostDetected && w.topic === "scene" ? source_default.cyan(" (recommended)") : "";
+    console.log(source_default.dim(`    ${cmd}${w.summary}${tag}`));
+  }
   console.log(source_default.dim("    vibe doctor               Check system health + available commands"));
   console.log(source_default.dim("    vibe schema --list        Discover every command"));
   console.log(source_default.dim("    vibe setup                Re-run user-scope setup anytime"));
@@ -69734,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;
@@ -69785,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];
@@ -69796,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
@@ -70731,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) => {
@@ -70751,7 +71057,10 @@ Examples:
     });
     return;
   }
-  printReport(results);
+  printReport(results, { verbose: Boolean(options.verbose) });
+  if (options.testKeys) {
+    await runLiveKeyTests(results);
+  }
 });
 var REQUIRED_FFMPEG_FILTERS = {
   drawtext: {
@@ -70805,14 +71114,14 @@ async function runDiagnostics() {
     try {
       const filtersResult = await execSafe("ffmpeg", ["-filters"]);
       const filtersOutput = filtersResult.stdout;
-      const platform = 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[platform] ? { fix: info.fix[platform] } : {}
+          ...!available && info.fix[platform3] ? { fix: info.fix[platform3] } : {}
         };
       }
     } catch {
@@ -70914,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");
@@ -70943,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(", ")}`)}`
         );
@@ -70968,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"));
@@ -71007,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;
@@ -71032,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).";
@@ -72403,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) => {
@@ -72506,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);