react-doctor 0.9.12-dev.e183c35 → 0.9.12-dev.e1d4c51

package/dist/{build-section-divider-D2kON1gx.js → build-section-divider-BTksty2F.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]="1b1cd9c6-c97b-527e-87ad-933fabbb08d7")}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-BMWbP8MZ.js";
-import { r as isExpectedUserError } from "./telemetry-runtime-Cix2Ie97.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]="99ccb1e4-f2eb-559a-b678-db3dc6227e36")}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-C4PUVqp5.js";
+import { r as isExpectedUserError } from "./telemetry-runtime-BQjl1WJM.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.e183c35`;
+const resolveSentryRelease = () => process.env.SENTRY_RELEASE || `react-doctor@0.9.12-dev.e1d4c51`;
 /**
 * 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.e183c35") ? "development" : "production");
+const resolveSentryEnvironment = () => process.env.SENTRY_ENVIRONMENT || (isDevVersion("0.9.12-dev.e1d4c51") ? "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-D2kON1gx.js.map
-//# debugId=1b1cd9c6-c97b-527e-87ad-933fabbb08d7
+//# sourceMappingURL=build-section-divider-BTksty2F.js.map
+//# debugId=99ccb1e4-f2eb-559a-b678-db3dc6227e36

package/dist/{ci-BDF4MCw4.js → ci-BkLZiDUN.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]="e9c77810-10a8-5f2a-a697-7bb400fbc468")}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]="7bfddff1-e38a-57be-9bfd-bde4013a5acb")}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-BMWbP8MZ.js";
-import { r as isExpectedUserError } from "./telemetry-runtime-Cix2Ie97.js";
-import { n as handleUserError, t as handleError } from "./handle-error-CiH-zHAJ.js";
-import { t as reportErrorToSentry } from "./report-error-6PgTfB1z.js";
-import { N as cliLogger, c as spinner, n as findNearestPackageDirectory } from "./install-doctor-script-B7P7AJly.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-CfSmkFY0.js";
-import { a as isValidBlockingLevel, c as openWorkflowPullRequest, l as stageWorkflowFile, n as isScopeValue } from "./resolve-scope-Bq-uMX-y.js";
-import { t as shouldSkipPrompts } from "./should-skip-prompts-K3hVW95X.js";
-import { t as printBrandedHeader } from "./print-branded-header-DWWSXUyB.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-C4PUVqp5.js";
+import { r as isExpectedUserError } from "./telemetry-runtime-BQjl1WJM.js";
+import { n as handleUserError, t as handleError } from "./handle-error-Ddm9numu.js";
+import { t as reportErrorToSentry } from "./report-error-FYj7f2vY.js";
+import { M as cliLogger, c as spinner, n as findNearestPackageDirectory } from "./install-doctor-script-DMNgSbdq.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-C-kf3m11.js";
+import { a as isValidBlockingLevel, c as openWorkflowPullRequest, l as stageWorkflowFile, n as isScopeValue } from "./resolve-scope-ClRg-hd_.js";
+import { t as shouldSkipPrompts } from "./should-skip-prompts-DfUwV_qr.js";
+import { t as printBrandedHeader } from "./print-branded-header-s2p-5716.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-BDF4MCw4.js.map
-//# debugId=e9c77810-10a8-5f2a-a697-7bb400fbc468
+//# sourceMappingURL=ci-BkLZiDUN.js.map
+//# debugId=7bfddff1-e38a-57be-9bfd-bde4013a5acb

package/dist/cli.js

@@ -1,13 +1,13 @@
 
-!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]="f42b1a1f-3941-5a61-bf1b-ea87400b9ec6")}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-BMWbP8MZ.js";
-import { n as shutdownTelemetry, r as isExpectedUserError } from "./telemetry-runtime-Cix2Ie97.js";
-import { i as initializeSentry, r as flushSentry } from "./build-section-divider-D2kON1gx.js";
-import { t as exitGracefully } from "./exit-gracefully-D-9LC4_A.js";
-import { n as handleUserError, t as handleError } from "./handle-error-CiH-zHAJ.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-C4PUVqp5.js";
+import { n as shutdownTelemetry, r as isExpectedUserError } from "./telemetry-runtime-BQjl1WJM.js";
+import { i as initializeSentry, r as flushSentry } from "./build-section-divider-BTksty2F.js";
+import { t as exitGracefully } from "./exit-gracefully-LlCvoAEm.js";
+import { n as handleUserError, t as handleError } from "./handle-error-Ddm9numu.js";
 import { n as getLastRunTraceId } from "./active-run-trace-dlIZeEvb.js";
-import { t as reportErrorToSentry } from "./report-error-6PgTfB1z.js";
+import { t as reportErrorToSentry } from "./report-error-FYj7f2vY.js";
 import { t as unrefStdin } from "./unref-stdin-BKT_s38a.js";
 import { execFileSync } from "node:child_process";
 //#region ../../node_modules/.pnpm/commander@14.0.3/node_modules/commander/lib/error.js
@@ -3529,7 +3529,7 @@ ${highlighter.dim("Learn more:")}
 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-BfuDcKtg.js");
+	const { runScanCommand } = await import("./scan-3K6Kfp4M.js");
 	return runScanCommand({
 		directory,
 		flags,
@@ -3537,75 +3537,75 @@ program.action(async (directory = ".", flags) => {
 	});
 });
 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-5z-_ATHh.js");
+	const { designAction } = await import("./design-C4t3qkuV.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-C0Sq0Vsq.js");
+	const { runtimeScanAction } = await import("./runtime-scan-n5_rAxCK.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-vS83AKil.js");
+	const { whyAction } = await import("./why-eB_2sMXA.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-D3ZEk4sy.js");
+	const { installAction } = await import("./install-D0M10gBH.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-BDF4MCw4.js");
+	const { ciInstallAction } = await import("./ci-BkLZiDUN.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-BDF4MCw4.js");
+	const { ciConfigAction } = await import("./ci-BkLZiDUN.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-BDF4MCw4.js");
+	const { ciUpgradeAction } = await import("./ci-BkLZiDUN.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-D3IeIvrP.js");
+	const { versionAction } = await import("./version-CJ_V_OjY.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-Cw83jL1c.js");
+	const { rulesListAction } = await import("./rules-DsN5blEA.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-Cw83jL1c.js");
+	const { rulesExplainAction } = await import("./rules-DsN5blEA.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-Cw83jL1c.js");
+	const { rulesSetAction } = await import("./rules-DsN5blEA.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-Cw83jL1c.js");
+	const { rulesEnableAction } = await import("./rules-DsN5blEA.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-Cw83jL1c.js");
+	const { rulesDisableAction } = await import("./rules-DsN5blEA.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-Cw83jL1c.js");
+	const { rulesCategoryAction } = await import("./rules-DsN5blEA.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-Cw83jL1c.js");
+	const { rulesIgnoreTagAction } = await import("./rules-DsN5blEA.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-Cw83jL1c.js");
+	const { rulesUnignoreTagAction } = await import("./rules-DsN5blEA.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-BfuDcKtg.js");
+	const { runScanCommand } = await import("./scan-3K6Kfp4M.js");
 	return runScanCommand({
 		directory,
 		flags: command.optsWithGlobals(),
@@ -3635,7 +3635,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 +3645,4 @@ Promise.resolve().then(() => assertNoRemovedFlags(process.argv)).then(() => prog
 export {};
 
 //# sourceMappingURL=cli.js.map
-//# debugId=060d9fda-090f-56c0-a01c-3ce99371376f
+//# debugId=f42b1a1f-3941-5a61-bf1b-ea87400b9ec6

package/dist/{design-5z-_ATHh.js → design-C4t3qkuV.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]="fe0a3178-d42b-5fd4-96d1-a37d26c97c6b")}catch(e){}}();
-import { t as inspectAction } from "./inspect-UlnsYEF7.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]="67f51b65-e710-5bed-91d0-11fa45a8ff25")}catch(e){}}();
+import { t as inspectAction } from "./inspect-RhrLJRiS.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-5z-_ATHh.js.map
-//# debugId=fe0a3178-d42b-5fd4-96d1-a37d26c97c6b
+//# sourceMappingURL=design-C4t3qkuV.js.map
+//# debugId=67f51b65-e710-5bed-91d0-11fa45a8ff25

package/dist/{exit-gracefully-D-9LC4_A.js → exit-gracefully-LlCvoAEm.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]="10fe0b4b-43e7-54f5-90b8-a65125da197e")}catch(e){}}();
-import { d as isJsonModeActive, m as writeJsonCancellationReport } from "./record-metric-BMWbP8MZ.js";
-import { n as shutdownTelemetry } from "./telemetry-runtime-Cix2Ie97.js";
-import { n as buildFooterLinkLines, r as flushSentry, t as buildSectionDivider } from "./build-section-divider-D2kON1gx.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]="b812b813-056b-5f00-bfaf-5517954f098a")}catch(e){}}();
+import { d as isJsonModeActive, m as writeJsonCancellationReport } from "./record-metric-C4PUVqp5.js";
+import { n as shutdownTelemetry } from "./telemetry-runtime-BQjl1WJM.js";
+import { n as buildFooterLinkLines, r as flushSentry, t as buildSectionDivider } from "./build-section-divider-BTksty2F.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-D-9LC4_A.js.map
-//# debugId=10fe0b4b-43e7-54f5-90b8-a65125da197e
+//# sourceMappingURL=exit-gracefully-LlCvoAEm.js.map
+//# debugId=b812b813-056b-5f00-bfaf-5517954f098a

package/dist/{handle-error-CiH-zHAJ.js → handle-error-Ddm9numu.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]="cffa3e8d-52f9-5f99-9686-e1e103e4ad6f")}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-BMWbP8MZ.js";
-import { a as isEnvironmentError, i as formatEnvironmentError } from "./telemetry-runtime-Cix2Ie97.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]="efd5006b-2098-5c82-bbcd-70777ac9ab39")}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-C4PUVqp5.js";
+import { a as isNpmCacheCorruptionError, i as formatNpmCacheCorruptionError, o as formatEnvironmentError, s as isEnvironmentError } from "./telemetry-runtime-BQjl1WJM.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-CiH-zHAJ.js.map
-//# debugId=cffa3e8d-52f9-5f99-9686-e1e103e4ad6f
+//# sourceMappingURL=handle-error-Ddm9numu.js.map
+//# debugId=efd5006b-2098-5c82-bbcd-70777ac9ab39