react-doctor 0.2.11-dev.402c7ea → 0.2.11-dev.b2934f9

package/README.md

@@ -43,6 +43,32 @@ Works with Claude Code, Cursor, Codex, OpenCode, and many more.
 
 Add the reusable GitHub Action from Marketplace to scan every pull request, show inline annotations, and leave findings where reviewers already look.
 
+```yaml
+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@v1
+```
+
+React Doctor scans the files changed in the pull request, emits inline annotations, blocks on error-level findings, and updates one sticky PR comment with the score and issue summary. The built-in GitHub token is used automatically; no secret or PAT is required. On forked PRs where GitHub withholds write permissions, the scan and annotations still run, but the sticky comment may be skipped.
+
 [Add GitHub Action →](https://github.com/marketplace/actions/react-doctor)
 
 ## Contributing

package/dist/{cli-logger-Df45H6Lw.js → cli-logger-CSZagq1E.js}

@@ -2281,15 +2281,91 @@ const detectFramework = (dependencies) => {
 	if (dependencies.preact && !dependencies.react) return "preact";
 	return "unknown";
 };
-const UPPER_BOUND_COMPARATOR = /<\s*=?\s*\d+(?:\.\d+){0,2}(?:-[^\s,|]+)?/g;
-const HAS_UPPER_BOUND_COMPARATOR = /<\s*=?\s*\d+(?:\.\d+){0,2}(?:-[^\s,|]+)?/;
-const OR_SEPARATOR = /\s*\|\|\s*/;
 const UNRESOLVABLE_PROTOCOL_VERSION = /^(?:file|git|github|https?|link|patch|portal|workspace|npm):/i;
 const DIST_TAG_VERSION = /^[a-z][a-z0-9._-]*$/i;
 const WILDCARD_VERSION = /^[*xX](?:\.[*xX])*$/;
-const NON_LOWER_BOUND_COMPARATOR = /(?:^|[\s,|])(?:>(?!=)|!={0,2})\s*\d/;
-const LOWER_BOUND_MAJOR = /(?:^|[\s,|])(?:>=\s*|[~^=v]\s*)?(\d+)(?=$|[\s,|.*xX-])/g;
 const NPM_ALIAS_VERSION = /^npm:(?:@[^/]+\/[^@]+|[^@]+)@(.+)$/i;
+const isDigit = (value) => value !== void 0 && value >= "0" && value <= "9";
+const isWhitespace = (value) => value === " " || value === "	" || value === "\n" || value === "\r" || value === "\f" || value === "\v";
+const isSeparator = (value) => isWhitespace(value) || value === "," || value === "|";
+const skipWhitespace = (value, start) => {
+	let index = start;
+	while (isWhitespace(value[index])) index += 1;
+	return index;
+};
+const skipSeparators = (value, start) => {
+	let index = start;
+	while (isSeparator(value[index])) index += 1;
+	return index;
+};
+const readDigits = (value, start) => {
+	let index = start;
+	while (isDigit(value[index])) index += 1;
+	return index;
+};
+const getUpperBoundComparatorEnd = (version, start) => {
+	if (version[start] !== "<") return null;
+	let index = skipWhitespace(version, start + 1);
+	if (version[index] === "=") index = skipWhitespace(version, index + 1);
+	const majorStart = index;
+	index = readDigits(version, index);
+	if (index === majorStart) return null;
+	for (let segments = 0; segments < 2 && version[index] === "."; segments += 1) {
+		const segmentStart = index + 1;
+		const segmentEnd = readDigits(version, segmentStart);
+		if (segmentEnd === segmentStart) break;
+		index = segmentEnd;
+	}
+	if (version[index] === "-") {
+		index += 1;
+		while (index < version.length && !isSeparator(version[index])) index += 1;
+	}
+	return index;
+};
+const stripUpperBoundComparators = (version) => {
+	let stripped = "";
+	let index = 0;
+	while (index < version.length) {
+		const comparatorEnd = getUpperBoundComparatorEnd(version, index);
+		if (comparatorEnd === null) {
+			stripped += version[index];
+			index += 1;
+			continue;
+		}
+		stripped += " ";
+		index = comparatorEnd;
+	}
+	return stripped;
+};
+const hasNonLowerBoundComparator = (branch) => {
+	for (let index = 0; index < branch.length; index += 1) {
+		if (index > 0 && !isSeparator(branch[index - 1])) continue;
+		if (branch[index] === ">" && branch[index + 1] !== "=") {
+			if (isDigit(branch[skipWhitespace(branch, index + 1)])) return true;
+			continue;
+		}
+		if (branch[index] !== "!") continue;
+		let valueIndex = index + 1;
+		if (branch[valueIndex] === "=") valueIndex += 1;
+		if (branch[valueIndex] === "=") valueIndex += 1;
+		valueIndex = skipWhitespace(branch, valueIndex);
+		if (isDigit(branch[valueIndex])) return true;
+	}
+	return false;
+};
+const isMajorTerminator = (value) => value === void 0 || isSeparator(value) || value === "." || value === "*" || value === "x" || value === "X" || value === "-";
+const getLowerBoundMajorAt = (branch, start) => {
+	let index = start;
+	if (branch[index] === ">" && branch[index + 1] === "=") index = skipWhitespace(branch, index + 2);
+	else if (branch[index] === "~" || branch[index] === "^" || branch[index] === "=" || branch[index] === "v") index = skipWhitespace(branch, index + 1);
+	const majorStart = index;
+	const majorEnd = readDigits(branch, majorStart);
+	if (majorEnd === majorStart || !isMajorTerminator(branch[majorEnd])) return null;
+	return {
+		end: majorEnd,
+		major: Number.parseInt(branch.slice(majorStart, majorEnd), 10)
+	};
+};
 const normalizeDependencyVersion = (version) => {
 	const trimmed = version.trim();
 	if (trimmed.length === 0) return null;
@@ -2299,17 +2375,29 @@ const normalizeDependencyVersion = (version) => {
 	if (WILDCARD_VERSION.test(normalizedVersion)) return null;
 	return normalizedVersion;
 };
-const splitDependencyVersionBranches = (version) => version.split(OR_SEPARATOR).filter(Boolean);
-const hasUpperBoundComparator = (version) => HAS_UPPER_BOUND_COMPARATOR.test(version);
+const splitDependencyVersionBranches = (version) => version.split("||").map((branch) => branch.trim()).filter(Boolean);
+const hasUpperBoundComparator = (version) => {
+	for (let index = 0; index < version.length; index += 1) if (getUpperBoundComparatorEnd(version, index) !== null) return true;
+	return false;
+};
 const getBranchLowestMajor = (branch) => {
-	if (NON_LOWER_BOUND_COMPARATOR.test(branch)) return null;
-	const lowerBoundComparators = branch.replace(UPPER_BOUND_COMPARATOR, " ").trim();
+	if (hasNonLowerBoundComparator(branch)) return null;
+	const lowerBoundComparators = stripUpperBoundComparators(branch).trim();
 	if (lowerBoundComparators.length === 0) return null;
 	let branchLowestMajor = null;
-	for (const match of lowerBoundComparators.matchAll(LOWER_BOUND_MAJOR)) {
-		const major = Number.parseInt(match[1], 10);
-		if (!Number.isFinite(major) || major <= 0) continue;
-		if (branchLowestMajor === null || major < branchLowestMajor) branchLowestMajor = major;
+	let index = 0;
+	while (index < lowerBoundComparators.length) {
+		const lowerBoundStart = skipSeparators(lowerBoundComparators, index);
+		if (lowerBoundStart > 0 && !isSeparator(lowerBoundComparators[lowerBoundStart - 1])) {
+			index = lowerBoundStart + 1;
+			continue;
+		}
+		const lowerBoundMajor = getLowerBoundMajorAt(lowerBoundComparators, lowerBoundStart);
+		if (lowerBoundMajor !== null && Number.isFinite(lowerBoundMajor.major) && lowerBoundMajor.major > 0) {
+			const major = lowerBoundMajor.major;
+			if (branchLowestMajor === null || major < branchLowestMajor) branchLowestMajor = major;
+		}
+		index = lowerBoundMajor?.end ?? lowerBoundStart + 1;
 	}
 	return branchLowestMajor;
 };
@@ -2478,6 +2566,7 @@ const resolveCatalogVersion = (packageJson, packageName, rootDirectory, explicit
 const EMPTY_DEPENDENCY_INFO = {
 	reactVersion: null,
 	tailwindVersion: null,
+	zodVersion: null,
 	framework: "unknown"
 };
 const pickConcreteVersion = (packageJson, packageName, sections) => {
@@ -2506,6 +2595,11 @@ const extractDependencyInfo = (packageJson) => {
 			"devDependencies",
 			"peerDependencies"
 		]),
+		zodVersion: pickConcreteVersion(packageJson, "zod", [
+			"dependencies",
+			"devDependencies",
+			"peerDependencies"
+		]),
 		framework: detectFramework(allDependencies)
 	};
 };
@@ -2650,8 +2744,22 @@ const findReactInWorkspaces = (rootDirectory, packageJson) => {
 				workspaceDirectory,
 				workspacePackageJson
 			});
+			const zodVersion = resolveWorkspaceDependencyVersion({
+				concreteVersion: info.zodVersion,
+				packageName: "zod",
+				rootDirectory,
+				rootPackageJson: packageJson,
+				sections: [
+					"dependencies",
+					"devDependencies",
+					"peerDependencies"
+				],
+				workspaceDirectory,
+				workspacePackageJson
+			});
 			if (reactVersion && shouldReplaceReactVersion(result.reactVersion, reactVersion)) result.reactVersion = reactVersion;
 			if (tailwindVersion && !result.tailwindVersion) result.tailwindVersion = tailwindVersion;
+			if (zodVersion && !result.zodVersion) result.zodVersion = zodVersion;
 			if (info.framework !== "unknown" && result.framework === "unknown") result.framework = info.framework;
 			const resultReactMajor = parseReactMajor(result.reactVersion);
 			if (result.reactVersion && result.tailwindVersion && result.framework !== "unknown" && resultReactMajor !== null && resultReactMajor <= 17) return result;
@@ -2686,14 +2794,26 @@ const findDependencyInfoFromMonorepoRoot = (directory) => {
 			"peerDependencies"
 		]
 	}) : null;
