videoclaw 3.0.0-alpha.1

package/dist/video/assemble/ffmpeg.js

@@ -0,0 +1,251 @@
+/**
+ * Shared FFmpeg / ffprobe helper for the assemble stage (sub-slice 3e).
+ *
+ * Source of truth: `skills/video-replicator/scripts/ffmpeg_wrapper.py`.
+ *
+ * This ports the proven Python `FFmpegWrapper` spawn primitives to Node:
+ *  - `runFfmpeg` mirrors `FFmpegWrapper.run` — prepends `-y`, captures stderr,
+ *    raises on a non-zero exit (here: `VclawError('ffmpeg_failed', ...)`).
+ *  - `ffprobeDuration` mirrors `FFmpegWrapper.probe`/`get_duration` — runs
+ *    ffprobe with `format=duration` and returns the value in **milliseconds**.
+ *  - `STANDARD_VIDEO_ARGS` / `STANDARD_AUDIO_ARGS` encode the exact codec /
+ *    rate / preset / crf knobs the Python encoders use, so segments produced by
+ *    `animate-slides.ts` (and later 3h stitch) share one uniform encoding.
+ *
+ * IMPORTANT — testing boundary: the *arg shapes* built here are the unit-tested
+ * surface. Actually spawning ffmpeg/ffprobe against real media (and eyeballing
+ * the result) is a HUMAN integration checkpoint, explicitly out of scope for
+ * the unit tests. Tests exercise the dry-run path + the env/bin override only;
+ * they never require ffmpeg to be installed.
+ *
+ * ffmpeg/ffprobe are system binaries (no npm dep); they are spawned directly.
+ */
+import { spawn } from 'node:child_process';
+import { VclawError } from '../errors.js';
+/**
+ * Standard H.264 video encoding params — matches the Python encoders
+ * (`-r 24 -c:v libx264 -preset fast -crf 20`). Keeping these uniform across
+ * every segment is what lets the 3h stitch step concat segments cleanly.
+ */
+export const STANDARD_VIDEO_ARGS = [
+    '-r',
+    '24',
+    '-c:v',
+    'libx264',
+    '-preset',
+    'fast',
+    '-crf',
+    '20',
+];
+/**
+ * Standard AAC audio encoding params — matches the Python encoders
+ * (`-c:a aac -ar 44100 -ac 2`).
+ */
+export const STANDARD_AUDIO_ARGS = [
+    '-c:a',
+    'aac',
+    '-ar',
+    '44100',
+    '-ac',
+    '2',
+];
+/** Resolve the ffmpeg binary: explicit opt > VCLAW_FFMPEG_BIN env > `ffmpeg`. */
+export function resolveFfmpegBin(explicit) {
+    return explicit ?? process.env.VCLAW_FFMPEG_BIN ?? 'ffmpeg';
+}
+/** Resolve the ffprobe binary: explicit opt > VCLAW_FFPROBE_BIN env > `ffprobe`. */
+export function resolveFfprobeBin(explicit) {
+    return explicit ?? process.env.VCLAW_FFPROBE_BIN ?? 'ffprobe';
+}
+/**
+ * Per-clip cut-at-N tail trim (WS9). Returns the ffmpeg `-t <seconds>` flag pair
+ * when `maxSeconds` is a positive number, else `[]` (no trim). PURE — splice the
+ * result into a per-clip ffmpeg arg array just before the output path.
+ */
+export function trimTailArgs(maxSeconds) {
+    return maxSeconds && maxSeconds > 0 ? ['-t', String(maxSeconds)] : [];
+}
+/**
+ * Letterbox normalization filter (WS9). Scales the source to the canvas
+ * `width` (preserving aspect via `-2`) and pads it onto a `width`x`height`
+ * black canvas, producing cinematic bars. Mirrors the DHUAAN TITLEFIT pattern
+ * (`scale=W:-2,pad=W:H:0:(oh-ih)/2:black`). Returns '' when no `ratio` is given
+ * (an empty/undefined ratio disables the filter). PURE — no ffmpeg spawned.
+ *
+ * `ratio` is the target aspect ratio label (e.g. '2.39:1'); the actual letterbox
+ * geometry comes from the `width`/`height` canvas the caller already targets.
+ */
+export function letterboxFilter(ratio, width, height) {
+    if (!ratio)
+        return '';
+    return `scale=${width}:-2,pad=${width}:${height}:0:(oh-ih)/2:black`;
+}
+/**
+ * Render a binary + args into a printable command string. Tokens containing
+ * whitespace or shell-significant chars are single-quoted so the printed
+ * command is copy-pasteable. This is for *logging/inspection only* — the actual
+ * spawn passes the args array verbatim (no shell), so quoting never affects
+ * execution.
+ */
+function formatCommand(bin, args) {
+    const quote = (tok) => /[^A-Za-z0-9_\-./:=,]/.test(tok) ? `'${tok.replace(/'/g, `'\\''`)}'` : tok;
+    return [bin, ...args].map(quote).join(' ');
+}
+/**
+ * Run ffmpeg with the given args. The `-y` flag (overwrite output without
+ * prompting) is prepended automatically, mirroring the Python wrapper, so
+ * callers never block on an interactive prompt.
+ *
+ * On `dryRun`, returns the command string without spawning (exitCode 0,
+ * empty stderr). On a non-zero exit, throws `VclawError('ffmpeg_failed', ...)`.
+ *
+ * NOTE: This is the real-spawn path. Unit tests must use `dryRun: true` — we do
+ * NOT run ffmpeg in tests.
+ */
+export async function runFfmpeg(args, opts = {}) {
+    const bin = resolveFfmpegBin(opts.ffmpegBin);
+    // Prepend -y exactly like FFmpegWrapper.run.
+    const fullArgs = ['-y', ...args];
+    const command = formatCommand(bin, fullArgs);
+    if (opts.dryRun) {
+        return { exitCode: 0, stderr: '', command };
+    }
+    return await new Promise((resolve, reject) => {
+        const child = spawn(bin, fullArgs, { stdio: ['ignore', 'ignore', 'pipe'] });
+        let stderr = '';
+        child.stderr?.on('data', (chunk) => {
+            stderr += chunk.toString();
+        });
+        child.on('error', (err) => {
+            reject(new VclawError('ffmpeg_failed', `Failed to spawn ffmpeg ("${bin}"): ${err.message}`, { bin, command }));
+        });
+        child.on('close', (code) => {
+            const exitCode = code ?? 1;
+            if (exitCode !== 0) {
+                reject(new VclawError('ffmpeg_failed', `ffmpeg exited with code ${exitCode}.`, { exitCode, command, stderr: stderr.trim().slice(0, 500) }));
+                return;
+            }
+            resolve({ exitCode, stderr, command });
+        });
+    });
+}
+/**
+ * Probe a media file's duration, returned in **milliseconds**.
+ *
+ * Mirrors `FFmpegWrapper.probe(entries="format=duration")` + `get_duration`:
+ *   ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 <path>
+ *
+ * On `dryRun`, returns 0 without spawning. Throws `VclawError('ffmpeg_failed', ...)`
+ * if ffprobe fails or emits an unparseable duration.
+ */
+export async function ffprobeDuration(path, opts = {}) {
+    if (opts.dryRun)
+        return 0;
+    const bin = resolveFfprobeBin(opts.ffprobeBin);
+    const args = [
+        '-v',
+        'error',
+        '-show_entries',
+        'format=duration',
+        '-of',
+        'default=noprint_wrappers=1:nokey=1',
+        path,
+    ];
+    const command = formatCommand(bin, args);
+    return await new Promise((resolve, reject) => {
+        const child = spawn(bin, args, { stdio: ['ignore', 'pipe', 'pipe'] });
+        let stdout = '';
+        let stderr = '';
+        child.stdout?.on('data', (chunk) => {
+            stdout += chunk.toString();
+        });
+        child.stderr?.on('data', (chunk) => {
+            stderr += chunk.toString();
+        });
+        child.on('error', (err) => {
+            reject(new VclawError('ffmpeg_failed', `Failed to spawn ffprobe ("${bin}"): ${err.message}`, {
+                bin,
+                command,
+            }));
+        });
+        child.on('close', (code) => {
+            const exitCode = code ?? 1;
+            if (exitCode !== 0) {
+                reject(new VclawError('ffmpeg_failed', `ffprobe exited with code ${exitCode} for "${path}".`, {
+                    exitCode,
+                    command,
+                    stderr: stderr.trim().slice(0, 500),
+                }));
+                return;
+            }
+            const seconds = Number.parseFloat(stdout.trim());
+            if (!Number.isFinite(seconds)) {
+                reject(new VclawError('ffmpeg_failed', `ffprobe returned an unparseable duration for "${path}": ${JSON.stringify(stdout.trim())}`, { command }));
+                return;
+            }
+            resolve(Math.round(seconds * 1000));
+        });
+    });
+}
+/**
+ * True iff ffprobe can read a positive duration from `path`. Catches
+ * truncated/no-moov MP4s that pass existence+size checks but fail at
+ * stitch. Ported from parallel_video_gen._ffprobe_is_valid_mp4. Never
+ * throws — returns false on any probe failure / missing file / timeout.
+ *
+ * Mirrors the Python guard's args exactly:
+ *   ffprobe -v error -show_entries format=duration -of csv=p=0 <path>
+ * returning true only when ffprobe exits 0 AND stdout trims to a finite
+ * number > 0.
+ */
+export async function isValidMp4(path, opts = {}) {
+    const bin = resolveFfprobeBin(opts.ffprobeBin);
+    const timeoutMs = opts.timeoutMs ?? 15000;
+    const args = [
+        '-v',
+        'error',
+        '-show_entries',
+        'format=duration',
+        '-of',
+        'csv=p=0',
+        path,
+    ];
+    return await new Promise((resolve) => {
+        let settled = false;
+        const done = (value) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolve(value);
+        };
+        let child;
+        try {
+            child = spawn(bin, args, { stdio: ['ignore', 'pipe', 'ignore'] });
+        }
+        catch {
+            // Spawn threw synchronously (e.g. binary not found on some platforms).
+            done(false);
+            return;
+        }
+        const timer = setTimeout(() => {
+            child.kill('SIGKILL');
+            done(false);
+        }, timeoutMs);
+        let stdout = '';
+        child.stdout?.on('data', (chunk) => {
+            stdout += chunk.toString();
+        });
+        // Missing binary / spawn failure → false (never throws).
+        child.on('error', () => done(false));
+        child.on('close', (code) => {
+            if (code !== 0) {
+                done(false);
+                return;
+            }
+            const seconds = Number.parseFloat(stdout.trim());
+            done(Number.isFinite(seconds) && seconds > 0);
+        });
+    });
+}
+//# sourceMappingURL=ffmpeg.js.map

package/dist/video/assemble/ffmpeg.js.map

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

package/dist/video/assemble/gemini-vision-classify.d.ts

@@ -0,0 +1,37 @@
+export declare const DEFAULT_GEMINI_VISION_QA_ENDPOINT = "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.5-flash:generateContent";
+/** Resolve the endpoint: explicit option → VCLAW_GEMINI_API_ENDPOINT → default. */
+export declare function resolveVisionQaEndpoint(endpoint?: string): string;
+export declare function slideImageMimeType(imagePath: string): string;
+export declare function extractGeminiText(payload: unknown): string;
+/**
+ * Parse the two-line `verdict:` / `reason:` reply against an allowed verdict
+ * set. An unrecognized verdict value falls back to `'error'` with the full
+ * reply text as the reason, exactly like the Python originals — so a refusal
+ * or free-form answer is surfaced verbatim instead of being misclassified.
+ */
+export declare function parseTwoLineVerdict<T extends string>(text: string, allowed: readonly T[]): {
+    verdict: T | 'error';
+    reason: string;
+};
+export interface ClassifyImageInput<T extends string> {
+    imagePath: string;
+    prompt: string;
+    allowedVerdicts: readonly T[];
+    /** Pre-resolved endpoint (see {@link resolveVisionQaEndpoint}). */
+    endpoint: string;
+    /** Explicit API key — bypasses the env-backed key pool. */
+    keyOverride?: string;
+    /** Injectable fetch for offline tests. */
+    fetcher?: typeof fetch;
+}
+/**
+ * One Gemini-Vision classification call: read the image, POST prompt +
+ * inlineData, parse the two-line reply. Failures (unreadable image, HTTP
+ * error, network throw, refusal) degrade to `{verdict: 'error', reason}` —
+ * the caller decides whether errors are advisory. Never throws.
+ */
+export declare function classifyImageWithGemini<T extends string>(input: ClassifyImageInput<T>): Promise<{
+    verdict: T | 'error';
+    reason: string;
+}>;
+//# sourceMappingURL=gemini-vision-classify.d.ts.map

package/dist/video/assemble/gemini-vision-classify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini-vision-classify.d.ts","sourceRoot":"","sources":["../../../src/video/assemble/gemini-vision-classify.ts"],"names":[],"mappings":"AAmBA,eAAO,MAAM,iCAAiC,6FAC8C,CAAC;AAE7F,mFAAmF;AACnF,wBAAgB,uBAAuB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAW5D;AAID,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAU1D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,EAClD,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,SAAS,CAAC,EAAE,GACpB;IAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAe1C;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,MAAM;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,SAAS,CAAC,EAAE,CAAC;IAC9B,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAAC,CAAC,SAAS,MAAM,EAC5D,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC3B,OAAO,CAAC;IAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAoDnD"}

package/dist/video/assemble/gemini-vision-classify.js

@@ -0,0 +1,123 @@
+/**
+ * Shared Gemini-Vision single-image classifier used by the assemble QA vision
+ * modules (`qa-narration-vision.ts`, `qa-image-vision.ts`).
+ *
+ * Both legacy Python QA scripts (`bunty_narration_check.py check_slide`,
+ * `bunty_image_filter_check.py check_image`) share the same transport shape:
+ * one image + one prompt per call, temperature 0, and an EXACT two-line
+ * `verdict:` / `reason:` reply. This module is that shared half — the per-QA
+ * prompts and verdict ladders stay in their own modules.
+ *
+ * Transport mirrors `gemini-judge.ts`/`gemini-analyze.ts`: key handling via
+ * {@link fetchGeminiWithPool} (round-robin pool with cooldown, or an explicit
+ * `keyOverride`), endpoint overridable via VCLAW_GEMINI_API_ENDPOINT, and an
+ * injectable `fetcher` so tests run fully offline.
+ */
+import { readFile } from 'node:fs/promises';
+import { extname } from 'node:path';
+import { fetchGeminiWithPool } from '../gemini-key-pool.js';
+export const DEFAULT_GEMINI_VISION_QA_ENDPOINT = 'https://generativelanguage.googleapis.com/v1beta/models/gemini-3.5-flash:generateContent';
+/** Resolve the endpoint: explicit option → VCLAW_GEMINI_API_ENDPOINT → default. */
+export function resolveVisionQaEndpoint(endpoint) {
+    return endpoint ?? process.env.VCLAW_GEMINI_API_ENDPOINT ?? DEFAULT_GEMINI_VISION_QA_ENDPOINT;
+}
+export function slideImageMimeType(imagePath) {
+    switch (extname(imagePath).toLowerCase()) {
+        case '.jpg':
+        case '.jpeg':
+            return 'image/jpeg';
+        case '.webp':
+            return 'image/webp';
+        case '.png':
+        default:
+            return 'image/png';
+    }
+}
+// Mirrors extractGeminiText in gemini-judge.ts: unwrap
+// candidates[0].content.parts[].text, '' rather than throwing.
+export function extractGeminiText(payload) {
+    const candidates = payload.candidates;
+    return (candidates?.[0]?.content?.parts
+        ?.map((part) => part.text ?? '')
+        .join('\n')
+        .trim() ?? '');
+}
+/**
+ * Parse the two-line `verdict:` / `reason:` reply against an allowed verdict
+ * set. An unrecognized verdict value falls back to `'error'` with the full
+ * reply text as the reason, exactly like the Python originals — so a refusal
+ * or free-form answer is surfaced verbatim instead of being misclassified.
+ */
+export function parseTwoLineVerdict(text, allowed) {
+    let verdict = 'error';
+    let reason = text.trim();
+    for (const line of text.split('\n')) {
+        const lower = line.toLowerCase();
+        if (lower.startsWith('verdict:')) {
+            const value = line.slice(line.indexOf(':') + 1).trim().toLowerCase();
+            if (allowed.includes(value)) {
+                verdict = value;
+            }
+        }
+        else if (lower.startsWith('reason:')) {
+            reason = line.slice(line.indexOf(':') + 1).trim();
+        }
+    }
+    return { verdict, reason: verdict === 'error' ? text.trim() : reason };
+}
+/**
+ * One Gemini-Vision classification call: read the image, POST prompt +
+ * inlineData, parse the two-line reply. Failures (unreadable image, HTTP
+ * error, network throw, refusal) degrade to `{verdict: 'error', reason}` —
+ * the caller decides whether errors are advisory. Never throws.
+ */
+export async function classifyImageWithGemini(input) {
+    let imageB64;
+    try {
+        imageB64 = (await readFile(input.imagePath)).toString('base64');
+    }
+    catch (error) {
+        return {
+            verdict: 'error',
+            reason: `Could not read slide image ${input.imagePath}: ${error.message}`,
+        };
+    }
+    const body = {
+        contents: [
+            {
+                parts: [
+                    { text: input.prompt },
+                    { inlineData: { mimeType: slideImageMimeType(input.imagePath), data: imageB64 } },
+                ],
+            },
+        ],
+        // The Python originals used maxOutputTokens: 200 (tuned for the
+        // non-thinking gemini-2.0-flash). On gemini-3.5-flash, thinking tokens
+        // count against this budget and 200 truncates the reason line mid-word
+        // (live-observed). 1024 leaves room for thought + the two-line reply.
+        generationConfig: { temperature: 0, maxOutputTokens: 1024 },
+    };
+    try {
+        const response = await fetchGeminiWithPool((key) => `${input.endpoint}?key=${key}`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(body),
+        }, { fetcher: input.fetcher, keyOverride: input.keyOverride });
+        if (!response.ok) {
+            const detail = await response.text().catch(() => '');
+            return {
+                verdict: 'error',
+                reason: `Gemini returned HTTP ${response.status}${detail ? `: ${detail.slice(0, 160)}` : ''}`,
+            };
+        }
+        const text = extractGeminiText(await response.json());
+        return parseTwoLineVerdict(text, input.allowedVerdicts);
+    }
+    catch (error) {
+        return {
+            verdict: 'error',
+            reason: `Gemini call failed: ${error.message}`,
+        };
+    }
+}
+//# sourceMappingURL=gemini-vision-classify.js.map

package/dist/video/assemble/gemini-vision-classify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini-vision-classify.js","sourceRoot":"","sources":["../../../src/video/assemble/gemini-vision-classify.ts"],"names":[],"mappings":"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"}

package/dist/video/assemble/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Public surface for the assemble stage (`vclaw video assemble`).
+ *
+ * Sub-slice 3a: re-exports shared types only. Subsequent sub-slices
+ * (3b–3h) add module re-exports (tts, pdf, title-card, animate-slides,
+ * music, stitch) here as they land.
+ */
+export type { AssembleInput, AssembleManifestEntry, AssembleResult, } from './types.js';
+export { assembleProject, writeAssembleReport } from './assemble.js';
+export { generateTts, COMBINED_NARRATION_FILENAME } from './tts.js';
+export type { TtsInput, TtsResult, TtsSegment, TtsSceneOutput, } from './tts.js';
+export { parseTranscript, parseEditedTranscript, sceneTexts, transcriptToTtsSegments, loadTranscriptFile, loadEditedTranscriptFile, } from './transcript.js';
+export type { MultiVoiceSegment, SceneText, SceneTranscript, LoadedTranscript, SceneTextEntry, } from './transcript.js';
+export { planNarrationConcat, runNarrationConcat, concatListLine } from './audio-concat.js';
+export type { NarrationConcatInput, NarrationConcatPlan, NarrationPadStep, } from './audio-concat.js';
+export { extractPdfSlides, slideImageFilename } from './pdf.js';
+export type { ExtractPdfSlidesInput, ExtractPdfSlidesResult, ExtractedPdfPage, SlideImageFormat, } from './pdf.js';
+export { generateTitleCard } from './title-card.js';
+export type { GenerateTitleCardInput, GenerateTitleCardResult, } from './title-card.js';
+export { runFfmpeg, ffprobeDuration, resolveFfmpegBin, resolveFfprobeBin, STANDARD_VIDEO_ARGS, STANDARD_AUDIO_ARGS, } from './ffmpeg.js';
+export type { RunFfmpegOptions, RunFfmpegResult, FfprobeDurationOptions, } from './ffmpeg.js';
+export { buildAnimateArgs, animateSlide, alignDurationToFrame, DEFAULT_FADE_DURATION_SEC, TARGET_WIDTH, TARGET_HEIGHT, TARGET_FPS, APAD_SAFETY_SEC, } from './animate-slides.js';
+export type { BuildAnimateArgsInput, AnimateSlideResult, } from './animate-slides.js';
+export { generateMusic, resolveMusicApiKey } from './music.js';
+export type { GenerateMusicInput, GenerateMusicResult, } from './music.js';
+export { lintDialogue, countWords, STANDARD_MAX_WORDS, STANDARD_RECOMMENDED_WORDS, SIGNOFF_SCENE_INDEX, SIGNOFF_MAX_WORDS, SIGNOFF_RECOMMENDED_WORDS, } from './qa-dialogue-lint.js';
+export type { DialogueSegment, LintDialogueInput, LintDialogueResult, DialogueWarning, } from './qa-dialogue-lint.js';
+export { checkNarration, countNarrationWords, MIN_NARRATION_CHARS, DEFAULT_MAX_NARRATION_WORDS, WORDS_PER_SECOND, } from './qa-narration.js';
+export type { NarrationScene, CheckNarrationInput, CheckNarrationResult, NarrationWarning, } from './qa-narration.js';
+export { checkSlideAlignment, parseSlideAlignmentReply, buildSlideAlignmentPrompt, DEFAULT_QA_NARRATION_VISION_ENDPOINT, } from './qa-narration-vision.js';
+export type { SlideAlignmentVerdict, SlideAlignmentSlide, SlideAlignmentResult, CheckSlideAlignmentInput, CheckSlideAlignmentResult, } from './qa-narration-vision.js';
+export { planNarrationFit } from './narration-fit.js';
+export type { NarrationFitInput, NarrationFitPlan, NarrationFitWarning, } from './narration-fit.js';
+export { runAssembleMediaQc } from './media-qc.js';
+export type { AssembleMediaQcClip, AssembleMediaQcIssue, AssembleMediaQcMaster, AssembleMediaQcReport, AssembleMediaQcStatus, RunAssembleMediaQcInput, } from './media-qc.js';
+export { checkImageFilter, classifyImagePrompt, VERDICT_ORDER, RISK_CATEGORIES, } from './qa-image-filter.js';
+export type { FilterVerdict, ImageFilterCandidate, CheckImageFilterInput, CheckImageFilterResult, ImageFilterWarning, } from './qa-image-filter.js';
+export { checkImageVision, parseImageVisionReply, buildImageVisionPrompt, DEFAULT_QA_IMAGE_VISION_ENDPOINT, } from './qa-image-vision.js';
+export type { ImageVisionVerdict, ImageVisionSlide, ImageVisionResult, CheckImageVisionInput, CheckImageVisionResult, } from './qa-image-vision.js';
+export { stitch, orderedSegments, selectConcatStrategy, buildConcatListContent, buildConcatDemuxerArgs, buildConcatFilterArgs, buildSegmentPrepArgs, resolveGradeFilter, GRADE_FILTER_IDS, buildMusicMixArgs, FILTER_FALLBACK_SEGMENT_THRESHOLD, DEFAULT_MUSIC_VOLUME, DEFAULT_MUSIC_FADE_OUT_SEC, STANDARD_AUDIO_BITRATE, } from './stitch.js';
+export type { ConcatStrategy, MusicMixSettings, StitchInput, StitchPlannedStep, StitchResult, StitchOptions, BuildConcatFilterOptions, BuildSegmentPrepOptions, BuildMusicMixOptions, } from './stitch.js';
+export { trimTailArgs, letterboxFilter } from './ffmpeg.js';
+export { topazUpscalePlan } from './upscale.js';
+export type { TopazUpscaleOptions, TopazUpscalePlan } from './upscale.js';
+export { buildOverlayArgs, buildAlertTextArgs, buildLowerThirdArgs, OVERLAY_POSITION_IDS, } from './overlay.js';
+export type { OverlayPosition, BuildOverlayOptions, BuildAlertTextOptions, BuildLowerThirdOptions, } from './overlay.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/video/assemble/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/video/assemble/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,YAAY,EACV,aAAa,EACb,qBAAqB,EACrB,cAAc,GACf,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGrE,OAAO,EAAE,WAAW,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAC;AACpE,YAAY,EACV,QAAQ,EACR,SAAS,EACT,UAAU,EACV,cAAc,GACf,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,UAAU,EACV,uBAAuB,EACvB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,iBAAiB,EACjB,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,cAAc,GACf,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC5F,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAChE,YAAY,EACV,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,YAAY,EACV,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AAKzB,OAAO,EACL,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,oBAAoB,EACpB,yBAAyB,EACzB,YAAY,EACZ,aAAa,EACb,UAAU,EACV,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,qBAAqB,EACrB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAC/D,YAAY,EACV,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,0BAA0B,EAC1B,mBAAmB,EACnB,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,2BAA2B,EAC3B,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EACzB,oCAAoC,GACrC,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,gCAAgC,GACjC,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAK9B,OAAO,EACL,MAAM,EACN,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,iCAAiC,EACjC,oBAAoB,EACpB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,wBAAwB,EACxB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAKrB,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAI1E,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,cAAc,CAAC"}

package/dist/video/assemble/index.js

@@ -0,0 +1,40 @@
+// Sub-slice 3i: the assemble-stage orchestrator + typed assemble-report writer.
+export { assembleProject, writeAssembleReport } from './assemble.js';
+// Sub-slice 3b: TTS (text->speech narration).
+export { generateTts, COMBINED_NARRATION_FILENAME } from './tts.js';
+// Sub-slice 3b: transcript loading (standalone + SEALCAM+-embedded + edits).
+export { parseTranscript, parseEditedTranscript, sceneTexts, transcriptToTtsSegments, loadTranscriptFile, loadEditedTranscriptFile, } from './transcript.js';
+// Sub-slice 3b: combined narration track (concat + silence padding).
+export { planNarrationConcat, runNarrationConcat, concatListLine } from './audio-concat.js';
+// Sub-slice 3c: PDF slide extraction (rasterize PDF pages to images).
+export { extractPdfSlides, slideImageFilename } from './pdf.js';
+// Sub-slice 3d: title-card generation (SVG text composited over a base via sharp).
+export { generateTitleCard } from './title-card.js';
+// Sub-slice 3e: shared FFmpeg helper (spawn wrapper + ffprobe duration) and
+// slide-animation arg-builder. Pure arg-builders are the tested surface;
+// actual ffmpeg execution is integration-only (human-verified).
+export { runFfmpeg, ffprobeDuration, resolveFfmpegBin, resolveFfprobeBin, STANDARD_VIDEO_ARGS, STANDARD_AUDIO_ARGS, } from './ffmpeg.js';
+export { buildAnimateArgs, animateSlide, alignDurationToFrame, DEFAULT_FADE_DURATION_SEC, TARGET_WIDTH, TARGET_HEIGHT, TARGET_FPS, APAD_SAFETY_SEC, } from './animate-slides.js';
+// Sub-slice 3f: background-music generation (Kie.ai Suno; submit -> poll -> download).
+export { generateMusic, resolveMusicApiKey } from './music.js';
+// Sub-slice 3g: QA modules (advisory, pure-local; Gemini-vision deferred).
+export { lintDialogue, countWords, STANDARD_MAX_WORDS, STANDARD_RECOMMENDED_WORDS, SIGNOFF_SCENE_INDEX, SIGNOFF_MAX_WORDS, SIGNOFF_RECOMMENDED_WORDS, } from './qa-dialogue-lint.js';
+export { checkNarration, countNarrationWords, MIN_NARRATION_CHARS, DEFAULT_MAX_NARRATION_WORDS, WORDS_PER_SECOND, } from './qa-narration.js';
+export { checkSlideAlignment, parseSlideAlignmentReply, buildSlideAlignmentPrompt, DEFAULT_QA_NARRATION_VISION_ENDPOINT, } from './qa-narration-vision.js';
+export { planNarrationFit } from './narration-fit.js';
+export { runAssembleMediaQc } from './media-qc.js';
+export { checkImageFilter, classifyImagePrompt, VERDICT_ORDER, RISK_CATEGORIES, } from './qa-image-filter.js';
+export { checkImageVision, parseImageVisionReply, buildImageVisionPrompt, DEFAULT_QA_IMAGE_VISION_ENDPOINT, } from './qa-image-vision.js';
+// Sub-slice 3h: stitch keystone — concat-demuxer (primary) + concat-filter
+// fallback + music-bed mix. Pure arg-builders are the tested surface; the final
+// MP4 quality check is a human integration checkpoint (ffmpeg never run in tests).
+export { stitch, orderedSegments, selectConcatStrategy, buildConcatListContent, buildConcatDemuxerArgs, buildConcatFilterArgs, buildSegmentPrepArgs, resolveGradeFilter, GRADE_FILTER_IDS, buildMusicMixArgs, FILTER_FALLBACK_SEGMENT_THRESHOLD, DEFAULT_MUSIC_VOLUME, DEFAULT_MUSIC_FADE_OUT_SEC, STANDARD_AUDIO_BITRATE, } from './stitch.js';
+// WS9 post-production: per-clip cut-at-N trim + letterbox filter (ffmpeg.ts) and
+// the gated, opt-in Topaz upscale planner (upscale.ts). Pure arg/plan builders;
+// the real upscale shell-out is a separate wrapper gated on plan.run.
+export { trimTailArgs, letterboxFilter } from './ffmpeg.js';
+export { topazUpscalePlan } from './upscale.js';
+// Motion-graphics overlays (the After-Effects-shaped gap): composite a graphic,
+// burn an animated alert, or a lower-third title — pure FFmpeg arg-builders.
+export { buildOverlayArgs, buildAlertTextArgs, buildLowerThirdArgs, OVERLAY_POSITION_IDS, } from './overlay.js';
+//# sourceMappingURL=index.js.map

package/dist/video/assemble/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/video/assemble/index.ts"],"names":[],"mappings":"AAaA,gFAAgF;AAChF,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAErE,8CAA8C;AAC9C,OAAO,EAAE,WAAW,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAC;AAQpE,6EAA6E;AAC7E,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,UAAU,EACV,uBAAuB,EACvB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AASzB,qEAAqE;AACrE,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAO5F,sEAAsE;AACtE,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAQhE,mFAAmF;AACnF,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAMpD,4EAA4E;AAC5E,yEAAyE;AACzE,gEAAgE;AAChE,OAAO,EACL,SAAS,EACT,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAOrB,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,oBAAoB,EACpB,yBAAyB,EACzB,YAAY,EACZ,aAAa,EACb,UAAU,EACV,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAM7B,uFAAuF;AACvF,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAM/D,2EAA2E;AAC3E,OAAO,EACL,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,0BAA0B,EAC1B,mBAAmB,EACnB,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAQ/B,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,mBAAmB,EACnB,2BAA2B,EAC3B,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAQ3B,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EACzB,oCAAoC,GACrC,MAAM,0BAA0B,CAAC;AASlC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAOtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAUnD,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAS9B,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,sBAAsB,EACtB,gCAAgC,GACjC,MAAM,sBAAsB,CAAC;AAS9B,2EAA2E;AAC3E,gFAAgF;AAChF,mFAAmF;AACnF,OAAO,EACL,MAAM,EACN,eAAe,EACf,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,iCAAiC,EACjC,oBAAoB,EACpB,0BAA0B,EAC1B,sBAAsB,GACvB,MAAM,aAAa,CAAC;AAarB,iFAAiF;AACjF,gFAAgF;AAChF,sEAAsE;AACtE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGhD,gFAAgF;AAChF,6EAA6E;AAC7E,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,cAAc,CAAC"}

package/dist/video/assemble/media-qc.d.ts

@@ -0,0 +1,44 @@
+import { type VideoMediaProbe } from '../final-media.js';
+import type { AssembleManifestEntry } from './types.js';
+export type AssembleMediaQcStatus = 'pass' | 'warning' | 'fail' | 'skipped';
+export type AssembleMediaQcIssueCode = 'probe-failed' | 'missing-audio' | 'nonstandard-audio-codec' | 'nonstandard-audio-sample-rate' | 'nonstandard-video-codec' | 'duration-drift';
+export interface AssembleMediaQcIssue {
+    severity: 'warning' | 'error';
+    code: AssembleMediaQcIssueCode;
+    scope: string;
+    message: string;
+}
+export interface AssembleMediaQcClip {
+    path: string;
+    sceneIndex?: number;
+    status: Exclude<AssembleMediaQcStatus, 'skipped'>;
+    durationMs?: number;
+    probe?: VideoMediaProbe;
+    issues: AssembleMediaQcIssue[];
+}
+export interface AssembleMediaQcMaster {
+    path: string;
+    status: Exclude<AssembleMediaQcStatus, 'skipped'>;
+    durationMs?: number;
+    expectedDurationMs?: number;
+    driftMs?: number;
+    probe?: VideoMediaProbe;
+    issues: AssembleMediaQcIssue[];
+}
+export interface AssembleMediaQcReport {
+    status: AssembleMediaQcStatus;
+    clips: AssembleMediaQcClip[];
+    master?: AssembleMediaQcMaster;
+    issues: AssembleMediaQcIssue[];
+}
+export interface RunAssembleMediaQcInput {
+    manifest: AssembleManifestEntry[];
+    outputPath?: string;
+    probe?: (path: string) => Promise<VideoMediaProbe>;
+    expectedVideoCodec?: string;
+    expectedAudioCodec?: string;
+    expectedAudioSampleRate?: number;
+    driftToleranceMs?: number;
+}
+export declare function runAssembleMediaQc(input: RunAssembleMediaQcInput): Promise<AssembleMediaQcReport>;
+//# sourceMappingURL=media-qc.d.ts.map

package/dist/video/assemble/media-qc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-qc.d.ts","sourceRoot":"","sources":["../../../src/video/assemble/media-qc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;AAE5E,MAAM,MAAM,wBAAwB,GAChC,cAAc,GACd,eAAe,GACf,yBAAyB,GACzB,+BAA+B,GAC/B,yBAAyB,GACzB,gBAAgB,CAAC;AAErB,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,SAAS,GAAG,OAAO,CAAC;IAC9B,IAAI,EAAE,wBAAwB,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC,qBAAqB,EAAE,SAAS,CAAC,CAAC;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,oBAAoB,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC,qBAAqB,EAAE,SAAS,CAAC,CAAC;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,oBAAoB,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,qBAAqB,CAAC;IAC9B,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC7B,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,MAAM,EAAE,oBAAoB,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,qBAAqB,EAAE,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IACnD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAgHD,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,qBAAqB,CAAC,CAmFhC"}