@vibeframe/cli 0.111.1 → 0.111.3

package/dist/commands/_shared/ffmpeg-gate.d.ts

@@ -0,0 +1,3 @@
+/** Test-only hook — CI runners have no ffmpeg, production code never calls this. */
+export declare function __setFfmpegToolsForTests(value: boolean | null): void;
+export declare function ffmpegToolsAvailable(): boolean;

package/dist/commands/_shared/root-sync.d.ts

@@ -49,6 +49,8 @@ export declare function resolveSyncedBeatDuration(opts: {
     beatDuration?: number;
     narrationPath?: string;
     sceneDurationSec?: number;
+    /** Injectable for tests — defaults to the ffprobe-backed audio probe. */
+    probeAudioDuration?: (absPath: string) => Promise<number>;
 }): Promise<number>;
 /**
  * Final narration-synced duration per beat for a project on disk. Reads

package/dist/commands/_shared/root-sync.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/commands/_shared/scene-render.d.ts

@@ -67,6 +67,13 @@ export interface SceneRenderResult {
     /** Non-fatal warning from the audio mux pass — caller may surface to the user. */
     audioMuxWarning?: string;
     reportPath?: string;
+    /**
+     * True when the pre-render drift guard found narration-synced durations
+     * out of step with the composed timeline (e.g. sync stage skipped or run
+     * with stale durations) and re-synced root + scene durations first.
+     */
+    autoSyncApplied?: boolean;
+    autoSyncWarning?: string;
     code?: string;
     error?: string;
     retryWith?: string[];

package/dist/index.js

@@ -29414,14 +29414,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(join5(opts.projectDir, opts.narrationPath));
-    return Number(Math.max(storyboardMin, audioDuration + 0.5).toFixed(2));
+    const audioDuration = await probe(join5(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) {
@@ -60169,6 +60170,22 @@ var init_build_plan = __esm({
   }
 });
 
+// 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({
+  "src/commands/_shared/ffmpeg-gate.ts"() {
+    "use strict";
+    init_exec_safe();
+    testOverride = null;
+    cached = null;
+  }
+});
+
 // src/utils/concurrency.ts
 async function mapWithConcurrency(items, limit, fn) {
   if (!Number.isInteger(limit) || limit <= 0) {
@@ -60527,6 +60544,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 && existsSync48(join24(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 root = opts.root ?? projectConfig.config.composition.entry;
   if (opts.beatId) {
     const prepared = await prepareBeatRenderRoot({
@@ -60643,7 +60687,9 @@ async function executeSceneRender(opts = {}) {
     format: config2.format,
     audioCount,
     audioMuxApplied,
-    audioMuxWarning
+    audioMuxWarning,
+    ...autoSyncApplied ? { autoSyncApplied } : {},
+    ...autoSyncWarning ? { autoSyncWarning } : {}
   };
   if (opts.revealInFinder) {
     try {
@@ -60903,6 +60949,10 @@ var init_scene_render = __esm({
   "src/commands/_shared/scene-render.ts"() {
     "use strict";
     init_chrome();
+    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();
@@ -60972,6 +61022,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 (existsSync49(storyboardPath2)) {
@@ -62643,6 +62715,7 @@ var init_scene_build = __esm({
     import_dotenv4 = __toESM(require_main(), 1);
     init_dist2();
     init_audio();
+    init_ffmpeg_gate();
     init_concurrency();
     init_compose_scenes_skills();
     init_compose_prompts();
@@ -67963,10 +68036,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}`,
@@ -73213,7 +73289,7 @@ init_source();
 // package.json
 var package_default = {
   name: "@vibeframe/cli",
-  version: "0.111.1",
+  version: "0.111.3",
   description: "VibeFrame CLI - agentic video workflow runtime",
   private: false,
   license: "MIT",

package/dist/tools/manifest/index.js

@@ -30123,14 +30123,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(join7(opts.projectDir, opts.narrationPath));
-    return Number(Math.max(storyboardMin, audioDuration + 0.5).toFixed(2));
+    const audioDuration = await probe(join7(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) {
@@ -31508,6 +31509,22 @@ var init_chrome = __esm({
   }
 });
 
+// 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({
+  "src/commands/_shared/ffmpeg-gate.ts"() {
+    "use strict";
+    init_exec_safe();
+    testOverride = null;
+    cached = null;
+  }
+});
+
 // src/commands/_shared/scene-audio-scan.ts
 import { readFile as readFile15 } from "node:fs/promises";
 import { resolve as resolve18 } from "node:path";
@@ -31833,6 +31850,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 && existsSync15(join14(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 root = opts.root ?? projectConfig.config.composition.entry;
   if (opts.beatId) {
     const prepared = await prepareBeatRenderRoot({
@@ -31949,7 +31993,9 @@ async function executeSceneRender(opts = {}) {
     format: config2.format,
     audioCount,
     audioMuxApplied,
-    audioMuxWarning
+    audioMuxWarning,
+    ...autoSyncApplied ? { autoSyncApplied } : {},
+    ...autoSyncWarning ? { autoSyncWarning } : {}
   };
   if (opts.revealInFinder) {
     try {
@@ -32209,6 +32255,10 @@ var init_scene_render = __esm({
   "src/commands/_shared/scene-render.ts"() {
     "use strict";
     init_chrome();
+    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();
@@ -33659,6 +33709,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 (existsSync19(storyboardPath)) {
@@ -35330,6 +35402,7 @@ var init_scene_build = __esm({
     import_dotenv3 = __toESM(require_main(), 1);
     init_dist2();
     init_audio();
+    init_ffmpeg_gate();
     init_concurrency();
     init_compose_scenes_skills();
     init_compose_prompts();
@@ -53467,10 +53540,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}`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibeframe/cli",
-  "version": "0.111.1",
+  "version": "0.111.3",
   "description": "VibeFrame CLI - agentic video workflow runtime",
   "private": false,
   "license": "MIT",
@@ -83,8 +83,8 @@
     "tsx": "^4.21.0",
     "typescript": "^5.3.3",
     "vitest": "^1.2.2",
-    "@vibeframe/ai-providers": "0.111.1",
-    "@vibeframe/core": "0.111.1"
+    "@vibeframe/ai-providers": "0.111.3",
+    "@vibeframe/core": "0.111.3"
   },
   "engines": {
     "node": ">=20"