veodl 1.12.0 → 2.0.0

package/src/path-links.js

@@ -1,53 +0,0 @@
-import path from 'node:path';
-import { statSync } from 'node:fs';
-import { pathToFileURL } from 'node:url';
-
-export function supportsPathLinks(stream, env = process.env) {
-  return Boolean(stream.isTTY && env.TERM !== 'dumb' &&
-    (env.WT_SESSION || env.TERM_PROGRAM === 'iTerm.app' || env.TERM_PROGRAM === 'WezTerm' ||
-      env.TERM_PROGRAM === 'vscode' || env.KITTY_WINDOW_ID || Number(env.VTE_VERSION) >= 5000));
-}
-
-// File links target their containing folder so clicking does not play the media.
-export function folderLink(stream, target, label = target, env = process.env) {
-  const safeLabel = String(label).replace(/[\x00-\x1f\x7f-\x9f]/g, ' ');
-  if (!supportsPathLinks(stream, env)) return safeLabel;
-  try {
-    const absolute = path.resolve(target);
-    const folder = statSync(absolute).isDirectory() ? absolute : path.dirname(absolute);
-    const url = pathToFileURL(folder + path.sep).href;
-    return `\x1b]8;;${url}\x1b\\${safeLabel}\x1b]8;;\x1b\\`;
-  } catch { return safeLabel; }
-}
-
-// Recognize absolute paths in application prose before display truncation.
-// Resolve the longest existing candidate so spaces and parentheses in names survive.
-export function linkOutputPaths(stream, original, displayed = original, env = process.env) {
-  if (!supportsPathLinks(stream, env) || /\x1b/.test(original) ||
-    /^\s*(?:["{[]|Retry:|Usage:|Manual command:|Run with|Stop:|Cleanup:)/.test(original)) return displayed;
-  const matches = [...original.matchAll(/(?:^|[\s("'])([A-Za-z]:[\\/]|\\\\[^\\\s]+\\|\/(?!\/))/g)];
-  for (const match of matches.reverse()) {
-    const start = match.index + match[0].length - match[1].length;
-    const rest = original.slice(start);
-    const ends = [rest.length];
-    for (let i = rest.length - 1; i > 0; i--) {
-      if (/[\s)"',;:.]/.test(rest[i])) ends.push(i);
-    }
-    let target;
-    for (const end of ends) {
-      const candidate = rest.slice(0, end);
-      try { statSync(candidate); target = candidate; break; } catch { /* try a prose boundary */ }
-    }
-    if (!target) continue;
-    // Truncation has already happened; keep the complete destination in the URL.
-    if (displayed.slice(start, start + target.length) === target) {
-      displayed = displayed.slice(0, start) + folderLink(stream, target, target, env) + displayed.slice(start + target.length);
-    } else {
-      const visible = displayed.slice(start);
-      if (visible.endsWith('…') && target.startsWith(visible.slice(0, -1))) {
-        displayed = displayed.slice(0, start) + folderLink(stream, target, visible, env);
-      }
-    }
-  }
-  return displayed;
-}

package/src/paths.js

@@ -1,26 +0,0 @@
-import os from 'node:os';
-import path from 'node:path';
-
-/**
- * Single source of truth for veo's per-user cache root. Used for the yt-dlp
- * backend, the staged FFmpeg binaries, and small state files.
- * An invalid relative OS cache setting must never write into the output directory.
- */
-export function cacheBase({ platform = process.platform, env = process.env, home = os.homedir() } = {}) {
-  let base;
-  if (platform === 'win32') base = env.LOCALAPPDATA || path.join(home, 'AppData', 'Local');
-  else if (platform === 'darwin') base = path.join(home, 'Library', 'Caches');
-  else base = env.XDG_CACHE_HOME || path.join(home, '.cache');
-  if (!path.isAbsolute(base)) base = path.join(home, '.cache');
-  return path.join(base, 'veo');
-}
-
-/** Per-user configuration directory, following each platform's own convention. */
-export function configBase({ platform = process.platform, env = process.env, home = os.homedir() } = {}) {
-  let base;
-  if (platform === 'win32') base = env.APPDATA || path.join(home, 'AppData', 'Roaming');
-  else if (platform === 'darwin') base = path.join(home, 'Library', 'Application Support');
-  else base = env.XDG_CONFIG_HOME || path.join(home, '.config');
-  if (!path.isAbsolute(base)) base = path.join(home, '.config');
-  return path.join(base, 'veo');
-}

package/src/playlist.js

@@ -1,31 +0,0 @@
-export function validateItems(value) {
-  if (typeof value !== 'string' || !/^\d+(?:-\d+)?(?:,\d+(?:-\d+)?)*$/.test(value)) {
-    throw new Error('--playlist-items expects positive indices or ranges, e.g. 1,3-5.');
-  }
-  for (const part of value.split(',')) {
-    const [start, end = start] = part.split('-').map(Number);
-    if (!Number.isSafeInteger(start) || !Number.isSafeInteger(end) || start < 1 || end < start) {
-      throw new Error('--playlist-items requires ascending, positive ranges.');
-    }
-  }
-  return value;
-}
-
-export function selectedEntries(metadata, selection) {
-  const ranges = selection ? validateItems(selection).split(',').map(part => part.split('-').map(Number)) : null;
-  const entries = (metadata.entries || []).map((entry, offset) => ({ entry, index: entry?.playlist_index || offset + 1 }));
-  const selected = entries.filter(({ index }) => !ranges || ranges.some(([start, end = start]) => index >= start && index <= end));
-  if (!selected.length) throw new Error('No playlist entries match the selection.');
-  return selected;
-}
-
-export function sizeEstimate(entries) {
-  const sizes = entries.map(({ entry }) => entry?.filesize || entry?.filesize_approx);
-  const known = sizes.filter(value => Number.isFinite(value) && value > 0);
-  return { estimatedBytes: known.reduce((sum, value) => sum + value, 0), knownSizes: known.length, totalEntries: entries.length };
-}
-
-export function describeEstimate(estimate) {
-  if (!estimate.knownSizes) return `${estimate.totalEntries} entries; total size unknown`;
-  return `${estimate.totalEntries} entries; approximately ${(estimate.estimatedBytes / 1048576).toFixed(1)} MiB${estimate.knownSizes < estimate.totalEntries ? ` for ${estimate.knownSizes} entries; remaining sizes unknown` : ''}`;
-}

package/src/progress.js

@@ -1,341 +0,0 @@
-import { cleanText } from './utils.js';
-import { createTerminalTitle } from './terminal-title.js';
-import { terminalColumns } from './terminal-size.js';
-import { createInlineRegion } from './inline-region.js';
-
-const PROCESSING_LABELS = { Merger: 'Merging audio/video', VideoRemuxer: 'Changing video container', VideoConvertor: 'Converting video', ExtractAudio: 'Converting audio', EmbedSubtitle: 'Embedding subtitles', Metadata: 'Writing metadata', EmbedThumbnail: 'Embedding thumbnail', MoveFiles: 'Preparing saved file' };
-
-export function styleText(stream, text, role = 'muted', enabled = true, env = process.env) {
-  if (!enabled || !stream.isTTY || Object.hasOwn(env, 'NO_COLOR') || env.TERM === 'dumb') return text;
-  const codes = { muted: 90, title: 1, profile: 97, success: 32, error: 31 };
-  return '\x1b[' + (codes[role] || 90) + 'm' + text + '\x1b[0m';
-}
-
-function bytes(value) {
-  if (!Number.isFinite(value) || value < 0) return '?';
-  const units = ['B', 'KiB', 'MiB', 'GiB', 'TiB'];
-  let i = 0;
-  while (value >= 1024 && i < units.length - 1) { value /= 1024; i++; }
-  return `${value.toFixed(i ? 1 : 0)} ${units[i]}`;
-}
-
-// Count terminal cells conservatively, including wide titles and emoji.
-function cells(text) {
-  return [...text].reduce((width, char) => width + (/\p{Mark}|\u200d/u.test(char) ? 0 : /[\u1100-\u115f\u2329\u232a\u2e80-\ua4cf\uac00-\ud7a3\uf900-\ufaff\ufe10-\ufe19\ufe30-\ufe6f\uff01-\uff60\uffe0-\uffe6]|\p{Extended_Pictographic}/u.test(char) ? 2 : 1), 0);
-}
-
-function fit(text, width) {
-  if (cells(text) <= width) return text;
-  let result = '';
-  for (const char of text) {
-    if (cells(result + char) > width - 1) break;
-    result += char;
-  }
-  return width > 0 ? result + '…' : '';
-}
-
-export function wrap(text, width) {
-  if (!Number.isFinite(width)) return text;
-  const lines = [];
-  let line = '';
-  for (const char of text) {
-    if (line && cells(line + char) > width) { lines.push(line); line = ''; }
-    line += char;
-  }
-  return [...lines, line].join('\n');
-}
-
-export function terminalText(stream, text) {
-  return fit(cleanText(text), stream.isTTY ? Math.max(1, terminalColumns(stream) - 1) : Infinity);
-}
-
-export function terminalTitle(stream, text) {
-  const safe = cleanText(text);
-  if (!stream.isTTY) return safe;
-  const width = Math.max(1, terminalColumns(stream) - 1);
-  const lines = [];
-  let line = '';
-  for (const char of safe) {
-    if (cells(line + char) > width) {
-      if (lines.length === 2) return [...lines, fit(line + char + '…', width)].join('\n');
-      lines.push(line);
-      line = '';
-    }
-    line += char;
-  }
-  return [...lines, line].join('\n');
-}
-
-export function formatProgress(data, { columns = Infinity, prefix = '' } = {}) {
-  const done = Number.isFinite(data.downloaded_bytes) ? data.downloaded_bytes : 0;
-  const total = data.total_bytes || data.total_bytes_estimate;
-  const estimated = !data.total_bytes && Boolean(data.total_bytes_estimate);
-  const percent = total > 0 ? Math.max(0, Math.min(estimated && data.status !== 'finished' ? 99 : 100, done / total * 100)) : null;
-  const eta = Number.isFinite(data.eta) ? `${Math.floor(data.eta / 60)}:${String(Math.floor(data.eta % 60)).padStart(2, '0')}` : '?';
-  const pct = `${estimated && data.status !== 'finished' ? '~' : ''}${percent === null ? '?' : percent.toFixed(0)}%`;
-  const size = `${estimated ? '~' : ''}${bytes(total)}`;
-  const label = prefix ? cleanText(prefix) + ' ' : '';
-  if (data.status === 'finished') return wrap(`${label}${bytes(done)} received; processing…`, columns);
-  const stats = [`${bytes(data.speed)}/s`, `${bytes(done)} / ${size}`, `ETA ${eta}`];
-  const barSize = Math.max(1, Math.min(20, Number.isFinite(columns) ? columns - cells(pct) - 3 : 20));
-  const filled = percent === null ? 0 : Math.round(percent / 100 * barSize);
-  const bar = `[${'='.repeat(filled)}${'-'.repeat(barSize - filled)}] ${pct}`;
-  const full = `${label}${bar}  ${stats.join('  ')}`;
-  if (cells(full) <= columns) return full;
-  const lines = [];
-  if (label) lines.push(fit(label.trimEnd(), columns));
-  lines.push(wrap(bar, columns));
-  let statLine = '';
-  for (const stat of stats) {
-    if (statLine && cells(`${statLine}  ${stat}`) > columns) { lines.push(wrap(statLine, columns)); statLine = ''; }
-    statLine += (statLine ? '  ' : '') + stat;
-  }
-  if (statLine) lines.push(wrap(statLine, columns));
-  return lines.join('\n');
-}
-
-export function createReporter(stream = process.stderr, { setTitle = createTerminalTitle(stream), env = process.env } = {}) {
-  let color = true;
-  let region;
-  const muted = text => styleText(stream, text, 'muted', color, env);
-  const heading = text => styleText(stream, text, 'title', color, env);
-  let active = false;
-  let lastLog = 0;
-  let name = '';
-  let phase = 'Starting…';
-  let started = false;
-  let position = '';
-  let hasItem = false;
-  let streamName = '';
-  let animation;
-  let animationLabel = '';
-  let animationOwner;
-  let animationFrame = 0;
-  let redraw;
-  let listening = false;
-  let sizeTimer;
-  let lastWidth = terminalColumns(stream);
-  const append = render => {
-    if (region) region.log(render); else stream.write(render());
-  };
-  const eraseLive = () => {
-    if (!active) return;
-    stream.write('\r\x1b[2K\x1b[J');
-  };
-  const renderLive = text => {
-    eraseLive();
-    const rows = text.split('\n').length;
-    // Park the real cursor at the block's first row. The terminal relocates it
-    // during reflow; no saved cursor or guessed old line count is needed on resize.
-    stream.write(`\r\x1b[2K${text.replace(/\n/g, '\r\n')}${rows > 1 ? `\x1b[${rows - 1}A` : ''}\r`);
-    active = true;
-  };
-  const onResize = () => {
-    const width = terminalColumns(stream);
-    if (width === lastWidth) return;
-    lastWidth = width;
-    // Terminal scrollback reflows differently across hosts. Never infer cursor
-    // positions for past log/title lines; redraw only the owned live block.
-    if (active) redraw?.();
-  };
-  const watchResize = render => {
-    if (region) return;
-    if (stream.isTTY && terminalColumns(stream) !== lastWidth) onResize();
-    redraw = render;
-    if (!sizeTimer && stream.isTTY) {
-      lastWidth = terminalColumns(stream);
-      sizeTimer = setInterval(() => {
-        const width = terminalColumns(stream);
-        if (width !== lastWidth) onResize();
-      }, 150);
-      sizeTimer.unref?.();
-    }
-    if (!listening && stream.isTTY && stream.on) {
-      stream.on('resize', onResize);
-      listening = true;
-    }
-  };
-  const stopAnimation = () => { if (animation) clearInterval(animation); animation = undefined; };
-  const display = value => terminalText(stream, value);
-  const animate = (label, owner) => {
-    clear();
-    if (!stream.isTTY) { stream.write(muted(label + '…') + '\n'); return; }
-    animationLabel = label;
-    animationOwner = owner;
-    animationFrame = 0;
-    const tick = () => {
-      const render = () => muted(display(animationLabel + '.'.repeat(animationFrame % 3 + 1)));
-      if (region) region.live(render); else renderLive(render());
-      animationFrame++;
-    };
-    watchResize(tick);
-    tick();
-    animation = setInterval(tick, 350);
-    animation.unref?.();
-  };
-  const processingResult = (label, status) => {
-    clear();
-    const failed = status === 'failed' || status === 'error';
-    const suffix = failed ? 'failed' : 'done';
-    append(() => muted(`${fit(label, Math.max(0, (stream.isTTY ? terminalColumns(stream) - 1 : Infinity) - suffix.length - 2))}: `) + styleText(stream, suffix, failed ? 'error' : 'success', color, env) + '\n');
-    watchResize(undefined);
-  };
-  const finishStatus = (message, owner, prefix = '', outcome) => {
-    const label = prefix + cleanText(message);
-    if (!animation || animationOwner !== owner || animationLabel !== label.slice(0, -1)) return;
-    if (outcome) { processingResult(label.slice(0, -1), outcome); return; }
-    clear();
-    append(() => muted(display(label)) + '\n');
-    watchResize(undefined);
-  };
-  const line = (data, prefix) => formatProgress(data, { prefix, columns: stream.isTTY ? Math.max(1, terminalColumns(stream) - 1) : Infinity });
-  const draw = (data, prefix) => {
-    if (region) { region.live(() => line(data, prefix)); return; }
-    const render = () => renderLive(line(data, prefix));
-    watchResize(render);
-    render();
-  };
-  const updateTitle = () => setTitle(`veo | ${phase}${name ? ` | ${name}` : ''}`);
-  function clear() {
-    stopAnimation();
-    region?.live(undefined);
-    if (sizeTimer) clearInterval(sizeTimer);
-    sizeTimer = undefined;
-    if (listening) stream.removeListener?.('resize', onResize);
-    listening = false;
-    redraw = undefined;
-    if (active && stream.isTTY) { eraseLive(); stream.write('\r\x1b[2K'); }
-    active = false;
-    animationLabel = '';
-    animationOwner = undefined;
-  }
-  const scoped = (index, total, title, parent = '') => {
-    let childName = cleanText(title), lastProgress = 0;
-    const owner = Symbol('scoped reporter');
-    const prefix = parent + '[' + index + '/' + total + '] ';
-    const log = (message, quiet = true) => {
-      phase = cleanText(message); name = childName;
-      const line = prefix + childName + ': ' + phase;
-      if (phase.endsWith('…')) animate(line.slice(0, -1), owner);
-      else { clear(); append(() => (quiet ? muted(display(line)) : display(line)) + '\n'); }
-      if (started) updateTitle();
-    };
-    return {
-      scoped: (index, total, title) => scoped(index, total, title, prefix),
-      name(value) { childName = cleanText(value); },
-      status: log,
-      finishStatus(message, outcome) { finishStatus(message, owner, prefix + childName + ': ', outcome); },
-      progress(data) {
-        if (stream.isTTY) {
-          draw(data, prefix + childName + ': ' + (data.stream || 'Media'));
-        } else if (Date.now() - lastProgress >= 5000 || data.status === 'finished') {
-          log((data.stream || 'Media') + ' ' + formatProgress(data), false);
-          lastProgress = Date.now();
-        }
-      },
-      processing(data) {
-        const label = prefix + childName + ': ' + (PROCESSING_LABELS[data.postprocessor] || 'Processing media');
-        if (['finished', 'failed', 'error'].includes(data.status)) processingResult(label, data.status);
-        else animate(label, owner);
-        phase = `${PROCESSING_LABELS[data.postprocessor] || 'Processing media'}${data.status === 'finished' ? ': done' : '…'}`;
-        name = childName; if (started) updateTitle();
-      },
-      finish() {},
-      failStep() { if (animation && animationOwner === owner) processingResult(animationLabel, 'failed'); },
-    };
-  };
-  return {
-    enableInline() {
-      if (!region && stream.isTTY && env.TERM !== 'dumb') { clear(); region = createInlineRegion(stream); }
-    },
-    output(destination) {
-      if (!stream.isTTY || !destination.isTTY) return destination;
-      return {
-        isTTY: true,
-        get columns() { return terminalColumns(destination); },
-        write(chunk, ...args) {
-          clear();
-          region?.commit();
-          return destination.write(chunk, ...args);
-        },
-      };
-    },
-    dispose() { clear(); region?.close(); region = undefined; },
-    configure(options) { color = options.color !== false; },
-    scoped,
-    item(index, total, title) {
-      clear(); position = total > 1 ? `[${index}/${total}] ` : ''; hasItem = true; name = cleanText(title); streamName = ''; lastLog = 0;
-      const titleText = `${position}${name}`;
-      const render = () => heading(terminalTitle(stream, titleText)) + '\n';
-      if (region) region.source(render); else append(render);
-      watchResize(undefined);
-      phase = 'Starting…'; if (started) updateTitle();
-    },
-    processing(data) {
-      const processor = cleanText(data.postprocessor || 'Processing');
-      const label = PROCESSING_LABELS[processor] || 'Processing media';
-      phase = `${label}${data.status === 'finished' ? ': done' : '…'}`;
-      if (started) updateTitle();
-      if (['finished', 'failed', 'error'].includes(data.status)) processingResult(`${position}${label}`, data.status);
-      else animate(`${position}${label}`);
-    },
-    start(title = '') { started = true; name = cleanText(title); phase = 'Starting…'; updateTitle(); },
-    name(title) {
-      const next = cleanText(title);
-      if (hasItem && next !== name) {
-        clear();
-        const titleText = `${position}${next}`;
-        const render = () => heading(terminalTitle(stream, titleText)) + '\n';
-        // Titles join the log stream at their chronological position, like
-        // without the inline region. Stored as a render function, they still
-        // re-render on resize (max three rows, current width).
-        if (region) region.log(render); else append(render);
-        watchResize(undefined);
-      }
-      name = next; if (started) updateTitle();
-    },
-    status(message) {
-      phase = cleanText(message);
-      if (started) updateTitle();
-      if (phase.endsWith('…')) animate(phase.slice(0, -1));
-      else {
-        clear();
-        const status = phase;
-        append(() => muted(display(status)) + '\n');
-        watchResize(undefined);
-      }
-    },
-    profile(value) {
-      const selected = value ? cleanText(value) : 'global (no profile)';
-      phase = `Profile: ${selected}`;
-      if (started) updateTitle();
-      clear();
-      append(() => value && value !== 'default'
-        ? muted('Profile: ') + styleText(stream, fit(selected, stream.isTTY ? Math.max(0, terminalColumns(stream) - 10) : Infinity), 'profile', color, env) + '\n'
-        : muted(display(`Profile: ${selected}`)) + '\n');
-    },
-    finishStatus(message, outcome) { finishStatus(message, undefined, '', outcome); },
-    failStep() { if (animation && animationOwner === undefined) processingResult(animationLabel, 'failed'); },
-    complete() { clear(); phase = 'Done'; if (started) updateTitle(); },
-    fail(cancelled = false) { clear(); phase = cancelled ? 'Cancelled' : 'Failed'; if (started) updateTitle(); },
-    progress(data) {
-      if (data.stream && data.stream !== streamName) {
-        clear(); streamName = data.stream; lastLog = 0;
-        const label = `${position}${streamName} download`;
-        append(() => muted(display(label)) + '\n');
-      }
-      const total = data.total_bytes;
-      const percent = Number.isFinite(total) && total > 0 && Number.isFinite(data.downloaded_bytes)
-        ? Math.max(0, Math.min(100, Math.round(data.downloaded_bytes / total * 100))) : null;
-      phase = data.status === 'finished' ? 'Processing…' : percent === null ? 'Downloading…' : `${percent}%`;
-      if (started) updateTitle();
-      if (stream.isTTY) {
-        draw(data, `${position}${streamName}`);
-      } else if (Date.now() - lastLog >= 5000 || data.status === 'finished') {
-        stream.write(`${position}${streamName ? `${streamName} ` : ''}${formatProgress(data)}\n`);
-        lastLog = Date.now();
-      }
-    },
-    finish() { clear(); region?.commit(); },
-  };
-}

package/src/run-archive.js

@@ -1,148 +0,0 @@
-import { createHash } from 'node:crypto';
-import { lstat, open, readdir } from 'node:fs/promises';
-import path from 'node:path';
-import { cacheBase } from './paths.js';
-import { readJson, writeJson } from './state.js';
-
-export const RUN_ARCHIVE_ID = /^[0-9a-z]{6}$/;
-const SAMPLE_BYTES = 64 * 1024;
-const MAX_SEARCH_FILES = 200_000;
-const MEDIA_EXTENSIONS = new Set(['.mp4', '.mkv', '.webm', '.mov', '.m4v', '.mp3', '.m4a', '.aac', '.opus', '.ogg', '.flac', '.wav', '.mka', '.ts']);
-
-export function runArchiveFile(id, root = cacheBase()) {
-  if (!RUN_ARCHIVE_ID.test(id)) throw new Error('Run ids have 6 letters or digits.');
-  return path.join(path.resolve(root), 'run-history', `${id}.json`);
-}
-
-export function isMediaFile(file) { return MEDIA_EXTENSIONS.has(path.extname(file).toLowerCase()); }
-
-async function regularFile(file) {
-  const info = await lstat(file).catch(error => { if (error.code === 'ENOENT') return null; throw error; });
-  return info?.isFile() && !info.isSymbolicLink() ? info : null;
-}
-
-/** Sample three parts of a file so renames can be found without rereading a huge video. */
-export async function fileFingerprint(file, knownInfo) {
-  const info = knownInfo || await regularFile(file);
-  if (!info) return null;
-  const digest = createHash('sha256').update(`veo-file-v1:${info.size}:`);
-  const positions = [...new Set([0, Math.floor(Math.max(0, info.size - SAMPLE_BYTES) / 2), Math.max(0, info.size - SAMPLE_BYTES)])];
-  const handle = await open(file, 'r');
-  try {
-    for (const position of positions) {
-      const bytes = Math.min(SAMPLE_BYTES, info.size - position);
-      const buffer = Buffer.alloc(bytes);
-      const { bytesRead } = await handle.read(buffer, 0, bytes, position);
-      if (bytesRead !== bytes) throw new Error(`File changed while recording its identity: ${file}`);
-      digest.update(String(position)).update(':').update(buffer);
-    }
-  } finally { await handle.close(); }
-  return { size: info.size, sampleSha256: digest.digest('hex'),
-    device: info.dev, inode: info.ino };
-}
-
-export async function archiveRun(job, { root = cacheBase(), now = new Date() } = {}) {
-  const id = job.runId;
-  if (!RUN_ARCHIVE_ID.test(id || '')) return null;
-  const items = [];
-  for (const item of job.items || []) {
-    const files = [];
-    for (const file of item.files || []) {
-      const media = isMediaFile(file);
-      files.push({ originalPath: path.resolve(file), media,
-        fingerprint: media ? item.fingerprints?.[file] || await fileFingerprint(file).catch(() => null) : null });
-    }
-    items.push({ url: item.url, status: item.status, error: item.error || null,
-      output: path.resolve(item.options?.output || job.options?.output || process.cwd()), files });
-  }
-  const archived = { version: 1, id, startedAt: job.startedAt || null, finishedAt: now.toISOString(),
-    status: items.every(item => ['saved', 'skipped'].includes(item.status)) ? 'completed' : 'incomplete', items };
-  if (await lstat(runArchiveFile(id, root)).then(() => true, error => { if (error.code === 'ENOENT') return false; throw error; })) {
-    throw new Error(`Run archive ${id} already exists; refusing to overwrite it.`);
-  }
-  await writeJson(runArchiveFile(id, root), archived);
-  return archived;
-}
-
-export async function readRunArchive(id, root = cacheBase()) {
-  const archive = await readJson(runArchiveFile(id, root), null);
-  if (!archive) throw new Error(`No finished run with id ${id} was found. Active runs appear in veo runs --json.`);
-  if (archive.version !== 1 || archive.id !== id || !Array.isArray(archive.items)) throw new Error(`Invalid archived run: ${id}`);
-  return archive;
-}
-
-async function scan(root, wantedSizes, signal) {
-  const info = await regularFile(root);
-  if (info) throw new Error(`Search root is a file: ${root}`);
-  const directory = await lstat(root).catch(error => { if (error.code === 'ENOENT') return null; throw error; });
-  if (!directory) return [];
-  if (!directory.isDirectory() || directory.isSymbolicLink()) throw new Error(`Search root is not a plain directory: ${root}`);
-  const candidates = [];
-  const pending = [root];
-  let seen = 0;
-  while (pending.length) {
-    signal?.throwIfAborted();
-    const current = pending.pop();
-    for (const entry of await readdir(current, { withFileTypes: true })) {
-      const file = path.join(current, entry.name);
-      if (entry.isDirectory()) pending.push(file);
-      else if (entry.isFile()) {
-        if (++seen > MAX_SEARCH_FILES) throw new Error(`Too many files under ${root}; use --search with a narrower directory.`);
-        const details = await regularFile(file);
-        if (details && wantedSizes.has(details.size)) candidates.push({ file, details });
-      }
-    }
-  }
-  return candidates;
-}
-
-/** Resolve original paths first, then use fingerprints to find renamed media. */
-export async function locateRunFiles(archive, { searchRoot, signal } = {}) {
-  const items = [];
-  const missing = [];
-  for (const item of archive.items) {
-    signal?.throwIfAborted();
-    const files = [];
-    for (const entry of item.files || []) {
-      const details = await regularFile(entry.originalPath);
-      const fingerprint = details && entry.fingerprint ? await fileFingerprint(entry.originalPath, details).catch(error => { if (error.code === 'ENOENT') return null; throw error; }) : null;
-      const valid = details && (!entry.fingerprint || (fingerprint?.size === entry.fingerprint.size && fingerprint.sampleSha256 === entry.fingerprint.sampleSha256));
-      const resolved = { originalPath: entry.originalPath, path: valid ? entry.originalPath : null,
-        found: Boolean(valid), renamed: false, media: Boolean(entry.media) };
-      files.push(resolved);
-      if (!valid && entry.media && entry.fingerprint) missing.push({ resolved, entry, output: item.output });
-    }
-    items.push({ url: item.url, status: item.status, error: item.error || null, files });
-  }
-  if (missing.length) {
-    const roots = [...new Set(missing.map(item => item.output).concat(searchRoot ? [path.resolve(searchRoot)] : []))];
-    const wanted = new Set(missing.map(item => item.entry.fingerprint.size));
-    const matches = new Map();
-    for (const root of roots) for (const candidate of await scan(root, wanted, signal)) {
-      signal?.throwIfAborted();
-      const fingerprint = await fileFingerprint(candidate.file, candidate.details).catch(error => { if (error.code === 'ENOENT') return null; throw error; });
-      if (!fingerprint) continue;
-      const key = `${fingerprint.size}:${fingerprint.sampleSha256}`;
-      const paths = matches.get(key) || new Set();
-      paths.add(candidate.file);
-      matches.set(key, paths);
-    }
-    for (const { resolved, entry } of missing) {
-      const key = `${entry.fingerprint.size}:${entry.fingerprint.sampleSha256}`;
-      const paths = [...(matches.get(key) || [])];
-      let selected = paths.length === 1 ? paths[0] : null;
-      if (!selected && paths.length > 1 && entry.fingerprint.inode > 0) {
-        const sameFile = [];
-        for (const file of paths) {
-          const details = await regularFile(file);
-          if (details?.dev === entry.fingerprint.device && details.ino === entry.fingerprint.inode) sameFile.push(file);
-        }
-        if (sameFile.length === 1) selected = sameFile[0];
-      }
-      if (selected) {
-        resolved.path = selected; resolved.found = true; resolved.renamed = selected !== entry.originalPath;
-      } else if (paths.length > 1) resolved.candidates = paths;
-    }
-  }
-  return items;
-}