birdclaw 0.8.3 → 0.8.4

package/src/cli.ts

@@ -1,1616 +0,0 @@
-#!/usr/bin/env node
-import { spawn } from "node:child_process";
-import { readFileSync } from "node:fs";
-import { dirname } from "node:path";
-import process from "node:process";
-import { fileURLToPath, pathToFileURL } from "node:url";
-import { Command } from "commander";
-import { registerModerationCommands } from "#/cli-moderation";
-import { registerAnalysisCommands } from "#/cli/register-analysis";
-import { registerComposeCommands } from "#/cli/register-compose";
-import { registerGraphCommands } from "#/cli/register-graph";
-import { registerInboxCommand } from "#/cli/register-inbox";
-import { registerStorageCommands } from "#/cli/register-storage";
-import { findArchives } from "#/lib/archive-finder";
-import {
-	ARCHIVE_IMPORT_SLICES,
-	type ArchiveImportSlice,
-	type ImportProgressEvent,
-	type ImportProgressSlice,
-	type ImportWritePhase,
-	importArchive,
-} from "#/lib/archive-import";
-import {
-	AuthoredSyncError,
-	syncAuthoredTweets,
-	type AuthoredSyncMode,
-} from "#/lib/authored-live";
-import {
-	installAccountSyncLaunchAgent,
-	parseAccountSyncSteps,
-	runAccountSyncJob,
-} from "#/lib/account-sync-job";
-import { maybeAutoSyncBackup, maybeAutoUpdateBackup } from "#/lib/backup";
-import {
-	installBookmarkSyncLaunchAgent,
-	runBookmarkSyncJob,
-} from "#/lib/bookmark-sync-job";
-import { runDirectMessageRequestMutationViaBird } from "#/lib/bird";
-import { importBlocklist } from "#/lib/blocklist";
-import {
-	type ActionsTransport,
-	ensureBirdclawDirs,
-	resolveMentionsDataSource,
-	setActionsTransport,
-} from "#/lib/config";
-import { closeDatabase } from "#/lib/db";
-import {
-	type DirectMessagesSyncMode,
-	syncDirectMessagesViaCachedBird,
-} from "#/lib/dms-live";
-import { backfillLinkIndex, searchLinks } from "#/lib/link-index";
-import { fetchTweetMedia, formatMediaFetchResult } from "#/lib/media-fetch";
-import { syncMentionThreads } from "#/lib/mention-threads-live";
-import { exportMentionItems } from "#/lib/mentions-export";
-import {
-	exportMentionsViaCachedAuto,
-	exportMentionsViaCachedBird,
-	exportMentionsViaCachedXurl,
-	syncMentions,
-} from "#/lib/mentions-live";
-import { syncFollowGraph } from "#/lib/follow-graph";
-import { hydrateProfilesFromX } from "#/lib/profile-hydration";
-import { resolveProfilesForIds } from "#/lib/profile-resolver";
-import { inspectProfileReplies } from "#/lib/profile-replies";
-import {
-	applyDmRequestMutationToLocalStore,
-	getQueryEnvelope,
-	listDmConversations,
-	listTimelineItems,
-} from "#/lib/queries";
-import {
-	syncTimelineCollection,
-	type TimelineCollectionMode,
-} from "#/lib/timeline-collections-live";
-import { syncHomeTimeline } from "#/lib/timeline-live";
-import { expandUrlsFromTexts } from "#/lib/url-expansion";
-import { formatWhois, runWhois } from "#/lib/whois";
-
-const program = new Command();
-const packageRoot = dirname(dirname(fileURLToPath(import.meta.url)));
-const packageVersion = JSON.parse(
-	readFileSync(new URL("../package.json", import.meta.url), "utf8"),
-) as { version?: string };
-
-function print(data: unknown, asJson: boolean) {
-	if (asJson) {
-		console.log(JSON.stringify(data, null, 2));
-		return;
-	}
-	console.log(data);
-}
-
-function printError(error: string) {
-	console.error(JSON.stringify({ error }));
-}
-
-function errorMessage(error: unknown) {
-	return error instanceof Error ? error.message : String(error);
-}
-
-const IMPORT_SLICE_LABELS: Record<ImportProgressSlice, string> = {
-	tweets: "tweets",
-	noteTweets: "note tweets",
-	directMessages: "direct messages",
-	likes: "likes",
-	bookmarks: "bookmarks",
-	media: "media files",
-	followers: "followers",
-	following: "following",
-};
-
-const IMPORT_WRITE_LABELS: Record<ImportWritePhase, string> = {
-	profiles: "profiles",
-	tweets: "tweets",
-	collections: "likes+bookmarks",
-	dmMessages: "DM messages",
-};
-
-function logImportProgress(event: ImportProgressEvent) {
-	switch (event.kind) {
-		case "scanned":
-			process.stderr.write(
-				`Scanning archive… ${String(event.entryCount)} entries\n`,
-			);
-			return;
-		case "slice-start":
-			if (event.slice === "media") {
-				process.stderr.write("Indexing media files…\n");
-				return;
-			}
-			process.stderr.write(
-				`Parsing ${IMPORT_SLICE_LABELS[event.slice]}… (${String(event.files)} file${event.files === 1 ? "" : "s"})\n`,
-			);
-			return;
-		case "slice-file":
-			if (event.files > 1) {
-				process.stderr.write(
-					`  ${IMPORT_SLICE_LABELS[event.slice]} ${String(event.processed)}/${String(event.files)}\n`,
-				);
-			}
-			return;
-		case "slice-done":
-			process.stderr.write(
-				`  ${IMPORT_SLICE_LABELS[event.slice]}: ${event.count.toLocaleString()}\n`,
-			);
-			return;
-		case "writing":
-			process.stderr.write("Writing to database…\n");
-			return;
-		case "write-start":
-			process.stderr.write(
-				`Writing ${IMPORT_WRITE_LABELS[event.phase]}… (${event.total.toLocaleString()})\n`,
-			);
-			return;
-		case "write-progress":
-			process.stderr.write(
-				`  ${IMPORT_WRITE_LABELS[event.phase]} ${event.processed.toLocaleString()}/${event.total.toLocaleString()}\n`,
-			);
-			return;
-		case "done":
-			process.stderr.write("Import complete.\n");
-			return;
-	}
-}
-
-function formatLinkSearchItems(items: ReturnType<typeof searchLinks>) {
-	return items
-		.map((item) => {
-			const linked = item.linkedTweet
-				? ` -> @${item.linkedTweet.author.handle}/${item.linkedTweet.id}: ${item.linkedTweet.text}`
-				: ` -> ${item.expansion.finalUrl}`;
-			const source =
-				item.occurrence.sourceKind === "dm"
-					? `dm ${item.occurrence.direction ?? ""}`.trim()
-					: "tweet";
-			const participant = item.participant
-				? ` @${item.participant.handle}`
-				: "";
-			return `${item.occurrence.createdAt} ${source}${participant}: ${item.occurrence.shortUrl}${linked}`;
-		})
-		.join("\n");
-}
-
-function parseNonNegativeIntegerOption(
-	value: string | undefined,
-	option: string,
-) {
-	if (value === undefined) {
-		return undefined;
-	}
-
-	const trimmed = value.trim();
-	if (!/^\d+$/.test(trimmed)) {
-		printError(`${option} must be a non-negative integer`);
-		process.exitCode = 1;
-		return undefined;
-	}
-
-	const parsed = Number.parseInt(trimmed, 10);
-	if (!Number.isSafeInteger(parsed)) {
-		printError(`${option} must be a non-negative integer`);
-		process.exitCode = 1;
-		return undefined;
-	}
-
-	return parsed;
-}
-
-function parsePositiveIntegerOption(value: string | undefined, option: string) {
-	const parsed = parseNonNegativeIntegerOption(value, option);
-	if (parsed === undefined) {
-		return undefined;
-	}
-	if (parsed < 1) {
-		printError(`${option} must be at least 1`);
-		process.exitCode = 1;
-		return undefined;
-	}
-	return parsed;
-}
-
-function parseDmInboxOption(
-	value: string | undefined,
-): "all" | "accepted" | "requests" | undefined {
-	const normalized = (value ?? "all").trim().toLowerCase();
-	if (
-		normalized === "all" ||
-		normalized === "accepted" ||
-		normalized === "requests"
-	) {
-		return normalized;
-	}
-	if (normalized === "request") {
-		return "requests";
-	}
-	printError("--inbox must be all, accepted, or requests");
-	process.exitCode = 1;
-	return undefined;
-}
-
-function parseDmSyncModeOption(
-	value: string | undefined,
-): DirectMessagesSyncMode | undefined {
-	const normalized = (value ?? "bird").trim().toLowerCase();
-	if (normalized === "auto" || normalized === "bird" || normalized === "xurl") {
-		return normalized;
-	}
-	printError("--mode must be auto, bird, or xurl");
-	process.exitCode = 1;
-	return undefined;
-}
-
-function parseArchiveImportSelect(value: string | undefined) {
-	if (value === undefined) {
-		return undefined;
-	}
-
-	const aliases: Record<string, ArchiveImportSlice> = Object.assign(
-		Object.create(null) as Record<string, ArchiveImportSlice>,
-		{
-			tweets: "tweets",
-			likes: "likes",
-			bookmarks: "bookmarks",
-			directmessages: "directMessages",
-			"direct-messages": "directMessages",
-			dms: "directMessages",
-			profiles: "profiles",
-			followers: "followers",
-			following: "following",
-		},
-	);
-	const selected: ArchiveImportSlice[] = [];
-	const seen = new Set<ArchiveImportSlice>();
-	for (const rawItem of value.split(",")) {
-		const item = rawItem.trim();
-		if (!item) continue;
-		const slice = aliases[item] ?? aliases[item.toLowerCase()];
-		if (!slice) {
-			printError(
-				`--select must be a comma-separated subset of ${ARCHIVE_IMPORT_SLICES.join(", ")}`,
-			);
-			process.exitCode = 1;
-			return undefined;
-		}
-		if (!seen.has(slice)) {
-			seen.add(slice);
-			selected.push(slice);
-		}
-	}
-
-	if (selected.length === 0) {
-		printError(
-			`--select must include at least one of ${ARCHIVE_IMPORT_SLICES.join(", ")}`,
-		);
-		process.exitCode = 1;
-		return undefined;
-	}
-
-	return selected;
-}
-
-function resolveActionOptions(options: { transport?: string }) {
-	return {
-		transport: options.transport as ActionsTransport | undefined,
-	};
-}
-
-function parseActionsTransport(value: string | undefined) {
-	const normalized = value?.trim().toLowerCase();
-	if (normalized === "auto" || normalized === "bird" || normalized === "xurl") {
-		return normalized;
-	}
-	printError("transport must be auto, bird, or xurl");
-	process.exitCode = 1;
-	return undefined;
-}
-
-async function enrichDmItems(
-	query: Parameters<typeof listDmConversations>[0],
-	options: {
-		resolveProfiles?: boolean;
-		expandUrls?: boolean;
-		refreshProfileCache?: boolean;
-		refreshUrlCache?: boolean;
-		xurlFallback?: boolean;
-	},
-) {
-	let items = listDmConversations(query);
-	const profileResolution = options.resolveProfiles
-		? await resolveProfilesForIds(
-				items.map((item) => item.participant.id),
-				{
-					refresh: options.refreshProfileCache,
-					xurlFallback: options.xurlFallback ?? true,
-				},
-			)
-		: undefined;
-	if (profileResolution) {
-		items = listDmConversations(query);
-	}
-
-	const urlExpansions = options.expandUrls
-		? await expandUrlsFromTexts(
-				items.flatMap((item) => [
-					item.lastMessagePreview,
-					item.searchSnippet ?? "",
-					...(item.matches ?? []).flatMap((match) => [
-						...match.before.map((message) => message.text),
-						match.message.text,
-						...match.after.map((message) => message.text),
-					]),
-				]),
-				{ refresh: options.refreshUrlCache },
-			)
-		: undefined;
-
-	if (!profileResolution && !urlExpansions) {
-		return items;
-	}
-
-	return {
-		items,
-		...(profileResolution ? { profileResolution } : {}),
-		...(urlExpansions ? { urlExpansions } : {}),
-	};
-}
-
-async function autoUpdateBeforeRead() {
-	let result: Awaited<ReturnType<typeof maybeAutoUpdateBackup>>;
-	try {
-		result = await maybeAutoUpdateBackup();
-	} catch (error) {
-		const message = error instanceof Error ? error.message : String(error);
-		console.error(`birdclaw backup auto-sync failed: ${message}`);
-		return;
-	}
-	if (!result.ok) {
-		console.error(`birdclaw backup auto-sync failed: ${result.error}`);
-	}
-}
-
-async function autoSyncAfterWrite() {
-	let result: Awaited<ReturnType<typeof maybeAutoSyncBackup>>;
-	try {
-		result = await maybeAutoSyncBackup();
-	} catch (error) {
-		const message = error instanceof Error ? error.message : String(error);
-		console.error(`birdclaw backup sync failed: ${message}`);
-		return;
-	}
-	if (!result.ok) {
-		console.error(`birdclaw backup sync failed: ${result.error}`);
-	}
-}
-
-program
-	.name("birdclaw")
-	.description("Local-first Twitter workspace")
-	.version(packageVersion.version ?? "0.0.0")
-	.option("--json", "Emit JSON output");
-
-program
-	.command("init")
-	.description("Create local birdclaw root and seed the database")
-	.action(async () => {
-		const paths = ensureBirdclawDirs();
-		await getQueryEnvelope();
-		print(
-			{
-				ok: true,
-				rootDir: paths.rootDir,
-				configPath: paths.configPath,
-				dbPath: paths.dbPath,
-				mediaOriginalsDir: paths.mediaOriginalsDir,
-				mediaThumbsDir: paths.mediaThumbsDir,
-			},
-			program.opts().json ?? false,
-		);
-	});
-
-const authCommand = program
-	.command("auth")
-	.description("Manage live transport");
-
-authCommand
-	.command("status")
-	.description("Show transport status")
-	.action(async () => {
-		const meta = await getQueryEnvelope();
-		print(meta.transport, program.opts().json ?? false);
-	});
-
-authCommand
-	.command("use <transport>")
-	.description("Set preferred moderation action transport")
-	.action((transport: string) => {
-		const parsed = parseActionsTransport(transport);
-		if (!parsed) return;
-		print(setActionsTransport(parsed), program.opts().json ?? false);
-	});
-
-program
-	.command("archive find")
-	.description("Find likely Twitter archives on disk")
-	.action(async () => {
-		const items = await findArchives();
-		print(items, program.opts().json ?? false);
-	});
-
-const importCommand = program
-	.command("import")
-	.description("Import local archive data");
-
-importCommand
-	.command("archive [archivePath]")
-	.description("Import a Twitter archive into the local SQLite store")
-	.option(
-		"--select <kinds>",
-		`Import only selected archive slices: ${ARCHIVE_IMPORT_SLICES.join(", ")}`,
-	)
-	.action(async (archivePath, options: { select?: string }) => {
-		const select = parseArchiveImportSelect(options.select);
-		if (options.select !== undefined && !select) {
-			return;
-		}
-		let resolvedArchivePath = archivePath;
-		if (!resolvedArchivePath) {
-			const [latestArchive] = await findArchives();
-			resolvedArchivePath = latestArchive?.path;
-		}
-
-		if (!resolvedArchivePath) {
-			throw new Error(
-				"No archive found. Pass a path or place one in Downloads.",
-			);
-		}
-
-		const asJson = Boolean(program.opts().json);
-		const result = await importArchive(resolvedArchivePath, {
-			select,
-			onProgress: asJson ? undefined : logImportProgress,
-		});
-		await autoSyncAfterWrite();
-		print(result, asJson);
-	});
-
-importCommand
-	.command("hydrate-profiles")
-	.description("Backfill archive-imported profiles from live Twitter metadata")
-	.action(async () => {
-		const result = await hydrateProfilesFromX();
-		await autoSyncAfterWrite();
-		print(result, program.opts().json ?? false);
-	});
-
-const searchCommand = program
-	.command("search")
-	.description("Search local data");
-
-searchCommand
-	.command("tweets [query]")
-	.option("--resource <resource>", "home, mentions, or authored", "home")
-	.option("--replied", "Only replied items")
-	.option("--unreplied", "Only unreplied items")
-	.option("--since <date>", "Include tweets created at or after this date")
-	.option("--until <date>", "Include tweets created before this date")
-	.option("--originals-only", "Exclude authored replies that start with @")
-	.option("--hide-low-quality", "Hide RTs, tiny replies, and link-only noise")
-	.option(
-		"--min-likes <n>",
-		"Override the low-quality like threshold (default 50)",
-	)
-	.option("--quality-reason", "Include qualityReason on each row")
-	.option("--liked", "Only liked tweets")
-	.option("--bookmarked", "Only bookmarked tweets")
-	.option("--limit <n>", "Limit results", "20")
-	.action(async (query, options) => {
-		const minLikes = parseNonNegativeIntegerOption(
-			options.minLikes,
-			"--min-likes",
-		);
-		if (options.minLikes !== undefined && minLikes === undefined) {
-			return;
-		}
-
-		await autoUpdateBeforeRead();
-		const replyFilter = options.replied
-			? "replied"
-			: options.unreplied
-				? "unreplied"
-				: "all";
-		const items = listTimelineItems({
-			resource:
-				options.resource === "mentions"
-					? "mentions"
-					: options.resource === "authored"
-						? "authored"
-						: "home",
-			search: query,
-			replyFilter,
-			since: options.since,
-			until: options.until,
-			includeReplies: !options.originalsOnly,
-			qualityFilter: options.hideLowQuality ? "summary" : "all",
-			lowQualityThreshold: minLikes,
-			includeQualityReason: Boolean(options.qualityReason),
-			likedOnly: Boolean(options.liked),
-			bookmarkedOnly: Boolean(options.bookmarked),
-			limit: Number(options.limit),
-		});
-		print(items, program.opts().json ?? false);
-	});
-
-searchCommand
-	.command("dms <query>")
-	.option("--inbox <kind>", "all, accepted, or requests", "all")
-	.option("--participant <value>")
-	.option("--min-followers <n>", "Minimum sender follower count")
-	.option("--max-followers <n>", "Maximum sender follower count")
-	.option("--min-influence-score <n>", "Minimum derived influence score")
-	.option("--max-influence-score <n>", "Maximum derived influence score")
-	.option("--sort <mode>", "recent or followers", "recent")
-	.option(
-		"--context <n>",
-		"Include N messages before and after each match",
-		"0",
-	)
-	.option(
-		"--resolve-profiles",
-		"Resolve placeholder DM profiles through cache/bird/xurl",
-	)
-	.option("--expand-urls", "Expand URLs through the persistent URL cache")
-	.option("--refresh-profile-cache", "Bypass profile lookup cache")
-	.option("--refresh-url-cache", "Bypass URL expansion cache")
-	.option(
-		"--no-xurl-fallback",
-		"Do not fall back to xurl after bird profile lookup",
-	)
-	.option("--replied", "Only replied threads")
-	.option("--unreplied", "Only unreplied threads")
-	.option("--limit <n>", "Limit results", "20")
-	.action(async (query, options) => {
-		await autoUpdateBeforeRead();
-		const context = parseNonNegativeIntegerOption(options.context, "--context");
-		if (context === undefined) {
-			return;
-		}
-		const inbox = parseDmInboxOption(options.inbox);
-		if (inbox === undefined) {
-			return;
-		}
-		const replyFilter = options.replied
-			? "replied"
-			: options.unreplied
-				? "unreplied"
-				: "all";
-		const dmQuery = {
-			search: query,
-			...(inbox !== "all" ? { inbox } : {}),
-			participant: options.participant,
-			minFollowers: options.minFollowers
-				? Number(options.minFollowers)
-				: undefined,
-			maxFollowers: options.maxFollowers
-				? Number(options.maxFollowers)
-				: undefined,
-			minInfluenceScore: options.minInfluenceScore
-				? Number(options.minInfluenceScore)
-				: undefined,
-			maxInfluenceScore: options.maxInfluenceScore
-				? Number(options.maxInfluenceScore)
-				: undefined,
-			sort:
-				options.sort === "followers" || options.sort === "influence"
-					? "followers"
-					: "recent",
-			replyFilter,
-			context,
-			limit: Number(options.limit),
-		} as const;
-		const items = await enrichDmItems(dmQuery, {
-			resolveProfiles: Boolean(options.resolveProfiles),
-			expandUrls: Boolean(options.expandUrls),
-			refreshProfileCache: Boolean(options.refreshProfileCache),
-			refreshUrlCache: Boolean(options.refreshUrlCache),
-			xurlFallback: options.xurlFallback,
-		});
-		print(items, program.opts().json ?? false);
-	});
-
-searchCommand
-	.command("links <query>")
-	.description("Search indexed short links, expansions, and linked tweets")
-	.option("--account <accountIdOrHandle>", "Account id or handle")
-	.option("--since <date>", "Include links created at or after this date")
-	.option("--until <date>", "Include links created before this date")
-	.option("--source <kind>", "dm or tweet")
-	.option("--direction <direction>", "inbound or outbound")
-	.option("--participant <value>", "DM participant handle or name")
-	.option("--media <type>", "image, video, or gif")
-	.option("--limit <n>", "Limit results", "20")
-	.action(async (query, options) => {
-		await autoUpdateBeforeRead();
-		const items = searchLinks(query, {
-			account: options.account,
-			since: options.since,
-			until: options.until,
-			source:
-				options.source === "tweet"
-					? "tweet"
-					: options.source === "dm"
-						? "dm"
-						: undefined,
-			direction:
-				options.direction === "inbound"
-					? "inbound"
-					: options.direction === "outbound"
-						? "outbound"
-						: undefined,
-			participant: options.participant,
-			mediaType:
-				options.media === "image" ||
-				options.media === "video" ||
-				options.media === "gif"
-					? options.media
-					: undefined,
-			limit: Number(options.limit),
-		});
-		if (program.opts().json) {
-			print(items, true);
-			return;
-		}
-		console.log(formatLinkSearchItems(items));
-	});
-
-const linksCommand = program
-	.command("links")
-	.description("Build and inspect the short-link index");
-
-linksCommand
-	.command("backfill")
-	.description("Backfill indexed URL occurrences and t.co expansions")
-	.option("--all-urls", "Index all URLs, not only t.co")
-	.option("--source <kind>", "dm or tweet")
-	.option("--refresh-url-cache", "Re-expand URLs already in the index")
-	.option("--limit <n>", "Limit network/cache expansions for this run")
-	.option("--concurrency <n>", "Concurrent URL expansion workers", "12")
-	.option("--timeout-ms <n>", "Per-redirect fetch timeout", "15000")
-	.action(async (options) => {
-		const limit = parseNonNegativeIntegerOption(options.limit, "--limit");
-		if (options.limit !== undefined && limit === undefined) {
-			return;
-		}
-		const concurrency = parseNonNegativeIntegerOption(
-			options.concurrency,
-			"--concurrency",
-		);
-		if (concurrency === undefined) {
-			return;
-		}
-		const timeoutMs = parseNonNegativeIntegerOption(
-			options.timeoutMs,
-			"--timeout-ms",
-		);
-		if (timeoutMs === undefined) {
-			return;
-		}
-		const result = await backfillLinkIndex({
-			includeAllUrls: Boolean(options.allUrls),
-			refresh: Boolean(options.refreshUrlCache),
-			source:
-				options.source === "tweet"
-					? "tweet"
-					: options.source === "dm"
-						? "dm"
-						: undefined,
-			limit,
-			concurrency,
-			timeoutMs,
-		});
-		await autoSyncAfterWrite();
-		print(result, program.opts().json ?? false);
-	});
-
-const mediaCommand = program
-	.command("media")
-	.description("Manage the local media cache");
-
-mediaCommand
-	.command("fetch")
-	.description(
-		"Fetch missing pbs.twimg.com image media already stored in tweets",
-	)
-	.option("--account <accountId>", "Account id")
-	.option("--limit <n>", "Stop after N tweets processed")
-	.option(
-		"--kind <kind>",
-		"Tweet or collection kind, e.g. home, like, bookmark",
-	)
-	.option("--since <isoDate>", "Only tweets created at or after this date")
-	.option("--parallel <n>", "Concurrent fetch workers, capped at 5", "1")
-	.option("--pacing-ms <n>", "Delay between request starts", "250")
-	.option("--video-pacing-ms <n>", "Delay between video request starts")
-	.option("--retry-max <n>", "Retries per file after rate limiting", "3")
-	.option("--include-video", "Include video and animated GIF media", true)
-	.option("--no-include-video", "Skip video and animated GIF media")
-	.option("--max-bytes <n>", "Maximum media file size in bytes", "104857600")
-	.option("--dry-run", "List what would be fetched without downloading")
-	.option("--json", "Emit JSON output")
-	.action(async (options) => {
-		const limit = parseNonNegativeIntegerOption(options.limit, "--limit");
-		if (options.limit !== undefined && limit === undefined) {
-			return;
-		}
-		const parallel =
-			parsePositiveIntegerOption(options.parallel, "--parallel") ?? 1;
-		const pacingMs =
-			parseNonNegativeIntegerOption(options.pacingMs, "--pacing-ms") ?? 250;
-		const retryMax =
-			parseNonNegativeIntegerOption(options.retryMax, "--retry-max") ?? 3;
-		const videoPacingMs =
-			options.videoPacingMs === undefined
-				? undefined
-				: parseNonNegativeIntegerOption(
-						options.videoPacingMs,
-						"--video-pacing-ms",
-					);
-		const maxBytes =
-			parseNonNegativeIntegerOption(options.maxBytes, "--max-bytes") ??
-			100 * 1024 * 1024;
-		if (process.exitCode) {
-			return;
-		}
-
-		const result = await fetchTweetMedia({
-			account: options.account,
-			limit,
-			kind: options.kind,
-			since: options.since,
-			parallel,
-			pacingMs,
-			videoPacingMs,
-			retryMax,
-			includeVideo: Boolean(options.includeVideo),
-			maxBytes,
-			dryRun: Boolean(options.dryRun),
-		});
-		const asJson = Boolean(program.opts().json || options.json);
-		print(asJson ? result : formatMediaFetchResult(result), asJson);
-	});
-
-program
-	.command("whois <query>")
-	.description("Identify likely people or orgs from local DMs and tweets")
-	.option("--account <accountId>", "Account id")
-	.option("--no-dms", "Do not search DMs")
-	.option("--tweets", "Include local tweet search evidence")
-	.option("--no-resolve-profiles", "Do not resolve placeholder profiles")
-	.option("--no-expand-urls", "Do not expand URLs")
-	.option("--refresh-profile-cache", "Bypass profile lookup cache")
-	.option("--refresh-url-cache", "Bypass URL expansion cache")
-	.option(
-		"--no-xurl-fallback",
-		"Do not fall back to xurl after bird profile lookup",
-	)
-	.option(
-		"--affiliation <query>",
-		"Require affiliation, bio, or history evidence",
-	)
-	.option(
-		"--current-affiliation <query>",
-		"Require an active affiliation badge",
-	)
-	.option(
-		"--exclude-domain-only",
-		"Drop candidates that only match domains/URLs",
-	)
-	.option("--context <n>", "DM messages before and after each match", "4")
-	.option("--limit <n>", "Limit candidates", "10")
-	.action(async (query, options) => {
-		await autoUpdateBeforeRead();
-		const context = parseNonNegativeIntegerOption(options.context, "--context");
-		if (context === undefined) {
-			return;
-		}
-		const result = await runWhois(query, {
-			account: options.account,
-			dms: options.dms,
-			tweets: Boolean(options.tweets),
-			resolveProfiles: options.resolveProfiles,
-			expandUrls: options.expandUrls,
-			refreshProfileCache: Boolean(options.refreshProfileCache),
-			refreshUrlCache: Boolean(options.refreshUrlCache),
-			xurlFallback: options.xurlFallback,
-			affiliation: options.affiliation,
-			currentAffiliation: options.currentAffiliation,
-			excludeDomainOnly: Boolean(options.excludeDomainOnly),
-			context,
-			limit: Number(options.limit),
-		});
-		print(
-			program.opts().json ? result : formatWhois(result),
-			program.opts().json ?? false,
-		);
-	});
-
-registerAnalysisCommands({
-	program,
-	print,
-	asJson: () => program.opts().json ?? false,
-	autoSyncAfterWrite,
-	autoUpdateBeforeRead,
-	parseNonNegativeIntegerOption,
-	parsePositiveIntegerOption,
-});
-
-const mentionsCommand = program
-	.command("mentions")
-	.description("Export local mention tweets for scripts and agents");
-
-mentionsCommand
-	.command("export [query]")
-	.description("Return mention tweets with plain-text and markdown renderings")
-	.option("--account <accountId>", "Account id")
-	.option("--mode <mode>", "birdclaw, auto, xurl, or bird")
-	.option("--replied", "Only replied items")
-	.option("--unreplied", "Only unreplied items")
-	.option("--refresh", "Refresh the live xurl cache before returning")
-	.option("--cache-ttl <seconds>", "Live-cache freshness window", "120")
-	.option("--all", "Fetch every retrievable xurl mentions page")
-	.option(
-		"--max-pages <n>",
-		"Maximum xurl mention pages to fetch (implies --all)",
-	)
-	.option("--limit <n>", "Limit results", "20")
-	.action(async (query, options) => {
-		await autoUpdateBeforeRead();
-		const replyFilter = options.replied
-			? "replied"
-			: options.unreplied
-				? "unreplied"
-				: "all";
-		const limit = Number(options.limit);
-		const mode = resolveMentionsDataSource(options.mode);
-		if (mode === "xurl" || mode === "bird" || mode === "auto") {
-			const exportFn =
-				mode === "xurl"
-					? exportMentionsViaCachedXurl
-					: mode === "bird"
-						? exportMentionsViaCachedBird
-						: exportMentionsViaCachedAuto;
-			const payload = await exportFn({
-				account: options.account,
-				search: query,
-				replyFilter,
-				limit,
-				all: Boolean(options.all) || options.maxPages !== undefined,
-				maxPages: options.maxPages ? Number(options.maxPages) : undefined,
-				refresh: Boolean(options.refresh),
-				cacheTtlMs: Number(options.cacheTtl) * 1000,
-			});
-			await autoSyncAfterWrite();
-			print(payload, true);
-			return;
-		}
-
-		const items = exportMentionItems({
-			account: options.account,
-			search: query,
-			replyFilter,
-			limit,
-		});
-		print({ resource: "mentions", count: items.length, items }, true);
-	});
-
-const profilesCommand = program
-	.command("profiles")
-	.description("Inspect live profile context for moderation and triage");
-
-profilesCommand
-	.command("replies <query>")
-	.description("Inspect recent authored replies for one profile")
-	.option("--limit <n>", "Limit replies", "12")
-	.action(async (query, options) => {
-		const result = await inspectProfileReplies(query, {
-			limit: Number(options.limit),
-		});
-		print(result, program.opts().json ?? false);
-	});
-
-const dmsCommand = program.command("dms").description("Direct messages");
-
-const syncCommand = program
-	.command("sync")
-	.description("Refresh live Twitter collections into the local store");
-
-syncCommand
-	.command("timeline")
-	.description("Refresh live home timeline through xurl or bird")
-	.option("--account <accountId>", "Account id")
-	.option("--mode <mode>", "auto, xurl, or bird", "auto")
-	.option("--limit <n>", "Result limit", "100")
-	.option("--max-pages <n>", "Stop after N xurl pages", "3")
-	.option("--for-you", 'Fetch "For You" instead of chronological Following')
-	.option("--cache-ttl <seconds>", "Live-cache freshness window", "120")
-	.option("--refresh", "Bypass live-cache freshness window")
-	.action(async (options) => {
-		const result = await syncHomeTimeline({
-			account: options.account,
-			mode: options.mode,
-			limit: Number(options.limit),
-			maxPages: Number(options.maxPages),
-			following: !options.forYou,
-			refresh: Boolean(options.refresh),
-			cacheTtlMs: Number(options.cacheTtl) * 1000,
-		});
-		await autoSyncAfterWrite();
-		print(result, true);
-	});
-
-syncCommand
-	.command("mentions")
-	.description("Refresh live mentions through xurl or bird")
-	.option("--account <accountId>", "Account id")
-	.option("--mode <mode>", "auto, bird, or xurl", "auto")
-	.option("--limit <n>", "Result limit per page", "20")
-	.option("--max-pages <n>", "Stop after N pages")
-	.option("--since-id <id>", "Fetch mentions newer than this tweet id")
-	.option("--start-time <iso>", "Fetch mentions created at or after this time")
-	.option("--refresh", "Bypass live-cache freshness window")
-	.option("--cache-ttl <seconds>", "Live-cache freshness window", "120")
-	.action(async (options) => {
-		try {
-			const result = await syncMentions({
-				account: options.account,
-				mode: options.mode,
-				limit: Number(options.limit),
-				maxPages: options.maxPages ? Number(options.maxPages) : undefined,
-				sinceId: options.sinceId,
-				startTime: options.startTime,
-				refresh: Boolean(options.refresh),
-				cacheTtlMs: Number(options.cacheTtl) * 1000,
-			});
-			await autoSyncAfterWrite();
-			print(result, true);
-			if (result.partial) {
-				process.exitCode = 5;
-			}
-		} catch (error) {
-			print(
-				{
-					ok: false,
-					kind: "mentions",
-					mode: options.mode ?? "xurl",
-					error: errorMessage(error),
-				},
-				true,
-			);
-			process.exitCode = 1;
-		}
-	});
-
-syncCommand
-	.command("authored")
-	.description("Refresh authenticated authored tweets through xurl")
-	.option("--account <accountId>", "Account id")
-	.option("--mode <mode>", "xurl", "xurl")
-	.option("--limit <n>", "X API page size", "100")
-	.option("--max-pages <n>", "Stop after N pages and resume later")
-	.option("--since-id <tweetId>", "Override the stored since_id cursor")
-	.option(
-		"--until-id <tweetId>",
-		"Fetch tweets older than this id without moving the cursor",
-	)
-	.action(async (options) => {
-		try {
-			const result = await syncAuthoredTweets({
-				account: options.account,
-				mode: options.mode as AuthoredSyncMode,
-				limit: Number(options.limit),
-				maxPages: options.maxPages ? Number(options.maxPages) : undefined,
-				sinceId: options.sinceId,
-				untilId: options.untilId,
-			});
-			await autoSyncAfterWrite();
-			print(result, true);
-			if (result.partial) {
-				process.exitCode = 5;
-			}
-		} catch (error) {
-			print(
-				{
-					ok: false,
-					kind: "authored",
-					source: "xurl",
-					error: errorMessage(error),
-				},
-				true,
-			);
-			process.exitCode =
-				error instanceof AuthoredSyncError ? error.exitCode : 1;
-		}
-	});
-
-syncCommand
-	.command("mention-threads")
-	.description(
-		"Fetch tweet conversation context for recent mentions through bird or xurl",
-	)
-	.option("--account <accountId>", "Account id")
-	.option("--mode <mode>", "bird or xurl", "bird")
-	.option("--limit <n>", "Recent mentions to inspect", "30")
-	.option("--delay-ms <n>", "Delay between thread fetches", "1500")
-	.option("--timeout-ms <n>", "Per-thread timeout", "15000")
-	.option("--all", "Fetch all retrievable thread pages")
-	.option("--max-pages <n>", "Stop after N pages")
-	.action(async (options) => {
-		try {
-			const result = await syncMentionThreads({
-				account: options.account,
-				mode: options.mode,
-				limit: Number(options.limit),
-				delayMs: Number(options.delayMs),
-				timeoutMs: Number(options.timeoutMs),
-				all: Boolean(options.all),
-				maxPages: options.maxPages ? Number(options.maxPages) : undefined,
-			});
-			await autoSyncAfterWrite();
-			print(result, true);
-			if (result.partial) {
-				process.exitCode = 5;
-			}
-		} catch (error) {
-			print(
-				{
-					ok: false,
-					kind: "mention-threads",
-					mode: options.mode ?? "bird",
-					error: errorMessage(error),
-				},
-				true,
-			);
-			process.exitCode = 1;
-		}
-	});
-
-for (const kind of ["likes", "bookmarks"] as const) {
-	syncCommand
-		.command(kind)
-		.description(`Refresh live ${kind} through xurl or bird`)
-		.option("--account <accountId>", "Account id")
-		.option("--mode <mode>", "auto, xurl, or bird", "auto")
-		.option("--limit <n>", "Per-page/result limit", "20")
-		.option("--all", "Fetch every retrievable page")
-		.option(
-			"--max-pages <n>",
-			"Stop after N pages when using --all or --early-stop",
-		)
-		.option("--early-stop", "Stop when a fetched page is already fully local")
-		.option("--cache-ttl <seconds>", "Live-cache freshness window", "120")
-		.option("--refresh", "Bypass live-cache freshness window")
-		.action(async (options) => {
-			const result = await syncTimelineCollection({
-				kind,
-				account: options.account,
-				mode: options.mode as TimelineCollectionMode,
-				limit: Number(options.limit),
-				all: Boolean(options.all) || options.maxPages !== undefined,
-				maxPages: options.maxPages ? Number(options.maxPages) : undefined,
-				refresh: Boolean(options.refresh),
-				cacheTtlMs: Number(options.cacheTtl) * 1000,
-				earlyStop: Boolean(options.earlyStop),
-			});
-			await autoSyncAfterWrite();
-			print(result, true);
-		});
-}
-
-for (const direction of ["followers", "following"] as const) {
-	syncCommand
-		.command(direction)
-		.description(
-			`Dry-run or refresh live ${direction} into the local follow graph`,
-		)
-		.option("--account <accountId>", "Account id")
-		.option("--mode <mode>", "auto, bird, or xurl", "auto")
-		.option("--limit <n>", "X API users per page", "1000")
-		.option("--max-pages <n>", "Stop after N pages")
-		.option("--max-resources <n>", "Stop after N unique users")
-		.option("--cache-ttl <seconds>", "Live-cache freshness window", "86400")
-		.option("--refresh", "Bypass the live-cache freshness window")
-		.option("--allow-partial", "Acknowledge capped/incomplete snapshot")
-		.option("--yes", "Confirm live sync or fresh-cache merge")
-		.action(async (options) => {
-			try {
-				const result = await syncFollowGraph({
-					direction,
-					account: options.account,
-					mode: options.mode,
-					limit: Number(options.limit),
-					maxPages: options.maxPages ? Number(options.maxPages) : undefined,
-					maxResources: options.maxResources
-						? Number(options.maxResources)
-						: undefined,
-					cacheTtlMs: Number(options.cacheTtl) * 1000,
-					refresh: Boolean(options.refresh),
-					allowPartial: Boolean(options.allowPartial),
-					yes: Boolean(options.yes),
-				});
-				if (!result.dryRun) {
-					await autoSyncAfterWrite();
-				}
-				print(result, true);
-			} catch (error) {
-				print({ ok: false, direction, error: errorMessage(error) }, true);
-				process.exitCode = 1;
-			}
-		});
-}
-
-const jobsCommand = program
-	.command("jobs")
-	.description("Run and install background Birdclaw jobs");
-
-jobsCommand
-	.command("sync-account")
-	.description("Refresh live account timelines and append a JSONL audit entry")
-	.option("--account <accountId>", "Account id")
-	.option(
-		"--steps <steps>",
-		"Comma list: timeline,mentions,mention-threads,likes,bookmarks,dms",
-	)
-	.option("--mode <mode>", "auto, xurl, or bird for likes/bookmarks", "auto")
-	.option("--limit <n>", "Per-page/result limit", "100")
-	.option("--max-pages <n>", "Stop after N pages", "3")
-	.option("--cache-ttl <seconds>", "Live-cache freshness window", "120")
-	.option("--refresh", "Bypass live-cache freshness window")
-	.option(
-		"--allow-bird-account",
-		"Assert bird cookies match --account for Bird-backed steps",
-	)
-	.option("--log <path>", "Audit JSONL path")
-	.action(async (options) => {
-		const result = await runAccountSyncJob({
-			account: options.account,
-			steps: parseAccountSyncSteps(options.steps),
-			mode: options.mode as TimelineCollectionMode,
-			limit: Number(options.limit),
-			maxPages: Number(options.maxPages),
-			refresh: Boolean(options.refresh),
-			cacheTtlMs: Number(options.cacheTtl) * 1000,
-			allowBirdAccount: Boolean(options.allowBirdAccount),
-			logPath: options.log,
-		});
-		print(result, true);
-		if (!result.ok) {
-			process.exitCode = 1;
-		}
-	});
-
-jobsCommand
-	.command("install-account-launchd")
-	.description("Install a LaunchAgent that runs account sync")
-	.option("--label <label>", "LaunchAgent label")
-	.option("--interval-seconds <seconds>", "Launch interval", "1800")
-	.option("--program <path>", "birdclaw executable or command", "birdclaw")
-	.option("--account <accountId>", "Account id")
-	.option(
-		"--steps <steps>",
-		"Comma list: timeline,mentions,mention-threads,likes,bookmarks,dms",
-	)
-	.option("--mode <mode>", "auto, xurl, or bird for likes/bookmarks", "auto")
-	.option("--limit <n>", "Per-page/result limit", "100")
-	.option("--max-pages <n>", "Stop after N pages", "3")
-	.option("--cache-ttl <seconds>", "Live-cache freshness window", "120")
-	.option("--no-refresh", "Allow live-cache reuse")
-	.option(
-		"--allow-bird-account",
-		"Assert bird cookies match --account for Bird-backed steps",
-	)
-	.option("--log <path>", "Audit JSONL path")
-	.option("--env-path <path>", "Shell env file to source before running")
-	.option("--env-file <path>", "Deprecated alias for --env-path")
-	.option("--stdout <path>", "launchd stdout path")
-	.option("--stderr <path>", "launchd stderr path")
-	.option("--launch-agents-dir <path>", "LaunchAgents directory")
-	.option("--no-load", "Write plist without loading it")
-	.action(async (options) => {
-		const result = await installAccountSyncLaunchAgent({
-			label: options.label,
-			intervalSeconds: Number(options.intervalSeconds),
-			program: options.program,
-			account: options.account,
-			steps: parseAccountSyncSteps(options.steps),
-			mode: options.mode as TimelineCollectionMode,
-			limit: Number(options.limit),
-			maxPages: Number(options.maxPages),
-			refresh: options.refresh,
-			allowBirdAccount: Boolean(options.allowBirdAccount),
-			cacheTtlSeconds: Number(options.cacheTtl),
-			logPath: options.log,
-			envFile: options.envPath ?? options.envFile,
-			stdoutPath: options.stdout,
-			stderrPath: options.stderr,
-			launchAgentsDir: options.launchAgentsDir,
-			load: options.load,
-		});
-		print(result, true);
-	});
-
-jobsCommand
-	.command("sync-bookmarks")
-	.description("Refresh live bookmarks and append a JSONL audit entry")
-	.option("--account <accountId>", "Account id")
-	.option("--mode <mode>", "auto, xurl, or bird", "auto")
-	.option("--limit <n>", "Per-page/result limit", "100")
-	.option("--all", "Fetch every retrievable page")
-	.option("--max-pages <n>", "Stop after N pages", "5")
-	.option("--cache-ttl <seconds>", "Live-cache freshness window", "120")
-	.option("--refresh", "Bypass live-cache freshness window")
-	.option("--log <path>", "Audit JSONL path")
-	.action(async (options) => {
-		const result = await runBookmarkSyncJob({
-			account: options.account,
-			mode: options.mode as TimelineCollectionMode,
-			limit: Number(options.limit),
-			all: Boolean(options.all) || options.maxPages !== undefined,
-			maxPages: options.all ? undefined : Number(options.maxPages),
-			refresh: Boolean(options.refresh),
-			cacheTtlMs: Number(options.cacheTtl) * 1000,
-			logPath: options.log,
-		});
-		print(result, true);
-		if (!result.ok) {
-			process.exitCode = 1;
-		}
-	});
-
-jobsCommand
-	.command("install-bookmarks-launchd")
-	.description("Install a LaunchAgent that runs bookmark sync every 3 hours")
-	.option("--label <label>", "LaunchAgent label")
-	.option("--interval-seconds <seconds>", "Launch interval", "10800")
-	.option("--program <path>", "birdclaw executable or command", "birdclaw")
-	.option("--mode <mode>", "auto, xurl, or bird", "auto")
-	.option("--limit <n>", "Per-page/result limit", "100")
-	.option("--all", "Fetch every retrievable page")
-	.option("--max-pages <n>", "Stop after N pages", "5")
-	.option("--cache-ttl <seconds>", "Live-cache freshness window", "120")
-	.option("--no-refresh", "Allow live-cache reuse")
-	.option("--log <path>", "Audit JSONL path")
-	.option("--env-path <path>", "Shell env file to source before running")
-	.option("--env-file <path>", "Deprecated alias for --env-path")
-	.option("--stdout <path>", "launchd stdout path")
-	.option("--stderr <path>", "launchd stderr path")
-	.option("--launch-agents-dir <path>", "LaunchAgents directory")
-	.option("--no-load", "Write plist without loading it")
-	.action(async (options) => {
-		const result = await installBookmarkSyncLaunchAgent({
-			label: options.label,
-			intervalSeconds: Number(options.intervalSeconds),
-			program: options.program,
-			mode: options.mode as TimelineCollectionMode,
-			limit: Number(options.limit),
-			all: Boolean(options.all) || options.maxPages !== undefined,
-			maxPages: options.all ? undefined : Number(options.maxPages),
-			refresh: options.refresh,
-			cacheTtlSeconds: Number(options.cacheTtl),
-			logPath: options.log,
-			envFile: options.envPath ?? options.envFile,
-			stdoutPath: options.stdout,
-			stderrPath: options.stderr,
-			launchAgentsDir: options.launchAgentsDir,
-			load: options.load,
-		});
-		print(result, true);
-	});
-
-dmsCommand
-	.command("list")
-	.option("--account <accountId>", "Account id")
-	.option("--mode <mode>", "auto, bird, or xurl", "bird")
-	.option("--refresh", "Refresh live DMs before listing")
-	.option("--cache-ttl <seconds>", "Live-cache freshness window", "120")
-	.option("--inbox <kind>", "all, accepted, or requests", "all")
-	.option("--max-pages <n>", "Additional accepted/request pages to sync", "0")
-	.option("--all-pages", "Fetch all accepted/request pages while syncing")
-	.option("--page-delay-ms <n>", "Delay between live DM page requests", "0")
-	.option("--participant <value>")
-	.option("--min-followers <n>", "Minimum sender follower count")
-	.option("--max-followers <n>", "Maximum sender follower count")
-	.option("--min-influence-score <n>", "Minimum derived influence score")
-	.option("--max-influence-score <n>", "Maximum derived influence score")
-	.option("--sort <mode>", "recent or followers", "recent")
-	.option(
-		"--resolve-profiles",
-		"Resolve placeholder DM profiles through cache/bird/xurl",
-	)
-	.option("--expand-urls", "Expand URLs through the persistent URL cache")
-	.option("--refresh-profile-cache", "Bypass profile lookup cache")
-	.option("--refresh-url-cache", "Bypass URL expansion cache")
-	.option(
-		"--no-xurl-fallback",
-		"Do not fall back to xurl after bird profile lookup",
-	)
-	.option("--replied", "Only replied threads")
-	.option("--unreplied", "Only unreplied threads")
-	.option("--limit <n>", "Limit results", "20")
-	.action(async (options) => {
-		const replyFilter = options.replied
-			? "replied"
-			: options.unreplied
-				? "unreplied"
-				: "all";
-		const inbox = parseDmInboxOption(options.inbox);
-		const mode = parseDmSyncModeOption(options.mode);
-		const maxPages = parseNonNegativeIntegerOption(
-			options.maxPages,
-			"--max-pages",
-		);
-		const pageDelayMs = parseNonNegativeIntegerOption(
-			options.pageDelayMs,
-			"--page-delay-ms",
-		);
-		if (
-			inbox === undefined ||
-			mode === undefined ||
-			maxPages === undefined ||
-			pageDelayMs === undefined
-		) {
-			return;
-		}
-		if (options.refresh) {
-			await syncDirectMessagesViaCachedBird({
-				account: options.account,
-				mode,
-				limit: Number(options.limit),
-				...(inbox !== "all" ? { inbox } : {}),
-				...(maxPages > 0 ? { maxPages } : {}),
-				...(options.allPages ? { allPages: true } : {}),
-				...(pageDelayMs > 0 ? { pageDelayMs } : {}),
-				refresh: true,
-				cacheTtlMs: Number(options.cacheTtl) * 1000,
-			});
-			await autoSyncAfterWrite();
-		} else {
-			await autoUpdateBeforeRead();
-		}
-		const items = await enrichDmItems(
-			{
-				account: options.account,
-				...(inbox !== "all" ? { inbox } : {}),
-				participant: options.participant,
-				minFollowers: options.minFollowers
-					? Number(options.minFollowers)
-					: undefined,
-				maxFollowers: options.maxFollowers
-					? Number(options.maxFollowers)
-					: undefined,
-				minInfluenceScore: options.minInfluenceScore
-					? Number(options.minInfluenceScore)
-					: undefined,
-				maxInfluenceScore: options.maxInfluenceScore
-					? Number(options.maxInfluenceScore)
-					: undefined,
-				sort:
-					options.sort === "followers" || options.sort === "influence"
-						? "followers"
-						: "recent",
-				replyFilter,
-				limit: Number(options.limit),
-			},
-			{
-				resolveProfiles: Boolean(options.resolveProfiles),
-				expandUrls: Boolean(options.expandUrls),
-				refreshProfileCache: Boolean(options.refreshProfileCache),
-				refreshUrlCache: Boolean(options.refreshUrlCache),
-				xurlFallback: options.xurlFallback,
-			},
-		);
-		print(items, program.opts().json ?? false);
-	});
-
-dmsCommand
-	.command("sync")
-	.description("Refresh live direct messages into the local store")
-	.option("--account <accountId>", "Account id")
-	.option("--mode <mode>", "auto, bird, or xurl", "bird")
-	.option("--limit <n>", "Limit messages", "20")
-	.option("--inbox <kind>", "all, accepted, or requests", "all")
-	.option("--max-pages <n>", "Additional accepted/request pages to sync", "0")
-	.option("--all-pages", "Fetch all accepted/request pages")
-	.option("--page-delay-ms <n>", "Delay between live DM page requests", "0")
-	.option("--cache-ttl <seconds>", "Live-cache freshness window", "120")
-	.option("--refresh", "Bypass live-cache freshness window")
-	.action(async (options) => {
-		const inbox = parseDmInboxOption(options.inbox);
-		const mode = parseDmSyncModeOption(options.mode);
-		const maxPages = parseNonNegativeIntegerOption(
-			options.maxPages,
-			"--max-pages",
-		);
-		const pageDelayMs = parseNonNegativeIntegerOption(
-			options.pageDelayMs,
-			"--page-delay-ms",
-		);
-		if (
-			inbox === undefined ||
-			mode === undefined ||
-			maxPages === undefined ||
-			pageDelayMs === undefined
-		) {
-			return;
-		}
-		const result = await syncDirectMessagesViaCachedBird({
-			account: options.account,
-			mode,
-			limit: Number(options.limit),
-			...(inbox !== "all" ? { inbox } : {}),
-			...(maxPages > 0 ? { maxPages } : {}),
-			...(options.allPages ? { allPages: true } : {}),
-			...(pageDelayMs > 0 ? { pageDelayMs } : {}),
-			refresh: Boolean(options.refresh),
-			cacheTtlMs: Number(options.cacheTtl) * 1000,
-		});
-		await autoSyncAfterWrite();
-		print(result, true);
-	});
-
-for (const action of ["accept", "reject", "block"] as const) {
-	const command = dmsCommand
-		.command(`${action} <conversationId>`)
-		.description(`${action} a live DM message request through bird`);
-	if (action === "block") {
-		command
-			.option("--max-pages <n>", "Additional timeline pages to search", "3")
-			.option("--all-pages", "Search all accepted/request timeline pages");
-	}
-	command.action(async (conversationId, options) => {
-		const maxPages =
-			action === "block"
-				? parseNonNegativeIntegerOption(options.maxPages, "--max-pages")
-				: undefined;
-		if (action === "block" && maxPages === undefined) {
-			return;
-		}
-		const result = await runDirectMessageRequestMutationViaBird({
-			action,
-			conversationId,
-			...(action === "block" && maxPages !== undefined ? { maxPages } : {}),
-			...(action === "block" && options.allPages ? { allPages: true } : {}),
-		});
-		if (result.success) {
-			await applyDmRequestMutationToLocalStore(conversationId, action);
-		} else {
-			process.exitCode = 1;
-		}
-		await autoSyncAfterWrite();
-		print(result, true);
-	});
-}
-
-registerModerationCommands({
-	program,
-	print,
-	asJson: () => program.opts().json ?? false,
-	importBlocklist,
-	resolveActionOptions,
-});
-
-const commandContext = {
-	program,
-	print,
-	asJson: () => program.opts().json ?? false,
-	autoSyncAfterWrite,
-	autoUpdateBeforeRead,
-	parseNonNegativeIntegerOption,
-	parsePositiveIntegerOption,
-};
-
-registerComposeCommands(commandContext);
-registerInboxCommand(commandContext);
-
-registerGraphCommands(commandContext);
-
-registerStorageCommands(commandContext);
-
-program
-	.command("serve")
-	.description("Run the local web app")
-	.action(async () => {
-		await autoUpdateBeforeRead();
-		const child = spawn(
-			process.execPath,
-			[
-				"node_modules/vite/bin/vite.js",
-				"dev",
-				"--host",
-				"127.0.0.1",
-				"--port",
-				"3000",
-			],
-			{
-				cwd: packageRoot,
-				env: { ...process.env, BIRDCLAW_LOCAL_WEB: "1" },
-				stdio: "inherit",
-				detached: process.platform !== "win32",
-			},
-		);
-		const forwardedSignals = [
-			"SIGINT",
-			"SIGTERM",
-			"SIGHUP",
-			"SIGQUIT",
-		] as const;
-		const forwardSignal = (signal: NodeJS.Signals) => {
-			if (child.exitCode === null && child.signalCode === null) {
-				signalChild(signal);
-			}
-		};
-		const signalChild = (signal: NodeJS.Signals) => {
-			if (child.pid === undefined) {
-				return;
-			}
-			const targetPid = process.platform === "win32" ? child.pid : -child.pid;
-			try {
-				process.kill(targetPid, signal);
-			} catch (error) {
-				if (
-					!(
-						typeof error === "object" &&
-						error !== null &&
-						"code" in error &&
-						error.code === "ESRCH"
-					)
-				) {
-					throw error;
-				}
-			}
-		};
-		const removeSignalHandlers = () => {
-			for (const signal of forwardedSignals) {
-				process.removeListener(signal, forwardSignal);
-			}
-		};
-		for (const signal of forwardedSignals) {
-			process.on(signal, forwardSignal);
-		}
-		child.on("exit", (code, signal) => {
-			removeSignalHandlers();
-			if (signal) {
-				process.kill(process.pid, signal);
-				return;
-			}
-			process.exit(code ?? 0);
-		});
-	});
-
-export async function runCli(argv = process.argv) {
-	try {
-		await program.parseAsync(argv);
-	} finally {
-		await closeDatabase();
-	}
-}
-
-/* v8 ignore next 5 */
-if (process.argv[1]) {
-	const entryUrl = pathToFileURL(process.argv[1]).href;
-	if (import.meta.url === entryUrl) {
-		void runCli().catch((error) => {
-			console.error(error instanceof Error ? error.message : String(error));
-			process.exitCode = 1;
-		});
-	}
-}