videoclaw 3.0.0-alpha.1

package/dist/video/motion-overlay/execute.js

@@ -0,0 +1,205 @@
+/**
+ * Motion-overlay execution (Phase 4) — V2V + audio-restore + stitch.
+ *
+ * `runMotionOverlay` drives the render half of `vclaw video motion-overlay
+ * --execute`. The PLAN (a `MotionOverlayPlan` from `run.ts`) stays the source of
+ * truth: this module renders each of its takes IN ORDER through three steps and
+ * stitches the results into the final reel. It re-derives no slicing, prompting,
+ * or routing — the plan already fixed those.
+ *
+ * Per take:
+ *   1. Omni Flash V2V — feed the take's base footage (`takes/…mp4`) + the take's
+ *      composed prompt to the Google Flow omni-flash video-to-video transport.
+ *      Flow paints the kinetic typography / icon / metaphor overlay while keeping
+ *      the spoken content, but it RE-ENCODES the audio.
+ *   2. Audio-restore — `ffmpeg -i <v2v> -i <take> -map 0:v -map 1:a -c:v copy
+ *      -c:a aac <out>`: take the annotated VIDEO from the V2V output and the
+ *      ORIGINAL AUDIO from the source take, so the reel honors CRITICAL RULE 1
+ *      (pass the original voiceover through) as closely as the transport allows.
+ *   3. Collect the audio-restored take.
+ * Then the collected takes are clip-stitched (in take order) into the final reel.
+ *
+ * Credit safety is structural: every side effect (V2V submit/poll, the
+ * audio-restore ffmpeg mux, and the stitch) is delegated to an injectable
+ * {@link MotionOverlayStepRunner}. The CLI supplies a runner that shells the real
+ * `vclaw video` V2V path + ffmpeg + the assemble clip-stitch; tests inject a fake
+ * runner, so the whole orchestrator runs offline with NO provider spend.
+ *
+ * Dry vs execute: default (`confirmSpend` falsey) is a dry plan — the runner is
+ * NOT invoked at all and the report enumerates the steps that WOULD run. Only
+ * `confirmSpend: true` actually drives the runner. This mirrors `studio/execute.ts`.
+ */
+import { mkdir } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { runFfmpeg } from '../assemble/ffmpeg.js';
+import { stitch } from '../assemble/stitch.js';
+import { takeStem } from './plan.js';
+export class MotionOverlayExecuteError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'MotionOverlayExecuteError';
+    }
+}
+/** The subdir under the work folder where V2V outputs land. */
+export const V2V_DIRNAME = 'v2v';
+/** The subdir under the work folder where audio-restored takes land. */
+export const RESTORED_DIRNAME = 'restored';
+/** The final reel filename written into the work folder. */
+export const REEL_FILENAME = 'motion-overlay-reel.mp4';
+/** Resolve the per-take base-footage path from a take's manifest `file` field. */
+function baseFootagePath(workdir, take) {
+    // `take.file` is the work-folder-relative `takes/…mp4` path written by plan.ts.
+    return join(workdir, take.file);
+}
+/**
+ * Reconstruct a take's stem (e.g. `take-01_0s-10s`) from its manifest fields so
+ * the V2V / restored outputs sit beside the takes with matching names. We rebuild
+ * the same {@link takeStem} the planner used from the take's index + bounds.
+ */
+function takeStemOf(take) {
+    const split = { index: take.index, start: take.start, end: take.end, segmentIndices: [] };
+    return takeStem(split);
+}
+/**
+ * Execute (or dry-plan) a motion-overlay reel from its plan.
+ *
+ * Takes are processed strictly IN ORDER; the final reel stitches the
+ * audio-restored takes in that same order. Pure control flow — all I/O is
+ * delegated to `opts.runner`. Never mutates the input plan.
+ *
+ * Throws {@link MotionOverlayExecuteError} (`motion_overlay_no_takes`) if the
+ * plan has zero takes (nothing to render or stitch).
+ */
+export async function runMotionOverlay(plan, opts) {
+    if (plan.takes.length === 0) {
+        throw new MotionOverlayExecuteError('motion_overlay_no_takes', 'motion-overlay execute: the plan has no takes to render.');
+    }
+    const confirmSpend = opts.confirmSpend === true;
+    const mode = confirmSpend ? 'execute' : 'dry';
+    const reelPath = join(plan.workdir, REEL_FILENAME);
+    const results = [];
+    // Takes are sorted by index defensively so the stitch order is deterministic
+    // regardless of manifest ordering.
+    const orderedTakes = [...plan.takes].sort((a, b) => a.index - b.index);
+    const hostBaseByIndex = opts.hostBaseByIndex ?? {};
+    for (const take of orderedTakes) {
+        const stem = takeStemOf(take);
+        // The ORIGINAL source take — always the audio source (the real voiceover).
+        const sourceTake = baseFootagePath(plan.workdir, take);
+        // The V2V base footage: the generated host clip on avatar-host (when present),
+        // else the source take. The audio-restore source stays the source take.
+        const baseFootage = hostBaseByIndex[take.index] ?? sourceTake;
+        const v2vVideo = join(plan.workdir, V2V_DIRNAME, `${stem}.mp4`);
+        const restoredTake = join(plan.workdir, RESTORED_DIRNAME, `${stem}.mp4`);
+        if (confirmSpend) {
+            // 1. Omni Flash V2V: base footage + composed prompt → annotated take.
+            await opts.runner.runV2V({
+                index: take.index,
+                baseFootage,
+                prompt: take.prompt,
+                outputPath: v2vVideo,
+            });
+            // 2. Audio-restore: mux the ORIGINAL take audio onto the annotated video.
+            await opts.runner.restoreAudio({
+                index: take.index,
+                v2vVideo,
+                originalTake: sourceTake,
+                outputPath: restoredTake,
+            });
+        }
+        results.push({
+            index: take.index,
+            anatomy: take.anatomy,
+            baseFootage,
+            audioSource: sourceTake,
+            v2vVideo,
+            restoredTake,
+            status: confirmSpend ? 'ran' : 'planned',
+        });
+    }
+    // 3. Clip-stitch the audio-restored takes (in take order) into the final reel.
+    const takeClips = results.map((r) => r.restoredTake);
+    if (confirmSpend) {
+        await opts.runner.stitch({ takeClips, outputPath: reelPath });
+    }
+    const report = {
+        schemaVersion: 1,
+        mode,
+        executed: confirmSpend,
+        takes: results,
+        reelPath,
+    };
+    if (!confirmSpend) {
+        report.hint =
+            'Dry run: no provider was called. Re-run with --execute --confirm-spend to render each take through Omni Flash V2V, restore the original audio, and stitch the reel.';
+    }
+    return report;
+}
+// ---------------------------------------------------------------------------
+// Default (real) runner
+// ---------------------------------------------------------------------------
+/**
+ * Build the audio-restore ffmpeg args (PURE). Takes the annotated VIDEO from the
+ * V2V output and the ORIGINAL AUDIO from the source take, re-muxing them so the
+ * reel keeps the untouched voiceover (CRITICAL RULE 1).
+ *
+ *   -i <v2v_video> -i <original_take>
+ *   -map 0:v -map 1:a   (video from input 0, audio from input 1)
+ *   -c:v copy           (don't re-encode the annotated video)
+ *   -c:a aac            (re-encode the restored audio to AAC for mp4 compat)
+ *   -shortest           (cap to the shorter stream so a length mismatch can't
+ *                        leave a trailing black/silent tail)
+ *   <output>
+ *
+ * (`-y` is prepended by `runFfmpeg`, so it is NOT included here.)
+ */
+export function buildAudioRestoreArgs(v2vVideo, originalTake, outputPath) {
+    return [
+        '-i',
+        v2vVideo,
+        '-i',
+        originalTake,
+        '-map',
+        '0:v',
+        '-map',
+        '1:a',
+        '-c:v',
+        'copy',
+        '-c:a',
+        'aac',
+        '-shortest',
+        outputPath,
+    ];
+}
+/**
+ * Build the default {@link MotionOverlayStepRunner} that shells the REAL render
+ * path: `v2v` for each take's omni-flash render, `runFfmpeg` for the audio-restore
+ * mux ({@link buildAudioRestoreArgs}), and the assemble {@link stitch} clip-stitch
+ * for the final reel. The V2V transport is injected so the audio + stitch wiring
+ * stays independently testable; the whole runner is ONLY used under
+ * `--execute --confirm-spend`, so tests never reach it (they inject a fake runner).
+ */
+export function createDefaultMotionOverlayRunner(opts) {
+    const ffmpegBin = opts.ffmpegBin;
+    return {
+        async runV2V(step) {
+            await mkdir(dirname(step.outputPath), { recursive: true });
+            await opts.v2v(step);
+        },
+        async restoreAudio(step) {
+            await mkdir(dirname(step.outputPath), { recursive: true });
+            await runFfmpeg(buildAudioRestoreArgs(step.v2vVideo, step.originalTake, step.outputPath), {
+                ...(ffmpegBin ? { ffmpegBin } : {}),
+            });
+        },
+        async stitch(step) {
+            await mkdir(dirname(step.outputPath), { recursive: true });
+            // Clip-stitch mode: stitch the audio-restored takes directly (each take is
+            // an independent rendered clip, so demuxer/filter selection is automatic).
+            await stitch({ segments: step.takeClips, outputPath: step.outputPath }, { ...(ffmpegBin ? { ffmpegBin } : {}) });
+        },
+    };
+}
+//# sourceMappingURL=execute.js.map

