demofly 0.2.8 → 0.2.10

package/dist/lib/scene-assembler.js

@@ -0,0 +1,185 @@
+import { execSync } from "node:child_process";
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { probeAudioDuration, computeOverflow, } from "./audio-probe.js";
+const COLORS = {
+    reset: "\x1b[0m",
+    yellow: "\x1b[33m",
+    red: "\x1b[31m",
+};
+const ATEMPO_CAP = 1.25;
+function findSceneAudioFile(audioDir, sceneId) {
+    const extensions = [".wav", ".mp3", ".aac", ".m4a", ".ogg"];
+    for (const ext of extensions) {
+        const filePath = resolve(audioDir, `${sceneId}${ext}`);
+        if (existsSync(filePath))
+            return filePath;
+    }
+    return null;
+}
+function emitWarning(info) {
+    const overflowStr = `${(info.overflowMs / 1000).toFixed(1)}s`;
+    const method = info.correction === "atempo"
+        ? `atempo ${info.atempoRatio.toFixed(2)}x applied`
+        : "freeze-frame applied";
+    if (info.severity === "critical") {
+        console.warn(`  ${COLORS.red}${info.sceneId}: audio ${overflowStr} over window (${method}) — consider shortening transcript${COLORS.reset}`);
+    }
+    else {
+        console.warn(`  ${COLORS.yellow}${info.sceneId}: audio ${overflowStr} over window (${method})${COLORS.reset}`);
+    }
+}
+/**
+ * Assemble a final video from existing per-scene video clips and audio files.
+ *
+ * Pipeline:
+ * 1. For each scene clip, find matching audio and probe duration
+ * 2. Apply correction if audio overflows video window (freeze-frame or atempo)
+ * 3. Mux each scene's video + audio into mp4
+ * 4. Concatenate all scene mp4s into final.mp4
+ */
+export function assembleScenes(clips, audioDir, recordingsDir, options = {}) {
+    const scenesDir = resolve(recordingsDir, "scenes");
+    const corrections = [];
+    const muxedPaths = [];
+    for (const clip of clips) {
+        const sceneDir = resolve(scenesDir, clip.sceneId);
+        mkdirSync(sceneDir, { recursive: true });
+        const audioPath = findSceneAudioFile(audioDir, clip.sceneId);
+        const muxedPath = resolve(sceneDir, "muxed.mp4");
+        if (audioPath) {
+            const sceneWindowMs = clip.durationMs;
+            const audioDurationMs = probeAudioDuration(audioPath);
+            const { overflowMs, severity } = computeOverflow(audioDurationMs, sceneWindowMs);
+            const correctionInfo = muxWithCorrection(clip.videoPath, audioPath, muxedPath, overflowMs, severity, sceneWindowMs, audioDurationMs, clip.sceneId, options);
+            corrections.push(correctionInfo);
+            if (correctionInfo.correction !== "none") {
+                emitWarning(correctionInfo);
+            }
+        }
+        else {
+            // No audio — transcode video only
+            try {
+                execSync(`ffmpeg -y -i "${clip.videoPath}" -c:v libx264 -preset fast -crf 23 -pix_fmt yuv420p -an "${muxedPath}"`, { encoding: "utf-8", timeout: 300_000, stdio: ["pipe", "pipe", "pipe"] });
+            }
+            catch (error) {
+                const execError = error;
+                console.warn(`Warning: Failed to transcode ${clip.sceneId}:`);
+                if (execError.stderr)
+                    console.warn(execError.stderr);
+                continue;
+            }
+        }
+        if (existsSync(muxedPath)) {
+            muxedPaths.push(muxedPath);
+        }
+    }
+    // Concatenate all per-scene clips
+    const finalPath = resolve(recordingsDir, "final.mp4");
+    if (muxedPaths.length === 0) {
+        throw new Error("No scene clips were produced for concatenation");
+    }
+    if (muxedPaths.length === 1) {
+        execSync(`cp "${muxedPaths[0]}" "${finalPath}"`, { stdio: "pipe" });
+    }
+    else {
+        const concatList = muxedPaths.map((p) => `file '${p}'`).join("\n");
+        const concatFile = resolve(recordingsDir, "concat.txt");
+        writeFileSync(concatFile, concatList, "utf-8");
+        try {
+            execSync(`ffmpeg -y -f concat -safe 0 -i "${concatFile}" -c copy -movflags +faststart "${finalPath}"`, { encoding: "utf-8", timeout: 600_000, stdio: ["pipe", "pipe", "pipe"] });
+        }
+        catch (error) {
+            const execError = error;
+            console.error("ffmpeg concat failed:");
+            if (execError.stderr)
+                console.error(execError.stderr);
+            throw new Error("Failed to concatenate scene clips");
+        }
+    }
+    // Compute adjusted total duration
+    const totalFreeze = corrections
+        .filter((c) => c.correction === "freeze-frame" || c.correction === "freeze-frame-fallback")
+        .reduce((sum, c) => sum + Math.max(0, c.overflowMs), 0);
+    const originalTotalMs = clips.reduce((sum, c) => sum + c.durationMs, 0);
+    const adjustedTotalDurationMs = originalTotalMs + totalFreeze;
+    return { finalPath, corrections, adjustedTotalDurationMs };
+}
+function muxWithCorrection(clipPath, audioPath, muxedPath, overflowMs, severity, sceneWindowMs, audioDurationMs, sceneId, options) {
+    if (overflowMs <= 0) {
+        // Audio fits — simple mux
+        try {
+            execSync(`ffmpeg -y -i "${clipPath}" -i "${audioPath}" ` +
+                `-map 0:v -map 1:a ` +
+                `-c:v libx264 -preset fast -crf 23 -pix_fmt yuv420p ` +
+                `-c:a aac -b:a 128k ` +
+                `-movflags +faststart "${muxedPath}"`, { encoding: "utf-8", timeout: 300_000, stdio: ["pipe", "pipe", "pipe"] });
+        }
+        catch (error) {
+            const execError = error;
+            console.warn(`Warning: Failed to mux ${sceneId}:`);
+            if (execError.stderr)
+                console.warn(execError.stderr);
+        }
+        return { sceneId, overflowMs, severity, correction: "none" };
+    }
+    // Audio overflows — decide correction method
+    if (options.useAtempo) {
+        const ratio = audioDurationMs / sceneWindowMs;
+        if (ratio <= ATEMPO_CAP) {
+            return applyAtempo(clipPath, audioPath, muxedPath, sceneId, overflowMs, severity, ratio);
+        }
+        // Exceeds cap — fall back to freeze-frame
+        console.warn(`  ${COLORS.yellow}${sceneId}: atempo ratio ${ratio.toFixed(2)}x exceeds cap ${ATEMPO_CAP}x, using freeze-frame${COLORS.reset}`);
+        return applyFreezeFrame(clipPath, audioPath, muxedPath, sceneId, overflowMs, severity, true);
+    }
+    // Default: freeze-frame
+    return applyFreezeFrame(clipPath, audioPath, muxedPath, sceneId, overflowMs, severity, false);
+}
+function applyFreezeFrame(clipPath, audioPath, muxedPath, sceneId, overflowMs, severity, isFallback) {
+    const padSec = Math.ceil(overflowMs / 1000) + 2;
+    try {
+        execSync(`ffmpeg -y -i "${clipPath}" -i "${audioPath}" ` +
+            `-filter_complex "[0:v]tpad=stop_mode=clone:stop_duration=${padSec}[v]" ` +
+            `-map "[v]" -map 1:a ` +
+            `-c:v libx264 -preset fast -crf 23 -pix_fmt yuv420p ` +
+            `-c:a aac -b:a 128k -shortest ` +
+            `-movflags +faststart "${muxedPath}"`, { encoding: "utf-8", timeout: 300_000, stdio: ["pipe", "pipe", "pipe"] });
+    }
+    catch (error) {
+        const execError = error;
+        console.warn(`Warning: Failed to freeze-frame mux ${sceneId}:`);
+        if (execError.stderr)
+            console.warn(execError.stderr);
+    }
+    return {
+        sceneId,
+        overflowMs,
+        severity,
+        correction: isFallback ? "freeze-frame-fallback" : "freeze-frame",
+    };
+}
+function applyAtempo(clipPath, audioPath, muxedPath, sceneId, overflowMs, severity, ratio) {
+    try {
+        execSync(`ffmpeg -y -i "${clipPath}" -i "${audioPath}" ` +
+            `-filter_complex "[1:a]atempo=${ratio.toFixed(6)}[a]" ` +
+            `-map 0:v -map "[a]" ` +
+            `-c:v libx264 -preset fast -crf 23 -pix_fmt yuv420p ` +
+            `-c:a aac -b:a 128k ` +
+            `-movflags +faststart "${muxedPath}"`, { encoding: "utf-8", timeout: 300_000, stdio: ["pipe", "pipe", "pipe"] });
+    }
+    catch (error) {
+        const execError = error;
+        console.warn(`Warning: Failed to atempo mux ${sceneId}:`);
+        if (execError.stderr)
+            console.warn(execError.stderr);
+    }
+    return {
+        sceneId,
+        overflowMs,
+        severity,
+        correction: "atempo",
+        atempoRatio: ratio,
+    };
+}
+//# sourceMappingURL=scene-assembler.js.map

