@vibeframe/mcp-server 0.70.0 → 0.72.0

package/dist/index.js

@@ -79585,19 +79585,19 @@ var require_range = __commonJS({
     var replaceCaret = (comp, options) => {
       debug7("caret", comp, options);
       const r = options.loose ? re[t.CARETLOOSE] : re[t.CARET];
-      const z12 = options.includePrerelease ? "-0" : "";
+      const z13 = options.includePrerelease ? "-0" : "";
       return comp.replace(r, (_, M, m, p, pr) => {
         debug7("caret", comp, _, M, m, p, pr);
         let ret;
         if (isX(M)) {
           ret = "";
         } else if (isX(m)) {
-          ret = `>=${M}.0.0${z12} <${+M + 1}.0.0-0`;
+          ret = `>=${M}.0.0${z13} <${+M + 1}.0.0-0`;
         } else if (isX(p)) {
           if (M === "0") {
-            ret = `>=${M}.${m}.0${z12} <${M}.${+m + 1}.0-0`;
+            ret = `>=${M}.${m}.0${z13} <${M}.${+m + 1}.0-0`;
           } else {
-            ret = `>=${M}.${m}.0${z12} <${+M + 1}.0.0-0`;
+            ret = `>=${M}.${m}.0${z13} <${+M + 1}.0.0-0`;
           }
         } else if (pr) {
           debug7("replaceCaret pr", pr);
@@ -79614,9 +79614,9 @@ var require_range = __commonJS({
           debug7("no pr");
           if (M === "0") {
             if (m === "0") {
-              ret = `>=${M}.${m}.${p}${z12} <${M}.${m}.${+p + 1}-0`;
+              ret = `>=${M}.${m}.${p}${z13} <${M}.${m}.${+p + 1}-0`;
             } else {
-              ret = `>=${M}.${m}.${p}${z12} <${M}.${+m + 1}.0-0`;
+              ret = `>=${M}.${m}.${p}${z13} <${M}.${+m + 1}.0-0`;
             }
           } else {
             ret = `>=${M}.${m}.${p} <${+M + 1}.0.0-0`;
@@ -106350,7 +106350,7 @@ var require_emscripten_module_WASM_RELEASE_SYNC = __commonJS({
           m = b;
           n = c;
         });
-        var p = Object.assign({}, a), t = "./this.program", u = "object" == typeof window, v = "function" == typeof importScripts, w = "object" == typeof process && "object" == typeof process.versions && "string" == typeof process.versions.node, x = "", y, z12, A;
+        var p = Object.assign({}, a), t = "./this.program", u = "object" == typeof window, v = "function" == typeof importScripts, w = "object" == typeof process && "object" == typeof process.versions && "string" == typeof process.versions.node, x = "", y, z13, A;
         if (w) {
           var fs8 = __require("fs"), B = __require("path");
           x = v ? B.dirname(x) + "/" : __dirname + "/";
@@ -106366,7 +106366,7 @@ var require_emscripten_module_WASM_RELEASE_SYNC = __commonJS({
             b.buffer || (b = new Uint8Array(b));
             return b;
           };
-          z12 = (b, c, d) => {
+          z13 = (b, c, d) => {
             var e = C(b);
             e && c(e);
             b = b.startsWith("file://") ? new URL(b) : B.normalize(b);
@@ -106410,7 +106410,7 @@ var require_emscripten_module_WASM_RELEASE_SYNC = __commonJS({
                 return b;
               throw d;
             }
-          }), z12 = (b, c, d) => {
+          }), z13 = (b, c, d) => {
             var e = new XMLHttpRequest();
             e.open("GET", b, true);
             e.responseType = "arraybuffer";
@@ -106491,9 +106491,9 @@ var require_emscripten_module_WASM_RELEASE_SYNC = __commonJS({
               }).catch(function() {
                 return ha(b);
               });
-            if (z12)
+            if (z13)
               return new Promise(function(c, d) {
-                z12(b, function(e) {
+                z13(b, function(e) {
                   c(new Uint8Array(e));
                 }, d);
               });
@@ -347714,8 +347714,8 @@ async function queryElementStacking(page, nativeHdrVideoIds) {
       while (current) {
         const cs = window.getComputedStyle(current);
         const pos = cs.position;
-        const z12 = parseInt(cs.zIndex);
-        if (!Number.isNaN(z12) && pos !== "static") return z12;
+        const z13 = parseInt(cs.zIndex);
+        if (!Number.isNaN(z13) && pos !== "static") return z13;
         current = current.parentElement;
       }
       return 0;
@@ -396287,19 +396287,19 @@ ${sourceUrlComment}
         var replaceCaret = (comp, options) => {
           debug62("caret", comp, options);
           const r = options.loose ? re[t.CARETLOOSE] : re[t.CARET];
-          const z12 = options.includePrerelease ? "-0" : "";
+          const z13 = options.includePrerelease ? "-0" : "";
           return comp.replace(r, (_, M, m, p, pr) => {
             debug62("caret", comp, _, M, m, p, pr);
             let ret;
             if (isX(M)) {
               ret = "";
             } else if (isX(m)) {
-              ret = `>=${M}.0.0${z12} <${+M + 1}.0.0-0`;
+              ret = `>=${M}.0.0${z13} <${+M + 1}.0.0-0`;
             } else if (isX(p)) {
               if (M === "0") {
-                ret = `>=${M}.${m}.0${z12} <${M}.${+m + 1}.0-0`;
+                ret = `>=${M}.${m}.0${z13} <${M}.${+m + 1}.0-0`;
               } else {
-                ret = `>=${M}.${m}.0${z12} <${+M + 1}.0.0-0`;
+                ret = `>=${M}.${m}.0${z13} <${+M + 1}.0.0-0`;
               }
             } else if (pr) {
               debug62("replaceCaret pr", pr);
@@ -396316,9 +396316,9 @@ ${sourceUrlComment}
               debug62("no pr");
               if (M === "0") {
                 if (m === "0") {
-                  ret = `>=${M}.${m}.${p}${z12} <${M}.${m}.${+p + 1}-0`;
+                  ret = `>=${M}.${m}.${p}${z13} <${M}.${m}.${+p + 1}-0`;
                 } else {
-                  ret = `>=${M}.${m}.${p}${z12} <${M}.${+m + 1}.0-0`;
+                  ret = `>=${M}.${m}.${p}${z13} <${M}.${+m + 1}.0-0`;
                 }
               } else {
                 ret = `>=${M}.${m}.${p} <${+M + 1}.0.0-0`;
@@ -422114,7 +422114,7 @@ Attempted to suspend at:`);
               m = b;
               n = c;
             });
-            var p = Object.assign({}, a), t = "./this.program", u = "object" == typeof window, v = "function" == typeof importScripts, w = "object" == typeof process && "object" == typeof process.versions && "string" == typeof process.versions.node, x = "", y, z12, A;
+            var p = Object.assign({}, a), t = "./this.program", u = "object" == typeof window, v = "function" == typeof importScripts, w = "object" == typeof process && "object" == typeof process.versions && "string" == typeof process.versions.node, x = "", y, z13, A;
             if (w) {
               var fs8 = __require2("fs"), B = __require2("path");
               x = v ? B.dirname(x) + "/" : __dirname + "/";
@@ -422130,7 +422130,7 @@ Attempted to suspend at:`);
                 b.buffer || (b = new Uint8Array(b));
                 return b;
               };
-              z12 = (b, c, d) => {
+              z13 = (b, c, d) => {
                 var e = C(b);
                 e && c(e);
                 b = b.startsWith("file://") ? new URL(b) : B.normalize(b);
@@ -422174,7 +422174,7 @@ Attempted to suspend at:`);
                     return b;
                   throw d;
                 }
-              }), z12 = (b, c, d) => {
+              }), z13 = (b, c, d) => {
                 var e = new XMLHttpRequest();
                 e.open("GET", b, true);
                 e.responseType = "arraybuffer";
@@ -422255,9 +422255,9 @@ Attempted to suspend at:`);
                   }).catch(function() {
                     return ha(b);
                   });
-                if (z12)
+                if (z13)
                   return new Promise(function(c, d) {
-                    z12(b, function(e) {
+                    z13(b, function(e) {
                       c(new Uint8Array(e));
                     }, d);
                   });
@@ -448826,6 +448826,26 @@ function detectAgentHosts(env4 = 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 = [];
@@ -448873,14 +448893,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"
     };
   }
 });
@@ -449205,6 +449232,7 @@ __export(output_exports, {
   notFoundError: () => notFoundError,
   outputError: () => outputError,
   outputResult: () => outputResult,
+  outputSuccess: () => outputSuccess,
   spinner: () => spinner,
   suggestNext: () => suggestNext,
   usageError: () => usageError
@@ -449263,6 +449291,40 @@ function formatCost(min, max, unit) {
   if (min === max) return `~$${min.toFixed(2)} ${unit}`;
   return `~$${min.toFixed(2)}-$${max.toFixed(2)} ${unit}`;
 }
+function lookupCostEstimateUpperBound(command3) {
+  return COST_ESTIMATES[command3]?.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 keys2 = fields.split(",").map((k) => k.trim());
+      const data = opts.data;
+      const filteredData = {};
+      for (const key2 of keys2) {
+        if (key2 in data) filteredData[key2] = data[key2];
+      }
+      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];
@@ -451854,6 +451916,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);
@@ -451870,16 +451933,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;
@@ -451904,13 +451970,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;
       }
@@ -451948,6 +452017,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);
@@ -451960,16 +452030,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;
@@ -451998,12 +452071,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;
       }
@@ -452022,6 +452098,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);
@@ -452034,13 +452111,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;
@@ -452061,11 +452141,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;
       }
@@ -452081,6 +452164,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);
@@ -452093,15 +452177,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;
@@ -452124,12 +452211,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;
       }
@@ -452146,6 +452236,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);
@@ -452158,14 +452249,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;
@@ -452195,12 +452289,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;
       }
@@ -452217,6 +452314,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);
@@ -452231,15 +452329,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;
@@ -452268,13 +452369,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;
       }
@@ -453419,6 +453523,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) {
@@ -453434,13 +453539,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: resolve29(process.cwd(), videoPath),
-              style: options.style || options.preset,
-              analyzeOnly: options.analyzeOnly || false
+            startedAt,
+            dryRun: true,
+            data: {
+              params: {
+                videoPath: resolve29(process.cwd(), videoPath),
+                style: options.style || options.preset,
+                analyzeOnly: options.analyzeOnly || false
+              }
             }
           });
           return;
@@ -453466,12 +453574,15 @@ Run 'vibe schema edit.<command>' for structured parameter info.
         if (isJsonMode()) {
           const absPath2 = resolve29(process.cwd(), videoPath);
           const gradeOutputPath = options.output ? resolve29(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;
         }
@@ -453500,6 +453611,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'));
@@ -453512,18 +453624,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: resolve29(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: resolve29(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;
@@ -453548,11 +453663,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;
         }
@@ -453569,6 +453687,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);
@@ -453577,15 +453696,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: resolve29(process.cwd(), videoPath),
-              style: options.style,
-              minSpeed: parseFloat(options.minSpeed),
-              maxSpeed: parseFloat(options.maxSpeed),
-              analyzeOnly: options.analyzeOnly || false
+            startedAt,
+            dryRun: true,
+            data: {
+              params: {
+                videoPath: resolve29(process.cwd(), videoPath),
+                style: options.style,
+                minSpeed: parseFloat(options.minSpeed),
+                maxSpeed: parseFloat(options.maxSpeed),
+                analyzeOnly: options.analyzeOnly || false
+              }
             }
           });
           return;
@@ -453638,11 +453760,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 ? resolve29(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;
         }
@@ -453682,6 +453807,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);
@@ -453690,14 +453816,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: resolve29(process.cwd(), videoPath),
-              aspect: options.aspect,
-              focus: options.focus,
-              analyzeOnly: options.analyzeOnly || false
+            startedAt,
+            dryRun: true,
+            data: {
+              params: {
+                videoPath: resolve29(process.cwd(), videoPath),
+                aspect: options.aspect,
+                focus: options.focus,
+                analyzeOnly: options.analyzeOnly || false
+              }
             }
           });
           return;
