react-doctor 0.0.40 → 0.0.42

package/dist/cli.js

@@ -13,8 +13,8 @@ import { performance } from "node:perf_hooks";
 import { execSync, spawn, spawnSync } from "node:child_process";
 import { main } from "knip";
 import { createOptions } from "knip/session";
-
 //#region src/utils/detect-agents.ts
+const AGENTS_SKILL_DIR = ".agents/skills";
 const SUPPORTED_AGENTS = {
 	claude: {
 		binaries: ["claude"],
@@ -24,37 +24,37 @@ const SUPPORTED_AGENTS = {
 	codex: {
 		binaries: ["codex"],
 		displayName: "Codex",
-		skillDir: ".codex/skills"
+		skillDir: AGENTS_SKILL_DIR
 	},
 	copilot: {
 		binaries: ["copilot"],
 		displayName: "GitHub Copilot",
-		skillDir: ".github/copilot/skills"
+		skillDir: AGENTS_SKILL_DIR
 	},
 	gemini: {
 		binaries: ["gemini"],
 		displayName: "Gemini CLI",
-		skillDir: ".gemini/skills"
+		skillDir: AGENTS_SKILL_DIR
 	},
 	cursor: {
 		binaries: ["cursor", "agent"],
 		displayName: "Cursor",
-		skillDir: ".cursor/skills"
+		skillDir: AGENTS_SKILL_DIR
 	},
 	opencode: {
 		binaries: ["opencode"],
 		displayName: "OpenCode",
-		skillDir: ".opencode/skills"
+		skillDir: AGENTS_SKILL_DIR
 	},
 	droid: {
 		binaries: ["droid"],
 		displayName: "Factory Droid",
-		skillDir: ".droid/skills"
+		skillDir: ".factory/skills"
 	},
 	pi: {
 		binaries: ["pi", "omegon"],
 		displayName: "Pi",
-		skillDir: ".pi/skills"
+		skillDir: AGENTS_SKILL_DIR
 	}
 };
 const ALL_SUPPORTED_AGENTS = Object.keys(SUPPORTED_AGENTS);
@@ -74,7 +74,6 @@ const isCommandAvailable = (command) => {
 const detectAvailableAgents = () => ALL_SUPPORTED_AGENTS.filter((agent) => SUPPORTED_AGENTS[agent].binaries.some(isCommandAvailable));
 const toDisplayName = (agent) => SUPPORTED_AGENTS[agent].displayName;
 const toSkillDir = (agent) => SUPPORTED_AGENTS[agent].skillDir;
-
 //#endregion
 //#region src/utils/highlighter.ts
 const highlighter = {
@@ -84,11 +83,11 @@ const highlighter = {
 	success: pc.green,
 	dim: pc.dim
 };
-
 //#endregion
 //#region src/utils/install-skill-for-agent.ts
-const installSkillForAgent = (projectRoot, agent, skillSourceDirectory, skillName) => {
+const installSkillForAgent = (projectRoot, agent, skillSourceDirectory, skillName, alreadyInstalledDirectories) => {
 	const installedSkillDirectory = path.join(projectRoot, toSkillDir(agent), skillName);
+	if (alreadyInstalledDirectories?.has(installedSkillDirectory)) return installedSkillDirectory;
 	rmSync(installedSkillDirectory, {
 		recursive: true,
 		force: true
@@ -97,7 +96,6 @@ const installSkillForAgent = (projectRoot, agent, skillSourceDirectory, skillNam
 	cpSync(skillSourceDirectory, installedSkillDirectory, { recursive: true });
 	return installedSkillDirectory;
 };
-
 //#endregion
 //#region src/utils/logger.ts
 const logger = {
@@ -123,7 +121,6 @@ const logger = {
 		console.log("");
 	}
 };
-
 //#endregion
 //#region src/utils/should-auto-select-current-choice.ts
 const shouldAutoSelectCurrentChoice = (choiceStates, cursor) => {
@@ -131,13 +128,11 @@ const shouldAutoSelectCurrentChoice = (choiceStates, cursor) => {
 	const currentChoice = choiceStates[cursor];
 	return Boolean(currentChoice) && !currentChoice.disabled;
 };
-
 //#endregion
 //#region src/utils/should-select-all-choices.ts
 const shouldSelectAllChoices = (choiceStates) => {
 	return choiceStates.filter((choiceState) => !choiceState.disabled).some((choiceState) => choiceState.selected !== true);
 };
-
 //#endregion
 //#region src/utils/prompts.ts
 const require = createRequire(import.meta.url);
@@ -203,7 +198,6 @@ const prompts = (questions) => {
 	patchSelectBanner();
 	return basePrompts(questions, { onCancel });
 };
-
 //#endregion
 //#region src/utils/spinner.ts
 let sharedInstance = null;
@@ -234,7 +228,6 @@ const spinner = (text) => ({ start() {
 		fail: (displayText) => finalize("fail", text, displayText)
 	};
 } });
-
 //#endregion
 //#region src/install-skill.ts
 const SKILL_NAME = "react-doctor";
@@ -271,35 +264,37 @@ const runInstallSkill = async (options = {}) => {
 	})).agents ?? [];
 	if (selectedAgents.length === 0) return;
 	const installSpinner = spinner(`Installing ${SKILL_NAME} skill...`).start();
-	for (const agent of selectedAgents) installSkillForAgent(projectRoot, agent, sourceDir, SKILL_NAME);
+	const installedDirectories = /* @__PURE__ */ new Set();
+	for (const agent of selectedAgents) {
+		const installedDirectory = installSkillForAgent(projectRoot, agent, sourceDir, SKILL_NAME, installedDirectories);
+		installedDirectories.add(installedDirectory);
+	}
 	installSpinner.succeed(`${SKILL_NAME} skill installed for ${selectedAgents.map(toDisplayName).join(", ")}.`);
 };
-
 //#endregion
 //#region src/constants.ts
 const SOURCE_FILE_PATTERN = /\.(tsx?|jsx?)$/;
 const JSX_FILE_PATTERN = /\.(tsx|jsx)$/;
 const MILLISECONDS_PER_SECOND = 1e3;
-const ERROR_PREVIEW_LENGTH_CHARS = 200;
-const PERFECT_SCORE = 100;
-const SCORE_GOOD_THRESHOLD = 75;
-const SCORE_OK_THRESHOLD = 50;
-const SCORE_BAR_WIDTH_CHARS = 50;
-const SUMMARY_BOX_HORIZONTAL_PADDING_CHARS = 1;
-const SUMMARY_BOX_OUTER_INDENT_CHARS = 2;
 const SCORE_API_URL = "https://www.react.doctor/api/score";
 const SHARE_BASE_URL = "https://www.react.doctor/share";
 const FETCH_TIMEOUT_MS = 1e4;
 const GIT_LS_FILES_MAX_BUFFER_BYTES = 50 * 1024 * 1024;
-const SPAWN_ARGS_MAX_LENGTH_CHARS = 24e3;
-const OXLINT_MAX_FILES_PER_BATCH = 500;
 const OFFLINE_MESSAGE = "Score calculated locally (offline mode).";
 const DEFAULT_BRANCH_CANDIDATES = ["main", "master"];
 const ERROR_RULE_PENALTY = 1.5;
 const WARNING_RULE_PENALTY = .75;
-const MAX_KNIP_RETRIES = 5;
+const KNIP_CONFIG_LOCATIONS = [
+	"knip.json",
+	"knip.jsonc",
+	".knip.json",
+	".knip.jsonc",
+	"knip.ts",
+	"knip.js",
+	"knip.config.ts",
+	"knip.config.js"
+];
 const OXLINT_NODE_REQUIREMENT = "^20.19.0 || >=22.12.0";
-const OXLINT_RECOMMENDED_NODE_MAJOR = 24;
 const GIT_SHOW_MAX_BUFFER_BYTES = 10 * 1024 * 1024;
 const IGNORED_DIRECTORIES = new Set([
 	"node_modules",
@@ -307,12 +302,11 @@ const IGNORED_DIRECTORIES = new Set([
 	"build",
 	"coverage"
 ]);
-
 //#endregion
 //#region src/core/calculate-score-locally.ts
 const getScoreLabel = (score) => {
-	if (score >= SCORE_GOOD_THRESHOLD) return "Great";
-	if (score >= SCORE_OK_THRESHOLD) return "Needs work";
+	if (score >= 75) return "Great";
+	if (score >= 50) return "Needs work";
 	return "Critical";
 };
 const countUniqueRules = (diagnostics) => {
@@ -330,7 +324,7 @@ const countUniqueRules = (diagnostics) => {
 };
 const scoreFromRuleCounts = (errorRuleCount, warningRuleCount) => {
 	const penalty = errorRuleCount * ERROR_RULE_PENALTY + warningRuleCount * WARNING_RULE_PENALTY;
-	return Math.max(0, Math.round(PERFECT_SCORE - penalty));
+	return Math.max(0, Math.round(100 - penalty));
 };
 const calculateScoreLocally = (diagnostics) => {
 	const { errorRuleCount, warningRuleCount } = countUniqueRules(diagnostics);
@@ -340,7 +334,6 @@ const calculateScoreLocally = (diagnostics) => {
 		label: getScoreLabel(score)
 	};
 };
-
 //#endregion
 //#region src/core/try-score-from-api.ts
 const parseScoreResult = (value) => {
@@ -372,7 +365,6 @@ const tryScoreFromApi = async (diagnostics, fetchImplementation) => {
 		clearTimeout(timeoutId);
 	}
 };
-
 //#endregion
 //#region src/utils/proxy-fetch.ts
 const getGlobalProcess = () => {
@@ -415,7 +407,6 @@ const proxyFetch = async (url, init) => {
 		clearTimeout(timeoutId);
 	}
 };
-
 //#endregion
 //#region src/utils/calculate-score-node.ts
 const calculateScore = async (diagnostics) => {
@@ -423,19 +414,16 @@ const calculateScore = async (diagnostics) => {
 	if (apiScore) return apiScore;
 	return calculateScoreLocally(diagnostics);
 };
-
 //#endregion
 //#region src/utils/colorize-by-score.ts
 const colorizeByScore = (text, score) => {
-	if (score >= SCORE_GOOD_THRESHOLD) return highlighter.success(text);
-	if (score >= SCORE_OK_THRESHOLD) return highlighter.warn(text);
+	if (score >= 75) return highlighter.success(text);
+	if (score >= 50) return highlighter.warn(text);
 	return highlighter.error(text);
 };
-
 //#endregion
 //#region src/plugin/constants.ts
 const MOTION_LIBRARY_PACKAGES = new Set(["framer-motion", "motion"]);
-
 //#endregion
 //#region src/utils/is-file.ts
 const isFile = (filePath) => {
@@ -445,7 +433,6 @@ const isFile = (filePath) => {
 		return false;
 	}
 };
-
 //#endregion
 //#region src/utils/read-package-json.ts
 const readPackageJson = (packageJsonPath) => {
@@ -460,7 +447,6 @@ const readPackageJson = (packageJsonPath) => {
 		throw error;
 	}
 };
-
 //#endregion
 //#region src/utils/check-reduced-motion.ts
 const REDUCED_MOTION_GREP_PATTERN = "prefers-reduced-motion|useReducedMotion|MotionConfig|reducedMotion";
@@ -502,7 +488,6 @@ const checkReducedMotion = (rootDirectory) => {
 		return [MISSING_REDUCED_MOTION_DIAGNOSTIC];
 	}
 };
-
 //#endregion
 //#region src/utils/read-file-lines-node.ts
 const createNodeReadFileLinesSync = (rootDirectory) => {
@@ -515,7 +500,6 @@ const createNodeReadFileLinesSync = (rootDirectory) => {
 		}
 	};
 };
-
 //#endregion
 //#region src/utils/match-glob-pattern.ts
 const REGEX_SPECIAL_CHARACTERS = /[.+^${}()|[\]\\]/g;
@@ -543,7 +527,6 @@ const compileGlobPattern = (pattern) => {
 	regexSource += "$";
 	return new RegExp(regexSource);
 };
-
 //#endregion
 //#region src/utils/is-ignored-file.ts
 const toRelativePath = (filePath, rootDirectory) => {
@@ -558,7 +541,6 @@ const isFileIgnoredByPatterns = (filePath, rootDirectory, patterns) => {
 	const relativePath = toRelativePath(filePath, rootDirectory);
 	return patterns.some((pattern) => pattern.test(relativePath));
 };
-
 //#endregion
 //#region src/utils/filter-diagnostics.ts
 const resolveCandidateReadPath = (rootDirectory, filePath) => {
@@ -632,17 +614,14 @@ const filterInlineSuppressions = (diagnostics, rootDirectory, readFileLinesSync)
 		return true;
 	});
 };
-
 //#endregion
 //#region src/utils/merge-and-filter-diagnostics.ts
 const mergeAndFilterDiagnostics = (mergedDiagnostics, directory, userConfig, readFileLinesSync) => {
 	return filterInlineSuppressions(userConfig ? filterIgnoredDiagnostics(mergedDiagnostics, userConfig, directory, readFileLinesSync) : mergedDiagnostics, directory, readFileLinesSync);
 };
-
 //#endregion
 //#region src/utils/jsx-include-paths.ts
 const computeJsxIncludePaths = (includePaths) => includePaths.length > 0 ? includePaths.filter((filePath) => JSX_FILE_PATTERN.test(filePath)) : void 0;
-
 //#endregion
 //#region src/utils/combine-diagnostics.ts
 const combineDiagnostics = (lintDiagnostics, deadCodeDiagnostics, directory, isDiffMode, userConfig, readFileLinesSync = createNodeReadFileLinesSync(directory), includeEnvironmentChecks = true) => {
@@ -653,7 +632,6 @@ const combineDiagnostics = (lintDiagnostics, deadCodeDiagnostics, directory, isD
 		...extraDiagnostics
 	], directory, userConfig, readFileLinesSync);
 };
-
 //#endregion
 //#region src/utils/find-monorepo-root.ts
 const isMonorepoRoot = (directory) => {
@@ -672,11 +650,9 @@ const findMonorepoRoot = (startDirectory) => {
 	}
 	return null;
 };
-
 //#endregion
 //#region src/utils/is-plain-object.ts
 const isPlainObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-
 //#endregion
 //#region src/utils/discover-project.ts
 const REACT_COMPILER_PACKAGES = new Set([
@@ -1097,7 +1073,22 @@ const discoverProject = (directory) => {
 		sourceFileCount
 	};
 };
-
+//#endregion
+//#region src/utils/format-error-chain.ts
+const collectErrorChain = (rootError) => {
+	const errorChain = [];
+	const visitedErrors = /* @__PURE__ */ new Set();
+	let currentError = rootError;
+	while (currentError !== void 0 && !visitedErrors.has(currentError)) {
+		visitedErrors.add(currentError);
+		errorChain.push(currentError);
+		currentError = currentError instanceof Error ? currentError.cause : void 0;
+	}
+	return errorChain;
+};
+const formatErrorMessage = (error) => error instanceof Error ? error.message || error.name : String(error);
+const formatErrorChain = (rootError) => collectErrorChain(rootError).map(formatErrorMessage).join(" → ");
+const getErrorChainMessages = (rootError) => collectErrorChain(rootError).map(formatErrorMessage);
 //#endregion
 //#region src/utils/framed-box.ts
 const createFramedLine = (plainText, renderedText = plainText) => ({
@@ -1107,10 +1098,10 @@ const createFramedLine = (plainText, renderedText = plainText) => ({
 const renderFramedBoxString = (framedLines) => {
 	if (framedLines.length === 0) return "";
 	const borderColorizer = highlighter.dim;
-	const outerIndent = " ".repeat(SUMMARY_BOX_OUTER_INDENT_CHARS);
-	const horizontalPadding = " ".repeat(SUMMARY_BOX_HORIZONTAL_PADDING_CHARS);
+	const outerIndent = " ".repeat(2);
+	const horizontalPadding = " ".repeat(1);
 	const maximumLineLength = Math.max(...framedLines.map((framedLine) => framedLine.plainText.length));
-	const borderLine = "─".repeat(maximumLineLength + SUMMARY_BOX_HORIZONTAL_PADDING_CHARS * 2);
+	const borderLine = "─".repeat(maximumLineLength + 2);
 	const lines = [];
 	lines.push(`${outerIndent}${borderColorizer(`┌${borderLine}┐`)}`);
 	for (const framedLine of framedLines) {
@@ -1124,7 +1115,6 @@ const printFramedBox = (framedLines) => {
 	const rendered = renderFramedBoxString(framedLines);
 	if (rendered) logger.log(rendered);
 };
-
 //#endregion
 //#region src/utils/group-by.ts
 const groupBy = (items, keyFn) => {
@@ -1137,11 +1127,9 @@ const groupBy = (items, keyFn) => {
 	}
 	return groups;
 };
-
 //#endregion
 //#region src/utils/indent-multiline-text.ts
 const indentMultilineText = (text, linePrefix) => text.split("\n").map((lineText) => `${linePrefix}${lineText}`).join("\n");
-
 //#endregion
 //#region src/utils/load-config.ts
 const CONFIG_FILENAME = "react-doctor.config.json";
@@ -1177,7 +1165,6 @@ const loadConfig = (rootDirectory) => {
 	}
 	return null;
 };
-
 //#endregion
 //#region src/utils/resolve-compatible-node.ts
 const parseNodeVersion = (versionString) => {
@@ -1230,7 +1217,7 @@ const installNodeViaNvm = () => {
 	const nvmScript = path.join(nvmDirectory, "nvm.sh");
 	if (!existsSync(nvmScript)) return false;
 	try {
-		execSync(`bash -c ". '${nvmScript}' && nvm install ${OXLINT_RECOMMENDED_NODE_MAJOR}"`, { stdio: "inherit" });
+		execSync(`bash -c ". '${nvmScript}' && nvm install 24"`, { stdio: "inherit" });
 		return findCompatibleNvmBinary() !== null;
 	} catch {
 		return false;
@@ -1252,7 +1239,6 @@ const resolveNodeForOxlint = () => {
 		version
 	};
 };
-
 //#endregion
 //#region src/utils/resolve-lint-include-paths.ts
 const listSourceFilesViaGit = (rootDirectory) => {
@@ -1295,7 +1281,6 @@ const resolveLintIncludePaths = (rootDirectory, userConfig) => {
 		return !isFileIgnoredByPatterns(filePath, rootDirectory, ignoredPatterns);
 	});
 };
-
 //#endregion
 //#region src/utils/collect-unused-file-paths.ts
 const collectUnusedFilePaths = (filesIssues) => {
@@ -1309,7 +1294,19 @@ const collectUnusedFilePaths = (filesIssues) => {
 	}
 	return unusedFilePaths;
 };
-
+//#endregion
+//#region src/utils/extract-failed-plugin-name.ts
+const PLUGIN_CONFIG_PATTERN = /(?:^|[/\\\s])([a-z][a-z0-9-]*)\.config\./i;
+const extractFailedPluginName = (error) => {
+	for (const errorMessage of getErrorChainMessages(error)) {
+		const pluginNameMatch = errorMessage.match(PLUGIN_CONFIG_PATTERN);
+		if (pluginNameMatch?.[1]) return pluginNameMatch[1].toLowerCase();
+	}
+	return null;
+};
+//#endregion
+//#region src/utils/has-knip-config.ts
+const hasKnipConfig = (directory) => KNIP_CONFIG_LOCATIONS.some((configFilename) => isFile(path.join(directory, configFilename)));
 //#endregion
 //#region src/utils/run-knip.ts
 const KNIP_CATEGORY_MAP = {
@@ -1364,12 +1361,15 @@ const silenced = async (fn) => {
 		console.error = originalError;
 	}
 };
-const CONFIG_LOADING_ERROR_PATTERN = /Error loading .*\/([a-z-]+)\.config\./;
-const extractFailedPluginName = (error) => {
-	return String(error).match(CONFIG_LOADING_ERROR_PATTERN)?.[1] ?? null;
-};
 const TSCONFIG_FILENAMES = ["tsconfig.base.json", "tsconfig.json"];
 const resolveTsConfigFile = (directory) => TSCONFIG_FILENAMES.find((filename) => fs.existsSync(path.join(directory, filename)));
+const tryDisableFailedPlugin = (error, parsedConfig, disabledPlugins) => {
+	const failedPlugin = extractFailedPluginName(error);
+	if (!failedPlugin || !(failedPlugin in parsedConfig) || disabledPlugins.has(failedPlugin)) return false;
+	disabledPlugins.add(failedPlugin);
+	parsedConfig[failedPlugin] = false;
+	return true;
+};
 const runKnipWithOptions = async (knipCwd, workspaceName) => {
 	const tsConfigFile = resolveTsConfigFile(knipCwd);
 	const options = await silenced(() => createOptions({
@@ -1379,33 +1379,36 @@ const runKnipWithOptions = async (knipCwd, workspaceName) => {
 		...tsConfigFile ? { tsConfigFile } : {}
 	}));
 	const parsedConfig = options.parsedConfig;
-	for (let attempt = 0; attempt <= MAX_KNIP_RETRIES; attempt++) try {
+	const disabledPlugins = /* @__PURE__ */ new Set();
+	let lastKnipError;
+	for (let attempt = 0; attempt <= 5; attempt++) try {
 		return await silenced(() => main(options));
 	} catch (error) {
-		const failedPlugin = extractFailedPluginName(error);
-		if (!failedPlugin || attempt === MAX_KNIP_RETRIES) throw error;
-		parsedConfig[failedPlugin] = false;
+		lastKnipError = error;
+		if (!tryDisableFailedPlugin(error, parsedConfig, disabledPlugins)) throw error;
 	}
-	throw new Error("Unreachable");
+	throw lastKnipError;
 };
 const hasNodeModules = (directory) => {
 	const nodeModulesPath = path.join(directory, "node_modules");
 	return fs.existsSync(nodeModulesPath) && fs.statSync(nodeModulesPath).isDirectory();
 };
+const resolveWorkspaceName = (rootDirectory) => {
+	const packageJsonPath = path.join(rootDirectory, "package.json");
+	return (isFile(packageJsonPath) ? readPackageJson(packageJsonPath) : {}).name ?? path.basename(rootDirectory);
+};
+const runKnipForProject = async (rootDirectory, monorepoRoot) => {
+	if (!monorepoRoot || hasKnipConfig(rootDirectory)) return runKnipWithOptions(rootDirectory);
+	try {
+		return await runKnipWithOptions(monorepoRoot, resolveWorkspaceName(rootDirectory));
+	} catch {
+		return runKnipWithOptions(rootDirectory);
+	}
+};
 const runKnip = async (rootDirectory) => {
 	const monorepoRoot = findMonorepoRoot(rootDirectory);
 	if (!(hasNodeModules(rootDirectory) || monorepoRoot !== null && hasNodeModules(monorepoRoot))) return [];
-	let knipResult;
-	if (monorepoRoot) {
-		const packageJsonPath = path.join(rootDirectory, "package.json");
-		const workspaceName = (isFile(packageJsonPath) ? JSON.parse(fs.readFileSync(packageJsonPath, "utf-8")) : {}).name ?? path.basename(rootDirectory);
-		try {
-			knipResult = await runKnipWithOptions(monorepoRoot, workspaceName);
-		} catch {
-			knipResult = await runKnipWithOptions(rootDirectory);
-		}
-	} else knipResult = await runKnipWithOptions(rootDirectory);
-	const { issues } = knipResult;
+	const { issues } = await runKnipForProject(rootDirectory, monorepoRoot);
 	const diagnostics = [];
 	for (const unusedFilePath of collectUnusedFilePaths(issues.files)) diagnostics.push({
 		filePath: path.relative(rootDirectory, unusedFilePath),
@@ -1426,7 +1429,6 @@ const runKnip = async (rootDirectory) => {
 	]) diagnostics.push(...collectIssueRecords(issues[issueType], issueType, rootDirectory));
 	return diagnostics;
 };
-
 //#endregion
 //#region src/oxlint-config.ts
 const esmRequire$1 = createRequire(import.meta.url);
@@ -1610,7 +1612,6 @@ const createOxlintConfig = ({ pluginPath, framework, hasReactCompiler, customRul
 		...framework === "tanstack-start" ? TANSTACK_START_RULES : {}
 	}
 });
-
 //#endregion
 //#region src/utils/neutralize-disable-directives.ts
 const findFilesWithDisableDirectives = (rootDirectory, includePaths) => {
@@ -1653,7 +1654,6 @@ const neutralizeDisableDirectives = (rootDirectory, includePaths) => {
 		for (const [absolutePath, originalContent] of originalContents) fs.writeFileSync(absolutePath, originalContent);
 	};
 };
-
 //#endregion
 //#region src/utils/run-oxlint.ts
 const esmRequire = createRequire(import.meta.url);
@@ -1913,8 +1913,8 @@ const batchIncludePaths = (baseArgs, includePaths) => {
 	let currentBatchLength = baseArgsLength;
 	for (const filePath of includePaths) {
 		const entryLength = filePath.length + 1;
-		const exceedsArgLength = currentBatch.length > 0 && currentBatchLength + entryLength > SPAWN_ARGS_MAX_LENGTH_CHARS;
-		const exceedsFileCount = currentBatch.length >= OXLINT_MAX_FILES_PER_BATCH;
+		const exceedsArgLength = currentBatch.length > 0 && currentBatchLength + entryLength > 24e3;
+		const exceedsFileCount = currentBatch.length >= 500;
 		if (exceedsArgLength || exceedsFileCount) {
 			batches.push(currentBatch);
 			currentBatch = [];
@@ -1958,7 +1958,7 @@ const parseOxlintOutput = (stdout) => {
 	try {
 		output = JSON.parse(stdout);
 	} catch {
-		throw new Error(`Failed to parse oxlint output: ${stdout.slice(0, ERROR_PREVIEW_LENGTH_CHARS)}`);
+		throw new Error(`Failed to parse oxlint output: ${stdout.slice(0, 200)}`);
 	}
 	return output.diagnostics.filter((diagnostic) => diagnostic.code && JSX_FILE_PATTERN.test(diagnostic.filename)).map((diagnostic) => {
 		const { plugin, rule } = parseRuleCode(diagnostic.code);
@@ -2009,7 +2009,6 @@ const runOxlint = async (rootDirectory, hasTypeScript, framework, hasReactCompil
 		if (fs.existsSync(configPath)) fs.unlinkSync(configPath);
 	}
 };
-
 //#endregion
 //#region src/scan.ts
 const SEVERITY_ORDER = {
@@ -2048,7 +2047,7 @@ const printDiagnostics = (diagnostics, isVerbose) => {
 	}
 };
 const formatElapsedTime = (elapsedMilliseconds) => {
-	if (elapsedMilliseconds < MILLISECONDS_PER_SECOND) return `${Math.round(elapsedMilliseconds)}ms`;
+	if (elapsedMilliseconds < 1e3) return `${Math.round(elapsedMilliseconds)}ms`;
 	return `${(elapsedMilliseconds / MILLISECONDS_PER_SECOND).toFixed(1)}s`;
 };
 const formatRuleSummary = (ruleKey, ruleDiagnostics) => {
@@ -2077,8 +2076,8 @@ const writeDiagnosticsDirectory = (diagnostics) => {
 	return outputDirectory;
 };
 const buildScoreBarSegments = (score) => {
-	const filledCount = Math.round(score / PERFECT_SCORE * SCORE_BAR_WIDTH_CHARS);
-	const emptyCount = SCORE_BAR_WIDTH_CHARS - filledCount;
+	const filledCount = Math.round(score / 100 * 50);
+	const emptyCount = 50 - filledCount;
 	return {
 		filledSegment: "█".repeat(filledCount),
 		emptySegment: "░".repeat(emptyCount)
@@ -2095,14 +2094,14 @@ const buildScoreBar = (score) => {
 const printScoreGauge = (score, label) => {
 	const scoreDisplay = colorizeByScore(`${score}`, score);
 	const labelDisplay = colorizeByScore(label, score);
-	logger.log(`  ${scoreDisplay} / ${PERFECT_SCORE}  ${labelDisplay}`);
+	logger.log(`  ${scoreDisplay} / 100  ${labelDisplay}`);
 	logger.break();
 	logger.log(`  ${buildScoreBar(score)}`);
 	logger.break();
 };
 const getDoctorFace = (score) => {
-	if (score >= SCORE_GOOD_THRESHOLD) return ["◠ ◠", " ▽ "];
-	if (score >= SCORE_OK_THRESHOLD) return ["• •", " ─ "];
+	if (score >= 75) return ["◠ ◠", " ▽ "];
+	if (score >= 50) return ["• •", " ─ "];
 	return ["x x", " ▽ "];
 };
 const printBranding = (score) => {
@@ -2140,8 +2139,8 @@ const buildBrandingLines = (scoreResult, noScoreMessage) => {
 		lines.push(createFramedLine("└─────┘", scoreColorizer("└─────┘")));
 		lines.push(createFramedLine("React Doctor (www.react.doctor)", `React Doctor ${highlighter.dim("(www.react.doctor)")}`));
 		lines.push(createFramedLine(""));
-		const scoreLinePlainText = `${scoreResult.score} / ${PERFECT_SCORE}  ${scoreResult.label}`;
-		const scoreLineRenderedText = `${colorizeByScore(String(scoreResult.score), scoreResult.score)} / ${PERFECT_SCORE}  ${colorizeByScore(scoreResult.label, scoreResult.score)}`;
+		const scoreLinePlainText = `${scoreResult.score} / 100  ${scoreResult.label}`;
+		const scoreLineRenderedText = `${colorizeByScore(String(scoreResult.score), scoreResult.score)} / 100  ${colorizeByScore(scoreResult.label, scoreResult.score)}`;
 		lines.push(createFramedLine(scoreLinePlainText, scoreLineRenderedText));
 		lines.push(createFramedLine(""));
 		lines.push(createFramedLine(buildPlainScoreBar(scoreResult.score), buildScoreBar(scoreResult.score)));
@@ -2208,7 +2207,7 @@ const resolveOxlintNode = async (isLintEnabled, isScoreOnly) => {
 		const { shouldInstallNode } = await prompts({
 			type: "confirm",
 			name: "shouldInstallNode",
-			message: `Install Node ${OXLINT_RECOMMENDED_NODE_MAJOR} via nvm to enable lint checks?`,
+			message: `Install Node 24 via nvm to enable lint checks?`,
 			initial: true
 		});
 		if (shouldInstallNode) {
@@ -2225,8 +2224,8 @@ const resolveOxlintNode = async (isLintEnabled, isScoreOnly) => {
 			logger.break();
 			return null;
 		}
-	} else if (isNvmInstalled()) logger.dim(`  Run: nvm install ${OXLINT_RECOMMENDED_NODE_MAJOR}`);
-	else logger.dim(`  Install nvm (https://github.com/nvm-sh/nvm) and run: nvm install ${OXLINT_RECOMMENDED_NODE_MAJOR}`);
+	} else if (isNvmInstalled()) logger.dim(`  Run: nvm install 24`);
+	else logger.dim(`  Install nvm (https://github.com/nvm-sh/nvm) and run: nvm install 24`);
 	logger.break();
 	return null;
 };
@@ -2279,13 +2278,13 @@ const scan = async (directory, inputOptions = {}) => {
 		} catch (error) {
 			didLintFail = true;
 			if (!options.scoreOnly) {
-				const errorMessage = error instanceof Error ? error.message : String(error);
-				if (errorMessage.includes("native binding")) {
+				const lintErrorChain = formatErrorChain(error);
+				if (lintErrorChain.includes("native binding")) {
 					lintSpinner?.fail(`Lint checks failed — oxlint native binding not found (Node ${process.version}).`);
 					logger.dim(`  Upgrade to Node ${OXLINT_NODE_REQUIREMENT} or run: npx -p oxlint@latest react-doctor@latest`);
 				} else {
 					lintSpinner?.fail("Lint checks failed (non-fatal, skipping).");
-					logger.error(errorMessage);
+					logger.error(lintErrorChain);
 				}
 			}
 			return [];
@@ -2301,7 +2300,7 @@ const scan = async (directory, inputOptions = {}) => {
 			didDeadCodeFail = true;
 			if (!options.scoreOnly) {
 				deadCodeSpinner?.fail("Dead code detection failed (non-fatal, skipping).");
-				logger.error(String(error));
+				logger.error(formatErrorChain(error));
 			}
 			return [];
 		}
@@ -2358,7 +2357,6 @@ const scan = async (directory, inputOptions = {}) => {
 		skippedChecks
 	};
 };
-
 //#endregion
 //#region src/utils/get-diff-files.ts
 const getCurrentBranch = (directory) => {
@@ -2438,7 +2436,6 @@ const getDiffInfo = (directory, explicitBaseBranch) => {
 	};
 };
 const filterSourceFiles = (filePaths) => filePaths.filter((filePath) => SOURCE_FILE_PATTERN.test(filePath));
-
 //#endregion
 //#region src/utils/get-staged-files.ts
 const getStagedFilePaths = (directory) => {
@@ -2500,7 +2497,6 @@ const materializeStagedFiles = (directory, stagedFiles, tempDirectory) => {
 		}
 	};
 };
-
 //#endregion
 //#region src/utils/handle-error.ts
 const DEFAULT_HANDLE_ERROR_OPTIONS = { shouldExit: true };
@@ -2514,7 +2510,6 @@ const handleError = (error, options = DEFAULT_HANDLE_ERROR_OPTIONS) => {
 	if (options.shouldExit) process.exit(1);
 	process.exitCode = 1;
 };
-
 //#endregion
 //#region src/utils/select-projects.ts
 const selectProjects = async (rootDirectory, projectFlag, skipPrompts) => {
@@ -2562,10 +2557,9 @@ const promptProjectSelection = async (workspacePackages, rootDirectory) => {
 	});
 	return selectedDirectories;
 };
-
 //#endregion
 //#region src/cli.ts
-const VERSION = "0.0.40";
+const VERSION = "0.0.42";
 const VALID_FAIL_ON_LEVELS = new Set([
 	"error",
 	"warning",
@@ -2734,7 +2728,7 @@ const main$1 = async () => {
 	await program.parseAsync();
 };
 main$1();
-
 //#endregion
-export {  };
+export {};
+
 //# sourceMappingURL=cli.js.map