react-doctor 0.9.12-dev.a2b460d → 0.9.12-dev.f7efb7d

package/README.md

@@ -9,7 +9,7 @@
 
 Your agent writes bad React, this catches it.
 
-React Doctor deterministically scans your codebase and finds issues across state & effects, performance, architecture, security, and accessibility.
+React Doctor deterministically scans your codebase and finds issues across state and effects, performance, architecture, security, accessibility, and maintainability. It highlights overly complex React functions and repeated JSX trees that are good candidates for composition.
 
 Works across React frameworks and React-enabled sites - Next.js, Vite, Astro, TanStack, React Native, Expo, you name it.
 

package/bin/react-doctor.js

@@ -10,12 +10,4 @@ if (module.enableCompileCache && !process.env.NODE_DISABLE_COMPILE_CACHE) {
   }
 }
 
-// Fast-path the (experimental) language server so it runs without the CLI's
-// commander / prompts / ora layer, which would touch process.stdin before the
-// LSP connection attaches and break the stdio transport.
-if (process.argv[2] === "experimental-lsp") {
-  const { startLanguageServer } = await import("../dist/lsp.js");
-  startLanguageServer();
-} else {
-  await import("../dist/cli.js");
-}
+await import("../dist/cli.js");

package/dist/{build-section-divider-Vz879zXD.js → build-section-divider-LBEprrSw.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]="140b0cea-029f-5af2-8653-e99462b0ce17")}catch(e){}}();
-import { At as anonymizeInPlace, Fn as scrubSensitivePaths, M as SENTRY_FLUSH_TIMEOUT_MS, Y as CANONICAL_GITHUB_URL, a as isEnvFlagEnabled, cn as highlighter, i as isTelemetryEnabled, jt as anonymizeText, nt as DOCS_URL, o as buildSentryScope } from "./record-metric-CMe2d1Xv.js";
-import { c as isExpectedUserError } from "./unref-stdin-Cxhw67r6.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]="6f8961a6-7626-5d07-a0a4-acbfebe329f7")}catch(e){}}();
+import { $n as CANONICAL_GITHUB_URL, Gt as highlighter, M as SENTRY_FLUSH_TIMEOUT_MS, a as isEnvFlagEnabled, ar as DOCS_URL, dt as anonymizeInPlace, ft as anonymizeText, i as isTelemetryEnabled, mn as scrubSensitivePaths, o as buildSentryScope } from "./record-metric-DFQYh2Mf.js";
+import { c as isExpectedUserError } from "./unref-stdin-C5xln9RW.js";
 import * as Sentry from "@sentry/node";
 //#region src/cli/utils/scrub-sentry-event.ts
 /**
@@ -55,9 +55,8 @@ const scrubSentryEvent = (event) => {
 /**
 * Shared Sentry configuration resolution — release, environment, and tracing
 * sample rate — derived from `VERSION` and the standard `SENTRY_*` env
-* overrides. Lives apart from `instrument.ts` (the CLI's run-context-aware
-* init) so both the CLI and the editor language server can resolve identical
-* release/environment values without the LSP pulling in CLI run-context code.
+* overrides. Lives apart from `instrument.ts` so this resolution remains
+* independently testable.
 */
 /**
 * A version is a "dev" build when it's the unbuilt placeholder (`0.0.0`) or
@@ -71,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.a2b460d`;
+const resolveSentryRelease = () => process.env.SENTRY_RELEASE || `react-doctor@0.9.12-dev.f7efb7d`;
 /**
 * 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.a2b460d") ? "development" : "production");
+const resolveSentryEnvironment = () => process.env.SENTRY_ENVIRONMENT || (isDevVersion("0.9.12-dev.f7efb7d") ? "development" : "production");
 //#endregion
 //#region src/instrument.ts
 let isInitialized = false;
@@ -227,5 +226,5 @@ const buildSectionDivider = () => highlighter.dim(`${DIVIDER_INDENT}${"─".repe
 //#endregion
 export { initializeSentry as a, flushSentry as i, buildFooterLinkLines as n, activeScanAbortRegistry as r, buildSectionDivider as t };
 
-//# sourceMappingURL=build-section-divider-Vz879zXD.js.map
-//# debugId=140b0cea-029f-5af2-8653-e99462b0ce17
+//# sourceMappingURL=build-section-divider-LBEprrSw.js.map
+//# debugId=6f8961a6-7626-5d07-a0a4-acbfebe329f7

package/dist/{ci-BVYrYekU.js → ci-B80oWpS1.js}

@@ -1,14 +1,14 @@
 
-!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]="78f87d33-c5f6-5495-9915-ffb7a60836c3")}catch(e){}}();
-import { n as __require, r as __toESM, t as __commonJSMin } from "./chunk-q7NCDQ7-.js";
-import { X as CI_URL, ar as runSync, cn as highlighter, ot as GITHUB_ACTIONS_SETUP_URL, t as recordCount, w as METRIC } from "./record-metric-CMe2d1Xv.js";
-import { c as isExpectedUserError } from "./unref-stdin-Cxhw67r6.js";
-import { n as handleError, r as handleUserError, t as reportErrorToSentry } from "./report-error-1l7v6_dE.js";
-import { L as cliLogger, c as spinner, n as findNearestPackageDirectory } from "./install-doctor-script-D58Hr1dM.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-DkMicv8E.js";
-import { a as isValidBlockingLevel, c as openWorkflowPullRequest, l as stageWorkflowFile, n as isScopeValue } from "./resolve-scope-CMNrOdDf.js";
-import { t as shouldSkipPrompts } from "./should-skip-prompts-mXKZBNCz.js";
-import { t as printBrandedHeader } from "./print-branded-header-D4QYSu-h.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]="5b6ba07b-84e2-5eef-a7cb-81e5f8f467e5")}catch(e){}}();
+import { i as __toESM, r as __require, t as __commonJSMin } from "./chunk-ChKA3wi6.js";
+import { Gt as highlighter, Rn as runSync, er as CI_URL, sr as GITHUB_ACTIONS_SETUP_URL, t as recordCount, w as METRIC } from "./record-metric-DFQYh2Mf.js";
+import { c as isExpectedUserError } from "./unref-stdin-C5xln9RW.js";
+import { n as handleError, r as handleUserError, t as reportErrorToSentry } from "./report-error-Bg7eABmv.js";
+import { L as cliLogger, c as spinner, n as findNearestPackageDirectory } from "./install-doctor-script-rddKhKYf.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-telZkaCp.js";
+import { a as isValidBlockingLevel, c as openWorkflowPullRequest, l as stageWorkflowFile, n as isScopeValue } from "./resolve-scope-CsMf2eUG.js";
+import { t as shouldSkipPrompts } from "./should-skip-prompts-oFD5z_9E.js";
+import { t as printBrandedHeader } from "./print-branded-header-514lsPsP.js";
 import * as path$1 from "node:path";
 import * as fs$1 from "node:fs";
 //#region src/cli/utils/ci/ci-provider.ts
@@ -7497,5 +7497,5 @@ const ciConfigAction = (options) => runCiCommand("config", runCiConfig, options)
 //#endregion
 export { ciConfigAction, ciInstallAction, ciUpgradeAction };
 
-//# sourceMappingURL=ci-BVYrYekU.js.map
-//# debugId=78f87d33-c5f6-5495-9915-ffb7a60836c3
+//# sourceMappingURL=ci-B80oWpS1.js.map
+//# debugId=5b6ba07b-84e2-5eef-a7cb-81e5f8f467e5

package/dist/cli.js

@@ -1,11 +1,11 @@
 
-!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]="c779427c-ed7c-5be4-b123-73410d3af015")}catch(e){}}();
-import { n as __require, r as __toESM, t as __commonJSMin } from "./chunk-q7NCDQ7-.js";
-import { In as setColorEnabled, R as CliInputError, V as isDebugFlagEnabled, X as CI_URL, Y as CANONICAL_GITHUB_URL, cn as highlighter, d as isJsonModeActive, g as VERSION, i as isTelemetryEnabled, m as writeJsonErrorReport } from "./record-metric-CMe2d1Xv.js";
-import { c as isExpectedUserError, r as getLastRunTraceId, s as shutdownTelemetry, t as unrefStdin } from "./unref-stdin-Cxhw67r6.js";
-import { a as initializeSentry, i as flushSentry } from "./build-section-divider-Vz879zXD.js";
-import { t as exitGracefully } from "./exit-gracefully-Cjv5kC_l.js";
-import { n as handleError, r as handleUserError, t as reportErrorToSentry } from "./report-error-1l7v6_dE.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]="03462e9a-cc61-5815-b641-9bce568efeb2")}catch(e){}}();
+import { i as __toESM, r as __require, t as __commonJSMin } from "./chunk-ChKA3wi6.js";
+import { $n as CANONICAL_GITHUB_URL, Gt as highlighter, R as CliInputError, V as isDebugFlagEnabled, d as isJsonModeActive, er as CI_URL, g as VERSION, hn as setColorEnabled, i as isTelemetryEnabled, m as writeJsonErrorReport } from "./record-metric-DFQYh2Mf.js";
+import { c as isExpectedUserError, r as getLastRunTraceId, s as shutdownTelemetry, t as unrefStdin } from "./unref-stdin-C5xln9RW.js";
+import { a as initializeSentry, i as flushSentry } from "./build-section-divider-LBEprrSw.js";
+import { t as exitGracefully } from "./exit-gracefully-Z8iBwlMI.js";
+import { n as handleError, r as handleUserError, t as reportErrorToSentry } from "./report-error-Bg7eABmv.js";
 import { execFileSync } from "node:child_process";
 //#region ../../node_modules/.pnpm/commander@14.0.3/node_modules/commander/lib/error.js
 var require_error = /* @__PURE__ */ __commonJSMin(((exports) => {
@@ -3456,10 +3456,10 @@ ${formatExampleLines([
 
 ${highlighter.dim("Scope:")}
   Runs every rule tagged ${highlighter.info("design")}; all design rules stay opt-in during a general health scan.
-  Dead-code, supply-chain, external lint-config, custom-plugin, and health-score passes are skipped.
+  Whole-project maintainability, supply-chain, external lint-config, custom-plugin, and health-score passes are skipped.
   Standard scan flags such as ${highlighter.info("--scope")}, ${highlighter.info("--project")}, ${highlighter.info("--verbose")}, and ${highlighter.info("--json")} still work.
 `;
-const MAX_DURATION_OPTION_DESCRIPTION = "scan time budget for the whole run, shared across workspace projects: past it, queued projects, remaining lint batches, and dead-code are skipped and partial results are reported (skipped files and projects are listed in the JSON report)";
+const MAX_DURATION_OPTION_DESCRIPTION = "scan time budget for the whole run, shared across workspace projects: past it, queued projects, remaining lint batches, and maintainability analysis are skipped and partial results are reported (skipped files and projects are listed in the JSON report)";
 const renderCiHelpEpilog = () => `
 ${highlighter.dim("Examples:")}
 ${formatExampleLines([
@@ -3479,9 +3479,9 @@ ${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").option("--dead-code", "enable dead-code analysis (default)").option("--no-dead-code", "skip dead-code analysis (unused files / exports / dependencies, circular imports)").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);
+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-D4m5r4Rs.js");
+	const { runScanCommand } = await import("./scan-D7bmiqv1.js");
 	return runScanCommand({
 		directory,
 		flags,
@@ -3489,72 +3489,71 @@ 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-D-TYN_tr.js");
+	const { designAction } = await import("./design-Doxh3Oua.js");
 	return designAction(directory ?? ".", command.optsWithGlobals());
 });
 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-BktDEhhH.js");
+	const { whyAction } = await import("./why-DPksh2dy.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 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(async (options, command) => {
-	const { installAction } = await import("./install-ZeYvD9Rw.js");
+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-CxK6oNgV.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-BVYrYekU.js");
+	const { ciInstallAction } = await import("./ci-B80oWpS1.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-BVYrYekU.js");
+	const { ciConfigAction } = await import("./ci-B80oWpS1.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-BVYrYekU.js");
+	const { ciUpgradeAction } = await import("./ci-B80oWpS1.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-CnvVY2VD.js");
+	const { versionAction } = await import("./version-Bg3OKWjm.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-CzR1qUru.js");
+	const { rulesListAction } = await import("./rules-Bmw6adjU.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-CzR1qUru.js");
+	const { rulesExplainAction } = await import("./rules-Bmw6adjU.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-CzR1qUru.js");
+	const { rulesSetAction } = await import("./rules-Bmw6adjU.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-CzR1qUru.js");
+	const { rulesEnableAction } = await import("./rules-Bmw6adjU.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-CzR1qUru.js");
+	const { rulesDisableAction } = await import("./rules-Bmw6adjU.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-CzR1qUru.js");
+	const { rulesCategoryAction } = await import("./rules-Bmw6adjU.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-CzR1qUru.js");
+	const { rulesIgnoreTagAction } = await import("./rules-Bmw6adjU.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-CzR1qUru.js");
+	const { rulesUnignoreTagAction } = await import("./rules-Bmw6adjU.js");
 	return rulesUnignoreTagAction(tag, command.optsWithGlobals());
 });
-program.command("experimental-lsp", { hidden: false }).description("[experimental] run the React Doctor language server over stdio (for editors)").allowUnknownOption().action(() => {});
-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)").option("--no-dead-code", "skip dead-code analysis").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-D4m5r4Rs.js");
+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-D7bmiqv1.js");
 	return runScanCommand({
 		directory,
 		flags: command.optsWithGlobals(),
@@ -3593,4 +3592,4 @@ Promise.resolve().then(() => assertNoRemovedFlags(process.argv)).then(() => prog
 export {};
 
 //# sourceMappingURL=cli.js.map
-//# debugId=c779427c-ed7c-5be4-b123-73410d3af015
+//# debugId=03462e9a-cc61-5815-b641-9bce568efeb2

package/dist/{design-D-TYN_tr.js → design-Doxh3Oua.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]="7c9e148d-f31f-56f0-8f3d-5ba7ab111299")}catch(e){}}();
-import { t as inspectAction } from "./inspect-kkvDHKDE.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]="57e0fb68-4680-5c11-92ad-72cb11bf8b4b")}catch(e){}}();
+import { t as inspectAction } from "./inspect-qNFSJB8s.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-TYN_tr.js.map
-//# debugId=7c9e148d-f31f-56f0-8f3d-5ba7ab111299
+//# sourceMappingURL=design-Doxh3Oua.js.map
+//# debugId=57e0fb68-4680-5c11-92ad-72cb11bf8b4b

package/dist/{devtools-DPRVRu3S.js → devtools-D8NTVj81.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]="de65e4d1-46e8-5d95-92bc-2e867613f003")}catch(e){}}();
-import { n as __require, r as __toESM, t as __commonJSMin } from "./chunk-q7NCDQ7-.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]="9bd200c1-4571-57fb-8b9f-f59503d08d1d")}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) => {
 	const BINARY_TYPES = [
@@ -16999,5 +16999,5 @@ if (await isDevToolsReachable()) {
 //#endregion
 export {};
 
-//# sourceMappingURL=devtools-DPRVRu3S.js.map
-//# debugId=de65e4d1-46e8-5d95-92bc-2e867613f003
+//# sourceMappingURL=devtools-D8NTVj81.js.map
+//# debugId=9bd200c1-4571-57fb-8b9f-f59503d08d1d

package/dist/{exit-gracefully-Cjv5kC_l.js → exit-gracefully-Z8iBwlMI.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]="bd95a7a7-0356-5ed5-91a0-95e7f28f5b63")}catch(e){}}();
-import { d as isJsonModeActive, m as writeJsonErrorReport } from "./record-metric-CMe2d1Xv.js";
-import { s as shutdownTelemetry } from "./unref-stdin-Cxhw67r6.js";
-import { i as flushSentry, n as buildFooterLinkLines, r as activeScanAbortRegistry, t as buildSectionDivider } from "./build-section-divider-Vz879zXD.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]="128c0b08-c070-5a15-99dd-4d7cef422d88")}catch(e){}}();
+import { d as isJsonModeActive, m as writeJsonErrorReport } from "./record-metric-DFQYh2Mf.js";
+import { s as shutdownTelemetry } from "./unref-stdin-C5xln9RW.js";
+import { i as flushSentry, n as buildFooterLinkLines, r as activeScanAbortRegistry, t as buildSectionDivider } from "./build-section-divider-LBEprrSw.js";
 //#region src/cli/utils/active-tui-renderer.ts
 let activeTuiRenderer = null;
 const registerActiveTuiRenderer = (renderer) => {
@@ -44,5 +44,5 @@ const exitGracefully = () => {
 //#endregion
 export { registerActiveTuiRenderer as n, exitGracefully as t };
 
-//# sourceMappingURL=exit-gracefully-Cjv5kC_l.js.map
-//# debugId=bd95a7a7-0356-5ed5-91a0-95e7f28f5b63
+//# sourceMappingURL=exit-gracefully-Z8iBwlMI.js.map
+//# debugId=128c0b08-c070-5a15-99dd-4d7cef422d88

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { FrameworkToken } from "oxlint-plugin-react-doctor/core";
 import fs from "node:fs";
+import { FrameworkToken } from "oxlint-plugin-react-doctor/core";
 
 //#region ../../node_modules/.pnpm/effect@4.0.0-beta.102/node_modules/effect/dist/Types.d.ts
 /**
@@ -9636,10 +9636,9 @@ interface Diagnostic {
   column: number;
   /**
    * UTF-8 byte offset of the diagnostic's primary span start, straight
-   * from oxlint's label span. Optional because environment / dead-code
-   * diagnostics carry no source span. Editors (LSP) convert this into a
-   * precise range via the in-memory document; non-editor consumers can
-   * ignore it.
+   * from oxlint's label span. Optional because environment / maintainability
+   * diagnostics carry no source span. Consumers can use it to recover a
+   * precise range or ignore it.
    */
   offset?: number;
   /** UTF-8 byte length of the primary span (pairs with `offset`). */
@@ -9697,8 +9696,8 @@ type BlockingLevel = "error" | "warning" | "none";
  * CLI `--scope` flag, the GitHub Action `scope` input, and this config field
  * all share. Ordered widest to narrowest:
  *
- * - `"full"` — whole project, every issue (the default). Whole-project checks
- *   (dead-code, environment, supply-chain) run only at this scope.
+ * - `"full"` — whole project, every issue (the default). Environment and
+ *   supply-chain checks run only at this scope.
  * - `"files"` — only the files changed vs the base, with ALL issues in them
  *   (no compare-to-main). What `--staged` and an uncommitted `--diff` do today.
  * - `"changed"` — only issues the change INTRODUCED vs the base (the baseline
@@ -9836,8 +9835,7 @@ interface SupplyChainConfig {
   /**
    * Whether to run the Socket supply-chain score check. Default: `true`.
    * Set to `false` to opt out — the check performs one network request per
-   * direct dependency. It is always skipped in `--diff` / `--staged` mode
-   * and in editor scans regardless of this setting.
+   * direct dependency. It is always skipped in `--diff` / `--staged` mode.
    */
   enabled?: boolean;
   /**
@@ -9871,11 +9869,8 @@ interface ReactDoctorConfig {
    */
   supplyChain?: SupplyChainConfig;
   /**
-   * Whether to run dead-code analysis (via `deslop-js`) alongside lint.
-   * Reports unused files, unused exports, unused dependencies, and
-   * circular imports under the "Maintainability" category. Default: `true`.
-   * Always skipped in `--diff` / `--staged` modes because reachability
-   * is a whole-project property.
+   * Compatibility switch for React maintainability analysis. Default: `true`.
+   * @deprecated React maintainability checks are part of React Doctor.
    */
   deadCode?: boolean;
   verbose?: boolean;
@@ -10332,7 +10327,7 @@ interface ScoreResult {
 //#region src/types/diagnose.d.ts
 interface DiagnoseOptions {
   lint?: boolean;
-  /** See `ReactDoctorConfig.deadCode`. Ignored in diff mode. */
+  /** @deprecated Compatibility alias for React maintainability analysis. */
   deadCode?: boolean;
   verbose?: boolean;
   /** Restrict linting to supported JS/TS files and inline scripts in HTML files. */
@@ -10352,11 +10347,7 @@ interface DiagnoseOptions {
 interface DiagnoseResult {
   diagnostics: Diagnostic[];
   score: ScoreResult | null;
-  /**
-   * Checks that did not run to completion (e.g. `"dead-code"` when the
-   * `deslop-js` native binding crashed). Empty when everything ran.
-   * Mirrors `InspectResult.skippedChecks`.
-   */
+  /** Checks that did not run to completion. Mirrors `InspectResult.skippedChecks`. */
   skippedChecks: string[];
   /** See `InspectResult.skippedCheckReasons`. */
   skippedCheckReasons?: Record<string, string>;
@@ -10380,7 +10371,7 @@ interface DiagnoseResult {
 }
 /**
  * A single project to scan as part of a `diagnose({ projects })` batch.
- * Scan options (`deadCode`, `lint`, etc.) are flat on the entry and
+ * Scan options (`lint`, etc.) are flat on the entry and
  * layer on top of the global defaults — omitted fields fall through.
  */
 interface ProjectDefinition extends DiagnoseOptions {
@@ -10497,23 +10488,11 @@ interface InspectResult {
    */
   lintSidecarReplayedFileCount?: number | null;
   lintSidecarTotalFileCount?: number | null;
-  /**
-   * Dead-code result cache outcome: `true` when the pass replayed a cached
-   * result (the analysis never ran), `false` on a fresh analysis. Absent when
-   * the pass never consulted the cache — dead-code skipped, the cache
-   * disabled, or a whole-repo cache replay where no analysis ran. The CLI
-   * projects it onto the Sentry wide event as `deadCode.cacheHit`.
-   */
+  /** @deprecated Retained for report compatibility. */
   deadCodeCacheHit?: boolean | null;
-  /**
-   * deslop's incremental summary-cache outcome for the dead-code analysis:
-   * collected files served from cached parse summaries vs freshly parsed.
-   * Both absent whenever no analysis consulted the incremental store — a
-   * whole-result cache hit, the cache disabled, or dead-code skipped. The CLI
-   * projects them onto the Sentry wide event as `deadCode.summaryCacheHits` /
-   * `deadCode.summaryCacheMisses`.
-   */
+  /** @deprecated Retained for report compatibility. */
   deadCodeSummaryCacheHits?: number | null;
+  /** @deprecated Retained for report compatibility. */
   deadCodeSummaryCacheMisses?: number | null;
   /**
    * Present only for a baseline run (`InspectOptions.baseline` set). The
@@ -10531,7 +10510,7 @@ interface InspectResult {
  * Options accepted by `inspect()`. Mixes two concern groups; ordered
  * here in the source to make the split visible to future readers:
  *
- *   - **Engine inputs** (`lint`, `deadCode`, `includePaths`,
+ *   - **Engine inputs** (`lint`, `includePaths`,
  *     `configOverride`, `respectInlineDisables`) — flow into
  *     `runInspect`'s `InspectInput` and shape what the engine
  *     actually does.
@@ -10738,8 +10717,8 @@ type JsonReport = JsonReportV1$1 | JsonReportV2$1 | JsonReportV3$1; //#endregion
  * Distinguishes the two situations that both surface as "no project here", so
  * the rendered message matches reality:
  *
- * - `no-project` (default): the path exists but has no React project — no
- *   `package.json` at the root and no discoverable nested React subproject.
+ * - `no-project` (default): the path exists but has no supported project — no
+ *   `package.json` at the root and no discoverable nested React or Three.js subproject.
  * - `missing-path`: the resolved scan target does not exist on disk at all
  *   (a typo, a stale temp path, a monorepo subdir that isn't present). The
  *   generic "expected a package.json" guidance is misleading here, so point
@@ -10844,10 +10823,10 @@ declare const ProjectDiscoveryFailed_base: Class<ProjectDiscoveryFailed, TaggedS
 declare class ProjectDiscoveryFailed extends ProjectDiscoveryFailed_base {
   get message(): string;
 }
-declare const DeadCodeAnalysisFailed_base: Class<DeadCodeAnalysisFailed, TaggedStruct<"DeadCodeAnalysisFailed", {
+declare const MaintainabilityAnalysisFailed_base: Class<MaintainabilityAnalysisFailed, TaggedStruct<"MaintainabilityAnalysisFailed", {
   readonly cause: Unknown;
 }>, YieldableError>;
-declare class DeadCodeAnalysisFailed extends DeadCodeAnalysisFailed_base {
+declare class MaintainabilityAnalysisFailed extends MaintainabilityAnalysisFailed_base {
   get message(): string;
 }
 declare const GitInvocationFailed_base: Class<GitInvocationFailed, TaggedStruct<"GitInvocationFailed", {
@@ -10871,7 +10850,7 @@ declare class GitBaseBranchInvalid extends GitBaseBranchInvalid_base {
   get message(): string;
 }
 declare const ReactDoctorError_base: Class<ReactDoctorError, TaggedStruct<"ReactDoctorError", {
-  readonly reason: Union<readonly [typeof OxlintUnavailable, typeof OxlintBatchExceeded, typeof ScanDeadlineExceeded, typeof OxlintSpawnFailed, typeof OxlintOutputUnparseable, typeof ConfigParseFailed, typeof ProjectNotFound, typeof NoReactDependency, typeof AmbiguousProject, typeof ProjectDiscoveryFailed, typeof DeadCodeAnalysisFailed, typeof GitInvocationFailed, typeof GitBaseBranchMissing, typeof GitBaseBranchInvalid]>;
+  readonly reason: Union<readonly [typeof OxlintUnavailable, typeof OxlintBatchExceeded, typeof ScanDeadlineExceeded, typeof OxlintSpawnFailed, typeof OxlintOutputUnparseable, typeof ConfigParseFailed, typeof ProjectNotFound, typeof NoReactDependency, typeof AmbiguousProject, typeof ProjectDiscoveryFailed, typeof MaintainabilityAnalysisFailed, typeof GitInvocationFailed, typeof GitBaseBranchMissing, typeof GitBaseBranchInvalid]>;
 }>, YieldableError>;
 declare class ReactDoctorError extends ReactDoctorError_base {
   get message(): string;