react-doctor 0.2.6 → 0.2.8

package/dist/cli.js

@@ -1,13 +1,12 @@
 import { i as __toESM, n as __exportAll, r as __require, t as __commonJSMin } from "./rolldown-runtime-uZX_iqCz.js";
-import { A as formatReactDoctorError, B as toRelativePath, C as buildJsonReportError, D as filterSourceFiles, E as filterDiagnosticsForSurface, F as layerOtlp, I as listWorkspacePackages, L as loadConfigWithSource, M as groupBy, N as highlighter, O as formatErrorChain, P as isReactDoctorError, R as resolveConfigRootDir, S as buildJsonReport, T as discoverReactSubprojects, _ as Reporter, a as Config, b as Score, c as Git, d as MILLISECONDS_PER_SECOND, f as NoReactDependencyError, g as ProjectNotFoundError, h as Project, i as CANONICAL_GITHUB_URL, j as getDiffInfo, k as formatFrameworkName, l as LintPartialFailures, m as OXLINT_NODE_REQUIREMENT, o as DeadCode, p as NodeResolver, r as AmbiguousProjectError, s as Files, t as cliLogger, u as Linter, v as SHARE_BASE_URL, w as calculateScore, x as StagedFiles, y as SKILL_NAME, z as runInspect } from "./cli-logger-Iz5pfDnL.js";
+import { A as isReactDoctorError, C as filterSourceFiles, D as groupBy, E as getDiffInfo, F as runInspect, I as toRelativePath, M as listWorkspacePackages, N as resolveScanTarget, O as highlighter, P as restoreLegacyThrow, S as filterDiagnosticsForSurface, T as formatReactDoctorError, _ as Score, a as DeadCode, b as buildJsonReportError, c as LintPartialFailures, d as OXLINT_NODE_REQUIREMENT, f as Progress, g as SKILL_NAME, h as SHARE_BASE_URL, i as Config, j as layerOtlp, k as isMonorepoRoot, l as Linter, m as Reporter, o as Files, p as Project, r as CANONICAL_GITHUB_URL, s as Git, t as cliLogger, u as NodeResolver, v as StagedFiles, w as formatErrorChain, x as discoverReactSubprojects, y as buildJsonReport } from "./cli-logger-C35LXalM.js";
 import { createRequire } from "node:module";
-import { execFileSync } from "node:child_process";
+import { execFileSync, execSync } from "node:child_process";
 import path, { join } from "node:path";
 import { accessSync, chmodSync, constants, existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, rmdirSync, statSync, writeFileSync } from "node:fs";
 import process$1 from "node:process";
 import * as Effect from "effect/Effect";
 import * as Layer from "effect/Layer";
-import * as Ref from "effect/Ref";
 import * as Console from "effect/Console";
 import os, { tmpdir } from "node:os";
 import { performance } from "node:perf_hooks";
@@ -3029,256 +3028,6 @@ const { program: program$1, createCommand, createArgument, createOption, Command
 	exports.InvalidOptionArgumentError = InvalidArgumentError;
 })))(), 1)).default;
 //#endregion
-//#region src/cli/utils/build-runtime-layers.ts
-/**
-* Composes the production layer stack for `inspect()`'s
-* `Effect.runPromise(Effect.provide(...))` call. Lives outside
-* `inspect.ts` so the orchestrator stays focused on Effect program
-* construction and post-scan rendering — layer wiring is its own
-* concern with its own contract.
-*
-* Same shape as `core/src/run-inspect.ts → layerInspectLive`
-* (the default for `@react-doctor/api → diagnose()`) with two
-* differences specific to the CLI path:
-*
-* - **Config**: when the caller passes `configOverride`, the
-*   already-loaded config is provided via `Config.layerOf` instead
-*   of re-loading from disk; `configSourceDirectory` is threaded
-*   through so `userConfig.plugins` resolution still anchors at
-*   the original config file location.
-* - **Score**: always `layerOf(null)` because the CLI computes the
-*   real score AFTER `runInspect` returns, with surface filtering
-*   applied (the orchestrator's `Score.compute` only sees the
-*   per-element-filtered list, not the surface-filtered one).
-*/
-const buildRuntimeLayers = (input) => {
-	const linterLayer = input.shouldSkipLint ? Linter.layerOf([]) : Linter.layerOxlint;
-	const deadCodeLayer = input.shouldRunDeadCode ? DeadCode.layerNode : DeadCode.layerOf([]);
-	const scoreLayer = Score.layerOf(null);
-	const configLayer = input.hasConfigOverride ? Config.layerOf({
-		config: input.userConfig,
-		resolvedDirectory: input.directory,
-		configSourceDirectory: input.configSourceDirectory
-	}) : Config.layerNode;
-	return Layer.mergeAll(Project.layerNode, configLayer, Files.layerNode, Git.layerNode, linterLayer, LintPartialFailures.layerLive, deadCodeLayer, Reporter.layerNoop, scoreLayer);
-};
-//#endregion
-//#region src/cli/utils/build-hidden-diagnostics-summary.ts
-const buildHiddenDiagnosticsSummary = (hiddenDiagnostics) => {
-	const errorCount = hiddenDiagnostics.filter((diagnostic) => diagnostic.severity === "error").length;
-	const warningCount = hiddenDiagnostics.length - errorCount;
-	const parts = [];
-	if (errorCount > 0) parts.push({
-		severity: "error",
-		count: errorCount,
-		text: `✗ ${errorCount} more error${errorCount === 1 ? "" : "s"}`
-	});
-	if (warningCount > 0) parts.push({
-		severity: "warning",
-		count: warningCount,
-		text: `⚠ ${warningCount} more warning${warningCount === 1 ? "" : "s"}`
-	});
-	return parts;
-};
-//#endregion
-//#region src/cli/utils/indent-multiline-text.ts
-const indentMultilineText = (text, linePrefix) => text.split("\n").map((lineText) => `${linePrefix}${lineText}`).join("\n");
-//#endregion
-//#region src/cli/utils/wrap-indented-text.ts
-const wrapLine = (lineText, contentWidth) => {
-	if (lineText.length <= contentWidth) return [lineText];
-	const wrappedLines = [];
-	let remainingText = lineText.trim();
-	while (remainingText.length > contentWidth) {
-		const candidateText = remainingText.slice(0, contentWidth);
-		const breakIndex = candidateText.lastIndexOf(" ");
-		if (breakIndex <= 0) {
-			wrappedLines.push(candidateText);
-			remainingText = remainingText.slice(contentWidth).trimStart();
-			continue;
-		}
-		wrappedLines.push(remainingText.slice(0, breakIndex));
-		remainingText = remainingText.slice(breakIndex + 1).trimStart();
-	}
-	if (remainingText.length > 0) wrappedLines.push(remainingText);
-	return wrappedLines;
-};
-const wrapIndentedText = (text, linePrefix, width) => {
-	const contentWidth = width - linePrefix.length;
-	if (contentWidth <= 0) return indentMultilineText(text, linePrefix);
-	return text.split("\n").flatMap((lineText) => wrapLine(lineText, contentWidth)).map((lineText) => `${linePrefix}${lineText}`).join("\n");
-};
-//#endregion
-//#region src/cli/utils/render-diagnostics.ts
-const SEVERITY_ORDER = {
-	error: 0,
-	warning: 1
-};
-const colorizeBySeverity = (text, severity) => severity === "error" ? highlighter.error(text) : highlighter.warn(text);
-const sortByImportance = (diagnosticGroups) => diagnosticGroups.toSorted(([, diagnosticsA], [, diagnosticsB]) => {
-	const severityDelta = SEVERITY_ORDER[diagnosticsA[0].severity] - SEVERITY_ORDER[diagnosticsB[0].severity];
-	if (severityDelta !== 0) return severityDelta;
-	return diagnosticsB.length - diagnosticsA.length;
-});
-const collectAffectedFiles = (diagnostics) => new Set(diagnostics.map((diagnostic) => diagnostic.filePath));
-const buildVerboseSiteMap = (diagnostics) => {
-	const fileSites = /* @__PURE__ */ new Map();
-	for (const diagnostic of diagnostics) {
-		const sites = fileSites.get(diagnostic.filePath) ?? [];
-		if (diagnostic.line > 0) sites.push({
-			line: diagnostic.line,
-			suppressionHint: diagnostic.suppressionHint
-		});
-		fileSites.set(diagnostic.filePath, sites);
-	}
-	return fileSites;
-};
-const formatSiteCountBadge = (count) => count > 1 ? `×${count}` : "";
-const formatIssueCount = (count) => `${count} ${count === 1 ? "issue" : "issues"}`;
-const toRuleTitle = (ruleName) => {
-	const readableRuleName = ruleName.replace(/^(no|prefer|require|use)-/, "").replace(/^(nextjs|tanstack-start)-/, "").replaceAll("-", " ");
-	return (readableRuleName.charAt(0).toUpperCase() + readableRuleName.slice(1)).replace(/\b(css|html|url|svg|jsx|api|ua)\b/gi, (match) => match.toUpperCase());
-};
-const computeRuleNameColumnWidth = (ruleKeys) => {
-	const longestRuleNameLength = ruleKeys.reduce((longest, ruleKey) => Math.max(longest, ruleKey.length), 0);
-	return Math.max(36, longestRuleNameLength);
-};
-const padRuleNameToColumn = (ruleName, columnWidth) => {
-	if (ruleName.length >= columnWidth) return ruleName;
-	return ruleName + " ".repeat(columnWidth - ruleName.length);
-};
-const grayLine = (text) => highlighter.gray(text);
-const grayWrappedLine = (text, linePrefix) => grayLine(wrapIndentedText(text, linePrefix, 88));
-const buildCompactRuleGroupLine = (ruleKey, ruleDiagnostics, ruleNameColumnWidth) => {
-	const firstDiagnostic = ruleDiagnostics[0];
-	const icon = colorizeBySeverity(firstDiagnostic.severity === "error" ? "✗" : "⚠", firstDiagnostic.severity);
-	const siteCountBadge = formatSiteCountBadge(ruleDiagnostics.length);
-	return `  ${icon} ${siteCountBadge.length > 0 ? colorizeBySeverity(padRuleNameToColumn(ruleKey, ruleNameColumnWidth), firstDiagnostic.severity) : colorizeBySeverity(ruleKey, firstDiagnostic.severity)}${siteCountBadge.length > 0 ? ` ${highlighter.gray(siteCountBadge)}` : ""}`;
-};
-const getWorstSeverity = (diagnostics) => diagnostics.some((diagnostic) => diagnostic.severity === "error") ? "error" : "warning";
-const buildCategoryDiagnosticGroups = (diagnostics) => {
-	return [...groupBy(diagnostics, (diagnostic) => diagnostic.category).entries()].map(([category, categoryDiagnostics]) => {
-		return {
-			category,
-			diagnostics: categoryDiagnostics,
-			ruleGroups: sortByImportance([...groupBy(categoryDiagnostics, (diagnostic) => `${diagnostic.plugin}/${diagnostic.rule}`).entries()])
-		};
-	}).toSorted((categoryGroupA, categoryGroupB) => {
-		const severityDelta = SEVERITY_ORDER[getWorstSeverity(categoryGroupA.diagnostics)] - SEVERITY_ORDER[getWorstSeverity(categoryGroupB.diagnostics)];
-		if (severityDelta !== 0) return severityDelta;
-		if (categoryGroupA.diagnostics.length !== categoryGroupB.diagnostics.length) return categoryGroupB.diagnostics.length - categoryGroupA.diagnostics.length;
-		return categoryGroupA.category.localeCompare(categoryGroupB.category);
-	});
-};
-const buildDefaultRuleGroupLines = (ruleKey, ruleDiagnostics, rootDirectory) => {
-	const firstDiagnostic = ruleDiagnostics[0];
-	const ruleTitle = toRuleTitle(firstDiagnostic.rule);
-	const icon = colorizeBySeverity(firstDiagnostic.severity === "error" ? "✗" : "⚠", firstDiagnostic.severity);
-	const siteCountBadge = formatSiteCountBadge(ruleDiagnostics.length);
-	const trailingBadge = siteCountBadge.length > 0 ? ` ${highlighter.gray(siteCountBadge)}` : "";
-	const lines = [];
-	lines.push(`  ${icon} ${ruleTitle}${trailingBadge}`);
-	lines.push(grayWrappedLine(firstDiagnostic.message, "    "));
-	if (firstDiagnostic.help) lines.push(grayWrappedLine(firstDiagnostic.help, "    "));
-	if (firstDiagnostic.url) lines.push(grayLine(`    ${firstDiagnostic.url}`));
-	const firstLocation = ruleDiagnostics.find((diagnostic) => diagnostic.line > 0);
-	if (firstLocation) {
-		const locationPath = toRelativePath(firstLocation.filePath, rootDirectory);
-		lines.push(grayLine(`    ${locationPath}:${firstLocation.line}`));
-	}
-	return lines;
-};
-const buildDefaultCategoryGroupLines = (categoryGroup, visibleRuleGroups, rootDirectory) => {
-	const issueCount = formatIssueCount(categoryGroup.diagnostics.length);
-	const lines = [`${highlighter.bold(categoryGroup.category)} ${highlighter.dim(issueCount)}`];
-	for (const [ruleKey, ruleDiagnostics] of visibleRuleGroups) lines.push(...buildDefaultRuleGroupLines(ruleKey, ruleDiagnostics, rootDirectory));
-	lines.push("");
-	return lines;
-};
-const buildVerboseRuleGroupLines = (ruleKey, ruleDiagnostics, ruleNameColumnWidth) => {
-	const lines = [];
-	lines.push(buildCompactRuleGroupLine(ruleKey, ruleDiagnostics, ruleNameColumnWidth));
-	const firstDiagnostic = ruleDiagnostics[0];
-	lines.push(grayLine(indentMultilineText(firstDiagnostic.message, "      ")));
-	if (firstDiagnostic.help) lines.push(grayLine(indentMultilineText(`→ ${firstDiagnostic.help}`, "      ")));
-	const fileSites = buildVerboseSiteMap(ruleDiagnostics);
-	for (const [filePath, sites] of fileSites) if (sites.length > 0) for (const site of sites) {
-		lines.push(grayLine(`      ${filePath}:${site.line}`));
-		if (site.suppressionHint) lines.push(grayLine(`        ↳ ${site.suppressionHint}`));
-	}
-	else lines.push(grayLine(`      ${filePath}`));
-	lines.push("");
-	return lines;
-};
-const buildHiddenDiagnosticsLines = (hiddenRuleGroups) => {
-	return [
-		`  ${buildHiddenDiagnosticsSummary(hiddenRuleGroups.flatMap(([, ruleDiagnostics]) => ruleDiagnostics)).map((part) => {
-			const [icon, ...labelParts] = part.text.split(" ");
-			return `${colorizeBySeverity(icon, part.severity)} ${highlighter.dim(labelParts.join(" "))}`;
-		}).join("  ")}`,
-		grayLine("    Run `npx react-doctor@latest . --verbose` to get all details"),
-		""
-	];
-};
-const buildDefaultDiagnosticsLines = (diagnostics, rootDirectory) => {
-	const categoryGroups = buildCategoryDiagnosticGroups(diagnostics);
-	const hiddenRuleGroups = [];
-	const visibleCategoryGroups = categoryGroups.slice(0, 5);
-	const hiddenCategoryGroups = categoryGroups.slice(5);
-	const lines = [];
-	for (const categoryGroup of visibleCategoryGroups) {
-		const visibleRuleGroups = categoryGroup.ruleGroups.slice(0, 3);
-		const remainingRuleGroups = categoryGroup.ruleGroups.slice(3);
-		lines.push(...buildDefaultCategoryGroupLines(categoryGroup, visibleRuleGroups, rootDirectory));
-		hiddenRuleGroups.push(...remainingRuleGroups);
-	}
-	hiddenRuleGroups.push(...hiddenCategoryGroups.flatMap((categoryGroup) => categoryGroup.ruleGroups));
-	if (hiddenRuleGroups.length > 0) lines.push(...buildHiddenDiagnosticsLines(hiddenRuleGroups));
-	return lines;
-};
-/**
-* 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, rootDirectory) => Effect.gen(function* () {
-	let lines;
-	if (!isVerbose) lines = buildDefaultDiagnosticsLines(diagnostics, rootDirectory);
-	else {
-		const sortedRuleGroups = sortByImportance([...groupBy(diagnostics, (diagnostic) => `${diagnostic.plugin}/${diagnostic.rule}`).entries()]);
-		const ruleNameColumnWidth = computeRuleNameColumnWidth(sortedRuleGroups.map(([ruleKey]) => ruleKey));
-		lines = sortedRuleGroups.flatMap(([ruleKey, ruleDiagnostics]) => buildVerboseRuleGroupLines(ruleKey, ruleDiagnostics, ruleNameColumnWidth));
-	}
-	for (const line of lines) yield* Console.log(line);
-});
-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 sections = [
-		`Rule: ${ruleKey}`,
-		`Severity: ${firstDiagnostic.severity}`,
-		`Category: ${firstDiagnostic.category}`,
-		`Count: ${ruleDiagnostics.length}`,
-		"",
-		firstDiagnostic.message
-	];
-	if (firstDiagnostic.help) sections.push("", `Suggestion: ${firstDiagnostic.help}`);
-	if (firstDiagnostic.url) sections.push("", `Docs: ${firstDiagnostic.url}`);
-	sections.push("", "Files:");
-	const fileSites = buildVerboseSiteMap(ruleDiagnostics);
-	for (const [filePath, sites] of fileSites) if (sites.length > 0) for (const site of sites) {
-		sections.push(`  ${filePath}:${site.line}`);
-		if (site.suppressionHint) sections.push(`    ${site.suppressionHint}`);
-	}
-	else sections.push(`  ${filePath}`);
-	return sections.join("\n") + "\n";
-};
-const sortRuleGroupsByImportance = sortByImportance;
-//#endregion
 //#region ../../node_modules/.pnpm/chalk@5.6.2/node_modules/chalk/source/vendor/ansi-styles/index.js
 const ANSI_BACKGROUND_OFFSET = 10;
 const wrapAnsi16 = (offset = 0) => (code) => `\u001B[${code + offset}m`;
@@ -6226,6 +5975,31 @@ function ora(options) {
 	return new Ora(options);
 }
 //#endregion
+//#region src/cli/utils/is-ci-environment.ts
+const CI_ENVIRONMENT_VARIABLES = [
+	"GITHUB_ACTIONS",
+	"GITLAB_CI",
+	"CIRCLECI"
+];
+const CODING_AGENT_ENVIRONMENT_VARIABLES = [
+	"CLAUDECODE",
+	"CLAUDE_CODE",
+	"CURSOR_AGENT",
+	"CODEX_CI",
+	"CODEX_SANDBOX",
+	"CODEX_SANDBOX_NETWORK_DISABLED",
+	"OPENCODE",
+	"GOOSE_TERMINAL",
+	"AGENT_SESSION_ID",
+	"AMP_THREAD_ID",
+	"AGENT_THREAD_ID"
+];
+const CODING_AGENT_ENVIRONMENT_VALUE_VARIABLES = ["AGENT"];
+const CODING_AGENT_ENVIRONMENT_VALUES = { AGENT: ["amp", "goose"] };
+const isCiEnvironment = () => CI_ENVIRONMENT_VARIABLES.some((envVariable) => Boolean(process.env[envVariable])) || process.env.CI === "true";
+const isCodingAgentEnvironment = () => CODING_AGENT_ENVIRONMENT_VARIABLES.some((envVariable) => Boolean(process.env[envVariable])) || CODING_AGENT_ENVIRONMENT_VALUE_VARIABLES.some((envVariable) => CODING_AGENT_ENVIRONMENT_VALUES[envVariable].some((value) => process.env[envVariable]?.toLowerCase() === value));
+const isCiOrCodingAgentEnvironment = () => isCiEnvironment() || isCodingAgentEnvironment();
+//#endregion
 //#region src/cli/utils/is-non-interactive-environment.ts
 const NON_INTERACTIVE_ENVIRONMENT_VARIABLES = [
 	"CI",
@@ -6240,15 +6014,9 @@ const NON_INTERACTIVE_ENVIRONMENT_VARIABLES = [
 	"CIRCLECI",
 	"TRAVIS",
 	"DRONE",
-	"CLAUDECODE",
-	"CLAUDE_CODE",
-	"CURSOR_AGENT",
-	"CODEX_CI",
-	"OPENCODE",
-	"AMP_HOME",
 	"GIT_DIR"
 ];
-const isNonInteractiveEnvironment = () => NON_INTERACTIVE_ENVIRONMENT_VARIABLES.some((envVariable) => Boolean(process.env[envVariable]));
+const isNonInteractiveEnvironment = () => NON_INTERACTIVE_ENVIRONMENT_VARIABLES.some((envVariable) => Boolean(process.env[envVariable])) || isCodingAgentEnvironment();
 //#endregion
 //#region src/cli/utils/is-spinner-interactive.ts
 const isSpinnerInteractive = (stream = process.stderr) => {
@@ -6267,6 +6035,7 @@ const setSpinnerSilent = (silent) => {
 };
 const isSpinnerSilent = () => isSilent;
 const noopHandle = Object.freeze({
+	update: () => {},
 	succeed: () => {},
 	fail: () => {}
 });
@@ -6283,6 +6052,10 @@ const spinner = (text) => ({ start() {
 	if (isEnabled) instance.start();
 	let didFinalize = false;
 	return {
+		update(displayText) {
+			if (didFinalize) return;
+			instance.text = displayText;
+		},
 		succeed(displayText) {
 			if (didFinalize) return;
 			didFinalize = true;
@@ -6296,85 +6069,331 @@ const spinner = (text) => ({ start() {
 	};
 } });
 //#endregion
-//#region src/cli/utils/render-project-detection.ts
+//#region src/cli/utils/build-runtime-layers.ts
 /**
-* Each "completed step" is rendered by ora's `succeed` (writes a
-* green ✔ + the supplied label) — the ora handle is created, started,
-* and immediately succeeded so the user sees a static checklist
-* rather than a spinning frame for steps that finish synchronously.
-* The wrapping `Effect.sync` keeps the imperative IO inside the
-* Effect graph so cancellation / Console swap behave consistently
-* with the rest of the renderer.
+* Adapts the CLI's existing `spinner()` helper (an ora wrapper that
+* already handles non-interactive demotion + `setSpinnerSilent`) into
+* a `ProgressHandle` factory the orchestrator can drive via the
+* `Progress` service.
 */