+	const leafZodDeclaration = leafPackageJson ? getDependencyDeclaration({
+		packageJson: leafPackageJson,
+		packageName: "zod",
+		sections: [
+			"dependencies",
+			"devDependencies",
+			"peerDependencies"
+		]
+	}) : null;
 	const shouldUseReactFallback = !leafReactDeclaration?.hasDeclaration;
 	const shouldUseTailwindFallback = leafTailwindDeclaration?.hasDeclaration ?? true;
+	const shouldUseZodFallback = leafZodDeclaration?.hasDeclaration ?? true;
 	const reactCatalogVersion = shouldUseReactFallback ? resolveCatalogVersion(rootPackageJson, "react", monorepoRoot, leafReactDeclaration?.catalogReference) : null;
 	const tailwindCatalogVersion = shouldUseTailwindFallback ? resolveCatalogVersion(rootPackageJson, "tailwindcss", monorepoRoot, leafTailwindDeclaration?.catalogReference) : null;
+	const zodCatalogVersion = shouldUseZodFallback ? resolveCatalogVersion(rootPackageJson, "zod", monorepoRoot, leafZodDeclaration?.catalogReference) : null;
 	const workspaceInfo = findReactInWorkspaces(monorepoRoot, rootPackageJson);
 	return {
 		reactVersion: shouldUseReactFallback ? reactCatalogVersion ?? rootInfo.reactVersion ?? workspaceInfo.reactVersion : rootInfo.reactVersion ?? workspaceInfo.reactVersion,
 		tailwindVersion: shouldUseTailwindFallback ? tailwindCatalogVersion ?? rootInfo.tailwindVersion ?? workspaceInfo.tailwindVersion : null,
+		zodVersion: shouldUseZodFallback ? zodCatalogVersion ?? rootInfo.zodVersion ?? workspaceInfo.zodVersion : null,
 		framework: rootInfo.framework !== "unknown" ? rootInfo.framework : workspaceInfo.framework
 	};
 };