package/dist/video/motion-overlay/execute.js.map

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

package/dist/video/motion-overlay/flow-pack.d.ts

@@ -0,0 +1,65 @@
+import type { MotionOverlayPlan, MotionTake } from './types.js';
+/** Pure: pull the prompt body out of a `prompts/take-NN.md` — the text between the
+ * first pair of ``` fences (the ready-to-paste Omni prompt). Falls back to the
+ * whole doc if no fence is present. */
+export declare function extractPromptBlock(md: string): string;
+/** One pack entry: a take's clip + its prompt file (basenames, inside the pack). */
+export interface FlowPackEntry {
+    index: number;
+    clip: string;
+    prompt: string;
+    span: string;
+}
+/** Pure: the README walking the operator through the Flow web hand-off. */
+export declare function flowPackReadme(args: {
+    entries: FlowPackEntry[];
+    style: string;
+    layout: string;
+}): string;
+/** Injectable fs seam for the pack writer (tests pass fakes). */
+export interface EmitFlowPackDeps {
+    copyFile?: (src: string, dst: string) => Promise<void>;
+    readFile?: (p: string) => Promise<string>;
+    writeFile?: (p: string, data: string) => Promise<void>;
+}
+export interface FlowPackResult {
+    packDir: string;
+    entries: FlowPackEntry[];
+}
+/**
+ * Emit the hand-off pack into `outDir`: copy each take clip, write its prompt as a
+ * clean `.txt`, and a README. Reads the take + prompt files the planner already
+ * wrote under `plan.workdir`. Pure control flow over injectable fs.
+ */
+export declare function emitFlowPack(plan: MotionOverlayPlan, outDir: string, deps?: EmitFlowPackDeps): Promise<FlowPackResult>;
+/**
+ * Pure: pair each take (in order) with its returned animated clip. Prefers a file
+ * whose name contains the take's `take-0N` token; otherwise falls back to sorted
+ * positional order. Returns `null` for a take with no matching output.
+ */
+export declare function pairFlowOutputs(takes: MotionTake[], files: string[]): Array<{
+    take: MotionTake;
+    file: string | null;
+}>;
+/**
+ * Pure: ffmpeg concat-filter args joining N restored clips into one reel (re-encode;
+ * robust across heterogeneous inputs). `-y` is prepended by the runner.
+ */
+export declare function buildConcatArgs(clips: string[], outputPath: string): string[];
+/** Injectable ffmpeg seam for restitch. */
+export type FfmpegRunner = (args: string[]) => Promise<void>;
+export interface RestitchResult {
+    outputPath: string;
+    takeCount: number;
+    restored: string[];
+}
+/**
+ * Restitch: for each take, re-mux the operator's downloaded animated clip with the
+ * take's ORIGINAL audio (`buildAudioRestoreArgs`), then concat into the final reel.
+ * Throws if a take has no matching animated output.
+ */
+export declare function restitchFlowOutputs(plan: MotionOverlayPlan, flowOutDir: string, outputPath: string, deps: {
+    ffmpeg: FfmpegRunner;
+    listDir?: (d: string) => Promise<string[]>;
+}): Promise<RestitchResult>;
+//# sourceMappingURL=flow-pack.d.ts.map

