@vibeframe/cli 0.113.29 → 0.113.30

package/CONTEXT.md

@@ -125,13 +125,17 @@ vibe guide <topic> --json              # Step-by-step guides (motion | scene | p
 }
 ```
 
-| Code            | Exit | Meaning             | Recovery                   |
-| --------------- | ---- | ------------------- | -------------------------- |
-| `USAGE_ERROR`   | 2    | bad arg             | check `vibe schema <cmd>`  |
-| `NOT_FOUND`     | 3    | file missing        | verify path                |
-| `AUTH_ERROR`    | 4    | key missing/invalid | `vibe doctor`              |
-| `API_ERROR`     | 5    | provider failed     | retry if `retryable: true` |
-| `NETWORK_ERROR` | 6    | connection          | retry with backoff         |
+| Code                 | Exit | Meaning                     | Recovery                          |
+| -------------------- | ---- | --------------------------- | --------------------------------- |
+| `COST_CAP_EXCEEDED`  | 1    | estimate over `--max-cost`  | follow `retryWith`; do not re-run as-is |
+| `USAGE_ERROR`        | 2    | bad arg                     | check `vibe schema <cmd>`         |
+| `NOT_FOUND`          | 3    | file missing                | verify path                       |
+| `AUTH_ERROR`         | 4    | key missing/invalid         | `vibe doctor`                     |
+| `API_ERROR`          | 5    | provider failed             | retry if `retryable: true`        |
+| `NETWORK_ERROR`      | 6    | connection                  | retry with backoff                |
+
+`COST_CAP_EXCEEDED` also carries `data.plan` - the priced plan the refusal was
+based on - so a refused call still tells you what the build would have cost.
 
 ## Authentication
 

package/dist/commands/_shared/scene-project.d.ts

@@ -98,7 +98,7 @@ export declare function buildHyperframesConfig(): HyperframesConfig;
 export declare function buildHyperframesMeta(name: string, now?: Date): HyperframesMeta;
 /**
  * Merge an existing Hyperframes config with our defaults, preserving any
- * user-authored keys and nested values. `vibe scene init` is idempotent:
+ * user-authored keys and nested values. `vibe init` is idempotent:
  * running it on a directory that already has `hyperframes.json` must never
  * lose user config.
  */

package/dist/commands/output.d.ts

@@ -22,6 +22,12 @@ export interface StructuredError {
     retryWith?: string[];
     recoverable?: boolean;
     retryable: boolean;
+    /**
+     * Structured context carried alongside the failure, so a refusal can hand
+     * back the evidence it refused on instead of forcing a second call. Used by
+     * the `--max-cost` gate to return the priced build plan with the refusal.
+     */
+    data?: Record<string, unknown>;
 }
 export declare function usageError(msg: string, suggestion?: string): StructuredError;
 export declare function authError(envVar: string, provider: string): StructuredError;
@@ -29,6 +35,21 @@ export declare function apiError(msg: string, retryable?: boolean): StructuredEr
 export declare function notFoundError(path: string): StructuredError;
 export declare function networkError(msg: string): StructuredError;
 export declare function generalError(msg: string, suggestion?: string): StructuredError;
+/**
+ * The `--max-cost` refusal. A command that declines to spend is a failure, so
+ * it takes the structured error path like every other refusal: `success:false`
+ * on stderr, exit 1. `data` carries the priced plan the refusal was based on,
+ * so an agent gets the estimate and the reason from one call.
+ *
+ * `recoverable: true` because the caller has two real ways forward (raise the
+ * ceiling, or narrow the scope), both spelled out in `retryWith`.
+ */
+export declare function costCapError(opts: {
+    estimatedCostUsd: number;
+    maxCostUsd: number;
+    retryWith: string[];
+    data?: Record<string, unknown>;
+}): StructuredError;
 /** Output structured error then exit */
 export declare function exitWithError(err: StructuredError): never;
 /** Check if --json flag is active */

package/dist/index.js

@@ -6557,6 +6557,19 @@ function notFoundError(path2) {
 function generalError(msg, suggestion) {
   return { success: false, error: msg, code: "ERROR", exitCode: 1 /* GENERAL */, suggestion, retryable: false };
 }
+function costCapError(opts) {
+  return {
+    success: false,
+    error: `Estimated cost $${opts.estimatedCostUsd.toFixed(2)} exceeds --max-cost $${opts.maxCostUsd.toFixed(2)}.`,
+    code: "COST_CAP_EXCEEDED",
+    exitCode: 1 /* GENERAL */,
+    suggestion: "Raise --max-cost or reduce the stage/provider scope.",
+    retryWith: opts.retryWith,
+    recoverable: true,
+    retryable: false,
+    data: opts.data
+  };
+}
 function exitWithError(err) {
   if (isJsonMode()) {
     console.error(JSON.stringify({
@@ -6571,6 +6584,9 @@ function exitWithError(err) {
     if (err.suggestion) {
       console.error(source_default.dim(`  ${err.suggestion}`));
     }
+    if (err.retryWith && err.retryWith.length > 0) {
+      console.error(source_default.dim(`  Retry: ${err.retryWith[0]}`));
+    }
     console.error();
   }
   process.exit(err.exitCode);
@@ -26945,7 +26961,7 @@ ${avoid}
 ---
 
 _Browse other named styles: \`vibe scene list-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>"\`._`}
