react-doctor 0.2.11 → 0.2.12-dev.269ca17

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-pbFEieEc.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) {
@@ -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.11";
+const VERSION = "0.2.12-dev.269ca17";
 //#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;
@@ -7068,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}` : ""}`);
@@ -7096,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) => {
@@ -7155,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) => {
@@ -7217,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("");
 });
@@ -7463,7 +7495,7 @@ const warnSetupPromptFailure = async (options, error) => {
 		return;
 	}
 	try {
-		const { cliLogger } = await import("./cli-logger-pbFEieEc.js").then((n) => n.n);
+		const { cliLogger } = await import("./cli-logger-CSZagq1E.js").then((n) => n.n);
 		cliLogger.warn(message);
 	} catch {}
 };
@@ -7566,12 +7598,14 @@ const resolveDiffMode = async (diffInfo, effectiveDiff, shouldSkipPrompts, isQui
 		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";
 };
@@ -7601,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));
@@ -7810,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.");
 };
@@ -7836,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);
@@ -7892,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,
@@ -7901,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,
@@ -7931,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");
@@ -8831,21 +8878,23 @@ const buildWorkflowContent = () => [
 	"",
 	"on:",
 	"  pull_request:",
-	"    branches: [main]",
+	"    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@v4",
+	"      - uses: actions/checkout@v5",
 	"      - uses: millionco/react-doctor@main",
-	"        with:",
-	"          github-token: ${{ secrets.GITHUB_TOKEN }}",
-	"          diff: main",
 	""
 ].join("\n");
 const runInstallReactDoctor = async (options = {}) => {
@@ -9043,6 +9092,7 @@ const ROOT_FLAG_SPEC = {
 		"--yes"
 	]),
 	longOptionsWithRequiredValues: new Set([
+		"--changed-files-from",
 		"--explain",
 		"--fail-on",
 		"--project",
@@ -9136,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.

package/dist/index.d.ts

@@ -305,20 +305,25 @@ interface ProjectInfo {
   reactVersion: string | null;
   reactMajorVersion: number | null;
   tailwindVersion: string | null;
+  zodVersion: string | null;
+  /** Parsed major from `zodVersion`, or `null` when absent/unparseable. Mirrors `reactMajorVersion`. */
+  zodMajorVersion: number | null;
   framework: Framework;
   hasTypeScript: boolean;
   hasReactCompiler: boolean;
   hasTanStackQuery: boolean;
   /**
-   * `true` when `preact` is declared anywhere in the project's
-   * dependency manifest. Drives the `preact` capability in
-   * `buildCapabilities`, which gates every `preact-*` rule. Modeled
-   * on `hasTanStackQuery` rather than the `framework` field because
-   * the dominant Preact setup today is Preact-on-Vite — those
-   * projects classify as `framework: "vite"` for build-tool reasons
-   * but still need Preact-specific rules to fire.
+   * The declared `preact` version spec, or `null` when Preact isn't a
+   * dependency. Parallels `reactVersion` so a React-compatible runtime is
+   * modeled the same way React is. Drives the `preact` capability in
+   * `buildCapabilities` (which gates every `preact-*` rule) — keyed off
+   * this rather than `framework` because the dominant Preact setup
+   * (Preact-on-Vite) classifies as `framework: "vite"` but still needs
+   * Preact rules to fire.
    */
-  hasPreact: boolean;
+  preactVersion: string | null;
+  /** Parsed major from `preactVersion`, or `null` when absent/unparseable. Mirrors `reactMajorVersion`. */
+  preactMajorVersion: number | null;
   /**
    * `true` when the project (or any of its workspace packages) declares
    * React Native or Expo as a dependency. Enables the `react-native`