veodl 1.12.1 → 2.0.1

package/src/stats.js

@@ -1,63 +0,0 @@
-import { commandOutput } from './output.js';
-import { randomUUID } from 'node:crypto';
-import { readdir, lstat, rm } from 'node:fs/promises';
-import path from 'node:path';
-import { cacheBase } from './paths.js';
-import { readJson, writeJson } from './state.js';
-
-const fields = ['videos', 'audio', 'failed', 'skipped', 'cancelled', 'elapsedMs'];
-const pattern = /^[a-f0-9-]{36}\.json$/;
-const empty = () => Object.fromEntries(fields.map(key => [key, 0]));
-
-export function createStatsRecorder(root = cacheBase()) {
-  const file = path.join(root, 'stats', `${randomUUID()}.json`);
-  const totals = { version: 1, since: new Date().toISOString(), ...empty() };
-  return async delta => {
-    for (const key of fields) totals[key] += delta[key] || 0;
-    await writeJson(file, totals);
-  };
-}
-
-async function statFiles(root) {
-  const directory = path.resolve(root, 'stats');
-  const info = await lstat(directory).catch(error => { if (error.code === 'ENOENT') return null; throw error; });
-  if (!info) return [];
-  if (!info.isDirectory() || info.isSymbolicLink()) throw new Error(`Invalid statistics directory: ${directory}`);
-  return (await readdir(directory, { withFileTypes: true }))
-    .filter(entry => entry.isFile() && pattern.test(entry.name)).map(entry => path.join(directory, entry.name));
-}
-
-export async function readStats(root = cacheBase()) {
-  const result = { since: null, ...empty() };
-  for (const file of await statFiles(root)) {
-    const value = await readJson(file, null);
-    if (!value) continue;
-    if (value.version !== 1 || !Number.isFinite(Date.parse(value.since)) || fields.some(key => !Number.isFinite(value[key]) || value[key] < 0)) {
-      throw new Error(`Invalid statistics file: ${file}`);
-    }
-    if (!result.since || value.since < result.since) result.since = value.since;
-    for (const key of fields) result[key] += value[key];
-  }
-  return result;
-}
-
-// Called by flush only after registered runs have stopped and while its gate is held.
-export async function resetStats(root = cacheBase()) {
-  for (const file of await statFiles(root)) await rm(file, { force: true });
-}
-
-export async function statsMain(args = [], { stdout = process.stdout, root = cacheBase() } = {}) {
-  [args, stdout] = commandOutput(args, stdout);
-  if (args.length === 1 && ['--help', '-h'].includes(args[0])) {
-    stdout.write('veo stats [--json]\n\nShow recorded download totals. Time includes preparation, processing and saving,\nincluding failed attempts. Parallel run times are added together.\nStats start with this version; old downloads are not imported.\nUse veo flush --stats to clear temporary data and reset statistics.\n');
-    return 0;
-  }
-  if (args.length && (args.length !== 1 || args[0] !== '--json')) throw new Error('Usage: veo stats [--json]');
-  const stats = await readStats(root);
-  if (args[0] === '--json') stdout.write(`${JSON.stringify(stats)}\n`);
-  else {
-    const seconds = Math.floor(stats.elapsedMs / 1000);
-    stdout.write(`veo stats\n\nTracking since: ${stats.since || 'No downloads recorded yet'}\nVideos saved:   ${stats.videos}\nAudio saved:    ${stats.audio}\nTotal failures: ${stats.failed}\nSkipped:        ${stats.skipped}\nCancelled:      ${stats.cancelled}\nDownload time:  ${Math.floor(seconds / 3600)}h ${Math.floor(seconds / 60) % 60}m ${seconds % 60}s\n\nTime includes preparation, processing and saving. Active requests appear when finished.\n`);
-  }
-  return 0;
-}

package/src/terminal-size.js

