videoclaw 3.0.0-alpha.1

package/dist/video/assemble/overlay.js

@@ -0,0 +1,141 @@
+/**
+ * Motion-graphics overlays for the assemble layer (the After-Effects-shaped gap):
+ * composite a graphic onto footage, burn an animated alert, or a lower-third title
+ * — all time-gated with fades. These are PURE FFmpeg arg-builders (the tested
+ * surface; ffmpeg is never spawned here), mirroring stitch.ts. They pair with
+ * gen-image: generate a "SYSTEM COMPROMISED" / dashboard graphic, then overlay it.
+ *
+ * Conventions: `-y` is auto-prepended by runFfmpeg, so it is NOT included here.
+ * Time gating uses `enable='between(t,start,end)'`; fades use the `fade` filter on
+ * the overlay's alpha, so the composite eases in/out rather than popping.
+ *
+ * VALIDATION STATUS: {@link buildOverlayArgs} (graphic composite) is real-render
+ * validated — pair it with gen-image to overlay a generated "SYSTEM COMPROMISED" /
+ * dashboard graphic with no font dependency (the recommended path). The two text
+ * builders ({@link buildAlertTextArgs}, {@link buildLowerThirdArgs}) use the
+ * `drawtext` filter, which requires an ffmpeg built with libfreetype; their arg
+ * shapes are unit-tested but NOT render-validated on every host. On a drawtext-less
+ * ffmpeg, render the text to a PNG (gen-image / a title-card) and composite it via
+ * buildOverlayArgs instead.
+ */
+export const OVERLAY_POSITION_IDS = [
+    'top-left', 'top-right', 'bottom-left', 'bottom-right',
+    'center', 'bottom-center', 'top-center', 'full',
+];
+/** overlay x/y expressions for a position, given a pixel `margin`. `full` is 0,0
+ * (the caller scales the graphic to the frame). Uses overlay-filter vars
+ * (main_w/main_h = base, overlay_w/overlay_h = the graphic). */
+function overlayXY(position, margin) {
+    const m = String(margin);
+    switch (position) {
+        case 'top-left': return { x: m, y: m };
+        case 'top-right': return { x: `main_w-overlay_w-${m}`, y: m };
+        case 'bottom-left': return { x: m, y: `main_h-overlay_h-${m}` };
+        case 'bottom-right': return { x: `main_w-overlay_w-${m}`, y: `main_h-overlay_h-${m}` };
+        case 'center': return { x: '(main_w-overlay_w)/2', y: '(main_h-overlay_h)/2' };
+        case 'bottom-center': return { x: '(main_w-overlay_w)/2', y: `main_h-overlay_h-${m}` };
+        case 'top-center': return { x: '(main_w-overlay_w)/2', y: m };
+        case 'full': return { x: '0', y: '0' };
+    }
+}
+/**
+ * Composite a graphic (PNG/MP4-with-alpha) onto a base video (PURE). Fades the
+ * overlay's alpha in/out and gates it to [startSec, endSec] when given. `full`
+ * scales the graphic to the frame; other positions overlay at native size.
+ */
+export function buildOverlayArgs(baseVideo, graphic, outputPath, opts = {}) {
+    const position = opts.position ?? 'bottom-center';
+    const margin = opts.margin ?? 48;
+    const { x, y } = overlayXY(position, margin);
+    const start = opts.startSec;
+    const end = opts.endSec;
+    const ovChain = ['format=rgba'];
+    if (typeof opts.opacity === 'number' && opts.opacity < 1) {
+        ovChain.push(`colorchannelmixer=aa=${opts.opacity}`);
+    }
+    if (opts.fadeInSec && opts.fadeInSec > 0) {
+        ovChain.push(`fade=t=in:st=${start ?? 0}:d=${opts.fadeInSec}:alpha=1`);
+    }
+    if (opts.fadeOutSec && opts.fadeOutSec > 0 && typeof end === 'number') {
+        ovChain.push(`fade=t=out:st=${Math.max(0, end - opts.fadeOutSec)}:d=${opts.fadeOutSec}:alpha=1`);
+    }
+    const enable = typeof start === 'number' && typeof end === 'number'
+        ? `:enable='between(t,${start},${end})'`
+        : '';
+    // For `full`, scale the graphic to the base frame with scale2ref (a runtime
+    // reference to the base video's real WxH) — NOT `scale=main_w:main_h`, whose
+    // main_w/main_h are overlay-filter-only vars that evaluate to 0 inside `scale`
+    // (→ scale=0:0, which ffmpeg rejects with "Output size 0x0 is not allowed").
+    // Other positions overlay the graphic at its native size.
+    const filter = position === 'full'
+        ? `[1:v]${ovChain.join(',')}[ovpre];` +
+            `[ovpre][0:v]scale2ref=w=main_w:h=main_h[ov][base];` +
+            `[base][ov]overlay=0:0${enable}[v]`
+        : `[1:v]${ovChain.join(',')}[ov];` +
+            `[0:v][ov]overlay=${x}:${y}${enable}[v]`;
+    return [
+        '-i', baseVideo,
+        '-i', graphic,
+        '-filter_complex', filter,
+        '-map', '[v]', '-map', '0:a?',
+        '-c:v', 'libx264', '-preset', 'fast', '-crf', String(opts.crf ?? 18),
+        '-c:a', 'copy', '-movflags', '+faststart',
+        outputPath,
+    ];
+}
+/**
+ * Burn an animated alert (e.g. "SYSTEM COMPROMISED") onto a base video WITHOUT a
+ * pre-rendered graphic (PURE). The text alpha pulses via a sine expression and an
+ * optional border box flashes in sync, gated to [startSec, endSec]. This is the
+ * templated motion-graphic the reference advert uses for its breach moment.
+ */
+export function buildAlertTextArgs(baseVideo, text, outputPath, opts = {}) {
+    const start = opts.startSec ?? 0;
+    const end = opts.endSec;
+    const hz = opts.pulseHz ?? 2;
+    const color = opts.color ?? 'red';
+    const fontSize = opts.fontSize ?? 72;
+    const gate = typeof end === 'number' ? `between(t,${start},${end})` : `gte(t,${start})`;
+    // Pulsing alpha: 0 outside the window, 0.55..1.0 sine inside.
+    const alpha = `if(${gate}\\,0.55+0.45*sin(2*PI*${hz}*t)\\,0)`;
+    const safeText = text.replace(/:/g, '\\:').replace(/'/g, "\\'");
+    const filters = [];
+    if (opts.border !== false) {
+        // A thick frame border that shares the pulsing alpha.
+        filters.push(`drawbox=x=24:y=24:w=iw-48:h=ih-48:color=${color}:t=8:enable='${gate}'`);
+    }
+    filters.push(`drawtext=text='${safeText}':fontcolor=${color}:fontsize=${fontSize}:` +
+        `x=(w-text_w)/2:y=(h-text_h)/2:alpha='${alpha}'`);
+    return [
+        '-i', baseVideo,
+        '-vf', filters.join(','),
+        '-c:v', 'libx264', '-preset', 'fast', '-crf', String(opts.crf ?? 18),
+        '-c:a', 'copy', '-movflags', '+faststart',
+        outputPath,
+    ];
+}
+/**
+ * Burn a lower-third title (text on a translucent box, bottom-left) onto a base
+ * video (PURE), gated to [startSec, endSec] with optional fades. The standard
+ * name/role caption the reference uses to introduce characters.
+ */
+export function buildLowerThirdArgs(baseVideo, text, outputPath, opts = {}) {
+    const start = opts.startSec;
+    const end = opts.endSec;
+    const margin = opts.margin ?? 64;
+    const fontSize = opts.fontSize ?? 40;
+    const safeText = text.replace(/:/g, '\\:').replace(/'/g, "\\'");
+    const enable = typeof start === 'number' && typeof end === 'number'
+        ? `:enable='between(t,${start},${end})'`
+        : '';
+    const drawtext = `drawtext=text='${safeText}':fontcolor=${opts.color ?? 'white'}:fontsize=${fontSize}:` +
+        `x=${margin}:y=h-${margin}-text_h:box=1:boxcolor=${opts.boxColor ?? 'black@0.55'}:boxborderw=18${enable}`;
+    return [
+        '-i', baseVideo,
+        '-vf', drawtext,
+        '-c:v', 'libx264', '-preset', 'fast', '-crf', String(opts.crf ?? 18),
+        '-c:a', 'copy', '-movflags', '+faststart',
+        outputPath,
+    ];
+}
+//# sourceMappingURL=overlay.js.map

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

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

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

@@ -0,0 +1,46 @@
+export type SlideImageFormat = 'png' | 'jpg';
+export interface ExtractPdfSlidesInput {
+    /** Absolute or cwd-relative path to the source PDF. */
+    pdfPath: string;
+    /** Directory to write the rendered slide images into. */
+    outputDir: string;
+    /** Image encoding (default: 'png'). */
+    format?: SlideImageFormat;
+    /**
+     * Render scale relative to the PDF's native point size (default: 2.0).
+     *
+     * pdfjs renders at 72 DPI when scale=1. The Python default of 200 DPI maps
+     * to scale ≈ 2.78; we default to 2.0 (≈144 DPI) for a sensible balance of
+     * fidelity vs. file size, overridable per call.
+     */
+    scale?: number;
+    /** Skip rendering + file writes; return page metadata only. */
+    dryRun?: boolean;
+}
+export interface ExtractedPdfPage {
+    /** 1-based page index (mirrors the Python `slide_NNN` naming). */
+    index: number;
+    /** Path to the rendered image (empty string on dry-run). */
+    path: string;
+    /** Rendered pixel width (= native width × scale). */
+    width: number;
+    /** Rendered pixel height (= native height × scale). */
+    height: number;
+}
+export interface ExtractPdfSlidesResult {
+    pages: ExtractedPdfPage[];
+}
+/** `slide_001.png` — zero-padded to 3 digits to match the Python pipeline. */
+export declare function slideImageFilename(index: number, format: SlideImageFormat): string;
+/**
+ * Render each page of a PDF to an image. Returns per-page metadata.
+ *
+ * On `dryRun`, the PDF is still opened (so page count + dimensions are real),
+ * but no canvas is rendered and no file is written; each page's `path` is the
+ * empty string.
+ *
+ * Throws `VclawError('pdf_parse_failed', ...)` if the document cannot be
+ * parsed or a page cannot be rendered.
+ */
+export declare function extractPdfSlides(input: ExtractPdfSlidesInput): Promise<ExtractPdfSlidesResult>;
+//# sourceMappingURL=pdf.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pdf.d.ts","sourceRoot":"","sources":["../../../src/video/assemble/pdf.ts"],"names":[],"mappings":"AA2BA,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,KAAK,CAAC;AAE7C,MAAM,WAAW,qBAAqB;IACpC,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,gBAAgB,EAAE,CAAC;CAC3B;AAID,8EAA8E;AAC9E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAElF;AAED;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,sBAAsB,CAAC,CAsFjC"}

package/dist/video/assemble/pdf.js

@@ -0,0 +1,111 @@
+/**
+ * PDF slide extraction for the assemble stage (sub-slice 3c).
+ *
+ * Source of truth: `skills/video-replicator/scripts/extract_pdf_slides.py`.
+ *
+ * The Python pipeline shells out to `pdf2image`/`pdftoppm` to rasterize each
+ * PDF page to a JPEG at a target DPI. We do the equivalent in-process with
+ * `pdfjs-dist`: open the PDF, render each page to a canvas, and encode the
+ * canvas to PNG/JPG. No external binaries; no network.
+ *
+ * pdfjs-dist must be imported from its `legacy` build in Node.js — the default
+ * (browser) build emits the "Please use the `legacy` build in Node.js
+ * environments" warning and assumes browser globals. The legacy build is the
+ * supported Node entry point.
+ *
+ * Rendering needs a canvas backend. `@napi-rs/canvas` is the canvas the
+ * pdfjs-dist Node build itself relies on (it ships as pdfjs-dist's canvas
+ * dependency), so no additional native dependency is introduced here; we just
+ * declare it directly since we import it directly.
+ */
+// eslint-disable-next-line import/no-unresolved -- legacy entry resolved at runtime
+import * as pdfjs from 'pdfjs-dist/legacy/build/pdf.mjs';
+import { createCanvas } from '@napi-rs/canvas';
+import { writeFile, mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { VclawError } from '../errors.js';
+const DEFAULT_SCALE = 2.0;
+/** `slide_001.png` — zero-padded to 3 digits to match the Python pipeline. */
+export function slideImageFilename(index, format) {
+    return `slide_${String(index).padStart(3, '0')}.${format}`;
+}
+/**
+ * Render each page of a PDF to an image. Returns per-page metadata.
+ *
+ * On `dryRun`, the PDF is still opened (so page count + dimensions are real),
+ * but no canvas is rendered and no file is written; each page's `path` is the
+ * empty string.
+ *
+ * Throws `VclawError('pdf_parse_failed', ...)` if the document cannot be
+ * parsed or a page cannot be rendered.
+ */
+export async function extractPdfSlides(input) {
+    const format = input.format ?? 'png';
+    const scale = input.scale && input.scale > 0 ? input.scale : DEFAULT_SCALE;
+    let data;
+    try {
+        const { readFile } = await import('node:fs/promises');
+        data = await readFile(input.pdfPath);
+    }
+    catch (err) {
+        throw new VclawError('pdf_parse_failed', `Could not read PDF at "${input.pdfPath}": ${err.message}`, { pdfPath: input.pdfPath });
+    }
+    let doc;
+    try {
+        // `isEvalSupported: false` keeps us off `eval` in Node; `useSystemFonts`
+        // lets the legacy build fall back to system fonts rather than failing.
+        doc = await pdfjs.getDocument({
+            data: new Uint8Array(data),
+            isEvalSupported: false,
+            useSystemFonts: true,
+        }).promise;
+    }
+    catch (err) {
+        throw new VclawError('pdf_parse_failed', `Failed to parse PDF "${input.pdfPath}": ${err.message}`, { pdfPath: input.pdfPath });
+    }
+    const pageCount = doc.numPages;
+    const pages = [];
+    try {
+        if (!input.dryRun) {
+            await mkdir(input.outputDir, { recursive: true });
+        }
+        for (let index = 1; index <= pageCount; index += 1) {
+            const page = await doc.getPage(index);
+            const viewport = page.getViewport({ scale });
+            const width = Math.ceil(viewport.width);
+            const height = Math.ceil(viewport.height);
+            if (input.dryRun) {
+                pages.push({ index, path: '', width, height });
+                page.cleanup();
+                continue;
+            }
+            const canvas = createCanvas(width, height);
+            const ctx = canvas.getContext('2d');
+            // The @napi-rs/canvas 2D context satisfies pdfjs's render contract;
+            // pdfjs ships @napi-rs/canvas as its own Node canvas backend. pdfjs types
+            // the field as the browser `CanvasRenderingContext2D`, which isn't in the
+            // Node lib set, so we widen the render params to `unknown` first.
+            const renderParams = {
+                canvasContext: ctx,
+                viewport,
+            };
+            await page.render(renderParams).promise;
+            const filename = slideImageFilename(index, format);
+            const path = join(input.outputDir, filename);
+            const buffer = format === 'jpg' ? await canvas.encode('jpeg', 95) : await canvas.encode('png');
+            await writeFile(path, buffer);
+            pages.push({ index, path, width, height });
+            page.cleanup();
+        }
+    }
+    catch (err) {
+        if (err instanceof VclawError)
+            throw err;
+        throw new VclawError('pdf_parse_failed', `Failed to render PDF "${input.pdfPath}": ${err.message}`, { pdfPath: input.pdfPath });
+    }
+    finally {
+        await doc.destroy().catch(() => undefined);
+    }
+    return { pages };
+}
+//# sourceMappingURL=pdf.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pdf.js","sourceRoot":"","sources":["../../../src/video/assemble/pdf.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,oFAAoF;AACpF,OAAO,KAAK,KAAK,MAAM,iCAAiC,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAsC1C,MAAM,aAAa,GAAG,GAAG,CAAC;AAE1B,8EAA8E;AAC9E,MAAM,UAAU,kBAAkB,CAAC,KAAa,EAAE,MAAwB;IACxE,OAAO,SAAS,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,EAAE,CAAC;AAC7D,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,KAA4B;IAE5B,MAAM,MAAM,GAAqB,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC;IACvD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC;IAE3E,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;QACtD,IAAI,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,UAAU,CAClB,kBAAkB,EAClB,0BAA0B,KAAK,CAAC,OAAO,MAAO,GAAa,CAAC,OAAO,EAAE,EACrE,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAC3B,CAAC;IACJ,CAAC;IAED,IAAI,GAA6D,CAAC;IAClE,IAAI,CAAC;QACH,yEAAyE;QACzE,uEAAuE;QACvE,GAAG,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC;YAC5B,IAAI,EAAE,IAAI,UAAU,CAAC,IAAI,CAAC;YAC1B,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;SACrB,CAAC,CAAC,OAAO,CAAC;IACb,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,UAAU,CAClB,kBAAkB,EAClB,wBAAwB,KAAK,CAAC,OAAO,MAAO,GAAa,CAAC,OAAO,EAAE,EACnE,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAC3B,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,GAAG,CAAC,QAAQ,CAAC;IAC/B,MAAM,KAAK,GAAuB,EAAE,CAAC;IAErC,IAAI,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAClB,MAAM,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,CAAC;QAED,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,IAAI,SAAS,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YACnD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;YAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YACxC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAE1C,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBACjB,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;gBAC/C,IAAI,CAAC,OAAO,EAAE,CAAC;gBACf,SAAS;YACX,CAAC;YAED,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YAC3C,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YACpC,oEAAoE;YACpE,0EAA0E;YAC1E,0EAA0E;YAC1E,kEAAkE;YAClE,MAAM,YAAY,GAAG;gBACnB,aAAa,EAAE,GAAG;gBAClB,QAAQ;aACuC,CAAC;YAClD,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC;YAExC,MAAM,QAAQ,GAAG,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YACnD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YAC7C,MAAM,MAAM,GACV,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAClF,MAAM,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAE9B,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;YAC3C,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,UAAU;YAAE,MAAM,GAAG,CAAC;QACzC,MAAM,IAAI,UAAU,CAClB,kBAAkB,EAClB,yBAAyB,KAAK,CAAC,OAAO,MAAO,GAAa,CAAC,OAAO,EAAE,EACpE,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAC3B,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,CAAC;AACnB,CAAC"}

package/dist/video/assemble/qa-dialogue-lint.d.ts

@@ -0,0 +1,56 @@
+/** Standard lip-sync word ceiling (scenes 17, 19, 20). */
+export declare const STANDARD_MAX_WORDS = 28;
+/** Comfortable middle for standard lip-sync. */
+export declare const STANDARD_RECOMMENDED_WORDS = 26;
+/** The dramatic sign-off scene index (1-based, matches Python "21"). */
+export declare const SIGNOFF_SCENE_INDEX = 21;
+/** Sign-off word ceiling (scene 21). */
+export declare const SIGNOFF_MAX_WORDS = 20;
+/** Comfortable middle for the sign-off. */
+export declare const SIGNOFF_RECOMMENDED_WORDS = 18;
+export interface DialogueSegment {
+    /** Scene index this dialogue line belongs to. */
+    sceneIndex: number;
+    /** The spoken text for this scene. */
+    text: string;
+}
+export interface LintDialogueInput {
+    segments: DialogueSegment[];
+    /** Override the standard (non-sign-off) max word count. Default STANDARD_MAX_WORDS. */
+    standardMaxWords?: number;
+    /** Override the standard recommended word count. Default STANDARD_RECOMMENDED_WORDS. */
+    standardRecommendedWords?: number;
+    /** Scene index treated as the tighter sign-off. Default SIGNOFF_SCENE_INDEX. */
+    signoffSceneIndex?: number;
+    /** Override the sign-off max word count. Default SIGNOFF_MAX_WORDS. */
+    signoffMaxWords?: number;
+    /** Override the sign-off recommended word count. Default SIGNOFF_RECOMMENDED_WORDS. */
+    signoffRecommendedWords?: number;
+}
+export interface DialogueWarning {
+    sceneIndex: number;
+    /** Stable rule id: 'over-limit' (will be cut off) or 'near-limit' (edge). */
+    rule: 'over-limit' | 'near-limit';
+    message: string;
+    /** Computed word count for the segment. */
+    wordCount: number;
+}
+export interface LintDialogueResult {
+    warnings: DialogueWarning[];
+    /** True when no over-limit or near-limit warnings were produced. */
+    ok: boolean;
+}
+/**
+ * Count tokens that look like words (have at least one letter or digit). This
+ * excludes standalone punctuation like em dashes which split on whitespace into
+ * their own token but aren't spoken. Hyphenated words count as one.
+ *
+ * Mirrors the Python `count_words` helper.
+ */
+export declare function countWords(text: string): number;
+/**
+ * Lint dialogue segments against the Veo lip-sync word ceilings. Advisory:
+ * returns warnings, never throws for content. Throws only on invalid input.
+ */
+export declare function lintDialogue(input: LintDialogueInput): LintDialogueResult;
+//# sourceMappingURL=qa-dialogue-lint.d.ts.map

package/dist/video/assemble/qa-dialogue-lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qa-dialogue-lint.d.ts","sourceRoot":"","sources":["../../../src/video/assemble/qa-dialogue-lint.ts"],"names":[],"mappings":"AAqBA,0DAA0D;AAC1D,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,gDAAgD;AAChD,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAC7C,wEAAwE;AACxE,eAAO,MAAM,mBAAmB,KAAK,CAAC;AACtC,wCAAwC;AACxC,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,2CAA2C;AAC3C,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAE5C,MAAM,WAAW,eAAe;IAC9B,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,uFAAuF;IACvF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wFAAwF;IACxF,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,gFAAgF;IAChF,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uEAAuE;IACvE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uFAAuF;IACvF,uBAAuB,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,IAAI,EAAE,YAAY,GAAG,YAAY,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,oEAAoE;IACpE,EAAE,EAAE,OAAO,CAAC;CACb;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK/C;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,kBAAkB,CA0CzE"}

package/dist/video/assemble/qa-dialogue-lint.js

@@ -0,0 +1,85 @@
+/**
+ * Dialogue / lip-sync word-count linter (pure, no I/O).
+ *
+ * Ported from `skills/video-replicator/scripts/bunty_dialogue_lint.py`.
+ *
+ * Veo I2V lip-sync clips have a FIXED 8-second duration. Above ~28 words the
+ * speech gets cut off mid-sentence (confirmed 2026-05-11). The sign-off scene
+ * (scene 21) is tighter — 15-20 words for dramatic pacing.
+ *
+ * Limits (from bunty-voice-guide.md, codified 2026-05-11):
+ *   Standard lip-sync (scenes 17, 19, 20): 24-28 words MAX (recommended <=26)
+ *   Sign-off (scene 21):                   15-20 words MAX (recommended <=18)
+ *
+ * This is ADVISORY: it returns warnings rather than throwing. It only throws a
+ * VclawError for genuinely invalid input (non-array segments). The Python
+ * file/glob/CLI wiring and ANSI emit are intentionally NOT ported (3i owns CLI).
+ *
+ * Pure module: no CLI wiring (3i).
+ */
+import { VclawError } from '../errors.js';
+/** Standard lip-sync word ceiling (scenes 17, 19, 20). */
+export const STANDARD_MAX_WORDS = 28;
+/** Comfortable middle for standard lip-sync. */
+export const STANDARD_RECOMMENDED_WORDS = 26;
+/** The dramatic sign-off scene index (1-based, matches Python "21"). */
+export const SIGNOFF_SCENE_INDEX = 21;
+/** Sign-off word ceiling (scene 21). */
+export const SIGNOFF_MAX_WORDS = 20;
+/** Comfortable middle for the sign-off. */
+export const SIGNOFF_RECOMMENDED_WORDS = 18;
+/**
+ * Count tokens that look like words (have at least one letter or digit). This
+ * excludes standalone punctuation like em dashes which split on whitespace into
+ * their own token but aren't spoken. Hyphenated words count as one.
+ *
+ * Mirrors the Python `count_words` helper.
+ */
+export function countWords(text) {
+    return text
+        .trim()
+        .split(/\s+/)
+        .filter((w) => /[\p{L}\p{N}]/u.test(w)).length;
+}
+/**
+ * Lint dialogue segments against the Veo lip-sync word ceilings. Advisory:
+ * returns warnings, never throws for content. Throws only on invalid input.
+ */
+export function lintDialogue(input) {
+    if (!input || !Array.isArray(input.segments)) {
+        throw new VclawError('unexpected_internal_error', 'lintDialogue: input.segments must be an array');
+    }
+    const standardMax = input.standardMaxWords ?? STANDARD_MAX_WORDS;
+    const standardRec = input.standardRecommendedWords ?? STANDARD_RECOMMENDED_WORDS;
+    const signoffScene = input.signoffSceneIndex ?? SIGNOFF_SCENE_INDEX;
+    const signoffMax = input.signoffMaxWords ?? SIGNOFF_MAX_WORDS;
+    const signoffRec = input.signoffRecommendedWords ?? SIGNOFF_RECOMMENDED_WORDS;
+    const warnings = [];
+    for (const seg of input.segments) {
+        if (typeof seg?.text !== 'string')
+            continue;
+        const n = countWords(seg.text);
+        const isSignoff = seg.sceneIndex === signoffScene;
+        const maxWords = isSignoff ? signoffMax : standardMax;
+        const recommended = isSignoff ? signoffRec : standardRec;
+        const label = isSignoff ? 'sign-off' : 'lip-sync';
+        if (n > maxWords) {
+            warnings.push({
+                sceneIndex: seg.sceneIndex,
+                rule: 'over-limit',
+                wordCount: n,
+                message: `Scene ${seg.sceneIndex} (${label}): ${n} words — OVER LIMIT (${maxWords}). Veo will cut off speech mid-sentence. Trim to <=${recommended}.`,
+            });
+        }
+        else if (n > recommended) {
+            warnings.push({
+                sceneIndex: seg.sceneIndex,
+                rule: 'near-limit',
+                wordCount: n,
+                message: `Scene ${seg.sceneIndex} (${label}): ${n} words — at the edge (${maxWords} max). Consider trimming to <=${recommended} for safety.`,
+            });
+        }
+    }
+    return { warnings, ok: warnings.length === 0 };
+}
+//# sourceMappingURL=qa-dialogue-lint.js.map

package/dist/video/assemble/qa-dialogue-lint.js.map

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

package/dist/video/assemble/qa-image-filter.d.ts

@@ -0,0 +1,52 @@
+export type FilterVerdict = 'safe' | 'risky' | 'likely-blocked';
+/** Severity ordering, mirrors Python VERDICT_ORDER. */
+export declare const VERDICT_ORDER: Record<FilterVerdict, number>;
+/**
+ * Keyword categories matching the Python prompt's flagged-element list. Each
+ * category contributes to the risk score. Two distinct categories present, or a
+ * high-weight category, escalate the verdict to likely-blocked.
+ */
+export declare const RISK_CATEGORIES: Record<string, {
+    weight: number;
+    keywords: string[];
+}>;
+export interface ImageFilterCandidate {
+    sceneIndex: number;
+    /**
+     * The text used to generate / describe the slide image (prompt or caption).
+     * The local heuristic scans this for known-risky keyword categories.
+     */
+    prompt: string;
+}
+export interface CheckImageFilterInput {
+    candidates: ImageFilterCandidate[];
+    /**
+     * Flag any candidate at or above this verdict. Default 'risky'. (The Python
+     * default is 'likely-blocked', but for a text-only heuristic 'risky' is the
+     * safer advisory default; callers can raise it.)
+     */
+    threshold?: FilterVerdict;
+}
+export interface ImageFilterWarning {
+    sceneIndex: number;
+    rule: 'content-filter-risk';
+    verdict: FilterVerdict;
+    /** Risk categories that matched, e.g. ['weapon', 'supernatural']. */
+    categories: string[];
+    message: string;
+}
+export interface CheckImageFilterResult {
+    warnings: ImageFilterWarning[];
+    ok: boolean;
+}
+/** Classify one prompt into a verdict + matched categories (pure, local). */
+export declare function classifyImagePrompt(prompt: string): {
+    verdict: FilterVerdict;
+    categories: string[];
+};
+/**
+ * Run the local image-filter heuristic over candidate slide prompts. Advisory:
+ * returns warnings, never throws for content. Throws only on invalid input.
+ */
+export declare function checkImageFilter(input: CheckImageFilterInput): CheckImageFilterResult;
+//# sourceMappingURL=qa-image-filter.d.ts.map

package/dist/video/assemble/qa-image-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qa-image-filter.d.ts","sourceRoot":"","sources":["../../../src/video/assemble/qa-image-filter.ts"],"names":[],"mappings":"AA0BA,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,GAAG,gBAAgB,CAAC;AAEhE,uDAAuD;AACvD,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAIvD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAiBlF,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,oBAAoB,EAAE,CAAC;IACnC;;;;OAIG;IACH,SAAS,CAAC,EAAE,aAAa,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,qBAAqB,CAAC;IAC5B,OAAO,EAAE,aAAa,CAAC;IACvB,qEAAqE;IACrE,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,EAAE,EAAE,OAAO,CAAC;CACb;AAED,6EAA6E;AAC7E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG;IACnD,OAAO,EAAE,aAAa,CAAC;IACvB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,CAcA;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,sBAAsB,CA8BrF"}

package/dist/video/assemble/qa-image-filter.js

@@ -0,0 +1,102 @@
+/**
+ * Image content-filter risk heuristics — LOCAL checks only (pure, no I/O).
+ *
+ * Ported from `skills/video-replicator/scripts/bunty_image_filter_check.py`.
+ *
+ * The Python original predicts which deck slides will trip Veo's first-frame
+ * content filter (warriors with weapons, supernatural figures, dark
+ * industrial-noir, combat poses). It does this via a Gemini-Vision call that
+ * classifies each slide image as safe|risky|likely-blocked. That vision call
+ * needs an API key, looks at pixels, and requires a network round-trip, so it
+ * lives in the sibling `qa-image-vision.ts` (`checkImageVision`) — this module
+ * stays pure.
+ *
+ * What IS ported here: the local, text-based heuristic that scores a slide's
+ * *prompt / description* against the same known-risky keyword categories the
+ * Python prompt enumerates (weapons, combat poses, supernatural/demonic,
+ * industrial-noir). This lets the operator flag at-risk slides from their
+ * generation prompts BEFORE any image or F2V generation, cheaply and offline,
+ * and mirrors the Python verdict ladder (safe < risky < likely-blocked) that
+ * the vision sibling shares via {@link VERDICT_ORDER}.
+ *
+ * This is ADVISORY: it returns warnings rather than throwing. It only throws a
+ * VclawError for genuinely invalid input. Pure module: no CLI wiring (3i).
+ */
+import { VclawError } from '../errors.js';
+/** Severity ordering, mirrors Python VERDICT_ORDER. */
+export const VERDICT_ORDER = {
+    safe: 0,
+    risky: 1,
+    'likely-blocked': 2,
+};
+/**
+ * Keyword categories matching the Python prompt's flagged-element list. Each
+ * category contributes to the risk score. Two distinct categories present, or a
+ * high-weight category, escalate the verdict to likely-blocked.
+ */
+export const RISK_CATEGORIES = {
+    weapon: {
+        weight: 2,
+        keywords: ['sword', 'knife', 'gun', 'rifle', 'pistol', 'blade', 'energy weapon', 'firearm'],
+    },
+    combatPose: {
+        weight: 1,
+        keywords: ['fighting stance', 'battle pose', 'combat pose', 'warrior stance', 'fighting pose'],
+    },
+    supernatural: {
+        weight: 2,
+        keywords: ['glowing eyes', 'demonic', 'hooded figure', 'dark aura', 'glowing aura', 'energy ball', 'supernatural'],
+    },
+    industrialNoir: {
+        weight: 1,
+        keywords: ['rusted metal', 'destroyed environment', 'helmeted silhouette', 'industrial noir', 'dark silhouette'],
+    },
+};
+/** Classify one prompt into a verdict + matched categories (pure, local). */
+export function classifyImagePrompt(prompt) {
+    const hay = prompt.toLowerCase();
+    const matched = [];
+    let score = 0;
+    for (const [name, { weight, keywords }] of Object.entries(RISK_CATEGORIES)) {
+        if (keywords.some((kw) => hay.includes(kw))) {
+            matched.push(name);
+            score += weight;
+        }
+    }
+    let verdict = 'safe';
+    if (score >= 2 || matched.length >= 2)
+        verdict = 'likely-blocked';
+    else if (score >= 1)
+        verdict = 'risky';
+    return { verdict, categories: matched };
+}
+/**
+ * Run the local image-filter heuristic over candidate slide prompts. Advisory:
+ * returns warnings, never throws for content. Throws only on invalid input.
+ */
+export function checkImageFilter(input) {
+    if (!input || !Array.isArray(input.candidates)) {
+        throw new VclawError('unexpected_internal_error', 'checkImageFilter: input.candidates must be an array');
+    }
+    const threshold = input.threshold ?? 'risky';
+    const thresholdLevel = VERDICT_ORDER[threshold];
+    const warnings = [];
+    for (const candidate of input.candidates) {
+        if (typeof candidate?.prompt !== 'string')
+            continue;
+        const { verdict, categories } = classifyImagePrompt(candidate.prompt);
+        if (VERDICT_ORDER[verdict] >= thresholdLevel) {
+            warnings.push({
+                sceneIndex: candidate.sceneIndex,
+                rule: 'content-filter-risk',
+                verdict,
+                categories,
+                message: verdict === 'safe'
+                    ? `Scene ${candidate.sceneIndex}: clean cricket composition.`
+                    : `Scene ${candidate.sceneIndex}: ${verdict} — flagged ${categories.join(', ')}. Consider softening the composition before F2V to avoid Veo content-filter rejection.`,
+            });
+        }
+    }
+    return { warnings, ok: warnings.length === 0 };
+}
+//# sourceMappingURL=qa-image-filter.js.map

package/dist/video/assemble/qa-image-filter.js.map

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