@vibeframe/mcp-server 0.111.0 → 0.111.3

package/dist/index.js

@@ -34586,7 +34586,7 @@ var require_source_map = __commonJS({
 var require_previous_map = __commonJS({
   "../../node_modules/.pnpm/postcss@8.5.6/node_modules/postcss/lib/previous-map.js"(exports, module) {
     "use strict";
-    var { existsSync: existsSync65, readFileSync: readFileSync12 } = __require("fs");
+    var { existsSync: existsSync66, readFileSync: readFileSync12 } = __require("fs");
     var { dirname: dirname33, join: join44 } = __require("path");
     var { SourceMapConsumer, SourceMapGenerator } = require_source_map();
     function fromBase64(str2) {
@@ -34649,7 +34649,7 @@ var require_previous_map = __commonJS({
       }
       loadFile(path14) {
         this.root = dirname33(path14);
-        if (existsSync65(path14)) {
+        if (existsSync66(path14)) {
           this.mapFile = path14;
           return readFileSync12(path14, "utf-8").toString().trim();
         }
@@ -35343,8 +35343,8 @@ var require_map_generator = __commonJS({
         if (this.mapOpts.absolute) return file;
         if (file.charCodeAt(0) === 60) return file;
         if (/^\w+:\/\//.test(file)) return file;
-        let cached = this.memoizedPaths.get(file);
-        if (cached) return cached;
+        let cached2 = this.memoizedPaths.get(file);
+        if (cached2) return cached2;
         let from3 = this.opts.to ? dirname33(this.opts.to) : ".";
         if (typeof this.mapOpts.annotation === "string") {
           from3 = dirname33(resolve79(from3, this.mapOpts.annotation));
@@ -35407,8 +35407,8 @@ var require_map_generator = __commonJS({
         }
       }
       toFileUrl(path14) {
-        let cached = this.memoizedFileURLs.get(path14);
-        if (cached) return cached;
+        let cached2 = this.memoizedFileURLs.get(path14);
+        if (cached2) return cached2;
         if (pathToFileURL) {
           let fileURL = pathToFileURL(path14).toString();
           this.memoizedFileURLs.set(path14, fileURL);
@@ -35420,8 +35420,8 @@ var require_map_generator = __commonJS({
         }
       }
       toUrl(path14) {
-        let cached = this.memoizedURLs.get(path14);
-        if (cached) return cached;
+        let cached2 = this.memoizedURLs.get(path14);
+        if (cached2) return cached2;
         if (sep2 === "\\") {
           path14 = path14.replace(/\\/g, "/");
         }
@@ -39915,8 +39915,8 @@ var require_common2 = __commonJS({
         }
         return debug9;
       }
-      function extend(namespace, delimiter) {
-        const newDebug = createDebug(this.namespace + (typeof delimiter === "undefined" ? ":" : delimiter) + namespace);
+      function extend(namespace, delimiter2) {
+        const newDebug = createDebug(this.namespace + (typeof delimiter2 === "undefined" ? ":" : delimiter2) + namespace);
         newDebug.log = this.log;
         return newDebug;
       }
@@ -83010,9 +83010,9 @@ var require_range = __commonJS({
       parseRange(range) {
         const memoOpts = (this.options.includePrerelease && FLAG_INCLUDE_PRERELEASE) | (this.options.loose && FLAG_LOOSE);
         const memoKey = memoOpts + ":" + range;
-        const cached = cache.get(memoKey);
-        if (cached) {
-          return cached;
+        const cached2 = cache.get(memoKey);
+        if (cached2) {
+          return cached2;
         }
         const loose = this.options.loose;
         const hr2 = loose ? re2[t2.HYPHENRANGELOOSE] : re2[t2.HYPHENRANGE];
@@ -90548,10 +90548,10 @@ var require_parseListMLSD = __commonJS({
       // available on the server's operating system." The parser by Apache Commons tries to translate these
       // to Unix permissions – this is misleading users and might not even be correct.
     };
-    function splitStringOnce(str2, delimiter) {
-      const pos = str2.indexOf(delimiter);
+    function splitStringOnce(str2, delimiter2) {
+      const pos = str2.indexOf(delimiter2);
       const a2 = str2.substr(0, pos);
-      const b2 = str2.substr(pos + delimiter.length);
+      const b2 = str2.substr(pos + delimiter2.length);
       return [a2, b2];
     }
     function testLine(line) {
@@ -182151,8 +182151,8 @@ ${lanes.join("\n")}
           return emptyArray;
         }
         const cache = (_a9 = host.getModuleSpecifierCache) == null ? void 0 : _a9.call(host);
-        const cached = cache == null ? void 0 : cache.get(importingSourceFile.path, moduleSourceFile.path, userPreferences, options);
-        return [cached == null ? void 0 : cached.kind, cached == null ? void 0 : cached.moduleSpecifiers, moduleSourceFile, cached == null ? void 0 : cached.modulePaths, cache];
+        const cached2 = cache == null ? void 0 : cache.get(importingSourceFile.path, moduleSourceFile.path, userPreferences, options);
+        return [cached2 == null ? void 0 : cached2.kind, cached2 == null ? void 0 : cached2.moduleSpecifiers, moduleSourceFile, cached2 == null ? void 0 : cached2.modulePaths, cache];
       }
       function getModuleSpecifiers(moduleSymbol, checker, compilerOptions, importingSourceFile, host, userPreferences, options = {}) {
         return getModuleSpecifiersWithCacheInfo(
@@ -182431,8 +182431,8 @@ ${lanes.join("\n")}
         const importedFilePath = toPath(importedFileName, host.getCurrentDirectory(), hostGetCanonicalFileName(host));
         const cache = (_a9 = host.getModuleSpecifierCache) == null ? void 0 : _a9.call(host);
         if (cache) {
-          const cached = cache.get(importingFilePath, importedFilePath, preferences, options);
-          if (cached == null ? void 0 : cached.modulePaths) return cached.modulePaths;
+          const cached2 = cache.get(importingFilePath, importedFilePath, preferences, options);
+          if (cached2 == null ? void 0 : cached2.modulePaths) return cached2.modulePaths;
         }
         const modulePaths = getAllModulePathsWorker(info, importedFileName, host, compilerOptions, options);
         if (cache) {
@@ -190476,9 +190476,9 @@ ${lanes.join("\n")}
           function typeParameterToName(type, context3) {
             var _a9, _b3, _c3, _d;
             if (context3.flags & 4 && context3.typeParameterNames) {
-              const cached = context3.typeParameterNames.get(getTypeId(type));
-              if (cached) {
-                return cached;
+              const cached2 = context3.typeParameterNames.get(getTypeId(type));
+              if (cached2) {
+                return cached2;
               }
             }
             let result = symbolToName(
@@ -198192,9 +198192,9 @@ ${lanes.join("\n")}
         }
         function getOrCreateSubstitutionType(baseType, constraint) {
           const id = `${getTypeId(baseType)}>${getTypeId(constraint)}`;
-          const cached = substitutionTypes.get(id);
-          if (cached) {
-            return cached;
+          const cached2 = substitutionTypes.get(id);
+          if (cached2) {
+            return cached2;
           }
           const result = createType(
             33554432
@@ -201593,9 +201593,9 @@ ${lanes.join("\n")}
           }
           const key2 = type.id + getAliasId(aliasSymbol, aliasTypeArguments);
           const mapperCache = activeTypeMappersCaches[index !== -1 ? index : activeTypeMappersCount - 1];
-          const cached = mapperCache.get(key2);
-          if (cached) {
-            return cached;
+          const cached2 = mapperCache.get(key2);
+          if (cached2) {
+            return cached2;
           }
           totalInstantiationCount++;
           instantiationCount++;
@@ -206101,9 +206101,9 @@ ${lanes.join("\n")}
           return widened === original ? prop2 : createSymbolWithType(prop2, widened);
         }
         function getUndefinedProperty(prop2) {
-          const cached = undefinedProperties.get(prop2.escapedName);
-          if (cached) {
-            return cached;
+          const cached2 = undefinedProperties.get(prop2.escapedName);
+          if (cached2) {
+            return cached2;
           }
           const result = createSymbolWithType(prop2, undefinedOrMissingType);
           result.flags |= 16777216;
@@ -208964,9 +208964,9 @@ ${lanes.join("\n")}
             if (!key22) {
               return declaredType;
             }
-            const cached = cache.get(key22);
-            if (cached) {
-              return cached;
+            const cached2 = cache.get(key22);
+            if (cached2) {
+              return cached2;
             }
             for (let i2 = flowLoopStart; i2 < flowLoopCount; i2++) {
               if (flowLoopNodes[i2] === flow && flowLoopKeys[i2] === key22 && flowLoopTypes[i2].length) {
@@ -208998,9 +208998,9 @@ ${lanes.join("\n")}
                 flowType = getTypeAtFlowNode(antecedent);
                 flowTypeCache = saveFlowTypeCache;
                 flowLoopCount--;
-                const cached2 = cache.get(key22);
-                if (cached2) {
-                  return cached2;
+                const cached22 = cache.get(key22);
+                if (cached22) {
+                  return cached22;
                 }
               }
               const type = getTypeFromFlowType(flowType);
@@ -211175,10 +211175,10 @@ ${lanes.join("\n")}
               );
             }
             const links = getNodeLinks(iife);
-            const cached = links.resolvedSignature;
+            const cached2 = links.resolvedSignature;
             links.resolvedSignature = anySignature;
             const type = indexOfParameter < args.length ? getWidenedLiteralType(checkExpression(args[indexOfParameter])) : parameter.initializer ? void 0 : undefinedWideningType;
-            links.resolvedSignature = cached;
+            links.resolvedSignature = cached2;
             return type;
           }
           const contextualSignature = getContextualSignature(func);
@@ -211877,8 +211877,8 @@ ${lanes.join("\n")}
         }
         function discriminateContextualTypeByJSXAttributes(node, contextualType) {
           const key2 = `D${getNodeId(node)},${getTypeId(contextualType)}`;
-          const cached = getCachedType(key2);
-          if (cached) return cached;
+          const cached2 = getCachedType(key2);
+          if (cached2) return cached2;
           const jsxChildrenPropertyName = getJsxElementChildrenPropertyName(getJsxNamespaceAt(node));
           return setCachedType(
             key2,
@@ -216355,12 +216355,12 @@ ${lanes.join("\n")}
         }
         function getResolvedSignature(node, candidatesOutArray, checkMode) {
           const links = getNodeLinks(node);
-          const cached = links.resolvedSignature;
-          if (cached && cached !== resolvingSignature && !candidatesOutArray) {
-            return cached;
+          const cached2 = links.resolvedSignature;
+          if (cached2 && cached2 !== resolvingSignature && !candidatesOutArray) {
+            return cached2;
           }
           const saveResolutionStart = resolutionStart;
-          if (!cached) {
+          if (!cached2) {
             resolutionStart = resolutionTargets.length;
           }
           links.resolvedSignature = resolvingSignature;
@@ -216372,7 +216372,7 @@ ${lanes.join("\n")}
           );
           resolutionStart = saveResolutionStart;
           if (result !== resolvingSignature) {
-            links.resolvedSignature = flowLoopStart === flowLoopCount ? result : cached;
+            links.resolvedSignature = flowLoopStart === flowLoopCount ? result : cached2;
           }
           return result;
         }
@@ -279842,9 +279842,9 @@ ${lanes.join("\n")}
           if (!ambientModuleCache) {
             ambientModuleCache = /* @__PURE__ */ new Map();
           } else {
-            const cached = ambientModuleCache.get(moduleSymbol);
-            if (cached !== void 0) {
-              return cached;
+            const cached2 = ambientModuleCache.get(moduleSymbol);
+            if (cached2 !== void 0) {
+              return cached2;
             }
           }
           const declaredModuleSpecifier = stripQuotes3(moduleSymbol.getName());
@@ -279869,9 +279869,9 @@ ${lanes.join("\n")}
           if (!sourceFileCache) {
             sourceFileCache = /* @__PURE__ */ new Map();
           } else {
-            const cached = sourceFileCache.get(sourceFile);
-            if (cached !== void 0) {
-              return cached;
+            const cached2 = sourceFileCache.get(sourceFile);
+            if (cached2 !== void 0) {
+              return cached2;
             }
           }
           const packageName = getNodeModulesPackageNameFromFileName(sourceFile.fileName, moduleSpecifierResolutionHost);
@@ -313192,9 +313192,9 @@ ${newComment.split("\n").map((c2) => ` * ${c2}`).join("\n")}
             return true;
           }
           const key2 = getSymbolId(symbol) + "," + getSymbolId(parent2);
-          const cached = cachedResults.get(key2);
-          if (cached !== void 0) {
-            return cached;
+          const cached2 = cachedResults.get(key2);
+          if (cached2 !== void 0) {
+            return cached2;
           }
           cachedResults.set(key2, false);
           const inherits = !!symbol.declarations && symbol.declarations.some(
@@ -339627,9 +339627,9 @@ var require_util5 = __commonJS({
     exports.isDirectorySync = exports.isDirectory = exports.removeUndefinedValuesFromObject = exports.getPropertyByPath = exports.emplace = void 0;
     var fs_1 = __importStar3(__require("fs"));
     function emplace(map3, key2, fn) {
-      const cached = map3.get(key2);
-      if (cached !== void 0) {
-        return cached;
+      const cached2 = map3.get(key2);
+      if (cached2 !== void 0) {
+        return cached2;
       }
       const result = fn();
       map3.set(key2, result);
@@ -349374,9 +349374,9 @@ async function beginFrameCapture(page, options, frameTimeTicks, interval) {
     buffer = Buffer.from(result.screenshotData, "base64");
     lastFrameCache.set(page, buffer);
   } else {
-    const cached = lastFrameCache.get(page);
-    if (cached) {
-      buffer = cached;
+    const cached2 = lastFrameCache.get(page);
+    if (cached2) {
+      buffer = cached2;
     } else {
       const fallback2 = await sendBeginFrame(client, {
         frameTimeTicks: frameTimeTicks + 1e-3,
@@ -350739,8 +350739,8 @@ function parseFrameRate(frameRateStr) {
   return parseFloat(frameRateStr) || 0;
 }
 async function extractVideoMetadata(filePath) {
-  const cached = videoMetadataCache.get(filePath);
-  if (cached) return cached;
+  const cached2 = videoMetadataCache.get(filePath);
+  if (cached2) return cached2;
   const probePromise = (async () => {
     const stdout = await runFfprobe([
       "-v",
@@ -350782,8 +350782,8 @@ async function extractVideoMetadata(filePath) {
   return probePromise;
 }
 async function extractAudioMetadata(filePath) {
-  const cached = audioMetadataCache.get(filePath);
-  if (cached) return cached;
+  const cached2 = audioMetadataCache.get(filePath);
+  if (cached2) return cached2;
   const probePromise = (async () => {
     const stdout = await runFfprobe([
       "-v",
@@ -350815,8 +350815,8 @@ async function extractAudioMetadata(filePath) {
   return probePromise;
 }
 async function analyzeKeyframeIntervals(filePath) {
-  const cached = keyframeCache.get(filePath);
-  if (cached) return cached;
+  const cached2 = keyframeCache.get(filePath);
+  if (cached2) return cached2;
   const promise = analyzeKeyframeIntervalsUncached(filePath);
   keyframeCache.set(filePath, promise);
   promise.catch(() => {
@@ -351210,10 +351210,10 @@ function createFrameDataUriCache(cacheLimit) {
     return dataUri;
   }
   async function get(framePath) {
-    const cached = cache.get(framePath);
-    if (cached) {
-      remember(framePath, cached);
-      return cached;
+    const cached2 = cache.get(framePath);
+    if (cached2) {
+      remember(framePath, cached2);
+      return cached2;
     }
     const existing = inFlight.get(framePath);
     if (existing) {
@@ -353778,8 +353778,8 @@ async function safeCleanup(label, fn, log2 = defaultLogger) {
   }
 }
 function getMaxFrameIndex(frameDir) {
-  const cached = frameDirMaxIndexCache.get(frameDir);
-  if (cached !== void 0) return cached;
+  const cached2 = frameDirMaxIndexCache.get(frameDir);
+  if (cached2 !== void 0) return cached2;
   let max = 0;
   try {
     for (const name of readdirSync6(frameDir)) {
@@ -359330,8 +359330,8 @@ var init_dist2 = __esm({
             }
             return debug62;
           }
-          function extend(namespace, delimiter) {
-            const newDebug = createDebug(this.namespace + (typeof delimiter === "undefined" ? ":" : delimiter) + namespace);
+          function extend(namespace, delimiter2) {
+            const newDebug = createDebug(this.namespace + (typeof delimiter2 === "undefined" ? ":" : delimiter2) + namespace);
             newDebug.log = this.log;
             return newDebug;
           }
@@ -399712,9 +399712,9 @@ ${sourceUrlComment}
           parseRange(range) {
             const memoOpts = (this.options.includePrerelease && FLAG_INCLUDE_PRERELEASE) | (this.options.loose && FLAG_LOOSE);
             const memoKey = memoOpts + ":" + range;
-            const cached = cache.get(memoKey);
-            if (cached) {
-              return cached;
+            const cached2 = cache.get(memoKey);
+            if (cached2) {
+              return cached2;
             }
             const loose = this.options.loose;
             const hr2 = loose ? re2[t2.HYPHENRANGELOOSE] : re2[t2.HYPHENRANGE];
@@ -407094,10 +407094,10 @@ Closing reason: ${this._closingError.stack}`;
           // available on the server's operating system." The parser by Apache Commons tries to translate these
           // to Unix permissions – this is misleading users and might not even be correct.
         };
-        function splitStringOnce(str2, delimiter) {
-          const pos = str2.indexOf(delimiter);
+        function splitStringOnce(str2, delimiter2) {
+          const pos = str2.indexOf(delimiter2);
           const a2 = str2.substr(0, pos);
-          const b2 = str2.substr(pos + delimiter.length);
+          const b2 = str2.substr(pos + delimiter2.length);
           return [a2, b2];
         }
         function testLine(line) {
@@ -458340,10 +458340,10 @@ async function* iterSSEChunks(iterator3) {
     yield data;
   }
 }
-function partition(str2, delimiter) {
-  const index = str2.indexOf(delimiter);
+function partition(str2, delimiter2) {
+  const index = str2.indexOf(delimiter2);
   if (index !== -1) {
-    return [str2.substring(0, index), delimiter, str2.substring(index + delimiter.length)];
+    return [str2.substring(0, index), delimiter2, str2.substring(index + delimiter2.length)];
   }
   return [str2, "", ""];
 }
@@ -462204,10 +462204,10 @@ async function* iterSSEChunks2(iterator3) {
     yield data;
   }
 }
-function partition2(str2, delimiter) {
-  const index = str2.indexOf(delimiter);
+function partition2(str2, delimiter2) {
+  const index = str2.indexOf(delimiter2);
   if (index !== -1) {
-    return [str2.substring(0, index), delimiter, str2.substring(index + delimiter.length)];
+    return [str2.substring(0, index), delimiter2, str2.substring(index + delimiter2.length)];
   }
   return [str2, "", ""];
 }
@@ -469341,14 +469341,15 @@ async function expectedRootSync(opts) {
   return { block, totalDurationSec: Number(cursor.toFixed(2)), audioRefs };
 }
 async function resolveSyncedBeatDuration(opts) {
-  if (opts.sceneDurationSec !== void 0) return Number(opts.sceneDurationSec.toFixed(2));
   const storyboardMin = opts.beatDuration ?? 3;
-  if (!opts.narrationPath) return Number(storyboardMin.toFixed(2));
+  const reported = opts.sceneDurationSec;
+  if (!opts.narrationPath) return Number((reported ?? storyboardMin).toFixed(2));
+  const probe = opts.probeAudioDuration ?? getAudioDuration;
   try {
-    const audioDuration = await getAudioDuration(join23(opts.projectDir, opts.narrationPath));
-    return Number(Math.max(storyboardMin, audioDuration + 0.5).toFixed(2));
+    const audioDuration = await probe(join23(opts.projectDir, opts.narrationPath));
+    return Number(Math.max(storyboardMin, reported ?? 0, audioDuration + 0.5).toFixed(2));
   } catch {
-    return Number(storyboardMin.toFixed(2));
+    return Number(Math.max(storyboardMin, reported ?? 0).toFixed(2));
   }
 }
 async function resolveProjectBeatDurations(projectDir) {
@@ -470726,6 +470727,22 @@ var init_chrome3 = __esm({
   }
 });
 
+// ../cli/src/commands/_shared/ffmpeg-gate.ts
+function ffmpegToolsAvailable() {
+  if (testOverride !== null) return testOverride;
+  if (cached === null) cached = commandExists("ffmpeg") && commandExists("ffprobe");
+  return cached;
+}
+var testOverride, cached;
+var init_ffmpeg_gate = __esm({
+  "../cli/src/commands/_shared/ffmpeg-gate.ts"() {
+    "use strict";
+    init_exec_safe();
+    testOverride = null;
+    cached = null;
+  }
+});
+
 // ../cli/src/commands/_shared/scene-audio-scan.ts
 import { readFile as readFile15 } from "node:fs/promises";
 import { resolve as resolve25 } from "node:path";
@@ -471047,6 +471064,33 @@ async function executeSceneRender(opts = {}) {
       error: `Project directory not found: ${projectDir}`
     };
   }
+  if (!ffmpegToolsAvailable()) {
+    return {
+      success: false,
+      kind: "render",
+      beat: opts.beatId ?? null,
+      code: "FFMPEG_MISSING",
+      error: "FFmpeg (ffmpeg/ffprobe) was not found on PATH; rendering needs it for audio mux and duration checks. Install it (macOS: `brew install ffmpeg`) and retry."
+    };
+  }
+  let autoSyncApplied = false;
+  let autoSyncWarning;
+  if (!opts.beatId && existsSync30(join30(projectDir, "STORYBOARD.md"))) {
+    try {
+      const rootPlan = await createProjectRootSyncPlan({ projectDir });
+      const subPlans = await createSubCompDurationSyncPlans({
+        projectDir,
+        beats: await loadProjectRootSyncBeats(projectDir)
+      });
+      if (rootPlan.changed || subPlans.some((plan) => plan.changed)) {
+        await executeSceneRepair({ projectDir });
+        autoSyncApplied = true;
+        autoSyncWarning = "Narration-synced durations drifted from the composed timeline; root and scene durations were re-synced before rendering (same pass as `vibe build --stage sync`).";
+      }
+    } catch (error) {
+      autoSyncWarning = `Narration drift check skipped: ${error instanceof Error ? error.message : String(error)}`;
+    }
+  }
   let root2 = opts.root ?? projectConfig.config.composition.entry;
   if (opts.beatId) {
     const prepared = await prepareBeatRenderRoot({
@@ -471163,7 +471207,9 @@ async function executeSceneRender(opts = {}) {
     format: config4.format,
     audioCount,
     audioMuxApplied,
-    audioMuxWarning
+    audioMuxWarning,
+    ...autoSyncApplied ? { autoSyncApplied } : {},
+    ...autoSyncWarning ? { autoSyncWarning } : {}
   };
   if (opts.revealInFinder) {
     try {
@@ -471424,6 +471470,10 @@ var init_scene_render = __esm({
     "use strict";
     init_dist2();
     init_chrome3();
+    init_ffmpeg_gate();
+    init_root_sync();
+    init_sub_comp_duration_sync();
+    init_scene_repair();
     init_scene_lint();
     init_scene_audio_scan();
     init_scene_audio_mux();
@@ -472874,6 +472924,28 @@ async function executeSceneBuild(opts) {
     providerResolution: buildPlan.providerResolution,
     ...result
   });
+  if (shouldRunStage(selectedStage, "assets") || shouldRunStage(selectedStage, "sync")) {
+    if (!ffmpegToolsAvailable()) {
+      return finishBuildResult({
+        success: false,
+        phase: "failed",
+        mode,
+        selectedStage,
+        code: "FFMPEG_MISSING",
+        error: "ffprobe (part of FFmpeg) was not found on PATH. Narration-synced durations cannot be computed without it.",
+        message: "ffprobe not found on PATH.",
+        suggestion: "Install FFmpeg (macOS: `brew install ffmpeg`), then re-run the build.",
+        recoverable: true,
+        beats: [],
+        stageReports,
+        warnings,
+        retryWith,
+        status: "failed",
+        currentStage: "assets",
+        totalLatencyMs: Date.now() - startedAt
+      });
+    }
+  }
   if (!buildPlan.validation.ok) {
     let invalidBeats = [];
     if (existsSync35(storyboardPath)) {
@@ -474545,6 +474617,7 @@ var init_scene_build = __esm({
     import_dotenv3 = __toESM(require_main(), 1);
     init_dist();
     init_audio();
+    init_ffmpeg_gate();
     init_concurrency();
     init_compose_scenes_skills();
     init_compose_prompts();
@@ -488653,10 +488726,13 @@ function mapRenderResultToToolResult(result, projectDir) {
       format: result.format,
       audioCount: result.audioCount,
       audioMuxApplied: result.audioMuxApplied,
-      audioMuxWarning: result.audioMuxWarning
+      audioMuxWarning: result.audioMuxWarning,
+      ...result.autoSyncApplied ? { autoSyncApplied: true } : {},
+      ...result.autoSyncWarning ? { autoSyncWarning: result.autoSyncWarning } : {}
     },
     humanLines: [
       `\u2705 Render complete: ${result.absoluteOutputPath ?? result.outputPath}`,
+      ...result.autoSyncApplied ? [`   auto-sync: narration-synced durations were re-applied before render`] : [],
       `   duration: ${((result.durationMs ?? 0) / 1e3).toFixed(1)}s`,
       `   frames:   ${result.framesRendered ?? "?"}${result.totalFrames ? ` / ${result.totalFrames}` : ""}`,
       `   config:   ${result.fps}fps \xB7 ${result.quality} \xB7 ${result.format}`,
@@ -498017,8 +498093,21 @@ This creates a music video-style edit where cuts happen in rhythm with the music
 }
 
 // src/instructions.ts
-import { mkdirSync as mkdirSync13 } from "node:fs";
-import { isAbsolute as isAbsolute9, resolve as resolve78 } from "node:path";
+import { existsSync as existsSync65, mkdirSync as mkdirSync13 } from "node:fs";
+import { delimiter, isAbsolute as isAbsolute9, resolve as resolve78 } from "node:path";
+var DEFAULT_EXTRA_PATH_DIRS = process.platform === "darwin" ? ["/opt/homebrew/bin", "/usr/local/bin", "/opt/local/bin"] : ["/usr/local/bin"];
+function ensureSystemPath(env4 = process.env, extraDirs = DEFAULT_EXTRA_PATH_DIRS) {
+  const current = (env4.PATH ?? "").split(delimiter).filter(Boolean);
+  const added = [];
+  for (const dir of extraDirs) {
+    if (!current.includes(dir) && existsSync65(dir)) {
+      current.push(dir);
+      added.push(dir);
+    }
+  }
+  if (added.length > 0) env4.PATH = current.join(delimiter);
+  return added;
+}
 function scrubUnresolvedUserConfigEnv(env4 = process.env) {
   const removed = [];
   for (const [key2, value] of Object.entries(env4)) {
@@ -498057,7 +498146,8 @@ function buildServerInstructions(cwd = resolveServerWorkspaceRoot()) {
     "When creating projects with init, use a project name or workspace-relative path under the workspace root.",
     "Do not create projects in /tmp, /home/claude, /workspace, or other synthetic roots unless the user explicitly asks.",
     "Before high or very-high cost provider work, run a dry-run or plan when available and ask the user to confirm provider spend.",
-    "When the user's request leaves them unspecified, ask the user before building instead of silently picking defaults: narration provider (kokoro = free local, elevenlabs = cloud credits), backdrop image generation (paid; skipping is free), and visual style (list options via scene_list_styles). Present the choices and wait for the answer."
+    "When the user's request leaves them unspecified, ask the user before building instead of silently picking defaults: narration provider (kokoro = free local, elevenlabs = cloud credits), backdrop image generation (paid; skipping is free), and visual style (list options via scene_list_styles). Present the choices and wait for the answer.",
+    "Narration and backdrop choices are independent \u2014 kokoro narration with OpenAI backdrops is a common combination. Pass each answer explicitly to build (ttsProvider plus skipBackdrop/imageProvider); never let one choice imply the other."
   ].join("\n");
 }
 
@@ -498078,11 +498168,12 @@ console.info = (...args) => console.error(...args);
 console.debug = (...args) => console.error(...args);
 scrubUnresolvedUserConfigEnv();
 applyWorkspaceEnv();
+ensureSystemPath();
 var server2 = new Server(
   {
     name: "vibeframe",
     // Stamped with the package version by build.js at bundle time.
-    version: "0.111.0"
+    version: "0.111.3"
   },
   {
     capabilities: {

package/package.json

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