@@ -453765,13 +453894,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 ? resolve29(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;
         }
@@ -453822,6 +453954,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"));
@@ -453837,16 +453970,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) => resolve29(process.cwd(), p)),
-              prompt: prompt3,
-              provider,
-              model: options.model,
-              ratio: options.ratio,
-              size: options.size
+            startedAt,
+            dryRun: true,
+            data: {
+              params: {
+                imagePaths: imagePaths.map((p) => resolve29(process.cwd(), p)),
+                prompt: prompt3,
+                provider,
+                model: options.model,
+                ratio: options.ratio,
+                size: options.size
+              }
             }
           });
           return;
@@ -453924,11 +454060,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;
@@ -453944,6 +454083,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);
@@ -453954,14 +454094,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;
@@ -453988,12 +454131,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;
           }
@@ -454019,6 +454165,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);
@@ -454029,14 +454176,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;
@@ -454062,10 +454212,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;
             }
@@ -454770,21 +454923,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;
@@ -455052,27 +455209,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;
@@ -455186,20 +455347,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;
@@ -455226,7 +455391,11 @@ function registerSoundEffectCommand(parent) {
       await writeFile22(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}`));
@@ -455276,6 +455445,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",
@@ -455287,12 +455457,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;
       }
@@ -455330,6 +455503,7 @@ var init_music_status = __esm({
 // ../cli/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;
@@ -455342,7 +455516,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 {
@@ -455362,7 +455540,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 {
@@ -455435,16 +455617,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;
       }
@@ -455479,7 +455663,11 @@ function registerBackgroundCommand(parent) {
           await mkdir18(dirname25(outputPath), { recursive: true });
           await writeFile23(outputPath, buffer);
         }
-        outputResult({ success: true, imageUrl: img.url, outputPath });
+        outputSuccess({
+          command: "generate background",
+          startedAt,
+          data: { imageUrl: img.url, outputPath }
+        });
         return;
       }
       console.log();
@@ -455576,6 +455764,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) {
@@ -455591,13 +455780,16 @@ function registerStoryboardCommand(parent) {
         textContent2 = await readFile23(filePath, "utf-8");
       }
       if (options.dryRun) {
-        outputResult({
-          dryRun: true,
+        outputSuccess({
           command: "generate storyboard",
-          params: {
-            content: textContent2.substring(0, 200),
-            duration: options.duration,
-            creativity
+          startedAt,
+          dryRun: true,
+          data: {
+            params: {
+              content: textContent2.substring(0, 200),
+              duration: options.duration,
+              creativity
+            }
           }
         });
         return;
@@ -455629,16 +455821,23 @@ function registerStoryboardCommand(parent) {
         const outputPath = resolve39(process.cwd(), options.output);
         await writeFile24(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();
@@ -455770,6 +455969,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()) {
@@ -455791,10 +455991,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;
       }
@@ -455883,10 +456084,13 @@ function registerSpeechCommand(parent) {
         }
       }
       if (isJsonMode()) {
-        outputResult({
-          success: true,
-          characterCount: result.characterCount,
-          outputPath
+        outputSuccess({
+          command: "generate speech",
+          startedAt,
+          data: {
+            characterCount: result.characterCount,
+            outputPath
+          }
         });
         return;
       }
@@ -455975,6 +456179,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) {
@@ -455982,16 +456187,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;
@@ -456018,11 +456226,14 @@ function registerMusicCommand(parent) {
         await writeFile26(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;
         }
@@ -456090,12 +456301,15 @@ function registerMusicCommand(parent) {
         await writeFile26(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;
         }
@@ -456130,6 +456344,7 @@ import { existsSync as existsSync47 } from "node:fs";
 import { writeFile as writeFile27, mkdir as mkdir19 } 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) {
@@ -456165,11 +456380,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;
         }
@@ -456217,7 +456435,11 @@ function registerThumbnailCommand(parent) {
           await mkdir19(dirname26(outputPath), { recursive: true });
           await writeFile27(outputPath, buffer);
         }
-        outputResult({ success: true, imageUrl: img.url, outputPath });
+        outputSuccess({
+          command: "generate thumbnail",
+          startedAt,
+          data: { imageUrl: img.url, outputPath }
+        });
         return;
       }
       console.log();
@@ -456288,6 +456510,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") {
@@ -456310,14 +456533,17 @@ function registerVideoStatusCommand(parent) {
             outputPath = resolve44(process.cwd(), options.output);
             await writeFile28(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;
         }
@@ -456375,15 +456601,18 @@ function registerVideoStatusCommand(parent) {
             outputPath = resolve44(process.cwd(), options.output);
             await writeFile28(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;
         }
@@ -456439,15 +456668,18 @@ function registerVideoStatusCommand(parent) {
             outputPath = resolve44(process.cwd(), options.output);
             await writeFile28(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;
         }
@@ -456511,22 +456743,26 @@ import { resolve as resolve45 } from "node:path";
 import { writeFile as writeFile29 } 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;
@@ -456583,13 +456819,16 @@ function registerVideoExtendCommand(parent) {
             outputPath = resolve45(process.cwd(), options.output);
             await writeFile29(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;
         }
@@ -456669,13 +456908,16 @@ function registerVideoExtendCommand(parent) {
             outputPath = resolve45(process.cwd(), options.output);
             await writeFile29(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;
         }
@@ -456790,6 +457032,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()) {
@@ -456848,18 +457091,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;
@@ -456897,14 +457143,17 @@ Examples:
             await mkdir20(dirname27(outputPath), { recursive: true });
             await writeFile30(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;
         }
@@ -457016,13 +457265,18 @@ Examples:
             await mkdir20(dirname27(outputPath), { recursive: true });
             await writeFile30(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;
         }
@@ -457106,11 +457360,14 @@ Examples:
             await mkdir20(dirname27(outputPath), { recursive: true });
             await writeFile30(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;
         }
@@ -457181,11 +457438,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"));
@@ -458911,6 +459171,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()) {
@@ -459002,19 +459263,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;
@@ -459294,13 +459558,16 @@ Examples:
           outputPath = resolve49(process.cwd(), options.output);
           await writeFile33(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;
       }
@@ -459865,20 +460132,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;
@@ -459980,20 +460251,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;
@@ -460062,18 +460337,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;
@@ -461547,20 +461826,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 ?? basename6(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;
@@ -461576,19 +461859,21 @@ sceneCommand.command("init").description("Scaffold a new scene project (or safel
       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;
     }
@@ -461629,6 +461914,7 @@ sceneCommand.command("init").description("Scaffold a new scene project (or safel
 });
 var 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(", ")}`));
