@vibeframe/cli 0.106.4 → 0.106.6

package/dist/index.js

@@ -7844,7 +7844,7 @@ function errorMessage(error) {
   return error instanceof Error ? error.message : "Unknown error";
 }
 function sleep(ms) {
-  return new Promise((resolve81) => setTimeout(resolve81, ms));
+  return new Promise((resolve83) => setTimeout(resolve83, ms));
 }
 var ProviderHttpError;
 var init_http = __esm({
@@ -12238,7 +12238,7 @@ var init_RunwayProvider = __esm({
        * Sleep helper
        */
       sleep(ms) {
-        return new Promise((resolve81) => setTimeout(resolve81, ms));
+        return new Promise((resolve83) => setTimeout(resolve83, ms));
       }
     };
     RunwayProvider.API_VERSION = "2024-11-06";
@@ -12679,7 +12679,7 @@ var init_KlingProvider = __esm({
        * Sleep helper
        */
       sleep(ms) {
-        return new Promise((resolve81) => setTimeout(resolve81, ms));
+        return new Promise((resolve83) => setTimeout(resolve83, ms));
       }
     };
     klingProvider = new KlingProvider();
@@ -12997,7 +12997,7 @@ var init_GrokProvider = __esm({
         }
       }
       sleep(ms) {
-        return new Promise((resolve81) => setTimeout(resolve81, ms));
+        return new Promise((resolve83) => setTimeout(resolve83, ms));
       }
     };
     grokProvider = new GrokProvider();
@@ -13032,11 +13032,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(resolve81) {
-          resolve81(value);
+        return value instanceof P ? value : new P(function(resolve83) {
+          resolve83(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve81, reject) {
+      return new (P || (P = Promise))(function(resolve83, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -13052,7 +13052,7 @@ var require_middleware = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve81(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve83(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -13137,11 +13137,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(resolve81) {
-          resolve81(value);
+        return value instanceof P ? value : new P(function(resolve83) {
+          resolve83(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve81, reject) {
+      return new (P || (P = Promise))(function(resolve83, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -13157,7 +13157,7 @@ var require_response = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve81(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve83(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -13264,11 +13264,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(resolve81) {
-          resolve81(value);
+        return value instanceof P ? value : new P(function(resolve83) {
+          resolve83(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve81, reject) {
+      return new (P || (P = Promise))(function(resolve83, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -13284,7 +13284,7 @@ var require_utils = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve81(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve83(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -13377,7 +13377,7 @@ var require_utils = __commonJS({
     }
     function sleep4(ms) {
       return __awaiter(this, void 0, void 0, function* () {
-        return new Promise((resolve81) => setTimeout(resolve81, ms));
+        return new Promise((resolve83) => setTimeout(resolve83, ms));
       });
     }
   }
@@ -13389,11 +13389,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(resolve81) {
-          resolve81(value);
+        return value instanceof P ? value : new P(function(resolve83) {
+          resolve83(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve81, reject) {
+      return new (P || (P = Promise))(function(resolve83, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -13409,7 +13409,7 @@ var require_retry = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve81(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve83(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -13616,11 +13616,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(resolve81) {
-          resolve81(value);
+        return value instanceof P ? value : new P(function(resolve83) {
+          resolve83(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve81, reject) {
+      return new (P || (P = Promise))(function(resolve83, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -13636,7 +13636,7 @@ var require_request = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve81(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve83(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -13723,11 +13723,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(resolve81) {
-          resolve81(value);
+        return value instanceof P ? value : new P(function(resolve83) {
+          resolve83(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve81, reject) {
+      return new (P || (P = Promise))(function(resolve83, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -13743,7 +13743,7 @@ var require_storage = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve81(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve83(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -14071,11 +14071,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(resolve81) {
-          resolve81(value);
+        return value instanceof P ? value : new P(function(resolve83) {
+          resolve83(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve81, reject) {
+      return new (P || (P = Promise))(function(resolve83, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -14091,7 +14091,7 @@ var require_auth = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve81(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve83(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -14130,11 +14130,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(resolve81) {
-          resolve81(value);
+        return value instanceof P ? value : new P(function(resolve83) {
+          resolve83(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve81, reject) {
+      return new (P || (P = Promise))(function(resolve83, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -14150,7 +14150,7 @@ var require_streaming = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve81(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve83(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -14383,7 +14383,7 @@ var require_streaming = __commonJS({
           query: options.queryParams
         });
         this.options = options;
-        this.donePromise = new Promise((resolve81, reject) => {
+        this.donePromise = new Promise((resolve83, reject) => {
           if (this.streamClosed) {
             reject(new response_1.ApiError({
               message: "Streaming connection is already closed.",
@@ -14394,11 +14394,11 @@ var require_streaming = __commonJS({
           }
           this.signal.addEventListener("abort", () => {
             var _a2;
-            resolve81((_a2 = this.currentData) !== null && _a2 !== void 0 ? _a2 : {});
+            resolve83((_a2 = this.currentData) !== null && _a2 !== void 0 ? _a2 : {});
           });
           this.on("done", (data) => {
             this.streamClosed = true;
-            resolve81(data);
+            resolve83(data);
           });
           this.on("error", (error) => {
             this.streamClosed = true;
@@ -14423,7 +14423,7 @@ var require_streaming = __commonJS({
             if (data) {
               yield yield __await(data);
             }
-            yield __await(new Promise((resolve81) => setTimeout(resolve81, 16)));
+            yield __await(new Promise((resolve83) => setTimeout(resolve83, 16)));
           }
         });
       }
@@ -14468,11 +14468,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(resolve81) {
-          resolve81(value);
+        return value instanceof P ? value : new P(function(resolve83) {
+          resolve83(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve81, reject) {
+      return new (P || (P = Promise))(function(resolve83, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -14488,7 +14488,7 @@ var require_queue = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve81(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve83(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -14623,7 +14623,7 @@ var require_queue = __commonJS({
               }
               return doneStatus;
             }
-            return new Promise((resolve81, reject) => {
+            return new Promise((resolve83, 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;
@@ -14655,7 +14655,7 @@ var require_queue = __commonJS({
                   }
                   if (requestStatus.status === "COMPLETED") {
                     clearScheduledTasks();
-                    resolve81(requestStatus);
+                    resolve83(requestStatus);
                     return;
                   }
                   pollingTimeoutId = setTimeout(poll, pollInterval);
@@ -16616,11 +16616,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(resolve81) {
-          resolve81(value);
+        return value instanceof P ? value : new P(function(resolve83) {
+          resolve83(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve81, reject) {
+      return new (P || (P = Promise))(function(resolve83, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -16636,7 +16636,7 @@ var require_realtime = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve81(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve83(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -16961,11 +16961,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(resolve81) {
-          resolve81(value);
+        return value instanceof P ? value : new P(function(resolve83) {
+          resolve83(value);
         });
       }
-      return new (P || (P = Promise))(function(resolve81, reject) {
+      return new (P || (P = Promise))(function(resolve83, reject) {
         function fulfilled(value) {
           try {
             step(generator.next(value));
@@ -16981,7 +16981,7 @@ var require_client = __commonJS({
           }
         }
         function step(result) {
-          result.done ? resolve81(result.value) : adopt(result.value).then(fulfilled, rejected);
+          result.done ? resolve83(result.value) : adopt(result.value).then(fulfilled, rejected);
         }
         step((generator = generator.apply(thisArg, _arguments || [])).next());
       });
@@ -17666,7 +17666,7 @@ var init_ReplicateProvider = __esm({
        * Sleep helper
        */
       sleep(ms) {
-        return new Promise((resolve81) => setTimeout(resolve81, ms));
+        return new Promise((resolve83) => setTimeout(resolve83, ms));
       }
       /**
        * Generate music from text prompt using MusicGen
@@ -21601,7 +21601,7 @@ var require_timestamp2 = __commonJS({
       resolve: (str) => parseSexagesimal(str, false),
       stringify: stringifySexagesimal
     };
-    var timestamp = {
+    var timestamp2 = {
       identify: (value) => value instanceof Date,
       default: true,
       tag: "tag:yaml.org,2002:timestamp",
@@ -21610,7 +21610,7 @@ var require_timestamp2 = __commonJS({
       // assumed to be 00:00:00Z (start of day, UTC).
       test: RegExp("^([0-9]{4})-([0-9]{1,2})-([0-9]{1,2})(?:(?:t|T|[ \\t]+)([0-9]{1,2}):([0-9]{1,2}):([0-9]{1,2}(\\.[0-9]+)?)(?:[ \\t]*(Z|[-+][012]?[0-9](?::[0-9]{2})?))?)?$"),
       resolve(str) {
-        const match = str.match(timestamp.test);
+        const match = str.match(timestamp2.test);
         if (!match)
           throw new Error("!!timestamp expects a date, starting with yyyy-mm-dd");
         const [, year, month, day, hour, minute, second] = match.map(Number);
@@ -21629,7 +21629,7 @@ var require_timestamp2 = __commonJS({
     };
     exports.floatTime = floatTime;
     exports.intTime = intTime;
-    exports.timestamp = timestamp;
+    exports.timestamp = timestamp2;
   }
 });
 
@@ -21649,7 +21649,7 @@ var require_schema3 = __commonJS({
     var omap = require_omap();
     var pairs = require_pairs();
     var set = require_set();
-    var timestamp = require_timestamp2();
+    var timestamp2 = require_timestamp2();
     var schema = [
       map.map,
       seq.seq,
@@ -21669,9 +21669,9 @@ var require_schema3 = __commonJS({
       omap.omap,
       pairs.pairs,
       set.set,
-      timestamp.intTime,
-      timestamp.floatTime,
-      timestamp.timestamp
+      timestamp2.intTime,
+      timestamp2.floatTime,
+      timestamp2.timestamp
     ];
     exports.schema = schema;
   }
@@ -21696,7 +21696,7 @@ var require_tags = __commonJS({
     var pairs = require_pairs();
     var schema$2 = require_schema3();
     var set = require_set();
-    var timestamp = require_timestamp2();
+    var timestamp2 = require_timestamp2();
     var schemas = /* @__PURE__ */ new Map([
       ["core", schema.schema],
       ["failsafe", [map.map, seq.seq, string.string]],
@@ -21710,11 +21710,11 @@ var require_tags = __commonJS({
       float: float.float,
       floatExp: float.floatExp,
       floatNaN: float.floatNaN,
-      floatTime: timestamp.floatTime,
+      floatTime: timestamp2.floatTime,
       int: int.int,
       intHex: int.intHex,
       intOct: int.intOct,
-      intTime: timestamp.intTime,
+      intTime: timestamp2.intTime,
       map: map.map,
       merge: merge.merge,
       null: _null.nullTag,
@@ -21722,7 +21722,7 @@ var require_tags = __commonJS({
       pairs: pairs.pairs,
       seq: seq.seq,
       set: set.set,
-      timestamp: timestamp.timestamp
+      timestamp: timestamp2.timestamp
     };
     var coreKnownTags = {
       "tag:yaml.org,2002:binary": binary.binary,
@@ -21730,7 +21730,7 @@ var require_tags = __commonJS({
       "tag:yaml.org,2002:omap": omap.omap,
       "tag:yaml.org,2002:pairs": pairs.pairs,
       "tag:yaml.org,2002:set": set.set,
-      "tag:yaml.org,2002:timestamp": timestamp.timestamp
+      "tag:yaml.org,2002:timestamp": timestamp2.timestamp
     };
     function getTags(customTags, schemaName, addMergeTag) {
       const schemaTags = schemas.get(schemaName);
@@ -26132,7 +26132,7 @@ async function prompt(question, hidden = false) {
     input: process.stdin,
     output: process.stdout
   });
-  return new Promise((resolve81) => {
+  return new Promise((resolve83) => {
     if (hidden && process.stdin.isTTY) {
       process.stdout.write(question);
       let input = "";
@@ -26146,7 +26146,7 @@ async function prompt(question, hidden = false) {
           process.stdin.removeListener("data", onData);
           process.stdout.write("\n");
           rl.close();
-          resolve81(input);
+          resolve83(input);
         } else if (char === "") {
           process.exit(1);
         } else if (char === "\x7F" || char === "\b") {
@@ -26161,7 +26161,7 @@ async function prompt(question, hidden = false) {
     } else {
       rl.question(question, (answer) => {
         rl.close();
-        resolve81(answer);
+        resolve83(answer);
       });
     }
   });
@@ -26758,6 +26758,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
@@ -33269,16 +33281,16 @@ async function prompt2(question) {
     input,
     output: process.stdout
   });
-  return new Promise((resolve81) => {
+  return new Promise((resolve83) => {
     rl.question(question, (answer) => {
       rl.close();
-      resolve81(answer);
+      resolve83(answer);
     });
   });
 }
 async function promptHidden(question, opts = {}) {
   const input = getTTYInputStream();
-  return new Promise((resolve81) => {
+  return new Promise((resolve83) => {
     let value = "";
     if (typeof input.setRawMode === "function") {
       input.setRawMode(true);
@@ -33292,7 +33304,7 @@ async function promptHidden(question, opts = {}) {
           input.setRawMode(false);
           input.removeListener("data", onData);
           process.stdout.write("\n");
-          resolve81(value);
+          resolve83(value);
         } else if (char === "") {
           input.setRawMode(false);
           process.stdout.write("\n");
@@ -33318,7 +33330,7 @@ async function promptHidden(question, opts = {}) {
       const rl = createInterface2({ input, output: process.stdout });
       rl.question(question, (answer) => {
         rl.close();
-        resolve81(answer);
+        resolve83(answer);
       });
     }
   });
@@ -33326,7 +33338,7 @@ async function promptHidden(question, opts = {}) {
 async function promptSelect(_question, options, defaultIndex = 0, opts = {}) {
   const input = getTTYInputStream();
   if (typeof input.setRawMode === "function") {
-    return new Promise((resolve81) => {
+    return new Promise((resolve83) => {
       let selected = defaultIndex;
       const render = () => {
         if (renderCount > 0) {
@@ -33354,7 +33366,7 @@ async function promptSelect(_question, options, defaultIndex = 0, opts = {}) {
           input.setRawMode(false);
           input.removeListener("data", onData);
           process.stdout.write("\n");
-          resolve81(selected);
+          resolve83(selected);
         } else if (char === "") {
           input.setRawMode(false);
           process.stdout.write("\n");
@@ -33364,7 +33376,7 @@ async function promptSelect(_question, options, defaultIndex = 0, opts = {}) {
           input.setRawMode(false);
           input.removeListener("data", onData);
           process.stdout.write("\n");
-          resolve81(opts.backIndex);
+          resolve83(opts.backIndex);
         } else if (char === "\x1B[A" || char === "k") {
           selected = (selected - 1 + options.length) % options.length;
           render();
@@ -33378,7 +33390,7 @@ async function promptSelect(_question, options, defaultIndex = 0, opts = {}) {
           input.removeListener("data", onData);
           render();
           process.stdout.write("\n");
-          resolve81(selected);
+          resolve83(selected);
         }
       };
       const onData = (chunk) => {
@@ -33402,7 +33414,7 @@ async function promptSelect(_question, options, defaultIndex = 0, opts = {}) {
 async function promptConfirm(question, defaultYes = true) {
   const input = getTTYInputStream();
   if (typeof input.setRawMode === "function") {
-    return new Promise((resolve81) => {
+    return new Promise((resolve83) => {
       const options = ["Yes", "No"];
       let selected = defaultYes ? 0 : 1;
       let renderCount = 0;
@@ -33432,7 +33444,7 @@ async function promptConfirm(question, defaultYes = true) {
           finished = true;
           input.setRawMode(false);
           input.removeListener("data", onData);
-          resolve81(selected === 0);
+          resolve83(selected === 0);
         } else if (char === "") {
           input.setRawMode(false);
           process.stdout.write("\n");
@@ -33446,14 +33458,14 @@ async function promptConfirm(question, defaultYes = true) {
           input.setRawMode(false);
           input.removeListener("data", onData);
           render();
-          resolve81(true);
+          resolve83(true);
         } else if (char === "n" || char === "N") {
           selected = 1;
           finished = true;
           input.setRawMode(false);
           input.removeListener("data", onData);
           render();
-          resolve81(false);
+          resolve83(false);
         }
       };
       const onData = (chunk) => {
@@ -33472,7 +33484,7 @@ async function promptMultiSelect(_question, options, defaultSelected = [], opts
   const input = getTTYInputStream();
   const selected = options.map((_, i) => Boolean(defaultSelected[i]));
   if (typeof input.setRawMode === "function") {
-    return new Promise((resolve81) => {
+    return new Promise((resolve83) => {
       let cursor = 0;
       let renderCount = 0;
       let userToggled = false;
@@ -33502,7 +33514,7 @@ async function promptMultiSelect(_question, options, defaultSelected = [], opts
         for (let i = 0; i < selected.length; i++) {
           if (selected[i]) result.push(i);
         }
-        resolve81(result);
+        resolve83(result);
       };
       let finished = false;
       const handleChar = (char) => {
@@ -33816,7 +33828,7 @@ var init_speech = __esm({
 import { writeFile as writeFile19, unlink, rename } from "node:fs/promises";
 import { resolve as resolve22, basename as basename4 } from "node:path";
 function sleep2(ms) {
-  return new Promise((resolve81) => setTimeout(resolve81, ms));
+  return new Promise((resolve83) => setTimeout(resolve83, ms));
 }
 async function uploadToImgbb(imageBuffer, apiKey) {
   try {
@@ -35506,7 +35518,7 @@ function unique(items) {
   ];
 }
 function sleep3(ms) {
-  return new Promise((resolve81) => setTimeout(resolve81, ms));
+  return new Promise((resolve83) => setTimeout(resolve83, ms));
 }
 var init_status_jobs = __esm({
   "src/commands/_shared/status-jobs.ts"() {
@@ -36015,20 +36027,20 @@ async function executeThumbnailBestFrame(options) {
     if (!jsonMatch) {
       return { success: false, error: `Could not parse timestamp from Gemini response: ${result.response.slice(0, 200)}` };
     }
-    const timestamp = parseFloat(jsonMatch[1]);
+    const timestamp2 = parseFloat(jsonMatch[1]);
     let reason;
     const reasonMatch = result.response.match(/"reason"\s*:\s*"([^"]+)"/);
     if (reasonMatch) {
       reason = reasonMatch[1];
     }
-    await execSafe("ffmpeg", ["-ss", String(timestamp), "-i", videoPath, "-frames:v", "1", "-q:v", "2", outputPath, "-y"], { timeout: 6e4, maxBuffer: 50 * 1024 * 1024 });
+    await execSafe("ffmpeg", ["-ss", String(timestamp2), "-i", videoPath, "-frames:v", "1", "-q:v", "2", outputPath, "-y"], { timeout: 6e4, maxBuffer: 50 * 1024 * 1024 });
     if (!existsSync16(outputPath)) {
       return { success: false, error: "FFmpeg failed to extract frame" };
     }
     return {
       success: true,
       outputPath,
-      timestamp,
+      timestamp: timestamp2,
       reason
     };
   } catch (error) {
@@ -39557,8 +39569,8 @@ function parseSRT(content) {
   }
   return segments;
 }
-function parseSRTTimestamp(timestamp) {
-  const normalized = timestamp.replace(",", ".");
+function parseSRTTimestamp(timestamp2) {
+  const normalized = timestamp2.replace(",", ".");
   const parts = normalized.split(":");
   const hours = parseInt(parts[0], 10);
   const mins = parseInt(parts[1], 10);
@@ -47096,6 +47108,7 @@ var init_product_surface = __esm({
       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." },
@@ -50855,11 +50868,11 @@ var init_FrameParser = __esm({
               const nullStr = _FrameParser.readNullTerminatedString(uint8Array, syltHeader.encoding);
               uint8Array = uint8Array.subarray(nullStr.len);
               if (readSyllables) {
-                const timestamp = UINT32_BE.get(uint8Array, 0);
+                const timestamp2 = UINT32_BE.get(uint8Array, 0);
                 uint8Array = uint8Array.subarray(UINT32_BE.len);
                 result.syncText.push({
                   text: nullStr.text,
-                  timestamp
+                  timestamp: timestamp2
                 });
               } else {
                 result.descriptor = nullStr.text;
@@ -56854,8 +56867,8 @@ var init_detect = __esm({
         let match;
         scenes.push({ timestamp: 0, score: 1 });
         while ((match = regex2.exec(output)) !== null) {
-          const timestamp = parseFloat(match[1]);
-          scenes.push({ timestamp, score: threshold });
+          const timestamp2 = parseFloat(match[1]);
+          scenes.push({ timestamp: timestamp2, score: threshold });
         }
         const totalDuration = await ffprobeDuration(absPath);
         spinner2.succeed(source_default.green(`Detected ${scenes.length} scenes`));
@@ -58464,14 +58477,14 @@ var init_adapters = __esm({
 });
 
 // src/commands/_shared/storyboard-revise.ts
-import { existsSync as existsSync41 } from "node:fs";
-import { readFile as readFile38, writeFile as writeFile45 } from "node:fs/promises";
-import { join as join19, resolve as resolve54 } from "node:path";
+import { existsSync as existsSync42 } from "node:fs";
+import { readFile as readFile39, writeFile as writeFile46 } from "node:fs/promises";
+import { join as join20, resolve as resolve55 } from "node:path";
 async function executeStoryboardRevision(opts) {
-  const projectDir = resolve54(opts.projectDir);
-  const storyboardPath2 = join19(projectDir, "STORYBOARD.md");
+  const projectDir = resolve55(opts.projectDir);
+  const storyboardPath2 = join20(projectDir, "STORYBOARD.md");
   const retryWith = [`vibe storyboard revise ${projectDir} --from "<request>" --dry-run --json`];
-  if (!existsSync41(storyboardPath2)) {
+  if (!existsSync42(storyboardPath2)) {
     return failureResult({
       projectDir,
       storyboardPath: storyboardPath2,
@@ -58481,7 +58494,7 @@ async function executeStoryboardRevision(opts) {
       retryWith: [`vibe init ${projectDir} --from "<brief>" --json`]
     });
   }
-  const currentStoryboard = await readFile38(storyboardPath2, "utf-8");
+  const currentStoryboard = await readFile39(storyboardPath2, "utf-8");
   const projectConfig = await readProjectConfig(projectDir);
   const explicitComposer = opts.composer ?? projectConfig.config.providers.composer ?? void 0;
   let provider = explicitComposer ?? "claude";
@@ -58580,7 +58593,7 @@ async function executeStoryboardRevision(opts) {
   }
   const storyboardMd = normalizeMarkdown(payload.storyboardMd);
   if (!opts.dryRun) {
-    await writeFile45(storyboardPath2, storyboardMd, "utf-8");
+    await writeFile46(storyboardPath2, storyboardMd, "utf-8");
   }
   const changedBeats = unique2([...diffChangedBeats(currentStoryboard, storyboardMd), ...payload.changedBeats]);
   return stripUndefined3({
@@ -58703,18 +58716,18 @@ function diffChangedBeats(before, after) {
   return ids.filter((id) => JSON.stringify(beforeBeats.get(id) ?? null) !== JSON.stringify(afterBeats.get(id) ?? null));
 }
 async function readRevisionContext(projectDir) {
-  const designMd = await readOptionalText(join19(projectDir, "DESIGN.md"));
-  const buildReportJson = await readOptionalJsonText(join19(projectDir, "build-report.json"));
+  const designMd = await readOptionalText(join20(projectDir, "DESIGN.md"));
+  const buildReportJson = await readOptionalJsonText(join20(projectDir, "build-report.json"));
   return { designMd, buildReportJson };
 }
 async function readOptionalText(path2) {
-  if (!existsSync41(path2)) return null;
-  return readFile38(path2, "utf-8");
+  if (!existsSync42(path2)) return null;
+  return readFile39(path2, "utf-8");
 }
 async function readOptionalJsonText(path2) {
-  if (!existsSync41(path2)) return null;
+  if (!existsSync42(path2)) return null;
   try {
-    const parsed = JSON.parse(await readFile38(path2, "utf-8"));
+    const parsed = JSON.parse(await readFile39(path2, "utf-8"));
     return JSON.stringify(parsed, null, 2);
   } catch {
     return null;
@@ -58762,8 +58775,8 @@ var init_storyboard_revise = __esm({
 });
 
 // src/commands/_shared/build-asset-reference.ts
-import { existsSync as existsSync43 } from "node:fs";
-import { extname as extname13, isAbsolute as isAbsolute5, relative as relative10, resolve as resolve56, sep } from "node:path";
+import { existsSync as existsSync44 } from "node:fs";
+import { extname as extname13, isAbsolute as isAbsolute5, relative as relative10, resolve as resolve57, sep } from "node:path";
 function resolveTypedAssetReference(projectDir, kind, value) {
   const raw = stringOrUndefined2(value);
   if (!raw || !looksLikeAssetPath(raw)) return null;
@@ -58790,10 +58803,10 @@ function isReadyAssetReference(reference) {
 function resolveReference(projectDir, kind, raw, source, forcedError) {
   const ext = extname13(raw).toLowerCase();
   const inferred = inferAssetKind(raw);
-  const absPath = isAbsolute5(raw) ? resolve56(raw) : resolve56(projectDir, raw);
-  const rel = relative10(resolve56(projectDir), absPath);
+  const absPath = isAbsolute5(raw) ? resolve57(raw) : resolve57(projectDir, raw);
+  const rel = relative10(resolve57(projectDir), absPath);
   const withinProject = rel.length > 0 && !rel.startsWith("..") && !isAbsolute5(rel);
-  const exists = withinProject && existsSync43(absPath);
+  const exists = withinProject && existsSync44(absPath);
   let error = forcedError;
   if (!error && inferred && inferred !== kind && !isNarrationAudioReference(kind, ext)) {
     error = `Asset reference "${raw}" is a ${inferred} asset, not ${kind}.`;
@@ -58952,19 +58965,19 @@ var init_build_backdrop_prompt = __esm({
 });
 
 // src/commands/_shared/build-plan.ts
-import { existsSync as existsSync44 } from "node:fs";
-import { readFile as readFile40 } from "node:fs/promises";
-import { dirname as dirname19, join as join20, resolve as resolve57 } from "node:path";
+import { existsSync as existsSync45 } from "node:fs";
+import { readFile as readFile41 } from "node:fs/promises";
+import { dirname as dirname20, join as join21, resolve as resolve58 } from "node:path";
 async function createBuildPlan(opts) {
-  const projectDir = resolve57(opts.projectDir);
+  const projectDir = resolve58(opts.projectDir);
   loadPlanEnv(projectDir);
   const stage = opts.stage ?? "all";
   const config2 = await readProjectConfig(projectDir);
-  const storyboardPath2 = join20(projectDir, "STORYBOARD.md");
+  const storyboardPath2 = join21(projectDir, "STORYBOARD.md");
   const warnings = [];
   const retryWith = [];
   const providerResolution = [];
-  if (!existsSync44(storyboardPath2)) {
+  if (!existsSync45(storyboardPath2)) {
     const validation2 = {
       ok: false,
       issues: [
@@ -58993,7 +59006,7 @@ async function createBuildPlan(opts) {
       validation: validation2
     });
   }
-  const storyboardMd = await readFile40(storyboardPath2, "utf-8");
+  const storyboardMd = await readFile41(storyboardPath2, "utf-8");
   const validation = validateStoryboardMarkdown(storyboardMd);
   const validationIssues = [...validation.issues];
   const parsed = parseStoryboard(storyboardMd);
@@ -59019,7 +59032,7 @@ async function createBuildPlan(opts) {
   const imageQuality = opts.imageQuality ?? config2.config.build.imageQuality ?? "hd";
   const imageSize2 = opts.imageSize ?? config2.config.build.imageSize ?? "1536x1024";
   const imageRatio = imageRatioForSize(imageSize2);
-  const needsComposer = includeCompose && mode !== "agent" && sourceBeats.some((beat) => !existsSync44(join20(projectDir, `compositions/scene-${beat.id}.html`)));
+  const needsComposer = includeCompose && mode !== "agent" && sourceBeats.some((beat) => !existsSync45(join21(projectDir, `compositions/scene-${beat.id}.html`)));
   const resolved = await resolvePlanProviders({
     projectDir,
     config: config2,
@@ -59140,7 +59153,7 @@ async function createBuildPlan(opts) {
       active: includeAssets
     }) : null;
     const compositionPath = `compositions/scene-${beat.id}.html`;
-    const compositionExists = existsSync44(join20(projectDir, compositionPath));
+    const compositionExists = existsSync45(join21(projectDir, compositionPath));
     for (const asset of [narration, backdrop, video, music]) {
       if (!asset) continue;
       if (asset.referenceError) {
@@ -59207,7 +59220,7 @@ async function createBuildPlan(opts) {
     }
   }
   const validationOk = !validationIssues.some((issue) => issue.severity === "error");
-  if (!existsSync44(join20(projectDir, config2.config.composition.entry))) {
+  if (!existsSync45(join21(projectDir, config2.config.composition.entry))) {
     missing.add("root-composition");
     if (validationOk) retryWith.push(`vibe build ${projectDir} --stage sync --json`);
   }
@@ -59339,8 +59352,8 @@ function assetPlan(opts) {
       reason: ready ? "referenced-asset" : "invalid-reference"
     };
   }
-  const canonicalExists = existsSync44(join20(opts.projectDir, opts.path));
-  const cacheHit = opts.cache ? existsSync44(join20(opts.projectDir, opts.cache.path)) : false;
+  const canonicalExists = existsSync45(join21(opts.projectDir, opts.path));
+  const cacheHit = opts.cache ? existsSync45(join21(opts.projectDir, opts.cache.path)) : false;
   const freshness = assetFreshnessFromMetadata({
     projectDir: opts.projectDir,
     kind: opts.kind,
@@ -59534,7 +59547,7 @@ async function firstConfiguredComposer(projectDir) {
 }
 function firstExisting2(projectDir, paths) {
   for (const path2 of paths) {
-    if (existsSync44(join20(projectDir, path2))) return path2;
+    if (existsSync45(join21(projectDir, path2))) return path2;
   }
   return null;
 }
@@ -59575,15 +59588,15 @@ function unique3(items) {
   return [...new Set(items.filter((item) => item.length > 0))];
 }
 function loadPlanEnv(projectDir) {
-  (0, import_dotenv3.config)({ path: join20(projectDir, ".env"), quiet: true });
-  (0, import_dotenv3.config)({ path: resolve57(process.cwd(), ".env"), quiet: true });
+  (0, import_dotenv3.config)({ path: join21(projectDir, ".env"), quiet: true });
+  (0, import_dotenv3.config)({ path: resolve58(process.cwd(), ".env"), quiet: true });
   let dir = process.cwd();
-  while (dir !== dirname19(dir)) {
-    if (existsSync44(join20(dir, "pnpm-workspace.yaml"))) {
-      (0, import_dotenv3.config)({ path: join20(dir, ".env"), quiet: true });
+  while (dir !== dirname20(dir)) {
+    if (existsSync45(join21(dir, "pnpm-workspace.yaml"))) {
+      (0, import_dotenv3.config)({ path: join21(dir, ".env"), quiet: true });
       return;
     }
-    dir = dirname19(dir);
+    dir = dirname20(dir);
   }
 }
 var import_dotenv3, BACKDROP_COST_USD, VIDEO_COST_USD, MUSIC_COST_USD, ELEVENLABS_NARRATION_COST_USD, COMPOSE_COST_USD, SUPPORTED_BUILD_IMAGE_PROVIDERS;
@@ -59611,8 +59624,8 @@ var init_build_plan = __esm({
 });
 
 // src/commands/_shared/scene-audio-scan.ts
-import { readFile as readFile41 } from "node:fs/promises";
-import { resolve as resolve59 } from "node:path";
+import { readFile as readFile42 } from "node:fs/promises";
+import { resolve as resolve60 } from "node:path";
 function parseRootClips(rootHtml) {
   const clips = [];
   const clipRegex = /<div\b[^>]*class="clip"[^>]*>/gi;
@@ -59650,9 +59663,9 @@ function parseSceneAudios(compositionHtml) {
 }
 function makeFsCompositionReader(projectDir) {
   return async (compositionSrcRel) => {
-    const abs = resolve59(projectDir, compositionSrcRel);
+    const abs = resolve60(projectDir, compositionSrcRel);
     try {
-      return await readFile41(abs, "utf-8");
+      return await readFile42(abs, "utf-8");
     } catch {
       return null;
     }
@@ -59669,7 +59682,7 @@ async function scanSceneAudio(opts) {
     for (const audio of audios) {
       out.push({
         srcRel: audio.srcRel,
-        srcAbs: resolve59(opts.projectDir, audio.srcRel),
+        srcAbs: resolve60(opts.projectDir, audio.srcRel),
         absoluteStart: clip.start + audio.localStart,
         durationHint: audio.durationHint,
         clipDurationCap: clip.duration - audio.localStart,
@@ -59684,7 +59697,7 @@ async function scanSceneAudio(opts) {
   for (const audio of rootAudios) {
     out.push({
       srcRel: audio.srcRel,
-      srcAbs: resolve59(opts.projectDir, audio.srcRel),
+      srcAbs: resolve60(opts.projectDir, audio.srcRel),
       absoluteStart: audio.localStart,
       durationHint: audio.durationHint,
       clipDurationCap: Math.max(0, maxClipEnd - audio.localStart),
@@ -59719,7 +59732,7 @@ var init_scene_audio_scan = __esm({
 
 // src/commands/_shared/scene-audio-mux.ts
 import { rename as rename4, unlink as unlink3 } from "node:fs/promises";
-import { resolve as resolve60, dirname as dirname20, extname as extname14, basename as basename20 } from "node:path";
+import { resolve as resolve61, dirname as dirname21, extname as extname14, basename as basename20 } from "node:path";
 function buildAudioMuxFilter(audios) {
   if (audios.length === 0) return null;
   const labels = [];
@@ -59779,8 +59792,8 @@ async function muxAudioIntoVideo(opts) {
     return { success: true, outputPath: opts.videoPath, audioCount: 0 };
   }
   const ext = extname14(opts.videoPath) || `.${opts.format}`;
-  const tmpPath = resolve60(
-    dirname20(opts.videoPath),
+  const tmpPath = resolve61(
+    dirname21(opts.videoPath),
     `.${basename20(opts.videoPath, ext)}.muxing${ext}`
   );
   const args = ["-y", "-loglevel", "error", "-i", opts.videoPath];
@@ -59850,9 +59863,9 @@ __export(scene_render_exports, {
   prepareBeatRenderRoot: () => prepareBeatRenderRoot,
   qualityToCrf: () => qualityToCrf2
 });
-import { existsSync as existsSync45 } from "node:fs";
-import { mkdir as mkdir23, readFile as readFile42, stat as stat8, writeFile as writeFile47 } from "node:fs/promises";
-import { resolve as resolve61, relative as relative11, dirname as dirname21, basename as basename21, join as join21, isAbsolute as isAbsolute6 } from "node:path";
+import { existsSync as existsSync46 } from "node:fs";
+import { mkdir as mkdir24, readFile as readFile43, stat as stat8, writeFile as writeFile48 } from "node:fs/promises";
+import { resolve as resolve62, relative as relative11, dirname as dirname22, basename as basename21, join as join22, isAbsolute as isAbsolute6 } from "node:path";
 import {
   createRenderJob,
   executeRenderJob
@@ -59864,9 +59877,9 @@ function defaultOutputPath(opts) {
   const fmt = opts.format ?? "mp4";
   const now = opts.now ?? /* @__PURE__ */ new Date();
   const stamp = now.toISOString().replace(/[:T]/g, "-").replace(/\..+$/, "");
-  const name = (opts.projectName ?? basename21(resolve61(opts.projectDir))) || "scene";
+  const name = (opts.projectName ?? basename21(resolve62(opts.projectDir))) || "scene";
   const beat = opts.beatId ? `-${sanitizeFileSegment2(opts.beatId)}` : "";
-  return resolve61(opts.projectDir, "renders", `${name}${beat}-${stamp}.${fmt}`);
+  return resolve62(opts.projectDir, "renders", `${name}${beat}-${stamp}.${fmt}`);
 }
 function buildRenderConfig(opts) {
   const quality = opts.quality ?? "standard";
@@ -59880,7 +59893,7 @@ function buildRenderConfig(opts) {
   };
 }
 async function executeSceneRender(opts = {}) {
-  const projectDir = resolve61(opts.projectDir ?? ".");
+  const projectDir = resolve62(opts.projectDir ?? ".");
   const projectConfig = await readProjectConfig(projectDir);
   const engine = projectConfig.config.composition.engine;
   if (engine !== "hyperframes") {
@@ -59926,7 +59939,7 @@ async function executeSceneRender(opts = {}) {
       kind: "render",
       beat: opts.beatId ?? null,
       root,
-      error: `Root composition not found: ${resolve61(projectDir, root)}. Run \`vibe scene init\` first.`
+      error: `Root composition not found: ${resolve62(projectDir, root)}. Run \`vibe scene init\` first.`
     };
   }
   const chrome = await preflightChrome();
@@ -59940,8 +59953,8 @@ async function executeSceneRender(opts = {}) {
     };
   }
   const projectName = projectConfig.config.name;
-  const outputPath = opts.output ? resolve61(projectDir, opts.output) : defaultOutputPath({ projectDir, projectName, format: opts.format, beatId: opts.beatId });
-  await mkdir23(dirname21(outputPath), { recursive: true });
+  const outputPath = opts.output ? resolve62(projectDir, opts.output) : defaultOutputPath({ projectDir, projectName, format: opts.format, beatId: opts.beatId });
+  await mkdir24(dirname22(outputPath), { recursive: true });
   const config2 = buildRenderConfig({
     fps: opts.fps,
     quality: opts.quality,
@@ -59973,7 +59986,7 @@ async function executeSceneRender(opts = {}) {
   let audioMuxWarning;
   try {
     opts.onProgress?.(0.95, "Mixing audio");
-    const rootHtml = await readFile42(resolve61(projectDir, root), "utf-8");
+    const rootHtml = await readFile43(resolve62(projectDir, root), "utf-8");
     const audios = await scanSceneAudio({ projectDir, rootHtml });
     audioCount = audios.length;
     if (audios.length > 0) {
@@ -60027,11 +60040,11 @@ async function safeStat(p) {
 }
 async function prepareBeatRenderRoot(opts) {
   const root = `.vibeframe/tmp/render-beat-${sanitizeFileSegment2(opts.beatId)}.html`;
-  const reportPath = join21(opts.projectDir, "build-report.json");
+  const reportPath = join22(opts.projectDir, "build-report.json");
   const retryWith = [
     `vibe build ${opts.projectDir} --beat ${opts.beatId} --stage sync --json`
   ];
-  if (!existsSync45(reportPath)) {
+  if (!existsSync46(reportPath)) {
     return {
       success: false,
       root,
@@ -60042,7 +60055,7 @@ async function prepareBeatRenderRoot(opts) {
   }
   let report;
   try {
-    report = JSON.parse(await readFile42(reportPath, "utf-8"));
+    report = JSON.parse(await readFile43(reportPath, "utf-8"));
   } catch (error) {
     return {
       success: false,
@@ -60111,8 +60124,8 @@ async function prepareBeatRenderRoot(opts) {
     durationSec,
     narrationPath
   });
-  await mkdir23(dirname21(join21(opts.projectDir, root)), { recursive: true });
-  await writeFile47(join21(opts.projectDir, root), html, "utf-8");
+  await mkdir24(dirname22(join22(opts.projectDir, root)), { recursive: true });
+  await writeFile48(join22(opts.projectDir, root), html, "utf-8");
   return {
     success: true,
     root,
@@ -60176,9 +60189,9 @@ function reportedBeatAssetPaths(beat) {
   ]);
 }
 async function writeRenderReport(projectDir, result) {
-  const reportPath = join21(projectDir, "render-report.json");
+  const reportPath = join22(projectDir, "render-report.json");
   try {
-    await writeFile47(
+    await writeFile48(
       reportPath,
       JSON.stringify(
         {
@@ -60210,8 +60223,8 @@ async function writeRenderReport(projectDir, result) {
   }
 }
 function pathExists3(projectDir, value) {
-  const abs = isAbsolute6(value) ? value : resolve61(projectDir, value);
-  return existsSync45(abs);
+  const abs = isAbsolute6(value) ? value : resolve62(projectDir, value);
+  return existsSync46(abs);
 }
 function stringValue(value) {
   return typeof value === "string" && value.length > 0 ? value : void 0;
@@ -60264,12 +60277,12 @@ __export(scene_build_exports, {
   executeSceneBuild: () => executeSceneBuild,
   resolveSceneBuildMode: () => resolveSceneBuildMode
 });
-import { existsSync as existsSync46 } from "node:fs";
-import { copyFile as copyFile5, mkdir as mkdir24, readFile as readFile43, writeFile as writeFile48 } from "node:fs/promises";
-import { dirname as dirname22, join as join22, resolve as resolve62 } from "node:path";
+import { existsSync as existsSync47 } from "node:fs";
+import { copyFile as copyFile5, mkdir as mkdir25, readFile as readFile44, writeFile as writeFile49 } from "node:fs/promises";
+import { dirname as dirname23, join as join23, resolve as resolve63 } from "node:path";
 async function executeSceneBuild(opts) {
   const startedAt = Date.now();
-  const projectDir = resolve62(opts.projectDir);
+  const projectDir = resolve63(opts.projectDir);
   const onProgress = opts.onProgress ?? (() => {
   });
   const mode = resolveSceneBuildMode(opts);
@@ -60278,7 +60291,7 @@ async function executeSceneBuild(opts) {
   const warnings = [];
   const retryWith = [];
   let sceneRepair = skippedSceneRepairSummary();
-  const storyboardPath2 = join22(projectDir, "STORYBOARD.md");
+  const storyboardPath2 = join23(projectDir, "STORYBOARD.md");
   const buildPlan = await createBuildPlan({
     projectDir,
     stage: selectedStage,
@@ -60306,8 +60319,8 @@ async function executeSceneBuild(opts) {
   });
   if (!buildPlan.validation.ok) {
     let invalidBeats = [];
-    if (existsSync46(storyboardPath2)) {
-      invalidBeats = parseStoryboard(await readFile43(storyboardPath2, "utf-8")).beats;
+    if (existsSync47(storyboardPath2)) {
+      invalidBeats = parseStoryboard(await readFile44(storyboardPath2, "utf-8")).beats;
     }
     return finishBuildResult({
       success: false,
@@ -60331,7 +60344,7 @@ async function executeSceneBuild(opts) {
       totalLatencyMs: Date.now() - startedAt
     });
   }
-  if (!existsSync46(storyboardPath2)) {
+  if (!existsSync47(storyboardPath2)) {
     return finishBuildResult({
       success: false,
       phase: "failed",
@@ -60345,7 +60358,7 @@ async function executeSceneBuild(opts) {
       totalLatencyMs: Date.now() - startedAt
     });
   }
-  const storyboardMd = await readFile43(storyboardPath2, "utf-8");
+  const storyboardMd = await readFile44(storyboardPath2, "utf-8");
   const parsed = parseStoryboard(storyboardMd);
   if (parsed.beats.length === 0) {
     return finishBuildResult({
@@ -60513,9 +60526,9 @@ async function executeSceneBuild(opts) {
   let composeData;
   if (shouldRunStage(selectedStage, "compose")) {
     if (mode === "agent") {
-      const compositionsDir = join22(projectDir, "compositions");
+      const compositionsDir = join23(projectDir, "compositions");
       const missingBeats = activeBeats.filter(
-        (b) => !existsSync46(join22(compositionsDir, `scene-${b.id}.html`))
+        (b) => !existsSync47(join23(compositionsDir, `scene-${b.id}.html`))
       );
       if (missingBeats.length > 0) {
         const plan = await getComposePrompts({ projectDir, beatId: opts.beatId });
@@ -60651,7 +60664,7 @@ async function executeSceneBuild(opts) {
     });
   }
   if (shouldRunStage(selectedStage, "sync")) {
-    if (!existsSync46(join22(projectDir, "index.html"))) {
+    if (!existsSync47(join23(projectDir, "index.html"))) {
       await scaffoldSceneProject({
         dir: projectDir,
         name: projectDir.split(/[\\/]/).filter(Boolean).pop(),
@@ -60910,7 +60923,7 @@ async function dispatchNarration(beat, ctx) {
       return {
         status: "cached",
         path: existingRel,
-        durationSec: await safeAudioDuration(join22(ctx.projectDir, existingRel)),
+        durationSec: await safeAudioDuration(join23(ctx.projectDir, existingRel)),
         provider: metadata?.provider,
         cachePath: metadata?.cachePath,
         cacheKey: metadata?.cacheKey,
@@ -60934,9 +60947,9 @@ async function dispatchNarration(beat, ctx) {
     voice,
     ext: resolution.audioExtension
   });
-  const cacheAbs = join22(ctx.projectDir, cache.path);
+  const cacheAbs = join23(ctx.projectDir, cache.path);
   const rel = `assets/narration-${beat.id}.${resolution.audioExtension}`;
-  const abs = join22(ctx.projectDir, rel);
+  const abs = join23(ctx.projectDir, rel);
   if (existingRel && !ctx.force && isFreshCanonicalAsset({
     projectDir: ctx.projectDir,
     kind: "narration",
@@ -60950,7 +60963,7 @@ async function dispatchNarration(beat, ctx) {
     return {
       status: "cached",
       path: existingRel,
-      durationSec: await safeAudioDuration(join22(ctx.projectDir, existingRel)),
+      durationSec: await safeAudioDuration(join23(ctx.projectDir, existingRel)),
       provider: resolution.provider,
       cachePath: cache.path,
       cacheKey: cache.key,
@@ -60958,8 +60971,8 @@ async function dispatchNarration(beat, ctx) {
       freshness: "fresh"
     };
   }
-  if (existsSync46(cacheAbs) && !ctx.force) {
-    await mkdir24(dirname22(abs), { recursive: true });
+  if (existsSync47(cacheAbs) && !ctx.force) {
+    await mkdir25(dirname23(abs), { recursive: true });
     await copyFile5(cacheAbs, abs);
     await writeAssetMetadata({
       projectDir: ctx.projectDir,
@@ -60990,10 +61003,10 @@ async function dispatchNarration(beat, ctx) {
     ctx.onProgress({ type: "narration-failed", beatId: beat.id, error });
     return { status: "failed", error };
   }
-  await mkdir24(dirname22(abs), { recursive: true });
-  await writeFile48(abs, result.audioBuffer);
-  await mkdir24(dirname22(cacheAbs), { recursive: true });
-  await writeFile48(cacheAbs, result.audioBuffer);
+  await mkdir25(dirname23(abs), { recursive: true });
+  await writeFile49(abs, result.audioBuffer);
+  await mkdir25(dirname23(cacheAbs), { recursive: true });
+  await writeFile49(cacheAbs, result.audioBuffer);
   await writeAssetMetadata({
     projectDir: ctx.projectDir,
     kind: "narration",
@@ -61029,7 +61042,7 @@ async function dispatchBackdrop(beat, ctx) {
   if (!cue) return { status: "no-cue" };
   const prompt3 = augmentBackdropPrompt(cue);
   const rel = `assets/backdrop-${beat.id}.png`;
-  const abs = join22(ctx.projectDir, rel);
+  const abs = join23(ctx.projectDir, rel);
   const size = ctx.imageSize ?? "1536x1024";
   const ratio = imageRatioForSize(size);
   const metadataOptions = { quality: ctx.imageQuality, size, ratio };
@@ -61042,7 +61055,7 @@ async function dispatchBackdrop(beat, ctx) {
     ratio
   });
   const metadataPath = assetMetadataPath("backdrop", beat.id);
-  if (existsSync46(abs) && !ctx.force) {
+  if (existsSync47(abs) && !ctx.force) {
     const metadata = readAssetMetadata(ctx.projectDir, "backdrop", beat.id);
     if (!metadata || isFreshCanonicalAsset({
       projectDir: ctx.projectDir,
@@ -61065,9 +61078,9 @@ async function dispatchBackdrop(beat, ctx) {
       };
     }
   }
-  const cacheAbs = join22(ctx.projectDir, cache.path);
-  if (existsSync46(cacheAbs) && !ctx.force) {
-    await mkdir24(dirname22(abs), { recursive: true });
+  const cacheAbs = join23(ctx.projectDir, cache.path);
+  if (existsSync47(cacheAbs) && !ctx.force) {
+    await mkdir25(dirname23(abs), { recursive: true });
     await copyFile5(cacheAbs, abs);
     await writeAssetMetadata({
       projectDir: ctx.projectDir,
@@ -61097,11 +61110,11 @@ async function dispatchBackdrop(beat, ctx) {
     ctx.onProgress({ type: "backdrop-failed", beatId: beat.id, error });
     return { status: "failed", error };
   }
-  await mkdir24(dirname22(abs), { recursive: true });
+  await mkdir25(dirname23(abs), { recursive: true });
   const buffer = generated.buffer;
-  await writeFile48(abs, buffer);
-  await mkdir24(dirname22(cacheAbs), { recursive: true });
-  await writeFile48(cacheAbs, buffer);
+  await writeFile49(abs, buffer);
+  await mkdir25(dirname23(cacheAbs), { recursive: true });
+  await writeFile49(cacheAbs, buffer);
   await writeAssetMetadata({
     projectDir: ctx.projectDir,
     kind: "backdrop",
@@ -61192,7 +61205,7 @@ async function dispatchVideo(beat, ctx) {
   const prompt3 = stringOrUndefined4(beat.cues?.video);
   if (!prompt3) return { status: "no-cue" };
   const rel = `assets/video-${beat.id}.mp4`;
-  const abs = join22(ctx.projectDir, rel);
+  const abs = join23(ctx.projectDir, rel);
   const cache = videoCacheDescriptor({
     beatId: beat.id,
     cue: prompt3,
@@ -61200,7 +61213,7 @@ async function dispatchVideo(beat, ctx) {
     duration: normalizeVideoDuration(beat.duration)
   });
   const metadataPath = assetMetadataPath("video", beat.id);
-  if (existsSync46(abs) && !ctx.force) {
+  if (existsSync47(abs) && !ctx.force) {
     const metadata = readAssetMetadata(ctx.projectDir, "video", beat.id);
     if (!metadata || isFreshCanonicalAsset({
       projectDir: ctx.projectDir,
@@ -61223,9 +61236,9 @@ async function dispatchVideo(beat, ctx) {
       };
     }
   }
-  const cacheAbs = join22(ctx.projectDir, cache.path);
-  if (existsSync46(cacheAbs) && !ctx.force) {
-    await mkdir24(dirname22(abs), { recursive: true });
+  const cacheAbs = join23(ctx.projectDir, cache.path);
+  if (existsSync47(cacheAbs) && !ctx.force) {
+    await mkdir25(dirname23(abs), { recursive: true });
     await copyFile5(cacheAbs, abs);
     await writeAssetMetadata({
       projectDir: ctx.projectDir,
@@ -61264,8 +61277,8 @@ async function dispatchVideo(beat, ctx) {
     ctx.onProgress({ type: "video-failed", beatId: beat.id, error });
     return { status: "failed", error };
   }
-  if (result.status === "completed" && existsSync46(abs)) {
-    await mkdir24(dirname22(cacheAbs), { recursive: true });
+  if (result.status === "completed" && existsSync47(abs)) {
+    await mkdir25(dirname23(cacheAbs), { recursive: true });
     await copyFile5(abs, cacheAbs);
     await writeAssetMetadata({
       projectDir: ctx.projectDir,
@@ -61332,7 +61345,7 @@ async function dispatchMusic(beat, ctx) {
   const prompt3 = stringOrUndefined4(beat.cues?.music);
   if (!prompt3) return { status: "no-cue" };
   const rel = `assets/music-${beat.id}.mp3`;
-  const abs = join22(ctx.projectDir, rel);
+  const abs = join23(ctx.projectDir, rel);
   const duration = normalizeMusicDuration(beat.duration);
   const cache = musicCacheDescriptor({
     beatId: beat.id,
@@ -61341,7 +61354,7 @@ async function dispatchMusic(beat, ctx) {
     duration
   });
   const metadataPath = assetMetadataPath("music", beat.id);
-  if (existsSync46(abs) && !ctx.force) {
+  if (existsSync47(abs) && !ctx.force) {
     const metadata = readAssetMetadata(ctx.projectDir, "music", beat.id);
     if (!metadata || isFreshCanonicalAsset({
       projectDir: ctx.projectDir,
@@ -61365,9 +61378,9 @@ async function dispatchMusic(beat, ctx) {
       };
     }
   }
-  const cacheAbs = join22(ctx.projectDir, cache.path);
-  if (existsSync46(cacheAbs) && !ctx.force) {
-    await mkdir24(dirname22(abs), { recursive: true });
+  const cacheAbs = join23(ctx.projectDir, cache.path);
+  if (existsSync47(cacheAbs) && !ctx.force) {
+    await mkdir25(dirname23(abs), { recursive: true });
     await copyFile5(cacheAbs, abs);
     await writeAssetMetadata({
       projectDir: ctx.projectDir,
@@ -61440,12 +61453,12 @@ async function dispatchMusic(beat, ctx) {
       metadataPath
     };
   }
-  if (!existsSync46(abs)) {
+  if (!existsSync47(abs)) {
     const error = result.outputPath ? `music output was not written at ${abs}` : "music generation did not return an output file";
     ctx.onProgress({ type: "music-failed", beatId: beat.id, error });
     return { status: "failed", error };
   }
-  await mkdir24(dirname22(cacheAbs), { recursive: true });
+  await mkdir25(dirname23(cacheAbs), { recursive: true });
   await copyFile5(abs, cacheAbs);
   await writeAssetMetadata({
     projectDir: ctx.projectDir,
@@ -61476,15 +61489,15 @@ async function dispatchMusic(beat, ctx) {
   };
 }
 function loadSceneBuildEnv(projectDir) {
-  (0, import_dotenv4.config)({ path: join22(projectDir, ".env"), quiet: true });
-  (0, import_dotenv4.config)({ path: resolve62(process.cwd(), ".env"), quiet: true });
+  (0, import_dotenv4.config)({ path: join23(projectDir, ".env"), quiet: true });
+  (0, import_dotenv4.config)({ path: resolve63(process.cwd(), ".env"), quiet: true });
   let dir = process.cwd();
-  while (dir !== dirname22(dir)) {
-    if (existsSync46(join22(dir, "pnpm-workspace.yaml"))) {
-      (0, import_dotenv4.config)({ path: join22(dir, ".env"), quiet: true });
+  while (dir !== dirname23(dir)) {
+    if (existsSync47(join23(dir, "pnpm-workspace.yaml"))) {
+      (0, import_dotenv4.config)({ path: join23(dir, ".env"), quiet: true });
       return;
     }
-    dir = dirname22(dir);
+    dir = dirname23(dir);
   }
 }
 async function skipped(kind, beatId, reason, ctx) {
@@ -61690,7 +61703,7 @@ function mergeBeatOutcomes(base, updates) {
 }
 function firstExisting3(projectDir, relPaths) {
   for (const rel of relPaths) {
-    if (existsSync46(join22(projectDir, rel))) return rel;
+    if (existsSync47(join23(projectDir, rel))) return rel;
   }
   return null;
 }
@@ -61721,7 +61734,7 @@ async function apiKeyForVideoProvider(provider, projectDir) {
   return getApiKeyFromConfig(providerKey, { cwd: projectDir });
 }
 async function finalizeBuildResult(projectDir, startedAt, result) {
-  const reportPath = join22(projectDir, "build-report.json");
+  const reportPath = join23(projectDir, "build-report.json");
   if (result.stageReports) {
     for (const report of Object.values(result.stageReports)) {
       if (report.status === "pending") report.status = "skipped";
@@ -61737,7 +61750,7 @@ async function finalizeBuildResult(projectDir, startedAt, result) {
     totalLatencyMs: Date.now() - startedAt
   };
   try {
-    await writeFile48(
+    await writeFile49(
       reportPath,
       JSON.stringify(toBuildReport(projectDir, withMeta), null, 2) + "\n",
       "utf-8"
@@ -61880,7 +61893,7 @@ function normalizeReportDuration(value) {
 }
 function buildReportComposition(projectDir, result, beatId) {
   const path2 = `compositions/scene-${beatId}.html`;
-  const exists = existsSync46(join22(projectDir, path2));
+  const exists = existsSync47(join23(projectDir, path2));
   const written = composeWrittenEntry(result, beatId);
   if (written) {
     return {
@@ -61937,8 +61950,8 @@ function summarizeBuildBeats(projectDir, beats) {
   let compositionsReady = 0;
   for (const beat of beats) {
     if (beatAssetsReady(beat)) assetsReady += 1;
-    const compositionPath = join22(projectDir, "compositions", `scene-${beat.beatId}.html`);
-    if (existsSync46(compositionPath)) {
+    const compositionPath = join23(projectDir, "compositions", `scene-${beat.beatId}.html`);
+    if (existsSync47(compositionPath)) {
       compositionsReady += 1;
     } else {
       needsAuthor.push(beat.beatId);
@@ -61972,7 +61985,7 @@ async function resolveBeatDuration(opts) {
   const storyboardMin = opts.beatDuration ?? 3;
   if (!opts.narrationPath) return Number(storyboardMin.toFixed(2));
   try {
-    const audioDuration = await getAudioDuration(join22(opts.projectDir, opts.narrationPath));
+    const audioDuration = await getAudioDuration(join23(opts.projectDir, opts.narrationPath));
     return Number(Math.max(storyboardMin, audioDuration + 0.5).toFixed(2));
   } catch {
     return Number(storyboardMin.toFixed(2));
@@ -62076,19 +62089,19 @@ __export(ai_audio_exports, {
   executeTranscribe: () => executeTranscribe,
   executeVoiceClone: () => executeVoiceClone
 });
-import { resolve as resolve69, dirname as dirname24, basename as basename22, extname as extname15 } from "node:path";
-import { readFile as readFile45, writeFile as writeFile49 } from "node:fs/promises";
-import { existsSync as existsSync51 } from "node:fs";
+import { resolve as resolve71, dirname as dirname25, basename as basename22, extname as extname15 } from "node:path";
+import { readFile as readFile46, writeFile as writeFile50 } from "node:fs/promises";
+import { existsSync as existsSync52 } from "node:fs";
 async function executeTranscribe(options) {
   const { audioPath, language, output, format, apiKey } = options;
   try {
     const key = apiKey || process.env.OPENAI_API_KEY;
     if (!key) return { success: false, error: "OPENAI_API_KEY required" };
-    const absPath = resolve69(process.cwd(), audioPath);
-    if (!existsSync51(absPath)) return { success: false, error: `File not found: ${absPath}` };
+    const absPath = resolve71(process.cwd(), audioPath);
+    if (!existsSync52(absPath)) return { success: false, error: `File not found: ${absPath}` };
     const whisper = new WhisperProvider();
     await whisper.initialize({ apiKey: key });
-    const audioBuffer = await readFile45(absPath);
+    const audioBuffer = await readFile46(absPath);
     const audioBlob = new Blob([audioBuffer]);
     const result = await whisper.transcribe(audioBlob, language);
     if (result.status === "failed") {
@@ -62096,10 +62109,10 @@ async function executeTranscribe(options) {
     }
     let outputPath;
     if (output) {
-      outputPath = resolve69(process.cwd(), output);
+      outputPath = resolve71(process.cwd(), output);
       const fmt = detectFormat(output, format);
       const content = formatTranscript(result, fmt);
-      await writeFile49(outputPath, content, "utf-8");
+      await writeFile50(outputPath, content, "utf-8");
     }
     return {
       success: true,
@@ -62117,17 +62130,17 @@ 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 = resolve69(process.cwd(), audioPath);
-    if (!existsSync51(absPath)) return { success: false, error: `File not found: ${absPath}` };
-    const audioBuffer = await readFile45(absPath);
+    const absPath = resolve71(process.cwd(), audioPath);
+    if (!existsSync52(absPath)) return { success: false, error: `File not found: ${absPath}` };
+    const audioBuffer = await readFile46(absPath);
     const elevenlabs = new ElevenLabsProvider();
     await elevenlabs.initialize({ apiKey: key });
     const result = await elevenlabs.isolateVocals(audioBuffer);
     if (!result.success || !result.audioBuffer) {
       return { success: false, error: result.error || "Audio isolation failed" };
     }
-    const outputPath = resolve69(process.cwd(), output);
-    await writeFile49(outputPath, result.audioBuffer);
+    const outputPath = resolve71(process.cwd(), output);
+    await writeFile50(outputPath, result.audioBuffer);
     return { success: true, outputPath };
   } catch (error) {
     return { success: false, error: `Audio isolation failed: ${error instanceof Error ? error.message : String(error)}` };
@@ -62143,9 +62156,9 @@ async function executeVoiceClone(options) {
     }
     const audioBuffers = [];
     for (const samplePath of samplePaths) {
-      const absPath = resolve69(process.cwd(), samplePath);
-      if (!existsSync51(absPath)) return { success: false, error: `File not found: ${samplePath}` };
-      const buffer = await readFile45(absPath);
+      const absPath = resolve71(process.cwd(), samplePath);
+      if (!existsSync52(absPath)) return { success: false, error: `File not found: ${samplePath}` };
+      const buffer = await readFile46(absPath);
       audioBuffers.push(buffer);
     }
     const elevenlabs = new ElevenLabsProvider();
@@ -62165,8 +62178,8 @@ async function executeVoiceClone(options) {
 async function executeDub(options) {
   const { mediaPath, language, source, voice, analyzeOnly, output } = options;
   try {
-    const absPath = resolve69(process.cwd(), mediaPath);
-    if (!existsSync51(absPath)) return { success: false, error: `File not found: ${absPath}` };
+    const absPath = resolve71(process.cwd(), mediaPath);
+    if (!existsSync52(absPath)) return { success: false, error: `File not found: ${absPath}` };
     const openaiKey = process.env.OPENAI_API_KEY;
     const anthropicKey = process.env.ANTHROPIC_API_KEY;
     const elevenlabsKey = process.env.ELEVENLABS_API_KEY;
@@ -62177,13 +62190,13 @@ async function executeDub(options) {
     const isVideo = [".mp4", ".mov", ".avi", ".mkv", ".webm"].includes(ext);
     let audioPath = absPath;
     if (isVideo) {
-      const tempAudioPath = resolve69(dirname24(absPath), `temp-audio-${Date.now()}.mp3`);
+      const tempAudioPath = resolve71(dirname25(absPath), `temp-audio-${Date.now()}.mp3`);
       execSafeSync("ffmpeg", ["-i", absPath, "-vn", "-acodec", "mp3", "-y", tempAudioPath]);
       audioPath = tempAudioPath;
     }
     const whisper = new WhisperProvider();
     await whisper.initialize({ apiKey: openaiKey });
-    const audioBuffer = await readFile45(audioPath);
+    const audioBuffer = await readFile46(audioPath);
     const audioBlob = new Blob([audioBuffer]);
     const transcriptResult = await whisper.transcribe(audioBlob, source);
     if (transcriptResult.status === "failed" || !transcriptResult.segments) {
@@ -62226,7 +62239,7 @@ ${segmentTexts}`,
     }
     if (analyzeOnly) {
       if (output) {
-        const timingPath = resolve69(process.cwd(), output);
+        const timingPath = resolve71(process.cwd(), output);
         const timingData = {
           sourcePath: absPath,
           sourceLanguage: transcriptResult.detectedLanguage || source || "auto",
@@ -62238,14 +62251,14 @@ ${segmentTexts}`,
             translated: translatedSegments[i]?.text || s.text
           }))
         };
-        await writeFile49(timingPath, JSON.stringify(timingData, null, 2));
+        await writeFile50(timingPath, JSON.stringify(timingData, null, 2));
       }
       return {
         success: true,
         sourceLanguage: transcriptResult.detectedLanguage || source || "auto",
         targetLanguage: language,
         segmentCount: segments.length,
-        outputPath: output ? resolve69(process.cwd(), output) : void 0
+        outputPath: output ? resolve71(process.cwd(), output) : void 0
       };
     }
     const elevenlabs = new ElevenLabsProvider();
@@ -62259,9 +62272,9 @@ ${segmentTexts}`,
     }
     const combinedBuffer = Buffer.concat(dubbedBuffers);
     const outputExt = isVideo ? ".mp3" : extname15(absPath);
-    const defaultOutputPath2 = resolve69(dirname24(absPath), `${basename22(absPath, extname15(absPath))}-${language}${outputExt}`);
-    const finalOutputPath = resolve69(process.cwd(), output || defaultOutputPath2);
-    await writeFile49(finalOutputPath, combinedBuffer);
+    const defaultOutputPath2 = resolve71(dirname25(absPath), `${basename22(absPath, extname15(absPath))}-${language}${outputExt}`);
+    const finalOutputPath = resolve71(process.cwd(), output || defaultOutputPath2);
+    await writeFile50(finalOutputPath, combinedBuffer);
     if (isVideo && audioPath !== absPath) {
       try {
         const { unlink: unlink5 } = await import("node:fs/promises");
@@ -62292,12 +62305,12 @@ async function executeDuck(options) {
   } = options;
   try {
     if (!commandExists("ffmpeg")) return { success: false, error: "FFmpeg not found" };
-    const absMusicPath = resolve69(process.cwd(), musicPath);
-    const absVoicePath = resolve69(process.cwd(), voicePath);
-    if (!existsSync51(absMusicPath)) return { success: false, error: `Music file not found: ${absMusicPath}` };
-    if (!existsSync51(absVoicePath)) return { success: false, error: `Voice file not found: ${absVoicePath}` };
-    const defaultOutput = resolve69(dirname24(absMusicPath), `${basename22(absMusicPath, extname15(absMusicPath))}-ducked${extname15(absMusicPath)}`);
-    const outputPath = resolve69(process.cwd(), output || defaultOutput);
+    const absMusicPath = resolve71(process.cwd(), musicPath);
+    const absVoicePath = resolve71(process.cwd(), voicePath);
+    if (!existsSync52(absMusicPath)) return { success: false, error: `Music file not found: ${absMusicPath}` };
+    if (!existsSync52(absVoicePath)) return { success: false, error: `Voice file not found: ${absVoicePath}` };
+    const defaultOutput = resolve71(dirname25(absMusicPath), `${basename22(absMusicPath, extname15(absMusicPath))}-ducked${extname15(absMusicPath)}`);
+    const outputPath = resolve71(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",
@@ -62309,7 +62322,7 @@ async function executeDuck(options) {
       "-y",
       outputPath
     ], { timeout: 12e4, maxBuffer: 50 * 1024 * 1024 });
-    if (!existsSync51(outputPath)) return { success: false, error: "FFmpeg failed to create output" };
+    if (!existsSync52(outputPath)) return { success: false, error: "FFmpeg failed to create output" };
     return { success: true, outputPath };
   } catch (error) {
     return { success: false, error: `Audio ducking failed: ${error instanceof Error ? error.message : String(error)}` };
@@ -62325,9 +62338,9 @@ var init_ai_audio = __esm({
 });
 
 // src/pipeline/executor.ts
-import { resolve as resolve70 } from "node:path";
-import { readFile as readFile46, writeFile as writeFile50, mkdir as mkdir26 } from "node:fs/promises";
-import { existsSync as existsSync52 } from "node:fs";
+import { resolve as resolve72 } from "node:path";
+import { readFile as readFile47, writeFile as writeFile51, mkdir as mkdir27 } from "node:fs/promises";
+import { existsSync as existsSync53 } from "node:fs";
 function maxCostFor(action) {
   const cmd = ACTION_METADATA[action]?.command;
   if (!cmd) return 0;
@@ -62338,9 +62351,9 @@ function registerAction(action, handler) {
 }
 function getOutput(params, outputDir, defaultName) {
   if (params.output && typeof params.output === "string") {
-    return resolve70(outputDir, params.output);
+    return resolve72(outputDir, params.output);
   }
-  return resolve70(outputDir, defaultName);
+  return resolve72(outputDir, defaultName);
 }
 function stringParam(value) {
   return typeof value === "string" && value.trim() !== "" ? value : void 0;
@@ -62591,7 +62604,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: resolve70(outputDir, projectRel),
+      projectDir: resolve72(outputDir, projectRel),
       mode: params.mode,
       effort: params.effort,
       composer: params.composer,
@@ -62617,7 +62630,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: resolve70(outputDir, projectRel),
+      projectDir: resolve72(outputDir, projectRel),
       root: params.root,
       output: params.output,
       fps: params.fps,
@@ -62641,11 +62654,11 @@ async function ensureActionsRegistered() {
   });
 }
 async function loadPipeline(filePath) {
-  const absPath = resolve70(process.cwd(), filePath);
-  if (!existsSync52(absPath)) {
+  const absPath = resolve72(process.cwd(), filePath);
+  if (!existsSync53(absPath)) {
     throw new Error(`Pipeline file not found: ${absPath}`);
   }
-  const content = await readFile46(absPath, "utf-8");
+  const content = await readFile47(absPath, "utf-8");
   const manifest2 = (0, import_yaml8.parse)(content);
   if (!manifest2.name) throw new Error("Pipeline missing 'name' field");
   if (!manifest2.steps || !Array.isArray(manifest2.steps)) throw new Error("Pipeline missing 'steps' array");
@@ -62660,15 +62673,15 @@ async function loadPipeline(filePath) {
 }
 async function executePipeline(manifest2, options = {}) {
   await ensureActionsRegistered();
-  const outputDir = resolve70(process.cwd(), options.outputDir || `${manifest2.name}-output`);
-  await mkdir26(outputDir, { recursive: true });
+  const outputDir = resolve72(process.cwd(), options.outputDir || `${manifest2.name}-output`);
+  await mkdir27(outputDir, { recursive: true });
   const completedSteps = /* @__PURE__ */ new Map();
   const results = [];
   const startTime = Date.now();
   if (options.resume) {
-    const checkpointPath = resolve70(outputDir, CHECKPOINT_FILE);
-    if (existsSync52(checkpointPath)) {
-      const checkpointContent = await readFile46(checkpointPath, "utf-8");
+    const checkpointPath = resolve72(outputDir, CHECKPOINT_FILE);
+    if (existsSync53(checkpointPath)) {
+      const checkpointContent = await readFile47(checkpointPath, "utf-8");
       const checkpoint = (0, import_yaml8.parse)(checkpointContent);
       for (const cs of checkpoint.completedSteps) {
         completedSteps.set(cs.id, {
@@ -62786,8 +62799,8 @@ async function executePipeline(manifest2, options = {}) {
           data: s.data
         }))
       };
-      await writeFile50(
-        resolve70(outputDir, CHECKPOINT_FILE),
+      await writeFile51(
+        resolve72(outputDir, CHECKPOINT_FILE),
         (0, import_yaml8.stringify)(checkpoint, { indent: 2 }),
         "utf-8"
       );
@@ -67041,7 +67054,7 @@ var init_define_tool = __esm({
 });
 
 // src/tools/manifest/scene.ts
-import { resolve as resolve71, relative as relative12 } from "node:path";
+import { resolve as resolve73, relative as relative12 } from "node:path";
 function summariseLint(result) {
   return {
     ok: result.ok,
@@ -67063,7 +67076,7 @@ function summariseLint(result) {
     fixed: result.fixed
   };
 }
-var SCENE_PRESETS2, sceneStylesSchema, sceneStylesTool, sceneInitSchema, sceneInitTool, sceneAddSchema, sceneAddTool, sceneLintSchema, sceneLintTool, sceneRepairSchema, sceneRepairTool, sceneRenderSchema, sceneRenderTool, sceneBuildSchema, sceneBuildTool, sceneInstallSkillSchema, sceneInstallSkillTool, sceneComposePromptsSchema, sceneComposePromptsTool, sceneTools;
+var SCENE_PRESETS2, PROJECT_DIR_DESCRIPTION, INIT_DIR_DESCRIPTION, sceneStylesSchema, sceneStylesTool, sceneInitSchema, sceneInitTool, sceneAddSchema, sceneAddTool, sceneLintSchema, sceneLintTool, sceneRepairSchema, sceneRepairTool, sceneRenderSchema, sceneRenderTool, sceneBuildSchema, sceneBuildTool, sceneInstallSkillSchema, sceneInstallSkillTool, sceneComposePromptsSchema, sceneComposePromptsTool, sceneTools;
 var init_scene2 = __esm({
   "src/tools/manifest/scene.ts"() {
     "use strict";
@@ -67086,6 +67099,8 @@ var init_scene2 = __esm({
       "kinetic-type",
       "product-shot"
     ];
+    PROJECT_DIR_DESCRIPTION = "Project directory. Defaults to the surface's cwd; in MCP hosts, relative paths resolve under the configured server workspace.";
+    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.";
     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.")
     });
@@ -67145,7 +67160,7 @@ var init_scene2 = __esm({
       }
     });
     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.")
@@ -67157,7 +67172,7 @@ var init_scene2 = __esm({
       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 = resolve71(ctx.workingDirectory, args.dir);
+        const dir = resolve73(ctx.workingDirectory, args.dir);
         const result = await scaffoldSceneProject({
           dir,
           name: args.name,
@@ -67192,7 +67207,7 @@ var init_scene2 = __esm({
       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."),
@@ -67207,7 +67222,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 ? resolve71(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
+        const projectDir = args.projectDir ? resolve73(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
         const result = await executeSceneAdd({
           name: args.name,
           preset: args.preset ?? "simple",
@@ -67253,7 +67268,7 @@ var init_scene2 = __esm({
       }
     });
     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").')
     });
@@ -67264,7 +67279,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 ? resolve71(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
+        const projectDir = args.projectDir ? resolve73(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
         const result = await runProjectLint({
           projectDir,
           rootRel: args.root,
@@ -67290,7 +67305,7 @@ var init_scene2 = __esm({
       }
     });
     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.")
     });
@@ -67301,7 +67316,7 @@ var init_scene2 = __esm({
       description: "Apply deterministic mechanical scene repairs. Currently uses the safe lint auto-fix allow-list and never performs semantic creative rewrites.",
       schema: sceneRepairSchema,
       async execute(args, ctx) {
-        const projectDir = args.projectDir ? resolve71(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
+        const projectDir = args.projectDir ? resolve73(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
         const result = await executeSceneRepair({
           projectDir,
           rootRel: args.root,
@@ -67319,7 +67334,7 @@ var init_scene2 = __esm({
       }
     });
     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)."),
@@ -67335,7 +67350,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 ? resolve71(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
+        const projectDir = args.projectDir ? resolve73(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
         const result = await executeSceneRender({
           projectDir,
           root: args.root,
@@ -67374,7 +67389,7 @@ var init_scene2 = __esm({
     });
     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."),
@@ -67409,7 +67424,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 init + scene_add + 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 ? resolve71(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
+        const projectDir = args.projectDir ? resolve73(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
         const result = await executeSceneBuild({
           projectDir,
           stage: args.stage,
@@ -67489,7 +67504,7 @@ var init_scene2 = __esm({
     });
     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."
@@ -67506,7 +67521,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 = resolve71(ctx.workingDirectory, args.projectDir);
+        const projectDir = resolve73(ctx.workingDirectory, args.projectDir);
         const hostFlag = args.host ?? "auto";
         const hosts = (() => {
           if (hostFlag === "all") return ["all"];
@@ -67539,7 +67554,7 @@ var init_scene2 = __esm({
     });
     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."
@@ -67552,7 +67567,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 (build) remains as a fallback for non-agent contexts.",
       schema: sceneComposePromptsSchema,
       async execute(args, ctx) {
-        const projectDir = resolve71(ctx.workingDirectory, args.projectDir);
+        const projectDir = resolve73(ctx.workingDirectory, args.projectDir);
         const result = await getComposePrompts({
           projectDir,
           beatId: args.beat
@@ -68180,14 +68195,14 @@ var init_edit = __esm({
 });
 
 // src/commands/ai-suggest-edit.ts
-import { readFile as readFile47, writeFile as writeFile51 } from "node:fs/promises";
-import { resolve as resolve72 } from "node:path";
+import { readFile as readFile48, writeFile as writeFile52 } from "node:fs/promises";
+import { resolve as resolve74 } 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 = resolve72(process.cwd(), options.projectPath);
-    const content = await readFile47(filePath, "utf-8");
+    const filePath = resolve74(process.cwd(), options.projectPath);
+    const content = await readFile48(filePath, "utf-8");
     const data = JSON.parse(content);
     const project = Project.fromJSON(data);
     const gemini = new GeminiProvider();
@@ -68198,7 +68213,7 @@ async function executeSuggestEdit(options) {
       const first = suggestions[0];
       const applied = applySuggestion(project, first);
       if (applied) {
-        await writeFile51(filePath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
+        await writeFile52(filePath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
         return {
           success: true,
           suggestions,
@@ -68227,8 +68242,8 @@ var init_ai_suggest_edit = __esm({
 });
 
 // src/tools/manifest/inspect.ts
-import { resolve as resolve73 } from "node:path";
-var inspectProjectTool, inspectRenderTool, analyzeMediaTool, analyzeVideoTool, analyzeReviewTool, analyzeSuggestTool, inspectTools;
+import { resolve as resolve75 } from "node:path";
+var PROJECT_DIR_DESCRIPTION2, inspectProjectTool, inspectRenderTool, analyzeMediaTool, analyzeVideoTool, analyzeReviewTool, analyzeSuggestTool, inspectTools;
 var init_inspect = __esm({
   "src/tools/manifest/inspect.ts"() {
     "use strict";
@@ -68239,28 +68254,33 @@ var init_inspect = __esm({
     init_ai_suggest_edit();
     init_scene_inspect();
     init_render_inspect();
+    PROJECT_DIR_DESCRIPTION2 = "Project directory. Defaults to the surface's cwd; in MCP hosts, relative paths resolve under the configured server workspace.";
     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.")
       }),
       async execute(args, ctx) {
-        const projectDir = args.projectDir ? resolve73(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
+        const projectDir = args.projectDir ? resolve75(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
         const result = await inspectProject({
           projectDir,
           beatId: args.beat,
-          outputPath: args.outputPath ? resolve73(ctx.workingDirectory, args.outputPath) : void 0,
+          outputPath: args.outputPath ? resolve75(ctx.workingDirectory, args.outputPath) : void 0,
           writeReport: args.report !== false
         });
         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`,
@@ -68275,7 +68295,7 @@ var init_inspect = __esm({
       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."),
@@ -68285,20 +68305,24 @@ var init_inspect = __esm({
         dryRun: external_exports.boolean().optional().describe("Preview resolved inputs without probing video or calling Gemini.")
       }),
       async execute(args, ctx) {
-        const projectDir = args.projectDir ? resolve73(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
+        const projectDir = args.projectDir ? resolve75(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
         if (args.dryRun) {
           const result2 = await previewInspectRender({
             projectDir,
             beatId: args.beat,
-            videoPath: args.videoPath ? resolve73(ctx.workingDirectory, args.videoPath) : void 0,
-            outputPath: args.outputPath ? resolve73(ctx.workingDirectory, args.outputPath) : void 0,
+            videoPath: args.videoPath ? resolve75(ctx.workingDirectory, args.videoPath) : void 0,
+            outputPath: args.outputPath ? resolve75(ctx.workingDirectory, args.outputPath) : void 0,
             writeReport: args.report !== false,
             ai: args.ai === true,
             model: args.model
           });
           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}`] : []
@@ -68308,15 +68332,19 @@ var init_inspect = __esm({
         const result = await inspectRender({
           projectDir,
           beatId: args.beat,
-          videoPath: args.videoPath ? resolve73(ctx.workingDirectory, args.videoPath) : void 0,
-          outputPath: args.outputPath ? resolve73(ctx.workingDirectory, args.outputPath) : void 0,
+          videoPath: args.videoPath ? resolve75(ctx.workingDirectory, args.videoPath) : void 0,
+          outputPath: args.outputPath ? resolve75(ctx.workingDirectory, args.outputPath) : void 0,
           writeReport: args.report !== false,
           ai: args.ai === true,
           model: args.model
         });
         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`,
@@ -68700,7 +68728,7 @@ var init_generate2 = __esm({
       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);
@@ -68899,15 +68927,15 @@ var init_generate2 = __esm({
 });
 
 // src/tools/manifest/storyboard.ts
-import { existsSync as existsSync53 } from "node:fs";
-import { readFile as readFile48, writeFile as writeFile52 } from "node:fs/promises";
-import { resolve as resolve74 } from "node:path";
+import { existsSync as existsSync54 } from "node:fs";
+import { readFile as readFile49, writeFile as writeFile53 } from "node:fs/promises";
+import { resolve as resolve76 } from "node:path";
 async function readStoryboard2(projectDir) {
-  const path2 = resolve74(projectDir, "STORYBOARD.md");
-  if (!existsSync53(path2)) return null;
-  return { path: path2, markdown: await readFile48(path2, "utf-8") };
+  const path2 = resolve76(projectDir, "STORYBOARD.md");
+  if (!existsSync54(path2)) return null;
+  return { path: path2, markdown: await readFile49(path2, "utf-8") };
 }
-var projectDirSchema, storyboardListTool, storyboardValidateTool, storyboardGetTool, storyboardSetTool, storyboardMoveTool, storyboardReviseTool, planTool, storyboardTools;
+var PROJECT_DIR_DESCRIPTION3, projectDirSchema, storyboardListTool, storyboardValidateTool, storyboardGetTool, storyboardSetTool, storyboardMoveTool, storyboardReviseTool, planTool, storyboardTools;
 var init_storyboard2 = __esm({
   "src/tools/manifest/storyboard.ts"() {
     "use strict";
@@ -68917,8 +68945,9 @@ var init_storyboard2 = __esm({
     init_storyboard_edit();
     init_storyboard_revise();
     init_build_plan();
+    PROJECT_DIR_DESCRIPTION3 = "Project directory. Defaults to the surface's cwd; in MCP hosts, relative paths resolve under the configured server workspace.";
     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)
     });
     storyboardListTool = defineTool({
       name: "storyboard_list",
@@ -68927,7 +68956,7 @@ var init_storyboard2 = __esm({
       description: "List beats, ids, durations, and cue blocks from a project's STORYBOARD.md.",
       schema: projectDirSchema,
       async execute(args, ctx) {
-        const projectDir = args.projectDir ? resolve74(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
+        const projectDir = args.projectDir ? resolve76(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
         const file = await readStoryboard2(projectDir);
         if (!file) return { success: false, error: `STORYBOARD.md not found in ${projectDir}` };
         const parsed = parseStoryboard(file.markdown);
@@ -68953,7 +68982,7 @@ var init_storyboard2 = __esm({
       description: "Validate STORYBOARD.md beat ids and cue blocks.",
       schema: projectDirSchema,
       async execute(args, ctx) {
-        const projectDir = args.projectDir ? resolve74(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
+        const projectDir = args.projectDir ? resolve76(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
         const file = await readStoryboard2(projectDir);
         if (!file) return { success: false, error: `STORYBOARD.md not found in ${projectDir}` };
         const result = validateStoryboardMarkdown(file.markdown);
@@ -68982,11 +69011,11 @@ var init_storyboard2 = __esm({
       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) {
-        const projectDir = args.projectDir ? resolve74(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
+        const projectDir = args.projectDir ? resolve76(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
         const file = await readStoryboard2(projectDir);
         if (!file) return { success: false, error: `STORYBOARD.md not found in ${projectDir}` };
         const beat = getStoryboardBeat(file.markdown, args.beat);
@@ -69004,7 +69033,7 @@ var init_storyboard2 = __esm({
       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."),
@@ -69012,7 +69041,7 @@ var init_storyboard2 = __esm({
         unset: external_exports.boolean().optional().describe("Remove the cue key.")
       }),
       async execute(args, ctx) {
-        const projectDir = args.projectDir ? resolve74(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
+        const projectDir = args.projectDir ? resolve76(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
         const file = await readStoryboard2(projectDir);
         if (!file) return { success: false, error: `STORYBOARD.md not found in ${projectDir}` };
         try {
@@ -69023,7 +69052,7 @@ var init_storyboard2 = __esm({
             value,
             unset: args.unset
           });
-          await writeFile52(file.path, next, "utf-8");
+          await writeFile53(file.path, next, "utf-8");
           return {
             success: true,
             data: { beat: args.beat, key: args.key },
@@ -69040,12 +69069,12 @@ var init_storyboard2 = __esm({
       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.")
       }),
       async execute(args, ctx) {
-        const projectDir = args.projectDir ? resolve74(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
+        const projectDir = args.projectDir ? resolve76(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
         const file = await readStoryboard2(projectDir);
         if (!file) return { success: false, error: `STORYBOARD.md not found in ${projectDir}` };
         try {
@@ -69053,7 +69082,7 @@ var init_storyboard2 = __esm({
             beatId: args.beat,
             afterBeatId: args.after
           });
-          await writeFile52(file.path, next, "utf-8");
+          await writeFile53(file.path, next, "utf-8");
           return {
             success: true,
             data: { beat: args.beat, after: args.after },
@@ -69070,14 +69099,14 @@ var init_storyboard2 = __esm({
       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."),
         dryRun: external_exports.boolean().optional().describe("Preview the revised storyboard without writing.")
       }),
       async execute(args, ctx) {
-        const projectDir = args.projectDir ? resolve74(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
+        const projectDir = args.projectDir ? resolve76(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
         const result = await executeStoryboardRevision({
           projectDir,
           request: args.request,
@@ -69101,7 +69130,7 @@ var init_storyboard2 = __esm({
       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."),
@@ -69120,7 +69149,7 @@ var init_storyboard2 = __esm({
         force: external_exports.boolean().optional().describe("Plan regeneration even when outputs exist.")
       }),
       async execute(args, ctx) {
-        const projectDir = args.projectDir ? resolve74(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
+        const projectDir = args.projectDir ? resolve76(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
         const plan = await createBuildPlan({
           projectDir,
           stage: args.stage,
@@ -69163,9 +69192,9 @@ var init_storyboard2 = __esm({
 });
 
 // src/tools/manifest/remix.ts
-import { writeFile as writeFile53 } from "node:fs/promises";
+import { writeFile as writeFile54 } from "node:fs/promises";
 import { tmpdir as tmpdir4 } from "node:os";
-import { join as join24 } from "node:path";
+import { join as join25 } from "node:path";
 var pipelineHighlightsTool, pipelineAutoShortsTool, pipelineRunTool, pipelineRegenerateSceneTool, remixTools;
 var init_remix = __esm({
   "src/tools/manifest/remix.ts"() {
@@ -69273,8 +69302,8 @@ var init_remix = __esm({
         let resolvedPath = args.pipelinePath;
         let tempPath;
         if (args.pipelineYaml) {
-          tempPath = join24(tmpdir4(), `vibe-mcp-pipeline-${Date.now()}.yaml`);
-          await writeFile53(tempPath, args.pipelineYaml, "utf-8");
+          tempPath = join25(tmpdir4(), `vibe-mcp-pipeline-${Date.now()}.yaml`);
+          await writeFile54(tempPath, args.pipelineYaml, "utf-8");
           resolvedPath = tempPath;
         }
         try {
@@ -69441,15 +69470,15 @@ var init_detect2 = __esm({
 });
 
 // src/tools/manifest/_project-io.ts
-import { readFile as readFile49, writeFile as writeFile54 } from "node:fs/promises";
+import { readFile as readFile50, writeFile as writeFile55 } from "node:fs/promises";
 async function loadProject2(projectPath, cwd) {
   const absPath = await resolveTimelineFile(projectPath, cwd);
-  const content = await readFile49(absPath, "utf-8");
+  const content = await readFile50(absPath, "utf-8");
   const data = JSON.parse(content);
   return { project: Project.fromJSON(data), absPath };
 }
 async function saveProject(absPath, project) {
-  await writeFile54(absPath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
+  await writeFile55(absPath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
 }
 var init_project_io = __esm({
   "src/tools/manifest/_project-io.ts"() {
@@ -69460,8 +69489,8 @@ var init_project_io = __esm({
 });
 
 // src/tools/manifest/timeline.ts
-import { mkdir as mkdir27, writeFile as writeFile55 } from "node:fs/promises";
-import { basename as basename23, resolve as resolve75 } from "node:path";
+import { mkdir as mkdir28, writeFile as writeFile56 } from "node:fs/promises";
+import { basename as basename23, resolve as resolve77 } from "node:path";
 var MEDIA_TYPES, timelineCreateTool, timelineInfoTool, timelineAddSourceTool, timelineAddClipTool, timelineSplitClipTool, timelineTrimClipTool, timelineMoveClipTool, timelineDeleteClipTool, timelineDuplicateClipTool, timelineAddEffectTool, timelineAddTrackTool, timelineListTool, timelineTools;
 var init_timeline = __esm({
   "src/tools/manifest/timeline.ts"() {
@@ -69497,18 +69526,18 @@ var init_timeline = __esm({
         fps: external_exports.number().optional().describe("Frames per second (default: 30)")
       }),
       async execute(args, ctx) {
-        const projectName = args.name === "." ? basename23(ctx.workingDirectory) : basename23(resolve75(ctx.workingDirectory, args.name));
+        const projectName = args.name === "." ? basename23(ctx.workingDirectory) : basename23(resolve77(ctx.workingDirectory, args.name));
         const project = new Project(projectName);
         if (args.fps) project.setFrameRate(args.fps);
         let outputPath;
         if (args.outputPath) {
-          outputPath = resolve75(ctx.workingDirectory, args.outputPath);
+          outputPath = resolve77(ctx.workingDirectory, args.outputPath);
         } else {
-          const dirPath = resolve75(ctx.workingDirectory, args.name);
-          await mkdir27(dirPath, { recursive: true });
-          outputPath = resolve75(dirPath, TIMELINE_FILENAME);
+          const dirPath = resolve77(ctx.workingDirectory, args.name);
+          await mkdir28(dirPath, { recursive: true });
+          outputPath = resolve77(dirPath, TIMELINE_FILENAME);
         }
-        await writeFile55(outputPath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
+        await writeFile56(outputPath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
         return {
           success: true,
           data: { name: projectName, outputPath },
@@ -69556,7 +69585,7 @@ var init_timeline = __esm({
       }),
       async execute(args, ctx) {
         const { project, absPath } = await loadProject2(args.projectPath, ctx.workingDirectory);
-        const mediaPath = resolve75(ctx.workingDirectory, args.mediaPath);
+        const mediaPath = resolve77(ctx.workingDirectory, args.mediaPath);
         const ext = mediaPath.split(".").pop()?.toLowerCase() ?? "";
         const source = project.addSource({
           name: args.name ?? mediaPath.split("/").pop() ?? "media",
@@ -69784,8 +69813,8 @@ var init_timeline = __esm({
 });
 
 // src/tools/manifest/project.ts
-import { resolve as resolve76 } from "node:path";
-import { writeFile as writeFile56 } from "node:fs/promises";
+import { resolve as resolve78 } from "node:path";
+import { writeFile as writeFile57 } from "node:fs/promises";
 var projectCreateTool, projectInfoTool, projectTools;
 var init_project2 = __esm({
   "src/tools/manifest/project.ts"() {
@@ -69807,10 +69836,10 @@ var init_project2 = __esm({
         fps: external_exports.number().optional().describe("Frames per second (default: 30)")
       }),
       async execute(args, ctx) {
-        const outputPath = resolve76(ctx.workingDirectory, args.outputPath ?? `${args.name}.vibe.json`);
+        const outputPath = resolve78(ctx.workingDirectory, args.outputPath ?? `${args.name}.vibe.json`);
         const project = new Project(args.name);
         if (args.fps) project.setFrameRate(args.fps);
-        await writeFile56(outputPath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
+        await writeFile57(outputPath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
         return {
           success: true,
           data: { name: args.name, outputPath },
@@ -69853,8 +69882,8 @@ var init_project2 = __esm({
 });
 
 // src/commands/export.ts
-import { readFile as readFile50, access as access7 } from "node:fs/promises";
-import { resolve as resolve77, basename as basename24 } from "node:path";
+import { readFile as readFile51, access as access7 } from "node:fs/promises";
+import { resolve as resolve79, basename as basename24 } from "node:path";
 import { spawn as spawn3 } from "node:child_process";
 function timelineBaseName(path2) {
   const name = basename24(path2);
@@ -69922,7 +69951,7 @@ async function runExport(projectPath, outputPath, options = {}) {
       };
     }
     const filePath = await resolveTimelineFile(projectPath);
-    const content = await readFile50(filePath, "utf-8");
+    const content = await readFile51(filePath, "utf-8");
     const data = JSON.parse(content);
     const project = Project.fromJSON(data);
     const summary = project.getSummary();
@@ -69932,7 +69961,7 @@ async function runExport(projectPath, outputPath, options = {}) {
         message: "Project has no clips to export"
       };
     }
-    const finalOutputPath = resolve77(process.cwd(), outputPath);
+    const finalOutputPath = resolve79(process.cwd(), outputPath);
     const basePresetSettings = getPresetSettings(preset, summary.aspectRatio);
     const presetSettings = applyCustomOverrides(basePresetSettings, { bitrate, fps, resolution, codec });
     const clips = project.getClips().sort((a, b) => a.startTime - b.startTime);
@@ -70328,7 +70357,7 @@ function buildFFmpegArgs(clips, sources, presetSettings, outputPath, options, so
   return args;
 }
 function runFFmpegProcess(ffmpegPath, args, onProgress) {
-  return new Promise((resolve81, reject) => {
+  return new Promise((resolve83, reject) => {
     const ffmpeg = spawn3(ffmpegPath, args, {
       stdio: ["pipe", "pipe", "pipe"]
     });
@@ -70352,7 +70381,7 @@ function runFFmpegProcess(ffmpegPath, args, onProgress) {
     });
     ffmpeg.on("close", (code) => {
       if (code === 0) {
-        resolve81();
+        resolve83();
       } else {
         const errorMatch = stderr.match(/Error.*$/m);
         const errorMsg = errorMatch ? errorMatch[0] : `FFmpeg exited with code ${code}`;
@@ -70488,17 +70517,17 @@ function getPresetSettings(preset, aspectRatio2) {
 }
 async function runHyperframesExport(projectPath, options, spinner2, startedAt) {
   spinner2.text = "Loading project...";
-  const { readFile: readFile52 } = await import("node:fs/promises");
-  const { resolve: resolve81 } = await import("node:path");
+  const { readFile: readFile53 } = await import("node:fs/promises");
+  const { resolve: resolve83 } = 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 = await resolveTimelineFile(projectPath);
-  const content = await readFile52(filePath, "utf-8");
+  const content = await readFile53(filePath, "utf-8");
   const project = Project2.fromJSON(JSON.parse(content));
   const state = project.getState();
-  const outputPath = options.output ? resolve81(process.cwd(), options.output) : resolve81(process.cwd(), `${timelineBaseName(projectPath)}.${options.format ?? "mp4"}`);
+  const outputPath = options.output ? resolve83(process.cwd(), options.output) : resolve83(process.cwd(), `${timelineBaseName(projectPath)}.${options.format ?? "mp4"}`);
   const quality = ["draft", "standard", "high"].includes(options.preset ?? "") ? options.preset : "standard";
   const backend = createHyperframesBackend2();
   spinner2.text = "Rendering with Hyperframes...";
@@ -70617,7 +70646,7 @@ Run 'vibe schema export' for structured parameter info.`).action(async (projectP
         }
         spinner2.text = "Loading project...";
         const filePath = await resolveTimelineFile(projectPath);
-        const content = await readFile50(filePath, "utf-8");
+        const content = await readFile51(filePath, "utf-8");
         const data = JSON.parse(content);
         const project = Project.fromJSON(data);
         const summary = project.getSummary();
@@ -70625,7 +70654,7 @@ Run 'vibe schema export' for structured parameter info.`).action(async (projectP
           spinner2.fail("Project has no clips to export");
           exitWithError(usageError("Project has no clips to export"));
         }
-        const outputPath = options.output ? resolve77(process.cwd(), options.output) : resolve77(
+        const outputPath = options.output ? resolve79(process.cwd(), options.output) : resolve79(
           process.cwd(),
           `${timelineBaseName(projectPath)}.${options.format}`
         );
@@ -70709,7 +70738,7 @@ Run 'vibe schema export' for structured parameter info.`).action(async (projectP
 });
 
 // src/tools/manifest/export.ts
-import { resolve as resolve78 } from "node:path";
+import { resolve as resolve80 } from "node:path";
 var exportVideoTool, exportTools;
 var init_export2 = __esm({
   "src/tools/manifest/export.ts"() {
@@ -70730,8 +70759,8 @@ var init_export2 = __esm({
         overwrite: external_exports.boolean().optional().describe("Overwrite existing output file (default: false)")
       }),
       async execute(args, ctx) {
-        const projectPath = resolve78(ctx.workingDirectory, args.projectPath);
-        const outputPath = resolve78(ctx.workingDirectory, args.outputPath);
+        const projectPath = resolve80(ctx.workingDirectory, args.projectPath);
+        const outputPath = resolve80(ctx.workingDirectory, args.outputPath);
         const result = await runExport(projectPath, outputPath, {
           preset: args.preset,
           format: args.format,
@@ -70750,8 +70779,8 @@ var init_export2 = __esm({
 });
 
 // src/tools/manifest/agent-only.ts
-import { readFile as readFile51, writeFile as writeFile57, readdir as readdir7, stat as stat9, access as access8, unlink as unlink4 } from "node:fs/promises";
-import { resolve as resolve79, join as join25, basename as basename25, extname as extname16 } from "node:path";
+import { readFile as readFile52, writeFile as writeFile58, readdir as readdir7, stat as stat9, access as access8, unlink as unlink4 } from "node:fs/promises";
+import { resolve as resolve81, join as join26, basename as basename25, extname as extname16 } from "node:path";
 function matchPattern(filename, pattern) {
   const regex2 = new RegExp(
     "^" + pattern.replace(/\./g, "\\.").replace(/\*/g, ".*").replace(/\?/g, ".") + "$",
@@ -70829,12 +70858,12 @@ var init_agent_only = __esm({
       async execute(args, ctx) {
         const dirPath = args.path ?? ".";
         try {
-          const absPath = resolve79(ctx.workingDirectory, dirPath);
+          const absPath = resolve81(ctx.workingDirectory, dirPath);
           const entries = await readdir7(absPath, { withFileTypes: true });
           const results = [];
           for (const entry of entries) {
             if (args.pattern && !matchPattern(entry.name, args.pattern)) continue;
-            const fullPath = join25(absPath, entry.name);
+            const fullPath = join26(absPath, entry.name);
             const stats = await stat9(fullPath);
             if (entry.isDirectory()) {
               results.push(`[DIR]  ${entry.name}/`);
@@ -70860,8 +70889,8 @@ var init_agent_only = __esm({
       }),
       async execute(args, ctx) {
         try {
-          const absPath = resolve79(ctx.workingDirectory, args.path);
-          const content = await readFile51(absPath, "utf-8");
+          const absPath = resolve81(ctx.workingDirectory, args.path);
+          const content = await readFile52(absPath, "utf-8");
           const maxLength = 4e3;
           const truncated = content.length > maxLength;
           const output = truncated ? content.substring(0, maxLength) + "\n... (truncated)" : content;
@@ -70883,8 +70912,8 @@ var init_agent_only = __esm({
       }),
       async execute(args, ctx) {
         try {
-          const absPath = resolve79(ctx.workingDirectory, args.path);
-          await writeFile57(absPath, args.content, "utf-8");
+          const absPath = resolve81(ctx.workingDirectory, args.path);
+          await writeFile58(absPath, args.content, "utf-8");
           return { success: true, data: { bytes: args.content.length }, humanLines: [`File written: ${args.path} (${formatSize(args.content.length)})`] };
         } catch (error) {
           return { success: false, error: `Failed to write file: ${error instanceof Error ? error.message : String(error)}` };
@@ -70901,7 +70930,7 @@ var init_agent_only = __esm({
         path: external_exports.string().describe("Path to check")
       }),
       async execute(args, ctx) {
-        const absPath = resolve79(ctx.workingDirectory, args.path);
+        const absPath = resolve81(ctx.workingDirectory, args.path);
         try {
           await access8(absPath);
           const stats = await stat9(absPath);
@@ -70927,11 +70956,11 @@ var init_agent_only = __esm({
       }),
       async execute(args, ctx) {
         try {
-          const filePath = resolve79(ctx.workingDirectory, args.project);
-          const content = await readFile51(filePath, "utf-8");
+          const filePath = resolve81(ctx.workingDirectory, args.project);
+          const content = await readFile52(filePath, "utf-8");
           const data = JSON.parse(content);
           const project = Project.fromJSON(data);
-          const dirPath = resolve79(ctx.workingDirectory, args.directory);
+          const dirPath = resolve81(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;
@@ -70939,7 +70968,7 @@ var init_agent_only = __esm({
           const scanDir = async (dir) => {
             const entries = await readdir7(dir, { withFileTypes: true });
             for (const entry of entries) {
-              const entryPath = join25(dir, entry.name);
+              const entryPath = join26(dir, entry.name);
               if (entry.isDirectory() && recursive) {
                 await scanDir(entryPath);
               } else if (entry.isFile()) {
@@ -70966,7 +70995,7 @@ var init_agent_only = __esm({
             const source = project.addSource({ name: mediaName, type: mediaType, url: mediaFile, duration });
             addedSources.push({ id: source.id, name: mediaName, type: mediaType });
           }
-          await writeFile57(filePath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
+          await writeFile58(filePath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
           return {
             success: true,
             data: { count: addedSources.length, sources: addedSources },
@@ -70997,8 +71026,8 @@ var init_agent_only = __esm({
       }),
       async execute(args, ctx) {
         try {
-          const filePath = resolve79(ctx.workingDirectory, args.project);
-          const content = await readFile51(filePath, "utf-8");
+          const filePath = resolve81(ctx.workingDirectory, args.project);
+          const content = await readFile52(filePath, "utf-8");
           const data = JSON.parse(content);
           const project = Project.fromJSON(data);
           const sourceIds = args.sourceIds ?? [];
@@ -71034,7 +71063,7 @@ var init_agent_only = __esm({
             createdClips.push({ id: clip.id, sourceName: source.name, startTime: currentTime, duration: source.duration });
             currentTime += source.duration + gap;
           }
-          await writeFile57(filePath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
+          await writeFile58(filePath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
           const totalDuration = currentTime - gap - startTime;
           return {
             success: true,
@@ -71066,8 +71095,8 @@ var init_agent_only = __esm({
       }),
       async execute(args, ctx) {
         try {
-          const filePath = resolve79(ctx.workingDirectory, args.project);
-          const content = await readFile51(filePath, "utf-8");
+          const filePath = resolve81(ctx.workingDirectory, args.project);
+          const content = await readFile52(filePath, "utf-8");
           const data = JSON.parse(content);
           const project = Project.fromJSON(data);
           const clipIds = args.clipIds ?? [];
@@ -71095,7 +71124,7 @@ var init_agent_only = __esm({
             });
             if (effect) appliedEffects.push({ clipId: clip.id, effectId: effect.id });
           }
-          await writeFile57(filePath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
+          await writeFile58(filePath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
           return {
             success: true,
             data: { applied: appliedEffects.length, effectType: args.effectType },
@@ -71120,7 +71149,7 @@ var init_agent_only = __esm({
       async execute(args, ctx) {
         try {
           const filePath = await resolveTimelineFile(args.project, ctx.workingDirectory);
-          const content = await readFile51(filePath, "utf-8");
+          const content = await readFile52(filePath, "utf-8");
           const data = JSON.parse(content);
           const project = Project.fromJSON(data);
           const what = args.what ?? "clips";
@@ -71162,7 +71191,7 @@ var init_agent_only = __esm({
               removed.sources++;
             }
           }
-          await writeFile57(filePath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
+          await writeFile58(filePath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
           const parts = [];
           if (removed.clips > 0) parts.push(`${removed.clips} clips`);
           if (removed.tracks > 0) parts.push(`${removed.tracks} tracks`);
@@ -71195,7 +71224,7 @@ var init_agent_only = __esm({
       async execute(args, ctx) {
         try {
           const filePath = await resolveTimelineFile(args.projectPath, ctx.workingDirectory);
-          const content = await readFile51(filePath, "utf-8");
+          const content = await readFile52(filePath, "utf-8");
           const data = JSON.parse(content);
           const project = Project.fromJSON(data);
           const updates = [];
@@ -71211,7 +71240,7 @@ var init_agent_only = __esm({
             project.setFrameRate(args.fps);
             updates.push(`Frame Rate: ${args.fps} fps`);
           }
-          await writeFile57(filePath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
+          await writeFile58(filePath, JSON.stringify(project.toJSON(), null, 2), "utf-8");
           return {
             success: true,
             data: { updates },
@@ -71344,7 +71373,7 @@ var init_agent_only = __esm({
       }),
       async execute(args, ctx) {
         try {
-          const absPath = resolve79(ctx.workingDirectory, args.path);
+          const absPath = resolve81(ctx.workingDirectory, args.path);
           const { stdout } = await execSafe(
             "ffprobe",
             ["-v", "quiet", "-print_format", "json", "-show_format", "-show_streams", absPath],
@@ -71431,10 +71460,10 @@ Audio:`);
       }),
       async execute(args, ctx) {
         try {
-          const absInput = resolve79(ctx.workingDirectory, args.input);
+          const absInput = resolve81(ctx.workingDirectory, args.input);
           const ext = args.input.split(".").pop() || "mp4";
           const baseName = args.input.replace(/\.[^/.]+$/, "");
-          const outputPath = args.output ? resolve79(ctx.workingDirectory, args.output) : resolve79(ctx.workingDirectory, `${baseName}-compressed.${ext}`);
+          const outputPath = args.output ? resolve81(ctx.workingDirectory, args.output) : resolve81(ctx.workingDirectory, `${baseName}-compressed.${ext}`);
           const crfValues = { low: 28, medium: 23, high: 18 };
           const crf = crfValues[args.quality ?? "medium"];
           await execSafe(
@@ -71457,8 +71486,8 @@ Audio:`);
             ],
             { maxBuffer: 50 * 1024 * 1024 }
           );
-          const inputBuf = await readFile51(absInput);
-          const outputBuf = await readFile51(outputPath);
+          const inputBuf = await readFile52(absInput);
+          const outputBuf = await readFile52(outputPath);
           const inputSize = inputBuf.length;
           const outputSize = outputBuf.length;
           const reduction = (inputSize - outputSize) / inputSize * 100;
@@ -71492,8 +71521,8 @@ Audio:`);
       }),
       async execute(args, ctx) {
         try {
-          const absInput = resolve79(ctx.workingDirectory, args.input);
-          const absOutput = resolve79(ctx.workingDirectory, args.output);
+          const absInput = resolve81(ctx.workingDirectory, args.input);
+          const absOutput = resolve81(ctx.workingDirectory, args.output);
           const codecMap = {
             h264: "libx264",
             h265: "libx265",
@@ -71544,11 +71573,11 @@ Audio:`);
           };
         }
         try {
-          const absOutput = resolve79(ctx.workingDirectory, args.output);
+          const absOutput = resolve81(ctx.workingDirectory, args.output);
           if (args.reencode) {
             const ffmpegArgs = [];
             for (const i of args.inputs) {
-              ffmpegArgs.push("-i", resolve79(ctx.workingDirectory, i));
+              ffmpegArgs.push("-i", resolve81(ctx.workingDirectory, i));
             }
             const filterComplex = args.inputs.map((_, i) => `[${i}:v][${i}:a]`).join("");
             ffmpegArgs.push(
@@ -71563,9 +71592,9 @@ Audio:`);
             );
             await execSafe("ffmpeg", ffmpegArgs, { maxBuffer: 100 * 1024 * 1024 });
           } else {
-            const tempList = resolve79(ctx.workingDirectory, `concat-list-${Date.now()}.txt`);
-            const listContent = args.inputs.map((i) => `file '${resolve79(ctx.workingDirectory, i)}'`).join("\n");
-            await writeFile57(tempList, listContent, "utf-8");
+            const tempList = resolve81(ctx.workingDirectory, `concat-list-${Date.now()}.txt`);
+            const listContent = args.inputs.map((i) => `file '${resolve81(ctx.workingDirectory, i)}'`).join("\n");
+            await writeFile58(tempList, listContent, "utf-8");
             try {
               await execSafe(
                 "ffmpeg",
@@ -71659,14 +71688,15 @@ var init_walkthrough = __esm({
 });
 
 // src/tools/manifest/status.ts
-import { resolve as resolve80 } from "node:path";
-var statusJobTool, statusProjectTool, statusTools;
+import { resolve as resolve82 } from "node:path";
+var PROJECT_DIR_DESCRIPTION4, statusJobTool, statusProjectTool, statusTools;
 var init_status = __esm({
   "src/tools/manifest/status.ts"() {
     "use strict";
     init_zod();
     init_define_tool();
     init_status_jobs();
+    PROJECT_DIR_DESCRIPTION4 = "Project directory. Defaults to the surface's cwd; in MCP hosts, relative paths resolve under the configured server workspace.";
     statusJobTool = defineTool({
       name: "status_job",
       category: "status",
@@ -71674,13 +71704,13 @@ var init_status = __esm({
       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.")
       }),
       async execute(args, ctx) {
-        const projectDir = args.projectDir ? resolve80(ctx.workingDirectory, args.projectDir) : findProjectRoot(ctx.workingDirectory);
+        const projectDir = args.projectDir ? resolve82(ctx.workingDirectory, args.projectDir) : findProjectRoot(ctx.workingDirectory);
         const record = await readJobRecord(args.jobId, projectDir);
         if (!record) return { success: false, error: `Job not found: ${args.jobId}` };
         const result = args.refresh === false ? makeJobStatusResult(record, {
@@ -71689,7 +71719,7 @@ var init_status = __esm({
           warnings: []
         }) : await refreshJobRecord(record, {
           wait: args.wait,
-          output: args.output ? resolve80(ctx.workingDirectory, args.output) : void 0,
+          output: args.output ? resolve82(ctx.workingDirectory, args.output) : void 0,
           workingDirectory: ctx.workingDirectory
         });
         return {
@@ -71708,15 +71738,19 @@ var init_status = __esm({
       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) {
-        const projectDir = args.projectDir ? resolve80(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
+        const projectDir = args.projectDir ? resolve82(ctx.workingDirectory, args.projectDir) : ctx.workingDirectory;
         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"}`] : [],
@@ -71994,8 +72028,8 @@ init_source();
 // package.json
 var package_default = {
   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: {
@@ -78013,9 +78047,9 @@ function parseLrc(lrcString) {
       const minutes = Number.parseInt(match[1], 10);
       const seconds = Number.parseInt(match[2], 10);
       const ms = match[3].length === 3 ? Number.parseInt(match[3], 10) : Number.parseInt(match[3], 10) * 10;
-      const timestamp = (minutes * 60 + seconds) * 1e3 + ms;
+      const timestamp2 = (minutes * 60 + seconds) * 1e3 + ms;
       const text = line.replace(TIMESTAMP_REGEX, "").trim();
-      syncText.push({ timestamp, text });
+      syncText.push({ timestamp: timestamp2, text });
     }
   }
   return {
@@ -79170,12 +79204,12 @@ function resolveCopier() {
 async function copyToClipboard(text) {
   const opener = resolveCopier();
   if (!opener) return false;
-  return new Promise((resolve81) => {
+  return new Promise((resolve83) => {
     let settled = false;
     const finish = (ok) => {
       if (settled) return;
       settled = true;
-      resolve81(ok);
+      resolve83(ok);
     };
     try {
       const child = spawn2(opener.command, opener.args, {
@@ -80428,9 +80462,9 @@ init_source();
 init_agent_host_detect();
 init_scene_project();
 init_visual_styles();
-import { existsSync as existsSync40 } from "node:fs";
-import { mkdir as mkdir22, readFile as readFile37, writeFile as writeFile44 } from "node:fs/promises";
-import { basename as basename19, dirname as dirname18, resolve as resolve53 } from "node:path";
+import { existsSync as existsSync41 } from "node:fs";
+import { mkdir as mkdir23, readFile as readFile38, writeFile as writeFile45 } from "node:fs/promises";
+import { basename as basename19, dirname as dirname19, resolve as resolve54 } from "node:path";
 
 // src/commands/_shared/storyboard-draft.ts
 init_scene_project();
@@ -80588,6 +80622,306 @@ function escapeRegExp2(value) {
 init_project_config();
 init_install_skill();
 
+// src/commands/_shared/host-integration.ts
+import { existsSync as existsSync40 } from "node:fs";
+import { mkdir as mkdir22, readFile as readFile37, writeFile as writeFile44 } from "node:fs/promises";
+import { homedir as homedir6 } from "node:os";
+import { dirname as dirname18, join as join19, resolve as resolve53 } from "node:path";
+var HOST_SELECTIONS = [
+  "codex",
+  "claude",
+  "claude-code",
+  "claude-desktop",
+  "cursor",
+  "all"
+];
+var VIBEFRAME_MCP_JSON = {
+  command: "npx",
+  args: ["-y", "@vibeframe/mcp-server"]
+};
+var CODEX_MCP_BLOCK = `[mcp_servers.vibeframe]
+command = "npx"
+args = ["-y", "@vibeframe/mcp-server"]
+enabled = true
+`;
+var CODEX_MANAGED_START = "# >>> VibeFrame MCP server >>>";
+var CODEX_MANAGED_END = "# <<< VibeFrame MCP server <<<";
+function hostDefinitions(_projectDir = process.cwd()) {
+  return [
+    {
+      id: "codex",
+      label: "OpenAI Codex",
+      surfaces: ["shell", "project-guidance", "mcp"],
+      guidanceFiles: ["AGENTS.md"],
+      configPath: (dir) => join19(resolve53(dir), ".codex", "config.toml"),
+      configKind: "codex-toml",
+      notes: [
+        "Codex reads AGENTS.md and can also load project-scoped .codex/config.toml after the project is trusted.",
+        "Keep provider/auth keys in VibeFrame config or environment, not in project-local Codex config."
+      ]
+    },
+    {
+      id: "claude-code",
+      label: "Claude Code",
+      surfaces: ["shell", "project-guidance", "mcp"],
+      guidanceFiles: ["AGENTS.md", "CLAUDE.md", ".claude/skills/hyperframes/"],
+      configPath: (dir) => join19(resolve53(dir), ".mcp.json"),
+      configKind: "mcp-json",
+      notes: [
+        "Claude Code can drive vibe directly through shell plus AGENTS.md/CLAUDE.md.",
+        "The MCP entry is optional and gives Claude Code a typed tool surface."
+      ]
+    },
+    {
+      id: "claude-desktop",
+      label: "Claude Desktop",
+      surfaces: ["mcp"],
+      guidanceFiles: [],
+      configPath: (_dir) => claudeDesktopConfigPath(),
+      configKind: "mcp-json",
+      notes: [
+        "Claude Desktop uses MCP config rather than project shell commands.",
+        "With --write, VibeFrame backs up the existing config before merging."
+      ]
+    },
+    {
+      id: "cursor",
+      label: "Cursor",
+      surfaces: ["shell", "project-guidance", "mcp"],
+      guidanceFiles: ["AGENTS.md", ".cursor/rules/hyperframes.mdc"],
+      configPath: (dir) => join19(resolve53(dir), ".cursor", "mcp.json"),
+      configKind: "mcp-json",
+      notes: [
+        "Cursor can use AGENTS.md/rules for shell-driven work and .cursor/mcp.json for typed MCP tools."
+      ]
+    }
+  ];
+}
+function resolveHostSelection(selection) {
+  if (selection === "all") return ["codex", "claude-code", "claude-desktop", "cursor"];
+  if (selection === "claude") return ["claude-code", "claude-desktop"];
+  return [selection];
+}
+function vibeframeMcpJson(host, projectDir) {
+  return host.id === "claude-desktop" ? { ...VIBEFRAME_MCP_JSON, cwd: resolve53(projectDir) } : { ...VIBEFRAME_MCP_JSON };
+}
+function renderHostSnippet(host, projectDir) {
+  if (host.configKind === "codex-toml") return CODEX_MCP_BLOCK.trimEnd();
+  return JSON.stringify({ mcpServers: { vibeframe: vibeframeMcpJson(host, projectDir) } }, null, 2);
+}
+function claudeCodeAddCommand() {
+  return "claude mcp add vibeframe --scope project -- npx -y @vibeframe/mcp-server";
+}
+async function planHostSetup(host, projectDir, opts) {
+  const configPath = host.configPath(projectDir);
+  const snippet = renderHostSnippet(host, projectDir);
+  const files = [];
+  const warnings = [];
+  const nextSteps = hostNextSteps(host);
+  for (const relPath of host.guidanceFiles.filter((p) => !p.endsWith("/"))) {
+    const absPath = join19(resolve53(projectDir), relPath);
+    files.push({
+      path: absPath,
+      status: existsSync40(absPath) ? "skipped-exists" : "missing",
+      reason: existsSync40(absPath) ? "already present" : "run vibe init --agent all first"
+    });
+  }
+  if (!opts.write || opts.dryRun) {
+    files.push({
+      path: configPath,
+      status: opts.write ? "would-merge" : "would-write",
+      reason: opts.write ? "dry run" : "snippet only; pass --write to modify"
+    });
+    return { host, snippet, command: host.id === "claude-code" ? claudeCodeAddCommand() : void 0, configPath, files, warnings, nextSteps };
+  }
+  try {
+    const action = host.configKind === "codex-toml" ? await mergeCodexToml(configPath, { force: opts.force === true }) : await mergeMcpJson(configPath, {
+      server: vibeframeMcpJson(host, projectDir),
+      force: opts.force === true,
+      backup: host.id === "claude-desktop"
+    });
+    files.push(action);
+  } catch (error) {
+    warnings.push(error instanceof Error ? error.message : String(error));
+  }
+  return { host, snippet, command: host.id === "claude-code" ? claudeCodeAddCommand() : void 0, configPath, files, warnings, nextSteps };
+}
+async function inspectHost(host, projectDir) {
+  const configPath = host.configPath(projectDir);
+  const warnings = [];
+  const nextSteps = hostNextSteps(host);
+  const guidanceFiles = host.guidanceFiles.map((relPath) => {
+    const absPath = relPath.endsWith("/") ? join19(resolve53(projectDir), relPath) : join19(resolve53(projectDir), relPath);
+    return {
+      path: absPath,
+      status: existsSync40(absPath) ? "skipped-exists" : "missing",
+      reason: existsSync40(absPath) ? "present" : "missing"
+    };
+  });
+  let configured = false;
+  if (existsSync40(configPath)) {
+    try {
+      const content = await readFile37(configPath, "utf-8");
+      if (host.configKind === "codex-toml") {
+        configured = /\[mcp_servers\.vibeframe\]/.test(content);
+      } else {
+        const json = JSON.parse(content);
+        configured = hasVibeframeMcpServer(json);
+        const server = readVibeframeMcpServer(json);
+        if (host.id === "claude-desktop" && configured && !server?.cwd) {
+          warnings.push(
+            "Claude Desktop vibeframe MCP config has no cwd; run `vibe host setup claude-desktop <workspace> --write` to anchor relative paths."
+          );
+        }
+      }
+    } catch (error) {
+      warnings.push(error instanceof Error ? error.message : String(error));
+    }
+  }
+  return { host, configPath, configured, guidanceFiles, warnings, nextSteps };
+}
+async function mergeMcpJson(configPath, opts) {
+  let root = {};
+  const exists = existsSync40(configPath);
+  if (exists) {
+    const raw = await readFile37(configPath, "utf-8");
+    try {
+      root = raw.trim() ? JSON.parse(raw) : {};
+    } catch (error) {
+      throw new Error(`Invalid JSON in ${configPath}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+  }
+  const mcpServers = typeof root.mcpServers === "object" && root.mcpServers !== null && !Array.isArray(root.mcpServers) ? root.mcpServers : {};
+  if (mcpServers.vibeframe && !opts.force) {
+    const existing = mcpServers.vibeframe;
+    if (canAddMissingCwd(existing, opts.server)) {
+      root.mcpServers = {
+        ...mcpServers,
+        vibeframe: { ...existing, cwd: opts.server.cwd }
+      };
+      await mkdir22(dirname18(configPath), { recursive: true });
+      if (exists && opts.backup) {
+        await writeFile44(`${configPath}.bak-${timestamp()}`, await readFile37(configPath, "utf-8"), "utf-8");
+      }
+      await writeFile44(configPath, JSON.stringify(root, null, 2) + "\n", "utf-8");
+      return { path: configPath, status: "merged", reason: "added cwd to existing vibeframe MCP server" };
+    }
+    return {
+      path: configPath,
+      status: "skipped-exists",
+      reason: "vibeframe MCP server already exists; pass --force to replace"
+    };
+  }
+  root.mcpServers = { ...mcpServers, vibeframe: opts.server };
+  await mkdir22(dirname18(configPath), { recursive: true });
+  if (exists && opts.backup) {
+    await writeFile44(`${configPath}.bak-${timestamp()}`, await readFile37(configPath, "utf-8"), "utf-8");
+  }
+  await writeFile44(configPath, JSON.stringify(root, null, 2) + "\n", "utf-8");
+  return { path: configPath, status: exists ? "merged" : "wrote" };
+}
+async function mergeCodexToml(configPath, opts) {
+  const exists = existsSync40(configPath);
+  const block = `${CODEX_MANAGED_START}
+${CODEX_MCP_BLOCK}${CODEX_MANAGED_END}`;
+  if (!exists) {
+    await mkdir22(dirname18(configPath), { recursive: true });
+    await writeFile44(configPath, `#:schema https://developers.openai.com/codex/config-schema.json
+
+${block}
+`, "utf-8");
+    return { path: configPath, status: "wrote" };
+  }
+  const raw = await readFile37(configPath, "utf-8");
+  if (raw.includes(CODEX_MANAGED_START)) {
+    const updated = raw.replace(
+      new RegExp(`${escapeRegExp3(CODEX_MANAGED_START)}[\\s\\S]*?${escapeRegExp3(CODEX_MANAGED_END)}`),
+      block
+    );
+    await writeFile44(configPath, ensureTrailingNewline(updated), "utf-8");
+    return { path: configPath, status: "merged", reason: "updated managed VibeFrame block" };
+  }
+  if (/\[mcp_servers\.vibeframe\]/.test(raw)) {
+    if (!opts.force) {
+      return {
+        path: configPath,
+        status: "skipped-exists",
+        reason: "vibeframe MCP table already exists; pass --force to replace"
+      };
+    }
+    const updated = raw.replace(/\n?\[mcp_servers\.vibeframe\][\s\S]*?(?=\n\[|$)/, `
+${block}
+`);
+    await writeFile44(configPath, ensureTrailingNewline(updated), "utf-8");
+    return { path: configPath, status: "merged", reason: "replaced existing VibeFrame MCP table" };
+  }
+  await writeFile44(configPath, `${ensureTrailingNewline(raw)}
+${block}
+`, "utf-8");
+  return { path: configPath, status: "merged" };
+}
+function hasVibeframeMcpServer(value) {
+  if (!value || typeof value !== "object") return false;
+  const root = value;
+  if (!root.mcpServers || typeof root.mcpServers !== "object") return false;
+  return Object.prototype.hasOwnProperty.call(root.mcpServers, "vibeframe");
+}
+function readVibeframeMcpServer(value) {
+  if (!value || typeof value !== "object") return null;
+  const root = value;
+  if (!root.mcpServers || typeof root.mcpServers !== "object" || Array.isArray(root.mcpServers)) return null;
+  const server = root.mcpServers.vibeframe;
+  if (!server || typeof server !== "object" || Array.isArray(server)) return null;
+  return server;
+}
+function canAddMissingCwd(existing, target) {
+  if (!target.cwd) return false;
+  if (!existing || typeof existing !== "object" || Array.isArray(existing)) return false;
+  const current = existing;
+  if (current.cwd) return false;
+  if (current.command !== target.command) return false;
+  if (!Array.isArray(current.args)) return false;
+  return JSON.stringify(current.args) === JSON.stringify(target.args);
+}
+function hostNextSteps(host) {
+  if (host.id === "codex") {
+    return [
+      "Trust the project in Codex so .codex/config.toml is loaded.",
+      "Run /mcp in Codex to confirm the vibeframe server is connected."
+    ];
+  }
+  if (host.id === "claude-code") {
+    return [
+      "Restart Claude Code or run /mcp to approve the project-scoped server.",
+      "Use AGENTS.md/CLAUDE.md for shell-driven vibe workflows."
+    ];
+  }
+  if (host.id === "claude-desktop") {
+    return ["Restart Claude Desktop after updating its MCP config."];
+  }
+  return ["Restart Cursor or reload MCP servers, then ask Cursor to use the vibeframe MCP tools."];
+}
+function claudeDesktopConfigPath() {
+  const home = homedir6();
+  if (process.platform === "darwin") {
+    return join19(home, "Library", "Application Support", "Claude", "claude_desktop_config.json");
+  }
+  if (process.platform === "win32") {
+    return join19(process.env.APPDATA ?? join19(home, "AppData", "Roaming"), "Claude", "claude_desktop_config.json");
+  }
+  return join19(home, ".config", "Claude", "claude_desktop_config.json");
+}
+function timestamp() {
+  return (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
+}
+function ensureTrailingNewline(value) {
+  return value.endsWith("\n") ? value : `${value}
+`;
+}
+function escapeRegExp3(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+
 // src/commands/_shared/init-templates.ts
 var AGENTS_MD = `# AGENTS.md
 
@@ -80628,6 +80962,8 @@ vibe schema --list             # full machine-readable catalog (80+)
 vibe schema --list --surface public  # small first-run/product command surface
 vibe schema generate.video     # JSON Schema for any single command
 vibe doctor                    # available providers + system health
+vibe host setup all            # print Codex/Claude/Cursor app integration snippets
+vibe host doctor all --json    # verify project guidance + MCP config
 vibe guide motion              # choose text-overlay vs motion-overlay vs generate motion
 vibe guide scene               # step-by-step authoring guide (scene)
 vibe guide pipeline            # step-by-step authoring guide (pipeline)
@@ -80752,6 +81088,22 @@ unless the user explicitly asks for a non-VibeFrame asset.
 \`.env\` is still supported as a gitignored fallback. Copy \`.env.example\`
 to start if you prefer environment variables.
 
+## App host setup
+
+VibeFrame is CLI-first, not terminal-only. Codex, Claude Code, and Cursor can
+drive the same project through shell commands, and app hosts can also use
+VibeFrame's MCP server as a typed tool surface.
+
+\`\`\`bash
+vibe host setup all         # print snippets only
+vibe host setup all --write # write project/app config
+vibe host doctor all --json # verify readiness
+\`\`\`
+
+Default setup is snippet-only; use \`--write\` when you want VibeFrame to merge
+the generated config. Keep provider keys in \`.vibeframe/config.yaml\`, user
+config, or env files \u2014 not in app host config.
+
 ### Composition rules (scene HTML)
 
 \`vibe init\` installs local composition rules into your project. The
@@ -80942,7 +81294,7 @@ var initCommand = new Command("init").description("Scaffold a VibeFrame project
 ).option(
   "--from <brief>",
   "Draft STORYBOARD.md and DESIGN.md from a brief string or text/markdown file"
-).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) => {
+).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("--mcp", "Also write project-scoped MCP config for Codex/Claude Code/Cursor").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") {
@@ -80958,14 +81310,14 @@ var initCommand = new Command("init").description("Scaffold a VibeFrame project
       usageError(`Invalid --agent: ${agent}`, `Must be one of: ${VALID_AGENTS.join(", ")}`)
     );
   }
-  const projectDir = resolve53(projectDirArg);
+  const projectDir = resolve54(projectDirArg);
   const projectName = basename19(projectDir);
   const targetHosts = resolveTargets(agent);
   const wantsClaude = targetHosts.includes("claude-code");
   const wantsGemini = targetHosts.includes("gemini-cli");
   const wantsCrossTool = targetHosts.some((h) => h !== "claude-code");
   const actions = [];
-  if (!existsSync40(projectDir)) {
+  if (!existsSync41(projectDir)) {
     if (options.dryRun) {
       actions.push({
         path: projectDir,
@@ -80973,13 +81325,13 @@ var initCommand = new Command("init").description("Scaffold a VibeFrame project
         reason: "(would create directory)"
       });
     } else {
-      await mkdir22(projectDir, { recursive: true });
+      await mkdir23(projectDir, { recursive: true });
     }
   }
   if (wantsCrossTool || !wantsClaude) {
     actions.push(
       await writeIfMissing(
-        resolve53(projectDir, "AGENTS.md"),
+        resolve54(projectDir, "AGENTS.md"),
         AGENTS_MD,
         options.force,
         options.dryRun
@@ -80989,7 +81341,7 @@ var initCommand = new Command("init").description("Scaffold a VibeFrame project
   if (wantsClaude) {
     actions.push(
       await writeIfMissing(
-        resolve53(projectDir, "CLAUDE.md"),
+        resolve54(projectDir, "CLAUDE.md"),
         CLAUDE_MD,
         options.force,
         options.dryRun
@@ -80999,7 +81351,7 @@ var initCommand = new Command("init").description("Scaffold a VibeFrame project
   if (wantsGemini) {
     actions.push(
       await writeIfMissing(
-        resolve53(projectDir, "GEMINI.md"),
+        resolve54(projectDir, "GEMINI.md"),
         GEMINI_MD,
         options.force,
         options.dryRun
@@ -81008,18 +81360,18 @@ var initCommand = new Command("init").description("Scaffold a VibeFrame project
   }
   actions.push(
     await writeIfMissing(
-      resolve53(projectDir, ".env.example"),
+      resolve54(projectDir, ".env.example"),
       renderEnvExample(),
       options.force,
       options.dryRun
     )
   );
   actions.push(
-    await mergeGitignore(resolve53(projectDir, ".gitignore"), GITIGNORE_ADDITIONS, options.dryRun)
+    await mergeGitignore(resolve54(projectDir, ".gitignore"), GITIGNORE_ADDITIONS, options.dryRun)
   );
   actions.push(
     await writeIfMissing(
-      resolve53(projectDir, VIBE_CONFIG_FILENAME),
+      resolve54(projectDir, VIBE_CONFIG_FILENAME),
       projectConfigJson({ name: projectName }),
       options.force,
       options.dryRun
@@ -81027,12 +81379,20 @@ var initCommand = new Command("init").description("Scaffold a VibeFrame project
   );
   actions.push(
     await writeIfMissing(
-      resolve53(projectDir, "vibe.project.yaml"),
+      resolve54(projectDir, "vibe.project.yaml"),
       renderProjectYaml({ name: projectName }),
       options.force,
       options.dryRun
     )
   );
+  if (options.mcp === true) {
+    actions.push(
+      ...await setupProjectMcpTargets(projectDir, targetHosts, {
+        force: options.force === true,
+        dryRun: options.dryRun === true
+      })
+    );
+  }
   if (isJsonMode()) {
     outputSuccess({
       command: "init",
@@ -81117,7 +81477,7 @@ async function runSceneInit(projectDirArg, options, startedAt) {
       )
     );
   }
-  const projectDir = resolve53(projectDirArg);
+  const projectDir = resolve54(projectDirArg);
   const projectName = basename19(projectDir);
   const groups = describeSceneScaffold({ dir: projectDir, profile });
   const fromBrief = typeof options.from === "string" && options.from.trim() ? await readBriefOrLiteral(String(options.from), process.cwd()) : null;
@@ -81170,14 +81530,14 @@ async function runSceneInit(projectDirArg, options, startedAt) {
       aspect,
       visualStyle
     });
-    const storyboardPath2 = resolve53(projectDir, "STORYBOARD.md");
-    const designPath = resolve53(projectDir, "DESIGN.md");
-    if (options.force || result.created.includes(storyboardPath2) || !existsSync40(storyboardPath2)) {
-      await writeFile44(storyboardPath2, draft.storyboardMd, "utf-8");
+    const storyboardPath2 = resolve54(projectDir, "STORYBOARD.md");
+    const designPath = resolve54(projectDir, "DESIGN.md");
+    if (options.force || result.created.includes(storyboardPath2) || !existsSync41(storyboardPath2)) {
+      await writeFile45(storyboardPath2, draft.storyboardMd, "utf-8");
       if (!result.created.includes(storyboardPath2)) result.created.push(storyboardPath2);
     }
-    if (options.force || result.created.includes(designPath) || !existsSync40(designPath)) {
-      await writeFile44(designPath, draft.designMd, "utf-8");
+    if (options.force || result.created.includes(designPath) || !existsSync41(designPath)) {
+      await writeFile45(designPath, draft.designMd, "utf-8");
       if (!result.created.includes(designPath)) result.created.push(designPath);
     }
     draftWarnings.push(...draft.warnings);
@@ -81187,6 +81547,10 @@ async function runSceneInit(projectDirArg, options, startedAt) {
     projectDir,
     hosts: deriveInstallHosts(detectedIds)
   }) : { success: true, files: [], bundleVersion: "not-installed" };
+  const mcpActions = options.mcp === true ? await setupProjectMcpTargets(projectDir, detectedIds, {
+    force: options.force === true,
+    dryRun: false
+  }) : [];
   if (isJsonMode()) {
     outputSuccess({
       command: "init",
@@ -81206,6 +81570,7 @@ async function runSceneInit(projectDirArg, options, startedAt) {
         groups: result.groups,
         skillFiles: skillResult.files,
         skillBundleVersion: skillResult.bundleVersion,
+        mcpFiles: mcpActions,
         warnings: draftWarnings
       }
     });
@@ -81243,6 +81608,10 @@ async function runSceneInit(projectDirArg, options, startedAt) {
   for (const f of skillResult.files.filter((f2) => f2.status === "wrote")) {
     console.log(source_default.green(`    + ${f.path.replace(projectDir + "/", "")}`));
   }
+  for (const f of mcpActions) {
+    const icon = f.status === "wrote" || f.status === "merged" ? source_default.green("+") : source_default.dim("\xB7");
+    console.log(`${icon} ${f.path.replace(projectDir + "/", "")} ${source_default.dim(`(${f.status})`)}`);
+  }
   console.log();
   console.log(source_default.dim(`Tip: cd ${projectDirArg} before running the next commands.`));
   console.log();
@@ -81290,9 +81659,9 @@ function printGroup(label, files, projectDir) {
   }
 }
 async function readBriefOrLiteral(value, cwd) {
-  const candidate = resolve53(cwd, value);
-  if (existsSync40(candidate)) {
-    return readFile37(candidate, "utf-8");
+  const candidate = resolve54(cwd, value);
+  if (existsSync41(candidate)) {
+    return readFile38(candidate, "utf-8");
   }
   return value;
 }
@@ -81311,32 +81680,65 @@ function resolveTargets(agent) {
   }
   return [agent];
 }
+async function setupProjectMcpTargets(projectDir, targetHosts, opts) {
+  const ids = /* @__PURE__ */ new Set();
+  if (targetHosts.includes("codex")) ids.add("codex");
+  if (targetHosts.includes("claude-code")) ids.add("claude-code");
+  if (targetHosts.includes("cursor")) ids.add("cursor");
+  if (targetHosts.length === 0) {
+    ids.add("codex");
+    ids.add("claude-code");
+    ids.add("cursor");
+  }
+  const actions = [];
+  for (const host of hostDefinitions(projectDir).filter((h) => ids.has(h.id))) {
+    const plan = await planHostSetup(host, projectDir, {
+      write: true,
+      dryRun: opts.dryRun,
+      force: opts.force
+    });
+    const configAction = plan.files.find((file) => file.path === plan.configPath);
+    if (!configAction) continue;
+    actions.push({
+      path: configAction.path,
+      status: normalizeHostAction(configAction.status),
+      reason: configAction.reason
+    });
+  }
+  return actions;
+}
+function normalizeHostAction(status) {
+  if (status === "merged") return "merged";
+  if (status === "wrote") return "wrote";
+  if (status === "skipped-exists") return "skipped-exists";
+  return "would-write";
+}
 async function writeIfMissing(absPath, content, force, dryRun) {
-  const exists = existsSync40(absPath);
+  const exists = existsSync41(absPath);
   if (exists && !force) {
     return { path: absPath, status: "skipped-exists", reason: "(use --force to overwrite)" };
   }
   if (dryRun) {
     return { path: absPath, status: "would-write" };
   }
-  await mkdir22(dirname18(absPath), { recursive: true });
-  await writeFile44(absPath, content, "utf-8");
+  await mkdir23(dirname19(absPath), { recursive: true });
+  await writeFile45(absPath, content, "utf-8");
   return { path: absPath, status: "wrote" };
 }
 async function mergeGitignore(absPath, additions, dryRun) {
   const marker = "# VibeFrame";
-  if (!existsSync40(absPath)) {
+  if (!existsSync41(absPath)) {
     if (dryRun) return { path: absPath, status: "would-write" };
-    await writeFile44(absPath, additions.trimStart(), "utf-8");
+    await writeFile45(absPath, additions.trimStart(), "utf-8");
     return { path: absPath, status: "wrote" };
   }
-  const existing = await readFile37(absPath, "utf-8");
+  const existing = await readFile38(absPath, "utf-8");
   if (existing.includes(marker)) {
     return { path: absPath, status: "skipped-exists", reason: "(already has VibeFrame block)" };
   }
   if (dryRun) return { path: absPath, status: "merged" };
   const trailing = existing.endsWith("\n") ? "" : "\n";
-  await writeFile44(absPath, existing + trailing + additions, "utf-8");
+  await writeFile45(absPath, existing + trailing + additions, "utf-8");
   return { path: absPath, status: "merged" };
 }
 function formatStatusIcon(status) {
@@ -81363,9 +81765,9 @@ init_storyboard_revise();
 init_composer_resolve();
 init_cost_tier();
 init_output();
-import { readFile as readFile39, writeFile as writeFile46 } from "node:fs/promises";
-import { existsSync as existsSync42 } from "node:fs";
-import { resolve as resolve55 } from "node:path";
+import { readFile as readFile40, writeFile as writeFile47 } from "node:fs/promises";
+import { existsSync as existsSync43 } from "node:fs";
+import { resolve as resolve56 } from "node:path";
 var storyboardCommand = new Command("storyboard").description("Read, validate, and safely mutate STORYBOARD.md cue blocks").addHelpText("after", `
 Examples:
   $ vibe storyboard validate my-video --json
@@ -81377,7 +81779,7 @@ Examples:
 `);
 storyboardCommand.command("list").description("List beats, ids, cues, and durations from STORYBOARD.md").argument("[project-dir]", "Project directory", ".").action(async (projectDirArg) => {
   const startedAt = Date.now();
-  const projectDir = resolve55(projectDirArg);
+  const projectDir = resolve56(projectDirArg);
   const md = await readStoryboard(projectDir);
   const parsed = parseStoryboard(md);
   const data = {
@@ -81399,7 +81801,7 @@ storyboardCommand.command("list").description("List beats, ids, cues, and durati
 });
 storyboardCommand.command("get").description("Print one beat as structured JSON").argument("<project-dir>", "Project directory").argument("<beat>", "Beat id").action(async (projectDirArg, beatId) => {
   const startedAt = Date.now();
-  const projectDir = resolve55(projectDirArg);
+  const projectDir = resolve56(projectDirArg);
   const md = await readStoryboard(projectDir);
   const beat = getStoryboardBeat(md, beatId);
   if (!beat) {
@@ -81422,7 +81824,7 @@ storyboardCommand.command("get").description("Print one beat as structured JSON"
 });
 storyboardCommand.command("set").description("Update one cue in one beat without raw Markdown editing").argument("<project-dir>", "Project directory").argument("<beat>", "Beat id").argument("<key>", `Cue key: ${STORYBOARD_CUE_KEYS.join(" | ")}`).argument("[value...]", "Cue value. Use --json-value to pass a JSON scalar/object.").option("--json-value", "Parse value as JSON instead of a string").option("--unset", "Remove the cue key from the beat").action(async (projectDirArg, beatId, key, valueParts, options) => {
   const startedAt = Date.now();
-  const projectDir = resolve55(projectDirArg);
+  const projectDir = resolve56(projectDirArg);
   if (!options.unset && (!valueParts || valueParts.length === 0)) {
     exitWithError(usageError("Cue value is required unless --unset is passed."));
   }
@@ -81441,7 +81843,7 @@ storyboardCommand.command("set").description("Update one cue in one beat without
   } catch (error) {
     exitWithError(usageError(error instanceof Error ? error.message : String(error)));
   }
-  await writeFile46(storyboardPath(projectDir), next, "utf-8");
+  await writeFile47(storyboardPath(projectDir), next, "utf-8");
   const beat = getStoryboardBeat(next, beatId);
   outputSuccess({
     command: "storyboard set",
@@ -81457,7 +81859,7 @@ storyboardCommand.command("set").description("Update one cue in one beat without
 });
 storyboardCommand.command("move").description("Reorder beats safely").argument("<project-dir>", "Project directory").argument("<beat>", "Beat id to move").requiredOption("--after <beat>", "Place the beat after this beat id").action(async (projectDirArg, beatId, options) => {
   const startedAt = Date.now();
-  const projectDir = resolve55(projectDirArg);
+  const projectDir = resolve56(projectDirArg);
   const md = await readStoryboard(projectDir);
   let next;
   try {
@@ -81465,7 +81867,7 @@ storyboardCommand.command("move").description("Reorder beats safely").argument("
   } catch (error) {
     exitWithError(usageError(error instanceof Error ? error.message : String(error)));
   }
-  await writeFile46(storyboardPath(projectDir), next, "utf-8");
+  await writeFile47(storyboardPath(projectDir), next, "utf-8");
   const parsed = parseStoryboard(next);
   outputSuccess({
     command: "storyboard move",
@@ -81480,7 +81882,7 @@ storyboardCommand.command("move").description("Reorder beats safely").argument("
 });
 storyboardCommand.command("revise").description("Revise STORYBOARD.md from a request or source file").argument("<project-dir>", "Project directory").requiredOption("--from <brief>", "Revision request or path to a text/markdown file").option("-d, --duration <sec>", "Target total duration in seconds").option("--composer <provider>", "Revision LLM provider: claude|openai|gemini").option("--dry-run", "Preview the revised storyboard without writing").action(async (projectDirArg, options) => {
   const startedAt = Date.now();
-  const projectDir = resolve55(projectDirArg);
+  const projectDir = resolve56(projectDirArg);
   const brief = await readBrief(options.from, process.cwd());
   const duration = options.duration ? Number.parseFloat(options.duration) : void 0;
   if (duration !== void 0 && (!Number.isFinite(duration) || duration <= 0)) {
@@ -81512,7 +81914,7 @@ storyboardCommand.command("revise").description("Revise STORYBOARD.md from a req
 });
 storyboardCommand.command("validate").description("Validate cue blocks and beat ids").argument("[project-dir]", "Project directory", ".").action(async (projectDirArg) => {
   const startedAt = Date.now();
-  const projectDir = resolve55(projectDirArg);
+  const projectDir = resolve56(projectDirArg);
   const md = await readStoryboard(projectDir);
   const result = validateStoryboardMarkdown(md);
   if (isJsonMode()) {
@@ -81547,13 +81949,13 @@ storyboardCommand.command("validate").description("Validate cue blocks and beat
 });
 async function readStoryboard(projectDir) {
   const path2 = storyboardPath(projectDir);
-  if (!existsSync42(path2)) {
+  if (!existsSync43(path2)) {
     exitWithError(generalError(`STORYBOARD.md not found at ${path2}`, `Run 'vibe init ${projectDir} --from "<brief>"' first.`));
   }
-  return readFile39(path2, "utf-8");
+  return readFile40(path2, "utf-8");
 }
 function storyboardPath(projectDir) {
-  return resolve55(projectDir, "STORYBOARD.md");
+  return resolve56(projectDir, "STORYBOARD.md");
 }
 function parseComposer(value) {
   if (value === void 0) return void 0;
@@ -81561,9 +81963,9 @@ function parseComposer(value) {
   exitWithError(usageError(`Invalid --composer: ${value}`, "Must be one of: claude, openai, gemini"));
 }
 async function readBrief(value, cwd) {
-  const candidate = resolve55(cwd, value);
-  if (existsSync42(candidate)) {
-    return readFile39(candidate, "utf-8");
+  const candidate = resolve56(cwd, value);
+  if (existsSync43(candidate)) {
+    return readFile40(candidate, "utf-8");
   }
   return value;
 }
@@ -81596,7 +81998,7 @@ init_esm();
 init_source();
 init_build_plan();
 init_output();
-import { resolve as resolve58 } from "node:path";
+import { resolve as resolve59 } from "node:path";
 var VALID_STAGES = ["assets", "compose", "sync", "render", "all"];
 var VALID_MODES = ["agent", "batch", "auto"];
 var VALID_TTS_PROVIDERS = ["auto", "elevenlabs", "kokoro"];
@@ -81644,7 +82046,7 @@ var planCommand = new Command("plan").description("Read STORYBOARD.md and show b
       )
     );
   }
-  const projectDir = resolve58(projectDirArg);
+  const projectDir = resolve59(projectDirArg);
   const plan = await createBuildPlan({
     projectDir,
     stage,
@@ -81789,8 +82191,8 @@ init_scene_build();
 init_build_plan();
 init_storyboard_parse();
 init_output();
-import { resolve as resolve63, join as join23 } from "node:path";
-import { readFileSync as readFileSync3, existsSync as existsSync47 } from "node:fs";
+import { resolve as resolve64, join as join24 } from "node:path";
+import { readFileSync as readFileSync3, existsSync as existsSync48 } from "node:fs";
 var VALID_MODES2 = ["agent", "batch", "auto"];
 var VALID_STAGES2 = ["assets", "compose", "sync", "render", "all"];
 var VALID_IMAGE_PROVIDERS2 = ["openai", "gemini", "grok"];
@@ -81807,7 +82209,7 @@ Examples:
 Advanced equivalent: \`vibe scene build\`.`
 ).action(async (projectDirArg, options) => {
   const startedAt = Date.now();
-  const projectDir = resolve63(projectDirArg);
+  const projectDir = resolve64(projectDirArg);
   const mode = String(options.mode ?? "auto");
   if (!VALID_MODES2.includes(mode)) {
     exitWithError(
@@ -82153,8 +82555,8 @@ function buildPlanValidationFailureData(plan) {
   };
 }
 function estimateBuildCost(params) {
-  const storyboardPath2 = join23(params.projectDir, "STORYBOARD.md");
-  if (!existsSync47(storyboardPath2)) return null;
+  const storyboardPath2 = join24(params.projectDir, "STORYBOARD.md");
+  if (!existsSync48(storyboardPath2)) return null;
   let beats = 0;
   try {
     const md = readFileSync3(storyboardPath2, "utf-8");
@@ -82298,7 +82700,7 @@ init_source();
 init_ora();
 init_scene_render();
 init_output();
-import { resolve as resolve64 } from "node:path";
+import { resolve as resolve65 } from "node:path";
 var VALID_FPS = [24, 30, 60];
 var VALID_QUALITIES = ["draft", "standard", "high"];
 var VALID_FORMATS = ["mp4", "webm", "mov"];
@@ -82309,7 +82711,7 @@ Examples:
 
 Alias note: this is the project-level entrypoint for \`vibe scene render\`.`).action(async (projectDirArg, options) => {
   const startedAt = Date.now();
-  const projectDir = resolve64(projectDirArg);
+  const projectDir = resolve65(projectDirArg);
   const fps = parseFps(String(options.fps));
   const quality = parseQuality(String(options.quality));
   const format = parseFormat(String(options.format));
@@ -82432,7 +82834,7 @@ init_source();
 init_cost_tier();
 init_status_jobs();
 init_output();
-import { resolve as resolve65 } from "node:path";
+import { resolve as resolve66 } from "node:path";
 var statusCommand = new Command("status").description("Inspect local async jobs and project workflow status").addHelpText("after", `
 Examples:
   $ vibe status job job_abc123 --json
@@ -82443,7 +82845,7 @@ Examples:
 statusCommand.command("job").description("Show one async job status").argument("<job-id>", "Local job id from a no-wait command").option("--project <dir>", "Project directory containing .vibeframe/jobs").option("--no-refresh", "Read local job record only; do not call provider APIs").option("--wait", "Wait for completion when the provider status helper supports it").option("-o, --output <path>", "Download result media when complete").action(async (jobId, options) => {
   const startedAt = Date.now();
   try {
-    const projectDir = options.project ? resolve65(options.project) : findProjectRoot();
+    const projectDir = options.project ? resolve66(options.project) : findProjectRoot();
     const record = await readJobRecord(jobId, projectDir);
     if (!record) {
       exitWithError(generalError(`Job not found: ${jobId}`, `Run 'vibe status project ${projectDir} --json' to list known jobs.`));
@@ -82471,7 +82873,7 @@ applyTier(statusCommand.commands[statusCommand.commands.length - 1], "free");
 statusCommand.command("project").description("Summarize build, review, and async job status for a project").argument("[project-dir]", "VibeFrame project directory", ".").option("--refresh", "Refresh active supported jobs before summarizing").action(async (projectDirArg, options) => {
   const startedAt = Date.now();
   try {
-    const result = await inspectProjectStatus(resolve65(projectDirArg), {
+    const result = await inspectProjectStatus(resolve66(projectDirArg), {
       refresh: options.refresh === true
     });
     if (isJsonMode()) {
@@ -82567,8 +82969,8 @@ init_composer_resolve();
 init_cost_tier();
 init_scene_build_mode();
 init_output();
-import { existsSync as existsSync48 } from "node:fs";
-import { resolve as resolve66 } from "node:path";
+import { existsSync as existsSync49 } from "node:fs";
+import { resolve as resolve67 } from "node:path";
 var COMMAND_KEY_MAP = getCommandKeyMap();
 var FREE_COMMANDS = [
   "edit silence-cut",
@@ -82695,14 +83097,14 @@ async function runDiagnostics() {
         installed = false;
       }
     } else if (toolName === "chrome") {
-      const { existsSync: existsSync54 } = await import("node:fs");
-      const { homedir: homedir6 } = await import("node:os");
-      const { join: join26 } = await import("node:path");
+      const { existsSync: existsSync55 } = await import("node:fs");
+      const { homedir: homedir7 } = await import("node:os");
+      const { join: join27 } = await import("node:path");
       const chromePaths = [
         process.env.HYPERFRAMES_CHROME_PATH,
         process.env.CHROME_PATH,
-        join26(
-          homedir6(),
+        join27(
+          homedir7(),
           ".cache",
           "puppeteer",
           "chrome-headless-shell",
@@ -82716,7 +83118,7 @@ async function runDiagnostics() {
         "/usr/bin/chromium",
         "/usr/bin/chromium-browser"
       ];
-      installed = chromePaths.some((p) => p && existsSync54(p));
+      installed = chromePaths.some((p) => p && existsSync55(p));
     } else {
       installed = commandExists(toolName);
     }
@@ -82756,7 +83158,7 @@ async function runDiagnostics() {
   }
   const projectFiles = ["AGENTS.md", "CLAUDE.md", "vibe.project.yaml"].map((rel) => ({
     path: rel,
-    exists: existsSync48(resolve66(cwd, rel))
+    exists: existsSync49(resolve67(cwd, rel))
   }));
   const projectInitialized = projectFiles.some((f) => f.exists);
   const nearestProjectConfigPath = await findProjectConfigPath(cwd);
@@ -82775,8 +83177,8 @@ async function runDiagnostics() {
   } catch (err) {
     if (!(err instanceof ComposerResolveError)) throw err;
   }
-  const sceneProjectInCwd = existsSync48(resolve66(cwd, "STORYBOARD.md"));
-  const skillInstalled = existsSync48(resolve66(cwd, "SKILL.md"));
+  const sceneProjectInCwd = existsSync49(resolve67(cwd, "STORYBOARD.md"));
+  const skillInstalled = existsSync49(resolve67(cwd, "SKILL.md"));
   return {
     system: {
       node: { version: nodeVersion, ok: true },
@@ -83123,6 +83525,198 @@ function pickNextStep(results, hasMissingProviders) {
   return null;
 }
 
+// src/commands/host.ts
+init_esm();
+init_source();
+init_exec_safe();
+init_cost_tier();
+import { resolve as resolve68 } from "node:path";
+init_output();
+var hostCommand = new Command("host").description("Set up Codex, Claude, and Cursor app integrations").addHelpText(
+  "after",
+  `
+Examples:
+  $ vibe host list --json
+  $ vibe host setup all                 Print MCP/project config snippets
+  $ vibe host setup cursor --write      Write .cursor/mcp.json
+  $ vibe host doctor all --json         Check host-app readiness
+`
+);
+hostCommand.command("list").description("List supported app hosts and integration surfaces").action(() => {
+  const startedAt = Date.now();
+  const hosts = hostDefinitions(resolve68(".")).map((host) => ({
+    id: host.id,
+    label: host.label,
+    surfaces: host.surfaces,
+    guidanceFiles: host.guidanceFiles,
+    notes: host.notes
+  }));
+  if (isJsonMode()) {
+    outputSuccess({ command: "host list", startedAt, data: { hosts } });
+    return;
+  }
+  console.log();
+  console.log(source_default.bold.cyan("Supported Host Apps"));
+  console.log(source_default.dim("\u2500".repeat(60)));
+  for (const host of hosts) {
+    console.log(`  ${source_default.bold(host.label)} ${source_default.dim(`(${host.id})`)}`);
+    console.log(source_default.dim(`    surfaces: ${host.surfaces.join(", ")}`));
+    if (host.guidanceFiles.length > 0) {
+      console.log(source_default.dim(`    files:    ${host.guidanceFiles.join(", ")}`));
+    }
+  }
+  console.log();
+});
+applyTier(hostCommand.commands[hostCommand.commands.length - 1], "free");
+hostCommand.command("setup").description("Print or write Codex/Claude/Cursor MCP and project integration config").argument("[host]", `Host target: ${HOST_SELECTIONS.join(" | ")}`, "all").argument("[project-dir]", "Project directory for project-scoped config", ".").option("--write", "Write config files instead of printing snippets only").option("--dry-run", "Show file actions without writing").option("--force", "Replace an existing vibeframe MCP entry").action(async (hostArg, projectDirArg, options) => {
+  const startedAt = Date.now();
+  const selection = validateHostSelection(hostArg);
+  const projectDir = resolve68(projectDirArg);
+  const ids = resolveHostSelection(selection);
+  const defs = hostDefinitions(projectDir).filter((host) => ids.includes(host.id));
+  const plans = [];
+  for (const host of defs) {
+    plans.push(
+      await planHostSetup(host, projectDir, {
+        write: Boolean(options.write),
+        dryRun: Boolean(options.dryRun),
+        force: Boolean(options.force)
+      })
+    );
+  }
+  if (isJsonMode()) {
+    outputSuccess({
+      command: "host setup",
+      startedAt,
+      ...options.dryRun ? { dryRun: true } : {},
+      data: {
+        projectDir,
+        selection,
+        write: Boolean(options.write),
+        hosts: plans.map(serializeSetupPlan)
+      },
+      warnings: plans.flatMap((plan) => plan.warnings)
+    });
+    return;
+  }
+  printSetupPlans(plans, { write: Boolean(options.write), dryRun: Boolean(options.dryRun) });
+});
+applyTier(hostCommand.commands[hostCommand.commands.length - 1], "free");
+hostCommand.command("doctor").description("Check Codex/Claude/Cursor app integration readiness").argument("[host]", `Host target: ${HOST_SELECTIONS.join(" | ")}`, "all").argument("[project-dir]", "Project directory to inspect", ".").action(async (hostArg, projectDirArg) => {
+  const startedAt = Date.now();
+  const selection = validateHostSelection(hostArg);
+  const projectDir = resolve68(projectDirArg);
+  const ids = resolveHostSelection(selection);
+  const defs = hostDefinitions(projectDir).filter((host) => ids.includes(host.id));
+  const hosts = await Promise.all(defs.map((host) => inspectHost(host, projectDir)));
+  const system = {
+    vibe: commandExists("vibe"),
+    npx: commandExists("npx")
+  };
+  const warnings = [
+    ...system.vibe ? [] : ["vibe binary not found on PATH"],
+    ...system.npx ? [] : ["npx not found on PATH; MCP stdio config needs npx"],
+    ...hosts.flatMap((host) => host.warnings)
+  ];
+  if (isJsonMode()) {
+    outputSuccess({
+      command: "host doctor",
+      startedAt,
+      data: {
+        projectDir,
+        selection,
+        system,
+        hosts: hosts.map(serializeDoctorResult)
+      },
+      warnings
+    });
+    return;
+  }
+  printDoctor(hosts, system, warnings);
+});
+applyTier(hostCommand.commands[hostCommand.commands.length - 1], "free");
+function validateHostSelection(value) {
+  if (HOST_SELECTIONS.includes(value)) return value;
+  exitWithError(
+    usageError(`Invalid host target: ${value}`, `Must be one of: ${HOST_SELECTIONS.join(", ")}`)
+  );
+}
+function serializeSetupPlan(plan) {
+  return {
+    id: plan.host.id,
+    label: plan.host.label,
+    surfaces: plan.host.surfaces,
+    configPath: plan.configPath,
+    snippet: plan.snippet,
+    ...plan.command ? { command: plan.command } : {},
+    files: plan.files,
+    warnings: plan.warnings,
+    nextSteps: plan.nextSteps
+  };
+}
+function serializeDoctorResult(result) {
+  return {
+    id: result.host.id,
+    label: result.host.label,
+    surfaces: result.host.surfaces,
+    configPath: result.configPath,
+    configured: result.configured,
+    guidanceFiles: result.guidanceFiles,
+    warnings: result.warnings,
+    nextSteps: result.nextSteps
+  };
+}
+function printSetupPlans(plans, opts) {
+  console.log();
+  console.log(source_default.bold.cyan("VibeFrame Host Setup"));
+  console.log(source_default.dim("\u2500".repeat(60)));
+  if (!opts.write) {
+    console.log(source_default.dim("Snippet mode \u2014 no files were changed. Pass --write to apply."));
+  } else if (opts.dryRun) {
+    console.log(source_default.dim("Dry run \u2014 no files were changed."));
+  }
+  for (const plan of plans) {
+    console.log();
+    console.log(source_default.bold(plan.host.label) + source_default.dim(` (${plan.host.id})`));
+    console.log(source_default.dim(`Config: ${plan.configPath}`));
+    if (plan.command) console.log(source_default.dim(`Command: ${plan.command}`));
+    console.log();
+    console.log(plan.snippet);
+    if (plan.files.length > 0) {
+      console.log();
+      for (const file of plan.files) {
+        console.log(`  ${formatAction(file.status)} ${file.path}${file.reason ? source_default.dim(` ${file.reason}`) : ""}`);
+      }
+    }
+    for (const warning of plan.warnings) console.log(source_default.yellow(`  Warning: ${warning}`));
+  }
+  console.log();
+}
+function printDoctor(hosts, system, warnings) {
+  console.log();
+  console.log(source_default.bold.cyan("VibeFrame Host Doctor"));
+  console.log(source_default.dim("\u2500".repeat(60)));
+  console.log(`  vibe: ${system.vibe ? source_default.green("OK") : source_default.red("MISSING")}`);
+  console.log(`  npx:  ${system.npx ? source_default.green("OK") : source_default.red("MISSING")}`);
+  console.log();
+  for (const host of hosts) {
+    console.log(source_default.bold(host.host.label) + source_default.dim(` (${host.host.id})`));
+    console.log(`  MCP config: ${host.configured ? source_default.green("OK") : source_default.yellow("missing")} ${source_default.dim(host.configPath)}`);
+    for (const file of host.guidanceFiles) {
+      const ok = file.status !== "missing";
+      console.log(`  ${ok ? source_default.green("OK") : source_default.yellow("MISSING")} ${source_default.dim(file.path)}`);
+    }
+    console.log();
+  }
+  for (const warning of warnings) console.log(source_default.yellow(`Warning: ${warning}`));
+}
+function formatAction(status) {
+  if (status === "wrote" || status === "merged") return source_default.green("\u2713");
+  if (status.startsWith("would")) return source_default.cyan("\u2192");
+  if (status === "missing") return source_default.yellow("!");
+  return source_default.dim("\u25CB");
+}
+
 // src/commands/demo.ts
 init_esm();
 init_source();
@@ -83131,10 +83725,10 @@ init_exec_safe();
 init_detect();
 init_ai_edit();
 init_output();
-import { resolve as resolve67 } from "node:path";
-import { existsSync as existsSync49 } from "node:fs";
-import { mkdir as mkdir25, rm as rm4 } from "node:fs/promises";
-var DEMO_DIR = resolve67(process.cwd(), ".vibeframe-demo");
+import { resolve as resolve69 } from "node:path";
+import { existsSync as existsSync50 } from "node:fs";
+import { mkdir as mkdir26, rm as rm4 } from "node:fs/promises";
+var DEMO_DIR = resolve69(process.cwd(), ".vibeframe-demo");
 async function generateTestVideo(outputPath) {
   const filter = [
     // Video: color bars with text
@@ -83163,7 +83757,7 @@ async function generateTestVideo(outputPath) {
       "-y",
       outputPath
     ], { timeout: 3e4, maxBuffer: 50 * 1024 * 1024 });
-    return existsSync49(outputPath);
+    return existsSync50(outputPath);
   } catch {
     try {
       await execSafe("ffmpeg", [
@@ -83189,7 +83783,7 @@ async function generateTestVideo(outputPath) {
         "-y",
         outputPath
       ], { timeout: 3e4, maxBuffer: 50 * 1024 * 1024 });
-      return existsSync49(outputPath);
+      return existsSync50(outputPath);
     } catch {
       return false;
     }
@@ -83213,8 +83807,8 @@ var demoCommand = new Command("demo").description("Run sample edits on a test vi
     console.log(source_default.dim("  " + "\u2500".repeat(50)));
     console.log();
   }
-  await mkdir25(DEMO_DIR, { recursive: true });
-  const testVideo = resolve67(DEMO_DIR, "test-input.mp4");
+  await mkdir26(DEMO_DIR, { recursive: true });
+  const testVideo = resolve69(DEMO_DIR, "test-input.mp4");
   const genSpinner = !isJson ? ora("Generating test video...").start() : null;
   const generated = await generateTestVideo(testVideo);
   if (!generated) {
@@ -83243,7 +83837,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 = resolve67(DEMO_DIR, "silence-cut.mp4");
+        const output = resolve69(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)` };
@@ -83255,7 +83849,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 = resolve67(DEMO_DIR, "noise-reduced.mp4");
+        const output = resolve69(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 };
       }
@@ -83264,7 +83858,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 = resolve67(DEMO_DIR, "faded.mp4");
+        const output = resolve69(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 };
       }
@@ -83331,20 +83925,20 @@ var demoCommand = new Command("demo").description("Run sample edits on a test vi
 
 // src/commands/context.ts
 init_esm();
-import { existsSync as existsSync50 } from "node:fs";
-import { readFile as readFile44 } from "node:fs/promises";
-import { resolve as resolve68, dirname as dirname23 } from "node:path";
+import { existsSync as existsSync51 } from "node:fs";
+import { readFile as readFile45 } from "node:fs/promises";
+import { resolve as resolve70, dirname as dirname24 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 var __filename = fileURLToPath2(import.meta.url);
-var __dirname = dirname23(__filename);
+var __dirname = dirname24(__filename);
 function resolveContextPath(baseDir = __dirname) {
   const candidates = [
     // Bundled package layout: packages/cli/dist/index.js -> packages/cli/CONTEXT.md
-    resolve68(baseDir, "../CONTEXT.md"),
+    resolve70(baseDir, "../CONTEXT.md"),
     // Source/dev layout: packages/cli/src/commands/context.ts -> packages/cli/CONTEXT.md
-    resolve68(baseDir, "../../CONTEXT.md")
+    resolve70(baseDir, "../../CONTEXT.md")
   ];
-  return candidates.find((candidate) => existsSync50(candidate)) ?? null;
+  return candidates.find((candidate) => existsSync51(candidate)) ?? null;
 }
 var contextCommand = new Command("context").description("Print CLI context/guidelines for AI agent integration").option("--format <format>", "Output format: markdown | json", "markdown").action(async (_options, cmd) => {
   const options = {
@@ -83434,7 +84028,7 @@ var contextCommand = new Command("context").description("Print CLI context/guide
   try {
     const contextPath = resolveContextPath();
     if (!contextPath) throw new Error("CONTEXT.md not found");
-    const content = await readFile44(contextPath, "utf-8");
+    const content = await readFile45(contextPath, "utf-8");
     console.log(
       content.replace(
         "## Mental model",
@@ -84376,7 +84970,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((resolve81) => {
+  return new Promise((resolve83) => {
     if (typeof process.stdin.ref === "function") {
       process.stdin.ref();
     }
@@ -84483,7 +85077,7 @@ async function startAgent(options = {}) {
       clearInterval(keepalive);
       console.log();
       console.log(source_default.dim("Goodbye!"));
-      resolve81();
+      resolve83();
     });
     rl.prompt();
   });
@@ -84756,8 +85350,8 @@ init_source();
 init_config();
 init_schema();
 init_api_key();
-import { access as access9, writeFile as writeFile58, mkdir as mkdir28 } from "node:fs/promises";
-import { dirname as dirname25 } from "node:path";
+import { access as access9, writeFile as writeFile59, mkdir as mkdir29 } from "node:fs/promises";
+import { dirname as dirname26 } from "node:path";
 var BANNER_SHOWN_PATH = `${USER_CONFIG_DIR}/.banner-shown`;
 async function isFirstRun() {
   try {
@@ -84776,8 +85370,8 @@ async function isFirstRun() {
 }
 async function markBannerShown() {
   try {
-    await mkdir28(dirname25(BANNER_SHOWN_PATH), { recursive: true });
-    await writeFile58(BANNER_SHOWN_PATH, (/* @__PURE__ */ new Date()).toISOString());
+    await mkdir29(dirname26(BANNER_SHOWN_PATH), { recursive: true });
+    await writeFile59(BANNER_SHOWN_PATH, (/* @__PURE__ */ new Date()).toISOString());
   } catch {
   }
 }
@@ -84912,6 +85506,7 @@ this section shows the typical entry points by use case):
     vibe schema --list --surface public Compact first-run command catalog
     vibe schema generate.video          JSON schema for any command
     vibe context                        Agent integration quickstart
+    vibe host setup all                 Configure Codex/Claude/Cursor app integrations
     vibe agent                          Optional built-in agent when you do not use Claude Code/Codex/etc.
 
 Common-flag note: most commands accept --dry-run to preview cost/output
@@ -85013,6 +85608,7 @@ program2.addCommand(buildCommand);
 program2.addCommand(renderCommand);
 program2.addCommand(statusCommand);
 program2.addCommand(doctorCommand);
+program2.addCommand(hostCommand);
 program2.addCommand(demoCommand, { hidden: true });
 program2.addCommand(runCommand);
 program2.addCommand(agentCommand);