npm - @vibeframe/mcp-server - Versions diffs - 0.71.0 → 0.73.0 - Mend

@vibeframe/mcp-server 0.71.0 → 0.73.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (3) hide show

package/dist/index.js CHANGED Viewed

@@ -7330,6 +7330,441 @@ var require_dist = __commonJS({
   }
 });
+// ../cli/src/commands/_shared/scene-project.ts
+import { mkdir, readFile, writeFile, access } from "node:fs/promises";
+import { resolve, basename } from "node:path";
+function aspectToDims(aspect) {
+  return ASPECT_DIMS[aspect];
+}
+function defaultVibeProjectConfig(name) {
+  return {
+    name,
+    aspect: "16:9",
+    defaultSceneDuration: 5,
+    providers: { image: null, tts: null, transcribe: null },
+    budget: { maxUsd: 0 }
+  };
+}
+function buildHyperframesConfig() {
+  return {
+    $schema: "https://hyperframes.heygen.com/schema/hyperframes.json",
+    registry: "https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry",
+    paths: {
+      blocks: "compositions",
+      components: "compositions/components",
+      assets: "assets"
+    }
+  };
+}
+function buildHyperframesMeta(name, now = /* @__PURE__ */ new Date()) {
+  return { id: name, name, createdAt: now.toISOString() };
+}
+function mergeHyperframesConfig(existing, defaults) {
+  const out = { ...defaults, ...existing };
+  if (existing.paths || defaults.paths) {
+    out.paths = { ...defaults.paths ?? {}, ...existing.paths ?? {} };
+  }
+  return out;
+}
+function buildEmptyRootHtml(opts) {
+  const { width, height } = ASPECT_DIMS[opts.aspect];
+  return `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=${width}, height=${height}" />
+    <script src="https://cdn.jsdelivr.net/npm/gsap@3.14.2/dist/gsap.min.js"></script>
+    <style>
+      * { margin: 0; padding: 0; box-sizing: border-box; }
+      html, body {
+        margin: 0;
+        width: ${width}px;
+        height: ${height}px;
+        overflow: hidden;
+        background: #000;
+      }
+    </style>
+  </head>
+  <body>
+    <div
+      id="root"
+      data-composition-id="main"
+      data-start="0"
+      data-duration="${opts.duration}"
+      data-width="${width}"
+      data-height="${height}"
+    >
+      <!-- Scenes added via \`vibe scene add\` are inserted here. -->
+      <!-- Each scene reference: data-composition-id, data-composition-src, data-start, data-duration, data-track-index. -->
+      <!-- See compositions/*.html for sub-composition contents. -->
+    </div>
+    <script>
+      window.__timelines = window.__timelines || {};
+      window.__timelines["main"] = gsap.timeline({ paused: true });
+    </script>
+  </body>
+</html>
+`;
+}
+function buildDesignMd(opts) {
+  const { name, style } = opts;
+  const intro = style ? `Visual identity for **${name}**, scaffolded from the **${style.name}** style (after ${style.designer}). Customise freely \u2014 this file is the single source of truth for every scene's palette, typography, and motion.` : `Visual identity for **${name}**. Fill the sections below before authoring any scene HTML or generating any backdrop. Pick a named style with \`vibe scene styles\` if you want a credible starting point.`;
+  const moodLine = style ? `**Mood:** ${style.mood} \xB7 **Best for:** ${style.bestFor}` : `**Mood:** _(one line \u2014 what should the viewer FEEL?)_`;
+  const palette = style ? `${style.palette.map((c) => `- \`${c}\``).join("\n")}
+${style.paletteNotes}` : `- _hex_ \u2014 primary
+- _hex_ \u2014 accent
+_2\u20133 colours max. Declare explicit hex values; never name colours abstractly._`;
+  const typography = style ? style.typography : `_One family, two weights. State the role of each (headline / label / body)._`;
+  const composition = style ? style.composition : `_Grid? Centered? Layered? How does negative space behave?_`;
+  const motion = style ? `${style.motion}
+**GSAP signature:** ${style.gsapSignature}` : `_How fast? Snappy or fluid? Overshoot or precision?_
+**GSAP signature:** _e.g. \`expo.out\`, \`sine.inOut\`, \`back.out(1.8)\`_`;
+  const transition = style ? style.transition : `_Which Hyperframes shader matches the energy? (Cinematic Zoom, Cross-Warp Morph, Glitch, Domain Warp, \u2026)_`;
+  const avoid = style ? style.avoid.map((a) => `- ${a}`).join("\n") : `- _anti-pattern 1_
+- _anti-pattern 2_
+- _anti-pattern 3_`;
+  return `# ${name} \u2014 Design
+> **Hard-gate.** This file defines the visual identity of every scene.
+> Author it before generating any HTML, backdrop image, or motion.
+> The Hyperframes \`hyperframes\` skill enforces this: scenes that
+> contradict DESIGN.md are rejected.
+${intro}
+## Style
+${moodLine}
+## Palette
+${palette}
+## Typography
+${typography}
+## Composition
+${composition}
+## Motion
+${motion}
+## Transition
+${transition}
+## What NOT to do
+${avoid}
+---
+_Browse other named styles: \`vibe scene styles\`_
+${style ? `_This file was seeded by \`vibe scene init --visual-style "${style.name}"\`._` : `_Seed this file from a named style: \`vibe scene init <dir> --visual-style "<name>"\`._`}
+`;
+}
+function buildStoryboardMd(name, duration = 12) {
+  return `---
+title: ${name}
+duration: ${duration}
+aspect: 16:9
+tts: auto
+imageProvider: openai
+---
+# ${name} \u2014 Storyboard
+Edit these beats before running \`vibe build\`. Each beat starts with
+YAML cues that drive narration, backdrop generation, and timing.
+## Beat hook \u2014 Hook
+\`\`\`yaml
+narration: "Introduce the promise in one crisp sentence."
+backdrop: "Cinematic abstract technology backdrop, precise light, premium editorial feel"
+duration: 4
+\`\`\`
+Show the core visual identity immediately. Keep copy short enough for one
+screen and one spoken breath.
+## Beat proof \u2014 Proof
+\`\`\`yaml
+narration: "Show the mechanism or proof point that makes the promise believable."
+backdrop: "Layered interface details, subtle motion trails, high-contrast product storytelling"
+duration: 4
+\`\`\`
+Use this beat for the concrete differentiator: command, workflow, metric, or
+before/after.
+## Beat close \u2014 Close
+\`\`\`yaml
+narration: "Close with the action the viewer should remember."
+backdrop: "Resolved hero frame, confident final composition, clean negative space"
+duration: 4
+\`\`\`
+End on the product name, offer, or command. Avoid adding a new idea in the
+final beat.
+`;
+}
+function buildProjectClaudeMd(name) {
+  return `# ${name} \u2014 Scene Authoring Project
+This project is **bilingual**: it works with both VibeFrame (\`vibe\`) and
+HeyGen Hyperframes (\`hyperframes\`). You can run either CLI inside this
+directory.
+## Visual identity hard-gate
+**Author \`DESIGN.md\` before any scene HTML.** It defines palette,
+typography, motion, and transition rules. Both the agent-driven path and
+the fallback emit reference it; scenes that contradict DESIGN.md are
+rejected by the Hyperframes \`hyperframes\` skill.
+Browse named styles: \`vibe scene styles\`. Re-seed from one with
+\`vibe scene init . --visual-style "Swiss Pulse"\` (idempotent).
+## Skills \u2014 USE THESE FIRST
+**Always invoke the relevant skill before authoring scenes.** Skills encode
+framework-specific patterns (GSAP timeline registration, data-attribute
+semantics, VibeFrame pipeline conventions) that are NOT in generic web docs.
+| Skill             | Command          | When to use                                                                           |
+| ----------------- | ---------------- | ------------------------------------------------------------------------------------- |
+| **hyperframes**   | \`/hyperframes\`   | Cinematic-quality composition \u2014 DESIGN.md hard-gate, named styles, motion principles  |
+| **vibe-scene**    | \`/vibe-scene\`    | VibeFrame's authoring loop, AI assets, lint feedback, pipeline integration            |
+| **gsap**          | \`/gsap\`          | GSAP tweens, timelines, easing                                                        |
+Optional: install the upstream Hyperframes skills once per machine when your agent supports skill commands:
+\`\`\`bash
+npx skills add heygen-com/hyperframes
+\`\`\`
+Restart your agent session (or reload the skill list) after installing.
+If skills aren't available, follow the **Key Rules** below \u2014 they cover
+the framework-level minimum, not the cinematic craft layer.
+## Project structure
+- \`DESIGN.md\` \u2014 visual identity contract (palette, type, motion, transitions)
+- \`STORYBOARD.md\` \u2014 per-beat narration/backdrop/duration cues for \`vibe build\`
+- \`index.html\` \u2014 root composition (timeline)
+- \`compositions/scene-*.html\` \u2014 per-scene HTML authored by you or the agent
+- \`assets/\` \u2014 shared media (narration audio, images, video)
+- \`transcript.json\` \u2014 Whisper word-level transcript (if narration exists)
+- \`hyperframes.json\` \u2014 HF registry config (speak to both toolchains)
+- \`vibe.project.yaml\` \u2014 VibeFrame config (providers, budget)
+- \`renders/\` \u2014 output MP4s
+## Commands
+\`\`\`bash
+vibe scene add <name> --narration "..." --visuals "..."   # Author a new scene via AI
+vibe build                                                 # STORYBOARD.md \u2192 narrated MP4
+vibe scene lint                                             # Validate scenes (in-process HF linter)
+vibe scene render                                           # Render to MP4
+# Hyperframes CLI (if installed \u2014 works in this project too)
+npx hyperframes preview
+npx hyperframes render
+\`\`\`
+## Key Rules (for hand-authored scene HTML)
+1. Every timed element needs \`data-start\`, \`data-duration\`, and \`data-track-index\`.
+2. Elements with timing **MUST** have \`class="clip"\` \u2014 the framework uses this for visibility control.
+3. Timelines must be paused and registered on \`window.__timelines\`:
+   \`\`\`js
+   window.__timelines = window.__timelines || {};
+   window.__timelines["composition-id"] = gsap.timeline({ paused: true });
+   \`\`\`
+4. Videos use \`muted\` with a separate \`<audio>\` element for the audio track.
+5. Sub-compositions use \`data-composition-src="compositions/file.html"\`.
+6. Only deterministic logic \u2014 no \`Date.now()\`, \`Math.random()\`, or network fetches.
+## Linting \u2014 run after changes
+\`\`\`bash
+vibe scene lint           # preferred \u2014 in-process, no network
+vibe scene lint --fix     # auto-fix mechanical issues
+vibe scene lint --json    # structured output for agent loops
+\`\`\`
+`;
+}
+function buildSceneGitignore() {
+  return `# VibeFrame caches
+.vibeframe/cache/
+.vibeframe/checkpoints/
+# Render outputs
+renders/*.mp4
+tmp/
+# OS / editor
+.DS_Store
+*.log
+`;
+}
+function isSceneScaffoldProfile(value) {
+  return value === "minimal" || value === "agent" || value === "full";
+}
+function describeSceneScaffold(opts) {
+  const dir = resolve(opts.dir);
+  const profile = opts.profile ?? "full";
+  const groups = {
+    authoring: [
+      resolve(dir, "STORYBOARD.md"),
+      resolve(dir, "DESIGN.md"),
+      resolve(dir, "vibe.project.yaml"),
+      resolve(dir, ".gitignore")
+    ],
+    render: [],
+    agent: []
+  };
+  if (profile === "full") {
+    groups.render = [
+      resolve(dir, "index.html"),
+      resolve(dir, "compositions"),
+      resolve(dir, "assets"),
+      resolve(dir, "renders"),
+      resolve(dir, "hyperframes.json"),
+      resolve(dir, "meta.json")
+    ];
+  }
+  if (profile === "agent" || profile === "full") {
+    groups.agent = [
+      resolve(dir, "SKILL.md"),
+      resolve(dir, "references"),
+      resolve(dir, "CLAUDE.md")
+    ];
+  }
+  return groups;
+}
+async function pathExists(p) {
+  try {
+    await access(p);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function scaffoldSceneProject(opts) {
+  const dir = resolve(opts.dir);
+  const name = opts.name ?? basename(dir);
+  const aspect = opts.aspect ?? "16:9";
+  const duration = opts.duration ?? 10;
+  const now = opts.now ?? /* @__PURE__ */ new Date();
+  const profile = opts.profile ?? "full";
+  await mkdir(dir, { recursive: true });
+  if (profile === "full") {
+    await mkdir(resolve(dir, "compositions"), { recursive: true });
+    await mkdir(resolve(dir, "assets"), { recursive: true });
+    await mkdir(resolve(dir, "renders"), { recursive: true });
+  }
+  const created = [];
+  const skipped2 = [];
+  const merged = [];
+  if (profile === "full") {
+    const hfPath = resolve(dir, "hyperframes.json");
+    const hfDefaults = buildHyperframesConfig();
+    if (await pathExists(hfPath)) {
+      const existingRaw = await readFile(hfPath, "utf-8");
+      const existing = JSON.parse(existingRaw);
+      const mergedConfig = mergeHyperframesConfig(existing, hfDefaults);
+      await writeFile(hfPath, JSON.stringify(mergedConfig, null, 2) + "\n", "utf-8");
+      merged.push(hfPath);
+    } else {
+      await writeFile(hfPath, JSON.stringify(hfDefaults, null, 2) + "\n", "utf-8");
+      created.push(hfPath);
+    }
+    const metaPath = resolve(dir, "meta.json");
+    if (await pathExists(metaPath)) {
+      skipped2.push(metaPath);
+    } else {
+      await writeFile(metaPath, JSON.stringify(buildHyperframesMeta(name, now), null, 2) + "\n", "utf-8");
+      created.push(metaPath);
+    }
+    const rootPath = resolve(dir, "index.html");
+    if (await pathExists(rootPath)) {
+      skipped2.push(rootPath);
+    } else {
+      await writeFile(rootPath, buildEmptyRootHtml({ aspect, duration }), "utf-8");
+      created.push(rootPath);
+    }
+  }
+  const vibePath = resolve(dir, "vibe.project.yaml");
+  if (await pathExists(vibePath)) {
+    skipped2.push(vibePath);
+  } else {
+    const cfg = { ...defaultVibeProjectConfig(name), aspect };
+    await writeFile(vibePath, (0, import_yaml.stringify)(cfg), "utf-8");
+    created.push(vibePath);
+  }
+  if (profile === "agent" || profile === "full") {
+    const claudePath = resolve(dir, "CLAUDE.md");
+    if (await pathExists(claudePath)) {
+      skipped2.push(claudePath);
+    } else {
+      await writeFile(claudePath, buildProjectClaudeMd(name), "utf-8");
+      created.push(claudePath);
+    }
+  }
+  const designPath = resolve(dir, "DESIGN.md");
+  if (await pathExists(designPath)) {
+    skipped2.push(designPath);
+  } else {
+    await writeFile(
+      designPath,
+      buildDesignMd({ name, style: opts.visualStyle }),
+      "utf-8"
+    );
+    created.push(designPath);
+  }
+  const storyboardPath = resolve(dir, "STORYBOARD.md");
+  if (await pathExists(storyboardPath)) {
+    skipped2.push(storyboardPath);
+  } else {
+    await writeFile(storyboardPath, buildStoryboardMd(name, duration), "utf-8");
+    created.push(storyboardPath);
+  }
+  const gitignorePath = resolve(dir, ".gitignore");
+  if (await pathExists(gitignorePath)) {
+    skipped2.push(gitignorePath);
+  } else {
+    await writeFile(gitignorePath, buildSceneGitignore(), "utf-8");
+    created.push(gitignorePath);
+  }
+  return { created, skipped: skipped2, merged, groups: describeSceneScaffold({ dir, profile }) };
+}
+var import_yaml, ASPECT_DIMS;
+var init_scene_project = __esm({
+  "../cli/src/commands/_shared/scene-project.ts"() {
+    "use strict";
+    import_yaml = __toESM(require_dist(), 1);
+    ASPECT_DIMS = {
+      "16:9": { width: 1920, height: 1080 },
+      "9:16": { width: 1080, height: 1920 },
+      "1:1": { width: 1080, height: 1080 },
+      "4:5": { width: 1080, height: 1350 }
+    };
+  }
+});
 // ../../node_modules/.pnpm/commander@12.1.0/node_modules/commander/lib/error.js
 var require_error = __commonJS({
   "../../node_modules/.pnpm/commander@12.1.0/node_modules/commander/lib/error.js"(exports) {
@@ -13713,12 +14148,12 @@ var init_api_keys = __esm({
       label: "ImgBB",
       showInSetup: false,
       // not prompted in setup wizard — internal upload host
-      envExampleComment: "ImgBB API Key (image hosting \u2014 used by Kling and fal.ai for image-to-video uploads)",
+      envExampleComment: "ImgBB API Key (image hosting \u2014 used by Kling and Seedance for image-to-video uploads)",
       envExampleUrl: "https://api.imgbb.com/",
       // ImgBB has no provider class (envvar-only); doctor still shows what it
       // unlocks at the apiKey level.
       commandsUnlocked: [
-        "generate video -p kling/fal (image-to-video upload host)"
+        "generate video -p kling/seedance (image-to-video upload host)"
       ]
     });
     defineProvider({
@@ -23787,13 +24222,18 @@ var init_fal = __esm({
     defineProvider({
       id: "fal",
       label: "fal.ai (Seedance 2.0)",
+      displayName: "Seedance 2.0",
+      gateway: "fal.ai",
+      aliases: ["seedance"],
+      models: ["seedance-2.0", "seedance-2.0-fast"],
+      capabilities: ["text-to-video", "image-to-video", "native-audio"],
       apiKey: "fal",
       kinds: ["video"],
       resolverPriority: { video: 1 },
       commandsUnlocked: [
-        "generate video -p fal (Seedance 2.0 \u2014 default since v0.57)",
-        "generate video -p fal -m fast (lower-latency variant)",
-        "generate video -p fal -i <image> (image-to-video)"
+        "generate video -p seedance (Seedance 2.0 via fal.ai \u2014 default since v0.57)",
+        "generate video -p seedance --seedance-model fast (lower-latency variant)",
+        "generate video -p seedance -i <image> (image-to-video)"
       ]
     });
   }
@@ -446848,7 +447288,9 @@ function buildAudioMuxFilter(audios) {
     const inputIdx = i + 1;
     const delayMs = Math.max(0, Math.round(a.absoluteStart * 1e3));
     const volume = Number.isFinite(a.volume) ? a.volume : 1;
-    const trimSec = Math.max(0, a.clipDurationCap);
+    const durationHint = typeof a.durationHint === "number" && Number.isFinite(a.durationHint) ? Math.max(0, a.durationHint) : null;
+    const clipCap = Math.max(0, a.clipDurationCap);
+    const trimSec = durationHint === null ? clipCap : Math.min(durationHint, clipCap);
     const label = `a${i}`;
     const stage = [
       `[${inputIdx}:a]`,
@@ -447107,6 +447549,57 @@ var init_scene_render = __esm({
   }
 });
+// ../cli/src/utils/audio.ts
+async function getAudioDuration(filePath) {
+  try {
+    return await ffprobeDuration(filePath);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(`Failed to get audio duration: ${message}`);
+  }
+}
+async function getVideoDuration(filePath) {
+  try {
+    return await ffprobeDuration(filePath);
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(`Failed to get video duration: ${message}`);
+  }
+}
+async function extendVideoNaturally(videoPath, targetDuration, outputPath) {
+  const videoDuration = await getVideoDuration(videoPath);
+  const ratio = targetDuration / videoDuration;
+  if (ratio <= 1) {
+    const { copyFile: copyFile5 } = await import("node:fs/promises");
+    await copyFile5(videoPath, outputPath);
+    return;
+  }
+  if (ratio <= 1.15) {
+    const slowFactor = (1 / ratio).toFixed(4);
+    await execSafe("ffmpeg", ["-y", "-i", videoPath, "-filter:v", `setpts=${slowFactor}*PTS`, "-an", outputPath]);
+  } else if (ratio <= 1.4) {
+    const slowFactor = (1 / ratio).toFixed(4);
+    await execSafe("ffmpeg", ["-y", "-i", videoPath, "-filter:v", `minterpolate=fps=60:mi_mode=mci,setpts=${slowFactor}*PTS`, "-an", outputPath]);
+  } else {
+    const slowRatio = 0.7;
+    const slowedDuration = videoDuration / slowRatio;
+    const freezeDuration = targetDuration - slowedDuration;
+    if (freezeDuration <= 0) {
+      const slowFactor = (1 / ratio).toFixed(4);
+      await execSafe("ffmpeg", ["-y", "-i", videoPath, "-filter:v", `minterpolate=fps=60:mi_mode=mci,setpts=${slowFactor}*PTS`, "-an", outputPath]);
+    } else {
+      const slowFactor = (1 / slowRatio).toFixed(4);
+      await execSafe("ffmpeg", ["-y", "-i", videoPath, "-filter:v", `setpts=${slowFactor}*PTS,tpad=stop_mode=clone:stop_duration=${freezeDuration.toFixed(2)}`, "-an", outputPath]);
+    }
+  }
+}
+var init_audio = __esm({
+  "../cli/src/utils/audio.ts"() {
+    "use strict";
+    init_exec_safe();
+  }
+});
 // ../cli/src/commands/_shared/hf-skill-bundle/bundle-content.ts
 var SKILL_MD, HOUSE_STYLE_MD, MOTION_PRINCIPLES_MD, TYPOGRAPHY_MD, TRANSITIONS_MD;
 var init_bundle_content = __esm({
@@ -448703,7 +449196,7 @@ async function getComposePrompts(opts) {
     return baseError(`DESIGN.md not found at ${designPath}. Run \`vibe scene init <dir>\` first.`);
   }
   if (!existsSync24(storyboardPath)) {
-    return baseError(`STORYBOARD.md not found at ${storyboardPath}. Run \`vibe scene init <dir>\` first.`);
+    return baseError(`STORYBOARD.md not found at ${storyboardPath}. Run \`vibe scene init <dir>\` to create a starter, or add STORYBOARD.md with per-beat cues.`);
   }
   if (!existsSync24(skillPath)) {
     warnings.push(
@@ -448929,7 +449422,10 @@ async function executeSceneBuild(opts) {
   const mode = resolveSceneBuildMode(opts);
   const storyboardPath = join25(projectDir, "STORYBOARD.md");
   if (!existsSync26(storyboardPath)) {
-    return failBeforePrimitives(`STORYBOARD.md not found at ${storyboardPath}`, startedAt);
+    return failBeforePrimitives(
+      `STORYBOARD.md not found at ${storyboardPath}. Run \`vibe scene init <dir>\` to create a starter, or add STORYBOARD.md with per-beat cues.`,
+      startedAt
+    );
   }
   const storyboardMd = await readFile9(storyboardPath, "utf-8");
   const parsed = parseStoryboard(storyboardMd);
@@ -449009,6 +449505,13 @@ async function executeSceneBuild(opts) {
     }
     composeData = composeResult.data;
   }
+  if (!existsSync26(join25(projectDir, "index.html"))) {
+    await scaffoldSceneProject({
+      dir: projectDir,
+      name: projectDir.split(/[\\/]/).filter(Boolean).pop(),
+      profile: "full"
+    });
+  }
   await syncRootClipReferences(parsed.beats, projectDir, beatOutcomes);
   let outputPath;
   let renderResult;
@@ -449107,6 +449610,7 @@ async function dispatchBackdrop(beat, ctx) {
     ctx.onProgress({ type: "backdrop-cached", beatId: beat.id, path: rel });
     return { status: "cached", path: rel };
   }
+  loadSceneBuildEnv(ctx.projectDir);
   const apiKey = process.env.OPENAI_API_KEY ?? "";
   if (!apiKey) {
     const error = "OPENAI_API_KEY not set \u2014 cannot dispatch backdrop";
@@ -449135,6 +449639,18 @@ async function dispatchBackdrop(beat, ctx) {
   });
   return { status: "generated", path: rel };
 }
+function loadSceneBuildEnv(projectDir) {
+  (0, import_dotenv2.config)({ path: join25(projectDir, ".env"), quiet: true });
+  (0, import_dotenv2.config)({ path: resolve19(process.cwd(), ".env"), quiet: true });
+  let dir = process.cwd();
+  while (dir !== dirname15(dir)) {
+    if (existsSync26(join25(dir, "pnpm-workspace.yaml"))) {
+      (0, import_dotenv2.config)({ path: join25(dir, ".env"), quiet: true });
+      return;
+    }
+    dir = dirname15(dir);
+  }
+}
 async function skipped(kind, beatId, reason, ctx) {
   ctx.onProgress({ type: `${kind}-skipped`, beatId, reason });
   return { status: "skipped" };
@@ -449165,20 +449681,24 @@ async function syncRootClipReferences(beats, projectDir, outcomes) {
   const clipLines = [];
   const audioLines = [];
   for (const beat of beats) {
-    const duration = beat.duration ?? 3;
+    const outcome = outcomes.find((o) => o.beatId === beat.id);
+    const duration = await resolveBeatDuration({
+      beatDuration: beat.duration,
+      narrationPath: outcome?.narrationPath,
+      projectDir
+    });
     const compositionId = `scene-${beat.id}`;
     clipLines.push(
       `      <div class="clip" data-composition-id="${compositionId}" data-composition-src="compositions/${compositionId}.html" data-start="${cursor}" data-duration="${duration}" data-track-index="0"></div>`
     );
-    const outcome = outcomes.find((o) => o.beatId === beat.id);
     if (outcome?.narrationPath) {
       audioLines.push(
-        `      <audio src="${outcome.narrationPath}" data-start="${cursor}" data-duration="${duration}" data-track-index="2"></audio>`
+        `      <audio id="narration-${beat.id}" src="${outcome.narrationPath}" data-start="${cursor}" data-duration="${duration}" data-track-index="2"></audio>`
       );
     }
     cursor += duration;
   }
-  const totalDuration = cursor;
+  const totalDuration = Number(cursor.toFixed(2));
   const block = "      <!-- vibe-scene-build: clip refs (auto-generated; safe to re-run) -->\n" + clipLines.join("\n") + (audioLines.length > 0 ? "\n" + audioLines.join("\n") : "") + "\n      <!-- /vibe-scene-build -->";
   let next;
   const markerRe = /\n? *<!-- vibe-scene-build: clip refs.*?<!-- \/vibe-scene-build -->/s;
@@ -449196,22 +449716,36 @@ ${block}
     }
   }
   next = next.replace(
-    /(id="root"[\s\S]*?data-duration=")(\d+(?:\.\d+)?)(")/,
+    /(id="root"[\s\S]*?data-duration=")([^"]*)(")/,
     `$1${totalDuration}$3`
   );
   if (next !== html) {
     await writeFile8(rootPath, next, "utf-8");
   }
 }
+async function resolveBeatDuration(opts) {
+  const storyboardMin = opts.beatDuration ?? 3;
+  if (!opts.narrationPath) return Number(storyboardMin.toFixed(2));
+  try {
+    const audioDuration = await getAudioDuration(join25(opts.projectDir, opts.narrationPath));
+    return Number(Math.max(storyboardMin, audioDuration + 0.5).toFixed(2));
+  } catch {
+    return Number(storyboardMin.toFixed(2));
+  }
+}
+var import_dotenv2;
 var init_scene_build = __esm({
   "../cli/src/commands/_shared/scene-build.ts"() {
     "use strict";
+    import_dotenv2 = __toESM(require_main(), 1);
     init_dist();
+    init_audio();
     init_compose_scenes_skills();
     init_compose_prompts();
     init_agent_host_detect();
     init_scene_render();
     init_storyboard_parse();
+    init_scene_project();
     init_tts_resolve();
   }
 });
@@ -449232,6 +449766,7 @@ __export(output_exports, {
   notFoundError: () => notFoundError,
   outputError: () => outputError,
   outputResult: () => outputResult,
+  outputSuccess: () => outputSuccess,
   spinner: () => spinner,
   suggestNext: () => suggestNext,
   usageError: () => usageError
@@ -449290,6 +449825,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];
@@ -449428,57 +449997,6 @@ var init_output = __esm({
   }
 });
-// ../cli/src/utils/audio.ts
-async function getAudioDuration(filePath) {
-  try {
-    return await ffprobeDuration(filePath);
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    throw new Error(`Failed to get audio duration: ${message}`);
-  }
-}
-async function getVideoDuration(filePath) {
-  try {
-    return await ffprobeDuration(filePath);
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    throw new Error(`Failed to get video duration: ${message}`);
-  }
-}
-async function extendVideoNaturally(videoPath, targetDuration, outputPath) {
-  const videoDuration = await getVideoDuration(videoPath);
-  const ratio = targetDuration / videoDuration;
-  if (ratio <= 1) {
-    const { copyFile: copyFile5 } = await import("node:fs/promises");
-    await copyFile5(videoPath, outputPath);
-    return;
-  }
-  if (ratio <= 1.15) {
-    const slowFactor = (1 / ratio).toFixed(4);
-    await execSafe("ffmpeg", ["-y", "-i", videoPath, "-filter:v", `setpts=${slowFactor}*PTS`, "-an", outputPath]);
-  } else if (ratio <= 1.4) {
-    const slowFactor = (1 / ratio).toFixed(4);
-    await execSafe("ffmpeg", ["-y", "-i", videoPath, "-filter:v", `minterpolate=fps=60:mi_mode=mci,setpts=${slowFactor}*PTS`, "-an", outputPath]);
-  } else {
-    const slowRatio = 0.7;
-    const slowedDuration = videoDuration / slowRatio;
-    const freezeDuration = targetDuration - slowedDuration;
-    if (freezeDuration <= 0) {
-      const slowFactor = (1 / ratio).toFixed(4);
-      await execSafe("ffmpeg", ["-y", "-i", videoPath, "-filter:v", `minterpolate=fps=60:mi_mode=mci,setpts=${slowFactor}*PTS`, "-an", outputPath]);
-    } else {
-      const slowFactor = (1 / slowRatio).toFixed(4);
-      await execSafe("ffmpeg", ["-y", "-i", videoPath, "-filter:v", `setpts=${slowFactor}*PTS,tpad=stop_mode=clone:stop_duration=${freezeDuration.toFixed(2)}`, "-an", outputPath]);
-    }
-  }
-}
-var init_audio = __esm({
-  "../cli/src/utils/audio.ts"() {
-    "use strict";
-    init_exec_safe();
-  }
-});
 // ../cli/src/utils/subtitle.ts
 function detectFormat(outputPath, explicitFormat) {
   if (explicitFormat) {
@@ -451881,6 +452399,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);
@@ -451897,16 +452416,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;
@@ -451931,13 +452453,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;
       }
@@ -451975,6 +452500,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);
@@ -451987,16 +452513,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;
@@ -452025,12 +452554,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;
       }
@@ -452049,6 +452581,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);
@@ -452061,13 +452594,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;
@@ -452088,11 +452624,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;
       }
@@ -452108,6 +452647,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);
@@ -452120,15 +452660,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;
@@ -452151,12 +452694,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;
       }
@@ -452173,6 +452719,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);
@@ -452185,14 +452732,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;
@@ -452222,12 +452772,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;
       }
@@ -452244,6 +452797,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);
@@ -452258,15 +452812,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;
@@ -452295,13 +452852,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;
       }
@@ -453446,6 +454006,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) {
@@ -453461,13 +454022,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;
@@ -453493,12 +454057,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;
         }
