@vibeframe/cli 0.70.0 → 0.72.0

package/dist/index.js

@@ -6557,6 +6557,7 @@ __export(output_exports, {
   notFoundError: () => notFoundError,
   outputError: () => outputError,
   outputResult: () => outputResult,
+  outputSuccess: () => outputSuccess,
   spinner: () => spinner,
   suggestNext: () => suggestNext,
   usageError: () => usageError
@@ -6615,6 +6616,40 @@ function formatCost(min, max, unit) {
   if (min === max) return `~$${min.toFixed(2)} ${unit}`;
   return `~$${min.toFixed(2)}-$${max.toFixed(2)} ${unit}`;
 }
+function lookupCostEstimateUpperBound(command) {
+  return COST_ESTIMATES[command]?.max ?? 0;
+}
+function outputSuccess(opts) {
+  const elapsedMs = Math.max(0, Date.now() - opts.startedAt);
+  const costUsd = opts.costUsd ?? (opts.dryRun ? lookupCostEstimateUpperBound(opts.command) : 0);
+  const envelope = {
+    command: opts.command,
+    ...opts.dryRun ? { dryRun: true } : {},
+    elapsedMs,
+    costUsd,
+    warnings: opts.warnings ?? [],
+    data: opts.data
+  };
+  if (isJsonMode()) {
+    const fields = process.env.VIBE_OUTPUT_FIELDS;
+    if (fields) {
+      const keys = fields.split(",").map((k) => k.trim());
+      const data = opts.data;
+      const filteredData = {};
+      for (const key of keys) {
+        if (key in data) filteredData[key] = data[key];
+      }
+      envelope.data = filteredData;
+    }
+    console.log(JSON.stringify(envelope, null, 2));
+    return;
+  }
+  if (isQuietMode()) {
+    const data = opts.data;
+    const primary = data.outputPath ?? data.output ?? data.path ?? data.url ?? data.id;
+    if (primary !== void 0) console.log(String(primary));
+  }
+}
 function outputResult(result) {
   if (result.dryRun && result.command && typeof result.command === "string") {
     const cost = COST_ESTIMATES[result.command];
@@ -29108,6 +29143,26 @@ function detectAgentHosts(env2 = process.env) {
       detected: false,
       signals: [],
       projectFiles: ["AGENTS.md", ".aider.conf.yml"]
+    },
+    {
+      id: "gemini-cli",
+      label: "Gemini CLI",
+      detected: false,
+      signals: [],
+      // Per https://geminicli.com/docs/cli/gemini-md/ Gemini CLI's primary
+      // context file is GEMINI.md; AGENTS.md is the cross-tool fallback
+      // VibeFrame writes by default. Both are honoured.
+      projectFiles: ["GEMINI.md", "AGENTS.md", ".gemini/"]
+    },
+    {
+      id: "opencode",
+      label: "OpenCode",
+      detected: false,
+      signals: [],
+      // sst/opencode officially supports the agents.md spec — AGENTS.md at
+      // project root is the standard place. Local config also under
+      // `.opencode/` per https://opencode.ai/docs/config/.
+      projectFiles: ["AGENTS.md", ".opencode/"]
     }
   ].map((host) => {
     const signals2 = [];
@@ -29165,14 +29220,21 @@ var init_agent_host_detect = __esm({
       "claude-code": "claude",
       codex: "codex",
       cursor: "cursor",
-      aider: "aider"
+      aider: "aider",
+      "gemini-cli": "gemini",
+      opencode: "opencode"
     };
     HOST_CONFIG_DIRS = {
       "claude-code": ".claude",
       codex: ".codex",
       cursor: ".cursor",
       // some installs; macOS app stores prefs elsewhere
-      aider: null
+      aider: null,
+      "gemini-cli": ".gemini",
+      // sst/opencode uses XDG-style `~/.config/opencode/` per
+      // https://opencode.ai/docs/config/. The path is relative to $HOME so
+      // the join in detectAgentHosts() resolves correctly.
+      opencode: ".config/opencode"
     };
   }
 });
@@ -30020,20 +30082,24 @@ Examples:
 A scene project is bilingual: it works with both \`vibe\` and \`npx hyperframes\`.
 Run 'vibe schema scene.<command>' for structured parameter info.`);
     sceneCommand.command("init").description("Scaffold a new scene project (or safely augment an existing Hyperframes project)").argument("<dir>", "Project directory (created if it doesn't exist)").option("-n, --name <name>", "Project name (defaults to directory basename)").option("-r, --ratio <ratio>", "Aspect ratio: 16:9, 9:16, 1:1, 4:5", "16:9").option("-d, --duration <sec>", "Default root composition duration (seconds)", "10").option("--visual-style <name>", `Seed DESIGN.md from a named style (browse via \`vibe scene styles\`). E.g. "Swiss Pulse"`).option("--dry-run", "Preview parameters without writing files").action(async (dir, options) => {
+      const startedAt = Date.now();
       const aspect = validateAspect(options.ratio);
       const duration = validateDuration(options.duration);
       const name = options.name ?? basename4(dir.replace(/\/+$/, ""));
       const visualStyle = options.visualStyle ? validateVisualStyle(options.visualStyle) : void 0;
       if (options.dryRun) {
-        outputResult({
-          dryRun: true,
+        outputSuccess({
           command: "scene init",
-          params: {
-            dir,
-            name,
-            aspect,
-            duration,
-            visualStyle: visualStyle?.name ?? null
+          startedAt,
+          dryRun: true,
+          data: {
+            params: {
+              dir,
+              name,
+              aspect,
+              duration,
+              visualStyle: visualStyle?.name ?? null
+            }
           }
         });
         return;
@@ -30049,19 +30115,21 @@ Run 'vibe schema scene.<command>' for structured parameter info.`);
           hosts: skillHosts
         });
         if (isJsonMode()) {
-          outputResult({
-            success: true,
+          outputSuccess({
             command: "scene init",
-            dir,
-            name,
-            aspect,
-            duration,
-            visualStyle: visualStyle?.name ?? null,
-            created: result.created,
-            merged: result.merged,
-            skipped: result.skipped,
-            skillFiles: skillResult.files,
-            skillBundleVersion: skillResult.bundleVersion
+            startedAt,
+            data: {
+              dir,
+              name,
+              aspect,
+              duration,
+              visualStyle: visualStyle?.name ?? null,
+              created: result.created,
+              merged: result.merged,
+              skipped: result.skipped,
+              skillFiles: skillResult.files,
+              skillBundleVersion: skillResult.bundleVersion
+            }
           });
           return;
         }
@@ -30102,6 +30170,7 @@ Run 'vibe schema scene.<command>' for structured parameter info.`);
     });
     VALID_INSTALL_SKILL_HOSTS = ["claude-code", "cursor", "auto", "all"];
     sceneCommand.command("install-skill").description("Install the Hyperframes skill into a scene project so the host agent can read it (Phase H1)").argument("[project-dir]", "Project directory containing STORYBOARD.md / DESIGN.md", ".").option("--host <id>", `Host layout target: ${VALID_INSTALL_SKILL_HOSTS.join(" | ")}`, "auto").option("--force", "Overwrite existing skill files (default: skip-on-exist)").option("--dry-run", "Preview which files would be written without changing anything").action(async (projectDirArg, options) => {
+      const startedAt = Date.now();
       const hostFlag = options.host ?? "auto";
       if (!VALID_INSTALL_SKILL_HOSTS.includes(hostFlag)) {
         exitWithError(usageError(`Invalid --host: ${hostFlag}`, `Valid: ${VALID_INSTALL_SKILL_HOSTS.join(", ")}`));
@@ -30121,15 +30190,17 @@ Run 'vibe schema scene.<command>' for structured parameter info.`);
         dryRun: options.dryRun ?? false
       });
       if (isJsonMode()) {
-        outputResult({
-          success: true,
+        outputSuccess({
           command: "scene install-skill",
-          projectDir,
-          host: hostFlag,
-          resolvedHosts: hosts,
-          bundleVersion: result.bundleVersion,
-          files: result.files,
-          dryRun: options.dryRun ?? false
+          startedAt,
+          dryRun: options.dryRun ?? false,
+          data: {
+            projectDir,
+            host: hostFlag,
+            resolvedHosts: hosts,
+            bundleVersion: result.bundleVersion,
+            files: result.files
+          }
         });
         return;
       }
@@ -30151,6 +30222,7 @@ Run 'vibe schema scene.<command>' for structured parameter info.`);
       }
     });
     sceneCommand.command("compose-prompts").description("Emit the per-beat compose plan for the host agent to author HTML itself (Phase H2 \u2014 no LLM call)").argument("[project-dir]", "Project directory containing STORYBOARD.md / DESIGN.md", ".").option("--beat <id>", "Restrict the plan to a single beat by id (e.g. 'hook', '1')").action(async (projectDirArg, options) => {
+      const startedAt = Date.now();
       const projectDir = resolve14(projectDirArg);
       const result = await getComposePrompts({
         projectDir,
@@ -30158,18 +30230,21 @@ Run 'vibe schema scene.<command>' for structured parameter info.`);
       });
       if (!result.success) {
         if (isJsonMode()) {
-          outputResult({
+          outputSuccess({
             command: "scene compose-prompts",
-            ...result
+            startedAt,
+            data: { ...result }
           });
-          process.exit(1);
+          process.exitCode = 1;
+          return;
         }
         exitWithError(generalError(result.error ?? "compose-prompts failed"));
       }
       if (isJsonMode()) {
-        outputResult({
+        outputSuccess({
           command: "scene compose-prompts",
-          ...result
+          startedAt,
+          data: { ...result }
         });
         return;
       }
@@ -30203,20 +30278,23 @@ Run 'vibe schema scene.<command>' for structured parameter info.`);
       console.log(source_default.dim("Re-run with --json to get the full per-beat userPrompt + cues for direct consumption."));
     });
     sceneCommand.command("styles").description("List vendored visual styles (or show one) for DESIGN.md seeding").argument("[name]", "Style name to inspect (omit to list all)").action((name) => {
+      const startedAt = Date.now();
       if (!name) {
         const all = listVisualStyles();
         if (isJsonMode()) {
-          outputResult({
-            success: true,
+          outputSuccess({
             command: "scene styles",
-            count: all.length,
-            styles: all.map((s) => ({
-              name: s.name,
-              slug: s.slug,
-              designer: s.designer,
-              mood: s.mood,
-              bestFor: s.bestFor
-            }))
+            startedAt,
+            data: {
+              count: all.length,
+              styles: all.map((s) => ({
+                name: s.name,
+                slug: s.slug,
+                designer: s.designer,
+                mood: s.mood,
+                bestFor: s.bestFor
+              }))
+            }
           });
           return;
         }
@@ -30244,7 +30322,11 @@ Run 'vibe schema scene.<command>' for structured parameter info.`);
         return;
       }
       if (isJsonMode()) {
-        outputResult({ success: true, command: "scene styles", style });
+        outputSuccess({
+          command: "scene styles",
+          startedAt,
+          data: { style }
+        });
         return;
       }
       console.log();
@@ -30266,6 +30348,7 @@ Run 'vibe schema scene.<command>' for structured parameter info.`);
       console.log(source_default.dim("Seed DESIGN.md:"), source_default.cyan(`vibe scene init <dir> --visual-style "${style.name}"`));
     });
     sceneCommand.command("add").description("Add a new scene to a project: AI narration + image + per-scene HTML").argument("<name>", "Scene name (slugified into the composition id)").option("--style <preset>", `Style preset: ${SCENE_PRESETS.join(", ")}`, "simple").option("--narration <text>", "Narration text (or path to a .txt file). Drives TTS + scene duration.").option("--narration-file <path>", "Existing narration audio file (.wav/.mp3). Skips TTS \u2014 useful with hyperframes tts, Mac say, or other external tools.").option("-d, --duration <sec>", "Explicit scene duration in seconds (overrides narration audio)").option("--visuals <prompt>", "Image prompt \u2014 generates assets/scene-<id>.png via the configured image provider").option("--headline <text>", "Visible headline (defaults to the humanised scene name)").option("--kicker <text>", "Small label above the headline (explainer / product-shot)").option("--insert-into <path>", "Root composition file to update", "index.html").option("--project <dir>", "Project directory", ".").option("--image-provider <name>", "Image provider: gemini, openai", "gemini").option("--tts <provider>", "TTS provider: auto, elevenlabs, kokoro (default auto \u2014 picks ElevenLabs when key set, else Kokoro local)", "auto").option("--voice <id>", "Voice id (ElevenLabs name/id, or Kokoro id like af_heart, am_michael)").option("--no-audio", "Skip TTS even when --narration is provided (useful for tests/agent dry runs)").option("--no-image", "Skip image generation even when --visuals is provided").option("--no-transcribe", "Skip Whisper word-level transcribe step (no transcript-<id>.json emitted)").option("--transcribe-language <code>", "BCP-47 language code passed to Whisper (e.g. en, ko)").option("--force", "Overwrite an existing compositions/scene-<id>.html").option("--dry-run", "Preview parameters without writing files or calling APIs").action(async (name, options) => {
+      const startedAt = Date.now();
       if (options.style) options.style = validatePreset(options.style);
       if (options.duration !== void 0) options.duration = validateDuration(options.duration);
       let tts;
@@ -30276,25 +30359,28 @@ Run 'vibe schema scene.<command>' for structured parameter info.`);
       }
       if (options.dryRun) {
         const id = slugifySceneName(name);
-        outputResult({
-          dryRun: true,
+        outputSuccess({
           command: "scene add",
-          params: {
-            name,
-            id,
-            preset: options.style,
-            narration: !!options.narration,
-            visuals: !!options.visuals,
-            duration: options.duration,
-            headline: options.headline,
-            kicker: options.kicker,
-            project: options.project,
-            insertInto: options.insertInto,
-            imageProvider: options.imageProvider,
-            tts,
-            audio: options.audio,
-            // commander sets `audio: false` when --no-audio is passed
-            image: options.image
+          startedAt,
+          dryRun: true,
+          data: {
+            params: {
+              name,
+              id,
+              preset: options.style,
+              narration: !!options.narration,
+              visuals: !!options.visuals,
+              duration: options.duration,
+              headline: options.headline,
+              kicker: options.kicker,
+              project: options.project,
+              insertInto: options.insertInto,
+              imageProvider: options.imageProvider,
+              tts,
+              audio: options.audio,
+              // commander sets `audio: false` when --no-audio is passed
+              image: options.image
+            }
           }
         });
         return;
@@ -30329,9 +30415,10 @@ Run 'vibe schema scene.<command>' for structured parameter info.`);
           exitWithError(generalError(result.error ?? "Scene add failed"));
         }
         if (isJsonMode()) {
-          outputResult({
+          outputSuccess({
             command: "scene add",
-            ...result
+            startedAt,
+            data: { ...result }
           });
           return;
         }
@@ -30363,6 +30450,7 @@ Run 'vibe schema scene.<command>' for structured parameter info.`);
       }
     });
     sceneCommand.command("lint").description("Validate scene HTML against Hyperframes rules (in-process, no Chrome required)").argument("[root]", "Root composition file relative to --project", "index.html").option("--project <dir>", "Project directory", ".").option("--fix", 'Apply mechanical auto-fixes (currently: missing class="clip")').action(async (root, options) => {
+      const startedAt = Date.now();
       const projectDir = resolve14(options.project);
       if (!await rootExists(projectDir, root)) {
         exitWithError(generalError(
@@ -30380,11 +30468,12 @@ Run 'vibe schema scene.<command>' for structured parameter info.`);
         exitWithError(generalError(`Lint failed: ${msg}`));
       }
       if (isJsonMode()) {
-        outputResult({
+        outputSuccess({
           command: "scene lint",
-          ...result
+          startedAt,
+          data: { ...result }
         });
-        if (!result.ok) process.exit(1);
+        if (!result.ok) process.exitCode = 1;
         return;
       }
       if (result.ok && result.warningCount === 0 && result.infoCount === 0) {
@@ -30418,29 +30507,33 @@ Run 'vibe schema scene.<command>' for structured parameter info.`);
           console.log(`  ${source_default.green("\u2714")} ${fx.file}  ${source_default.dim(fx.codes.join(", "))}`);
         }
       }
-      if (!result.ok) process.exit(1);
+      if (!result.ok) process.exitCode = 1;
     });
     VALID_FPS = [24, 30, 60];
     VALID_QUALITIES = ["draft", "standard", "high"];
     VALID_FORMATS = ["mp4", "webm", "mov"];
     sceneCommand.command("render").description("Render a scene project to MP4/WebM/MOV via the Hyperframes producer (requires Chrome)").argument("[root]", "Root composition file relative to --project", "index.html").option("--project <dir>", "Project directory", ".").option("-o, --out <path>", "Output file (default: renders/<name>-<timestamp>.<format>)").option("--fps <n>", `Frames per second: ${VALID_FPS.join("|")}`, "30").option("--quality <q>", `Quality preset: ${VALID_QUALITIES.join("|")}`, "standard").option("--format <f>", `Output container: ${VALID_FORMATS.join("|")}`, "mp4").option("--workers <n>", "Capture workers (1-16, default 1)", "1").option("--dry-run", "Preview parameters without rendering").action(async (root, options) => {
+      const startedAt = Date.now();
       const fps = validateFps(options.fps);
       const quality = validateQuality(options.quality);
       const format = validateFormat(options.format);
       const workers = validateWorkers(options.workers);
       const projectDir = resolve14(options.project);
       if (options.dryRun) {
-        outputResult({
-          dryRun: true,
+        outputSuccess({
           command: "scene render",
-          params: {
-            projectDir,
-            root,
-            output: options.out,
-            fps,
-            quality,
-            format,
-            workers
+          startedAt,
+          dryRun: true,
+          data: {
+            params: {
+              projectDir,
+              root,
+              output: options.out,
+              fps,
+              quality,
+              format,
+              workers
+            }
           }
         });
         return;
@@ -30461,13 +30554,22 @@ Run 'vibe schema scene.<command>' for structured parameter info.`);
       if (!result.success) {
         spinner2?.fail("Render failed");
         if (isJsonMode()) {
-          outputResult({ command: "scene render", ...result });
-          process.exit(1);
+          outputSuccess({
+            command: "scene render",
+            startedAt,
+            data: { ...result }
+          });
+          process.exitCode = 1;
+          return;
         }
         exitWithError(generalError(result.error ?? "Render failed"));
       }
       if (isJsonMode()) {
-        outputResult({ command: "scene render", ...result });
+        outputSuccess({
+          command: "scene render",
+          startedAt,
+          data: { ...result }
+        });
         return;
       }
       spinner2?.succeed(source_default.green(`Render complete: ${result.outputPath}`));
@@ -30487,25 +30589,29 @@ Run 'vibe schema scene.<command>' for structured parameter info.`);
       }
     });
     sceneCommand.command("build").description("One-shot: read STORYBOARD.md cues, dispatch TTS + image-gen per beat, compose, render to MP4 (v0.60)").argument("[project-dir]", "Project directory containing STORYBOARD.md", ".").option("--mode <mode>", "Build mode: agent (host-agent authors HTML) | batch (CLI's internal LLM authors HTML) | auto (agent if any host detected) [Plan H \u2014 Phase 3]", "auto").option("--effort <level>", "Compose effort tier (batch mode only): low|medium|high", "medium").option("--composer <provider>", "LLM that composes scene HTML in batch mode: claude|openai|gemini (default: auto-resolve from available API keys, claude > gemini > openai)").option("--skip-narration", "Don't dispatch TTS even when beats declare narration cues").option("--skip-backdrop", "Don't dispatch image-gen even when beats declare backdrop cues").option("--skip-render", "Compose only \u2014 don't render to MP4").option("--tts <provider>", "TTS provider: auto|elevenlabs|kokoro (overrides frontmatter)").option("--voice <id>", "Voice id (provider-specific \u2014 overrides frontmatter)").option("--image-provider <name>", "Image provider: openai (only one supported in v0.60)").option("--quality <q>", "Image quality: standard|hd", "hd").option("--image-size <s>", "Image size: 1024x1024|1536x1024|1024x1536", "1536x1024").option("--force", "Re-dispatch primitives even when assets already exist").option("--dry-run", "Preview parameters without dispatching").action(async (projectDirArg, options) => {
+      const startedAt = Date.now();
       const projectDir = resolve14(projectDirArg);
       if (options.dryRun) {
-        outputResult({
-          dryRun: true,
+        outputSuccess({
           command: "scene build",
-          params: {
-            projectDir,
-            mode: options.mode,
-            effort: options.effort,
-            composer: options.composer,
-            skipNarration: options.skipNarration ?? false,
-            skipBackdrop: options.skipBackdrop ?? false,
-            skipRender: options.skipRender ?? false,
-            ttsProvider: options.tts,
-            voice: options.voice,
-            imageProvider: options.imageProvider,
-            imageQuality: options.quality,
-            imageSize: options.imageSize,
-            force: options.force ?? false
+          startedAt,
+          dryRun: true,
+          data: {
+            params: {
+              projectDir,
+              mode: options.mode,
+              effort: options.effort,
+              composer: options.composer,
+              skipNarration: options.skipNarration ?? false,
+              skipBackdrop: options.skipBackdrop ?? false,
+              skipRender: options.skipRender ?? false,
+              ttsProvider: options.tts,
+              voice: options.voice,
+              imageProvider: options.imageProvider,
+              imageQuality: options.quality,
+              imageSize: options.imageSize,
+              force: options.force ?? false
+            }
           }
         });
         return;
@@ -30559,13 +30665,22 @@ Run 'vibe schema scene.<command>' for structured parameter info.`);
       if (!result.success) {
         spinner2?.fail(`Build failed: ${result.error}`);
         if (isJsonMode()) {
-          outputResult({ command: "scene build", ...result });
-          process.exit(1);
+          outputSuccess({
+            command: "scene build",
+            startedAt,
+            data: { ...result }
+          });
+          process.exitCode = 1;
+          return;
         }
         exitWithError(generalError(result.error ?? "Build failed"));
       }
       if (isJsonMode()) {
-        outputResult({ command: "scene build", ...result });
+        outputSuccess({
+          command: "scene build",
+          startedAt,
+          data: { ...result }
+        });
         return;
       }
       if (result.phase === "needs-author") {
@@ -31579,27 +31694,31 @@ Use this image analysis to inform the color palette, typography placement, and o
 }
 function registerMotionCommand(aiCommand) {
   aiCommand.command("motion").description("Generate motion graphics using Claude + Remotion (render & composite)").argument("<description>", "Natural language description of the motion graphic").option("-k, --api-key <key>", "Anthropic API key (or set ANTHROPIC_API_KEY env)").option("-o, --output <path>", "Output file path", "motion.tsx").option("-d, --duration <sec>", "Duration in seconds", "5").option("-w, --width <px>", "Width in pixels", "1920").option("-h, --height <px>", "Height in pixels", "1080").option("--fps <fps>", "Frame rate", "30").option("-s, --style <style>", "Style preset: minimal, corporate, playful, cinematic").option("--render", "Render the generated code with Remotion (output .webm)").option("--video <path>", "Base video to composite the motion graphic onto").option("--image <path>", "Image to analyze with Gemini \u2014 color/mood fed into Claude prompt").option("--from-tsx <path>", "Refine an existing TSX file instead of generating from scratch").option("-m, --model <alias>", "LLM model: sonnet (default), opus, gemini, gemini-3.1-pro", "sonnet").option("--dry-run", "Preview parameters without executing").action(async (description, options) => {
+    const startedAt = Date.now();
     try {
       if (options.output) {
         validateOutputPath(options.output);
       }
       if (options.dryRun) {
-        outputResult({
+        outputSuccess({
+          command: "generate motion",
+          startedAt,
           dryRun: true,
-          command: "ai motion",
-          params: {
-            description: description.slice(0, 200),
-            duration: options.duration,
-            width: options.width,
-            height: options.height,
-            fps: options.fps,
-            style: options.style,
-            render: options.render ?? false,
-            video: options.video,
-            image: options.image,
-            fromTsx: options.fromTsx,
-            model: options.model,
-            output: options.output
+          data: {
+            params: {
+              description: description.slice(0, 200),
+              duration: options.duration,
+              width: options.width,
+              height: options.height,
+              fps: options.fps,
+              style: options.style,
+              render: options.render ?? false,
+              video: options.video,
+              image: options.image,
+              fromTsx: options.fromTsx,
+              model: options.model,
+              output: options.output
+            }
           }
         });
         return;
@@ -31713,20 +31832,24 @@ async function executeSoundEffect(options) {
 }
 function registerSoundEffectCommand(parent) {
   parent.command("sound-effect").description("Generate sound effect using ElevenLabs").argument("<prompt>", "Description of the sound effect").option("-k, --api-key <key>", "ElevenLabs API key (or set ELEVENLABS_API_KEY env)").option("-o, --output <path>", "Output audio file path", "sound-effect.mp3").option("-d, --duration <seconds>", "Duration in seconds (0.5-22, default: auto)").option("--prompt-influence <value>", "Prompt influence (0-1, default: 0.3)").option("--dry-run", "Preview parameters without executing").action(async (prompt3, options) => {
+    const startedAt = Date.now();
     try {
       rejectControlChars(prompt3);
       if (options.output) {
         validateOutputPath(options.output);
       }
       if (options.dryRun) {
-        outputResult({
-          dryRun: true,
+        outputSuccess({
           command: "generate sound-effect",
-          params: {
-            prompt: prompt3,
-            duration: options.duration,
-            promptInfluence: options.promptInfluence,
-            output: options.output
+          startedAt,
+          dryRun: true,
+          data: {
+            params: {
+              prompt: prompt3,
+              duration: options.duration,
+              promptInfluence: options.promptInfluence,
+              output: options.output
+            }
           }
         });
         return;
@@ -31753,7 +31876,11 @@ function registerSoundEffectCommand(parent) {
       await writeFile13(outputPath, result.audioBuffer);
       spinner2.succeed(source_default.green("Sound effect generated"));
       if (isJsonMode()) {
-        outputResult({ success: true, outputPath });
+        outputSuccess({
+          command: "generate sound-effect",
+          startedAt,
+          data: { outputPath }
+        });
         return;
       }
       console.log(source_default.green(`Saved to: ${outputPath}`));
@@ -31803,6 +31930,7 @@ async function executeMusicStatus(options) {
 }
 function registerMusicStatusCommand(parent) {
   parent.command("music-status", { hidden: true }).description("Check music generation status").argument("<task-id>", "Task ID from music generation").option("-k, --api-key <key>", "Replicate API token (or set REPLICATE_API_TOKEN env)").action(async (taskId, options) => {
+    const startedAt = Date.now();
     try {
       const apiKey = await requireApiKey(
         "REPLICATE_API_TOKEN",
@@ -31814,12 +31942,15 @@ function registerMusicStatusCommand(parent) {
       const result = await replicate.getMusicStatus(taskId);
       if (isJsonMode()) {
         const status = result.audioUrl ? "completed" : result.error ? "failed" : "processing";
-        outputResult({
-          success: true,
-          taskId,
-          status,
-          audioUrl: result.audioUrl,
-          error: result.error
+        outputSuccess({
+          command: "generate music-status",
+          startedAt,
+          data: {
+            taskId,
+            status,
+            audioUrl: result.audioUrl,
+            error: result.error
+          }
         });
         return;
       }
@@ -31857,6 +31988,7 @@ var init_music_status = __esm({
 // src/commands/generate/video-cancel.ts
 function registerVideoCancelCommand(parent) {
   parent.command("video-cancel", { hidden: true }).description("Cancel video generation (Grok or Runway)").argument("<task-id>", "Task ID to cancel").option("-p, --provider <provider>", "Provider: grok, runway", "grok").option("-k, --api-key <key>", "API key (or set XAI_API_KEY / RUNWAY_API_SECRET env)").action(async (taskId, options) => {
+    const startedAt = Date.now();
     try {
       const provider = (options.provider || "grok").toLowerCase();
       let success = false;
@@ -31869,7 +32001,11 @@ function registerVideoCancelCommand(parent) {
         if (success) {
           spinner2.succeed(source_default.green("Generation cancelled"));
           if (isJsonMode()) {
-            outputResult({ success: true, taskId, provider: "grok", cancelled: true });
+            outputSuccess({
+              command: "generate video-cancel",
+              startedAt,
+              data: { taskId, provider: "grok", cancelled: true }
+            });
             return;
           }
         } else {
@@ -31889,7 +32025,11 @@ function registerVideoCancelCommand(parent) {
         if (success) {
           spinner2.succeed(source_default.green("Generation cancelled"));
           if (isJsonMode()) {
-            outputResult({ success: true, taskId, provider: "runway", cancelled: true });
+            outputSuccess({
+              command: "generate video-cancel",
+              startedAt,
+              data: { taskId, provider: "runway", cancelled: true }
+            });
             return;
           }
         } else {
@@ -31962,16 +32102,18 @@ async function executeBackground(options) {
 }
 function registerBackgroundCommand(parent) {
   parent.command("background").description("Generate video background using DALL-E").argument("<description>", "Background description").option("-k, --api-key <key>", "OpenAI API key (or set OPENAI_API_KEY env)").option("-o, --output <path>", "Output file path (downloads image)").option("-a, --aspect <ratio>", "Aspect ratio: 16:9, 9:16, 1:1", "16:9").option("--dry-run", "Preview parameters without executing").action(async (description, options) => {
+    const startedAt = Date.now();
     try {
       rejectControlChars(description);
       if (options.output) {
         validateOutputPath(options.output);
       }
       if (options.dryRun) {
-        outputResult({
-          dryRun: true,
+        outputSuccess({
           command: "generate background",
-          params: { description, aspect: options.aspect, output: options.output }
+          startedAt,
+          dryRun: true,
+          data: { params: { description, aspect: options.aspect, output: options.output } }
         });
         return;
       }
@@ -32006,7 +32148,11 @@ function registerBackgroundCommand(parent) {
           await mkdir9(dirname7(outputPath), { recursive: true });
           await writeFile14(outputPath, buffer);
         }
-        outputResult({ success: true, imageUrl: img.url, outputPath });
+        outputSuccess({
+          command: "generate background",
+          startedAt,
+          data: { imageUrl: img.url, outputPath }
+        });
         return;
       }
       console.log();
@@ -32152,6 +32298,7 @@ async function executeStoryboard(options) {
 }
 function registerStoryboardCommand(parent) {
   parent.command("storyboard").description("Generate video storyboard from content using Claude").argument("<content>", "Content to analyze (text or file path)").option("-k, --api-key <key>", "Anthropic API key (or set ANTHROPIC_API_KEY env)").option("-o, --output <path>", "Output JSON file path").option("-d, --duration <sec>", "Target total duration in seconds").option("-f, --file", "Treat content argument as file path").option("-c, --creativity <level>", "Creativity level: low (default, consistent) or high (varied, unexpected)", "low").option("--dry-run", "Preview parameters without executing").action(async (content, options) => {
+    const startedAt = Date.now();
     try {
       rejectControlChars(content);
       if (options.output) {
@@ -32167,13 +32314,16 @@ function registerStoryboardCommand(parent) {
         textContent = await readFile14(filePath, "utf-8");
       }
       if (options.dryRun) {
-        outputResult({
-          dryRun: true,
+        outputSuccess({
           command: "generate storyboard",
-          params: {
-            content: textContent.substring(0, 200),
-            duration: options.duration,
-            creativity
+          startedAt,
+          dryRun: true,
+          data: {
+            params: {
+              content: textContent.substring(0, 200),
+              duration: options.duration,
+              creativity
+            }
           }
         });
         return;
@@ -32205,16 +32355,23 @@ function registerStoryboardCommand(parent) {
         const outputPath = resolve19(process.cwd(), options.output);
         await writeFile15(outputPath, JSON.stringify(segments, null, 2), "utf-8");
         if (isJsonMode()) {
-          outputResult({
-            success: true,
-            segmentCount: segments.length,
-            segments,
-            outputPath
+          outputSuccess({
+            command: "generate storyboard",
+            startedAt,
+            data: {
+              segmentCount: segments.length,
+              segments,
+              outputPath
+            }
           });
           return;
         }
       } else if (isJsonMode()) {
-        outputResult({ success: true, segmentCount: segments.length, segments });
+        outputSuccess({
+          command: "generate storyboard",
+          startedAt,
+          data: { segmentCount: segments.length, segments }
+        });
         return;
       }
       console.log();
@@ -32459,6 +32616,7 @@ async function executeSpeech(options) {
 }
 function registerSpeechCommand(parent) {
   parent.command("speech").alias("tts").description("Generate speech from text using ElevenLabs").argument("[text]", "Text to convert to speech (interactive if omitted)").option("-k, --api-key <key>", "ElevenLabs API key (or set ELEVENLABS_API_KEY env)").option("-o, --output <path>", "Output audio file path", "output.mp3").option("-v, --voice <id>", "Voice ID (default: Rachel)", "21m00Tcm4TlvDq8ikWAM").option("--list-voices", "List available voices").option("--fit-duration <seconds>", "Speed up audio to fit target duration (via FFmpeg atempo)", parseFloat).option("--dry-run", "Preview parameters without executing").action(async (text, options) => {
+    const startedAt = Date.now();
     try {
       if (!text) {
         if (hasTTY()) {
@@ -32480,10 +32638,11 @@ function registerSpeechCommand(parent) {
         validateOutputPath(options.output);
       }
       if (options.dryRun) {
-        outputResult({
-          dryRun: true,
+        outputSuccess({
           command: "generate speech",
-          params: { text, voice: options.voice, output: options.output }
+          startedAt,
+          dryRun: true,
+          data: { params: { text, voice: options.voice, output: options.output } }
         });
         return;
       }
@@ -32572,10 +32731,13 @@ function registerSpeechCommand(parent) {
         }
       }
       if (isJsonMode()) {
-        outputResult({
-          success: true,
-          characterCount: result.characterCount,
-          outputPath
+        outputSuccess({
+          command: "generate speech",
+          startedAt,
+          data: {
+            characterCount: result.characterCount,
+            outputPath
+          }
         });
         return;
       }
@@ -32664,6 +32826,7 @@ async function executeMusic(options) {
 }
 function registerMusicCommand(parent) {
   parent.command("music").description("Generate background music from a text prompt (ElevenLabs or Replicate MusicGen)").argument("<prompt>", "Description of the music to generate").option("-p, --provider <provider>", "Provider: elevenlabs (default, up to 10min), replicate (MusicGen, max 30s)", "elevenlabs").option("-k, --api-key <key>", "API key (or set ELEVENLABS_API_KEY / REPLICATE_API_TOKEN env)").option("-d, --duration <seconds>", "Duration in seconds (elevenlabs: 3-600, replicate: 1-30)", "8").option("--instrumental", "Force instrumental music, no vocals (ElevenLabs only)").option("-m, --melody <file>", "Reference melody audio file for conditioning (Replicate only)").option("--model <model>", "Model variant (Replicate only): large, stereo-large, melody-large, stereo-melody-large", "stereo-large").option("-o, --output <path>", "Output audio file path", "music.mp3").option("--no-wait", "Don't wait for generation to complete (Replicate async mode)").option("--dry-run", "Preview parameters without executing").action(async (prompt3, options) => {
+    const startedAt = Date.now();
     try {
       rejectControlChars(prompt3);
       if (options.output) {
@@ -32671,16 +32834,19 @@ function registerMusicCommand(parent) {
       }
       const provider = (options.provider || "elevenlabs").toLowerCase();
       if (options.dryRun) {
-        outputResult({
-          dryRun: true,
+        outputSuccess({
           command: "generate music",
-          params: {
-            prompt: prompt3,
-            provider,
-            duration: options.duration,
-            model: options.model,
-            output: options.output,
-            instrumental: options.instrumental
+          startedAt,
+          dryRun: true,
+          data: {
+            params: {
+              prompt: prompt3,
+              provider,
+              duration: options.duration,
+              model: options.model,
+              output: options.output,
+              instrumental: options.instrumental
+            }
           }
         });
         return;
@@ -32707,11 +32873,14 @@ function registerMusicCommand(parent) {
         await writeFile17(outputPath, result.audioBuffer);
         spinner2.succeed(source_default.green("Music generated successfully"));
         if (isJsonMode()) {
-          outputResult({
-            success: true,
-            provider: "elevenlabs",
-            outputPath,
-            duration
+          outputSuccess({
+            command: "generate music",
+            startedAt,
+            data: {
+              provider: "elevenlabs",
+              outputPath,
+              duration
+            }
           });
           return;
         }
@@ -32779,12 +32948,15 @@ function registerMusicCommand(parent) {
         await writeFile17(outputPath, audioBuffer);
         spinner2.succeed(source_default.green("Music generated successfully"));
         if (isJsonMode()) {
-          outputResult({
-            success: true,
-            provider: "replicate",
-            taskId: result.taskId,
-            audioUrl: finalResult.audioUrl,
-            outputPath
+          outputSuccess({
+            command: "generate music",
+            startedAt,
+            data: {
+              provider: "replicate",
+              taskId: result.taskId,
+              audioUrl: finalResult.audioUrl,
+              outputPath
+            }
           });
           return;
         }
@@ -33084,6 +33256,7 @@ import { existsSync as existsSync15 } from "node:fs";
 import { writeFile as writeFile19, mkdir as mkdir11 } from "node:fs/promises";
 function registerThumbnailCommand(parent) {
   parent.command("thumbnail").description("Generate video thumbnail (DALL-E) or extract best frame from video (Gemini)").argument("[description]", "Thumbnail description (for DALL-E generation)").option("-k, --api-key <key>", "API key (OpenAI for generation, Google for best-frame)").option("-o, --output <path>", "Output file path").option("-s, --style <style>", "Platform style: youtube, instagram, tiktok, twitter").option("--best-frame <video>", "Extract best thumbnail frame from video using Gemini AI").option("--prompt <prompt>", "Custom prompt for best-frame analysis").option("--model <model>", "Gemini model: flash, latest, pro (default: flash)", "flash").action(async (description, options) => {
+    const startedAt = Date.now();
     try {
       if (description) rejectControlChars(description);
       if (options.output) {
@@ -33119,11 +33292,14 @@ function registerThumbnailCommand(parent) {
         }
         spinner3.succeed(source_default.green("Best frame extracted"));
         if (isJsonMode()) {
-          outputResult({
-            success: true,
-            timestamp: result2.timestamp,
-            reason: result2.reason,
-            outputPath: result2.outputPath
+          outputSuccess({
+            command: "generate thumbnail",
+            startedAt,
+            data: {
+              timestamp: result2.timestamp,
+              reason: result2.reason,
+              outputPath: result2.outputPath
+            }
           });
           return;
         }
@@ -33171,7 +33347,11 @@ function registerThumbnailCommand(parent) {
           await mkdir11(dirname9(outputPath), { recursive: true });
           await writeFile19(outputPath, buffer);
         }
-        outputResult({ success: true, imageUrl: img.url, outputPath });
+        outputSuccess({
+          command: "generate thumbnail",
+          startedAt,
+          data: { imageUrl: img.url, outputPath }
+        });
         return;
       }
       console.log();
@@ -33242,6 +33422,7 @@ function getStatusColor(status) {
 }
 function registerVideoStatusCommand(parent) {
   parent.command("video-status", { hidden: true }).description("Check video generation status (Grok, Runway, or Kling)").argument("<task-id>", "Task ID from video generation").option("-p, --provider <provider>", "Provider: grok, runway, kling", "grok").option("-k, --api-key <key>", "API key (or set XAI_API_KEY / RUNWAY_API_SECRET / KLING_API_KEY env)").option("-t, --type <type>", "Task type: text2video or image2video (Kling only)", "text2video").option("-w, --wait", "Wait for completion").option("-o, --output <path>", "Download video when complete").action(async (taskId, options) => {
+    const startedAt = Date.now();
     try {
       const provider = (options.provider || "grok").toLowerCase();
       if (provider === "grok") {
@@ -33264,14 +33445,17 @@ function registerVideoStatusCommand(parent) {
             outputPath = resolve24(process.cwd(), options.output);
             await writeFile20(outputPath, buffer);
           }
-          outputResult({
-            success: true,
-            taskId,
-            provider: "grok",
-            status: result.status,
-            videoUrl: result.videoUrl,
-            error: result.error,
-            outputPath
+          outputSuccess({
+            command: "generate video-status",
+            startedAt,
+            data: {
+              taskId,
+              provider: "grok",
+              status: result.status,
+              videoUrl: result.videoUrl,
+              error: result.error,
+              outputPath
+            }
           });
           return;
         }
@@ -33329,15 +33513,18 @@ function registerVideoStatusCommand(parent) {
             outputPath = resolve24(process.cwd(), options.output);
             await writeFile20(outputPath, buffer);
           }
-          outputResult({
-            success: true,
-            taskId,
-            provider: "runway",
-            status: result.status,
-            videoUrl: result.videoUrl,
-            progress: result.progress,
-            error: result.error,
-            outputPath
+          outputSuccess({
+            command: "generate video-status",
+            startedAt,
+            data: {
+              taskId,
+              provider: "runway",
+              status: result.status,
+              videoUrl: result.videoUrl,
+              progress: result.progress,
+              error: result.error,
+              outputPath
+            }
           });
           return;
         }
@@ -33393,15 +33580,18 @@ function registerVideoStatusCommand(parent) {
             outputPath = resolve24(process.cwd(), options.output);
             await writeFile20(outputPath, buffer);
           }
-          outputResult({
-            success: true,
-            taskId,
-            provider: "kling",
-            status: result.status,
-            videoUrl: result.videoUrl,
-            duration: result.duration,
-            error: result.error,
-            outputPath
+          outputSuccess({
+            command: "generate video-status",
+            startedAt,
+            data: {
+              taskId,
+              provider: "kling",
+              status: result.status,
+              videoUrl: result.videoUrl,
+              duration: result.duration,
+              error: result.error,
+              outputPath
+            }
           });
           return;
         }
@@ -33465,22 +33655,26 @@ import { resolve as resolve25 } from "node:path";
 import { writeFile as writeFile21 } from "node:fs/promises";
 function registerVideoExtendCommand(parent) {
   parent.command("video-extend", { hidden: true }).description("Extend video duration (Kling by video ID, Veo by operation name)").argument("<id>", "Kling video ID or Veo operation name").option("-p, --provider <provider>", "Provider: kling, veo", "kling").option("-k, --api-key <key>", "API key (KLING_API_KEY or GOOGLE_API_KEY)").option("-o, --output <path>", "Output file path").option("--prompt <text>", "Continuation prompt").option("-d, --duration <sec>", "Duration: 5 or 10 (Kling), 4/6/8 (Veo)", "5").option("-n, --negative <prompt>", "Negative prompt (what to avoid, Kling only)").option("--veo-model <model>", "Veo model: 3.0, 3.1, 3.1-fast", "3.1").option("--no-wait", "Start extension and return task ID without waiting").option("--dry-run", "Preview parameters without executing").action(async (id, options) => {
+    const startedAt = Date.now();
     try {
       const provider = (options.provider || "kling").toLowerCase();
       if (options.output) {
         validateOutputPath(options.output);
       }
       if (options.dryRun) {
-        outputResult({
-          dryRun: true,
+        outputSuccess({
           command: "generate video-extend",
-          params: {
-            id,
-            provider,
-            prompt: options.prompt,
-            duration: options.duration,
-            negative: options.negative,
-            veoModel: options.veoModel
+          startedAt,
+          dryRun: true,
+          data: {
+            params: {
+              id,
+              provider,
+              prompt: options.prompt,
+              duration: options.duration,
+              negative: options.negative,
+              veoModel: options.veoModel
+            }
           }
         });
         return;
@@ -33537,13 +33731,16 @@ function registerVideoExtendCommand(parent) {
             outputPath = resolve25(process.cwd(), options.output);
             await writeFile21(outputPath, buffer);
           }
-          outputResult({
-            success: true,
-            provider: "kling",
-            taskId: result.id,
-            videoUrl: finalResult.videoUrl,
-            duration: finalResult.duration,
-            outputPath
+          outputSuccess({
+            command: "generate video-extend",
+            startedAt,
+            data: {
+              provider: "kling",
+              taskId: result.id,
+              videoUrl: finalResult.videoUrl,
+              duration: finalResult.duration,
+              outputPath
+            }
           });
           return;
         }
@@ -33623,13 +33820,16 @@ function registerVideoExtendCommand(parent) {
             outputPath = resolve25(process.cwd(), options.output);
             await writeFile21(outputPath, buffer);
           }
-          outputResult({
-            success: true,
-            provider: "veo",
-            taskId: result.id,
-            videoUrl: finalResult.videoUrl,
-            duration: finalResult.duration,
-            outputPath
+          outputSuccess({
+            command: "generate video-extend",
+            startedAt,
+            data: {
+              provider: "veo",
+              taskId: result.id,
+              videoUrl: finalResult.videoUrl,
+              duration: finalResult.duration,
+              outputPath
+            }
           });
           return;
         }
@@ -33744,6 +33944,7 @@ Examples:
   $ vibe gen img "landscape photo" -o wide.png -r 16:9
   $ vibe gen img "portrait" -o portrait.png -p gemini -m pro
   $ vibe gen img "product shot" --dry-run --json`).action(async (prompt3, options) => {
+    const startedAt = Date.now();
     try {
       if (!prompt3) {
         if (hasTTY()) {
@@ -33802,18 +34003,21 @@ Examples:
         provider = resolved?.name ?? "gemini";
       }
       if (options.dryRun) {
-        outputResult({
-          dryRun: true,
+        outputSuccess({
           command: "generate image",
-          params: {
-            prompt: prompt3,
-            provider,
-            model: options.model,
-            ratio: options.ratio,
-            size: options.size,
-            quality: options.quality,
-            count: options.count,
-            output: options.output
+          startedAt,
+          dryRun: true,
+          data: {
+            params: {
+              prompt: prompt3,
+              provider,
+              model: options.model,
+              ratio: options.ratio,
+              size: options.size,
+              quality: options.quality,
+              count: options.count,
+              output: options.output
+            }
           }
         });
         return;
@@ -33851,14 +34055,17 @@ Examples:
             await mkdir12(dirname10(outputPath), { recursive: true });
             await writeFile22(outputPath, buffer);
           }
-          outputResult({
-            success: true,
-            provider: "openai",
-            images: result.images.map((img) => ({
-              url: img.url,
-              revisedPrompt: img.revisedPrompt
-            })),
-            outputPath
+          outputSuccess({
+            command: "generate image",
+            startedAt,
+            data: {
+              provider: "openai",
+              images: result.images.map((img) => ({
+                url: img.url,
+                revisedPrompt: img.revisedPrompt
+              })),
+              outputPath
+            }
           });
           return;
         }
@@ -33970,13 +34177,18 @@ Examples:
             await mkdir12(dirname10(outputPath), { recursive: true });
             await writeFile22(outputPath, buffer);
           }
-          outputResult({
-            success: true,
-            provider: "gemini",
-            images: result.images.map((img) => ({
-              mimeType: img.mimeType
-            })),
-            outputPath
+          outputSuccess({
+            command: "generate image",
+            startedAt,
+            warnings: usedLabel.includes("fallback") ? [`Model "${options.model}" failed; fell back to flash`] : [],
+            data: {
+              provider: "gemini",
+              model: usedLabel,
+              images: result.images.map((img) => ({
+                mimeType: img.mimeType
+              })),
+              outputPath
+            }
           });
           return;
         }
@@ -34060,11 +34272,14 @@ Examples:
             await mkdir12(dirname10(outputPath), { recursive: true });
             await writeFile22(outputPath, buffer);
           }
-          outputResult({
-            success: true,
-            provider: "grok",
-            images: result.images.map((img) => ({ url: img.url })),
-            outputPath
+          outputSuccess({
+            command: "generate image",
+            startedAt,
+            data: {
+              provider: "grok",
+              images: result.images.map((img) => ({ url: img.url })),
+              outputPath
+            }
           });
           return;
         }
@@ -34135,11 +34350,14 @@ Examples:
           proc.on("close", (code) => {
             if (code === 0) {
               if (isJsonMode()) {
-                outputResult({
-                  success: true,
-                  provider: "runway",
-                  images: [{ format: "file" }],
-                  outputPath
+                outputSuccess({
+                  command: "generate image",
+                  startedAt,
+                  data: {
+                    provider: "runway",
+                    images: [{ format: "file" }],
+                    outputPath
+                  }
                 });
               } else {
                 spinner2.succeed(source_default.green("Generated image with Runway"));
@@ -35865,6 +36083,7 @@ Examples:
   $ vibe gen vid "epic scene" -i frame.png -o out.mp4 -p runway       # Image-to-video
   $ vibe gen vid "ocean waves" -o waves.mp4 -p veo --resolution 1080p # Veo
   $ vibe gen vid "sunset" -o sun.mp4 -d 10 --dry-run --json`).action(async (prompt3, options) => {
+    const startedAt = Date.now();
     try {
       if (!prompt3) {
         if (hasTTY()) {
@@ -35956,19 +36175,22 @@ Examples:
         options.ratio = "16:9";
       }
       if (options.dryRun) {
-        outputResult({
-          dryRun: true,
+        outputSuccess({
           command: "generate video",
-          params: {
-            prompt: prompt3,
-            provider,
-            duration: options.duration,
-            ratio: options.ratio,
-            image: options.image,
-            mode: options.mode,
-            negative: options.negative,
-            resolution: options.resolution,
-            veoModel: options.veoModel
+          startedAt,
+          dryRun: true,
+          data: {
+            params: {
+              prompt: prompt3,
+              provider,
+              duration: options.duration,
+              ratio: options.ratio,
+              image: options.image,
+              mode: options.mode,
+              negative: options.negative,
+              resolution: options.resolution,
+              veoModel: options.veoModel
+            }
           }
         });
         return;
@@ -36248,13 +36470,16 @@ Examples:
           outputPath = resolve29(process.cwd(), options.output);
           await writeFile25(outputPath, buffer);
         }
-        outputResult({
-          success: true,
-          provider,
-          taskId: result?.id,
-          videoUrl: finalResult.videoUrl,
-          duration: finalResult.duration,
-          outputPath
+        outputSuccess({
+          command: "generate video",
+          startedAt,
+          data: {
+            provider,
+            taskId: result?.id,
+            videoUrl: finalResult.videoUrl,
+            duration: finalResult.duration,
+            outputPath
+          }
         });
         return;
       }
@@ -37687,6 +37912,7 @@ Examples:
   $ vibe ed sc video.mp4 --dry-run --json
 
 No API key needed (FFmpeg only). Use --use-gemini for smart detection (requires GOOGLE_API_KEY).`).action(async (videoPath, options) => {
+    const startedAt = Date.now();
     try {
       if (options.output) {
         validateOutputPath(options.output);
@@ -37703,16 +37929,19 @@ No API key needed (FFmpeg only). Use --use-gemini for smart detection (requires
       const outputPath = options.output || `${name}-cut${ext}`;
       const useGemini = options.useGemini || false;
       if (options.dryRun) {
-        outputResult({
-          dryRun: true,
+        outputSuccess({
           command: "edit silence-cut",
-          params: {
-            videoPath: absVideoPath,
-            noiseThreshold: parseFloat(options.noise),
-            minDuration: parseFloat(options.minDuration),
-            padding: parseFloat(options.padding),
-            useGemini,
-            analyzeOnly: options.analyzeOnly || false
+          startedAt,
+          dryRun: true,
+          data: {
+            params: {
+              videoPath: absVideoPath,
+              noiseThreshold: parseFloat(options.noise),
+              minDuration: parseFloat(options.minDuration),
+              padding: parseFloat(options.padding),
+              useGemini,
+              analyzeOnly: options.analyzeOnly || false
+            }
           }
         });
         return;
@@ -37737,13 +37966,16 @@ No API key needed (FFmpeg only). Use --use-gemini for smart detection (requires
       }
       spinner2.succeed(source_default.green("Silence detection complete"));
       if (isJsonMode()) {
-        outputResult({
-          success: true,
-          method: result.method,
-          totalDuration: result.totalDuration,
-          silentPeriods: result.silentPeriods,
-          silentDuration: result.silentDuration,
-          outputPath: result.outputPath
+        outputSuccess({
+          command: "edit silence-cut",
+          startedAt,
+          data: {
+            method: result.method,
+            totalDuration: result.totalDuration,
+            silentPeriods: result.silentPeriods,
+            silentDuration: result.silentDuration,
+            outputPath: result.outputPath
+          }
         });
         return;
       }
@@ -37781,6 +38013,7 @@ Examples:
   $ vibe ed cap video.mp4 --dry-run --json
 
 Requires: OPENAI_API_KEY (Whisper transcription) + FFmpeg`).action(async (videoPath, options) => {
+    const startedAt = Date.now();
     try {
       if (options.output) {
         validateOutputPath(options.output);
@@ -37793,16 +38026,19 @@ Requires: OPENAI_API_KEY (Whisper transcription) + FFmpeg`).action(async (videoP
         exitWithError(generalError("FFmpeg not found. Install with: brew install ffmpeg (macOS) or apt install ffmpeg (Linux). Run `vibe doctor` for details."));
       }
       if (options.dryRun) {
-        outputResult({
-          dryRun: true,
+        outputSuccess({
           command: "edit caption",
-          params: {
-            videoPath: absVideoPath,
-            style: options.style,
-            fontSize: options.fontSize ? parseInt(options.fontSize) : void 0,
-            fontColor: options.color,
-            language: options.language,
-            position: options.position
+          startedAt,
+          dryRun: true,
+          data: {
+            params: {
+              videoPath: absVideoPath,
+              style: options.style,
+              fontSize: options.fontSize ? parseInt(options.fontSize) : void 0,
+              fontColor: options.color,
+              language: options.language,
+              position: options.position
+            }
           }
         });
         return;
@@ -37831,12 +38067,15 @@ Requires: OPENAI_API_KEY (Whisper transcription) + FFmpeg`).action(async (videoP
       }
       spinner2.succeed(source_default.green("Captions applied"));
       if (isJsonMode()) {
-        outputResult({
-          success: true,
-          segmentCount: result.segmentCount,
-          style: options.style || "bold",
-          outputPath: result.outputPath,
-          srtPath: result.srtPath
+        outputSuccess({
+          command: "edit caption",
+          startedAt,
+          data: {
+            segmentCount: result.segmentCount,
+            style: options.style || "bold",
+            outputPath: result.outputPath,
+            srtPath: result.srtPath
+          }
         });
         return;
       }
@@ -37855,6 +38094,7 @@ Requires: OPENAI_API_KEY (Whisper transcription) + FFmpeg`).action(async (videoP
     }
   });
   aiCommand.command("noise-reduce").description("Remove background noise from audio/video using FFmpeg (no API key needed)").argument("<input>", "Audio or video file path").option("-o, --output <path>", "Output file path (default: <name>-denoised.<ext>)").option("-s, --strength <level>", "Noise reduction strength: low, medium, high (default: medium)", "medium").option("-n, --noise-floor <dB>", "Custom noise floor in dB (overrides strength preset)").option("--dry-run", "Preview parameters without executing").action(async (inputPath, options) => {
+    const startedAt = Date.now();
     try {
       if (options.output) {
         validateOutputPath(options.output);
@@ -37867,13 +38107,16 @@ Requires: OPENAI_API_KEY (Whisper transcription) + FFmpeg`).action(async (videoP
         exitWithError(generalError("FFmpeg not found. Install with: brew install ffmpeg (macOS) or apt install ffmpeg (Linux). Run `vibe doctor` for details."));
       }
       if (options.dryRun) {
-        outputResult({
-          dryRun: true,
+        outputSuccess({
           command: "edit noise-reduce",
-          params: {
-            inputPath: absInputPath,
-            strength: options.strength,
-            noiseFloor: options.noiseFloor ? parseFloat(options.noiseFloor) : void 0
+          startedAt,
+          dryRun: true,
+          data: {
+            params: {
+              inputPath: absInputPath,
+              strength: options.strength,
+              noiseFloor: options.noiseFloor ? parseFloat(options.noiseFloor) : void 0
+            }
           }
         });
         return;
@@ -37894,11 +38137,14 @@ Requires: OPENAI_API_KEY (Whisper transcription) + FFmpeg`).action(async (videoP
       }
       spinner2.succeed(source_default.green("Noise reduction complete"));
       if (isJsonMode()) {
-        outputResult({
-          success: true,
-          inputDuration: result.inputDuration,
-          strength: options.strength || "medium",
-          outputPath: result.outputPath
+        outputSuccess({
+          command: "edit noise-reduce",
+          startedAt,
+          data: {
+            inputDuration: result.inputDuration,
+            strength: options.strength || "medium",
+            outputPath: result.outputPath
+          }
         });
         return;
       }
@@ -37914,6 +38160,7 @@ Requires: OPENAI_API_KEY (Whisper transcription) + FFmpeg`).action(async (videoP
     }
   });
   aiCommand.command("fade").description("Apply fade in/out effects to video (FFmpeg only, no API key needed)").argument("<video>", "Video file path").option("-o, --output <path>", "Output file path (default: <name>-faded.<ext>)").option("--fade-in <seconds>", "Fade-in duration in seconds (default: 1)", "1").option("--fade-out <seconds>", "Fade-out duration in seconds (default: 1)", "1").option("--audio-only", "Apply fade to audio only (video stream copied)").option("--video-only", "Apply fade to video only (audio stream copied)").option("--dry-run", "Preview parameters without executing").action(async (videoPath, options) => {
+    const startedAt = Date.now();
     try {
       if (options.output) {
         validateOutputPath(options.output);
@@ -37926,15 +38173,18 @@ Requires: OPENAI_API_KEY (Whisper transcription) + FFmpeg`).action(async (videoP
         exitWithError(generalError("FFmpeg not found. Install with: brew install ffmpeg (macOS) or apt install ffmpeg (Linux). Run `vibe doctor` for details."));
       }
       if (options.dryRun) {
-        outputResult({
-          dryRun: true,
+        outputSuccess({
           command: "edit fade",
-          params: {
-            videoPath: absVideoPath,
-            fadeIn: parseFloat(options.fadeIn),
-            fadeOut: parseFloat(options.fadeOut),
-            audioOnly: options.audioOnly || false,
-            videoOnly: options.videoOnly || false
+          startedAt,
+          dryRun: true,
+          data: {
+            params: {
+              videoPath: absVideoPath,
+              fadeIn: parseFloat(options.fadeIn),
+              fadeOut: parseFloat(options.fadeOut),
+              audioOnly: options.audioOnly || false,
+              videoOnly: options.videoOnly || false
+            }
           }
         });
         return;
@@ -37957,12 +38207,15 @@ Requires: OPENAI_API_KEY (Whisper transcription) + FFmpeg`).action(async (videoP
       }
       spinner2.succeed(source_default.green("Fade effects applied"));
       if (isJsonMode()) {
-        outputResult({
-          success: true,
-          totalDuration: result.totalDuration,
-          fadeInApplied: result.fadeInApplied,
-          fadeOutApplied: result.fadeOutApplied,
-          outputPath: result.outputPath
+        outputSuccess({
+          command: "edit fade",
+          startedAt,
+          data: {
+            totalDuration: result.totalDuration,
+            fadeInApplied: result.fadeInApplied,
+            fadeOutApplied: result.fadeOutApplied,
+            outputPath: result.outputPath
+          }
         });
         return;
       }
@@ -37979,6 +38232,7 @@ Requires: OPENAI_API_KEY (Whisper transcription) + FFmpeg`).action(async (videoP
     }
   });
   aiCommand.command("translate-srt").description("Translate SRT subtitle file to another language (Claude/OpenAI)").argument("<srt>", "SRT file path").option("-t, --target <language>", "Target language (e.g., ko, es, fr, ja, zh)").option("-o, --output <path>", "Output file path (default: <name>-<target>.srt)").option("-p, --provider <provider>", "Translation provider: claude, openai (default: claude)", "claude").option("--source <language>", "Source language (auto-detected if omitted)").option("-k, --api-key <key>", "API key (or set ANTHROPIC_API_KEY / OPENAI_API_KEY env)").option("--dry-run", "Preview parameters without executing").action(async (srtPath, options) => {
+    const startedAt = Date.now();
     try {
       if (options.output) {
         validateOutputPath(options.output);
@@ -37991,14 +38245,17 @@ Requires: OPENAI_API_KEY (Whisper transcription) + FFmpeg`).action(async (videoP
         exitWithError(notFoundError(absSrtPath));
       }
       if (options.dryRun) {
-        outputResult({
-          dryRun: true,
+        outputSuccess({
           command: "edit translate-srt",
-          params: {
-            srtPath: absSrtPath,
-            targetLanguage: options.target,
-            provider: options.provider || "claude",
-            sourceLanguage: options.source
+          startedAt,
+          dryRun: true,
+          data: {
+            params: {
+              srtPath: absSrtPath,
+              targetLanguage: options.target,
+              provider: options.provider || "claude",
+              sourceLanguage: options.source
+            }
           }
         });
         return;
@@ -38028,12 +38285,15 @@ Requires: OPENAI_API_KEY (Whisper transcription) + FFmpeg`).action(async (videoP
       }
       spinner2.succeed(source_default.green("Translation complete"));
       if (isJsonMode()) {
-        outputResult({
-          success: true,
-          segmentCount: result.segmentCount,
-          sourceLanguage: result.sourceLanguage,
-          targetLanguage: result.targetLanguage,
-          outputPath: result.outputPath
+        outputSuccess({
+          command: "edit translate-srt",
+          startedAt,
+          data: {
+            segmentCount: result.segmentCount,
+            sourceLanguage: result.sourceLanguage,
+            targetLanguage: result.targetLanguage,
+            outputPath: result.outputPath
+          }
         });
         return;
       }
@@ -38050,6 +38310,7 @@ Requires: OPENAI_API_KEY (Whisper transcription) + FFmpeg`).action(async (videoP
     }
   });
   aiCommand.command("jump-cut").description("Remove filler words (um, uh, like, etc.) from video using Whisper word-level timestamps").argument("<video>", "Video file path").option("-o, --output <path>", "Output file path (default: <name>-jumpcut.<ext>)").option("--fillers <words>", "Comma-separated filler words to detect").option("--padding <seconds>", "Padding around cuts in seconds (default: 0.05)", "0.05").option("-l, --language <lang>", "Language code for transcription (e.g., en, ko)").option("--analyze-only", "Only detect fillers, don't cut").option("-k, --api-key <key>", "OpenAI API key (or set OPENAI_API_KEY env)").option("--dry-run", "Preview parameters without executing").action(async (videoPath, options) => {
+    const startedAt = Date.now();
     try {
       if (options.output) {
         validateOutputPath(options.output);
@@ -38064,15 +38325,18 @@ Requires: OPENAI_API_KEY (Whisper transcription) + FFmpeg`).action(async (videoP
       }
       if (options.dryRun) {
         const fillers2 = options.fillers ? options.fillers.split(",").map((f) => f.trim()) : void 0;
-        outputResult({
-          dryRun: true,
+        outputSuccess({
           command: "edit jump-cut",
-          params: {
-            videoPath: absVideoPath,
-            fillers: fillers2,
-            padding: parseFloat(options.padding),
-            language: options.language,
-            analyzeOnly: options.analyzeOnly || false
+          startedAt,
+          dryRun: true,
+          data: {
+            params: {
+              videoPath: absVideoPath,
+              fillers: fillers2,
+              padding: parseFloat(options.padding),
+              language: options.language,
+              analyzeOnly: options.analyzeOnly || false
+            }
           }
         });
         return;
@@ -38101,13 +38365,16 @@ Requires: OPENAI_API_KEY (Whisper transcription) + FFmpeg`).action(async (videoP
       }
       spinner2.succeed(source_default.green("Filler detection complete"));
       if (isJsonMode()) {
-        outputResult({
-          success: true,
-          totalDuration: result.totalDuration,
-          fillerCount: result.fillerCount,
-          fillerDuration: result.fillerDuration,
-          fillers: result.fillers,
-          outputPath: result.outputPath
+        outputSuccess({
+          command: "edit jump-cut",
+          startedAt,
+          data: {
+            totalDuration: result.totalDuration,
+            fillerCount: result.fillerCount,
+            fillerDuration: result.fillerDuration,
+            fillers: result.fillers,
+            outputPath: result.outputPath
+          }
         });
         return;
       }
@@ -38909,6 +39176,7 @@ Run 'vibe schema edit.<command>' for structured parameter info.
     registerEditCommands(editCommand);
     registerFillGapsCommand(editCommand);
     editCommand.command("grade").description("Apply AI-generated color grading (Claude + FFmpeg)").argument("<video>", "Video file path").option("-s, --style <prompt>", "Style description (e.g., 'cinematic warm')").option("--preset <name>", "Built-in preset: film-noir, vintage, cinematic-warm, cool-tones, high-contrast, pastel, cyberpunk, horror").option("-o, --output <path>", "Output video file path").option("--analyze-only", "Show filter without applying").option("-k, --api-key <key>", "Anthropic API key (or set ANTHROPIC_API_KEY env)").option("--dry-run", "Preview parameters without executing").action(async (videoPath, options) => {
+      const startedAt = Date.now();
       try {
         if (options.style) rejectControlChars(options.style);
         if (options.output) {
@@ -38924,13 +39192,16 @@ Run 'vibe schema edit.<command>' for structured parameter info.
           exitWithError(notFoundError("FFmpeg not found. Install with: brew install ffmpeg"));
         }
         if (options.dryRun) {
-          outputResult({
-            dryRun: true,
+          outputSuccess({
             command: "edit grade",
-            params: {
-              videoPath: resolve33(process.cwd(), videoPath),
-              style: options.style || options.preset,
-              analyzeOnly: options.analyzeOnly || false
+            startedAt,
+            dryRun: true,
+            data: {
+              params: {
+                videoPath: resolve33(process.cwd(), videoPath),
+                style: options.style || options.preset,
+                analyzeOnly: options.analyzeOnly || false
+              }
             }
           });
           return;
@@ -38956,12 +39227,15 @@ Run 'vibe schema edit.<command>' for structured parameter info.
         if (isJsonMode()) {
           const absPath2 = resolve33(process.cwd(), videoPath);
           const gradeOutputPath = options.output ? resolve33(process.cwd(), options.output) : absPath2.replace(/(\.[^.]+)$/, "-graded$1");
-          outputResult({
-            success: true,
-            style: options.preset || options.style,
-            description: gradeResult.description,
-            ffmpegFilter: gradeResult.ffmpegFilter,
-            outputPath: options.analyzeOnly ? void 0 : gradeOutputPath
+          outputSuccess({
+            command: "edit grade",
+            startedAt,
+            data: {
+              style: options.preset || options.style,
+              description: gradeResult.description,
+              ffmpegFilter: gradeResult.ffmpegFilter,
+              outputPath: options.analyzeOnly ? void 0 : gradeOutputPath
+            }
           });
           return;
         }
@@ -38990,6 +39264,7 @@ Run 'vibe schema edit.<command>' for structured parameter info.
       }
     });
     editCommand.command("text-overlay").description("Apply text overlays to video (FFmpeg drawtext)").argument("<video>", "Video file path").option("-t, --text <texts...>", "Text lines to overlay (repeat for multiple)").option("-s, --style <style>", "Overlay style: lower-third, center-bold, subtitle, minimal", "lower-third").option("--font-size <size>", "Font size in pixels (auto-calculated if omitted)").option("--font-color <color>", "Font color (default: white)", "white").option("--fade <seconds>", "Fade in/out duration in seconds", "0.3").option("--start <seconds>", "Start time in seconds", "0").option("--end <seconds>", "End time in seconds (default: video duration)").option("-o, --output <path>", "Output video file path").option("--dry-run", "Preview parameters without executing").action(async (videoPath, options) => {
+      const startedAt = Date.now();
       try {
         if (!options.text || options.text.length === 0) {
           exitWithError(usageError("At least one --text option is required", 'Example: vibe edit text-overlay video.mp4 -t "NEXUS AI" --style center-bold'));
@@ -39002,18 +39277,21 @@ Run 'vibe schema edit.<command>' for structured parameter info.
           exitWithError(generalError("FFmpeg not found", "Install with: brew install ffmpeg (macOS) or apt install ffmpeg (Linux)"));
         }
         if (options.dryRun) {
-          outputResult({
-            dryRun: true,
+          outputSuccess({
             command: "edit text-overlay",
-            params: {
-              videoPath: resolve33(process.cwd(), videoPath),
-              texts: options.text,
-              style: options.style,
-              fontSize: options.fontSize ? parseInt(options.fontSize) : void 0,
-              fontColor: options.fontColor,
-              fade: parseFloat(options.fade),
-              start: parseFloat(options.start),
-              end: options.end ? parseFloat(options.end) : void 0
+            startedAt,
+            dryRun: true,
+            data: {
+              params: {
+                videoPath: resolve33(process.cwd(), videoPath),
+                texts: options.text,
+                style: options.style,
+                fontSize: options.fontSize ? parseInt(options.fontSize) : void 0,
+                fontColor: options.fontColor,
+                fade: parseFloat(options.fade),
+                start: parseFloat(options.start),
+                end: options.end ? parseFloat(options.end) : void 0
+              }
             }
           });
           return;
@@ -39038,11 +39316,14 @@ Run 'vibe schema edit.<command>' for structured parameter info.
         }
         spinner2.succeed(source_default.green("Text overlays applied"));
         if (isJsonMode()) {
-          outputResult({
-            success: true,
-            style: options.style,
-            texts: options.text,
-            outputPath: result.outputPath
+          outputSuccess({
+            command: "edit text-overlay",
+            startedAt,
+            data: {
+              style: options.style,
+              texts: options.text,
+              outputPath: result.outputPath
+            }
           });
           return;
         }
@@ -39059,6 +39340,7 @@ Run 'vibe schema edit.<command>' for structured parameter info.
       }
     });
     editCommand.command("speed-ramp").description("Apply content-aware speed ramping (Whisper + Claude + FFmpeg)").argument("<video>", "Video file path").option("-o, --output <path>", "Output video file path").option("-s, --style <style>", "Style: dramatic, smooth, action", "dramatic").option("--min-speed <factor>", "Minimum speed factor", "0.25").option("--max-speed <factor>", "Maximum speed factor", "4.0").option("--analyze-only", "Show keyframes without applying").option("-l, --language <lang>", "Language code for transcription").option("-k, --api-key <key>", "Anthropic API key (or set ANTHROPIC_API_KEY env)").option("--dry-run", "Preview parameters without executing").action(async (videoPath, options) => {
+      const startedAt = Date.now();
       try {
         if (options.output) {
           validateOutputPath(options.output);
@@ -39067,15 +39349,18 @@ Run 'vibe schema edit.<command>' for structured parameter info.
           exitWithError(generalError("FFmpeg not found", "Install with: brew install ffmpeg (macOS) or apt install ffmpeg (Linux)"));
         }
         if (options.dryRun) {
-          outputResult({
-            dryRun: true,
+          outputSuccess({
             command: "edit speed-ramp",
-            params: {
-              videoPath: resolve33(process.cwd(), videoPath),
-              style: options.style,
-              minSpeed: parseFloat(options.minSpeed),
-              maxSpeed: parseFloat(options.maxSpeed),
-              analyzeOnly: options.analyzeOnly || false
+            startedAt,
+            dryRun: true,
+            data: {
+              params: {
+                videoPath: resolve33(process.cwd(), videoPath),
+                style: options.style,
+                minSpeed: parseFloat(options.minSpeed),
+                maxSpeed: parseFloat(options.maxSpeed),
+                analyzeOnly: options.analyzeOnly || false
+              }
             }
           });
           return;
@@ -39128,11 +39413,14 @@ Run 'vibe schema edit.<command>' for structured parameter info.
         if (isJsonMode()) {
           const avgSpeed2 = speedResult.keyframes.reduce((sum, kf) => sum + kf.speed, 0) / speedResult.keyframes.length;
           const speedRampOutputPath = options.output ? resolve33(process.cwd(), options.output) : absPath.replace(/(\.[^.]+)$/, "-ramped$1");
-          outputResult({
-            success: true,
-            keyframes: speedResult.keyframes,
-            avgSpeed: avgSpeed2,
-            outputPath: options.analyzeOnly ? void 0 : speedRampOutputPath
+          outputSuccess({
+            command: "edit speed-ramp",
+            startedAt,
+            data: {
+              keyframes: speedResult.keyframes,
+              avgSpeed: avgSpeed2,
+              outputPath: options.analyzeOnly ? void 0 : speedRampOutputPath
+            }
           });
           return;
         }
@@ -39172,6 +39460,7 @@ Run 'vibe schema edit.<command>' for structured parameter info.
       }
     });
     editCommand.command("reframe").description("Auto-reframe video to different aspect ratio (Claude Vision + FFmpeg)").argument("<video>", "Video file path").option("-a, --aspect <ratio>", "Target aspect ratio: 9:16, 1:1, 4:5", "9:16").option("-f, --focus <mode>", "Focus mode: auto, face, center, action", "auto").option("-o, --output <path>", "Output video file path").option("--analyze-only", "Show crop regions without applying").option("--keyframes <path>", "Export keyframes to JSON file").option("-k, --api-key <key>", "Anthropic API key (or set ANTHROPIC_API_KEY env)").option("--dry-run", "Preview parameters without executing").action(async (videoPath, options) => {
+      const startedAt = Date.now();
       try {
         if (options.output) {
           validateOutputPath(options.output);
@@ -39180,14 +39469,17 @@ Run 'vibe schema edit.<command>' for structured parameter info.
           exitWithError(generalError("FFmpeg not found", "Install with: brew install ffmpeg (macOS) or apt install ffmpeg (Linux)"));
         }
         if (options.dryRun) {
-          outputResult({
-            dryRun: true,
+          outputSuccess({
             command: "edit reframe",
-            params: {
-              videoPath: resolve33(process.cwd(), videoPath),
-              aspect: options.aspect,
-              focus: options.focus,
-              analyzeOnly: options.analyzeOnly || false
+            startedAt,
+            dryRun: true,
+            data: {
+              params: {
+                videoPath: resolve33(process.cwd(), videoPath),
+                aspect: options.aspect,
+                focus: options.focus,
+                analyzeOnly: options.analyzeOnly || false
+              }
             }
           });
           return;
@@ -39255,13 +39547,16 @@ Run 'vibe schema edit.<command>' for structured parameter info.
         spinner2.succeed(source_default.green(`Analyzed ${cropKeyframes.length} keyframes`));
         if (isJsonMode()) {
           const reframeOutputPath = options.output ? resolve33(process.cwd(), options.output) : absPath.replace(/(\.[^.]+)$/, `-${options.aspect.replace(":", "x")}$1`);
-          outputResult({
-            success: true,
-            sourceWidth,
-            sourceHeight,
-            aspect: options.aspect,
-            cropKeyframes,
-            outputPath: options.analyzeOnly ? void 0 : reframeOutputPath
+          outputSuccess({
+            command: "edit reframe",
+            startedAt,
+            data: {
+              sourceWidth,
+              sourceHeight,
+              aspect: options.aspect,
+              cropKeyframes,
+              outputPath: options.analyzeOnly ? void 0 : reframeOutputPath
+            }
           });
           return;
         }
@@ -39312,6 +39607,7 @@ Run 'vibe schema edit.<command>' for structured parameter info.
       }
     });
     editCommand.command("image").description("Edit image(s) using AI (Gemini/OpenAI/Grok)").argument("<images...>", "Input image file(s) followed by edit prompt").option("-p, --provider <provider>", "Provider: gemini (default), openai, grok", "gemini").option("-k, --api-key <key>", "API key (or set env variable)").option("-o, --output <path>", "Output file path", "edited.png").option("-m, --model <model>", "Model: flash/3.1-flash/latest/pro (Gemini only)", "flash").option("-r, --ratio <ratio>", "Output aspect ratio").option("-s, --size <resolution>", "Resolution: 1K, 2K, 4K (Gemini Pro only)").option("--dry-run", "Preview parameters without executing").action(async (args, options) => {
+      const startedAt = Date.now();
       try {
         if (args.length < 2) {
           exitWithError(usageError("Need at least one image and a prompt"));
@@ -39327,16 +39623,19 @@ Run 'vibe schema edit.<command>' for structured parameter info.
           exitWithError(usageError("Grok supports only 1 input image for editing.", "Use -p gemini (up to 14 images) or -p openai (up to 16 images) for multi-image editing."));
         }
         if (options.dryRun) {
-          outputResult({
-            dryRun: true,
+          outputSuccess({
             command: "edit image",
-            params: {
-              imagePaths: imagePaths.map((p) => resolve33(process.cwd(), p)),
-              prompt: prompt3,
-              provider,
-              model: options.model,
-              ratio: options.ratio,
-              size: options.size
+            startedAt,
+            dryRun: true,
+            data: {
+              params: {
+                imagePaths: imagePaths.map((p) => resolve33(process.cwd(), p)),
+                prompt: prompt3,
+                provider,
+                model: options.model,
+                ratio: options.ratio,
+                size: options.size
+              }
             }
           });
           return;
@@ -39414,11 +39713,14 @@ Run 'vibe schema edit.<command>' for structured parameter info.
         };
         const resultModel = result.model;
         if (isJsonMode()) {
-          outputResult({
-            success: true,
-            provider,
-            model: resultModel || options.model,
-            outputPath
+          outputSuccess({
+            command: "edit image",
+            startedAt,
+            data: {
+              provider,
+              model: resultModel || options.model,
+              outputPath
+            }
           });
           await saveImage();
           return;
@@ -39434,6 +39736,7 @@ Run 'vibe schema edit.<command>' for structured parameter info.
       }
     });
     editCommand.command("interpolate").description("Create slow motion with frame interpolation (FFmpeg)").argument("<video>", "Video file path").option("-o, --output <path>", "Output file path").option("-f, --factor <number>", "Slow motion factor: 2, 4, or 8", "2").option("--fps <number>", "Target output FPS").option("--quality <mode>", "Quality: fast or quality", "quality").option("--dry-run", "Preview parameters without executing").action(async (videoPath, options) => {
+      const startedAt = Date.now();
       try {
         if (options.output) {
           validateOutputPath(options.output);
@@ -39444,14 +39747,17 @@ Run 'vibe schema edit.<command>' for structured parameter info.
           exitWithError(usageError("Factor must be 2, 4, or 8"));
         }
         if (options.dryRun) {
-          outputResult({
-            dryRun: true,
+          outputSuccess({
             command: "edit interpolate",
-            params: {
-              videoPath: absPath,
-              factor,
-              fps: options.fps ? parseInt(options.fps) : void 0,
-              quality: options.quality
+            startedAt,
+            dryRun: true,
+            data: {
+              params: {
+                videoPath: absPath,
+                factor,
+                fps: options.fps ? parseInt(options.fps) : void 0,
+                quality: options.quality
+              }
             }
           });
           return;
@@ -39478,12 +39784,15 @@ Run 'vibe schema edit.<command>' for structured parameter info.
           await execSafe("ffmpeg", ["-i", absPath, "-filter:v", `minterpolate='${mi}:fps=${targetFps}',setpts=${factor}*PTS`, "-an", outputPath, "-y"], { timeout: 6e5 });
           spinner2.succeed(source_default.green(`Created ${factor}x slow motion`));
           if (isJsonMode()) {
-            outputResult({
-              success: true,
-              originalFps,
-              targetFps,
-              factor,
-              outputPath
+            outputSuccess({
+              command: "edit interpolate",
+              startedAt,
+              data: {
+                originalFps,
+                targetFps,
+                factor,
+                outputPath
+              }
             });
             return;
           }
@@ -39509,6 +39818,7 @@ Run 'vibe schema edit.<command>' for structured parameter info.
       }
     });
     editCommand.command("upscale-video").description("Upscale video resolution using AI or FFmpeg").argument("<video>", "Video file path").option("-o, --output <path>", "Output file path").option("-s, --scale <factor>", "Scale factor: 2 or 4", "2").option("-m, --model <model>", "Model: real-esrgan, topaz", "real-esrgan").option("--ffmpeg", "Use FFmpeg lanczos (free, no API)").option("-k, --api-key <key>", "Replicate API token (or set REPLICATE_API_TOKEN env)").option("--no-wait", "Start processing and return task ID without waiting").option("--dry-run", "Preview parameters without executing").action(async (videoPath, options) => {
+      const startedAt = Date.now();
       try {
         if (options.output) {
           validateOutputPath(options.output);
@@ -39519,14 +39829,17 @@ Run 'vibe schema edit.<command>' for structured parameter info.
           exitWithError(usageError("Scale must be 2 or 4"));
         }
         if (options.dryRun) {
-          outputResult({
-            dryRun: true,
+          outputSuccess({
             command: "edit upscale-video",
-            params: {
-              videoPath: absPath,
-              scale,
-              model: options.model,
-              ffmpeg: options.ffmpeg || false
+            startedAt,
+            dryRun: true,
+            data: {
+              params: {
+                videoPath: absPath,
+                scale,
+                model: options.model,
+                ffmpeg: options.ffmpeg || false
+              }
             }
           });
           return;
@@ -39552,10 +39865,13 @@ Run 'vibe schema edit.<command>' for structured parameter info.
             await execSafe("ffmpeg", ["-i", absPath, "-vf", `scale=${newWidth}:${newHeight}:flags=lanczos`, "-c:a", "copy", outputPath, "-y"]);
             spinner3.succeed(source_default.green(`Upscaled to ${newWidth}x${newHeight}`));
             if (isJsonMode()) {
-              outputResult({
-                success: true,
-                dimensions: `${newWidth}x${newHeight}`,
-                outputPath
+              outputSuccess({
+                command: "edit upscale-video",
+                startedAt,
+                data: {
+                  dimensions: `${newWidth}x${newHeight}`,
+                  outputPath
+                }
               });
               return;
             }
@@ -39995,21 +40311,25 @@ Score each category 1-10. For fixable issues, provide an FFmpeg filter in autoFi
 }
 function registerReviewCommand(aiCommand) {
   aiCommand.command("review").description("Review video quality using Gemini AI and optionally auto-fix issues").argument("<video>", "Video file path").option("-s, --storyboard <path>", "Storyboard JSON file for context").option("--auto-apply", "Automatically apply fixable corrections").option("--verify", "Run verification pass after applying fixes").option("-m, --model <model>", "Gemini model: flash (default), flash-2.5, pro", "flash").option("-o, --output <path>", "Output video file path (for auto-apply)").option("--dry-run", "Preview parameters without executing").action(async (videoPath, options) => {
+    const startedAt = Date.now();
     try {
       if (options.output) {
         validateOutputPath(options.output);
       }
       if (options.dryRun) {
-        outputResult({
-          dryRun: true,
+        outputSuccess({
           command: "ai review",
-          params: {
-            videoPath,
-            storyboard: options.storyboard,
-            autoApply: options.autoApply ?? false,
-            verify: options.verify ?? false,
-            model: options.model,
-            output: options.output
+          startedAt,
+          dryRun: true,
+          data: {
+            params: {
+              videoPath,
+              storyboard: options.storyboard,
+              autoApply: options.autoApply ?? false,
+              verify: options.verify ?? false,
+              model: options.model,
+              output: options.output
+            }
           }
         });
         return;
@@ -40543,6 +40863,7 @@ Analyze both VISUALS (expressions, actions, scene changes) and AUDIO (speech, re
 }
 function registerHighlightsCommands(aiCommand) {
   aiCommand.command("highlights").description("Extract highlights from long-form video/audio content").argument("<media>", "Video or audio file path").option("-o, --output <path>", "Output JSON file with highlights").option("--project <path>", "Create project with highlight clips").option("-d, --duration <seconds>", "Target highlight reel duration", "60").option("-n, --count <number>", "Maximum number of highlights").option("-t, --threshold <value>", "Confidence threshold (0-1)", "0.7").option("--criteria <type>", "Selection criteria: emotional | informative | funny | all", "all").option("-l, --language <lang>", "Language code for transcription (e.g., en, ko)").option("--use-gemini", "Use Gemini Video Understanding for enhanced visual+audio analysis").option("--low-res", "Use low resolution mode for longer videos (Gemini only)").option("--dry-run", "Preview parameters without executing").action(async (mediaPath, options) => {
+    const startedAt = Date.now();
     try {
       if (options.output) {
         validateOutputPath(options.output);
@@ -40552,20 +40873,23 @@ function registerHighlightsCommands(aiCommand) {
         exitWithError(notFoundError(absPath));
       }
       if (options.dryRun) {
-        outputResult({
-          dryRun: true,
+        outputSuccess({
           command: "ai highlights",
-          params: {
-            mediaPath,
-            output: options.output,
-            project: options.project,
-            duration: options.duration,
-            count: options.count,
-            threshold: options.threshold,
-            criteria: options.criteria,
-            language: options.language,
-            useGemini: options.useGemini ?? false,
-            lowRes: options.lowRes ?? false
+          startedAt,
+          dryRun: true,
+          data: {
+            params: {
+              mediaPath,
+              output: options.output,
+              project: options.project,
+              duration: options.duration,
+              count: options.count,
+              threshold: options.threshold,
+              criteria: options.criteria,
+              language: options.language,
+              useGemini: options.useGemini ?? false,
+              lowRes: options.lowRes ?? false
+            }
           }
         });
         return;
@@ -40758,13 +41082,13 @@ Analyze both what is SHOWN (visual cues, actions, expressions) and what is SAID
         });
         if (allHighlights.length === 0) {
           analyzeSpinner.warn(source_default.yellow("No highlights detected in the content"));
-          process.exit(0);
+          return;
         }
         analyzeSpinner.succeed(source_default.green(`Found ${allHighlights.length} potential highlights`));
       }
       if (allHighlights.length === 0) {
         console.log(source_default.yellow("No highlights detected in the content"));
-        process.exit(0);
+        return;
       }
       const filterSpinner = ora("\u{1F4CA} Filtering and ranking...").start();
       const threshold = parseFloat(options.threshold);
@@ -40840,6 +41164,7 @@ Analyze both what is SHOWN (visual cues, actions, expressions) and what is SAID
     }
   });
   aiCommand.command("auto-shorts").alias("shorts").description("Auto-generate shorts from long-form video").argument("<video>", "Video file path").option("-o, --output <path>", "Output file (single) or directory (multiple)").option("-d, --duration <seconds>", "Target duration in seconds (15-60)", "60").option("-n, --count <number>", "Number of shorts to generate", "1").option("-a, --aspect <ratio>", "Aspect ratio: 9:16, 1:1", "9:16").option("--output-dir <dir>", "Output directory for multiple shorts").option("--add-captions", "Add auto-generated captions").option("--caption-style <style>", "Caption style: minimal, bold, animated", "bold").option("--analyze-only", "Show segments without generating").option("-l, --language <lang>", "Language code for transcription").option("--use-gemini", "Use Gemini Video Understanding for enhanced visual+audio analysis").option("--low-res", "Use low resolution mode for longer videos (Gemini only)").option("--dry-run", "Preview parameters without executing").action(async (videoPath, options) => {
+    const startedAt = Date.now();
     try {
       if (options.output) {
         validateOutputPath(options.output);
@@ -40849,22 +41174,25 @@ Analyze both what is SHOWN (visual cues, actions, expressions) and what is SAID
         exitWithError(notFoundError(absPath));
       }
       if (options.dryRun) {
-        outputResult({
-          dryRun: true,
+        outputSuccess({
           command: "ai auto-shorts",
-          params: {
-            videoPath,
-            output: options.output,
-            duration: options.duration,
-            count: options.count,
-            aspect: options.aspect,
-            outputDir: options.outputDir,
-            addCaptions: options.addCaptions ?? false,
-            captionStyle: options.captionStyle,
-            analyzeOnly: options.analyzeOnly ?? false,
-            language: options.language,
-            useGemini: options.useGemini ?? false,
-            lowRes: options.lowRes ?? false
+          startedAt,
+          dryRun: true,
+          data: {
+            params: {
+              videoPath,
+              output: options.output,
+              duration: options.duration,
+              count: options.count,
+              aspect: options.aspect,
+              outputDir: options.outputDir,
+              addCaptions: options.addCaptions ?? false,
+              captionStyle: options.captionStyle,
+              analyzeOnly: options.analyzeOnly ?? false,
+              language: options.language,
+              useGemini: options.useGemini ?? false,
+              lowRes: options.lowRes ?? false
+            }
           }
         });
         return;
@@ -51752,13 +52080,13 @@ function getPresetSettings(preset, aspectRatio) {
   }
   return settings;
 }
-async function runHyperframesExport(projectPath, options, spinner2) {
+async function runHyperframesExport(projectPath, options, spinner2, startedAt) {
   spinner2.text = "Loading project...";
   const { readFile: readFile42 } = await import("node:fs/promises");
   const { resolve: resolve62, basename: basename22 } = await import("node:path");
   const { Project: Project2 } = await Promise.resolve().then(() => (init_engine(), engine_exports));
   const { createHyperframesBackend: createHyperframesBackend2 } = await Promise.resolve().then(() => (init_hyperframes(), hyperframes_exports));
-  const { exitWithError: exitWithError2, generalError: generalError2, outputResult: outputResult2 } = await Promise.resolve().then(() => (init_output(), output_exports));
+  const { exitWithError: exitWithError2, generalError: generalError2, outputSuccess: outputSuccess2 } = await Promise.resolve().then(() => (init_output(), output_exports));
   const chalk2 = (await Promise.resolve().then(() => (init_source(), source_exports))).default;
   const filePath = resolve62(process.cwd(), projectPath);
   const content = await readFile42(filePath, "utf-8");
@@ -51784,10 +52112,10 @@ async function runHyperframesExport(projectPath, options, spinner2) {
     return;
   }
   spinner2.succeed(chalk2.green(`Exported: ${result.outputPath}`));
-  outputResult2({
-    success: true,
+  outputSuccess2({
     command: "export",
-    result: {
+    startedAt,
+    data: {
       outputPath: result.outputPath,
       backend: "hyperframes",
       durationMs: result.durationMs,
@@ -51831,6 +52159,7 @@ Cost: Free (no API keys needed). Requires FFmpeg.
 GIF format: 15fps, no audio, looping. Good for previews and sharing.
 Custom flags (--bitrate, --fps, --resolution, --codec) override preset values.
 Run 'vibe schema export' for structured parameter info.`).action(async (projectPath, options) => {
+      const startedAt = Date.now();
       const spinner2 = ora("Checking FFmpeg...").start();
       try {
         if (options.output) {
@@ -51848,27 +52177,30 @@ Run 'vibe schema export' for structured parameter info.`).action(async (projectP
           exitWithError(usageError(overrideError));
         }
         if (options.dryRun) {
-          outputResult({
-            dryRun: true,
+          outputSuccess({
             command: "export",
-            params: {
-              project: projectPath,
-              output: options.output || null,
-              format: options.format,
-              preset: options.preset,
-              overwrite: options.overwrite,
-              gapFill: options.gapFill,
-              backend: options.backend,
-              bitrate: options.bitrate ?? null,
-              fps: customOverrides.fps ?? null,
-              resolution: options.resolution ?? null,
-              codec: options.codec ?? null
+            startedAt,
+            dryRun: true,
+            data: {
+              params: {
+                project: projectPath,
+                output: options.output || null,
+                format: options.format,
+                preset: options.preset,
+                overwrite: options.overwrite,
+                gapFill: options.gapFill,
+                backend: options.backend,
+                bitrate: options.bitrate ?? null,
+                fps: customOverrides.fps ?? null,
+                resolution: options.resolution ?? null,
+                codec: options.codec ?? null
+              }
             }
           });
           return;
         }
         if (options.backend === "hyperframes") {
-          await runHyperframesExport(projectPath, options, spinner2);
+          await runHyperframesExport(projectPath, options, spinner2, startedAt);
           return;
         }
         const ffmpegPath = await findFFmpeg();
@@ -52118,20 +52450,24 @@ var init_detect = __esm({
     init_validate();
     detectCommand = new Command("detect").description("Auto-detect scenes, beats, and silences in media");
     detectCommand.command("scenes").description("Detect scene changes in video").argument("<video>", "Video file path").option("-t, --threshold <value>", "Scene change threshold (0-1)", "0.3").option("-o, --output <path>", "Output JSON file with timestamps").option("-p, --project <path>", "Add scenes as clips to project").option("--dry-run", "Preview parameters without executing").action(async (videoPath, options) => {
+      const startedAt = Date.now();
       const spinner2 = ora("Detecting scenes...").start();
       try {
         if (options.output) {
           validateOutputPath(options.output);
         }
         if (options.dryRun) {
-          outputResult({
-            dryRun: true,
+          outputSuccess({
             command: "detect scenes",
-            params: {
-              video: videoPath,
-              threshold: options.threshold,
-              output: options.output || null,
-              project: options.project || null
+            startedAt,
+            dryRun: true,
+            data: {
+              params: {
+                video: videoPath,
+                threshold: options.threshold,
+                output: options.output || null,
+                project: options.project || null
+              }
             }
           });
           return;
@@ -52233,20 +52569,24 @@ var init_detect = __esm({
       }
     });
     detectCommand.command("silence").description("Detect silence in audio/video").argument("<media>", "Media file path").option("-n, --noise <dB>", "Noise threshold in dB", "-30").option("-d, --duration <sec>", "Minimum silence duration", "0.5").option("-o, --output <path>", "Output JSON file with timestamps").option("--dry-run", "Preview parameters without executing").action(async (mediaPath, options) => {
+      const startedAt = Date.now();
       const spinner2 = ora("Detecting silence...").start();
       try {
         if (options.output) {
           validateOutputPath(options.output);
         }
         if (options.dryRun) {
-          outputResult({
-            dryRun: true,
+          outputSuccess({
             command: "detect silence",
-            params: {
-              media: mediaPath,
-              noise: options.noise,
-              duration: options.duration,
-              output: options.output || null
+            startedAt,
+            dryRun: true,
+            data: {
+              params: {
+                media: mediaPath,
+                noise: options.noise,
+                duration: options.duration,
+                output: options.output || null
+              }
             }
           });
           return;
@@ -52315,18 +52655,22 @@ var init_detect = __esm({
       }
     });
     detectCommand.command("beats").description("Detect beats in audio (for music sync)").argument("<audio>", "Audio file path").option("-o, --output <path>", "Output JSON file with timestamps").option("--dry-run", "Preview parameters without executing").action(async (audioPath, options) => {
+      const startedAt = Date.now();
       const spinner2 = ora("Detecting beats...").start();
       try {
         if (options.output) {
           validateOutputPath(options.output);
         }
         if (options.dryRun) {
-          outputResult({
-            dryRun: true,
+          outputSuccess({
             command: "detect beats",
-            params: {
-              audio: audioPath,
-              output: options.output || null
+            startedAt,
+            dryRun: true,
+            data: {
+              params: {
+                audio: audioPath,
+                output: options.output || null
+              }
             }
           });
           return;
@@ -61356,6 +61700,363 @@ 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 scene 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 scene build [project-dir]\` | STORYBOARD.md has YAML frontmatter + per-beat cues |
+| **High-craft (manual)** | \`DESIGN.md\` + Hyperframes skill 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 scene build\` whenever the user has a STORYBOARD with
+narration / backdrop intent.
+
+## High-craft path
+
+1. \`vibe scene 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 the Hyperframes skill** 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 scene render\`
+   to MP4.
+
+## Quick-draft path
+
+\`\`\`bash
+vibe scene init my-promo -r 16:9 -d 30
+vibe scene add intro --style announcement \\
+    --headline "Ship videos, not clicks"
+vibe scene lint
+vibe scene render
+\`\`\`
+
+\`vibe scene init\` is **idempotent** \u2014 running it on an existing
+Hyperframes directory merges \`hyperframes.json\` instead of clobbering it.
+Safe to invoke on user-provided projects.
+
+## Subcommands
+
+\`\`\`bash
+vibe scene init <dir> [-r 16:9|9:16|1:1|4:5] [-d <sec>] [--visual-style "<name>"]
+vibe scene styles [<name>]                   # list / show vendored visual identities
+vibe scene install-skill [<dir>] [--host all]  # retroactive Hyperframes-skill install
+vibe scene add <name> --style <preset> [...]
+vibe scene compose-prompts [<dir>] [--beat <id>]   # H2: emit plan, no LLM call
+vibe scene lint [<root>] [--json] [--fix]
+vibe scene render [<root>] [--fps 30] [--quality standard] [--format mp4]
+vibe scene build [<dir>] [--mode agent|batch|auto]   # H3 dispatch
+\`\`\`
+
+## 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 scene init my-promo --visual-style "Swiss Pulse" -d 12
+# (edit STORYBOARD.md with per-beat YAML cues \u2014 narration, backdrop, duration)
+vibe scene build my-promo
+\`\`\`
+
+\`vibe scene 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 scene 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 scene build\` |
+| Hand-tweak a single scene's animation | edit \`compositions/<file>.html\` directly |
+| Render the project | \`vibe scene render\` *or* \`npx hyperframes render\` (equivalent) |
+| 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 examples** \u2014 \`examples/demo-pipeline.yaml\` (FFmpeg-only,
+   no keys), \`examples/promo-video.yaml\` (AI providers).
+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 scene init <dir> --visual-style "<style name>"` to scaffold the project + install the Hyperframes skill (Plan H).',
+          "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 scene 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 scene render` to produce the MP4."
+        ],
+        relatedCommands: [
+          "vibe scene init",
+          "vibe scene styles",
+          "vibe scene install-skill",
+          "vibe scene compose-prompts",
+          "vibe scene build",
+          "vibe scene lint",
+          "vibe scene render",
+          "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({
+  "src/tools/manifest/walkthrough.ts"() {
+    "use strict";
+    init_zod();
+    init_define_tool();
+    init_walkthroughs();
+    walkthroughSchema = external_exports.object({
+      topic: external_exports.enum(WALKTHROUGH_TOPICS).optional().describe(
+        "Walkthrough topic to load. Omit to list every available walkthrough \u2014 useful for discovery on first contact."
+      )
+    });
+    walkthroughTool = defineTool({
+      name: "walkthrough",
+      category: "agent",
+      cost: "free",
+      description: "Load the step-by-step authoring guide for a vibe workflow (BUILD scene authoring, YAML pipeline authoring). Universal CLI-equivalent of Claude Code's /vibe-* slash commands \u2014 any host agent that calls this tool gets the same content the slash menu delivers in Claude Code, with no Claude Code dependency. Without a topic, returns the catalog of walkthroughs for discovery.",
+      schema: walkthroughSchema,
+      async execute(args) {
+        if (!args.topic) {
+          const topics = listWalkthroughs();
+          return {
+            success: true,
+            data: { action: "list", topics },
+            humanLines: [
+              `Available walkthroughs: ${topics.map((t) => t.topic).join(", ")}.`,
+              `Call again with topic to load full content.`
+            ]
+          };
+        }
+        const result = loadWalkthrough(args.topic);
+        return {
+          success: true,
+          data: { action: "show", ...result },
+          humanLines: [
+            `Loaded walkthrough: ${result.title}.`,
+            `${result.steps.length} steps, ${result.relatedCommands.length} related commands, ${result.content.length} chars of guide content.`
+          ]
+        };
+      }
+    });
+    walkthroughTools = [walkthroughTool];
+  }
+});
+
 // src/tools/manifest/index.ts
 var manifest_exports = {};
 __export(manifest_exports, {
@@ -61370,7 +62071,8 @@ __export(manifest_exports, {
   pipelineTools: () => pipelineTools,
   projectTools: () => projectTools,
   sceneTools: () => sceneTools,
-  timelineTools: () => timelineTools
+  timelineTools: () => timelineTools,
+  walkthroughTools: () => walkthroughTools
 });
 var manifest;
 var init_manifest = __esm({
@@ -61387,6 +62089,7 @@ var init_manifest = __esm({
     init_project2();
     init_export2();
     init_agent_only();
+    init_walkthrough();
     manifest = [
       ...sceneTools,
       ...audioTools,
@@ -61398,7 +62101,8 @@ var init_manifest = __esm({
       ...timelineTools,
       ...projectTools,
       ...exportTools,
-      ...agentOnlyTools
+      ...agentOnlyTools,
+      ...walkthroughTools
     ];
   }
 });
@@ -61602,7 +62306,7 @@ init_source();
 // package.json
 var package_default = {
   name: "@vibeframe/cli",
-  version: "0.70.0",
+  version: "0.72.0",
   description: "VibeFrame CLI - natural language video editing from the terminal",
   private: false,
   license: "MIT",
@@ -61834,20 +62538,24 @@ Examples:
 Cost: Free (no API keys needed). Projects are saved as .vibe.json files.
 Run 'vibe schema project.<command>' for structured parameter info.`);
 projectCommand.command("create").description("Create a new project").argument("<name>", "Project name or path (e.g., 'my-project' or 'output/my-project')").option("-o, --output <path>", "Output file path (overrides name-based path)").option("-r, --ratio <ratio>", "Aspect ratio (16:9, 9:16, 1:1, 4:5)", "16:9").option("-f, --fps <fps>", "Frame rate", "30").option("--dry-run", "Preview parameters without executing").action(async (name, options) => {
+  const startedAt = Date.now();
   const spinner2 = ora("Creating project...").start();
   try {
     if (options.output) {
       validateOutputPath(options.output);
     }
     if (options.dryRun) {
-      outputResult({
-        dryRun: true,
+      outputSuccess({
         command: "project create",
-        params: {
-          name,
-          output: options.output || null,
-          aspectRatio: options.ratio,
-          frameRate: options.fps
+        startedAt,
+        dryRun: true,
+        data: {
+          params: {
+            name,
+            output: options.output || null,
+            aspectRatio: options.ratio,
+            frameRate: options.fps
+          }
         }
       });
       return;
@@ -61912,17 +62620,21 @@ projectCommand.command("info").description("Show project information").argument(
   }
 });
 projectCommand.command("set").description("Update project settings").argument("<file>", "Project file path").option("-n, --name <name>", "Project name").option("-r, --ratio <ratio>", "Aspect ratio (16:9, 9:16, 1:1, 4:5)").option("-f, --fps <fps>", "Frame rate").option("--dry-run", "Preview parameters without executing").action(async (file, options) => {
+  const startedAt = Date.now();
   const spinner2 = ora("Updating project...").start();
   try {
     if (options.dryRun) {
-      outputResult({
-        dryRun: true,
+      outputSuccess({
         command: "project set",
-        params: {
-          file,
-          name: options.name || null,
-          ratio: options.ratio || null,
-          fps: options.fps || null
+        startedAt,
+        dryRun: true,
+        data: {
+          params: {
+            file,
+            name: options.name || null,
+            ratio: options.ratio || null,
+            fps: options.fps || null
+          }
         }
       });
       return;
@@ -61973,18 +62685,22 @@ Typical workflow: create project \u2192 add-source \u2192 add-clip \u2192 trim/s
 Cost: Free (no API keys needed).
 Run 'vibe schema timeline.<command>' for structured parameter info.`);
 timelineCommand.command("add-source").description("Add a media source to the project").argument("<project>", "Project file path").argument("<media>", "Media file path").option("-n, --name <name>", "Source name (defaults to filename)").option("-t, --type <type>", "Media type (video, audio, image, lottie)").option("-d, --duration <seconds>", "Duration in seconds (required for images)").option("--dry-run", "Preview parameters without executing").action(async (projectPath, mediaPath, options) => {
+  const startedAt = Date.now();
   const spinner2 = ora("Adding source...").start();
   try {
     if (options.dryRun) {
-      outputResult({
-        dryRun: true,
+      outputSuccess({
         command: "timeline add-source",
-        params: {
-          project: projectPath,
-          media: mediaPath,
-          name: options.name || null,
-          type: options.type || null,
-          duration: options.duration || null
+        startedAt,
+        dryRun: true,
+        data: {
+          params: {
+            project: projectPath,
+            media: mediaPath,
+            name: options.name || null,
+            type: options.type || null,
+            duration: options.duration || null
+          }
         }
       });
       return;
@@ -62017,21 +62733,25 @@ timelineCommand.command("add-source").description("Add a media source to the pro
   }
 });
 timelineCommand.command("add-clip").description("Add a clip to the timeline").argument("<project>", "Project file path").argument("<source-id>", "Source ID to use").option("-t, --track <id>", "Track ID (defaults to first matching track)").option("-s, --start <seconds>", "Start time in timeline", "0").option("-d, --duration <seconds>", "Clip duration (defaults to source duration)").option("--offset <seconds>", "Source start offset", "0").option("--dry-run", "Preview parameters without executing").action(async (projectPath, sourceId, options) => {
+  const startedAt = Date.now();
   const spinner2 = ora("Adding clip...").start();
   try {
     validateResourceId(sourceId);
     if (options.track) validateResourceId(options.track);
     if (options.dryRun) {
-      outputResult({
-        dryRun: true,
+      outputSuccess({
         command: "timeline add-clip",
-        params: {
-          project: projectPath,
-          sourceId,
-          track: options.track || null,
-          start: options.start,
-          duration: options.duration || null,
-          offset: options.offset
+        startedAt,
+        dryRun: true,
+        data: {
+          params: {
+            project: projectPath,
+            sourceId,
+            track: options.track || null,
+            start: options.start,
+            duration: options.duration || null,
+            offset: options.offset
+          }
         }
       });
       return;
@@ -62080,16 +62800,20 @@ timelineCommand.command("add-clip").description("Add a clip to the timeline").ar
   }
 });
 timelineCommand.command("add-track").description("Add a new track").argument("<project>", "Project file path").argument("<type>", "Track type (video, audio)").option("-n, --name <name>", "Track name").option("--dry-run", "Preview parameters without executing").action(async (projectPath, type, options) => {
+  const startedAt = Date.now();
   const spinner2 = ora("Adding track...").start();
   try {
     if (options.dryRun) {
-      outputResult({
-        dryRun: true,
+      outputSuccess({
         command: "timeline add-track",
-        params: {
-          project: projectPath,
-          type,
-          name: options.name || null
+        startedAt,
+        dryRun: true,
+        data: {
+          params: {
+            project: projectPath,
+            type,
+            name: options.name || null
+          }
         }
       });
       return;
@@ -62121,20 +62845,24 @@ timelineCommand.command("add-track").description("Add a new track").argument("<p
   }
 });
 timelineCommand.command("add-effect").description("Add an effect to a clip").argument("<project>", "Project file path").argument("<clip-id>", "Clip ID").argument("<effect-type>", "Effect type (fadeIn, fadeOut, blur, brightness, contrast, saturation, speed, volume)").option("-s, --start <seconds>", "Effect start time (relative to clip)", "0").option("-d, --duration <seconds>", "Effect duration (defaults to clip duration)").option("-p, --params <json>", "Effect parameters as JSON", "{}").option("--dry-run", "Preview parameters without executing").action(async (projectPath, clipId, effectType, options) => {
+  const startedAt = Date.now();
   const spinner2 = ora("Adding effect...").start();
   try {
     validateResourceId(clipId);
     if (options.dryRun) {
-      outputResult({
-        dryRun: true,
+      outputSuccess({
         command: "timeline add-effect",
-        params: {
-          project: projectPath,
-          clipId,
-          effectType,
-          start: options.start,
-          duration: options.duration || null,
-          params: options.params
+        startedAt,
+        dryRun: true,
+        data: {
+          params: {
+            project: projectPath,
+            clipId,
+            effectType,
+            start: options.start,
+            duration: options.duration || null,
+            params: options.params
+          }
         }
       });
       return;
@@ -62174,18 +62902,22 @@ timelineCommand.command("add-effect").description("Add an effect to a clip").arg
   }
 });
 timelineCommand.command("trim").description("Trim a clip").argument("<project>", "Project file path").argument("<clip-id>", "Clip ID").option("--start <seconds>", "New start time").option("--duration <seconds>", "New duration").option("--dry-run", "Preview parameters without executing").action(async (projectPath, clipId, options) => {
+  const startedAt = Date.now();
   const spinner2 = ora("Trimming clip...").start();
   try {
     validateResourceId(clipId);
     if (options.dryRun) {
-      outputResult({
-        dryRun: true,
+      outputSuccess({
         command: "timeline trim",
-        params: {
-          project: projectPath,
-          clipId,
-          start: options.start || null,
-          duration: options.duration || null
+        startedAt,
+        dryRun: true,
+        data: {
+          params: {
+            project: projectPath,
+            clipId,
+            start: options.start || null,
+            duration: options.duration || null
+          }
         }
       });
       return;
@@ -62278,17 +63010,21 @@ timelineCommand.command("list").description("List timeline contents").argument("
   }
 });
 timelineCommand.command("split").description("Split a clip at a specific time").argument("<project>", "Project file path").argument("<clip-id>", "Clip ID to split").option("-t, --time <seconds>", "Split time relative to clip start", "0").option("--dry-run", "Preview parameters without executing").action(async (projectPath, clipId, options) => {
+  const startedAt = Date.now();
   const spinner2 = ora("Splitting clip...").start();
   try {
     validateResourceId(clipId);
     if (options.dryRun) {
-      outputResult({
-        dryRun: true,
+      outputSuccess({
         command: "timeline split",
-        params: {
-          project: projectPath,
-          clipId,
-          time: options.time
+        startedAt,
+        dryRun: true,
+        data: {
+          params: {
+            project: projectPath,
+            clipId,
+            time: options.time
+          }
         }
       });
       return;
@@ -62325,17 +63061,21 @@ timelineCommand.command("split").description("Split a clip at a specific time").
   }
 });
 timelineCommand.command("duplicate").description("Duplicate a clip").argument("<project>", "Project file path").argument("<clip-id>", "Clip ID to duplicate").option("-t, --time <seconds>", "Start time for duplicate (default: after original)").option("--dry-run", "Preview parameters without executing").action(async (projectPath, clipId, options) => {
+  const startedAt = Date.now();
   const spinner2 = ora("Duplicating clip...").start();
   try {
     validateResourceId(clipId);
     if (options.dryRun) {
-      outputResult({
-        dryRun: true,
+      outputSuccess({
         command: "timeline duplicate",
-        params: {
-          project: projectPath,
-          clipId,
-          time: options.time || null
+        startedAt,
+        dryRun: true,
+        data: {
+          params: {
+            project: projectPath,
+            clipId,
+            time: options.time || null
+          }
         }
       });
       return;
@@ -62367,16 +63107,20 @@ timelineCommand.command("duplicate").description("Duplicate a clip").argument("<
   }
 });
 timelineCommand.command("delete").description("Delete a clip from the timeline").argument("<project>", "Project file path").argument("<clip-id>", "Clip ID to delete").option("--dry-run", "Preview parameters without executing").action(async (projectPath, clipId, options) => {
+  const startedAt = Date.now();
   const spinner2 = ora("Deleting clip...").start();
   try {
     validateResourceId(clipId);
     if (options.dryRun) {
-      outputResult({
-        dryRun: true,
+      outputSuccess({
         command: "timeline delete",
-        params: {
-          project: projectPath,
-          clipId
+        startedAt,
+        dryRun: true,
+        data: {
+          params: {
+            project: projectPath,
+            clipId
+          }
         }
       });
       return;
@@ -62404,19 +63148,23 @@ timelineCommand.command("delete").description("Delete a clip from the timeline")
   }
 });
 timelineCommand.command("move").description("Move a clip to a new position").argument("<project>", "Project file path").argument("<clip-id>", "Clip ID to move").option("-t, --time <seconds>", "New start time").option("--track <track-id>", "Move to different track").option("--dry-run", "Preview parameters without executing").action(async (projectPath, clipId, options) => {
+  const startedAt = Date.now();
   const spinner2 = ora("Moving clip...").start();
   try {
     validateResourceId(clipId);
     if (options.track) validateResourceId(options.track);
     if (options.dryRun) {
-      outputResult({
-        dryRun: true,
+      outputSuccess({
         command: "timeline move",
-        params: {
-          project: projectPath,
-          clipId,
-          time: options.time || null,
-          track: options.track || null
+        startedAt,
+        dryRun: true,
+        data: {
+          params: {
+            project: projectPath,
+            clipId,
+            time: options.time || null,
+            track: options.track || null
+          }
         }
       });
       return;
@@ -62499,6 +63247,7 @@ Run 'vibe schema analyze.<command>' for structured parameter info.
 `
 );
 analyzeCommand.command("media").description("Analyze any media: images, videos, or YouTube URLs using Gemini").argument("<source>", "Image/video file path, image URL, or YouTube URL").argument("<prompt>", "Analysis prompt (e.g., 'Describe this image', 'Summarize this video')").option("-k, --api-key <key>", "Google API key (or set GOOGLE_API_KEY env)").option("-m, --model <model>", "Model: flash (default), flash-2.5, pro", "flash").option("--fps <number>", "Frames per second for video (default: 1)").option("--start <seconds>", "Start offset in seconds (video only)").option("--end <seconds>", "End offset in seconds (video only)").option("--low-res", "Use low resolution mode (fewer tokens)").option("-v, --verbose", "Show token usage").option("--fields <fields>", "Comma-separated fields to include in output (e.g., response,model)").action(async (source, prompt3, options) => {
+  const startedAt = Date.now();
   try {
     rejectControlChars(prompt3);
     if (options.apiKey) {
@@ -62523,15 +63272,17 @@ analyzeCommand.command("media").description("Analyze any media: images, videos,
     spinner2.succeed(source_default.green("Analysis complete"));
     const response = sanitizeLLMResponse(result.response || "");
     if (isJsonMode()) {
-      let result_obj = { success: true, response, sourceType: result.sourceType, model: result.model };
+      const data = { response, sourceType: result.sourceType, model: result.model };
       if (result.totalTokens) {
-        result_obj = { ...result_obj, promptTokens: result.promptTokens, responseTokens: result.responseTokens, totalTokens: result.totalTokens };
-      }
-      if (options.fields) {
-        const fields = options.fields.split(",").map((f) => f.trim());
-        result_obj = Object.fromEntries(Object.entries(result_obj).filter(([k]) => fields.includes(k) || k === "success"));
-      }
-      outputResult(result_obj);
+        data.promptTokens = result.promptTokens;
+        data.responseTokens = result.responseTokens;
+        data.totalTokens = result.totalTokens;
+      }
+      outputSuccess({
+        command: "analyze media",
+        startedAt,
+        data
+      });
       return;
     }
     console.log();
@@ -62554,6 +63305,7 @@ analyzeCommand.command("media").description("Analyze any media: images, videos,
   }
 });
 analyzeCommand.command("video").description("Analyze video using Gemini (summarize, Q&A, extract info)").argument("<source>", "Video file path or YouTube URL").argument("<prompt>", "Analysis prompt (e.g., 'Summarize this video')").option("-k, --api-key <key>", "Google API key (or set GOOGLE_API_KEY env)").option("-m, --model <model>", "Model: flash (default), flash-2.5, pro", "flash").option("--fps <number>", "Frames per second (default: 1, higher for action)").option("--start <seconds>", "Start offset in seconds (for clipping)").option("--end <seconds>", "End offset in seconds (for clipping)").option("--low-res", "Use low resolution mode (fewer tokens, longer videos)").option("-v, --verbose", "Show token usage").option("--fields <fields>", "Comma-separated fields to include in output (e.g., response,model)").action(async (source, prompt3, options) => {
+  const startedAt = Date.now();
   try {
     rejectControlChars(prompt3);
     if (options.apiKey) {
@@ -62578,15 +63330,17 @@ analyzeCommand.command("video").description("Analyze video using Gemini (summari
     spinner2.succeed(source_default.green("Video analyzed"));
     const response = sanitizeLLMResponse(result.response || "");
     if (isJsonMode()) {
-      let result_obj = { success: true, response, model: result.model };
+      const data = { response, model: result.model };
       if (result.totalTokens) {
-        result_obj = { ...result_obj, promptTokens: result.promptTokens, responseTokens: result.responseTokens, totalTokens: result.totalTokens };
-      }
-      if (options.fields) {
-        const fields = options.fields.split(",").map((f) => f.trim());
-        result_obj = Object.fromEntries(Object.entries(result_obj).filter(([k]) => fields.includes(k) || k === "success"));
-      }
-      outputResult(result_obj);
+        data.promptTokens = result.promptTokens;
+        data.responseTokens = result.responseTokens;
+        data.totalTokens = result.totalTokens;
+      }
+      outputSuccess({
+        command: "analyze video",
+        startedAt,
+        data
+      });
       return;
     }
     console.log();
@@ -62609,6 +63363,7 @@ analyzeCommand.command("video").description("Analyze video using Gemini (summari
 });
 registerReviewCommand(analyzeCommand);
 analyzeCommand.command("suggest").description("Get AI edit suggestions using Gemini").argument("<project>", "Project file path").argument("<instruction>", "Natural language instruction").option("-k, --api-key <key>", "Google API key (or set GOOGLE_API_KEY env)").option("--apply", "Apply the first suggestion automatically").action(async (projectPath, instruction, options) => {
+  const startedAt = Date.now();
   try {
     rejectControlChars(instruction);
     const apiKey = await requireApiKey("GOOGLE_API_KEY", "Google", options.apiKey);
@@ -62624,7 +63379,13 @@ analyzeCommand.command("suggest").description("Get AI edit suggestions using Gem
     const suggestions = await gemini.autoEdit(clips, instruction);
     spinner2.succeed(source_default.green(`Found ${suggestions.length} suggestion(s)`));
     if (isJsonMode()) {
-      outputResult({ success: true, suggestions: suggestions.map((s) => ({ type: s.type, description: s.description, confidence: s.confidence, clipIds: s.clipIds, params: s.params })) });
+      outputSuccess({
+        command: "analyze suggest",
+        startedAt,
+        data: {
+          suggestions: suggestions.map((s) => ({ type: s.type, description: s.description, confidence: s.confidence, clipIds: s.clipIds, params: s.params }))
+        }
+      });
       return;
     }
     console.log();
@@ -62693,6 +63454,7 @@ Run 'vibe schema audio.<command>' for structured parameter info.
 `
 );
 audioCommand.command("transcribe").description("Transcribe audio using Whisper").argument("<audio>", "Audio file path").option("-k, --api-key <key>", "OpenAI API key (or set OPENAI_API_KEY env)").option("-l, --language <lang>", "Language code (e.g., en, ko)").option("-o, --output <path>", "Output file path").option("-f, --format <format>", "Output format: json, srt, vtt (auto-detected from extension)").action(async (audioPath, options) => {
+  const startedAt = Date.now();
   try {
     if (options.output) {
       validateOutputPath(options.output);
@@ -62713,7 +63475,16 @@ audioCommand.command("transcribe").description("Transcribe audio using Whisper")
     }
     spinner2.succeed(source_default.green("Transcription complete"));
     if (isJsonMode()) {
-      outputResult({ success: true, fullText: result.fullText, segments: result.segments, language: result.detectedLanguage, outputPath: options.output ? resolve37(process.cwd(), options.output) : void 0 });
+      outputSuccess({
+        command: "audio transcribe",
+        startedAt,
+        data: {
+          fullText: result.fullText,
+          segments: result.segments,
+          language: result.detectedLanguage,
+          outputPath: options.output ? resolve37(process.cwd(), options.output) : void 0
+        }
+      });
       return;
     }
     console.log();
@@ -62743,6 +63514,7 @@ audioCommand.command("transcribe").description("Transcribe audio using Whisper")
   }
 });
 audioCommand.command("voices").description("List available ElevenLabs voices").option("-k, --api-key <key>", "ElevenLabs API key (or set ELEVENLABS_API_KEY env)").action(async (options) => {
+  const startedAt = Date.now();
   try {
     const apiKey = await requireApiKey("ELEVENLABS_API_KEY", "ElevenLabs", options.apiKey);
     const spinner2 = ora("Fetching voices...").start();
@@ -62751,7 +63523,13 @@ audioCommand.command("voices").description("List available ElevenLabs voices").o
     const voices = await elevenlabs.getVoices();
     spinner2.succeed(source_default.green(`Found ${voices.length} voices`));
     if (isJsonMode()) {
-      outputResult({ success: true, voices: voices.map((v) => ({ name: v.name, voiceId: v.voice_id, category: v.category, labels: v.labels })) });
+      outputSuccess({
+        command: "audio voices",
+        startedAt,
+        data: {
+          voices: voices.map((v) => ({ name: v.name, voiceId: v.voice_id, category: v.category, labels: v.labels }))
+        }
+      });
       return;
     }
     console.log();
@@ -62769,9 +63547,15 @@ audioCommand.command("voices").description("List available ElevenLabs voices").o
   }
 });
 audioCommand.command("isolate").description("Isolate vocals from audio using ElevenLabs").argument("<audio>", "Input audio file path").option("-k, --api-key <key>", "ElevenLabs API key (or set ELEVENLABS_API_KEY env)").option("-o, --output <path>", "Output audio file path", "vocals.mp3").option("--dry-run", "Preview parameters without executing").action(async (audioPath, options) => {
+  const startedAt = Date.now();
   try {
     if (options.dryRun) {
-      outputResult({ dryRun: true, command: "audio isolate", audioPath });
+      outputSuccess({
+        command: "audio isolate",
+        startedAt,
+        dryRun: true,
+        data: { params: { audioPath } }
+      });
       return;
     }
     if (options.output) {
@@ -62793,7 +63577,11 @@ audioCommand.command("isolate").description("Isolate vocals from audio using Ele
     await writeFile32(outputPath, result.audioBuffer);
     spinner2.succeed(source_default.green("Vocals isolated"));
     if (isJsonMode()) {
-      outputResult({ success: true, outputPath });
+      outputSuccess({
+        command: "audio isolate",
+        startedAt,
+        data: { outputPath }
+      });
       return;
     }
     console.log(source_default.green(`Saved to: ${outputPath}`));
@@ -62804,9 +63592,15 @@ audioCommand.command("isolate").description("Isolate vocals from audio using Ele
   }
 });
 audioCommand.command("voice-clone").description("Clone a voice from audio samples using ElevenLabs").argument("[samples...]", "Audio sample files (1-25 files)").option("-k, --api-key <key>", "ElevenLabs API key (or set ELEVENLABS_API_KEY env)").option("-n, --name <name>", "Voice name (required)").option("-d, --description <desc>", "Voice description").option("--labels <json>", `Labels as JSON (e.g., '{"accent": "american"}')`).option("--remove-noise", "Remove background noise from samples").option("--list", "List all available voices").option("--dry-run", "Preview parameters without executing").action(async (samples, options) => {
+  const startedAt = Date.now();
   try {
     if (options.dryRun) {
-      outputResult({ dryRun: true, command: "audio voice-clone", samples: samples?.length, name: options.name });
+      outputSuccess({
+        command: "audio voice-clone",
+        startedAt,
+        dryRun: true,
+        data: { params: { samples: samples?.length, name: options.name } }
+      });
       return;
     }
     const apiKey = await requireApiKey("ELEVENLABS_API_KEY", "ElevenLabs", options.apiKey);
@@ -62862,7 +63656,11 @@ audioCommand.command("voice-clone").description("Clone a voice from audio sample
     }
     spinner2.succeed(source_default.green("Voice cloned successfully"));
     if (isJsonMode()) {
-      outputResult({ success: true, name: options.name, voiceId: result.voiceId });
+      outputSuccess({
+        command: "audio voice-clone",
+        startedAt,
+        data: { name: options.name, voiceId: result.voiceId }
+      });
       return;
     }
     console.log();
@@ -62880,9 +63678,15 @@ audioCommand.command("voice-clone").description("Clone a voice from audio sample
   }
 });
 audioCommand.command("dub").description("Dub audio/video to another language (transcribe, translate, TTS)").argument("<media>", "Input media file (video or audio)").option("-l, --language <lang>", "Target language code (e.g., es, ko, ja) (required)").option("--source <lang>", "Source language code (default: auto-detect)").option("-v, --voice <id>", "ElevenLabs voice ID for output").option("--analyze-only", "Only analyze and show timing, don't generate audio").option("-o, --output <path>", "Output file path").option("--dry-run", "Preview parameters without executing").action(async (mediaPath, options) => {
+  const startedAt = Date.now();
   try {
     if (options.dryRun) {
-      outputResult({ dryRun: true, command: "audio dub", mediaPath, targetLanguage: options.language, sourceLanguage: options.source, voice: options.voice });
+      outputSuccess({
+        command: "audio dub",
+        startedAt,
+        dryRun: true,
+        data: { params: { mediaPath, targetLanguage: options.language, sourceLanguage: options.source, voice: options.voice } }
+      });
       return;
     }
     if (options.output) {
@@ -63042,7 +63846,16 @@ ${segmentTexts}`,
     await writeFile32(finalOutputPath, combinedBuffer);
     spinner2.succeed(source_default.green("Dubbing complete"));
     if (isJsonMode()) {
-      outputResult({ success: true, sourceLanguage: transcriptResult.detectedLanguage || options.source || "auto", targetLanguage: options.language, segmentCount: translatedSegments.length, outputPath: finalOutputPath });
+      outputSuccess({
+        command: "audio dub",
+        startedAt,
+        data: {
+          sourceLanguage: transcriptResult.detectedLanguage || options.source || "auto",
+          targetLanguage: options.language,
+          segmentCount: translatedSegments.length,
+          outputPath: finalOutputPath
+        }
+      });
       return;
     }
     console.log();
@@ -63061,13 +63874,19 @@ ${segmentTexts}`,
   }
 });
 audioCommand.command("duck").description("Auto-duck background music when voice is present (FFmpeg)").argument("<music>", "Background music file path").option("-v, --voice <path>", "Voice/narration track (required)").option("-o, --output <path>", "Output audio file path").option("-t, --threshold <dB>", "Sidechain threshold in dB", "-30").option("-r, --ratio <ratio>", "Compression ratio", "3").option("-a, --attack <ms>", "Attack time in ms", "20").option("-l, --release <ms>", "Release time in ms", "200").option("--dry-run", "Preview parameters without executing").action(async (musicPath, options) => {
+  const startedAt = Date.now();
   try {
     if (options.dryRun) {
       const threshold = parseFloat(options.threshold);
       const ratio2 = parseFloat(options.ratio);
       const attack2 = parseFloat(options.attack);
       const release2 = parseFloat(options.release);
-      outputResult({ dryRun: true, command: "audio duck", musicPath, voicePath: options.voice, threshold, ratio: ratio2, attack: attack2, release: release2 });
+      outputSuccess({
+        command: "audio duck",
+        startedAt,
+        dryRun: true,
+        data: { params: { musicPath, voicePath: options.voice, threshold, ratio: ratio2, attack: attack2, release: release2 } }
+      });
       return;
     }
     if (options.output) {
@@ -63092,7 +63911,11 @@ audioCommand.command("duck").description("Auto-duck background music when voice
     await execSafe("ffmpeg", ["-i", absMusic, "-i", absVoice, "-filter_complex", filterComplex, "-map", "[out]", outputPath, "-y"]);
     spinner2.succeed(source_default.green("Audio ducking complete"));
     if (isJsonMode()) {
-      outputResult({ success: true, musicPath: absMusic, voicePath: options.voice, threshold: thresholdDb, ratio, outputPath });
+      outputSuccess({
+        command: "audio duck",
+        startedAt,
+        data: { musicPath: absMusic, voicePath: options.voice, threshold: thresholdDb, ratio, outputPath }
+      });
       return;
     }
     console.log();
@@ -63130,6 +63953,7 @@ import { resolve as resolve38 } from "node:path";
 import { existsSync as existsSync29 } from "node:fs";
 function registerScriptPipelineCommands(aiCommand) {
   aiCommand.command("regenerate-scene").description("Regenerate a specific scene in a script-to-video output directory").argument("<project-dir>", "Path to the script-to-video output directory").requiredOption("--scene <numbers>", "Scene number(s) to regenerate (1-based), e.g., 3 or 3,4,5").option("--video-only", "Only regenerate video").option("--narration-only", "Only regenerate narration").option("--image-only", "Only regenerate image").option("-g, --generator <engine>", "Video generator: grok | kling | runway | veo", "grok").option("-i, --image-provider <provider>", "Image provider: gemini | openai | grok", "gemini").option("-v, --voice <id>", "ElevenLabs voice ID for narration").option("-a, --aspect-ratio <ratio>", "Aspect ratio: 16:9 | 9:16 | 1:1", "16:9").option("--retries <count>", "Number of retries for video generation failures", String(DEFAULT_VIDEO_RETRIES)).option("--reference-scene <num>", "Use another scene's image as reference for character consistency").option("--dry-run", "Preview parameters without executing").action(async (projectDir, options) => {
+    const startedAt = Date.now();
     try {
       const outputDir = resolve38(process.cwd(), projectDir);
       const projectPath = resolve38(outputDir, "project.vibe.json");
@@ -63148,20 +63972,23 @@ function registerScriptPipelineCommands(aiCommand) {
         exitWithError(usageError("Scene number must be a positive integer (1-based)", "e.g., --scene 3 or --scene 3,4,5"));
       }
       if (options.dryRun) {
-        outputResult({
-          dryRun: true,
+        outputSuccess({
           command: "pipeline regenerate-scene",
-          params: {
-            projectDir,
-            scene: sceneNums,
-            videoOnly: options.videoOnly ?? false,
-            narrationOnly: options.narrationOnly ?? false,
-            imageOnly: options.imageOnly ?? false,
-            generator: options.generator,
-            imageProvider: options.imageProvider,
-            aspectRatio: options.aspectRatio,
-            retries: options.retries,
-            referenceScene: options.referenceScene
+          startedAt,
+          dryRun: true,
+          data: {
+            params: {
+              projectDir,
+              scene: sceneNums,
+              videoOnly: options.videoOnly ?? false,
+              narrationOnly: options.narrationOnly ?? false,
+              imageOnly: options.imageOnly ?? false,
+              generator: options.generator,
+              imageProvider: options.imageProvider,
+              aspectRatio: options.aspectRatio,
+              retries: options.retries,
+              referenceScene: options.referenceScene
+            }
           }
         });
         return;
@@ -63356,6 +64183,7 @@ Styles:
 Required API Key: OPENAI_API_KEY (Whisper transcription)
 `
 ).action(async (videoPath, options) => {
+  const startedAt = Date.now();
   try {
     const absVideoPath = resolve41(process.cwd(), videoPath);
     if (!existsSync32(absVideoPath)) {
@@ -63366,20 +64194,23 @@ Required API Key: OPENAI_API_KEY (Whisper transcription)
     }
     const outputFile = options.output || videoPath.replace(/(\.\w+)$/, "-captioned$1");
     if (options.dryRun) {
-      outputResult({
-        dryRun: true,
+      outputSuccess({
         command: "pipeline animated-caption",
-        params: {
-          videoPath: absVideoPath,
-          outputPath: outputFile,
-          style: options.style,
-          highlightColor: options.highlightColor,
-          fontSize: options.fontSize ? parseInt(options.fontSize) : "auto",
-          position: options.position,
-          wordsPerGroup: options.wordsPerGroup ? parseInt(options.wordsPerGroup) : "auto",
-          maxChars: options.maxChars ? parseInt(options.maxChars) : "auto",
-          language: options.language || "auto",
-          fast: !!options.fast
+        startedAt,
+        dryRun: true,
+        data: {
+          params: {
+            videoPath: absVideoPath,
+            outputPath: outputFile,
+            style: options.style,
+            highlightColor: options.highlightColor,
+            fontSize: options.fontSize ? parseInt(options.fontSize) : "auto",
+            position: options.position,
+            wordsPerGroup: options.wordsPerGroup ? parseInt(options.wordsPerGroup) : "auto",
+            maxChars: options.maxChars ? parseInt(options.maxChars) : "auto",
+            language: options.language || "auto",
+            fast: !!options.fast
+          }
         }
       });
       return;
@@ -63410,13 +64241,16 @@ Required API Key: OPENAI_API_KEY (Whisper transcription)
     }
     spinner2.succeed(source_default.green("Animated captions applied successfully"));
     if (isJsonMode()) {
-      outputResult({
-        success: true,
-        outputPath: result.outputPath,
-        wordCount: result.wordCount,
-        groupCount: result.groupCount,
-        style: result.style,
-        tier: result.tier
+      outputSuccess({
+        command: "pipeline animated-caption",
+        startedAt,
+        data: {
+          outputPath: result.outputPath,
+          wordCount: result.wordCount,
+          groupCount: result.groupCount,
+          style: result.style,
+          tier: result.tier
+        }
       });
       return;
     }
@@ -67684,18 +68518,22 @@ function isMediaFile(filePath) {
   return mediaExts.includes(ext);
 }
 batchCommand.command("import").description("Import multiple media files from a directory").argument("<project>", "Project file path").argument("<directory>", "Directory containing media files").option("-r, --recursive", "Search subdirectories", false).option("-d, --duration <seconds>", "Default duration for images", "5").option("--filter <pattern>", "Filter files by extension (e.g., '.mp4,.mov')").option("--dry-run", "Preview parameters without executing").action(async (projectPath, directory, options) => {
+  const startedAt = Date.now();
   const spinner2 = ora("Scanning directory...").start();
   try {
     if (options.dryRun) {
-      outputResult({
-        dryRun: true,
+      outputSuccess({
         command: "batch import",
-        params: {
-          project: projectPath,
-          directory,
-          recursive: options.recursive,
-          duration: options.duration,
-          filter: options.filter || null
+        startedAt,
+        dryRun: true,
+        data: {
+          params: {
+            project: projectPath,
+            directory,
+            recursive: options.recursive,
+            duration: options.duration,
+            filter: options.filter || null
+          }
         }
       });
       return;
@@ -67757,19 +68595,23 @@ batchCommand.command("import").description("Import multiple media files from a d
   }
 });
 batchCommand.command("concat").description("Concatenate multiple sources into sequential clips").argument("<project>", "Project file path").argument("[source-ids...]", "Source IDs to concatenate (or --all)").option("--all", "Concatenate all sources in order", false).option("--track <track-id>", "Track to place clips on").option("--start <seconds>", "Starting time", "0").option("--gap <seconds>", "Gap between clips", "0").option("--dry-run", "Preview parameters without executing").action(async (projectPath, sourceIds, options) => {
+  const startedAt = Date.now();
   const spinner2 = ora("Creating clips...").start();
   try {
     if (options.dryRun) {
-      outputResult({
-        dryRun: true,
+      outputSuccess({
         command: "batch concat",
-        params: {
-          project: projectPath,
-          sourceIds,
-          all: options.all,
-          track: options.track || null,
-          start: options.start,
-          gap: options.gap
+        startedAt,
+        dryRun: true,
+        data: {
+          params: {
+            project: projectPath,
+            sourceIds,
+            all: options.all,
+            track: options.track || null,
+            start: options.start,
+            gap: options.gap
+          }
         }
       });
       return;
@@ -67831,20 +68673,24 @@ batchCommand.command("concat").description("Concatenate multiple sources into se
 });
 batchCommand.command("apply-effect").description("Apply an effect to multiple clips").argument("<project>", "Project file path").argument("<effect-type>", "Effect type (fadeIn, fadeOut, blur, etc.)").argument("[clip-ids...]", "Clip IDs to apply effect to (or --all)").option("--all", "Apply to all clips", false).option("-d, --duration <seconds>", "Effect duration", "1").option("-s, --start <seconds>", "Effect start time (relative to clip)", "0").option("--intensity <value>", "Effect intensity (0-1)", "1").option("--dry-run", "Preview parameters without executing").action(
   async (projectPath, effectType, clipIds, options) => {
+    const startedAt = Date.now();
     const spinner2 = ora("Applying effects...").start();
     try {
       if (options.dryRun) {
-        outputResult({
-          dryRun: true,
+        outputSuccess({
           command: "batch apply-effect",
-          params: {
-            project: projectPath,
-            effectType,
-            clipIds,
-            all: options.all,
-            duration: options.duration,
-            start: options.start,
-            intensity: options.intensity
+          startedAt,
+          dryRun: true,
+          data: {
+            params: {
+              project: projectPath,
+              effectType,
+              clipIds,
+              all: options.all,
+              duration: options.duration,
+              start: options.start,
+              intensity: options.intensity
+            }
           }
         });
         return;
@@ -67898,17 +68744,21 @@ batchCommand.command("apply-effect").description("Apply an effect to multiple cl
   }
 );
 batchCommand.command("remove-clips").description("Remove multiple clips from the timeline").argument("<project>", "Project file path").argument("[clip-ids...]", "Clip IDs to remove").option("--all", "Remove all clips", false).option("--track <track-id>", "Remove clips from specific track only").option("--dry-run", "Preview parameters without executing").action(async (projectPath, clipIds, options) => {
+  const startedAt = Date.now();
   const spinner2 = ora("Removing clips...").start();
   try {
     if (options.dryRun) {
-      outputResult({
-        dryRun: true,
+      outputSuccess({
         command: "batch remove-clips",
-        params: {
-          project: projectPath,
-          clipIds,
-          all: options.all,
-          track: options.track || null
+        startedAt,
+        dryRun: true,
+        data: {
+          params: {
+            project: projectPath,
+            clipIds,
+            all: options.all,
+            track: options.track || null
+          }
         }
       });
       return;
@@ -68432,6 +69282,27 @@ subcommands for video generation, editing, analysis, and pipeline
 orchestration. Cost tiers below \u2014 **always confirm with the user before
 running High / Very High tier commands**.
 
+## Agent host coverage
+
+VibeFrame's CLI works with any bash-capable AI coding agent. Six host
+families have first-class auto-detection and scaffolds today:
+
+- **Claude Code** \u2014 \`CLAUDE.md\` (this file's import wrapper) +
+  \`AGENTS.md\` + \`/vibe-*\` slash commands.
+- **OpenAI Codex** \u2014 reads \`AGENTS.md\` natively (agents.md spec).
+- **Cursor** \u2014 reads \`AGENTS.md\` plus \`.cursor/rules/\` for project
+  rules; supports MCP via \`.cursor/mcp.json\`.
+- **Aider** \u2014 reads \`AGENTS.md\` (binary-only detection by VibeFrame).
+- **Gemini CLI** \u2014 primary context file is \`GEMINI.md\`; also reads
+  \`AGENTS.md\` if present.
+- **OpenCode** \u2014 reads \`AGENTS.md\` (officially supported per
+  \`opencode.ai/docs/rules\`); supports MCP via \`.opencode/mcp.json\`.
+
+Run \`vibe doctor\` to see which host(s) the CLI detects in your
+environment. Anyone running another bash-capable agent (Continue,
+Sourcegraph Cody, etc.) still gets this \`AGENTS.md\` as the universal
+fallback.
+
 ## Self-discovery
 
 Don't memorise the command surface \u2014 read it from the CLI:
@@ -68441,6 +69312,8 @@ vibe --help                    # command groups overview
 vibe schema --list             # full machine-readable catalog (80+)
 vibe schema generate.video     # JSON Schema for any single command
 vibe doctor                    # available providers + system health
+vibe walkthrough scene         # step-by-step authoring guide (scene)
+vibe walkthrough pipeline      # step-by-step authoring guide (pipeline)
 \`\`\`
 
 ## Two flows \u2014 pick by intent
@@ -68570,7 +69443,7 @@ var CLAUDE_MD = `@AGENTS.md
 
 This file imports \`AGENTS.md\` (above) \u2014 that's the canonical source.
 Add anything Claude-Code-specific *below*; everything generic should
-stay in AGENTS.md so other agent hosts (Codex, Cursor, Aider) see it
+stay in AGENTS.md so other agent hosts (Codex, Cursor, Aider, Gemini CLI, OpenCode) see it
 too.
 
 ## Skills
@@ -68593,6 +69466,20 @@ curl -fsSL https://raw.githubusercontent.com/vericontext/vibeframe/main/scripts/
 <!-- Add Claude-specific notes here: which sub-agents to prefer, custom
      slash commands you've added, conversational style preferences, etc. -->
 `;
+var GEMINI_MD = `@AGENTS.md
+
+# Gemini CLI overrides
+
+This project's canonical agent guidance lives in \`AGENTS.md\` \u2014 read
+it first. The \`@AGENTS.md\` line above is the import marker; if
+Gemini CLI doesn't inline imported files in your version, open
+\`AGENTS.md\` directly. Both files are kept in sync by \`vibe init\`.
+
+## Project-specific guidance
+
+<!-- Add Gemini-CLI-specific notes here: any conventions specific to
+     how you drive vibe from Gemini CLI (preferred models, tone, etc.). -->
+`;
 function renderEnvExample(opts = {}) {
   const fallback2 = opts.withLocalFallbackHeader === false ? "" : `# \u2500\u2500 Local fallbacks (no key needed) \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
 # Kokoro TTS (local, ~330MB on first call)  \u2192  works without ELEVENLABS_API_KEY
@@ -68651,8 +69538,9 @@ defaults:
 
 // src/commands/init.ts
 init_output();
-var VALID_AGENTS = ["claude-code", "codex", "cursor", "aider", "all", "auto"];
+var VALID_AGENTS = ["claude-code", "codex", "cursor", "aider", "gemini-cli", "opencode", "all", "auto"];
 var initCommand = new Command("init").description("Scaffold project-scope agent files (AGENTS.md / CLAUDE.md / .env.example / .gitignore)").argument("[project-dir]", "Project directory (defaults to cwd)", ".").option("--agent <id>", `Agent target: ${VALID_AGENTS.join(" | ")}`, "auto").option("--force", "Overwrite existing files instead of skipping").option("--dry-run", "Print the file list without writing anything").action(async (projectDirArg, options) => {
+  const startedAt = Date.now();
   const agent = options.agent;
   if (!VALID_AGENTS.includes(agent)) {
     exitWithError(usageError(`Invalid --agent: ${agent}`, `Must be one of: ${VALID_AGENTS.join(", ")}`));
@@ -68661,6 +69549,7 @@ var initCommand = new Command("init").description("Scaffold project-scope agent
   const projectName = basename19(projectDir);
   const targetHosts = resolveTargets(agent);
   const wantsClaude = targetHosts.includes("claude-code");
+  const wantsGemini = targetHosts.includes("gemini-cli");
   const wantsCrossTool = targetHosts.some((h) => h !== "claude-code");
   const actions = [];
   if (!existsSync34(projectDir)) {
@@ -68686,6 +69575,14 @@ var initCommand = new Command("init").description("Scaffold project-scope agent
       options.dryRun
     ));
   }
+  if (wantsGemini) {
+    actions.push(await writeIfMissing(
+      resolve48(projectDir, "GEMINI.md"),
+      GEMINI_MD,
+      options.force,
+      options.dryRun
+    ));
+  }
   actions.push(await writeIfMissing(
     resolve48(projectDir, ".env.example"),
     renderEnvExample(),
@@ -68704,13 +69601,16 @@ var initCommand = new Command("init").description("Scaffold project-scope agent
     options.dryRun
   ));
   if (isJsonMode()) {
-    outputResult({
+    outputSuccess({
       command: "init",
-      projectDir,
-      agent,
-      targetHosts,
-      actions,
-      dryRun: options.dryRun ?? false
+      startedAt,
+      ...options.dryRun ? { dryRun: true } : {},
+      data: {
+        projectDir,
+        agent,
+        targetHosts,
+        actions
+      }
     });
     return;
   }
@@ -68744,7 +69644,7 @@ var initCommand = new Command("init").description("Scaffold project-scope agent
 });
 function resolveTargets(agent) {
   if (agent === "all") {
-    return ["claude-code", "codex", "cursor", "aider"];
+    return ["claude-code", "codex", "cursor", "aider", "gemini-cli", "opencode"];
   }
   if (agent === "auto") {
     const detected = detectedAgentHosts().map((h) => h.id);
@@ -68834,14 +69734,15 @@ Examples:
   $ vibe doctor --json       Machine-readable output
 `
 ).action(async (options) => {
+  const startedAt = Date.now();
   if (options.json) process.env.VIBE_JSON_OUTPUT = "1";
   const isJson = process.env.VIBE_JSON_OUTPUT === "1";
   const results = await runDiagnostics();
   if (isJson) {
-    outputResult({
-      success: true,
+    outputSuccess({
       command: "doctor",
-      result: results
+      startedAt,
+      data: { ...results }
     });
     return;
   }
@@ -69213,6 +70114,7 @@ async function generateTestVideo(outputPath) {
   }
 }
 var demoCommand = new Command("demo").description("Run sample edits on a test video (no API keys needed)").option("--keep", "Keep demo output files after completion").option("--json", "Output results as JSON").action(async (options) => {
+  const startedAt = Date.now();
   if (options.json) process.env.VIBE_JSON_OUTPUT = "1";
   const isJson = isJsonMode() || !process.stdin.isTTY;
   if (!commandExists("ffmpeg")) {
@@ -69312,11 +70214,16 @@ var demoCommand = new Command("demo").description("Run sample edits on a test vi
   const passed = results.filter((r) => r.success).length;
   const total = results.length;
   if (isJson) {
-    outputResult({
-      success: passed === total,
+    outputSuccess({
       command: "demo",
-      result: { passed, total, steps: results },
-      demoDir: DEMO_DIR
+      startedAt,
+      data: {
+        allPassed: passed === total,
+        passed,
+        total,
+        steps: results,
+        demoDir: DEMO_DIR
+      }
     });
   } else {
     console.log();
@@ -69429,6 +70336,7 @@ Variable references: $step_id.output, $step_id.data.field, \${ENV_VAR}
 Cost: Depends on steps. Use --dry-run to preview before executing.
 Run 'vibe schema run' for structured parameter info.
 `).action(async (pipelinePath, options) => {
+  const startedAt = Date.now();
   loadEnv();
   const isJson = options.json || process.env.VIBE_JSON_OUTPUT === "1";
   const cliBudget = {};
@@ -69461,13 +70369,16 @@ Run 'vibe schema run' for structured parameter info.
         budget: hasBudgetFlag ? cliBudget : void 0
       });
       if (isJson) {
-        outputResult({
-          dryRun: true,
+        outputSuccess({
           command: "run",
-          name: manifest2.name,
-          steps: result2.steps.map((s) => ({ id: s.id, action: s.action, estimatedCost: s.data?.estimatedCost })),
-          totalSteps: result2.totalSteps,
-          budget: result2.budget
+          startedAt,
+          dryRun: true,
+          data: {
+            name: manifest2.name,
+            steps: result2.steps.map((s) => ({ id: s.id, action: s.action, estimatedCost: s.data?.estimatedCost })),
+            totalSteps: result2.totalSteps,
+            budget: result2.budget
+          }
         });
       } else {
         console.log(source_default.bold("  Execution Plan:"));
@@ -69499,24 +70410,27 @@ Run 'vibe schema run' for structured parameter info.
     });
     spinner2?.stop();
     if (isJson) {
-      outputResult({
-        success: result.success,
-        name: result.name,
-        error: result.error,
-        completedSteps: result.completedSteps,
-        totalSteps: result.totalSteps,
-        totalDuration: result.totalDuration,
-        outputDir: result.outputDir,
-        budget: result.budget,
-        steps: result.steps.map((s) => ({
-          id: s.id,
-          action: s.action,
-          success: s.success,
-          output: s.output,
-          duration: s.duration,
-          error: s.error,
-          data: s.data
-        }))
+      outputSuccess({
+        command: "run",
+        startedAt,
+        data: {
+          name: result.name,
+          error: result.error,
+          completedSteps: result.completedSteps,
+          totalSteps: result.totalSteps,
+          totalDuration: result.totalDuration,
+          outputDir: result.outputDir,
+          budget: result.budget,
+          steps: result.steps.map((s) => ({
+            id: s.id,
+            action: s.action,
+            success: s.success,
+            output: s.output,
+            duration: s.duration,
+            error: s.error,
+            data: s.data
+          }))
+        }
       });
     } else {
       console.log();
@@ -70301,6 +71215,81 @@ function getEnvVar(provider) {
   return envVars[provider] || "API_KEY";
 }
 
+// src/commands/walkthrough.ts
+init_esm();
+init_source();
+init_walkthroughs();
+init_output();
+var walkthroughCommand = new Command("walkthrough").description("Step-by-step authoring guide for a vibe workflow (universal /vibe-* slash-command equivalent)").argument("[topic]", `Walkthrough topic: ${WALKTHROUGH_TOPICS.join(" | ")}. Omit to list all.`).option("--list", "List available walkthroughs and exit").action(async (topicArg, options) => {
+  const startedAt = Date.now();
+  if (!topicArg || options.list) {
+    const topics = listWalkthroughs();
+    if (isJsonMode()) {
+      outputSuccess({
+        command: "walkthrough",
+        startedAt,
+        data: {
+          action: "list",
+          topics
+        }
+      });
+      return;
+    }
+    console.log();
+    console.log(source_default.bold.cyan("Available walkthroughs"));
+    console.log(source_default.dim("\u2500".repeat(60)));
+    for (const t of topics) {
+      console.log(`  ${source_default.bold(t.topic.padEnd(10))} ${source_default.dim(t.summary)}`);
+    }
+    console.log();
+    console.log(source_default.dim("Run `vibe walkthrough <topic>` for the full guide."));
+    console.log(source_default.dim("Add `--json` to get structured output for an agent host."));
+    console.log();
+    return;
+  }
+  if (!isWalkthroughTopic(topicArg)) {
+    exitWithError(usageError(
+      `Unknown walkthrough topic: ${topicArg}`,
+      `Valid topics: ${WALKTHROUGH_TOPICS.join(", ")}`
+    ));
+  }
+  const topic = topicArg;
+  const result = loadWalkthrough(topic);
+  if (isJsonMode()) {
+    outputSuccess({
+      command: "walkthrough",
+      startedAt,
+      data: {
+        action: "show",
+        ...result
+      }
+    });
+    return;
+  }
+  console.log();
+  console.log(source_default.bold.cyan(result.title));
+  console.log(source_default.dim("\u2500".repeat(60)));
+  console.log(source_default.dim(result.summary));
+  console.log();
+  console.log(source_default.bold("Quick steps"));
+  console.log(source_default.dim("\u2500".repeat(60)));
+  for (let i = 0; i < result.steps.length; i++) {
+    console.log(`  ${source_default.cyan(`${i + 1}.`)} ${result.steps[i]}`);
+  }
+  console.log();
+  console.log(source_default.bold("Related commands"));
+  console.log(source_default.dim("\u2500".repeat(60)));
+  for (const cmd of result.relatedCommands) {
+    console.log(`  ${source_default.cyan(cmd)}`);
+  }
+  console.log();
+  console.log(source_default.bold("Full guide"));
+  console.log(source_default.dim("\u2500".repeat(60)));
+  console.log();
+  console.log(result.content);
+  console.log();
+});
+
 // src/index.ts
 init_api_key();
 
@@ -70501,6 +71490,7 @@ program2.addCommand(detectCommand);
 program2.addCommand(batchCommand);
 program2.addCommand(schemaCommand);
 program2.addCommand(contextCommand);
+program2.addCommand(walkthroughCommand);
 program2.addCommand(mediaCommand, { hidden: true });
 function propagateErrorHandling(cmd) {
   for (const sub of cmd.commands) {