videoclaw 3.0.0-alpha.1

package/dist/video/assemble/stitch.js

@@ -0,0 +1,607 @@
+/**
+ * Stitch keystone for the assemble stage (sub-slice 3h).
+ *
+ * Source of truth (ported VERBATIM):
+ *  - `skills/video-replicator/scripts/stitch_bunty.py` — the bunty stitch. Uses
+ *    the concat **demuxer** path (`ffmpeg -y -f concat -safe 0 -i concat.txt
+ *    -c copy output`) — a single ffmpeg invocation regardless of segment count,
+ *    chosen deliberately so it survives the sandbox's per-session FFmpeg limit.
+ *  - `skills/video-replicator/scripts/ffmpeg_wrapper.py:concat_via_filter` — the
+ *    concat **filter** fallback (`-filter_complex
+ *    "[0:v][0:a]...concat=n=N:v=1:a=1[outv][outa]"` + re-encode). Used for 8+
+ *    segments where demuxer-accumulated AV drift across boundaries matters, OR
+ *    when a segment has incompatible codec params and the demuxer rejects it.
+ *  - `skills/video-replicator/scripts/assembly_utils.py:add_background_music` —
+ *    the music-bed mix (loops the music under the narration at low volume with a
+ *    tail fade-out, via amix).
+ *
+ * bunty (stitch_bunty.py) and nex (nex_assemble.py) collapse into ONE
+ * parameterized stitch driven by brand-profile-derived knobs:
+ *  - bunty: pre-encoded segments → demuxer concat, no music, intro/outro by
+ *    lip-sync scene segments. (`_concat_via_demuxer`, demuxer-first with a
+ *    filter fallback.)
+ *  - nex: normalized segments → filter concat (drift-free for 8+), optional
+ *    background-music bed, optional title-card prepend. (`concat_via_filter`
+ *    + `add_background_music`.)
+ * These differences become StitchInput fields: `concatStrategy`
+ * (demuxer | filter | auto), `intro` / `outro` segment paths, and the optional
+ * `music` block (track + volume + tail fade). The demuxer-vs-filter selection in
+ * `auto` mode flips at `FILTER_FALLBACK_SEGMENT_THRESHOLD` segments — the real
+ * sandbox-survival + drift lesson from the Python.
+ *
+ * AV-drift note (stitch_bunty.py ~L471-479): demuxer `-c copy` preserves exact
+ * packet timing and accumulates no re-encode drift, BUT it requires every
+ * segment to share encoding params. The per-segment AV-lock from 3e
+ * (1280×720@24, H.264 libx264 preset-fast crf20, AAC 44100 stereo) guarantees
+ * that, so the demuxer path is the primary one. Filter concat re-encodes (and so
+ * can introduce its own drift) but tolerates mismatched inputs — it is the
+ * fallback.
+ *
+ * IMPORTANT — testing boundary (SAME as 3e): the PURE arg-builders
+ * (`buildConcatDemuxerArgs`, `buildConcatFilterArgs`, `buildMusicMixArgs`) are
+ * the unit-tested surface (arg-shape only). `stitch` actually spawns ffmpeg and
+ * writes the concat list; verifying that the final MP4 looks/sounds right on
+ * real media is a HUMAN integration checkpoint, explicitly OUT OF SCOPE for the
+ * unit tests. Tests use the dry-run path and never run ffmpeg or require media.
+ */
+import { writeFile, mkdir, stat } from 'node:fs/promises';
+import { dirname, resolve as resolvePath } from 'node:path';
+import { runFfmpeg, ffprobeDuration, isValidMp4, trimTailArgs, letterboxFilter } from './ffmpeg.js';
+import { VclawError } from '../errors.js';
+/**
+ * Segment-count threshold at which `auto` strategy switches from the
+ * concat demuxer to the concat filter. Mirrors the Python lesson that the
+ * demuxer accumulates audible AV drift across "8+ segments"
+ * (ffmpeg_wrapper.concat_via_filter docstring). At or above this many segments
+ * `auto` prefers the filter path.
+ */
+export const FILTER_FALLBACK_SEGMENT_THRESHOLD = 8;
+/** Default background-music mix level (nex_assemble.py --music-volume default 0.05). */
+export const DEFAULT_MUSIC_VOLUME = 0.05;
+/** Default tail fade-out for the music bed in seconds (add_background_music default 3.0). */
+export const DEFAULT_MUSIC_FADE_OUT_SEC = 3.0;
+/** AAC bitrate for re-encode paths (filter concat + music mix). Matches the Python "192k". */
+export const STANDARD_AUDIO_BITRATE = '192k';
+/**
+ * Named post-production color grades → FFmpeg video-filter chains (WS9+). Applied
+ * in the per-segment prep pass, so different segments can carry different grades —
+ * which is exactly the reference advert's narrative color language (cool-steel
+ * "normal ops" -> crimson "breach" -> electric-blue "resolution"). These are real
+ * post transforms on the rendered footage (colorbalance/eq), NOT prompt hints.
+ * `kodak-500t` approximates the Vision3 500T tungsten stock (cool shadows, warm
+ * highlights, mild desat). For a true film LUT, pass a `.cube` via `gradeLut`.
+ */
+const GRADE_FILTERS = {
+    'cool-steel': 'colorbalance=rs=-0.08:gs=-0.04:bs=0.12,eq=saturation=0.82:contrast=1.06',
+    'crimson-threat': 'colorbalance=rs=0.18:gs=-0.06:bs=-0.08,eq=saturation=1.05:contrast=1.12',
+    'electric-blue': 'colorbalance=rs=-0.06:gs=0.04:bs=0.18,eq=saturation=1.00:contrast=1.05',
+    'kodak-500t': 'colorbalance=bs=0.08:rh=0.05:bh=-0.05,eq=saturation=0.90:contrast=1.05',
+    'bleach-bypass': 'eq=saturation=0.50:contrast=1.32',
+    'desaturated': 'eq=saturation=0.70:contrast=1.08',
+    'teal-orange': 'colorbalance=rs=0.05:bs=0.10:rh=0.08:bh=-0.06,eq=saturation=1.08',
+};
+/** Stable list of the named grade ids (for CLI validation / docs). */
+export const GRADE_FILTER_IDS = Object.keys(GRADE_FILTERS);
+/**
+ * Resolve a named grade id to its FFmpeg filter chain. Returns '' for an
+ * undefined/empty/unknown id (the prep pass then applies no grade) — callers that
+ * want a hard failure on an unknown id should validate against {@link GRADE_FILTER_IDS}.
+ */
+export function resolveGradeFilter(id) {
+    if (!id)
+        return '';
+    return GRADE_FILTERS[id] ?? '';
+}
+/** Assemble the full ordered segment list: intro + body + outro. */
+export function orderedSegments(input) {
+    return [...(input.intro ?? []), ...input.segments, ...(input.outro ?? [])];
+}
+/**
+ * Choose the effective concat path. `demuxer`/`filter` are honored directly;
+ * `auto` flips to the filter at {@link FILTER_FALLBACK_SEGMENT_THRESHOLD}
+ * segments (the drift lesson from the Python).
+ */
+export function selectConcatStrategy(strategy, segmentCount) {
+    if (strategy === 'demuxer' || strategy === 'filter')
+        return strategy;
+    return segmentCount >= FILTER_FALLBACK_SEGMENT_THRESHOLD ? 'filter' : 'demuxer';
+}
+/** Render the concat-demuxer list file body: one `file '<abspath>'` line per segment. */
+export function buildConcatListContent(segments) {
+    // Mirrors stitch_bunty._concat_via_demuxer: file '<os.path.abspath(seg)>'.
+    // DEVIATION from the Python (which had this bug): single quotes in the path
+    // are escaped ('\'') — an apostrophe anywhere in a parent directory name
+    // would otherwise corrupt the concat list for every segment.
+    return segments.map((seg) => `file '${resolvePath(seg).replace(/'/g, `'\\''`)}'\n`).join('');
+}
+/**
+ * Build the concat-DEMUXER ffmpeg args (PURE). The primary path.
+ *
+ * Ported VERBATIM from stitch_bunty._concat_via_demuxer (L240):
+ *   ffmpeg -y -f concat -safe 0 -i concat.txt -c copy output
+ * (`-y` is prepended by `runFfmpeg`, so it is NOT included here.)
+ *
+ * A single ffmpeg invocation regardless of segment count — survives the
+ * sandbox's per-session FFmpeg limit. Requires all segments to share encoding
+ * params (true for 3e segments).
+ */
+export function buildConcatDemuxerArgs(_segments, concatListPath, outputPath) {
+    return ['-f', 'concat', '-safe', '0', '-i', concatListPath, '-c', 'copy', outputPath];
+}
+/**
+ * Build the concat-FILTER fallback ffmpeg args (PURE). For 8+ segments where
+ * demuxer drift accumulates, or when a segment has incompatible codec params.
+ *
+ * Ported VERBATIM from ffmpeg_wrapper.concat_via_filter (L296-326):
+ *   -i f0 -i f1 ... -i f{n-1}
+ *   -filter_complex "[0:v][0:a][1:v][1:a]...concat=n=N:v=1:a=1[outv][outa]"
+ *   -map [outv] -map [outa]
+ *   -c:v libx264 -preset fast -crf 20
+ *   -c:a aac -b:a 192k -ar 44100 -ac 2
+ *   -movflags +faststart output
+ */
+export function buildConcatFilterArgs(segments, outputPath, opts = {}) {
+    const crf = opts.crf ?? 20;
+    const audioBitrate = opts.audioBitrate ?? STANDARD_AUDIO_BITRATE;
+    const sampleRate = opts.sampleRate ?? 44100;
+    const channels = opts.channels ?? 2;
+    const inputArgs = [];
+    for (const seg of segments) {
+        inputArgs.push('-i', seg);
+    }
+    // [0:v][0:a][1:v][1:a]...[n-1:v][n-1:a]concat=n=N:v=1:a=1[outv][outa]
+    let filterInputs = '';
+    for (let i = 0; i < segments.length; i += 1) {
+        filterInputs += `[${i}:v][${i}:a]`;
+    }
+    const filterComplex = `${filterInputs}concat=n=${segments.length}:v=1:a=1[outv][outa]`;
+    return [
+        ...inputArgs,
+        '-filter_complex',
+        filterComplex,
+        '-map',
+        '[outv]',
+        '-map',
+        '[outa]',
+        '-c:v',
+        'libx264',
+        '-preset',
+        'fast',
+        '-crf',
+        String(crf),
+        '-c:a',
+        'aac',
+        '-b:a',
+        audioBitrate,
+        '-ar',
+        String(sampleRate),
+        '-ac',
+        String(channels),
+        '-movflags',
+        '+faststart',
+        outputPath,
+    ];
+}
+/**
+ * Build the per-segment normalization ffmpeg args (PURE, WS9). Re-encodes one
+ * clip to the 3e segment standard (1280×720@24 / libx264 preset-fast crf20 / AAC
+ * 44100 stereo) while optionally trimming its tail ({@link trimTailArgs}) and
+ * letterboxing it onto a canvas ({@link letterboxFilter}). Re-encoding to the
+ * standard keeps the normalized segments uniform, so the demuxer `-c copy` concat
+ * stays valid. `-t` is placed just before the output path so it caps the OUTPUT.
+ */
+export function buildSegmentPrepArgs(segment, outputPath, opts = {}) {
+    const width = opts.width ?? 1280;
+    const height = opts.height ?? 720;
+    // Compose the vf chain in deterministic order: letterbox (geometry) → LUT
+    // (film-stock emulation) → named grade (state color). Each is optional; empties
+    // are dropped, so default behavior is no `-vf` at all.
+    const vf = [
+        letterboxFilter(opts.letterboxRatio, width, height),
+        opts.gradeLut ? `lut3d=${opts.gradeLut}` : '',
+        opts.gradeFilter ?? '',
+    ]
+        .filter((f) => f !== '')
+        .join(',');
+    const args = ['-i', segment];
+    if (vf)
+        args.push('-vf', vf);
+    args.push('-r', String(opts.fps ?? 24), '-c:v', 'libx264', '-preset', 'fast', '-crf', String(opts.crf ?? 20), '-c:a', 'aac', '-b:a', opts.audioBitrate ?? STANDARD_AUDIO_BITRATE, '-ar', String(opts.sampleRate ?? 44100), '-ac', String(opts.channels ?? 2), '-movflags', '+faststart');
+    // -t (when set) just before the output path → caps the output duration.
+    args.push(...trimTailArgs(opts.clipMaxSeconds), outputPath);
+    return args;
+}
+/** Format a number the way the Python f-strings do (`:.2f` / `:.3f`). */
+function fixed(value, digits) {
+    return value.toFixed(digits);
+}
+/**
+ * Build the background-music mix ffmpeg args (PURE). Loops the music under the
+ * narration at a low volume with a tail fade-out, then mixes via amix.
+ *
+ * Ported VERBATIM from assembly_utils.add_background_music (L408-435):
+ *   -i video -stream_loop -1 -i music
+ *   -filter_complex "[0:a]volume=1.0[v];
+ *     [1:a]volume={vol},afade=t=out:st={fade_start}:d={fade_out}[m];
+ *     [v][m]amix=inputs=2:duration=first:dropout_transition=600:normalize=0[a]"
+ *   -map 0:v -map [a]
+ *   -c:v copy -c:a aac -b:a 192k
+ *   -movflags +faststart
+ *   -t {total} output
+ *
+ * fade_start = max(0, total - fade_out). `dropout_transition=600` prevents early
+ * audio cutoff on silent sections; `normalize=0` keeps the narration at full
+ * level while the music stays at `volume`.
+ */
+export function buildMusicMixArgs(videoPath, musicPath, outputPath, opts = {}) {
+    const volume = opts.volume ?? DEFAULT_MUSIC_VOLUME;
+    const fadeOut = opts.fadeOutSec ?? DEFAULT_MUSIC_FADE_OUT_SEC;
+    const totalDur = opts.totalDurationSec ?? 0;
+    const fadeStart = Math.max(0, totalDur - fadeOut);
+    const filterComplex = `[0:a]volume=1.0[v];` +
+        `[1:a]volume=${volume},afade=t=out:st=${fixed(fadeStart, 2)}:d=${fadeOut}[m];` +
+        `[v][m]amix=inputs=2:duration=first:dropout_transition=600:normalize=0[a]`;
+    return [
+        '-i',
+        videoPath,
+        '-stream_loop',
+        '-1',
+        '-i',
+        musicPath,
+        '-filter_complex',
+        filterComplex,
+        '-map',
+        '0:v',
+        '-map',
+        '[a]',
+        '-c:v',
+        'copy',
+        '-c:a',
+        'aac',
+        '-b:a',
+        STANDARD_AUDIO_BITRATE,
+        '-movflags',
+        '+faststart',
+        '-t',
+        fixed(totalDur, 3),
+        outputPath,
+    ];
+}
+/**
+ * Build ffmpeg args that mix the video's own audio together with N additional
+ * audio layers. **PURE** — returns only the arg-string array; never spawns
+ * processes, reads files, or has side-effects.
+ *
+ * ## Input numbering
+ * - Input 0 : the video file (carries video + its original audio).
+ * - Inputs 1…N : the supplied `layers`, in order.
+ *
+ * ## Filter graph — static-volume path (default)
+ * ```
+ * [1:a]volume=<v1>[l1]; [2:a]volume=<v2>[l2]; …
+ * [0:a][l1][l2]…amix=inputs=N+1:duration=first:dropout_transition=600:normalize=0[a]
+ * ```
+ *
+ * ## Filter graph — ducking path (`duckMusicUnderVoice=true` + voice layer present)
+ * ```
+ * per-layer volume chains as above …
+ * [voice_labels…]amix=…[voice]          (or direct passthrough for single voice)
+ * [voice]asplit=M+1[vs0]…[vsM-1][vsfinal]
+ * [l_music0][vs0]sidechaincompress=…[duck0]; [l_music1][vs1]sidechaincompress=…[duck1]; …
+ * [0:a][duck0][duck1]…[vsfinal][sfx…]amix=inputs=M+2+S:…[a]
+ * ```
+ * where M = number of music layers and S = number of sfx layers.
+ * SFX layers are mixed in at their own volume but are NEVER used as a
+ * sidechain signal and do NOT by themselves enable ducking (only
+ * `narration`/`dialogue` layers count as voice for the `duckMusicUnderVoice`
+ * gate).
+ *
+ * ## Output mapping
+ * `-map 0:v -map [a] -c:v copy -c:a aac -b:a 192k -movflags +faststart <output>`
+ */
+export function buildMultiLayerMixArgs(videoPath, layers, outputPath, opts = {}) {
+    if (layers.length === 0) {
+        throw new Error('buildMultiLayerMixArgs: at least one layer is required');
+    }
+    const doDuck = opts.duckMusicUnderVoice ?? false;
+    const globalMusicVol = opts.musicVolume ?? DEFAULT_MUSIC_VOLUME;
+    // ── Input args ────────────────────────────────────────────────────────────
+    // Video is always input 0. Each layer follows; music layers get -stream_loop.
+    const inputArgs = ['-i', videoPath];
+    for (const layer of layers) {
+        const shouldLoop = layer.loop ?? layer.role === 'music';
+        if (shouldLoop)
+            inputArgs.push('-stream_loop', '-1');
+        inputArgs.push('-i', layer.trackPath);
+    }
+    // ── Per-layer volume chains ───────────────────────────────────────────────
+    // Build these first (index-stable); categorise into music vs voice labels.
+    const filterParts = [];
+    const allLayerLabels = []; // [l1], [l2], … (in layer order)
+    const musicLayerLabels = []; // subset with role === 'music'
+    const voiceLayerLabels = []; // subset with role narration|dialogue
+    const sfxLayerLabels = []; // subset with role === 'sfx' (mixed, never a sidechain)
+    for (let i = 0; i < layers.length; i += 1) {
+        const layer = layers[i];
+        const inputIdx = i + 1; // 0 is video
+        const label = `[l${inputIdx}]`;
+        allLayerLabels.push(label);
+        const vol = layer.volume !== undefined
+            ? layer.volume
+            : layer.role === 'music'
+                ? globalMusicVol
+                : 1.0;
+        filterParts.push(`[${inputIdx}:a]volume=${vol}${label}`);
+        if (layer.role === 'music') {
+            musicLayerLabels.push(label);
+        }
+        else if (layer.role === 'sfx') {
+            // SFX is mixed alongside everything else but must never serve as a
+            // sidechain signal and must not by itself enable music ducking.
+            sfxLayerLabels.push(label);
+        }
+        else {
+            // narration | dialogue → genuine voice signal that drives ducking.
+            voiceLayerLabels.push(label);
+        }
+    }
+    const hasVoice = voiceLayerLabels.length > 0;
+    const hasMusic = musicLayerLabels.length > 0;
+    if (doDuck && hasVoice && hasMusic) {
+        // ── Sidechain-ducking path ──────────────────────────────────────────────
+        //
+        // Step 1: Merge all voice labels into a single [voice] stream.
+        //   - One voice label  → simple volume=1.0 passthrough (rename).
+        //   - Multiple labels  → amix down to mono [voice].
+        const voiceLabel = '[voice]';
+        if (voiceLayerLabels.length === 1) {
+            filterParts.push(`${voiceLayerLabels[0]}volume=1.0${voiceLabel}`);
+        }
+        else {
+            const joined = voiceLayerLabels.join('');
+            filterParts.push(`${joined}amix=inputs=${voiceLayerLabels.length}:duration=first:dropout_transition=600:normalize=0${voiceLabel}`);
+        }
+        // Step 2: asplit [voice] into M+1 copies:
+        //   [vs0]…[vsM-1] → one per music layer (sidechain signal)
+        //   [vsfinal]     → passed into the final amix so voice stays audible
+        const numMusicLayers = musicLayerLabels.length;
+        const totalSplits = numMusicLayers + 1;
+        const splitOutputLabels = Array.from({ length: totalSplits }, (_, k) => (k < numMusicLayers ? `[vs${k}]` : '[vsfinal]'));
+        filterParts.push(`${voiceLabel}asplit=${totalSplits}${splitOutputLabels.join('')}`);
+        // Step 3: Sidechain-compress each music layer against its voice copy.
+        //   sidechaincompress: [main][sidechain] → [duckN]
+        const duckLabels = [];
+        for (let mi = 0; mi < numMusicLayers; mi += 1) {
+            const duckLabel = `[duck${mi}]`;
+            filterParts.push(`${musicLayerLabels[mi]}[vs${mi}]sidechaincompress=threshold=0.25:ratio=4:attack=5:release=200${duckLabel}`);
+            duckLabels.push(duckLabel);
+        }
+        // Step 4: Final amix — video audio + all ducked music + the final voice
+        //   copy + any sfx layers (mixed at full/own volume, NOT ducked).
+        //   inputs = 1 (video) + M (ducked music) + 1 (vsfinal) + S (sfx)
+        const finalMixInputs = ['[0:a]', ...duckLabels, '[vsfinal]', ...sfxLayerLabels].join('');
+        const finalMixCount = 1 + duckLabels.length + 1 + sfxLayerLabels.length;
+        filterParts.push(`${finalMixInputs}amix=inputs=${finalMixCount}:duration=first:dropout_transition=600:normalize=0[a]`);
+    }
+    else {
+        // ── Static-volume amix path (default / legacy-compatible) ───────────────
+        // Mix: [0:a] + [l1] + [l2] + … → amix → [a]
+        const allInputs = ['[0:a]', ...allLayerLabels].join('');
+        const totalInputs = 1 + allLayerLabels.length;
+        filterParts.push(`${allInputs}amix=inputs=${totalInputs}:duration=first:dropout_transition=600:normalize=0[a]`);
+    }
+    // ── Output args ───────────────────────────────────────────────────────────
+    return [
+        ...inputArgs,
+        '-filter_complex',
+        filterParts.join(';'),
+        '-map',
+        '0:v',
+        '-map',
+        '[a]',
+        '-c:v',
+        'copy',
+        '-c:a',
+        'aac',
+        '-b:a',
+        STANDARD_AUDIO_BITRATE,
+        '-movflags',
+        '+faststart',
+        outputPath,
+    ];
+}
+/**
+ * Compose the full ordered layer list for the multi-layer mix step: the
+ * `music` bed (if present) first as a looped `music` layer, then the extra
+ * `audioLayers` (dialogue/sfx/voice) in order. Pure. Only called when
+ * `input.audioLayers` is non-empty, so the result always has ≥1 layer.
+ */
+function combinedAudioLayers(input) {
+    const musicLayer = input.music
+        ? [
+            {
+                trackPath: input.music.trackPath,
+                role: 'music',
+                loop: true,
+                ...(input.music.volume !== undefined ? { volume: input.music.volume } : {}),
+            },
+        ]
+        : [];
+    return [...musicLayer, ...(input.audioLayers ?? [])];
+}
+/**
+ * Orchestrate the stitch: write the concat list (demuxer path), pick the
+ * demuxer-vs-filter path, run via `runFfmpeg`, optionally mix a music bed, and
+ * return the final MP4 path + a plan of the executed command sequence.
+ *
+ * On `dryRun`, returns the planned command sequence WITHOUT writing the concat
+ * list, spawning ffmpeg, or probing durations (music fade-start is computed
+ * from 0). This is the path unit tests use.
+ *
+ * NOTE: the real-spawn path. The final-MP4 quality check is a HUMAN integration
+ * checkpoint — out of scope here.
+ */
+export async function stitch(input, opts = {}) {
+    const segs = orderedSegments(input);
+    if (segs.length === 0) {
+        // Defensive: nothing to concat. Caller is expected to pass >=1 segment.
+        throw new Error('stitch: no segments to concatenate');
+    }
+    const strategy = selectConcatStrategy(input.concatStrategy ?? 'auto', segs.length);
+    const hasMusic = input.music !== undefined;
+    // Extra (dialogue/sfx/voice) global layers beyond the music bed. Presence
+    // here flips the mix step from the legacy single-music buildMusicMixArgs path
+    // to the multi-layer buildMultiLayerMixArgs path. Empty/undefined ⇒ legacy.
+    const hasExtraLayers = (input.audioLayers?.length ?? 0) > 0;
+    // Any audio mix at all (music bed and/or extra layers) requires the
+    // concat→intermediate→mix two-step. When neither is present, concat targets
+    // the final output directly (byte-identical legacy no-audio path).
+    const hasAudioMix = hasMusic || hasExtraLayers;
+    const concatListPath = input.concatListPath ?? resolvePath(dirname(input.outputPath), 'concat.txt');
+    // When audio is mixed, concat writes an intermediate file and the mix step
+    // produces the final output (mirrors nex_assemble's concat_no_music.mp4).
+    const concatOutput = hasAudioMix
+        ? resolvePath(dirname(input.outputPath), 'concat_no_music.mp4')
+        : input.outputPath;
+    const plan = [];
+    // --- Optional per-segment normalization pre-pass (WS9) ---
+    // When a tail-cut or letterbox is requested, each ordered segment is
+    // re-encoded to the standard (dropping dead tail frames / adding cinematic
+    // bars) before concat; the concat then consumes the normalized clips. Default
+    // (neither field set) emits no prep steps and is byte-identical to legacy.
+    const hasGrade = (typeof input.gradeLut === 'string' && input.gradeLut !== '') ||
+        (typeof input.gradeId === 'string' && input.gradeId !== '') ||
+        (input.segmentGradeIds?.some((g) => typeof g === 'string' && g !== '') ?? false);
+    const needsPrep = (input.clipMaxSeconds !== undefined && input.clipMaxSeconds > 0) ||
+        (typeof input.letterboxRatio === 'string' && input.letterboxRatio !== '') ||
+        hasGrade;
+    const prepDir = resolvePath(dirname(input.outputPath), '.prep');
+    const concatSegs = needsPrep
+        ? segs.map((_, i) => resolvePath(prepDir, `seg-${String(i).padStart(3, '0')}.mp4`))
+        : segs;
+    if (needsPrep) {
+        segs.forEach((seg, i) => {
+            // Per-segment grade override realizes the narrative color language; falls
+            // back to the uniform gradeId.
+            const gradeFilter = resolveGradeFilter(input.segmentGradeIds?.[i] ?? input.gradeId);
+            plan.push({
+                kind: 'segment-prep',
+                args: buildSegmentPrepArgs(seg, concatSegs[i], {
+                    clipMaxSeconds: input.clipMaxSeconds,
+                    letterboxRatio: input.letterboxRatio,
+                    width: input.letterboxCanvas?.width,
+                    height: input.letterboxCanvas?.height,
+                    gradeLut: input.gradeLut,
+                    gradeFilter,
+                }),
+                outputPath: concatSegs[i],
+            });
+        });
+    }
+    // --- Concat step ---
+    const concatArgs = strategy === 'demuxer'
+        ? buildConcatDemuxerArgs(concatSegs, concatListPath, concatOutput)
+        : buildConcatFilterArgs(concatSegs, concatOutput);
+    plan.push({
+        kind: strategy === 'demuxer' ? 'concat-demuxer' : 'concat-filter',
+        args: concatArgs,
+        outputPath: concatOutput,
+    });
+    // --- Audio-mix step (optional) ---
+    // Two mutually-exclusive paths:
+    //   * hasExtraLayers → multi-layer mix (music bed prepended + dialogue/sfx).
+    //   * music-only     → the EXACT legacy buildMusicMixArgs path (byte-identical).
+    // Neither ⇒ no mix step (legacy no-audio path).
+    if (hasExtraLayers) {
+        const layers = combinedAudioLayers(input);
+        const mixArgs = buildMultiLayerMixArgs(concatOutput, layers, input.outputPath);
+        plan.push({ kind: 'multi-layer-mix', args: mixArgs, outputPath: input.outputPath });
+    }
+    else if (hasMusic && input.music) {
+        // The fade-start / -t cap need the concat duration; on dry-run we leave it 0.
+        const musicArgs = buildMusicMixArgs(concatOutput, input.music.trackPath, input.outputPath, {
+            volume: input.music.volume,
+            fadeOutSec: input.music.fadeOutSec,
+            totalDurationSec: 0,
+        });
+        plan.push({ kind: 'music-mix', args: musicArgs, outputPath: input.outputPath });
+    }
+    if (opts.dryRun) {
+        return {
+            status: 'dry-run',
+            outputPath: input.outputPath,
+            orderedSegments: segs,
+            concatStrategy: strategy,
+            music: hasMusic,
+            plan,
+            durationMs: 0,
+        };
+    }
+    // --- Pre-concat corruption guard ---
+    // useapi sometimes reports a generation 'complete' while the downloaded mp4
+    // is truncated (no moov atom): it passes existence/size checks but ffmpeg
+    // concat later dies with "Invalid data found when processing input". Probe
+    // each real input segment up front so the corrupt one is named clearly.
+    // Only the actual segment inputs are probed (not derived intermediates).
+    if (!opts.skipSegmentValidation) {
+        for (const seg of segs) {
+            const ok = await isValidMp4(seg, { ffprobeBin: opts.ffprobeBin });
+            if (!ok) {
+                throw new VclawError('ffmpeg_failed', `stitch input segment is a corrupt or truncated MP4 (ffprobe could not read a valid duration): ${seg}`, { segment: seg });
+            }
+        }
+    }
+    // --- Real execution ---
+    await mkdir(dirname(input.outputPath), { recursive: true });
+    // Per-segment normalization pre-pass: concat then reads the normalized clips.
+    if (needsPrep) {
+        await mkdir(prepDir, { recursive: true });
+        for (const step of plan) {
+            if (step.kind === 'segment-prep')
+                await runFfmpeg(step.args, opts);
+        }
+    }
+    if (strategy === 'demuxer') {
+        await mkdir(dirname(concatListPath), { recursive: true });
+        await writeFile(concatListPath, buildConcatListContent(concatSegs), 'utf8');
+    }
+    await runFfmpeg(concatArgs, opts);
+    let finalPath = concatOutput;
+    if (hasExtraLayers) {
+        // Multi-layer mix: dialogue/sfx (+ optional music bed) over the concat.
+        // buildMultiLayerMixArgs uses duration=first (driven by the video input),
+        // so it needs no probed total — the args are already final from planning.
+        const mixStep = plan.find((s) => s.kind === 'multi-layer-mix');
+        const mixArgs = mixStep?.args ?? buildMultiLayerMixArgs(concatOutput, combinedAudioLayers(input), input.outputPath);
+        await runFfmpeg(mixArgs, opts);
+        finalPath = input.outputPath;
+    }
+    else if (hasMusic && input.music) {
+        // Probe the concat output to compute the real fade-start + -t cap.
+        const concatMs = await ffprobeDuration(concatOutput, { ffprobeBin: opts.ffprobeBin });
+        const musicArgs = buildMusicMixArgs(concatOutput, input.music.trackPath, input.outputPath, {
+            volume: input.music.volume,
+            fadeOutSec: input.music.fadeOutSec,
+            totalDurationSec: concatMs / 1000,
+        });
+        // Refresh the plan's music step with the duration-resolved args.
+        const musicStep = plan.find((s) => s.kind === 'music-mix');
+        if (musicStep)
+            musicStep.args = musicArgs;
+        await runFfmpeg(musicArgs, opts);
+        finalPath = input.outputPath;
+    }
+    const durationMs = await ffprobeDuration(finalPath, { ffprobeBin: opts.ffprobeBin });
+    // Touch stat so a 0-byte output surfaces as a runtime failure path-side.
+    await stat(finalPath);
+    return {
+        status: 'complete',
+        outputPath: finalPath,
+        orderedSegments: segs,
+        concatStrategy: strategy,
+        music: hasMusic,
+        plan,
+        durationMs,
+    };
+}
+//# sourceMappingURL=stitch.js.map

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

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