@@ -453527,6 +454094,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'));
@@ -453539,18 +454107,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;
@@ -453575,11 +454146,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;
         }
@@ -453596,6 +454170,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);
@@ -453604,15 +454179,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;
@@ -453665,11 +454243,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;
         }
@@ -453709,6 +454290,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);
@@ -453717,14 +454299,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;
@@ -453792,13 +454377,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;
         }
@@ -453849,6 +454437,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"));
@@ -453864,16 +454453,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;
@@ -453951,11 +454543,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;
@@ -453971,6 +454566,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);
@@ -453981,14 +454577,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;
@@ -454015,12 +454614,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;
           }
@@ -454046,6 +454648,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);
@@ -454056,14 +454659,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;
@@ -454089,10 +454695,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;
             }
@@ -454797,21 +455406,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;
@@ -455079,27 +455692,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;
@@ -455213,20 +455830,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;
@@ -455253,7 +455874,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}`));
@@ -455303,6 +455928,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",
@@ -455314,12 +455940,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;
       }
@@ -455357,6 +455986,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;
@@ -455369,7 +455999,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 {
@@ -455389,7 +456023,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 {
@@ -455462,16 +456100,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;
       }
@@ -455506,7 +456146,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();
@@ -455603,6 +456247,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) {
@@ -455618,13 +456263,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;
@@ -455656,16 +456304,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();
@@ -455797,6 +456452,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()) {
@@ -455818,10 +456474,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;
       }
@@ -455910,10 +456567,13 @@ function registerSpeechCommand(parent) {
         }
       }
       if (isJsonMode()) {
-        outputResult({
-          success: true,
-          characterCount: result.characterCount,
-          outputPath
+        outputSuccess({
+          command: "generate speech",
+          startedAt,
+          data: {
+            characterCount: result.characterCount,
+            outputPath
+          }
         });
         return;
       }
@@ -456002,6 +456662,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) {
@@ -456009,16 +456670,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;
@@ -456045,11 +456709,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;
         }
@@ -456117,12 +456784,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;
         }
@@ -456157,6 +456827,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) {
@@ -456192,11 +456863,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;
         }
@@ -456244,7 +456918,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();
@@ -456315,6 +456993,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") {
@@ -456337,14 +457016,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;
         }
@@ -456402,15 +457084,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;
         }
@@ -456466,15 +457151,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;
         }
@@ -456538,22 +457226,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;
@@ -456610,13 +457302,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;
         }
@@ -456696,13 +457391,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;
         }
@@ -456817,6 +457515,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()) {
@@ -456875,18 +457574,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;
@@ -456924,14 +457626,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;
         }
@@ -457043,13 +457748,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;
         }
@@ -457133,11 +457843,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;
         }
@@ -457208,11 +457921,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"));
@@ -458931,13 +459647,19 @@ var init_ai_script_pipeline = __esm({
 import { resolve as resolve49 } from "node:path";
 import { readFile as readFile25, writeFile as writeFile33 } from "node:fs/promises";
 function registerVideoCommand(parent) {
-  parent.command("video").alias("vid").description("Generate video using AI (Kling, Runway, Veo, or Grok)").argument("[prompt]", "Text prompt describing the video (interactive if omitted)").option("-p, --provider <provider>", "Provider: fal (Seedance 2.0, default when FAL_KEY set), grok, kling, runway, veo").option("-k, --api-key <key>", "API key (or set XAI_API_KEY / RUNWAY_API_SECRET / KLING_API_KEY / GOOGLE_API_KEY env)").option("-o, --output <path>", "Output file path (downloads video)").option("-i, --image <path>", "Reference image for image-to-video").option("-d, --duration <sec>", "Duration: 5 or 10 seconds", "5").option("-r, --ratio <ratio>", "Aspect ratio: 16:9, 9:16, or 1:1 (auto-detected from image if omitted)").option("-s, --seed <number>", "Random seed for reproducibility (Runway only)").option("-m, --mode <mode>", "Generation mode: std or pro (Kling only)", "std").option("-n, --negative <prompt>", "Negative prompt - what to avoid (Kling/Veo)").option("--resolution <res>", "Video resolution: 720p, 1080p, 4k (Veo only)").option("--last-frame <path>", "Last frame image for frame interpolation (Veo only)").option("--ref-images <paths...>", "Reference images for character consistency (Veo 3.1 only, max 3)").option("--person <mode>", "Person generation: allow_all, allow_adult (Veo only)").option("--veo-model <model>", "Veo model: 3.0, 3.1, 3.1-fast (default: 3.1-fast)", "3.1-fast").option("--runway-model <model>", "Runway model: gen4.5 (default, text+image-to-video), gen4_turbo (image-to-video only)", "gen4.5").option("--no-wait", "Start generation and return task ID without waiting").option("--dry-run", "Preview parameters without executing").addHelpText("after", `
+  parent.command("video").alias("vid").description("Generate video using AI (Seedance, Grok, Kling, Runway, or Veo)").argument("[prompt]", "Text prompt describing the video (interactive if omitted)").option("-p, --provider <provider>", "Provider: seedance (ByteDance Seedance 2.0 via fal.ai), grok, kling, runway, veo. `fal` is a backwards-compatible alias for seedance.").option("-k, --api-key <key>", "API key (or set FAL_KEY / XAI_API_KEY / RUNWAY_API_SECRET / KLING_API_KEY / GOOGLE_API_KEY env)").option("-o, --output <path>", "Output file path (downloads video)").option("-i, --image <path>", "Reference image for image-to-video").option(
+    "-d, --duration <sec>",
+    "Duration in seconds. Seedance accepts 4-15 (`fal` alias supported); Kling accepts 5 or 10; Veo maps to 6 or 8.",
+    "5"
+  ).option("-r, --ratio <ratio>", "Aspect ratio: 16:9, 9:16, or 1:1 (auto-detected from image if omitted)").option("-s, --seed <number>", "Random seed for reproducibility (Runway only)").option("-m, --mode <mode>", "Generation mode: std or pro (Kling only)", "std").option("--seedance-model <model>", "Seedance variant: quality or fast (fal.ai only)", "quality").option("-n, --negative <prompt>", "Negative prompt - what to avoid (Kling/Veo)").option("--resolution <res>", "Video resolution: 720p, 1080p, 4k (Veo only)").option("--last-frame <path>", "Last frame image for frame interpolation (Veo only)").option("--ref-images <paths...>", "Reference images for character consistency (Veo 3.1 only, max 3)").option("--person <mode>", "Person generation: allow_all, allow_adult (Veo only)").option("--veo-model <model>", "Veo model: 3.0, 3.1, 3.1-fast (default: 3.1-fast)", "3.1-fast").option("--runway-model <model>", "Runway model: gen4.5 (default, text+image-to-video), gen4_turbo (image-to-video only)", "gen4.5").option("--no-wait", "Start generation and return task ID without waiting").option("--dry-run", "Preview parameters without executing").addHelpText("after", `
 Examples:
-  $ vibe generate video "dancing cat" -o cat.mp4                      # Grok (default)
+  $ vibe generate video "dancing cat" -o cat.mp4                      # Seedance when FAL_KEY is set
+  $ vibe gen vid "cinematic city timelapse" -o city.mp4 -p seedance   # Seedance via fal.ai
   $ vibe gen vid "city timelapse" -o city.mp4 -p kling                # Kling
   $ 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()) {
@@ -458958,12 +459680,13 @@ Examples:
       if (options.output) {
         validateOutputPath(options.output);
       }
-      const validProviders = ["runway", "kling", "veo", "grok", "fal"];
+      const validProviders = ["runway", "kling", "veo", "grok", "seedance", "fal"];
       const videoEnvMap = {
         grok: "XAI_API_KEY",
         veo: "GOOGLE_API_KEY",
         kling: "KLING_API_KEY",
         runway: "RUNWAY_API_SECRET",
+        seedance: "FAL_KEY",
         fal: "FAL_KEY"
       };
       let provider;
@@ -458973,7 +459696,7 @@ Examples:
           exitWithError(
             usageError(
               `Invalid provider: ${provider}`,
-              `Available providers: ${validProviders.join(", ")}`
+              "Available providers: seedance, grok, kling, runway, veo. `fal` is a backwards-compatible alias for seedance."
             )
           );
         }
@@ -459029,19 +459752,23 @@ 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: provider === "fal" ? "seedance" : provider,
+              duration: options.duration,
+              ratio: options.ratio,
+              image: options.image,
+              mode: options.mode,
+              negative: options.negative,
+              resolution: options.resolution,
+              veoModel: options.veoModel,
+              seedanceModel: options.seedanceModel
+            }
           }
         });
         return;
@@ -459051,6 +459778,7 @@ Examples:
         kling: "KLING_API_KEY",
         veo: "GOOGLE_API_KEY",
         grok: "XAI_API_KEY",
+        seedance: "FAL_KEY",
         fal: "FAL_KEY"
       };
       const providerNameMap = {
@@ -459058,7 +459786,8 @@ Examples:
         kling: "Kling",
         veo: "Veo",
         grok: "Grok",
-        fal: "fal.ai (Seedance 2.0)"
+        seedance: "Seedance 2.0 via fal.ai",
+        fal: "Seedance 2.0 via fal.ai"
       };
       const envKey = envKeyMap[provider];
       const providerName = providerNameMap[provider];
@@ -459277,15 +460006,15 @@ Examples:
           },
           3e5
         );
-      } else if (provider === "fal") {
+      } else if (provider === "fal" || provider === "seedance") {
         const fal = new FalProvider();
         await fal.initialize({ apiKey });
         let falImage = referenceImage;
         if (falImage && falImage.startsWith("data:")) {
-          spinner2.text = "Uploading image to ImgBB for fal...";
+          spinner2.text = "Uploading image to ImgBB for Seedance...";
           const imgbbKey = await getApiKeyFromConfig("imgbb") || process.env.IMGBB_API_KEY;
           if (!imgbbKey) {
-            spinner2.fail("ImgBB API key required for fal image-to-video");
+            spinner2.fail("ImgBB API key required for Seedance image-to-video");
             exitWithError(authError("IMGBB_API_KEY", "ImgBB"));
           }
           const base64Data = falImage.split(",")[1];
@@ -459297,8 +460026,9 @@ Examples:
           }
           falImage = uploadResult.url;
         }
-        spinner2.text = "Generating video with Seedance 2.0 (this may take 1-3 minutes)...";
-        const falModel = options.model === "fast" ? "seedance-2.0-fast" : "seedance-2.0";
+        spinner2.text = "Generating video with fal.ai Seedance 2.0 (this may take 1-3 minutes)...";
+        const seedanceModel = String(options.seedanceModel ?? "quality").toLowerCase();
+        const falModel = seedanceModel === "fast" || seedanceModel === "seedance-2.0-fast" ? "seedance-2.0-fast" : "seedance-2.0";
         result = await fal.generateVideo(prompt3, {
           prompt: prompt3,
           referenceImage: falImage,
@@ -459321,13 +460051,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;
       }
@@ -459420,7 +460153,8 @@ var init_generate = __esm({
 Examples:
   $ vibe generate image "a sunset over the ocean" -o sunset.png
   $ vibe generate image "logo design" -o logo.png -p openai
-  $ vibe generate video "dancing cat" -o cat.mp4                  # Grok (default, native audio)
+  $ vibe generate video "dancing cat" -o cat.mp4                  # Seedance when FAL_KEY is set
+  $ vibe generate video "city timelapse" -o city.mp4 -p seedance  # Seedance via fal.ai
   $ vibe generate video "city timelapse" -o city.mp4 -p kling     # Kling
   $ vibe generate video "epic scene" -i frame.png -o out.mp4 -p runway  # Image-to-video
   $ vibe generate speech "Hello world" -o hello.mp3
@@ -459430,7 +460164,8 @@ Examples:
 API Keys (per provider):
   GOOGLE_API_KEY     Image (default), Veo video
   OPENAI_API_KEY     Image (-p openai)
-  XAI_API_KEY        Grok image/video (default video)
+  FAL_KEY            Seedance video (-p seedance, default video)
+  XAI_API_KEY        Grok image/video
   KLING_API_KEY      Kling video (-p kling)
   RUNWAY_API_SECRET  Runway video (-p runway)
   ELEVENLABS_API_KEY Speech, sound effects, music
@@ -459478,12 +460213,20 @@ async function executeVideoGenerate(options) {
     negative,
     resolution,
     veoModel = "3.1-fast",
+    seedanceModel = "quality",
     output: output3,
     wait = true,
     apiKey
   } = options;
   try {
-    const envKeyMap = { grok: "XAI_API_KEY", runway: "RUNWAY_API_SECRET", kling: "KLING_API_KEY", veo: "GOOGLE_API_KEY" };
+    const envKeyMap = {
+      grok: "XAI_API_KEY",
+      runway: "RUNWAY_API_SECRET",
+      kling: "KLING_API_KEY",
+      veo: "GOOGLE_API_KEY",
+      seedance: "FAL_KEY",
+      fal: "FAL_KEY"
+    };
     const key2 = apiKey || process.env[envKeyMap[provider] || ""];
     if (!key2) return { success: false, error: `${envKeyMap[provider]} required for ${provider}` };
     let referenceImage;
@@ -459495,7 +460238,36 @@ async function executeVideoGenerate(options) {
       const mimeType = mimeTypes[ext || "png"] || "image/png";
       referenceImage = `data:${mimeType};base64,${imageBuffer.toString("base64")}`;
     }
-    if (provider === "runway") {
+    if (provider === "seedance" || provider === "fal") {
+      const fal = new FalProvider();
+      await fal.initialize({ apiKey: key2 });
+      let falImage = referenceImage;
+      if (falImage && falImage.startsWith("data:")) {
+        const imgbbKey = process.env.IMGBB_API_KEY;
+        if (!imgbbKey) return { success: false, error: "IMGBB_API_KEY required for Seedance image-to-video" };
+        const base64Data = falImage.split(",")[1];
+        const uploadResult = await uploadToImgbb(Buffer.from(base64Data, "base64"), imgbbKey);
+        if (!uploadResult.success || !uploadResult.url) return { success: false, error: `ImgBB upload failed: ${uploadResult.error}` };
+        falImage = uploadResult.url;
+      }
+      const model = seedanceModel === "fast" || seedanceModel === "seedance-2.0-fast" ? "seedance-2.0-fast" : "seedance-2.0";
+      const result = await fal.generateVideo(prompt3, {
+        prompt: prompt3,
+        referenceImage: falImage,
+        duration,
+        aspectRatio: ratio,
+        negativePrompt: negative,
+        model
+      });
+      if (result.status === "failed") return { success: false, error: result.error || "Seedance generation failed" };
+      let outputPath;
+      if (output3 && result.videoUrl) {
+        const buffer = await downloadVideo(result.videoUrl, key2);
+        outputPath = resolve50(process.cwd(), output3);
+        await writeFile34(outputPath, buffer);
+      }
+      return { success: true, taskId: result.id, status: "completed", videoUrl: result.videoUrl, outputPath, provider: "seedance" };
+    } else if (provider === "runway") {
       const runway = new RunwayProvider();
       await runway.initialize({ apiKey: key2 });
       const result = await runway.generateVideo(prompt3, {
@@ -459892,20 +460664,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;
@@ -460007,20 +460783,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;
@@ -460089,18 +460869,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;
@@ -460698,334 +461482,8 @@ function visualStyleNames() {
   return STYLES.map((s) => `"${s.name}"`).join(", ");
 }
-// ../cli/src/commands/_shared/scene-project.ts
-var import_yaml = __toESM(require_dist(), 1);
-import { mkdir, readFile, writeFile, access } from "node:fs/promises";
-import { resolve, basename } from "node:path";
-var ASPECT_DIMS = {
-  "16:9": { width: 1920, height: 1080 },
-  "9:16": { width: 1080, height: 1920 },
-  "1:1": { width: 1080, height: 1080 },
-  "4:5": { width: 1080, height: 1350 }
-};
-function aspectToDims(aspect) {
-  return ASPECT_DIMS[aspect];
-}
-function defaultVibeProjectConfig(name) {
-  return {
-    name,
-    aspect: "16:9",
-    defaultSceneDuration: 5,
-    providers: { image: null, tts: null, transcribe: null },
-    budget: { maxUsd: 0 }
-  };
-}
-function buildHyperframesConfig() {
-  return {
-    $schema: "https://hyperframes.heygen.com/schema/hyperframes.json",
-    registry: "https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry",
-    paths: {
-      blocks: "compositions",
-      components: "compositions/components",
-      assets: "assets"
-    }
-  };
-}
-function buildHyperframesMeta(name, now = /* @__PURE__ */ new Date()) {
-  return { id: name, name, createdAt: now.toISOString() };
-}
-function mergeHyperframesConfig(existing, defaults) {
-  const out = { ...defaults, ...existing };
-  if (existing.paths || defaults.paths) {
-    out.paths = { ...defaults.paths ?? {}, ...existing.paths ?? {} };
-  }
-  return out;
-}
-function buildEmptyRootHtml(opts) {
-  const { width, height } = ASPECT_DIMS[opts.aspect];
-  return `<!doctype html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=${width}, height=${height}" />
-    <script src="https://cdn.jsdelivr.net/npm/gsap@3.14.2/dist/gsap.min.js"></script>
-    <style>
-      * { margin: 0; padding: 0; box-sizing: border-box; }
-      html, body {
-        margin: 0;
-        width: ${width}px;
-        height: ${height}px;
-        overflow: hidden;
-        background: #000;
-      }
-    </style>
-  </head>
-  <body>
-    <div
-      id="root"
-      data-composition-id="main"
-      data-start="0"
-      data-duration="${opts.duration}"
-      data-width="${width}"
-      data-height="${height}"
-    >
-      <!-- Scenes added via \`vibe scene add\` are inserted here. -->
-      <!-- Each scene reference: data-composition-id, data-composition-src, data-start, data-duration, data-track-index. -->
-      <!-- See compositions/*.html for sub-composition contents. -->
-    </div>
-    <script>
-      window.__timelines = window.__timelines || {};
-      window.__timelines["main"] = gsap.timeline({ paused: true });
-    </script>
-  </body>
-</html>
-`;
-}
-function buildDesignMd(opts) {
-  const { name, style } = opts;
-  const intro = style ? `Visual identity for **${name}**, scaffolded from the **${style.name}** style (after ${style.designer}). Customise freely \u2014 this file is the single source of truth for every scene's palette, typography, and motion.` : `Visual identity for **${name}**. Fill the sections below before authoring any scene HTML or generating any backdrop. Pick a named style with \`vibe scene styles\` if you want a credible starting point.`;
-  const moodLine = style ? `**Mood:** ${style.mood} \xB7 **Best for:** ${style.bestFor}` : `**Mood:** _(one line \u2014 what should the viewer FEEL?)_`;
-  const palette = style ? `${style.palette.map((c) => `- \`${c}\``).join("\n")}
-${style.paletteNotes}` : `- _hex_ \u2014 primary
-- _hex_ \u2014 accent
-_2\u20133 colours max. Declare explicit hex values; never name colours abstractly._`;
-  const typography = style ? style.typography : `_One family, two weights. State the role of each (headline / label / body)._`;
-  const composition = style ? style.composition : `_Grid? Centered? Layered? How does negative space behave?_`;
-  const motion = style ? `${style.motion}
-**GSAP signature:** ${style.gsapSignature}` : `_How fast? Snappy or fluid? Overshoot or precision?_
-**GSAP signature:** _e.g. \`expo.out\`, \`sine.inOut\`, \`back.out(1.8)\`_`;
-  const transition = style ? style.transition : `_Which Hyperframes shader matches the energy? (Cinematic Zoom, Cross-Warp Morph, Glitch, Domain Warp, \u2026)_`;
-  const avoid = style ? style.avoid.map((a) => `- ${a}`).join("\n") : `- _anti-pattern 1_
-- _anti-pattern 2_
-- _anti-pattern 3_`;
-  return `# ${name} \u2014 Design
-> **Hard-gate.** This file defines the visual identity of every scene.
-> Author it before generating any HTML, backdrop image, or motion.
-> The Hyperframes \`hyperframes\` skill enforces this: scenes that
-> contradict DESIGN.md are rejected.
-${intro}
-## Style
-${moodLine}
-## Palette
-${palette}
-## Typography
-${typography}
-## Composition
-${composition}
-## Motion
-${motion}
-## Transition
-${transition}
-## What NOT to do
-${avoid}
----
-_Browse other named styles: \`vibe scene styles\`_
-${style ? `_This file was seeded by \`vibe scene init --visual-style "${style.name}"\`._` : `_Seed this file from a named style: \`vibe scene init <dir> --visual-style "<name>"\`._`}
-`;
-}
-function buildProjectClaudeMd(name) {
-  return `# ${name} \u2014 Scene Authoring Project
-This project is **bilingual**: it works with both VibeFrame (\`vibe\`) and
-HeyGen Hyperframes (\`hyperframes\`). You can run either CLI inside this
-directory.
-## Visual identity hard-gate
-**Author \`DESIGN.md\` before any scene HTML.** It defines palette,
-typography, motion, and transition rules. Both the agent-driven path and
-the fallback emit reference it; scenes that contradict DESIGN.md are
-rejected by the Hyperframes \`hyperframes\` skill.
-Browse named styles: \`vibe scene styles\`. Re-seed from one with
-\`vibe scene init . --visual-style "Swiss Pulse"\` (idempotent).
-## Skills \u2014 USE THESE FIRST
-**Always invoke the relevant skill before authoring scenes.** Skills encode
-framework-specific patterns (GSAP timeline registration, data-attribute
-semantics, VibeFrame pipeline conventions) that are NOT in generic web docs.
-| Skill             | Command          | When to use                                                                           |
-| ----------------- | ---------------- | ------------------------------------------------------------------------------------- |
-| **hyperframes**   | \`/hyperframes\`   | Cinematic-quality composition \u2014 DESIGN.md hard-gate, named styles, motion principles  |
-| **vibe-scene**    | \`/vibe-scene\`    | VibeFrame's authoring loop, AI assets, lint feedback, pipeline integration            |
-| **gsap**          | \`/gsap\`          | GSAP tweens, timelines, easing                                                        |
-Install the Hyperframes skills once per machine:
-\`\`\`bash
-npx skills add heygen-com/hyperframes
-\`\`\`
-Restart your agent session (or reload the skill list) after installing.
-If skills aren't available, follow the **Key Rules** below \u2014 they cover
-the framework-level minimum, not the cinematic craft layer.
-## Project structure
-- \`DESIGN.md\` \u2014 visual identity contract (palette, type, motion, transitions)
-- \`index.html\` \u2014 root composition (timeline)
-- \`compositions/scene-*.html\` \u2014 per-scene HTML authored by you or the agent
-- \`assets/\` \u2014 shared media (narration audio, images, video)
-- \`transcript.json\` \u2014 Whisper word-level transcript (if narration exists)
-- \`hyperframes.json\` \u2014 HF registry config (speak to both toolchains)
-- \`vibe.project.yaml\` \u2014 VibeFrame config (providers, budget)
-- \`renders/\` \u2014 output MP4s
-## Commands
-\`\`\`bash
-vibe scene add <name> --narration "..." --visuals "..."   # Author a new scene via AI
-vibe scene lint                                             # Validate scenes (in-process HF linter)
-vibe scene render                                           # Render to MP4
-# Hyperframes CLI (if installed \u2014 works in this project too)
-npx hyperframes preview
-npx hyperframes render
-\`\`\`
-## Key Rules (for hand-authored scene HTML)
-1. Every timed element needs \`data-start\`, \`data-duration\`, and \`data-track-index\`.
-2. Elements with timing **MUST** have \`class="clip"\` \u2014 the framework uses this for visibility control.
-3. Timelines must be paused and registered on \`window.__timelines\`:
-   \`\`\`js
-   window.__timelines = window.__timelines || {};
-   window.__timelines["composition-id"] = gsap.timeline({ paused: true });
-   \`\`\`
-4. Videos use \`muted\` with a separate \`<audio>\` element for the audio track.
-5. Sub-compositions use \`data-composition-src="compositions/file.html"\`.
-6. Only deterministic logic \u2014 no \`Date.now()\`, \`Math.random()\`, or network fetches.
-## Linting \u2014 run after changes
-\`\`\`bash
-vibe scene lint           # preferred \u2014 in-process, no network
-vibe scene lint --fix     # auto-fix mechanical issues
-vibe scene lint --json    # structured output for agent loops
-\`\`\`
-`;
-}
-function buildSceneGitignore() {
-  return `# VibeFrame caches
-.vibeframe/cache/
-.vibeframe/checkpoints/
-# Render outputs
-renders/*.mp4
-tmp/
-# OS / editor
-.DS_Store
-*.log
-`;
-}
-async function pathExists(p) {
-  try {
-    await access(p);
-    return true;
-  } catch {
-    return false;
-  }
-}
-async function scaffoldSceneProject(opts) {
-  const dir = resolve(opts.dir);
-  const name = opts.name ?? basename(dir);
-  const aspect = opts.aspect ?? "16:9";
-  const duration = opts.duration ?? 10;
-  const now = opts.now ?? /* @__PURE__ */ new Date();
-  await mkdir(dir, { recursive: true });
-  await mkdir(resolve(dir, "compositions"), { recursive: true });
-  await mkdir(resolve(dir, "assets"), { recursive: true });
-  const created = [];
-  const skipped2 = [];
-  const merged = [];
-  const hfPath = resolve(dir, "hyperframes.json");
-  const hfDefaults = buildHyperframesConfig();
-  if (await pathExists(hfPath)) {
-    const existingRaw = await readFile(hfPath, "utf-8");
-    const existing = JSON.parse(existingRaw);
-    const mergedConfig = mergeHyperframesConfig(existing, hfDefaults);
-    await writeFile(hfPath, JSON.stringify(mergedConfig, null, 2) + "\n", "utf-8");
-    merged.push(hfPath);
-  } else {
-    await writeFile(hfPath, JSON.stringify(hfDefaults, null, 2) + "\n", "utf-8");
-    created.push(hfPath);
-  }
-  const metaPath = resolve(dir, "meta.json");
-  if (await pathExists(metaPath)) {
-    skipped2.push(metaPath);
-  } else {
-    await writeFile(metaPath, JSON.stringify(buildHyperframesMeta(name, now), null, 2) + "\n", "utf-8");
-    created.push(metaPath);
-  }
-  const rootPath = resolve(dir, "index.html");
-  if (await pathExists(rootPath)) {
-    skipped2.push(rootPath);
-  } else {
-    await writeFile(rootPath, buildEmptyRootHtml({ aspect, duration }), "utf-8");
-    created.push(rootPath);
-  }
-  const vibePath = resolve(dir, "vibe.project.yaml");
-  if (await pathExists(vibePath)) {
-    skipped2.push(vibePath);
-  } else {
-    const cfg = { ...defaultVibeProjectConfig(name), aspect };
-    await writeFile(vibePath, (0, import_yaml.stringify)(cfg), "utf-8");
-    created.push(vibePath);
-  }
-  const claudePath = resolve(dir, "CLAUDE.md");
-  if (await pathExists(claudePath)) {
-    skipped2.push(claudePath);
-  } else {
-    await writeFile(claudePath, buildProjectClaudeMd(name), "utf-8");
-    created.push(claudePath);
-  }
-  const designPath = resolve(dir, "DESIGN.md");
-  if (await pathExists(designPath)) {
-    skipped2.push(designPath);
-  } else {
-    await writeFile(
-      designPath,
-      buildDesignMd({ name, style: opts.visualStyle }),
-      "utf-8"
-    );
-    created.push(designPath);
-  }
-  const gitignorePath = resolve(dir, ".gitignore");
-  if (await pathExists(gitignorePath)) {
-    skipped2.push(gitignorePath);
-  } else {
-    await writeFile(gitignorePath, buildSceneGitignore(), "utf-8");
-    created.push(gitignorePath);
-  }
-  return { created, skipped: skipped2, merged };
-}
+// ../cli/src/tools/manifest/scene.ts
+init_scene_project();
 // ../cli/src/commands/scene.ts
 init_esm();