@@ -461648,15 +461934,17 @@ sceneCommand.command("install-skill").description("Install the Hyperframes skill
     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;
   }
@@ -461678,6 +461966,7 @@ sceneCommand.command("install-skill").description("Install the Hyperframes skill
   }
 });
 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 = resolve21(projectDirArg);
   const result = await getComposePrompts({
     projectDir,
@@ -461685,18 +461974,21 @@ sceneCommand.command("compose-prompts").description("Emit the per-beat compose p
   });
   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;
   }
@@ -461730,20 +462022,23 @@ sceneCommand.command("compose-prompts").description("Emit the per-beat compose p
   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;
     }
@@ -461771,7 +462066,11 @@ sceneCommand.command("styles").description("List vendored visual styles (or show
     return;
   }
   if (isJsonMode()) {
-    outputResult({ success: true, command: "scene styles", style });
+    outputSuccess({
+      command: "scene styles",
+      startedAt,
+      data: { style }
+    });
     return;
   }
   console.log();
@@ -461793,6 +462092,7 @@ sceneCommand.command("styles").description("List vendored visual styles (or show
   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;
@@ -461803,25 +462103,28 @@ sceneCommand.command("add").description("Add a new scene to a project: AI narrat
   }
   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;
@@ -461856,9 +462159,10 @@ sceneCommand.command("add").description("Add a new scene to a project: AI narrat
       exitWithError(generalError(result.error ?? "Scene add failed"));
     }
     if (isJsonMode()) {
-      outputResult({
+      outputSuccess({
         command: "scene add",
-        ...result
+        startedAt,
+        data: { ...result }
       });
       return;
     }
@@ -462154,6 +462458,7 @@ async function executeSceneAdd(opts) {
   };
 }
 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 (root2, options) => {
+  const startedAt = Date.now();
   const projectDir = resolve21(options.project);
   if (!await rootExists(projectDir, root2)) {
     exitWithError(generalError(
@@ -462171,11 +462476,12 @@ sceneCommand.command("lint").description("Validate scene HTML against Hyperframe
     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) {
@@ -462209,7 +462515,7 @@ sceneCommand.command("lint").description("Validate scene HTML against Hyperframe
       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;
 });
 function severityTag(severity) {
   if (severity === "error") return source_default.red("\u2718 error  ");
@@ -462246,23 +462552,27 @@ function validateWorkers(value) {
   return n;
 }
 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 (root2, options) => {
+  const startedAt = Date.now();
   const fps = validateFps(options.fps);
   const quality = validateQuality(options.quality);
   const format4 = validateFormat(options.format);
   const workers = validateWorkers(options.workers);
   const projectDir = resolve21(options.project);
   if (options.dryRun) {
-    outputResult({
-      dryRun: true,
+    outputSuccess({
       command: "scene render",
-      params: {
-        projectDir,
-        root: root2,
-        output: options.out,
-        fps,
-        quality,
-        format: format4,
-        workers
+      startedAt,
+      dryRun: true,
+      data: {
+        params: {
+          projectDir,
+          root: root2,
+          output: options.out,
+          fps,
+          quality,
+          format: format4,
+          workers
+        }
       }
     });
     return;
@@ -462283,13 +462593,22 @@ sceneCommand.command("render").description("Render a scene project to MP4/WebM/M
   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}`));
@@ -462309,25 +462628,29 @@ sceneCommand.command("render").description("Render a scene project to MP4/WebM/M
   }
 });
 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 = resolve21(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;
@@ -462381,13 +462704,22 @@ sceneCommand.command("build").description("One-shot: read STORYBOARD.md cues, di
   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") {
@@ -465897,6 +466229,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) {
@@ -465914,27 +466247,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();
@@ -466521,13 +466857,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: readFile34 } = await import("node:fs/promises");
   const { resolve: resolve64, basename: basename18 } = 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 = resolve64(process.cwd(), projectPath);
   const content = await readFile34(filePath, "utf-8");
@@ -466553,10 +466889,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,
@@ -467461,6 +467797,348 @@ var agentOnlyTools = [
   mediaConcatTool
 ];
 
+// ../cli/src/tools/manifest/walkthrough.ts
+import { z as z12 } from "zod";
+
+// ../cli/src/commands/_shared/walkthroughs/walkthroughs.ts
+var 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
+`;
+var 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.
+`;
+var 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"
+    ]
+  }
+};
+var CONTENT2 = {
+  scene: SCENE_WALKTHROUGH,
+  pipeline: PIPELINE_WALKTHROUGH
+};
+var WALKTHROUGH_TOPICS = ["scene", "pipeline"];
+function loadWalkthrough(topic) {
+  const meta = META[topic];
+  const content = CONTENT2[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
+  }));
+}
+
+// ../cli/src/tools/manifest/walkthrough.ts
+var walkthroughSchema = z12.object({
+  topic: z12.enum(WALKTHROUGH_TOPICS).optional().describe(
+    "Walkthrough topic to load. Omit to list every available walkthrough \u2014 useful for discovery on first contact."
+  )
+});
+var 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.`
+      ]
+    };
+  }
+});
+var walkthroughTools = [walkthroughTool];
+
 // ../cli/src/tools/manifest/index.ts
 var manifest = [
   ...sceneTools,
@@ -467473,15 +468151,16 @@ var manifest = [
   ...timelineTools,
   ...projectTools,
   ...exportTools,
-  ...agentOnlyTools
+  ...agentOnlyTools,
+  ...walkthroughTools
 ];
 
 // ../cli/src/tools/zod-to-json-schema.ts
-function getDef(z12) {
-  return z12._def;
+function getDef(z13) {
+  return z13._def;
 }
-function getDescription(z12) {
-  let current = z12;
+function getDescription(z13) {
+  let current = z13;
   while (current) {
     const def = getDef(current);
     if (def.description) return def.description;
@@ -467489,24 +468168,24 @@ function getDescription(z12) {
   }
   return void 0;
 }
-function unwrapOptional(z12) {
-  const def = getDef(z12);
+function unwrapOptional(z13) {
+  const def = getDef(z13);
   if (def.typeName === "ZodOptional" && def.innerType) {
     return { inner: def.innerType, optional: true };
   }
-  return { inner: z12, optional: false };
+  return { inner: z13, optional: false };
 }
-function unwrapDefault(z12) {
-  const def = getDef(z12);
+function unwrapDefault(z13) {
+  const def = getDef(z13);
   if (def.typeName === "ZodDefault" && def.innerType && def.defaultValue) {
     return { inner: def.innerType, defaultValue: def.defaultValue() };
   }
-  return { inner: z12 };
+  return { inner: z13 };
 }
-function convertLeaf(z12, description) {
-  const { inner: afterDefault, defaultValue } = unwrapDefault(z12);
+function convertLeaf(z13, description) {
+  const { inner: afterDefault, defaultValue } = unwrapDefault(z13);
   const def = getDef(afterDefault);
-  const desc = description ?? getDescription(z12);
+  const desc = description ?? getDescription(z13);
   const base = {};
   if (desc) base.description = desc;
   if (defaultValue !== void 0) base.default = defaultValue;
@@ -467553,8 +468232,8 @@ function convertLeaf(z12, description) {
       );
   }
 }
-function convertObject(z12, description) {
-  const def = getDef(z12);
+function convertObject(z13, description) {
+  const def = getDef(z13);
   if (def.typeName !== "ZodObject" || !def.shape) {
     throw new Error(`zod-to-json-schema: convertObject called on non-ZodObject (${def.typeName})`);
   }