react-doctor 0.5.8-dev.b69f4a7 → 0.5.8-dev.b6d1a87

package/dist/cli.js

@@ -1,5 +1,5 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="bd31e7dc-cfca-56b2-a963-9d798b3cbbe5")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="1e81c0a2-fd08-5f5b-ba28-bd5f7587e0f4")}catch(e){}}();
 import { createRequire } from "node:module";
 import * as NodeChildProcess from "node:child_process";
 import { execFile, execFileSync, spawn, spawnSync } from "node:child_process";
@@ -40522,6 +40522,11 @@ const toCanonicalPath = (filePath) => {
 };
 const DEAD_CODE_PLUGIN = "deslop";
 const DEAD_CODE_CATEGORY = "Maintainability";
+const REACT_DOCTOR_TOOLCHAIN_PACKAGES = new Set([
+	"react-doctor",
+	"eslint-plugin-react-doctor",
+	"oxlint-plugin-react-doctor"
+]);
 const DEAD_CODE_WORKER_SCRIPT = `
 const inputChunks = [];
 process.stdin.on("data", (chunk) => inputChunks.push(chunk));
@@ -40827,6 +40832,7 @@ const checkDeadCode = async (options) => {
 		});
 	}
 	for (const unusedDependency of result.unusedDependencies) {
+		if (REACT_DOCTOR_TOOLCHAIN_PACKAGES.has(unusedDependency.name)) continue;
 		const label = unusedDependency.isDevDependency ? "devDependency" : "dependency";
 		diagnostics.push({
 			filePath: "package.json",
@@ -45059,7 +45065,8 @@ const METRIC = {
 	lspScanCompleted: "lsp.scan.completed",
 	lspScanDuration: "lsp.scan.duration",
 	lspScanDiagnostics: "lsp.scan.diagnostics",
-	aiTrainingWarningShown: "ai.training.warning_shown"
+	aiTrainingWarningShown: "ai.training.warning_shown",
+	jsonOutUsed: "json.out_used"
 };
 //#endregion
 //#region src/cli/utils/noop-console.ts
@@ -45102,7 +45109,7 @@ const makeNoopConsole = () => ({
 });
 //#endregion
 //#region src/cli/utils/version.ts
-const VERSION = "0.5.8-dev.b69f4a7";
+const VERSION = "0.5.8-dev.b6d1a87";
 //#endregion
 //#region src/cli/utils/json-mode.ts
 let context = null;
@@ -45140,12 +45147,13 @@ const installSilentConsole = () => {
 		"trace"
 	]) target[key] = source[key];
 };
-const enableJsonMode = ({ compact, directory }) => {
+const enableJsonMode = ({ compact, directory, outputFile }) => {
 	context = {
 		compact,
 		directory,
 		startTime: performance$1.now(),
-		mode: "full"
+		mode: "full",
+		outputFile: outputFile ?? null
 	};
 	installSilentConsole();
 };
@@ -45158,7 +45166,11 @@ const setJsonReportMode = (mode) => {
 };
 const writeJsonReport = (report) => {
 	const serialized = context?.compact ? JSON.stringify(report) : JSON.stringify(report, null, 2);
-	process.stdout.write(`${serialized}\n`);
+	if (context?.outputFile) {
+		const resolvedPath = Path.resolve(context.outputFile);
+		NFS.mkdirSync(Path.dirname(resolvedPath), { recursive: true });
+		NFS.writeFileSync(resolvedPath, `${serialized}\n`);
+	} else process.stdout.write(`${serialized}\n`);
 };
 const writeJsonErrorReport = (error, sentryEventId) => {
 	if (!context) return;
@@ -45466,13 +45478,13 @@ const isDevVersion = (version) => version === "0.0.0" || version.includes("-");
 * uploads source-map artifacts under, so stack frames symbolicate. Honors the
 * standard `SENTRY_RELEASE` override.
 */
-const resolveSentryRelease = () => process.env.SENTRY_RELEASE || `react-doctor@0.5.8-dev.b69f4a7`;
+const resolveSentryRelease = () => process.env.SENTRY_RELEASE || `react-doctor@0.5.8-dev.b6d1a87`;
 /**
 * Deployment environment shown in Sentry's environment filter. Defaults to
 * `production` for tagged releases and `development` for dev/unbuilt versions,
 * overridable via the standard `SENTRY_ENVIRONMENT` env var.
 */
-const resolveSentryEnvironment = () => process.env.SENTRY_ENVIRONMENT || (isDevVersion("0.5.8-dev.b69f4a7") ? "development" : "production");
+const resolveSentryEnvironment = () => process.env.SENTRY_ENVIRONMENT || (isDevVersion("0.5.8-dev.b6d1a87") ? "development" : "production");
 /**
 * Performance-tracing sample rate in `[0, 1]`. Reads `SENTRY_TRACES_SAMPLE_RATE`
 * (set to `0` to disable tracing) and falls back to
@@ -50556,6 +50568,7 @@ const NON_BLOCKING_REACT_DOCTOR_COMMAND = [
 	`if ${REACT_DOCTOR_COMMAND} > "$react_doctor_output" 2>&1; then`,
 	"rm -f \"$react_doctor_output\";",
 	"else",
+	"cat \"$react_doctor_output\" >&2;",
 	"rm -f \"$react_doctor_output\";",
 	`printf "%s\\n" "React Doctor found staged regressions." "Run ${REACT_DOCTOR_COMMAND} to inspect." "Want them fixed? Ask your agent to run that command and resolve the findings." >&2;`,
 	"fi"
@@ -52253,10 +52266,11 @@ const rememberInstallAgents = (agents, options = {}) => writePreference(INSTALL_
 const CLAUDE_AGENT = "claude-code";
 const CURSOR_AGENT = "cursor";
 const CLAUDE_SETTINGS_RELATIVE_PATH = ".claude/settings.json";
-const CLAUDE_HOOK_RELATIVE_PATH = ".claude/hooks/react-doctor.sh";
-const CLAUDE_HOOK_COMMAND = "sh \"$CLAUDE_PROJECT_DIR/.claude/hooks/react-doctor.sh\"";
+const CLAUDE_HOOK_RELATIVE_PATH = ".claude/hooks/react-doctor.mjs";
+const CLAUDE_HOOK_COMMAND = "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/react-doctor.mjs\"";
 const CURSOR_HOOKS_RELATIVE_PATH = ".cursor/hooks.json";
-const CURSOR_HOOK_RELATIVE_PATH = ".cursor/hooks/react-doctor.sh";
+const CURSOR_HOOK_RELATIVE_PATH = ".cursor/hooks/react-doctor.mjs";
+const CURSOR_HOOK_COMMAND = "node .cursor/hooks/react-doctor.mjs";
 const CURSOR_HOOK_MATCHER = "Write|Edit|MultiEdit|ApplyPatch";
 const CURSOR_HOOKS_SCHEMA_VERSION = 1;
 const isSupportedAgent = (agent) => agent === CLAUDE_AGENT || agent === CURSOR_AGENT;
@@ -52288,7 +52302,6 @@ const writeJsonFileWithDirectoryCheck = (filePath, value) => {
 const writeHookScript = (filePath) => {
 	ensureDirectoryExists(Path.dirname(filePath));
 	NFS.writeFileSync(filePath, buildAgentHookScript());
-	NFS.chmodSync(filePath, 493);
 };
 const hasClaudeHookCommand = (groups) => groups.some((group) => (group.hooks ?? []).some((hook) => hook.command === CLAUDE_HOOK_COMMAND));
 const installClaudeHook = (projectRoot) => {
@@ -52309,7 +52322,7 @@ const installClaudeHook = (projectRoot) => {
 	writeHookScript(hookPath);
 	return [settingsPath, hookPath];
 };
-const hasCursorHookCommand = (handlers) => handlers.some((handler) => handler.command === CURSOR_HOOK_RELATIVE_PATH);
+const hasCursorHookCommand = (handlers) => handlers.some((handler) => handler.command === CURSOR_HOOK_COMMAND);
 const installCursorHook = (projectRoot) => {
 	const configPath = Path.join(projectRoot, CURSOR_HOOKS_RELATIVE_PATH);
 	const hookPath = Path.join(projectRoot, CURSOR_HOOK_RELATIVE_PATH);
@@ -52317,7 +52330,7 @@ const installCursorHook = (projectRoot) => {
 	const hooks = { ...config.hooks ?? {} };
 	const postToolUseHooks = [...hooks.postToolUse ?? []];
 	if (!hasCursorHookCommand(postToolUseHooks)) postToolUseHooks.push({
-		command: CURSOR_HOOK_RELATIVE_PATH,
+		command: CURSOR_HOOK_COMMAND,
 		matcher: CURSOR_HOOK_MATCHER,
 		timeout: 120
 	});
@@ -52331,102 +52344,111 @@ const installCursorHook = (projectRoot) => {
 	return [configPath, hookPath];
 };
 const buildAgentHookScript = () => [
-	"#!/bin/sh",
-	"set -u",
+	"import { readFileSync, writeFileSync, unlinkSync } from 'node:fs';",
+	"import { tmpdir } from 'node:os';",
+	"import { join, dirname } from 'node:path';",
+	"import { fileURLToPath } from 'node:url';",
+	"import { spawnSync } from 'node:child_process';",
 	"",
-	"input_file=$(mktemp \"${TMPDIR:-/tmp}/react-doctor-agent-hook.XXXXXX\")",
-	"output_file=$(mktemp \"${TMPDIR:-/tmp}/react-doctor-agent-hook-output.XXXXXX\")",
-	"trap 'rm -f \"$input_file\" \"$output_file\"' EXIT",
-	"cat > \"$input_file\"",
+	"const __filename = fileURLToPath(import.meta.url);",
+	"const __dirname = dirname(__filename);",
 	"",
-	"script_dir=$(CDPATH= cd \"$(dirname \"$0\")\" && pwd)",
-	"project_root=${CLAUDE_PROJECT_DIR:-}",
-	"if [ -z \"$project_root\" ]; then",
-	"  project_root=$(CDPATH= cd \"$script_dir/../..\" && pwd)",
-	"fi",
-	"if ! cd \"$project_root\"; then",
-	"  exit 0",
-	"fi",
+	"const EDIT_TOOL_NAMES = new Set(['Edit', 'Write', 'MultiEdit', 'NotebookEdit', 'ApplyPatch']);",
 	"",
-	"should_scan() {",
-	"  if ! command -v node >/dev/null 2>&1; then",
-	"    return 0",
-	"  fi",
+	"const readStdin = () => {",
+	"  try {",
+	"    return readFileSync(0, 'utf8');",
+	"  } catch {",
+	"    return '';",
+	"  }",
+	"};",
 	"",
-	"  node - \"$input_file\" <<'NODE'",
-	"const fs = require('node:fs');",
-	"const inputPath = process.argv[2];",
-	"const editToolNames = new Set(['Edit', 'Write', 'MultiEdit', 'NotebookEdit', 'ApplyPatch']);",
-	"try {",
-	"  const input = JSON.parse(fs.readFileSync(inputPath, 'utf8') || '{}');",
+	"const shouldScan = (input) => {",
 	"  const eventName = input.hook_event_name || input.eventName || input.event_name;",
 	"  if (eventName === 'PostToolBatch') {",
 	"    const toolCalls = Array.isArray(input.tool_calls) ? input.tool_calls : [];",
-	"    process.exit(toolCalls.some((toolCall) => editToolNames.has(toolCall.tool_name)) ? 0 : 10);",
+	"    return toolCalls.some((toolCall) => EDIT_TOOL_NAMES.has(toolCall.tool_name));",
 	"  }",
 	"  const toolName = input.tool_name || input.toolName || input.tool;",
-	"  process.exit(!toolName || editToolNames.has(toolName) ? 0 : 10);",
-	"} catch {",
-	"  process.exit(0);",
-	"}",
-	"NODE",
-	"}",
+	"  return !toolName || EDIT_TOOL_NAMES.has(toolName);",
+	"};",
 	"",
-	"run_react_doctor() {",
-	"  if [ -x ./node_modules/.bin/react-doctor ]; then",
-	"    ./node_modules/.bin/react-doctor --verbose --scope changed --blocking warning --no-score",
-	"    return",
-	"  fi",
+	"const runReactDoctor = (outputPath) => {",
+	"  // Each candidate is a single shell command string (not an args array):",
+	"  // `shell: true` is required to run the Windows `.cmd` shims, and an args",
+	"  // array with `shell: true` trips Node's DEP0190. A missing command exits",
+	"  // 127 via the shell (no ENOENT error), so fall through on that. With no",
+	"  // runner found, exit 0 silently — stdout is parsed as the hook's JSON.",
+	"  const commands = [",
+	"    './node_modules/.bin/react-doctor --verbose --scope changed --blocking warning --no-score',",
+	"    'react-doctor --verbose --scope changed --blocking warning --no-score',",
+	"    'pnpm dlx react-doctor@latest --verbose --scope changed --blocking warning --no-score',",
+	"    'npx --yes react-doctor@latest --verbose --scope changed --blocking warning --no-score',",
+	"  ];",
 	"",
-	"  if command -v react-doctor >/dev/null 2>&1; then",
-	"    react-doctor --verbose --scope changed --blocking warning --no-score",
-	"    return",
-	"  fi",
+	"  for (const command of commands) {",
+	"    const result = spawnSync(command, { encoding: 'utf8', shell: true });",
+	"    if (result.error?.code === 'ENOENT' || result.status === 127) continue;",
+	"    try {",
+	"      writeFileSync(outputPath, (result.stdout || '') + (result.stderr || ''));",
+	"    } catch {}",
+	"    return result.status;",
+	"  }",
 	"",
-	"  if command -v pnpm >/dev/null 2>&1; then",
-	"    pnpm dlx react-doctor@latest --verbose --scope changed --blocking warning --no-score",
-	"    return",
-	"  fi",
+	"  return 0;",
+	"};",
 	"",
-	"  if command -v npx >/dev/null 2>&1; then",
-	"    npx --yes react-doctor@latest --verbose --scope changed --blocking warning --no-score",
-	"    return",
-	"  fi",
+	"const cleanup = (...paths) => {",
+	"  for (const path of paths) {",
+	"    try { unlinkSync(path); } catch {}",
+	"  }",
+	"};",
 	"",
-	"  printf '%s\\n' 'react-doctor: command not found; skipping agent hook scan.'",
-	"  return 0",
-	"}",
+	"const main = () => {",
+	"  let input;",
+	"  try {",
+	"    const stdinContent = readStdin();",
+	"    input = JSON.parse(stdinContent || '{}');",
+	"  } catch {",
+	"    input = {};",
+	"  }",
 	"",
-	"if ! should_scan; then",
-	"  exit 0",
-	"fi",
+	"  if (!shouldScan(input)) {",
+	"    process.exit(0);",
+	"  }",
 	"",
-	"if run_react_doctor > \"$output_file\" 2>&1; then",
-	"  exit 0",
-	"fi",
+	"  const projectRoot = process.env.CLAUDE_PROJECT_DIR || join(__dirname, '../..');",
+	"  const outputPath = join(tmpdir(), `react-doctor-agent-hook-output-${process.pid}.txt`);",
 	"",
-	"node - \"$input_file\" \"$output_file\" <<'NODE'",
-	"const fs = require('node:fs');",
-	"const inputPath = process.argv[2];",
-	"const outputPath = process.argv[3];",
-	"const readInput = () => {",
 	"  try {",
-	"    return JSON.parse(fs.readFileSync(inputPath, 'utf8') || '{}');",
+	"    process.chdir(projectRoot);",
 	"  } catch {",
-	"    return {};",
+	"    process.exit(0);",
+	"  }",
+	"",
+	"  const scanResult = runReactDoctor(outputPath);",
+	"  if (scanResult === 0) {",
+	"    cleanup(outputPath);",
+	"    process.exit(0);",
+	"  }",
+	"",
+	"  const scanOutput = readFileSync(outputPath, 'utf8').trim();",
+	"  cleanup(outputPath);",
+	"",
+	"  if (!scanOutput) {",
+	"    process.exit(0);",
+	"  }",
+	"",
+	"  const message = `React Doctor found issues in the changed files. Review this output and fix the regressions before finishing. For confirmed issues that cannot be fixed now, create GitHub issues with the rule, file/line, confidence, impact, and proposed fix.\\n\\n${scanOutput}`;",
+	"",
+	"  if (input.hook_event_name === 'PostToolBatch') {",
+	"    console.log(JSON.stringify({ hookSpecificOutput: { hookEventName: 'PostToolBatch', additionalContext: message } }));",
+	"  } else {",
+	"    console.log(JSON.stringify({ additional_context: message }));",
 	"  }",
 	"};",
-	"const input = readInput();",
-	"const scanOutput = fs.readFileSync(outputPath, 'utf8').trim();",
-	"if (!scanOutput) process.exit(0);",
-	"const message = `React Doctor found issues in the changed files. Review this output and fix the regressions before finishing. For confirmed issues that cannot be fixed now, create GitHub issues with the rule, file/line, confidence, impact, and proposed fix.\\n\\n${scanOutput}`;",
-	"if (input.hook_event_name === 'PostToolBatch') {",
-	"  console.log(JSON.stringify({ hookSpecificOutput: { hookEventName: 'PostToolBatch', additionalContext: message } }));",
-	"} else {",
-	"  console.log(JSON.stringify({ additional_context: message }));",
-	"}",
-	"NODE",
-	""
+	"",
+	"main();"
 ].join("\n");
 const installReactDoctorAgentHooks = (options) => {
 	const installedAgents = [];
@@ -52487,6 +52509,7 @@ const buildReactDoctorHookBlock = () => [
 	"if react_doctor_scan_staged_files > \"$react_doctor_output\" 2>&1; then",
 	"  rm -f \"$react_doctor_output\"",
 	"else",
+	"  cat \"$react_doctor_output\" >&2",
 	"  rm -f \"$react_doctor_output\"",
 	`  printf '%s\\n' "React Doctor found staged regressions." "Run ${REACT_DOCTOR_COMMAND} to inspect." "Want them fixed? Ask your agent to run that command and resolve the findings." >&2`,
 	"fi",
@@ -53252,6 +53275,26 @@ const CLI_AGENT_AUTO_FLAGS = {
 	codex: ["--yolo"],
 	cursor: ["--force"]
 };
+const resolveCursorBundledNode = () => {
+	if (!isWindows) return null;
+	const localAppData = process.env.LOCALAPPDATA;
+	if (!localAppData) return null;
+	const cursorAgentRoot = Path.join(localAppData, "cursor-agent", "versions");
+	try {
+		const versions = NFS.readdirSync(cursorAgentRoot);
+		if (versions.length === 0) return null;
+		const sortedVersions = versions.sort((a, b) => b.localeCompare(a, void 0, { numeric: true }));
+		for (const version of sortedVersions) try {
+			const bundledNodePath = Path.join(cursorAgentRoot, version, "node.exe");
+			const entryScriptPath = Path.join(cursorAgentRoot, version, "index.js");
+			if (NFS.statSync(bundledNodePath).isFile() && NFS.statSync(entryScriptPath).isFile()) return {
+				command: bundledNodePath,
+				args: [entryScriptPath]
+			};
+		} catch {}
+	} catch {}
+	return null;
+};
 const resolveWindowsCmdEntryScript = (command) => {
 	if (!isWindows) return null;
 	const pathDirectories = (process.env.PATH ?? "").split(Path.delimiter).filter(Boolean);
@@ -53271,11 +53314,10 @@ const resolveWindowsCmdEntryScript = (command) => {
 	}
 	return null;
 };
-const spawnAgent = (command, args, cwd, shell = false) => new Promise((resolve, reject) => {
+const spawnAgent = (command, args, cwd) => new Promise((resolve, reject) => {
 	const child = spawn(command, [...args], {
 		cwd,
-		stdio: "inherit",
-		shell
+		stdio: "inherit"
 	});
 	child.on("error", reject);
 	child.on("close", (code) => resolve(code ?? 0));
@@ -53284,6 +53326,10 @@ const launchCliAgent = async (agentId, prompt, cwd) => {
 	const binary = CLI_AGENT_BINARIES[agentId];
 	const agentArgs = [...CLI_AGENT_AUTO_FLAGS[agentId], prompt];
 	if (isWindows) {
+		if (agentId === "cursor") {
+			const cursorResolution = resolveCursorBundledNode();
+			if (cursorResolution) return spawnAgent(cursorResolution.command, [...cursorResolution.args, ...agentArgs], cwd);
+		}
 		const entryScript = resolveWindowsCmdEntryScript(binary);
 		if (entryScript) return spawnAgent(process.execPath, [entryScript, ...agentArgs], cwd);
 	}
@@ -54396,10 +54442,14 @@ const inspectAction = async (directory, flags) => {
 	const isQuiet = isScoreOnly || isJsonMode;
 	const requestedDirectory = Path.resolve(directory);
 	const startTime = performance$1.now();
-	if (isJsonMode) enableJsonMode({
-		compact: Boolean(flags.jsonCompact),
-		directory: requestedDirectory
-	});
+	if (isJsonMode) {
+		enableJsonMode({
+			compact: Boolean(flags.jsonCompact),
+			directory: requestedDirectory,
+			outputFile: flags.jsonOut
+		});
+		if (flags.jsonOut) recordCount(METRIC.jsonOutUsed, 1);
+	}
 	recordCount(METRIC.cliInvoked, 1, { command: "inspect" });
 	try {
 		validateModeFlags(flags);
@@ -55337,6 +55387,14 @@ const applyColorPreference = (argv, env = process.env) => {
 	setColorEnabled(enabled);
 };
 //#endregion
+//#region src/cli/utils/ensure-windows-utf8-console.ts
+const ensureWindowsUtf8Console = () => {
+	if (process.platform !== "win32" || !process.stdout.isTTY) return;
+	try {
+		execFileSync("chcp.com", ["65001"], { stdio: "ignore" });
+	} catch {}
+};
+//#endregion
 //#region src/cli/utils/exit-gracefully.ts
 const exitGracefully = () => {
 	try {
@@ -55479,6 +55537,7 @@ const ROOT_FLAG_SPEC = {
 		"--category",
 		"--changed-files-from",
 		"--blocking",
+		"--json-out",
 		"--output-dir",
 		"--fail-on",
 		"--project",
@@ -55669,7 +55728,7 @@ ${highlighter.dim("Learn more:")}
   ${highlighter.info(CANONICAL_GITHUB_URL)}
 `;
 const collectCategoryOption = (value, previousValues) => [...previousValues ?? [], value];