@@ -461034,6 +461492,7 @@ init_ora();
 var import_yaml5 = __toESM(require_dist(), 1);
 init_dist();
 init_tts_resolve();
+init_scene_project();
 import { basename as basename6, resolve as resolve21, relative as relative7, dirname as dirname17 } from "node:path";
 import { mkdir as mkdir10, readFile as readFile10, writeFile as writeFile10, access as access4, copyFile as copyFile2 } from "node:fs/promises";
 import { existsSync as existsSync28 } from "node:fs";
@@ -461525,6 +461984,7 @@ function deriveInstallHosts(detected) {
 // ../cli/src/commands/scene.ts
 init_compose_prompts();
 var VALID_ASPECTS2 = ["16:9", "9:16", "1:1", "4:5"];
+var VALID_SCENE_INIT_PROFILES = ["minimal", "agent", "full"];
 function validateAspect(value) {
   if (!VALID_ASPECTS2.includes(value)) {
     exitWithError(usageError(`Invalid aspect ratio: ${value}`, `Valid: ${VALID_ASPECTS2.join(", ")}`));
@@ -461556,7 +462016,12 @@ function validateVisualStyle(value) {
   }
   return found;
 }
-var sceneCommand = new Command("scene").description("Author and render per-scene HTML compositions (Hyperframes backend)").addHelpText("after", `
+function formatSceneInitProfile(profile) {
+  if (profile === "minimal") return "authoring files only; build will add render scaffold when needed";
+  if (profile === "agent") return "authoring files plus local composition rules for host agents";
+  return "complete authoring, agent, and render scaffold";
+}
+var sceneCommand = new Command("scene").description("Advanced scene commands for VibeFrame video projects").addHelpText("after", `
 Examples:
   $ vibe scene init my-video                              # Scaffold a new project
   $ vibe scene init my-video -r 9:16 -d 30                # Vertical 30s project
@@ -461564,62 +462029,91 @@ Examples:
       --headline "Welcome to VibeFrame"                   # Headline-only scene
   $ vibe scene add overview --narration "VibeFrame turns scripts into video." \\
       --visuals "studio desk, soft lighting"              # AI narration + image
-  $ vibe scene lint                                       # Validate every scene against Hyperframes rules
+  $ vibe scene lint                                       # Validate every scene against composition rules
   $ vibe scene lint --fix                                 # Auto-fix mechanical issues (e.g. missing class="clip")
   $ vibe scene lint --json                                # Structured output for agent loops
   $ vibe scene render                                     # Render to renders/<name>-<timestamp>.mp4
   $ vibe scene render -o demo.mp4 --quality high          # Custom output path + quality
   $ vibe scene render --fps 60 --format webm              # 60fps WebM render
-A scene project is bilingual: it works with both \`vibe\` and \`npx hyperframes\`.
+Most users can start with \`vibe init\`, \`vibe build\`, and \`vibe render\`.
+This namespace exposes lower-level scene authoring and rendering controls.
 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) => {
+sceneCommand.command("init").description("Scaffold a new scene project (or safely augment an existing 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("--profile <profile>", "Scene profile: minimal (storyboard/design only), agent (recommended), full (render scaffold upfront)", "agent").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;
+  const profile = String(options.profile ?? "agent");
+  if (!isSceneScaffoldProfile(profile)) {
+    exitWithError(usageError(`Invalid --profile: ${profile}`, `Must be one of: ${VALID_SCENE_INIT_PROFILES.join(", ")}`));
+  }
+  const groups = describeSceneScaffold({ dir, profile });
   if (options.dryRun) {
-    outputResult({
-      dryRun: true,
+    if (!isJsonMode() && !isQuietMode()) {
+      printSceneInitDryRun({ dir, name, aspect, duration, visualStyleName: visualStyle?.name ?? null, profile, groups });
+      return;
+    }
+    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,
+          profile
+        },
+        groups
       }
     });
     return;
   }
-  const spinner2 = isJsonMode() ? null : ora(`Scaffolding scene project at ${dir}...`).start();
+  const spinner2 = isJsonMode() || isQuietMode() ? null : ora(`Scaffolding scene project at ${dir}...`).start();
   try {
-    const result = await scaffoldSceneProject({ dir, name, aspect, duration, visualStyle });
+    const result = await scaffoldSceneProject({ dir, name, aspect, duration, visualStyle, profile });
     const detectedIds = detectedAgentHosts().map((h) => h.id);
     const skillHosts = deriveInstallHosts(detectedIds);
     const projectAbs = resolve21(dir);
-    const skillResult = await installHyperframesSkill({
+    const skillResult = profile === "agent" || profile === "full" ? await installHyperframesSkill({
       projectDir: projectAbs,
       hosts: skillHosts
-    });
-    if (isJsonMode()) {
-      outputResult({
-        success: true,
+    }) : { success: true, files: [], bundleVersion: "not-installed" };
+    if (isJsonMode() || isQuietMode()) {
+      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,
+          profile,
+          created: result.created,
+          merged: result.merged,
+          skipped: result.skipped,
+          groups: result.groups,
+          skillFiles: skillResult.files,
+          skillBundleVersion: skillResult.bundleVersion
+        }
       });
       return;
     }
-    spinner2?.succeed(source_default.green(`Scene project ready: ${dir}`));
+    spinner2?.succeed(source_default.green(`Video project ready: ${dir}`));
+    console.log();
+    console.log(source_default.bold.cyan("Edit first"));
+    console.log(source_default.dim("\u2500".repeat(60)));
+    console.log(`  ${source_default.bold("STORYBOARD.md")} ${source_default.dim("# beats: narration, backdrop, minimum duration")}`);
+    console.log(`  ${source_default.bold("DESIGN.md")}     ${source_default.dim("# palette, typography, motion rules")}`);
+    console.log();
+    console.log(source_default.bold.cyan("Profile"));
+    console.log(source_default.dim("\u2500".repeat(60)));
+    console.log(`  ${source_default.bold(profile)} ${source_default.dim(formatSceneInitProfile(profile))}`);
     console.log();
     console.log(source_default.bold.cyan("Files"));
     console.log(source_default.dim("\u2500".repeat(60)));
@@ -461630,7 +462124,7 @@ sceneCommand.command("init").description("Scaffold a new scene project (or safel
     const skillSkipped = skillResult.files.filter((f) => f.status === "skipped-exists");
     if (skillWritten.length + skillSkipped.length > 0) {
       console.log();
-      console.log(source_default.bold.cyan("Hyperframes skill"));
+      console.log(source_default.bold.cyan("Composition rules"));
       console.log(source_default.dim("\u2500".repeat(60)));
       for (const f of skillWritten) console.log(source_default.green("  +"), f.path);
       for (const f of skillSkipped) console.log(source_default.dim("  \xB7"), f.path, source_default.dim("(kept existing)"));
@@ -461644,18 +462138,42 @@ sceneCommand.command("init").description("Scaffold a new scene project (or safel
     } else {
       console.log(`  ${source_default.cyan("vibe scene styles")}        ${source_default.dim("# pick a named style for DESIGN.md")}`);
     }
-    console.log(`  ${source_default.dim("Your agent now has Hyperframes rules in")} ${source_default.cyan("SKILL.md")} ${source_default.dim("\u2014 ask it to author scene HTML directly.")}`);
+    if (profile === "agent" || profile === "full") {
+      console.log(`  ${source_default.dim("Your agent now has composition rules in")} ${source_default.cyan("SKILL.md")} ${source_default.dim("\u2014 ask it to author scene HTML directly.")}`);
+    } else {
+      console.log(`  ${source_default.cyan("vibe scene install-skill")} ${source_default.dim("# add agent authoring rules later")}`);
+    }
     console.log(`  ${source_default.cyan("vibe scene add")} <name>    ${source_default.dim("# fallback: 5-preset emit (no agent)")}`);
-    console.log(`  ${source_default.cyan("vibe scene lint")}          ${source_default.dim("# validate HTML")}`);
-    console.log(`  ${source_default.cyan("vibe scene render")}        ${source_default.dim("# render to MP4")}`);
+    console.log(`  ${source_default.cyan("vibe build")}               ${source_default.dim("# build STORYBOARD.md into scenes/assets")}`);
+    console.log(`  ${source_default.cyan("vibe render")}              ${source_default.dim("# render to video")}`);
   } catch (error) {
     spinner2?.fail("Failed to scaffold scene project");
     const msg = error instanceof Error ? error.message : String(error);
     exitWithError(generalError(`Failed to scaffold: ${msg}`));
   }
 });
+function printSceneInitDryRun(opts) {
+  console.log();
+  console.log(source_default.bold.cyan("VibeFrame Scene Init - dry run"));
+  console.log(source_default.dim("-".repeat(60)));
+  console.log(`  Project:      ${source_default.bold(opts.dir)}`);
+  console.log(`  Name:         ${source_default.bold(opts.name)}`);
+  console.log(`  Profile:      ${source_default.bold(opts.profile)} ${source_default.dim(formatSceneInitProfile(opts.profile))}`);
+  console.log(`  Aspect:       ${opts.aspect}`);
+  console.log(`  Duration:     ${opts.duration}s`);
+  console.log(`  Visual style: ${opts.visualStyleName ?? "none"}`);
+  console.log();
+  console.log(source_default.bold.cyan("Files that would be prepared"));
+  console.log(source_default.dim("-".repeat(60)));
+  for (const file of opts.groups.authoring) console.log(`  authoring  ${file}`);
+  for (const file of opts.groups.agent) console.log(`  agent      ${file}`);
+  for (const file of opts.groups.render) console.log(`  render     ${file}`);
+  console.log();
+  console.log(source_default.dim("No files were written."));
+}
 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(", ")}`));
@@ -461675,15 +462193,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;
   }
