react-doctor 0.9.12-dev.bd08406 → 0.9.12-dev.ca30808

package/README.md

@@ -25,6 +25,12 @@ Run this at your project root to get an audit.
 npx react-doctor@latest
 ```
 
+Pass file paths to scan only the files that another CI step selected.
+
+```bash
+npx react-doctor@latest src/a.tsx src/b.tsx
+```
+
 https://github.com/user-attachments/assets/07cc88d9-9589-44c3-aa73-5d603cb1c570
 
 ### 2. Install for agents

package/dist/{build-section-divider-DjX3mmIx.js → build-section-divider-DGcPvzjX.js}

@@ -1,7 +1,7 @@
 
-!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]="f08c080e-5c10-5b8b-ac69-a02cccde630c")}catch(e){}}();
-import { Kt as highlighter, N as SENTRY_FLUSH_TIMEOUT_MS, a as isEnvFlagEnabled, er as CANONICAL_GITHUB_URL, ft as anonymizeInPlace, hn as scrubSensitivePaths, i as isTelemetryEnabled, o as buildSentryScope, or as DOCS_URL, pt as anonymizeText } from "./record-metric-CECbS8Qh.js";
-import { r as isExpectedUserError } from "./telemetry-runtime-DVy10F6G.js";
+!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]="34d68399-4e64-5d03-9e6b-911657576a32")}catch(e){}}();
+import { Kt as highlighter, N as SENTRY_FLUSH_TIMEOUT_MS, a as isEnvFlagEnabled, er as CANONICAL_GITHUB_URL, ft as anonymizeInPlace, hn as scrubSensitivePaths, i as isTelemetryEnabled, o as buildSentryScope, or as DOCS_URL, pt as anonymizeText } from "./record-metric-BzGcVSov.js";
+import { r as isExpectedUserError } from "./telemetry-runtime-Bs7DsGaF.js";
 import * as Sentry from "@sentry/node";
 //#region src/cli/utils/scrub-sentry-event.ts
 /**
@@ -70,13 +70,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.9.12-dev.bd08406`;
+const resolveSentryRelease = () => process.env.SENTRY_RELEASE || `react-doctor@0.9.12-dev.ca30808`;
 /**
 * 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.9.12-dev.bd08406") ? "development" : "production");
+const resolveSentryEnvironment = () => process.env.SENTRY_ENVIRONMENT || (isDevVersion("0.9.12-dev.ca30808") ? "development" : "production");
 //#endregion
 //#region src/instrument.ts
 let isInitialized = false;
@@ -212,5 +212,5 @@ const buildSectionDivider = () => highlighter.dim(`${DIVIDER_INDENT}${"─".repe
 //#endregion
 export { initializeSentry as i, buildFooterLinkLines as n, flushSentry as r, buildSectionDivider as t };
 
-//# sourceMappingURL=build-section-divider-DjX3mmIx.js.map
-//# debugId=f08c080e-5c10-5b8b-ac69-a02cccde630c
+//# sourceMappingURL=build-section-divider-DGcPvzjX.js.map
+//# debugId=34d68399-4e64-5d03-9e6b-911657576a32

package/dist/{ci-D0OU7_5i.js → ci-DZ9QnUV4.js}

@@ -1,15 +1,15 @@
 
-!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]="ecaf2c6d-566a-50d3-9aa6-85f2c0ddaeb4")}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]="edef111d-bacd-5bdf-9d46-5c90cee1a43e")}catch(e){}}();
 import { i as __toESM, r as __require, t as __commonJSMin } from "./chunk-ChKA3wi6.js";
-import { Kt as highlighter, T as METRIC, cr as GITHUB_ACTIONS_SETUP_URL, t as recordCount, tr as CI_URL, zn as runSync } from "./record-metric-CECbS8Qh.js";
-import { r as isExpectedUserError } from "./telemetry-runtime-DVy10F6G.js";
-import { n as handleUserError, t as handleError } from "./handle-error-BzC_gVSx.js";
-import { t as reportErrorToSentry } from "./report-error-Ckftf8UM.js";
-import { N as cliLogger, c as spinner, n as findNearestPackageDirectory } from "./install-doctor-script-W-u3DPjZ.js";
-import { a as readReactDoctorWorkflow, d as detectDefaultBranch, f as runCommand, l as prompts, n as getReactDoctorWorkflowPath, s as upgradeWorkflowActionToV2, t as buildWorkflowContent } from "./install-github-workflow-DqodeftR.js";
-import { a as isValidBlockingLevel, c as openWorkflowPullRequest, l as stageWorkflowFile, n as isScopeValue } from "./resolve-scope-IDn0nWJF.js";
-import { t as shouldSkipPrompts } from "./should-skip-prompts-DwpFmYZZ.js";
-import { t as printBrandedHeader } from "./print-branded-header-eiCaprox.js";
+import { Kt as highlighter, T as METRIC, cr as GITHUB_ACTIONS_SETUP_URL, t as recordCount, tr as CI_URL, zn as runSync } from "./record-metric-BzGcVSov.js";
+import { r as isExpectedUserError } from "./telemetry-runtime-Bs7DsGaF.js";
+import { n as handleUserError, t as handleError } from "./handle-error-Cslt8b7C.js";
+import { t as reportErrorToSentry } from "./report-error-ZMTPN93d.js";
+import { M as cliLogger, c as spinner, n as findNearestPackageDirectory } from "./install-doctor-script-DbKR-GHo.js";
+import { a as readReactDoctorWorkflow, d as detectDefaultBranch, f as runCommand, l as prompts, n as getReactDoctorWorkflowPath, s as upgradeWorkflowActionToV2, t as buildWorkflowContent } from "./install-github-workflow-Bkv_CMdF.js";
+import { a as isValidBlockingLevel, c as openWorkflowPullRequest, l as stageWorkflowFile, n as isScopeValue } from "./resolve-scope-BgrQEVtj.js";
+import { t as shouldSkipPrompts } from "./should-skip-prompts-F0NaNR8z.js";
+import { t as printBrandedHeader } from "./print-branded-header-CFNvp2ey.js";
 import * as path$1 from "node:path";
 import * as fs$1 from "node:fs";
 //#region src/cli/utils/ci/ci-provider.ts
@@ -7498,5 +7498,5 @@ const ciConfigAction = (options) => runCiCommand("config", runCiConfig, options)
 //#endregion
 export { ciConfigAction, ciInstallAction, ciUpgradeAction };
 
-//# sourceMappingURL=ci-D0OU7_5i.js.map
-//# debugId=ecaf2c6d-566a-50d3-9aa6-85f2c0ddaeb4
+//# sourceMappingURL=ci-DZ9QnUV4.js.map
+//# debugId=edef111d-bacd-5bdf-9d46-5c90cee1a43e

package/dist/cli.js

@@ -1,15 +1,17 @@
 
-!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]="060d9fda-090f-56c0-a01c-3ce99371376f")}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]="2db05473-003e-52a5-853a-90e4f4f5ac96")}catch(e){}}();
 import { i as __toESM, r as __require, t as __commonJSMin } from "./chunk-ChKA3wi6.js";
-import { H as isDebugFlagEnabled, Kt as highlighter, _ as VERSION, d as isJsonModeActive, er as CANONICAL_GITHUB_URL, gn as setColorEnabled, h as writeJsonErrorReport, i as isTelemetryEnabled, tr as CI_URL, z as CliInputError } from "./record-metric-CECbS8Qh.js";
-import { n as shutdownTelemetry, r as isExpectedUserError } from "./telemetry-runtime-DVy10F6G.js";
-import { i as initializeSentry, r as flushSentry } from "./build-section-divider-DjX3mmIx.js";
-import { t as exitGracefully } from "./exit-gracefully-DuS_nzeq.js";
-import { n as handleUserError, t as handleError } from "./handle-error-BzC_gVSx.js";
+import { H as isDebugFlagEnabled, Jt as isPathInsideDirectory, Kt as highlighter, Nt as filterSourceFiles, _ as VERSION, d as isJsonModeActive, er as CANONICAL_GITHUB_URL, gn as setColorEnabled, h as writeJsonErrorReport, i as isTelemetryEnabled, tr as CI_URL, xr as isFile, yr as isDirectory, z as CliInputError } from "./record-metric-BzGcVSov.js";
+import { n as shutdownTelemetry, r as isExpectedUserError } from "./telemetry-runtime-Bs7DsGaF.js";
+import { i as initializeSentry, r as flushSentry } from "./build-section-divider-DGcPvzjX.js";
+import { t as exitGracefully } from "./exit-gracefully-Dt1ix6Xh.js";
+import { n as handleUserError, t as handleError } from "./handle-error-Cslt8b7C.js";
 import { n as getLastRunTraceId } from "./active-run-trace-dlIZeEvb.js";
-import { t as reportErrorToSentry } from "./report-error-Ckftf8UM.js";
-import { t as unrefStdin } from "./unref-stdin-BKT_s38a.js";
+import { t as reportErrorToSentry } from "./report-error-ZMTPN93d.js";
+import { t as toForwardSlashes } from "./path-format-DnHpmJwG.js";
+import { t as unrefStdin } from "./unref-stdin-SK3WfwxS.js";
 import { execFileSync } from "node:child_process";
+import * as path$1 from "node:path";
 //#region ../../node_modules/.pnpm/commander@14.0.3/node_modules/commander/lib/error.js
 var require_error = /* @__PURE__ */ __commonJSMin(((exports) => {
 	/**
@@ -1026,7 +1028,7 @@ var require_suggestSimilar = /* @__PURE__ */ __commonJSMin(((exports) => {
 var require_command = /* @__PURE__ */ __commonJSMin(((exports) => {
 	const EventEmitter = __require("node:events").EventEmitter;
 	const childProcess = __require("node:child_process");
-	const path = __require("node:path");
+	const path$2 = __require("node:path");
 	const fs = __require("node:fs");
 	const process$1 = __require("node:process");
 	const { Argument, humanReadableArgName } = require_argument();
@@ -1946,9 +1948,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
 				".cjs"
 			];
 			function findFile(baseDir, baseName) {
-				const localBin = path.resolve(baseDir, baseName);
+				const localBin = path$2.resolve(baseDir, baseName);
 				if (fs.existsSync(localBin)) return localBin;
-				if (sourceExt.includes(path.extname(baseName))) return void 0;
+				if (sourceExt.includes(path$2.extname(baseName))) return void 0;
 				const foundExt = sourceExt.find((ext) => fs.existsSync(`${localBin}${ext}`));
 				if (foundExt) return `${localBin}${foundExt}`;
 			}
@@ -1963,17 +1965,17 @@ Expecting one of '${allowedValues.join("', '")}'`);
 				} catch {
 					resolvedScriptPath = this._scriptPath;
 				}
-				executableDir = path.resolve(path.dirname(resolvedScriptPath), executableDir);
+				executableDir = path$2.resolve(path$2.dirname(resolvedScriptPath), executableDir);
 			}
 			if (executableDir) {
 				let localFile = findFile(executableDir, executableFile);
 				if (!localFile && !subcommand._executableFile && this._scriptPath) {
-					const legacyName = path.basename(this._scriptPath, path.extname(this._scriptPath));
+					const legacyName = path$2.basename(this._scriptPath, path$2.extname(this._scriptPath));
 					if (legacyName !== this._name) localFile = findFile(executableDir, `${legacyName}-${subcommand._name}`);
 				}
 				executableFile = localFile || executableFile;
 			}
-			launchWithNode = sourceExt.includes(path.extname(executableFile));
+			launchWithNode = sourceExt.includes(path$2.extname(executableFile));
 			let proc;
 			if (process$1.platform !== "win32") if (launchWithNode) {
 				args.unshift(executableFile);
@@ -2741,7 +2743,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
 		* @return {Command}
 		*/
 		nameFromFilename(filename) {
-			this._name = path.basename(filename, path.extname(filename));
+			this._name = path$2.basename(filename, path$2.extname(filename));
 			return this;
 		}
 		/**
@@ -3173,6 +3175,31 @@ const assertNoRemovedFlags = (argv) => {
 	}
 };
 //#endregion
+//#region src/cli/utils/resolve-positional-scan-input.ts
+const resolvePositionalScanInput = (positionalPaths, currentDirectory = process.cwd()) => {
+	const absoluteCurrentDirectory = path$1.resolve(currentDirectory);
+	if (positionalPaths.length === 0) return {
+		directory: absoluteCurrentDirectory,
+		filePaths: void 0
+	};
+	const onlyAbsolutePath = path$1.resolve(absoluteCurrentDirectory, positionalPaths[0]);
+	if (positionalPaths.length === 1 && (isDirectory(onlyAbsolutePath) || !isFile(onlyAbsolutePath) && filterSourceFiles([positionalPaths[0]]).length === 0)) return {
+		directory: positionalPaths[0],
+		filePaths: void 0
+	};
+	const uniqueFilePaths = /* @__PURE__ */ new Set();
+	for (const positionalPath of positionalPaths) {
+		const absolutePath = path$1.resolve(absoluteCurrentDirectory, positionalPath);
+		if (isDirectory(absolutePath)) throw new CliInputError(`Cannot combine the directory "${positionalPath}" with file path arguments. Pass one directory or only file paths.`);
+		if (!isPathInsideDirectory(absolutePath, absoluteCurrentDirectory)) throw new CliInputError(`The file path "${positionalPath}" is outside the current directory. Run React Doctor from a common project root.`);
+		uniqueFilePaths.add(toForwardSlashes(path$1.relative(absoluteCurrentDirectory, absolutePath)));
+	}
+	return {
+		directory: absoluteCurrentDirectory,
+		filePaths: [...uniqueFilePaths]
+	};
+};
+//#endregion
 //#region src/cli/utils/strip-unknown-cli-flags.ts
 const ROOT_FLAG_SPEC = {
 	longOptionsWithoutValues: new Set([
@@ -3429,6 +3456,7 @@ ${highlighter.dim("Examples:")}
 ${formatExampleLines([
 	["react-doctor", "scan the current project"],
 	["react-doctor ./apps/web", "scan a specific directory"],
+	["react-doctor src/a.tsx src/b.tsx", "scan only selected files"],
 	["react-doctor scan http://localhost:3000", "profile one interaction in a running React app"],
 	["react-doctor --scope changed --base main", "scan only new issues vs. main"],
 	["react-doctor --project modules/a,modules/b", "score each module separately (names or paths)"],
@@ -3527,85 +3555,85 @@ ${highlighter.dim("Learn more:")}
   ${highlighter.info(CI_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").addOption(new Option("--dead-code").hideHelp()).addOption(new Option("--no-dead-code").hideHelp()).option("--supply-chain", "enable the dependency supply-chain scan (default)").option("--no-supply-chain", "skip the dependency supply-chain scan (Socket.dev dependency health checks)").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("--no-cache", "disable all scan caches for this run").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 supported JS/TS and inline HTML script source to scan/report: full (default), files, changed (only new issues vs base), or lines (issues whose source spans touch changed lines)").option("--base <ref>", "base git ref for files/changed/lines scope (auto-detected when omitted)").option("--include-untracked", "with --scope files/changed/lines, also scan ordinary untracked files (respects .gitignore)").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 (honors --project and config `projects`; exits 0 when nothing is staged)").option("--max-duration <seconds>", MAX_DURATION_OPTION_DESCRIPTION).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(async (directory = ".", flags) => {
-	const { runScanCommand } = await import("./scan-DtjqkKaM.js");
+const program = new Command().name("react-doctor").description("Diagnose React codebase health").version(VERSION, "-v, --version", "display the version number").argument("[paths...]", "one project directory or source file paths to scan").option("--lint", "enable linting").option("--no-lint", "skip linting").addOption(new Option("--dead-code").hideHelp()).addOption(new Option("--no-dead-code").hideHelp()).option("--supply-chain", "enable the dependency supply-chain scan (default)").option("--no-supply-chain", "skip the dependency supply-chain scan (Socket.dev dependency health checks)").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("--no-cache", "disable all scan caches for this run").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 supported JS/TS and inline HTML script source to scan/report: full (default), files, changed (only new issues vs base), or lines (issues whose source spans touch changed lines)").option("--base <ref>", "base git ref for files/changed/lines scope (auto-detected when omitted)").option("--include-untracked", "with --scope files/changed/lines, also scan ordinary untracked files (respects .gitignore)").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 (honors --project and config `projects`; exits 0 when nothing is staged)").option("--max-duration <seconds>", MAX_DURATION_OPTION_DESCRIPTION).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(async (positionalPaths = [], flags) => {
+	const { runScanCommand } = await import("./scan-CEvjogRY.js");
 	return runScanCommand({
-		directory,
+		...resolvePositionalScanInput(positionalPaths),
 		flags,
 		invocationCommand: "inspect"
 	});
 });
 program.command("design [directory]").description("Run only the focused UI design diagnostics").addHelpText("after", renderDesignHelpEpilog).action(async (directory, _options, command) => {
-	const { designAction } = await import("./design-D-9YrV4y.js");
+	const { designAction } = await import("./design-BlxQroSp.js");
 	return designAction(directory ?? ".", command.optsWithGlobals());
 });
 program.command("scan").description("Scan a React interaction in Chrome until you press Enter").argument("[url]", "HTTP(S) URL of the running React app; detects local apps when omitted").option("-f, --format <format>", "report format: text, json, or jsonl", "text").option("--cdp <url>", "reuse Chrome at this remote-debugging endpoint").option("--trace-out <path>", "save the compressed .json.gz DevTools trace at this path").addHelpText("after", renderRuntimeScanHelpEpilog).action(async (url, options) => {
-	const { runtimeScanAction } = await import("./runtime-scan-Dqqn1kW3.js");
+	const { runtimeScanAction } = await import("./runtime-scan-DINB89wl.js");
 	return runtimeScanAction(url, options);
 });
 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(async (location, options) => {
-	const { whyAction } = await import("./why-DnrSKh_M.js");
+	const { whyAction } = await import("./why-BqR3fLtE.js");
 	return 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 end-of-turn 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(async (options, command) => {
-	const { installAction } = await import("./install-BcGDtIYv.js");
+	const { installAction } = await import("./install-DeWeUjqr.js");
 	return installAction(options, command);
 });
 const providerOption = ["--provider <name>", "ci provider: github-actions or gitlab-ci (auto-detected by default)"];
 const prOption = ["--pr", "open a pull request with the change instead of writing it to the working tree"];
 const ci = program.command("ci").description("Set up, upgrade, and configure React Doctor in your CI");
 ci.command("install").description("Add a CI workflow that scans every pull request").option(...providerOption).option(...prOption).option("--blocking <level>", "gate level: none (advisory, default), warning, or error").option("--scope <value>", "what a pull-request scan reports: changed (default), files, lines, full").option("--comment", "post a summary comment on each pull request").option("--no-comment", "don't post a summary comment").option("--review-comments", "add inline review comments on changed lines").option("--no-review-comments", "don't add inline review comments").option("--commit-status", "report a commit status with the health score").option("--no-commit-status", "don't report a commit status").option("-y, --yes", "skip prompts; use the defaults").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", renderCiHelpEpilog).action(async (_options, command) => {
-	const { ciInstallAction } = await import("./ci-D0OU7_5i.js");
+	const { ciInstallAction } = await import("./ci-DZ9QnUV4.js");
 	return ciInstallAction(command.optsWithGlobals());
 });
 ci.command("config").description("Change the gate, scan scope, and pull-request reporting").option(...providerOption).option("--blocking <level>", "gate level: none (advisory), warning, or error").option("--scope <value>", "what a pull-request scan reports: changed, files, lines, or full").option("--comment", "post a summary comment on each pull request").option("--no-comment", "don't post a summary comment").option("--review-comments", "add inline review comments on changed lines").option("--no-review-comments", "don't add inline review comments").option("--commit-status", "report a commit status with the health score").option("--no-commit-status", "don't report a commit status").option("-y, --yes", "skip prompts; print the current settings").option("-c, --cwd <cwd>", "working directory", process.cwd()).option("--color", "force colored output").option("--no-color", "disable colored output (also honors NO_COLOR)").action(async (_options, command) => {
-	const { ciConfigAction } = await import("./ci-D0OU7_5i.js");
+	const { ciConfigAction } = await import("./ci-DZ9QnUV4.js");
 	return ciConfigAction(command.optsWithGlobals());
 });
 ci.command("upgrade").description("Upgrade the CI workflow to the action's current major").option(...providerOption).option(...prOption).option("-y, --yes", "skip prompts").option("-c, --cwd <cwd>", "working directory", process.cwd()).option("--color", "force colored output").option("--no-color", "disable colored output (also honors NO_COLOR)").action(async (_options, command) => {
-	const { ciUpgradeAction } = await import("./ci-D0OU7_5i.js");
+	const { ciUpgradeAction } = await import("./ci-DZ9QnUV4.js");
 	return ciUpgradeAction(command.optsWithGlobals());
 });
 program.command("version").description("show the version with Node and platform info").option("--color", "force colored output").option("--no-color", "disable colored output (also honors NO_COLOR)").action(async () => {
-	const { versionAction } = await import("./version-Cr0PARuU.js");
+	const { versionAction } = await import("./version-DVa-lN1C.js");
 	return versionAction();
 });
 const rules = program.command("rules").description("List, explain, and configure which React Doctor rules run");
 rules.command("list").description("List rules and the severity they run at under your config").option("--category <name>", "only show rules in a category (e.g. Performance)").option("--tag <name>", "only show rules with a tag (e.g. design, test-noise)").option("--framework <name>", "only show rules for a framework (e.g. global, nextjs)").option("--configured", "only show rules your config has changed from the default").option("--json", "output a structured JSON array").option("-c, --cwd <cwd>", "working directory", process.cwd()).action(async (_options, command) => {
-	const { rulesListAction } = await import("./rules-6hA6QP9L.js");
+	const { rulesListAction } = await import("./rules-DizN5gJ6.js");
 	return rulesListAction(command.optsWithGlobals());
 });
 rules.command("explain <rule>").description("Explain why a rule matters, its current severity, and how to configure it").option("--json", "output a structured JSON object").option("-c, --cwd <cwd>", "working directory", process.cwd()).action(async (rule, _options, command) => {
-	const { rulesExplainAction } = await import("./rules-6hA6QP9L.js");
+	const { rulesExplainAction } = await import("./rules-DizN5gJ6.js");
 	return rulesExplainAction(rule, command.optsWithGlobals());
 });
 rules.command("set <rule> <severity>").description("Set a rule's severity: off, warn, or error").option("-c, --cwd <cwd>", "working directory", process.cwd()).action(async (rule, severity, _options, command) => {
-	const { rulesSetAction } = await import("./rules-6hA6QP9L.js");
+	const { rulesSetAction } = await import("./rules-DizN5gJ6.js");
 	return rulesSetAction(rule, severity, command.optsWithGlobals());
 });
 rules.command("enable <rule>").description("Enable a rule at its recommended severity (or pass --severity)").option("--severity <level>", "severity to enable at: warn or error").option("-c, --cwd <cwd>", "working directory", process.cwd()).action(async (rule, _options, command) => {
-	const { rulesEnableAction } = await import("./rules-6hA6QP9L.js");
+	const { rulesEnableAction } = await import("./rules-DizN5gJ6.js");
 	return rulesEnableAction(rule, command.optsWithGlobals());
 });
 rules.command("disable <rule>").description("Disable a rule so it never runs").option("-c, --cwd <cwd>", "working directory", process.cwd()).action(async (rule, _options, command) => {
-	const { rulesDisableAction } = await import("./rules-6hA6QP9L.js");
+	const { rulesDisableAction } = await import("./rules-DizN5gJ6.js");
 	return rulesDisableAction(rule, command.optsWithGlobals());
 });
 rules.command("category <category> <severity>").description("Set the severity for a whole category (off, warn, error)").option("-c, --cwd <cwd>", "working directory", process.cwd()).action(async (category, severity, _options, command) => {
-	const { rulesCategoryAction } = await import("./rules-6hA6QP9L.js");
+	const { rulesCategoryAction } = await import("./rules-DizN5gJ6.js");
 	return rulesCategoryAction(category, severity, command.optsWithGlobals());
 });
 rules.command("ignore-tag <tag>").description("Skip a whole rule family by tag before linting (e.g. design)").option("-c, --cwd <cwd>", "working directory", process.cwd()).action(async (tag, _options, command) => {
-	const { rulesIgnoreTagAction } = await import("./rules-6hA6QP9L.js");
+	const { rulesIgnoreTagAction } = await import("./rules-DizN5gJ6.js");
 	return rulesIgnoreTagAction(tag, command.optsWithGlobals());
 });
 rules.command("unignore-tag <tag>").description("Stop ignoring a tag previously skipped via ignore-tag").option("-c, --cwd <cwd>", "working directory", process.cwd()).action(async (tag, _options, command) => {
-	const { rulesUnignoreTagAction } = await import("./rules-6hA6QP9L.js");
+	const { rulesUnignoreTagAction } = await import("./rules-DizN5gJ6.js");
 	return rulesUnignoreTagAction(tag, command.optsWithGlobals());
 });
 program.command("experimental-tui [directory]", { hidden: true }).description("[experimental] interactive, scrollable scan report").option("--blocking <level>", "severity that fails CI: error (default), warning, or none (advisory)").option("--color", "force colored output").option("--no-color", "disable colored output (also honors NO_COLOR)").addOption(new Option("--no-dead-code").hideHelp()).option("--no-supply-chain", "skip the dependency supply-chain scan").option("--score", "only print the numeric score (for scripts and CI)").option("--no-score", "skip the score API, the share URL, and crash reporting").option("--no-cache", "disable all scan caches for this run").option("--max-duration <seconds>", MAX_DURATION_OPTION_DESCRIPTION).option("-p, --project <names>", "scan specific workspace projects (comma-separated, or *)").option("-y, --yes", "skip the project prompt and scan every discovered project").action(async (directory = ".", _localOptions, command) => {
-	const { runScanCommand } = await import("./scan-DtjqkKaM.js");
+	const { runScanCommand } = await import("./scan-CEvjogRY.js");
 	return runScanCommand({
 		directory,
 		flags: command.optsWithGlobals(),
@@ -3635,7 +3663,8 @@ Promise.resolve().then(() => assertNoRemovedFlags(process.argv)).then(() => prog
 		process.exit(1);
 	}
 	if (isUserError) {
-		handleUserError(error);
+		handleUserError(error, { shouldExit: false });
+		await Promise.all([flushSentry(), shutdownTelemetry()]);
 		return;
 	}
 	handleError(error, { sentryEventId });
@@ -3644,4 +3673,4 @@ Promise.resolve().then(() => assertNoRemovedFlags(process.argv)).then(() => prog
 export {};
 
 //# sourceMappingURL=cli.js.map
-//# debugId=060d9fda-090f-56c0-a01c-3ce99371376f
+//# debugId=2db05473-003e-52a5-853a-90e4f4f5ac96

package/dist/{design-D-9YrV4y.js → design-BlxQroSp.js}

@@ -1,6 +1,6 @@
 
-!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]="10f38f0f-7189-5a15-a4dc-c7c077f15a0b")}catch(e){}}();
-import { t as inspectAction } from "./inspect-NIjyNi5S.js";
+!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]="e5b2a29d-21de-5730-a0a0-10dd8d756a97")}catch(e){}}();
+import { t as inspectAction } from "./inspect-Dd1qqPJf.js";
 //#region src/cli/commands/design.ts
 const designAction = async (directory, flags) => inspectAction(directory, {
 	...flags,
@@ -10,5 +10,5 @@ const designAction = async (directory, flags) => inspectAction(directory, {
 //#endregion
 export { designAction };
 
-//# sourceMappingURL=design-D-9YrV4y.js.map
-//# debugId=10f38f0f-7189-5a15-a4dc-c7c077f15a0b
+//# sourceMappingURL=design-BlxQroSp.js.map
+//# debugId=e5b2a29d-21de-5730-a0a0-10dd8d756a97

package/dist/{devtools-BiC-AP3B.js → devtools-CC2PAZ85.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]="27aef5e9-9c40-5fb8-a52c-e639ba9a5c8b")}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]="f1b960af-e618-536f-ba25-06c7416b43b4")}catch(e){}}();
 import { i as __toESM, r as __require, t as __commonJSMin } from "./chunk-ChKA3wi6.js";
 //#region ../../node_modules/.pnpm/ws@8.20.0/node_modules/ws/lib/constants.js
 var require_constants = /* @__PURE__ */ __commonJSMin(((exports, module) => {
@@ -16999,5 +16999,5 @@ if (await isDevToolsReachable()) {
 //#endregion
 export {};
 
-//# sourceMappingURL=devtools-BiC-AP3B.js.map
-//# debugId=27aef5e9-9c40-5fb8-a52c-e639ba9a5c8b
+//# sourceMappingURL=devtools-CC2PAZ85.js.map
+//# debugId=f1b960af-e618-536f-ba25-06c7416b43b4

package/dist/{exit-gracefully-DuS_nzeq.js → exit-gracefully-Dt1ix6Xh.js}

@@ -1,8 +1,8 @@
 
-!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]="7f85b424-35b3-5356-b2bd-6e99f312604b")}catch(e){}}();
-import { d as isJsonModeActive, m as writeJsonCancellationReport } from "./record-metric-CECbS8Qh.js";
-import { n as shutdownTelemetry } from "./telemetry-runtime-DVy10F6G.js";
-import { n as buildFooterLinkLines, r as flushSentry, t as buildSectionDivider } from "./build-section-divider-DjX3mmIx.js";
+!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]="255bcd10-efa4-5f94-b403-6c4baf957433")}catch(e){}}();
+import { d as isJsonModeActive, m as writeJsonCancellationReport } from "./record-metric-BzGcVSov.js";
+import { n as shutdownTelemetry } from "./telemetry-runtime-Bs7DsGaF.js";
+import { n as buildFooterLinkLines, r as flushSentry, t as buildSectionDivider } from "./build-section-divider-DGcPvzjX.js";
 import { t as activeScanAbortRegistry } from "./active-scan-abort-registry-DwG6tSPy.js";
 //#region src/cli/utils/active-tui-renderer.ts
 let activeTuiRenderer = null;
@@ -50,5 +50,5 @@ const exitGracefully = () => {
 //#endregion
 export { registerActiveTuiRenderer as n, exitGracefully as t };
 
-//# sourceMappingURL=exit-gracefully-DuS_nzeq.js.map
-//# debugId=7f85b424-35b3-5356-b2bd-6e99f312604b
+//# sourceMappingURL=exit-gracefully-Dt1ix6Xh.js.map
+//# debugId=255bcd10-efa4-5f94-b403-6c4baf957433

package/dist/{get-east-asian-width-Cglw13G7.js → get-east-asian-width-Bv2TD3Xj.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]="6955c459-56e8-5e4a-86be-c39cfafa059e")}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]="db817079-8f8f-50ee-bae1-5d0182c74255")}catch(e){}}();
 import process from "node:process";
 import os from "node:os";
 import tty from "node:tty";
@@ -440,5 +440,5 @@ function eastAsianWidth(codePoint, { ambiguousAsWide = false } = {}) {
 //#endregion
 export { chalk as a, stripAnsi as i, isFullWidth as n, isWide as r, eastAsianWidth as t };
 
-//# sourceMappingURL=get-east-asian-width-Cglw13G7.js.map
-//# debugId=6955c459-56e8-5e4a-86be-c39cfafa059e
+//# sourceMappingURL=get-east-asian-width-Bv2TD3Xj.js.map
+//# debugId=db817079-8f8f-50ee-bae1-5d0182c74255

package/dist/{handle-error-BzC_gVSx.js → handle-error-Cslt8b7C.js}

@@ -1,7 +1,7 @@
 
-!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]="e737b752-c89f-5407-a26f-d8e354a2f4af")}catch(e){}}();
-import { $n as CANONICAL_DISCORD_URL, An as gen, Cn as error, Ft as formatErrorChain, It as formatReactDoctorError, Kt as highlighter, T as METRIC, Xt as isReactDoctorError, _ as VERSION, br as isErrnoException, er as CANONICAL_GITHUB_URL, t as recordCount, zn as runSync } from "./record-metric-CECbS8Qh.js";
-import { a as isEnvironmentError, i as formatEnvironmentError } from "./telemetry-runtime-DVy10F6G.js";
+!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]="14074aaa-abab-54cc-8b60-b3d0d233a05b")}catch(e){}}();
+import { $n as CANONICAL_DISCORD_URL, An as gen, Cn as error, Ft as formatErrorChain, It as formatReactDoctorError, Kt as highlighter, T as METRIC, Xt as isReactDoctorError, _ as VERSION, br as isErrnoException, er as CANONICAL_GITHUB_URL, t as recordCount, zn as runSync } from "./record-metric-BzGcVSov.js";
+import { a as isNpmCacheCorruptionError, i as formatNpmCacheCorruptionError, o as formatEnvironmentError, s as isEnvironmentError } from "./telemetry-runtime-Bs7DsGaF.js";
 //#region src/cli/utils/handle-error.ts
 const OTLP_ENDPOINT_ENVIRONMENT_VARIABLE = "REACT_DOCTOR_OTLP_ENDPOINT";
 const OTLP_AUTH_HEADER_ENVIRONMENT_VARIABLE = "REACT_DOCTOR_OTLP_AUTH_HEADER";
@@ -85,15 +85,20 @@ const handleError = (error, options = {}) => {
 };
 /**
 * Renderer for expected, user-actionable failures — a bad `--diff` value,
-* a base branch that isn't fetched, or environment errors like disk-full or
-* permission-denied. Prints just the (already human-readable) message — no
-* "Something went wrong", prefilled issue, Discord link, or Sentry reference
-* — because there is no bug to report.
+* a base branch that isn't fetched, environment errors like disk-full or
+* permission-denied, or npm cache corruption. Prints just the (already
+* human-readable) message — no "Something went wrong", prefilled issue,
+* Discord link, or Sentry reference — because there is no bug to report.
 */
 const handleUserError = (error$1, options = {}) => {
-	const isEnvError = isEnvironmentError(error$1);
-	if (isEnvError) recordCount(METRIC.cliEnvironmentError, 1, { code: (isErrnoException(error$1) ? error$1.code : void 0) ?? "unknown" });
-	const message = isEnvError ? formatEnvironmentError(error$1) : formatErrorForReport(error$1);
+	let message = formatErrorForReport(error$1);
+	if (isNpmCacheCorruptionError(error$1)) {
+		recordCount(METRIC.cliEnvironmentError, 1, { code: "NPX_CACHE_CORRUPTION" });
+		message = formatNpmCacheCorruptionError(error$1);
+	} else if (isEnvironmentError(error$1)) {
+		recordCount(METRIC.cliEnvironmentError, 1, { code: (isErrnoException(error$1) ? error$1.code : void 0) ?? "unknown" });
+		message = formatEnvironmentError(error$1);
+	}
 	runSync(gen(function* () {
 		yield* error("");
 		yield* error(highlighter.error(message));
@@ -105,5 +110,5 @@ const handleUserError = (error$1, options = {}) => {
 //#endregion
 export { handleUserError as n, handleError as t };
 
-//# sourceMappingURL=handle-error-BzC_gVSx.js.map
-//# debugId=e737b752-c89f-5407-a26f-d8e354a2f4af
+//# sourceMappingURL=handle-error-Cslt8b7C.js.map
+//# debugId=14074aaa-abab-54cc-8b60-b3d0d233a05b