@vibeframe/cli 0.72.0 → 0.73.0

package/dist/index.js

@@ -14343,12 +14343,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({
@@ -15194,7 +15194,7 @@ var init_GeminiProvider = __esm({
        * Sleep helper
        */
       sleep(ms) {
-        return new Promise((resolve62) => setTimeout(resolve62, ms));
+        return new Promise((resolve64) => setTimeout(resolve64, ms));
       }
       /**
        * Extend a previously generated Veo video
@@ -19366,7 +19366,7 @@ var init_RunwayProvider = __esm({
        * Sleep helper
        */
       sleep(ms) {
-        return new Promise((resolve62) => setTimeout(resolve62, ms));
+        return new Promise((resolve64) => setTimeout(resolve64, ms));
       }
     };
     RunwayProvider.API_VERSION = "2024-11-06";
@@ -19807,7 +19807,7 @@ var init_KlingProvider = __esm({
        * Sleep helper
        */
       sleep(ms) {
-        return new Promise((resolve62) => setTimeout(resolve62, ms));
+        return new Promise((resolve64) => setTimeout(resolve64, ms));
       }
     };
     klingProvider = new KlingProvider();
@@ -20125,7 +20125,7 @@ var init_GrokProvider = __esm({
         }
       }
       sleep(ms) {
-        return new Promise((resolve62) => setTimeout(resolve62, ms));
+        return new Promise((resolve64) => setTimeout(resolve64, ms));
       }
     };
     grokProvider = new GrokProvider();
@@ -20160,11 +20160,11 @@ var require_middleware = __commonJS({
     "use strict";
     var __awaiter = exports && exports.__awaiter || function(thisArg, _arguments, P, generator) {
       function adopt(value) {
-        return value instanceof P ? value : new P(function(resolve62) {
-          resolve62(value);
+        return value instanceof P ? value : new P(function(resolve64) {
+          resolve64(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve62, reject) {
+      return new (P || (P = Promise))(function(resolve64, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -20180,7 +20180,7 @@ var require_middleware = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve62(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve64(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -20265,11 +20265,11 @@ var require_response = __commonJS({
     "use strict";
     var __awaiter = exports && exports.__awaiter || function(thisArg, _arguments, P, generator) {
       function adopt(value) {
-        return value instanceof P ? value : new P(function(resolve62) {
-          resolve62(value);
+        return value instanceof P ? value : new P(function(resolve64) {
+          resolve64(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve62, reject) {
+      return new (P || (P = Promise))(function(resolve64, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -20285,7 +20285,7 @@ var require_response = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve62(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve64(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -20392,11 +20392,11 @@ var require_utils = __commonJS({
     "use strict";
     var __awaiter = exports && exports.__awaiter || function(thisArg, _arguments, P, generator) {
       function adopt(value) {
-        return value instanceof P ? value : new P(function(resolve62) {
-          resolve62(value);
+        return value instanceof P ? value : new P(function(resolve64) {
+          resolve64(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve62, reject) {
+      return new (P || (P = Promise))(function(resolve64, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -20412,7 +20412,7 @@ var require_utils = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve62(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve64(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -20505,7 +20505,7 @@ var require_utils = __commonJS({
     }
     function sleep2(ms) {
       return __awaiter(this, void 0, void 0, function* () {
-        return new Promise((resolve62) => setTimeout(resolve62, ms));
+        return new Promise((resolve64) => setTimeout(resolve64, ms));
       });
     }
   }
@@ -20517,11 +20517,11 @@ var require_retry = __commonJS({
     "use strict";
     var __awaiter = exports && exports.__awaiter || function(thisArg, _arguments, P, generator) {
       function adopt(value) {
-        return value instanceof P ? value : new P(function(resolve62) {
-          resolve62(value);
+        return value instanceof P ? value : new P(function(resolve64) {
+          resolve64(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve62, reject) {
+      return new (P || (P = Promise))(function(resolve64, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -20537,7 +20537,7 @@ var require_retry = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve62(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve64(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -20744,11 +20744,11 @@ var require_request = __commonJS({
     "use strict";
     var __awaiter = exports && exports.__awaiter || function(thisArg, _arguments, P, generator) {
       function adopt(value) {
-        return value instanceof P ? value : new P(function(resolve62) {
-          resolve62(value);
+        return value instanceof P ? value : new P(function(resolve64) {
+          resolve64(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve62, reject) {
+      return new (P || (P = Promise))(function(resolve64, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -20764,7 +20764,7 @@ var require_request = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve62(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve64(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -20851,11 +20851,11 @@ var require_storage = __commonJS({
     "use strict";
     var __awaiter = exports && exports.__awaiter || function(thisArg, _arguments, P, generator) {
       function adopt(value) {
-        return value instanceof P ? value : new P(function(resolve62) {
-          resolve62(value);
+        return value instanceof P ? value : new P(function(resolve64) {
+          resolve64(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve62, reject) {
+      return new (P || (P = Promise))(function(resolve64, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -20871,7 +20871,7 @@ var require_storage = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve62(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve64(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -21199,11 +21199,11 @@ var require_auth = __commonJS({
     "use strict";
     var __awaiter = exports && exports.__awaiter || function(thisArg, _arguments, P, generator) {
       function adopt(value) {
-        return value instanceof P ? value : new P(function(resolve62) {
-          resolve62(value);
+        return value instanceof P ? value : new P(function(resolve64) {
+          resolve64(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve62, reject) {
+      return new (P || (P = Promise))(function(resolve64, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -21219,7 +21219,7 @@ var require_auth = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve62(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve64(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -21258,11 +21258,11 @@ var require_streaming = __commonJS({
     "use strict";
     var __awaiter = exports && exports.__awaiter || function(thisArg, _arguments, P, generator) {
       function adopt(value) {
-        return value instanceof P ? value : new P(function(resolve62) {
-          resolve62(value);
+        return value instanceof P ? value : new P(function(resolve64) {
+          resolve64(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve62, reject) {
+      return new (P || (P = Promise))(function(resolve64, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -21278,7 +21278,7 @@ var require_streaming = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve62(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve64(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -21511,7 +21511,7 @@ var require_streaming = __commonJS({
           query: options.queryParams
         });
         this.options = options;
-        this.donePromise = new Promise((resolve62, reject) => {
+        this.donePromise = new Promise((resolve64, reject) => {
           if (this.streamClosed) {
             reject(new response_1.ApiError({
               message: "Streaming connection is already closed.",
@@ -21522,11 +21522,11 @@ var require_streaming = __commonJS({
           }
           this.signal.addEventListener("abort", () => {
             var _a2;
-            resolve62((_a2 = this.currentData) !== null && _a2 !== void 0 ? _a2 : {});
+            resolve64((_a2 = this.currentData) !== null && _a2 !== void 0 ? _a2 : {});
           });
           this.on("done", (data) => {
             this.streamClosed = true;
-            resolve62(data);
+            resolve64(data);
           });
           this.on("error", (error) => {
             this.streamClosed = true;
@@ -21551,7 +21551,7 @@ var require_streaming = __commonJS({
             if (data) {
               yield yield __await(data);
             }
-            yield __await(new Promise((resolve62) => setTimeout(resolve62, 16)));
+            yield __await(new Promise((resolve64) => setTimeout(resolve64, 16)));
           }
         });
       }
@@ -21596,11 +21596,11 @@ var require_queue = __commonJS({
     "use strict";
     var __awaiter = exports && exports.__awaiter || function(thisArg, _arguments, P, generator) {
       function adopt(value) {
-        return value instanceof P ? value : new P(function(resolve62) {
-          resolve62(value);
+        return value instanceof P ? value : new P(function(resolve64) {
+          resolve64(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve62, reject) {
+      return new (P || (P = Promise))(function(resolve64, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -21616,7 +21616,7 @@ var require_queue = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve62(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve64(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -21751,7 +21751,7 @@ var require_queue = __commonJS({
               }
               return doneStatus;
             }
-            return new Promise((resolve62, reject) => {
+            return new Promise((resolve64, reject) => {
               var _a;
               let pollingTimeoutId;
               const pollInterval = "pollInterval" in options && typeof options.pollInterval === "number" ? (_a = options.pollInterval) !== null && _a !== void 0 ? _a : DEFAULT_POLL_INTERVAL : DEFAULT_POLL_INTERVAL;
@@ -21783,7 +21783,7 @@ var require_queue = __commonJS({
                   }
                   if (requestStatus.status === "COMPLETED") {
                     clearScheduledTasks();
-                    resolve62(requestStatus);
+                    resolve64(requestStatus);
                     return;
                   }
                   pollingTimeoutId = setTimeout(poll, pollInterval);
@@ -23744,11 +23744,11 @@ var require_realtime = __commonJS({
     "use strict";
     var __awaiter = exports && exports.__awaiter || function(thisArg, _arguments, P, generator) {
       function adopt(value) {
-        return value instanceof P ? value : new P(function(resolve62) {
-          resolve62(value);
+        return value instanceof P ? value : new P(function(resolve64) {
+          resolve64(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve62, reject) {
+      return new (P || (P = Promise))(function(resolve64, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -23764,7 +23764,7 @@ var require_realtime = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve62(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve64(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -24089,11 +24089,11 @@ var require_client = __commonJS({
     "use strict";
     var __awaiter = exports && exports.__awaiter || function(thisArg, _arguments, P, generator) {
       function adopt(value) {
-        return value instanceof P ? value : new P(function(resolve62) {
-          resolve62(value);
+        return value instanceof P ? value : new P(function(resolve64) {
+          resolve64(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve62, reject) {
+      return new (P || (P = Promise))(function(resolve64, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -24109,7 +24109,7 @@ var require_client = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve62(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve64(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -24417,13 +24417,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)"
       ]
     });
   }
@@ -24687,7 +24692,7 @@ var init_ReplicateProvider = __esm({
        * Sleep helper
        */
       sleep(ms) {
-        return new Promise((resolve62) => setTimeout(resolve62, ms));
+        return new Promise((resolve64) => setTimeout(resolve64, ms));
       }
       /**
        * Generate music from text prompt using MusicGen
@@ -25680,7 +25685,7 @@ async function prompt(question, hidden = false) {
     input: process.stdin,
     output: process.stdout
   });
-  return new Promise((resolve62) => {
+  return new Promise((resolve64) => {
     if (hidden && process.stdin.isTTY) {
       process.stdout.write(question);
       let input = "";
@@ -25694,7 +25699,7 @@ async function prompt(question, hidden = false) {
           process.stdin.removeListener("data", onData);
           process.stdout.write("\n");
           rl.close();
-          resolve62(input);
+          resolve64(input);
         } else if (char === "") {
           process.exit(1);
         } else if (char === "\x7F" || char === "\b") {
@@ -25709,7 +25714,7 @@ async function prompt(question, hidden = false) {
     } else {
       rl.question(question, (answer) => {
         rl.close();
-        resolve62(answer);
+        resolve64(answer);
       });
     }
   });
@@ -26040,6 +26045,54 @@ _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
 
@@ -26069,7 +26122,7 @@ semantics, VibeFrame pipeline conventions) that are NOT in generic web docs.
 | **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:
+Optional: install the upstream Hyperframes skills once per machine when your agent supports skill commands:
 
 \`\`\`bash
 npx skills add heygen-com/hyperframes
@@ -26082,6 +26135,7 @@ 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)
@@ -26094,6 +26148,7 @@ the framework-level minimum, not the cinematic craft layer.
 
 \`\`\`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
 
@@ -26138,6 +26193,41 @@ tmp/
 *.log
 `;
 }
+function isSceneScaffoldProfile(value) {
+  return value === "minimal" || value === "agent" || value === "full";
+}
+function describeSceneScaffold(opts) {
+  const dir = resolve5(opts.dir);
+  const profile = opts.profile ?? "full";
+  const groups = {
+    authoring: [
+      resolve5(dir, "STORYBOARD.md"),
+      resolve5(dir, "DESIGN.md"),
+      resolve5(dir, "vibe.project.yaml"),
+      resolve5(dir, ".gitignore")
+    ],
+    render: [],
+    agent: []
+  };
+  if (profile === "full") {
+    groups.render = [
+      resolve5(dir, "index.html"),
+      resolve5(dir, "compositions"),
+      resolve5(dir, "assets"),
+      resolve5(dir, "renders"),
+      resolve5(dir, "hyperframes.json"),
+      resolve5(dir, "meta.json")
+    ];
+  }
+  if (profile === "agent" || profile === "full") {
+    groups.agent = [
+      resolve5(dir, "SKILL.md"),
+      resolve5(dir, "references"),
+      resolve5(dir, "CLAUDE.md")
+    ];
+  }
+  return groups;
+}
 async function pathExists(p) {
   try {
     await access3(p);
@@ -26152,37 +26242,43 @@ async function scaffoldSceneProject(opts) {
   const aspect = opts.aspect ?? "16:9";
   const duration = opts.duration ?? 10;
   const now = opts.now ?? /* @__PURE__ */ new Date();
+  const profile = opts.profile ?? "full";
   await mkdir2(dir, { recursive: true });
-  await mkdir2(resolve5(dir, "compositions"), { recursive: true });
-  await mkdir2(resolve5(dir, "assets"), { recursive: true });
+  if (profile === "full") {
+    await mkdir2(resolve5(dir, "compositions"), { recursive: true });
+    await mkdir2(resolve5(dir, "assets"), { recursive: true });
+    await mkdir2(resolve5(dir, "renders"), { recursive: true });
+  }
   const created = [];
   const skipped2 = [];
   const merged = [];
-  const hfPath = resolve5(dir, "hyperframes.json");
-  const hfDefaults = buildHyperframesConfig();
-  if (await pathExists(hfPath)) {
-    const existingRaw = await readFile4(hfPath, "utf-8");
-    const existing = JSON.parse(existingRaw);
-    const mergedConfig = mergeHyperframesConfig(existing, hfDefaults);
-    await writeFile4(hfPath, JSON.stringify(mergedConfig, null, 2) + "\n", "utf-8");
-    merged.push(hfPath);
-  } else {
-    await writeFile4(hfPath, JSON.stringify(hfDefaults, null, 2) + "\n", "utf-8");
-    created.push(hfPath);
-  }
-  const metaPath = resolve5(dir, "meta.json");
-  if (await pathExists(metaPath)) {
-    skipped2.push(metaPath);
-  } else {
-    await writeFile4(metaPath, JSON.stringify(buildHyperframesMeta(name, now), null, 2) + "\n", "utf-8");
-    created.push(metaPath);
-  }
-  const rootPath = resolve5(dir, "index.html");
-  if (await pathExists(rootPath)) {
-    skipped2.push(rootPath);
-  } else {
-    await writeFile4(rootPath, buildEmptyRootHtml({ aspect, duration }), "utf-8");
-    created.push(rootPath);
+  if (profile === "full") {
+    const hfPath = resolve5(dir, "hyperframes.json");
+    const hfDefaults = buildHyperframesConfig();
+    if (await pathExists(hfPath)) {
+      const existingRaw = await readFile4(hfPath, "utf-8");
+      const existing = JSON.parse(existingRaw);
+      const mergedConfig = mergeHyperframesConfig(existing, hfDefaults);
+      await writeFile4(hfPath, JSON.stringify(mergedConfig, null, 2) + "\n", "utf-8");
+      merged.push(hfPath);
+    } else {
+      await writeFile4(hfPath, JSON.stringify(hfDefaults, null, 2) + "\n", "utf-8");
+      created.push(hfPath);
+    }
+    const metaPath = resolve5(dir, "meta.json");
+    if (await pathExists(metaPath)) {
+      skipped2.push(metaPath);
+    } else {
+      await writeFile4(metaPath, JSON.stringify(buildHyperframesMeta(name, now), null, 2) + "\n", "utf-8");
+      created.push(metaPath);
+    }
+    const rootPath = resolve5(dir, "index.html");
+    if (await pathExists(rootPath)) {
+      skipped2.push(rootPath);
+    } else {
+      await writeFile4(rootPath, buildEmptyRootHtml({ aspect, duration }), "utf-8");
+      created.push(rootPath);
+    }
   }
   const vibePath = resolve5(dir, "vibe.project.yaml");
   if (await pathExists(vibePath)) {
@@ -26192,12 +26288,14 @@ async function scaffoldSceneProject(opts) {
     await writeFile4(vibePath, (0, import_yaml2.stringify)(cfg), "utf-8");
     created.push(vibePath);
   }
-  const claudePath = resolve5(dir, "CLAUDE.md");
-  if (await pathExists(claudePath)) {
-    skipped2.push(claudePath);
-  } else {
-    await writeFile4(claudePath, buildProjectClaudeMd(name), "utf-8");
-    created.push(claudePath);
+  if (profile === "agent" || profile === "full") {
+    const claudePath = resolve5(dir, "CLAUDE.md");
+    if (await pathExists(claudePath)) {
+      skipped2.push(claudePath);
+    } else {
+      await writeFile4(claudePath, buildProjectClaudeMd(name), "utf-8");
+      created.push(claudePath);
+    }
   }
   const designPath = resolve5(dir, "DESIGN.md");
   if (await pathExists(designPath)) {
@@ -26210,6 +26308,13 @@ async function scaffoldSceneProject(opts) {
     );
     created.push(designPath);
   }
+  const storyboardPath = resolve5(dir, "STORYBOARD.md");
+  if (await pathExists(storyboardPath)) {
+    skipped2.push(storyboardPath);
+  } else {
+    await writeFile4(storyboardPath, buildStoryboardMd(name, duration), "utf-8");
+    created.push(storyboardPath);
+  }
   const gitignorePath = resolve5(dir, ".gitignore");
   if (await pathExists(gitignorePath)) {
     skipped2.push(gitignorePath);
@@ -26217,7 +26322,7 @@ async function scaffoldSceneProject(opts) {
     await writeFile4(gitignorePath, buildSceneGitignore(), "utf-8");
     created.push(gitignorePath);
   }
-  return { created, skipped: skipped2, merged };
+  return { created, skipped: skipped2, merged, groups: describeSceneScaffold({ dir, profile }) };
 }
 var import_yaml2, ASPECT_DIMS;
 var init_scene_project = __esm({
@@ -27157,7 +27262,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]`,
@@ -27419,6 +27526,57 @@ var init_scene_render = __esm({
   }
 });
 
+// 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: copyFile4 } = await import("node:fs/promises");
+    await copyFile4(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({
+  "src/utils/audio.ts"() {
+    "use strict";
+    init_exec_safe();
+  }
+});
+
 // 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({
@@ -29020,7 +29178,7 @@ async function getComposePrompts(opts) {
     return baseError(`DESIGN.md not found at ${designPath}. Run \`vibe scene init <dir>\` first.`);
   }
   if (!existsSync6(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 (!existsSync6(skillPath)) {
     warnings.push(
@@ -29256,7 +29414,10 @@ async function executeSceneBuild(opts) {
   const mode = resolveSceneBuildMode(opts);
   const storyboardPath = join7(projectDir, "STORYBOARD.md");
   if (!existsSync8(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 readFile10(storyboardPath, "utf-8");
   const parsed = parseStoryboard(storyboardMd);
@@ -29336,6 +29497,13 @@ async function executeSceneBuild(opts) {
     }
     composeData = composeResult.data;
   }
+  if (!existsSync8(join7(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;
@@ -29434,6 +29602,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";
@@ -29462,6 +29631,18 @@ async function dispatchBackdrop(beat, ctx) {
   });
   return { status: "generated", path: rel };
 }
+function loadSceneBuildEnv(projectDir) {
+  (0, import_dotenv2.config)({ path: join7(projectDir, ".env"), quiet: true });
+  (0, import_dotenv2.config)({ path: resolve12(process.cwd(), ".env"), quiet: true });
+  let dir = process.cwd();
+  while (dir !== dirname4(dir)) {
+    if (existsSync8(join7(dir, "pnpm-workspace.yaml"))) {
+      (0, import_dotenv2.config)({ path: join7(dir, ".env"), quiet: true });
+      return;
+    }
+    dir = dirname4(dir);
+  }
+}
 async function skipped(kind, beatId, reason, ctx) {
   ctx.onProgress({ type: `${kind}-skipped`, beatId, reason });
   return { status: "skipped" };
@@ -29492,20 +29673,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;
@@ -29523,77 +29708,40 @@ ${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 writeFile7(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(join7(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({
   "src/commands/_shared/scene-build.ts"() {
     "use strict";
+    import_dotenv2 = __toESM(require_main(), 1);
     init_dist2();
+    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();
   }
 });
 
-// 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: copyFile4 } = await import("node:fs/promises");
-    await copyFile4(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({
-  "src/utils/audio.ts"() {
-    "use strict";
-    init_exec_safe();
-  }
-});
-
 // src/commands/_shared/install-skill.ts
 import { mkdir as mkdir6, writeFile as writeFile8 } from "node:fs/promises";
 import { existsSync as existsSync9 } from "node:fs";
@@ -29730,6 +29878,30 @@ function validateVisualStyle(value) {
   }
   return found;
 }
+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";
+}
+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."));
+}
 async function pathExists2(p) {
   try {
     await access4(p);
@@ -30041,7 +30213,7 @@ function formatPrimitiveStatus(status, path2) {
       return status;
   }
 }
-var import_yaml5, VALID_ASPECTS2, sceneCommand, VALID_INSTALL_SKILL_HOSTS, VALID_FPS, VALID_QUALITIES, VALID_FORMATS;
+var import_yaml5, VALID_ASPECTS2, VALID_SCENE_INIT_PROFILES, sceneCommand, VALID_INSTALL_SKILL_HOSTS, VALID_FPS, VALID_QUALITIES, VALID_FORMATS;
 var init_scene = __esm({
   "src/commands/scene.ts"() {
     "use strict";
@@ -30064,7 +30236,8 @@ var init_scene = __esm({
     init_install_skill();
     init_compose_prompts();
     VALID_ASPECTS2 = ["16:9", "9:16", "1:1", "4:5"];
-    sceneCommand = new Command("scene").description("Author and render per-scene HTML compositions (Hyperframes backend)").addHelpText("after", `
+    VALID_SCENE_INIT_PROFILES = ["minimal", "agent", "full"];
+    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
@@ -30072,22 +30245,32 @@ 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 ?? basename4(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,
@@ -30098,23 +30281,25 @@ Run 'vibe schema scene.<command>' for structured parameter info.`);
               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 = resolve14(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,
@@ -30124,16 +30309,27 @@ Run 'vibe schema scene.<command>' for structured parameter info.`);
               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)));
@@ -30144,7 +30340,7 @@ Run 'vibe schema scene.<command>' for structured parameter info.`);
         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)"));
@@ -30158,10 +30354,14 @@ Run 'vibe schema scene.<command>' for structured parameter info.`);
         } 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);
@@ -30449,7 +30649,7 @@ Run 'vibe schema scene.<command>' for structured parameter info.`);
         exitWithError(generalError(msg));
       }
     });
-    sceneCommand.command("lint").description("Validate scene HTML against Hyperframes rules (in-process, no Chrome required)").argument("[root]", "Root composition file relative to --project", "index.html").option("--project <dir>", "Project directory", ".").option("--fix", 'Apply mechanical auto-fixes (currently: missing class="clip")').action(async (root, options) => {
+    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 (root, options) => {
       const startedAt = Date.now();
       const projectDir = resolve14(options.project);
       if (!await rootExists(projectDir, root)) {
@@ -30705,7 +30905,7 @@ Run 'vibe schema scene.<command>' for structured parameter info.`);
           }
         }
         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;
       }
@@ -32463,16 +32663,16 @@ async function prompt2(question) {
     input,
     output: process.stdout
   });
-  return new Promise((resolve62) => {
+  return new Promise((resolve64) => {
     rl.question(question, (answer) => {
       rl.close();
-      resolve62(answer);
+      resolve64(answer);
     });
   });
 }
 async function promptHidden(question) {
   const input = getTTYInputStream();
-  return new Promise((resolve62) => {
+  return new Promise((resolve64) => {
     process.stdout.write(question);
     let value = "";
     if (typeof input.setRawMode === "function") {
@@ -32484,7 +32684,7 @@ async function promptHidden(question) {
           input.setRawMode(false);
           input.removeListener("data", onData);
           process.stdout.write("\n");
-          resolve62(value);
+          resolve64(value);
         } else if (char === "") {
           input.setRawMode(false);
           process.stdout.write("\n");
@@ -32504,7 +32704,7 @@ async function promptHidden(question) {
       const rl = createInterface2({ input, output: process.stdout });
       rl.question("", (answer) => {
         rl.close();
-        resolve62(answer);
+        resolve64(answer);
       });
     }
   });
@@ -32512,7 +32712,7 @@ async function promptHidden(question) {
 async function promptSelect(_question, options, defaultIndex = 0) {
   const input = getTTYInputStream();
   if (typeof input.setRawMode === "function") {
-    return new Promise((resolve62) => {
+    return new Promise((resolve64) => {
       let selected = defaultIndex;
       const render = () => {
         if (renderCount > 0) {
@@ -32536,7 +32736,7 @@ async function promptSelect(_question, options, defaultIndex = 0) {
           input.setRawMode(false);
           input.removeListener("data", onData);
           process.stdout.write("\n");
-          resolve62(selected);
+          resolve64(selected);
         } else if (char === "") {
           input.setRawMode(false);
           process.stdout.write("\n");
@@ -32553,7 +32753,7 @@ async function promptSelect(_question, options, defaultIndex = 0) {
           input.removeListener("data", onData);
           render();
           process.stdout.write("\n");
-          resolve62(selected);
+          resolve64(selected);
         }
       };
       input.on("data", onData);
@@ -35343,7 +35543,7 @@ var init_dist3 = __esm({
 import { writeFile as writeFile23, unlink as unlink2, rename as rename2 } from "node:fs/promises";
 import { resolve as resolve27, basename as basename7 } from "node:path";
 function sleep(ms) {
-  return new Promise((resolve62) => setTimeout(resolve62, ms));
+  return new Promise((resolve64) => setTimeout(resolve64, ms));
 }
 async function uploadToImgbb(imageBuffer, apiKey) {
   try {
@@ -36076,9 +36276,14 @@ var init_ai_script_pipeline = __esm({
 import { resolve as resolve29 } from "node:path";
 import { readFile as readFile17, writeFile as writeFile25 } 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
@@ -36104,12 +36309,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;
@@ -36119,7 +36325,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."
             )
           );
         }
@@ -36182,14 +36388,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
             }
           }
         });
@@ -36200,6 +36407,7 @@ Examples:
         kling: "KLING_API_KEY",
         veo: "GOOGLE_API_KEY",
         grok: "XAI_API_KEY",
+        seedance: "FAL_KEY",
         fal: "FAL_KEY"
       };
       const providerNameMap = {
@@ -36207,7 +36415,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];
@@ -36426,15 +36635,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];
@@ -36446,8 +36655,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,
@@ -36572,7 +36782,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
@@ -36582,7 +36793,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
@@ -51922,7 +52134,7 @@ function buildFFmpegArgs(clips, sources, presetSettings, outputPath, options, so
   return args;
 }
 function runFFmpegProcess(ffmpegPath, args, onProgress) {
-  return new Promise((resolve62, reject) => {
+  return new Promise((resolve64, reject) => {
     const ffmpeg = spawn(ffmpegPath, args, {
       stdio: ["pipe", "pipe", "pipe"]
     });
@@ -51946,7 +52158,7 @@ function runFFmpegProcess(ffmpegPath, args, onProgress) {
     });
     ffmpeg.on("close", (code) => {
       if (code === 0) {
-        resolve62();
+        resolve64();
       } else {
         const errorMatch = stderr.match(/Error.*$/m);
         const errorMsg = errorMatch ? errorMatch[0] : `FFmpeg exited with code ${code}`;
@@ -52083,16 +52295,16 @@ function getPresetSettings(preset, aspectRatio) {
 async function runHyperframesExport(projectPath, options, spinner2, startedAt) {
   spinner2.text = "Loading project...";
   const { readFile: readFile42 } = await import("node:fs/promises");
-  const { resolve: resolve62, basename: basename22 } = await import("node:path");
+  const { resolve: resolve64, basename: basename22 } = await import("node:path");
   const { Project: Project2 } = await Promise.resolve().then(() => (init_engine(), engine_exports));
   const { createHyperframesBackend: createHyperframesBackend2 } = await Promise.resolve().then(() => (init_hyperframes(), hyperframes_exports));
   const { exitWithError: exitWithError2, generalError: generalError2, outputSuccess: outputSuccess2 } = await Promise.resolve().then(() => (init_output(), output_exports));
   const chalk2 = (await Promise.resolve().then(() => (init_source(), source_exports))).default;
-  const filePath = resolve62(process.cwd(), projectPath);
+  const filePath = resolve64(process.cwd(), projectPath);
   const content = await readFile42(filePath, "utf-8");
   const project = Project2.fromJSON(JSON.parse(content));
   const state = project.getState();
-  const outputPath = options.output ? resolve62(process.cwd(), options.output) : resolve62(process.cwd(), `${basename22(projectPath, ".vibe.json")}.${options.format ?? "mp4"}`);
+  const outputPath = options.output ? resolve64(process.cwd(), options.output) : resolve64(process.cwd(), `${basename22(projectPath, ".vibe.json")}.${options.format ?? "mp4"}`);
   const quality = ["draft", "standard", "high"].includes(options.preset ?? "") ? options.preset : "standard";
   const backend = createHyperframesBackend2();
   spinner2.text = "Rendering with Hyperframes...";
@@ -52263,6 +52475,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);
@@ -52811,7 +53042,7 @@ __export(ai_video_exports, {
   executeVideoStatus: () => executeVideoStatus
 });
 import { readFile as readFile36, writeFile as writeFile40 } from "node:fs/promises";
-import { resolve as resolve52 } from "node:path";
+import { resolve as resolve54 } from "node:path";
 async function executeVideoGenerate(options) {
   const {
     prompt: prompt3,
@@ -52824,24 +53055,61 @@ async function executeVideoGenerate(options) {
     negative,
     resolution,
     veoModel = "3.1-fast",
+    seedanceModel = "quality",
     output,
     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 key = apiKey || process.env[envKeyMap[provider] || ""];
     if (!key) return { success: false, error: `${envKeyMap[provider]} required for ${provider}` };
     let referenceImage;
     if (image) {
-      const imagePath = resolve52(process.cwd(), image);
+      const imagePath = resolve54(process.cwd(), image);
       const imageBuffer = await readFile36(imagePath);
       const ext = image.toLowerCase().split(".").pop();
       const mimeTypes2 = { jpg: "image/jpeg", jpeg: "image/jpeg", png: "image/png", gif: "image/gif", webp: "image/webp" };
       const mimeType = mimeTypes2[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: key });
+      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 (output && result.videoUrl) {
+        const buffer = await downloadVideo(result.videoUrl, key);
+        outputPath = resolve54(process.cwd(), output);
+        await writeFile40(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: key });
       const result = await runway.generateVideo(prompt3, {
@@ -52859,7 +53127,7 @@ async function executeVideoGenerate(options) {
       let outputPath;
       if (output && finalResult.videoUrl) {
         const buffer = await downloadVideo(finalResult.videoUrl, key);
-        outputPath = resolve52(process.cwd(), output);
+        outputPath = resolve54(process.cwd(), output);
         await writeFile40(outputPath, buffer);
       }
       return { success: true, taskId: result.id, status: "completed", videoUrl: finalResult.videoUrl, duration: finalResult.duration, outputPath, provider: "runway" };
@@ -52893,7 +53161,7 @@ async function executeVideoGenerate(options) {
       let outputPath;
       if (output && finalResult.videoUrl) {
         const buffer = await downloadVideo(finalResult.videoUrl, key);
-        outputPath = resolve52(process.cwd(), output);
+        outputPath = resolve54(process.cwd(), output);
         await writeFile40(outputPath, buffer);
       }
       return { success: true, taskId: result.id, status: "completed", videoUrl: finalResult.videoUrl, duration: finalResult.duration, outputPath, provider: "kling" };
@@ -52920,7 +53188,7 @@ async function executeVideoGenerate(options) {
       let outputPath;
       if (output && finalResult.videoUrl) {
         const buffer = await downloadVideo(finalResult.videoUrl, key);
-        outputPath = resolve52(process.cwd(), output);
+        outputPath = resolve54(process.cwd(), output);
         await writeFile40(outputPath, buffer);
       }
       return { success: true, taskId: result.id, status: "completed", videoUrl: finalResult.videoUrl, outputPath, provider: "veo" };
@@ -52941,7 +53209,7 @@ async function executeVideoGenerate(options) {
       let outputPath;
       if (output && finalResult.videoUrl) {
         const buffer = await downloadVideo(finalResult.videoUrl, key);
-        outputPath = resolve52(process.cwd(), output);
+        outputPath = resolve54(process.cwd(), output);
         await writeFile40(outputPath, buffer);
       }
       return { success: true, taskId: result.id, status: "completed", videoUrl: finalResult.videoUrl, duration: finalResult.duration, outputPath, provider: "grok" };
@@ -52968,7 +53236,7 @@ async function executeVideoStatus(options) {
       let outputPath;
       if (output && result.videoUrl) {
         const buffer = await downloadVideo(result.videoUrl, key);
-        outputPath = resolve52(process.cwd(), output);
+        outputPath = resolve54(process.cwd(), output);
         await writeFile40(outputPath, buffer);
       }
       return { success: true, taskId, status: result.status, progress: result.progress, videoUrl: result.videoUrl, outputPath };
@@ -52983,7 +53251,7 @@ async function executeVideoStatus(options) {
       let outputPath;
       if (output && result.videoUrl) {
         const buffer = await downloadVideo(result.videoUrl, key);
-        outputPath = resolve52(process.cwd(), output);
+        outputPath = resolve54(process.cwd(), output);
         await writeFile40(outputPath, buffer);
       }
       return { success: true, taskId, status: result.status, videoUrl: result.videoUrl, duration: result.duration, outputPath };
@@ -53028,7 +53296,7 @@ async function executeVideoExtend(options) {
       let outputPath;
       if (output && finalResult.videoUrl) {
         const buffer = await downloadVideo(finalResult.videoUrl, key);
-        outputPath = resolve52(process.cwd(), output);
+        outputPath = resolve54(process.cwd(), output);
         await writeFile40(outputPath, buffer);
       }
       return { success: true, taskId: result.id, status: "completed", videoUrl: finalResult.videoUrl, duration: finalResult.duration, outputPath };
@@ -53051,7 +53319,7 @@ async function executeVideoExtend(options) {
       let outputPath;
       if (output && finalResult.videoUrl) {
         const buffer = await downloadVideo(finalResult.videoUrl, key);
-        outputPath = resolve52(process.cwd(), output);
+        outputPath = resolve54(process.cwd(), output);
         await writeFile40(outputPath, buffer);
       }
       return { success: true, taskId: result.id, status: "completed", videoUrl: finalResult.videoUrl, outputPath };
@@ -53079,7 +53347,7 @@ __export(ai_audio_exports, {
   executeTranscribe: () => executeTranscribe,
   executeVoiceClone: () => executeVoiceClone
 });
-import { resolve as resolve53, dirname as dirname20, basename as basename20, extname as extname12 } from "node:path";
+import { resolve as resolve55, dirname as dirname20, basename as basename20, extname as extname12 } from "node:path";
 import { readFile as readFile37, writeFile as writeFile41 } from "node:fs/promises";
 import { existsSync as existsSync37 } from "node:fs";
 async function executeTranscribe(options) {
@@ -53087,7 +53355,7 @@ async function executeTranscribe(options) {
   try {
     const key = apiKey || process.env.OPENAI_API_KEY;
     if (!key) return { success: false, error: "OPENAI_API_KEY required" };
-    const absPath = resolve53(process.cwd(), audioPath);
+    const absPath = resolve55(process.cwd(), audioPath);
     if (!existsSync37(absPath)) return { success: false, error: `File not found: ${absPath}` };
     const whisper = new WhisperProvider();
     await whisper.initialize({ apiKey: key });
@@ -53099,7 +53367,7 @@ async function executeTranscribe(options) {
     }
     let outputPath;
     if (output) {
-      outputPath = resolve53(process.cwd(), output);
+      outputPath = resolve55(process.cwd(), output);
       const fmt = detectFormat(output, format);
       const content = formatTranscript(result, fmt);
       await writeFile41(outputPath, content, "utf-8");
@@ -53120,7 +53388,7 @@ async function executeIsolate(options) {
   try {
     const key = apiKey || process.env.ELEVENLABS_API_KEY;
     if (!key) return { success: false, error: "ELEVENLABS_API_KEY required" };
-    const absPath = resolve53(process.cwd(), audioPath);
+    const absPath = resolve55(process.cwd(), audioPath);
     if (!existsSync37(absPath)) return { success: false, error: `File not found: ${absPath}` };
     const audioBuffer = await readFile37(absPath);
     const elevenlabs = new ElevenLabsProvider();
@@ -53129,7 +53397,7 @@ async function executeIsolate(options) {
     if (!result.success || !result.audioBuffer) {
       return { success: false, error: result.error || "Audio isolation failed" };
     }
-    const outputPath = resolve53(process.cwd(), output);
+    const outputPath = resolve55(process.cwd(), output);
     await writeFile41(outputPath, result.audioBuffer);
     return { success: true, outputPath };
   } catch (error) {
@@ -53146,7 +53414,7 @@ async function executeVoiceClone(options) {
     }
     const audioBuffers = [];
     for (const samplePath of samplePaths) {
-      const absPath = resolve53(process.cwd(), samplePath);
+      const absPath = resolve55(process.cwd(), samplePath);
       if (!existsSync37(absPath)) return { success: false, error: `File not found: ${samplePath}` };
       const buffer = await readFile37(absPath);
       audioBuffers.push(buffer);
@@ -53168,7 +53436,7 @@ async function executeVoiceClone(options) {
 async function executeDub(options) {
   const { mediaPath, language, source, voice, analyzeOnly, output } = options;
   try {
-    const absPath = resolve53(process.cwd(), mediaPath);
+    const absPath = resolve55(process.cwd(), mediaPath);
     if (!existsSync37(absPath)) return { success: false, error: `File not found: ${absPath}` };
     const openaiKey = process.env.OPENAI_API_KEY;
     const anthropicKey = process.env.ANTHROPIC_API_KEY;
@@ -53180,7 +53448,7 @@ async function executeDub(options) {
     const isVideo = [".mp4", ".mov", ".avi", ".mkv", ".webm"].includes(ext);
     let audioPath = absPath;
     if (isVideo) {
-      const tempAudioPath = resolve53(dirname20(absPath), `temp-audio-${Date.now()}.mp3`);
+      const tempAudioPath = resolve55(dirname20(absPath), `temp-audio-${Date.now()}.mp3`);
       execSafeSync("ffmpeg", ["-i", absPath, "-vn", "-acodec", "mp3", "-y", tempAudioPath]);
       audioPath = tempAudioPath;
     }
@@ -53229,7 +53497,7 @@ ${segmentTexts}`,
     }
     if (analyzeOnly) {
       if (output) {
-        const timingPath = resolve53(process.cwd(), output);
+        const timingPath = resolve55(process.cwd(), output);
         const timingData = {
           sourcePath: absPath,
           sourceLanguage: transcriptResult.detectedLanguage || source || "auto",
@@ -53248,7 +53516,7 @@ ${segmentTexts}`,
         sourceLanguage: transcriptResult.detectedLanguage || source || "auto",
         targetLanguage: language,
         segmentCount: segments.length,
-        outputPath: output ? resolve53(process.cwd(), output) : void 0
+        outputPath: output ? resolve55(process.cwd(), output) : void 0
       };
     }
     const elevenlabs = new ElevenLabsProvider();
@@ -53262,8 +53530,8 @@ ${segmentTexts}`,
     }
     const combinedBuffer = Buffer.concat(dubbedBuffers);
     const outputExt = isVideo ? ".mp3" : extname12(absPath);
-    const defaultOutputPath2 = resolve53(dirname20(absPath), `${basename20(absPath, extname12(absPath))}-${language}${outputExt}`);
-    const finalOutputPath = resolve53(process.cwd(), output || defaultOutputPath2);
+    const defaultOutputPath2 = resolve55(dirname20(absPath), `${basename20(absPath, extname12(absPath))}-${language}${outputExt}`);
+    const finalOutputPath = resolve55(process.cwd(), output || defaultOutputPath2);
     await writeFile41(finalOutputPath, combinedBuffer);
     if (isVideo && audioPath !== absPath) {
       try {
@@ -53295,12 +53563,12 @@ async function executeDuck(options) {
   } = options;
   try {
     if (!commandExists("ffmpeg")) return { success: false, error: "FFmpeg not found" };
-    const absMusicPath = resolve53(process.cwd(), musicPath);
-    const absVoicePath = resolve53(process.cwd(), voicePath);
+    const absMusicPath = resolve55(process.cwd(), musicPath);
+    const absVoicePath = resolve55(process.cwd(), voicePath);
     if (!existsSync37(absMusicPath)) return { success: false, error: `Music file not found: ${absMusicPath}` };
     if (!existsSync37(absVoicePath)) return { success: false, error: `Voice file not found: ${absVoicePath}` };
-    const defaultOutput = resolve53(dirname20(absMusicPath), `${basename20(absMusicPath, extname12(absMusicPath))}-ducked${extname12(absMusicPath)}`);
-    const outputPath = resolve53(process.cwd(), output || defaultOutput);
+    const defaultOutput = resolve55(dirname20(absMusicPath), `${basename20(absMusicPath, extname12(absMusicPath))}-ducked${extname12(absMusicPath)}`);
+    const outputPath = resolve55(process.cwd(), output || defaultOutput);
     const filter = `[1:a]asplit=2[sc][mix];[0:a][sc]sidechaincompress=threshold=${threshold}dB:ratio=${ratio}:attack=${attack}:release=${release}[ducked];[ducked][mix]amix=inputs=2:duration=longest`;
     await execSafe("ffmpeg", [
       "-i",
@@ -53328,11 +53596,11 @@ var init_ai_audio = __esm({
 });
 
 // src/pipeline/executor.ts
-import { resolve as resolve54 } from "node:path";
+import { resolve as resolve56 } from "node:path";
 import { readFile as readFile38, writeFile as writeFile42, mkdir as mkdir22 } from "node:fs/promises";
 import { existsSync as existsSync38 } from "node:fs";
 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;
 }
@@ -53341,9 +53609,9 @@ function registerAction(action, handler) {
 }
 function getOutput(params, outputDir, defaultName) {
   if (params.output && typeof params.output === "string") {
-    return resolve54(outputDir, params.output);
+    return resolve56(outputDir, params.output);
   }
-  return resolve54(outputDir, defaultName);
+  return resolve56(outputDir, defaultName);
 }
 async function ensureActionsRegistered() {
   if (Object.keys(ACTION_HANDLERS).length > 0) return;
@@ -53356,7 +53624,15 @@ async function ensureActionsRegistered() {
   registerAction("generate-video", async (params, outputDir) => {
     const { executeVideoGenerate: executeVideoGenerate2 } = await Promise.resolve().then(() => (init_ai_video(), ai_video_exports));
     const output = 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, wait: true });
+    const r = await executeVideoGenerate2({
+      prompt: params.prompt,
+      provider: params.provider,
+      image: params.image,
+      duration: params.duration,
+      ratio: params.ratio,
+      output,
+      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) => {
@@ -53488,7 +53764,7 @@ async function ensureActionsRegistered() {
     const { executeSceneBuild: executeSceneBuild2 } = await Promise.resolve().then(() => (init_scene_build(), scene_build_exports));
     const projectRel = params.project ?? ".";
     const r = await executeSceneBuild2({
-      projectDir: resolve54(outputDir, projectRel),
+      projectDir: resolve56(outputDir, projectRel),
       mode: params.mode,
       effort: params.effort,
       composer: params.composer,
@@ -53514,7 +53790,7 @@ async function ensureActionsRegistered() {
     const { executeSceneRender: executeSceneRender2 } = await Promise.resolve().then(() => (init_scene_render(), scene_render_exports));
     const projectRel = params.project ?? ".";
     const r = await executeSceneRender2({
-      projectDir: resolve54(outputDir, projectRel),
+      projectDir: resolve56(outputDir, projectRel),
       root: params.root,
       output: params.output,
       fps: params.fps,
@@ -53538,7 +53814,7 @@ async function ensureActionsRegistered() {
   });
 }
 async function loadPipeline(filePath) {
-  const absPath = resolve54(process.cwd(), filePath);
+  const absPath = resolve56(process.cwd(), filePath);
   if (!existsSync38(absPath)) {
     throw new Error(`Pipeline file not found: ${absPath}`);
   }
@@ -53557,13 +53833,13 @@ async function loadPipeline(filePath) {
 }
 async function executePipeline(manifest2, options = {}) {
   await ensureActionsRegistered();
-  const outputDir = resolve54(process.cwd(), options.outputDir || `${manifest2.name}-output`);
+  const outputDir = resolve56(process.cwd(), options.outputDir || `${manifest2.name}-output`);
   await mkdir22(outputDir, { recursive: true });
   const completedSteps = /* @__PURE__ */ new Map();
   const results = [];
   const startTime = Date.now();
   if (options.resume) {
-    const checkpointPath = resolve54(outputDir, CHECKPOINT_FILE);
+    const checkpointPath = resolve56(outputDir, CHECKPOINT_FILE);
     if (existsSync38(checkpointPath)) {
       const checkpointContent = await readFile38(checkpointPath, "utf-8");
       const checkpoint = (0, import_yaml8.parse)(checkpointContent);
@@ -53684,7 +53960,7 @@ async function executePipeline(manifest2, options = {}) {
         }))
       };
       await writeFile42(
-        resolve54(outputDir, CHECKPOINT_FILE),
+        resolve56(outputDir, CHECKPOINT_FILE),
         (0, import_yaml8.stringify)(checkpoint, { indent: 2 }),
         "utf-8"
       );
@@ -53731,42 +54007,48 @@ async function executePipeline(manifest2, options = {}) {
     budget: effectiveBudget ? budgetUsage : void 0
   };
 }
-var import_yaml8, ACTION_TO_COMMAND, ACTION_HANDLERS, CHECKPOINT_FILE;
+var import_yaml8, ACTION_METADATA, ACTION_HANDLERS, CHECKPOINT_FILE;
 var init_executor = __esm({
   "src/pipeline/executor.ts"() {
     "use strict";
     import_yaml8 = __toESM(require_dist(), 1);
     init_resolver();
     init_output();
-    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"
+    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"] }
     };
     ACTION_HANDLERS = {};
     CHECKPOINT_FILE = ".pipeline-state.yaml";
@@ -58641,7 +58923,7 @@ var init_define_tool = __esm({
 });
 
 // src/tools/manifest/scene.ts
-import { resolve as resolve55, relative as relative7 } from "node:path";
+import { resolve as resolve57, relative as relative7 } from "node:path";
 function summariseLint(result) {
   return {
     ok: result.ok,
@@ -58757,10 +59039,10 @@ var init_scene2 = __esm({
       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 = resolve55(ctx.workingDirectory, args.dir);
+        const dir = resolve57(ctx.workingDirectory, args.dir);
         const result = await scaffoldSceneProject({
           dir,
           name: args.name,
@@ -58808,7 +59090,7 @@ var init_scene2 = __esm({
       description: "Add a single scene to an existing scene project. Optionally generates narration audio (ElevenLabs) and/or a backdrop image (Gemini/OpenAI), then emits compositions/scene-<id>.html with a paused GSAP timeline and splices a clip reference into the root index.html. Use skipAudio:true and skipImage:true for text-only scenes that need no API calls.",
       schema: sceneAddSchema,
       async execute(args, ctx) {
-        const projectDir = args.projectDir ? resolve55(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
+        const projectDir = args.projectDir ? resolve57(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
         const result = await executeSceneAdd({
           name: args.name,
           preset: args.preset ?? "simple",
@@ -58865,7 +59147,7 @@ var init_scene2 = __esm({
       description: "Validate every scene file in a project against the public Hyperframes lint rules (in-process, no Chrome required). Returns errors, warnings, and info findings per file. Optional fix:true mechanically repairs `timed_element_missing_clip_class` only \u2014 other issues surface with fixHints.",
       schema: sceneLintSchema,
       async execute(args, ctx) {
-        const projectDir = args.projectDir ? resolve55(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
+        const projectDir = args.projectDir ? resolve57(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
         const result = await runProjectLint({
           projectDir,
           rootRel: args.root,
@@ -58906,7 +59188,7 @@ var init_scene2 = __esm({
       description: "Render a scene project to MP4/WebM/MOV via the Hyperframes producer. Requires Chrome installed locally. Output defaults to renders/<projectName>-<isoStamp>.<format>.",
       schema: sceneRenderSchema,
       async execute(args, ctx) {
-        const projectDir = args.projectDir ? resolve55(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
+        const projectDir = args.projectDir ? resolve57(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
         const result = await executeSceneRender({
           projectDir,
           root: args.root,
@@ -58961,7 +59243,7 @@ var init_scene2 = __esm({
       description: "v0.60 one-shot orchestrator: read STORYBOARD.md per-beat YAML cues (narration / backdrop / duration), dispatch TTS + image generation per beat, compose scene HTML via the compose-scenes-with-skills pipeline, then render to MP4. Use this instead of chaining scene_init + scene_add + scene_render manually. Caches by SHA256 of (DESIGN.md + cue body) so re-runs are idempotent and cheap.",
       schema: sceneBuildSchema,
       async execute(args, ctx) {
-        const projectDir = args.projectDir ? resolve55(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
+        const projectDir = args.projectDir ? resolve57(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
         const result = await executeSceneBuild({
           projectDir,
           mode: args.mode,
@@ -59022,7 +59304,7 @@ var init_scene2 = __esm({
       description: "Install the vendored Hyperframes skill bundle into a scene project so the host agent (Claude Code, Cursor, Codex, Aider) can read framework rules + house style directly. Writes a universal SKILL.md + references/ at the project root, plus per-host layouts (.claude/skills/hyperframes/ for Claude Code, .cursor/rules/hyperframes.mdc for Cursor) when those hosts are detected. Phase H1 of the agentic-native composer plan \u2014 once installed, the host agent itself can author scene HTML using the rules instead of relying on vibe's internal LLM call.",
       schema: sceneInstallSkillSchema,
       async execute(args, ctx) {
-        const projectDir = resolve55(ctx.workingDirectory, args.projectDir);
+        const projectDir = resolve57(ctx.workingDirectory, args.projectDir);
         const hostFlag = args.host ?? "auto";
         const hosts = (() => {
           if (hostFlag === "all") return ["all"];
@@ -59064,7 +59346,7 @@ var init_scene2 = __esm({
       description: "Emit the per-beat compose plan for the host agent to author scene HTML itself. Reads STORYBOARD.md + DESIGN.md and returns each beat's outputPath + userPrompt + cues + body, plus references to the project's SKILL.md (Hyperframes rules) and DESIGN.md (visual identity). The host agent writes each compositions/scene-<id>.html file directly \u2014 VibeFrame makes NO LLM call here. Pairs with scene_install_skill (Phase H1). Phase H2 of the agentic-native composer plan; the internal-LLM batch path (scene_build) remains as a fallback for non-agent contexts.",
       schema: sceneComposePromptsSchema,
       async execute(args, ctx) {
-        const projectDir = resolve55(ctx.workingDirectory, args.projectDir);
+        const projectDir = resolve57(ctx.workingDirectory, args.projectDir);
         const result = await getComposePrompts({
           projectDir,
           beatId: args.beat
@@ -59654,12 +59936,12 @@ var init_edit = __esm({
 
 // src/commands/ai-suggest-edit.ts
 import { readFile as readFile39, writeFile as writeFile43 } from "node:fs/promises";
-import { resolve as resolve56 } from "node:path";
+import { resolve as resolve58 } from "node:path";
 async function executeSuggestEdit(options) {
   try {
     const apiKey = options.apiKey ?? process.env.GOOGLE_API_KEY;
     if (!apiKey) return { success: false, error: "GOOGLE_API_KEY required for suggest" };
-    const filePath = resolve56(process.cwd(), options.projectPath);
+    const filePath = resolve58(process.cwd(), options.projectPath);
     const content = await readFile39(filePath, "utf-8");
     const data = JSON.parse(content);
     const project = Project.fromJSON(data);
@@ -60438,9 +60720,9 @@ var init_detect2 = __esm({
 
 // src/tools/manifest/_project-io.ts
 import { readFile as readFile40, writeFile as writeFile45 } from "node:fs/promises";
-import { resolve as resolve57 } from "node:path";
+import { resolve as resolve59 } from "node:path";
 async function loadProject(projectPath, cwd) {
-  const absPath = resolve57(cwd, projectPath);
+  const absPath = resolve59(cwd, projectPath);
   const content = await readFile40(absPath, "utf-8");
   const data = JSON.parse(content);
   return { project: Project.fromJSON(data), absPath };
@@ -60456,7 +60738,7 @@ var init_project_io = __esm({
 });
 
 // src/tools/manifest/timeline.ts
-import { resolve as resolve58 } from "node:path";
+import { resolve as resolve60 } from "node:path";
 var MEDIA_TYPES, timelineAddSourceTool, timelineAddClipTool, timelineSplitClipTool, timelineTrimClipTool, timelineMoveClipTool, timelineDeleteClipTool, timelineDuplicateClipTool, timelineAddEffectTool, timelineAddTrackTool, timelineListTool, timelineTools;
 var init_timeline = __esm({
   "src/tools/manifest/timeline.ts"() {
@@ -60492,7 +60774,7 @@ var init_timeline = __esm({
       }),
       async execute(args, ctx) {
         const { project, absPath } = await loadProject(args.projectPath, ctx.workingDirectory);
-        const mediaPath = resolve58(ctx.workingDirectory, args.mediaPath);
+        const mediaPath = resolve60(ctx.workingDirectory, args.mediaPath);
         const ext = mediaPath.split(".").pop()?.toLowerCase() ?? "";
         const source = project.addSource({
           name: args.name ?? mediaPath.split("/").pop() ?? "media",
@@ -60718,7 +61000,7 @@ var init_timeline = __esm({
 });
 
 // src/tools/manifest/project.ts
-import { resolve as resolve59 } from "node:path";
+import { resolve as resolve61 } from "node:path";
 import { writeFile as writeFile46 } from "node:fs/promises";
 var projectCreateTool, projectInfoTool, projectTools;
 var init_project2 = __esm({
@@ -60741,7 +61023,7 @@ var init_project2 = __esm({
         fps: external_exports.number().optional().describe("Frames per second (default: 30)")
       }),
       async execute(args, ctx) {
-        const outputPath = resolve59(ctx.workingDirectory, args.outputPath ?? `${args.name}.vibe.json`);
+        const outputPath = resolve61(ctx.workingDirectory, args.outputPath ?? `${args.name}.vibe.json`);
         const project = new Project(args.name);
         if (args.fps) project.setFrameRate(args.fps);
         await writeFile46(outputPath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
@@ -60787,7 +61069,7 @@ var init_project2 = __esm({
 });
 
 // src/tools/manifest/export.ts
-import { resolve as resolve60 } from "node:path";
+import { resolve as resolve62 } from "node:path";
 var exportVideoTool, exportTools;
 var init_export2 = __esm({
   "src/tools/manifest/export.ts"() {
@@ -60808,8 +61090,8 @@ var init_export2 = __esm({
         overwrite: external_exports.boolean().optional().describe("Overwrite existing output file (default: false)")
       }),
       async execute(args, ctx) {
-        const projectPath = resolve60(ctx.workingDirectory, args.projectPath);
-        const outputPath = resolve60(ctx.workingDirectory, args.outputPath);
+        const projectPath = resolve62(ctx.workingDirectory, args.projectPath);
+        const outputPath = resolve62(ctx.workingDirectory, args.outputPath);
         const result = await runExport(projectPath, outputPath, {
           preset: args.preset,
           format: args.format,
@@ -60829,7 +61111,7 @@ var init_export2 = __esm({
 
 // src/tools/manifest/agent-only.ts
 import { readFile as readFile41, writeFile as writeFile47, readdir as readdir4, stat as stat6, access as access8, unlink as unlink4 } from "node:fs/promises";
-import { resolve as resolve61, join as join15, basename as basename21, extname as extname13 } from "node:path";
+import { resolve as resolve63, join as join15, basename as basename21, extname as extname13 } from "node:path";
 function matchPattern(filename, pattern) {
   const regex2 = new RegExp(
     "^" + pattern.replace(/\./g, "\\.").replace(/\*/g, ".*").replace(/\?/g, ".") + "$",
@@ -60885,11 +61167,11 @@ async function getMediaDuration2(filePath) {
   }
 }
 async function resolveProjectPath3(inputPath, cwd) {
-  const filePath = resolve61(cwd, inputPath);
+  const filePath = resolve63(cwd, inputPath);
   try {
     const stats = await stat6(filePath);
     if (stats.isDirectory()) {
-      return resolve61(filePath, "project.vibe.json");
+      return resolve63(filePath, "project.vibe.json");
     }
   } catch {
   }
@@ -60917,7 +61199,7 @@ var init_agent_only = __esm({
       async execute(args, ctx) {
         const dirPath = args.path ?? ".";
         try {
-          const absPath = resolve61(ctx.workingDirectory, dirPath);
+          const absPath = resolve63(ctx.workingDirectory, dirPath);
           const entries = await readdir4(absPath, { withFileTypes: true });
           const results = [];
           for (const entry of entries) {
@@ -60948,7 +61230,7 @@ var init_agent_only = __esm({
       }),
       async execute(args, ctx) {
         try {
-          const absPath = resolve61(ctx.workingDirectory, args.path);
+          const absPath = resolve63(ctx.workingDirectory, args.path);
           const content = await readFile41(absPath, "utf-8");
           const maxLength = 4e3;
           const truncated = content.length > maxLength;
@@ -60971,7 +61253,7 @@ var init_agent_only = __esm({
       }),
       async execute(args, ctx) {
         try {
-          const absPath = resolve61(ctx.workingDirectory, args.path);
+          const absPath = resolve63(ctx.workingDirectory, args.path);
           await writeFile47(absPath, args.content, "utf-8");
           return { success: true, data: { bytes: args.content.length }, humanLines: [`File written: ${args.path} (${formatSize(args.content.length)})`] };
         } catch (error) {
@@ -60989,7 +61271,7 @@ var init_agent_only = __esm({
         path: external_exports.string().describe("Path to check")
       }),
       async execute(args, ctx) {
-        const absPath = resolve61(ctx.workingDirectory, args.path);
+        const absPath = resolve63(ctx.workingDirectory, args.path);
         try {
           await access8(absPath);
           const stats = await stat6(absPath);
@@ -61015,11 +61297,11 @@ var init_agent_only = __esm({
       }),
       async execute(args, ctx) {
         try {
-          const filePath = resolve61(ctx.workingDirectory, args.project);
+          const filePath = resolve63(ctx.workingDirectory, args.project);
           const content = await readFile41(filePath, "utf-8");
           const data = JSON.parse(content);
           const project = Project.fromJSON(data);
-          const dirPath = resolve61(ctx.workingDirectory, args.directory);
+          const dirPath = resolve63(ctx.workingDirectory, args.directory);
           const filterExts = args.filter ? args.filter.split(",").map((e) => e.trim().toLowerCase()) : null;
           const imageDuration = args.imageDuration ?? 5;
           const recursive = args.recursive ?? false;
@@ -61085,7 +61367,7 @@ var init_agent_only = __esm({
       }),
       async execute(args, ctx) {
         try {
-          const filePath = resolve61(ctx.workingDirectory, args.project);
+          const filePath = resolve63(ctx.workingDirectory, args.project);
           const content = await readFile41(filePath, "utf-8");
           const data = JSON.parse(content);
           const project = Project.fromJSON(data);
@@ -61154,7 +61436,7 @@ var init_agent_only = __esm({
       }),
       async execute(args, ctx) {
         try {
-          const filePath = resolve61(ctx.workingDirectory, args.project);
+          const filePath = resolve63(ctx.workingDirectory, args.project);
           const content = await readFile41(filePath, "utf-8");
           const data = JSON.parse(content);
           const project = Project.fromJSON(data);
@@ -61432,7 +61714,7 @@ var init_agent_only = __esm({
       }),
       async execute(args, ctx) {
         try {
-          const absPath = resolve61(ctx.workingDirectory, args.path);
+          const absPath = resolve63(ctx.workingDirectory, args.path);
           const { stdout } = await execSafe(
             "ffprobe",
             ["-v", "quiet", "-print_format", "json", "-show_format", "-show_streams", absPath],
@@ -61519,10 +61801,10 @@ Audio:`);
       }),
       async execute(args, ctx) {
         try {
-          const absInput = resolve61(ctx.workingDirectory, args.input);
+          const absInput = resolve63(ctx.workingDirectory, args.input);
           const ext = args.input.split(".").pop() || "mp4";
           const baseName = args.input.replace(/\.[^/.]+$/, "");
-          const outputPath = args.output ? resolve61(ctx.workingDirectory, args.output) : resolve61(ctx.workingDirectory, `${baseName}-compressed.${ext}`);
+          const outputPath = args.output ? resolve63(ctx.workingDirectory, args.output) : resolve63(ctx.workingDirectory, `${baseName}-compressed.${ext}`);
           const crfValues = { low: 28, medium: 23, high: 18 };
           const crf = crfValues[args.quality ?? "medium"];
           await execSafe(
@@ -61580,8 +61862,8 @@ Audio:`);
       }),
       async execute(args, ctx) {
         try {
-          const absInput = resolve61(ctx.workingDirectory, args.input);
-          const absOutput = resolve61(ctx.workingDirectory, args.output);
+          const absInput = resolve63(ctx.workingDirectory, args.input);
+          const absOutput = resolve63(ctx.workingDirectory, args.output);
           const codecMap = {
             h264: "libx264",
             h265: "libx265",
@@ -61632,11 +61914,11 @@ Audio:`);
           };
         }
         try {
-          const absOutput = resolve61(ctx.workingDirectory, args.output);
+          const absOutput = resolve63(ctx.workingDirectory, args.output);
           if (args.reencode) {
             const ffmpegArgs = [];
             for (const i of args.inputs) {
-              ffmpegArgs.push("-i", resolve61(ctx.workingDirectory, i));
+              ffmpegArgs.push("-i", resolve63(ctx.workingDirectory, i));
             }
             const filterComplex = args.inputs.map((_, i) => `[${i}:v][${i}:a]`).join("");
             ffmpegArgs.push(
@@ -61651,8 +61933,8 @@ Audio:`);
             );
             await execSafe("ffmpeg", ffmpegArgs, { maxBuffer: 100 * 1024 * 1024 });
           } else {
-            const tempList = resolve61(ctx.workingDirectory, `concat-list-${Date.now()}.txt`);
-            const listContent = args.inputs.map((i) => `file '${resolve61(ctx.workingDirectory, i)}'`).join("\n");
+            const tempList = resolve63(ctx.workingDirectory, `concat-list-${Date.now()}.txt`);
+            const listContent = args.inputs.map((i) => `file '${resolve63(ctx.workingDirectory, i)}'`).join("\n");
             await writeFile47(tempList, listContent, "utf-8");
             try {
               await execSafe(
@@ -61737,7 +62019,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.
 
@@ -61745,19 +62027,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).
@@ -61768,7 +62050,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
@@ -61778,7 +62060,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
@@ -61790,12 +62072,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\`)
@@ -61813,18 +62095,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.
 
@@ -61847,9 +62129,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
@@ -61933,8 +62215,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\`,
@@ -61969,18 +62251,18 @@ overlay, etc.) \u2014 useful at the tail of a pipeline.
         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"
@@ -62306,7 +62588,7 @@ init_source();
 // package.json
 var package_default = {
   name: "@vibeframe/cli",
-  version: "0.72.0",
+  version: "0.73.0",
   description: "VibeFrame CLI - natural language video editing from the terminal",
   private: false,
   license: "MIT",
@@ -62578,6 +62860,19 @@ projectCommand.command("create").description("Create a new project").argument("<
     const data = JSON.stringify(project.toJSON(), null, 2);
     await writeFile(outputPath, data, "utf-8");
     spinner2.succeed(source_default.green(`Project created: ${outputPath}`));
+    if (isJsonMode()) {
+      outputSuccess({
+        command: "project create",
+        startedAt,
+        data: {
+          outputPath,
+          name: projectName,
+          aspectRatio: options.ratio,
+          frameRate: parseInt(options.fps, 10)
+        }
+      });
+      return;
+    }
     console.log();
     console.log(source_default.dim("  Name:"), projectName);
     console.log(source_default.dim("  Aspect Ratio:"), options.ratio);
@@ -62589,6 +62884,7 @@ projectCommand.command("create").description("Create a new project").argument("<
   }
 });
 projectCommand.command("info").description("Show project information").argument("<file>", "Project file path").action(async (file) => {
+  const startedAt = Date.now();
   const spinner2 = ora("Loading project...").start();
   try {
     const filePath = await resolveProjectPath(file);
@@ -62598,6 +62894,24 @@ projectCommand.command("info").description("Show project information").argument(
     spinner2.stop();
     const summary = project.getSummary();
     const meta = project.getMeta();
+    if (isJsonMode()) {
+      outputSuccess({
+        command: "project info",
+        startedAt,
+        data: {
+          name: summary.name,
+          duration: summary.duration,
+          aspectRatio: summary.aspectRatio,
+          frameRate: summary.frameRate,
+          trackCount: summary.trackCount,
+          clipCount: summary.clipCount,
+          sourceCount: summary.sourceCount,
+          createdAt: meta.createdAt.toISOString(),
+          updatedAt: meta.updatedAt.toISOString()
+        }
+      });
+      return;
+    }
     console.log();
     console.log(source_default.bold.cyan("Project Info"));
     console.log(source_default.dim("\u2500".repeat(40)));
@@ -62648,6 +62962,21 @@ projectCommand.command("set").description("Update project settings").argument("<
     if (options.fps) project.setFrameRate(parseInt(options.fps, 10));
     await writeFile(filePath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
     spinner2.succeed(source_default.green("Project updated"));
+    if (isJsonMode()) {
+      outputSuccess({
+        command: "project set",
+        startedAt,
+        data: {
+          file: filePath,
+          updates: {
+            name: options.name ?? null,
+            ratio: options.ratio ?? null,
+            fps: options.fps ? parseInt(options.fps, 10) : null
+          }
+        }
+      });
+      return;
+    }
   } catch (error) {
     spinner2.fail("Failed to update project");
     const msg = error instanceof Error ? error.message : String(error);
@@ -62721,6 +63050,20 @@ timelineCommand.command("add-source").description("Add a media source to the pro
     });
     await writeFile10(filePath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
     spinner2.succeed(source_default.green(`Source added: ${source.id}`));
+    if (isJsonMode()) {
+      outputSuccess({
+        command: "timeline add-source",
+        startedAt,
+        data: {
+          id: source.id,
+          name: mediaName,
+          type: mediaType,
+          path: absMediaPath,
+          duration
+        }
+      });
+      return;
+    }
     console.log();
     console.log(source_default.dim("  Name:"), mediaName);
     console.log(source_default.dim("  Type:"), mediaType);
@@ -62788,6 +63131,21 @@ timelineCommand.command("add-clip").description("Add a clip to the timeline").ar
     });
     await writeFile10(filePath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
     spinner2.succeed(source_default.green(`Clip added: ${clip.id}`));
+    if (isJsonMode()) {
+      outputSuccess({
+        command: "timeline add-clip",
+        startedAt,
+        data: {
+          id: clip.id,
+          sourceId,
+          sourceName: source.name,
+          trackId,
+          startTime,
+          duration
+        }
+      });
+      return;
+    }
     console.log();
     console.log(source_default.dim("  Source:"), source.name);
     console.log(source_default.dim("  Track:"), trackId);
@@ -62835,6 +63193,18 @@ timelineCommand.command("add-track").description("Add a new track").argument("<p
     });
     await writeFile10(filePath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
     spinner2.succeed(source_default.green(`Track added: ${track.id}`));
+    if (isJsonMode()) {
+      outputSuccess({
+        command: "timeline add-track",
+        startedAt,
+        data: {
+          id: track.id,
+          name: track.name,
+          type: track.type
+        }
+      });
+      return;
+    }
     console.log();
     console.log(source_default.dim("  Name:"), track.name);
     console.log(source_default.dim("  Type:"), track.type);
@@ -62891,6 +63261,21 @@ timelineCommand.command("add-effect").description("Add an effect to a clip").arg
     }
     await writeFile10(filePath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
     spinner2.succeed(source_default.green(`Effect added: ${effect.id}`));
+    if (isJsonMode()) {
+      outputSuccess({
+        command: "timeline add-effect",
+        startedAt,
+        data: {
+          id: effect.id,
+          type: effectType,
+          clipId,
+          startTime,
+          duration,
+          params
+        }
+      });
+      return;
+    }
     console.log();
     console.log(source_default.dim("  Type:"), effectType);
     console.log(source_default.dim("  Start:"), startTime, "s");
@@ -62940,6 +63325,18 @@ timelineCommand.command("trim").description("Trim a clip").argument("<project>",
     await writeFile10(filePath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
     const updatedClip = project.getClip(clipId);
     spinner2.succeed(source_default.green("Clip trimmed"));
+    if (isJsonMode()) {
+      outputSuccess({
+        command: "timeline trim",
+        startedAt,
+        data: {
+          id: updatedClip.id,
+          startTime: updatedClip.startTime,
+          duration: updatedClip.duration
+        }
+      });
+      return;
+    }
     console.log();
     console.log(source_default.dim("  Start:"), updatedClip.startTime, "s");
     console.log(source_default.dim("  Duration:"), updatedClip.duration, "s");
@@ -62950,17 +63347,61 @@ timelineCommand.command("trim").description("Trim a clip").argument("<project>",
   }
 });
 timelineCommand.command("list").description("List timeline contents").argument("<project>", "Project file path").option("--sources", "List sources only").option("--tracks", "List tracks only").option("--clips", "List clips only").action(async (projectPath, options) => {
+  const startedAt = Date.now();
   try {
     const filePath = resolve15(process.cwd(), projectPath);
     const content = await readFile12(filePath, "utf-8");
     const data = JSON.parse(content);
     const project = Project.fromJSON(data);
     const showAll = !options.sources && !options.tracks && !options.clips;
+    const sources = project.getSources();
+    const tracks = project.getTracks();
+    const clips = project.getClips();
+    if (isJsonMode()) {
+      const result = {};
+      if (showAll || options.sources) {
+        result.sources = sources.map((s) => ({
+          id: s.id,
+          name: s.name,
+          type: s.type,
+          duration: s.duration
+        }));
+      }
+      if (showAll || options.tracks) {
+        result.tracks = tracks.map((t) => ({
+          id: t.id,
+          name: t.name,
+          type: t.type,
+          isMuted: t.isMuted,
+          isLocked: t.isLocked,
+          isVisible: t.isVisible
+        }));
+      }
+      if (showAll || options.clips) {
+        result.clips = clips.map((c) => {
+          const source = project.getSource(c.sourceId);
+          return {
+            id: c.id,
+            sourceId: c.sourceId,
+            sourceName: source?.name ?? null,
+            trackId: c.trackId,
+            startTime: c.startTime,
+            duration: c.duration,
+            effects: c.effects.map((e) => ({ id: e.id, type: e.type }))
+          };
+        });
+      }
+      outputSuccess({
+        command: "timeline list",
+        startedAt,
+        data: result
+      });
+      return;
+    }
     if (showAll || options.sources) {
       console.log();
       console.log(source_default.bold.cyan("Sources"));
       console.log(source_default.dim("\u2500".repeat(60)));
-      const sources = project.getSources();
       if (sources.length === 0) {
         console.log(source_default.dim("  (none)"));
       } else {
@@ -62974,7 +63415,6 @@ timelineCommand.command("list").description("List timeline contents").argument("
       console.log();
       console.log(source_default.bold.cyan("Tracks"));
       console.log(source_default.dim("\u2500".repeat(60)));
-      const tracks = project.getTracks();
       for (const track of tracks) {
         const status = [
           track.isMuted ? "muted" : null,
@@ -62989,7 +63429,6 @@ timelineCommand.command("list").description("List timeline contents").argument("
       console.log();
       console.log(source_default.bold.cyan("Clips"));
       console.log(source_default.dim("\u2500".repeat(60)));
-      const clips = project.getClips();
       if (clips.length === 0) {
         console.log(source_default.dim("  (none)"));
       } else {
@@ -63051,6 +63490,17 @@ timelineCommand.command("split").description("Split a clip at a specific time").
     await writeFile10(filePath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
     const [first, second] = result;
     spinner2.succeed(source_default.green("Clip split successfully"));
+    if (isJsonMode()) {
+      outputSuccess({
+        command: "timeline split",
+        startedAt,
+        data: {
+          first: { id: first.id, duration: first.duration },
+          second: { id: second.id, duration: second.duration }
+        }
+      });
+      return;
+    }
     console.log();
     console.log(source_default.dim("  First clip:"), first.id, `(${first.duration.toFixed(2)}s)`);
     console.log(source_default.dim("  Second clip:"), second.id, `(${second.duration.toFixed(2)}s)`);
@@ -63097,6 +63547,19 @@ timelineCommand.command("duplicate").description("Duplicate a clip").argument("<
     }
     await writeFile10(filePath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
     spinner2.succeed(source_default.green(`Clip duplicated: ${duplicated.id}`));
+    if (isJsonMode()) {
+      outputSuccess({
+        command: "timeline duplicate",
+        startedAt,
+        data: {
+          id: duplicated.id,
+          sourceClipId: clipId,
+          startTime: duplicated.startTime,
+          duration: duplicated.duration
+        }
+      });
+      return;
+    }
     console.log();
     console.log(source_default.dim("  Start:"), duplicated.startTime, "s");
     console.log(source_default.dim("  Duration:"), duplicated.duration, "s");
@@ -63141,6 +63604,17 @@ timelineCommand.command("delete").description("Delete a clip from the timeline")
     }
     await writeFile10(filePath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
     spinner2.succeed(source_default.green("Clip deleted"));
+    if (isJsonMode()) {
+      outputSuccess({
+        command: "timeline delete",
+        startedAt,
+        data: {
+          id: clipId,
+          deleted: true
+        }
+      });
+      return;
+    }
   } catch (error) {
     spinner2.fail("Failed to delete clip");
     const msg = error instanceof Error ? error.message : String(error);
@@ -63188,6 +63662,18 @@ timelineCommand.command("move").description("Move a clip to a new position").arg
     await writeFile10(filePath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
     const updated = project.getClip(clipId);
     spinner2.succeed(source_default.green("Clip moved"));
+    if (isJsonMode()) {
+      outputSuccess({
+        command: "timeline move",
+        startedAt,
+        data: {
+          id: updated.id,
+          trackId: updated.trackId,
+          startTime: updated.startTime
+        }
+      });
+      return;
+    }
     console.log();
     console.log(source_default.dim("  Track:"), updated.trackId);
     console.log(source_default.dim("  Start:"), updated.startTime, "s");
@@ -64124,13 +64610,13 @@ init_ai_highlights();
 init_ai_animated_caption();
 init_output();
 var pipelineCommand = new Command("pipeline").alias("pipe").description(
-  "AI media transformations on existing video / audio (highlights, auto-shorts, animated captions). For BUILD-from-text flows see `vibe scene build`."
+  "AI media transformations on existing video / audio (highlights, auto-shorts, animated captions). For BUILD-from-text flows see `vibe build`."
 ).addHelpText(
   "after",
   `
 Two flows \u2014 pick by intent:
   BUILD     \u2014 text \u2192 MP4 (intent \u2192 AI generation \u2192 new video)
-              Use \`vibe scene build\` with a STORYBOARD.md + DESIGN.md.
+              Use \`vibe build\` with a STORYBOARD.md + DESIGN.md.
               Idempotent, agent-editable, skills-driven (v0.60+).
   PROCESS   \u2014 existing video/audio \u2192 transformed media
               Use \`vibe pipeline\` (this group) or \`vibe edit\` / \`vibe audio\`.
@@ -64142,7 +64628,7 @@ Examples (PROCESS):
   $ vibe pipeline animated-caption video.mp4 -o captioned.mp4 -s highlight
   $ vibe pipeline animated-caption video.mp4 -o out.mp4 -s karaoke-sweep --fast
 
-Required API Keys:
+Provider API Keys:
   highlights:          GOOGLE_API_KEY (Gemini analysis)
   auto-shorts:         GOOGLE_API_KEY + OPENAI_API_KEY (optional captions)
   animated-caption:    OPENAI_API_KEY (Whisper transcription)
@@ -64153,7 +64639,7 @@ Cost tiers:
   animated-caption:    $   Low (~$0.01)
   regenerate-scene:    $$$ High (per-scene re-run; depends on provider)
 
-Note: \`pipeline script-to-video\` was removed \u2014 use \`vibe scene build\` for
+Note: \`pipeline script-to-video\` was removed \u2014 use \`vibe build\` for
 text \u2192 MP4. \`pipeline regenerate-scene\` still operates on the
 storyboard.{yaml,json} layout produced by older runs.
 
@@ -64343,18 +64829,36 @@ function listCommands(program3) {
   console.log(JSON.stringify(commands, null, 2));
 }
 function extractEnumFromDescription(description) {
-  const providerMatch = description.match(
-    /(?:Provider|Providers?):\s*([a-z0-9,\s-]+?)(?:\s*\(|$)/i
+  const cleaned = description.replace(/\s*\([^()]*\)/g, "");
+  const finalize = (raw) => {
+    const values = raw.map((v) => v.trim().replace(/^or\s+/i, "")).filter(Boolean);
+    if (values.some((v) => /\s/.test(v))) return void 0;
+    if (values.length >= 2 && values.length <= 12) return values;
+    return void 0;
+  };
+  const providerMatch = cleaned.match(
+    /(?:Provider|Providers?):\s*([a-z0-9,\s-]+?)$/i
   );
   if (providerMatch) {
-    return providerMatch[1].split(",").map((s) => s.trim()).filter(Boolean);
+    const values = finalize(providerMatch[1].split(","));
+    if (values) return values;
   }
-  const styleMatch = description.match(
-    /^[A-Z][a-z]+:\s*([a-z0-9,\s-]+?)(?:\s*\(|$)/
+  const labeledMatch = cleaned.match(
+    /^([A-Z][a-z]+(?:\s+[a-z]+){0,2}):\s*([a-z0-9:,\s/-]+?)$/
   );
-  if (styleMatch) {
-    const values = styleMatch[1].split(",").map((s) => s.trim()).filter(Boolean);
-    if (values.length >= 2 && values.length <= 10) return values;
+  if (labeledMatch) {
+    return finalize(labeledMatch[2].split(","));
+  }
+  const parenMatch = description.match(/\(([^()]+)\)\s*$/);
+  if (parenMatch) {
+    const inner = parenMatch[1].trim();
+    if (/^default:|^e\.g\.|^or\s|via\s|run\s/i.test(inner)) return void 0;
+    const rawValues = inner.split(",").map((s) => s.trim()).filter(Boolean);
+    const values = rawValues.map((v) => v.replace(/^or\s+/i, "").trim());
+    const looksLikeEnum = values.every(
+      (v) => /^[a-z0-9][a-z0-9:/_-]*$/i.test(v) && v.length <= 24
+    );
+    if (looksLikeEnum && values.length >= 2 && values.length <= 12) return values;
   }
   return void 0;
 }
@@ -68849,7 +69353,7 @@ init_detect();
 // src/commands/setup.ts
 init_esm();
 init_source();
-var import_dotenv2 = __toESM(require_main(), 1);
+var import_dotenv3 = __toESM(require_main(), 1);
 init_config();
 init_output();
 init_tty();
@@ -68898,7 +69402,7 @@ var AI_FEATURES = [
   {
     label: "Videos",
     desc: "generate + extend",
-    defaultProvider: "fal.ai Seedance 2.0 (Artificial Analysis #2 t2v + i2v, since v0.57)",
+    defaultProvider: "Seedance 2.0 via fal.ai (Artificial Analysis #2 t2v + i2v, since v0.57)",
     alsoAvailable: "Grok Imagine, Kling, Runway Gen-4.5, Google Veo",
     keys: [{ configKey: "fal", envVar: "FAL_KEY", name: "fal.ai", url: "https://fal.ai/dashboard/keys", what: "ByteDance Seedance 2.0 text-to-video and image-to-video" }],
     tryCommand: 'vibe generate video "ocean waves" -o waves.mp4'
@@ -68973,7 +69477,7 @@ async function runSetupWizard(fullSetup = false) {
     console.log();
     await collectKeys(config2, pipelineKeys);
     await saveConfig(config2);
-    showComplete(config2, "vibe scene build my-story/   # see CONTRIBUTING.md for STORYBOARD.md format");
+    showComplete(config2, "vibe build my-story/   # see CONTRIBUTING.md for STORYBOARD.md format");
     return;
   }
   console.log(source_default.dim("Step 2 of 2"));
@@ -69138,7 +69642,7 @@ function showComplete(config2, defaultTryCommand, features = []) {
   console.log(source_default.bold("  Next steps:"));
   console.log(source_default.dim("    cd <project>; vibe init   Scaffold AGENTS.md / CLAUDE.md / .env.example (project scope)"));
   console.log(source_default.dim("    vibe doctor               Check system health + available commands"));
-  console.log(source_default.dim("    vibe schema --list        Discover all 69 commands"));
+  console.log(source_default.dim("    vibe schema --list        Discover all 81 commands"));
   console.log(source_default.dim("    vibe setup                Re-run user-scope setup anytime"));
   const hosts = detectedAgentHosts();
   const primary = hosts[0];
@@ -69151,14 +69655,14 @@ function showComplete(config2, defaultTryCommand, features = []) {
     );
     console.log(
       source_default.dim(
-        `  Scene composer will auto-dispatch to ${primary.label} (${source_default.bold("--mode agent")}). Run \`vibe scene init my-promo\` to scaffold a scene project + install the Hyperframes skill.`
+        `  Scene composer will auto-dispatch to ${primary.label} (${source_default.bold("--mode agent")}). Run \`vibe init my-promo\` to scaffold a video project + install local composition rules.`
       )
     );
   } else {
     console.log();
     console.log(
       source_default.dim(
-        `  No agent host detected \u2014 \`vibe scene build\` will use the internal LLM composer (${source_default.bold("--mode batch")}).`
+        `  No agent host detected \u2014 \`vibe build\` will use the internal LLM composer (${source_default.bold("--mode batch")}).`
       )
     );
   }
@@ -69207,7 +69711,7 @@ async function showConfig() {
   if (hasCwdEnv) {
     try {
       const envContent = await readFile33(cwdEnvPath, "utf-8");
-      dotenvKeys = (0, import_dotenv2.parse)(Buffer.from(envContent));
+      dotenvKeys = (0, import_dotenv3.parse)(Buffer.from(envContent));
     } catch {
     }
   }
@@ -69269,6 +69773,9 @@ async function showConfig() {
 init_esm();
 init_source();
 init_agent_host_detect();
+init_scene_project();
+init_visual_styles();
+init_install_skill();
 import { existsSync as existsSync34 } from "node:fs";
 import { mkdir as mkdir20, readFile as readFile34, writeFile as writeFile39 } from "node:fs/promises";
 import { basename as basename19, dirname as dirname18, resolve as resolve48 } from "node:path";
@@ -69322,9 +69829,9 @@ VibeFrame splits cleanly into two flows. Routing the user's request
 correctly is the most important judgement call you'll make.
 
 **BUILD \u2014 create new video from text intent.**
-Use \`vibe scene build\` with a STORYBOARD.md + DESIGN.md. The
+Use \`vibe build\` with a STORYBOARD.md + DESIGN.md. The
 skills-driven pipeline (v0.60+) dispatches narration TTS + backdrop
-image-gen per beat, composes scene HTML via the Hyperframes skill
+image-gen per beat, composes scene HTML via the bundled composition rules
 bundle, then renders to MP4. Idempotent re-runs reuse cached assets.
 
 **PROCESS \u2014 transform existing video / audio.**
@@ -69341,8 +69848,8 @@ PROCESS.
 
 | Task | Command |
 |---|---|
-| One-shot storyboard \u2192 MP4 | \`vibe scene build [project-dir]\` |
-| Render an existing scene project | \`vibe scene render -o out.mp4\` |
+| One-shot storyboard \u2192 video | \`vibe build [project-dir]\` |
+| Render an existing scene project | \`vibe render [project-dir] -o out.mp4\` |
 | Lint scene HTML | \`vibe scene lint --json\` |
 | Generate a single image | \`vibe generate image "prompt" -o img.png --quality hd\` |
 | Generate a single video | \`vibe generate video "prompt" -i image.png -o clip.mp4\` |
@@ -69375,7 +69882,7 @@ PROCESS.
 | **Free** | \`detect *\`, \`edit silence-cut/fade/noise-reduce\`, \`schema\`, \`project\`, \`timeline\` | $0 |
 | **Low** | \`analyze *\`, \`audio transcribe\`, \`generate image\` | $0.01\u2013$0.10 |
 | **High** | \`generate video\`, \`edit image\` | $1\u2013$5 |
-| **Very High** | \`pipeline *\` (highlights, auto-shorts, regenerate-scene), \`scene build\` | $5\u2013$50+ |
+| **Very High** | \`pipeline *\` (highlights, auto-shorts, regenerate-scene), \`build\` | $5\u2013$50+ |
 
 ## Agent invariants
 
@@ -69396,9 +69903,9 @@ API keys live in \`.env\` (gitignored). Copy \`.env.example\` to start. Run
 \`vibe doctor\` to see which keys are currently detected and which providers
 they unlock.
 
-### Hyperframes skill (scene HTML rules)
+### Composition rules (scene HTML)
 
-\`vibe scene init\` installs the Hyperframes skill into your project. The
+\`vibe init\` installs local composition rules into your project. The
 universal copy lives at \`SKILL.md\` (with \`references/*.md\`), and
 host-specific copies are placed where each agent expects them
 (\`.claude/skills/hyperframes/\` for Claude Code, \`.cursor/rules/hyperframes.mdc\`
@@ -69413,7 +69920,7 @@ To retro-install on a project scaffolded before this command existed, run
 
 ### Scene composer (batch / non-agent fallback)
 
-When you don't want to author HTML yourself, \`vibe scene build\` runs an
+When you don't want to author HTML yourself, \`vibe build --mode batch\` runs an
 LLM internally with the same skill bundle. It auto-picks a provider based
 on available keys (\`claude > gemini > openai\`) \u2014 pass \`--composer <name>\`
 to force one:
@@ -69453,7 +69960,7 @@ pack is available as slash commands (consolidated to 2 in v0.62 \u2014 the
 overview content moved into AGENTS.md above):
 
 - \`/vibe-pipeline\` \u2014 YAML pipeline authoring helper (Video as Code)
-- \`/vibe-scene\` \u2014 per-scene HTML authoring + \`vibe scene build\`
+- \`/vibe-scene\` \u2014 per-scene HTML authoring + \`vibe build\`
 
 To install / update them later:
 
@@ -69518,7 +70025,7 @@ renders/
 `;
 function renderProjectYaml(opts) {
   return `# VibeFrame project config. Used by \`vibe scene render\` to name
-# outputs and by \`vibe scene build\` for default providers / budget.
+# outputs and by \`vibe build\` for default providers / budget.
 name: ${opts.name}
 aspect: "16:9"
 defaults:
@@ -69539,8 +70046,16 @@ defaults:
 // src/commands/init.ts
 init_output();
 var VALID_AGENTS = ["claude-code", "codex", "cursor", "aider", "gemini-cli", "opencode", "all", "auto"];
-var initCommand = new Command("init").description("Scaffold project-scope agent files (AGENTS.md / CLAUDE.md / .env.example / .gitignore)").argument("[project-dir]", "Project directory (defaults to cwd)", ".").option("--agent <id>", `Agent target: ${VALID_AGENTS.join(" | ")}`, "auto").option("--force", "Overwrite existing files instead of skipping").option("--dry-run", "Print the file list without writing anything").action(async (projectDirArg, options) => {
+var initCommand = new Command("init").description("Scaffold a VibeFrame project (video scene project or project-scope agent files)").argument("[project-dir]", "Project directory (defaults to cwd)", ".").option("--type <type>", "Project type: scene (video project) | agent (agent files only)", "scene").option("--profile <profile>", "Scene profile: minimal (storyboard/design only), agent (recommended), full (render scaffold upfront)", "agent").option("-r, --ratio <ratio>", "Scene aspect ratio: 16:9, 9:16, 1:1, 4:5", "16:9").option("-d, --duration <sec>", "Default scene/root duration in seconds", "10").option("--visual-style <name>", "Seed scene DESIGN.md from a named style").option("--agent <id>", `Agent target: ${VALID_AGENTS.join(" | ")}`, "auto").option("--force", "Overwrite existing files instead of skipping").option("--dry-run", "Print the file list without writing anything").action(async (projectDirArg, options) => {
   const startedAt = Date.now();
+  const initType = String(options.type ?? "scene");
+  if (initType !== "scene" && initType !== "agent") {
+    exitWithError(usageError(`Invalid --type: ${initType}`, "Must be one of: scene, agent"));
+  }
+  if (initType === "scene") {
+    await runSceneInit(projectDirArg, options, startedAt);
+    return;
+  }
   const agent = options.agent;
   if (!VALID_AGENTS.includes(agent)) {
     exitWithError(usageError(`Invalid --agent: ${agent}`, `Must be one of: ${VALID_AGENTS.join(", ")}`));
@@ -69642,6 +70157,150 @@ var initCommand = new Command("init").description("Scaffold project-scope agent
   console.log(source_default.dim("    vibe scene init my-promo      Scaffold a starter scene project"));
   console.log();
 });
+var VALID_SCENE_ASPECTS = ["16:9", "9:16", "1:1", "4:5"];
+async function runSceneInit(projectDirArg, options, startedAt) {
+  const profile = String(options.profile ?? "agent");
+  if (!isSceneScaffoldProfile(profile)) {
+    exitWithError(usageError(`Invalid --profile: ${profile}`, "Must be one of: minimal, agent, full"));
+  }
+  const aspect = String(options.ratio ?? "16:9");
+  if (!VALID_SCENE_ASPECTS.includes(aspect)) {
+    exitWithError(usageError(`Invalid --ratio: ${aspect}`, `Must be one of: ${VALID_SCENE_ASPECTS.join(", ")}`));
+  }
+  const duration = Number.parseFloat(String(options.duration ?? "10"));
+  if (!Number.isFinite(duration) || duration <= 0 || duration > 3600) {
+    exitWithError(usageError(`Invalid --duration: ${String(options.duration)}`, "Duration must be a positive number of seconds (\u22643600)"));
+  }
+  const visualStyle = options.visualStyle ? getVisualStyle(String(options.visualStyle)) : void 0;
+  if (options.visualStyle && !visualStyle) {
+    exitWithError(usageError(`Unknown visual style: ${String(options.visualStyle)}`, `Valid: ${visualStyleNames()}. Browse with \`vibe scene styles\`.`));
+  }
+  const projectDir = resolve48(projectDirArg);
+  const projectName = basename19(projectDir);
+  const groups = describeSceneScaffold({ dir: projectDir, profile });
+  if (options.dryRun) {
+    if (!isJsonMode()) {
+      printSceneInitPlan({
+        projectDir,
+        profile,
+        aspect,
+        duration,
+        visualStyleName: visualStyle?.name ?? null,
+        groups,
+        dryRun: true
+      });
+      return;
+    }
+    outputSuccess({
+      command: "init",
+      startedAt,
+      dryRun: true,
+      data: {
+        type: "scene",
+        projectDir,
+        name: projectName,
+        profile,
+        aspect,
+        duration,
+        visualStyle: visualStyle?.name ?? null,
+        groups
+      }
+    });
+    return;
+  }
+  const result = await scaffoldSceneProject({
+    dir: projectDir,
+    name: projectName,
+    aspect,
+    duration,
+    visualStyle,
+    profile
+  });
+  const detectedIds = detectedAgentHosts().map((h) => h.id);
+  const skillResult = profile === "agent" || profile === "full" ? await installHyperframesSkill({
+    projectDir,
+    hosts: deriveInstallHosts(detectedIds)
+  }) : { success: true, files: [], bundleVersion: "not-installed" };
+  if (isJsonMode()) {
+    outputSuccess({
+      command: "init",
+      startedAt,
+      data: {
+        type: "scene",
+        projectDir,
+        name: projectName,
+        profile,
+        aspect,
+        duration,
+        visualStyle: visualStyle?.name ?? null,
+        created: result.created,
+        merged: result.merged,
+        skipped: result.skipped,
+        groups: result.groups,
+        skillFiles: skillResult.files,
+        skillBundleVersion: skillResult.bundleVersion
+      }
+    });
+    return;
+  }
+  console.log();
+  console.log(source_default.bold.magenta("VibeFrame Init") + source_default.dim(" \u2014 video project ready"));
+  console.log(source_default.dim("\u2500".repeat(60)));
+  console.log(`${source_default.dim("Project")}  ${projectDir}`);
+  console.log(`${source_default.dim("Profile")}  ${profile} ${source_default.dim(sceneProfileSummary(profile))}`);
+  console.log();
+  console.log(source_default.bold("Edit first"));
+  console.log(`  ${source_default.cyan("STORYBOARD.md")}  ${source_default.dim("beats: narration, backdrop, minimum duration")}`);
+  console.log(`  ${source_default.cyan("DESIGN.md")}      ${source_default.dim("palette, typography, motion rules")}`);
+  console.log();
+  console.log(source_default.bold("Then run"));
+  console.log(`  ${source_default.cyan("vibe build")}   ${source_default.dim("build storyboard assets/compositions")}`);
+  console.log(`  ${source_default.cyan("vibe render")}  ${source_default.dim("render final MP4")}`);
+  console.log();
+  console.log(source_default.bold("Files"));
+  for (const p of result.created) console.log(source_default.green(`    + ${p.replace(projectDir + "/", "")}`));
+  for (const p of result.merged) console.log(source_default.yellow(`    ~ ${p.replace(projectDir + "/", "")} (merged)`));
+  for (const p of result.skipped) console.log(source_default.dim(`    \xB7 ${p.replace(projectDir + "/", "")} (kept existing)`));
+  for (const f of skillResult.files.filter((f2) => f2.status === "wrote")) {
+    console.log(source_default.green(`    + ${f.path.replace(projectDir + "/", "")}`));
+  }
+  console.log();
+  console.log(source_default.dim(`Tip: cd ${projectDirArg} before running the next commands.`));
+  console.log();
+}
+function sceneProfileSummary(profile) {
+  if (profile === "minimal") return "(storyboard/design only)";
+  if (profile === "agent") return "(recommended: + local agent authoring rules)";
+  return "(+ render scaffold upfront)";
+}
+function printSceneInitPlan(opts) {
+  console.log();
+  console.log(source_default.bold.magenta("VibeFrame Init") + source_default.dim(opts.dryRun ? " \u2014 dry run" : ""));
+  console.log(source_default.dim("\u2500".repeat(60)));
+  console.log(`${source_default.dim("Project")}  ${opts.projectDir}`);
+  console.log(`${source_default.dim("Profile")}  ${opts.profile} ${source_default.dim(sceneProfileSummary(opts.profile))}`);
+  console.log(`${source_default.dim("Canvas")}   ${opts.aspect} \xB7 ${opts.duration}s default`);
+  if (opts.visualStyleName) console.log(`${source_default.dim("Style")}    ${opts.visualStyleName}`);
+  console.log();
+  console.log(source_default.bold("Edit first"));
+  console.log(`  ${source_default.cyan("STORYBOARD.md")}  ${source_default.dim("beats: narration, backdrop, minimum duration")}`);
+  console.log(`  ${source_default.cyan("DESIGN.md")}      ${source_default.dim("palette, typography, motion rules")}`);
+  console.log();
+  console.log(source_default.bold("Project contents"));
+  printGroup("authoring", opts.groups.authoring, opts.projectDir);
+  printGroup("agent", opts.groups.agent, opts.projectDir);
+  printGroup("render", opts.groups.render, opts.projectDir);
+  console.log();
+  console.log(source_default.dim("Dry run \u2014 no files were written. Re-run without --dry-run to create the project."));
+  console.log();
+}
+function printGroup(label, files, projectDir) {
+  if (files.length === 0) return;
+  console.log(`  ${source_default.bold(label)}`);
+  for (const file of files) {
+    console.log(source_default.dim(`    ${file.replace(projectDir + "/", "")}`));
+  }
+}
 function resolveTargets(agent) {
   if (agent === "all") {
     return ["claude-code", "codex", "cursor", "aider", "gemini-cli", "opencode"];
@@ -69696,6 +70355,306 @@ function formatStatusIcon(status) {
   }
 }
 
+// src/commands/build.ts
+init_esm();
+init_source();
+init_ora();
+init_scene_build();
+init_output();
+import { resolve as resolve49 } from "node:path";
+var VALID_MODES = ["agent", "batch", "auto"];
+var buildCommand = new Command("build").description("Build a VibeFrame video project from STORYBOARD.md").argument("[project-dir]", "Video project directory", ".").option("--mode <mode>", "Build mode: agent|batch|auto", "auto").option("--effort <level>", "Compose effort tier (batch mode only): low|medium|high", "medium").option("--composer <provider>", "Batch composer: claude|openai|gemini").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").option("--voice <id>", "Voice id").option("--image-provider <name>", "Image provider: openai").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").addHelpText("after", `
+Examples:
+  $ vibe init my-video --profile agent
+  $ vibe build my-video --mode agent --tts kokoro
+  $ vibe build my-video --skip-render
+
+Advanced equivalent: \`vibe scene build\`.`).action(async (projectDirArg, options) => {
+  const startedAt = Date.now();
+  const projectDir = resolve49(projectDirArg);
+  const mode = String(options.mode ?? "auto");
+  if (!VALID_MODES.includes(mode)) {
+    exitWithError(usageError(`Invalid --mode: ${mode}`, `Must be one of: ${VALID_MODES.join(", ")}`));
+  }
+  const params = {
+    projectDir,
+    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
+  };
+  if (options.dryRun) {
+    if (!isJsonMode() && !isQuietMode()) {
+      printBuildDryRun(projectDirArg, params);
+      return;
+    }
+    outputSuccess({
+      command: "build",
+      startedAt,
+      dryRun: true,
+      data: { params }
+    });
+    return;
+  }
+  const spinner2 = isJsonMode() || isQuietMode() ? null : ora("Building video project...").start();
+  const result = await executeSceneBuild({
+    projectDir,
+    mode,
+    effort: options.effort,
+    composer: options.composer,
+    skipNarration: options.skipNarration,
+    skipBackdrop: options.skipBackdrop,
+    skipRender: options.skipRender,
+    ttsProvider: options.tts,
+    voice: options.voice,
+    imageProvider: options.imageProvider,
+    imageQuality: options.quality,
+    imageSize: options.imageSize,
+    force: options.force,
+    onProgress: (e) => {
+      if (!spinner2) return;
+      if (e.type === "phase-start") spinner2.text = `Phase: ${e.phase}...`;
+      else if (e.type === "render-done") spinner2.text = `Rendered: ${e.outputPath}`;
+    }
+  });
+  if (!result.success) {
+    spinner2?.fail(`Build failed: ${result.error}`);
+    if (isJsonMode()) {
+      outputSuccess({ command: "build", startedAt, data: { ...result } });
+      process.exitCode = 1;
+      return;
+    }
+    exitWithError(generalError(result.error ?? "Build failed"));
+  }
+  if (isJsonMode() || isQuietMode()) {
+    outputSuccess({ command: "build", startedAt, data: { ...result } });
+    return;
+  }
+  if (result.phase === "needs-author") {
+    printNeedsAuthor(result);
+    return;
+  }
+  printBuildResult(spinner2, result, projectDirArg);
+});
+function printBuildDryRun(projectDirArg, params) {
+  console.log();
+  console.log(source_default.bold.cyan("VibeFrame Build - dry run"));
+  console.log(source_default.dim("-".repeat(60)));
+  console.log(`  Project:       ${source_default.bold(projectDirArg)}`);
+  console.log(`  Mode:          ${source_default.bold(params.mode)}`);
+  console.log(`  Composer:      ${source_default.bold(String(params.composer ?? "auto"))}`);
+  console.log(`  TTS:           ${source_default.bold(String(params.ttsProvider ?? "auto"))}${params.skipNarration ? source_default.dim(" (skipped)") : ""}`);
+  console.log(`  Image:         ${source_default.bold(String(params.imageProvider ?? "openai"))} ${source_default.dim(`${params.imageQuality} ${params.imageSize}`)}${params.skipBackdrop ? source_default.dim(" (skipped)") : ""}`);
+  console.log(`  Render:        ${source_default.bold(params.skipRender ? "skip" : "yes")}`);
+  console.log(`  Regenerate:    ${source_default.bold(params.force ? "yes" : "cache when possible")}`);
+  console.log();
+  console.log(source_default.dim("No assets, provider calls, or video files were created."));
+}
+function printNeedsAuthor(result) {
+  console.log(source_default.cyan("Agent authoring required"));
+  console.log();
+  console.log(source_default.bold.cyan("Missing compositions"));
+  console.log(source_default.dim("-".repeat(60)));
+  const missing = result.composePrompts?.beats.filter((beat) => !beat.exists) ?? [];
+  if (missing.length === 0) {
+    console.log(source_default.dim("  No missing files were reported. Re-run `vibe build` to continue."));
+  } else {
+    for (const beat of missing) {
+      const dur = beat.duration !== void 0 ? source_default.dim(` ${beat.duration}s`) : "";
+      console.log(`  ${source_default.bold(beat.id)}${dur} -> ${beat.outputPath}`);
+    }
+  }
+  console.log();
+  console.log(source_default.bold.cyan("Next"));
+  console.log(source_default.dim("-".repeat(60)));
+  console.log("  Ask your coding agent to author the missing HTML files.");
+  console.log("  Then run: vibe build");
+  console.log(source_default.dim("  Use `vibe build --mode batch` when you want the CLI to call an LLM composer instead."));
+}
+function printBuildResult(spinner2, result, projectDirArg) {
+  spinner2?.succeed(source_default.green(result.outputPath ? `Build complete: ${result.outputPath}` : "Build complete"));
+  console.log();
+  console.log(source_default.bold.cyan("Beats"));
+  console.log(source_default.dim("-".repeat(60)));
+  for (const beat of result.beats) {
+    const narration = formatPrimitiveStatus2(beat.narrationStatus, beat.narrationPath);
+    const backdrop = formatPrimitiveStatus2(beat.backdropStatus, beat.backdropPath);
+    console.log(`  ${source_default.bold(beat.beatId.padEnd(12))} narration: ${narration}   backdrop: ${backdrop}`);
+    if (beat.narrationError) console.log(source_default.red(`    ! narration: ${beat.narrationError}`));
+    if (beat.backdropError) console.log(source_default.red(`    ! backdrop: ${beat.backdropError}`));
+  }
+  if (result.composeData) {
+    console.log();
+    console.log(source_default.bold.cyan("Compose"));
+    console.log(source_default.dim("-".repeat(60)));
+    console.log(`  beats     ${result.composeData.beats}`);
+    console.log(`  cache     ${result.composeData.cacheHits} hit / ${result.composeData.beats - result.composeData.cacheHits} fresh`);
+    console.log(`  cost      $${result.composeData.totalCostUsd.toFixed(4)}`);
+  }
+  console.log();
+  console.log(source_default.bold.cyan("Next"));
+  console.log(source_default.dim("-".repeat(60)));
+  if (result.outputPath) {
+    console.log(`  Watch: ${result.outputPath}`);
+  } else {
+    console.log(`  Render: vibe render ${projectDirArg}`);
+  }
+  console.log(source_default.dim(`  Total: ${(result.totalLatencyMs / 1e3).toFixed(1)}s`));
+}
+function formatPrimitiveStatus2(status, path2) {
+  switch (status) {
+    case "generated":
+      return source_default.green(path2 ?? "generated");
+    case "cached":
+      return source_default.dim(path2 ?? "cached");
+    case "skipped":
+      return source_default.dim("skipped");
+    case "missing":
+      return source_default.yellow("missing cue");
+    case "failed":
+      return source_default.red("failed");
+    default:
+      return status;
+  }
+}
+
+// src/commands/render.ts
+init_esm();
+init_source();
+init_ora();
+init_scene_render();
+init_output();
+import { resolve as resolve50 } from "node:path";
+var VALID_FPS2 = [24, 30, 60];
+var VALID_QUALITIES2 = ["draft", "standard", "high"];
+var VALID_FORMATS2 = ["mp4", "webm", "mov"];
+var renderCommand = new Command("render").description("Render a VibeFrame video project to MP4/WebM/MOV").argument("[project-dir]", "Video project directory", ".").option("-o, --out <path>", "Output file (default: renders/<name>-<timestamp>.<format>)").option("--root <file>", "Root composition file", "index.html").option("--fps <n>", `Frames per second: ${VALID_FPS2.join("|")}`, "30").option("--quality <q>", `Quality preset: ${VALID_QUALITIES2.join("|")}`, "standard").option("--format <f>", `Output container: ${VALID_FORMATS2.join("|")}`, "mp4").option("--workers <n>", "Capture workers (1-16, default 1)", "1").option("--dry-run", "Preview parameters without rendering").addHelpText("after", `
+Examples:
+  $ vibe render my-video
+  $ vibe render my-video -o renders/final.mp4 --quality high
+
+Alias note: this is the project-level entrypoint for \`vibe scene render\`.`).action(async (projectDirArg, options) => {
+  const startedAt = Date.now();
+  const projectDir = resolve50(projectDirArg);
+  const fps = parseFps(String(options.fps));
+  const quality = parseQuality(String(options.quality));
+  const format = parseFormat(String(options.format));
+  const workers = parseWorkers(String(options.workers));
+  const params = {
+    projectDir,
+    root: options.root,
+    output: options.out,
+    fps,
+    quality,
+    format,
+    workers
+  };
+  if (options.dryRun) {
+    if (!isJsonMode() && !isQuietMode()) {
+      printRenderDryRun(projectDirArg, params);
+      return;
+    }
+    outputSuccess({
+      command: "render",
+      startedAt,
+      dryRun: true,
+      data: { params }
+    });
+    return;
+  }
+  const spinner2 = isJsonMode() || isQuietMode() ? null : ora("Rendering video project...").start();
+  const result = await executeSceneRender({
+    projectDir,
+    root: options.root,
+    output: options.out,
+    fps,
+    quality,
+    format,
+    workers,
+    onProgress: (pct, stage) => {
+      if (spinner2) spinner2.text = `Rendering [${Math.round(pct * 100)}%] ${stage}`;
+    }
+  });
+  if (!result.success) {
+    spinner2?.fail("Render failed");
+    if (isJsonMode()) {
+      outputSuccess({ command: "render", startedAt, data: { ...result } });
+      process.exitCode = 1;
+      return;
+    }
+    exitWithError(generalError(result.error ?? "Render failed"));
+  }
+  if (isJsonMode() || isQuietMode()) {
+    outputSuccess({ command: "render", startedAt, data: { ...result } });
+    return;
+  }
+  printRenderResult(spinner2, result);
+});
+function printRenderDryRun(projectDirArg, params) {
+  console.log();
+  console.log(source_default.bold.cyan("VibeFrame Render - dry run"));
+  console.log(source_default.dim("-".repeat(60)));
+  console.log(`  Project:       ${source_default.bold(projectDirArg)}`);
+  console.log(`  Root:          ${source_default.bold(String(params.root))}`);
+  console.log(`  Output:        ${source_default.bold(String(params.output ?? `renders/<name>-<timestamp>.${params.format}`))}`);
+  console.log(`  Format:        ${source_default.bold(params.format)}`);
+  console.log(`  Quality/FPS:   ${source_default.bold(`${params.quality} / ${params.fps}`)}`);
+  console.log(`  Workers:       ${source_default.bold(String(params.workers))}`);
+  console.log();
+  console.log(source_default.dim("No browser capture, FFmpeg mux, or video files were created."));
+}
+function printRenderResult(spinner2, result) {
+  spinner2?.succeed(source_default.green(`Render complete: ${result.outputPath}`));
+  console.log();
+  console.log(source_default.bold.cyan("Output"));
+  console.log(source_default.dim("-".repeat(60)));
+  console.log(`  File:      ${source_default.bold(result.outputPath)}`);
+  console.log(`  Format:    ${result.format ?? "mp4"}`);
+  console.log(`  Quality:   ${result.quality ?? "standard"}`);
+  console.log(`  FPS:       ${result.fps ?? 30}`);
+  if (result.totalFrames !== void 0) console.log(`  Frames:    ${result.framesRendered ?? result.totalFrames}/${result.totalFrames}`);
+  if (result.durationMs !== void 0) console.log(`  Duration:  ${(result.durationMs / 1e3).toFixed(2)}s`);
+  if (result.audioCount !== void 0) {
+    const audio = result.audioCount > 0 ? `${result.audioCount} track${result.audioCount === 1 ? "" : "s"} muxed` : "silent";
+    console.log(`  Audio:     ${audio}`);
+  }
+  if (result.audioMuxWarning) console.log(source_default.yellow(`  Warning:   ${result.audioMuxWarning}`));
+}
+function parseFps(value) {
+  const n = Number.parseInt(value, 10);
+  if (!VALID_FPS2.includes(n)) {
+    exitWithError(usageError(`Invalid --fps: ${value}`, `Valid: ${VALID_FPS2.join(", ")}`));
+  }
+  return n;
+}
+function parseQuality(value) {
+  if (!VALID_QUALITIES2.includes(value)) {
+    exitWithError(usageError(`Invalid --quality: ${value}`, `Valid: ${VALID_QUALITIES2.join(", ")}`));
+  }
+  return value;
+}
+function parseFormat(value) {
+  if (!VALID_FORMATS2.includes(value)) {
+    exitWithError(usageError(`Invalid --format: ${value}`, `Valid: ${VALID_FORMATS2.join(", ")}`));
+  }
+  return value;
+}
+function parseWorkers(value) {
+  const n = Number.parseInt(value, 10);
+  if (!Number.isFinite(n) || n < 1 || n > 16) {
+    exitWithError(usageError(`Invalid --workers: ${value}`, "Must be an integer between 1 and 16"));
+  }
+  return n;
+}
+
 // src/commands/doctor.ts
 init_esm();
 init_source();
@@ -69711,7 +70670,7 @@ init_scene_build();
 init_output();
 import { access as access7 } from "node:fs/promises";
 import { existsSync as existsSync35 } from "node:fs";
-import { resolve as resolve49 } from "node:path";
+import { resolve as resolve51 } from "node:path";
 var COMMAND_KEY_MAP = getCommandKeyMap();
 var FREE_COMMANDS = [
   "edit silence-cut",
@@ -69868,7 +70827,7 @@ async function runDiagnostics() {
   const cwd = process.cwd();
   const projectFiles = ["AGENTS.md", "CLAUDE.md", "vibe.project.yaml"].map((rel) => ({
     path: rel,
-    exists: existsSync35(resolve49(cwd, rel))
+    exists: existsSync35(resolve51(cwd, rel))
   }));
   const projectInitialized = projectFiles.some((f) => f.exists);
   const hosts = detectAgentHosts();
@@ -69883,8 +70842,8 @@ async function runDiagnostics() {
   } catch (err) {
     if (!(err instanceof ComposerResolveError)) throw err;
   }
-  const sceneProjectInCwd = existsSync35(resolve49(cwd, "STORYBOARD.md"));
-  const skillInstalled = existsSync35(resolve49(cwd, "SKILL.md"));
+  const sceneProjectInCwd = existsSync35(resolve51(cwd, "STORYBOARD.md"));
+  const skillInstalled = existsSync35(resolve51(cwd, "SKILL.md"));
   return {
     system: {
       node: { version: nodeVersion, ok: true },
@@ -70049,10 +71008,10 @@ init_exec_safe();
 init_detect();
 init_ai_edit();
 init_output();
-import { resolve as resolve50 } from "node:path";
+import { resolve as resolve52 } from "node:path";
 import { existsSync as existsSync36 } from "node:fs";
 import { mkdir as mkdir21, rm as rm4 } from "node:fs/promises";
-var DEMO_DIR = resolve50(process.cwd(), ".vibeframe-demo");
+var DEMO_DIR = resolve52(process.cwd(), ".vibeframe-demo");
 async function generateTestVideo(outputPath) {
   const filter = [
     // Video: color bars with text
@@ -70132,7 +71091,7 @@ var demoCommand = new Command("demo").description("Run sample edits on a test vi
     console.log();
   }
   await mkdir21(DEMO_DIR, { recursive: true });
-  const testVideo = resolve50(DEMO_DIR, "test-input.mp4");
+  const testVideo = resolve52(DEMO_DIR, "test-input.mp4");
   const genSpinner = !isJson ? ora("Generating test video...").start() : null;
   const generated = await generateTestVideo(testVideo);
   if (!generated) {
@@ -70161,7 +71120,7 @@ var demoCommand = new Command("demo").description("Run sample edits on a test vi
       name: "Silence Cut",
       description: "Removing silent segments",
       run: async () => {
-        const output = resolve50(DEMO_DIR, "silence-cut.mp4");
+        const output = resolve52(DEMO_DIR, "silence-cut.mp4");
         const r = await executeSilenceCut({ videoPath: testVideo, outputPath: output, padding: 0.1 });
         if (r.success && r.totalDuration && r.silentDuration) {
           return { success: true, detail: `Removed ${r.silentDuration.toFixed(1)}s silence (${r.totalDuration.toFixed(1)}s \u2192 ${(r.totalDuration - r.silentDuration).toFixed(1)}s)` };
@@ -70173,7 +71132,7 @@ var demoCommand = new Command("demo").description("Run sample edits on a test vi
       name: "Noise Reduce",
       description: "Reducing background noise",
       run: async () => {
-        const output = resolve50(DEMO_DIR, "noise-reduced.mp4");
+        const output = resolve52(DEMO_DIR, "noise-reduced.mp4");
         const r = await executeNoiseReduce({ inputPath: testVideo, outputPath: output, strength: "medium" });
         return { success: r.success, detail: r.success ? `Cleaned audio \u2192 ${output}` : r.error };
       }
@@ -70182,7 +71141,7 @@ var demoCommand = new Command("demo").description("Run sample edits on a test vi
       name: "Fade Effects",
       description: "Adding fade in/out",
       run: async () => {
-        const output = resolve50(DEMO_DIR, "faded.mp4");
+        const output = resolve52(DEMO_DIR, "faded.mp4");
         const r = await executeFade({ videoPath: testVideo, outputPath: output, fadeIn: 1, fadeOut: 1 });
         return { success: r.success, detail: r.success ? `1s fade in + 1s fade out \u2192 ${output}` : r.error };
       }
@@ -70250,13 +71209,13 @@ var demoCommand = new Command("demo").description("Run sample edits on a test vi
 // src/commands/context.ts
 init_esm();
 import { readFile as readFile35 } from "node:fs/promises";
-import { resolve as resolve51, dirname as dirname19 } from "node:path";
+import { resolve as resolve53, dirname as dirname19 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 var __filename = fileURLToPath2(import.meta.url);
 var __dirname = dirname19(__filename);
 var contextCommand = new Command("context").description("Print CLI context/guidelines for AI agent integration").action(async (_options, cmd) => {
   const options = { json: cmd.parent?.opts()?.json || cmd.opts()?.json };
-  const contextPath = resolve51(__dirname, "../../CONTEXT.md");
+  const contextPath = resolve53(__dirname, "../../CONTEXT.md");
   try {
     const content = await readFile35(contextPath, "utf-8");
     if (options.json) {
@@ -70997,14 +71956,14 @@ async function promptConfirm2(toolName, args) {
     output: process.stdout,
     terminal: process.stdin.isTTY ?? false
   });
-  return new Promise((resolve62) => {
+  return new Promise((resolve64) => {
     const argsStr = JSON.stringify(args, null, 2);
     console.log();
     console.log(source_default.yellow(`Execute ${source_default.bold(toolName)}?`));
     console.log(source_default.dim(argsStr));
     rl.question(source_default.cyan("(y/n): "), (answer) => {
       rl.close();
-      resolve62(answer.toLowerCase() === "y" || answer.toLowerCase() === "yes");
+      resolve64(answer.toLowerCase() === "y" || answer.toLowerCase() === "yes");
     });
   });
 }
@@ -71093,7 +72052,7 @@ async function startAgent(options = {}) {
   console.log();
   console.log(source_default.dim("  Commands: exit \xB7 reset \xB7 tools \xB7 context"));
   console.log();
-  return new Promise((resolve62) => {
+  return new Promise((resolve64) => {
     if (typeof process.stdin.ref === "function") {
       process.stdin.ref();
     }
@@ -71195,7 +72154,7 @@ async function startAgent(options = {}) {
       clearInterval(keepalive);
       console.log();
       console.log(source_default.dim("Goodbye!"));
-      resolve62();
+      resolve64();
     });
     rl.prompt();
   });
@@ -71378,7 +72337,7 @@ async function readStdin() {
   return Buffer.concat(chunks).toString("utf-8").trim();
 }
 var program2 = new Command();
-program2.name("vibe").showSuggestionAfterError(true).description("VibeFrame CLI - AI-First Video Editor").version(package_default.version).option("--json", "Output in JSON format").option("-q, --quiet", "Output only the primary result value (path, URL, or ID)").option("--fields <fields>", "Limit JSON output to specific fields (comma-separated)").option("--stdin", "Read options from stdin as JSON (for agent/script use)").option("--describe", "Show JSON schema for the command and exit (no execution)").exitOverride().configureOutput({
+program2.name("vibe").showSuggestionAfterError(true).description("VibeFrame CLI - video projects, AI media generation, and workflow automation").version(package_default.version).option("--json", "Output in JSON format").option("-q, --quiet", "Output only the primary result value (path, URL, or ID)").option("--fields <fields>", "Limit JSON output to specific fields (comma-separated)").option("--stdin", "Read options from stdin as JSON (for agent/script use)").option("--describe", "Show JSON schema for the command and exit (no execution)").exitOverride().configureOutput({
   outputError: (str, write2) => {
     if (process.env.VIBE_JSON_OUTPUT === "1" || process.argv.includes("--json")) {
       const err = { success: false, error: str.trim(), code: "USAGE_ERROR", exitCode: 2, retryable: false };
@@ -71403,13 +72362,25 @@ Cost tiers:
   Low      analyze, audio transcribe, generate image               ~$0.01-$0.10
   High     generate video, edit image                              ~$1-$5
   V.High   pipeline (regenerate-scene, highlights, auto-shorts)   ~$5-$50+
+  Tip      Add --dry-run before paid generation to preview the work.
 
-Quick start:
+Project flow:
   vibe doctor                  Check system health and API keys
   vibe setup                   Configure API keys interactively
-  vibe schema --list           Discover all commands (69 commands)
+  vibe init my-video           Scaffold a video project
+  vibe build my-video          Build STORYBOARD.md into scene compositions/assets
+  vibe render my-video         Render the project to MP4
+
+Asset tools:
+  vibe generate image "..."    Generate a still image
+  vibe generate video "..."    Generate a standalone AI video
+
+Workflow automation:
+  vibe run workflow.yaml       Run a Video-as-YAML pipeline
+  vibe schema --list           Discover all commands
 
 Agent integration:
+  vibe walkthrough scene       Load the scene authoring guide
   echo '{"provider":"kling"}' | vibe generate video "prompt" --stdin --json
   vibe schema generate.video   Get parameter schema for any command
 `
@@ -71478,6 +72449,8 @@ program2.addCommand(audioCommand);
 program2.addCommand(pipelineCommand);
 program2.addCommand(setupCommand);
 program2.addCommand(initCommand);
+program2.addCommand(buildCommand);
+program2.addCommand(renderCommand);
 program2.addCommand(doctorCommand);
 program2.addCommand(demoCommand);
 program2.addCommand(runCommand);