package/dist/video/motion-overlay/flow-pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-pack.d.ts","sourceRoot":"","sources":["../../../src/video/motion-overlay/flow-pack.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEhE;;uCAEuC;AACvC,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED,oFAAoF;AACpF,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,IAAI,EAAE;IAAE,OAAO,EAAE,aAAa,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAiCxG;AAED,iEAAiE;AACjE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,iBAAiB,EACvB,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,gBAAqB,GAC1B,OAAO,CAAC,cAAc,CAAC,CAmBzB;AAMD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAmBtH;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CA4B7E;AAED,2CAA2C;AAC3C,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE7D,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,iBAAiB,EACvB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;CAAE,GACzE,OAAO,CAAC,cAAc,CAAC,CAmBzB"}

package/dist/video/motion-overlay/flow-pack.js

@@ -0,0 +1,178 @@
+/**
+ * Flow hand-off pack + restitch — the productised "manual Omni" loop.
+ *
+ * The source skill's real pipeline is: *write prompts → upload each take + paste
+ * its prompt into Google Flow (Omni) by hand → download → stitch*. The Omni step
+ * was never automated (the skill marks it "under construction") and Flow's current
+ * web UI does not accept video uploads through the API or the Agent editor — so the
+ * hand-off stays manual. This module turns that manual loop into first-class
+ * artifacts instead of throwaway shell scripts:
+ *
+ *  - `emitFlowPack(plan, outDir)` — write a drop-in folder: each take's clip + a
+ *    clean, ready-to-paste prompt `.txt` (the prompt body extracted from the
+ *    `prompts/take-NN.md` the planner already wrote) + a README of the workflow.
+ *  - `restitchFlowOutputs(plan, flowOutDir, outputPath)` — once the operator drops
+ *    the animated takes back, re-mux each with its ORIGINAL audio (CRITICAL RULE 1)
+ *    and concatenate into the finished reel.
+ *
+ * Pure builders (prompt extraction, README, output pairing, concat args) are
+ * unit-tested; the fs copy + ffmpeg runs are injectable seams, so the whole module
+ * is exercised offline with no ffmpeg.
+ */
+import { mkdir, copyFile as fsCopyFile, writeFile as fsWriteFile, readFile as fsReadFile, readdir } from 'node:fs/promises';
+import { basename, join } from 'node:path';
+import { buildAudioRestoreArgs } from './execute.js';
+/** Pure: pull the prompt body out of a `prompts/take-NN.md` — the text between the
+ * first pair of ``` fences (the ready-to-paste Omni prompt). Falls back to the
+ * whole doc if no fence is present. */
+export function extractPromptBlock(md) {
+    const m = md.match(/```[^\n]*\n([\s\S]*?)\n```/);
+    return (m ? m[1] : md).trim();
+}
+/** Pure: the README walking the operator through the Flow web hand-off. */
+export function flowPackReadme(args) {
+    const rows = args.entries
+        .map((e) => `| \`${e.clip}\` | \`${e.prompt}\` | ${e.span} |`)
+        .join('\n');
+    return `# Flow hand-off pack
+
+Google Flow's API blocks the V2V "add overlays to my video" edit, and its web
+editor won't accept a video upload — so the Omni step is **manual** (exactly how the
+source skill's author does it). The prompts are already written; you upload + paste.
+
+Style: **${args.style}** · Layout: **${args.layout}**
+
+## Takes (one prompt per ≤10s clip)
+
+| Clip to upload | Prompt to paste | Span |
+|---|---|---|
+${rows}
+
+## Steps (per take)
+1. Open Google Flow and **upload** \`take-NN.mp4\`.
+2. **Paste** the entire contents of \`take-NN.txt\` as the prompt.
+3. Generate → **download** the result into a \`done/\` folder here, keeping the
+   take order (e.g. \`done/take-01_out.mp4\`).
+
+The prompt preserves your original audio and renders only the quoted on-screen text.
+
+## Then restitch
+\`\`\`
+vclaw video motion-overlay --output-dir <this work dir> --restitch <path to done/>
+\`\`\`
+That re-muxes each animated take with its **original audio** and concatenates the
+finished reel (\`motion-overlay-reel.mp4\`).
+`;
+}
+/**
+ * Emit the hand-off pack into `outDir`: copy each take clip, write its prompt as a
+ * clean `.txt`, and a README. Reads the take + prompt files the planner already
+ * wrote under `plan.workdir`. Pure control flow over injectable fs.
+ */
+export async function emitFlowPack(plan, outDir, deps = {}) {
+    const copyFile = deps.copyFile ?? fsCopyFile;
+    const readFile = deps.readFile ?? ((p) => fsReadFile(p, 'utf-8'));
+    const writeFile = deps.writeFile ?? ((p, d) => fsWriteFile(p, d, 'utf-8'));
+    await mkdir(outDir, { recursive: true });
+    const ordered = [...plan.takes].sort((a, b) => a.index - b.index);
+    const entries = [];
+    for (const take of ordered) {
+        const clipName = basename(take.file);
+        const stem = clipName.replace(/\.mp4$/i, '');
+        const promptName = `${stem}.txt`;
+        await copyFile(join(plan.workdir, take.file), join(outDir, clipName));
+        const md = await readFile(join(plan.workdir, take.promptFile));
+        await writeFile(join(outDir, promptName), extractPromptBlock(md));
+        entries.push({ index: take.index, clip: clipName, prompt: promptName, span: `${fmtT(take.start)}–${fmtT(take.end)}s` });
+    }
+    await writeFile(join(outDir, 'README.md'), flowPackReadme({ entries, style: plan.style, layout: plan.layout }));
+    return { packDir: outDir, entries };
+}
+function fmtT(s) {
+    return Number.isInteger(s) ? String(s) : s.toFixed(1);
+}
+/**
+ * Pure: pair each take (in order) with its returned animated clip. Prefers a file
+ * whose name contains the take's `take-0N` token; otherwise falls back to sorted
+ * positional order. Returns `null` for a take with no matching output.
+ */
+export function pairFlowOutputs(takes, files) {
+    const ordered = [...takes].sort((a, b) => a.index - b.index);
+    const sortedFiles = [...files].sort();
+    const used = new Set();
+    const result = ordered.map((take) => {
+        const token = `take-${String(take.index + 1).padStart(2, '0')}`;
+        const hit = sortedFiles.find((f) => !used.has(f) && basename(f).toLowerCase().includes(token));
+        if (hit)
+            used.add(hit);
+        return { take, file: hit ?? null };
+    });
+    // Second pass: fill any unmatched take from the remaining files in sorted order.
+    const remaining = sortedFiles.filter((f) => !used.has(f));
+    let r = 0;
+    for (const entry of result) {
+        if (!entry.file && r < remaining.length) {
+            entry.file = remaining[r++];
+        }
+    }
+    return result;
+}
+/**
+ * Pure: ffmpeg concat-filter args joining N restored clips into one reel (re-encode;
+ * robust across heterogeneous inputs). `-y` is prepended by the runner.
+ */
+export function buildConcatArgs(clips, outputPath) {
+    const inputs = clips.flatMap((c) => ['-i', c]);
+    const refs = clips.map((_, i) => `[${i}:v][${i}:a]`).join('');
+    const filter = `${refs}concat=n=${clips.length}:v=1:a=1[v][a]`;
+    return [
+        ...inputs,
+        '-filter_complex',
+        filter,
+        '-map',
+        '[v]',
+        '-map',
+        '[a]',
+        '-c:v',
+        'libx264',
+        '-crf',
+        '18',
+        '-preset',
+        'fast',
+        '-pix_fmt',
+        'yuv420p',
+        '-c:a',
+        'aac',
+        '-b:a',
+        '192k',
+        '-movflags',
+        '+faststart',
+        outputPath,
+    ];
+}
+/**
+ * Restitch: for each take, re-mux the operator's downloaded animated clip with the
+ * take's ORIGINAL audio (`buildAudioRestoreArgs`), then concat into the final reel.
+ * Throws if a take has no matching animated output.
+ */
+export async function restitchFlowOutputs(plan, flowOutDir, outputPath, deps) {
+    const listDir = deps.listDir ?? (async (d) => (await readdir(d)).filter((n) => n.endsWith('.mp4')).map((n) => join(d, n)));
+    const files = await listDir(flowOutDir);
+    const pairs = pairFlowOutputs(plan.takes, files);
+    const missing = pairs.filter((p) => !p.file).map((p) => p.take.index + 1);
+    if (missing.length) {
+        throw new Error(`restitch: no animated output found for take(s) ${missing.join(', ')} in ${flowOutDir}`);
+    }
+    const restoredDir = join(plan.workdir, 'restored');
+    await mkdir(restoredDir, { recursive: true });
+    const restored = [];
+    for (const { take, file } of pairs) {
+        const out = join(restoredDir, basename(take.file));
+        await deps.ffmpeg(buildAudioRestoreArgs(file, join(plan.workdir, take.file), out));
+        restored.push(out);
+    }
+    await mkdir(join(outputPath, '..'), { recursive: true }).catch(() => { });
+    await deps.ffmpeg(buildConcatArgs(restored, outputPath));
+    return { outputPath, takeCount: restored.length, restored };
+}
+//# sourceMappingURL=flow-pack.js.map

