react-doctor 0.9.4-dev.da0647e → 0.9.5-dev.2b8bc5c

package/dist/{exit-gracefully-BN2OivAV.js → exit-gracefully-Du1RQd8v.js}

@@ -1,5 +1,5 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="07705956-10ec-5419-acea-25f57c6a08c5")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="ebadd5f4-f19b-552c-b2da-27e8355f567a")}catch(e){}}();
 import { n as __require, r as __toESM$1, t as __commonJSMin$1 } from "./chunk-q7NCDQ7-.js";
 import { createRequire } from "node:module";
 import * as NodeChildProcess from "node:child_process";
@@ -15,11 +15,11 @@ import crypto, { createHash, randomUUID } from "node:crypto";
 import { ResolverFactory } from "oxc-resolver";
 import ts from "typescript";
 import * as NodeUrl from "node:url";
-import { fileURLToPath, pathToFileURL } from "node:url";
+import { fileURLToPath } from "node:url";
 import * as OS from "node:os";
 import os, { tmpdir } from "node:os";
-import { parseJSON5 } from "confbox";
 import { createJiti } from "jiti";
+import { parseJSON5 } from "confbox";
 import { ANALYZED_MANIFEST_FILENAMES, DEFAULT_EXTENSIONS } from "deslop-js/analyzed-inputs";
 import { convertToTSX } from "@astrojs/compiler/sync";
 import { gzipSync } from "node:zlib";
@@ -28,9 +28,9 @@ import { performance as performance$1 } from "node:perf_hooks";
 import { promisify, stripVTControlCharacters } from "node:util";
 import tty from "node:tty";
 import basePrompts from "prompts";
-import { codeFrameColumns } from "@babel/code-frame";
-import Conf from "conf";
 import { detectInstalledSkillAgents, getSkillAgentTypes } from "agent-install";
+import Conf from "conf";
+import { codeFrameColumns } from "@babel/code-frame";
 //#region ../../node_modules/.pnpm/effect@4.0.0-beta.70/node_modules/effect/dist/Pipeable.js
 /**
 * The `Pipeable` module defines the shared interface and implementation helpers
@@ -62453,7 +62453,7 @@ const SOCKET_FREE_USER_AGENT = "react-doctor-supply-chain";
 const FILE_LINT_CACHE_FILENAME = "file-lint-cache.json";
 const FILE_LINT_CACHE_MAX_FILE_COUNT = 5e4;
 const SIDECAR_LINT_CACHE_FILENAME = "sidecar-lint-cache.json";
-const CORE_PACKAGE_VERSION = "0.9.4";
+const CORE_PACKAGE_VERSION = "0.9.5";
 const DEAD_CODE_CACHE_FILENAME = "dead-code-cache.json";
 const DEAD_CODE_SUMMARY_CACHE_FILENAME = "dead-code-summaries.json";
 const SUPPLY_CHAIN_PLUGIN = "socket";
@@ -66965,6 +66965,11 @@ var DeadCodeResultCacheEnabled = class extends Reference("react-doctor/DeadCodeR
 	if (CACHE_DISABLED_VALUES$1.has(noDeadCodeCache)) return false;
 	return true;
 } }) {};
+const importDefaultExport = async (jitiInstance, filePath) => {
+	const imported = await jitiInstance.import(filePath);
+	return imported?.default ?? imported;
+};
+const readJson5File = (filePath) => parseJSON5(NFS.readFileSync(filePath, "utf-8"));
 const DIAGNOSTIC_SURFACES = [
 	"cli",
 	"prComment",
@@ -67195,11 +67200,7 @@ const DATA_CONFIG_EXTENSIONS = new Set(["json", "jsonc"]);
 const PACKAGE_JSON_FILENAME = "package.json";
 const PACKAGE_JSON_CONFIG_KEY = "reactDoctor";
 const LEGACY_CONFIG_FILENAME = "react-doctor.config.json";
-const jiti = createJiti(import.meta.url);
-const importDefaultExport = async (jitiInstance, filePath) => {
-	const imported = await jitiInstance.import(filePath);
-	return imported?.default ?? imported;
-};
+const jiti$1 = createJiti(import.meta.url);
 const SELF_PACKAGE_IMPORT_SPECIFIER = "react-doctor/api";
 const SELF_PACKAGE_RESOLVE_TARGETS = ["react-doctor/api", "@react-doctor/core"];
 const MODULE_NOT_FOUND_ERROR_CODES = new Set(["MODULE_NOT_FOUND", "ERR_MODULE_NOT_FOUND"]);
@@ -67207,7 +67208,7 @@ let selfAliasJiti;
 const getSelfAliasJiti = () => {
 	if (selfAliasJiti !== void 0) return selfAliasJiti;
 	for (const resolveTarget of SELF_PACKAGE_RESOLVE_TARGETS) try {
-		const aliasTargetPath = fileURLToPath(jiti.esmResolve(resolveTarget));
+		const aliasTargetPath = fileURLToPath(jiti$1.esmResolve(resolveTarget));
 		selfAliasJiti = createJiti(import.meta.url, { alias: { [SELF_PACKAGE_IMPORT_SPECIFIER]: aliasTargetPath } });
 		return selfAliasJiti;
 	} catch {
@@ -67219,7 +67220,7 @@ const getSelfAliasJiti = () => {
 const isSelfPackageResolutionError = (error) => error instanceof Error && "code" in error && typeof error.code === "string" && MODULE_NOT_FOUND_ERROR_CODES.has(error.code) && error.message.includes(SELF_PACKAGE_IMPORT_SPECIFIER);
 const loadModuleConfig = async (filePath) => {
 	try {
-		return await importDefaultExport(jiti, filePath);
+		return await importDefaultExport(jiti$1, filePath);
 	} catch (error) {
 		if (!isSelfPackageResolutionError(error)) throw error;
 		const aliasJiti = getSelfAliasJiti();
@@ -67231,12 +67232,11 @@ const loadModuleConfig = async (filePath) => {
 		}
 	}
 };
-const readDataConfig = (filePath) => parseJSON5(NFS.readFileSync(filePath, "utf-8"));
 const readEmbeddedPackageJsonConfig = (directory) => {
 	const packageJsonPath = Path.join(directory, PACKAGE_JSON_FILENAME);
 	if (!isFile(packageJsonPath)) return null;
 	try {
-		const packageJson = parseJSON5(NFS.readFileSync(packageJsonPath, "utf-8"));
+		const packageJson = readJson5File(packageJsonPath);
 		if (isPlainObject(packageJson)) {
 			const embeddedConfig = packageJson[PACKAGE_JSON_CONFIG_KEY];
 			if (isPlainObject(embeddedConfig)) return embeddedConfig;
@@ -67261,7 +67261,7 @@ const loadLegacyConfig = (directory) => {
 		loaded: null
 	};
 	try {
-		const parsed = readDataConfig(legacyFilePath);
+		const parsed = readJson5File(legacyFilePath);
 		if (isPlainObject(parsed)) {
 			warn(`${LEGACY_CONFIG_FILENAME} is deprecated — rename it to ${CONFIG_BASENAME}.json (or author a ${CONFIG_BASENAME}.ts). It is still read for now.`);
 			return {
@@ -67290,7 +67290,7 @@ const loadConfigFromDirectory = async (directory) => {
 		if (!isFile(filePath)) continue;
 		const isDataFile = DATA_CONFIG_EXTENSIONS.has(extension);
 		try {
-			const parsed = isDataFile ? readDataConfig(filePath) : await loadModuleConfig(filePath);
+			const parsed = isDataFile ? readJson5File(filePath) : await loadModuleConfig(filePath);
 			if (isPlainObject(parsed)) return {
 				status: "found",
 				loaded: {
@@ -69536,20 +69536,45 @@ const collectIgnorePatterns = (rootDirectory) => {
 	cachedPatternsByRoot.set(rootDirectory, patterns);
 	return patterns;
 };
-const failOpenReadJson = (filePath, fallback) => {
+const KNIP_DATA_CONFIG_FILENAMES = new Set([
+	"knip.json",
+	"knip.jsonc",
+	".knip.json",
+	".knip.jsonc"
+]);
+const KNIP_CONFIG_FILENAMES = [
+	...KNIP_DATA_CONFIG_FILENAMES,
+	"knip.ts",
+	"knip.js",
+	"knip.config.ts",
+	"knip.config.js"
+];
+const jiti = createJiti(import.meta.url, { moduleCache: false });
+const resolveKnipConfigExport = async (configExport) => {
+	const config = typeof configExport === "function" ? await configExport() : await configExport;
+	return isRecord$1(config) ? config : null;
+};
+const loadKnipConfigFile = async (configFilename, filePath) => {
 	try {
-		return JSON.parse(NFS.readFileSync(filePath, "utf8"));
+		return await resolveKnipConfigExport(KNIP_DATA_CONFIG_FILENAMES.has(configFilename) ? readJson5File(filePath) : await importDefaultExport(jiti, filePath));
 	} catch {
-		return fallback;
+		return null;
 	}
 };
-const KNIP_JSON_FILENAME = "knip.json";
-const readKnipConfig = (rootDirectory) => {
-	const knipJson = failOpenReadJson(path.join(rootDirectory, KNIP_JSON_FILENAME), null);
-	if (isRecord$1(knipJson)) return knipJson;
-	const packageJson = failOpenReadJson(path.join(rootDirectory, "package.json"), null);
-	const packageKnipConfig = isRecord$1(packageJson) ? packageJson.knip : null;
-	return isRecord$1(packageKnipConfig) ? packageKnipConfig : null;
+const loadKnipConfig = async (rootDirectory) => {
+	for (const configFilename of KNIP_CONFIG_FILENAMES) {
+		const filePath = path.join(rootDirectory, configFilename);
+		if (!isFile(filePath)) continue;
+		const config = await loadKnipConfigFile(configFilename, filePath);
+		if (config) return config;
+	}
+	try {
+		const packageJson = readJson5File(path.join(rootDirectory, "package.json"));
+		const packageKnipConfig = isRecord$1(packageJson) ? packageJson.knip : null;
+		return isRecord$1(packageKnipConfig) ? packageKnipConfig : null;
+	} catch {
+		return null;
+	}
 };
 const normalizePatternList = (value) => {
 	if (typeof value === "string" && value.length > 0) return [value];
@@ -69569,22 +69594,28 @@ const collectKnipWorkspacePatterns = (workspaces, settingName) => {
 	}
 	return patterns;
 };
-const collectKnipPatterns = (rootDirectory, settingName) => {
-	const config = readKnipConfig(rootDirectory);
+const collectKnipPatterns = (config, settingName) => {
 	if (!config) return [];
 	return [...normalizePatternList(config[settingName]), ...collectKnipWorkspacePatterns(config.workspaces, settingName)];
 };
-const collectDeadCodeIgnorePatterns = (rootDirectory) => {
+const collectDeadCodeIgnorePatterns = (rootDirectory, config) => {
 	const seen = /* @__PURE__ */ new Set();
 	const sources = [
 		readIgnoreFile(path.join(rootDirectory, ".gitignore")),
 		collectIgnorePatterns(rootDirectory),
-		collectKnipPatterns(rootDirectory, "ignore")
+		collectKnipPatterns(config, "ignore")
 	];
 	for (const source of sources) for (const pattern of source) seen.add(pattern);
 	return [...seen].filter((pattern) => pattern.length > 0);
 };
