react-doctor 0.6.3 → 0.7.0-dev.6b21b70

package/dist/index.js

@@ -1,5 +1,5 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="8565c6ea-39f3-51e6-895a-ae9f7c026d0e")}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]="07deeb70-f47f-5572-9930-e743f970f84f")}catch(e){}}();
 import { r as __toESM$1, t as __commonJSMin$1 } from "./chunk-N93fKeF6.js";
 import { createRequire } from "node:module";
 import * as NFS from "node:fs";
@@ -9,7 +9,7 @@ import path from "node:path";
 import * as NodeChildProcess from "node:child_process";
 import { execFileSync, spawn, spawnSync } from "node:child_process";
 import * as ts from "typescript";
-import reactDoctorPlugin, { ALL_REACT_DOCTOR_RULE_KEYS, CROSS_FILE_RULE_IDS, FRAMEWORK_SPECIFIC_RULE_KEYS, MOTION_LIBRARY_PACKAGES, REACT_COMPILER_RULES, REACT_DOCTOR_RULES, classifySecurityScanFile, shouldReadSecurityScanContent } from "oxlint-plugin-react-doctor";
+import reactDoctorPlugin, { ALL_REACT_DOCTOR_RULE_KEYS, CROSS_FILE_DEPENDENCY_COLLECTORS, CROSS_FILE_RULE_IDS, FRAMEWORK_SPECIFIC_RULE_KEYS, MOTION_LIBRARY_PACKAGES, REACT_COMPILER_RULES, REACT_DOCTOR_RULES, classifySecurityScanFile, collectCrossFileDependencyProbes, shouldReadSecurityScanContent } from "oxlint-plugin-react-doctor";
 import * as OS from "node:os";
 import os from "node:os";
 import { parseJSON5 } from "confbox";
@@ -18,6 +18,7 @@ import { fileURLToPath } from "node:url";
 import { createJiti } from "jiti";
 import * as Crypto from "node:crypto";
 import crypto, { createHash } from "node:crypto";
+import { ANALYZED_MANIFEST_FILENAMES, DEFAULT_EXTENSIONS } from "deslop-js/analyzed-inputs";
 import { gzipSync } from "node:zlib";
 //#region ../../node_modules/.pnpm/effect@4.0.0-beta.70/node_modules/effect/dist/Pipeable.js
 /**
@@ -19373,6 +19374,16 @@ var JsonReportV1 = class extends Class("JsonReportV1")({
 	* successful `baseline` run (`schemaVersion: 2`) and on non-compare scopes.
 	*/
 	baselineDegraded: optional(Boolean$1),
+	/**
+	* Whether any scanned project resolved a React-compatible runtime (React
+	* or Preact). `false` means every React-runtime rule family was gated off,
+	* so an empty `diagnostics` array is vacuous — NOT the same as a clean
+	* React scan. Consumers gating on the report (CI, verifiers, hooks) should
+	* treat `reactDetected === false` as "wrong scan target", not "all clear".
+	* Absent when nothing was scanned (`projects` is empty), on error reports,
+	* and on reports from older CLI versions.
+	*/
+	reactDetected: optional(Boolean$1),
 	diff: NullOr(JsonReportDiffInfo),
 	projects: ArraySchema(JsonReportProjectEntry),
 	diagnostics: ArraySchema(Diagnostic),
@@ -19398,6 +19409,8 @@ var JsonReportV2 = class extends Class("JsonReportV2")({
 	ok: Boolean$1,
 	directory: String$1,
 	mode: JsonReportMode,
+	/** See `JsonReportV1.reactDetected`. */
+	reactDetected: optional(Boolean$1),
 	diff: NullOr(JsonReportDiffInfo),
 	baseline: JsonReportBaseline,
 	projects: ArraySchema(JsonReportProjectEntry),
@@ -32927,10 +32940,15 @@ const SOCKET_PACKAGE_PAGE_BASE = "https://socket.dev/npm/package";
 const SOCKET_FREE_USER_AGENT = "react-doctor-supply-chain";
 const FILE_LINT_CACHE_FILENAME = "file-lint-cache.json";
 const FILE_LINT_CACHE_MAX_FILE_COUNT = 5e4;
+const SIDECAR_LINT_CACHE_FILENAME = "sidecar-lint-cache.json";
+const CORE_PACKAGE_VERSION = "0.7.0";
+const DEAD_CODE_CACHE_FILENAME = "dead-code-cache.json";
+const DEAD_CODE_SUMMARY_CACHE_FILENAME = "dead-code-summaries.json";
 const SUPPLY_CHAIN_PLUGIN = "socket";
 const SUPPLY_CHAIN_RULE = "low-supply-chain-score";
 const SUPPLY_CHAIN_CATEGORY = "Security";
 const SUPPLY_CHAIN_OVERLAP_TIMEOUT_MS = 9e4;
+const SUPPLY_CHAIN_CACHE_TTL_MS = 864e5;
 const SUPPLY_CHAIN_CACHE_SUBDIR = "supply-chain";
 const SUPPLY_CHAIN_IGNORED_PACKAGES = new Set(["next"]);
 const hasIgnoredPathSegment = (relativePath) => relativePath.split(/[/\\]/).slice(0, -1).some((segment) => IGNORED_DIRECTORIES.has(segment));
@@ -35613,6 +35631,48 @@ var PerFileLintCacheEnabled = class extends Reference("react-doctor/PerFileLintC
 	if (CACHE_DISABLED_VALUES.has(noFileCache)) return false;
 	return true;
 } }) {};
+/**
+* Whether the sidecar lint cache (`runners/oxlint/sidecar-lint-cache.ts`) is
+* active. Defaults ON — warm rescans replay the cross-file rules' cached
+* diagnostics for every file whose dependency fingerprint (the probe set the
+* plugin's collectors recorded) still matches the tree, and re-lint only the
+* rest. Only reachable when the per-file lint cache itself is on (the
+* sidecar covers its cache hits), so `REACT_DOCTOR_NO_CACHE` /
+* `REACT_DOCTOR_NO_FILE_CACHE` implicitly disable it too. Opt-OUT knobs:
+*
+*   - `REACT_DOCTOR_NO_CACHE` — the global off-switch.
+*   - `REACT_DOCTOR_NO_SIDECAR_CACHE` — granular rollback hatch: keep the
+*     per-file cache but run the always-fresh sidecar over every hit
+*     (the pre-cache behavior).
+*
+* Tests override via `Layer.succeed(SidecarLintCacheEnabled, false)`.
+*/
+var SidecarLintCacheEnabled = class extends Reference("react-doctor/SidecarLintCacheEnabled", { defaultValue: () => {
+	const noCache = process.env["REACT_DOCTOR_NO_CACHE"]?.toLowerCase() ?? "";
+	const noSidecarCache = process.env["REACT_DOCTOR_NO_SIDECAR_CACHE"]?.toLowerCase() ?? "";
+	if (CACHE_DISABLED_VALUES.has(noCache)) return false;
+	if (CACHE_DISABLED_VALUES.has(noSidecarCache)) return false;
+	return true;
+} }) {};
+/**
+* Whether the whole-project dead-code result cache
+* (`dead-code/dead-code-result-cache.ts`) is active. Defaults ON — a rescan
+* whose inputs (source tree, manifests, configs, analyzer version) are
+* unchanged replays the stored diagnostics instead of re-running the
+* analysis worker. Opt-OUT, two knobs (matching the per-file lint cache):
+*
+*   - `REACT_DOCTOR_NO_CACHE` — the global off-switch.
+*   - `REACT_DOCTOR_NO_DEAD_CODE_CACHE` — granular: bust only this cache.
+*
+* Tests override via `Layer.succeed(DeadCodeResultCacheEnabled, false)`.
+*/
+var DeadCodeResultCacheEnabled = class extends Reference("react-doctor/DeadCodeResultCacheEnabled", { defaultValue: () => {
+	const noCache = process.env["REACT_DOCTOR_NO_CACHE"]?.toLowerCase() ?? "";
+	const noDeadCodeCache = process.env["REACT_DOCTOR_NO_DEAD_CODE_CACHE"]?.toLowerCase() ?? "";
+	if (CACHE_DISABLED_VALUES.has(noCache)) return false;
+	if (CACHE_DISABLED_VALUES.has(noDeadCodeCache)) return false;
+	return true;
+} }) {};
 const DIAGNOSTIC_SURFACES = [
 	"cli",
 	"prComment",
@@ -36962,10 +37022,17 @@ function* collectSecurityScanFiles(rootDirectory) {
 		}
 	}
 }