package/dist/video/motion-overlay/flow-pack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-pack.js","sourceRoot":"","sources":["../../../src/video/motion-overlay/flow-pack.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAE,KAAK,EAAE,QAAQ,IAAI,UAAU,EAAE,SAAS,IAAI,WAAW,EAAE,QAAQ,IAAI,UAAU,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC5H,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAGrD;;uCAEuC;AACvC,MAAM,UAAU,kBAAkB,CAAC,EAAU;IAC3C,MAAM,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;IACjD,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AAChC,CAAC;AAUD,2EAA2E;AAC3E,MAAM,UAAU,cAAc,CAAC,IAAiE;IAC9F,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO;SACtB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,MAAM,QAAQ,CAAC,CAAC,IAAI,IAAI,CAAC;SAC7D,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,OAAO;;;;;;WAME,IAAI,CAAC,KAAK,kBAAkB,IAAI,CAAC,MAAM;;;;;;EAMhD,IAAI;;;;;;;;;;;;;;;;CAgBL,CAAC;AACF,CAAC;AAcD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAuB,EACvB,MAAc,EACd,OAAyB,EAAE;IAE3B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,UAAU,CAAC;IAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1E,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,CAAS,EAAE,CAAS,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3F,MAAM,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEzC,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAClE,MAAM,OAAO,GAAoB,EAAE,CAAC;IACpC,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAC7C,MAAM,UAAU,GAAG,GAAG,IAAI,MAAM,CAAC;QACjC,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;QACtE,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAC/D,MAAM,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,kBAAkB,CAAC,EAAE,CAAC,CAAC,CAAC;QAClE,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;IAC1H,CAAC;IACD,MAAM,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,cAAc,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAChH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AACtC,CAAC;AAED,SAAS,IAAI,CAAC,CAAS;IACrB,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACxD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAmB,EAAE,KAAe;IAClE,MAAM,OAAO,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAC7D,MAAM,WAAW,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IACtC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAClC,MAAM,KAAK,GAAG,QAAQ,MAAM,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;QAChE,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/F,IAAI,GAAG;YAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC;IACrC,CAAC,CAAC,CAAC;IACH,iFAAiF;IACjF,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC;YACxC,KAAK,CAAC,IAAI,GAAG,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAAe,EAAE,UAAkB;IACjE,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,GAAG,IAAI,YAAY,KAAK,CAAC,MAAM,gBAAgB,CAAC;IAC/D,OAAO;QACL,GAAG,MAAM;QACT,iBAAiB;QACjB,MAAM;QACN,MAAM;QACN,KAAK;QACL,MAAM;QACN,KAAK;QACL,MAAM;QACN,SAAS;QACT,MAAM;QACN,IAAI;QACJ,SAAS;QACT,MAAM;QACN,UAAU;QACV,SAAS;QACT,MAAM;QACN,KAAK;QACL,MAAM;QACN,MAAM;QACN,WAAW;QACX,YAAY;QACZ,UAAU;KACX,CAAC;AACJ,CAAC;AAWD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,IAAuB,EACvB,UAAkB,EAClB,UAAkB,EAClB,IAA0E;IAE1E,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,EAAE,CAAS,EAAE,EAAE,CAAC,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACnI,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAC1E,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,kDAAkD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,UAAU,EAAE,CAAC,CAAC;IAC3G,CAAC;IACD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACnD,MAAM,KAAK,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,KAAK,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACnD,MAAM,IAAI,CAAC,MAAM,CAAC,qBAAqB,CAAC,IAAc,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QAC7F,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IACD,MAAM,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACzE,MAAM,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;IACzD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC;AAC9D,CAAC"}