-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("--debug", "force a Sentry trace and print its id at the end (paste it into a bug report)").option("--output-dir <dir>", "directory for the full diagnostics dump (default: a temp folder)").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("--no-parallel", "lint serially with one worker (default: parallel across CPU cores; set the worker count with REACT_DOCTOR_PARALLEL)").option("--project <name>", "select projects: workspace names or directory paths (comma-separated for multiple); overrides the `projects` config field").option("--scope <value>", "how much to scan/report: full (default), files, changed (only new issues vs base), or lines (only changed lines)").option("--base <ref>", "base git ref for files/changed/lines scope (auto-detected when omitted)").addOption(new Option("--diff [base]", "[deprecated] alias for --scope changed (pass `false` to force a full scan)").hideHelp()).addOption(new Option("--changed-files-from <file>", "scan source files listed in a newline-delimited changed-files file").hideHelp()).option("--no-score", "skip the score API, the share URL, and crash reporting").addOption(new Option("--category <category>", "only show diagnostics in a category (repeatable; e.g. Security)").argParser(collectCategoryOption)).option("--no-telemetry", "alias for --no-score (skip the score API, share URL, and crash reporting)").option("--staged", "scan only staged (git index) files for pre-commit hooks").option("--blocking <level>", "severity that fails CI: error (default), warning, or none (advisory)").addOption(new Option("--fail-on <level>", "[deprecated] alias for --blocking <level>").hideHelp()).option("--no-respect-inline-disables", "audit mode: neutralize inline lint suppressions before scanning").option("--warnings", "show warning-severity diagnostics (default)").option("--no-warnings", "hide warning-severity diagnostics (errors only)").option("--color", "force colored output").option("--no-color", "disable colored output (also honors NO_COLOR)").addHelpText("after", renderRootHelpEpilog);
+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("--debug", "force a Sentry trace and print its id at the end (paste it into a bug report)").option("--output-dir <dir>", "directory for the full diagnostics dump (default: a temp folder)").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("--json-out <path>", "with --json, write the report to a file instead of stdout").option("-y, --yes", "skip prompts, scan all workspace projects").option("--no-parallel", "lint serially with one worker (default: parallel across CPU cores; set the worker count with REACT_DOCTOR_PARALLEL)").option("--project <name>", "select projects: workspace names or directory paths (comma-separated for multiple); overrides the `projects` config field").option("--scope <value>", "how much to scan/report: full (default), files, changed (only new issues vs base), or lines (only changed lines)").option("--base <ref>", "base git ref for files/changed/lines scope (auto-detected when omitted)").addOption(new Option("--diff [base]", "[deprecated] alias for --scope changed (pass `false` to force a full scan)").hideHelp()).addOption(new Option("--changed-files-from <file>", "scan source files listed in a newline-delimited changed-files file").hideHelp()).option("--no-score", "skip the score API, the share URL, and crash reporting").addOption(new Option("--category <category>", "only show diagnostics in a category (repeatable; e.g. Security)").argParser(collectCategoryOption)).option("--no-telemetry", "alias for --no-score (skip the score API, share URL, and crash reporting)").option("--staged", "scan only staged (git index) files for pre-commit hooks").option("--blocking <level>", "severity that fails CI: error (default), warning, or none (advisory)").addOption(new Option("--fail-on <level>", "[deprecated] alias for --blocking <level>").hideHelp()).option("--no-respect-inline-disables", "audit mode: neutralize inline lint suppressions before scanning").option("--warnings", "show warning-severity diagnostics (default)").option("--no-warnings", "hide warning-severity diagnostics (errors only)").option("--color", "force colored output").option("--no-color", "disable colored output (also honors NO_COLOR)").addHelpText("after", renderRootHelpEpilog);
 program.action(inspectAction);
 program.command("why <location>").description("Explain why a rule fired (or why a suppression didn't apply) at a file:line").option("--project <name>", "select projects: workspace names or directory paths (comma-separated for multiple)").option("-c, --cwd <cwd>", "working directory", process.cwd()).option("--color", "force colored output").option("--no-color", "disable colored output (also honors NO_COLOR)").action((location, options) => whyAction(location, options));
 program.command("install").alias("setup").description("Install the react-doctor skill into your coding agents and optional git hook").option("-y, --yes", "skip prompts, install for all detected agents").option("--dry-run", "show what would be installed without writing files").option("--agent-hooks", "install native non-blocking agent hooks for Claude Code and Cursor").option("-c, --cwd <cwd>", "working directory", process.cwd()).option("--color", "force colored output").option("--no-color", "disable colored output (also honors NO_COLOR)").addHelpText("after", renderInstallHelpEpilog).action(installAction);
