react-doctor 0.8.3 → 0.9.0-dev.1e67af0

package/dist/cli.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]="0dac14aa-8d32-5d22-8e5e-1d8d793e05c0")}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]="2fb9bb5f-dfff-55d9-9d36-af738b2c29ea")}catch(e){}}();
 import { createRequire } from "node:module";
 import * as NodeChildProcess from "node:child_process";
 import { execFile, execFileSync, spawn, spawnSync } from "node:child_process";
@@ -64656,6 +64656,13 @@ const IGNORED_DIRECTORIES = new Set([
 	"storybook-static"
 ]);
 const JSX_FILE_PATTERN = /\.(tsx|jsx)$/;
+const TYPESCRIPT_DECLARATION_FILE_PATTERN = /\.d\.(?:ts|mts|cts)$/;
+const OXLINT_IGNORED_DECLARATION_DIAGNOSTIC_CODES = new Set([
+	"TS(1036)",
+	"TS(1038)",
+	"TS(1183)",
+	"TS(1319)"
+]);
 const MILLISECONDS_PER_SECOND = 1e3;
 const REACT_ROUTER_CAPABILITY_THRESHOLDS = [
 	{
@@ -64957,6 +64964,14 @@ const DIAGNOSTIC_CATEGORY_BUCKETS = [
 	"Maintainability"
 ];
 const OCCURRENCE_MATCHED_CATEGORIES = new Set(["Accessibility"]);
+const CATEGORY_IMPACT_BY_NAME = new Map(Object.entries({
+	Security: "An attacker can read user data, act as your users, or run code you never shipped.",
+	Bugs: "Real users hit crashes, wrong output, or state that silently corrupts.",
+	Performance: "Users feel extra latency and wasted renders on every interaction.",
+	Accessibility: "Users on screen readers, keyboards, or assistive tech get locked out.",
+	Maintainability: "Every future change gets slower and riskier to make."
+}));
+const getCategoryImpact = (category) => CATEGORY_IMPACT_BY_NAME.get(category);
 const APP_ONLY_RULE_KEYS = new Set([
 	"react-hooks-js/static-components",
 	"react-doctor/no-render-prop-children",
@@ -64979,7 +64994,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.8.3";
+const CORE_PACKAGE_VERSION = "0.9.0";
 const DEAD_CODE_CACHE_FILENAME = "dead-code-cache.json";
 const DEAD_CODE_SUMMARY_CACHE_FILENAME = "dead-code-summaries.json";
 const SUPPLY_CHAIN_PLUGIN = "socket";
@@ -65700,18 +65715,20 @@ const getReactCompilerFlagState = (expression, analysis) => {
 	}
 	return null;
 };
-const getSelectedObjectProperty = (expression, propertyName, analysis) => {
+const getSelectedObjectProperty = (expression, propertyName, analysis, visitedExpressions = /* @__PURE__ */ new Set()) => {
 	let resolvedExpression = expression;
 	while (ts.isParenthesizedExpression(resolvedExpression) || ts.isAsExpression(resolvedExpression) || ts.isTypeAssertionExpression(resolvedExpression) || ts.isSatisfiesExpression(resolvedExpression) || ts.isNonNullExpression(resolvedExpression)) resolvedExpression = resolvedExpression.expression;
+	if (visitedExpressions.has(resolvedExpression)) return null;
+	visitedExpressions.add(resolvedExpression);
 	if (ts.isIdentifier(resolvedExpression)) {
 		if (analysis.localBindings.has(resolvedExpression.text)) {
 			const localInitializer = analysis.localBindings.get(resolvedExpression.text);
-			return localInitializer ? getSelectedObjectProperty(localInitializer, propertyName, analysis) : null;
+			return localInitializer ? getSelectedObjectProperty(localInitializer, propertyName, analysis, visitedExpressions) : null;
 		}
 		const scopedBinding = getScopedConfigBinding(resolvedExpression);
-		if (scopedBinding.wasFound) return scopedBinding.initializer ? getSelectedObjectProperty(scopedBinding.initializer, propertyName, analysis) : null;
+		if (scopedBinding.wasFound) return scopedBinding.initializer ? getSelectedObjectProperty(scopedBinding.initializer, propertyName, analysis, visitedExpressions) : null;
 		const topLevelBinding = getTopLevelBinding(analysis.sourceFile, resolvedExpression.text);
-		return topLevelBinding && ts.isExpression(topLevelBinding) ? getSelectedObjectProperty(topLevelBinding, propertyName, analysis) : null;
+		return topLevelBinding && ts.isExpression(topLevelBinding) ? getSelectedObjectProperty(topLevelBinding, propertyName, analysis, visitedExpressions) : null;
 	}
 	if (!ts.isObjectLiteralExpression(resolvedExpression)) return null;
 	for (const property of [...resolvedExpression.properties].reverse()) {
@@ -65719,7 +65736,7 @@ const getSelectedObjectProperty = (expression, propertyName, analysis) => {
 		if (ts.isMethodDeclaration(property) && getStaticPropertyName$1(property.name) === propertyName) return property;
 		if (ts.isShorthandPropertyAssignment(property) && property.name.text === propertyName) return property.name;
 		if (ts.isSpreadAssignment(property)) {
-			const spreadProperty = getSelectedObjectProperty(property.expression, propertyName, analysis);
+			const spreadProperty = getSelectedObjectProperty(property.expression, propertyName, analysis, visitedExpressions);
 			if (spreadProperty) return spreadProperty;
 		}
 	}
@@ -73188,13 +73205,13 @@ const decodeFileDiagnostics = (raw) => {
 	}
 };
 const emptyCache$1 = () => ({
-	version: 1,
+	version: 2,
 	rulesets: {}
 });
 const loadRulesetEntries$1 = (cacheFilePath, rulesetHash) => {
 	const entries = /* @__PURE__ */ new Map();
 	const persisted = failOpenReadJson(cacheFilePath, emptyCache$1());
-	if (persisted.version !== 1 || !isRecord$1(persisted.rulesets)) return entries;
+	if (persisted.version !== 2 || !isRecord$1(persisted.rulesets)) return entries;
 	const bucket = persisted.rulesets[rulesetHash];
 	if (!isRecord$1(bucket) || !isRecord$1(bucket.files)) return entries;
 	for (const [fileKey, rawDiagnostics] of Object.entries(bucket.files)) {
@@ -73214,7 +73231,7 @@ const createFileLintCache = (cacheDirectory, rulesetHash) => {
 		},
 		persist: () => {
 			const onDisk = failOpenReadJson(cacheFilePath, emptyCache$1());
-			const rulesets = onDisk.version === 1 && isRecord$1(onDisk.rulesets) ? { ...onDisk.rulesets } : {};
+			const rulesets = onDisk.version === 2 && isRecord$1(onDisk.rulesets) ? { ...onDisk.rulesets } : {};
 			const existingBucket = rulesets[rulesetHash];
 			const existingFiles = isRecord$1(existingBucket) && isRecord$1(existingBucket.files) ? existingBucket.files : {};
 			const ourFiles = {};
@@ -73228,7 +73245,7 @@ const createFileLintCache = (cacheDirectory, rulesetHash) => {
 				files: Object.fromEntries(cappedEntries)
 			};
 			atomicWriteJson(cacheFilePath, {
-				version: 1,
+				version: 2,
 				rulesets: Object.fromEntries(Object.entries(rulesets).filter(([, bucket]) => isRecord$1(bucket) && typeof bucket.updatedAtMs === "number").sort(([, first], [, second]) => second.updatedAtMs - first.updatedAtMs).slice(0, 8))
 			});
 		}
@@ -73317,13 +73334,13 @@ const encodeSidecarFileEntry = (entry) => ({
 	diagnostics: entry.diagnostics
 });
 const emptyCache = () => ({
-	version: 2,
+	version: 3,
 	rulesets: {}
 });
 const loadRulesetEntries = (cacheFilePath, rulesetHash) => {
 	const entries = /* @__PURE__ */ new Map();
 	const persisted = failOpenReadJson(cacheFilePath, emptyCache());
-	if (persisted.version !== 2 || !isRecord$1(persisted.rulesets)) return entries;
+	if (persisted.version !== 3 || !isRecord$1(persisted.rulesets)) return entries;
 	const bucket = persisted.rulesets[rulesetHash];
 	if (!isRecord$1(bucket) || !isRecord$1(bucket.files)) return entries;
 	for (const [fileKey, rawEntry] of Object.entries(bucket.files)) {
@@ -73343,7 +73360,7 @@ const createSidecarLintCache = (cacheDirectory, rulesetHash) => {
 		},
 		persist: () => {
 			const onDisk = failOpenReadJson(cacheFilePath, emptyCache());
-			const rulesets = onDisk.version === 2 && isRecord$1(onDisk.rulesets) ? { ...onDisk.rulesets } : {};
+			const rulesets = onDisk.version === 3 && isRecord$1(onDisk.rulesets) ? { ...onDisk.rulesets } : {};
 			const existingBucket = rulesets[rulesetHash];
 			const existingFiles = isRecord$1(existingBucket) && isRecord$1(existingBucket.files) ? existingBucket.files : {};
 			const ourFiles = {};
@@ -73357,7 +73374,7 @@ const createSidecarLintCache = (cacheDirectory, rulesetHash) => {
 				files: Object.fromEntries(cappedEntries)
 			};
 			atomicWriteJson(cacheFilePath, {
-				version: 2,
+				version: 3,
 				rulesets: Object.fromEntries(Object.entries(rulesets).filter(([, bucket]) => isRecord$1(bucket) && typeof bucket.updatedAtMs === "number").sort(([, first], [, second]) => second.updatedAtMs - first.updatedAtMs).slice(0, 8))
 			});
 		}
@@ -74290,7 +74307,7 @@ const parseOxlintOutput = (stdout, project, rootDirectory) => {
 		minifiedFileCache.set(absolutePath, minified);
 		return minified;
 	};
-	return suppressMemoizationInBailedOutFunctions(parsed.diagnostics.filter((diagnostic) => isMappableOxlintDiagnostic(diagnostic) && isLintableSourceFile(diagnostic.filename) && !isMinifiedDiagnosticFile(diagnostic.filename) && !shouldSuppressLocalUseHookDiagnostic(diagnostic, rootDirectory) && !shouldSuppressCompilerFindingInWorklet(diagnostic, project, rootDirectory)).map((diagnostic) => {
+	return suppressMemoizationInBailedOutFunctions(parsed.diagnostics.filter((diagnostic) => isMappableOxlintDiagnostic(diagnostic) && isLintableSourceFile(diagnostic.filename) && !(TYPESCRIPT_DECLARATION_FILE_PATTERN.test(diagnostic.filename) && OXLINT_IGNORED_DECLARATION_DIAGNOSTIC_CODES.has(diagnostic.code)) && !isMinifiedDiagnosticFile(diagnostic.filename) && !shouldSuppressLocalUseHookDiagnostic(diagnostic, rootDirectory) && !shouldSuppressCompilerFindingInWorklet(diagnostic, project, rootDirectory)).map((diagnostic) => {
 		const { plugin, rule } = parseRuleCode(diagnostic.code);
 		const primaryLabel = diagnostic.labels[0];
 		const cleaned = cleanDiagnosticMessage(diagnostic.message, diagnostic.help, plugin, rule, project);
@@ -77300,6 +77317,7 @@ const BASELINE_FILES_TEMP_DIR_PREFIX = "react-doctor-baseline-";
 const SCAN_RESULT_CACHE_FILENAME = "scan-cache.json";
 const RUN_GIT_MAX_BUFFER_BYTES = 64 * 1024 * 1024;
 const GH_DEFAULT_BRANCH_PROBE_TIMEOUT_MS = 5e3;
+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;
@@ -77391,7 +77409,7 @@ const makeNoopConsole = () => ({
 });
 //#endregion
 //#region src/cli/utils/version.ts
-const VERSION = "0.8.3";
+const VERSION = "0.9.0-dev.1e67af0";
 //#endregion
 //#region src/cli/utils/json-mode.ts
 let context = null;
@@ -77749,13 +77767,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.8.3`;
+const resolveSentryRelease = () => process.env.SENTRY_RELEASE || `react-doctor@0.9.0-dev.1e67af0`;
 /**
 * 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.8.3") ? "development" : "production");
+const resolveSentryEnvironment = () => process.env.SENTRY_ENVIRONMENT || (isDevVersion("0.9.0-dev.1e67af0") ? "development" : "production");
 /**
 * Performance-tracing sample rate in `[0, 1]`. Reads `SENTRY_TRACES_SAMPLE_RATE`
 * (set to `0` to disable tracing) and falls back to
@@ -89602,12 +89620,13 @@ const buildRuntimeLayers = (input) => {
 	const scoreLayer = input.shouldComputeScore ? Score.layerHttp : Score.layerOf(null);
 	const supplyChainLayer = input.shouldRunSupplyChain ? SupplyChain.layerNode : SupplyChain.layerOf([]);
 	const projectLayer = input.projectInfoOverride === void 0 ? Project.layerNode : Project.layerOf(input.projectInfoOverride);
-	const progressLayer = input.shouldShowProgressSpinners ? Progress.layerOra(buildSpinnerProgressHandle) : Progress.layerNoop;
+	const progressLayer = input.progressLayer ?? (input.shouldShowProgressSpinners ? Progress.layerOra(buildSpinnerProgressHandle) : Progress.layerNoop);
+	const reporterLayer = input.reporterLayer ?? Reporter.layerNoop;
 	const baseLayers = mergeAll$1(projectLayer, input.hasConfigOverride ? Config.layerOf({
 		config: input.userConfig,
 		resolvedDirectory: input.directory,
 		configSourceDirectory: input.configSourceDirectory
-	}) : Config.layerNode, Files.layerNode, Git.layerNode, linterLayer, LintPartialFailures.layerLive, deadCodeLayer, progressLayer, Reporter.layerNoop, scoreLayer, supplyChainLayer);
+	}) : Config.layerNode, Files.layerNode, Git.layerNode, linterLayer, LintPartialFailures.layerLive, deadCodeLayer, progressLayer, reporterLayer, scoreLayer, supplyChainLayer);
 	return input.oxlintConcurrency === void 0 ? baseLayers : mergeAll$1(baseLayers, succeed$3(OxlintConcurrency, input.oxlintConcurrency));
 };
 //#endregion
@@ -89977,12 +89996,12 @@ const resolveCacheFilePath = (projectDirectory) => path.join(resolveReactDoctorC
 const readPersistedCache = (cacheFilePath) => {
 	try {
 		const parsed = JSON.parse(fs.readFileSync(cacheFilePath, "utf8"));
-		if (!isRecord(parsed) || parsed.version !== 5) return {
-			version: 5,
+		if (!isRecord(parsed) || parsed.version !== 6) return {
+			version: 6,
 			entries: []
 		};
 		if (!Array.isArray(parsed.entries)) return {
-			version: 5,
+			version: 6,
 			entries: []
 		};
 		const entries = [];
@@ -89992,12 +90011,12 @@ const readPersistedCache = (cacheFilePath) => {
 			entries.push(entry);
 		}
 		return {
-			version: 5,
+			version: 6,
 			entries
 		};
 	} catch {
 		return {
-			version: 5,
+			version: 6,
 			entries: []
 		};
 	}
@@ -90059,7 +90078,7 @@ const buildScanResultCacheKey = (input) => {
 	if (headSha === null) return null;
 	if (stringifyStableJson(input.userConfig) === null) return null;
 	const cacheKeyJson = stringifyStableJson({
-		schemaVersion: 5,
+		schemaVersion: 6,
 		projectIdentity: resolveProjectIdentity(input.projectDirectory),
 		headSha,
 		worktreeFingerprint,
@@ -90102,7 +90121,7 @@ const createScanResultCache = (projectDirectory) => {
 	for (const entry of persistedCache.entries) entries.set(entry.key, entry);
 	const persist = () => {
 		writePersistedCache(cacheFilePath, {
-			version: 5,
+			version: 6,
 			entries: [...entries.values()].sort((firstEntry, secondEntry) => secondEntry.createdAtMs - firstEntry.createdAtMs).slice(0, 20)
 		});
 	};
@@ -91442,6 +91461,9 @@ const supportsHyperlinks = (stream = process.stdout, env = process.env) => {
 * 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([
 	"",
@@ -91660,6 +91682,13 @@ const colorizeByScore = (text, score) => {
 	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
@@ -91725,15 +91754,10 @@ const buildProjectedScoreBar = (currentScore, potentialScore) => {
 	const emptyCount = Math.max(0, barWidth - currentFill - gainCount);
 	return colorizeByScore("█".repeat(currentFill), currentScore) + highlighter.dim(colorizeByScore("▓".repeat(gainCount), currentScore)) + highlighter.dim("░".repeat(emptyCount));
 };
-const getDoctorFace = (score) => {
-	if (score >= 75) return ["◠ ◠", " ▽ "];
-	if (score >= 50) return ["• •", " ─ "];
-	return ["x x", " ▽ "];
-};
 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] = getDoctorFace(score);
+	const [eyes, mouth] = doctorFace(score);
 	return [
 		FACE_BOX_TOP_BORDER,
 		`│ ${eyes} │`,
@@ -92067,7 +92091,8 @@ const mergeInspectOptions = (inputOptions, userConfig) => {
 		includeTagDefaults: inputOptions.includeTagDefaults ?? false,
 		scoreDisabledMessage: inputOptions.scoreDisabledMessage,
 		outputSurface: inputOptions.outputSurface ?? "cli",
-		suppressRendering: inputOptions.suppressRendering ?? false,
+		suppressRendering: (inputOptions.suppressRendering ?? false) || inputOptions.uiLayers != null,
+		uiLayers: inputOptions.uiLayers ?? null,
 		concurrentScan: inputOptions.concurrentScan ?? false,
 		concurrency: inputOptions.concurrency,
 		maxDurationMs: inputOptions.maxDurationMs ?? null,
@@ -92291,7 +92316,9 @@ const runInspectWithRuntime = async (directory, options, userConfig, hasConfigOv
 		shouldRunSupplyChain: options.supplyChain,
 		shouldComputeScore: !options.noScore,
 		shouldShowProgressSpinners,
-		oxlintConcurrency: options.concurrency
+		oxlintConcurrency: options.concurrency,
+		reporterLayer: options.uiLayers?.reporter,
+		progressLayer: options.uiLayers?.progress
 	});
 	const program = runInspect({
 		directory,
@@ -92329,7 +92356,7 @@ const runInspectWithRuntime = async (directory, options, userConfig, hasConfigOv
 	const output = await runPromise(restoreLegacyThrow(applyObservability(options.silent ? program.pipe(provide(layers), provideService$2(Console, silentConsole)) : program.pipe(provide(layers)), rootSentrySpan)));
 	const didLintFail = lintBindingMissing || output.didLintFail;
 	const lintFailureReason = lintBindingMissing ? `oxlint native binding not found for Node ${process.version}; expected one matching ${OXLINT_NODE_REQUIREMENT}` : output.lintFailureReason;
-	if (!options.scoreOnly && !lintBindingMissing && output.didLintFail && lintFailureReason !== null) if (output.lintFailureReasonKind === "native-binding-missing") runConsole(log(highlighter.gray(`  Upgrade to Node ${OXLINT_NODE_REQUIREMENT} or run: npx -p oxlint@latest react-doctor@latest`)));
+	if (!options.scoreOnly && !options.uiLayers && !lintBindingMissing && output.didLintFail && lintFailureReason !== null) if (output.lintFailureReasonKind === "native-binding-missing") runConsole(log(highlighter.gray(`  Upgrade to Node ${OXLINT_NODE_REQUIREMENT} or run: npx -p oxlint@latest react-doctor@latest`)));
 	else runConsole(error$1(highlighter.error(lintFailureReason)));
 	let inspectDiagnostics = output.diagnostics;
 	let baselineDelta;
@@ -92564,7 +92591,7 @@ const finalizeAndRender = (input) => gen(function* () {
 	const scoreDiagnostics = filterDiagnosticsForSurface([...diagnostics], "score", userConfig);
 	const displayedScoreDiagnostics = filterDiagnosticsForSurface([...printedDiagnostics], "score", userConfig);
 	const potentialScore = score ? yield* promise(() => computeProjectedScore(displayedScoreDiagnostics, scoreDiagnostics, score)) : null;
-	const shouldShowShareLink = !options.noScore && options.share && !options.isCi;
+	const showShareLink = shouldShowShareLink(options);
 	yield* pause;
 	yield* printSummary({
 		diagnostics: [...printedDiagnostics],
@@ -92587,7 +92614,7 @@ const finalizeAndRender = (input) => gen(function* () {
 		diagnostics: [...printedDiagnostics],
 		scoreResult: score,
 		projectName: project.projectName,
-		isOffline: !shouldShowShareLink
+		isOffline: !showShareLink
 	});
 	return buildResult();
 });
@@ -92697,6 +92724,127 @@ const computeDefaultSelectedAgents = (detectedAgents, rememberedAgents) => {
 	return detectedAgents.length === 1 ? [...detectedAgents] : [];
 };
 //#endregion
+//#region src/cli/utils/launch-agent.ts
+const isWindows = process.platform === "win32";
+const CLI_AGENT_IDS = [
+	"claude-code",
+	"codex",
+	"cursor"
+];
+const CLI_AGENT_BINARIES = {
+	"claude-code": "claude",
+	codex: "codex",
+	cursor: "cursor-agent"
+};
+const CLI_AGENT_AUTO_FLAGS = {
+	"claude-code": ["--dangerously-skip-permissions"],
+	codex: ["--yolo"],
+	cursor: ["--force"]
+};
+const resolveCursorBundledNode = () => {
+	if (!isWindows) return null;
+	const localAppData = process.env.LOCALAPPDATA;
+	if (!localAppData) return null;
+	const cursorAgentRoot = Path.join(localAppData, "cursor-agent", "versions");
+	try {
+		const versions = NFS.readdirSync(cursorAgentRoot);
+		if (versions.length === 0) return null;
+		const sortedVersions = versions.sort((a, b) => b.localeCompare(a, void 0, { numeric: true }));
+		for (const version of sortedVersions) try {
+			const bundledNodePath = Path.join(cursorAgentRoot, version, "node.exe");
+			const entryScriptPath = Path.join(cursorAgentRoot, version, "index.js");
+			if (NFS.statSync(bundledNodePath).isFile() && NFS.statSync(entryScriptPath).isFile()) return {
+				command: bundledNodePath,
+				args: [entryScriptPath]
+			};
+		} catch {}
+	} catch {}
+	return null;
+};
+const resolveWindowsCmdEntryScript = (command) => {
+	if (!isWindows) return null;
+	const pathDirectories = (process.env.PATH ?? "").split(Path.delimiter).filter(Boolean);
+	for (const directory of pathDirectories) {
+		const cmdFilePath = Path.join(directory, `${command}.cmd`);
+		try {
+			if (!NFS.statSync(cmdFilePath).isFile()) continue;
+		} catch {
+			continue;
+		}
+		try {
+			const entryScriptMatch = NFS.readFileSync(cmdFilePath, "utf8").match(/"%(?:~dp0|dp0%)\\([^"]+\.(?:m?js|cjs))"/);
+			if (!entryScriptMatch) continue;
+			const resolvedScriptPath = Path.resolve(directory, entryScriptMatch[1]);
+			if (NFS.statSync(resolvedScriptPath).isFile()) return resolvedScriptPath;
+		} catch {}
+	}
+	return null;
+};
+const spawnAgent = (command, args, cwd) => new Promise((resolve, reject) => {
+	const child = spawn(command, [...args], {
+		cwd,
+		stdio: "inherit"
+	});
+	child.on("error", reject);
+	child.on("close", (code) => resolve(code ?? 0));
+});
+const launchCliAgent = async (agentId, prompt, cwd) => {
+	const binary = CLI_AGENT_BINARIES[agentId];
+	const agentArgs = [...CLI_AGENT_AUTO_FLAGS[agentId], prompt];
+	if (isWindows) {
+		if (agentId === "cursor") {
+			const cursorResolution = resolveCursorBundledNode();
+			if (cursorResolution) return spawnAgent(cursorResolution.command, [...cursorResolution.args, ...agentArgs], cwd);
+		}
+		const entryScript = resolveWindowsCmdEntryScript(binary);
+		if (entryScript) return spawnAgent(process.execPath, [entryScript, ...agentArgs], cwd);
+	}
+	try {
+		return await spawnAgent(binary, agentArgs, cwd);
+	} catch {
+		throw new Error(`Failed to launch ${binary}`);
+	}
+};
+const CLIPBOARD_COMMANDS = [
+	{
+		binary: "pbcopy",
+		args: []
+	},
+	{
+		binary: "wl-copy",
+		args: []
+	},
+	{
+		binary: "xclip",
+		args: ["-selection", "clipboard"]
+	},
+	{
+		binary: "xsel",
+		args: ["--clipboard", "--input"]
+	},
+	{
+		binary: "clip",
+		args: []
+	}
+];
+const copyToClipboard = (text) => {
+	const command = CLIPBOARD_COMMANDS.find((candidate) => isCommandAvailable(candidate.binary));
+	if (!command) return Promise.resolve(false);
+	return new Promise((resolve) => {
+		const child = spawn(command.binary, command.args);
+		child.on("error", () => resolve(false));
+		child.on("close", (code) => resolve(code === 0));
+		child.stdin.on("error", () => resolve(false));
+		child.stdin.end(text);
+	});
+};
+//#endregion
+//#region src/cli/utils/detect-launchable-agents.ts
+const detectLaunchableAgents = async () => {
+	const detected = new Set(await detectAvailableAgents());
+	return CLI_AGENT_IDS.filter((agentId) => detected.has(agentId) && isCommandAvailable(CLI_AGENT_BINARIES[agentId]));
+};
+//#endregion
 //#region src/cli/utils/action-upgrade-prompt.ts
 const ACTION_UPGRADE_GATE = {
 	id: ACTION_UPGRADE_EVENT,
@@ -93939,116 +94087,6 @@ const installReactDoctorSkillForAgent = async (agent, projectRoot) => {
 	return result.skills.length > 0 && result.failed.length === 0;
 };
 //#endregion
-//#region src/cli/utils/launch-agent.ts
-const isWindows = process.platform === "win32";
-const CLI_AGENT_BINARIES = {
-	"claude-code": "claude",
-	codex: "codex",
-	cursor: "cursor-agent"
-};
-const CLI_AGENT_AUTO_FLAGS = {
-	"claude-code": ["--dangerously-skip-permissions"],
-	codex: ["--yolo"],
-	cursor: ["--force"]
-};
-const resolveCursorBundledNode = () => {
-	if (!isWindows) return null;
-	const localAppData = process.env.LOCALAPPDATA;
-	if (!localAppData) return null;
-	const cursorAgentRoot = Path.join(localAppData, "cursor-agent", "versions");
-	try {
-		const versions = NFS.readdirSync(cursorAgentRoot);
-		if (versions.length === 0) return null;
-		const sortedVersions = versions.sort((a, b) => b.localeCompare(a, void 0, { numeric: true }));
-		for (const version of sortedVersions) try {
-			const bundledNodePath = Path.join(cursorAgentRoot, version, "node.exe");
-			const entryScriptPath = Path.join(cursorAgentRoot, version, "index.js");
-			if (NFS.statSync(bundledNodePath).isFile() && NFS.statSync(entryScriptPath).isFile()) return {
-				command: bundledNodePath,
-				args: [entryScriptPath]
-			};
-		} catch {}
-	} catch {}
-	return null;
-};
-const resolveWindowsCmdEntryScript = (command) => {
-	if (!isWindows) return null;
-	const pathDirectories = (process.env.PATH ?? "").split(Path.delimiter).filter(Boolean);
-	for (const directory of pathDirectories) {
-		const cmdFilePath = Path.join(directory, `${command}.cmd`);
-		try {
-			if (!NFS.statSync(cmdFilePath).isFile()) continue;
-		} catch {
-			continue;
-		}
-		try {
-			const entryScriptMatch = NFS.readFileSync(cmdFilePath, "utf8").match(/"%(?:~dp0|dp0%)\\([^"]+\.(?:m?js|cjs))"/);
-			if (!entryScriptMatch) continue;
-			const resolvedScriptPath = Path.resolve(directory, entryScriptMatch[1]);
-			if (NFS.statSync(resolvedScriptPath).isFile()) return resolvedScriptPath;
-		} catch {}
-	}
-	return null;
-};
-const spawnAgent = (command, args, cwd) => new Promise((resolve, reject) => {
-	const child = spawn(command, [...args], {
-		cwd,
-		stdio: "inherit"
-	});
-	child.on("error", reject);
-	child.on("close", (code) => resolve(code ?? 0));
-});
-const launchCliAgent = async (agentId, prompt, cwd) => {
-	const binary = CLI_AGENT_BINARIES[agentId];
-	const agentArgs = [...CLI_AGENT_AUTO_FLAGS[agentId], prompt];
-	if (isWindows) {
-		if (agentId === "cursor") {
-			const cursorResolution = resolveCursorBundledNode();
-			if (cursorResolution) return spawnAgent(cursorResolution.command, [...cursorResolution.args, ...agentArgs], cwd);
-		}
-		const entryScript = resolveWindowsCmdEntryScript(binary);
-		if (entryScript) return spawnAgent(process.execPath, [entryScript, ...agentArgs], cwd);
-	}
-	try {
-		return await spawnAgent(binary, agentArgs, cwd);
-	} catch {
-		throw new Error(`Failed to launch ${binary}`);
-	}
-};
-const CLIPBOARD_COMMANDS = [
-	{
-		binary: "pbcopy",
-		args: []
-	},
-	{
-		binary: "wl-copy",
-		args: []
-	},
-	{
-		binary: "xclip",
-		args: ["-selection", "clipboard"]
-	},
-	{
-		binary: "xsel",
-		args: ["--clipboard", "--input"]
-	},
-	{
-		binary: "clip",
-		args: []
-	}
-];
-const copyToClipboard = (text) => {
-	const command = CLIPBOARD_COMMANDS.find((candidate) => isCommandAvailable(candidate.binary));
-	if (!command) return Promise.resolve(false);
-	return new Promise((resolve) => {
-		const child = spawn(command.binary, command.args);
-		child.on("error", () => resolve(false));
-		child.on("close", (code) => resolve(code === 0));
-		child.stdin.on("error", () => resolve(false));
-		child.stdin.end(text);
-	});
-};
-//#endregion
 //#region src/cli/utils/handoff-to-agent.ts
 const CLIPBOARD_CHOICE = "clipboard";
 const SKIP_CHOICE = "skip";
@@ -94112,10 +94150,6 @@ const maybeOfferActionUpgrade = async (projectRoot) => {
 	}
 	if (await upgradeGitHubActionsWorkflow(workflow)) recordActionUpgradeDecision(projectRoot, "accepted");
 };
-const detectLaunchableAgents = async () => {
-	const detected = new Set(await detectAvailableAgents());
-	return Object.keys(CLI_AGENT_BINARIES).filter((agentId) => detected.has(agentId) && isCommandAvailable(CLI_AGENT_BINARIES[agentId]));
-};
 const handoffToAgent = async (input) => {
 	if (!input.interactive || input.diagnostics.length === 0) return;
 	cliLogger.break();
@@ -94430,15 +94464,29 @@ const readChangedFilesFrom = (filePath) => {
 	return [...uniqueFiles];
 };
 //#endregion
-//#region src/cli/utils/filter-scans-for-surface.ts
-const filterScansForSurface = (completedScans, surface) => completedScans.flatMap((scan) => filterDiagnosticsForSurface([...scan.result.diagnostics], surface, scan.config));
+//#region src/cli/utils/count-unique-scanned-files.ts
+const countUniqueScannedFiles = (results) => {
+	const uniqueScannedFilePaths = /* @__PURE__ */ new Set();
+	let fileCountFromScansWithoutPaths = 0;
+	for (const result of results) {
+		const scannedFilePaths = result.scannedFilePaths;
+		if (scannedFilePaths && scannedFilePaths.length > 0) for (const filePath of scannedFilePaths) uniqueScannedFilePaths.add(filePath);
+		else fileCountFromScansWithoutPaths += result.scannedFileCount ?? result.project.sourceFileCount;
+	}
+	return uniqueScannedFilePaths.size + fileCountFromScansWithoutPaths;
+};
 //#endregion
-//#region src/cli/utils/render-multi-project-summary.ts
-const getScoreLabel = (score) => {
+//#region src/cli/utils/score-band-label.ts
+const scoreBandLabel = (score) => {
 	if (score >= 75) return "Great";
 	if (score >= 50) return "OK";
 	return "Needs work";
 };
+//#endregion
+//#region src/cli/utils/filter-scans-for-surface.ts
+const filterScansForSurface = (completedScans, surface) => completedScans.flatMap((scan) => filterDiagnosticsForSurface([...scan.result.diagnostics], surface, scan.config));
+//#endregion
+//#region src/cli/utils/render-multi-project-summary.ts
 const buildSummaryLine = (entry, longestProjectNameLength) => {
 	const paddedName = entry.projectName.padEnd(longestProjectNameLength);
 	const nameRendering = entry.score !== null ? colorizeByScore(paddedName, entry.score) : highlighter.dim(paddedName);
@@ -94447,7 +94495,7 @@ const buildSummaryLine = (entry, longestProjectNameLength) => {
 		return `  ${nameRendering}  ${highlighter.dim("no score")}  ${highlighter.dim(issueLabel)}`;
 	}
 	const scoreRendering = colorizeByScore(String(entry.score).padStart(3), entry.score);
-	const label = colorizeByScore(getScoreLabel(entry.score), entry.score);
+	const label = colorizeByScore(scoreBandLabel(entry.score), entry.score);
 	const issuesParts = [];
 	if (entry.errorCount > 0) issuesParts.push(highlighter.error(`${entry.errorCount} ${entry.errorCount === 1 ? "error" : "errors"}`));
 	const warningCount = entry.issueCount - entry.errorCount;
@@ -94469,14 +94517,7 @@ const printMultiProjectSummary = (input) => gen(function* () {
 	const projectRootByDiagnostic = /* @__PURE__ */ new WeakMap();
 	for (const scan of completedScans) for (const diagnostic of scan.result.diagnostics) projectRootByDiagnostic.set(diagnostic, scan.result.project.rootDirectory);
 	const resolveDiagnosticSourceRoot = (diagnostic) => projectRootByDiagnostic.get(diagnostic) ?? "";
-	const uniqueScannedFilePaths = /* @__PURE__ */ new Set();
-	let fileCountFromScansWithoutPaths = 0;
-	for (const scan of completedScans) {
-		const scannedFilePaths = scan.result.scannedFilePaths;
-		if (scannedFilePaths && scannedFilePaths.length > 0) for (const filePath of scannedFilePaths) uniqueScannedFilePaths.add(filePath);
-		else fileCountFromScansWithoutPaths += scan.result.scannedFileCount ?? scan.result.project.sourceFileCount;
-	}
-	const totalScannedFileCount = uniqueScannedFilePaths.size + fileCountFromScansWithoutPaths;
+	const totalScannedFileCount = countUniqueScannedFiles(completedScans.map((scan) => scan.result));
 	yield* log(`${highlighter.success("✔")} Scanned ${totalScannedFileCount} ${totalScannedFileCount === 1 ? "file" : "files"} in ${formatElapsedTime(totalElapsedMilliseconds)}`);
 	if (displayDiagnostics.length > 0) {
 		yield* log("");
@@ -94748,10 +94789,14 @@ const parseFileLineArgument = (rawArgument) => {
 };
 //#endregion
 //#region src/cli/utils/select-projects.ts
-const selectProjects = async (rootDirectory, projectFlag, skipPrompts, configProjects) => {
+const discoverWorkspacePackages = (rootDirectory) => {
 	const hasRootPackageJson = isFile(Path.join(rootDirectory, "package.json"));
-	let packages = listWorkspacePackages(rootDirectory);
-	if (packages.length === 0 && (!hasRootPackageJson || isMonorepoRoot(rootDirectory))) packages = discoverReactSubprojects(rootDirectory);
+	const packages = listWorkspacePackages(rootDirectory);
+	if (packages.length === 0 && (!hasRootPackageJson || isMonorepoRoot(rootDirectory))) return discoverReactSubprojects(rootDirectory);
+	return packages;
+};
+const selectProjects = async (rootDirectory, projectFlag, skipPrompts, configProjects) => {
+	const packages = discoverWorkspacePackages(rootDirectory);
 	if (projectFlag) return resolveProjectFlag(projectFlag, packages, rootDirectory);
 	const configRequestedNames = (configProjects ?? []).map((requestedName) => requestedName.trim()).filter((requestedName) => requestedName.length > 0);
 	if (configRequestedNames.length > 0) {
@@ -94880,6 +94925,14 @@ const projectManifestChanged = (rootDirectory, projectDirectory, diffInfo) => {
 	return diffInfo.changedFiles.some((filePath) => toForwardSlashes(filePath) === manifestPath);
 };
 //#endregion
+//#region src/cli/utils/should-fail-scan-gate.ts
+const shouldFailScanGate = (input) => {
+	if (input.blockingLevel === "none") return false;
+	if (input.scans.some(({ result }) => hasLintHardFailure(result))) return true;
+	if (input.diagnosticsAreGateExempt === true) return false;
+	return shouldBlockCi(filterScansForSurface(input.scans, "ciFailure"), input.blockingLevel);
+};
+//#endregion
 //#region src/cli/utils/warn-deprecated-fail-on.ts
 const warnDeprecatedFailOn = (flags, userConfig) => {
 	const usedFlag = flags.failOn !== void 0;
@@ -95006,12 +95059,11 @@ const finalizeScans = (input) => {
 		}));
 	}
 	const blockingLevel = resolveBlockingLevel(input.flags, input.userConfig);
-	if (input.completedScans.some(({ result }) => hasLintHardFailure(result)) && blockingLevel !== "none") {
-		process.exitCode = 1;
-		return;
-	}
-	if (input.isScoreOnly || baselineDegraded) return;
-	if (shouldBlockCi(filterScansForSurface(input.completedScans, "ciFailure"), blockingLevel)) process.exitCode = 1;
+	if (shouldFailScanGate({
+		scans: input.completedScans,
+		blockingLevel,
+		diagnosticsAreGateExempt: input.isScoreOnly || baselineDegraded
+	})) process.exitCode = 1;
 };
 const buildChangedFilesDiffInfo = (changedFiles) => ({
 	currentBranch: process.env.GITHUB_HEAD_REF?.trim() || null,
@@ -95287,13 +95339,13 @@ const inspectAction = async (directory, flags, invocationCommand = "inspect") =>
 			completedScans.push(scanOutcome);
 		}
 		if (!isQuiet && isMultiProject && completedScans.length > 0) {
-			const shouldShowShareLink = !isShareOptedOut(completedScans, scanOptions.noScore) && !scanOptions.isCi;
+			const showShareLink = !isShareOptedOut(completedScans, scanOptions.noScore) && !scanOptions.isCi;
 			await runPromise(printMultiProjectSummary({
 				completedScans,
 				categoryFilters,
 				verbose: Boolean(flags.verbose),
 				outputDirectory: flags.outputDir,
-				isOffline: !shouldShowShareLink,
+				isOffline: !showShareLink,
 				projectName: Path.basename(resolvedDirectory),
 				totalElapsedMilliseconds: performance$1.now() - scanLoopStartTime
 			}));
@@ -96268,6 +96320,20 @@ const COMMAND_FLAG_SPECS = new Map([
 		longOptionsWithOptionalValues: /* @__PURE__ */ new Set(),
 		shortOptionsWithoutValues: new Set(["-h"]),
 		shortOptionsWithRequiredValues: new Set(["-c"])
+	}],
+	["experimental-tui", {
+		longOptionsWithoutValues: new Set([
+			"--color",
+			"--help",
+			"--no-color",
+			"--no-dead-code",
+			"--no-score",
+			"--yes"
+		]),
+		longOptionsWithRequiredValues: new Set(["--blocking", "--project"]),
+		longOptionsWithOptionalValues: /* @__PURE__ */ new Set(),
+		shortOptionsWithoutValues: new Set(["-h", "-y"]),
+		shortOptionsWithRequiredValues: new Set(["-p"])
 	}]
 ]);
 const isFlagLike = (argument) => argument.startsWith("-") && argument !== "-";
@@ -96447,6 +96513,35 @@ rules.command("category <category> <severity>").description("Set the severity fo
 rules.command("ignore-tag <tag>").description("Skip a whole rule family by tag before linting (e.g. design)").option("-c, --cwd <cwd>", "working directory", process.cwd()).action((tag, _options, command) => rulesIgnoreTagAction(tag, command.optsWithGlobals()));
 rules.command("unignore-tag <tag>").description("Stop ignoring a tag previously skipped via ignore-tag").option("-c, --cwd <cwd>", "working directory", process.cwd()).action((tag, _options, command) => rulesUnignoreTagAction(tag, command.optsWithGlobals()));
 program.command("experimental-lsp", { hidden: false }).description("[experimental] run the React Doctor language server over stdio (for editors)").allowUnknownOption().action(() => {});
+program.command("experimental-tui [directory]", { hidden: true }).description("[experimental] interactive, scrollable scan report").option("--blocking <level>", "severity that fails CI: error (default), warning, or none (advisory)").option("--color", "force colored output").option("--no-color", "disable colored output (also honors NO_COLOR)").option("--no-dead-code", "skip dead-code analysis").option("--no-score", "skip the score API, the share URL, and crash reporting").option("-p, --project <names>", "scan specific workspace projects (comma-separated, or *)").option("-y, --yes", "skip the project prompt and scan every discovered project").action(async (directory = ".", _localOptions, command) => {
+	const options = command.optsWithGlobals();
+	const deadCode = options.deadCode === false ? false : void 0;
+	const noScore = options.score === false ? true : void 0;
+	const nodeMajorVersion = Number(process.versions.node.split(".")[0]);
+	if (process.stdout.isTTY !== true || process.stdin.isTTY !== true || isNonInteractiveEnvironment() || nodeMajorVersion < 22) {
+		await inspectAction(directory, {
+			deadCode,
+			score: options.score === false ? false : void 0,
+			project: options.project,
+			yes: options.yes,
+			blocking: options.blocking
+		});
+		return;
+	}
+	recordCount(METRIC.cliInvoked, 1, { command: "experimental-tui" });
+	const { runScanApp } = await import("./run-scan-app-DZ5jGWFf.js");
+	const { shouldFail } = await runScanApp({
+		directory,
+		options: {
+			deadCode,
+			noScore
+		},
+		projectFlag: options.project,
+		skipPrompts: options.yes ?? false,
+		blocking: options.blocking
+	});
+	if (shouldFail) process.exitCode = 1;
+});
 process.stdout.on("error", (error) => {
 	if (error.code === "EPIPE") process.exit(0);
 });
@@ -96473,7 +96568,7 @@ Promise.resolve().then(() => assertNoRemovedFlags(process.argv)).then(() => prog
 	handleError(error, { sentryEventId });
 });
 //#endregion
-export {};
+export { toForwardSlashes as A, highlighter as B, buildRulePriorityMap as C, resolveBlockingLevel as D, formatLearnMoreLine as E, isCiEnvironment as F, sync as G, mergeReactDoctorConfigs as H, DIAGNOSTIC_CATEGORY_BUCKETS as I, void_ as K, Progress as L, isUnicodeSupported as M, METRIC as N, isReactDoctorWorkflowInstalled as O, TUI_REPORT_DETAIL_WIDTH_FRACTION as P, Reporter as R, hasLintHardFailure as S, formatFixRecipeLine as T, resolveScanTarget as U, mapWithConcurrency as V, runPromise as W, canAnimateOnboarding as _, resolveCliInspectOptions as a, buildCodeFrame as b, detectLaunchableAgents as c, launchCliAgent as d, isShareOptedOut as f, doctorFace as g, easeOutCubic as h, selectProjects as i, findNearestPackageDirectory as j, recordCount as k, CLI_AGENT_BINARIES as l, printFooter as m, shouldFailScanGate as n, countUniqueScannedFiles as o, inspect as p, succeed$3 as q, discoverWorkspacePackages as r, setUpGitHubActions as s, exitGracefully as t, copyToClipboard as u, computeProjectedScore as v, buildSortedRuleGroups as w, buildNoScoreMessage as x, formatElapsedTime as y, getCategoryImpact as z };
 
 //# sourceMappingURL=cli.js.map
-//# debugId=0dac14aa-8d32-5d22-8e5e-1d8d793e05c0
+//# debugId=2fb9bb5f-dfff-55d9-9d36-af738b2c29ea