package/dist/video/motion-overlay/ingest.d.ts

@@ -0,0 +1,74 @@
+/**
+ * FFmpeg ingest for motion-overlay.
+ *
+ * Thin side-effecting helpers over ffmpeg/ffprobe that the plan/execute layers
+ * call to break an input video into the pieces the composer needs:
+ *  - `probeVideo`        — duration (s) + width/height + derived aspect label.
+ *  - `extractAudio`      — pull the audio track to a standalone file.
+ *  - `cutTake`           — frame-accurate `-ss/-to` cut, re-encoded CRF18.
+ *  - `extractFrames`     — sample reference frames for `readFrameObservations`.
+ *  - `readFrameObservations` — heuristic + notes stub from the sampled frames.
+ *
+ * Every ffmpeg/ffprobe call routes through an injectable `IngestDeps` so tests
+ * run fully offline (no ffmpeg required) by supplying fakes. The defaults wrap
+ * the proven `assemble/ffmpeg.ts` spawn primitives + a small ffprobe shell-out.
+ */
+import type { FrameObservations } from './types.js';
+export interface VideoProbe {
+    durationSeconds: number;
+    width: number;
+    height: number;
+    /** "16:9" | "9:16" | "1:1" | "<w>:<h>" reduced label. */
+    aspect: string;
+}
+/** Run an ffmpeg arg array. Mirrors `runFfmpeg`'s shape (returns a command). */
+export type RunFfmpegFn = (args: string[]) => Promise<{
+    command: string;
+}>;
+/** Probe a video → duration/width/height. */
+export type ProbeFn = (path: string) => Promise<{
+    durationSeconds: number;
+    width: number;
+    height: number;
+}>;
+export interface IngestDeps {
+    /** Real ffmpeg by default; injected fake in tests. */
+    runFfmpeg?: RunFfmpegFn;
+    /** Real ffprobe by default; injected fake in tests. */
+    probe?: ProbeFn;
+}
+/** Reduce a width:height pair to a tidy aspect label. */
+export declare function aspectLabel(width: number, height: number): string;
+/** Probe a video for duration + dimensions + aspect label. */
+export declare function probeVideo(path: string, deps?: IngestDeps): Promise<VideoProbe>;
+/** Extract the input's audio track to `outPath` (copy codec, no re-encode). */
+export declare function extractAudio(inputPath: string, outPath: string, deps?: IngestDeps): Promise<{
+    command: string;
+}>;
+/**
+ * Cut a take frame-accurately from `inputPath` between `start` and `end`
+ * (absolute seconds), re-encoding so the cut is exact (not keyframe-snapped).
+ * Matches the design spec: `-ss/-to -c:v libx264 -crf 18 -preset fast -c:a aac`.
+ */
+export declare function cutTake(inputPath: string, start: number, end: number, outPath: string, deps?: IngestDeps): Promise<{
+    command: string;
+}>;
+/**
+ * Sample `count` reference frames evenly across `[0, durationSeconds)` to
+ * `<outDir>/frame_%02d.jpg`. Returns the relative-ish filenames produced (the
+ * caller owns the dir). One ffmpeg call using the `fps` filter.
+ */
+export declare function extractFrames(inputPath: string, outDir: string, durationSeconds: number, count: number, deps?: IngestDeps): Promise<string[]>;
+/**
+ * Derive `FrameObservations` from the sampled frames + the probe aspect.
+ *
+ * v1 is a deterministic heuristic stub: a portrait (9:16) talking-head is
+ * assumed centred; a landscape source is assumed to have the speaker on one
+ * side. It records a note about the untouchable region so the composer's GLOBAL
+ * RULES carry it through. Pure given its inputs — no image decoding (that is a
+ * later enhancement) — so it stays offline-testable.
+ */
+export declare function readFrameObservations(probe: {
+    aspect: string;
+}, frameFiles: string[]): FrameObservations;
+//# sourceMappingURL=ingest.d.ts.map

package/dist/video/motion-overlay/ingest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../../src/video/motion-overlay/ingest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,WAAW,UAAU;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,gFAAgF;AAChF,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAC3E,6CAA6C;AAC7C,MAAM,MAAM,OAAO,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAAE,eAAe,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAE5G,MAAM,WAAW,UAAU;IACzB,sDAAsD;IACtD,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,uDAAuD;IACvD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,yDAAyD;AACzD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAYjE;AAgED,8DAA8D;AAC9D,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,UAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAIzF;AAED,+EAA+E;AAC/E,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,UAAe,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAI1H;AAED;;;;GAIG;AACH,wBAAsB,OAAO,CAC3B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,UAAe,GACpB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAmB9B;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,UAAe,GACpB,OAAO,CAAC,MAAM,EAAE,CAAC,CAYnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,iBAAiB,CAYxG"}