react-doctor 0.2.9 → 0.2.11-dev.15e5fec

package/dist/cli.js

@@ -1,9 +1,9 @@
 import { i as __toESM, n as __exportAll, r as __require, t as __commonJSMin } from "./rolldown-runtime-uZX_iqCz.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-BliQX9s8.js";
+import { A as isMonorepoRoot, C as filterDiagnosticsForSurface, D as getDiffInfo, E as formatReactDoctorError, F as restoreLegacyThrow, I as runInspect, L as toRelativePath, M as layerOtlp, N as listWorkspacePackages, O as groupBy, P as resolveScanTarget, S as discoverReactSubprojects, T as formatErrorChain, _ 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 isReactDoctorError, k as highlighter, 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 filterSourceFiles, x as buildRulePromptUrl, y as buildJsonReport } from "./cli-logger-CSZagq1E.js";
 import { createRequire } from "node:module";
 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 fs, { 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";
@@ -6220,6 +6220,8 @@ const padRuleNameToColumn = (ruleName, columnWidth) => {
 	return ruleName + " ".repeat(columnWidth - ruleName.length);
 };
 const grayLine = (text) => highlighter.gray(text);
+const FETCH_FIX_RECIPE_LABEL = "Fetch & follow the canonical fix recipe before fixing";
+const formatFixRecipeLine = (diagnostic) => `${FETCH_FIX_RECIPE_LABEL}: ${buildRulePromptUrl(diagnostic.plugin, diagnostic.rule)}`;
 const buildCompactRuleGroupLine = (ruleKey, ruleDiagnostics, ruleNameColumnWidth) => {
 	const firstDiagnostic = ruleDiagnostics[0];
 	const icon = colorizeBySeverity(firstDiagnostic.severity === "error" ? "✗" : "⚠", firstDiagnostic.severity);
@@ -6255,6 +6257,7 @@ const buildVerboseRuleGroupLines = (ruleKey, ruleDiagnostics, ruleNameColumnWidt
 	const firstDiagnostic = ruleDiagnostics[0];
 	lines.push(grayLine(indentMultilineText(firstDiagnostic.message, "      ")));
 	if (firstDiagnostic.help) lines.push(grayLine(indentMultilineText(`→ ${firstDiagnostic.help}`, "      ")));
+	lines.push(grayLine(`      ${formatFixRecipeLine(firstDiagnostic)}`));
 	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}`));
@@ -6299,6 +6302,7 @@ const formatRuleSummary = (ruleKey, ruleDiagnostics) => {
 	];
 	if (firstDiagnostic.help) sections.push("", `Suggestion: ${firstDiagnostic.help}`);
 	if (firstDiagnostic.url) sections.push("", `Docs: ${firstDiagnostic.url}`);
+	sections.push("", formatFixRecipeLine(firstDiagnostic));
 	sections.push("", "Files:");
 	const fileSites = buildVerboseSiteMap(ruleDiagnostics);
 	for (const [filePath, sites] of fileSites) if (sites.length > 0) for (const site of sites) {
@@ -6320,11 +6324,11 @@ const colorizeByScore = (text, score) => {
 	return highlighter.error(text);
 };
 //#endregion
+//#region src/cli/utils/constants.ts
+const STAGED_FILES_TEMP_DIR_PREFIX = "react-doctor-staged-";
+const INTERNAL_ERROR_JSON_FALLBACK = "{\"schemaVersion\":1,\"ok\":false,\"error\":{\"message\":\"Internal error\",\"name\":\"Error\",\"chain\":[]}}\n";
+//#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 PERFECT_SCORE_RAINBOW_FRAME_COUNT = 16;
-const PERFECT_SCORE_RAINBOW_FRAME_DELAY_MS = 50;
 const RAINBOW_HUE_SHIFT_PER_FRAME = 9;
 const RAINBOW_GRADIENT_WIDTH = 80;
 const RAINBOW_OKLCH_LIGHTNESS = .638;
@@ -6433,8 +6437,8 @@ const buildInitialScoreHeaderLine = ({ isPerfectScore, shouldAnimate, lineIndex,
 };
 const printAnimatedScore = (scoreFaceLine, barFaceLine, score, label, projectName) => Effect.gen(function* () {
 	const isPerfectScore = score === 100;
-	for (let frame = 0; frame <= SCORE_BAR_ANIMATION_FRAME_COUNT; frame += 1) {
-		const progress = easeOutCubic(frame / SCORE_BAR_ANIMATION_FRAME_COUNT);
+	for (let frame = 0; frame <= 40; frame += 1) {
+		const progress = easeOutCubic(frame / 40);
 		const animatedScore = Math.round(score * progress);
 		if (isPerfectScore) {
 			yield* writeScoreHeaderLine(`${frame === 0 ? "" : "\x1B[4A"}\r${buildRainbowScoreHeaderFrame({
@@ -6444,16 +6448,16 @@ const printAnimatedScore = (scoreFaceLine, barFaceLine, score, label, projectNam
 				frame,
 				projectName
 			})}`);
-			if (frame < SCORE_BAR_ANIMATION_FRAME_COUNT) yield* sleep(SCORE_BAR_ANIMATION_FRAME_DELAY_MS);
+			if (frame < 40) yield* sleep(50);
 			continue;
 		}
 		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);
+		if (frame < 40) yield* sleep(50);
 	}
 	if (!isPerfectScore) return;
-	for (let frame = 0; frame < PERFECT_SCORE_RAINBOW_FRAME_COUNT; frame += 1) {
+	for (let frame = 0; frame < 16; frame += 1) {
 		yield* writeScoreHeaderLine(`\x1b[4A\r${buildRainbowScoreHeaderFrame({
 			score,
 			displayScore: score,
@@ -6461,9 +6465,9 @@ const printAnimatedScore = (scoreFaceLine, barFaceLine, score, label, projectNam
 			frame,
 			projectName
 		})}`);
-		yield* sleep(PERFECT_SCORE_RAINBOW_FRAME_DELAY_MS);
+		yield* sleep(50);
 	}
-	yield* writeScoreHeaderLine(`\x1b[4A\r${buildFinalPerfectScoreHeaderFrame(score, label, PERFECT_SCORE_RAINBOW_FRAME_COUNT, projectName)}\x1b[2A`);
+	yield* writeScoreHeaderLine(`\x1b[4A\r${buildFinalPerfectScoreHeaderFrame(score, label, 16, projectName)}\x1b[2A`);
 });
 const printScoreHeader = (scoreResult, projectName) => Effect.gen(function* () {
 	const isPerfectScore = scoreResult.score === 100;
@@ -6539,7 +6543,11 @@ const printCountsSummaryLine = (diagnostics, isVerbose) => Effect.gen(function*
 	const warningCount = diagnostics.filter((diagnostic) => diagnostic.severity === "warning").length;
 	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`));
+	if (!isVerbose && totalIssueCount > 0) {
+		const exampleDiagnostic = diagnostics.find((diagnostic) => diagnostic.severity === "error") ?? diagnostics[0];
+		yield* Console.log(highlighter.dim(`  Run ${highlighter.info("npx react-doctor@latest --verbose")} to list every issue with its fix-recipe URL`));
+		yield* Console.log(highlighter.dim(`  Each rule links a canonical fix recipe to fetch & follow before fixing, e.g. ${highlighter.info(buildRulePromptUrl(exampleDiagnostic.plugin, exampleDiagnostic.rule))}`));
+	}
 });
 const printSummary = (input) => Effect.gen(function* () {
 	if (input.scoreResult) yield* printScoreHeader(input.scoreResult, input.projectName);
@@ -6666,7 +6674,7 @@ 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.9";
+const VERSION = "0.2.11-dev.15e5fec";
 //#endregion
 //#region src/inspect.ts
 const silentConsole = makeNoopConsole();
@@ -6764,9 +6772,7 @@ const runInspectWithRuntime = async (directory, options, userConfig, hasConfigOv
 	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 && 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`)));
+	if (!options.scoreOnly && !lintBindingMissing && output.didLintFail && lintFailureReason !== null) if (output.lintFailureReasonKind === "native-binding-missing") 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 score = didLintFail ? null : output.score;
@@ -6854,10 +6860,6 @@ const finalizeAndRender = (input) => Effect.gen(function* () {
 	return buildResult();
 });
 //#endregion
-//#region src/cli/utils/constants.ts
-const STAGED_FILES_TEMP_DIR_PREFIX = "react-doctor-staged-";
-const INTERNAL_ERROR_JSON_FALLBACK = "{\"schemaVersion\":1,\"ok\":false,\"error\":{\"message\":\"Internal error\",\"name\":\"Error\",\"chain\":[]}}\n";
-//#endregion
 //#region src/cli/utils/get-staged-files.ts
 const stagedFilesLayer = StagedFiles.layerNode.pipe(Layer.provide(Git.layerNode));
 const getStagedSourceFiles = async (directory) => {
@@ -7072,15 +7074,16 @@ const buildIssuesSummary = (input) => {
 	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 sortedRules = [...groupBy([...input.diagnostics], (diagnostic) => `${diagnostic.plugin}/${diagnostic.rule}`).entries()].sort(([, diagnosticsA], [, diagnosticsB]) => diagnosticsB.length - diagnosticsA.length);
 	const visibleRules = sortedRules.slice(0, MAX_RULES_SHOWN);
-	for (const [rule, ruleDiagnostics] of visibleRules) {
+	for (const [ruleKey, 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(`${severity === "error" ? "ERROR" : "WARN"} ${ruleKey} (×${ruleDiagnostics.length})`);
 		lines.push(`  ${ruleDiagnostics[0].message}`);
+		lines.push(`  ${formatFixRecipeLine(ruleDiagnostics[0])}`);
 		for (const filePath of shownFiles) {
 			const firstSite = ruleDiagnostics.find((diagnostic) => diagnostic.filePath === filePath && diagnostic.line > 0);
 			lines.push(`  - ${filePath}${firstSite ? `:${firstSite.line}` : ""}`);
@@ -7100,11 +7103,12 @@ const buildIssuesSummary = (input) => {
 	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.");
+	lines.push("2. For each rule above, fetch & follow its canonical fix recipe URL before fixing.");
+	lines.push("3. Fix errors first, then warnings. Start with high-count rules.");
+	lines.push("4. Read the code before acting. Treat findings as hypotheses, not commands.");
+	lines.push("5. Fix root causes, not symptoms. Don't suppress rules without evidence.");
+	lines.push("6. Run `npx react-doctor@latest --verbose --diff` after changes to verify.");
+	lines.push("7. Split unrelated fixes into separate PRs.");
 	return lines.join("\n");
 };
 const copyToClipboard = (text) => {
@@ -7159,6 +7163,29 @@ const promptCopyIssues = async (input) => {
 	else cliLogger.log(issuesSummary);
 };
 //#endregion
+//#region src/cli/utils/path-format.ts
+const toForwardSlashes = (filePath) => filePath.replaceAll("\\", "/");
+//#endregion
+//#region src/cli/utils/read-changed-files-from.ts
+const isSafeRelativePath = (filePath) => {
+	if (filePath.length === 0) return false;
+	if (filePath.includes("\0")) return false;
+	if (path.isAbsolute(filePath)) return false;
+	const normalized = path.posix.normalize(filePath);
+	if (normalized === "." || normalized.startsWith("../") || normalized === "..") return false;
+	return normalized === filePath;
+};
+const readChangedFilesFrom = (filePath) => {
+	const raw = fs.readFileSync(filePath, "utf8");
+	const uniqueFiles = /* @__PURE__ */ new Set();
+	for (const line of raw.split(/\r?\n/)) {
+		const candidate = toForwardSlashes(line.trim());
+		if (!isSafeRelativePath(candidate)) continue;
+		uniqueFiles.add(candidate);
+	}
+	return [...uniqueFiles];
+};
+//#endregion
 //#region src/cli/utils/render-multi-project-summary.ts
 const SUMMARY_BAR_WIDTH_CHARS = 20;
 const buildMiniBar = (score) => {
@@ -7221,6 +7248,7 @@ const printMultiProjectSummary = (input) => Effect.gen(function* () {
 		};
 	});
 	const longestProjectNameLength = Math.max(...entries.map((entry) => entry.projectName.length));
+	yield* Console.log("");
 	for (const entry of entries) yield* Console.log(buildSummaryLine(entry, longestProjectNameLength));
 	yield* Console.log("");
 });
@@ -7416,7 +7444,7 @@ const disableSetupPrompt = (projectRoot, storeOptions = {}) => {
 	return true;
 };
 const shouldPromptInstallSetup = (options) => {
-	if (!options.hasScoredScan) return false;
+	if (!(options.hasCompletedScan ?? options.hasScoredScan ?? false)) return false;
 	if (options.isJsonMode) return false;
 	if (options.isScoreOnly) return false;
 	if (options.isStaged) return false;
@@ -7426,13 +7454,13 @@ const shouldPromptInstallSetup = (options) => {
 	return !hasDoctorScript(options.projectRoot);
 };
 const resolveInstallSetupProjectRoot = (options) => {
-	if (options.completedScanDirectories.length === 0) return findNearestPackageDirectory(options.scanRoot) ?? options.scanRoot;
+	if (options.scanDirectories.length === 0) return findNearestPackageDirectory(options.scanRoot) ?? options.scanRoot;
 	const packageDirectories = /* @__PURE__ */ new Set();
-	for (const scanDirectory of options.completedScanDirectories) {
+	for (const scanDirectory of options.scanDirectories) {
 		const packageDirectory = findNearestPackageDirectory(scanDirectory, options.scanRoot) ?? findNearestPackageDirectory(scanDirectory) ?? scanDirectory;
 		packageDirectories.add(packageDirectory);
 	}
-	if (packageDirectories.size !== 1) return null;
+	if (packageDirectories.size !== 1) return findNearestPackageDirectory(options.scanRoot, options.scanRoot);
 	return [...packageDirectories][0] ?? null;
 };
 const defaultWait = (milliseconds) => new Promise((resolve) => {
@@ -7467,7 +7495,7 @@ const warnSetupPromptFailure = async (options, error) => {
 		return;
 	}
 	try {
-		const { cliLogger } = await import("./cli-logger-BliQX9s8.js").then((n) => n.n);
+		const { cliLogger } = await import("./cli-logger-CSZagq1E.js").then((n) => n.n);
 		cliLogger.warn(message);
 	} catch {}
 };
@@ -7483,7 +7511,7 @@ const promptInstallSetup = async (options) => {
 			writeLine("You can always run `npx react-doctor@latest install` to set it up later.");
 			return;
 		}
-		const install = options.install ?? (await Promise.resolve().then(() => install_skill_exports)).runInstallSkill;
+		const install = options.install ?? (await Promise.resolve().then(() => install_react_doctor_exports)).runInstallReactDoctor;
 		const previousExitCode = process.exitCode;
 		let setupExitCode;
 		try {
@@ -7502,7 +7530,7 @@ const promptInstallSetup = async (options) => {
 	}
 };
 const shouldShowAgentInstallHint = (options) => {
-	if (!options.hasScoredScan) return false;
+	if (!(options.hasCompletedScan ?? options.hasScoredScan ?? false)) return false;
 	if (options.isJsonMode) return false;
 	if (options.isScoreOnly) return false;
 	if (options.isStaged) return false;
@@ -7567,15 +7595,17 @@ const resolveDiffMode = async (diffInfo, effectiveDiff, shouldSkipPrompts, isQui
 	const { scanScope } = await prompts({
 		type: "select",
 		name: "scanScope",
-		message: "Select",
+		message: "Choose what to scan",
 		choices: [{
 			title: "Full codebase",
+			description: "Scan every source file",
 			value: "full"
 		}, {
-			title: `Changed files (${changedSourceFiles.length})`,
+			title: diffInfo.isCurrentChanges ? `Uncommitted changes (${changedSourceFiles.length})` : `Changed files on ${diffInfo.currentBranch ?? "this branch"} (${changedSourceFiles.length})`,
+			description: diffInfo.isCurrentChanges ? "Compare working tree changes against HEAD" : `Compare against ${diffInfo.baseBranch} from the branch merge-base`,
 			value: "branch"
 		}],
-		initial: 0
+		initial: diffInfo.isCurrentChanges ? 0 : 1
 	});
 	return scanScope === "branch";
 };
@@ -7605,17 +7635,16 @@ const VALID_FAIL_ON_LEVELS = new Set([
 	"warning",
 	"none"
 ]);
-const DEFAULT_FAIL_ON_LEVEL = "error";
+const DEFAULT_FAIL_ON_LEVEL = "none";
 const isValidFailOnLevel = (level) => VALID_FAIL_ON_LEVELS.has(level);
 const resolveFailOnLevel = (flags, userConfig) => {
 	const sourceValue = flags.failOn ?? userConfig?.failOn ?? DEFAULT_FAIL_ON_LEVEL;
 	if (isValidFailOnLevel(sourceValue)) return sourceValue;
-	cliLogger.warn(`Invalid failOn level "${sourceValue}". Expected one of: error, warning, none. Falling back to "none".`);
-	return "none";
+	cliLogger.warn(`Invalid failOn level "${sourceValue}". Expected one of: error, warning, none. Falling back to "${DEFAULT_FAIL_ON_LEVEL}".`);
+	return DEFAULT_FAIL_ON_LEVEL;
 };
 //#endregion
 //#region src/cli/utils/resolve-project-diff-include-paths.ts
-const toForwardSlashes = (filePath) => filePath.replaceAll("\\", "/");
 const resolveProjectDiffIncludePaths = (rootDirectory, projectDirectory, diffInfo) => {
 	const changedSourceFiles = filterSourceFiles(diffInfo.changedFiles);
 	const relativeProjectDirectory = toForwardSlashes(path.relative(rootDirectory, projectDirectory));
@@ -7709,7 +7738,7 @@ const selectProjects = async (rootDirectory, projectFlag, skipPrompts) => {
 	}
 	if (packages.length === 0) return [rootDirectory];
 	if (packages.length === 1) {
-		cliLogger.log(`${highlighter.success("✔")} Select projects to scan ${highlighter.dim("›")} ${packages[0].name}`);
+		cliLogger.log(`${highlighter.success("✔")} Select projects ${highlighter.dim("›")} ${packages[0].name}`);
 		return [packages[0].directory];
 	}
 	if (projectFlag) return resolveProjectFlag(projectFlag, packages);
@@ -7733,13 +7762,13 @@ const resolveProjectFlag = (projectFlag, workspacePackages) => {
 	return resolvedDirectories;
 };
 const printDiscoveredProjects = (packages) => {
-	cliLogger.log(`${highlighter.success("✔")} Select projects to scan ${highlighter.dim("›")} ${packages.map((workspacePackage) => workspacePackage.name).join(", ")}`);
+	cliLogger.log(`${highlighter.success("✔")} Select projects ${highlighter.dim("›")} ${packages.map((workspacePackage) => workspacePackage.name).join(", ")}`);
 };
 const promptProjectSelection = async (workspacePackages, rootDirectory) => {
 	const { selectedDirectories } = await prompts({
 		type: "multiselect",
 		name: "selectedDirectories",
-		message: "Select projects to scan",
+		message: "Select projects",
 		choices: workspacePackages.map((workspacePackage) => ({
 			title: workspacePackage.name,
 			description: path.relative(rootDirectory, workspacePackage.directory),
@@ -7814,7 +7843,7 @@ const validateModeFlags = (flags) => {
 	if (flags.yes && flags.full) throw new Error("Cannot combine --yes and --full; pick one.");
 	if (flags.score && flags.json) throw new Error("Cannot combine --score and --json; pick one output mode.");
 	if (flags.prComment && (flags.json || flags.score)) throw new Error("--pr-comment cannot be combined with --json or --score.");
-	if (flags.annotations && (flags.json || flags.score)) throw new Error("--annotations cannot be combined with --json or --score.");
+	if (flags.annotations && flags.score) throw new Error("--annotations cannot be combined with --score.");
 	if (flags.explain !== void 0 && flags.why !== void 0) throw new Error("Use --explain or --why, not both — they're aliases of the same flag.");
 	if ((flags.explain ?? flags.why) !== void 0 && (flags.json || flags.score || flags.annotations || flags.staged)) throw new Error("--explain cannot be combined with --json, --score, --annotations, or --staged.");
 };
@@ -7840,6 +7869,12 @@ const finalizeScans = (input) => {
 	const ciFailureDiagnostics = filterDiagnosticsForSurface(input.diagnostics, "ciFailure", input.userConfig);
 	if (!input.isScoreOnly && shouldFailForDiagnostics(ciFailureDiagnostics, resolveFailOnLevel(input.flags, input.userConfig))) process.exitCode = 1;
 };
+const buildChangedFilesDiffInfo = (changedFiles) => ({
+	currentBranch: process.env.GITHUB_HEAD_REF?.trim() || null,
+	baseBranch: process.env.GITHUB_BASE_REF?.trim() || "pull request target",
+	changedFiles,
+	isCurrentChanges: false
+});
 const inspectAction = async (directory, flags) => {
 	const isScoreOnly = Boolean(flags.score);
 	const isJsonMode = Boolean(flags.json);
@@ -7896,7 +7931,14 @@ const inspectAction = async (directory, flags) => {
 				cliLogger.log(`Scanning ${highlighter.info(`${stagedFiles.length}`)} staged files...`);
 				cliLogger.break();
 			}
-			const snapshot = await materializeStagedFiles(resolvedDirectory, stagedFiles, mkdtempSync(path.join(tmpdir(), STAGED_FILES_TEMP_DIR_PREFIX)));
+			const tempDirectory = mkdtempSync(path.join(tmpdir(), STAGED_FILES_TEMP_DIR_PREFIX));
+			const snapshot = await materializeStagedFiles(resolvedDirectory, stagedFiles, tempDirectory).catch((error) => {
+				rmSync(tempDirectory, {
+					recursive: true,
+					force: true
+				});
+				throw error;
+			});
 			try {
 				const scanResult = await inspect(snapshot.tempDirectory, {
 					...scanOptions,
@@ -7905,7 +7947,7 @@ const inspectAction = async (directory, flags) => {
 				});
 				const remappedDiagnostics = scanResult.diagnostics.map((diagnostic) => ({
 					...diagnostic,
-					filePath: path.isAbsolute(diagnostic.filePath) ? diagnostic.filePath.replaceAll(snapshot.tempDirectory, resolvedDirectory) : diagnostic.filePath
+					filePath: path.isAbsolute(diagnostic.filePath) ? diagnostic.filePath.replaceAll(snapshot.tempDirectory, () => resolvedDirectory) : diagnostic.filePath
 				}));
 				finalizeScans({
 					diagnostics: remappedDiagnostics,
@@ -7935,9 +7977,10 @@ const inspectAction = async (directory, flags) => {
 			return;
 		}
 		const projectDirectories = await selectProjects(resolvedDirectory, flags.project, skipPrompts);
+		const changedFilesDiffInfo = flags.changedFilesFrom && !flags.full ? buildChangedFilesDiffInfo(readChangedFilesFrom(path.resolve(flags.changedFilesFrom))) : null;
 		const effectiveDiff = resolveEffectiveDiff(flags, userConfig);
-		const diffInfo = effectiveDiff !== void 0 && effectiveDiff !== false || !skipPrompts && !isQuiet ? await getDiffInfo(resolvedDirectory, typeof effectiveDiff === "string" ? effectiveDiff : void 0) : null;
-		const isDiffMode = await resolveDiffMode(diffInfo, effectiveDiff, skipPrompts, isQuiet);
+		const diffInfo = changedFilesDiffInfo ?? (changedFilesDiffInfo === null && (effectiveDiff !== void 0 && effectiveDiff !== false || !skipPrompts && !isQuiet) ? await getDiffInfo(resolvedDirectory, typeof effectiveDiff === "string" ? effectiveDiff : void 0) : null);
+		const isDiffMode = changedFilesDiffInfo !== null || await resolveDiffMode(diffInfo, effectiveDiff, skipPrompts, isQuiet);
 		setJsonReportMode(isDiffMode ? "diff" : "full");
 		if (isDiffMode && diffInfo && !isQuiet) {
 			if (diffInfo.isCurrentChanges) cliLogger.log("Scanning uncommitted changes");
@@ -7996,13 +8039,13 @@ const inspectAction = async (directory, flags) => {
 		});
 		const setupProjectRoot = resolveInstallSetupProjectRoot({
 			scanRoot: resolvedDirectory,
-			completedScanDirectories: completedScans.map((scan) => scan.directory)
+			scanDirectories: projectDirectories
 		});
 		if (setupProjectRoot !== null) {
-			const hasScoredScan = completedScans.some((scan) => scan.result.score !== null);
+			const hasCompletedScan = completedScans.length > 0;
 			await promptInstallSetup({
 				projectRoot: setupProjectRoot,
-				hasScoredScan,
+				hasCompletedScan,
 				issueCount: filterDiagnosticsForSurface(allDiagnostics, scanOptions.outputSurface ?? "cli", userConfig).length,
 				isJsonMode,
 				isScoreOnly,
@@ -8011,7 +8054,7 @@ const inspectAction = async (directory, flags) => {
 			});
 			if (shouldShowAgentInstallHint({
 				projectRoot: setupProjectRoot,
-				hasScoredScan,
+				hasCompletedScan,
 				isJsonMode,
 				isScoreOnly,
 				isStaged: Boolean(flags.staged)
@@ -8643,8 +8686,12 @@ const installReactDoctorGitHook = (options) => {
 	return installDirectGitHook(options);
 };
 //#endregion
-//#region src/cli/utils/install-skill.ts
-var install_skill_exports = /* @__PURE__ */ __exportAll({ runInstallSkill: () => runInstallSkill });
+//#region src/cli/utils/install-react-doctor.ts
+var install_react_doctor_exports = /* @__PURE__ */ __exportAll({ runInstallReactDoctor: () => runInstallReactDoctor });
+const SETUP_OPTION_GIT_HOOK = "git-hook";
+const SETUP_OPTION_AGENT_HOOKS = "agent-hooks";
+const SETUP_OPTION_WORKFLOW = "workflow";
+const SETUP_OPTION_SKIP = "skip";
 const CONFIG_ONLY_GIT_HOOK_KINDS = new Set([
 	"ghooks",
 	"git-hooks-js",
@@ -8825,7 +8872,32 @@ const getSkillSourceDirectory = () => {
 	const distDirectory = path.dirname(fileURLToPath(import.meta.url));
 	return path.join(distDirectory, "skills", SKILL_NAME);
 };
-const runInstallSkill = async (options = {}) => {
+const canInstallNativeAgentHooks = (agents) => agents.some((agent) => agent === "claude-code" || agent === "cursor");
+const buildWorkflowContent = () => [
+	"name: React Doctor",
+	"",
+	"on:",
+	"  pull_request:",
+	"    types: [opened, synchronize, reopened, ready_for_review]",
+	"",
+	"permissions:",
+	"  contents: read",
+	"  pull-requests: write",
+	"  issues: write",
+	"",
+	"concurrency:",
+	"  group: react-doctor-${{ github.event.pull_request.number || github.ref }}",
+	"  cancel-in-progress: true",
+	"",
+	"jobs:",
+	"  react-doctor:",
+	"    runs-on: ubuntu-latest",
+	"    steps:",
+	"      - uses: actions/checkout@v5",
+	"      - uses: millionco/react-doctor@main",
+	""
+].join("\n");
+const runInstallReactDoctor = async (options = {}) => {
 	const requestedProjectRoot = options.projectRoot ?? process.cwd();
 	const projectRoot = findNearestPackageDirectory(requestedProjectRoot) ?? requestedProjectRoot;
 	const sourceDir = options.sourceDir ?? getSkillSourceDirectory();
@@ -8846,7 +8918,8 @@ const runInstallSkill = async (options = {}) => {
 	const gitHookTarget = options.gitHookPath === void 0 ? detectGitHookTarget(projectRoot) : options.gitHookPath === null ? null : buildManualGitHookTarget(options.gitHookPath, projectRoot);
 	const gitHookPath = gitHookTarget?.hookPath;
 	const promptOptions = options.onPromptCancel === void 0 ? {} : { onCancel: options.onPromptCancel };
-	const selectedAgents = skipPrompts ? detectedAgents : (await prompts({
+	const prompt = options.prompt ?? prompts;
+	const selectedAgents = skipPrompts ? detectedAgents : (await prompt({
 		type: "multiselect",
 		name: "agents",
 		message: `Install the ${highlighter.info(`/react-doctor`)} skill for:`,
@@ -8859,13 +8932,48 @@ const runInstallSkill = async (options = {}) => {
 		min: 1
 	}, promptOptions)).agents ?? [];
 	if (selectedAgents.length === 0) return;
-	const shouldInstallGitHook = gitHookPath !== null && gitHookPath !== void 0 && (Boolean(options.yes) || !skipPrompts && Boolean((await prompts({
-		type: "confirm",
-		name: "installGitHook",
-		message: "Check for issues before each commit?",
-		initial: true
-	}, promptOptions)).installGitHook));
-	const shouldInstallAgentHooks = Boolean(options.agentHooks);
+	const workflowsDirectory = path.join(projectRoot, ".github", "workflows");
+	const workflowTargetPath = path.join(workflowsDirectory, "react-doctor.yml");
+	const hasExistingWorkflows = existsSync(workflowsDirectory);
+	const canInstallWorkflow = !existsSync(workflowTargetPath);
+	const setupActionChoices = [
+		...gitHookPath === null || gitHookPath === void 0 ? [] : [{
+			title: "Pre-commit hook",
+			description: "Check staged changes before each commit",
+			value: SETUP_OPTION_GIT_HOOK,
+			selected: true
+		}],
+		...canInstallNativeAgentHooks(selectedAgents) ? [{
+			title: "Agent hooks",
+			description: "Ask Claude Code or Cursor to scan after code edits",
+			value: SETUP_OPTION_AGENT_HOOKS,
+			selected: Boolean(options.agentHooks)
+		}] : [],
+		...canInstallWorkflow ? [{
+			title: "GitHub Actions workflow",
+			description: "Scan pull requests in CI",
+			value: SETUP_OPTION_WORKFLOW,
+			selected: hasExistingWorkflows
+		}] : []
+	];
+	const setupChoices = setupActionChoices.length === 0 ? [] : [{
+		title: "Skip optional setup",
+		description: "Install only the agent skill and package setup",
+		value: SETUP_OPTION_SKIP,
+		selected: false
+	}, ...setupActionChoices];
+	const selectedSetupOptions = skipPrompts || setupChoices.length === 0 ? [] : (await prompt({
+		type: "multiselect",
+		name: "setupOptions",
+		message: "Select additional React Doctor setup:",
+		choices: setupChoices,
+		instructions: false
+	}, promptOptions)).setupOptions ?? [];
+	const selectedSetupActions = selectedSetupOptions.filter((setupOption) => setupOption !== SETUP_OPTION_SKIP);
+	const didSkipOptionalSetup = selectedSetupActions.length === 0 && selectedSetupOptions.includes(SETUP_OPTION_SKIP);
+	const shouldInstallGitHook = gitHookPath !== null && gitHookPath !== void 0 && (Boolean(options.yes) || !didSkipOptionalSetup && selectedSetupActions.includes(SETUP_OPTION_GIT_HOOK));
+	const shouldInstallAgentHooks = Boolean(options.agentHooks) || !didSkipOptionalSetup && selectedSetupActions.includes(SETUP_OPTION_AGENT_HOOKS);
+	const shouldInstallWorkflow = !skipPrompts && !didSkipOptionalSetup && canInstallWorkflow && selectedSetupActions.includes(SETUP_OPTION_WORKFLOW);
 	if (options.dryRun) {
 		cliLogger.log(`Dry run — would install ${SKILL_NAME} skill for:`);
 		for (const agent of selectedAgents) cliLogger.dim(`  - ${getSkillAgentConfig(agent).displayName}`);
@@ -8874,6 +8982,7 @@ const runInstallSkill = async (options = {}) => {
 		cliLogger.dim("  Dev dependency: react-doctor");
 		if (shouldInstallGitHook) cliLogger.dim(`  Git hook: ${gitHookPath}`);
 		if (shouldInstallAgentHooks) cliLogger.dim("  Agent hooks: Claude Code / Cursor when selected");
+		if (shouldInstallWorkflow) cliLogger.dim(`  GitHub Actions workflow: ${path.relative(projectRoot, workflowTargetPath)}`);
 		return;
 	}
 	const installSpinner = spinner(`Installing ${SKILL_NAME} skill...`).start();
@@ -8921,47 +9030,15 @@ 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;
-			}
+	if (shouldInstallWorkflow) {
+		if (!hasExistingWorkflows) mkdirSync(workflowsDirectory, { recursive: true });
+		const workflowSpinner = spinner("Adding GitHub Actions workflow...").start();
+		try {
+			writeFileSync(workflowTargetPath, buildWorkflowContent());
+			workflowSpinner.succeed(`GitHub Actions workflow added at ${path.relative(projectRoot, workflowTargetPath)}.`);
+		} catch (error) {
+			workflowSpinner.fail("Failed to add GitHub Actions workflow.");
+			throw error;
 		}
 	}
 };
@@ -8971,7 +9048,7 @@ const installAction = async (options, command) => {
 	Effect.runSync(printBrandedHeader);
 	try {
 		const parentOptions = command?.parent?.opts?.();
-		await runInstallSkill({
+		await runInstallReactDoctor({
 			yes: options.yes ?? parentOptions?.yes,
 			dryRun: options.dryRun,
 			agentHooks: options.agentHooks,
@@ -9015,6 +9092,7 @@ const ROOT_FLAG_SPEC = {
 		"--yes"
 	]),
 	longOptionsWithRequiredValues: new Set([
+		"--changed-files-from",
 		"--explain",
 		"--fail-on",
 		"--project",
@@ -9108,10 +9186,16 @@ const stripUnknownCliFlags = (argv) => {
 	];
 };
 //#endregion
+//#region src/cli/utils/unref-stdin.ts
+const unrefStdin = () => {
+	process.stdin.unref?.();
+};
+//#endregion
 //#region src/cli/index.ts
 process.on("SIGINT", exitGracefully);
 process.on("SIGTERM", exitGracefully);
-const program = new Command().name("react-doctor").description("Diagnose React codebase health").version(VERSION, "-v, --version", "display the version number").argument("[directory]", "project directory to scan", ".").option("--lint", "enable linting").option("--no-lint", "skip linting").option("--dead-code", "enable dead-code analysis (default)").option("--no-dead-code", "skip dead-code analysis (unused files / exports / dependencies, circular imports)").option("--verbose", "show every rule and per-file details (default shows top 3 rules)").option("--score", "output only the score").option("--json", "output a single structured JSON report (suppresses other output)").option("--json-compact", "with --json, emit compact JSON (no indentation)").option("-y, --yes", "skip prompts, scan all workspace projects").option("--full", "force a full scan (overrides any `diff` value in config or `--diff`)").option("--project <name>", "select workspace project (comma-separated for multiple)").option("--diff [base]", "scan only files changed vs base branch (pass `false` to disable; overridden by --full)").option("--no-score", "skip the score API and the share URL").option("--staged", "scan only staged (git index) files for pre-commit hooks").option("--fail-on <level>", "exit with error code on diagnostics: error, warning, none (default: error)").option("--annotations", "output diagnostics as GitHub Actions annotations").option("--pr-comment", "tune CLI output for sticky PR comments (drops weak-signal rule families like `design` from the printed list and the fail-on gate; configure via config.surfaces)").option("--explain <file:line>", "diagnose why a rule fired or why a suppression didn't apply at a specific location").option("--why <file:line>", "alias for --explain").option("--respect-inline-disables", "respect inline `// eslint-disable*` / `// oxlint-disable*` comments (default)").option("--no-respect-inline-disables", "audit mode: neutralize inline lint suppressions before scanning").addHelpText("after", `
+unrefStdin();
+const program = new Command().name("react-doctor").description("Diagnose React codebase health").version(VERSION, "-v, --version", "display the version number").argument("[directory]", "project directory to scan", ".").option("--lint", "enable linting").option("--no-lint", "skip linting").option("--dead-code", "enable dead-code analysis (default)").option("--no-dead-code", "skip dead-code analysis (unused files / exports / dependencies, circular imports)").option("--verbose", "show every rule and per-file details (default shows top 3 rules)").option("--score", "output only the score").option("--json", "output a single structured JSON report (suppresses other output)").option("--json-compact", "with --json, emit compact JSON (no indentation)").option("-y, --yes", "skip prompts, scan all workspace projects").option("--full", "force a full scan (overrides any `diff` value in config or `--diff`)").option("--project <name>", "select workspace project (comma-separated for multiple)").option("--diff [base]", "scan only files changed vs base branch (pass `false` to disable; overridden by --full)").option("--changed-files-from <file>", "internal: scan source files listed in a newline-delimited changed-files file").option("--no-score", "skip the score API and the share URL").option("--staged", "scan only staged (git index) files for pre-commit hooks").option("--fail-on <level>", "exit with error code on diagnostics: error, warning, none (default: none)").option("--annotations", "output diagnostics as GitHub Actions annotations").option("--pr-comment", "tune CLI output for sticky PR comments (drops weak-signal rule families like `design` from the printed list and the fail-on gate; configure via config.surfaces)").option("--explain <file:line>", "diagnose why a rule fired or why a suppression didn't apply at a specific location").option("--why <file:line>", "alias for --explain").option("--respect-inline-disables", "respect inline `// eslint-disable*` / `// oxlint-disable*` comments (default)").option("--no-respect-inline-disables", "audit mode: neutralize inline lint suppressions before scanning").addHelpText("after", `
 ${highlighter.dim("Configuration:")}
   Place a ${highlighter.info("react-doctor.config.json")} (or ${highlighter.info("\"reactDoctor\"")} key in your package.json) in the project root.
   CLI flags always override config values. See the README for the full schema.