+${style ? `_This file was seeded by \`vibe init --visual-style "${style.name}"\`._` : `_Seed this file from a named style: \`vibe init <dir> --visual-style "<name>"\`._`}
 `;
 }
 function buildScriptMd(name, kind = DEFAULT_SCENE_KIND) {
@@ -27090,7 +27106,7 @@ Single-asset requests (\`vibe generate image|video|speech|...\`) do NOT
 consult this file - run the generate command directly.
 
 Browse named styles: \`vibe scene list-styles\`. Re-seed from one with
-\`vibe scene init . --visual-style "Swiss Pulse"\` (idempotent).
+\`vibe init . --visual-style "Swiss Pulse"\` (idempotent).
 
 ## Brief and local media
 
@@ -27245,9 +27261,21 @@ npx hyperframes render
 
 ## Key Rules (for hand-authored scene HTML)
 
+0. A scene file is a \`<template id="scene-<id>-template">\` wrapping ONE
+   composition div - not a standalone \`<!doctype html>\` document:
+   \`\`\`html
+   <template id="scene-hook-template">
+     <div data-composition-id="scene-hook" data-start="0" data-duration="3.3"
+          data-width="1920" data-height="1080">\u2026</div>
+   </template>
+   \`\`\`
+   The composition div **MUST** carry \`data-width\` and \`data-height\`.
 1. Every timed element needs \`data-start\`, \`data-duration\`, and \`data-track-index\`.
 2. Elements with timing **MUST** have \`class="clip"\` - the framework uses this for visibility control.
-3. Timelines must be paused and registered on \`window.__timelines\`:
+3. Timelines must be paused and registered on \`window.__timelines\`, which is an
+   OBJECT keyed by composition id - not an array, and \`.push()\` leaves the
+   timeline undiscovered, which renders a black frame because \`gsap.from\` holds
+   elements at their start state:
    \`\`\`js
    window.__timelines = window.__timelines || {};
    window.__timelines["composition-id"] = gsap.timeline({ paused: true });
@@ -28111,7 +28139,7 @@ function insertClipIntoRoot(rootHtml, clip) {
   const closeMatch = rootHtml.match(/\n(\s*)<\/div>(\s*\n\s*<script>)/);
   if (!closeMatch) {
     throw new Error(
-      "Could not find root composition closing </div>. Ensure index.html follows the layout from `vibe scene init`."
+      "Could not find root composition closing </div>. Ensure index.html follows the layout from `vibe init`."
     );
   }
   const closeIdx = closeMatch.index;
@@ -29393,10 +29421,10 @@ async function getComposePrompts(opts) {
     error: msg
   });
   if (!existsSync6(designPath)) {
-    return baseError(`DESIGN.md not found at ${designPath}. Run \`vibe scene init <dir>\` first.`);
+    return baseError(`DESIGN.md not found at ${designPath}. Run \`vibe init <dir>\` first.`);
   }
   if (!existsSync6(storyboardPath2)) {
-    return baseError(`STORYBOARD.md not found at ${storyboardPath2}. Run \`vibe scene init <dir>\` to create a starter, or add STORYBOARD.md with per-beat cues.`);
+    return baseError(`STORYBOARD.md not found at ${storyboardPath2}. Run \`vibe init <dir>\` to create a starter, or add STORYBOARD.md with per-beat cues.`);
   }
   if (!hyperframesSkillAvailable(projectDir)) {
     warnings.push(
@@ -29476,7 +29504,9 @@ function buildInstructions(args) {
   if (args.skillRef) {
     lines.push(`1. Read \`${args.skillRef}\` for the Hyperframes framework rules + house style. This is the visual-identity hard-gate.`);
   } else {
-    lines.push(`1. Run \`vibe scene install-skill\` to install the Hyperframes composition rules, then read them.`);
+    lines.push(
+      `1. Read this project's \`AGENTS.md\` section "Key Rules (for hand-authored scene HTML)" - written by \`vibe init\`, and the authoritative local contract. \`vibe scene install-skill\` adds Hyperframes' house style on top, but note it installs a ROUTER whose full contract sits behind \`/hyperframes-core\`, which resolves only in a host that has upstream's Hyperframes skills.`
+    );
   }
   lines.push(`2. Read \`DESIGN.md\` for project-specific palette, typography, motion signature.`);
   if (args.compositionRef) {
@@ -29486,6 +29516,7 @@ function buildInstructions(args) {
   lines.push(`3b. Use each beat's \`finalDurationSec\` (narration-synced) for \`data-duration\` and timeline anchors when present \u2014 NOT the storyboard \`duration\`, which is only the minimum. Scenes composed at the storyboard duration end early and render black tails.`);
   lines.push(`3c. Never give inner \`.clip\` elements a non-zero \`data-start\` \u2014 the renderer does not toggle internal clip visibility inside sub-compositions, so phased clips render all phases at once (overlapping text). Use full-window clips and GSAP autoAlpha phase transitions instead. Also keep beats 6-15s; split anything longer in the storyboard first.`);
   lines.push(`3d. If your environment cannot write files (e.g. Claude Desktop / MCP-only hosts), author each beat's HTML and submit it with the \`scene_submit\` tool (beat id + html). It validates with the same Hyperframes lint and writes the file for you; on lint errors it returns the findings without writing \u2014 fix and resubmit.`);
+  lines.push(`3e. Hard requirements the linter fails on, so satisfy them even without the full contract. A scene file is a \`<template id="scene-<id>-template">\` wrapping ONE \`<div data-composition-id="scene-<id>" data-start="0" data-duration="<sec>" data-width="1920" data-height="1080">\` \u2014 not a standalone \`<!doctype html>\` document. Register the paused GSAP timeline on the registry OBJECT keyed by composition id: \`window.__timelines = window.__timelines || {}; window.__timelines["scene-<id>"] = tl;\` \u2014 it is not an array, and \`.push()\` leaves the timeline undiscovered, which renders a black frame because \`gsap.from\` holds elements at their start state. Also put \`class="clip"\` on every timed element and give timeline-visible elements a stable \`id\`. Generate a reference scene with \`vibe scene add <id> --style <preset> --no-audio --no-image\` and match its shape.`);
   if (args.beatCount > 1) {
     lines.push(`4. After authoring all ${args.beatCount} beat(s), run \`vibe build <project> --stage sync --json\` to assemble the root composition (index.html) from the fragments. Lint needs that root, so sync comes first.`);
   } else if (args.filtered) {
@@ -30771,7 +30802,9 @@ async function executeSceneAdd(opts) {
     error
   });
   if (!await pathExists2(rootPath)) {
-    return errResult(`Root composition not found: ${rootPath}. Run \`vibe scene init\` first.`);
+    return errResult(
+      `Root composition not found: ${rootPath}. Run \`vibe build\` once to create the render scaffold, or scaffold it up front with \`vibe init <dir> --profile full\`.`
+    );
   }
   if (!opts.force && await pathExists2(scenePath)) {
     return errResult(`Scene already exists: ${sceneRel}. Re-run with --force to overwrite.`);
@@ -31313,7 +31346,7 @@ Run 'vibe schema scene.<command>' for structured parameter info.`
         console.log(source_default.dim("Show details: "), source_default.cyan('vibe scene list-styles "<name>"'));
         console.log(
           source_default.dim("Seed DESIGN.md:"),
-          source_default.cyan('vibe scene init <dir> --visual-style "<name>"')
+          source_default.cyan('vibe init <dir> --visual-style "<name>"')
         );
         return;
       }
@@ -31348,7 +31381,7 @@ Run 'vibe schema scene.<command>' for structured parameter info.`
       console.log();
       console.log(
         source_default.dim("Seed DESIGN.md:"),
-        source_default.cyan(`vibe scene init <dir> --visual-style "${style.name}"`)
+        source_default.cyan(`vibe init <dir> --visual-style "${style.name}"`)
       );
     });
     sceneCommand.command("add").description("Add a new scene to a project: AI narration + image + per-scene HTML").argument("<name>", "Scene name (slugified into the composition id)").option("--style <preset>", `Style preset: ${SCENE_PRESETS.join(", ")}`, "simple").option(
@@ -61218,7 +61251,7 @@ async function executeSceneRender(opts = {}) {
       kind: "render",
       beat: opts.beatId ?? null,
       root,
-      error: `Root composition not found: ${resolve66(projectDir, root)}. Run \`vibe scene init\` first.`
+      error: `Root composition not found: ${resolve66(projectDir, root)}. Run \`vibe build ${projectDir}\` once to create the render scaffold, or scaffold it up front with \`vibe init <dir> --profile full\`.`
     };
   }
   const chrome = await preflightChrome();
@@ -61709,7 +61742,7 @@ async function executeSceneBuild(opts) {
       phase: "failed",
       mode,
       selectedStage,
-      error: `STORYBOARD.md not found at ${storyboardPath2}. Run \`vibe scene init <dir>\` to create a starter, or add STORYBOARD.md with per-beat cues.`,
+      error: `STORYBOARD.md not found at ${storyboardPath2}. Run \`vibe init <dir>\` to create a starter, or add STORYBOARD.md with per-beat cues.`,
       beats: [],
       stageReports,
       warnings,
@@ -74249,7 +74282,7 @@ init_source();
 // package.json
 var package_default = {
   name: "@vibeframe/cli",
-  version: "0.113.29",
+  version: "0.113.30",
   description: "Frontier AI video generation for coding agents - Seedance, Runway, Veo, and Kling on your own keys, behind a hard cost cap",
   private: false,
   license: "MIT",
@@ -84605,35 +84638,17 @@ var planCommand = new Command("plan").description("Read STORYBOARD.md and show b
     return;
   }
   if (maxCost !== void 0 && plan.estimatedCostUsd > maxCost) {
-    const warning = `Estimated cost $${plan.estimatedCostUsd.toFixed(2)} exceeds --max-cost $${maxCost.toFixed(2)}.`;
-    const data = {
-      ...plan,
-      costCapUsd: maxCost,
-      code: "COST_CAP_EXCEEDED",
-      message: warning,
-      suggestion: "Raise --max-cost or reduce the stage/provider scope.",
-      recoverable: true,
-      retryWith: [
-        ...plan.retryWith,
-        `vibe plan ${projectDirArg} --stage ${stage} --skip-backdrop --json`,
-        `vibe build ${projectDirArg} --stage ${stage} --max-cost ${plan.estimatedCostUsd} --json`
-      ].filter((value, index, all) => value.length > 0 && all.indexOf(value) === index)
-    };
-    if (isJsonMode()) {
-      outputSuccess({
-        command: "plan",
-        startedAt,
-        data,
-        warnings: [warning]
-      });
-      process.exitCode = 1;
-      return;
-    }
     exitWithError(
-      usageError(
-        `Estimated cost $${plan.estimatedCostUsd.toFixed(2)} exceeds --max-cost $${maxCost.toFixed(2)}.`,
-        `Raise --max-cost or reduce the stage/provider scope.`
-      )
+      costCapError({
+        estimatedCostUsd: plan.estimatedCostUsd,
+        maxCostUsd: maxCost,
+        retryWith: [
+          ...plan.retryWith,
+          `vibe plan ${projectDirArg} --stage ${stage} --skip-backdrop --json`,
+          `vibe build ${projectDirArg} --stage ${stage} --max-cost ${plan.estimatedCostUsd} --json`
+        ].filter((value, index, all) => value.length > 0 && all.indexOf(value) === index),
+        data: { ...plan, costCapUsd: maxCost }
+      })
     );
   }
   if (isJsonMode()) {
@@ -84844,38 +84859,18 @@ Advanced equivalent: \`vibe scene build\`.`
       return;
     }
     if (maxCostUsd !== void 0 && plan.estimatedCostUsd > maxCostUsd) {
-      const warning = `Estimated cost $${plan.estimatedCostUsd.toFixed(2)} exceeds --max-cost $${maxCostUsd.toFixed(2)}.`;
-      const retryWith = unique6([
-        ...plan.retryWith,
-        `vibe build ${projectDirArg} --stage ${stage} --skip-backdrop --json`,
-        `vibe build ${projectDirArg} --stage ${stage} --max-cost ${plan.estimatedCostUsd} --json`
-      ]);
-      if (isJsonMode() || isQuietMode()) {
-        outputSuccess({
-          command: "build",
-          startedAt,
-          dryRun: true,
-          warnings: [warning],
-          data: {
-            params,
-            plan,
-            costCapUsd: maxCostUsd,
-            code: "COST_CAP_EXCEEDED",
-            message: warning,
-            suggestion: "Raise --max-cost or reduce the stage/provider scope.",
-            retryWith,
-            recoverable: true
-          }
-        });
-        process.exitCode = 1;
-        return;
-      }
-      console.log(source_default.red(warning));
-      if (retryWith.length > 0) {
-        console.log(source_default.dim(`Retry: ${retryWith[0]}`));
-      }
-      process.exitCode = 1;
-      return;
+      exitWithError(
+        costCapError({
+          estimatedCostUsd: plan.estimatedCostUsd,
+          maxCostUsd,
+          retryWith: unique6([
+            ...plan.retryWith,
+            `vibe build ${projectDirArg} --stage ${stage} --skip-backdrop --json`,
+            `vibe build ${projectDirArg} --stage ${stage} --max-cost ${plan.estimatedCostUsd} --json`
+          ]),
+          data: { params, plan, costCapUsd: maxCostUsd }
+        })
+      );
     }
     if (!isJsonMode() && !isQuietMode()) {
       printBuildDryRun(projectDirArg, params, plan);

package/dist/tools/manifest/index.js

@@ -24010,6 +24010,9 @@ function exitWithError(err) {
     if (err.suggestion) {
       console.error(source_default.dim(`  ${err.suggestion}`));
     }
+    if (err.retryWith && err.retryWith.length > 0) {
+      console.error(source_default.dim(`  Retry: ${err.retryWith[0]}`));
+    }
     console.error();
   }
   process.exit(err.exitCode);
@@ -26127,7 +26130,7 @@ ${avoid}
 ---
 
 _Browse other named styles: \`vibe scene list-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>"\`._`}
+${style ? `_This file was seeded by \`vibe init --visual-style "${style.name}"\`._` : `_Seed this file from a named style: \`vibe init <dir> --visual-style "<name>"\`._`}
 `;
 }
 function buildScriptMd(name, kind = DEFAULT_SCENE_KIND) {
@@ -26272,7 +26275,7 @@ Single-asset requests (\`vibe generate image|video|speech|...\`) do NOT
 consult this file - run the generate command directly.
 
 Browse named styles: \`vibe scene list-styles\`. Re-seed from one with
-\`vibe scene init . --visual-style "Swiss Pulse"\` (idempotent).
+\`vibe init . --visual-style "Swiss Pulse"\` (idempotent).
 
 ## Brief and local media
 
@@ -26427,9 +26430,21 @@ npx hyperframes render
 
 ## Key Rules (for hand-authored scene HTML)
 
+0. A scene file is a \`<template id="scene-<id>-template">\` wrapping ONE
+   composition div - not a standalone \`<!doctype html>\` document:
+   \`\`\`html
+   <template id="scene-hook-template">
+     <div data-composition-id="scene-hook" data-start="0" data-duration="3.3"
+          data-width="1920" data-height="1080">\u2026</div>
+   </template>
+   \`\`\`
+   The composition div **MUST** carry \`data-width\` and \`data-height\`.
 1. Every timed element needs \`data-start\`, \`data-duration\`, and \`data-track-index\`.
 2. Elements with timing **MUST** have \`class="clip"\` - the framework uses this for visibility control.
-3. Timelines must be paused and registered on \`window.__timelines\`:
+3. Timelines must be paused and registered on \`window.__timelines\`, which is an
+   OBJECT keyed by composition id - not an array, and \`.push()\` leaves the
+   timeline undiscovered, which renders a black frame because \`gsap.from\` holds
+   elements at their start state:
    \`\`\`js
    window.__timelines = window.__timelines || {};
    window.__timelines["composition-id"] = gsap.timeline({ paused: true });
@@ -30750,10 +30765,10 @@ async function getComposePrompts(opts) {
     error: msg
   });
   if (!existsSync8(designPath)) {
-    return baseError(`DESIGN.md not found at ${designPath}. Run \`vibe scene init <dir>\` first.`);
+    return baseError(`DESIGN.md not found at ${designPath}. Run \`vibe init <dir>\` first.`);
   }
   if (!existsSync8(storyboardPath)) {
-    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.`);
+    return baseError(`STORYBOARD.md not found at ${storyboardPath}. Run \`vibe init <dir>\` to create a starter, or add STORYBOARD.md with per-beat cues.`);
   }
   if (!hyperframesSkillAvailable(projectDir)) {
     warnings.push(
@@ -30833,7 +30848,9 @@ function buildInstructions(args) {
   if (args.skillRef) {
     lines.push(`1. Read \`${args.skillRef}\` for the Hyperframes framework rules + house style. This is the visual-identity hard-gate.`);
   } else {
-    lines.push(`1. Run \`vibe scene install-skill\` to install the Hyperframes composition rules, then read them.`);
+    lines.push(
+      `1. Read this project's \`AGENTS.md\` section "Key Rules (for hand-authored scene HTML)" - written by \`vibe init\`, and the authoritative local contract. \`vibe scene install-skill\` adds Hyperframes' house style on top, but note it installs a ROUTER whose full contract sits behind \`/hyperframes-core\`, which resolves only in a host that has upstream's Hyperframes skills.`
+    );
   }
   lines.push(`2. Read \`DESIGN.md\` for project-specific palette, typography, motion signature.`);
   if (args.compositionRef) {
@@ -30843,6 +30860,7 @@ function buildInstructions(args) {
   lines.push(`3b. Use each beat's \`finalDurationSec\` (narration-synced) for \`data-duration\` and timeline anchors when present \u2014 NOT the storyboard \`duration\`, which is only the minimum. Scenes composed at the storyboard duration end early and render black tails.`);
   lines.push(`3c. Never give inner \`.clip\` elements a non-zero \`data-start\` \u2014 the renderer does not toggle internal clip visibility inside sub-compositions, so phased clips render all phases at once (overlapping text). Use full-window clips and GSAP autoAlpha phase transitions instead. Also keep beats 6-15s; split anything longer in the storyboard first.`);
   lines.push(`3d. If your environment cannot write files (e.g. Claude Desktop / MCP-only hosts), author each beat's HTML and submit it with the \`scene_submit\` tool (beat id + html). It validates with the same Hyperframes lint and writes the file for you; on lint errors it returns the findings without writing \u2014 fix and resubmit.`);
+  lines.push(`3e. Hard requirements the linter fails on, so satisfy them even without the full contract. A scene file is a \`<template id="scene-<id>-template">\` wrapping ONE \`<div data-composition-id="scene-<id>" data-start="0" data-duration="<sec>" data-width="1920" data-height="1080">\` \u2014 not a standalone \`<!doctype html>\` document. Register the paused GSAP timeline on the registry OBJECT keyed by composition id: \`window.__timelines = window.__timelines || {}; window.__timelines["scene-<id>"] = tl;\` \u2014 it is not an array, and \`.push()\` leaves the timeline undiscovered, which renders a black frame because \`gsap.from\` holds elements at their start state. Also put \`class="clip"\` on every timed element and give timeline-visible elements a stable \`id\`. Generate a reference scene with \`vibe scene add <id> --style <preset> --no-audio --no-image\` and match its shape.`);
   if (args.beatCount > 1) {
     lines.push(`4. After authoring all ${args.beatCount} beat(s), run \`vibe build <project> --stage sync --json\` to assemble the root composition (index.html) from the fragments. Lint needs that root, so sync comes first.`);
   } else if (args.filtered) {
@@ -31941,7 +31959,7 @@ async function executeSceneRender(opts = {}) {
       kind: "render",
       beat: opts.beatId ?? null,
       root,
-      error: `Root composition not found: ${resolve20(projectDir, root)}. Run \`vibe scene init\` first.`
+      error: `Root composition not found: ${resolve20(projectDir, root)}. Run \`vibe build ${projectDir}\` once to create the render scaffold, or scaffold it up front with \`vibe init <dir> --profile full\`.`
     };
   }
   const chrome = await preflightChrome();
@@ -34189,7 +34207,7 @@ async function executeSceneBuild(opts) {
       phase: "failed",
       mode,
       selectedStage,
-      error: `STORYBOARD.md not found at ${storyboardPath}. Run \`vibe scene init <dir>\` to create a starter, or add STORYBOARD.md with per-beat cues.`,
+      error: `STORYBOARD.md not found at ${storyboardPath}. Run \`vibe init <dir>\` to create a starter, or add STORYBOARD.md with per-beat cues.`,
       beats: [],
       stageReports,
       warnings,
@@ -52976,7 +52994,7 @@ function insertClipIntoRoot(rootHtml, clip) {
   const closeMatch = rootHtml.match(/\n(\s*)<\/div>(\s*\n\s*<script>)/);
   if (!closeMatch) {
     throw new Error(
-      "Could not find root composition closing </div>. Ensure index.html follows the layout from `vibe scene init`."
+      "Could not find root composition closing </div>. Ensure index.html follows the layout from `vibe init`."
     );
   }
   const closeIdx = closeMatch.index;
@@ -53377,7 +53395,7 @@ sceneCommand.command("list-styles").description("List vendored visual styles (or
     console.log(source_default.dim("Show details: "), source_default.cyan('vibe scene list-styles "<name>"'));
     console.log(
       source_default.dim("Seed DESIGN.md:"),
-      source_default.cyan('vibe scene init <dir> --visual-style "<name>"')
+      source_default.cyan('vibe init <dir> --visual-style "<name>"')
     );
     return;
   }
@@ -53412,7 +53430,7 @@ sceneCommand.command("list-styles").description("List vendored visual styles (or
   console.log();
   console.log(
     source_default.dim("Seed DESIGN.md:"),
-    source_default.cyan(`vibe scene init <dir> --visual-style "${style.name}"`)
+    source_default.cyan(`vibe init <dir> --visual-style "${style.name}"`)
   );
 });
 sceneCommand.command("add").description("Add a new scene to a project: AI narration + image + per-scene HTML").argument("<name>", "Scene name (slugified into the composition id)").option("--style <preset>", `Style preset: ${SCENE_PRESETS.join(", ")}`, "simple").option(
@@ -53670,7 +53688,9 @@ async function executeSceneAdd(opts) {
     error
   });
   if (!await pathExists2(rootPath)) {
-    return errResult(`Root composition not found: ${rootPath}. Run \`vibe scene init\` first.`);
+    return errResult(
+      `Root composition not found: ${rootPath}. Run \`vibe build\` once to create the render scaffold, or scaffold it up front with \`vibe init <dir> --profile full\`.`
+    );
   }
   if (!opts.force && await pathExists2(scenePath)) {
     return errResult(`Scene already exists: ${sceneRel}. Re-run with --force to overwrite.`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibeframe/cli",
-  "version": "0.113.29",
+  "version": "0.113.30",
   "description": "Frontier AI video generation for coding agents - Seedance, Runway, Veo, and Kling on your own keys, behind a hard cost cap",
   "private": false,
   "license": "MIT",
@@ -91,8 +91,8 @@
     "tsx": "^4.21.0",
     "typescript": "^5.3.3",
     "vitest": "^1.2.2",
-    "@vibeframe/ai-providers": "0.113.29",
-    "@vibeframe/core": "0.113.29"
+    "@vibeframe/core": "0.113.30",
+    "@vibeframe/ai-providers": "0.113.30"
   },
   "engines": {
     "node": ">=20"