@@ -1,8 +0,0 @@
-// Windows stderr can retain an old size between writes. Refresh the native TTY
-// before reading it; custom/test streams retain their own live columns getter.
-export function terminalColumns(stream) {
-  if (process.platform === 'win32' && (stream === process.stdout || stream === process.stderr)) {
-    try { stream._refreshSize?.(); } catch { /* Cosmetic fallback only. */ }
-  }
-  return Number.isInteger(stream.columns) && stream.columns > 0 ? stream.columns : 80;
-}

package/src/terminal-title.js

@@ -1,19 +0,0 @@
-import { cleanText } from './utils.js';
-
-// PowerShell's console title API on Windows; OSC 0 on xterm-compatible Unix
-// terminals. Never put escape sequences into redirected output or dumb terminals.
-export function createTerminalTitle(stream, { platform = process.platform, env = process.env, processInfo = process } = {}) {
-  let previous;
-  return title => {
-    if (!stream.isTTY || env.TERM === 'dumb') return;
-    const safe = cleanText(title).slice(0, 240);
-    if (safe === previous) return;
-    try {
-      if (platform === 'win32') processInfo.title = safe;
-      else stream.write(`\x1b]0;${safe}\x07`);
-      previous = safe;
-    } catch {
-      // Cosmetic only: a terminal that rejects titles must not break downloads.
-    }
-  };
-}

package/src/tool-setup.js