@@ -55694,6 +55753,7 @@ if (process.argv.includes("-V") && !strippedArgv.includes("-V")) {
 	process.exit(0);
 }
 applyColorPreference(strippedArgv);
+ensureWindowsUtf8Console();
 const argv = normalizeHelpInvocation(strippedArgv, knownCommands);
 Promise.resolve().then(() => assertNoRemovedFlags(process.argv)).then(() => program.parseAsync(argv)).then(() => flushSentry()).catch(async (error) => {
 	const isUserError = isExpectedUserError(error);
@@ -55712,4 +55772,4 @@ Promise.resolve().then(() => assertNoRemovedFlags(process.argv)).then(() => prog
 export {};
 
 //# sourceMappingURL=cli.js.map
-//# debugId=bd31e7dc-cfca-56b2-a963-9d798b3cbbe5
+//# debugId=1e81c0a2-fd08-5f5b-ba28-bd5f7587e0f4

package/dist/index.js

@@ -1,5 +1,5 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="9807b1bf-1e62-5421-ad35-d1f4129c1538")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="faa2d232-c423-58f8-97f4-ba8d41a199d7")}catch(e){}}();
 import { r as __toESM$1, t as __commonJSMin$1 } from "./chunk-N93fKeF6.js";
 import { createRequire } from "node:module";
 import * as NFS from "node:fs";
