@vibeframe/cli 0.106.4 → 0.106.6

package/dist/tools/adapters/mcp.js

@@ -159,7 +159,11 @@ function buildMcpDispatcher(manifest) {
         workingDirectory: process.cwd(),
         surface: "mcp"
       });
-      const text = result.success ? JSON.stringify({ success: true, ...result.data }) : `${name} failed: ${result.error ?? "unknown error"}`;
+      const text = result.success ? JSON.stringify({ success: true, ...result.data }) : result.data ? JSON.stringify({
+        success: false,
+        error: result.error ?? "unknown error",
+        ...result.data
+      }) : `${name} failed: ${result.error ?? "unknown error"}`;
       return { content: [{ type: "text", text }] };
     } catch (error) {
       const msg = error instanceof Error ? error.message : String(error);

package/dist/tools/define-tool.js

@@ -9,6 +9,7 @@ var EXPLICIT_COMMAND_METADATA = {
   build: { surface: "public", note: "Primary storyboard-to-video build engine." },
   render: { surface: "public", note: "Project render entrypoint." },
   doctor: { surface: "public", note: "System and provider health check." },
+  host: { surface: "public", note: "Codex, Claude, and Cursor app integration setup." },
   guide: { surface: "public", note: "Workflow chooser and first-run guidance." },
   demo: { surface: "advanced", note: "Smoke-test/demo helper, not a core workflow." },
   run: { surface: "agent", note: "Automation surface for YAML pipelines." },

package/dist/tools/manifest/index.js

@@ -7733,6 +7733,18 @@ a host agent's built-in image/audio generation tool for VibeFrame project
 assets unless the user explicitly requests an external, non-VibeFrame
 asset.
 
+## App host setup
+
+VibeFrame is CLI-first, not terminal-only. Codex, Claude Code, and Cursor can
+drive this project through shell commands, and app hosts can use the MCP server
+as a typed tool surface.
+
+\`\`\`bash
+vibe host setup all         # print Codex/Claude/Cursor snippets
+vibe host setup all --write # write project/app config
+vibe host doctor all --json # verify readiness
+\`\`\`
+
 ## Skills \u2014 USE THESE FIRST
 
 @SKILL.md
@@ -50485,6 +50497,7 @@ var EXPLICIT_COMMAND_METADATA = {
   build: { surface: "public", note: "Primary storyboard-to-video build engine." },
   render: { surface: "public", note: "Project render entrypoint." },
   doctor: { surface: "public", note: "System and provider health check." },
+  host: { surface: "public", note: "Codex, Claude, and Cursor app integration setup." },
   guide: { surface: "public", note: "Workflow chooser and first-run guidance." },
   demo: { surface: "advanced", note: "Smoke-test/demo helper, not a core workflow." },
   run: { surface: "agent", note: "Automation surface for YAML pipelines." },
@@ -52307,6 +52320,8 @@ var SCENE_PRESETS2 = [
   "kinetic-type",
   "product-shot"
 ];
+var PROJECT_DIR_DESCRIPTION = "Project directory. Defaults to the surface's cwd; in MCP hosts, relative paths resolve under the configured server workspace.";
+var INIT_DIR_DESCRIPTION = "Project directory to create. Prefer a project name or workspace-relative path; in MCP hosts, relative paths resolve under the configured server workspace. Do not use /tmp or /home/claude unless the user explicitly asks.";
 var sceneStylesSchema = external_exports.object({
   name: external_exports.string().optional().describe("Style name or slug (e.g. 'Swiss Pulse', 'swiss-pulse'). Omit to list all 8.")
 });
@@ -52366,7 +52381,7 @@ var sceneStylesTool = defineTool({
   }
 });
 var sceneInitSchema = external_exports.object({
-  dir: external_exports.string().describe("Project directory (created if missing)."),
+  dir: external_exports.string().describe(INIT_DIR_DESCRIPTION),
   name: external_exports.string().optional().describe("Project name. Defaults to the directory basename."),
   aspect: external_exports.enum(["16:9", "9:16", "1:1", "4:5"]).optional().describe("Aspect ratio. Default 16:9."),
   duration: external_exports.number().optional().describe("Default root composition duration in seconds. Default 10.")
@@ -52413,7 +52428,7 @@ var sceneAddSchema = external_exports.object({
   visuals: external_exports.string().optional().describe("Image prompt \u2014 generates assets/scene-<id>.png via the configured image provider."),
   headline: external_exports.string().optional().describe("Visible headline text. Defaults to the humanised scene name."),
   kicker: external_exports.string().optional().describe("Small label above the headline (used by 'explainer' and 'product-shot' presets)."),
-  projectDir: external_exports.string().optional().describe("Project directory. Defaults to the surface's cwd."),
+  projectDir: external_exports.string().optional().describe(PROJECT_DIR_DESCRIPTION),
   insertInto: external_exports.string().optional().describe("Root composition file (relative to projectDir). Default 'index.html'."),
   imageProvider: external_exports.enum(["gemini", "openai"]).optional().describe("Image provider for visuals. Default 'gemini'."),
   voice: external_exports.string().optional().describe("ElevenLabs voice id or name."),
@@ -52474,7 +52489,7 @@ var sceneAddTool = defineTool({
   }
 });
 var sceneLintSchema = external_exports.object({
-  projectDir: external_exports.string().optional().describe("Project directory. Defaults to the surface's cwd."),
+  projectDir: external_exports.string().optional().describe(PROJECT_DIR_DESCRIPTION),
   root: external_exports.string().optional().describe("Root composition file relative to projectDir. Default 'index.html'."),
   fix: external_exports.boolean().optional().describe('Apply mechanical auto-fixes (currently: missing class="clip").')
 });
@@ -52532,7 +52547,7 @@ var sceneLintTool = defineTool({
   }
 });
 var sceneRepairSchema = external_exports.object({
-  projectDir: external_exports.string().optional().describe("Project directory. Defaults to the surface's cwd."),
+  projectDir: external_exports.string().optional().describe(PROJECT_DIR_DESCRIPTION),
   root: external_exports.string().optional().describe("Root composition file relative to projectDir. Default 'index.html'."),
   dryRun: external_exports.boolean().optional().describe("Preview deterministic repairs without writing files.")
 });
@@ -52561,7 +52576,7 @@ var sceneRepairTool = defineTool({
   }
 });
 var sceneRenderSchema = external_exports.object({
-  projectDir: external_exports.string().optional().describe("Project directory. Defaults to the surface's cwd."),
+  projectDir: external_exports.string().optional().describe(PROJECT_DIR_DESCRIPTION),
   root: external_exports.string().optional().describe("Root composition file relative to projectDir. Default 'index.html'."),
   beat: external_exports.string().optional().describe("Render only one storyboard beat using a temporary root."),
   output: external_exports.string().optional().describe("Output file path (relative paths resolve against projectDir)."),
@@ -52616,7 +52631,7 @@ var sceneRenderTool = defineTool({
 });
 var sceneBuildSchema = external_exports.object({
   projectDir: external_exports.string().optional().describe(
-    "Project directory containing STORYBOARD.md, DESIGN.md, index.html. Defaults to the surface's cwd."
+    "Project directory containing STORYBOARD.md, DESIGN.md, index.html. Defaults to the surface's cwd; in MCP hosts, relative paths resolve under the configured server workspace."
   ),
   stage: external_exports.enum(["assets", "compose", "sync", "render", "all"]).optional().describe("Build stage to run. Default all."),
   beat: external_exports.string().optional().describe("Restrict asset/compose work to one beat id."),
@@ -52731,7 +52746,7 @@ var sceneBuildTool = defineTool({
 });
 var sceneInstallSkillSchema = external_exports.object({
   projectDir: external_exports.string().describe(
-    "Project directory containing STORYBOARD.md / DESIGN.md. Required to keep cross-host calls explicit and prevent accidental installs in unintended cwd."
+    "Project directory containing STORYBOARD.md / DESIGN.md. Required to keep cross-host calls explicit; in MCP hosts, relative paths resolve under the configured server workspace."
   ),
   host: external_exports.enum(["claude-code", "cursor", "auto", "all"]).optional().describe(
     "Host layout target. 'auto' (default) detects installed agent hosts; 'all' writes every layout; 'claude-code' / 'cursor' force a single host. Codex / Aider read the universal SKILL.md via AGENTS.md so don't need a host-specific layout."
@@ -52781,7 +52796,7 @@ var sceneInstallSkillTool = defineTool({
 });
 var sceneComposePromptsSchema = external_exports.object({
   projectDir: external_exports.string().describe(
-    "Project directory containing STORYBOARD.md / DESIGN.md. Required to keep cross-host calls explicit."
+    "Project directory containing STORYBOARD.md / DESIGN.md. Required to keep cross-host calls explicit; in MCP hosts, relative paths resolve under the configured server workspace."
   ),
   beat: external_exports.string().optional().describe(
     "Restrict the plan to a single beat by id (e.g. 'hook', '1'). Omit to emit every beat in the storyboard."
@@ -55082,13 +55097,14 @@ function sanitizeFileSegment2(value) {
 }
 
 // src/tools/manifest/inspect.ts
+var PROJECT_DIR_DESCRIPTION2 = "Project directory. Defaults to the surface's cwd; in MCP hosts, relative paths resolve under the configured server workspace.";
 var inspectProjectTool = defineTool({
   name: "inspect_project",
   category: "analyze",
   cost: "free",
   description: "Local project inspection: checks STORYBOARD.md, DESIGN.md, config, build-report, scene lint, composition files, and referenced assets. Writes review-report.json by default.",
   schema: external_exports.object({
-    projectDir: external_exports.string().optional().describe("Project directory. Defaults to the surface's cwd."),
+    projectDir: external_exports.string().optional().describe(PROJECT_DIR_DESCRIPTION2),
     beat: external_exports.string().optional().describe("Inspect only one storyboard beat where beat-scoped checks apply."),
     outputPath: external_exports.string().optional().describe("Optional review report path. Defaults to <project>/review-report.json."),
     report: external_exports.boolean().optional().describe("Write review-report.json. Default true.")
@@ -55103,7 +55119,11 @@ var inspectProjectTool = defineTool({
     });
     return {
       success: result.status !== "fail",
-      data: result,
+      data: {
+        ...result,
+        workingDirectory: ctx.workingDirectory,
+        projectDir
+      },
       error: result.status === "fail" ? `${result.issues.filter((issue) => issue.severity === "error").length} project inspection error(s)` : void 0,
       humanLines: [
         `${result.status === "pass" ? "\u2705" : result.status === "warn" ? "\u26A0\uFE0F" : "\u274C"} Project inspection ${result.status} \u2014 score ${result.score}/100`,
@@ -55118,7 +55138,7 @@ var inspectRenderTool = defineTool({
   cost: "low",
   description: "Render inspection: runs cheap local video checks by default, optionally adds Gemini AI review with ai: true, and writes review-report.json by default.",
   schema: external_exports.object({
-    projectDir: external_exports.string().optional().describe("Project directory. Defaults to the surface's cwd."),
+    projectDir: external_exports.string().optional().describe(PROJECT_DIR_DESCRIPTION2),
     beat: external_exports.string().optional().describe("Inspect a render for one storyboard beat."),
     videoPath: external_exports.string().optional().describe("Rendered video path. Defaults to build-report outputPath or latest renders/* video."),
     outputPath: external_exports.string().optional().describe("Optional review report path. Defaults to <project>/review-report.json."),
@@ -55141,7 +55161,11 @@ var inspectRenderTool = defineTool({
       });
       return {
         success: true,
-        data: result2,
+        data: {
+          ...result2,
+          workingDirectory: ctx.workingDirectory,
+          projectDir
+        },
         humanLines: [
           `Render inspection dry-run \u2014 ${result2.videoPath ? "render found" : "render missing"}`,
           ...result2.reportPath ? [`report: ${result2.reportPath}`] : []
@@ -55159,7 +55183,11 @@ var inspectRenderTool = defineTool({
     });
     return {
       success: result.status !== "fail",
-      data: result,
+      data: {
+        ...result,
+        workingDirectory: ctx.workingDirectory,
+        projectDir
+      },
       error: result.status === "fail" ? `${result.issues.filter((issue) => issue.severity === "error").length} render inspection error(s)` : void 0,
       humanLines: [
         `${result.status === "pass" ? "\u2705" : result.status === "warn" ? "\u26A0\uFE0F" : "\u274C"} Render inspection ${result.status} \u2014 score ${result.score}/100`,
@@ -55535,7 +55563,7 @@ var generateBackgroundTool = defineTool({
   schema: external_exports.object({
     description: external_exports.string().describe("Background description / image prompt."),
     aspect: external_exports.enum(["16:9", "9:16", "1:1"]).optional().describe("Aspect ratio. Default '16:9'."),
-    output: external_exports.string().optional().describe("Output PNG path. Relative paths resolve against the surface's cwd.")
+    output: external_exports.string().optional().describe("Output PNG path. Relative paths resolve against the surface's cwd; in MCP hosts, that is the configured server workspace.")
   }),
   async execute(args) {
     const result = await executeBackground(args);
@@ -56072,8 +56100,9 @@ function stripUndefined3(value) {
 
 // src/tools/manifest/storyboard.ts
 init_build_plan();
+var PROJECT_DIR_DESCRIPTION3 = "Project directory. Defaults to the surface's cwd; in MCP hosts, relative paths resolve under the configured server workspace.";
 var projectDirSchema = external_exports.object({
-  projectDir: external_exports.string().optional().describe("Project directory. Defaults to the surface's cwd.")
+  projectDir: external_exports.string().optional().describe(PROJECT_DIR_DESCRIPTION3)
 });
 async function readStoryboard(projectDir) {
   const path2 = resolve52(projectDir, "STORYBOARD.md");
@@ -56142,7 +56171,7 @@ var storyboardGetTool = defineTool({
   cost: "free",
   description: "Return one STORYBOARD.md beat as structured data.",
   schema: external_exports.object({
-    projectDir: external_exports.string().optional().describe("Project directory. Defaults to the surface's cwd."),
+    projectDir: external_exports.string().optional().describe(PROJECT_DIR_DESCRIPTION3),
     beat: external_exports.string().describe("Beat id to return.")
   }),
   async execute(args, ctx) {
@@ -56164,7 +56193,7 @@ var storyboardSetTool = defineTool({
   cost: "free",
   description: "Set or unset one cue on one beat in STORYBOARD.md.",
   schema: external_exports.object({
-    projectDir: external_exports.string().optional().describe("Project directory. Defaults to the surface's cwd."),
+    projectDir: external_exports.string().optional().describe(PROJECT_DIR_DESCRIPTION3),
     beat: external_exports.string().describe("Beat id to mutate."),
     key: external_exports.string().describe("Cue key to set."),
     value: external_exports.string().optional().describe("Cue value. Required unless unset is true."),
@@ -56200,7 +56229,7 @@ var storyboardMoveTool = defineTool({
   cost: "free",
   description: "Move one beat after another beat in STORYBOARD.md.",
   schema: external_exports.object({
-    projectDir: external_exports.string().optional().describe("Project directory. Defaults to the surface's cwd."),
+    projectDir: external_exports.string().optional().describe(PROJECT_DIR_DESCRIPTION3),
     beat: external_exports.string().describe("Beat id to move."),
     after: external_exports.string().describe("Beat id that should precede the moved beat.")
   }),
@@ -56230,7 +56259,7 @@ var storyboardReviseTool = defineTool({
   cost: "low",
   description: "Revise an existing STORYBOARD.md from a natural-language request. Reads project context, validates the revised storyboard, and writes unless dryRun is true.",
   schema: external_exports.object({
-    projectDir: external_exports.string().optional().describe("Project directory. Defaults to the surface's cwd."),
+    projectDir: external_exports.string().optional().describe(PROJECT_DIR_DESCRIPTION3),
     request: external_exports.string().describe("Revision request, e.g. 'make the hook punchier and shorten to 30 seconds'."),
     durationSec: external_exports.number().optional().describe("Target total duration in seconds."),
     composer: external_exports.enum(["claude", "openai", "gemini"]).optional().describe("Revision LLM provider. Defaults to project config or available API keys."),
@@ -56261,7 +56290,7 @@ var planTool = defineTool({
   cost: "free",
   description: "Read STORYBOARD.md and return the build plan, missing artifacts, provider needs, and estimated cost.",
   schema: external_exports.object({
-    projectDir: external_exports.string().optional().describe("Project directory. Defaults to the surface's cwd."),
+    projectDir: external_exports.string().optional().describe(PROJECT_DIR_DESCRIPTION3),
     stage: external_exports.enum(["assets", "compose", "sync", "render", "all"]).optional().describe("Stage to plan. Default all."),
     beat: external_exports.string().optional().describe("Restrict the plan to one beat id."),
     mode: external_exports.enum(["agent", "batch", "auto"]).optional().describe("Build mode. Default auto."),
@@ -60821,6 +60850,7 @@ var guideTools = [guideTool];
 // src/tools/manifest/status.ts
 import { resolve as resolve62 } from "node:path";
 init_status_jobs();
+var PROJECT_DIR_DESCRIPTION4 = "Project directory. Defaults to the surface's cwd; in MCP hosts, relative paths resolve under the configured server workspace.";
 var statusJobTool = defineTool({
   name: "status_job",
   category: "status",
@@ -60828,7 +60858,7 @@ var statusJobTool = defineTool({
   description: "Read one local async job record and optionally refresh supported provider status. Supports Runway/Kling video and Replicate music live checks.",
   schema: external_exports.object({
     jobId: external_exports.string().describe("Local job id returned by a no-wait command."),
-    projectDir: external_exports.string().optional().describe("Project directory containing .vibeframe/jobs. Defaults to nearest project root."),
+    projectDir: external_exports.string().optional().describe("Project directory containing .vibeframe/jobs. Defaults to nearest project root; in MCP hosts, relative paths resolve under the configured server workspace."),
     refresh: external_exports.boolean().optional().describe("Call provider status APIs when supported. Default true."),
     wait: external_exports.boolean().optional().describe("Wait for completion when supported."),
     output: external_exports.string().optional().describe("Download result media to this path when complete.")
@@ -60862,7 +60892,7 @@ var statusProjectTool = defineTool({
   cost: "free",
   description: "Summarize build-report.json, review-report.json, and local async job records for a VibeFrame project.",
   schema: external_exports.object({
-    projectDir: external_exports.string().optional().describe("Project directory. Defaults to the surface's cwd."),
+    projectDir: external_exports.string().optional().describe(PROJECT_DIR_DESCRIPTION4),
     refresh: external_exports.boolean().optional().describe("Refresh active supported jobs before summarizing. Default false.")
   }),
   async execute(args, ctx) {
@@ -60870,7 +60900,11 @@ var statusProjectTool = defineTool({
     const result = await inspectProjectStatus(projectDir, { refresh: args.refresh === true });
     return {
       success: true,
-      data: result,
+      data: {
+        ...result,
+        workingDirectory: ctx.workingDirectory,
+        projectDir
+      },
       humanLines: [
         `Project status: ${result.status} (${result.currentStage}), ${result.jobs.active} active job(s), ${result.jobs.failed} failed job(s)`,
         ...result.build ? [`build: ${result.build.phase ?? "unknown"}`] : [],

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vibeframe/cli",
-  "version": "0.106.4",
-  "description": "VibeFrame CLI - natural language video editing from the terminal",
+  "version": "0.106.6",
+  "description": "VibeFrame CLI - agentic video workflow runtime",
   "private": false,
   "license": "MIT",
   "repository": {
@@ -83,8 +83,8 @@
     "tsx": "^4.21.0",
     "typescript": "^5.3.3",
     "vitest": "^1.2.2",
-    "@vibeframe/ai-providers": "0.106.4",
-    "@vibeframe/core": "0.106.4"
+    "@vibeframe/ai-providers": "0.106.6",
+    "@vibeframe/core": "0.106.6"
   },
   "engines": {
     "node": ">=20"