venice-video-harness 2.4.0

package/dist/editing/aligner.js

@@ -0,0 +1,201 @@
+/**
+ * Ground-truth script alignment for Venice-generated content.
+ *
+ * When we already know the exact spoken text (from `ShotScript.vo` or a
+ * TTS script), we can produce more accurate word timings than pure ASR by
+ * mapping the script's canonical words onto whisper.cpp's detected word
+ * timings via longest-common-subsequence alignment.
+ *
+ * The output is still a `WordTiming[]`, but the `word` field is the
+ * script's canonical word (with correct capitalization / punctuation)
+ * rather than whisper's best guess. Unmatched script words are linearly
+ * interpolated between their neighbors.
+ *
+ * This matters in practice because TTS voices often produce subtle
+ * mispronunciations or swallowed words that whisper transcribes as
+ * homophones ("their" vs "there", "a" vs "uh"). For editing purposes
+ * we want the script's words — that's what the captions, shot manifest,
+ * and VO_TEXT array refer to.
+ */
+function normalize(word) {
+    return word
+        .toLowerCase()
+        .replace(/[^a-z0-9']/g, '')
+        .replace(/'/g, '');
+}
+function tokenizeScript(script) {
+    return script
+        .replace(/\.{2,}/g, ' ')
+        .split(/\s+/)
+        .map((w) => w.trim())
+        .filter((w) => w.length > 0);
+}
+/**
+ * Build an LCS-style alignment matrix between script words and ASR words
+ * on normalized forms. Returns parallel arrays of matched indices.
+ */
+function alignLcs(scriptWords, asrWords) {
+    const a = scriptWords.map(normalize);
+    const b = asrWords.map((w) => normalize(w.word));
+    const m = a.length;
+    const n = b.length;
+    // DP table of LCS lengths.
+    const dp = Array.from({ length: m + 1 }, () => new Array(n + 1).fill(0));
+    for (let i = 1; i <= m; i++) {
+        for (let j = 1; j <= n; j++) {
+            if (a[i - 1] && b[j - 1] && a[i - 1] === b[j - 1]) {
+                dp[i][j] = dp[i - 1][j - 1] + 1;
+            }
+            else {
+                dp[i][j] = Math.max(dp[i - 1][j], dp[i][j - 1]);
+            }
+        }
+    }
+    const out = [];
+    let i = m;
+    let j = n;
+    while (i > 0 && j > 0) {
+        if (a[i - 1] === b[j - 1] && a[i - 1]) {
+            out.push({ scriptIdx: i - 1, asrIdx: j - 1 });
+            i--;
+            j--;
+        }
+        else if (dp[i - 1][j] >= dp[i][j - 1]) {
+            i--;
+        }
+        else {
+            j--;
+        }
+    }
+    return out.reverse();
+}
+/**
+ * Align a ground-truth script against whisper word timings.
+ */
+export function alignScriptToWords(script, asrWords, options = {}) {
+    const onMissing = options.onMissing ?? 'interpolate';
+    const scriptWords = tokenizeScript(script);
+    if (scriptWords.length === 0 || asrWords.length === 0)
+        return [];
+    const matches = alignLcs(scriptWords, asrWords);
+    // Produce timings per script word.
+    const timings = new Array(scriptWords.length).fill(null);
+    // Copy timings from matched ASR words (script wording wins).
+    for (const { scriptIdx, asrIdx } of matches) {
+        const asr = asrWords[asrIdx];
+        timings[scriptIdx] = {
+            word: scriptWords[scriptIdx],
+            startSec: asr.startSec,
+            endSec: asr.endSec,
+            confidence: asr.confidence,
+        };
+    }
+    if (onMissing === 'drop') {
+        return timings.filter((t) => t !== null);
+    }
+    // Interpolate missing timings based on surrounding anchors.
+    const firstMatched = timings.findIndex((t) => t !== null);
+    const lastMatched = (() => {
+        for (let k = timings.length - 1; k >= 0; k--)
+            if (timings[k])
+                return k;
+        return -1;
+    })();
+    if (firstMatched === -1) {
+        // Nothing matched — fall back to linear distribution across ASR span.
+        const firstAsr = asrWords[0];
+        const lastAsr = asrWords[asrWords.length - 1];
+        const span = Math.max(0.001, lastAsr.endSec - firstAsr.startSec);
+        const per = span / scriptWords.length;
+        return scriptWords.map((w, k) => ({
+            word: w,
+            startSec: firstAsr.startSec + k * per,
+            endSec: firstAsr.startSec + (k + 1) * per,
+        }));
+    }
+    // Extrapolate before the first matched word.
+    if (firstMatched > 0 && timings[firstMatched]) {
+        const anchor = timings[firstMatched];
+        const pre = firstMatched;
+        // Assume ~0.28s per pre-word if no earlier ASR — conservative.
+        const avg = 0.28;
+        for (let k = 0; k < firstMatched; k++) {
+            const offset = (firstMatched - k) * avg;
+            timings[k] = {
+                word: scriptWords[k],
+                startSec: Math.max(0, anchor.startSec - offset),
+                endSec: Math.max(0, anchor.startSec - offset + avg * 0.8),
+            };
+        }
+    }
+    // Extrapolate after the last matched word.
+    if (lastMatched !== -1 && lastMatched < scriptWords.length - 1 && timings[lastMatched]) {
+        const anchor = timings[lastMatched];
+        const avg = 0.28;
+        for (let k = lastMatched + 1; k < scriptWords.length; k++) {
+            const offset = (k - lastMatched) * avg;
+            timings[k] = {
+                word: scriptWords[k],
+                startSec: anchor.endSec + offset - avg,
+                endSec: anchor.endSec + offset,
+            };
+        }
+    }
+    // Interpolate gaps between matched words.
+    for (let k = 0; k < timings.length; k++) {
+        if (timings[k])
+            continue;
+        // Find anchor before and after.
+        let before = k - 1;
+        while (before >= 0 && !timings[before])
+            before--;
+        let after = k + 1;
+        while (after < timings.length && !timings[after])
+            after++;
+        if (before < 0 || after >= timings.length)
+            continue;
+        const b = timings[before];
+        const a = timings[after];
+        const span = Math.max(0.001, a.startSec - b.endSec);
+        const slots = after - before;
+        const localIdx = k - before;
+        const per = span / slots;
+        timings[k] = {
+            word: scriptWords[k],
+            startSec: b.endSec + (localIdx - 1) * per,
+            endSec: b.endSec + localIdx * per,
+        };
+    }
+    return timings.filter((t) => t !== null);
+}
+/**
+ * Detect VO truncation: returns the portion of the script (if any) that
+ * could not be aligned to ASR words because the audio ended before it.
+ * Useful as a VO-truncation check (AGENTS.md anti-pattern, rule 26).
+ */
+export function detectTruncation(script, asrWords) {
+    const scriptWords = tokenizeScript(script);
+    if (scriptWords.length === 0) {
+        return { truncated: false, lostWords: [], lastAlignedSec: 0 };
+    }
+    if (asrWords.length === 0) {
+        return { truncated: true, lostWords: scriptWords, lastAlignedSec: 0 };
+    }
+    const matches = alignLcs(scriptWords, asrWords);
+    if (matches.length === 0) {
+        return { truncated: true, lostWords: scriptWords, lastAlignedSec: 0 };
+    }
+    const lastMatch = matches[matches.length - 1];
+    const lost = scriptWords.slice(lastMatch.scriptIdx + 1);
+    // Treat as truncated only if more than 5% of script words are lost and
+    // the lost tail is more than 2 words (avoid false positives on single
+    // trailing filler).
+    const lossRatio = lost.length / scriptWords.length;
+    const truncated = lost.length > 2 && lossRatio > 0.05;
+    return {
+        truncated,
+        lostWords: lost,
+        lastAlignedSec: asrWords[lastMatch.asrIdx].endSec,
+    };
+}
+//# sourceMappingURL=aligner.js.map

package/dist/editing/aligner.js.map

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

package/dist/editing/edl.d.ts

@@ -0,0 +1,45 @@
+/**
+ * EDL (Edit Decision List) authoring and validation.
+ *
+ * The EDL is a JSON document the LLM reads and mutates. This module
+ * provides helpers that keep invariants tight: no negative durations,
+ * every `sourceId` resolves, transition ms within ffmpeg's sensible
+ * range, output settings present.
+ */
+import type { Edl, EdlClip, EdlTransition, Take } from './types.js';
+export declare const DEFAULT_EDL_OUTPUT: Edl['output'];
+export declare const DEFAULT_AUDIO_FADE_MS = 30;
+export declare const DEFAULT_TRANSITION_MS = 250;
+export interface CreateEdlOptions {
+    audioFadeMs?: number;
+    output?: Partial<Edl['output']>;
+}
+export declare function createEmptyEdl(options?: CreateEdlOptions): Edl;
+export interface EdlValidationError {
+    clipIndex: number;
+    message: string;
+}
+export declare function validateEdl(edl: Edl, takes: Take[]): EdlValidationError[];
+/** Effective clip duration in seconds after applying trimStart/trimEnd. */
+export declare function effectiveDurationSec(clip: EdlClip): number;
+/** Sum of clip durations minus crossfade overlaps. */
+export declare function estimateOutputDurationSec(edl: Edl): number;
+export interface AddClipInput {
+    sourceId: string;
+    startSec: number;
+    endSec: number;
+    trimStartMs?: number;
+    trimEndMs?: number;
+    transitionIn?: EdlTransition;
+    transitionMs?: number;
+    rationale?: string;
+}
+export declare function addClip(edl: Edl, input: AddClipInput): void;
+/**
+ * Insert a crossfade at a cut boundary (between clip `i - 1` and `i`).
+ * Used by the cut-qa agent's `insert-crossfade` fix.
+ */
+export declare function insertCrossfade(edl: Edl, clipIndex: number, transitionMs?: number): void;
+export declare function readEdl(path: string): Edl;
+export declare function writeEdl(edl: Edl, path: string): void;
+//# sourceMappingURL=edl.d.ts.map

package/dist/editing/edl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edl.d.ts","sourceRoot":"","sources":["../../src/editing/edl.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEpE,eAAO,MAAM,kBAAkB,EAAE,GAAG,CAAC,QAAQ,CAI5C,CAAC;AAEF,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAEzC,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;CACjC;AAED,wBAAgB,cAAc,CAAC,OAAO,GAAE,gBAAqB,GAAG,GAAG,CAMlE;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,kBAAkB,EAAE,CA8CzE;AAED,2EAA2E;AAC3E,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAI1D;AAED,sDAAsD;AACtD,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAS1D;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,aAAa,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAe3D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,GAAG,EACR,SAAS,EAAE,MAAM,EACjB,YAAY,GAAE,MAAY,GACzB,IAAI,CAON;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAgBzC;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAGrD"}

package/dist/editing/edl.js

@@ -0,0 +1,133 @@
+/**
+ * EDL (Edit Decision List) authoring and validation.
+ *
+ * The EDL is a JSON document the LLM reads and mutates. This module
+ * provides helpers that keep invariants tight: no negative durations,
+ * every `sourceId` resolves, transition ms within ffmpeg's sensible
+ * range, output settings present.
+ */
+import { readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+export const DEFAULT_EDL_OUTPUT = {
+    videoCodec: 'libx264',
+    audioCodec: 'aac',
+    crf: 18,
+};
+export const DEFAULT_AUDIO_FADE_MS = 30;
+export const DEFAULT_TRANSITION_MS = 250;
+export function createEmptyEdl(options = {}) {
+    return {
+        clips: [],
+        audioFadeMs: options.audioFadeMs ?? DEFAULT_AUDIO_FADE_MS,
+        output: { ...DEFAULT_EDL_OUTPUT, ...(options.output ?? {}) },
+    };
+}
+export function validateEdl(edl, takes) {
+    const errors = [];
+    const takeById = new Map(takes.map((t) => [t.id, t]));
+    if (edl.clips.length === 0) {
+        errors.push({ clipIndex: -1, message: 'EDL has no clips' });
+        return errors;
+    }
+    if (edl.audioFadeMs < 0 || edl.audioFadeMs > 500) {
+        errors.push({ clipIndex: -1, message: `audioFadeMs out of sensible range: ${edl.audioFadeMs}` });
+    }
+    edl.clips.forEach((clip, i) => {
+        const take = takeById.get(clip.sourceId);
+        if (!take) {
+            errors.push({ clipIndex: i, message: `Unknown sourceId: ${clip.sourceId}` });
+            return;
+        }
+        if (!(clip.endSec > clip.startSec)) {
+            errors.push({
+                clipIndex: i,
+                message: `endSec (${clip.endSec}) must be greater than startSec (${clip.startSec})`,
+            });
+        }
+        if (clip.startSec < 0) {
+            errors.push({ clipIndex: i, message: `startSec cannot be negative: ${clip.startSec}` });
+        }
+        if (clip.endSec > take.durationSec + 0.05) {
+            errors.push({
+                clipIndex: i,
+                message: `endSec (${clip.endSec}) exceeds source duration (${take.durationSec})`,
+            });
+        }
+        if (clip.transitionIn && clip.transitionIn !== 'cut' && (clip.transitionMs ?? 0) <= 0) {
+            errors.push({
+                clipIndex: i,
+                message: `transitionIn=${clip.transitionIn} requires positive transitionMs`,
+            });
+        }
+        if ((clip.trimStartMs ?? 0) < 0 || (clip.trimEndMs ?? 0) < 0) {
+            errors.push({ clipIndex: i, message: 'trimStartMs / trimEndMs cannot be negative' });
+        }
+    });
+    return errors;
+}
+/** Effective clip duration in seconds after applying trimStart/trimEnd. */
+export function effectiveDurationSec(clip) {
+    const base = clip.endSec - clip.startSec;
+    const trim = ((clip.trimStartMs ?? 0) + (clip.trimEndMs ?? 0)) / 1000;
+    return Math.max(0, base - trim);
+}
+/** Sum of clip durations minus crossfade overlaps. */
+export function estimateOutputDurationSec(edl) {
+    let total = 0;
+    edl.clips.forEach((clip, i) => {
+        total += effectiveDurationSec(clip);
+        if (i > 0 && clip.transitionIn && clip.transitionIn !== 'cut') {
+            total -= (clip.transitionMs ?? DEFAULT_TRANSITION_MS) / 1000;
+        }
+    });
+    return Math.max(0, total);
+}
+export function addClip(edl, input) {
+    const clip = {
+        sourceId: input.sourceId,
+        startSec: input.startSec,
+        endSec: input.endSec,
+        trimStartMs: input.trimStartMs,
+        trimEndMs: input.trimEndMs,
+        transitionIn: input.transitionIn ?? 'cut',
+        transitionMs: input.transitionIn && input.transitionIn !== 'cut'
+            ? input.transitionMs ?? DEFAULT_TRANSITION_MS
+            : undefined,
+        rationale: input.rationale,
+    };
+    edl.clips.push(clip);
+}
+/**
+ * Insert a crossfade at a cut boundary (between clip `i - 1` and `i`).
+ * Used by the cut-qa agent's `insert-crossfade` fix.
+ */
+export function insertCrossfade(edl, clipIndex, transitionMs = 200) {
+    if (clipIndex <= 0 || clipIndex >= edl.clips.length) {
+        throw new Error(`insertCrossfade: clipIndex ${clipIndex} out of range`);
+    }
+    const clip = edl.clips[clipIndex];
+    clip.transitionIn = 'crossfade';
+    clip.transitionMs = transitionMs;
+}
+export function readEdl(path) {
+    const raw = readFileSync(path, 'utf-8');
+    const parsed = JSON.parse(raw);
+    if (!parsed || typeof parsed !== 'object') {
+        throw new Error(`EDL at ${path} is not an object`);
+    }
+    if (!Array.isArray(parsed.clips)) {
+        throw new Error(`EDL at ${path} is missing a 'clips' array`);
+    }
+    const edl = {
+        clips: parsed.clips,
+        audioFadeMs: parsed.audioFadeMs ?? DEFAULT_AUDIO_FADE_MS,
+        colorGrade: parsed.colorGrade,
+        output: { ...DEFAULT_EDL_OUTPUT, ...(parsed.output ?? {}) },
+    };
+    return edl;
+}
+export function writeEdl(edl, path) {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, JSON.stringify(edl, null, 2), 'utf-8');
+}
+//# sourceMappingURL=edl.js.map

package/dist/editing/edl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edl.js","sourceRoot":"","sources":["../../src/editing/edl.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,MAAM,CAAC,MAAM,kBAAkB,GAAkB;IAC/C,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE,KAAK;IACjB,GAAG,EAAE,EAAE;CACR,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC;AACxC,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAOzC,MAAM,UAAU,cAAc,CAAC,UAA4B,EAAE;IAC3D,OAAO;QACL,KAAK,EAAE,EAAE;QACT,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,qBAAqB;QACzD,MAAM,EAAE,EAAE,GAAG,kBAAkB,EAAE,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE;KAC7D,CAAC;AACJ,CAAC;AAOD,MAAM,UAAU,WAAW,CAAC,GAAQ,EAAE,KAAa;IACjD,MAAM,MAAM,GAAyB,EAAE,CAAC;IACxC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAEtD,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAC5D,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,GAAG,CAAC,WAAW,GAAG,CAAC,IAAI,GAAG,CAAC,WAAW,GAAG,GAAG,EAAE,CAAC;QACjD,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,sCAAsC,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACnG,CAAC;IAED,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QAC5B,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,qBAAqB,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAC7E,OAAO;QACT,CAAC;QACD,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACnC,MAAM,CAAC,IAAI,CAAC;gBACV,SAAS,EAAE,CAAC;gBACZ,OAAO,EAAE,WAAW,IAAI,CAAC,MAAM,oCAAoC,IAAI,CAAC,QAAQ,GAAG;aACpF,CAAC,CAAC;QACL,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,gCAAgC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC1F,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,WAAW,GAAG,IAAI,EAAE,CAAC;YAC1C,MAAM,CAAC,IAAI,CAAC;gBACV,SAAS,EAAE,CAAC;gBACZ,OAAO,EAAE,WAAW,IAAI,CAAC,MAAM,8BAA8B,IAAI,CAAC,WAAW,GAAG;aACjF,CAAC,CAAC;QACL,CAAC;QACD,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,KAAK,KAAK,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YACtF,MAAM,CAAC,IAAI,CAAC;gBACV,SAAS,EAAE,CAAC;gBACZ,OAAO,EAAE,gBAAgB,IAAI,CAAC,YAAY,iCAAiC;aAC5E,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7D,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,4CAA4C,EAAE,CAAC,CAAC;QACvF,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,oBAAoB,CAAC,IAAa;IAChD,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC;IACzC,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACtE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC,CAAC;AAClC,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,yBAAyB,CAAC,GAAQ;IAChD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QAC5B,KAAK,IAAI,oBAAoB,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,KAAK,KAAK,EAAE,CAAC;YAC9D,KAAK,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,qBAAqB,CAAC,GAAG,IAAI,CAAC;QAC/D,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAC5B,CAAC;AAaD,MAAM,UAAU,OAAO,CAAC,GAAQ,EAAE,KAAmB;IACnD,MAAM,IAAI,GAAY;QACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,KAAK;QACzC,YAAY,EACV,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,YAAY,KAAK,KAAK;YAChD,CAAC,CAAC,KAAK,CAAC,YAAY,IAAI,qBAAqB;YAC7C,CAAC,CAAC,SAAS;QACf,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC;IACF,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACvB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,GAAQ,EACR,SAAiB,EACjB,eAAuB,GAAG;IAE1B,IAAI,SAAS,IAAI,CAAC,IAAI,SAAS,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,8BAA8B,SAAS,eAAe,CAAC,CAAC;IAC1E,CAAC;IACD,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAClC,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC;IAChC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,mBAAmB,CAAC,CAAC;IACrD,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,6BAA6B,CAAC,CAAC;IAC/D,CAAC;IACD,MAAM,GAAG,GAAQ;QACf,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,qBAAqB;QACxD,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,MAAM,EAAE,EAAE,GAAG,kBAAkB,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE;KAC5D,CAAC;IACF,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,GAAQ,EAAE,IAAY;IAC7C,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAC7D,CAAC"}

package/dist/editing/overlays.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Overlay manifest types and helpers.
+ *
+ * Overlays are branded motion graphics composited onto a finished cut:
+ * lower thirds (speaker name + title), title cards, callouts, chapter
+ * markers. They are produced by parallel sub-agents (Remotion or ffmpeg
+ * drawtext) and composited by `scripts/render-overlay.ts`.
+ *
+ * Separate from the EDL because overlays are a post-process on top of
+ * the delivered cut — not part of the source-material cut list.
+ */
+export type OverlayKind = 'lower-third' | 'title-card' | 'callout' | 'chapter-marker' | 'logo-bug';
+export type OverlayRenderer = 'remotion' | 'ffmpeg-drawtext';
+export interface OverlayPosition {
+    /** Anchor point for the overlay. */
+    anchor: 'top-left' | 'top-center' | 'top-right' | 'center' | 'bottom-left' | 'bottom-center' | 'bottom-right';
+    /** Offset in px from the anchor. Positive = inward. */
+    offsetXPx?: number;
+    offsetYPx?: number;
+}
+export interface LowerThirdPayload {
+    kind: 'lower-third';
+    name: string;
+    title?: string;
+    color?: string;
+    durationMs?: number;
+}
+export interface TitleCardPayload {
+    kind: 'title-card';
+    heading: string;
+    subheading?: string;
+    /** Background: 'black', 'white', 'blur', or a hex color. */
+    background?: string;
+}
+export interface CalloutPayload {
+    kind: 'callout';
+    text: string;
+    /**
+     * Point to this frame coordinate with an arrow. If omitted the callout
+     * is a free-floating banner.
+     */
+    pointToXPx?: number;
+    pointToYPx?: number;
+}
+export interface ChapterMarkerPayload {
+    kind: 'chapter-marker';
+    chapterNumber: number;
+    title: string;
+}
+export interface LogoBugPayload {
+    kind: 'logo-bug';
+    /**
+     * Describe the logo geometry in text — NEVER pass the Venice AI logo PNG
+     * as a composite source (AGENTS.md anti-pattern #11 — mostly-transparent
+     * logos render as overlays, not references). For the Venice crossed-keys
+     * logo the renderer draws it procedurally in Remotion or via ffmpeg
+     * drawgeometry from a pre-rendered branded PNG asset.
+     */
+    description: string;
+    /** Path to a pre-rendered fully-opaque logo asset. Optional. */
+    assetPath?: string;
+}
+export type OverlayPayload = LowerThirdPayload | TitleCardPayload | CalloutPayload | ChapterMarkerPayload | LogoBugPayload;
+export interface Overlay {
+    id: string;
+    kind: OverlayKind;
+    startSec: number;
+    endSec: number;
+    position: OverlayPosition;
+    payload: OverlayPayload;
+    renderer: OverlayRenderer;
+    /**
+     * Path to a pre-rendered overlay asset (transparent WebM/MOV for
+     * Remotion, or omitted for ffmpeg drawtext which renders in-place).
+     */
+    assetPath?: string;
+}
+export interface OverlayManifest {
+    /** Base video this manifest applies to. */
+    baseVideo: string;
+    /** Path to the composited output. */
+    outputPath: string;
+    overlays: Overlay[];
+}
+/**
+ * Validate an overlay manifest. Rejects manifests that would violate the
+ * Venice logo rules (rule 17, anti-pattern #11) or produce overlapping
+ * cuts on the same anchor.
+ */
+export interface OverlayValidationError {
+    overlayId: string;
+    message: string;
+}
+export declare function validateOverlayManifest(manifest: OverlayManifest): OverlayValidationError[];
+export declare function readOverlayManifest(path: string): OverlayManifest;
+export declare function writeOverlayManifest(manifest: OverlayManifest, path: string): void;
+//# sourceMappingURL=overlays.d.ts.map

package/dist/editing/overlays.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlays.d.ts","sourceRoot":"","sources":["../../src/editing/overlays.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,MAAM,MAAM,WAAW,GACnB,aAAa,GACb,YAAY,GACZ,SAAS,GACT,gBAAgB,GAChB,UAAU,CAAC;AAEf,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,iBAAiB,CAAC;AAE7D,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,MAAM,EAAE,UAAU,GAAG,YAAY,GAAG,WAAW,GAAG,QAAQ,GAAG,aAAa,GAAG,eAAe,GAAG,cAAc,CAAC;IAC9G,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,gBAAgB,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,CAAC;IACjB;;;;;;OAMG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,cAAc,GACtB,iBAAiB,GACjB,gBAAgB,GAChB,cAAc,GACd,oBAAoB,GACpB,cAAc,CAAC;AAEnB,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,eAAe,CAAC;IAC1B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,eAAe,GAAG,sBAAsB,EAAE,CAmB3F;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAGjE;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAGlF"}

package/dist/editing/overlays.js

@@ -0,0 +1,41 @@
+/**
+ * Overlay manifest types and helpers.
+ *
+ * Overlays are branded motion graphics composited onto a finished cut:
+ * lower thirds (speaker name + title), title cards, callouts, chapter
+ * markers. They are produced by parallel sub-agents (Remotion or ffmpeg
+ * drawtext) and composited by `scripts/render-overlay.ts`.
+ *
+ * Separate from the EDL because overlays are a post-process on top of
+ * the delivered cut — not part of the source-material cut list.
+ */
+import { readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+export function validateOverlayManifest(manifest) {
+    const errs = [];
+    for (const o of manifest.overlays) {
+        if (!(o.endSec > o.startSec)) {
+            errs.push({ overlayId: o.id, message: 'endSec must be greater than startSec' });
+        }
+        if (o.payload.kind === 'logo-bug') {
+            const p = o.payload;
+            const desc = (p.description ?? '').toLowerCase();
+            if (/\b(vvv|triple[- ]?v)\b/.test(desc)) {
+                errs.push({
+                    overlayId: o.id,
+                    message: 'Venice logo description uses "VVV" / "triple-V". Per AGENTS.md rule 17 the logo is a crossed-keys design — describe as "two ornate skeleton keys crossed in an X with a chevron/open-book at the top".',
+                });
+            }
+        }
+    }
+    return errs;
+}
+export function readOverlayManifest(path) {
+    const raw = readFileSync(path, 'utf-8');
+    return JSON.parse(raw);
+}
+export function writeOverlayManifest(manifest, path) {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, JSON.stringify(manifest, null, 2), 'utf-8');
+}
+//# sourceMappingURL=overlays.js.map

package/dist/editing/overlays.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlays.js","sourceRoot":"","sources":["../../src/editing/overlays.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0GpC,MAAM,UAAU,uBAAuB,CAAC,QAAyB;IAC/D,MAAM,IAAI,GAA6B,EAAE,CAAC;IAC1C,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAClC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,sCAAsC,EAAE,CAAC,CAAC;QAClF,CAAC;QACD,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAClC,MAAM,CAAC,GAAG,CAAC,CAAC,OAAyB,CAAC;YACtC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;YACjD,IAAI,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxC,IAAI,CAAC,IAAI,CAAC;oBACR,SAAS,EAAE,CAAC,CAAC,EAAE;oBACf,OAAO,EACL,wMAAwM;iBAC3M,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACxC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAoB,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAyB,EAAE,IAAY;IAC1E,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAClE,CAAC"}

package/dist/editing/packer.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Packer: collapses word streams into phrases and renders takes_packed.md.
+ *
+ * The pack is the primary LLM surface for editing. Keep it compact — target
+ * ~12KB per 40 minutes of source audio. The format matches the one used by
+ * browser-use/video-use so experience across projects transfers directly.
+ *
+ * Phrase boundary heuristics, in order:
+ *   1. Gap between consecutive words > `silenceGapSec` (default 0.45s)
+ *   2. Hard sentence punctuation followed by any gap (. ! ?)
+ *   3. Soft punctuation (, ; :) only when followed by > 0.30s gap
+ */
+import type { AudioEvent, Take, TakesPack, WordTiming } from './types.js';
+export interface PackOptions {
+    silenceGapSec?: number;
+    maxPhraseSec?: number;
+    /**
+     * Minimum character length for a phrase to appear in the pack — shorter
+     * fragments get merged into the next phrase.
+     */
+    minPhraseChars?: number;
+}
+/**
+ * Derive a stable 5-char hex id (e.g. `C0103`) from the file path. The
+ * leading `C` matches video-use's naming. Stable across runs so EDLs
+ * survive re-transcription.
+ */
+export declare function deriveTakeId(file: string, ordinal: number): string;
+export interface BuildTakeInput {
+    file: string;
+    words: WordTiming[];
+    durationSec: number;
+    transcriber: string;
+    ordinal: number;
+    mode: 'asr' | 'aligned';
+    defaultSpeaker?: string;
+    /** Pre-computed phrase-level speaker labels when diarization is available. */
+    phraseSpeakers?: string[];
+    audioEvents?: AudioEvent[];
+    packOptions?: PackOptions;
+}
+export declare function buildTake(input: BuildTakeInput): Take;
+/**
+ * Render a TakesPack to markdown. Each take becomes a `##` heading with
+ * bracketed phrase timestamps inside — the exact format video-use uses.
+ */
+export declare function renderTakesPack(pack: TakesPack): string;
+export declare function writeTakesPack(pack: TakesPack, outPath: string): void;
+/** Write `<source>.words.json` next to a take for programmatic consumers. */
+export declare function writeWordsJson(take: Take, outPath: string): void;
+export declare function wordsJsonPathFor(sourceFile: string, editDir: string): string;
+//# sourceMappingURL=packer.d.ts.map

package/dist/editing/packer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packer.d.ts","sourceRoot":"","sources":["../../src/editing/packer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EACV,UAAU,EACV,IAAI,EAEJ,SAAS,EACT,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,WAAW;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAQD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAKlE;AAiED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,KAAK,GAAG,SAAS,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8EAA8E;IAC9E,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAmBrD;AAMD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAqCvD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAGrE;AAED,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAmBhE;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAG5E"}