@@ -1,289 +0,0 @@
-import { spawn } from 'node:child_process';
-import { createHash } from 'node:crypto';
-import { constants, createReadStream, createWriteStream } from 'node:fs';
-import { chmod, lstat, mkdir, mkdtemp, open, rm } from 'node:fs/promises';
-import path from 'node:path';
-import { Readable, Transform, Writable } from 'node:stream';
-import { pipeline } from 'node:stream/promises';
-import { createGunzip } from 'node:zlib';
-import { MEDIA_ASSETS, MEDIA_ASSET_BASE } from './media-assets.js';
-import { cleanText } from './utils.js';
-
-// Only fixed package names and arguments are passed to these installers.
-export function runSetup(command, args, {
-  signal, env = process.env, cwd, status = () => {}, timeoutMs = 600_000,
-} = {}) {
-  signal?.throwIfAborted();
-  return new Promise((resolve, reject) => {
-    const child = spawn(command, args, {
-      shell: false, windowsHide: true, detached: process.platform !== 'win32',
-      stdio: ['ignore', 'pipe', 'pipe'], env, cwd,
-    });
-    let output = '';
-    let stopped;
-    const stop = error => {
-      if (stopped) return;
-      stopped = error;
-      if (process.platform === 'win32' && child.pid) {
-        const killer = spawn('taskkill.exe', ['/PID', String(child.pid), '/T', '/F'], { shell: false, windowsHide: true, stdio: 'ignore' });
-        killer.on('error', () => child.kill());
-      } else {
-        try { process.kill(-child.pid, 'SIGKILL'); } catch { child.kill('SIGKILL'); }
-      }
-    };
-    const abort = () => stop(signal.reason);
-    const timer = setTimeout(() => stop(new Error('Tool installation timed out. Retry with veo doctor fix.')), timeoutMs);
-    const receive = chunk => {
-      const text = cleanText(String(chunk));
-      output = (output + text).slice(-8192);
-      // Surface package-manager progress without taking over stdin or stdout.
-      for (const line of text.split(/[\r\n]+/)) if (line.trim()) status(line.slice(0, 500));
-    };
-    child.stdout.on('data', receive);
-    child.stderr.on('data', receive);
-    signal?.addEventListener('abort', abort, { once: true });
-    if (signal?.aborted) abort();
-    const cleanup = () => { clearTimeout(timer); signal?.removeEventListener('abort', abort); };
-    child.once('error', error => { cleanup(); reject(stopped || error); });
-    child.once('close', code => {
-      cleanup();
-      if (stopped) reject(stopped);
-      else if (code !== 0) reject(new Error(`${path.basename(command)} exited with code ${code}: ${output.trim()}`));
-      else resolve(output);
-    });
-  });
-}
-
-export async function hasTermuxEjs({ find, run = runSetup, signal }) {
-  const python = await find(['python', 'python3']);
-  if (!python) return false;
-  try {
-    await run(python, ['-B', '-c', 'import yt_dlp_ejs'], { signal, timeoutMs: 15_000 });
-    return true;
-  } catch {
-    signal?.throwIfAborted();
-    return false;
-  }
-}
-
-let termuxInstall;
-export async function installTermuxTools({ find, signal, status, run = runSetup, env = process.env }) {
-  if (termuxInstall) {
-    await termuxInstall;
-    signal?.throwIfAborted();
-    return;
-  }
-  termuxInstall = (async () => {
-    const pkg = await find(['pkg']);
-    if (!pkg) throw new Error('Automatic Android setup requires Termux with pkg on PATH. Install python-yt-dlp, yt-dlp-ejs and ffmpeg in Termux.');
-    signal?.throwIfAborted();
-    status('Installing yt-dlp, JavaScript support and FFmpeg with Termux pkg (first use)…');
-    // pkg refreshes mirrors/package lists itself. No full system upgrade or sudo.
-    await run(pkg, ['install', env.TERMUX_APP_PACKAGE_MANAGER === 'pacman' ? '--noconfirm' : '-y', 'python-yt-dlp', 'yt-dlp-ejs', 'ffmpeg'], {
-      signal, status, env: { ...env, DEBIAN_FRONTEND: 'noninteractive' },
-    });
-  })();
-  try { await termuxInstall; }
-  catch (cause) {
-    signal?.throwIfAborted();
-    throw new Error(`Automatic Termux setup failed: ${cause.message}. Retry with veo doctor fix; if the repository needs repair, run pkg update in Termux.`, { cause });
-  } finally { termuxInstall = undefined; }
-}
-
-export function mediaPackagePlan(platform = process.platform, arch = process.arch) {
-  // Windows 11 ARM runs the upstream x64 media tools via OS emulation.
-  const binaryArch = platform === 'win32' && arch === 'arm64' ? 'x64' : arch;
-  const assets = MEDIA_ASSETS[`${platform}-${binaryArch}`];
-  return assets ? { binaryArch, ...assets } : undefined;
-}
-
-const DOWNLOAD_TIMEOUT_MS = 600_000;
-const MEDIA_ORIGINS = new Set(['https://github.com', 'https://release-assets.githubusercontent.com']);
-
-function validateAsset(asset) {
-  if (!asset || typeof asset.name !== 'string' || !/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(asset.name) || asset.name.includes('..')) {
-    throw new Error('Invalid media asset name.');
-  }
-  if (!Number.isSafeInteger(asset.size) || asset.size <= 0 || typeof asset.sha256 !== 'string' || !/^[a-f0-9]{64}$/.test(asset.sha256)) {
-    throw new Error(`Invalid pinned integrity metadata for ${asset.name}.`);
-  }
-}
-
-function integrityStream(asset) {
-  validateAsset(asset);
-  const hash = createHash('sha256');
-  let size = 0;
-  return new Transform({
-    transform(chunk, _encoding, callback) {
-      size += chunk.length;
-      if (size > asset.size) return callback(new Error(`Unexpected size for ${asset.name}: exceeds pinned byte count.`));
-      hash.update(chunk);
-      callback(null, chunk);
-    },
-    flush(callback) {
-      if (size !== asset.size) return callback(new Error(`Unexpected size for ${asset.name}: does not match pinned byte count.`));
-      if (hash.digest('hex') !== asset.sha256) return callback(new Error(`Integrity verification failed for ${asset.name}: SHA-256 mismatch.`));
-      callback();
-    },
-  });
-}
-
-function downloadUrl(value) {
-  const url = new URL(value);
-  if (!MEDIA_ORIGINS.has(url.origin) || url.username || url.password) throw new Error('Media download redirect must remain on an approved HTTPS origin.');
-  return url;
-}
-
-async function mediaResponse(url, { signal, fetchImpl }) {
-  let current = downloadUrl(url);
-  for (let redirects = 0; redirects <= 5; redirects++) {
-    signal.throwIfAborted();
-    const response = await fetchImpl(current.href, {
-      signal, redirect: 'manual', headers: { 'Accept-Encoding': 'identity' },
-    });
-    if ([301, 302, 303, 307, 308].includes(response.status)) {
-      await response.body?.cancel?.().catch(() => {});
-      const location = response.headers.get('location');
-      if (!location || redirects === 5) throw new Error('Media download has an invalid or excessive redirect.');
-      current = downloadUrl(new URL(location, current));
-      continue;
-    }
-    if (response.status !== 200) {
-      await response.body?.cancel?.().catch(() => {});
-      throw new Error(`Media download failed with HTTP ${response.status}.`);
-    }
-    if (!response.body) throw new Error('Media download response has no body.');
-    return response;
-  }
-  throw new Error('Media download has an excessive redirect.');
-}
-
-// This reusable primitive receives pinned metadata from its caller. Desktop
-// setup supplies only the release manifest shipped with veo, never env values.
-export async function downloadMediaAsset({
-  asset, release, destination, signal, fetchImpl = fetch, timeoutMs = DOWNLOAD_TIMEOUT_MS,
-}) {
-  validateAsset(asset);
-  if (!/^b\d+\.\d+(?:\.\d+)?$/.test(release)) throw new Error('Invalid pinned media release.');
-  if (!Number.isInteger(timeoutMs) || timeoutMs < 1 || timeoutMs > DOWNLOAD_TIMEOUT_MS) throw new Error('Invalid media download timeout.');
-  if (asset.gzip) validateAsset(asset.gzip);
-  signal?.throwIfAborted();
-  const deadline = new AbortController();
-  const timer = setTimeout(() => deadline.abort(new DOMException('Media download timed out.', 'TimeoutError')), timeoutMs);
-  const downloadSignal = AbortSignal.any([deadline.signal, ...(signal ? [signal] : [])]);
-  const transferAsset = asset.gzip || asset;
-  const compressed = asset.gzip ? `${destination}.gz` : undefined;
-  const transferDestination = compressed || destination;
-  let createdTransfer = false;
-  let createdDestination = false;
-  try {
-    const response = await mediaResponse(`${MEDIA_ASSET_BASE}/${release}/${transferAsset.name}`, { signal: downloadSignal, fetchImpl });
-    const length = response.headers.get('content-length');
-    if (length !== null && (!/^\d+$/.test(length) || Number(length) !== transferAsset.size)) {
-      await response.body.cancel?.().catch(() => {});
-      throw new Error(`Unexpected content length for ${transferAsset.name}: does not match pinned byte count.`);
-    }
-    const transfer = createWriteStream(transferDestination, { flags: 'wx', mode: 0o600 });
-    transfer.once('open', () => { createdTransfer = true; });
-    const body = typeof response.body.getReader === 'function' ? Readable.fromWeb(response.body) : Readable.from(response.body);
-    await pipeline(body, integrityStream(transferAsset), transfer, { signal: downloadSignal });
-    if (asset.gzip) {
-      const output = createWriteStream(destination, { flags: 'wx', mode: 0o600 });
-      output.once('open', () => { createdDestination = true; });
-      await pipeline(createReadStream(compressed), createGunzip(), integrityStream(asset), output, { signal: downloadSignal });
-    }
-    downloadSignal.throwIfAborted();
-    return destination;
-  } catch (error) {
-    if (createdDestination) await rm(destination, { force: true });
-    if (createdTransfer) await rm(transferDestination, { force: true });
-    downloadSignal.throwIfAborted();
-    throw error;
-  } finally {
-    clearTimeout(timer);
-    if (compressed && createdTransfer) await rm(compressed, { force: true });
-  }
-}
-
-async function verifyMediaFile(file, asset, signal) {
-  signal?.throwIfAborted();
-  const info = await lstat(file);
-  if (!info.isFile() || info.isSymbolicLink() || info.size !== asset.size) return false;
-  const handle = await open(file, constants.O_RDONLY | (constants.O_NOFOLLOW || 0));
-  try {
-    const opened = await handle.stat();
-    if (!opened.isFile() || opened.size !== asset.size || opened.dev !== info.dev || opened.ino !== info.ino) return false;
-    await pipeline(handle.createReadStream({ autoClose: false }), integrityStream(asset), new Writable({ write(_chunk, _encoding, callback) { callback(); } }), { signal });
-    const after = await lstat(file);
-    return after.isFile() && !after.isSymbolicLink() && after.dev === opened.dev && after.ino === opened.ino && after.size === opened.size && after.mtimeMs === opened.mtimeMs;
-  } finally {
-    await handle.close();
-  }
-}
-
-export async function verifiedMediaTools({ directory, platform = process.platform, arch = process.arch, signal }) {
-  const plan = mediaPackagePlan(platform, arch);
-  if (!plan) return false;
-  const suffix = platform === 'win32' ? '.exe' : '';
-  try {
-    for (const tool of ['ffmpeg', 'ffprobe']) {
-      if (!await verifyMediaFile(path.join(directory, `${tool}${suffix}`), plan[tool], signal)) return false;
-    }
-    return true;
-  } catch {
-    signal?.throwIfAborted();
-    return false;
-  }
-}
-
-export function mediaProbeEnvironment(env = process.env) {
-  // Native version probes do not need any uploader configuration or secrets.
-  return Object.fromEntries(Object.entries(env).filter(([name]) => !/^(?:SMOLUP|SMOP|SMUP)_/i.test(name)));
-}
-
-export async function installMediaTools({
-  directory, stage, signal, status = () => {}, platform = process.platform, arch = process.arch,
-  env = process.env, run = runSetup, fetchImpl = fetch,
-}) {
-  const plan = mediaPackagePlan(platform, arch);
-  if (!plan) throw new Error(`Automatic FFmpeg setup is unavailable for ${platform}/${arch}. Set VEO_FFMPEG_PATH to a directory containing ffmpeg and ffprobe.`);
-  signal?.throwIfAborted();
-  const setupSignal = AbortSignal.any([AbortSignal.timeout(DOWNLOAD_TIMEOUT_MS), ...(signal ? [signal] : [])]);
-  await mkdir(directory, { recursive: true, mode: 0o700 });
-  const temporary = await mkdtemp(path.join(directory, '.media-setup-'));
-  const suffix = platform === 'win32' ? '.exe' : '';
-  try {
-    if (process.platform !== 'win32') await chmod(temporary, 0o700);
-    status('Downloading FFmpeg and FFprobe into the veo cache (first use)…');
-    const files = {
-      license: path.join(temporary, 'FFmpeg.LICENSE'),
-      readme: path.join(temporary, 'FFmpeg.README'),
-      ffmpeg: path.join(temporary, `ffmpeg${suffix}`),
-      ffprobe: path.join(temporary, `ffprobe${suffix}`),
-    };
-    for (const name of ['license', 'readme', 'ffmpeg', 'ffprobe']) {
-      await downloadMediaAsset({ asset: plan[name], release: plan.release, destination: files[name], signal: setupSignal, fetchImpl });
-    }
-    // Verify the whole pair before either downloaded program may execute.
-    if (!await verifiedMediaTools({ directory: temporary, platform, arch, signal: setupSignal })) throw new Error('Downloaded media tools failed pinned integrity verification.');
-    for (const name of ['license', 'readme']) {
-      if (!await verifyMediaFile(files[name], plan[name], setupSignal)) throw new Error('Downloaded media notices failed pinned integrity verification.');
-    }
-    for (const name of ['ffmpeg', 'ffprobe']) {
-      if (process.platform !== 'win32') await chmod(files[name], 0o700);
-      await run(files[name], ['-version'], { signal: setupSignal, env: mediaProbeEnvironment(env), timeoutMs: 15_000 });
-    }
-    for (const name of ['ffmpeg', 'ffprobe', 'license', 'readme']) {
-      await stage(files[name], path.join(directory, path.basename(files[name])), setupSignal);
-    }
-    if (!await verifiedMediaTools({ directory, platform, arch, signal: setupSignal })) throw new Error('Staged media tools failed pinned integrity verification.');
-    for (const name of ['license', 'readme']) {
-      if (!await verifyMediaFile(path.join(directory, path.basename(files[name])), plan[name], setupSignal)) throw new Error('Staged media notices failed pinned integrity verification.');
-    }
-    setupSignal.throwIfAborted();
-    return directory;
-  } catch (cause) {
-    signal?.throwIfAborted();
-    throw new Error(`Automatic FFmpeg setup failed: ${cause.message}. Retry with veo doctor fix or set VEO_FFMPEG_PATH to installed tools.`, { cause });
-  } finally { await rm(temporary, { recursive: true, force: true }); }
-}