@@ -2773,6 +2893,10 @@ const isPackageJsonReanimatedAware = (packageJson) => {
 	};
 	return Object.hasOwn(allDependencies, REANIMATED_DEPENDENCY_NAME);
 };
+const parseZodMajor = (zodVersion) => {
+	if (typeof zodVersion !== "string") return null;
+	return getLowestDependencyMajor(zodVersion);
+};
 const hasUpperBoundOnlyPeerRange = (range) => {
 	if (typeof range !== "string") return false;
 	const normalizedRange = normalizeDependencyVersion(range);
@@ -2911,7 +3035,7 @@ const discoverProject = (directory) => {
 	const packageJsonPath = path.join(directory, "package.json");
 	if (!isFile(packageJsonPath)) throw new PackageJsonNotFoundError(directory);
 	const packageJson = readPackageJson(packageJsonPath);
-	let { reactVersion, tailwindVersion, framework } = extractDependencyInfo(packageJson);
+	let { reactVersion, tailwindVersion, zodVersion, framework } = extractDependencyInfo(packageJson);
 	const reactDeclaration = getDependencyDeclaration({
 		packageJson,
 		packageName: "react",
@@ -2930,9 +3054,19 @@ const discoverProject = (directory) => {
 			"peerDependencies"
 		]
 	});
+	const zodDeclaration = getDependencyDeclaration({
+		packageJson,
+		packageName: "zod",
+		sections: [
+			"dependencies",
+			"devDependencies",
+			"peerDependencies"
+		]
+	});
 	if (!reactVersion && reactDeclaration.hasDeclaration) reactVersion = resolveCatalogVersion(packageJson, "react", directory, reactDeclaration.catalogReference);
 	if (!tailwindVersion && tailwindDeclaration.hasDeclaration) tailwindVersion = resolveCatalogVersion(packageJson, "tailwindcss", directory, tailwindDeclaration.catalogReference);
-	if (!reactVersion || !tailwindVersion) {
+	if (!zodVersion && zodDeclaration.hasDeclaration) zodVersion = resolveCatalogVersion(packageJson, "zod", directory, zodDeclaration.catalogReference);
+	if (!reactVersion || !tailwindVersion || !zodVersion) {
 		const monorepoRoot = findMonorepoRoot(directory);
 		if (monorepoRoot) {
 			const monorepoPackageJsonPath = path.join(monorepoRoot, "package.json");
@@ -2940,6 +3074,7 @@ const discoverProject = (directory) => {
 				const rootPackageJson = readPackageJson(monorepoPackageJsonPath);
 				if (!reactVersion && reactDeclaration.hasDeclaration) reactVersion = resolveCatalogVersion(rootPackageJson, "react", monorepoRoot, reactDeclaration.catalogReference);
 				if (!tailwindVersion && tailwindDeclaration.hasDeclaration) tailwindVersion = resolveCatalogVersion(rootPackageJson, "tailwindcss", monorepoRoot, tailwindDeclaration.catalogReference);
+				if (!zodVersion && zodDeclaration.hasDeclaration) zodVersion = resolveCatalogVersion(rootPackageJson, "zod", monorepoRoot, zodDeclaration.catalogReference);
 			}
 		}
 	}
@@ -2947,16 +3082,19 @@ const discoverProject = (directory) => {
 		const workspaceInfo = findReactInWorkspaces(directory, packageJson);
 		if (!reactVersion && workspaceInfo.reactVersion) reactVersion = workspaceInfo.reactVersion;
 		if (!tailwindVersion && workspaceInfo.tailwindVersion) tailwindVersion = workspaceInfo.tailwindVersion;
+		if (!zodVersion && workspaceInfo.zodVersion) zodVersion = workspaceInfo.zodVersion;
 		if (framework === "unknown" && workspaceInfo.framework !== "unknown") framework = workspaceInfo.framework;
 	}
 	if ((!reactVersion || framework === "unknown") && !isMonorepoRoot(directory)) {
 		const monorepoInfo = findDependencyInfoFromMonorepoRoot(directory);
 		if (!reactVersion) reactVersion = monorepoInfo.reactVersion;
 		if (!tailwindVersion) tailwindVersion = monorepoInfo.tailwindVersion;
+		if (!zodVersion) zodVersion = monorepoInfo.zodVersion;
 		if (framework === "unknown") framework = monorepoInfo.framework;
 	}
 	if (!reactVersion && reactDeclaration.version && !isCatalogReference(reactDeclaration.version)) reactVersion = reactDeclaration.version;
 	if (!tailwindVersion && tailwindDeclaration.version && !isCatalogReference(tailwindDeclaration.version)) tailwindVersion = tailwindDeclaration.version;
+	if (!zodVersion && zodDeclaration.version && !isCatalogReference(zodDeclaration.version)) zodVersion = zodDeclaration.version;
 	const projectName = packageJson.name ?? path.basename(directory);
 	const hasTypeScript = fs.existsSync(path.join(directory, "tsconfig.json"));
 	const sourceFileCount = countSourceFiles(directory);
@@ -2969,6 +3107,8 @@ const discoverProject = (directory) => {
 		reactVersion,
 		reactMajorVersion: resolveEffectiveReactMajor(reactVersion, packageJson),
 		tailwindVersion,
+		zodVersion,
+		zodMajorVersion: parseZodMajor(zodVersion),
 		framework,
 		hasTypeScript,
 		hasReactCompiler: detectReactCompiler(directory, packageJson),
@@ -3050,6 +3190,7 @@ const JSX_FILE_PATTERN = /\.(tsx|jsx)$/;
 const MILLISECONDS_PER_SECOND = 1e3;
 const SCORE_API_URL = "https://www.react.doctor/api/score";
 const SHARE_BASE_URL = "https://www.react.doctor/share";
+const PROMPTS_RULES_BASE_URL = "https://www.react.doctor/prompts/rules";
 const FETCH_TIMEOUT_MS = 1e4;
 const GITHUB_VIEWER_PERMISSION_TIMEOUT_MS = 2e3;
 const DEFAULT_BRANCH_CANDIDATES = ["main", "master"];
@@ -5491,6 +5632,10 @@ const buildCapabilities = (project) => {
 			minor: 4
 		})) capabilities.add("tailwind:3.4");
 	}
+	if (project.zodVersion !== null) {
+		capabilities.add("zod");
+		if (project.zodMajorVersion !== null && project.zodMajorVersion >= 4) capabilities.add("zod:4");
+	}
 	if (project.hasReactCompiler) capabilities.add("react-compiler");
 	if (project.hasTanStackQuery) capabilities.add("tanstack-query");
 	if (project.hasTypeScript) capabilities.add("typescript");
@@ -7360,6 +7505,13 @@ const highlighter = {
 	gray: import_picocolors.default.gray,
 	bold: import_picocolors.default.bold
 };
+/**
+* Canonical URL for a rule's reviewer-tested fix recipe, served at
+* `https://www.react.doctor/prompts/rules/<plugin>/<rule>.md`. The
+* `/doctor` playbook fetches it on demand so each fix follows the
+* canonical recipe instead of being improvised per diagnostic.
+*/
+const buildRulePromptUrl = (plugin, rule) => `${PROMPTS_RULES_BASE_URL}/${plugin}/${rule}.md`;
 const groupBy = (items, keyFn) => {
 	const groups = /* @__PURE__ */ new Map();
 	for (const item of items) {
@@ -7407,6 +7559,6 @@ const cliLogger = {
 	}
 };
 //#endregion
-export { isReactDoctorError as A, filterSourceFiles as C, groupBy as D, getDiffInfo as E, runInspect as F, toRelativePath as I, listWorkspacePackages as M, resolveScanTarget as N, highlighter as O, restoreLegacyThrow as P, filterDiagnosticsForSurface as S, formatReactDoctorError as T, Score as _, DeadCode as a, buildJsonReportError as b, LintPartialFailures as c, OXLINT_NODE_REQUIREMENT as d, Progress as f, SKILL_NAME as g, SHARE_BASE_URL as h, Config as i, layerOtlp as j, isMonorepoRoot as k, Linter as l, Reporter as m, cli_logger_exports as n, Files as o, Project as p, CANONICAL_GITHUB_URL as r, Git as s, cliLogger as t, NodeResolver as u, StagedFiles as v, formatErrorChain as w, discoverReactSubprojects as x, buildJsonReport as y };
+export { isMonorepoRoot as A, filterDiagnosticsForSurface as C, getDiffInfo as D, formatReactDoctorError as E, restoreLegacyThrow as F, runInspect as I, toRelativePath as L, layerOtlp as M, listWorkspacePackages as N, groupBy as O, resolveScanTarget as P, discoverReactSubprojects as S, formatErrorChain as T, Score as _, DeadCode as a, buildJsonReportError as b, LintPartialFailures as c, OXLINT_NODE_REQUIREMENT as d, Progress as f, SKILL_NAME as g, SHARE_BASE_URL as h, Config as i, isReactDoctorError as j, highlighter as k, Linter as l, Reporter as m, cli_logger_exports as n, Files as o, Project as p, CANONICAL_GITHUB_URL as r, Git as s, cliLogger as t, NodeResolver as u, StagedFiles as v, filterSourceFiles as w, buildRulePromptUrl as x, buildJsonReport as y };
 
-//# sourceMappingURL=cli-logger-Df45H6Lw.js.map
+//# sourceMappingURL=cli-logger-CSZagq1E.js.map

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-Df45H6Lw.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-dev.402c7ea";
+const VERSION = "0.2.11-dev.b2934f9";
 //#endregion
 //#region src/inspect.ts
 const silentConsole = makeNoopConsole();
@@ -7066,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}` : ""}`);
@@ -7094,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) => {
@@ -7153,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) => {
@@ -7215,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("");
 });
