npm - @vibeframe/mcp-server - Versions diffs - 0.72.0 → 0.74.0 - Mend

@vibeframe/mcp-server 0.72.0 → 0.74.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();
   }
 });
@@ -449221,8 +449755,10 @@ var output_exports = {};
 __export(output_exports, {
   COST_ESTIMATES: () => COST_ESTIMATES,
   ExitCode: () => ExitCode,
+  _resetDeprecationMemoryForTesting: () => _resetDeprecationMemoryForTesting,
   apiError: () => apiError,
   authError: () => authError,
+  emitDeprecationWarning: () => emitDeprecationWarning,
   exitWithError: () => exitWithError,
   generalError: () => generalError,
   isJsonMode: () => isJsonMode,
@@ -449367,6 +449903,19 @@ function suggestNext(tip) {
   Tip: ${tip}`));
   }
 }
+function emitDeprecationWarning(oldName, newName, removeIn) {
+  if (isJsonMode() || isQuietMode()) return;
+  if (!process.stderr.isTTY) return;
+  const key2 = `${oldName}\u2192${newName}`;
+  if (_seenDeprecations.has(key2)) return;
+  _seenDeprecations.add(key2);
+  process.stderr.write(
+    source_default.yellow(`[deprecated] '${oldName}' is deprecated; use '${newName}' instead. Alias will be removed in ${removeIn}.`) + "\n"
+  );
+}
+function _resetDeprecationMemoryForTesting() {
+  _seenDeprecations.clear();
+}
 function outputError(error, details) {
   if (isJsonMode()) {
     console.error(JSON.stringify({ success: false, error, ...details }, null, 2));
@@ -449374,7 +449923,7 @@ function outputError(error, details) {
     console.error(error);
   }
 }
-var ExitCode, PROVIDER_ERROR_HINTS, COST_ESTIMATES;
+var ExitCode, PROVIDER_ERROR_HINTS, COST_ESTIMATES, _seenDeprecations;
 var init_output = __esm({
   "../cli/src/commands/output.ts"() {
     "use strict";
@@ -449409,7 +449958,7 @@ var init_output = __esm({
       { pattern: /context_length_exceeded|maximum.*context.*length|token.*limit.*exceeded|prompt.*too.*long/i, suggestion: "Input exceeds the model's context window. Shorten the prompt, or use a model with larger context (run 'vibe schema <command>' for options).", retryable: false },
       { pattern: /model.*not.*found|invalid.*model|unknown.*model|model_not_found/i, suggestion: "The specified model is unavailable. Check 'vibe schema <command>' for valid model options.", retryable: false },
       // Provider-specific
-      { pattern: /voice.*not.*found|voice_not_found|invalid.*voice.?id/i, suggestion: "Voice ID not found. Run 'vibe audio voices' to list available voices, then pass --voice <id>.", retryable: false },
+      { pattern: /voice.*not.*found|voice_not_found|invalid.*voice.?id/i, suggestion: "Voice ID not found. Run 'vibe audio list-voices' to list available voices, then pass --voice <id>.", retryable: false },
       { pattern: /character.*(count|limit).*exceeded|invalid_character_count/i, suggestion: "Text exceeds the TTS provider's character limit. Shorten the text or split into chunks.", retryable: false },
       { pattern: /invalid.*aspect.*ratio|unsupported.*aspect.*ratio|unsupported.*resolution/i, suggestion: "This aspect ratio or resolution isn't supported by the chosen model. Check 'vibe schema <command>' for supported values.", retryable: false },
       { pattern: /invalid.*file.*format|unsupported.*(format|codec)|unsupported.*media.?type/i, suggestion: "Input file format not supported. Convert to MP4/MP3/PNG first with 'vibe export' or 'ffmpeg'.", retryable: false },
@@ -449460,57 +450009,7 @@ var init_output = __esm({
       // pre-flight). Range covers a 1-beat preview to a 10-beat long-form.
       "compose scenes with skills": { min: 0.05, max: 1.5, unit: "per pipeline" }
     };
-  }
-});
-// ../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();
+    _seenDeprecations = /* @__PURE__ */ new Set();
   }
 });
@@ -459164,9 +459663,14 @@ 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
@@ -459192,12 +459696,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;
@@ -459207,7 +459712,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."
             )
           );
         }
@@ -459270,14 +459775,15 @@ Examples:
           data: {
             params: {
               prompt: prompt3,
-              provider,
+              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
+              veoModel: options.veoModel,
+              seedanceModel: options.seedanceModel
             }
           }
         });
@@ -459288,6 +459794,7 @@ Examples:
         kling: "KLING_API_KEY",
         veo: "GOOGLE_API_KEY",
         grok: "XAI_API_KEY",
+        seedance: "FAL_KEY",
         fal: "FAL_KEY"
       };
       const providerNameMap = {
@@ -459295,7 +459802,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];
@@ -459514,15 +460022,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];
@@ -459534,8 +460042,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,
@@ -459660,7 +460169,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
@@ -459670,7 +460180,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
@@ -459718,12 +460229,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;
@@ -459735,7 +460254,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, {
@@ -460950,334 +461498,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();
@@ -461286,6 +461508,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";
@@ -461777,6 +462000,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(", ")}`));
@@ -461808,30 +462032,42 @@ 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("Lower-level scene authoring (add, lint, styles). For project flow use `vibe init` / `vibe build` / `vibe render`.").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
   $ vibe scene add intro --style announcement \\
       --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
+  $ vibe scene styles                                     # Browse seed visual styles for DESIGN.md
-A scene project is bilingual: it works with both \`vibe\` and \`npx hyperframes\`.
+For the project flow (init / build / render), use the top-level commands.
+The \`scene init\`, \`scene build\`, and \`scene render\` legacy aliases
+are still callable but hidden from this help \u2014 they will be removed in v1.0.
 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", { hidden: true }).description("Scaffold a new scene project (or safely augment an existing project) [legacy \u2014 prefer `vibe init`]").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) {
+    if (!isJsonMode() && !isQuietMode()) {
+      printSceneInitDryRun({ dir, name, aspect, duration, visualStyleName: visualStyle?.name ?? null, profile, groups });
+      return;
+    }
     outputSuccess({
       command: "scene init",
       startedAt,
@@ -461842,23 +462078,25 @@ sceneCommand.command("init").description("Scaffold a new scene project (or safel
           name,
           aspect,
           duration,
-          visualStyle: visualStyle?.name ?? null
-        }
+          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()) {
+    }) : { success: true, files: [], bundleVersion: "not-installed" };
+    if (isJsonMode() || isQuietMode()) {
       outputSuccess({
         command: "scene init",
         startedAt,
@@ -461868,16 +462106,27 @@ sceneCommand.command("init").description("Scaffold a new scene project (or safel
           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)));
@@ -461888,7 +462137,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)"));
@@ -461902,16 +462151,39 @@ 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();
@@ -462457,7 +462729,7 @@ 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)) {
@@ -462551,7 +462823,7 @@ 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) => {
+sceneCommand.command("render", { hidden: true }).description("Render a scene project to MP4/WebM/MOV via the Hyperframes producer (requires Chrome) [legacy \u2014 prefer `vibe render`]").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);
@@ -462627,7 +462899,7 @@ 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) => {
+sceneCommand.command("build", { hidden: true }).description("One-shot: read STORYBOARD.md cues, dispatch TTS + image-gen per beat, compose, render to MP4 [legacy \u2014 prefer `vibe build`]").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) {
@@ -462744,7 +463016,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;
   }
@@ -462883,7 +463155,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);
@@ -465041,38 +465313,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;
 }
@@ -465097,7 +465375,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) => {
@@ -466333,6 +466619,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);
@@ -467808,7 +468113,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.
@@ -467816,19 +468121,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).
@@ -467839,7 +468144,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
@@ -467849,7 +468154,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
@@ -467861,12 +468166,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\`)
@@ -467884,18 +468189,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.
@@ -467918,9 +468223,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
@@ -468004,8 +468309,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\`,
@@ -468040,18 +468345,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"