@vibeframe/mcp-server 0.73.0 → 0.74.0

package/README.md

@@ -194,7 +194,7 @@ Tool names are MCP-side. Your host typically prefixes them (e.g. Claude shows th
 |------|-------------|
 | `walkthrough` | Cross-host guides for scene and pipeline workflows |
 
-> **CLI ↔ MCP sync**: `packages/mcp-server/src/tools/cli-sync.test.ts` is a vitest hook that fails CI when a CLI subcommand is added/removed/renamed without the matching MCP change. Open the test file to see the live mapping table — `null` rows mark CLI-only commands (e.g. `vibe audio voices`, `vibe project set`) that are intentionally not exposed via MCP.
+> **CLI ↔ MCP sync**: `packages/mcp-server/src/tools/cli-sync.test.ts` is a vitest hook that fails CI when a CLI subcommand is added/removed/renamed without the matching MCP change. Open the test file to see the live mapping table — `null` rows mark CLI-only commands (e.g. `vibe audio list-voices`, `vibe project set`) that are intentionally not exposed via MCP.
 
 ## Resources
 

package/dist/index.js

@@ -449755,8 +449755,10 @@ var output_exports = {};
 __export(output_exports, {
   COST_ESTIMATES: () => COST_ESTIMATES,
   ExitCode: () => ExitCode,
+  _resetDeprecationMemoryForTesting: () => _resetDeprecationMemoryForTesting,
   apiError: () => apiError,
   authError: () => authError,
+  emitDeprecationWarning: () => emitDeprecationWarning,
   exitWithError: () => exitWithError,
   generalError: () => generalError,
   isJsonMode: () => isJsonMode,
@@ -449901,6 +449903,19 @@ function suggestNext(tip) {
   Tip: ${tip}`));
   }
 }
+function emitDeprecationWarning(oldName, newName, removeIn) {
+  if (isJsonMode() || isQuietMode()) return;
+  if (!process.stderr.isTTY) return;
+  const key2 = `${oldName}\u2192${newName}`;
+  if (_seenDeprecations.has(key2)) return;
+  _seenDeprecations.add(key2);
+  process.stderr.write(
+    source_default.yellow(`[deprecated] '${oldName}' is deprecated; use '${newName}' instead. Alias will be removed in ${removeIn}.`) + "\n"
+  );
+}
+function _resetDeprecationMemoryForTesting() {
+  _seenDeprecations.clear();
+}
 function outputError(error, details) {
   if (isJsonMode()) {
     console.error(JSON.stringify({ success: false, error, ...details }, null, 2));
@@ -449908,7 +449923,7 @@ function outputError(error, details) {
     console.error(error);
   }
 }
-var ExitCode, PROVIDER_ERROR_HINTS, COST_ESTIMATES;
+var ExitCode, PROVIDER_ERROR_HINTS, COST_ESTIMATES, _seenDeprecations;
 var init_output = __esm({
   "../cli/src/commands/output.ts"() {
     "use strict";
@@ -449943,7 +449958,7 @@ var init_output = __esm({
       { pattern: /context_length_exceeded|maximum.*context.*length|token.*limit.*exceeded|prompt.*too.*long/i, suggestion: "Input exceeds the model's context window. Shorten the prompt, or use a model with larger context (run 'vibe schema <command>' for options).", retryable: false },
       { pattern: /model.*not.*found|invalid.*model|unknown.*model|model_not_found/i, suggestion: "The specified model is unavailable. Check 'vibe schema <command>' for valid model options.", retryable: false },
       // Provider-specific
-      { pattern: /voice.*not.*found|voice_not_found|invalid.*voice.?id/i, suggestion: "Voice ID not found. Run 'vibe audio voices' to list available voices, then pass --voice <id>.", retryable: false },
+      { pattern: /voice.*not.*found|voice_not_found|invalid.*voice.?id/i, suggestion: "Voice ID not found. Run 'vibe audio list-voices' to list available voices, then pass --voice <id>.", retryable: false },
       { pattern: /character.*(count|limit).*exceeded|invalid_character_count/i, suggestion: "Text exceeds the TTS provider's character limit. Shorten the text or split into chunks.", retryable: false },
       { pattern: /invalid.*aspect.*ratio|unsupported.*aspect.*ratio|unsupported.*resolution/i, suggestion: "This aspect ratio or resolution isn't supported by the chosen model. Check 'vibe schema <command>' for supported values.", retryable: false },
       { pattern: /invalid.*file.*format|unsupported.*(format|codec)|unsupported.*media.?type/i, suggestion: "Input file format not supported. Convert to MP4/MP3/PNG first with 'vibe export' or 'ffmpeg'.", retryable: false },
@@ -449994,6 +450009,7 @@ var init_output = __esm({
       // pre-flight). Range covers a 1-beat preview to a 10-beat long-form.
       "compose scenes with skills": { min: 0.05, max: 1.5, unit: "per pipeline" }
     };
+    _seenDeprecations = /* @__PURE__ */ new Set();
   }
 });
 
@@ -462021,10 +462037,8 @@ function formatSceneInitProfile(profile) {
   if (profile === "agent") return "authoring files plus local composition rules for host agents";
   return "complete authoring, agent, and render scaffold";
 }
-var sceneCommand = new Command("scene").description("Advanced scene commands for VibeFrame video projects").addHelpText("after", `
+var sceneCommand = new Command("scene").description("Lower-level scene authoring (add, lint, styles). For project flow use `vibe init` / `vibe build` / `vibe render`.").addHelpText("after", `
 Examples:
-  $ vibe scene init my-video                              # Scaffold a new project
-  $ vibe scene init my-video -r 9:16 -d 30                # Vertical 30s project
   $ vibe scene add intro --style announcement \\
       --headline "Welcome to VibeFrame"                   # Headline-only scene
   $ vibe scene add overview --narration "VibeFrame turns scripts into video." \\
@@ -462032,14 +462046,13 @@ Examples:
   $ vibe scene lint                                       # Validate every scene against composition rules
   $ vibe scene lint --fix                                 # Auto-fix mechanical issues (e.g. missing class="clip")
   $ vibe scene lint --json                                # Structured output for agent loops
-  $ vibe scene render                                     # Render to renders/<name>-<timestamp>.mp4
-  $ vibe scene render -o demo.mp4 --quality high          # Custom output path + quality
-  $ vibe scene render --fps 60 --format webm              # 60fps WebM render
+  $ vibe scene styles                                     # Browse seed visual styles for DESIGN.md
 
-Most users can start with \`vibe init\`, \`vibe build\`, and \`vibe render\`.
-This namespace exposes lower-level scene authoring and rendering controls.
+For the project flow (init / build / render), use the top-level commands.
+The \`scene init\`, \`scene build\`, and \`scene render\` legacy aliases
+are still callable but hidden from this help \u2014 they will be removed in v1.0.
 Run 'vibe schema scene.<command>' for structured parameter info.`);
-sceneCommand.command("init").description("Scaffold a new scene project (or safely augment an existing 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) => {
+sceneCommand.command("init", { hidden: true }).description("Scaffold a new scene project (or safely augment an existing project) [legacy \u2014 prefer `vibe init`]").argument("<dir>", "Project directory (created if it doesn't exist)").option("-n, --name <name>", "Project name (defaults to directory basename)").option("-r, --ratio <ratio>", "Aspect ratio: 16:9, 9:16, 1:1, 4:5", "16:9").option("-d, --duration <sec>", "Default root composition duration (seconds)", "10").option("--visual-style <name>", `Seed DESIGN.md from a named style (browse via \`vibe scene styles\`). E.g. "Swiss Pulse"`).option("--profile <profile>", "Scene profile: minimal (storyboard/design only), agent (recommended), full (render scaffold upfront)", "agent").option("--dry-run", "Preview parameters without writing files").action(async (dir, options) => {
   const startedAt = Date.now();
   const aspect = validateAspect(options.ratio);
   const duration = validateDuration(options.duration);
@@ -462810,7 +462823,7 @@ function validateWorkers(value) {
   }
   return n;
 }
-sceneCommand.command("render").description("Render a scene project to MP4/WebM/MOV via the Hyperframes producer (requires Chrome)").argument("[root]", "Root composition file relative to --project", "index.html").option("--project <dir>", "Project directory", ".").option("-o, --out <path>", "Output file (default: renders/<name>-<timestamp>.<format>)").option("--fps <n>", `Frames per second: ${VALID_FPS.join("|")}`, "30").option("--quality <q>", `Quality preset: ${VALID_QUALITIES.join("|")}`, "standard").option("--format <f>", `Output container: ${VALID_FORMATS.join("|")}`, "mp4").option("--workers <n>", "Capture workers (1-16, default 1)", "1").option("--dry-run", "Preview parameters without rendering").action(async (root2, options) => {
+sceneCommand.command("render", { hidden: true }).description("Render a scene project to MP4/WebM/MOV via the Hyperframes producer (requires Chrome) [legacy \u2014 prefer `vibe render`]").argument("[root]", "Root composition file relative to --project", "index.html").option("--project <dir>", "Project directory", ".").option("-o, --out <path>", "Output file (default: renders/<name>-<timestamp>.<format>)").option("--fps <n>", `Frames per second: ${VALID_FPS.join("|")}`, "30").option("--quality <q>", `Quality preset: ${VALID_QUALITIES.join("|")}`, "standard").option("--format <f>", `Output container: ${VALID_FORMATS.join("|")}`, "mp4").option("--workers <n>", "Capture workers (1-16, default 1)", "1").option("--dry-run", "Preview parameters without rendering").action(async (root2, options) => {
   const startedAt = Date.now();
   const fps = validateFps(options.fps);
   const quality = validateQuality(options.quality);
@@ -462886,7 +462899,7 @@ sceneCommand.command("render").description("Render a scene project to MP4/WebM/M
     }
   }
 });
-sceneCommand.command("build").description("One-shot: read STORYBOARD.md cues, dispatch TTS + image-gen per beat, compose, render to MP4 (v0.60)").argument("[project-dir]", "Project directory containing STORYBOARD.md", ".").option("--mode <mode>", "Build mode: agent (host-agent authors HTML) | batch (CLI's internal LLM authors HTML) | auto (agent if any host detected) [Plan H \u2014 Phase 3]", "auto").option("--effort <level>", "Compose effort tier (batch mode only): low|medium|high", "medium").option("--composer <provider>", "LLM that composes scene HTML in batch mode: claude|openai|gemini (default: auto-resolve from available API keys, claude > gemini > openai)").option("--skip-narration", "Don't dispatch TTS even when beats declare narration cues").option("--skip-backdrop", "Don't dispatch image-gen even when beats declare backdrop cues").option("--skip-render", "Compose only \u2014 don't render to MP4").option("--tts <provider>", "TTS provider: auto|elevenlabs|kokoro (overrides frontmatter)").option("--voice <id>", "Voice id (provider-specific \u2014 overrides frontmatter)").option("--image-provider <name>", "Image provider: openai (only one supported in v0.60)").option("--quality <q>", "Image quality: standard|hd", "hd").option("--image-size <s>", "Image size: 1024x1024|1536x1024|1024x1536", "1536x1024").option("--force", "Re-dispatch primitives even when assets already exist").option("--dry-run", "Preview parameters without dispatching").action(async (projectDirArg, options) => {
+sceneCommand.command("build", { hidden: true }).description("One-shot: read STORYBOARD.md cues, dispatch TTS + image-gen per beat, compose, render to MP4 [legacy \u2014 prefer `vibe build`]").argument("[project-dir]", "Project directory containing STORYBOARD.md", ".").option("--mode <mode>", "Build mode: agent (host-agent authors HTML) | batch (CLI's internal LLM authors HTML) | auto (agent if any host detected) [Plan H \u2014 Phase 3]", "auto").option("--effort <level>", "Compose effort tier (batch mode only): low|medium|high", "medium").option("--composer <provider>", "LLM that composes scene HTML in batch mode: claude|openai|gemini (default: auto-resolve from available API keys, claude > gemini > openai)").option("--skip-narration", "Don't dispatch TTS even when beats declare narration cues").option("--skip-backdrop", "Don't dispatch image-gen even when beats declare backdrop cues").option("--skip-render", "Compose only \u2014 don't render to MP4").option("--tts <provider>", "TTS provider: auto|elevenlabs|kokoro (overrides frontmatter)").option("--voice <id>", "Voice id (provider-specific \u2014 overrides frontmatter)").option("--image-provider <name>", "Image provider: openai (only one supported in v0.60)").option("--quality <q>", "Image quality: standard|hd", "hd").option("--image-size <s>", "Image size: 1024x1024|1536x1024|1024x1536", "1536x1024").option("--force", "Re-dispatch primitives even when assets already exist").option("--dry-run", "Preview parameters without dispatching").action(async (projectDirArg, options) => {
   const startedAt = Date.now();
   const projectDir = resolve21(projectDirArg);
   if (options.dryRun) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibeframe/mcp-server",
-  "version": "0.73.0",
+  "version": "0.74.0",
   "description": "VibeFrame MCP Server - AI-native video editing via Model Context Protocol",
   "type": "module",
   "bin": {
@@ -57,8 +57,8 @@
     "tsx": "^4.21.0",
     "typescript": "^5.3.3",
     "vitest": "^1.2.2",
-    "@vibeframe/cli": "0.73.0",
-    "@vibeframe/core": "0.73.0"
+    "@vibeframe/core": "0.74.0",
+    "@vibeframe/cli": "0.74.0"
   },
   "engines": {
     "node": ">=20"