+/**
+* Whether project discovery resolved a React-compatible runtime (React or
+* Preact, which ships the same hooks + JSX model). This is the same
+* predicate that grants the `react` capability, so `false` means every
+* React-runtime rule family was gated off for the project.
+*/
+const hasReactRuntime = (project) => project.reactVersion !== null || project.preactVersion !== null;
 const buildCapabilities = (project) => {
 	const capabilities = /* @__PURE__ */ new Set();
 	capabilities.add(project.framework);
-	if (project.reactVersion !== null || project.preactVersion !== null) capabilities.add("react");
+	if (hasReactRuntime(project)) capabilities.add("react");
 	if (project.framework === "expo" || project.framework === "react-native" || project.hasReactNativeWorkspace) capabilities.add("react-native");
 	if (project.expoVersion !== null) capabilities.add("expo");
 	if (project.nextjsMajorVersion !== null && project.nextjsMajorVersion >= 15) capabilities.add("nextjs:15");
@@ -37301,6 +37368,146 @@ const collectDeadCodeIgnorePatterns = (rootDirectory) => {
 	return [...seen].filter((pattern) => pattern.length > 0);
 };
 const collectDeadCodeEntryPatterns = (rootDirectory) => [...new Set(collectKnipPatterns(rootDirectory, "entry"))].filter((pattern) => pattern.length > 0);
+const atomicWriteJson = (filePath, value) => {
+	try {
+		NFS.mkdirSync(Path.dirname(filePath), { recursive: true });
+		const temporaryPath = `${filePath}.${process.pid}.tmp`;
+		NFS.writeFileSync(temporaryPath, JSON.stringify(value));
+		NFS.renameSync(temporaryPath, filePath);
+	} catch {
+		return;
+	}
+};
+const failOpenReadJson = (filePath, fallback) => {
+	try {
+		return JSON.parse(NFS.readFileSync(filePath, "utf8"));
+	} catch {
+		return fallback;
+	}
+};
+const hashFileContents = (filePath) => {
+	try {
+		return crypto.createHash("sha1").update(NFS.readFileSync(filePath)).digest("hex");
+	} catch {
+		return null;
+	}
+};
+const ANALYZED_FILE_EXTENSIONS = new Set(DEFAULT_EXTENSIONS);
+const CORE_SIDE_MANIFEST_NAMES = ["knip.json", "deno.lock"];
+const ANALYZED_MANIFEST_NAMES = new Set([...ANALYZED_MANIFEST_FILENAMES, ...CORE_SIDE_MANIFEST_NAMES]);
+const isTsConfigLikeFile = (fileName) => (fileName.startsWith("tsconfig") || fileName.startsWith("jsconfig")) && fileName.endsWith(".json");
+const isFingerprintedFile = (fileName) => ANALYZED_FILE_EXTENSIONS.has(Path.extname(fileName).toLowerCase()) || ANALYZED_MANIFEST_NAMES.has(fileName) || isTsConfigLikeFile(fileName);
+/**
+* Stat snapshot of every file the analysis reads, keyed by root-relative
+* `/`-separated path. Taken BEFORE the (long) analysis so a stored result is
+* verified against the tree it started from.
+*/
+const collectAnalyzedFileStats = (rootDirectory) => {
+	const statByRelativePath = /* @__PURE__ */ new Map();
+	for (const { absolutePath, name } of walkSourceTreeFiles(rootDirectory)) {
+		if (!isFingerprintedFile(name)) continue;
+		try {
+			const fileStat = NFS.statSync(absolutePath);
+			const relativePath = Path.relative(rootDirectory, absolutePath).replace(/\\/g, "/");
+			statByRelativePath.set(relativePath, {
+				mtimeMs: fileStat.mtimeMs,
+				size: fileStat.size
+			});
+		} catch {}
+	}
+	return statByRelativePath;
+};
+const bundledRequire$2 = createRequire(import.meta.url);
+const resolveDeslopVersion = () => {
+	try {
+		const packageJson = JSON.parse(NFS.readFileSync(bundledRequire$2.resolve("deslop-js/package.json"), "utf8"));
+		return isRecord(packageJson) && typeof packageJson.version === "string" ? packageJson.version : "unknown";
+	} catch {
+		return "unknown";
+	}
+};
+const computeDeadCodeCacheKey = (input) => crypto.createHash("sha1").update(JSON.stringify({
+	schemaVersion: 2,
+	coreVersion: input.coreVersion,
+	deslopVersion: resolveDeslopVersion(),
+	deslopJsModuleSpecifier: input.deslopJsModuleSpecifier,
+	entryPatterns: input.entryPatterns,
+	ignorePatterns: input.ignorePatterns,
+	tsConfigFile: input.tsConfigPath === void 0 ? null : Path.relative(input.rootDirectory, input.tsConfigPath).replace(/\\/g, "/")
+})).digest("hex");
+const validateDiagnostic$2 = decodeUnknownSync(Diagnostic);
+const decodeCachedDiagnostics = (raw) => {
+	try {
+		for (const entry of raw) validateDiagnostic$2(entry);
+		return raw;
+	} catch {
+		return null;
+	}
+};
+const isPersistedFileIdentity = (value) => Array.isArray(value) && value.length === 3 && typeof value[0] === "number" && typeof value[1] === "number" && typeof value[2] === "string";
+const lookupDeadCodeResultCache = (input) => {
+	const cacheFilePath = Path.join(input.cacheDirectory, DEAD_CODE_CACHE_FILENAME);
+	const persisted = failOpenReadJson(cacheFilePath, null);
+	if (persisted === null || !isRecord(persisted) || persisted.version !== 2 || persisted.key !== input.cacheKey || !isRecord(persisted.files) || !Array.isArray(persisted.diagnostics)) return null;
+	const storedFileEntries = Object.entries(persisted.files);
+	if (storedFileEntries.length !== input.currentFileStats.size) return null;
+	const repairedFiles = {};
+	let repairedCount = 0;
+	for (const [relativePath, storedIdentity] of storedFileEntries) {
+		if (!isPersistedFileIdentity(storedIdentity)) return null;
+		const currentStat = input.currentFileStats.get(relativePath);
+		if (currentStat === void 0) return null;
+		const [storedMtimeMs, storedSize, storedContentHash] = storedIdentity;
+		if (currentStat.mtimeMs === storedMtimeMs && currentStat.size === storedSize) {
+			repairedFiles[relativePath] = storedIdentity;
+			continue;
+		}
+		if (currentStat.size !== storedSize) return null;
+		const currentContentHash = hashFileContents(Path.join(input.rootDirectory, relativePath));
+		if (currentContentHash === null || currentContentHash !== storedContentHash) return null;
+		repairedFiles[relativePath] = [
+			currentStat.mtimeMs,
+			currentStat.size,
+			storedContentHash
+		];
+		repairedCount += 1;
+	}
+	const diagnostics = decodeCachedDiagnostics(persisted.diagnostics);
+	if (diagnostics === null) return null;
+	if (repairedCount > 0) atomicWriteJson(cacheFilePath, {
+		version: 2,
+		key: input.cacheKey,
+		files: repairedFiles,
+		diagnostics: persisted.diagnostics
+	});
+	return diagnostics;
+};
+const storeDeadCodeResultCache = (input) => {
+	const persistedFiles = {};
+	for (const [relativePath, snapshotStat] of input.snapshotFileStats) {
+		const absolutePath = Path.join(input.rootDirectory, relativePath);
+		const contentHash = hashFileContents(absolutePath);
+		if (contentHash === null) return;
+		let currentStat;
+		try {
+			currentStat = NFS.statSync(absolutePath);
+		} catch {
+			return;
+		}
+		if (currentStat.mtimeMs !== snapshotStat.mtimeMs || currentStat.size !== snapshotStat.size) return;
+		persistedFiles[relativePath] = [
+			snapshotStat.mtimeMs,
+			snapshotStat.size,
+			contentHash
+		];
+	}
+	atomicWriteJson(Path.join(input.cacheDirectory, DEAD_CODE_CACHE_FILENAME), {
+		version: 2,
+		key: input.cacheKey,
+		files: persistedFiles,
+		diagnostics: input.diagnostics
+	});
+};
 const readSystemFacts = () => ({
 	availableCores: os.availableParallelism(),
 	totalMemoryBytes: os.totalmem(),
@@ -37369,6 +37576,21 @@ const withDeadCodeWorkerSlot = async (task, abortSignal) => {
 		releaseSlot();
 	}
 };
+const projectCacheSubdir = (projectDirectory) => crypto.createHash("sha256").update(projectDirectory).digest("hex").slice(0, 16);
+const resolveReactDoctorCacheDir = (projectDirectory) => {
+	const cacheDirOverride = process.env["REACT_DOCTOR_CACHE_DIR"]?.trim();
+	if (cacheDirOverride) return Path.join(cacheDirOverride, projectCacheSubdir(projectDirectory));
+	const nodeModulesDirectory = Path.join(projectDirectory, "node_modules");
+	if (NFS.existsSync(nodeModulesDirectory)) return Path.join(nodeModulesDirectory, ".cache", "react-doctor");
+	return Path.join(os.tmpdir(), `react-doctor-cache-${resolveUserCacheScope()}`, projectCacheSubdir(projectDirectory));
+};
+const resolveUserCacheScope = () => {
+	try {
+		return String(process.getuid?.() ?? os.userInfo().username);
+	} catch {
+		return "shared";
+	}
+};
 /**
 * Resolves a path to its canonical, symlink-free form, falling back to
 * the input when it cannot be realpath'd (broken symlink, permission
@@ -37422,6 +37644,14 @@ process.stdin.on("end", () => {
     circularDependencies: result.circularDependencies.map((cycle) => ({
       files: cycle.files,
     })),
+    ...(result.incrementalCacheStats
+      ? {
+          summaryCacheStats: {
+            hits: result.incrementalCacheStats.summaryHits,
+            misses: result.incrementalCacheStats.summaryMisses,
+          },
+        }
+      : {}),
   });
 
   const serializeError = (error) =>
@@ -37445,6 +37675,9 @@ process.stdin.on("end", () => {
         ...(workerInput.ignorePatterns.length > 0
           ? { ignorePatterns: workerInput.ignorePatterns }
           : {}),
+        ...(workerInput.incrementalCachePath
+          ? { incrementalCachePath: workerInput.incrementalCachePath }
+          : {}),
         // We consume only deslop's GRAPH-based findings (unusedFiles, unusedExports,
         // unusedDependencies, circularDependencies). Everything else deslop can compute
         // is pure wasted work for us, and it's the bulk of the runtime:
@@ -37455,12 +37688,18 @@ process.stdin.on("end", () => {
         //     are the single most expensive pass — duplicate-block detection alone was
         //     ~83s of a ~130s Sentry scan — so skipping them is an ~8.5x dead-code
         //     speedup on a large repo.
-        // Both are provably safe: the consumed graph findings are computed by their own
+        //   - reportRedundancy: the DRY-pattern detectors (duplicate types/constants,
+        //     simplifiable functions, identity wrappers, …) — ~120 ms of discarded
+        //     output per scan, and skipping them lets the incremental cache drop the
+        //     DRY-pattern summary fields (the largest slice of the cache file).
+        // All are provably safe: the consumed graph findings are computed by their own
         // detectors, independent of these passes (confirmed byte-identical on
-        // excalidraw + mui-material + sentry). tsConfigPath stays — the module resolver
-        // needs it for path-alias resolution in the import graph.
+        // excalidraw + mui-material + sentry; re-verified on sentry after the
+        // reportRedundancy flip). tsConfigPath stays — the module resolver needs it
+        // for path-alias resolution in the import graph.
         semantic: { enabled: false },
         reportCodeQuality: false,
+        reportRedundancy: false,
       };
       const result = await analyze(defineConfig(config));
       emit({ ok: true, result: normalizeResult(result) });
@@ -37544,13 +37783,23 @@ const parseCircularDependencies = (value) => {
 	}
 	return circularDependencies;
 };
+const parseSummaryCacheStats = (value) => {
+	if (!isRecord(value)) return void 0;
+	if (typeof value.hits !== "number" || typeof value.misses !== "number") return void 0;
+	return {
+		hits: value.hits,
+		misses: value.misses
+	};
+};
 const parseDeadCodeWorkerResult = (value) => {
 	if (!isRecord(value)) throw new Error("Dead-code worker returned an invalid result.");
+	const summaryCacheStats = parseSummaryCacheStats(value.summaryCacheStats);
 	return {
 		unusedFiles: parseUnusedFiles(value.unusedFiles),
 		unusedExports: parseUnusedExports(value.unusedExports),
 		unusedDependencies: parseUnusedDependencies(value.unusedDependencies),
-		circularDependencies: parseCircularDependencies(value.circularDependencies)
+		circularDependencies: parseCircularDependencies(value.circularDependencies),
+		...summaryCacheStats ? { summaryCacheStats } : {}
 	};
 };
 const parseDeadCodeWorkerError = (value) => {
@@ -37664,17 +37913,41 @@ const checkDeadCode = async (options) => {
 	if (!NFS.existsSync(Path.join(rootDirectory, "package.json"))) return [];
 	const entryPatterns = collectDeadCodeEntryPatterns(rootDirectory);
 	const ignorePatterns = collectDeadCodeIgnorePatterns(rootDirectory);
+	const tsConfigPath = resolveTsConfigPath(rootDirectory);
+	const deslopJsModuleSpecifier = options.deslopJsModuleSpecifier ?? import.meta.resolve("deslop-js");
+	const fileStatsSnapshot = options.cacheEnabled ? collectAnalyzedFileStats(rootDirectory) : null;
+	const cacheKey = fileStatsSnapshot === null ? null : computeDeadCodeCacheKey({
+		rootDirectory,
+		entryPatterns,
+		ignorePatterns,
+		tsConfigPath,
+		deslopJsModuleSpecifier,
+		coreVersion: CORE_PACKAGE_VERSION
+	});
+	if (cacheKey !== null && fileStatsSnapshot !== null) {
+		const cachedDiagnostics = lookupDeadCodeResultCache({
+			cacheDirectory: resolveReactDoctorCacheDir(rootDirectory),
+			cacheKey,
+			rootDirectory,
+			currentFileStats: fileStatsSnapshot
+		});
+		options.onCacheOutcome?.(cachedDiagnostics !== null);
+		if (cachedDiagnostics !== null) return [...cachedDiagnostics];
+	}
+	const incrementalCachePath = options.cacheEnabled === true ? Path.join(resolveReactDoctorCacheDir(rootDirectory), DEAD_CODE_SUMMARY_CACHE_FILENAME) : void 0;
 	const spawnAndRun = () => {
 		return runDeadCodeWorkerWithTimeout((options.createWorker ?? createDeadCodeWorker)({
 			rootDirectory,
 			entryPatterns,
-			tsConfigPath: resolveTsConfigPath(rootDirectory),
+			tsConfigPath,
 			ignorePatterns,
-			deslopJsModuleSpecifier: options.deslopJsModuleSpecifier ?? import.meta.resolve("deslop-js"),
-			parseConcurrency: options.parseConcurrency
+			deslopJsModuleSpecifier,
+			parseConcurrency: options.parseConcurrency,
+			incrementalCachePath
 		}), options.workerTimeoutMs ?? 12e4, options.abortSignal);
 	};
 	const result = parseDeadCodeWorkerResult(options.createWorker === void 0 ? await withDeadCodeWorkerSlot(spawnAndRun, options.abortSignal) : await spawnAndRun());
+	if (result.summaryCacheStats !== void 0) options.onSummaryCacheStats?.(result.summaryCacheStats);
 	const toRelative = (filePath) => toRelativeFilePath(rootDirectory, filePath);
 	const diagnostics = [];
 	for (const unusedFile of result.unusedFiles) diagnostics.push({
@@ -37731,6 +38004,13 @@ const checkDeadCode = async (options) => {
 			category: DEAD_CODE_CATEGORY
 		});
 	}
+	if (cacheKey !== null && fileStatsSnapshot !== null) storeDeadCodeResultCache({
+		cacheDirectory: resolveReactDoctorCacheDir(rootDirectory),
+		cacheKey,
+		rootDirectory,
+		snapshotFileStats: fileStatsSnapshot,
+		diagnostics
+	});
 	return diagnostics;
 };
 const DEAD_CODE_RULE_KEY_PREFIX = `${DEAD_CODE_PLUGIN}/`;
@@ -37833,12 +38113,16 @@ var Config = class Config extends Service()("react-doctor/Config") {
 */
 var DeadCode = class DeadCode extends Service()("react-doctor/DeadCode") {
 	static layerNode = succeed$3(DeadCode, DeadCode.of({ run: (input) => unwrap(fn("DeadCode.run")(function* () {
+		const cacheEnabled = yield* DeadCodeResultCacheEnabled;
 		return yield* tryPromise({
 			try: (signal) => checkDeadCode({
 				rootDirectory: input.rootDirectory,
 				parseConcurrency: input.parseConcurrency,
 				workerTimeoutMs: input.workerTimeoutMs,
-				abortSignal: signal
+				abortSignal: signal,
+				cacheEnabled,
+				onCacheOutcome: input.onCacheOutcome,
+				onSummaryCacheStats: input.onSummaryCacheStats
 			}),
 			catch: (cause) => new ReactDoctorError({ reason: new DeadCodeAnalysisFailed({ cause }) })
 		}).pipe(map$3((diagnostics) => fromIterable$1(diagnostics)));
@@ -38708,7 +38992,7 @@ const buildUserPluginRules = (userPlugin, severityControls) => {
 	}
 	return enabled;
 };
-const createOxlintConfig = ({ pluginPath, project, customRulesOnly = false, extendsPaths = [], ignoredTags = /* @__PURE__ */ new Set(), serverAuthFunctionNames, severityControls, userPlugins = [], disableReactHooksJsPlugin = false, ruleSelection }) => {
+const createOxlintConfig = ({ pluginPath, project, customRulesOnly = false, extendsPaths = [], ignoredTags = /* @__PURE__ */ new Set(), serverAuthFunctionNames, severityControls, userPlugins = [], disableReactHooksJsPlugin = false, ruleSelection, sidecarRuleIdFilter }) => {
 	const reactHooksJsPlugin = disableReactHooksJsPlugin || ruleSelection === "sidecar" ? null : resolveReactHooksJsPlugin(project.hasReactCompiler, customRulesOnly);
 	const reactCompilerRules = reactHooksJsPlugin ? applyRuleSeverityControls(filterRulesToAvailable(REACT_COMPILER_RULES, "react-hooks-js", reactHooksJsPlugin.availableRuleNames), severityControls) : {};
 	const jsPlugins = [];
@@ -38720,6 +39004,7 @@ const createOxlintConfig = ({ pluginPath, project, customRulesOnly = false, exte
 		if (!rule) continue;
 		if (ruleSelection === "cacheable" && CROSS_FILE_RULE_IDS.has(registryEntry.id)) continue;
 		if (ruleSelection === "sidecar" && !CROSS_FILE_RULE_IDS.has(registryEntry.id)) continue;
+		if (ruleSelection === "sidecar" && sidecarRuleIdFilter !== void 0 && !sidecarRuleIdFilter.has(registryEntry.id)) continue;
 		if (rule.scan !== void 0) continue;
 		if (customRulesOnly && registryEntry.originallyExternal) continue;
 		if (rule.framework !== "global" && !rule.requires) continue;
@@ -38764,33 +39049,145 @@ const createOxlintConfig = ({ pluginPath, project, customRulesOnly = false, exte
 		}
 	};
 };
-const atomicWriteJson = (filePath, value) => {
+const validateDiagnostic$1 = decodeUnknownSync(Diagnostic);
+const decodeFileDiagnostics = (raw) => {
+	if (!Array.isArray(raw)) return null;
 	try {
-		NFS.mkdirSync(Path.dirname(filePath), { recursive: true });
-		const temporaryPath = `${filePath}.${process.pid}.tmp`;
-		NFS.writeFileSync(temporaryPath, JSON.stringify(value));
-		NFS.renameSync(temporaryPath, filePath);
+		for (const entry of raw) validateDiagnostic$1(entry);
+		return raw;
 	} catch {
-		return;
+		return null;
 	}
 };
-const failOpenReadJson = (filePath, fallback) => {
-	try {
-		return JSON.parse(NFS.readFileSync(filePath, "utf8"));
-	} catch {
-		return fallback;
+const emptyCache$1 = () => ({
+	version: 1,
+	rulesets: {}
+});
+const loadRulesetEntries$1 = (cacheFilePath, rulesetHash) => {
+	const entries = /* @__PURE__ */ new Map();
+	const persisted = failOpenReadJson(cacheFilePath, emptyCache$1());
+	if (persisted.version !== 1 || !isRecord(persisted.rulesets)) return entries;
+	const bucket = persisted.rulesets[rulesetHash];
+	if (!isRecord(bucket) || !isRecord(bucket.files)) return entries;
+	for (const [fileKey, rawDiagnostics] of Object.entries(bucket.files)) {
+		const decoded = decodeFileDiagnostics(rawDiagnostics);
+		if (decoded !== null) entries.set(fileKey, decoded);
 	}
+	return entries;
+};
+const createFileLintCache = (cacheDirectory, rulesetHash) => {
+	const cacheFilePath = Path.join(cacheDirectory, FILE_LINT_CACHE_FILENAME);
+	const entries = loadRulesetEntries$1(cacheFilePath, rulesetHash);
+	return {
+		lookup: (fileKey) => entries.get(fileKey) ?? null,
+		store: (fileKey, diagnostics) => {
+			entries.delete(fileKey);
+			entries.set(fileKey, diagnostics);
+		},
+		persist: () => {
+			const onDisk = failOpenReadJson(cacheFilePath, emptyCache$1());
+			const rulesets = onDisk.version === 1 && isRecord(onDisk.rulesets) ? { ...onDisk.rulesets } : {};
+			const existingBucket = rulesets[rulesetHash];
+			const existingFiles = isRecord(existingBucket) && isRecord(existingBucket.files) ? existingBucket.files : {};
+			const ourFiles = {};
+			for (const [fileKey, diagnostics] of entries) ourFiles[fileKey] = diagnostics;
+			const cappedEntries = Object.entries({
+				...existingFiles,
+				...ourFiles
+			}).slice(-FILE_LINT_CACHE_MAX_FILE_COUNT);
+			rulesets[rulesetHash] = {
+				updatedAtMs: Date.now(),
+				files: Object.fromEntries(cappedEntries)
+			};
+			atomicWriteJson(cacheFilePath, {
+				version: 1,
+				rulesets: Object.fromEntries(Object.entries(rulesets).filter(([, bucket]) => isRecord(bucket) && typeof bucket.updatedAtMs === "number").sort(([, first], [, second]) => second.updatedAtMs - first.updatedAtMs).slice(0, 8))
+			});
+		}
+	};
+};
+const ABSENT_CONTENT_ANSWER = "absent";
+/**
+* Answers dependency probes for the sidecar lint cache — used both when
+* STORING an entry (turn the collector's probe paths into answers) and when
+* VERIFYING one (re-answer each stored probe against the current tree).
+* Store and verify must agree exactly, so both go through this one resolver.
+*
+*   - `content` — SHA-1 of the file's bytes, `"absent"` when unreadable
+*     (missing, a directory, permission failure). Source files reuse the
+*     hashes the cache-partition loop already computed
+*     (`contentHashByRelativePath`); everything else (package.json,
+*     tsconfig, ignored files) is hashed on demand.
+*   - `exists` — the existence class a module-resolution candidate probe
+*     sees: `"file"`, `"dir"`, or `"none"` (missing or an exotic entry —
+*     `statSync` follows symlinks, matching the resolvers).
+*
+* Answers are memoized per scan: the filesystem is frozen for the run, and
+* hot dependency paths (a barrel imported by hundreds of files, the shared
+* tsconfig chain) repeat across many files' probe sets.
+*/
+const createSidecarProbeAnswerResolver = (input) => {
+	const contentAnswerByPath = /* @__PURE__ */ new Map();
+	const existsAnswerByPath = /* @__PURE__ */ new Map();
+	const toRelativePath = (absolutePath) => Path.relative(input.rootDirectory, absolutePath).replaceAll("\\", "/");
+	const contentAnswer = (relativePath) => {
+		const memoized = contentAnswerByPath.get(relativePath);
+		if (memoized !== void 0) return memoized;
+		const answer = input.contentHashByRelativePath.get(relativePath) ?? hashFileContents(Path.resolve(input.rootDirectory, relativePath)) ?? ABSENT_CONTENT_ANSWER;
+		contentAnswerByPath.set(relativePath, answer);
+		return answer;
+	};
+	const existsAnswer = (relativePath) => {
+		const memoized = existsAnswerByPath.get(relativePath);
+		if (memoized !== void 0) return memoized;
+		let answer;
+		try {
+			const stat = NFS.statSync(Path.resolve(input.rootDirectory, relativePath));
+			answer = stat.isFile() ? "file" : stat.isDirectory() ? "dir" : "none";
+		} catch {
+			answer = "none";
+		}
+		existsAnswerByPath.set(relativePath, answer);
+		return answer;
+	};
+	return {
+		answerFor: (kind, relativePath) => kind === "content" ? contentAnswer(relativePath) : existsAnswer(relativePath),
+		toRelativePath
+	};
 };
 const validateDiagnostic = decodeUnknownSync(Diagnostic);
-const decodeFileDiagnostics = (raw) => {
-	if (!Array.isArray(raw)) return null;
+const isProbeKind = (value) => value === "content" || value === "exists";
+const decodeSidecarFileEntry = (raw) => {
+	if (!isRecord(raw) || !Array.isArray(raw.probes) || !Array.isArray(raw.diagnostics)) return null;
+	const probes = [];
+	for (const rawProbe of raw.probes) {
+		if (!Array.isArray(rawProbe) || rawProbe.length !== 3) return null;
+		const [kind, probePath, answer] = rawProbe;
+		if (!isProbeKind(kind) || typeof probePath !== "string" || typeof answer !== "string") return null;
+		probes.push({
+			kind,
+			path: probePath,
+			answer
+		});
+	}
 	try {
-		for (const entry of raw) validateDiagnostic(entry);
-		return raw;
+		for (const entry of raw.diagnostics) validateDiagnostic(entry);
 	} catch {
 		return null;
 	}
+	return {
+		probes,
+		diagnostics: raw.diagnostics
+	};
 };
+const encodeSidecarFileEntry = (entry) => ({
+	probes: entry.probes.map((probe) => [
+		probe.kind,
+		probe.path,
+		probe.answer
+	]),
+	diagnostics: entry.diagnostics
+});
 const emptyCache = () => ({
 	version: 1,
 	rulesets: {}
@@ -38801,20 +39198,20 @@ const loadRulesetEntries = (cacheFilePath, rulesetHash) => {
 	if (persisted.version !== 1 || !isRecord(persisted.rulesets)) return entries;
 	const bucket = persisted.rulesets[rulesetHash];
 	if (!isRecord(bucket) || !isRecord(bucket.files)) return entries;
-	for (const [fileKey, rawDiagnostics] of Object.entries(bucket.files)) {
-		const decoded = decodeFileDiagnostics(rawDiagnostics);
+	for (const [fileKey, rawEntry] of Object.entries(bucket.files)) {
+		const decoded = decodeSidecarFileEntry(rawEntry);
 		if (decoded !== null) entries.set(fileKey, decoded);
 	}
 	return entries;
 };
-const createFileLintCache = (cacheDirectory, rulesetHash) => {
-	const cacheFilePath = Path.join(cacheDirectory, FILE_LINT_CACHE_FILENAME);
+const createSidecarLintCache = (cacheDirectory, rulesetHash) => {
+	const cacheFilePath = Path.join(cacheDirectory, SIDECAR_LINT_CACHE_FILENAME);
 	const entries = loadRulesetEntries(cacheFilePath, rulesetHash);
 	return {
 		lookup: (fileKey) => entries.get(fileKey) ?? null,
-		store: (fileKey, diagnostics) => {
+		store: (fileKey, entry) => {
 			entries.delete(fileKey);
-			entries.set(fileKey, diagnostics);
+			entries.set(fileKey, entry);
 		},
 		persist: () => {
 			const onDisk = failOpenReadJson(cacheFilePath, emptyCache());
@@ -38822,7 +39219,7 @@ const createFileLintCache = (cacheDirectory, rulesetHash) => {
 			const existingBucket = rulesets[rulesetHash];
 			const existingFiles = isRecord(existingBucket) && isRecord(existingBucket.files) ? existingBucket.files : {};
 			const ourFiles = {};
-			for (const [fileKey, diagnostics] of entries) ourFiles[fileKey] = diagnostics;
+			for (const [fileKey, entry] of entries) ourFiles[fileKey] = encodeSidecarFileEntry(entry);
 			const cappedEntries = Object.entries({
 				...existingFiles,
 				...ourFiles
@@ -39837,13 +40234,6 @@ const validateRuleRegistration = () => {
 	].filter((entry) => entry !== null).join("; ");
 	console.warn(`[react-doctor] rule-registration drift: ${detail}`);
 };
-const hashFileContents = (filePath) => {
-	try {
-		return crypto.createHash("sha1").update(NFS.readFileSync(filePath)).digest("hex");
-	} catch {
-		return null;
-	}
-};
 /**
 * Balanced LPT (longest-processing-time-first) lint batch planner. Where
 * `batchIncludePaths` greedily fills 100-file batches and leaves a small
@@ -39908,21 +40298,6 @@ const planLintBatches = ({ baseArgs, files, sizeByFile }) => {
 	}
 	return batches.filter((batch) => batch.fileIndexes.length > 0).map((batch) => batch.fileIndexes.sort((leftIndex, rightIndex) => leftIndex - rightIndex).map((fileIndex) => files[fileIndex]));
 };
-const projectCacheSubdir = (projectDirectory) => crypto.createHash("sha256").update(projectDirectory).digest("hex").slice(0, 16);
-const resolveReactDoctorCacheDir = (projectDirectory) => {
-	const cacheDirOverride = process.env["REACT_DOCTOR_CACHE_DIR"]?.trim();
-	if (cacheDirOverride) return Path.join(cacheDirOverride, projectCacheSubdir(projectDirectory));
-	const nodeModulesDirectory = Path.join(projectDirectory, "node_modules");
-	if (NFS.existsSync(nodeModulesDirectory)) return Path.join(nodeModulesDirectory, ".cache", "react-doctor");
-	return Path.join(os.tmpdir(), `react-doctor-cache-${resolveUserCacheScope()}`, projectCacheSubdir(projectDirectory));
-};
-const resolveUserCacheScope = () => {
-	try {
-		return String(process.getuid?.() ?? os.userInfo().username);
-	} catch {
-		return "shared";
-	}
-};
 /**
 * Atomically (re)writes the generated oxlintrc.json. Used twice in
 * the runner: once for the primary scan, once for the
@@ -39940,6 +40315,106 @@ const writeOxlintConfig = (configPath, configToWrite) => {
 		NFS.closeSync(fileHandle);
 	}
 };
+/**
+* Attributes diagnostics back to the file that produced them by the
+* normalized path oxlint echoes. Returns `null` when ANY diagnostic can't be
+* attributed — the path forms don't align, so the caller must skip its cache
+* store rather than risk caching a wrong empty result for a file that
+* actually had diagnostics.
+*/
+const attributeDiagnosticsToFiles = (diagnostics, files) => {
+	const fileByNormalizedPath = /* @__PURE__ */ new Map();
+	for (const file of files) fileByNormalizedPath.set(file.replaceAll("\\", "/"), file);
+	const diagnosticsByFile = /* @__PURE__ */ new Map();
+	for (const diagnostic of diagnostics) {
+		const file = fileByNormalizedPath.get(diagnostic.filePath);
+		if (file === void 0) return null;
+		const fileDiagnostics = diagnosticsByFile.get(file) ?? [];
+		fileDiagnostics.push(diagnostic);
+		diagnosticsByFile.set(file, fileDiagnostics);
+	}
+	return diagnosticsByFile;
+};
+/**
+* Collects each file's cross-file dependency probes (via the plugin's
+* collectors) with their current answers. Fail-open per file: an unreadable /
+* unparseable / collector-failing file maps to `null` (no entry stored — it
+* re-lints next scan). The filesystem is frozen for the scan, so this can run
+* CONCURRENTLY with an oxlint child-process await — the caller starts it
+* unawaited before a lint pass and awaits it at store time, hiding the
+* in-process parse + resolution cost under the subprocess wait. The loop
+* yields on the cooperative time budget so the child's stdout handling (and
+* sibling fibers) keep flowing; each per-file collection is synchronous, so
+* the module-level probe recorder never sees interleaved use. Never rejects.
+*/
+const collectSidecarProbesForFiles = async (input) => {
+	const buildProbes = (file) => {
+		const absoluteFilePath = Path.resolve(input.rootDirectory, file);
+		let trace;
+		try {
+			trace = collectCrossFileDependencyProbes({
+				absoluteFilePath,
+				sourceText: NFS.readFileSync(absoluteFilePath, "utf8"),
+				ruleIds: input.boundedSidecarRuleIds
+			});
+		} catch {
+			return null;
+		}
+		if (trace === null) return null;
+		const probes = [];
+		for (const contentPath of trace.contentPaths) {
+			const relativePath = input.probeAnswers.toRelativePath(contentPath);
+			probes.push({
+				kind: "content",
+				path: relativePath,
+				answer: input.probeAnswers.answerFor("content", relativePath)
+			});
+		}
+		for (const existencePath of trace.existencePaths) {
+			const relativePath = input.probeAnswers.toRelativePath(existencePath);
+			probes.push({
+				kind: "exists",
+				path: relativePath,
+				answer: input.probeAnswers.answerFor("exists", relativePath)
+			});
+		}
+		return probes;
+	};
+	const probesByFile = /* @__PURE__ */ new Map();
+	let collectSliceStartedAt = performance.now();
+	for (const file of input.files) {
+		probesByFile.set(file, buildProbes(file));
+		if (performance.now() - collectSliceStartedAt >= 12) {
+			await yieldToEventLoop();
+			collectSliceStartedAt = performance.now();
+		}
+	}
+	return probesByFile;
+};
+/**
+* Stores each freshly-linted file's probe set + cross-file diagnostics so
+* the next scan can replay instead of re-linting.
+*/
+const storeSidecarEntries = (input) => {
+	let didStoreAnyEntry = false;
+	for (const pass of input.storablePasses) {
+		if (!pass.isTrusted) continue;
+		const diagnosticsByFile = attributeDiagnosticsToFiles(pass.diagnostics, pass.files);
+		if (diagnosticsByFile === null) continue;
+		for (const file of pass.files) {
+			const cacheKey = input.cacheKeyByFile.get(file);
+			if (cacheKey === void 0) continue;
+			const probes = pass.probesByFile.get(file);
+			if (probes === void 0 || probes === null) continue;
+			input.sidecarCache.store(cacheKey, {
+				probes,
+				diagnostics: diagnosticsByFile.get(file) ?? []
+			});
+			didStoreAnyEntry = true;
+		}
+	}
+	if (didStoreAnyEntry) input.sidecarCache.persist();
+};
 const REACT_HOOKS_JS_DROP_PREFIX = "React Compiler rules (react-hooks-js/*) skipped — eslint-plugin-react-hooks failed to load in this environment";
 /**
 * Detects an oxlint config-load crash caused by the optional
@@ -39981,7 +40456,7 @@ const reactHooksJsPluginDropNote = (error) => {
 *   6. always restore disable directives + clean up the temp dir
 */
 const runOxlint = async (options) => {
-	const { rootDirectory, project, includePaths, nodeBinaryPath = process.execPath, customRulesOnly = false, respectInlineDisables = true, adoptExistingLintConfig = true, ignoredTags = /* @__PURE__ */ new Set(), userConfig, configSourceDirectory = rootDirectory, onPartialFailure, perFileLintCacheEnabled = false, onCacheStats, spawnTimeoutMs, outputMaxBytes, lintBatchOrdering = "cost" } = options;
+	const { rootDirectory, project, includePaths, nodeBinaryPath = process.execPath, customRulesOnly = false, respectInlineDisables = true, adoptExistingLintConfig = true, ignoredTags = /* @__PURE__ */ new Set(), userConfig, configSourceDirectory = rootDirectory, onPartialFailure, perFileLintCacheEnabled = false, sidecarLintCacheEnabled = false, onCacheStats, onSidecarStats, spawnTimeoutMs, outputMaxBytes, lintBatchOrdering = "cost" } = options;
 	const serverAuthFunctionNames = Array.isArray(userConfig?.serverAuthFunctionNames) ? userConfig.serverAuthFunctionNames.filter((entry) => typeof entry === "string" && entry.length > 0) : void 0;
 	const severityControls = buildRuleSeverityControls(userConfig);
 	validateRuleRegistration();
@@ -39999,7 +40474,8 @@ const runOxlint = async (options) => {
 		severityControls,
 		userPlugins,
 		disableReactHooksJsPlugin: overrides.disableReactHooksJsPlugin,
-		ruleSelection: overrides.ruleSelection
+		ruleSelection: overrides.ruleSelection,
+		sidecarRuleIdFilter: overrides.sidecarRuleIdFilter
 	});
 	const restoreDisableDirectives = respectInlineDisables ? () => {} : await neutralizeDisableDirectives(rootDirectory, includePaths);
 	const configDirectory = NFS.mkdtempSync(Path.join(os.tmpdir(), "react-doctor-oxlintrc-"));
@@ -40102,15 +40578,18 @@ const runOxlint = async (options) => {
 			});
 			const cache = createFileLintCache(resolveReactDoctorCacheDir(rootDirectory), rulesetHash);
 			const cacheKeyByFile = /* @__PURE__ */ new Map();
+			const contentHashByRelativePath = /* @__PURE__ */ new Map();
 			const missFiles = [];
 			const replayedDiagnostics = [];
 			let hashSliceStartedAt = performance.now();
 			for (const candidateFile of candidateFiles) {
-				const contentHash = hashFileContents(Path.resolve(rootDirectory, candidateFile));
+				const absoluteCandidatePath = Path.resolve(rootDirectory, candidateFile);
+				const contentHash = hashFileContents(absoluteCandidatePath);
 				if (contentHash === null) {
 					missFiles.push(candidateFile);
 					continue;
 				}
+				contentHashByRelativePath.set(Path.relative(rootDirectory, absoluteCandidatePath).replaceAll("\\", "/"), contentHash);
 				const cacheKey = `${candidateFile.replaceAll("\\", "/")}\u0000${contentHash}`;
 				cacheKeyByFile.set(candidateFile, cacheKey);
 				const cachedDiagnostics = cache.lookup(cacheKey);
@@ -40122,43 +40601,111 @@ const runOxlint = async (options) => {
 				}
 			}
 			const cacheHitFileCount = candidateFiles.length - missFiles.length;
+			const enabledSidecarRuleIds = Object.keys(buildConfig({
+				extendsPaths: [],
+				ruleSelection: "sidecar"
+			}).rules).map((ruleKey) => ruleKey.slice(ruleKey.lastIndexOf("/") + 1)).filter((ruleId) => CROSS_FILE_RULE_IDS.has(ruleId));
+			const boundedSidecarRuleIds = enabledSidecarRuleIds.filter((ruleId) => CROSS_FILE_DEPENDENCY_COLLECTORS.has(ruleId));
+			const boundedSidecarRuleIdSet = new Set(boundedSidecarRuleIds);
+			const unboundedSidecarRuleIds = enabledSidecarRuleIds.filter((ruleId) => !CROSS_FILE_DEPENDENCY_COLLECTORS.has(ruleId));
+			const useSidecarCache = sidecarLintCacheEnabled && boundedSidecarRuleIds.length > 0;
+			const sidecarCache = useSidecarCache ? createSidecarLintCache(resolveReactDoctorCacheDir(rootDirectory), computeRulesetHash({
+				config: buildConfig({
+					extendsPaths: [],
+					ruleSelection: "sidecar",
+					sidecarRuleIdFilter: boundedSidecarRuleIdSet
+				}),
+				toolchainVersions: resolveOxlintToolchainVersions(nodeBinaryPath),
+				ignorePatterns: combinedPatterns,
+				tsconfigContent
+			})) : null;
+			const probeAnswers = createSidecarProbeAnswerResolver({
+				rootDirectory,
+				contentHashByRelativePath
+			});
+			const missProbesTask = sidecarCache === null ? null : collectSidecarProbesForFiles({
+				files: missFiles,
+				rootDirectory,
+				boundedSidecarRuleIds,
+				probeAnswers
+			});
 			const fullResult = await runConfigOverFiles((overrides) => buildConfig({
 				extendsPaths: [],
 				disableReactHooksJsPlugin: overrides.disableReactHooksJsPlugin
 			}), "oxlintrc.full.json", missFiles, options.onFileProgress && ((scannedFileCount) => options.onFileProgress?.(scannedFileCount, candidateFiles.length)));
 			const missFileSet = new Set(missFiles);
-			const sidecarResult = await runConfigOverFiles(() => buildConfig({
+			const hitFiles = candidateFiles.filter((candidateFile) => !missFileSet.has(candidateFile));
+			const sidecarReplayedDiagnostics = [];
+			const sidecarLintFiles = [];
+			if (sidecarCache === null) sidecarLintFiles.push(...hitFiles);
+			else {
+				let verifySliceStartedAt = performance.now();
+				for (const hitFile of hitFiles) {
+					const cacheKey = cacheKeyByFile.get(hitFile);
+					const entry = cacheKey === void 0 ? null : sidecarCache.lookup(cacheKey);
+					if (entry !== null && entry.probes.every((probe) => probeAnswers.answerFor(probe.kind, probe.path) === probe.answer)) sidecarReplayedDiagnostics.push(...entry.diagnostics);
+					else sidecarLintFiles.push(hitFile);
+					if (performance.now() - verifySliceStartedAt >= 12) {
+						await yieldToEventLoop();
+						verifySliceStartedAt = performance.now();
+					}
+				}
+			}
+			const sidecarProbesTask = sidecarCache === null ? null : collectSidecarProbesForFiles({
+				files: sidecarLintFiles,
+				rootDirectory,
+				boundedSidecarRuleIds,
+				probeAnswers
+			});
+			const sidecarReplayedFileCount = hitFiles.length - sidecarLintFiles.length;
+			if (sidecarReplayedFileCount > 0) options.onFileProgress?.(missFiles.length + sidecarReplayedFileCount, candidateFiles.length);
+			const boundedSidecarResult = await runConfigOverFiles(() => buildConfig({
 				extendsPaths: [],
-				ruleSelection: "sidecar"
-			}), "oxlintrc.sidecar.json", candidateFiles.filter((candidateFile) => !missFileSet.has(candidateFile)), options.onFileProgress && ((scannedFileCount) => options.onFileProgress?.(missFiles.length + scannedFileCount, candidateFiles.length)));
+				ruleSelection: "sidecar",
+				...useSidecarCache ? { sidecarRuleIdFilter: boundedSidecarRuleIdSet } : {}
+			}), "oxlintrc.sidecar.json", sidecarLintFiles, options.onFileProgress && ((scannedFileCount) => options.onFileProgress?.(missFiles.length + sidecarReplayedFileCount + scannedFileCount, candidateFiles.length)));
+			const unboundedSidecarResult = useSidecarCache && unboundedSidecarRuleIds.length > 0 ? await runConfigOverFiles(() => buildConfig({
+				extendsPaths: [],
+				ruleSelection: "sidecar",
+				sidecarRuleIdFilter: new Set(unboundedSidecarRuleIds)
+			}), "oxlintrc.sidecar-unbounded.json", hitFiles, void 0) : {
+				diagnostics: [],
+				didDropReactHooksJsPlugin: false,
+				hadPartialFailure: false
+			};
 			const freshCacheableDiagnostics = [];
 			for (const diagnostic of fullResult.diagnostics) if (!CROSS_FILE_RULE_IDS.has(diagnostic.rule)) freshCacheableDiagnostics.push(diagnostic);
 			onCacheStats?.(cacheHitFileCount, candidateFiles.length);
-			const missFileByNormalizedPath = /* @__PURE__ */ new Map();
-			for (const missFile of missFiles) missFileByNormalizedPath.set(missFile.replaceAll("\\", "/"), missFile);
-			const freshDiagnosticsByFile = /* @__PURE__ */ new Map();
-			let isAttributionSound = true;
-			for (const diagnostic of freshCacheableDiagnostics) {
-				const missFile = missFileByNormalizedPath.get(diagnostic.filePath);
-				if (missFile === void 0) {
-					isAttributionSound = false;
-					break;
-				}
-				const fileDiagnostics = freshDiagnosticsByFile.get(missFile) ?? [];
-				fileDiagnostics.push(diagnostic);
-				freshDiagnosticsByFile.set(missFile, fileDiagnostics);
-			}
-			if (!fullResult.didDropReactHooksJsPlugin && !fullResult.hadPartialFailure && isAttributionSound) {
+			if (sidecarCache !== null) onSidecarStats?.(hitFiles.length - sidecarLintFiles.length, hitFiles.length);
+			const freshDiagnosticsByFile = attributeDiagnosticsToFiles(freshCacheableDiagnostics, missFiles);
+			if (!fullResult.didDropReactHooksJsPlugin && !fullResult.hadPartialFailure && freshDiagnosticsByFile !== null) {
 				for (const missFile of missFiles) {
 					const cacheKey = cacheKeyByFile.get(missFile);
 					if (cacheKey !== void 0) cache.store(cacheKey, freshDiagnosticsByFile.get(missFile) ?? []);
 				}
 				cache.persist();
 			}
+			if (sidecarCache !== null && missProbesTask !== null && sidecarProbesTask !== null) storeSidecarEntries({
+				sidecarCache,
+				cacheKeyByFile,
+				storablePasses: [{
+					files: sidecarLintFiles,
+					diagnostics: boundedSidecarResult.diagnostics,
+					isTrusted: !boundedSidecarResult.hadPartialFailure,
+					probesByFile: await sidecarProbesTask
+				}, {
+					files: missFiles,
+					diagnostics: fullResult.diagnostics.filter((diagnostic) => boundedSidecarRuleIdSet.has(diagnostic.rule)),
+					isTrusted: !fullResult.didDropReactHooksJsPlugin && !fullResult.hadPartialFailure,
+					probesByFile: await missProbesTask
+				}]
+			});
 			return dedupeDiagnostics([
 				...replayedDiagnostics,
 				...fullResult.diagnostics,
-				...sidecarResult.diagnostics
+				...sidecarReplayedDiagnostics,
+				...boundedSidecarResult.diagnostics,
+				...unboundedSidecarResult.diagnostics
 			]);
 		}
 		const baseArgs = makeBaseArgs(configPath);
@@ -40256,6 +40803,7 @@ var Linter = class Linter extends Service()("react-doctor/Linter") {
 		const concurrency = yield* OxlintConcurrency;
 		const lintBatchOrdering = yield* LintBatchOrdering;
 		const perFileLintCacheEnabled = yield* PerFileLintCacheEnabled;
+		const sidecarLintCacheEnabled = yield* SidecarLintCacheEnabled;
 		const collectedFailures = [];
 		const diagnostics = yield* tryPromise({
 			try: (signal) => runOxlint({
@@ -40274,7 +40822,9 @@ var Linter = class Linter extends Service()("react-doctor/Linter") {
 				},
 				onFileProgress: input.onFileProgress,
 				perFileLintCacheEnabled,
+				sidecarLintCacheEnabled,
 				onCacheStats: input.onCacheStats,
+				onSidecarStats: input.onSidecarStats,
 				spawnTimeoutMs,
 				outputMaxBytes,
 				concurrency,
@@ -40696,6 +41246,20 @@ const writeCachedSocketBody = (cacheFile, body) => {
 		}));
 	} catch {}
 };
+const pruneExpiredSocketCache = (cacheDirectory) => {
+	try {
+		const supplyChainCacheDirectory = Path.join(cacheDirectory, SUPPLY_CHAIN_CACHE_SUBDIR);
+		const expiryThresholdMs = Date.now() - SUPPLY_CHAIN_CACHE_TTL_MS;
+		for (const entryName of NFS.readdirSync(supplyChainCacheDirectory)) {
+			const entryPath = Path.join(supplyChainCacheDirectory, entryName);
+			try {
+				if (NFS.statSync(entryPath).mtimeMs < expiryThresholdMs) NFS.rmSync(entryPath);
+			} catch {
+				continue;
+			}
+		}
+	} catch {}
+};
 const fetchSocketArtifact = (dependency, cacheDirectory) => tryPromise(async (signal) => {
 	const cacheFile = cacheDirectory === null ? null : supplyChainCacheFile(cacheDirectory, dependency);
 	if (cacheFile !== null) {
@@ -40823,6 +41387,7 @@ const checkSupplyChain = (input) => gen(function* () {
 	const dependencies = collectDependenciesToScore(readPackageJson(packageJsonPath), readPackageJsonText(packageJsonPath), options.includeDevDependencies);
 	if (dependencies.length === 0) return [];
 	const cacheDirectory = isSupplyChainCacheDisabled() ? null : resolveReactDoctorCacheDir(input.rootDirectory);
+	if (cacheDirectory !== null) pruneExpiredSocketCache(cacheDirectory);
 	const artifacts = yield* forEach$1(dependencies, (dependency) => fetchSocketArtifact(dependency, cacheDirectory), { concurrency: 8 }).pipe(timeoutOption(input.totalTimeoutMs ?? 9e4), map$3((maybeArtifacts) => getOrElse$1(maybeArtifacts, () => [])));
 	const diagnostics = [];
 	for (let index = 0; index < dependencies.length; index += 1) {
@@ -41049,7 +41614,14 @@ const runInspect = (input, hooks = {}) => gen(function* () {
 	const buildCollectDeadCode = (deadCodeTimeout) => runCollect(applyPerElementPipeline(deadCodeService.run({
 		rootDirectory: scanDirectory,
 		parseConcurrency: deadCodeParseConcurrency,
-		workerTimeoutMs: deadCodeTimeout.workerTimeoutMs
+		workerTimeoutMs: deadCodeTimeout.workerTimeoutMs,
+		onCacheOutcome: (didHitCache) => {
+			deadCodeCacheHit = didHitCache;
+		},
+		onSummaryCacheStats: (stats) => {
+			deadCodeSummaryCacheHits = stats.hits;
+			deadCodeSummaryCacheMisses = stats.misses;
+		}
 	}).pipe(catchTag("ReactDoctorError", (error) => unwrap(gen(function* () {
 		yield* set(deadCodeFailure, {
 			didFail: true,
@@ -41077,6 +41649,11 @@ const runInspect = (input, hooks = {}) => gen(function* () {
 	let lastReportedTotalFileCount = 0;
 	let lintCacheHitFileCount = null;
 	let lintCacheTotalFileCount = null;
+	let lintSidecarReplayedFileCount = null;
+	let lintSidecarTotalFileCount = null;
+	let deadCodeCacheHit = null;
+	let deadCodeSummaryCacheHits = null;
+	let deadCodeSummaryCacheMisses = null;
 	const baseLintStream = linterService.run({
 		rootDirectory: scanDirectory,
 		project,
@@ -41096,6 +41673,10 @@ const runInspect = (input, hooks = {}) => gen(function* () {
 			lintCacheHitFileCount = cacheHitFileCount;
 			lintCacheTotalFileCount = totalConsideredFileCount;
 		},
+		onSidecarStats: (sidecarReplayedFileCount, sidecarConsideredFileCount) => {
+			lintSidecarReplayedFileCount = sidecarReplayedFileCount;
+			lintSidecarTotalFileCount = sidecarConsideredFileCount;
+		},
 		deadlineEpochMs: input.deadlineEpochMs
 	}).pipe(catchTag("ReactDoctorError", (error) => unwrap(gen(function* () {
 		yield* set(lintFailure, {
@@ -41206,6 +41787,11 @@ const runInspect = (input, hooks = {}) => gen(function* () {
 		securityScanFailed,
 		lintCacheHitFileCount,
 		lintCacheTotalFileCount,
+		lintSidecarReplayedFileCount,
+		lintSidecarTotalFileCount,
+		deadCodeCacheHit: lintFailureState.didFail ? null : deadCodeCacheHit,
+		deadCodeSummaryCacheHits: lintFailureState.didFail ? null : deadCodeSummaryCacheHits,
+		deadCodeSummaryCacheMisses: lintFailureState.didFail ? null : deadCodeSummaryCacheMisses,
 		suppressedRuleCounts: transform.summarizeSuppressions()
 	};
 }).pipe(withSpan("runInspect", { attributes: {
@@ -41521,6 +42107,7 @@ const buildJsonReport = (input) => {
 	const worstScoredProject = findWorstScoredProject(projects);
 	const summary = summarizeDiagnostics(flattenedDiagnostics, worstScoredProject?.score?.score ?? null, worstScoredProject?.score?.label ?? null);
 	const shared = {
+		...input.scans.length > 0 ? { reactDetected: input.scans.some((scan) => hasReactRuntime(scan.result.project)) } : {},
 		version: input.version,
 		ok: true,
 		directory: input.directory,
@@ -41750,6 +42337,7 @@ const outputToDiagnoseResult = (output, elapsedMilliseconds) => {
 		skippedChecks,
 		...Object.keys(skippedCheckReasons).length > 0 ? { skippedCheckReasons } : {},
 		project: output.project,
+		reactDetected: hasReactRuntime(output.project),
 		elapsedMilliseconds
 	};
 };
@@ -41805,10 +42393,12 @@ const diagnoseProjectBatch = async (input) => {
 	const startTime = globalThis.performance.now();
 	const { projects, concurrency, config: batchConfig, ...baseOptions } = input;
 	const projectResults = await mapWithConcurrency(projects, concurrency ?? 4, (projectDefinition) => diagnoseProject(projectDefinition, baseOptions, batchConfig));
+	const succeededProjects = projectResults.filter((projectResult) => projectResult.ok);
 	return {
 		projects: projectResults,
-		diagnostics: projectResults.flatMap((projectResult) => projectResult.ok ? projectResult.diagnostics : []),
+		diagnostics: succeededProjects.flatMap((projectResult) => projectResult.diagnostics),
 		score: findWorstScore(projectResults),
+		...succeededProjects.length > 0 ? { reactDetected: succeededProjects.some((projectResult) => projectResult.reactDetected) } : {},
 		elapsedMilliseconds: globalThis.performance.now() - startTime
 	};
 };
@@ -41843,7 +42433,7 @@ const toJsonReport = (result, options) => buildJsonReport({
 	totalElapsedMilliseconds: result.elapsedMilliseconds
 });
 //#endregion
-export { AmbiguousProjectError, NoReactDependencyError, NotADirectoryError, PackageJsonNotFoundError, ProjectNotFoundError, ReactDoctorError, buildJsonReport, buildJsonReportError, clearCaches, defineConfig, diagnose, filterSourceFiles, getDiffInfo, isProjectDiscoveryError, isReactDoctorError, summarizeDiagnostics, toJsonReport };
+export { AmbiguousProjectError, NoReactDependencyError, NotADirectoryError, PackageJsonNotFoundError, ProjectNotFoundError, ReactDoctorError, buildJsonReport, buildJsonReportError, clearCaches, defineConfig, diagnose, filterSourceFiles, getDiffInfo, hasReactRuntime, isProjectDiscoveryError, isReactDoctorError, summarizeDiagnostics, toJsonReport };
 
 //# sourceMappingURL=index.js.map
-//# debugId=8565c6ea-39f3-51e6-895a-ae9f7c026d0e
+//# debugId=07deeb70-f47f-5572-9930-e743f970f84f