package/src/uninstall.js

@@ -1,222 +0,0 @@
-import path from 'node:path';
-import { spawn } from 'node:child_process';
-import { rm } from 'node:fs/promises';
-import { commandOutput } from './output.js';
-import { cacheBase } from './paths.js';
-import { configFile as resolveConfigFile } from './config.js';
-import { cleanText, readableError } from './utils.js';
-import { removeAlias, validateAliasName, listAliases } from './alias.js';
-
-const PACKAGE = 'veodl';
-
-export const UNINSTALL_HELP = `veo uninstall - remove veo completely or one command alias
-
-Usage:
-  veo uninstall [-p|--prefix <name>] [--json]
-                               Remove one alias (e.g. veo uninstall -p veodl)
-  veo uninstall [--yes] [--keep-cache] [--keep-config] [--keep-aliases] [--json]
-                               Remove everything: aliases, package, cache, config
-  veo uninstall --help         Show this help
-
-With -p/--prefix, only that alias is deleted; veo itself stays installed.
-Without -p, veo prints what would be removed. Add --yes to delete everything:
-custom wrappers created with veo alias add, the ${PACKAGE} package itself
-(commands veo, veodl) with npm, veo's cache directory (downloads, jobs,
-backend tools, history, statistics) and the config file. Use --keep-cache,
---keep-config or --keep-aliases to preserve one part. The config file is
-deleted by default; its path is shown before and after.
-`;
-
-export function npmUninstallCommand({ platform = process.platform } = {}) {
-  const args = ['uninstall', '-g', PACKAGE];
-  if (platform === 'win32') {
-    return {
-      command: 'cmd.exe',
-      args: ['/d', '/s', '/c', `npm ${args.join(' ')}`],
-      shell: false,
-      windowsVerbatimArguments: true,
-    };
-  }
-  return { command: 'npm', args, shell: false };
-}
-
-export function runNpmUninstall({ spawnImpl = spawn, platform = process.platform, signal, timeoutMs = 600_000 } = {}) {
-  const { command, args, ...spawnOptions } = npmUninstallCommand({ platform });
-  return new Promise((resolve, reject) => {
-    const child = spawnImpl(command, args, { ...spawnOptions, stdio: 'inherit', windowsHide: true, signal: signal ? AbortSignal.any([signal, AbortSignal.timeout(timeoutMs)]) : AbortSignal.timeout(timeoutMs) });
-    child.once('error', reject);
-    child.once('close', resolve);
-  });
-}
-
-function parseUninstallArgs(args) {
-  let prefix;
-  let yes = false;
-  let keepCache = false;
-  let keepConfig = false;
-  let keepAliases = false;
-  let json = false;
-  let binDir;
-  const rest = [];
-  for (let index = 0; index < args.length; index++) {
-    const token = args[index];
-    if (token === '-p' || token === '--prefix') {
-      prefix = args[++index];
-      if (!prefix) throw new Error('--prefix requires an alias name. Use: veo uninstall -p veodl');
-    } else if (token.startsWith('-p=')) {
-      prefix = token.slice(3) || undefined;
-      if (!prefix) throw new Error('--prefix requires an alias name. Use: veo uninstall -p veodl');
-    } else if (token.startsWith('--prefix=')) {
-      prefix = token.slice(9) || undefined;
-      if (!prefix) throw new Error('--prefix requires an alias name. Use: veo uninstall -p veodl');
-    } else if (token === '--yes') yes = true;
-    else if (token === '--purge') {
-      // Deprecated: full cleanup is now the default. Kept so older commands keep working.
-    } else if (token === '--keep-cache') keepCache = true;
-    else if (token === '--keep-config') keepConfig = true;
-    else if (token === '--keep-aliases') keepAliases = true;
-    else if (token === '--json') json = true;
-    else if (token === '--bin-dir') {
-      binDir = args[++index];
-      if (!binDir) throw new Error('--bin-dir requires a directory.');
-    } else if (token.startsWith('--bin-dir=')) {
-      binDir = token.slice(10) || undefined;
-      if (!binDir) throw new Error('--bin-dir requires a directory.');
-    } else rest.push(token);
-  }
-  return { prefix, yes, keepCache, keepConfig, keepAliases, json, binDir, rest };
-}
-
-export async function uninstallMain(args = [], {
-  stdout = process.stdout,
-  stderr = process.stderr,
-  platform = process.platform,
-  env = process.env,
-  spawnImpl = spawn,
-  rmImpl = rm,
-  cacheRoot,
-  configFile,
-  listImpl = listAliases,
-  removeImpl = removeAlias,
-} = {}) {
-  [args, stdout, stderr] = commandOutput(args, stdout, stderr);
-  const { prefix, yes, keepCache, keepConfig, keepAliases, json, binDir, rest } = parseUninstallArgs(args);
-  if (rest.includes('-h') || rest.includes('--help')) {
-    stdout.write(UNINSTALL_HELP);
-    return 0;
-  }
-  if (rest.length) throw new Error(`Unknown option for veo uninstall: ${rest.join(' ')}. Use: veo uninstall --help`);
-
-  if (prefix) {
-    if (keepCache || keepConfig || keepAliases) throw new Error('--keep-* cannot be combined with --prefix. Remove one alias or uninstall veo itself.');
-    const valid = validateAliasName(prefix);
-    const removed = await removeImpl(valid, { binDir, platform, env });
-    if (json) {
-      stdout.write(`${JSON.stringify({ status: 'removed', ...removed })}\n`);
-      return 0;
-    }
-    stdout.write(`Alias removed: ${removed.name} (${removed.removed.length} file(s) in ${removed.binDir})\n`);
-    if (removed.builtin) stdout.write('Note: veo update recreates the shipped veodl name.\n');
-    return 0;
-  }
-
-  const cache = cacheRoot || cacheBase({ platform, env });
-  const config = configFile || resolveConfigFile({ platform, env });
-  const manual = `npm uninstall -g ${PACKAGE}`;
-
-  // Custom wrappers first so the plan names them; npm removes veo/veodl itself.
-  let customAliases = [];
-  let aliasDir = binDir ? path.resolve(binDir) : null;
-  try {
-    const listed = await listImpl({ binDir: binDir || undefined, platform, env });
-    aliasDir = listed.binDir;
-    customAliases = listed.aliases.filter(entry => entry.present && entry.managed && !entry.builtin).map(entry => entry.name);
-  } catch {
-    // No bin directory (e.g. running from source without a global install):
-    // npm uninstall still works, alias cleanup is reported as skipped.
-  }
-
-  if (!yes) {
-    if (json) {
-      stdout.write(`${JSON.stringify({ status: 'planned', package: PACKAGE, manual, aliases: customAliases, binDir: aliasDir, cache, config })}\n`);
-      return 0;
-    }
-    stdout.write(`This removes everything: the ${PACKAGE} package with npm (commands veo, veodl).\n`);
-    if (!keepAliases) {
-      stdout.write(customAliases.length
-        ? `Custom wrappers to delete: ${customAliases.join(', ')} (${aliasDir})\n`
-        : `Custom wrappers: none found${aliasDir ? ` (${aliasDir})` : ''}.\n`);
-    }
-    if (!keepCache) stdout.write(`Cache to delete: ${cache}\n`);
-    if (!keepConfig) stdout.write(`Config to delete: ${config}\n`);
-    if (keepCache || keepConfig || keepAliases) {
-      const kept = [
-        keepAliases && 'aliases',
-        keepCache && 'cache',
-        keepConfig && 'config',
-      ].filter(Boolean).join(', ');
-      stdout.write(`Kept: ${kept}.\n`);
-    }
-    const keepFlags = `${keepAliases ? ' --keep-aliases' : ''}${keepCache ? ' --keep-cache' : ''}${keepConfig ? ' --keep-config' : ''}`;
-    stdout.write(`Run with --yes to proceed: veo uninstall --yes${keepFlags}\n`);
-    stdout.write(`Manual command: ${manual}\n`);
-    return 0;
-  }
-
-  let code;
-  try {
-    stdout.write(`Uninstalling ${PACKAGE} with npm…\n`);
-    code = await runNpmUninstall({ spawnImpl, platform, signal: AbortSignal.timeout(600_000) });
-  } catch (error) {
-    const reason = error.code === 'ENOENT' ? 'npm was not found. Install Node.js/npm, or uninstall manually.' : `Could not run npm: ${readableError(error)}`;
-    stderr.write(`veo: ${reason}\nManual command: ${manual}\n`);
-    return 1;
-  }
-  if (code !== 0) {
-    stderr.write(`veo: npm exited with code ${code}. Uninstall manually with: ${manual}\n`);
-    return 1;
-  }
-
-  const removedAliases = [];
-  if (!keepAliases) {
-    for (const name of customAliases) {
-      try {
-        await removeImpl(name, { binDir: aliasDir, platform, env });
-        removedAliases.push(name);
-      } catch (error) {
-        stderr.write(`veo: removed the package but could not delete alias ${name}: ${readableError(error)}\n`);
-        return 1;
-      }
-    }
-  }
-  let cacheDeleted = false;
-  if (!keepCache) {
-    try {
-      await rmImpl(cache, { recursive: true, force: true });
-      cacheDeleted = true;
-    } catch (error) {
-      stderr.write(`veo: removed the package but could not delete the cache ${cache}: ${readableError(error)}\n`);
-      return 1;
-    }
-  }
-  let configDeleted = false;
-  if (!keepConfig) {
-    try {
-      await rmImpl(config, { force: true });
-      configDeleted = true;
-    } catch (error) {
-      stderr.write(`veo: removed the package but could not delete the config ${config}: ${readableError(error)}\n`);
-      return 1;
-    }
-  }
-  if (json) {
-    stdout.write(`${JSON.stringify({ status: 'uninstalled', package: PACKAGE, aliases: removedAliases, binDir: aliasDir, cacheDeleted, cache, configDeleted, config })}\n`);
-    return 0;
-  }
-  stdout.write(`veo uninstalled (${PACKAGE}).`);
-  if (!keepAliases) stdout.write(removedAliases.length ? ` Aliases deleted: ${removedAliases.join(', ')}.` : ' No custom wrappers found.');
-  stdout.write(cacheDeleted ? ` Cache deleted: ${cache}.` : ` Cache kept: ${cache}.`);
-  stdout.write(configDeleted ? ` Config deleted: ${config}.` : ` Config kept: ${config}.`);
-  stdout.write('\n');
-  return 0;
-}