@@ -461705,6 +462225,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,
@@ -461712,18 +462233,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;
   }
@@ -461757,20 +462281,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;
     }
@@ -461798,7 +462325,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();
@@ -461820,6 +462351,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;
@@ -461830,25 +462362,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;
@@ -461883,9 +462418,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;
     }
@@ -462180,7 +462716,8 @@ async function executeSceneAdd(opts) {
     transcriptWordCount
   };
 }
-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) => {
+sceneCommand.command("lint").description("Validate scene HTML against composition 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(
@@ -462198,11 +462735,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) {
@@ -462236,7 +462774,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  ");
@@ -462273,23 +462811,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;
@@ -462310,13 +462852,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}`));
@@ -462336,25 +462887,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;
@@ -462408,13 +462963,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") {
@@ -462439,7 +463003,7 @@ sceneCommand.command("build").description("One-shot: read STORYBOARD.md cues, di
       }
     }
     console.log();
-    console.log(source_default.dim("Once you've authored each beat's HTML, re-run `vibe scene build` to lint + render."));
+    console.log(source_default.dim("Once you've authored each beat's HTML, re-run `vibe build` to lint + render."));
     console.log(source_default.dim("Or pass `--mode batch` to use the internal LLM compose path instead."));
     return;
   }
@@ -462578,7 +463142,7 @@ var sceneInitTool = defineTool({
   name: "scene_init",
   category: "scene",
   cost: "free",
-  description: "Scaffold a new bilingual VibeFrame + Hyperframes scene project. Creates index.html, hyperframes.json, vibe.project.yaml, compositions/, assets/, .gitignore, and a project-local CLAUDE.md. Idempotent: re-running on an existing Hyperframes project merges hyperframes.json instead of overwriting. No API keys required.",
+  description: "Scaffold a new VibeFrame video scene project. Supports minimal, agent, and full profiles; full includes the current HTML render backend metadata. Idempotent: re-running keeps user-authored files and merges backend config instead of overwriting. No API keys required.",
   schema: sceneInitSchema,
   async execute(args, ctx) {
     const dir = resolve23(ctx.workingDirectory, args.dir);
@@ -464736,38 +465300,44 @@ function findUnresolvedRefs(params, availableStepIds) {
 // ../cli/src/pipeline/executor.ts
 init_output();
-var ACTION_TO_COMMAND = {
-  "generate-image": "generate image",
-  "generate-video": "generate video",
-  "generate-tts": "generate speech",
-  "generate-sfx": "generate sound-effect",
-  "generate-music": "generate music",
-  "generate-storyboard": "generate storyboard",
-  "generate-motion": "generate motion",
-  "edit-silence-cut": "edit silence-cut",
-  "edit-jump-cut": "edit jump-cut",
-  "edit-caption": "edit caption",
-  "edit-noise-reduce": "edit noise-reduce",
-  "edit-fade": "edit fade",
-  "edit-translate-srt": "edit translate-srt",
-  "edit-text-overlay": "edit text-overlay",
-  "edit-grade": "edit grade",
-  "edit-speed-ramp": "edit speed-ramp",
-  "edit-reframe": "edit reframe",
-  "edit-interpolate": "edit interpolate",
-  "edit-upscale": "edit upscale-video",
-  "edit-image": "edit image",
-  "audio-transcribe": "audio transcribe",
-  "detect-scenes": "detect scenes",
-  "detect-silence": "detect silence",
-  "detect-beats": "detect beats",
-  "analyze-media": "analyze media",
-  "analyze-video": "analyze video",
-  "review-video": "analyze review",
-  "compose-scenes-with-skills": "compose scenes with skills"
+var ACTION_METADATA = {
+  "generate-image": { id: "generate-image", title: "Generate image", category: "generate", command: "generate image", outputs: ["image"] },
+  "generate-video": { id: "generate-video", title: "Generate video", category: "generate", command: "generate video", outputs: ["video"], requiredKeys: ["provider-dependent"] },
+  "generate-tts": { id: "generate-tts", title: "Generate speech", category: "generate", command: "generate speech", outputs: ["audio"] },
+  "generate-sfx": { id: "generate-sfx", title: "Generate sound effect", category: "generate", command: "generate sound-effect", outputs: ["audio"] },
+  "generate-music": { id: "generate-music", title: "Generate music", category: "generate", command: "generate music", outputs: ["audio"] },
+  "generate-storyboard": { id: "generate-storyboard", title: "Generate storyboard", category: "generate", command: "generate storyboard", outputs: ["storyboard"] },
+  "generate-motion": { id: "generate-motion", title: "Generate motion", category: "generate", command: "generate motion", outputs: ["code", "video"] },
+  "edit-silence-cut": { id: "edit-silence-cut", title: "Cut silence", category: "edit", command: "edit silence-cut", outputs: ["video"] },
+  "edit-jump-cut": { id: "edit-jump-cut", title: "Jump cut", category: "edit", command: "edit jump-cut", outputs: ["video"] },
+  "edit-caption": { id: "edit-caption", title: "Caption video", category: "edit", command: "edit caption", outputs: ["video", "srt"] },
+  "edit-noise-reduce": { id: "edit-noise-reduce", title: "Reduce noise", category: "edit", command: "edit noise-reduce", outputs: ["video"] },
+  "edit-fade": { id: "edit-fade", title: "Add fade", category: "edit", command: "edit fade", outputs: ["video"] },
+  "edit-translate-srt": { id: "edit-translate-srt", title: "Translate subtitles", category: "edit", command: "edit translate-srt", outputs: ["srt"] },
+  "edit-text-overlay": { id: "edit-text-overlay", title: "Add text overlay", category: "edit", command: "edit text-overlay", outputs: ["video"] },
+  "edit-grade": { id: "edit-grade", title: "Color grade", category: "edit", command: "edit grade", outputs: ["video"] },
+  "edit-speed-ramp": { id: "edit-speed-ramp", title: "Speed ramp", category: "edit", command: "edit speed-ramp", outputs: ["video"] },
+  "edit-reframe": { id: "edit-reframe", title: "Reframe video", category: "edit", command: "edit reframe", outputs: ["video"] },
+  "edit-interpolate": { id: "edit-interpolate", title: "Interpolate frames", category: "edit", command: "edit interpolate", outputs: ["video"] },
+  "edit-upscale": { id: "edit-upscale", title: "Upscale video", category: "edit", command: "edit upscale-video", outputs: ["video"] },
+  "edit-image": { id: "edit-image", title: "Edit image", category: "edit", command: "edit image", outputs: ["image"] },
+  "audio-transcribe": { id: "audio-transcribe", title: "Transcribe audio", category: "audio", command: "audio transcribe", outputs: ["transcript", "srt"] },
+  "audio-isolate": { id: "audio-isolate", title: "Isolate audio", category: "audio", outputs: ["audio"] },
+  "audio-dub": { id: "audio-dub", title: "Dub audio", category: "audio", outputs: ["audio", "video"] },
+  "audio-duck": { id: "audio-duck", title: "Duck audio", category: "audio", outputs: ["video"] },
+  "detect-scenes": { id: "detect-scenes", title: "Detect scenes", category: "detect", command: "detect scenes", outputs: ["json"] },
+  "detect-silence": { id: "detect-silence", title: "Detect silence", category: "detect", command: "detect silence", outputs: ["json"] },
+  "detect-beats": { id: "detect-beats", title: "Detect beats", category: "detect", command: "detect beats", outputs: ["json"] },
+  "analyze-media": { id: "analyze-media", title: "Analyze media", category: "analyze", command: "analyze media", outputs: ["json"] },
+  "analyze-video": { id: "analyze-video", title: "Analyze video", category: "analyze", command: "analyze video", outputs: ["json"] },
+  "review-video": { id: "review-video", title: "Review video", category: "analyze", command: "analyze review", outputs: ["json"] },
+  "compose-scenes-with-skills": { id: "compose-scenes-with-skills", title: "Compose scenes with skills", category: "scene", command: "compose scenes with skills", outputs: ["html"] },
+  "scene-build": { id: "scene-build", title: "Build scene project", category: "scene", outputs: ["video", "html", "assets"] },
+  "scene-render": { id: "scene-render", title: "Render scene project", category: "scene", outputs: ["video"] },
+  export: { id: "export", title: "Export project", category: "export", outputs: ["video"] }
 };
 function maxCostFor(action) {
-  const cmd = ACTION_TO_COMMAND[action];
+  const cmd = ACTION_METADATA[action]?.command;
   if (!cmd) return 0;
   return COST_ESTIMATES[cmd]?.max ?? 0;
 }
@@ -464792,7 +465362,15 @@ async function ensureActionsRegistered() {
   registerAction("generate-video", async (params, outputDir) => {
     const { executeVideoGenerate: executeVideoGenerate2 } = await Promise.resolve().then(() => (init_ai_video(), ai_video_exports));
     const output3 = getOutput(params, outputDir, "video.mp4");
-    const r = await executeVideoGenerate2({ prompt: params.prompt, provider: params.provider, image: params.image, duration: params.duration, ratio: params.ratio, output: output3, wait: true });
+    const r = await executeVideoGenerate2({
+      prompt: params.prompt,
+      provider: params.provider,
+      image: params.image,
+      duration: params.duration,
+      ratio: params.ratio,
+      output: output3,
+      wait: true
+    });
     return { id: "", action: "generate-video", success: r.success, output: r.outputPath || r.videoUrl, data: { taskId: r.taskId, provider: r.provider, videoUrl: r.videoUrl }, error: r.error };
   });
   registerAction("generate-tts", async (params, outputDir) => {
@@ -465924,6 +466502,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) {
@@ -465941,27 +466520,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();
@@ -466024,6 +466606,25 @@ Run 'vibe schema export' for structured parameter info.`).action(async (projectP
       spinner2.text = `Encoding... ${progress}%`;
     });
     spinner2.succeed(source_default.green(`Exported: ${outputPath}`));