@@ -37290,6 +37290,11 @@ const toCanonicalPath = (filePath) => {
 };
 const DEAD_CODE_PLUGIN = "deslop";
 const DEAD_CODE_CATEGORY = "Maintainability";
+const REACT_DOCTOR_TOOLCHAIN_PACKAGES = new Set([
+	"react-doctor",
+	"eslint-plugin-react-doctor",
+	"oxlint-plugin-react-doctor"
+]);
 const DEAD_CODE_WORKER_SCRIPT = `
 const inputChunks = [];
 process.stdin.on("data", (chunk) => inputChunks.push(chunk));
@@ -37595,6 +37600,7 @@ const checkDeadCode = async (options) => {
 		});
 	}
 	for (const unusedDependency of result.unusedDependencies) {
+		if (REACT_DOCTOR_TOOLCHAIN_PACKAGES.has(unusedDependency.name)) continue;
 		const label = unusedDependency.isDevDependency ? "devDependency" : "dependency";
 		diagnostics.push({
 			filePath: "package.json",
@@ -41645,4 +41651,4 @@ const toJsonReport = (result, options) => buildJsonReport({
 export { AmbiguousProjectError, NoReactDependencyError, NotADirectoryError, PackageJsonNotFoundError, ProjectNotFoundError, ReactDoctorError, buildJsonReport, buildJsonReportError, clearCaches, defineConfig, diagnose, filterSourceFiles, getDiffInfo, isProjectDiscoveryError, isReactDoctorError, summarizeDiagnostics, toJsonReport };
 
 //# sourceMappingURL=index.js.map
-//# debugId=9807b1bf-1e62-5421-ad35-d1f4129c1538
+//# debugId=faa2d232-c423-58f8-97f4-ba8d41a199d7

package/dist/lsp.js

@@ -37275,6 +37275,11 @@ const toCanonicalPath = (filePath) => {
 };
 const DEAD_CODE_PLUGIN = "deslop";
 const DEAD_CODE_CATEGORY = "Maintainability";
+const REACT_DOCTOR_TOOLCHAIN_PACKAGES = new Set([
+	"react-doctor",
+	"eslint-plugin-react-doctor",
+	"oxlint-plugin-react-doctor"
+]);
 const DEAD_CODE_WORKER_SCRIPT = `
 const inputChunks = [];
 process.stdin.on("data", (chunk) => inputChunks.push(chunk));