@@ -7461,7 +7495,7 @@ const warnSetupPromptFailure = async (options, error) => {
 		return;
 	}
 	try {
-		const { cliLogger } = await import("./cli-logger-Df45H6Lw.js").then((n) => n.n);
+		const { cliLogger } = await import("./cli-logger-CSZagq1E.js").then((n) => n.n);
 		cliLogger.warn(message);
 	} catch {}
 };
@@ -7611,7 +7645,6 @@ const resolveFailOnLevel = (flags, userConfig) => {
 };
 //#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);
@@ -7938,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");
@@ -8838,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: millionco/react-doctor@main",
-	"        with:",
-	"          github-token: ${{ secrets.GITHUB_TOKEN }}",
-	"          diff: main",
+	"      - uses: actions/checkout@v5",
+	"      - uses: millionco/react-doctor@v1",
 	""
 ].join("\n");
 const runInstallReactDoctor = async (options = {}) => {
@@ -9050,6 +9092,7 @@ const ROOT_FLAG_SPEC = {
 		"--yes"
 	]),
 	longOptionsWithRequiredValues: new Set([
+		"--changed-files-from",
 		"--explain",
 		"--fail-on",
 		"--project",
@@ -9143,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: 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", `
+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,6 +305,9 @@ 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;

package/dist/index.js

@@ -2307,15 +2307,91 @@ const detectFramework = (dependencies) => {
 	if (dependencies.preact && !dependencies.react) return "preact";
 	return "unknown";
 };
-const UPPER_BOUND_COMPARATOR = /<\s*=?\s*\d+(?:\.\d+){0,2}(?:-[^\s,|]+)?/g;
-const HAS_UPPER_BOUND_COMPARATOR = /<\s*=?\s*\d+(?:\.\d+){0,2}(?:-[^\s,|]+)?/;
-const OR_SEPARATOR = /\s*\|\|\s*/;
 const UNRESOLVABLE_PROTOCOL_VERSION = /^(?:file|git|github|https?|link|patch|portal|workspace|npm):/i;
 const DIST_TAG_VERSION = /^[a-z][a-z0-9._-]*$/i;
 const WILDCARD_VERSION = /^[*xX](?:\.[*xX])*$/;
-const NON_LOWER_BOUND_COMPARATOR = /(?:^|[\s,|])(?:>(?!=)|!={0,2})\s*\d/;
-const LOWER_BOUND_MAJOR = /(?:^|[\s,|])(?:>=\s*|[~^=v]\s*)?(\d+)(?=$|[\s,|.*xX-])/g;
 const NPM_ALIAS_VERSION = /^npm:(?:@[^/]+\/[^@]+|[^@]+)@(.+)$/i;
+const isDigit = (value) => value !== void 0 && value >= "0" && value <= "9";
+const isWhitespace = (value) => value === " " || value === "	" || value === "\n" || value === "\r" || value === "\f" || value === "\v";
+const isSeparator = (value) => isWhitespace(value) || value === "," || value === "|";
+const skipWhitespace = (value, start) => {
+	let index = start;
+	while (isWhitespace(value[index])) index += 1;
+	return index;
+};
+const skipSeparators = (value, start) => {
+	let index = start;
+	while (isSeparator(value[index])) index += 1;
+	return index;
+};
+const readDigits = (value, start) => {
+	let index = start;
+	while (isDigit(value[index])) index += 1;
+	return index;
+};
+const getUpperBoundComparatorEnd = (version, start) => {
+	if (version[start] !== "<") return null;
+	let index = skipWhitespace(version, start + 1);
+	if (version[index] === "=") index = skipWhitespace(version, index + 1);
+	const majorStart = index;
+	index = readDigits(version, index);
+	if (index === majorStart) return null;
+	for (let segments = 0; segments < 2 && version[index] === "."; segments += 1) {
+		const segmentStart = index + 1;
+		const segmentEnd = readDigits(version, segmentStart);
+		if (segmentEnd === segmentStart) break;
+		index = segmentEnd;
+	}
+	if (version[index] === "-") {
+		index += 1;
+		while (index < version.length && !isSeparator(version[index])) index += 1;
+	}
+	return index;
+};
+const stripUpperBoundComparators = (version) => {
+	let stripped = "";
+	let index = 0;
+	while (index < version.length) {
+		const comparatorEnd = getUpperBoundComparatorEnd(version, index);
+		if (comparatorEnd === null) {
+			stripped += version[index];
+			index += 1;
+			continue;
+		}
+		stripped += " ";
+		index = comparatorEnd;
+	}
+	return stripped;
+};
+const hasNonLowerBoundComparator = (branch) => {
+	for (let index = 0; index < branch.length; index += 1) {
+		if (index > 0 && !isSeparator(branch[index - 1])) continue;
+		if (branch[index] === ">" && branch[index + 1] !== "=") {
+			if (isDigit(branch[skipWhitespace(branch, index + 1)])) return true;
+			continue;
+		}
+		if (branch[index] !== "!") continue;
+		let valueIndex = index + 1;
+		if (branch[valueIndex] === "=") valueIndex += 1;
+		if (branch[valueIndex] === "=") valueIndex += 1;
+		valueIndex = skipWhitespace(branch, valueIndex);
+		if (isDigit(branch[valueIndex])) return true;
+	}
+	return false;
+};
+const isMajorTerminator = (value) => value === void 0 || isSeparator(value) || value === "." || value === "*" || value === "x" || value === "X" || value === "-";
+const getLowerBoundMajorAt = (branch, start) => {
+	let index = start;
+	if (branch[index] === ">" && branch[index + 1] === "=") index = skipWhitespace(branch, index + 2);
+	else if (branch[index] === "~" || branch[index] === "^" || branch[index] === "=" || branch[index] === "v") index = skipWhitespace(branch, index + 1);
+	const majorStart = index;
+	const majorEnd = readDigits(branch, majorStart);
+	if (majorEnd === majorStart || !isMajorTerminator(branch[majorEnd])) return null;
+	return {
+		end: majorEnd,
+		major: Number.parseInt(branch.slice(majorStart, majorEnd), 10)
+	};
+};
 const normalizeDependencyVersion = (version) => {
 	const trimmed = version.trim();
 	if (trimmed.length === 0) return null;
@@ -2325,17 +2401,29 @@ const normalizeDependencyVersion = (version) => {
 	if (WILDCARD_VERSION.test(normalizedVersion)) return null;
 	return normalizedVersion;
 };
-const splitDependencyVersionBranches = (version) => version.split(OR_SEPARATOR).filter(Boolean);
-const hasUpperBoundComparator = (version) => HAS_UPPER_BOUND_COMPARATOR.test(version);
+const splitDependencyVersionBranches = (version) => version.split("||").map((branch) => branch.trim()).filter(Boolean);
+const hasUpperBoundComparator = (version) => {
+	for (let index = 0; index < version.length; index += 1) if (getUpperBoundComparatorEnd(version, index) !== null) return true;
+	return false;
+};
 const getBranchLowestMajor = (branch) => {
-	if (NON_LOWER_BOUND_COMPARATOR.test(branch)) return null;
-	const lowerBoundComparators = branch.replace(UPPER_BOUND_COMPARATOR, " ").trim();
+	if (hasNonLowerBoundComparator(branch)) return null;
+	const lowerBoundComparators = stripUpperBoundComparators(branch).trim();
 	if (lowerBoundComparators.length === 0) return null;
 	let branchLowestMajor = null;
-	for (const match of lowerBoundComparators.matchAll(LOWER_BOUND_MAJOR)) {
-		const major = Number.parseInt(match[1], 10);
-		if (!Number.isFinite(major) || major <= 0) continue;
-		if (branchLowestMajor === null || major < branchLowestMajor) branchLowestMajor = major;
+	let index = 0;
+	while (index < lowerBoundComparators.length) {
+		const lowerBoundStart = skipSeparators(lowerBoundComparators, index);
+		if (lowerBoundStart > 0 && !isSeparator(lowerBoundComparators[lowerBoundStart - 1])) {
+			index = lowerBoundStart + 1;
+			continue;
+		}
+		const lowerBoundMajor = getLowerBoundMajorAt(lowerBoundComparators, lowerBoundStart);
+		if (lowerBoundMajor !== null && Number.isFinite(lowerBoundMajor.major) && lowerBoundMajor.major > 0) {
+			const major = lowerBoundMajor.major;
+			if (branchLowestMajor === null || major < branchLowestMajor) branchLowestMajor = major;
+		}
+		index = lowerBoundMajor?.end ?? lowerBoundStart + 1;
 	}
 	return branchLowestMajor;
 };
@@ -2504,6 +2592,7 @@ const resolveCatalogVersion = (packageJson, packageName, rootDirectory, explicit
 const EMPTY_DEPENDENCY_INFO = {
 	reactVersion: null,
 	tailwindVersion: null,
+	zodVersion: null,
 	framework: "unknown"
 };
 const pickConcreteVersion = (packageJson, packageName, sections) => {
@@ -2532,6 +2621,11 @@ const extractDependencyInfo = (packageJson) => {
 			"devDependencies",
 			"peerDependencies"
 		]),
+		zodVersion: pickConcreteVersion(packageJson, "zod", [
+			"dependencies",
+			"devDependencies",
+			"peerDependencies"
+		]),
 		framework: detectFramework(allDependencies)
 	};
 };
@@ -2676,8 +2770,22 @@ const findReactInWorkspaces = (rootDirectory, packageJson) => {
 				workspaceDirectory,
 				workspacePackageJson
 			});
+			const zodVersion = resolveWorkspaceDependencyVersion({
+				concreteVersion: info.zodVersion,
+				packageName: "zod",
+				rootDirectory,
+				rootPackageJson: packageJson,
+				sections: [
+					"dependencies",
+					"devDependencies",
+					"peerDependencies"
+				],
+				workspaceDirectory,
+				workspacePackageJson
+			});
 			if (reactVersion && shouldReplaceReactVersion(result.reactVersion, reactVersion)) result.reactVersion = reactVersion;
 			if (tailwindVersion && !result.tailwindVersion) result.tailwindVersion = tailwindVersion;
+			if (zodVersion && !result.zodVersion) result.zodVersion = zodVersion;
 			if (info.framework !== "unknown" && result.framework === "unknown") result.framework = info.framework;
 			const resultReactMajor = parseReactMajor(result.reactVersion);
 			if (result.reactVersion && result.tailwindVersion && result.framework !== "unknown" && resultReactMajor !== null && resultReactMajor <= 17) return result;
@@ -2712,14 +2820,26 @@ const findDependencyInfoFromMonorepoRoot = (directory) => {
 			"peerDependencies"
 		]
 	}) : null;