-const completeStep = (message) => Effect.sync(() => {
-	spinner(message).start().succeed(message);
+const buildSpinnerProgressHandle = (text) => {
+	const oraHandle = spinner(text).start();
+	return {
+		update: (displayText) => Effect.sync(() => oraHandle.update(displayText)),
+		succeed: (displayText) => Effect.sync(() => oraHandle.succeed(displayText)),
+		fail: (displayText) => Effect.sync(() => oraHandle.fail(displayText))
+	};
+};
+/**
+* Composes the production layer stack for `inspect()`'s
+* `Effect.runPromise(Effect.provide(...))` call. Lives outside
+* `inspect.ts` so the orchestrator stays focused on Effect program
+* construction and post-scan rendering — layer wiring is its own
+* concern with its own contract.
+*
+* Same shape as `core/src/run-inspect.ts → layerInspectLive`
+* (the default for `@react-doctor/api → diagnose()`) with the
+* differences specific to the CLI path:
+*
+* - **Config**: when the caller passes `configOverride`, the
+*   already-loaded config is provided via `Config.layerOf` instead
+*   of re-loading from disk; `configSourceDirectory` is threaded
+*   through so `userConfig.plugins` resolution still anchors at
+*   the original config file location.
+* - **Score**: `layerHttp` for normal runs; `layerOf(null)` only when
+*   the caller passed `--no-score`. The orchestrator applies the
+*   `"score"` surface filter to the diagnostic set before calling
+*   `Score.compute`, so the in-band score matches what the public-API
+*   contract documents.
+* - **Progress**: `layerOra` wired to the CLI's existing ora-backed
+*   spinner helper for terminal feedback; `layerNoop` for silent /
+*   score-only / lint-skipped runs.
+*/
+const buildRuntimeLayers = (input) => {
+	const linterLayer = input.shouldSkipLint ? Linter.layerOf([]) : Linter.layerOxlint;
+	const deadCodeLayer = input.shouldRunDeadCode ? DeadCode.layerNode : DeadCode.layerOf([]);
+	const scoreLayer = input.shouldComputeScore ? Score.layerHttp : Score.layerOf(null);
+	const progressLayer = input.shouldShowProgressSpinners ? Progress.layerOra(buildSpinnerProgressHandle) : Progress.layerNoop;
+	const configLayer = input.hasConfigOverride ? Config.layerOf({
+		config: input.userConfig,
+		resolvedDirectory: input.directory,
+		configSourceDirectory: input.configSourceDirectory
+	}) : Config.layerNode;
+	return Layer.mergeAll(Project.layerNode, configLayer, Files.layerNode, Git.layerNode, linterLayer, LintPartialFailures.layerLive, deadCodeLayer, progressLayer, Reporter.layerNoop, scoreLayer);
+};
+//#endregion
+//#region src/cli/utils/noop-console.ts
+/**
+* A concrete `Console.Console` whose methods are all no-ops.
+*
+* Used by `--silent` (provided via
+* `Effect.provideService(Console.Console, makeNoopConsole())`) and by
+* `enableJsonMode` (assigned over the relevant slots on
+* `globalThis.console` so imperative legacy callsites that aren't
+* Effect-typed also fall silent). Sourcing both from a single concrete
+* object keeps "what is a no-op console" answered in one place; the
+* earlier `new Proxy({} as Console.Console, { get: () => () => undefined })`
+* combined a cast with a Proxy to do the same thing implicitly.
+*
+* The interface mirrors Effect v4's `Console.Console` shape exactly so
+* `Effect.provideService(Console.Console, makeNoopConsole())` requires
+* no cast.
+*/
+const makeNoopConsole = () => ({
+	assert: () => {},
+	clear: () => {},
+	count: () => {},
+	countReset: () => {},
+	debug: () => {},
+	dir: () => {},
+	dirxml: () => {},
+	error: () => {},
+	group: () => {},
+	groupCollapsed: () => {},
+	groupEnd: () => {},
+	info: () => {},
+	log: () => {},
+	table: () => {},
+	time: () => {},
+	timeEnd: () => {},
+	timeLog: () => {},
+	trace: () => {},
+	warn: () => {}
 });
-const printProjectDetection = (input) => Effect.gen(function* () {
-	const frameworkLabel = formatFrameworkName(input.projectInfo.framework);
-	const languageLabel = input.projectInfo.hasTypeScript ? "TypeScript" : "JavaScript";
-	yield* completeStep(`Detecting framework. Found ${highlighter.info(frameworkLabel)}.`);
-	yield* completeStep(`Detecting React version. Found ${highlighter.info(`React ${input.projectInfo.reactVersion}`)}.`);
-	yield* completeStep(`Detecting Tailwind. ${input.projectInfo.tailwindVersion ? `Found ${highlighter.info(`Tailwind ${input.projectInfo.tailwindVersion}`)}.` : "Not found."}`);
-	yield* completeStep(`Detecting language. Found ${highlighter.info(languageLabel)}.`);
-	yield* completeStep(`Detecting React Compiler. ${input.projectInfo.hasReactCompiler ? highlighter.info("Found React Compiler.") : "Not found."}`);
-	if (input.isDiffMode) yield* completeStep(`Scanning ${highlighter.info(`${input.includePaths.length}`)} changed source files.`);
-	else yield* completeStep(`Found ${highlighter.info(`${input.lintSourceFileCount ?? input.projectInfo.sourceFileCount}`)} source files.`);
-	if (input.userConfig) yield* completeStep(`Loaded ${highlighter.info("react-doctor config")}.`);
+//#endregion
+//#region src/cli/utils/render-agent-guidance.ts
+const AGENT_GUIDANCE_LINES = [
+	"Treat React Doctor diagnostics as starting hypotheses. Read the relevant code before confirming or suppressing each finding.",
+	"For each group, decide true positive, false positive, or needs-human-review, then assign high/medium/low confidence.",
+	"Do not suppress a finding without evidence from the file in question. Confidence requires code context.",
+	"Understand the root cause before editing. Fix the underlying code instead of changing react-doctor config or suppressing rules unless explicitly asked.",
+	"Investigate deeply where relevant: race conditions, security-sensitive flows, state propagation, multi-file refactors, and downstream dependency chains.",
+	"Ignore pure style preferences, theoretical issues without real impact, missing features, and unrelated pre-existing code.",
+	"Start with high-confidence fixes that preserve behavior. Leave low-confidence or product-dependent changes as notes.",
+	"Run `npx react-doctor@latest --verbose --diff` before and after changes, plus relevant tests after each focused batch.",
+	"When available, spawn subagents or isolated worktrees for independent rule families, then review and merge only the best safe fixes.",
+	"Split unrelated, broad, or behavior-changing work into separate PRs/branches instead of one large cleanup.",
+	"For confirmed issues that cannot be fixed now, create GitHub issues with the rule, file/line, confidence, impact, and proposed fix.",
+	"If a fix needs an API, UX, or architecture decision, stop and ask before editing."
+];
+const printAgentGuidance = () => Effect.gen(function* () {
+	yield* Console.log(`${highlighter.bold("Agent guidance")}`);
+	for (const line of AGENT_GUIDANCE_LINES) yield* Console.log(highlighter.gray(`  - ${line}`));
 	yield* Console.log("");
 });
 //#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);
-};
+//#region src/cli/utils/indent-multiline-text.ts
+const indentMultilineText = (text, linePrefix) => text.split("\n").map((lineText) => `${linePrefix}${lineText}`).join("\n");
 //#endregion
-//#region src/cli/utils/render-score-header.ts
-const buildScoreBarSegments = (score) => {
-	const filledCount = Math.round(score / 100 * 50);
-	const emptyCount = 50 - filledCount;
-	return {
-		filledSegment: "█".repeat(filledCount),
-		emptySegment: "░".repeat(emptyCount)
-	};
-};
-const buildScoreBar = (score) => {
-	const { filledSegment, emptySegment } = buildScoreBarSegments(score);
-	return colorizeByScore(filledSegment, score) + highlighter.dim(emptySegment);
-};
-const getDoctorFace = (score) => {
-	if (score >= 75) return ["◠ ◠", " ▽ "];
-	if (score >= 50) return ["• •", " ─ "];
-	return ["x x", " ▽ "];
+//#region src/cli/utils/render-diagnostics.ts
+const POINTER = isUnicodeSupported() ? "›" : ">";
+const SEVERITY_ORDER = {
+	error: 0,
+	warning: 1
 };
-const BRANDING_LINE = `React Doctor ${highlighter.dim("(www.react.doctor)")}`;
-const buildFaceRenderedLines = (score) => {
-	const [eyes, mouth] = getDoctorFace(score);
-	const colorize = (text) => colorizeByScore(text, score);
-	return [
-		"┌─────┐",
+const colorizeBySeverity = (text, severity) => severity === "error" ? highlighter.error(text) : highlighter.warn(text);
+const sortByImportance = (diagnosticGroups) => diagnosticGroups.toSorted(([, diagnosticsA], [, diagnosticsB]) => {
+	const severityDelta = SEVERITY_ORDER[diagnosticsA[0].severity] - SEVERITY_ORDER[diagnosticsB[0].severity];
+	if (severityDelta !== 0) return severityDelta;
+	return diagnosticsB.length - diagnosticsA.length;
+});
+const collectAffectedFiles = (diagnostics) => new Set(diagnostics.map((diagnostic) => diagnostic.filePath));
+const buildVerboseSiteMap = (diagnostics) => {
+	const fileSites = /* @__PURE__ */ new Map();
+	for (const diagnostic of diagnostics) {
+		const sites = fileSites.get(diagnostic.filePath) ?? [];
+		if (diagnostic.line > 0) sites.push({
+			line: diagnostic.line,
+			suppressionHint: diagnostic.suppressionHint
+		});
+		fileSites.set(diagnostic.filePath, sites);
+	}
+	return fileSites;
+};
+const formatSiteCountBadge = (count) => count > 1 ? `×${count}` : "";
+const computeRuleNameColumnWidth = (ruleKeys) => {
+	const longestRuleNameLength = ruleKeys.reduce((longest, ruleKey) => Math.max(longest, ruleKey.length), 0);
+	return Math.max(36, longestRuleNameLength);
+};
+const padRuleNameToColumn = (ruleName, columnWidth) => {
+	if (ruleName.length >= columnWidth) return ruleName;
+	return ruleName + " ".repeat(columnWidth - ruleName.length);
+};
+const grayLine = (text) => highlighter.gray(text);
+const buildCompactRuleGroupLine = (ruleKey, ruleDiagnostics, ruleNameColumnWidth) => {
+	const firstDiagnostic = ruleDiagnostics[0];
+	const icon = colorizeBySeverity(firstDiagnostic.severity === "error" ? "✗" : "⚠", firstDiagnostic.severity);
+	const siteCountBadge = formatSiteCountBadge(ruleDiagnostics.length);
+	return `  ${icon} ${siteCountBadge.length > 0 ? colorizeBySeverity(padRuleNameToColumn(ruleKey, ruleNameColumnWidth), firstDiagnostic.severity) : colorizeBySeverity(ruleKey, firstDiagnostic.severity)}${siteCountBadge.length > 0 ? ` ${highlighter.gray(siteCountBadge)}` : ""}`;
+};
+const getWorstSeverity = (diagnostics) => diagnostics.some((diagnostic) => diagnostic.severity === "error") ? "error" : "warning";
+const buildCategoryDiagnosticGroups = (diagnostics) => {
+	return [...groupBy(diagnostics, (diagnostic) => diagnostic.category).entries()].map(([category, categoryDiagnostics]) => {
+		return {
+			category,
+			diagnostics: categoryDiagnostics,
+			ruleGroups: sortByImportance([...groupBy(categoryDiagnostics, (diagnostic) => `${diagnostic.plugin}/${diagnostic.rule}`).entries()])
+		};
+	}).toSorted((categoryGroupA, categoryGroupB) => {
+		const severityDelta = SEVERITY_ORDER[getWorstSeverity(categoryGroupA.diagnostics)] - SEVERITY_ORDER[getWorstSeverity(categoryGroupB.diagnostics)];
+		if (severityDelta !== 0) return severityDelta;
+		if (categoryGroupA.diagnostics.length !== categoryGroupB.diagnostics.length) return categoryGroupB.diagnostics.length - categoryGroupA.diagnostics.length;
+		return categoryGroupA.category.localeCompare(categoryGroupB.category);
+	});
+};
+const buildCompactCategoryLine = (categoryGroup) => {
+	const errorCount = categoryGroup.diagnostics.filter((diagnostic) => diagnostic.severity === "error").length;
+	const warningCount = categoryGroup.diagnostics.filter((diagnostic) => diagnostic.severity === "warning").length;
+	const parts = [];
+	if (errorCount > 0) parts.push(highlighter.error(`${errorCount} ${errorCount === 1 ? "error" : "errors"}`));
+	if (warningCount > 0) parts.push(highlighter.warn(highlighter.dim(`${warningCount} ${warningCount === 1 ? "warning" : "warnings"}`)));
+	return `  ${highlighter.bold(categoryGroup.category)} ${highlighter.dim(POINTER)} ${parts.join(highlighter.dim(", "))}`;
+};
+const buildVerboseRuleGroupLines = (ruleKey, ruleDiagnostics, ruleNameColumnWidth) => {
+	const lines = [];
+	lines.push(buildCompactRuleGroupLine(ruleKey, ruleDiagnostics, ruleNameColumnWidth));
+	const firstDiagnostic = ruleDiagnostics[0];
+	lines.push(grayLine(indentMultilineText(firstDiagnostic.message, "      ")));
+	if (firstDiagnostic.help) lines.push(grayLine(indentMultilineText(`→ ${firstDiagnostic.help}`, "      ")));
+	const fileSites = buildVerboseSiteMap(ruleDiagnostics);
+	for (const [filePath, sites] of fileSites) if (sites.length > 0) for (const site of sites) {
+		lines.push(grayLine(`      ${filePath}:${site.line}`));
+		if (site.suppressionHint) lines.push(grayLine(`        ↳ ${site.suppressionHint}`));
+	}
+	else lines.push(grayLine(`      ${filePath}`));
+	lines.push("");
+	return lines;
+};
+const buildDefaultDiagnosticsLines = (diagnostics) => {
+	const categoryGroups = buildCategoryDiagnosticGroups(diagnostics);
+	const lines = [];
+	for (const categoryGroup of categoryGroups) lines.push(buildCompactCategoryLine(categoryGroup));
+	lines.push("");
+	return lines;
+};
+/**
+* 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, rootDirectory) => Effect.gen(function* () {
+	let lines;
+	if (!isVerbose) lines = buildDefaultDiagnosticsLines(diagnostics);
+	else {
+		const sortedRuleGroups = sortByImportance([...groupBy(diagnostics, (diagnostic) => `${diagnostic.plugin}/${diagnostic.rule}`).entries()]);
+		const ruleNameColumnWidth = computeRuleNameColumnWidth(sortedRuleGroups.map(([ruleKey]) => ruleKey));
+		lines = sortedRuleGroups.flatMap(([ruleKey, ruleDiagnostics]) => buildVerboseRuleGroupLines(ruleKey, ruleDiagnostics, ruleNameColumnWidth));
+	}
+	for (const line of lines) yield* Console.log(line);
+});
+const formatRuleSummary = (ruleKey, ruleDiagnostics) => {
+	const firstDiagnostic = ruleDiagnostics[0];
+	const sections = [
+		`Rule: ${ruleKey}`,
+		`Severity: ${firstDiagnostic.severity}`,
+		`Category: ${firstDiagnostic.category}`,
+		`Count: ${ruleDiagnostics.length}`,
+		"",
+		firstDiagnostic.message
+	];
+	if (firstDiagnostic.help) sections.push("", `Suggestion: ${firstDiagnostic.help}`);
+	if (firstDiagnostic.url) sections.push("", `Docs: ${firstDiagnostic.url}`);
+	sections.push("", "Files:");
+	const fileSites = buildVerboseSiteMap(ruleDiagnostics);
+	for (const [filePath, sites] of fileSites) if (sites.length > 0) for (const site of sites) {
+		sections.push(`  ${filePath}:${site.line}`);
+		if (site.suppressionHint) sections.push(`    ${site.suppressionHint}`);
+	}
+	else sections.push(`  ${filePath}`);
+	return sections.join("\n") + "\n";
+};
+const sortRuleGroupsByImportance = sortByImportance;
+//#endregion
+//#region src/cli/utils/render-project-detection.ts
+const printProjectDetection = (_input) => Effect.void;
+//#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/render-score-header.ts
+const SCORE_BAR_ANIMATION_FRAME_COUNT = 40;
+const SCORE_BAR_ANIMATION_FRAME_DELAY_MS = 50;
+const easeOutCubic = (progress) => 1 - (1 - progress) ** 3;
+const sleep = (milliseconds) => Effect.promise(() => new Promise((resolve) => setTimeout(resolve, milliseconds)));
+const buildScoreBarSegments = (filledCount) => {
+	const emptyCount = 50 - filledCount;
+	return {
+		filledSegment: "█".repeat(filledCount),
+		emptySegment: "░".repeat(emptyCount)
+	};
+};
+const getFilledCount = (score) => Math.round(score / 100 * 50);
+const buildScoreBar = (displayScore, colorScore = displayScore) => {
+	const { filledSegment, emptySegment } = buildScoreBarSegments(getFilledCount(displayScore));
+	return colorizeByScore(filledSegment, colorScore) + highlighter.dim(emptySegment);
+};
+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 buildFaceRenderedLines = (score) => {
+	const [eyes, mouth] = getDoctorFace(score);
+	const colorize = (text) => colorizeByScore(text, score);
+	return [
+		"┌─────┐",
 		`│ ${eyes} │`,
 		`│ ${mouth} │`,
 		"└─────┘"
 	].map(colorize);
 };
-const printScoreHeader = (scoreResult) => Effect.gen(function* () {
+const buildScoreHeaderLine = (faceLine, rightColumnContent) => {
+	return `  ${faceLine}${rightColumnContent.length > 0 ? "  " : ""}${rightColumnContent}`;
+};
+const writeScoreHeaderLine = (line) => Effect.sync(() => {
+	process.stdout.write(line);
+});
+const buildScoreLine = (displayScore, finalScore, label, projectName) => {
+	const scoreNumber = colorizeByScore(`${displayScore}`, finalScore);
+	const scoreLabel = colorizeByScore(label, finalScore);
+	const projectSuffix = projectName ? ` ${highlighter.dim("·")} ${highlighter.dim(projectName)}` : "";
+	return `${scoreNumber} ${highlighter.dim(`/ 100`)} ${scoreLabel}${projectSuffix}`;
+};
+const printAnimatedScore = (scoreFaceLine, barFaceLine, score, label, projectName) => Effect.gen(function* () {
+	for (let frame = 0; frame <= SCORE_BAR_ANIMATION_FRAME_COUNT; frame += 1) {
+		const progress = easeOutCubic(frame / SCORE_BAR_ANIMATION_FRAME_COUNT);
+		const animatedScore = Math.round(score * progress);
+		const animatedScoreLine = buildScoreLine(animatedScore, score, label, projectName);
+		const animatedBarLine = buildScoreBar(animatedScore, score);
+		yield* writeScoreHeaderLine(`${frame === 0 ? "" : "\x1B[2A"}\r${buildScoreHeaderLine(scoreFaceLine, animatedScoreLine)}\n\r${buildScoreHeaderLine(barFaceLine, animatedBarLine)}\n`);
+		if (frame < SCORE_BAR_ANIMATION_FRAME_COUNT) yield* sleep(SCORE_BAR_ANIMATION_FRAME_DELAY_MS);
+	}
+});
+const printScoreHeader = (scoreResult, projectName) => Effect.gen(function* () {
 	const renderedFaceLines = buildFaceRenderedLines(scoreResult.score);
-	const scoreNumber = colorizeByScore(`${scoreResult.score}`, scoreResult.score);
-	const scoreLabel = colorizeByScore(scoreResult.label, scoreResult.score);
+	const shouldAnimate = !isSpinnerSilent() && isSpinnerInteractive(process.stdout);
 	const rightColumnLines = [
-		`${scoreNumber} ${highlighter.dim(`/ 100`)} ${scoreLabel}`,
-		buildScoreBar(scoreResult.score),
+		buildScoreLine(shouldAnimate ? 0 : scoreResult.score, scoreResult.score, scoreResult.label, projectName),
+		shouldAnimate ? buildScoreBar(0, scoreResult.score) : buildScoreBar(scoreResult.score),
 		BRANDING_LINE,
 		""
 	];
 	for (let lineIndex = 0; lineIndex < renderedFaceLines.length; lineIndex += 1) {
 		const rightColumnContent = rightColumnLines[lineIndex] ?? "";
-		const separator = rightColumnContent.length > 0 ? "  " : "";
-		yield* Console.log(`  ${renderedFaceLines[lineIndex]}${separator}${rightColumnContent}`);
+		yield* Console.log(buildScoreHeaderLine(renderedFaceLines[lineIndex], rightColumnContent));
 	}
 	yield* Console.log("");
+	if (shouldAnimate) {
+		yield* writeScoreHeaderLine("\x1B[5A");
+		yield* printAnimatedScore(renderedFaceLines[0], renderedFaceLines[1], scoreResult.score, scoreResult.label, projectName);
+		yield* writeScoreHeaderLine("\x1B[3B");
+	}
 });
 const printBrandingOnlyHeader = Effect.gen(function* () {
 	yield* Console.log(`  ${BRANDING_LINE}`);
@@ -6409,31 +6428,27 @@ const buildShareUrl = (diagnostics, scoreResult, projectName) => {
 	if (affectedFileCount > 0) params.set("f", String(affectedFileCount));
 	return `${SHARE_BASE_URL}?${params.toString()}`;
 };
-const printCountsSummaryLine = (diagnostics, totalSourceFileCount, elapsedMilliseconds) => Effect.gen(function* () {
+const printCountsSummaryLine = (diagnostics, isVerbose) => Effect.gen(function* () {
+	const totalIssueCount = diagnostics.length;
 	const errorCount = diagnostics.filter((diagnostic) => diagnostic.severity === "error").length;
 	const warningCount = diagnostics.filter((diagnostic) => diagnostic.severity === "warning").length;
-	const affectedFileCount = collectAffectedFiles(diagnostics).size;
-	const totalIssueCount = diagnostics.length;
-	const elapsedTimeLabel = formatElapsedTime(elapsedMilliseconds);
-	const issueCountColor = errorCount > 0 ? highlighter.error : warningCount > 0 ? highlighter.warn : highlighter.dim;
-	const issueCountText = `${totalIssueCount} ${totalIssueCount === 1 ? "issue" : "issues"}`;
-	const fileCountText = totalSourceFileCount > 0 ? `across ${affectedFileCount}/${totalSourceFileCount} files` : `across ${affectedFileCount} file${affectedFileCount === 1 ? "" : "s"}`;
-	const elapsedTimeText = `in ${elapsedTimeLabel}`;
-	yield* Console.log(`  ${issueCountColor(issueCountText)} ${highlighter.dim(`${fileCountText}  ${elapsedTimeText}`)}`);
+	const issueText = (errorCount > 0 ? highlighter.error : warningCount > 0 ? highlighter.warn : highlighter.dim)(`${totalIssueCount} ${totalIssueCount === 1 ? "issue" : "issues"}`);
+	yield* Console.log(`  ${issueText}`);
+	if (!isVerbose && totalIssueCount > 0) yield* Console.log(highlighter.dim(`  Run ${highlighter.info("npx react-doctor@latest --verbose")} to see details`));
 });
 const printSummary = (input) => Effect.gen(function* () {
-	if (input.scoreResult) yield* printScoreHeader(input.scoreResult);
+	if (input.scoreResult) yield* printScoreHeader(input.scoreResult, input.projectName);
 	else yield* printNoScoreHeader(input.noScoreMessage);
-	yield* printCountsSummaryLine(input.diagnostics, input.totalSourceFileCount, input.elapsedMilliseconds);
+	yield* printCountsSummaryLine(input.diagnostics, input.verbose ?? false);
 	const diagnosticsDirectory = yield* Effect.try({
 		try: () => writeDiagnosticsDirectory(input.diagnostics),
 		catch: (cause) => cause
 	}).pipe(Effect.orElseSucceed(() => null));
-	if (diagnosticsDirectory !== null) yield* Console.log(highlighter.gray(`  Full diagnostics written to ${diagnosticsDirectory}`));
+	if (diagnosticsDirectory !== null && input.verbose) yield* Console.log(highlighter.gray(`  Full diagnostics written to ${diagnosticsDirectory}`));
 	if (!input.isOffline) {
 		yield* Console.log("");
 		const shareUrl = buildShareUrl(input.diagnostics, input.scoreResult, input.projectName);
-		yield* Console.log(`  ${highlighter.bold("→ Share your results:")} ${highlighter.info(shareUrl)}`);
+		yield* Console.log(`  ${highlighter.bold("→ Share:")} ${highlighter.info(shareUrl)}`);
 		yield* Console.log("");
 	}
 });
@@ -6546,10 +6561,10 @@ const resolveOxlintNodeEffect = (isLintEnabled, isQuiet) => Effect.gen(function*
 const resolveOxlintNode = (isLintEnabled, isQuiet) => Effect.runPromise(resolveOxlintNodeEffect(isLintEnabled, isQuiet).pipe(Effect.provide(NodeResolver.layerNode)));
 //#endregion
 //#region src/cli/utils/version.ts
-const VERSION = "0.2.6";
+const VERSION = "0.2.8";
 //#endregion
 //#region src/inspect.ts
-const silentConsole = new Proxy({}, { get: () => () => void 0 });
+const silentConsole = makeNoopConsole();
 const runConsole = (effect) => {
 	Effect.runSync(effect);
 };
@@ -6565,6 +6580,8 @@ const mergeInspectOptions = (inputOptions, userConfig) => ({
 	scoreOnly: inputOptions.scoreOnly ?? false,
 	noScore: inputOptions.noScore ?? userConfig?.noScore ?? false,
 	isCi: inputOptions.isCi ?? false,
+	isCiOrCodingAgentEnvironment: isCiOrCodingAgentEnvironment(),
+	isNonInteractiveEnvironment: isNonInteractiveEnvironment(),
 	silent: inputOptions.silent ?? false,
 	includePaths: inputOptions.includePaths ?? [],
 	customRulesOnly: userConfig?.customRulesOnly ?? false,
@@ -6572,39 +6589,24 @@ const mergeInspectOptions = (inputOptions, userConfig) => ({
 	respectInlineDisables: inputOptions.respectInlineDisables ?? userConfig?.respectInlineDisables ?? true,
 	adoptExistingLintConfig: userConfig?.adoptExistingLintConfig ?? true,
 	ignoredTags: buildIgnoredTags(userConfig),
-	outputSurface: inputOptions.outputSurface ?? "cli"
+	outputSurface: inputOptions.outputSurface ?? "cli",
+	suppressRendering: inputOptions.suppressRendering ?? false
 });
-/**
-* Tagged-reason → legacy-class dispatch for the public `inspect()`
-* contract. Each case converts a `ReactDoctorError` reason into the
-* historical thrown class (`NoReactDependencyError`, …) via
-* `Effect.die`, which `Effect.runPromise` re-throws unchanged.
-* Unmatched reasons (GitInvocationFailed, OxlintSpawnFailed, …)
-* flow through as the original tagged `ReactDoctorError` instance.
-*
-* Adding a new public thrown class is one new entry on this object
-* — no `instanceof` checks, no `switch` ladder. The function form
-* (vs. the standalone constant) is required so `Effect.catchReasons`
-* gets the surrounding Effect's error channel for type inference.
-*/
-const restoreLegacyThrow = (effect) => effect.pipe(Effect.catchReasons("ReactDoctorError", {
-	NoReactDependency: (reason) => Effect.die(new NoReactDependencyError(reason.directory)),
-	ProjectNotFound: (reason) => Effect.die(new ProjectNotFoundError(reason.directory)),
-	AmbiguousProject: (reason) => Effect.die(new AmbiguousProjectError(reason.directory, [...reason.candidates]))
-}, (_reason, error) => Effect.die(new Error(error.message))));
 const inspect = async (directory, inputOptions = {}) => {
 	const startTime = performance.now();
 	const hasConfigOverride = inputOptions.configOverride !== void 0;
-	let scanDirectory = directory;
+	let scanDirectory;
 	let userConfig;
-	let configSourceDirectory = null;
-	if (hasConfigOverride) userConfig = inputOptions.configOverride ?? null;
-	else {
-		const loadedConfig = loadConfigWithSource(directory);
-		const redirectedDirectory = resolveConfigRootDir(loadedConfig?.config ?? null, loadedConfig?.sourceDirectory ?? null);
-		if (redirectedDirectory) scanDirectory = redirectedDirectory;
-		userConfig = loadedConfig?.config ?? null;
-		configSourceDirectory = loadedConfig?.sourceDirectory ?? null;
+	let configSourceDirectory;
+	if (hasConfigOverride) {
+		scanDirectory = directory;
+		userConfig = inputOptions.configOverride ?? null;
+		configSourceDirectory = null;
+	} else {
+		const scanTarget = resolveScanTarget(directory);
+		scanDirectory = scanTarget.resolvedDirectory;
+		userConfig = scanTarget.userConfig;
+		configSourceDirectory = scanTarget.configSourceDirectory;
 	}
 	const options = mergeInspectOptions(inputOptions, userConfig);
 	const wasSpinnerSilent = isSpinnerSilent();
@@ -6619,79 +6621,50 @@ const runInspectWithRuntime = async (directory, options, userConfig, hasConfigOv
 	const isDiffMode = options.includePaths.length > 0;
 	const resolvedNodeBinaryPath = await resolveOxlintNode(options.lint, options.scoreOnly || options.silent);
 	const lintBindingMissing = options.lint && !resolvedNodeBinaryPath;
+	const shouldShowProgressSpinners = !options.isCiOrCodingAgentEnvironment && !options.silent && !options.scoreOnly && options.lint && Boolean(resolvedNodeBinaryPath);
 	const layers = buildRuntimeLayers({
 		directory,
 		hasConfigOverride,
 		userConfig,
 		configSourceDirectory,
 		shouldSkipLint: !options.lint || lintBindingMissing,
-		shouldRunDeadCode: options.deadCode
-	});
-	const program = Effect.gen(function* () {
-		const spinnerRef = yield* Ref.make(null);
-		return {
-			output: yield* runInspect({
-				directory,
-				includePaths: options.includePaths,
-				customRulesOnly: options.customRulesOnly,
-				respectInlineDisables: options.respectInlineDisables,
-				adoptExistingLintConfig: options.adoptExistingLintConfig,
-				ignoredTags: options.ignoredTags,
-				nodeBinaryPath: resolvedNodeBinaryPath ?? void 0,
-				runDeadCode: options.deadCode,
-				isCi: options.isCi,
-				doctorVersion: VERSION,
-				resolveLocalGithubViewerPermission: !options.noScore
-			}, {
-				beforeLint: (projectInfo, lintIncludePaths) => Effect.gen(function* () {
-					const lintSourceFileCount = lintIncludePaths?.length ?? projectInfo.sourceFileCount;
-					if (!options.scoreOnly) yield* printProjectDetection({
-						projectInfo,
-						userConfig,
-						isDiffMode,
-						includePaths: options.includePaths,
-						lintSourceFileCount
-					});
-					if (options.lint && resolvedNodeBinaryPath && !options.scoreOnly && !options.silent) {
-						const handle = spinner("Running lint checks...").start();
-						yield* Ref.set(spinnerRef, {
-							succeed: (text) => handle.succeed(text),
-							fail: (text) => handle.fail(text)
-						});
-					}
-				}),
-				afterLint: (didFail) => Effect.gen(function* () {
-					const handle = yield* Ref.get(spinnerRef);
-					if (handle && !didFail) handle.succeed("Running lint checks.");
-				})
-			}),
-			finalHandle: yield* Ref.get(spinnerRef)
-		};
+		shouldRunDeadCode: options.deadCode,
+		shouldComputeScore: !options.noScore,
+		shouldShowProgressSpinners
 	});
+	const program = runInspect({
+		directory,
+		includePaths: options.includePaths,
+		customRulesOnly: options.customRulesOnly,
+		respectInlineDisables: options.respectInlineDisables,
+		adoptExistingLintConfig: options.adoptExistingLintConfig,
+		ignoredTags: options.ignoredTags,
+		nodeBinaryPath: resolvedNodeBinaryPath ?? void 0,
+		runDeadCode: options.deadCode,
+		isCi: options.isCi,
+		doctorVersion: VERSION,
+		resolveLocalGithubViewerPermission: !options.noScore
+	}, { beforeLint: (projectInfo, lintIncludePaths) => Effect.gen(function* () {
+		if (options.scoreOnly || options.suppressRendering) return;
+		const lintSourceFileCount = lintIncludePaths?.length ?? projectInfo.sourceFileCount;
+		yield* printProjectDetection({
+			projectInfo,
+			userConfig,
+			isDiffMode,
+			includePaths: options.includePaths,
+			lintSourceFileCount
+		});
+	}) });
 	const programWithLayers = options.silent ? program.pipe(Effect.provide(layers), Effect.provideService(Console.Console, silentConsole), Effect.provide(layerOtlp)) : program.pipe(Effect.provide(layers), Effect.provide(layerOtlp));
-	const { output, finalHandle: finalSpinnerHandle } = await Effect.runPromise(restoreLegacyThrow(programWithLayers));
+	const output = await Effect.runPromise(restoreLegacyThrow(programWithLayers));
 	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;
 	const lintFailureReasonTag = output.lintFailureReasonTag;
 	const isNativeBindingFailure = lintFailureReasonTag === "OxlintUnavailable" || lintFailureReasonTag === "OxlintSpawnFailed";
-	if (!options.scoreOnly && !lintBindingMissing && output.didLintFail && finalSpinnerHandle !== null && lintFailureReason !== null) if (isNativeBindingFailure && /native binding/.test(lintFailureReason)) {
-		finalSpinnerHandle.fail(`Lint checks failed — oxlint native binding not found (Node ${process.version}).`);
-		runConsole(Console.log(highlighter.gray(`  Upgrade to Node ${OXLINT_NODE_REQUIREMENT} or run: npx -p oxlint@latest react-doctor@latest`)));
-	} else {
-		finalSpinnerHandle.fail("Lint checks failed (non-fatal, skipping).");
-		runConsole(Console.error(highlighter.error(lintFailureReason)));
-	}
-	if (!options.scoreOnly && !options.silent && options.deadCode && !isDiffMode) {
-		const deadCodeSpinner = spinner("Analyzing dead code...").start();
-		if (output.didDeadCodeFail) deadCodeSpinner.fail("Dead-code analysis failed (non-fatal, skipping).");
-		else deadCodeSpinner.succeed("Analyzing dead code.");
-	}
+	if (!options.scoreOnly && !lintBindingMissing && output.didLintFail && lintFailureReason !== null) if (isNativeBindingFailure && /native binding/.test(lintFailureReason)) runConsole(Console.log(highlighter.gray(`  Upgrade to Node ${OXLINT_NODE_REQUIREMENT} or run: npx -p oxlint@latest react-doctor@latest`)));
+	else runConsole(Console.error(highlighter.error(lintFailureReason)));
 	const inspectDiagnostics = output.diagnostics;
-	const scoreDiagnostics = filterDiagnosticsForSurface([...inspectDiagnostics], "score", output.userConfig);
-	const score = didLintFail || options.noScore ? null : await calculateScore([...scoreDiagnostics], {
-		isCi: options.isCi,
-		metadata: output.scoreMetadata
-	});
+	const score = didLintFail ? null : output.score;
 	const finalizeInput = {
 		options,
 		elapsedMilliseconds: performance.now() - startTime,
@@ -6727,6 +6700,7 @@ const finalizeAndRender = (input) => Effect.gen(function* () {
 		project,
 		elapsedMilliseconds
 	});
+	if (options.suppressRendering) return buildResult();
 	if (options.scoreOnly) {
 		if (score) yield* Console.log(`${score.score}`);
 		else yield* Console.log(highlighter.gray(noScoreMessage));
@@ -6751,6 +6725,7 @@ const finalizeAndRender = (input) => Effect.gen(function* () {
 	}
 	yield* Console.log("");
 	yield* printDiagnostics([...surfaceDiagnostics], options.verbose, directory);
+	if (options.isNonInteractiveEnvironment && options.outputSurface !== "prComment") yield* printAgentGuidance();
 	if (demotedDiagnosticCount > 0) {
 		yield* Console.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* Console.log("");
@@ -6763,7 +6738,8 @@ const finalizeAndRender = (input) => Effect.gen(function* () {
 		projectName: project.projectName,
 		totalSourceFileCount: lintSourceFileCount,
 		noScoreMessage,
-		isOffline: !shouldShowShareLink
+		isOffline: !shouldShowShareLink,
+		verbose: options.verbose
 	});
 	if (hasSkippedChecks) {
 		const skippedLabel = skippedChecks.join(" and ");
@@ -6804,6 +6780,58 @@ const materializeStagedFiles = async (directory, stagedFiles, tempDirectory) =>
 };
 //#endregion
 //#region src/cli/utils/handle-error.ts
+const OTLP_ENDPOINT_ENVIRONMENT_VARIABLE = "REACT_DOCTOR_OTLP_ENDPOINT";
+const OTLP_AUTH_HEADER_ENVIRONMENT_VARIABLE = "REACT_DOCTOR_OTLP_AUTH_HEADER";
+const formatErrorForReport = (error) => isReactDoctorError(error) ? formatReactDoctorError(error) : formatErrorChain(error);
+const formatSingleLine = (text) => text.replaceAll(/\s+/g, " ").trim();
+const getErrorReportContext = () => ({
+	cwd: process.cwd(),
+	command: process.argv.join(" "),
+	nodeVersion: process.version,
+	platform: process.platform,
+	architecture: process.arch,
+	isOtlpEndpointConfigured: Boolean(process.env[OTLP_ENDPOINT_ENVIRONMENT_VARIABLE]),
+	isOtlpAuthHeaderConfigured: Boolean(process.env[OTLP_AUTH_HEADER_ENVIRONMENT_VARIABLE])
+});
+const formatConfiguredState = (isConfigured) => isConfigured ? "yes" : "no";
+const buildErrorIssueBody = (error, context) => {
+	const formattedError = formatErrorForReport(error) || "(empty error)";
+	const isOtlpExporterEnabled = context.isOtlpEndpointConfigured && context.isOtlpAuthHeaderConfigured;
+	return [
+		"## Error",
+		"",
+		"```text",
+		formattedError,
+		"```",
+		"",
+		"## Runtime",
+		"",
+		`- react-doctor version: ${VERSION}`,
+		`- node: ${context.nodeVersion}`,
+		`- platform: ${context.platform} ${context.architecture}`,
+		`- cwd: ${context.cwd}`,
+		`- command: ${context.command}`,
+		"",
+		"## OpenTelemetry",
+		"",
+		`- ${OTLP_ENDPOINT_ENVIRONMENT_VARIABLE} configured: ${formatConfiguredState(context.isOtlpEndpointConfigured)}`,
+		`- ${OTLP_AUTH_HEADER_ENVIRONMENT_VARIABLE} configured: ${formatConfiguredState(context.isOtlpAuthHeaderConfigured)} (value redacted)`,
+		`- OTLP exporter enabled: ${formatConfiguredState(isOtlpExporterEnabled)}`,
+		"- trace/span link, if exported: ",
+		"",
+		"## Notes",
+		"",
+		"Please add reproduction steps and any relevant repository details."
+	].join("\n");
+};
+const buildErrorIssueUrl = (error) => {
+	const formattedError = formatSingleLine(formatErrorForReport(error));
+	const issueUrl = new URL(`${CANONICAL_GITHUB_URL}/issues/new`);
+	issueUrl.searchParams.set("title", formattedError ? `CLI error: ${formattedError}` : "CLI error");
+	issueUrl.searchParams.set("labels", "bug");
+	issueUrl.searchParams.set("body", buildErrorIssueBody(error, getErrorReportContext()));
+	return issueUrl.toString();
+};
 /**
 * Effect-typed renderer: every message routes through `Console.error`
 * so test runs can swap `Console` to a capture sink and the output
@@ -6814,9 +6842,9 @@ const materializeStagedFiles = async (directory, stagedFiles, tempDirectory) =>
 const handleErrorEffect = (error) => Effect.gen(function* () {
 	yield* Console.error("");
 	yield* Console.error(highlighter.error("Something went wrong. Please check the error below for more details."));
-	yield* Console.error(highlighter.error(`If the problem persists, please open an issue at ${CANONICAL_GITHUB_URL}/issues.`));
+	yield* Console.error(highlighter.error(`If the problem persists, please open this prefilled issue: ${buildErrorIssueUrl(error)}`));
 	yield* Console.error("");
-	yield* Console.error(highlighter.error(isReactDoctorError(error) ? formatReactDoctorError(error) : formatErrorChain(error)));
+	yield* Console.error(highlighter.error(formatErrorForReport(error)));
 	yield* Console.error("");
 });
 /**
@@ -6833,19 +6861,30 @@ const handleError = (error, options = { shouldExit: true }) => {
 //#region src/cli/utils/json-mode.ts
 let context = null;
 /**
-* JSON mode writes the report payload to stdout; any incidental
-* log line printed by an Effect program would corrupt the JSON.
-* Effect's `Console` module resolves to `globalThis.console` by
-* default (see `effect/internal/effect.ts` → `ConsoleRef`), so
-* monkey-patching the global is enough to silence every
+* JSON mode writes the report payload to stdout; any incidental log
+* line printed by an Effect program would corrupt the JSON. Effect's
+* `Console` module resolves to `globalThis.console` by default (see
+* `effect/internal/effect.ts` → `ConsoleRef`), so copying the methods
+* from `makeNoopConsole()` onto the global is enough to silence every
 * `yield* Console.log(...)` and `cliLogger.*` call sourced from
-* react-doctor or its services. We snapshot the originals (used
-* by `writeJsonReport` → `process.stdout.write`) and never need
-* to restore — JSON mode is one-shot per CLI invocation.
+* react-doctor or its services.
+*
+* We use the same `makeNoopConsole()` source as the `--silent` path
+* (which provides the Effect Console via
+* `Effect.provideService(Console.Console, makeNoopConsole())`) — one
+* canonical "no-op console" definition shared by the two silent
+* mechanisms. The two routes still differ in how they install the
+* noop: silent mode swaps the Effect Console reference inside the
+* program; JSON mode patches the global because the surrounding CLI
+* command body is still imperative. Both will collapse into the
+* Effect-typed route once the command body finishes its migration.
+*
+* JSON mode is one-shot per CLI invocation, so we never restore.
 */
 const installSilentConsole = () => {
-	const noop = () => {};
-	const console = globalThis.console;
+	const noopConsole = makeNoopConsole();
+	const target = globalThis.console;
+	const source = noopConsole;
 	for (const key of [
 		"log",
 		"error",
@@ -6853,7 +6892,7 @@ const installSilentConsole = () => {
 		"info",
 		"debug",
 		"trace"
-	]) console[key] = noop;
+	]) target[key] = source[key];
 };
 const enableJsonMode = ({ compact, directory }) => {
 	context = {
@@ -6919,6 +6958,168 @@ const printBrandedHeader = Effect.gen(function* () {
 	yield* Console.log("");
 });
 //#endregion
+//#region src/cli/utils/copy-issues-to-clipboard.ts
+const MAX_RULES_SHOWN = 10;
+const MAX_FILES_PER_RULE = 3;
+const buildIssuesSummary = (input) => {
+	const lines = [];
+	lines.push(`# React Doctor: ${input.projectName}`);
+	if (input.score) lines.push(`Score: ${input.score.score}/100`);
+	lines.push(`${input.diagnostics.length} issues found`);
+	lines.push("");
+	const sortedRules = [...groupBy([...input.diagnostics], (diagnostic) => diagnostic.rule).entries()].sort(([, diagnosticsA], [, diagnosticsB]) => diagnosticsB.length - diagnosticsA.length);
+	const visibleRules = sortedRules.slice(0, MAX_RULES_SHOWN);
+	for (const [rule, ruleDiagnostics] of visibleRules) {
+		const severity = ruleDiagnostics[0].severity;
+		const uniqueFiles = [...new Set(ruleDiagnostics.map((diagnostic) => diagnostic.filePath))];
+		const shownFiles = uniqueFiles.slice(0, MAX_FILES_PER_RULE);
+		const remainingFileCount = uniqueFiles.length - shownFiles.length;
+		lines.push(`${severity === "error" ? "ERROR" : "WARN"} ${rule} (×${ruleDiagnostics.length})`);
+		lines.push(`  ${ruleDiagnostics[0].message}`);
+		for (const filePath of shownFiles) {
+			const firstSite = ruleDiagnostics.find((diagnostic) => diagnostic.filePath === filePath && diagnostic.line > 0);
+			lines.push(`  - ${filePath}${firstSite ? `:${firstSite.line}` : ""}`);
+		}
+		if (remainingFileCount > 0) lines.push(`  - +${remainingFileCount} more files`);
+	}
+	const hiddenRuleCount = sortedRules.length - visibleRules.length;
+	if (hiddenRuleCount > 0) {
+		lines.push("");
+		lines.push(`+${hiddenRuleCount} more rules`);
+	}
+	try {
+		const diagnosticsDirectory = writeDiagnosticsDirectory([...input.diagnostics]);
+		lines.push("");
+		lines.push(`Full trace: ${diagnosticsDirectory}`);
+	} catch {}
+	lines.push("");
+	lines.push("## How to fix");
+	lines.push("1. Run `npx react-doctor@latest --verbose` to see full details");
+	lines.push("2. Fix errors first, then warnings. Start with high-count rules.");
+	lines.push("3. Read the code before acting. Treat findings as hypotheses, not commands.");
+	lines.push("4. Fix root causes, not symptoms. Don't suppress rules without evidence.");
+	lines.push("5. Run `npx react-doctor@latest --verbose --diff` after changes to verify.");
+	lines.push("6. Split unrelated fixes into separate PRs.");
+	return lines.join("\n");
+};
+const copyToClipboard = (text) => {
+	const platform = os.platform();
+	try {
+		if (platform === "darwin") {
+			execSync("pbcopy", {
+				input: text,
+				stdio: [
+					"pipe",
+					"ignore",
+					"ignore"
+				]
+			});
+			return true;
+		}
+		if (platform === "win32") {
+			execSync("clip", {
+				input: text,
+				stdio: [
+					"pipe",
+					"ignore",
+					"ignore"
+				]
+			});
+			return true;
+		}
+		execSync("xclip -selection clipboard", {
+			input: text,
+			stdio: [
+				"pipe",
+				"ignore",
+				"ignore"
+			]
+		});
+		return true;
+	} catch {
+		return false;
+	}
+};
+const promptCopyIssues = async (input) => {
+	if (input.diagnostics.length === 0) return;
+	const { shouldCopy } = await prompts({
+		type: "confirm",
+		name: "shouldCopy",
+		message: "Copy issues to clipboard?",
+		initial: true
+	}, { onCancel: () => true });
+	if (!shouldCopy) return;
+	const issuesSummary = buildIssuesSummary(input);
+	if (copyToClipboard(issuesSummary)) cliLogger.log("  Copied to clipboard.");
+	else cliLogger.log(issuesSummary);
+};
+//#endregion
+//#region src/cli/utils/render-multi-project-summary.ts
+const SUMMARY_BAR_WIDTH_CHARS = 20;
+const buildMiniBar = (score) => {
+	const filledCount = Math.round(score / 100 * SUMMARY_BAR_WIDTH_CHARS);
+	const emptyCount = SUMMARY_BAR_WIDTH_CHARS - filledCount;
+	return colorizeByScore("█".repeat(filledCount), score) + highlighter.dim("░".repeat(emptyCount));
+};
+const getScoreLabel = (score) => {
+	if (score >= 75) return "Great";
+	if (score >= 50) return "OK";
+	return "Needs work";
+};
+const buildSummaryLine = (entry, longestProjectNameLength) => {
+	const paddedName = entry.projectName.padEnd(longestProjectNameLength);
+	const nameRendering = entry.score !== null ? colorizeByScore(paddedName, entry.score) : highlighter.dim(paddedName);
+	if (entry.score === null) {
+		const issueLabel = `${entry.issueCount} ${entry.issueCount === 1 ? "issue" : "issues"}`;
+		return `  ${nameRendering}  ${highlighter.dim("—".repeat(SUMMARY_BAR_WIDTH_CHARS))}  ${highlighter.dim("no score")}  ${highlighter.dim(issueLabel)}`;
+	}
+	const scoreRendering = colorizeByScore(String(entry.score).padStart(3), entry.score);
+	const bar = buildMiniBar(entry.score);
+	const label = colorizeByScore(getScoreLabel(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;
+	if (warningCount > 0) issuesParts.push(highlighter.warn(`${warningCount} ${warningCount === 1 ? "warning" : "warnings"}`));
+	return `  ${nameRendering}  ${scoreRendering}  ${bar}  ${label}  ${issuesParts.length > 0 ? issuesParts.join(highlighter.dim(", ")) : ""}`;
+};
+const computeAggregateScore = (completedScans) => {
+	const scoredScans = completedScans.filter((scan) => scan.result.score !== null);
+	if (scoredScans.length === 0) return null;
+	return scoredScans.reduce((worst, scan) => scan.result.score.score < worst.result.score.score ? scan : worst).result.score;
+};
+const printMultiProjectSummary = (input) => Effect.gen(function* () {
+	const { completedScans, userConfig, verbose } = input;
+	const surfaceDiagnostics = filterDiagnosticsForSurface(completedScans.flatMap((scan) => scan.result.diagnostics), "cli", userConfig);
+	if (surfaceDiagnostics.length > 0) {
+		yield* Console.log("");
+		yield* printDiagnostics(surfaceDiagnostics, verbose, "");
+	}
+	const aggregateScore = computeAggregateScore(completedScans);
+	const totalSourceFileCount = completedScans.reduce((sum, scan) => sum + scan.result.project.sourceFileCount, 0);
+	yield* printSummary({
+		diagnostics: surfaceDiagnostics,
+		elapsedMilliseconds: completedScans.reduce((sum, scan) => sum + scan.result.elapsedMilliseconds, 0),
+		scoreResult: aggregateScore,
+		projectName: completedScans.map((scan) => scan.result.project.projectName).join(", "),
+		totalSourceFileCount,
+		noScoreMessage: "Score unavailable.",
+		isOffline: true,
+		verbose
+	});
+	const entries = completedScans.map((scan) => {
+		const errorCount = scan.result.diagnostics.filter((diagnostic) => diagnostic.severity === "error").length;
+		return {
+			projectName: scan.result.project.projectName,
+			score: scan.result.score?.score ?? null,
+			issueCount: scan.result.diagnostics.length,
+			errorCount
+		};
+	});
+	const longestProjectNameLength = Math.max(...entries.map((entry) => entry.projectName.length));
+	for (const entry of entries) yield* Console.log(buildSummaryLine(entry, longestProjectNameLength));
+	yield* Console.log("");
+});
+//#endregion
 //#region src/cli/utils/git-hook-shared.ts
 const HOOK_FILE_NAME = "pre-commit";
 const HOOK_RELATIVE_PATH = "hooks/pre-commit";
@@ -6993,7 +7194,8 @@ const ensureTrailingNewline = (content) => content.endsWith("\n") ? content : `$
 //#endregion
 //#region src/cli/utils/install-doctor-script.ts
 const DOCTOR_SCRIPT_NAME = "doctor";
-const DOCTOR_SCRIPT_COMMAND = "react-doctor";
+const FALLBACK_DOCTOR_SCRIPT_NAME = "react-doctor";
+const DOCTOR_SCRIPT_COMMAND = "npx react-doctor@latest";
 const DOCTOR_PACKAGE_NAME = "react-doctor";
 const DEPENDENCY_FIELD_NAMES = [
 	"dependencies",
@@ -7001,50 +7203,87 @@ const DEPENDENCY_FIELD_NAMES = [
 	"optionalDependencies",
 	"peerDependencies"
 ];
-const getDoctorDependencyVersion = () => `^${VERSION}`;
+const isReactDoctorScriptCommand = (value) => typeof value === "string" && /\breact-doctor\b/.test(value);
+const findNearestPackageDirectory = (startDirectory, stopDirectory) => {
+	let currentDirectory = path.resolve(startDirectory);
+	const resolvedStopDirectory = stopDirectory === void 0 ? void 0 : path.resolve(stopDirectory);
+	while (true) {
+		if (existsSync(getPackageJsonPath(currentDirectory))) return currentDirectory;
+		if (currentDirectory === resolvedStopDirectory) return null;
+		const parentDirectory = path.dirname(currentDirectory);
+		if (parentDirectory === currentDirectory) return null;
+		currentDirectory = parentDirectory;
+	}
+};
 const hasDoctorScript = (projectRoot) => {
-	const packageJson = readPackageJson(projectRoot);
+	const packageJson = readPackageJson(findNearestPackageDirectory(projectRoot) ?? projectRoot);
 	if (!isRecord(packageJson)) return false;
 	const scripts = packageJson.scripts;
-	return isRecord(scripts) && Object.hasOwn(scripts, "doctor");
+	if (!isRecord(scripts)) return false;
+	return isReactDoctorScriptCommand(scripts["doctor"]) || isReactDoctorScriptCommand(scripts["react-doctor"]);
 };
 const hasDoctorDependency = (packageJson) => DEPENDENCY_FIELD_NAMES.some((fieldName) => {
 	const dependencies = packageJson[fieldName];
 	return isRecord(dependencies) && Object.hasOwn(dependencies, "react-doctor");
 });
 const installDoctorScript = (options) => {
-	const packageJsonPath = getPackageJsonPath(options.projectRoot);
-	const packageJson = readPackageJson(options.projectRoot);
+	const packageDirectory = findNearestPackageDirectory(options.projectRoot) ?? options.projectRoot;
+	const packageJsonPath = getPackageJsonPath(packageDirectory);
+	const packageJson = readPackageJson(packageDirectory);
 	if (!isRecord(packageJson)) return {
 		packageJsonPath,
 		scriptStatus: "skipped",
-		dependencyStatus: "skipped",
-		scriptReason: "missing-or-invalid-package-json",
-		dependencyReason: "missing-or-invalid-package-json"
+		scriptReason: "missing-or-invalid-package-json"
 	};
 	const scripts = packageJson.scripts;
-	const devDependencies = packageJson.devDependencies;
-	const scriptStatus = isRecord(scripts) && Object.hasOwn(scripts, "doctor") ? "existing" : scripts !== void 0 && !isRecord(scripts) ? "skipped" : "created";
-	const dependencyStatus = hasDoctorDependency(packageJson) ? "existing" : devDependencies !== void 0 && !isRecord(devDependencies) ? "skipped" : "created";
-	const didCreateScript = scriptStatus === "created";
-	const didCreateDependency = dependencyStatus === "created";
-	if (didCreateScript || didCreateDependency) writeJsonFile$1(packageJsonPath, {
+	const scriptTarget = (() => {
+		if (scripts !== void 0 && !isRecord(scripts)) return {
+			status: "skipped",
+			reason: "invalid-scripts"
+		};
+		const scriptRecord = isRecord(scripts) ? scripts : {};
+		if (isReactDoctorScriptCommand(scriptRecord["doctor"])) return {
+			scriptName: DOCTOR_SCRIPT_NAME,
+			status: "existing"
+		};
+		if (!Object.hasOwn(scriptRecord, "doctor")) {
+			if (isReactDoctorScriptCommand(scriptRecord["react-doctor"])) return {
+				scriptName: FALLBACK_DOCTOR_SCRIPT_NAME,
+				status: "existing"
+			};
+			return {
+				scriptName: DOCTOR_SCRIPT_NAME,
+				status: "created"
+			};
+		}
+		if (isReactDoctorScriptCommand(scriptRecord["react-doctor"])) return {
+			scriptName: FALLBACK_DOCTOR_SCRIPT_NAME,
+			status: "existing",
+			reason: "doctor-script-taken"
+		};
+		if (Object.hasOwn(scriptRecord, "react-doctor")) return {
+			status: "skipped",
+			reason: "script-names-taken"
+		};
+		return {
+			scriptName: FALLBACK_DOCTOR_SCRIPT_NAME,
+			status: "created",
+			reason: "doctor-script-taken"
+		};
+	})();
+	const scriptStatus = scriptTarget.status;
+	if (scriptStatus === "created") writeJsonFile$1(packageJsonPath, {
 		...packageJson,
-		...didCreateScript ? { scripts: {
+		scripts: {
 			...isRecord(scripts) ? scripts : {},
-			[DOCTOR_SCRIPT_NAME]: DOCTOR_SCRIPT_COMMAND
-		} } : {},
-		...didCreateDependency ? { devDependencies: {
-			...isRecord(devDependencies) ? devDependencies : {},
-			[DOCTOR_PACKAGE_NAME]: getDoctorDependencyVersion()
-		} } : {}
+			[scriptTarget.scriptName ?? "doctor"]: DOCTOR_SCRIPT_COMMAND
+		}
 	});
 	return {
 		packageJsonPath,
+		...scriptTarget.scriptName !== void 0 ? { scriptName: scriptTarget.scriptName } : {},
 		scriptStatus,
-		dependencyStatus,
-		...scriptStatus === "skipped" ? { scriptReason: "invalid-scripts" } : {},
-		...dependencyStatus === "skipped" ? { dependencyReason: "invalid-dev-dependencies" } : {}
+		...scriptTarget.reason !== void 0 ? { scriptReason: scriptTarget.reason } : {}
 	};
 };
 const SETUP_PROMPT_CHOICE_NEVER = "never";
@@ -7077,9 +7316,20 @@ const shouldPromptInstallSetup = (options) => {
 	if (options.isScoreOnly) return false;
 	if (options.isStaged) return false;
 	if (options.skipPrompts) return false;
+	if (isCiOrCodingAgentEnvironment()) return false;
 	if (hasDisabledSetupPrompt(options.projectRoot, options.store)) return false;
 	return !hasDoctorScript(options.projectRoot);
 };
+const resolveInstallSetupProjectRoot = (options) => {
+	if (options.completedScanDirectories.length === 0) return findNearestPackageDirectory(options.scanRoot) ?? options.scanRoot;
+	const packageDirectories = /* @__PURE__ */ new Set();
+	for (const scanDirectory of options.completedScanDirectories) {
+		const packageDirectory = findNearestPackageDirectory(scanDirectory, options.scanRoot) ?? findNearestPackageDirectory(scanDirectory) ?? scanDirectory;
+		packageDirectories.add(packageDirectory);
+	}
+	if (packageDirectories.size !== 1) return null;
+	return [...packageDirectories][0] ?? null;
+};
 const defaultWait = (milliseconds) => new Promise((resolve) => {
 	setTimeout(resolve, milliseconds);
 });
@@ -7088,20 +7338,15 @@ const defaultSelect = async (message) => {
 		type: "select",
 		name: "setupReactDoctorChoice",
 		message,
-		choices: [
-			{
-				title: "Yes",
-				value: "yes"
-			},
-			{
-				title: "No",
-				value: "no"
-			},
-			{
-				title: "No, never ask again for this project",
-				value: SETUP_PROMPT_CHOICE_NEVER
-			}
-		],
+		choices: [{
+			title: "Yes (recommended)",
+			description: "Use agents to automatically fix issues",
+			value: "yes"
+		}, {
+			title: "Skip",
+			description: "Not recommended. Issues may go unfixed.",
+			value: SETUP_PROMPT_CHOICE_NEVER
+		}],
 		initial: 0
 	}, { onCancel: () => true });
 	return setupReactDoctorChoice ?? "no";
@@ -7109,15 +7354,6 @@ const defaultSelect = async (message) => {
 const defaultWriteLine = (line = "") => {
 	console.log(line);
 };
-const buildInstallSetupPitchLines = (issueCount) => {
-	const issueLabel = `${issueCount} ${issueCount === 1 ? "issue" : "issues"}`;
-	return [
-		"",
-		issueCount > 0 ? `React Doctor found ${issueLabel}! Do you want to add React Doctor to this project? It will help humans and agents keep working through those fixes after this scan.` : "React Doctor did not find issues this time! Do you want to add React Doctor to this project? It will help humans and agents catch future regressions early.",
-		"Setup will add a `doctor` package script, install React Doctor skills for your coding agents, and offer optional hooks for pre-commit and post-edit checks.",
-		""
-	];
-};
 const formatSetupPromptFailure = (error) => error instanceof Error ? error.message : String(error);
 const warnSetupPromptFailure = async (options, error) => {
 	const message = `React Doctor setup prompt skipped: ${formatSetupPromptFailure(error)}`;
@@ -7126,22 +7362,22 @@ const warnSetupPromptFailure = async (options, error) => {
 		return;
 	}
 	try {
-		const { cliLogger } = await import("./cli-logger-Iz5pfDnL.js").then((n) => n.n);
+		const { cliLogger } = await import("./cli-logger-C35LXalM.js").then((n) => n.n);
 		cliLogger.warn(message);
 	} catch {}
 };
 const promptInstallSetup = async (options) => {
 	try {
 		if (!shouldPromptInstallSetup(options)) return;
-		await (options.wait ?? defaultWait)(300);
-		const writeLine = options.writeLine ?? defaultWriteLine;
-		for (const line of buildInstallSetupPitchLines(options.issueCount)) writeLine(line);
+		await (options.wait ?? defaultWait)(100);
 		const setupReactDoctorChoice = await (options.select ?? defaultSelect)("Set up React Doctor for this project?");
-		if (setupReactDoctorChoice === "never") {
-			disableSetupPrompt(options.projectRoot, options.store);
+		if (setupReactDoctorChoice !== "yes") {
+			if (setupReactDoctorChoice === "never") disableSetupPrompt(options.projectRoot, options.store);
+			const writeLine = options.writeLine ?? defaultWriteLine;
+			writeLine("");
+			writeLine("You can always run `npx react-doctor@latest install` to set it up later.");
 			return;
 		}
-		if (setupReactDoctorChoice !== "yes") return;
 		const install = options.install ?? (await Promise.resolve().then(() => install_skill_exports)).runInstallSkill;
 		const previousExitCode = process.exitCode;
 		let setupExitCode;
@@ -7160,25 +7396,50 @@ const promptInstallSetup = async (options) => {
 		await warnSetupPromptFailure(options, error);
 	}
 };
-//#endregion
-//#region src/cli/utils/is-ci-environment.ts
-const CI_ENVIRONMENT_VARIABLES = [
-	"GITHUB_ACTIONS",
-	"GITLAB_CI",
-	"CIRCLECI"
+const shouldShowAgentInstallHint = (options) => {
+	if (!options.hasScoredScan) return false;
+	if (options.isJsonMode) return false;
+	if (options.isScoreOnly) return false;
+	if (options.isStaged) return false;
+	if (!(options.isCodingAgent ?? isCodingAgentEnvironment())) return false;
+	if (hasDisabledSetupPrompt(options.projectRoot, options.store)) return false;
+	return !hasDoctorScript(options.projectRoot);
+};
+const AGENT_INSTALL_HINT_LINES = [
+	"React Doctor is not installed in this project.",
+	"Ask the user if they would like to set it up, then run:",
+	"",
+	"  npx react-doctor install --yes",
+	"",
+	"This adds agent skill files, a `doctor` package script, and react-doctor as a dev dependency."
 ];
-const isCiEnvironment = () => CI_ENVIRONMENT_VARIABLES.some((envVariable) => Boolean(process.env[envVariable])) || process.env.CI === "true";
+const printAgentInstallHint = (writeLine = defaultWriteLine) => {
+	writeLine("");
+	for (const line of AGENT_INSTALL_HINT_LINES) writeLine(line);
+};
 //#endregion
 //#region src/cli/utils/resolve-cli-inspect-options.ts
+/**
+* Translates CLI flags into the `InspectOptions` contract `inspect()`
+* accepts. Flag-specific computed fields (`scoreOnly`, `noScore`,
+* `silent`, `outputSurface`, `isCi`) live here — there's no
+* `userConfig` knob for them, only flag derivation. The remaining
+* boolean knobs (`lint`, `deadCode`, `verbose`, `respectInlineDisables`)
+* pass through unchanged: `inspect()` owns the userConfig-fallback
+* layer so the merge logic isn't duplicated. The shell still hands
+* `userConfig` in via `configOverride` and `noScore` so this resolver
+* can apply the one flag-and-config rule that flags own
+* (`--score false` wins, otherwise inherit `userConfig.noScore`).
+*/
 const resolveCliInspectOptions = (flags, userConfig) => ({
-	lint: flags.lint ?? userConfig?.lint ?? true,
-	deadCode: flags.deadCode ?? userConfig?.deadCode ?? true,
-	verbose: flags.verbose ?? userConfig?.verbose ?? false,
+	lint: flags.lint,
+	deadCode: flags.deadCode,
+	verbose: flags.verbose,
+	respectInlineDisables: flags.respectInlineDisables,
 	scoreOnly: flags.score === true,
 	noScore: flags.score === false || (userConfig?.noScore ?? false),
 	isCi: isCiEnvironment(),
 	silent: Boolean(flags.json),
-	respectInlineDisables: flags.respectInlineDisables ?? userConfig?.respectInlineDisables ?? true,
 	outputSurface: flags.prComment ? "prComment" : "cli"
 });
 //#endregion
@@ -7198,14 +7459,20 @@ const resolveDiffMode = async (diffInfo, effectiveDiff, shouldSkipPrompts, isQui
 	if (changedSourceFiles.length === 0) return false;
 	if (shouldSkipPrompts) return false;
 	if (isQuiet) return false;
-	const currentBranchLabel = diffInfo.currentBranch ?? "(detached HEAD)";
-	const { shouldScanChangedOnly } = await prompts({
-		type: "confirm",
-		name: "shouldScanChangedOnly",
-		message: diffInfo.isCurrentChanges ? `Found ${changedSourceFiles.length} uncommitted changed files. Only scan those?` : `On branch ${currentBranchLabel} (${changedSourceFiles.length} files changed vs ${diffInfo.baseBranch}). Only scan changed files?`,
-		initial: true
+	const { scanScope } = await prompts({
+		type: "select",
+		name: "scanScope",
+		message: "Select",
+		choices: [{
+			title: "Full codebase",
+			value: "full"
+		}, {
+			title: `Changed files (${changedSourceFiles.length})`,
+			value: "branch"
+		}],
+		initial: 0
 	});
-	return Boolean(shouldScanChangedOnly);
+	return scanScope === "branch";
 };
 //#endregion
 //#region src/cli/utils/coerce-diff-value.ts
@@ -7259,6 +7526,40 @@ const resolveProjectDiffIncludePaths = (rootDirectory, projectDirectory, diffInf
 	});
 };
 //#endregion
+//#region src/cli/utils/build-diagnostic-issue-url.ts
+const formatRuleIdentifier = (diagnostic) => `${diagnostic.plugin}/${diagnostic.rule}`;
+const buildDiagnosticIssueBody = (input) => {
+	const { diagnostic, relativeFilePath } = input;
+	const lines = [
+		"## Diagnostic",
+		"",
+		`- Rule: ${formatRuleIdentifier(diagnostic)}`,
+		`- Severity: ${diagnostic.severity}`,
+		`- Category: ${diagnostic.category}`,
+		`- Location: ${relativeFilePath}:${diagnostic.line}`,
+		"",
+		"## Message",
+		"",
+		"```text",
+		diagnostic.message,
+		"```"
+	];
+	if (diagnostic.help) lines.push("", "## Suggested Fix", "", "```text", diagnostic.help, "```");
+	lines.push("", "## Why this looks wrong or needs follow-up", "", "Please explain why this should be changed, suppressed, or treated as a false positive.");
+	return lines.join("\n");
+};
+const buildDiagnosticIssueUrl = (input) => {
+	const { diagnostic, relativeFilePath } = input;
+	const issueUrl = new URL(`${CANONICAL_GITHUB_URL}/issues/new`);
+	issueUrl.searchParams.set("title", `Diagnostic follow-up: ${formatRuleIdentifier(diagnostic)}`);
+	issueUrl.searchParams.set("labels", "bug");
+	issueUrl.searchParams.set("body", buildDiagnosticIssueBody({
+		diagnostic,
+		relativeFilePath
+	}));
+	return issueUrl.toString();
+};
+//#endregion
 //#region src/cli/utils/find-owning-project.ts
 const findOwningProjectDirectory = (rootDirectory, filePath) => {
 	const absoluteFile = path.isAbsolute(filePath) ? filePath : path.resolve(rootDirectory, filePath);
@@ -7297,7 +7598,10 @@ const parseFileLineArgument = (rawArgument) => {
 //#region src/cli/utils/select-projects.ts
 const selectProjects = async (rootDirectory, projectFlag, skipPrompts) => {
 	let packages = listWorkspacePackages(rootDirectory);
-	if (packages.length === 0) packages = discoverReactSubprojects(rootDirectory);
+	if (packages.length === 0) {
+		if (!isMonorepoRoot(rootDirectory)) return [rootDirectory];
+		packages = discoverReactSubprojects(rootDirectory);
+	}
 	if (packages.length === 0) return [rootDirectory];
 	if (packages.length === 1) {
 		cliLogger.log(`${highlighter.success("✔")} Select projects to scan ${highlighter.dim("›")} ${packages[0].name}`);
@@ -7375,6 +7679,10 @@ const runExplain = async (fileLineArgument, context) => {
 		cliLogger.log(`${severitySymbol} ${colorizedRule} ${highlighter.dim(`(${severityLabel})`)} — ${diagnostic.message}`);
 		if (diagnostic.category) cliLogger.dim(`  Category: ${diagnostic.category}`);
 		if (diagnostic.help) cliLogger.dim(`  ${diagnostic.help}`);
+		cliLogger.dim(`  If this needs follow-up or looks like a false positive, open: ${buildDiagnosticIssueUrl({
+			diagnostic,
+			relativeFilePath: requestedRelativePath
+		})}`);
 		if (diagnostic.suppressionHint) {
 			cliLogger.break();
 			cliLogger.log(`  Suppression diagnosis: ${diagnostic.suppressionHint}`);
@@ -7407,6 +7715,26 @@ const validateModeFlags = (flags) => {
 };
 //#endregion
 //#region src/cli/commands/inspect.ts
+/**
+* Post-scan finalization shared by the staged-arm and project-loop
+* paths of `inspectAction`: emit the JSON report (when in JSON mode),
+* print PR annotations (when `--annotations`), and set
+* `process.exitCode = 1` when the configured fail-on threshold is
+* crossed. Both arms previously inlined the same four-step shape.
+*/
+const finalizeScans = (input) => {
+	if (input.isJsonMode) writeJsonReport(buildJsonReport({
+		version: VERSION,
+		directory: input.resolvedDirectory,
+		mode: input.mode,
+		diff: input.diff,
+		scans: input.completedScans,
+		totalElapsedMilliseconds: performance.now() - input.startTime
+	}));
+	if (input.flags.annotations) printAnnotations(input.diagnostics, input.isJsonMode);
+	const ciFailureDiagnostics = filterDiagnosticsForSurface(input.diagnostics, "ciFailure", input.userConfig);
+	if (!input.isScoreOnly && shouldFailForDiagnostics(ciFailureDiagnostics, resolveFailOnLevel(input.flags, input.userConfig))) process.exitCode = 1;
+};
 const inspectAction = async (directory, flags) => {
 	const isScoreOnly = Boolean(flags.score);
 	const isJsonMode = Boolean(flags.json);
@@ -7419,12 +7747,11 @@ const inspectAction = async (directory, flags) => {
 	});
 	try {
 		validateModeFlags(flags);
-		const loadedConfig = loadConfigWithSource(requestedDirectory);
-		const userConfig = loadedConfig?.config ?? null;
-		const redirectedDirectory = resolveConfigRootDir(loadedConfig?.config ?? null, loadedConfig?.sourceDirectory ?? null);
-		const resolvedDirectory = redirectedDirectory ?? requestedDirectory;
+		const scanTarget = resolveScanTarget(requestedDirectory);
+		const userConfig = scanTarget.userConfig;
+		const resolvedDirectory = scanTarget.resolvedDirectory;
 		setJsonReportDirectory(resolvedDirectory);
-		if (redirectedDirectory && !isQuiet) {
+		if (scanTarget.didRedirectViaRootDir && !isQuiet) {
 			cliLogger.dim(`Redirected to ${highlighter.info(toRelativePath(resolvedDirectory, requestedDirectory))} via react-doctor config "rootDir".`);
 			cliLogger.break();
 		}
@@ -7475,12 +7802,9 @@ const inspectAction = async (directory, flags) => {
 					...diagnostic,
 					filePath: path.isAbsolute(diagnostic.filePath) ? diagnostic.filePath.replaceAll(snapshot.tempDirectory, resolvedDirectory) : diagnostic.filePath
 				}));
-				if (isJsonMode) writeJsonReport(buildJsonReport({
-					version: VERSION,
-					directory: resolvedDirectory,
-					mode: "staged",
-					diff: null,
-					scans: [{
+				finalizeScans({
+					diagnostics: remappedDiagnostics,
+					completedScans: [{
 						directory: resolvedDirectory,
 						result: {
 							...scanResult,
@@ -7491,11 +7815,15 @@ const inspectAction = async (directory, flags) => {
 							}
 						}
 					}],
-					totalElapsedMilliseconds: performance.now() - startTime
-				}));
-				if (flags.annotations) printAnnotations(remappedDiagnostics, isJsonMode);
-				const ciFailureDiagnostics = filterDiagnosticsForSurface(remappedDiagnostics, "ciFailure", userConfig);
-				if (!isScoreOnly && shouldFailForDiagnostics(ciFailureDiagnostics, resolveFailOnLevel(flags, userConfig))) process.exitCode = 1;
+					mode: "staged",
+					diff: null,
+					isJsonMode,
+					isScoreOnly,
+					flags,
+					userConfig,
+					resolvedDirectory,
+					startTime
+				});
 			} finally {
 				snapshot.cleanup();
 			}
@@ -7516,6 +7844,7 @@ const inspectAction = async (directory, flags) => {
 		}
 		const allDiagnostics = [];
 		const completedScans = [];
+		const isMultiProject = projectDirectories.length > 1;
 		for (const projectDirectory of projectDirectories) {
 			let includePaths;
 			if (isDiffMode) {
@@ -7529,42 +7858,68 @@ const inspectAction = async (directory, flags) => {
 				}
 				includePaths = changedSourceFiles;
 			}
-			if (!isQuiet) {
-				cliLogger.dim(`Scanning ${projectDirectory}...`);
-				cliLogger.break();
-			}
+			if (!isQuiet && !isMultiProject) cliLogger.dim("  ");
 			const scanResult = await inspect(projectDirectory, {
 				...scanOptions,
 				includePaths,
-				configOverride: userConfig
+				configOverride: userConfig,
+				suppressRendering: isMultiProject
 			});
 			allDiagnostics.push(...scanResult.diagnostics);
 			completedScans.push({
 				directory: projectDirectory,
 				result: scanResult
 			});
-			if (!isQuiet) cliLogger.break();
+			if (!isQuiet && !isMultiProject) cliLogger.break();
 		}
-		if (isJsonMode) writeJsonReport(buildJsonReport({
-			version: VERSION,
-			directory: resolvedDirectory,
+		if (!isQuiet && isMultiProject && completedScans.length > 0) await Effect.runPromise(printMultiProjectSummary({
+			completedScans,
+			userConfig,
+			verbose: Boolean(flags.verbose)
+		}));
+		finalizeScans({
+			diagnostics: allDiagnostics,
+			completedScans,
 			mode: isDiffMode ? "diff" : "full",
 			diff: isDiffMode ? diffInfo : null,
-			scans: completedScans,
-			totalElapsedMilliseconds: performance.now() - startTime
-		}));
-		if (flags.annotations) printAnnotations(allDiagnostics, isJsonMode);
-		const ciFailureDiagnostics = filterDiagnosticsForSurface(allDiagnostics, "ciFailure", userConfig);
-		if (!isScoreOnly && shouldFailForDiagnostics(ciFailureDiagnostics, resolveFailOnLevel(flags, userConfig))) process.exitCode = 1;
-		await promptInstallSetup({
-			projectRoot: resolvedDirectory,
-			hasScoredScan: completedScans.some((scan) => scan.result.score !== null),
-			issueCount: filterDiagnosticsForSurface(allDiagnostics, scanOptions.outputSurface ?? "cli", userConfig).length,
 			isJsonMode,
 			isScoreOnly,
-			isStaged: Boolean(flags.staged),
-			skipPrompts
+			flags,
+			userConfig,
+			resolvedDirectory,
+			startTime
+		});
+		const setupProjectRoot = resolveInstallSetupProjectRoot({
+			scanRoot: resolvedDirectory,
+			completedScanDirectories: completedScans.map((scan) => scan.directory)
 		});
+		if (setupProjectRoot !== null) {
+			const hasScoredScan = completedScans.some((scan) => scan.result.score !== null);
+			await promptInstallSetup({
+				projectRoot: setupProjectRoot,
+				hasScoredScan,
+				issueCount: filterDiagnosticsForSurface(allDiagnostics, scanOptions.outputSurface ?? "cli", userConfig).length,
+				isJsonMode,
+				isScoreOnly,
+				isStaged: Boolean(flags.staged),
+				skipPrompts
+			});
+			if (shouldShowAgentInstallHint({
+				projectRoot: setupProjectRoot,
+				hasScoredScan,
+				isJsonMode,
+				isScoreOnly,
+				isStaged: Boolean(flags.staged)
+			})) printAgentInstallHint();
+		}
+		if (!skipPrompts && !isQuiet && allDiagnostics.length > 0) {
+			const lastScan = completedScans[completedScans.length - 1];
+			await promptCopyIssues({
+				diagnostics: allDiagnostics,
+				score: lastScan?.result.score ?? null,
+				projectName: lastScan?.result.project.projectName ?? path.basename(resolvedDirectory)
+			});
+		}
 	} catch (error) {
 		if (isJsonMode) {
 			writeJsonErrorReport(error);
@@ -7765,7 +8120,7 @@ const buildAgentHookScript = () => [
 	"const input = readInput();",
 	"const scanOutput = fs.readFileSync(outputPath, 'utf8').trim();",
 	"if (!scanOutput) process.exit(0);",
-	"const message = `React Doctor found issues in the changed files. Review this output and fix the regressions before finishing:\\n\\n${scanOutput}`;",
+	"const message = `React Doctor found issues in the changed files. Review this output and fix the regressions before finishing. For confirmed issues that cannot be fixed now, create GitHub issues with the rule, file/line, confidence, impact, and proposed fix.\\n\\n${scanOutput}`;",
 	"if (input.hook_event_name === 'PostToolBatch') {",
 	"  console.log(JSON.stringify({ hookSpecificOutput: { hookEventName: 'PostToolBatch', additionalContext: message } }));",
 	"} else {",
@@ -7881,24 +8236,6 @@ const installDirectGitHook = (options) => {
 };
 //#endregion
 //#region src/cli/utils/install-git-hook-config-managers.ts
-const installSimpleGitHooks = (options) => {
-	const packageJsonPath = getPackageJsonPath(options.projectRoot);
-	const didHookExist = existsSync(packageJsonPath);
-	const packageJson = readPackageJson(options.projectRoot);
-	const nextPackageJson = isRecord(packageJson) ? { ...packageJson } : {};
-	const existingConfig = nextPackageJson["simple-git-hooks"];
-	const nextConfig = isRecord(existingConfig) ? { ...existingConfig } : {};
-	const existingPreCommit = typeof nextConfig["pre-commit"] === "string" ? nextConfig["pre-commit"] : "";
-	nextConfig["pre-commit"] = existingPreCommit.includes("react-doctor --staged --fail-on warning") ? existingPreCommit : [existingPreCommit, NON_BLOCKING_REACT_DOCTOR_COMMAND].filter(Boolean).join("\n");
-	nextPackageJson["simple-git-hooks"] = nextConfig;
-	writeJsonFile$1(packageJsonPath, nextPackageJson);
-	removeLegacyManagedRunner(options.projectRoot);
-	return {
-		hookPath: packageJsonPath,
-		kind: "simple-git-hooks",
-		status: didHookExist ? "updated" : "created"
-	};
-};
 const appendStringCommand = (existingCommand) => {
 	const existingCommandText = typeof existingCommand === "string" ? existingCommand : Array.isArray(existingCommand) ? existingCommand.filter((entry) => typeof entry === "string").join("\n") : "";
 	return existingCommandText.includes("react-doctor --staged --fail-on warning") ? existingCommandText : [existingCommandText, NON_BLOCKING_REACT_DOCTOR_COMMAND].filter(Boolean).join("\n");
@@ -7907,58 +8244,63 @@ const appendArrayCommand = (existingCommands) => {
 	const commands = Array.isArray(existingCommands) ? existingCommands.filter((entry) => typeof entry === "string") : typeof existingCommands === "string" ? [existingCommands] : [];
 	return commands.some((command) => command.includes("react-doctor --staged --fail-on warning")) ? commands : [...commands, NON_BLOCKING_REACT_DOCTOR_COMMAND];
 };
-const installPackageJsonPreCommitString = (options, kind, configKey) => {
-	const packageJsonPath = getPackageJsonPath(options.projectRoot);
-	const didHookExist = existsSync(packageJsonPath);
-	const packageJson = readPackageJson(options.projectRoot);
-	const nextPackageJson = isRecord(packageJson) ? { ...packageJson } : {};
-	const existingConfig = nextPackageJson[configKey];
-	const nextConfig = isRecord(existingConfig) ? { ...existingConfig } : {};
-	nextConfig["pre-commit"] = appendStringCommand(nextConfig["pre-commit"]);
-	nextPackageJson[configKey] = nextConfig;
-	writeJsonFile$1(packageJsonPath, nextPackageJson);
-	removeLegacyManagedRunner(options.projectRoot);
-	return {
-		hookPath: packageJsonPath,
-		kind,
-		status: didHookExist ? "updated" : "created"
-	};
-};
-const installGhooks = (options) => {
-	const packageJsonPath = getPackageJsonPath(options.projectRoot);
-	const didHookExist = existsSync(packageJsonPath);
-	const packageJson = readPackageJson(options.projectRoot);
-	const nextPackageJson = isRecord(packageJson) ? { ...packageJson } : {};
-	const existingConfig = nextPackageJson.config;
-	const nextConfig = isRecord(existingConfig) ? { ...existingConfig } : {};
-	const existingGhooks = nextConfig.ghooks;
-	const nextGhooks = isRecord(existingGhooks) ? { ...existingGhooks } : {};
-	nextGhooks["pre-commit"] = appendStringCommand(nextGhooks["pre-commit"]);
-	nextConfig.ghooks = nextGhooks;
-	nextPackageJson.config = nextConfig;
-	writeJsonFile$1(packageJsonPath, nextPackageJson);
-	removeLegacyManagedRunner(options.projectRoot);
-	return {
-		hookPath: packageJsonPath,
-		kind: "ghooks",
-		status: didHookExist ? "updated" : "created"
-	};
-};
-const installPreCommitNpm = (options) => {
+const installPackageJsonHook = (options, strategy) => {
 	const packageJsonPath = getPackageJsonPath(options.projectRoot);
 	const didHookExist = existsSync(packageJsonPath);
 	const packageJson = readPackageJson(options.projectRoot);
 	const nextPackageJson = isRecord(packageJson) ? { ...packageJson } : {};
-	nextPackageJson["pre-commit"] = appendArrayCommand(nextPackageJson["pre-commit"]);
+	const parentKeys = strategy.path.slice(0, -1);
+	const leafKey = strategy.path[strategy.path.length - 1];
+	let parent = nextPackageJson;
+	for (const key of parentKeys) {
+		const existing = parent[key];
+		const cloned = isRecord(existing) ? { ...existing } : {};
+		parent[key] = cloned;
+		parent = cloned;
+	}
+	parent[leafKey] = strategy.leafShape === "array" ? appendArrayCommand(parent[leafKey]) : appendStringCommand(parent[leafKey]);
 	writeJsonFile$1(packageJsonPath, nextPackageJson);
 	removeLegacyManagedRunner(options.projectRoot);
 	return {
 		hookPath: packageJsonPath,
-		kind: "pre-commit-npm",
+		kind: strategy.kind,
 		status: didHookExist ? "updated" : "created"
 	};
 };
-const installPrettyQuick = (options) => installPackageJsonPreCommitString(options, "pretty-quick", "gitHooks");
+const installSimpleGitHooks = (options) => installPackageJsonHook(options, {
+	kind: "simple-git-hooks",
+	path: ["simple-git-hooks", "pre-commit"],
+	leafShape: "string"
+});
+const installGhooks = (options) => installPackageJsonHook(options, {
+	kind: "ghooks",
+	path: [
+		"config",
+		"ghooks",
+		"pre-commit"
+	],
+	leafShape: "string"
+});
+const installPreCommitNpm = (options) => installPackageJsonHook(options, {
+	kind: "pre-commit-npm",
+	path: ["pre-commit"],
+	leafShape: "array"
+});
+const installPrettyQuick = (options) => installPackageJsonHook(options, {
+	kind: "pretty-quick",
+	path: ["gitHooks", "pre-commit"],
+	leafShape: "string"
+});
+const installYorkie = (options) => installPackageJsonHook(options, {
+	kind: "yorkie",
+	path: ["gitHooks", "pre-commit"],
+	leafShape: "string"
+});
+const installGitHooksJs = (options) => installPackageJsonHook(options, {
+	kind: "git-hooks-js",
+	path: ["git-hooks", "pre-commit"],
+	leafShape: "string"
+});
 const appendIndentedBlockToTopLevelSection = (content, sectionName, block) => {
 	const normalizedContent = ensureTrailingNewline(content);
 	const match = new RegExp(`^${sectionName}:\\s*$`, "m").exec(normalizedContent);
@@ -8188,9 +8530,9 @@ const installReactDoctorGitHook = (options) => {
 	if (options.kind === "lefthook") return installLefthook(options);
 	if (options.kind === "pre-commit") return installPreCommit(options);
 	if (options.kind === "overcommit") return installOvercommit(options);
-	if (options.kind === "yorkie") return installPackageJsonPreCommitString(options, "yorkie", "gitHooks");
+	if (options.kind === "yorkie") return installYorkie(options);
 	if (options.kind === "ghooks") return installGhooks(options);
-	if (options.kind === "git-hooks-js") return installPackageJsonPreCommitString(options, "git-hooks-js", "git-hooks");
+	if (options.kind === "git-hooks-js") return installGitHooksJs(options);
 	if (options.kind === "pre-commit-npm") return installPreCommitNpm(options);
 	if (options.kind === "pretty-quick") return installPrettyQuick(options);
 	return installDirectGitHook(options);
@@ -8198,7 +8540,6 @@ const installReactDoctorGitHook = (options) => {
 //#endregion
 //#region src/cli/utils/install-skill.ts
 var install_skill_exports = /* @__PURE__ */ __exportAll({ runInstallSkill: () => runInstallSkill });
-const NATIVE_AGENT_HOOK_AGENTS = new Set(["claude-code", "cursor"]);
 const CONFIG_ONLY_GIT_HOOK_KINDS = new Set([
 	"ghooks",
 	"git-hooks-js",
@@ -8210,35 +8551,167 @@ const CONFIG_ONLY_GIT_HOOK_KINDS = new Set([
 	"simple-git-hooks",
 	"yorkie"
 ]);
+const PACKAGE_MANAGER_LOCKFILES = [
+	{
+		packageManager: "pnpm",
+		fileName: "pnpm-lock.yaml"
+	},
+	{
+		packageManager: "yarn",
+		fileName: "yarn.lock"
+	},
+	{
+		packageManager: "bun",
+		fileName: "bun.lockb"
+	},
+	{
+		packageManager: "bun",
+		fileName: "bun.lock"
+	},
+	{
+		packageManager: "npm",
+		fileName: "package-lock.json"
+	}
+];
+const findNearestFileDirectory = (startDirectory, fileNames) => {
+	let currentDirectory = path.resolve(startDirectory);
+	while (true) {
+		if (fileNames.some((fileName) => existsSync(path.join(currentDirectory, fileName)))) return currentDirectory;
+		const parentDirectory = path.dirname(currentDirectory);
+		if (parentDirectory === currentDirectory) return null;
+		currentDirectory = parentDirectory;
+	}
+};
+const detectPackageManager = (projectRoot) => {
+	let currentDirectory = path.resolve(projectRoot);
+	while (true) {
+		const packageJson = readPackageJson(currentDirectory);
+		if (isRecord(packageJson) && typeof packageJson.packageManager === "string") {
+			const packageManagerName = packageJson.packageManager.split("@")[0];
+			if (packageManagerName === "pnpm" || packageManagerName === "yarn" || packageManagerName === "bun" || packageManagerName === "npm") return packageManagerName;
+		}
+		const parentDirectory = path.dirname(currentDirectory);
+		if (parentDirectory === currentDirectory) break;
+		currentDirectory = parentDirectory;
+	}
+	const lockfileDirectory = findNearestFileDirectory(projectRoot, PACKAGE_MANAGER_LOCKFILES.map((lockfile) => lockfile.fileName));
+	return PACKAGE_MANAGER_LOCKFILES.find((lockfile) => lockfileDirectory !== null && existsSync(path.join(lockfileDirectory, lockfile.fileName)))?.packageManager ?? "npm";
+};
+const packageManagerNeedsWorkspaceFlag = (projectRoot) => existsSync(path.join(projectRoot, "pnpm-workspace.yaml")) || findNearestFileDirectory(projectRoot, ["pnpm-workspace.yaml"]) !== null;
+const buildInstallCommand = (projectRoot) => {
+	const packageManager = detectPackageManager(projectRoot);
+	const packageSpecifier = `${DOCTOR_PACKAGE_NAME}@latest`;
+	if (packageManager === "npm") return {
+		command: "npm",
+		args: [
+			"install",
+			"--save-dev",
+			packageSpecifier
+		],
+		cwd: projectRoot
+	};
+	if (packageManager === "yarn") return {
+		command: "yarn",
+		args: [
+			"add",
+			"--dev",
+			packageSpecifier
+		],
+		cwd: projectRoot
+	};
+	if (packageManager === "bun") return {
+		command: "bun",
+		args: [
+			"add",
+			"--dev",
+			packageSpecifier
+		],
+		cwd: projectRoot
+	};
+	return {
+		command: "pnpm",
+		args: [
+			"add",
+			"--save-dev",
+			...packageManagerNeedsWorkspaceFlag(projectRoot) ? ["-w"] : [],
+			packageSpecifier
+		],
+		cwd: projectRoot
+	};
+};
+const defaultInstallDependencyRunner = (input) => {
+	execFileSync(input.command, [...input.args], {
+		cwd: input.cwd,
+		stdio: "inherit",
+		env: {
+			...process.env,
+			REACT_DOCTOR_INSTALL: "1"
+		}
+	});
+};
+const installReactDoctorDependency = async (options) => {
+	const packageJson = readPackageJson(options.projectRoot);
+	if (!isRecord(packageJson)) return {
+		dependencyStatus: "skipped",
+		dependencyReason: "missing-or-invalid-package-json"
+	};
+	if (hasDoctorDependency(packageJson)) return { dependencyStatus: "existing" };
+	if (packageJson.devDependencies !== void 0 && !isRecord(packageJson.devDependencies)) return {
+		dependencyStatus: "skipped",
+		dependencyReason: "invalid-dev-dependencies"
+	};
+	const runnerInput = buildInstallCommand(options.projectRoot);
+	await (options.runner ?? defaultInstallDependencyRunner)(runnerInput);
+	return { dependencyStatus: "created" };
+};
 const buildManualGitHookTarget = (hookPath, projectRoot) => ({
 	hookPath,
 	runnerRoot: projectRoot,
 	kind: "git"
 });
-const hasNativeAgentHookTarget = (agents) => agents.some((agent) => NATIVE_AGENT_HOOK_AGENTS.has(agent));
 const formatGitHookInstallMessage = (hookResult) => {
 	if (CONFIG_ONLY_GIT_HOOK_KINDS.has(hookResult.kind)) return `React Doctor pre-commit config ${hookResult.status} at ${hookResult.hookPath}. Run your hook manager's install command if hooks are not already installed.`;
 	return `React Doctor pre-commit hook ${hookResult.status} at ${hookResult.hookPath}.`;
 };
 const formatDoctorScriptInstallMessage = (scriptResult) => {
 	const messages = [];
-	if (scriptResult.scriptStatus === "created") messages.push("Added package script: doctor.");
-	else if (scriptResult.scriptStatus === "existing") messages.push("Package script already exists: doctor.");
+	const scriptName = scriptResult.scriptName ?? "doctor";
+	if (scriptResult.scriptStatus === "created") messages.push(`Added package script: ${scriptName}.`);
+	else if (scriptResult.scriptStatus === "existing") messages.push(`Package script already exists: ${scriptName}.`);
+	else if (scriptResult.scriptReason === "script-names-taken") messages.push("Skipped package script: doctor and react-doctor are already taken.");
+	else if (scriptResult.scriptReason === "doctor-script-taken") messages.push("Skipped package script: doctor and react-doctor scripts already exist.");
 	else if (scriptResult.scriptReason === "invalid-scripts") messages.push(`Skipped package script: scripts field is not an object.`);
 	else messages.push("Skipped package script: package.json missing or invalid.");
-	if (scriptResult.dependencyStatus === "created") messages.push("Added dev dependency: react-doctor.");
-	else if (scriptResult.dependencyStatus === "existing") messages.push("React Doctor dependency already exists.");
-	else if (scriptResult.dependencyReason === "invalid-dev-dependencies") messages.push("Skipped dev dependency: devDependencies field is not an object.");
-	else messages.push("Skipped dev dependency: package.json missing or invalid.");
 	return messages.join(" ");
 };
-const installReactDoctorPackageSetup = (projectRoot) => {
-	const scriptSpinner = spinner("Installing React Doctor package setup...").start();
+const formatDependencyInstallMessage = (result) => {
+	if (result.dependencyStatus === "created") return "Installed dev dependency: react-doctor.";
+	if (result.dependencyStatus === "existing") return "React Doctor dependency already exists.";
+	if (result.dependencyReason === "invalid-dev-dependencies") return "Skipped dev dependency install: devDependencies field is not an object.";
+	return "Skipped dev dependency install: package.json missing or invalid.";
+};
+const installReactDoctorPackageSetup = async (projectRoot, dependencyRunner) => {
+	const scriptSpinner = spinner("Installing React Doctor package script...").start();
 	try {
 		const scriptResult = installDoctorScript({ projectRoot });
 		scriptSpinner.succeed(formatDoctorScriptInstallMessage(scriptResult));
 	} catch (error) {
-		scriptSpinner.fail("Failed to install React Doctor package setup.");
+		scriptSpinner.fail("Failed to install React Doctor package script.");
+		throw error;
+	}
+	const dependencySpinner = spinner("Installing React Doctor package...").start();
+	try {
+		const dependencyResult = await installReactDoctorDependency({
+			projectRoot,
+			runner: dependencyRunner
+		});
+		if (dependencyResult.dependencyStatus === "skipped") {
+			dependencySpinner.fail(formatDependencyInstallMessage(dependencyResult));
+			return;
+		}
+		dependencySpinner.succeed(formatDependencyInstallMessage(dependencyResult));
+	} catch (error) {
+		dependencySpinner.fail("Failed to install React Doctor package.");
 		throw error;
 	}
 };
@@ -8247,9 +8720,9 @@ const getSkillSourceDirectory = () => {
 	return path.join(distDirectory, "skills", SKILL_NAME);
 };
 const runInstallSkill = async (options = {}) => {
-	const projectRoot = options.projectRoot ?? process.cwd();
+	const requestedProjectRoot = options.projectRoot ?? process.cwd();
+	const projectRoot = findNearestPackageDirectory(requestedProjectRoot) ?? requestedProjectRoot;
 	const sourceDir = options.sourceDir ?? getSkillSourceDirectory();
-	if (!options.dryRun) installReactDoctorPackageSetup(projectRoot);
 	if (!existsSync(path.join(sourceDir, SKILL_MANIFEST_FILE))) {
 		cliLogger.error(`Could not locate the ${SKILL_NAME} skill bundled with this package.`);
 		process.exitCode = 1;
@@ -8270,7 +8743,7 @@ const runInstallSkill = async (options = {}) => {
 	const selectedAgents = skipPrompts ? detectedAgents : (await prompts({
 		type: "multiselect",
 		name: "agents",
-		message: `Install the ${highlighter.info("react-doctor")} skill for:`,
+		message: `Install the ${highlighter.info(`/react-doctor`)} skill for:`,
 		choices: detectedAgents.map((agent) => ({
 			title: getSkillAgentConfig(agent).displayName,
 			value: agent,
@@ -8283,20 +8756,15 @@ const runInstallSkill = async (options = {}) => {
 	const shouldInstallGitHook = gitHookPath !== null && gitHookPath !== void 0 && (Boolean(options.yes) || !skipPrompts && Boolean((await prompts({
 		type: "confirm",
 		name: "installGitHook",
-		message: "Run React Doctor on staged files before commits? (non-blocking git hook)",
+		message: "Check for issues before each commit?",
 		initial: true
 	}, promptOptions)).installGitHook));
-	const shouldInstallAgentHooks = Boolean(options.agentHooks) || !skipPrompts && hasNativeAgentHookTarget(selectedAgents) && Boolean((await prompts({
-		type: "confirm",
-		name: "installAgentHooks",
-		message: "Install native agent hooks after file edits? (Claude Code / Cursor)",
-		initial: false
-	}, promptOptions)).installAgentHooks);
+	const shouldInstallAgentHooks = Boolean(options.agentHooks);
 	if (options.dryRun) {
 		cliLogger.log(`Dry run — would install ${SKILL_NAME} skill for:`);
 		for (const agent of selectedAgents) cliLogger.dim(`  - ${getSkillAgentConfig(agent).displayName}`);
 		cliLogger.dim(`  Source: ${sourceDir}`);
-		cliLogger.dim("  Package script: doctor");
+		cliLogger.dim("  Package script: doctor (or react-doctor if doctor exists)");
 		cliLogger.dim("  Dev dependency: react-doctor");
 		if (shouldInstallGitHook) cliLogger.dim(`  Git hook: ${gitHookPath}`);
 		if (shouldInstallAgentHooks) cliLogger.dim("  Agent hooks: Claude Code / Cursor when selected");
@@ -8317,6 +8785,7 @@ const runInstallSkill = async (options = {}) => {
 		installSpinner.fail(`Failed to install ${SKILL_NAME} skill.`);
 		throw error;
 	}
+	await installReactDoctorPackageSetup(projectRoot, options.installDependencyRunner);
 	if (shouldInstallGitHook && gitHookTarget !== null && gitHookTarget !== void 0) {
 		const hookSpinner = spinner("Installing React Doctor pre-commit hook...").start();
 		try {
@@ -8346,6 +8815,49 @@ const runInstallSkill = async (options = {}) => {
 			throw error;
 		}
 	}
+	const workflowsDirectory = path.join(projectRoot, ".github", "workflows");
+	const workflowTargetPath = path.join(workflowsDirectory, "react-doctor.yml");
+	if (!existsSync(workflowTargetPath) && !skipPrompts) {
+		const hasExistingWorkflows = existsSync(workflowsDirectory);
+		const { shouldInstallWorkflow } = await prompts({
+			type: "confirm",
+			name: "shouldInstallWorkflow",
+			message: "Add a GitHub Actions workflow to scan PRs?",
+			initial: hasExistingWorkflows
+		}, promptOptions);
+		if (shouldInstallWorkflow) {
+			if (!hasExistingWorkflows) mkdirSync(workflowsDirectory, { recursive: true });
+			const workflowSpinner = spinner("Adding GitHub Actions workflow...").start();
+			try {
+				writeFileSync(workflowTargetPath, [
+					"name: React Doctor",
+					"",
+					"on:",
+					"  pull_request:",
+					"    branches: [main]",
+					"",
+					"permissions:",
+					"  contents: read",
+					"  pull-requests: write",
+					"",
+					"jobs:",
+					"  react-doctor:",
+					"    runs-on: ubuntu-latest",
+					"    steps:",
+					"      - uses: actions/checkout@v4",
+					"      - uses: millionco/react-doctor@main",
+					"        with:",
+					"          github-token: ${{ secrets.GITHUB_TOKEN }}",
+					"          diff: main",
+					""
+				].join("\n"));
+				workflowSpinner.succeed(`GitHub Actions workflow added at ${path.relative(projectRoot, workflowTargetPath)}.`);
+			} catch (error) {
+				workflowSpinner.fail("Failed to add GitHub Actions workflow.");
+				throw error;
+			}
+		}
+	}
 };
 //#endregion
 //#region src/cli/commands/install.ts
@@ -8366,13 +8878,10 @@ const installAction = async (options, command) => {
 //#endregion
 //#region src/cli/utils/exit-gracefully.ts
 const exitGracefully = () => {
-	if (isJsonModeActive()) {
-		writeJsonErrorReport(/* @__PURE__ */ new Error("Scan cancelled by user (SIGINT/SIGTERM)"));
-		process.exit(130);
-	}
-	cliLogger.break();
-	cliLogger.log("Cancelled.");
-	cliLogger.break();
+	try {
+		if (isJsonModeActive()) writeJsonErrorReport(/* @__PURE__ */ new Error("Scan cancelled by user (SIGINT/SIGTERM)"));
+		else console.log("\nCancelled.\n");
+	} catch {}
 	process.exit(130);
 };
 //#endregion