@vibeframe/mcp-server 0.113.29 → 0.113.30

package/dist/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, kind3 = 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 });
@@ -268804,10 +268819,10 @@ async function getComposePrompts(opts) {
     error: msg
   });
   if (!existsSync43(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 (!existsSync43(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(
@@ -268887,7 +268902,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) {
@@ -268897,6 +268914,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) {
@@ -269991,7 +270009,7 @@ async function executeSceneRender(opts = {}) {
       kind: "render",
       beat: opts.beatId ?? null,
       root: root2,
-      error: `Root composition not found: ${resolve33(projectDir, root2)}. Run \`vibe scene init\` first.`
+      error: `Root composition not found: ${resolve33(projectDir, root2)}. Run \`vibe build ${projectDir}\` once to create the render scaffold, or scaffold it up front with \`vibe init <dir> --profile full\`.`
     };
   }
   const chrome2 = await preflightChrome();
@@ -272241,7 +272259,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,
@@ -305086,7 +305104,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;
@@ -305487,7 +305505,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;
   }
@@ -305522,7 +305540,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(
@@ -305780,7 +305798,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.`);
@@ -316070,7 +316090,7 @@ function handleCliFlags(argv, version2) {
 }
 
 // src/index.ts
-if (handleCliFlags(process.argv.slice(2), "0.113.29")) {
+if (handleCliFlags(process.argv.slice(2), "0.113.30")) {
   process.exit(0);
 }
 console.log = (...args) => console.error(...args);
@@ -316083,7 +316103,7 @@ var server = new Server(
   {
     name: "vibeframe",
     // Stamped with the package version by build.js at bundle time.
-    version: "0.113.29"
+    version: "0.113.30"
   },
   {
     capabilities: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibeframe/mcp-server",
-  "version": "0.113.29",
+  "version": "0.113.30",
   "description": "VibeFrame MCP Server - frontier AI video generation for agents (Seedance, Runway, Veo, Kling) on your own keys, behind a hard cost cap",
   "type": "module",
   "bin": {
@@ -66,8 +66,8 @@
     "tsx": "^4.21.0",
     "typescript": "^5.3.3",
     "vitest": "^1.2.2",
-    "@vibeframe/cli": "0.113.29",
-    "@vibeframe/core": "0.113.29"
+    "@vibeframe/core": "0.113.30",
+    "@vibeframe/cli": "0.113.30"
   },
   "engines": {
     "node": ">=20"