package/dist/lib/scene-assembler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-assembler.js","sourceRoot":"","sources":["../../src/lib/scene-assembler.ts"],"names":[],"mappings":"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"}

package/dist/lib/voice-resolver.d.ts

@@ -78,5 +78,9 @@ export declare function resolveVoiceFromFlags(voiceName: string | undefined, pro
     createApiClient: (token: string) => {
         get<T>(path: string): Promise<T>;
     };
+    demoVoicePreference?: {
+        name: string;
+        provider: string;
+    } | null;
 }): Promise<ResolvedVoice>;
 //# sourceMappingURL=voice-resolver.d.ts.map

package/dist/lib/voice-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"voice-resolver.d.ts","sourceRoot":"","sources":["../../src/lib/voice-resolver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,8DAA8D;AAC9D,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;EAQhB,CAAC;AAEX,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,sFAAsF;IACtF,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,CAAC,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,EAAE,GACnH,cAAc,EAAE,CAsBlB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,eAAe,EAAE,cAAc,EAAE,GAChC,aAAa,GAAG,IAAI,CAwBtB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAE1D;AAED,6CAA6C;AAC7C,eAAO,MAAM,oBAAoB,EAAE,aAKlC,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,IAAI,EAAE;IACJ,eAAe,EAAE,MAAM;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,QAAQ,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACvC,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK;QAAE,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;KAAE,CAAC;CAC1E,GACA,OAAO,CAAC,aAAa,CAAC,CA0BxB"}
+{"version":3,"file":"voice-resolver.d.ts","sourceRoot":"","sources":["../../src/lib/voice-resolver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,8DAA8D;AAC9D,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;EAQhB,CAAC;AAEX,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,sFAAsF;IACtF,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,CAAC,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,EAAE,GACnH,cAAc,EAAE,CAsBlB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,eAAe,EAAE,cAAc,EAAE,GAChC,aAAa,GAAG,IAAI,CAwBtB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAE1D;AAED,6CAA6C;AAC7C,eAAO,MAAM,oBAAoB,EAAE,aAKlC,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,IAAI,EAAE;IACJ,eAAe,EAAE,MAAM;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,QAAQ,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACvC,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK;QAAE,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;KAAE,CAAC;IACzE,mBAAmB,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACjE,GACA,OAAO,CAAC,aAAa,CAAC,CA6BxB"}

package/dist/lib/voice-resolver.js

@@ -84,8 +84,11 @@ export const KOKORO_DEFAULT_VOICE = {
  */
 export async function resolveVoiceFromFlags(voiceName, providerName, deps) {
     const defaultVoice = deps.getDefaultVoice();
-    const name = voiceName ?? defaultVoice.name;
-    const provider = providerName ?? (voiceName ? undefined : defaultVoice.provider);
+    // Resolution order: CLI flags → demo preference → system default
+    const demoVoice = deps.demoVoicePreference;
+    const effectiveDefault = demoVoice ?? defaultVoice;
+    const name = voiceName ?? effectiveDefault.name;
+    const provider = providerName ?? (voiceName ? undefined : effectiveDefault.provider);
     const token = await deps.getToken();
     let apiVoices;
     if (token) {

package/dist/lib/voice-resolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"voice-resolver.js","sourceRoot":"","sources":["../../src/lib/voice-resolver.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"voice-resolver.js","sourceRoot":"","sources":["../../src/lib/voice-resolver.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "demofly",
-  "version": "0.2.8",
+  "version": "0.2.10",
   "description": "CLI for demofly — automated demo video generation",
   "type": "module",
   "bin": {