+	const leafZodDeclaration = leafPackageJson ? getDependencyDeclaration({
+		packageJson: leafPackageJson,
+		packageName: "zod",
+		sections: [
+			"dependencies",
+			"devDependencies",
+			"peerDependencies"
+		]
+	}) : null;
 	const shouldUseReactFallback = !leafReactDeclaration?.hasDeclaration;
 	const shouldUseTailwindFallback = leafTailwindDeclaration?.hasDeclaration ?? true;
+	const shouldUseZodFallback = leafZodDeclaration?.hasDeclaration ?? true;
 	const reactCatalogVersion = shouldUseReactFallback ? resolveCatalogVersion(rootPackageJson, "react", monorepoRoot, leafReactDeclaration?.catalogReference) : null;
 	const tailwindCatalogVersion = shouldUseTailwindFallback ? resolveCatalogVersion(rootPackageJson, "tailwindcss", monorepoRoot, leafTailwindDeclaration?.catalogReference) : null;
+	const zodCatalogVersion = shouldUseZodFallback ? resolveCatalogVersion(rootPackageJson, "zod", monorepoRoot, leafZodDeclaration?.catalogReference) : null;
 	const workspaceInfo = findReactInWorkspaces(monorepoRoot, rootPackageJson);
 	return {
 		reactVersion: shouldUseReactFallback ? reactCatalogVersion ?? rootInfo.reactVersion ?? workspaceInfo.reactVersion : rootInfo.reactVersion ?? workspaceInfo.reactVersion,
 		tailwindVersion: shouldUseTailwindFallback ? tailwindCatalogVersion ?? rootInfo.tailwindVersion ?? workspaceInfo.tailwindVersion : null,
+		zodVersion: shouldUseZodFallback ? zodCatalogVersion ?? rootInfo.zodVersion ?? workspaceInfo.zodVersion : null,
 		framework: rootInfo.framework !== "unknown" ? rootInfo.framework : workspaceInfo.framework
 	};
 };