-const collectDeadCodeEntryPatterns = (rootDirectory) => [...new Set(collectKnipPatterns(rootDirectory, "entry"))].filter((pattern) => pattern.length > 0);
+const collectDeadCodeEntryPatterns = (config) => [...new Set(collectKnipPatterns(config, "entry"))].filter((pattern) => pattern.length > 0);
+const collectDeadCodePatterns = async (rootDirectory) => {
+	const config = await loadKnipConfig(rootDirectory);
+	return {
+		entryPatterns: collectDeadCodeEntryPatterns(config),
+		ignorePatterns: collectDeadCodeIgnorePatterns(rootDirectory, config)
+	};
+};
 const atomicWriteJson = (filePath, value) => {
 	try {
 		NFS.mkdirSync(Path.dirname(filePath), { recursive: true });
@@ -69595,6 +69626,13 @@ const atomicWriteJson = (filePath, value) => {
 		return;
 	}
 };
+const failOpenReadJson = (filePath, fallback) => {
+	try {
+		return JSON.parse(NFS.readFileSync(filePath, "utf8"));
+	} catch {
+		return fallback;
+	}
+};
 const hashFileContents = (filePath) => {
 	try {
 		return crypto.createHash("sha1").update(NFS.readFileSync(filePath)).digest("hex");
@@ -69603,7 +69641,7 @@ const hashFileContents = (filePath) => {
 	}
 };
 const ANALYZED_FILE_EXTENSIONS = new Set(DEFAULT_EXTENSIONS);
-const CORE_SIDE_MANIFEST_NAMES = ["knip.json", "deno.lock"];
+const CORE_SIDE_MANIFEST_NAMES = [...KNIP_CONFIG_FILENAMES, "deno.lock"];
 const ANALYZED_MANIFEST_NAMES = new Set([...ANALYZED_MANIFEST_FILENAMES, ...CORE_SIDE_MANIFEST_NAMES]);
 const isTsConfigLikeFile = (fileName) => (fileName.startsWith("tsconfig") || fileName.startsWith("jsconfig")) && fileName.endsWith(".json");
 const isFingerprintedFile = (fileName) => ANALYZED_FILE_EXTENSIONS.has(Path.extname(fileName).toLowerCase()) || ANALYZED_MANIFEST_NAMES.has(fileName) || isTsConfigLikeFile(fileName);
@@ -70129,8 +70167,7 @@ const runDeadCodeWorkerWithTimeout = (handle, timeoutMs, abortSignal) => new Pro
 const checkDeadCode = async (options) => {
 	const rootDirectory = toCanonicalPath(options.rootDirectory);
 	if (!NFS.existsSync(Path.join(rootDirectory, "package.json"))) return [];
-	const entryPatterns = collectDeadCodeEntryPatterns(rootDirectory);
-	const ignorePatterns = collectDeadCodeIgnorePatterns(rootDirectory);
+	const { entryPatterns, ignorePatterns } = await collectDeadCodePatterns(rootDirectory);
 	const tsConfigPath = resolveTsConfigPath(rootDirectory);
 	const deslopJsModuleSpecifier = options.deslopJsModuleSpecifier ?? import.meta.resolve("deslop-js");
 	const fileStatsSnapshot = options.cacheEnabled ? collectAnalyzedFileStats(rootDirectory) : null;
@@ -76357,8 +76394,7 @@ const GH_DEFAULT_BRANCH_PROBE_TIMEOUT_MS = 5e3;
 const TUI_REPORT_COMPACT_MAX_ROWS = 23;
 const TUI_REPORT_DETAIL_WIDTH_FRACTION = .6;
 const CI_TRUST_COMPANIES = "PayPal, Rippling, and Alibaba";
-const WELCOME_EXPLANATION_HOLD_MS = 1e3;
-const CATEGORY_COUNTUP_SETTLE_HOLD_MS = 1e3;
+const MINIMUM_VTE_VERSION_FOR_HYPERLINKS = 5e3;
 const INTERNAL_ERROR_JSON_FALLBACK = "{\"schemaVersion\":3,\"version\":\"unknown\",\"ok\":false,\"directory\":\"\",\"mode\":\"full\",\"diff\":null,\"projects\":[],\"diagnostics\":[],\"summary\":{\"errorCount\":0,\"warningCount\":0,\"affectedFileCount\":0,\"totalDiagnosticCount\":0,\"score\":null,\"scoreLabel\":null},\"elapsedMilliseconds\":0,\"error\":{\"message\":\"Internal error\",\"name\":\"Error\",\"chain\":[]}}\n";
 const SENTRY_FLUSH_TIMEOUT_MS = 2e3;
 const NANOSECONDS_PER_SECOND = 1000000000n;
@@ -76412,7 +76448,7 @@ const METRIC = {
 	tuiFindingNavigated: "tui.finding_navigated",
 	tuiIssueStreamShown: "tui.issue_stream_shown",
 	tuiProjectPathContextShown: "tui.project_path_context_shown",
-	tuiProjectSelectInlineShown: "tui.project_select_inline_shown",
+	tuiProjectSelectShown: "tui.project_select_shown",
 	tuiReportActionSelected: "tui.report_action_selected",
 	tuiCancelled: "tui.cancelled",
 	tuiScanInlineShown: "tui.scan_inline_shown",
@@ -76461,7 +76497,7 @@ const makeNoopConsole = () => ({
 });
 //#endregion
 //#region src/cli/utils/version.ts
-const VERSION = "0.9.4-dev.da0647e";
+const VERSION = "0.9.5-dev.2b8bc5c";
 //#endregion
 //#region src/cli/utils/json-mode.ts
 let context = null;
@@ -76922,13 +76958,13 @@ const isDevVersion = (version) => version === "0.0.0" || version.includes("-");
 * uploads source-map artifacts under, so stack frames symbolicate. Honors the
 * standard `SENTRY_RELEASE` override.
 */
-const resolveSentryRelease = () => process.env.SENTRY_RELEASE || `react-doctor@0.9.4-dev.da0647e`;
+const resolveSentryRelease = () => process.env.SENTRY_RELEASE || `react-doctor@0.9.5-dev.2b8bc5c`;
 /**
 * Deployment environment shown in Sentry's environment filter. Defaults to
 * `production` for tagged releases and `development` for dev/unbuilt versions,
 * overridable via the standard `SENTRY_ENVIRONMENT` env var.
 */
-const resolveSentryEnvironment = () => process.env.SENTRY_ENVIRONMENT || (isDevVersion("0.9.4-dev.da0647e") ? "development" : "production");
+const resolveSentryEnvironment = () => process.env.SENTRY_ENVIRONMENT || (isDevVersion("0.9.5-dev.2b8bc5c") ? "development" : "production");
 /**
 * Performance-tracing sample rate in `[0, 1]`. Reads `SENTRY_TRACES_SAMPLE_RATE`
 * (set to `0` to disable tracing) and falls back to
@@ -82449,88 +82485,68 @@ const printAgentGuidance = () => gen(function* () {
 	yield* log("");
 });
 //#endregion
-//#region src/cli/utils/box-text.ts
-const ESCAPE = String.fromCharCode(27);
-const ANSI_ESCAPE_PATTERN = new RegExp(`${ESCAPE}\\[[0-9;]*m`, "g");
-const ANSI_LEADING_ESCAPE_PATTERN = new RegExp(`^${ESCAPE}\\[[0-9;]*m`);
-const ANSI_RESET = `${ESCAPE}[0m`;
-const ELLIPSIS = "…";
-const visibleWidth = (line) => line.replace(ANSI_ESCAPE_PATTERN, "").length;
-const truncateToVisibleWidth = (line, maxVisibleWidth) => {
-	if (visibleWidth(line) <= maxVisibleWidth) return line;
-	const keepWidth = Math.max(0, maxVisibleWidth - 1);
-	let result = "";
-	let keptVisible = 0;
-	let cursor = 0;
-	while (cursor < line.length && keptVisible < keepWidth) {
-		const escapeMatch = ANSI_LEADING_ESCAPE_PATTERN.exec(line.slice(cursor));
-		if (escapeMatch) {
-			result += escapeMatch[0];
-			cursor += escapeMatch[0].length;
-			continue;
-		}
-		result += line[cursor];
-		keptVisible += 1;
-		cursor += 1;
+//#region src/cli/utils/filter-diagnostics-by-categories.ts
+const filterDiagnosticsByCategories = (diagnostics, categories) => categories.size === 0 ? [...diagnostics] : diagnostics.filter((diagnostic) => categories.has(diagnostic.category));
+//#endregion
+//#region src/cli/utils/format-diagnostic-site.ts
+const formatDiagnosticSite = (site) => site.line > 0 ? `${site.filePath}:${site.line}` : site.filePath;
+//#endregion
+//#region src/cli/utils/format-rule-summary.ts
+const formatFileContextTag = (diagnostic) => diagnostic.fileContext ? ` (${diagnostic.fileContext} file)` : "";
+const formatRuleSummary = (ruleKey, ruleDiagnostics) => {
+	const firstDiagnostic = ruleDiagnostics[0];
+	if (firstDiagnostic === void 0) return "";
+	const distinctMessages = [...new Set(ruleDiagnostics.map((diagnostic) => diagnostic.message))];
+	const sections = [
+		`Rule: ${ruleKey}`,
+		`Severity: ${firstDiagnostic.severity}`,
+		`Category: ${firstDiagnostic.category}`,
+		`Count: ${ruleDiagnostics.length}`,
+		"",
+		distinctMessages.join("\n\n")
+	];
+	if (firstDiagnostic.help) sections.push("", `Suggestion: ${firstDiagnostic.help}`);
+	if (firstDiagnostic.url) sections.push("", `Docs: ${firstDiagnostic.url}`);
+	const fixRecipeLine = formatFixRecipeLine(firstDiagnostic);
+	if (fixRecipeLine) sections.push("", fixRecipeLine);
+	sections.push("", "Files:");
+	for (const diagnostic of ruleDiagnostics) {
+		sections.push(`  ${formatDiagnosticSite(diagnostic)}${formatFileContextTag(diagnostic)}`);
+		if (diagnostic.suppressionHint) sections.push(`    ${diagnostic.suppressionHint}`);
 	}
-	return `${result}${ANSI_RESET}${ELLIPSIS}`;
-};
-const boxText = (content, innerWidth) => {
-	const horizontalRule = highlighter.dim("─".repeat(innerWidth + 2));
-	const side = highlighter.dim("│");
-	const body = content.split("\n").map((rawLine) => {
-		const line = truncateToVisibleWidth(rawLine, innerWidth);
-		return `${side} ${line}${" ".repeat(innerWidth - visibleWidth(line))} ${side}`;
-	});
-	return [
-		`${highlighter.dim("┌")}${horizontalRule}${highlighter.dim("┐")}`,
-		...body,
-		`${highlighter.dim("└")}${horizontalRule}${highlighter.dim("┘")}`
-	].join("\n");
+	return `${sections.join("\n")}\n`;
 };
 //#endregion
-//#region src/cli/utils/resolve-absolute-path.ts
-/**
-* Resolves a diagnostic's `filePath` (relative to its project root, or
-* already absolute) to an absolute path. Shared by the code-frame reader and
-* the terminal hyperlink builder so both turn a relative path into the same
-* on-disk location.
-*/
-const resolveAbsolutePath = (filePath, rootDirectory) => Path.isAbsolute(filePath) ? filePath : Path.resolve(rootDirectory || ".", filePath);
-//#endregion
-//#region src/cli/utils/build-code-frame.ts
-/**
-* Renders a syntax-highlighted source excerpt around a diagnostic site
-* with a caret pointing at the offending column. Returns null when the
-* file can't be read (e.g. multi-project summaries where paths are
-* resolved against a different cwd), so callers can fall back to the
-* bare `file:line` reference instead of failing the whole render.
-*/
-const buildCodeFrame = (input) => {
-	if (input.line <= 0) return null;
-	const absolutePath = resolveAbsolutePath(input.filePath, input.rootDirectory);
-	let source;
+//#region src/cli/utils/write-diagnostics-directory.ts
+const ruleDumpFileName = (ruleKey) => ruleKey.replace(/\//g, "--") + ".txt";
+const readPreviousRuleDumpFileNames = (directory) => {
 	try {
-		source = NFS.readFileSync(absolutePath, "utf8");
+		const previous = JSON.parse(NFS.readFileSync(Path.join(directory, "diagnostics.json"), "utf8"));
+		return new Set(previous.filter((d) => typeof d?.plugin === "string" && typeof d?.rule === "string").map((d) => ruleDumpFileName(`${d.plugin}/${d.rule}`)));
 	} catch {
-		return null;
+		return /* @__PURE__ */ new Set();
 	}
-	if ((source.split("\n", input.line)[input.line - 1] ?? "").length > 200) return null;
-	const location = input.endLine != null && input.endLine > input.line ? {
-		start: { line: input.line },
-		end: { line: input.endLine }
-	} : { start: {
-		line: input.line,
-		column: input.column > 0 ? input.column : void 0
-	} };
-	return codeFrameColumns(source, location, {
-		highlightCode: true,
-		linesAbove: 1,
-		linesBelow: 1,
-		...input.message ? { message: input.message } : {}
-	});
+};
+const writeDiagnosticsDirectory = (diagnostics, outputDirectory) => {
+	const directory = outputDirectory ? Path.resolve(outputDirectory) : Path.join(tmpdir(), `react-doctor-${randomUUID()}`);
+	if (outputDirectory) for (const fileName of readPreviousRuleDumpFileNames(directory)) NFS.rmSync(Path.join(directory, fileName), { force: true });
+	NFS.mkdirSync(directory, { recursive: true });
+	for (const [ruleKey, ruleDiagnostics] of buildSortedRuleGroups(diagnostics)) NFS.writeFileSync(Path.join(directory, ruleDumpFileName(ruleKey)), formatRuleSummary(ruleKey, ruleDiagnostics));
+	NFS.writeFileSync(Path.join(directory, "diagnostics.json"), JSON.stringify(diagnostics));
+	return directory;
 };
 //#endregion
+//#region src/cli/utils/print-diagnostics-dump.ts
+const printDiagnosticsDump = (diagnostics, outputDirectory, verbose, stream = "stdout") => gen(function* () {
+	const writtenDirectory = yield* try_({
+		try: () => writeDiagnosticsDirectory(diagnostics, outputDirectory),
+		catch: (cause) => cause
+	}).pipe(orElseSucceed(() => null));
+	if (writtenDirectory === null || !verbose && !outputDirectory) return;
+	const pathLine = highlighter.gray(`  Full diagnostics written to ${writtenDirectory}`);
+	yield* stream === "stderr" || Boolean(outputDirectory) && isJsonModeActive() ? sync(() => process.stderr.write(`${pathLine}\n`)) : log(pathLine);
+});
+//#endregion
 //#region src/cli/utils/resolve-measure-width.ts
 const resolveClampedWidth = (input) => {
 	const terminalColumns = process.stdout.columns;
@@ -82544,20 +82560,6 @@ const resolveMeasureWidth = (reservedColumns = 0) => resolveClampedWidth({
 	minWidth: 24
 });
 //#endregion
-//#region src/cli/utils/build-section-divider.ts
-const DIVIDER_INDENT = "  ";
-const buildSectionDivider = () => highlighter.dim(`${DIVIDER_INDENT}${"─".repeat(resolveMeasureWidth(2))}`);
-//#endregion
-//#region src/cli/utils/format-hyperlink.ts
-const OSC = "\x1B]";
-const ST = "\x1B\\";
-/**
-* Wraps `text` in an OSC 8 hyperlink pointing at `uri`. The visible characters
-* are exactly `text`; the link is carried in escape sequences a capable
-* terminal turns into a click target.
-*/
-const formatHyperlink = (text, uri) => `${OSC}8;;${uri}${ST}${text}${OSC}8;;${ST}`;
-//#endregion
 //#region src/cli/utils/indent-multiline-text.ts
 const indentMultilineText = (text, linePrefix) => text.split("\n").map((lineText) => `${linePrefix}${lineText}`).join("\n");
 //#endregion
@@ -82597,793 +82599,6 @@ const wrapTextToWidth = (text, width, options = {}) => {
 	return text.split("\n").flatMap((lineText) => wrapLine(lineText, width, breakLongWords));
 };
 //#endregion
-//#region src/cli/utils/write-stdout.ts
-const writeStdout = (text) => sync(() => {
-	process.stdout.write(text);
-});
-//#endregion
-//#region src/cli/utils/render-diagnostics.ts
-const POINTER = isUnicodeSupported() ? "›" : ">";
-const colorizeBySeverity = (text, severity) => severity === "error" ? highlighter.error(text) : highlighter.warn(text);
-const collectAffectedFiles = (diagnostics) => new Set(diagnostics.map((diagnostic) => diagnostic.filePath));
-const formatFileContextTag = (diagnostic) => diagnostic.fileContext ? ` (${diagnostic.fileContext} file)` : "";
-const buildVerboseFileEntries = (diagnostics) => {
-	const fileEntries = /* @__PURE__ */ new Map();
-	for (const diagnostic of diagnostics) {
-		let entry = fileEntries.get(diagnostic.filePath);
-		if (entry === void 0) {
-			entry = {
-				contextTag: formatFileContextTag(diagnostic),
-				sites: []
-			};
-			fileEntries.set(diagnostic.filePath, entry);
-		}
-		if (diagnostic.line > 0) entry.sites.push({
-			line: diagnostic.line,
-			suppressionHint: diagnostic.suppressionHint
-		});
-	}
-	return fileEntries;
-};
-const formatSiteCountBadge = (count) => count > 1 ? `×${count}` : "";
-const formatTrailingSiteBadge = (count) => {
-	const badge = formatSiteCountBadge(count);
-	return badge.length > 0 ? ` ${highlighter.gray(badge)}` : "";
-};
-const CATEGORY_DISPLAY_RANK = new Map(DIAGNOSTIC_CATEGORY_BUCKETS.map((category, index) => [category, index]));
-const compareCategoriesByDisplayRank = (categoryA, categoryB) => {
-	const rankA = CATEGORY_DISPLAY_RANK.get(categoryA);
-	const rankB = CATEGORY_DISPLAY_RANK.get(categoryB);
-	if (rankA !== void 0 && rankB !== void 0) return rankA - rankB;
-	if (rankA !== void 0) return -1;
-	if (rankB !== void 0) return 1;
-	return categoryA.localeCompare(categoryB);
-};
-const buildCategoryDiagnosticGroups = (diagnostics, rulePriority) => {
-	return [...groupBy(diagnostics, (diagnostic) => diagnostic.category).entries()].map(([category, categoryDiagnostics]) => ({
-		category,
-		diagnostics: categoryDiagnostics,
-		ruleGroups: buildSortedRuleGroups(categoryDiagnostics, rulePriority)
-	})).toSorted((categoryGroupA, categoryGroupB) => compareCategoriesByDisplayRank(categoryGroupA.category, categoryGroupB.category));
-};
-const formatCategoryTallyLine = (tally, errorShown, warningShown) => {
-	const parts = [];
-	if (tally.errorCount > 0) parts.push(highlighter.error(`${errorShown} ${errorShown === 1 ? "error" : "errors"}`));
-	if (tally.warningCount > 0) parts.push(highlighter.warn(highlighter.dim(`${warningShown} ${warningShown === 1 ? "warning" : "warnings"}`)));
-	return `  ${highlighter.bold(tally.category)} ${highlighter.dim(POINTER)} ${parts.join(highlighter.dim(", "))}`;
-};
-const buildCategoryTally = (categoryGroup) => ({
-	category: categoryGroup.category,
-	errorCount: categoryGroup.diagnostics.filter((diagnostic) => diagnostic.severity === "error").length,
-	warningCount: categoryGroup.diagnostics.filter((diagnostic) => diagnostic.severity === "warning").length
-});
-const buildCategoryTallyLines = (tallies) => tallies.map((tally) => formatCategoryTallyLine(tally, tally.errorCount, tally.warningCount));
-const buildPartiallyRevealedTallyLines = (tallies, revealedUnitCount) => {
-	let remainingToReveal = revealedUnitCount;
-	return tallies.map((tally) => {
-		const errorShown = Math.min(tally.errorCount, remainingToReveal);
-		remainingToReveal -= errorShown;
-		const warningShown = Math.min(tally.warningCount, remainingToReveal);
-		remainingToReveal -= warningShown;
-		return formatCategoryTallyLine(tally, errorShown, warningShown);
-	});
-};
-const printCategoryCountUp = (tallies) => gen(function* () {
-	const totalUnitCount = tallies.reduce((sum, tally) => sum + tally.errorCount + tally.warningCount, 0);
-	const unitsPerStep = Math.max(1, Math.ceil(totalUnitCount / 24));
-	for (let revealedUnitCount = 0; revealedUnitCount < totalUnitCount; revealedUnitCount += unitsPerStep) {
-		const lines = buildPartiallyRevealedTallyLines(tallies, revealedUnitCount);
-		yield* writeStdout(`${revealedUnitCount === 0 ? "" : `\x1b[${tallies.length}A`}\r${lines.join("\n\r")}\n`);
-		yield* sleep(70);
-	}
-	yield* writeStdout(`${totalUnitCount === 0 ? "" : `\x1b[${tallies.length}A`}\r${buildCategoryTallyLines(tallies).join("\n\r")}\n`);
-	yield* sleep(CATEGORY_COUNTUP_SETTLE_HOLD_MS);
-});
-const TOP_ERROR_DETAIL_INDENT = "    ";
-const pickRepresentativeDiagnostic = (ruleDiagnostics) => ruleDiagnostics.find((diagnostic) => diagnostic.line > 0) ?? ruleDiagnostics[0];
-const hasIndistinctSiteLocations = (ruleDiagnostics) => {
-	const firstDiagnostic = ruleDiagnostics[0];
-	if (firstDiagnostic === void 0) return false;
-	return ruleDiagnostics.every((diagnostic) => diagnostic.line <= 0 && diagnostic.filePath === firstDiagnostic.filePath);
-};
-const FRAME_CONTEXT_REACH_LINES = 3;
-const clusterNearbyDiagnostics = (diagnostics) => {
-	const byFile = groupBy(diagnostics, (diagnostic) => diagnostic.filePath);
-	const clusters = [];
-	for (const fileDiagnostics of byFile.values()) {
-		const sorted = [...fileDiagnostics].sort((left, right) => left.line - right.line);
-		let current = [];
-		const flush = () => {
-			if (current.length === 0) return;
-			clusters.push({
-				diagnostics: current,
-				startLine: current[0].line,
-				endLine: current[current.length - 1].line
-			});
-			current = [];
-		};
-		for (const diagnostic of sorted) {
-			const previous = current[current.length - 1];
-			if (previous != null && (diagnostic.line - previous.line > FRAME_CONTEXT_REACH_LINES || diagnostic.line - current[0].line > 20)) flush();
-			current.push(diagnostic);
-		}
-		flush();
-	}
-	return clusters;
-};
-const formatClusterLocationText = (cluster) => {
-	const { filePath } = cluster.diagnostics[0];
-	if (cluster.startLine <= 0) return filePath;
-	if (cluster.endLine > cluster.startLine) return `${filePath}:${cluster.startLine}-${cluster.endLine}`;
-	return `${filePath}:${cluster.startLine}`;
-};
-const formatClusterLocation = (cluster, resolveSourceRoot, hyperlinks) => {
-	const lead = cluster.diagnostics[0];
-	const contextTag = formatFileContextTag(lead);
-	const location = formatClusterLocationText(cluster);
-	if (!hyperlinks) return `${location}${contextTag}`;
-	return `${formatHyperlink(location, pathToFileURL(resolveAbsolutePath(lead.filePath, resolveSourceRoot(lead))).href)}${contextTag}`;
-};
-const buildDiagnosticClusterLines = (cluster, resolveSourceRoot, resolveFrameSourceRoot, renderCodeFrame, hyperlinks) => {
-	const lead = cluster.diagnostics[0];
-	const isMultiSite = cluster.diagnostics.length > 1;
-	const sourceRoot = resolveSourceRoot(lead);
-	const frameSourceRoot = resolveFrameSourceRoot(lead);
-	const frameFilePath = Path.isAbsolute(lead.filePath) && sourceRoot !== frameSourceRoot ? Path.relative(sourceRoot, lead.filePath) : lead.filePath;
-	const lines = ["", highlighter.gray(`${TOP_ERROR_DETAIL_INDENT}${formatClusterLocation(cluster, resolveSourceRoot, hyperlinks)}`)];
-	const codeFrame = renderCodeFrame ? buildCodeFrame({
-		filePath: frameFilePath,
-		line: cluster.startLine,
-		column: isMultiSite ? 0 : lead.column,
-		endLine: isMultiSite ? cluster.endLine : void 0,
-		rootDirectory: frameSourceRoot
-	}) : null;
-	if (codeFrame) {
-		const boxInnerWidth = resolveMeasureWidth(8);
-		lines.push(indentMultilineText(boxText(codeFrame, boxInnerWidth), TOP_ERROR_DETAIL_INDENT));
-	}
-	const seenHints = /* @__PURE__ */ new Set();
-	for (const diagnostic of cluster.diagnostics) if (diagnostic.suppressionHint && !seenHints.has(diagnostic.suppressionHint)) {
-		seenHints.add(diagnostic.suppressionHint);
-		lines.push(highlighter.gray(`${TOP_ERROR_DETAIL_INDENT}↳ ${diagnostic.suppressionHint}`));
-	}
-	return lines;
-};
-const buildRuleDetailBlock = (ruleKey, ruleDiagnostics, resolveSourceRoot, resolveFrameSourceRoot, renderEverySite, isAgentEnvironment, hyperlinks) => {
-	const representative = pickRepresentativeDiagnostic(ruleDiagnostics);
-	const { severity } = representative;
-	const trailingBadge = formatTrailingSiteBadge(ruleDiagnostics.length);
-	const headline = colorizeBySeverity(`${representative.category}: ${representative.title ?? ruleKey}`, severity);
-	const lines = [`  ${colorizeBySeverity(severity === "error" ? "✖" : "⚠", severity)} ${headline}${trailingBadge}`];
-	if (renderEverySite && !isAgentEnvironment) {
-		const learnMoreLine = formatLearnMoreLine(representative);
-		if (learnMoreLine) lines.push(`${TOP_ERROR_DETAIL_INDENT}${highlighter.info(learnMoreLine)}`);
-	}
-	const isCollapsedWarningGroup = severity === "warning" && hasIndistinctSiteLocations(ruleDiagnostics);
-	const impactMessages = isCollapsedWarningGroup ? [...new Set(ruleDiagnostics.map((diagnostic) => diagnostic.message))] : [representative.message];
-	for (const impactMessage of impactMessages) for (const explanationLine of wrapTextToWidth(impactMessage, resolveMeasureWidth(4), { breakLongWords: false })) lines.push(`${TOP_ERROR_DETAIL_INDENT}${explanationLine}`);
-	if (representative.help) for (const fixLine of wrapTextToWidth(`→ ${representative.help}`, resolveMeasureWidth(4), { breakLongWords: false })) lines.push(highlighter.dim(`${TOP_ERROR_DETAIL_INDENT}${fixLine}`));
-	const sharedFixSiteCount = getSharedFixSiteCount(ruleDiagnostics);
-	if (sharedFixSiteCount > 0) lines.push(highlighter.dim(`${TOP_ERROR_DETAIL_INDENT}↳ One fix clears all ${sharedFixSiteCount} findings.`));
-	if (renderEverySite && isAgentEnvironment) {
-		const fixRecipeLine = formatFixRecipeLine(representative);
-		if (fixRecipeLine) lines.push(highlighter.gray(`${TOP_ERROR_DETAIL_INDENT}${fixRecipeLine}`));
-	}
-	const renderCodeFrame = severity === "error";
-	const sites = renderEverySite ? ruleDiagnostics : [representative];
-	if (!(isCollapsedWarningGroup && representative.help.includes(representative.filePath))) for (const cluster of clusterNearbyDiagnostics(sites)) lines.push(...buildDiagnosticClusterLines(cluster, resolveSourceRoot, resolveFrameSourceRoot, renderCodeFrame, hyperlinks));
-	return lines;
-};
-const selectErrorRuleGroups = (diagnostics, rulePriority) => buildSortedRuleGroups(diagnostics.filter((diagnostic) => diagnostic.severity === "error"), rulePriority);
-const selectTopErrorRuleGroups = (diagnostics, limit, rulePriority) => selectErrorRuleGroups(diagnostics, rulePriority).slice(0, limit);
-const buildOverflowSummaryLine = (diagnostics, rulePriority) => {
-	const errorRuleGroups = selectErrorRuleGroups(diagnostics, rulePriority);
-	const shownErrorRuleCount = Math.min(3, errorRuleGroups.length);
-	if (diagnostics.length <= shownErrorRuleCount) return void 0;
-	const command = highlighter.bold(highlighter.info("npx react-doctor@latest --verbose"));
-	return `  ${highlighter.dim("Run")} ${command} ${highlighter.dim("to list every error and warning")}`;
-};
-const formatMigrationBucketLine = (bucket) => `${TOP_ERROR_DETAIL_INDENT}${bucket.title} ${highlighter.gray(`×${bucket.siteCount} across ${bucket.fileCount} files`)}`;
-const buildMigrationScaleAdvisoryLines = (diagnostics) => {
-	const buckets = findMigrationScaleBuckets(diagnostics);
-	if (buckets.length === 0) return [];
-	const shownBuckets = buckets.slice(0, 3);
-	const lines = [`  ${highlighter.warn("⚠")} ${highlighter.bold("Migration-scale change")}${highlighter.dim(": sample before you sweep")}`, ...shownBuckets.map(formatMigrationBucketLine)];
-	const remainingBuckets = buckets.length - shownBuckets.length;
-	if (remainingBuckets > 0) lines.push(highlighter.gray(`${TOP_ERROR_DETAIL_INDENT}+${remainingBuckets} more ${remainingBuckets === 1 ? "rule" : "rules"} at this scale`));
-	for (const guidanceLine of wrapTextToWidth("Fixing all of them at once is hard to review and prone to subtle mistakes across the whole repo. Fix a representative few first and confirm the recipe holds. Then get the code owner's sign-off before changing the rest.", resolveMeasureWidth(4), { breakLongWords: false })) lines.push(highlighter.dim(`${TOP_ERROR_DETAIL_INDENT}${guidanceLine}`));
-	const command = highlighter.info("npx react-doctor@latest <path>");
-	lines.push(`${TOP_ERROR_DETAIL_INDENT}${highlighter.dim("Scope it down one area at a time:")} ${command}`);
-	return lines;
-};
-const getTopErrorRuleKeys = (diagnostics, limit, rulePriority) => new Set(selectTopErrorRuleGroups(diagnostics, limit, rulePriority).map(([ruleKey]) => ruleKey));
-const buildTopErrorsSection = (diagnostics, resolveSourceRoot, resolveFrameSourceRoot, hyperlinks, rulePriority) => {
-	const topRuleGroups = selectErrorRuleGroups(diagnostics, rulePriority).slice(0, 3);
-	if (topRuleGroups.length === 0) return {
-		lines: [],
-		blockOffsets: []
-	};
-	const lines = [`  ${highlighter.bold(`Top ${topRuleGroups.length} ${topRuleGroups.length === 1 ? "error" : "errors"} you should fix`)}`, ""];
-	const blockOffsets = [];
-	for (const [ruleKey, ruleDiagnostics] of topRuleGroups) {
-		blockOffsets.push(lines.length);
-		lines.push(...buildRuleDetailBlock(ruleKey, ruleDiagnostics, resolveSourceRoot, resolveFrameSourceRoot, false, false, hyperlinks));
-		lines.push("");
-	}
-	return {
-		lines,
-		blockOffsets
-	};
-};
-const joinSections = (...sections) => {
-	const lines = [];
-	const sectionStarts = [];
-	for (const section of sections) {
-		if (section.length === 0) {
-			sectionStarts.push(null);
-			continue;
-		}
-		if (lines.length > 0) lines.push("");
-		sectionStarts.push(lines.length);
-		lines.push(...section);
-	}
-	if (lines.length > 0 && lines[lines.length - 1] !== "") lines.push("");
-	return {
-		lines,
-		sectionStarts
-	};
-};
-const buildOverviewHeaderLines = (diagnostics) => {
-	const totalIssueCount = diagnostics.length;
-	if (totalIssueCount === 0) return [];
-	const issueNoun = totalIssueCount === 1 ? "issue" : "issues";
-	return [`  ${highlighter.bold(`All ${totalIssueCount} ${issueNoun}`)}`];
-};
-/**
-* Effect-typed diagnostics renderer. Internal helpers build the
-* line array purely; the IO happens once at the boundary with a
-* single Effect.forEach over Console.log so failures or fiber
-* interruption produce predictable partial output.
-*/
-const printDiagnostics = (diagnostics, isVerbose, sourceRoot, rulePriority, isAgentEnvironment = false, onboarding = {}, hyperlinks = false, frameSourceRoot = sourceRoot) => gen(function* () {
-	const sectionPause = onboarding.sectionPause ?? void_;
-	const animateCountUp = onboarding.animateCountUp ?? false;
-	const resolveSourceRoot = typeof sourceRoot === "function" ? sourceRoot : () => sourceRoot;
-	const resolveFrameSourceRoot = typeof frameSourceRoot === "function" ? frameSourceRoot : () => frameSourceRoot;
-	let detailLines;
-	let topErrorBlockOffsets = [];
-	if (!isVerbose) {
-		const topErrors = buildTopErrorsSection(diagnostics, resolveSourceRoot, resolveFrameSourceRoot, hyperlinks, rulePriority);
-		detailLines = topErrors.lines;
-		topErrorBlockOffsets = topErrors.blockOffsets;
-	} else detailLines = buildSortedRuleGroups(diagnostics, rulePriority).flatMap(([ruleKey, ruleDiagnostics]) => {
-		return [...buildRuleDetailBlock(ruleKey, ruleDiagnostics, resolveSourceRoot, resolveFrameSourceRoot, true, isAgentEnvironment, hyperlinks), ""];
-	});
-	const overflowLine = isVerbose ? void 0 : buildOverflowSummaryLine(diagnostics, rulePriority);
-	const categoryTallies = buildCategoryDiagnosticGroups(diagnostics, rulePriority).map(buildCategoryTally);
-	const categoryLines = buildCategoryTallyLines(categoryTallies);
-	const overviewDividerLines = detailLines.length > 0 && categoryLines.length > 0 ? [buildSectionDivider()] : [];
-	const { lines, sectionStarts } = joinSections(detailLines, overviewDividerLines, buildOverviewHeaderLines(diagnostics), categoryLines, overflowLine ? [overflowLine] : [], buildMigrationScaleAdvisoryLines(diagnostics));
-	const [detailStart, , , categoryStart] = sectionStarts;
-	const pauseBeforeLineIndices = detailStart == null ? /* @__PURE__ */ new Set() : new Set(topErrorBlockOffsets.map((offset) => detailStart + offset));
-	let lineIndex = 0;
-	while (lineIndex < lines.length) {
-		if (animateCountUp && lineIndex === categoryStart && categoryLines.length > 0) {
-			yield* printCategoryCountUp(categoryTallies);
-			lineIndex += categoryLines.length;
-			continue;
-		}
-		if (pauseBeforeLineIndices.has(lineIndex)) yield* sectionPause;
-		yield* log(lines[lineIndex]);
-		lineIndex += 1;
-	}
-});
-const formatElapsedTime = (elapsedMilliseconds) => {
-	if (elapsedMilliseconds < 1e3) return `${Math.round(elapsedMilliseconds)}ms`;
-	return `${(elapsedMilliseconds / MILLISECONDS_PER_SECOND).toFixed(1)}s`;
-};
-const formatRuleSummary = (ruleKey, ruleDiagnostics) => {
-	const firstDiagnostic = ruleDiagnostics[0];
-	const distinctMessages = [...new Set(ruleDiagnostics.map((diagnostic) => diagnostic.message))];
-	const sections = [
-		`Rule: ${ruleKey}`,
-		`Severity: ${firstDiagnostic.severity}`,
-		`Category: ${firstDiagnostic.category}`,
-		`Count: ${ruleDiagnostics.length}`,
-		"",
-		distinctMessages.join("\n\n")
-	];
-	if (firstDiagnostic.help) sections.push("", `Suggestion: ${firstDiagnostic.help}`);
-	if (firstDiagnostic.url) sections.push("", `Docs: ${firstDiagnostic.url}`);
-	const fixRecipeLine = formatFixRecipeLine(firstDiagnostic);
-	if (fixRecipeLine) sections.push("", fixRecipeLine);
-	sections.push("", "Files:");
-	const fileEntries = buildVerboseFileEntries(ruleDiagnostics);
-	for (const [filePath, { contextTag, sites }] of fileEntries) if (sites.length > 0) for (const site of sites) {
-		sections.push(`  ${filePath}:${site.line}${contextTag}`);
-		if (site.suppressionHint) sections.push(`    ${site.suppressionHint}`);
-	}
-	else sections.push(`  ${filePath}${contextTag}`);
-	return sections.join("\n") + "\n";
-};
-//#endregion
-//#region src/cli/utils/compute-score-projection.ts
-const computeProjectedScore = async (topErrorSource, rescoreSource, currentScore) => {
-	const topErrorRuleKeys = getTopErrorRuleKeys(topErrorSource, 3, buildRulePriorityMap([currentScore]));
-	if (topErrorRuleKeys.size === 0) return null;
-	const potentialScore = await calculateScore(rescoreSource.filter((diagnostic) => !topErrorRuleKeys.has(`${diagnostic.plugin}/${diagnostic.rule}`)));
-	if (!potentialScore || potentialScore.score <= currentScore.score) return null;
-	return potentialScore.score;
-};
-//#endregion
-//#region src/cli/utils/filter-diagnostics-by-categories.ts
-const filterDiagnosticsByCategories = (diagnostics, categories) => categories.size === 0 ? [...diagnostics] : diagnostics.filter((diagnostic) => categories.has(diagnostic.category));
-//#endregion
-//#region src/cli/utils/supports-hyperlinks.ts
-const HYPERLINK_CAPABLE_TERM_PROGRAMS = new Set([
-	"iTerm.app",
-	"WezTerm",
-	"vscode",
-	"Hyper",
-	"ghostty",
-	"Tabby",
-	"rio"
-]);
-const parseVteVersion = (raw) => {
-	const parsed = Number.parseInt(raw ?? "", 10);
-	return Number.isNaN(parsed) ? 0 : parsed;
-};
-/**
-* Whether `stream` is a terminal that renders OSC 8 hyperlinks. Auto-detected
-* from terminal-identity env vars; the de-facto `FORCE_HYPERLINK` env var
-* overrides detection (`FORCE_HYPERLINK=0`/`false` forces off, any other value
-* forces on), mirroring how the ecosystem's terminal libraries gate the same
-* feature. Off for non-TTYs, `TERM=dumb`, and CI (whose log viewers render the
-* raw escape rather than a link). Unknown terminals default to off.
-*/
-const supportsHyperlinks = (stream = process.stdout, env = process.env) => {
-	const forced = env.FORCE_HYPERLINK;
-	if (forced !== void 0 && forced !== "") return forced !== "0" && forced.toLowerCase() !== "false";
-	if (stream.isTTY !== true) return false;
-	if (env.TERM === "dumb") return false;
-	if (isCiEnvironment(env)) return false;
-	if (env.WT_SESSION) return true;
-	if (env.KITTY_WINDOW_ID || env.TERM === "xterm-kitty") return true;
-	if (parseVteVersion(env.VTE_VERSION) >= 5e3) return true;
-	return Boolean(env.TERM_PROGRAM && HYPERLINK_CAPABLE_TERM_PROGRAMS.has(env.TERM_PROGRAM));
-};
-//#endregion
-//#region src/cli/utils/should-render-hyperlinks.ts
-/**
-* Whether to emit OSC 8 clickable `file:line` locations for this run: a
-* hyperlink-capable terminal AND not a coding agent (whose output parsers
-* would choke on the escape sequences).
-*/
-const shouldRenderHyperlinks = (stream = process.stdout) => supportsHyperlinks(stream) && !isCodingAgentEnvironment();
-//#endregion
-//#region src/cli/utils/should-show-share-link.ts
-const shouldShowShareLink = ({ noScore, share, isCi }) => !noScore && share && !isCi;
-const FORCE_ONBOARDING_ENV_VAR = "REACT_DOCTOR_FORCE_ONBOARDING";
-const FALSY_FLAG_VALUES = new Set([
-	"",
-	"0",
-	"false"
-]);
-const isOnboardingForced = (environment = process.env) => {
-	const value = environment[FORCE_ONBOARDING_ENV_VAR];
-	return value !== void 0 && !FALSY_FLAG_VALUES.has(value.toLowerCase());
-};
-const onboardingSectionPause = (shouldPace) => shouldPace ? sleep(850) : void_;
-const shouldRecordOnboarding = (input) => input.paceOnboardingSections && !input.forceOnboarding && !input.verbose && !input.isNonInteractiveEnvironment;
-const canAnimateOnboarding = (stream = process.stdout) => {
-	if (!(stream.isTTY === true && (stream.columns ?? 0) > 0 && process.env.TERM !== "dumb")) return false;
-	if (isOnboardingForced()) return true;
-	return !isGitHookEnvironment() && !isCiEnvironment();
-};
-//#endregion
-//#region src/cli/utils/now-iso.ts
-const nowIso = () => (/* @__PURE__ */ new Date()).toISOString();
-const ONBOARDING_EVENT = "onboarding";
-const CI_PITCH_EVENT = "ci-pitch";
-const ACTION_UPGRADE_EVENT = "action-upgrade-v2";
-const SETUP_HINT_EVENT = "setup-hint";
-const HANDOFF_TARGET_PREFERENCE_ID = "handoff-target";
-const INSTALL_AGENTS_PREFERENCE_ID = "install-agents";
-const foldLegacyDecisions = (projects, legacy, eventId) => {
-	for (const [hash, record] of Object.entries(legacy ?? {})) {
-		const existing = projects[hash] ?? { rootDirectory: record.rootDirectory ?? "" };
-		projects[hash] = {
-			...existing,
-			events: {
-				...existing.events,
-				[eventId]: {
-					firedAt: record.at ?? nowIso(),
-					version: 1,
-					...record.outcome ? { outcome: record.outcome } : {}
-				}
-			}
-		};
-	}
-};
-const migrateCliState = (state) => {
-	if (typeof state.schemaVersion === "number" && state.schemaVersion >= 2) return state;
-	const projects = {};
-	for (const [hash, record] of Object.entries(state.projects ?? {})) {
-		const carried = {
-			rootDirectory: record.rootDirectory,
-			...record.events ? { events: record.events } : {},
-			...record.migrations ? { migrations: record.migrations } : {}
-		};
-		projects[hash] = record.setupPrompt === false ? {
-			...carried,
-			events: {
-				...carried.events,
-				[SETUP_HINT_EVENT]: {
-					firedAt: nowIso(),
-					version: 1,
-					outcome: "declined"
-				}
-			}
-		} : carried;
-	}
-	foldLegacyDecisions(projects, state.ciPrompts, CI_PITCH_EVENT);
-	foldLegacyDecisions(projects, state.actionUpgrades, ACTION_UPGRADE_EVENT);
-	return {
-		schemaVersion: 2,
-		global: typeof state.onboardedAt === "string" ? { events: { [ONBOARDING_EVENT]: {
-			firedAt: state.onboardedAt,
-			version: 1
-		} } } : {},
-		projects
-	};
-};
-const resolveConfigDir = (options) => options.cwd ?? (process.env["REACT_DOCTOR_CONFIG_DIR"] || void 0);
-const openStore = (options = {}) => new Conf({
-	projectName: REACT_DOCTOR_CONFIG_PROJECT_NAME,
-	cwd: resolveConfigDir(options)
-});
-const openMigratedStore = (options) => {
-	const store = openStore(options);
-	const state = store.store;
-	const migrated = migrateCliState(state);
-	if (migrated !== state) store.store = migrated;
-	return store;
-};
-const readCliState = (select, fallback, options = {}) => {
-	try {
-		return select(openMigratedStore(options).store);
-	} catch {
-		return fallback;
-	}
-};
-const updateCliState = (update, options = {}) => {
-	try {
-		const store = openMigratedStore(options);
-		store.store = update(store.store);
-		return true;
-	} catch {
-		return false;
-	}
-};
-//#endregion
-//#region src/cli/utils/hash-project-root.ts
-const hashProjectRoot = (projectRoot) => createHash("sha256").update(Path.resolve(projectRoot)).digest("hex");
-//#endregion
-//#region src/cli/utils/cli-lifecycle.ts
-const versionOf = (item) => item.version ?? 1;
-const selectScope = (state, scoped, projectRoot) => scoped.scope === "global" ? state.global : projectRoot === void 0 ? void 0 : state.projects?.[hashProjectRoot(projectRoot)];
-const updateScope = (state, scoped, projectRoot, updateScopeState) => {
-	if (scoped.scope === "global") return {
-		...state,
-		global: updateScopeState(state.global ?? {})
-	};
-	if (projectRoot === void 0) return state;
-	const projectKey = hashProjectRoot(projectRoot);
-	const base = state.projects?.[projectKey] ?? { rootDirectory: Path.resolve(projectRoot) };
-	return {
-		...state,
-		projects: {
-			...state.projects,
-			[projectKey]: {
-				...base,
-				...updateScopeState(base)
-			}
-		}
-	};
-};
-const isGatePending = (gate, target = {}, options = {}) => {
-	if (gate.scope === "project" && target.projectRoot === void 0) return false;
-	return readCliState((state) => {
-		const record = selectScope(state, gate, target.projectRoot)?.events?.[gate.id];
-		return !record || record.version < versionOf(gate);
-	}, gate.fireWhenUnknown ?? false, options);
-};
-const recordGate = (gate, target = {}, options = {}) => updateCliState((state) => updateScope(state, gate, target.projectRoot, (scope) => ({
-	...scope,
-	events: {
-		...scope.events,
-		[gate.id]: {
-			firedAt: nowIso(),
-			version: versionOf(gate),
-			...target.outcome ? { outcome: target.outcome } : {}
-		}
-	}
-})), options);
-const readPreference = (preference, target = {}, options = {}) => readCliState((state) => selectScope(state, preference, target.projectRoot)?.preferences?.[preference.id] ?? null, null, options);
-const writePreference = (preference, value, target = {}, options = {}) => updateCliState((state) => updateScope(state, preference, target.projectRoot, (scope) => ({
-	...scope,
-	preferences: {
-		...scope.preferences,
-		[preference.id]: value
-	}
-})), options);
-const isMigrationPending = (migration, target = {}, options = {}) => {
-	if (migration.scope === "project" && target.projectRoot === void 0) return false;
-	return readCliState((state) => {
-		const record = selectScope(state, migration, target.projectRoot)?.migrations?.[migration.id];
-		return !record || record.version < versionOf(migration);
-	}, false, options);
-};
-const recordMigration = (migration, projectRoot, record, options) => updateCliState((state) => updateScope(state, migration, projectRoot, (scope) => ({
-	...scope,
-	migrations: {
-		...scope.migrations,
-		[migration.id]: record
-	}
-})), options);
-const runMigrations = async (migrations, target = {}, options = {}) => {
-	const results = [];
-	for (const migration of migrations) {
-		if (!isMigrationPending(migration, target, options)) {
-			results.push({
-				id: migration.id,
-				ran: false,
-				applied: true
-			});
-			continue;
-		}
-		let applied = false;
-		try {
-			applied = await migration.run({ projectRoot: target.projectRoot });
-		} catch {
-			applied = false;
-		}
-		if (applied) recordMigration(migration, target.projectRoot, {
-			ranAt: nowIso(),
-			version: versionOf(migration)
-		}, options);
-		results.push({
-			id: migration.id,
-			ran: true,
-			applied
-		});
-	}
-	return results;
-};
-//#endregion
-//#region src/cli/utils/onboarding-state.ts
-const ONBOARDING_GATE = {
-	id: ONBOARDING_EVENT,
-	scope: "global"
-};
-const hasCompletedOnboarding = (options = {}) => !isGatePending(ONBOARDING_GATE, {}, options);
-const markOnboardingComplete = (options = {}) => {
-	if (isGatePending(ONBOARDING_GATE, {}, options)) recordGate(ONBOARDING_GATE, {}, options);
-};
-//#endregion
-//#region src/cli/utils/colorize-by-score.ts
-const colorizeByScore = (text, score) => {
-	if (score >= 75) return highlighter.success(text);
-	if (score >= 50) return highlighter.warn(text);
-	return highlighter.error(text);
-};
-//#endregion
-//#region src/cli/utils/doctor-face.ts
-const doctorFace = (score) => {
-	if (score >= 75) return ["◠ ◠", " ▽ "];
-	if (score >= 50) return ["• •", " ─ "];
-	return ["x x", " ▽ "];
-};
-//#endregion
-//#region src/cli/utils/ease-out-cubic.ts
-const easeOutCubic = (progress) => 1 - (1 - progress) ** 3;
-//#endregion
-//#region src/cli/utils/render-score-header.ts
-const RAINBOW_HUE_SHIFT_PER_FRAME = 9;
-const RAINBOW_GRADIENT_WIDTH = 80;
-const RAINBOW_OKLCH_LIGHTNESS = .638;
-const RAINBOW_OKLCH_CHROMA = .129;
-const FACE_BOX_TOP_BORDER = "┌─────┐";
-const SCORE_RIGHT_COLUMN_OFFSET = 11;
-const getScoreBarWidth = () => resolveClampedWidth({
-	reservedColumns: SCORE_RIGHT_COLUMN_OFFSET + 1,
-	fullWidth: 50,
-	minWidth: 10
-});
-const buildScoreBarSegments = (filledCount) => {
-	const emptyCount = Math.max(0, getScoreBarWidth() - filledCount);
-	return {
-		filledSegment: "█".repeat(filledCount),
-		emptySegment: "░".repeat(emptyCount)
-	};
-};
-const getFilledCount = (score) => Math.round(score / 100 * getScoreBarWidth());
-const joinScoreHeaderFrame = (lines) => `${lines[0]}\n\r${lines[1]}\n\r${lines[2]}\n\r${lines[3]}\n`;
-const buildRawScoreBar = (displayScore) => {
-	const { filledSegment, emptySegment } = buildScoreBarSegments(getFilledCount(displayScore));
-	return filledSegment + emptySegment;
-};
-const buildScoreHeaderLine = (faceLine, rightColumnContent) => {
-	return `  ${faceLine}${rightColumnContent.length > 0 ? "  " : ""}${rightColumnContent}`;
-};
-const getRightColumnOffset = (faceLine) => `  ${faceLine}  `.length;
-const clampColorChannel = (value) => Math.max(0, Math.min(255, Math.round(value)));
-const encodeSrgb = (value) => value <= .0031308 ? value * 12.92 : 1.055 * value ** (1 / 2.4) - .055;
-const oklchToRgb = (lightness, chroma, hue) => {
-	const hueRadians = hue * Math.PI / 180;
-	const labA = chroma * Math.cos(hueRadians);
-	const labB = chroma * Math.sin(hueRadians);
-	const longCone = (lightness + .3963377774 * labA + .2158037573 * labB) ** 3;
-	const mediumCone = (lightness - .1055613458 * labA - .0638541728 * labB) ** 3;
-	const shortCone = (lightness - .0894841775 * labA - 1.291485548 * labB) ** 3;
-	return {
-		red: clampColorChannel(encodeSrgb(4.0767416621 * longCone - 3.3077115913 * mediumCone + .2309699292 * shortCone) * 255),
-		green: clampColorChannel(encodeSrgb(-1.2684380046 * longCone + 2.6097574011 * mediumCone - .3413193965 * shortCone) * 255),
-		blue: clampColorChannel(encodeSrgb(-.0041960863 * longCone - .7034186147 * mediumCone + 1.707614701 * shortCone) * 255)
-	};
-};
-const colorizeTrueColor = (text, { red, green, blue }) => `\x1b[38;2;${red};${green};${blue}m${text}\x1b[39m`;
-const colorizeRainbowText = (text, frame, offset = 0) => [...text].map((character, index) => {
-	if (character === " ") return character;
-	return colorizeTrueColor(character, oklchToRgb(RAINBOW_OKLCH_LIGHTNESS, RAINBOW_OKLCH_CHROMA, ((index + offset) / RAINBOW_GRADIENT_WIDTH * 360 + frame * RAINBOW_HUE_SHIFT_PER_FRAME) % 360));
-}).join("");
-const buildRainbowHeaderLine = (faceLine, rightColumnContent, frame) => colorizeRainbowText(buildScoreHeaderLine(faceLine, rightColumnContent), frame);
-const buildScoreBar = (displayScore, colorScore = displayScore) => {
-	const { filledSegment, emptySegment } = buildScoreBarSegments(getFilledCount(displayScore));
-	return colorizeByScore(filledSegment, colorScore) + highlighter.dim(emptySegment);
-};
-const buildProjectedScoreBar = (currentScore, potentialScore) => {
-	const barWidth = getScoreBarWidth();
-	const currentFill = getFilledCount(currentScore);
-	const potentialFill = Math.min(getFilledCount(potentialScore), barWidth);
-	const gainCount = Math.max(0, potentialFill - currentFill);
-	const emptyCount = Math.max(0, barWidth - currentFill - gainCount);
-	return colorizeByScore("█".repeat(currentFill), currentScore) + highlighter.dim(colorizeByScore("▓".repeat(gainCount), currentScore)) + highlighter.dim("░".repeat(emptyCount));
-};
-const BRANDING_LINE = `React Doctor ${highlighter.dim("(https://react.doctor)")}`;
-const RAW_BRANDING_LINE = "React Doctor (https://react.doctor)";
-const buildRawFaceLines = (score) => {
-	const [eyes, mouth] = doctorFace(score);
-	return [
-		FACE_BOX_TOP_BORDER,
-		`│ ${eyes} │`,
-		`│ ${mouth} │`,
-		"└─────┘"
-	];
-};
-const buildFaceRenderedLines = (score) => {
-	const colorize = (text) => colorizeByScore(text, score);
-	return buildRawFaceLines(score).map(colorize);
-};
-const buildScoreLine = (displayScore, finalScore, label) => {
-	const scoreNumber = colorizeByScore(`${displayScore}`, finalScore);
-	const scoreLabel = colorizeByScore(label, finalScore);
-	return `${scoreNumber} ${highlighter.dim(`/ 100`)} ${scoreLabel}`;
-};
-const buildRawScoreLine = (displayScore, label) => `${displayScore} / 100 ${label}`;
-const buildRainbowScoreHeaderFrame = ({ score, displayScore, label, frame }) => {
-	const rawFaceLines = buildRawFaceLines(score);
-	return joinScoreHeaderFrame([
-		buildRainbowHeaderLine(rawFaceLines[0] ?? "", buildRawScoreLine(displayScore, label), frame),
-		buildRainbowHeaderLine(rawFaceLines[1] ?? "", buildRawScoreBar(displayScore), frame),
-		buildRainbowHeaderLine(rawFaceLines[2] ?? "", RAW_BRANDING_LINE, frame),
-		buildRainbowHeaderLine(rawFaceLines[3] ?? "", "", frame)
-	]);
-};
-const buildFinalPerfectScoreHeaderFrame = (score, label, frame) => {
-	const rawFaceLines = buildRawFaceLines(score);
-	const renderedFaceLines = buildFaceRenderedLines(score);
-	const rainbowBarLine = colorizeRainbowText(buildRawScoreBar(score), frame, getRightColumnOffset(rawFaceLines[1] ?? ""));
-	return joinScoreHeaderFrame([
-		buildScoreHeaderLine(renderedFaceLines[0] ?? "", buildScoreLine(score, score, label)),
-		buildScoreHeaderLine(renderedFaceLines[1] ?? "", rainbowBarLine),
-		buildScoreHeaderLine(renderedFaceLines[2] ?? "", BRANDING_LINE),
-		buildScoreHeaderLine(renderedFaceLines[3] ?? "", "")
-	]);
-};
-const buildInitialScoreHeaderLine = ({ isPerfectScore, shouldAnimate, lineIndex, renderedFaceLine, rawFaceLine, rightColumnContent, rawRightColumnContent, score }) => {
-	if (!isPerfectScore) return buildScoreHeaderLine(renderedFaceLine, rightColumnContent);
-	if (shouldAnimate) return buildRainbowHeaderLine(rawFaceLine, rawRightColumnContent, 0);
-	if (lineIndex !== 1) return buildScoreHeaderLine(renderedFaceLine, rightColumnContent);
-	return buildScoreHeaderLine(renderedFaceLine, colorizeRainbowText(buildRawScoreBar(score), 0, getRightColumnOffset(rawFaceLine)));
-};
-const printAnimatedScore = (scoreFaceLine, barFaceLine, score, label, potentialScore) => gen(function* () {
-	const isPerfectScore = score === 100;
-	for (let frame = 0; frame <= 40; frame += 1) {
-		const progress = easeOutCubic(frame / 40);
-		const animatedScore = Math.round(score * progress);
-		if (isPerfectScore) {
-			yield* writeStdout(`${frame === 0 ? "" : "\x1B[4A"}\r${buildRainbowScoreHeaderFrame({
-				score,
-				displayScore: animatedScore,
-				label,
-				frame
-			})}`);
-			if (frame < 40) yield* sleep(50);
-			continue;
-		}
-		const animatedScoreLine = buildScoreLine(animatedScore, score, label);
-		const animatedBarLine = frame === 40 && potentialScore !== void 0 ? buildProjectedScoreBar(score, potentialScore) : buildScoreBar(animatedScore, score);
-		yield* writeStdout(`${frame === 0 ? "" : "\x1B[2A"}\r${buildScoreHeaderLine(scoreFaceLine, animatedScoreLine)}\n\r${buildScoreHeaderLine(barFaceLine, animatedBarLine)}\n`);
-		if (frame < 40) yield* sleep(50);
-	}
-	if (!isPerfectScore) return;
-	for (let frame = 0; frame < 16; frame += 1) {
-		yield* writeStdout(`\x1b[4A\r${buildRainbowScoreHeaderFrame({
-			score,
-			displayScore: score,
-			label,
-			frame
-		})}`);
-		yield* sleep(50);
-	}
-	yield* writeStdout(`\x1b[4A\r${buildFinalPerfectScoreHeaderFrame(score, label, 16)}\x1b[2A`);
-});
-const printScoreHeader = (scoreResult, potentialScore) => gen(function* () {
-	const isPerfectScore = scoreResult.score === 100;
-	const renderedFaceLines = buildFaceRenderedLines(scoreResult.score);
-	const rawFaceLines = buildRawFaceLines(scoreResult.score);
-	const shouldAnimate = !isSpinnerSilent() && canAnimateOnboarding(process.stdout);
-	const displayScore = shouldAnimate ? 0 : scoreResult.score;
-	const rightColumnLines = [
-		buildScoreLine(displayScore, scoreResult.score, scoreResult.label),
-		shouldAnimate ? buildScoreBar(0, scoreResult.score) : potentialScore !== void 0 ? buildProjectedScoreBar(scoreResult.score, potentialScore) : buildScoreBar(scoreResult.score),
-		BRANDING_LINE,
-		""
-	];
-	const rawRightColumnLines = [
-		buildRawScoreLine(displayScore, scoreResult.label),
-		buildRawScoreBar(displayScore),
-		RAW_BRANDING_LINE,
-		""
-	];
-	for (let lineIndex = 0; lineIndex < renderedFaceLines.length; lineIndex += 1) yield* log(buildInitialScoreHeaderLine({
-		isPerfectScore,
-		shouldAnimate,
-		lineIndex,
-		renderedFaceLine: renderedFaceLines[lineIndex] ?? "",
-		rawFaceLine: rawFaceLines[lineIndex] ?? "",
-		rightColumnContent: rightColumnLines[lineIndex] ?? "",
-		rawRightColumnContent: rawRightColumnLines[lineIndex] ?? "",
-		score: scoreResult.score
-	}));
-	yield* log("");
-	if (shouldAnimate) {
-		yield* writeStdout("\x1B[5A");
-		yield* printAnimatedScore(renderedFaceLines[0], renderedFaceLines[1], scoreResult.score, scoreResult.label, potentialScore);
-		yield* writeStdout("\x1B[3B");
-	}
-});
-const animateScoreProjection = (scoreResult, potentialScore, linesBelowBar) => gen(function* () {
-	if (scoreResult.score === 100 || potentialScore <= scoreResult.score) return;
-	const barFaceLine = buildFaceRenderedLines(scoreResult.score)[1] ?? "";
-	for (let frame = 1; frame <= 16; frame += 1) {
-		const progress = easeOutCubic(frame / 16);
-		const displayedPotential = scoreResult.score + (potentialScore - scoreResult.score) * progress;
-		yield* writeStdout(`\x1b[${linesBelowBar}A\r${buildScoreHeaderLine(barFaceLine, buildProjectedScoreBar(scoreResult.score, displayedPotential))}\x1b[${linesBelowBar}B\r`);
-		if (frame < 16) yield* sleep(35);
-	}
-});
-const printBrandingOnlyHeader = gen(function* () {
-	yield* log(`  ${BRANDING_LINE}`);
-	yield* log("");
-});
-const printNoScoreHeader = (noScoreMessage) => gen(function* () {
-	yield* log(`  ${BRANDING_LINE}`);
-	yield* log(`  ${highlighter.gray(noScoreMessage)}`);
-	yield* log("");
-});
-//#endregion
 //#region src/cli/utils/build-footer-description-lines.ts
 const FOOTER_DESCRIPTION_INDENT = "  ";
 const buildFooterDescriptionLines = (description) => {
@@ -83404,67 +82619,90 @@ const buildFooterLinkLines = ({ shareUrl }) => [
 	...buildFooterDescriptionLines("Report issues and star the repository!")
 ];
 //#endregion
-//#region src/cli/utils/write-diagnostics-directory.ts
-const ruleDumpFileName = (ruleKey) => ruleKey.replace(/\//g, "--") + ".txt";
-const readPreviousRuleDumpFileNames = (directory) => {
-	try {
-		const previous = JSON.parse(NFS.readFileSync(Path.join(directory, "diagnostics.json"), "utf8"));
-		return new Set(previous.filter((d) => typeof d?.plugin === "string" && typeof d?.rule === "string").map((d) => ruleDumpFileName(`${d.plugin}/${d.rule}`)));
-	} catch {
-		return /* @__PURE__ */ new Set();
-	}
-};
-const writeDiagnosticsDirectory = (diagnostics, outputDirectory) => {
-	const directory = outputDirectory ? Path.resolve(outputDirectory) : Path.join(tmpdir(), `react-doctor-${randomUUID()}`);
-	if (outputDirectory) for (const fileName of readPreviousRuleDumpFileNames(directory)) NFS.rmSync(Path.join(directory, fileName), { force: true });
-	NFS.mkdirSync(directory, { recursive: true });
-	for (const [ruleKey, ruleDiagnostics] of buildSortedRuleGroups(diagnostics)) NFS.writeFileSync(Path.join(directory, ruleDumpFileName(ruleKey)), formatRuleSummary(ruleKey, ruleDiagnostics));
-	NFS.writeFileSync(Path.join(directory, "diagnostics.json"), JSON.stringify(diagnostics));
-	return directory;
-};
+//#region src/cli/utils/build-section-divider.ts
+const DIVIDER_INDENT = "  ";
+const buildSectionDivider = () => highlighter.dim(`${DIVIDER_INDENT}${"─".repeat(resolveMeasureWidth(2))}`);
+//#endregion
+//#region src/cli/utils/collect-affected-files.ts
+const collectAffectedFiles = (diagnostics) => new Set(diagnostics.map((diagnostic) => diagnostic.filePath));
 //#endregion
-//#region src/cli/utils/render-summary.ts
-const buildShareUrl = (diagnostics, scoreResult, projectName) => {
-	const errorCount = diagnostics.filter((diagnostic) => diagnostic.severity === "error").length;
-	const warningCount = diagnostics.filter((diagnostic) => diagnostic.severity === "warning").length;
-	const affectedFileCount = collectAffectedFiles(diagnostics).size;
-	const params = new URLSearchParams();
-	params.set("p", projectName);
-	if (scoreResult) params.set("s", String(scoreResult.score));
-	if (errorCount > 0) params.set("e", String(errorCount));
-	if (warningCount > 0) params.set("w", String(warningCount));
-	if (affectedFileCount > 0) params.set("f", String(affectedFileCount));
-	return `${SHARE_BASE_URL}?${params.toString()}`;
+//#region src/cli/utils/print-footer.ts
+const buildShareUrl = (input) => {
+	const errorCount = input.diagnostics.filter((diagnostic) => diagnostic.severity === "error").length;
+	const warningCount = input.diagnostics.length - errorCount;
+	const affectedFileCount = collectAffectedFiles(input.diagnostics).size;
+	const parameters = new URLSearchParams({ p: input.projectName });
+	if (input.scoreResult) parameters.set("s", String(input.scoreResult.score));
+	if (errorCount > 0) parameters.set("e", String(errorCount));
+	if (warningCount > 0) parameters.set("w", String(warningCount));
+	if (affectedFileCount > 0) parameters.set("f", String(affectedFileCount));
+	return `${SHARE_BASE_URL}?${parameters.toString()}`;
 };
 const printFooter = (input) => gen(function* () {
 	yield* log("");
 	yield* log(buildSectionDivider());
 	yield* log("");
-	const shareUrl = input.isOffline ? null : buildShareUrl(input.diagnostics, input.scoreResult, input.projectName);
+	const shareUrl = input.isOffline ? null : buildShareUrl(input);
 	for (const line of buildFooterLinkLines({ shareUrl })) yield* log(line);
 });
-const printDiagnosticsDump = (diagnostics, outputDirectory, verbose, stream = "stdout") => gen(function* () {
-	const writtenDirectory = yield* try_({
-		try: () => writeDiagnosticsDirectory(diagnostics, outputDirectory),
-		catch: (cause) => cause
-	}).pipe(orElseSucceed(() => null));
-	if (writtenDirectory !== null && (verbose || outputDirectory)) {
-		const pathLine = highlighter.gray(`  Full diagnostics written to ${writtenDirectory}`);
-		yield* stream === "stderr" || Boolean(outputDirectory) && isJsonModeActive() ? sync(() => process.stderr.write(`${pathLine}\n`)) : log(pathLine);
+//#endregion
+//#region src/cli/utils/format-elapsed-time.ts
+const formatElapsedTime = (elapsedMilliseconds) => {
+	if (elapsedMilliseconds < 1e3) return `${Math.round(elapsedMilliseconds)}ms`;
+	return `${(elapsedMilliseconds / MILLISECONDS_PER_SECOND).toFixed(1)}s`;
+};
+//#endregion
+//#region src/cli/utils/pluralize.ts
+const pluralize = (count, singularNoun) => `${count} ${singularNoun}${count === 1 ? "" : "s"}`;
+//#endregion
+//#region src/cli/utils/print-headless-report.ts
+const formatContextTag = (diagnostic) => diagnostic.fileContext ? ` (${diagnostic.fileContext} file)` : "";
+const printHeadlessReport = (input) => gen(function* () {
+	yield* log(`${highlighter.success("✔")} Scanned ${pluralize(input.scannedFileCount, "file")} in ${formatElapsedTime(input.elapsedMilliseconds)}`);
+	yield* log("");
+	yield* log(highlighter.bold(`React Doctor — ${input.projectName}`));
+	if (input.scoreResult) yield* log(`Score: ${input.scoreResult.score} / 100 ${input.scoreResult.label}`);
+	else yield* log(highlighter.gray(input.noScoreMessage));
+	if (input.diagnostics.length === 0) {
+		yield* log("");
+		yield* log(highlighter.success(`✔ ${input.emptyStateMessage}`));
+	} else {
+		yield* log("");
+		yield* log(highlighter.bold(pluralize(input.diagnostics.length, "issue")));
+		const categoryCounts = /* @__PURE__ */ new Map();
+		for (const diagnostic of input.diagnostics) {
+			const counts = categoryCounts.get(diagnostic.category) ?? {
+				error: 0,
+				warning: 0
+			};
+			categoryCounts.set(diagnostic.category, {
+				error: counts.error + Number(diagnostic.severity === "error"),
+				warning: counts.warning + Number(diagnostic.severity === "warning")
+			});
+		}
+		for (const [category, counts] of categoryCounts) {
+			const countParts = [];
+			if (counts.error > 0) countParts.push(pluralize(counts.error, "error"));
+			if (counts.warning > 0) countParts.push(pluralize(counts.warning, "warning"));
+			yield* log(`${category}: ${countParts.join(", ")}`);
+		}
+		yield* log("");
+		for (const [ruleKey, ruleDiagnostics] of buildSortedRuleGroups(input.diagnostics)) {
+			const representativeDiagnostic = ruleDiagnostics[0];
+			if (representativeDiagnostic === void 0) continue;
+			const severityIcon = representativeDiagnostic.severity === "error" ? "✖" : "⚠";
+			const colorize = representativeDiagnostic.severity === "error" ? highlighter.error : highlighter.warn;
+			const occurrenceSuffix = ruleDiagnostics.length > 1 ? ` ×${ruleDiagnostics.length}` : "";
+			yield* log(colorize(`${severityIcon} ${representativeDiagnostic.title ?? ruleKey}${occurrenceSuffix}`));
+			yield* log(highlighter.gray(`  ${ruleKey}`));
+			for (const diagnostic of ruleDiagnostics) yield* log(`  ${formatDiagnosticSite(diagnostic)}${formatContextTag(diagnostic)}`);
+		}
+	}
+	if (input.skippedChecks.length > 0) {
+		yield* log("");
+		yield* warn$1(highlighter.warn(`Results are incomplete: ${input.skippedChecks.join(" and ")} checks failed.`));
 	}
 });
-const printSummary = (input) => gen(function* () {
-	if (input.scoreResult) {
-		const animateProjection = Boolean(input.animateProjection) && input.potentialScore != null && !input.verbose;
-		yield* printScoreHeader(input.scoreResult, animateProjection ? void 0 : input.potentialScore ?? void 0);
-		if (input.potentialScore != null) {
-			const improvement = input.potentialScore - input.scoreResult.score;
-			yield* log(highlighter.gray("  You could improve ") + colorizeByScore(`+${improvement}%`, input.potentialScore) + highlighter.gray(` by fixing the top 3 issues`));
-			if (animateProjection) yield* animateScoreProjection(input.scoreResult, input.potentialScore, 5);
-		}
-	} else yield* printNoScoreHeader(input.noScoreMessage);
-	yield* printDiagnosticsDump(input.diagnostics, input.outputDirectory, input.verbose);
-});
 //#endregion
 //#region src/cli/utils/resolve-oxlint-node.ts
 const consoleWarn = (message) => warn$1(highlighter.warn(message));
@@ -83538,15 +82776,6 @@ const resolveCliCategories = (categoryFlag) => {
 //#endregion
 //#region src/inspect.ts
 const silentConsole = makeNoopConsole();
-const recordOnboardingCompletion = (options) => {
-	const forceOnboarding = isOnboardingForced();
-	if (shouldRecordOnboarding({
-		paceOnboardingSections: !options.silent && !options.scoreOnly && !options.suppressRendering && !options.verbose && canAnimateOnboarding(process.stdout) && (forceOnboarding || !hasCompletedOnboarding()),
-		forceOnboarding,
-		verbose: options.verbose,
-		isNonInteractiveEnvironment: options.isNonInteractiveEnvironment
-	})) markOnboardingComplete();
-};
 const buildChangedLineMatcher = (directory, changedLineRanges) => {
 	const rangesByFile = /* @__PURE__ */ new Map();
 	for (const entry of changedLineRanges) rangesByFile.set(toForwardSlashes(entry.file), entry.ranges);
@@ -83826,7 +83055,7 @@ const runInspectWithRuntime = async (directory, options, userConfig, hasConfigOv
 		recordSentryProjectContext(cachedPayload.project, rootSentrySpan, { concurrentScan: options.concurrentScan });
 		recordCount(METRIC.projectDetected, 1);
 		const baselineDegraded = Boolean(options.baseline) && isDiffMode && cachedPayload.baselineDelta === void 0;
-		const result = await renderAndRecordScan({
+		return await renderAndRecordScan({
 			payload: cachedPayload,
 			options,
 			userConfig,
@@ -83837,8 +83066,6 @@ const runInspectWithRuntime = async (directory, options, userConfig, hasConfigOv
 			baselineDegraded,
 			wholeRepoCacheHit: true
 		});
-		recordOnboardingCompletion(options);
-		return result;
 	}
 	const shouldShowProgressSpinners = !options.isCiOrCodingAgentEnvironment && !options.silent && !options.scoreOnly && !options.suppressRendering && options.lint && Boolean(resolvedNodeBinaryPath);
 	const layers = buildRuntimeLayers({
@@ -83941,7 +83168,7 @@ const runInspectWithRuntime = async (directory, options, userConfig, hasConfigOv
 		suppressedRuleCounts: output.suppressedRuleCounts
 	};
 	if (cacheKey !== null && scanResultCache !== null && shouldStoreScanPayload(payload) && !baselineDegraded) scanResultCache.store(cacheKey, payload);
-	const result = await renderAndRecordScan({
+	return await renderAndRecordScan({
 		payload,
 		options,
 		userConfig,
@@ -83959,8 +83186,6 @@ const runInspectWithRuntime = async (directory, options, userConfig, hasConfigOv
 		deadCodeSummaryCacheHits: output.deadCodeSummaryCacheHits,
 		deadCodeSummaryCacheMisses: output.deadCodeSummaryCacheMisses
 	});
-	recordOnboardingCompletion(options);
-	return result;
 };
 const runMaybeSilent = (effect, silent) => silent ? effect.pipe(provideService$2(Console, silentConsole)) : effect;
 const renderAndRecordScan = async (input) => {
@@ -83979,7 +83204,6 @@ const renderAndRecordScan = async (input) => {
 		supplyChainOverlapTimedOut: input.payload.supplyChainOverlapTimedOut,
 		securityScanFailed: input.payload.securityScanFailed ?? false,
 		securityScanFailureReason: input.payload.securityScanFailureReason ?? null,
-		directory: input.payload.directory,
 		scannedFileCount: input.payload.scannedFileCount,
 		scannedFilePaths: input.payload.scannedFilePaths,
 		analyzedFiles: input.payload.analyzedFiles ?? [],
@@ -84030,7 +83254,7 @@ const renderAndRecordScan = async (input) => {
 	return result;
 };
 const finalizeAndRender = (input) => gen(function* () {
-	const { options, elapsedMilliseconds, diagnostics, score, project, userConfig, didLintFail, lintFailureReason, lintPartialFailures, didDeadCodeFail, deadCodeFailureReason, supplyChainOverlapTimedOut, securityScanFailed, securityScanFailureReason, directory, scannedFileCount, scannedFilePaths, analyzedFiles, scanElapsedMilliseconds, lintCacheHitFileCount, lintCacheTotalFileCount, lintSidecarReplayedFileCount, lintSidecarTotalFileCount, deadCodeCacheHit, deadCodeSummaryCacheHits, deadCodeSummaryCacheMisses, baselineDelta } = input;
+	const { options, elapsedMilliseconds, diagnostics, score, project, userConfig, didLintFail, lintFailureReason, lintPartialFailures, didDeadCodeFail, deadCodeFailureReason, supplyChainOverlapTimedOut, securityScanFailed, securityScanFailureReason, scannedFileCount, scannedFilePaths, analyzedFiles, scanElapsedMilliseconds, lintCacheHitFileCount, lintCacheTotalFileCount, lintSidecarReplayedFileCount, lintSidecarTotalFileCount, deadCodeCacheHit, deadCodeSummaryCacheHits, deadCodeSummaryCacheMisses, baselineDelta } = input;
 	const { skippedChecks, skippedCheckReasons } = buildSkippedChecks({
 		didLintFail,
 		lintFailureReason,
@@ -84082,69 +83306,32 @@ const finalizeAndRender = (input) => gen(function* () {
 		else yield* error$1(highlighter.gray(noScoreMessage));
 		return buildResult();
 	}
-	const animateRender = !options.silent && !options.verbose && canAnimateOnboarding(process.stdout);
-	const pause = onboardingSectionPause(animateRender);
-	const useHyperlinks = shouldRenderHyperlinks(process.stdout);
 	const demotedDiagnosticCount = diagnostics.length - surfaceDiagnostics.length;
-	const lintSourceFileCount = options.includePaths.length > 0 ? options.includePaths.length : project.sourceFileCount;
-	if (printedDiagnostics.length === 0) {
-		yield* pause;
-		if (hasSkippedChecks) {
-			const skippedLabel = skippedChecks.join(" and ");
-			yield* warn$1(highlighter.warn(`No issues detected, but ${skippedLabel} checks failed — results are incomplete.`));
-		} else yield* log(highlighter.success(buildEmptyReportMessage({
+	if (options.isNonInteractiveEnvironment && options.outputSurface !== "prComment") yield* printAgentGuidance();
+	yield* printHeadlessReport({
+		diagnostics: printedDiagnostics,
+		elapsedMilliseconds,
+		emptyStateMessage: buildEmptyReportMessage({
 			categoryFilters: options.categoryFilters,
 			demotedDiagnosticCount,
 			outputSurface: options.outputSurface
-		})));
-		yield* log("");
-		yield* pause;
-		if (hasSkippedChecks) {
-			yield* printBrandingOnlyHeader;
-			yield* log(highlighter.gray("  Score not shown — some checks could not complete."));
-		} else if (score) yield* printScoreHeader(score);
-		else yield* printNoScoreHeader(noScoreMessage);
-		if (options.outputDirectory !== null) yield* printDiagnosticsDump(printedDiagnostics, options.outputDirectory);
-		return buildResult();
-	}
-	yield* pause;
-	yield* log("");
-	yield* printDiagnostics([...printedDiagnostics], options.verbose, directory, buildRulePriorityMap([score]), isCodingAgentEnvironment(), {
-		sectionPause: pause,
-		animateCountUp: animateRender
-	}, useHyperlinks);
-	if (options.isNonInteractiveEnvironment && options.outputSurface !== "prComment") yield* printAgentGuidance();
-	if (options.categoryFilters.size === 0 && demotedDiagnosticCount > 0) {
-		yield* log(highlighter.gray(`  ${demotedDiagnosticCount} demoted from the ${options.outputSurface} surface (e.g. design cleanup) — run \`npx react-doctor@latest .\` locally for the full list.`));
-		yield* log("");
-	}
-	const scoreDiagnostics = filterDiagnosticsForSurface([...diagnostics], "score", userConfig);
-	const displayedScoreDiagnostics = filterDiagnosticsForSurface([...printedDiagnostics], "score", userConfig);
-	const potentialScore = score ? yield* promise(() => computeProjectedScore(displayedScoreDiagnostics, scoreDiagnostics, score)) : null;
-	const showShareLink = shouldShowShareLink(options);
-	yield* pause;
-	yield* printSummary({
-		diagnostics: [...printedDiagnostics],
-		elapsedMilliseconds,
-		scoreResult: score,
-		potentialScore,
-		totalSourceFileCount: lintSourceFileCount,
+		}),
 		noScoreMessage,
-		verbose: options.verbose,
-		outputDirectory: options.outputDirectory,
-		animateProjection: animateRender
+		projectName: project.projectName,
+		scannedFileCount,
+		scoreResult: hasSkippedChecks ? null : score,
+		skippedChecks
 	});
-	if (hasSkippedChecks) {
-		const skippedLabel = skippedChecks.join(" and ");
+	if (options.outputDirectory !== null || options.verbose) yield* printDiagnosticsDump(printedDiagnostics, options.outputDirectory, options.verbose);
+	if (options.categoryFilters.size === 0 && demotedDiagnosticCount > 0) {
+		yield* log(highlighter.gray(`  ${demotedDiagnosticCount} demoted from the ${options.outputSurface} surface (e.g. design cleanup) — run \`npx react-doctor@latest .\` locally for the full list.`));
 		yield* log("");
-		yield* warn$1(highlighter.warn(`  Note: ${skippedLabel} checks failed — score may be incomplete.`));
 	}
-	yield* pause;
 	yield* printFooter({
-		diagnostics: [...printedDiagnostics],
+		diagnostics: printedDiagnostics,
 		scoreResult: score,
 		projectName: project.projectName,
-		isOffline: !showShareLink
+		isOffline: options.isCi || !options.share || score === null
 	});
 	return buildResult();
 });
@@ -84175,9 +83362,6 @@ const collectProjectSourceFileCounts = async (rootDirectory, projectDirectories)
 //#region src/cli/utils/format-skipped-projects-message.ts
 const formatSkippedProjectsMessage = (projectCount) => `${projectCount} ${projectCount === 1 ? "project was" : "projects were"} skipped because the max scan duration was reached.`;
 //#endregion
-//#region src/cli/utils/is-share-opted-out.ts
-const isShareOptedOut = (scans, flagNoScore) => Boolean(flagNoScore) || scans.some((scan) => Boolean(scan.config?.noScore) || scan.config?.share === false);
-//#endregion
 //#region src/cli/utils/build-handoff-payload.ts
 const buildHandoffPayload = (input) => {
 	const topGroups = buildSortedRuleGroups(input.diagnostics).slice(0, 3);
@@ -84374,6 +83558,186 @@ const detectLaunchableAgents = async () => {
 	return CLI_AGENT_IDS.filter((agentId) => detected.has(agentId) && isCommandAvailable(CLI_AGENT_BINARIES[agentId]));
 };
 //#endregion
+//#region src/cli/utils/now-iso.ts
+const nowIso = () => (/* @__PURE__ */ new Date()).toISOString();
+const ONBOARDING_EVENT = "onboarding";
+const CI_PITCH_EVENT = "ci-pitch";
+const ACTION_UPGRADE_EVENT = "action-upgrade-v2";
+const SETUP_HINT_EVENT = "setup-hint";
+const HANDOFF_TARGET_PREFERENCE_ID = "handoff-target";
+const INSTALL_AGENTS_PREFERENCE_ID = "install-agents";
+const foldLegacyDecisions = (projects, legacy, eventId) => {
+	for (const [hash, record] of Object.entries(legacy ?? {})) {
+		const existing = projects[hash] ?? { rootDirectory: record.rootDirectory ?? "" };
+		projects[hash] = {
+			...existing,
+			events: {
+				...existing.events,
+				[eventId]: {
+					firedAt: record.at ?? nowIso(),
+					version: 1,
+					...record.outcome ? { outcome: record.outcome } : {}
+				}
+			}
+		};
+	}
+};
+const migrateCliState = (state) => {
+	if (typeof state.schemaVersion === "number" && state.schemaVersion >= 2) return state;
+	const projects = {};
+	for (const [hash, record] of Object.entries(state.projects ?? {})) {
+		const carried = {
+			rootDirectory: record.rootDirectory,
+			...record.events ? { events: record.events } : {},
+			...record.migrations ? { migrations: record.migrations } : {}
+		};
+		projects[hash] = record.setupPrompt === false ? {
+			...carried,
+			events: {
+				...carried.events,
+				[SETUP_HINT_EVENT]: {
+					firedAt: nowIso(),
+					version: 1,
+					outcome: "declined"
+				}
+			}
+		} : carried;
+	}
+	foldLegacyDecisions(projects, state.ciPrompts, CI_PITCH_EVENT);
+	foldLegacyDecisions(projects, state.actionUpgrades, ACTION_UPGRADE_EVENT);
+	return {
+		schemaVersion: 2,
+		global: typeof state.onboardedAt === "string" ? { events: { [ONBOARDING_EVENT]: {
+			firedAt: state.onboardedAt,
+			version: 1
+		} } } : {},
+		projects
+	};
+};
+const resolveConfigDir = (options) => options.cwd ?? (process.env["REACT_DOCTOR_CONFIG_DIR"] || void 0);
+const openStore = (options = {}) => new Conf({
+	projectName: REACT_DOCTOR_CONFIG_PROJECT_NAME,
+	cwd: resolveConfigDir(options)
+});
+const openMigratedStore = (options) => {
+	const store = openStore(options);
+	const state = store.store;
+	const migrated = migrateCliState(state);
+	if (migrated !== state) store.store = migrated;
+	return store;
+};
+const readCliState = (select, fallback, options = {}) => {
+	try {
+		return select(openMigratedStore(options).store);
+	} catch {
+		return fallback;
+	}
+};
+const updateCliState = (update, options = {}) => {
+	try {
+		const store = openMigratedStore(options);
+		store.store = update(store.store);
+		return true;
+	} catch {
+		return false;
+	}
+};
+//#endregion
+//#region src/cli/utils/hash-project-root.ts
+const hashProjectRoot = (projectRoot) => createHash("sha256").update(Path.resolve(projectRoot)).digest("hex");
+//#endregion
+//#region src/cli/utils/cli-lifecycle.ts
+const versionOf = (item) => item.version ?? 1;
+const selectScope = (state, scoped, projectRoot) => scoped.scope === "global" ? state.global : projectRoot === void 0 ? void 0 : state.projects?.[hashProjectRoot(projectRoot)];
+const updateScope = (state, scoped, projectRoot, updateScopeState) => {
+	if (scoped.scope === "global") return {
+		...state,
+		global: updateScopeState(state.global ?? {})
+	};
+	if (projectRoot === void 0) return state;
+	const projectKey = hashProjectRoot(projectRoot);
+	const base = state.projects?.[projectKey] ?? { rootDirectory: Path.resolve(projectRoot) };
+	return {
+		...state,
+		projects: {
+			...state.projects,
+			[projectKey]: {
+				...base,
+				...updateScopeState(base)
+			}
+		}
+	};
+};
+const isGatePending = (gate, target = {}, options = {}) => {
+	if (gate.scope === "project" && target.projectRoot === void 0) return false;
+	return readCliState((state) => {
+		const record = selectScope(state, gate, target.projectRoot)?.events?.[gate.id];
+		return !record || record.version < versionOf(gate);
+	}, gate.fireWhenUnknown ?? false, options);
+};
+const recordGate = (gate, target = {}, options = {}) => updateCliState((state) => updateScope(state, gate, target.projectRoot, (scope) => ({
+	...scope,
+	events: {
+		...scope.events,
+		[gate.id]: {
+			firedAt: nowIso(),
+			version: versionOf(gate),
+			...target.outcome ? { outcome: target.outcome } : {}
+		}
+	}
+})), options);
+const readPreference = (preference, target = {}, options = {}) => readCliState((state) => selectScope(state, preference, target.projectRoot)?.preferences?.[preference.id] ?? null, null, options);
+const writePreference = (preference, value, target = {}, options = {}) => updateCliState((state) => updateScope(state, preference, target.projectRoot, (scope) => ({
+	...scope,
+	preferences: {
+		...scope.preferences,
+		[preference.id]: value
+	}
+})), options);
+const isMigrationPending = (migration, target = {}, options = {}) => {
+	if (migration.scope === "project" && target.projectRoot === void 0) return false;
+	return readCliState((state) => {
+		const record = selectScope(state, migration, target.projectRoot)?.migrations?.[migration.id];
+		return !record || record.version < versionOf(migration);
+	}, false, options);
+};
+const recordMigration = (migration, projectRoot, record, options) => updateCliState((state) => updateScope(state, migration, projectRoot, (scope) => ({
+	...scope,
+	migrations: {
+		...scope.migrations,
+		[migration.id]: record
+	}
+})), options);
+const runMigrations = async (migrations, target = {}, options = {}) => {
+	const results = [];
+	for (const migration of migrations) {
+		if (!isMigrationPending(migration, target, options)) {
+			results.push({
+				id: migration.id,
+				ran: false,
+				applied: true
+			});
+			continue;
+		}
+		let applied = false;
+		try {
+			applied = await migration.run({ projectRoot: target.projectRoot });
+		} catch {
+			applied = false;
+		}
+		if (applied) recordMigration(migration, target.projectRoot, {
+			ranAt: nowIso(),
+			version: versionOf(migration)
+		}, options);
+		results.push({
+			id: migration.id,
+			ran: true,
+			applied
+		});
+	}
+	return results;
+};
+//#endregion
 //#region src/cli/utils/open-url.ts
 const resolveOpenCommand = (url) => {
 	if (process$1.platform === "darwin") return {
@@ -84619,6 +83983,48 @@ const resolveProjectScan = async (rootScanTarget, projectDirectory) => {
 	};
 };
 //#endregion
+//#region src/cli/utils/resolve-absolute-path.ts
+/**
+* Resolves a diagnostic's `filePath` (relative to its project root, or
+* already absolute) to an absolute path. Shared by the code-frame reader and
+* the terminal hyperlink builder so both turn a relative path into the same
+* on-disk location.
+*/
+const resolveAbsolutePath = (filePath, rootDirectory) => Path.isAbsolute(filePath) ? filePath : Path.resolve(rootDirectory || ".", filePath);
+//#endregion
+//#region src/cli/utils/build-code-frame.ts
+/**
+* Renders a syntax-highlighted source excerpt around a diagnostic site
+* with a caret pointing at the offending column. Returns null when the
+* file can't be read (e.g. multi-project summaries where paths are
+* resolved against a different cwd), so callers can fall back to the
+* bare `file:line` reference instead of failing the whole render.
+*/
+const buildCodeFrame = (input) => {
+	if (input.line <= 0) return null;
+	const absolutePath = resolveAbsolutePath(input.filePath, input.rootDirectory);
+	let source;
+	try {
+		source = NFS.readFileSync(absolutePath, "utf8");
+	} catch {
+		return null;
+	}
+	if ((source.split("\n", input.line)[input.line - 1] ?? "").length > 200) return null;
+	const location = input.endLine != null && input.endLine > input.line ? {
+		start: { line: input.line },
+		end: { line: input.endLine }
+	} : { start: {
+		line: input.line,
+		column: input.column > 0 ? input.column : void 0
+	} };
+	return codeFrameColumns(source, location, {
+		highlightCode: true,
+		linesAbove: 1,
+		linesBelow: 1,
+		...input.message ? { message: input.message } : {}
+	});
+};
+//#endregion
 //#region src/cli/utils/select-projects.ts
 const discoverWorkspacePackages = (rootDirectory) => {
 	const hasRootPackageJson = isFile(Path.join(rootDirectory, "package.json"));
@@ -84738,10 +84144,10 @@ const registerActiveTuiRenderer = (renderer) => {
 		if (activeTuiRenderer === renderer) activeTuiRenderer = null;
 	};
 };
-const clearActiveTuiRenderer = () => {
+const preserveActiveTuiRendererOutput = () => {
 	const renderer = activeTuiRenderer;
 	activeTuiRenderer = null;
-	renderer?.clear();
+	renderer?.preserveOutput();
 };
 //#endregion
 //#region src/cli/utils/exit-gracefully.ts
@@ -84750,7 +84156,7 @@ const exitGracefully = () => {
 	if (didStartExiting) return process.exit(130);
 	didStartExiting = true;
 	activeScanAbortRegistry.abortAll();
-	clearActiveTuiRenderer();
+	preserveActiveTuiRendererOutput();
 	try {
 		if (isJsonModeActive()) writeJsonErrorReport(/* @__PURE__ */ new Error("Scan cancelled by user (SIGINT/SIGTERM)"));
 		else console.log([
@@ -84765,7 +84171,7 @@ const exitGracefully = () => {
 	flushSentry().finally(() => process.exit(130));
 };
 //#endregion
-export { canAnimateOnboarding as $, isDebugFlagEnabled as $n, provide as $r, isFullWidth as $t, formatSkippedProjectsMessage as A, flushSentry as An, getEquivalentRuleKeys as Ar, buildWorkflowContent as At, colorizeByScore as B, writeJsonErrorReport as Bn, loadConfigWithSource as Br, prompts as Bt, CLI_AGENT_BINARIES as C, resolveGitPath as Cn, findLegacyConfig as Cr, recordRunTraceId as Ct, detectAvailableAgents as D, detectDefaultBranch as Dn, getCategoryImpact as Dr, warnDeprecatedDiff as Dt, computeDefaultSelectedAgents as E, writeJsonFile as En, getBaselineDiffPlan as Er, resolveScope as Et, printDiagnosticsDump as F, buildSentryScope as Fn, isPathInsideDirectory as Fr, upgradeReactDoctorWorkflowInPlace as Ft, recordGate as G, SENTRY_FLUSH_TIMEOUT_MS as Gn, setColorEnabled as Gr, DOCTOR_PACKAGE_NAME as Gt, markOnboardingComplete as H, VERSION as Hn, messageFromUnknown as Hr, openWorkflowPullRequest as Ht, printFooter as I, enableJsonMode as In, isPlainObject as Ir, upgradeWorkflowActionToV2 as It, ACTION_UPGRADE_EVENT as J, TUI_REPORT_COMPACT_MAX_ROWS as Jn, yieldToEventLoop as Jr, hasDoctorScript as Jt, runMigrations as K, STAGED_FILES_TEMP_DIR_PREFIX as Kn, toRelativePath as Kr, findNearestPackageDirectory as Kt, printSummary as L, isJsonModeActive as Ln, isReactDoctorError as Lr, workflowUsesV1Action as Lt, deduplicateProjectScans as M, isExpectedUserError as Mn, hasReactRuntime as Mr, installReactDoctorWorkflow as Mt, createInvocationInspect as N, formatEnvironmentError as Nn, highlighter as Nr, isReactDoctorWorkflowInstalled as Nt, buildHandoffPayload as O, runCommand as On, getChangedLineRanges as Or, isValidBlockingLevel as Ot, inspect as P, isEnvironmentError as Pn, isErrnoException as Pr, readReactDoctorWorkflow as Pt, SETUP_HINT_EVENT as Q, isNonInteractiveEnvironment as Qn, promise as Qr, spinner as Qt, easeOutCubic as R, setJsonReportDirectory as Rn, isSameRuleKey as Rr, recordCount as Rt, detectLaunchableAgents as S, readPackageJson as Sn, discoverReactSubprojects as Sr, getLastRunTraceId as St, launchCliAgent as T, runGitRaw as Tn, formatReactDoctorError as Tr, isScopeValue as Tt, isGatePending as U, CI_TRUST_COMPANIES as Un, remainingDeadlineBudgetMs as Ur, stageWorkflowFile as Ut, hasCompletedOnboarding as V, writeJsonReport as Vn, mapWithConcurrency as Vr, unrefStdin as Vt, readPreference as W, METRIC as Wn, resolveScanTarget as Wr, toForwardSlashes as Wt, HANDOFF_TARGET_PREFERENCE_ID as X, WELCOME_EXPLANATION_HOLD_MS as Xn, log as Xr, isSpinnerSilent as Xt, CI_PITCH_EVENT as Y, TUI_REPORT_DETAIL_WIDTH_FRACTION as Yn, error$1 as Yr, installReactDoctorScriptStep as Yt, INSTALL_AGENTS_PREFERENCE_ID as Z, CliInputError as Zn, gen as Zr, setSpinnerSilent as Zt, filterScansForSurface as _, getPackageJsonPath as _n, StagedFiles as _r, buildRulePriorityMap as _t, shouldFailScanGate as a, provide$2 as ai, HOOK_RELATIVE_PATH as an, CI_URL as ar, computeProjectedScore as at, reportWorkflowResult as b, packageHasNestedRecordKey as bn, clearConfigCache as br, formatLearnMoreLine as bt, selectProjects as c, LEGACY_HOOK_RUNNER_RELATIVE_PATH as cn, CONFIG_SCHEMA_URL as cr, writeStdout as ct, resolveProjectDiffIncludePaths as d, PRE_COMMIT_CONFIG_FILE as dn, Git as dr, buildCodeFrame as dt, runPromise as ei, isWide as en, isCiEnvironment as er, isOnboardingForced as et, resolveProjectSourceFilePaths as f, REACT_DOCTOR_COMMAND as fn, LEGACY_CONFIG_FILENAME as fr, buildEmptyReportMessage as ft, resolveCliInspectOptions as g, ensureTrailingNewline as gn, STAGED_FILES_PROJECT_CONFIG_FILENAMES as gr, hasLintHardFailure as gt, resolveWorkspaceDeadCodeOwner as h, VITE_PLUS_HOOKS_PATH as hn, SKILL_NAME as hr, resolveMergeBaseRef as ht, validateModeFlags as i, void_ as ii, HOOK_FILE_NAME as in, CANONICAL_GITHUB_URL as ir, filterDiagnosticsByCategories as it, collectProjectSourceFileCounts as j, initializeSentry as jn, hasPublishedFixRecipe as jr, getReactDoctorWorkflowPath as jt, isShareOptedOut as k, cliLogger as kn, getDiffInfo as kr, resolveBlockingLevel as kt, resolveProjectScan as l, NON_BLOCKING_REACT_DOCTOR_COMMAND as ln, DIAGNOSTIC_CATEGORY_BUCKETS as lr, indentMultilineText as lt, retryMissingProjectScores as m, SIMPLE_GIT_HOOKS_PACKAGE_JSON_KEY as mn, Reporter as mr, buildNoScoreMessage as mt, registerActiveTuiRenderer as n, sleep as ni, isUnicodeSupported as nn, isCodingAgentEnvironment as nr, shouldRenderHyperlinks as nt, projectManifestChanged as o, succeed$3 as oi, HUSKY_HOOKS_PATH as on, COMPILER_CLEANUP_BUCKET as or, formatElapsedTime as ot, resolveProjectRelativeDirectory as p, SIMPLE_GIT_HOOKS_CONFIG_FILE as pn, Progress as pr, hasIncompleteScoreAnalysis as pt, writePreference as q, STAGED_SNAPSHOT_ADDITIONAL_CONFIG_FILENAMES as qn, validateConfigTypes as qr, hasDoctorDependency as qt, validateIncludeUntrackedScope as r, sync as ri, chalk as rn, CANONICAL_DISCORD_URL as rr, supportsHyperlinks as rt, discoverWorkspacePackages as s, LEFTHOOK_CONFIG_FILES as sn, COMPILER_CLEANUP_RULE_KEYS as sr, printDiagnostics as st, exitGracefully as t, runSync as ti, stripAnsi as tn, isCiOrCodingAgentEnvironment as tr, shouldRecordOnboarding as tt, resolveProjectChangedLineRanges as u, OVERCOMMIT_CONFIG_FILE as un, GITHUB_ACTIONS_SETUP_URL as ur, formatHyperlink as ut, countUniqueScannedFiles as v, isRecord as vn, buildJsonReport as vr, buildSortedRuleGroups as vt, copyToClipboard as w, runGit as wn, formatErrorChain as wr, finalizeScope as wt, openUrl as x, packageHasRecordKey as xn, detectAiTrainingEnvironment as xr, getActiveRunTrace as xt, setUpGitHubActions as y, packageHasDependency as yn, buildRuleDocsUrl as yr, formatFixRecipeLine as yt, doctorFace as z, setJsonReportMode as zn, listWorkspacePackages as zr, recordDistribution as zt };
+export { filterDiagnosticsByCategories as $, GITHUB_ACTIONS_SETUP_URL as $n, PRE_COMMIT_CONFIG_FILE as $t, HANDOFF_TARGET_PREFERENCE_ID as A, VERSION as An, loadConfigWithSource as Ar, openWorkflowPullRequest as At, buildHandoffPayload as B, isNonInteractiveEnvironment as Bn, log as Br, spinner as Bt, isGatePending as C, buildSentryScope as Cn, highlighter as Cr, upgradeReactDoctorWorkflowInPlace as Ct, writePreference as D, setJsonReportMode as Dn, isReactDoctorError as Dr, recordDistribution as Dt, runMigrations as E, setJsonReportDirectory as En, isPlainObject as Er, recordCount as Et, CLI_AGENT_BINARIES as F, STAGED_FILES_TEMP_DIR_PREFIX as Fn, setColorEnabled as Fr, hasDoctorDependency as Ft, inspect as G, isCodingAgentEnvironment as Gn, sync as Gr, chalk as Gt, collectProjectSourceFileCounts as H, isDebugFlagEnabled as Hn, provide as Hr, isWide as Ht, copyToClipboard as I, STAGED_SNAPSHOT_ADDITIONAL_CONFIG_FILENAMES as In, toRelativePath as Ir, hasDoctorScript as It, formatElapsedTime as J, CI_URL as Jn, succeed$3 as Jr, HUSKY_HOOKS_PATH as Jt, printHeadlessReport as K, CANONICAL_DISCORD_URL as Kn, void_ as Kr, HOOK_FILE_NAME as Kt, launchCliAgent as L, TUI_REPORT_COMPACT_MAX_ROWS as Ln, validateConfigTypes as Lr, installReactDoctorScriptStep as Lt, ONBOARDING_EVENT as M, METRIC as Mn, messageFromUnknown as Mr, toForwardSlashes as Mt, SETUP_HINT_EVENT as N, MINIMUM_VTE_VERSION_FOR_HYPERLINKS as Nn, remainingDeadlineBudgetMs as Nr, DOCTOR_PACKAGE_NAME as Nt, ACTION_UPGRADE_EVENT as O, writeJsonErrorReport as On, isSameRuleKey as Or, prompts as Ot, detectLaunchableAgents as P, SENTRY_FLUSH_TIMEOUT_MS as Pn, resolveScanTarget as Pr, findNearestPackageDirectory as Pt, formatDiagnosticSite as Q, DIAGNOSTIC_CATEGORY_BUCKETS as Qn, OVERCOMMIT_CONFIG_FILE as Qt, computeDefaultSelectedAgents as R, TUI_REPORT_DETAIL_WIDTH_FRACTION as Rn, yieldToEventLoop as Rr, isSpinnerSilent as Rt, openUrl as S, isEnvironmentError as Sn, hasReactRuntime as Sr, readReactDoctorWorkflow as St, recordGate as T, isJsonModeActive as Tn, isPathInsideDirectory as Tr, workflowUsesV1Action as Tt, deduplicateProjectScans as U, isCiEnvironment as Un, runPromise as Ur, stripAnsi as Ut, formatSkippedProjectsMessage as V, isGitHookEnvironment as Vn, gen as Vr, isFullWidth as Vt, createInvocationInspect as W, isCiOrCodingAgentEnvironment as Wn, runSync as Wr, isUnicodeSupported as Wt, indentMultilineText as X, COMPILER_CLEANUP_RULE_KEYS as Xn, LEGACY_HOOK_RUNNER_RELATIVE_PATH as Xt, printFooter as Y, COMPILER_CLEANUP_BUCKET as Yn, LEFTHOOK_CONFIG_FILES as Yt, printDiagnosticsDump as Z, CONFIG_SCHEMA_URL as Zn, NON_BLOCKING_REACT_DOCTOR_COMMAND as Zt, resolveCliInspectOptions as _, cliLogger as _n, getCategoryImpact as _r, resolveBlockingLevel as _t, shouldFailScanGate as a, getPackageJsonPath as an, STAGED_FILES_PROJECT_CONFIG_FILENAMES as ar, buildRulePriorityMap as at, setUpGitHubActions as b, isExpectedUserError as bn, getEquivalentRuleKeys as br, installReactDoctorWorkflow as bt, selectProjects as c, packageHasNestedRecordKey as cn, buildRuleDocsUrl as cr, formatLearnMoreLine as ct, resolveProjectChangedLineRanges as d, resolveGitPath as dn, detectAiTrainingEnvironment as dr, recordRunTraceId as dt, REACT_DOCTOR_COMMAND as en, Git as er, buildEmptyReportMessage as et, resolveProjectDiffIncludePaths as f, runGit as fn, discoverReactSubprojects as fr, finalizeScope as ft, resolveWorkspaceDeadCodeOwner as g, runCommand as gn, getBaselineDiffPlan as gr, isValidBlockingLevel as gt, retryMissingProjectScores as h, detectDefaultBranch as hn, formatReactDoctorError as hr, warnDeprecatedDiff as ht, validateModeFlags as i, ensureTrailingNewline as in, SKILL_NAME as ir, hasLintHardFailure as it, INSTALL_AGENTS_PREFERENCE_ID as j, CI_TRUST_COMPANIES as jn, mapWithConcurrency as jr, stageWorkflowFile as jt, CI_PITCH_EVENT as k, writeJsonReport as kn, listWorkspacePackages as kr, unrefStdin as kt, buildCodeFrame as l, packageHasRecordKey as ln, calculateScore as lr, getActiveRunTrace as lt, resolveProjectRelativeDirectory as m, writeJsonFile as mn, formatErrorChain as mr, resolveScope as mt, registerActiveTuiRenderer as n, SIMPLE_GIT_HOOKS_PACKAGE_JSON_KEY as nn, Progress as nr, buildNoScoreMessage as nt, projectManifestChanged as o, isRecord as on, StagedFiles as or, buildSortedRuleGroups as ot, resolveProjectSourceFilePaths as p, runGitRaw as pn, findLegacyConfig as pr, isScopeValue as pt, pluralize as q, CANONICAL_GITHUB_URL as qn, provide$2 as qr, HOOK_RELATIVE_PATH as qt, validateIncludeUntrackedScope as r, VITE_PLUS_HOOKS_PATH as rn, Reporter as rr, resolveMergeBaseRef as rt, discoverWorkspacePackages as s, packageHasDependency as sn, buildJsonReport as sr, formatFixRecipeLine as st, exitGracefully as t, SIMPLE_GIT_HOOKS_CONFIG_FILE as tn, LEGACY_CONFIG_FILENAME as tr, hasIncompleteScoreAnalysis as tt, resolveProjectScan as u, readPackageJson as un, clearConfigCache as ur, getLastRunTraceId as ut, filterScansForSurface as v, flushSentry as vn, getChangedLineRanges as vr, buildWorkflowContent as vt, readPreference as w, enableJsonMode as wn, isErrnoException as wr, upgradeWorkflowActionToV2 as wt, reportWorkflowResult as x, formatEnvironmentError as xn, hasPublishedFixRecipe as xr, isReactDoctorWorkflowInstalled as xt, countUniqueScannedFiles as y, initializeSentry as yn, getDiffInfo as yr, getReactDoctorWorkflowPath as yt, detectAvailableAgents as z, CliInputError as zn, error$1 as zr, setSpinnerSilent as zt };
 
-//# sourceMappingURL=exit-gracefully-BN2OivAV.js.map
-//# debugId=07705956-10ec-5419-acea-25f57c6a08c5
+//# sourceMappingURL=exit-gracefully-Du1RQd8v.js.map
+//# debugId=ebadd5f4-f19b-552c-b2da-27e8355f567a