@@ -37580,6 +37585,7 @@ const checkDeadCode = async (options) => {
 		});
 	}
 	for (const unusedDependency of result.unusedDependencies) {
+		if (REACT_DOCTOR_TOOLCHAIN_PACKAGES.has(unusedDependency.name)) continue;
 		const label = unusedDependency.isDevDependency ? "devDependency" : "dependency";
 		diagnostics.push({
 			filePath: "package.json",
@@ -43047,7 +43053,8 @@ const METRIC = {
 	lspScanCompleted: "lsp.scan.completed",
 	lspScanDuration: "lsp.scan.duration",
 	lspScanDiagnostics: "lsp.scan.diagnostics",
-	aiTrainingWarningShown: "ai.training.warning_shown"
+	aiTrainingWarningShown: "ai.training.warning_shown",
+	jsonOutUsed: "json.out_used"
 };
 //#endregion
 //#region src/cli/utils/to-category-key.ts
@@ -43364,5 +43371,5 @@ const startLanguageServer = () => {
 };
 //#endregion
 export { startLanguageServer };
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="b3c6b2e5-253e-5be2-aacb-bd57bbb3e5e6")}catch(e){}}();
-//# debugId=b3c6b2e5-253e-5be2-aacb-bd57bbb3e5e6
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="47940f68-872d-59ed-bdd2-40ef7848566c")}catch(e){}}();
+//# debugId=47940f68-872d-59ed-bdd2-40ef7848566c

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-doctor",
-  "version": "0.5.8-dev.b69f4a7",
+  "version": "0.5.8-dev.b6d1a87",
   "description": "Your agent writes bad React. This catches it",
   "keywords": [
     "accessibility",
@@ -60,12 +60,12 @@
     "magicast": "^0.5.3",
     "oxlint": ">=1.66.0 <1.67.0",
     "prompts": "^2.4.2",
-    "typescript": ">=5.0.4 <7",
+    "typescript": ">=5.0.4 <6",
     "vscode-languageserver": "^9.0.1",
     "vscode-languageserver-textdocument": "^1.0.12",
     "vscode-uri": "^3.1.0",
     "deslop-js": "0.5.8",
-    "oxlint-plugin-react-doctor": "0.5.8-dev.b69f4a7"
+    "oxlint-plugin-react-doctor": "0.5.8-dev.b6d1a87"
   },
   "devDependencies": {
     "@types/babel__code-frame": "^7.27.0",