+    if (isJsonMode()) {
+      outputSuccess({
+        command: "export",
+        startedAt,
+        data: {
+          outputPath,
+          backend: "ffmpeg",
+          format: options.format,
+          preset: options.preset,
+          resolution: presetSettings.resolution,
+          duration: summary.duration,
+          clipCount: summary.clipCount,
+          bitrate: options.bitrate ?? null,
+          fps: options.fps ?? null,
+          codec: options.codec ?? null
+        }
+      });
+      return;
+    }
     console.log();
     console.log(source_default.dim("  Duration:"), `${summary.duration.toFixed(1)}s`);
     console.log(source_default.dim("  Clips:"), summary.clipCount);
@@ -466548,13 +467149,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");
@@ -466580,10 +467181,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,
@@ -467499,7 +468100,7 @@ A scene project is a directory that is **bilingual**: it works with both
 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
+\`vibe build\` (v0.60+) is the supported one-shot driver from a
 written storyboard to an MP4. Plan H (v0.70) added \`--mode agent\` so the
 host agent itself authors the per-beat HTML \u2014 no internal LLM call.
@@ -467507,19 +468108,19 @@ host agent itself authors the per-beat HTML \u2014 no internal LLM call.
 | 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 |
+| **One-shot (default, v0.60+)** | \`vibe build [project-dir]\` | STORYBOARD.md has YAML frontmatter + per-beat cues |
+| **High-craft (manual)** | \`DESIGN.md\` + local composition rules in your agent | Maximum control: hand-author each scene |
 | **Quick draft** | \`vibe scene add --style <preset>\` | No agent or no API keys; fast iteration |
-Recommend \`vibe scene build\` whenever the user has a STORYBOARD with
+Recommend \`vibe 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
+1. \`vibe init my-promo --visual-style "Swiss Pulse"\` \u2014 seeds
    \`DESIGN.md\` (palette, typography, motion, transitions) plus the
    \`vibe.project.yaml\` / \`hyperframes.json\` / \`index.html\` scaffold.
-   In Plan H this **also installs the Hyperframes skill** at the
+   In Plan H this **also installs local composition rules** at the
    right place for your host (\`.claude/skills/hyperframes/\` for Claude
    Code, \`.cursor/rules/hyperframes.mdc\` for Cursor, universal
    \`SKILL.md\` for everyone else).
@@ -467530,7 +468131,7 @@ narration / backdrop intent.
 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\`
+5. \`vibe scene lint --fix\` for mechanical issues, \`vibe render my-promo\`
    to MP4.
 ## Quick-draft path
@@ -467540,7 +468141,7 @@ 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 render my-promo
 \`\`\`
 \`vibe scene init\` is **idempotent** \u2014 running it on an existing
@@ -467552,12 +468153,12 @@ Safe to invoke on user-provided projects.
 \`\`\`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 install-skill [<dir>] [--host all]  # retroactive composition-rules install
 vibe scene add <name> --style <preset> [...]
 vibe scene compose-prompts [<dir>] [--beat <id>]   # H2: emit plan, no LLM call
 vibe scene lint [<root>] [--json] [--fix]
 vibe scene render [<root>] [--fps 30] [--quality standard] [--format mp4]
-vibe scene build [<dir>] [--mode agent|batch|auto]   # H3 dispatch
+vibe build [<dir>] [--mode agent|batch|auto]         # H3 dispatch
 \`\`\`
 ## Style presets (for \`vibe scene add --style\`)
@@ -467575,18 +468176,18 @@ from the generated TTS audio.
 ## STORYBOARD-to-MP4 (one command, v0.60+)
 \`\`\`bash
-vibe scene init my-promo --visual-style "Swiss Pulse" -d 12
+vibe 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 build my-promo
 \`\`\`
-\`vibe scene build\` reads the STORYBOARD frontmatter + per-beat cues,
+\`vibe build\` reads the STORYBOARD frontmatter + per-beat cues,
 dispatches TTS + image-gen per beat, then either:
 - **\`--mode agent\`** (default when an agent host is detected) \u2014 emits a
   \`needs-author\` plan via \`vibe scene compose-prompts\`. The host agent
   authors each \`compositions/scene-<id>.html\` itself, then re-invoking
-  \`vibe scene build\` proceeds to lint + render.
+  \`vibe build\` proceeds to lint + render.
 - **\`--mode batch\`** \u2014 VibeFrame runs an internal LLM (Claude / OpenAI /
   Gemini) to compose the HTML, then renders.
@@ -467609,9 +468210,9 @@ and surface the error to the user.
 | Task | Tool |
 |------|------|
 | Generate narration + image, then author scene | \`vibe scene add\` |
-| Generate a full scenes project from a STORYBOARD | \`vibe scene build\` |
+| Generate a full scenes project from a STORYBOARD | \`vibe build\` |
 | Hand-tweak a single scene's animation | edit \`compositions/<file>.html\` directly |
-| Render the project | \`vibe scene render\` *or* \`npx hyperframes render\` (equivalent) |
+| Render the project | \`vibe render\` *or* \`vibe scene render\` for lower-level control |
 | Lint | \`vibe scene lint\` *or* \`npx hyperframes lint\` (equivalent) |
 The \`vibe\` CLI adds asset generation, AI orchestration, and pipeline
@@ -467695,8 +468296,8 @@ 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).
+1. **Start from a tiny YAML** \u2014 keep it in your project directory and run
+   \`vibe run pipeline.yaml --dry-run\` before spending provider budget.
 2. **Dry-run first** \u2014 you see estimated cost and resolved variable
    graph before spending API credits.
 3. **Keep step ids short and descriptive** (\`intro\`, \`scene1\`, \`voice\`,
@@ -467731,18 +468332,18 @@ var META = {
     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).',
+      'Run `vibe init <dir> --visual-style "<style name>"` to scaffold the project + install local composition rules.',
       "Edit `STORYBOARD.md` with per-beat YAML cues (narration / backdrop / duration).",
       "Read `SKILL.md` for the framework rules and `DESIGN.md` for the visual-identity hard-gate.",
-      "Run `vibe 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."
+      "Run `vibe build <dir>`. With an agent host detected, the CLI emits a `needs-author` plan; the host agent authors each `compositions/scene-<id>.html` and re-invokes to render.",
+      "Run `vibe scene lint --fix` to validate, then `vibe render <dir>` to produce the MP4."
     ],
     relatedCommands: [
-      "vibe scene init",
+      "vibe init",
       "vibe scene styles",
       "vibe scene install-skill",
       "vibe scene compose-prompts",
-      "vibe scene build",
+      "vibe build",
       "vibe scene lint",
       "vibe scene render",
       "vibe scene add"