@@ -2799,6 +2919,10 @@ const isPackageJsonReanimatedAware = (packageJson) => {
 	};
 	return Object.hasOwn(allDependencies, REANIMATED_DEPENDENCY_NAME);
 };
+const parseZodMajor = (zodVersion) => {
+	if (typeof zodVersion !== "string") return null;
+	return getLowestDependencyMajor(zodVersion);
+};
 const hasUpperBoundOnlyPeerRange = (range) => {
 	if (typeof range !== "string") return false;
 	const normalizedRange = normalizeDependencyVersion(range);
@@ -2940,7 +3064,7 @@ const discoverProject = (directory) => {
 	const packageJsonPath = path.join(directory, "package.json");
 	if (!isFile(packageJsonPath)) throw new PackageJsonNotFoundError(directory);
 	const packageJson = readPackageJson(packageJsonPath);
-	let { reactVersion, tailwindVersion, framework } = extractDependencyInfo(packageJson);
+	let { reactVersion, tailwindVersion, zodVersion, framework } = extractDependencyInfo(packageJson);
 	const reactDeclaration = getDependencyDeclaration({
 		packageJson,
 		packageName: "react",
@@ -2959,9 +3083,19 @@ const discoverProject = (directory) => {
 			"peerDependencies"
 		]
 	});
+	const zodDeclaration = getDependencyDeclaration({
+		packageJson,
+		packageName: "zod",
+		sections: [
+			"dependencies",
+			"devDependencies",
+			"peerDependencies"
+		]
+	});
 	if (!reactVersion && reactDeclaration.hasDeclaration) reactVersion = resolveCatalogVersion(packageJson, "react", directory, reactDeclaration.catalogReference);
 	if (!tailwindVersion && tailwindDeclaration.hasDeclaration) tailwindVersion = resolveCatalogVersion(packageJson, "tailwindcss", directory, tailwindDeclaration.catalogReference);
-	if (!reactVersion || !tailwindVersion) {
+	if (!zodVersion && zodDeclaration.hasDeclaration) zodVersion = resolveCatalogVersion(packageJson, "zod", directory, zodDeclaration.catalogReference);
+	if (!reactVersion || !tailwindVersion || !zodVersion) {
 		const monorepoRoot = findMonorepoRoot(directory);
 		if (monorepoRoot) {
 			const monorepoPackageJsonPath = path.join(monorepoRoot, "package.json");
@@ -2969,6 +3103,7 @@ const discoverProject = (directory) => {
 				const rootPackageJson = readPackageJson(monorepoPackageJsonPath);
 				if (!reactVersion && reactDeclaration.hasDeclaration) reactVersion = resolveCatalogVersion(rootPackageJson, "react", monorepoRoot, reactDeclaration.catalogReference);
 				if (!tailwindVersion && tailwindDeclaration.hasDeclaration) tailwindVersion = resolveCatalogVersion(rootPackageJson, "tailwindcss", monorepoRoot, tailwindDeclaration.catalogReference);
+				if (!zodVersion && zodDeclaration.hasDeclaration) zodVersion = resolveCatalogVersion(rootPackageJson, "zod", monorepoRoot, zodDeclaration.catalogReference);
 			}
 		}
 	}
@@ -2976,16 +3111,19 @@ const discoverProject = (directory) => {
 		const workspaceInfo = findReactInWorkspaces(directory, packageJson);
 		if (!reactVersion && workspaceInfo.reactVersion) reactVersion = workspaceInfo.reactVersion;
 		if (!tailwindVersion && workspaceInfo.tailwindVersion) tailwindVersion = workspaceInfo.tailwindVersion;
+		if (!zodVersion && workspaceInfo.zodVersion) zodVersion = workspaceInfo.zodVersion;
 		if (framework === "unknown" && workspaceInfo.framework !== "unknown") framework = workspaceInfo.framework;
 	}
 	if ((!reactVersion || framework === "unknown") && !isMonorepoRoot(directory)) {
 		const monorepoInfo = findDependencyInfoFromMonorepoRoot(directory);
 		if (!reactVersion) reactVersion = monorepoInfo.reactVersion;
 		if (!tailwindVersion) tailwindVersion = monorepoInfo.tailwindVersion;
+		if (!zodVersion) zodVersion = monorepoInfo.zodVersion;
 		if (framework === "unknown") framework = monorepoInfo.framework;
 	}
 	if (!reactVersion && reactDeclaration.version && !isCatalogReference(reactDeclaration.version)) reactVersion = reactDeclaration.version;
 	if (!tailwindVersion && tailwindDeclaration.version && !isCatalogReference(tailwindDeclaration.version)) tailwindVersion = tailwindDeclaration.version;
+	if (!zodVersion && zodDeclaration.version && !isCatalogReference(zodDeclaration.version)) zodVersion = zodDeclaration.version;
 	const projectName = packageJson.name ?? path.basename(directory);
 	const hasTypeScript = fs.existsSync(path.join(directory, "tsconfig.json"));
 	const sourceFileCount = countSourceFiles(directory);
@@ -2998,6 +3136,8 @@ const discoverProject = (directory) => {
 		reactVersion,
 		reactMajorVersion: resolveEffectiveReactMajor(reactVersion, packageJson),
 		tailwindVersion,
+		zodVersion,
+		zodMajorVersion: parseZodMajor(zodVersion),
 		framework,
 		hasTypeScript,
 		hasReactCompiler: detectReactCompiler(directory, packageJson),
@@ -5522,6 +5662,10 @@ const buildCapabilities = (project) => {
 			minor: 4
 		})) capabilities.add("tailwind:3.4");
 	}
+	if (project.zodVersion !== null) {
+		capabilities.add("zod");
+		if (project.zodMajorVersion !== null && project.zodMajorVersion >= 4) capabilities.add("zod:4");
+	}
 	if (project.hasReactCompiler) capabilities.add("react-compiler");
 	if (project.hasTanStackQuery) capabilities.add("tanstack-query");
 	if (project.hasTypeScript) capabilities.add("typescript");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-doctor",
-  "version": "0.2.11-dev.402c7ea",
+  "version": "0.2.11-dev.b2934f9",
   "description": "Diagnose and fix React codebases for security, performance, correctness, accessibility, bundle-size, and architecture issues",
   "keywords": [
     "accessibility",
@@ -58,14 +58,14 @@
     "oxlint": "^1.66.0",
     "prompts": "^2.4.2",
     "typescript": ">=5.0.4 <7",
-    "oxlint-plugin-react-doctor": "0.2.11-dev.402c7ea"
+    "oxlint-plugin-react-doctor": "0.2.11-dev.b2934f9"
   },
   "devDependencies": {
     "@types/prompts": "^2.4.9",
     "commander": "^14.0.3",
     "ora": "^9.4.0",
-    "@react-doctor/core": "0.2.11",
-    "@react-doctor/api": "0.2.11"
+    "@react-doctor/api": "0.2.11",
+    "@react-doctor/core": "0.2.11"
   },
   "engines": {
     "node": "^20.19.0 || >=22.12.0"