react-doctor 0.9.12-dev.ffc2d14 → 0.9.13-dev.d030b11

package/dist/{unref-stdin-BxyvqsOy.js → telemetry-runtime-hAsPFFEx.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]="2bee1c15-4924-512e-8abd-f6f764de1963")}catch(e){}}();
-import { Hn as buildWithScope, Jt as isProjectDiscoveryError, Kn as close, Ln as runPromise, On as make, Qt as layerObservability, R as CliInputError, Rn as runSync, Sr as messageFromUnknown, Yn as void_, Yt as isReactDoctorError, g as VERSION, i as isTelemetryEnabled, qn as makeUnsafe, yr as isErrnoException } from "./record-metric-CFfsgcVs.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]="b824371a-8ecd-5990-9b33-5fdf5feb5168")}catch(e){}}();
+import { $t as layerObservability, Cr as messageFromUnknown, Jn as makeUnsafe, Rn as runPromise, Un as buildWithScope, Xn as void_, Xt as isReactDoctorError, Yt as isProjectDiscoveryError, _ as VERSION, br as isErrnoException, i as isTelemetryEnabled, kn as make, qn as close, z as CliInputError, zn as runSync } from "./record-metric-BRc98SXW.js";
 //#region src/cli/utils/is-environment-error.ts
 const ENVIRONMENT_ERROR_CODES = new Set([
 	"EACCES",
@@ -61,6 +61,51 @@ const formatEnvironmentError = (error) => {
 	}
 };
 //#endregion
+//#region src/cli/utils/is-npm-cache-corruption-error.ts
+const MISSING_AJV_META_SCHEMA_MESSAGES = new Set(["Cannot find module './meta/unevaluated.json'", "Cannot find module './meta/validation.json'"]);
+const NPX_AJV_META_SCHEMA_REQUIRE_PATH_PATTERN = /(?:^|\/)_npx\/(?<cacheKey>[a-f0-9]{16})\/node_modules\/ajv\/dist\/refs\/json-schema-2020-12\/index\.js$/;
+const isModuleNotFoundError = (error) => error instanceof Error && "code" in error && error.code === "MODULE_NOT_FOUND";
+const findNpmCacheCorruptionError = (error) => {
+	const pendingErrors = [error];
+	const visitedErrors = /* @__PURE__ */ new Set();
+	while (pendingErrors.length > 0) {
+		const currentError = pendingErrors.pop();
+		if (typeof currentError !== "object" || currentError === null) continue;
+		if (visitedErrors.has(currentError)) continue;
+		visitedErrors.add(currentError);
+		if (isModuleNotFoundError(currentError)) {
+			const [message] = currentError.message.split("\n");
+			if (message && MISSING_AJV_META_SCHEMA_MESSAGES.has(message)) {
+				const requireStack = Array.isArray(currentError.requireStack) ? currentError.requireStack : [];
+				for (const requirePath of requireStack) {
+					if (typeof requirePath !== "string") continue;
+					const cacheKey = requirePath.replaceAll("\\", "/").match(NPX_AJV_META_SCHEMA_REQUIRE_PATH_PATTERN)?.groups?.cacheKey;
+					if (cacheKey !== void 0) return {
+						cacheKey,
+						moduleNotFoundError: currentError
+					};
+				}
+			}
+		}
+		if (currentError instanceof Error && currentError.cause !== void 0) pendingErrors.push(currentError.cause);
+	}
+	return null;
+};
+const isNpmCacheCorruptionError = (error) => findNpmCacheCorruptionError(error) !== null;
+const formatNpmCacheCorruptionError = (error) => {
+	const corruptionMatch = findNpmCacheCorruptionError(error);
+	if (!corruptionMatch) return messageFromUnknown(error);
+	return [
+		"The npx cache has an incomplete Ajv installation.",
+		"",
+		"Remove this cache entry, then run React Doctor again:",
+		`  npm cache npx rm ${corruptionMatch.cacheKey}`,
+		"  npx react-doctor@latest",
+		"",
+		`Original error: ${corruptionMatch.moduleNotFoundError.message}`
+	].join("\n");
+};
+//#endregion
 //#region src/cli/utils/is-expected-user-error.ts
 /**
 * Whether `error` is an expected, user-actionable failure — the user's project
@@ -69,7 +114,7 @@ const formatEnvironmentError = (error) => {
 * `handleUserError` (a plain message — no "Something went wrong", prefilled
 * issue, Discord link, or Sentry reference), since there is no bug to report.
 *
-* Four distinct shapes reach the CLI's catch blocks:
+* Five distinct shapes reach the CLI's catch blocks:
 *
 * - **Project-discovery failures** (`NoReactDependencyError`,
 *   `ProjectNotFoundError`, `PackageJsonNotFoundError`, `NotADirectoryError`,
@@ -89,12 +134,15 @@ const formatEnvironmentError = (error) => {
 *   actionable message instead of crashing. See `is-environment-error.ts` for
 *   why the set stays narrow (codes that usually mean our bug keep reaching
 *   Sentry).
+* - **npm cache corruption** (missing Ajv meta-schema files inside `_npx`) —
+*   an incomplete npx package installation that the user can remove and
+*   reinstall.
 *
 * This composes the existing core narrowers rather than introducing a new
 * error-shape helper (AGENTS.md): it encodes CLI-layer reporting policy, not
 * knowledge of the `ReactDoctorError` shape.
 */
-const isExpectedUserError = (error) => error instanceof CliInputError || isProjectDiscoveryError(error) || isEnvironmentError(error) || isReactDoctorError(error) && (error.reason._tag === "GitBaseBranchInvalid" || error.reason._tag === "GitBaseBranchMissing");
+const isExpectedUserError = (error) => error instanceof CliInputError || isProjectDiscoveryError(error) || isEnvironmentError(error) || isNpmCacheCorruptionError(error) || isReactDoctorError(error) && (error.reason._tag === "GitBaseBranchInvalid" || error.reason._tag === "GitBaseBranchMissing");
 //#endregion
 //#region src/cli/utils/resolve-axiom-telemetry-options.ts
 /**
@@ -197,25 +245,7 @@ const shutdownTelemetry = async () => {
 	return pendingShutdown;
 };
 //#endregion
-//#region src/cli/utils/active-run-trace.ts
-let activeRunTrace = null;
-const setActiveRunTrace = (trace) => {
-	activeRunTrace = trace;
-};
-const getActiveRunTrace = () => activeRunTrace;
-let lastRunTraceId = null;
-const recordRunTraceId = (traceId) => {
-	lastRunTraceId = traceId;
-};
-const getLastRunTraceId = () => lastRunTraceId;
-//#endregion
-//#region src/cli/utils/unref-stdin.ts
-const unrefStdin = () => {
-	if (process.stdin.isTTY) return;
-	process.stdin.unref?.();
-};
-//#endregion
-export { setActiveRunTrace as a, isExpectedUserError as c, recordRunTraceId as i, formatEnvironmentError as l, getActiveRunTrace as n, getTelemetryContext as o, getLastRunTraceId as r, shutdownTelemetry as s, unrefStdin as t, isEnvironmentError as u };
+export { isNpmCacheCorruptionError as a, formatNpmCacheCorruptionError as i, shutdownTelemetry as n, formatEnvironmentError as o, isExpectedUserError as r, isEnvironmentError as s, getTelemetryContext as t };
 
-//# sourceMappingURL=unref-stdin-BxyvqsOy.js.map
-//# debugId=2bee1c15-4924-512e-8abd-f6f764de1963
+//# sourceMappingURL=telemetry-runtime-hAsPFFEx.js.map
+//# debugId=b824371a-8ecd-5990-9b33-5fdf5feb5168

package/dist/unref-stdin-SK3WfwxS.js

@@ -0,0 +1,12 @@
+//#region src/cli/utils/unref-stdin.ts
+
+!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]="8f48a2ed-e79f-5438-90a2-8ef096b5fd64")}catch(e){}}();
+const unrefStdin = () => {
+	if (process.stdin.isTTY) return;
+	process.stdin.unref?.();
+};
+//#endregion
+export { unrefStdin as t };
+
+//# sourceMappingURL=unref-stdin-SK3WfwxS.js.map
+//# debugId=8f48a2ed-e79f-5438-90a2-8ef096b5fd64

package/dist/{version-S-8vvWFi.js → version-BiWDQQgs.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]="eed18eb6-7b08-5c0f-9206-65fc4aadea43")}catch(e){}}();
-import { g as VERSION, t as recordCount, w as METRIC } from "./record-metric-CFfsgcVs.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]="6bf87c94-f918-500b-8ac0-da6f0c4c61a9")}catch(e){}}();
+import { T as METRIC, _ as VERSION, t as recordCount } from "./record-metric-BRc98SXW.js";
 //#region src/cli/commands/version.ts
 /**
 * oclif-style version line. 12-factor CLI Apps (#3, "What version am I
@@ -17,5 +17,5 @@ const versionAction = () => {
 //#endregion
 export { versionAction };
 
-//# sourceMappingURL=version-S-8vvWFi.js.map
-//# debugId=eed18eb6-7b08-5c0f-9206-65fc4aadea43
+//# sourceMappingURL=version-BiWDQQgs.js.map
+//# debugId=6bf87c94-f918-500b-8ac0-da6f0c4c61a9

package/dist/{why-DXfx0oL9.js → why-B8sLOroq.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]="fd7f3a9f-2a0e-58d7-b42a-f5ded8bef85d")}catch(e){}}();
-import { t as inspectAction } from "./inspect-g3_lzs3l.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]="c6c61d23-0133-5dfa-8c42-9fe2484e5cd3")}catch(e){}}();
+import { t as inspectAction } from "./inspect-BZ-i49rK.js";
 //#region src/cli/commands/why.ts
 /**
 * `why <file:line>` — explains why a rule fired (or why a suppression didn't
@@ -17,5 +17,5 @@ const whyAction = async (location, options) => {
 //#endregion
 export { whyAction };
 
-//# sourceMappingURL=why-DXfx0oL9.js.map
-//# debugId=fd7f3a9f-2a0e-58d7-b42a-f5ded8bef85d
+//# sourceMappingURL=why-B8sLOroq.js.map
+//# debugId=c6c61d23-0133-5dfa-8c42-9fe2484e5cd3

package/dist/with-run-span-BWmpgEhA.js

@@ -0,0 +1,110 @@
+
+!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]="0e4a0091-a5d8-5683-85fa-9b96cb60efdc")}catch(e){}}();
+import { D as NANOSECONDS_PER_MILLISECOND, In as provideContext, Xn as void_, Yn as fail, c as setSentryProjectInfo, jn as makeSpan, o as buildSentryScope, r as toSpanAttributes, s as buildSentryProjectContext, zn as runSync } from "./record-metric-BRc98SXW.js";
+import { t as getTelemetryContext } from "./telemetry-runtime-hAsPFFEx.js";
+import { i as setActiveRunTrace, r as recordRunTraceId } from "./active-run-trace-dlIZeEvb.js";
+//#region src/cli/utils/with-run-span.ts
+/**
+* Ends the run span without letting a telemetry failure change the run's
+* outcome — the invariant every other emit site here already holds.
+*
+* The failure path is the reason this matters most: a throw from `end` there
+* would replace the user's original scan error, so a project-config mistake
+* could surface as an exporter stack trace, be reclassified as a crash, and get
+* reported as one.
+*/
+const endSpanSafely = (span, exit) => {
+	try {
+		span.end(BigInt(Date.now()) * NANOSECONDS_PER_MILLISECOND, exit);
+	} catch {}
+};
+/**
+* Clears the module-level run-scoped telemetry state — the current scanned
+* project and the active run trace. `inspect()` calls this at the start of every
+* run and again after a clean one, so a prior or just-finished scan can't attach
+* its project tags / trace to a later run or to a non-scan error (e.g.
+* inspectAction's post-loop finalize/handoff steps). A thrown scan error skips
+* the post-run reset, leaving the state for the command catch to attribute and
+* link the crash. Concurrent batch members (`concurrentScan`) never touch this
+* state — they neither write nor reset it. Safe to call when telemetry is off
+* (the refs are read only when an event is built).
+*/
+const resetSentryRunState = () => {
+	setSentryProjectInfo(null);
+	setActiveRunTrace(null);
+};
+/**
+* Runs an inspect invocation inside a root span so each `react-doctor` run is a
+* first-class trace with timing and the run snapshot as attributes. The span is
+* handed to `run` so the scan's Effect spans parent under it and so the wide
+* event can be stamped onto it once the outcome is known.
+*
+* A no-op pass-through when telemetry is off (`--no-telemetry`, tests, or an
+* unconfigured build) — `run` receives `undefined` and no span is created, so
+* there's no added exit latency.
+*
+* The span is created against the shared telemetry context rather than a
+* freshly-provided layer, so it lives in the same tracer as the scan program's
+* spans; see `telemetry-runtime.ts` for why that matters. It is started and
+* ended manually because the body it wraps is a promise-returning imperative
+* function, not an Effect — the same shape the Sentry inactive span had.
+*
+* While the span runs, its trace context is recorded as the active run trace so
+* `reportErrorToSentry` can attach a crash thrown during the scan back to this
+* trace (errors surface in the command catch, after the span has ended).
+*
+* A `concurrentScan` (one member of the CLI's multi-project pool) still gets its
+* own root span, but skips recording the active run trace — the module-level
+* handle has single-scan semantics, and overlapping writers would link a crash
+* to an arbitrary sibling's trace.
+*/
+const withRunSpan = async (run, options = {}) => {
+	const telemetryContext = getTelemetryContext();
+	if (telemetryContext === null) return run(void 0);
+	const { tags } = buildSentryScope();
+	const command = typeof tags.command === "string" ? tags.command : "inspect";
+	let rootSpan;
+	try {
+		rootSpan = runSync(makeSpan(`react-doctor ${command}`, { attributes: toSpanAttributes(tags) }).pipe(provideContext(telemetryContext)));
+	} catch {
+		return run(void 0);
+	}
+	recordRunTraceId(rootSpan.traceId);
+	if (options.concurrentScan !== true) setActiveRunTrace({
+		traceId: rootSpan.traceId,
+		spanId: rootSpan.spanId,
+		sampled: rootSpan.sampled
+	});
+	try {
+		const result = await run(rootSpan);
+		endSpanSafely(rootSpan, void_);
+		return result;
+	} catch (error) {
+		endSpanSafely(rootSpan, fail(options.mapErrorForSpan?.(error) ?? error));
+		throw error;
+	}
+};
+/**
+* Records the scanned project (discovered in the `beforeLint` hook): remembers
+* it for the lazy Sentry error-capture path (`buildSentryScope` folds it into
+* exception events) and for per-emit metric attributes, and sets it on the run's
+* root span so the trace carries the project shape too. Always cheap — the span
+* attributes are skipped when `rootSpan` is absent (telemetry off), and storing
+* the info is a plain assignment.
+*
+* A `concurrentScan` only sets the span attributes: the module-level project ref
+* has single-scan semantics, and overlapping writers would stamp events and
+* metrics with an arbitrary sibling's project. Wide events keep full attribution
+* (they ride the span); per-emit metrics simply omit the project shape during a
+* concurrent batch (absent, never wrong).
+*/
+const recordSentryProjectContext = (projectInfo, rootSpan, options = {}) => {
+	if (options.concurrentScan !== true) setSentryProjectInfo(projectInfo);
+	if (rootSpan === void 0) return;
+	for (const [key, value] of Object.entries(toSpanAttributes(buildSentryProjectContext(projectInfo).tags))) rootSpan.attribute(key, value);
+};
+//#endregion
+export { resetSentryRunState as n, withRunSpan as r, recordSentryProjectContext as t };
+
+//# sourceMappingURL=with-run-span-BWmpgEhA.js.map
+//# debugId=0e4a0091-a5d8-5683-85fa-9b96cb60efdc

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-doctor",
-  "version": "0.9.12-dev.ffc2d14",
+  "version": "0.9.13-dev.d030b11",
   "description": "Your agent writes bad React. This catches it",
   "keywords": [
     "accessibility",
@@ -53,19 +53,22 @@
     "@astrojs/compiler": "^4.0.0",
     "@sentry/node": "^10.54.0",
     "agent-install": "0.0.5",
+    "bippy": "^0.6.1",
     "conf": "^15.1.0",
     "confbox": "^0.2.4",
     "eslint-plugin-react-hooks": "^7.1.1",
+    "is-unicode-supported": "^2.1.0",
     "jiti": "^2.7.0",
     "magicast": "^0.5.3",
-    "oxc-parser": "^0.144.0",
+    "oxc-parser": "^0.146.0",
     "oxc-resolver": "^11.24.2",
-    "oxlint": ">=1.78.0 <1.79.0",
+    "oxlint": ">=1.79.0 <1.80.0",
+    "playwright-core": "^1.62.1",
     "prompts": "^2.4.2",
     "typescript": ">=5.0.4 <6",
     "yaml": "^2.9.0",
     "yoga-layout": "~3.2.1",
-    "oxlint-plugin-react-doctor": "0.9.12-dev.ffc2d14"
+    "oxlint-plugin-react-doctor": "0.9.13-dev.d030b11"
   },
   "devDependencies": {
     "@types/babel__code-frame": "^7.27.0",
@@ -78,8 +81,8 @@
     "ora": "^9.4.0",
     "react": "19.2.5",
     "react-devtools-core": "^7.0.1",
-    "@react-doctor/core": "0.9.12",
-    "@react-doctor/api": "0.9.12"
+    "@react-doctor/api": "0.9.13",
+    "@react-doctor/core": "0.9.13"
   },
   "engines": {
     "node": "^20.19.0 || >=22.13.0"

package/dist/scan-4I1mvxBO.js

@@ -1,53 +0,0 @@
-
-!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]="51399d27-1dd4-55db-9fa5-7f925bd3ec8f")}catch(e){}}();
-import { dn as resolveScanTarget, t as recordCount, w as METRIC, z as isNonInteractiveEnvironment } from "./record-metric-CFfsgcVs.js";
-import { i as warnDeprecatedDiff } from "./resolve-scope-CXS-5jLR.js";
-import { _ as resolveCliInspectOptions, i as validateModeFlags } from "./should-fail-scan-gate-C0Bo5Gqy.js";
-import { n as warnDeprecatedFailOn, r as runProjectMigrations, t as inspectAction } from "./inspect-g3_lzs3l.js";
-import path from "node:path";
-//#region src/cli/utils/should-use-tui.ts
-const shouldUseTui = (input) => {
-	if (input.isNonInteractiveEnvironment || !input.stdinIsTty || !input.stdoutIsTty || !input.supportsRawMode || input.nodeMajorVersion < 22 || input.terminalName === "dumb") return false;
-	const flags = input.flags;
-	return !(flags.score === true || flags.json === true || flags.jsonCompact === true || flags.jsonOut !== void 0 || flags.staged === true || flags.changedFilesFrom !== void 0);
-};
-//#endregion
-//#region src/cli/commands/scan.ts
-const runScanCommand = async (input) => {
-	if (input.flags.cache === false) process.env.REACT_DOCTOR_NO_CACHE = "1";
-	const nodeMajorVersion = Number(process.versions.node.split(".")[0]);
-	if (!shouldUseTui({
-		flags: input.flags,
-		isNonInteractiveEnvironment: isNonInteractiveEnvironment(),
-		nodeMajorVersion,
-		stdinIsTty: process.stdin.isTTY === true,
-		stdoutIsTty: process.stdout.isTTY === true,
-		supportsRawMode: typeof process.stdin.setRawMode === "function",
-		terminalName: process.env.TERM
-	})) {
-		await inspectAction(input.directory, input.flags, input.invocationCommand);
-		return;
-	}
-	await runProjectMigrations(path.resolve(input.directory));
-	const scanTarget = await resolveScanTarget(input.directory, { allowAmbiguous: true });
-	validateModeFlags(input.flags);
-	warnDeprecatedFailOn(input.flags, scanTarget.userConfig);
-	warnDeprecatedDiff(input.flags, scanTarget.userConfig);
-	recordCount(METRIC.cliInvoked, 1, { command: input.invocationCommand });
-	const { runScanApp } = await import("./run-scan-app-CDDu7P32.js");
-	const { shouldFail } = await runScanApp({
-		directory: input.directory,
-		scanTarget,
-		options: resolveCliInspectOptions(input.flags, null),
-		projectFlag: input.flags.project,
-		skipPrompts: input.flags.yes ?? false,
-		blocking: input.flags.blocking ?? input.flags.failOn,
-		flags: input.flags
-	});
-	if (shouldFail) process.exitCode = 1;
-};
-//#endregion
-export { runScanCommand };
-
-//# sourceMappingURL=scan-4I1mvxBO.js.map
-//# debugId=51399d27-1dd4-55db-9fa5-7f925bd3ec8f