react-doctor 0.9.2-dev.3728102 → 0.9.2-dev.86add14

package/dist/cli.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]="3ced4c14-18cb-5b0c-811c-3448b5c2f139")}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]="2a10a6ef-ec19-5a23-88d5-c2e4d5e30eec")}catch(e){}}();
 import { createRequire } from "node:module";
 import * as NodeChildProcess from "node:child_process";
 import { execFile, execFileSync, spawn, spawnSync } from "node:child_process";
@@ -13,11 +13,11 @@ import * as Crypto from "node:crypto";
 import crypto, { createHash, randomUUID } from "node:crypto";
 import { ResolverFactory } from "oxc-resolver";
 import ts from "typescript";
+import * as NodeUrl from "node:url";
+import { fileURLToPath, pathToFileURL } from "node:url";
 import * as OS from "node:os";
 import os, { tmpdir } from "node:os";
 import { parseJSON5 } from "confbox";
-import * as NodeUrl from "node:url";
-import { fileURLToPath, pathToFileURL } from "node:url";
 import { createJiti } from "jiti";
 import { ANALYZED_MANIFEST_FILENAMES, DEFAULT_EXTENSIONS } from "deslop-js/analyzed-inputs";
 import { gzipSync } from "node:zlib";
@@ -65596,10 +65596,16 @@ const getTopLevelBinding = (sourceFile, bindingName) => {
 	}
 	return null;
 };
-const getFunctionLocalBindings = (functionNode, argumentsList) => {
+const getFunctionLocalBindings = (functionNode, argumentsList, argumentAnalysis, functionAnalysis) => {
 	const localBindings = /* @__PURE__ */ new Map();
 	functionNode.parameters.forEach((parameter, parameterIndex) => {
-		if (ts.isIdentifier(parameter.name)) localBindings.set(parameter.name.text, argumentsList[parameterIndex] ?? parameter.initializer ?? null);
+		if (ts.isIdentifier(parameter.name)) {
+			const argument = argumentsList[parameterIndex];
+			localBindings.set(parameter.name.text, {
+				expression: argument ?? parameter.initializer ?? null,
+				analysis: argument ? argumentAnalysis : functionAnalysis
+			});
+		}
 	});
 	return localBindings;
 };
@@ -65735,8 +65741,8 @@ const getStaticConfigValueState = (expression, analysis, visitedExpressions = /*
 	};
 	if (ts.isIdentifier(unwrappedExpression)) {
 		if (analysis.localBindings.has(unwrappedExpression.text)) {
-			const localInitializer = analysis.localBindings.get(unwrappedExpression.text);
-			return localInitializer ? getStaticConfigValueState(localInitializer, analysis, nextVisitedExpressions) : null;
+			const localReference = analysis.localBindings.get(unwrappedExpression.text);
+			return localReference?.expression ? getStaticConfigValueState(localReference.expression, localReference.analysis, nextVisitedExpressions) : null;
 		}
 		const topLevelBinding = getTopLevelBinding(analysis.sourceFile, unwrappedExpression.text);
 		return topLevelBinding && ts.isExpression(topLevelBinding) ? getStaticConfigValueState(topLevelBinding, analysis, nextVisitedExpressions) : null;
@@ -65778,8 +65784,8 @@ const getReactCompilerFlagState = (expression, analysis, visitedExpressions = /*
 		const assignedBinding = getAssignedPropertyInitializer(unwrappedExpression, "reactCompiler");
 		if (assignedBinding.wasFound && assignedBinding.initializer) return { isEnabled: !isStaticallyDisabledConfigExpression(assignedBinding.initializer, analysis) };
 		if (analysis.localBindings.has(unwrappedExpression.text)) {
-			const localInitializer = analysis.localBindings.get(unwrappedExpression.text);
-			return localInitializer ? getReactCompilerFlagState(localInitializer, analysis, nextVisitedExpressions) : null;
+			const localReference = analysis.localBindings.get(unwrappedExpression.text);
+			return localReference?.expression ? getReactCompilerFlagState(localReference.expression, localReference.analysis, nextVisitedExpressions) : null;
 		}
 		const topLevelBinding = getTopLevelBinding(analysis.sourceFile, unwrappedExpression.text);
 		return topLevelBinding && ts.isExpression(topLevelBinding) ? getReactCompilerFlagState(topLevelBinding, analysis, nextVisitedExpressions) : null;
@@ -65802,8 +65808,8 @@ const getSelectedObjectProperty = (expression, propertyName, analysis, visitedEx
 	visitedExpressions.add(resolvedExpression);
 	if (ts.isIdentifier(resolvedExpression)) {
 		if (analysis.localBindings.has(resolvedExpression.text)) {
-			const localInitializer = analysis.localBindings.get(resolvedExpression.text);
-			return localInitializer ? getSelectedObjectProperty(localInitializer, propertyName, analysis, visitedExpressions) : null;
+			const localReference = analysis.localBindings.get(resolvedExpression.text);
+			return localReference?.expression ? getSelectedObjectProperty(localReference.expression, propertyName, localReference.analysis, visitedExpressions) : null;
 		}
 		const scopedBinding = getScopedConfigBinding(resolvedExpression);
 		if (scopedBinding.wasFound) return scopedBinding.initializer ? getSelectedObjectProperty(scopedBinding.initializer, propertyName, analysis, visitedExpressions) : null;
@@ -65812,9 +65818,18 @@ const getSelectedObjectProperty = (expression, propertyName, analysis, visitedEx
 	}
 	if (!ts.isObjectLiteralExpression(resolvedExpression)) return null;
 	for (const property of [...resolvedExpression.properties].reverse()) {
-		if (ts.isPropertyAssignment(property) && getStaticPropertyName$2(property.name) === propertyName) return property.initializer;
-		if (ts.isMethodDeclaration(property) && getStaticPropertyName$2(property.name) === propertyName) return property;
-		if (ts.isShorthandPropertyAssignment(property) && property.name.text === propertyName) return property.name;
+		if (ts.isPropertyAssignment(property) && getStaticPropertyName$2(property.name) === propertyName) return {
+			node: property.initializer,
+			analysis
+		};
+		if (ts.isMethodDeclaration(property) && getStaticPropertyName$2(property.name) === propertyName) return {
+			node: property,
+			analysis
+		};
+		if (ts.isShorthandPropertyAssignment(property) && property.name.text === propertyName) return {
+			node: property.name,
+			analysis
+		};
 		if (ts.isSpreadAssignment(property)) {
 			const spreadProperty = getSelectedObjectProperty(property.expression, propertyName, analysis, visitedExpressions);
 			if (spreadProperty) return spreadProperty;
@@ -65827,8 +65842,8 @@ const configExpressionMayDefineProperty = (expression, propertyName, analysis) =
 	while (ts.isParenthesizedExpression(resolvedExpression) || ts.isAsExpression(resolvedExpression) || ts.isTypeAssertionExpression(resolvedExpression) || ts.isSatisfiesExpression(resolvedExpression) || ts.isNonNullExpression(resolvedExpression)) resolvedExpression = resolvedExpression.expression;
 	if (ts.isIdentifier(resolvedExpression)) {
 		if (analysis.localBindings.has(resolvedExpression.text)) {
-			const localInitializer = analysis.localBindings.get(resolvedExpression.text);
-			return localInitializer ? configExpressionMayDefineProperty(localInitializer, propertyName, analysis) : true;
+			const localReference = analysis.localBindings.get(resolvedExpression.text);
+			return localReference?.expression ? configExpressionMayDefineProperty(localReference.expression, propertyName, localReference.analysis) : true;
 		}
 		const scopedBinding = getScopedConfigBinding(resolvedExpression);
 		if (scopedBinding.wasFound) return scopedBinding.initializer ? configExpressionMayDefineProperty(scopedBinding.initializer, propertyName, analysis) : true;
@@ -65912,15 +65927,15 @@ const getReExportedConfigModules = (sourceFile, exportName) => {
 	}
 	return bindings;
 };
-const analyzeConfigModuleExport = (filePath, exportName, allowCompilerTransform, importDepth, visitedModules, argumentsList = []) => {
+const analyzeConfigModuleExport = (filePath, exportName, allowCompilerTransform, importDepth, visitedModules, argumentsList = [], argumentAnalysis) => {
 	if (!isFile(filePath) || importDepth > 4) return false;
 	const moduleVisitKey = `${filePath}:${exportName}:${allowCompilerTransform}`;
 	if (visitedModules.has(moduleVisitKey)) return false;
 	const nextVisitedModules = new Set(visitedModules);
 	nextVisitedModules.add(moduleVisitKey);
-	return analyzeConfigSourceFileExport(parseConfigSourceFile(filePath, NFS.readFileSync(filePath, "utf-8")), filePath, exportName, allowCompilerTransform, importDepth, nextVisitedModules, argumentsList);
+	return analyzeConfigSourceFileExport(parseConfigSourceFile(filePath, NFS.readFileSync(filePath, "utf-8")), filePath, exportName, allowCompilerTransform, importDepth, nextVisitedModules, argumentsList, argumentAnalysis);
 };
-const analyzeConfigSourceFileExport = (sourceFile, filePath, exportName, allowCompilerTransform, importDepth, visitedModules, argumentsList = []) => {
+const analyzeConfigSourceFileExport = (sourceFile, filePath, exportName, allowCompilerTransform, importDepth, visitedModules, argumentsList = [], argumentAnalysis) => {
 	const analysis = {
 		filePath,
 		sourceFile,
@@ -65930,14 +65945,27 @@ const analyzeConfigSourceFileExport = (sourceFile, filePath, exportName, allowCo
 		localBindings: /* @__PURE__ */ new Map(),
 		activeFunctions: /* @__PURE__ */ new Set()
 	};
+	const resolvedArgumentAnalysis = argumentAnalysis ?? analysis;
 	const exportedConfigNodes = getExportedConfigNodes(sourceFile, exportName);
-	return exportedConfigNodes.some((node) => ts.isArrowFunction(node) || ts.isFunctionExpression(node) || ts.isFunctionDeclaration(node) ? analyzeConfigFunction(node, analysis, allowCompilerTransform, argumentsList) : analyzeConfigNode(node, analysis, allowCompilerTransform)) || getReExportedConfigModules(sourceFile, exportName).some((binding) => {
+	return exportedConfigNodes.some((node) => {
+		if (ts.isArrowFunction(node) || ts.isFunctionExpression(node) || ts.isFunctionDeclaration(node)) return analyzeConfigFunction(node, analysis, allowCompilerTransform, argumentsList, resolvedArgumentAnalysis);
+		if (argumentsList.length > 0 && ts.isIdentifier(node)) {
+			const topLevelBinding = getTopLevelBinding(sourceFile, node.text);
+			if (topLevelBinding && ts.isFunctionLike(topLevelBinding)) return analyzeConfigFunction(topLevelBinding, analysis, allowCompilerTransform, argumentsList, resolvedArgumentAnalysis);
+			const importBinding = getImportBinding(sourceFile, node.text);
+			if (importBinding) {
+				const importedFilePath = resolveImportedConfigFile(filePath, importBinding.moduleSpecifier);
+				return Boolean(importedFilePath && analyzeConfigModuleExport(importedFilePath, importBinding.exportName, allowCompilerTransform, importDepth + 1, visitedModules, argumentsList, resolvedArgumentAnalysis));
+			}
+		}
+		return analyzeConfigNode(node, analysis, allowCompilerTransform);
+	}) || getReExportedConfigModules(sourceFile, exportName).some((binding) => {
 		if (exportedConfigNodes.length > 0 && binding.isNamespace) return false;
 		const importedFilePath = resolveImportedConfigFile(filePath, binding.moduleSpecifier);
-		return Boolean(importedFilePath && analyzeConfigModuleExport(importedFilePath, binding.exportName, allowCompilerTransform, importDepth + 1, visitedModules, argumentsList));
+		return Boolean(importedFilePath && analyzeConfigModuleExport(importedFilePath, binding.exportName, allowCompilerTransform, importDepth + 1, visitedModules, argumentsList, resolvedArgumentAnalysis));
 	});
 };
-const analyzeConfigFunction = (functionNode, analysis, allowCompilerTransform, argumentsList = []) => {
+const analyzeConfigFunction = (functionNode, analysis, allowCompilerTransform, argumentsList = [], argumentAnalysis = analysis) => {
 	if (!functionNode.body) return false;
 	if (analysis.activeFunctions.has(functionNode.pos)) return false;
 	const activeFunctions = new Set(analysis.activeFunctions);
@@ -65945,7 +65973,7 @@ const analyzeConfigFunction = (functionNode, analysis, allowCompilerTransform, a
 	const functionAnalysis = {
 		...analysis,
 		visitedNodes: /* @__PURE__ */ new Set(),
-		localBindings: getFunctionLocalBindings(functionNode, argumentsList),
+		localBindings: getFunctionLocalBindings(functionNode, argumentsList, argumentAnalysis, analysis),
 		activeFunctions
 	};
 	if (!ts.isBlock(functionNode.body)) return analyzeConfigNode(functionNode.body, functionAnalysis, allowCompilerTransform);
@@ -65964,7 +65992,7 @@ const analyzeConfigFunction = (functionNode, analysis, allowCompilerTransform, a
 const analyzeImportedConfig = ({ analysis, moduleSpecifier, exportName, allowCompilerTransform, argumentsList }) => {
 	const importedFilePath = resolveImportedConfigFile(analysis.filePath, moduleSpecifier);
 	if (!importedFilePath) return null;
-	return analyzeConfigModuleExport(importedFilePath, exportName, allowCompilerTransform, analysis.importDepth + 1, analysis.visitedModules, argumentsList);
+	return analyzeConfigModuleExport(importedFilePath, exportName, allowCompilerTransform, analysis.importDepth + 1, analysis.visitedModules, argumentsList, analysis);
 };
 const analyzeConfigIdentifier = (identifier, analysis, allowCompilerTransform, isCompilerTransformCollection, excludedPropertyNames) => {
 	const assignedReactCompiler = getAssignedPropertyInitializer(identifier, "reactCompiler");
@@ -65978,8 +66006,8 @@ const analyzeConfigIdentifier = (identifier, analysis, allowCompilerTransform, i
 	if (assignedPlugins.wasFound) overriddenPropertyNames.add("plugins");
 	if (assignedPresets.wasFound) overriddenPropertyNames.add("presets");
 	if (analysis.localBindings.has(identifier.text)) {
-		const localInitializer = analysis.localBindings.get(identifier.text);
-		return Boolean(localInitializer && analyzeConfigNode(localInitializer, analysis, allowCompilerTransform, isCompilerTransformCollection, overriddenPropertyNames));
+		const localReference = analysis.localBindings.get(identifier.text);
+		return Boolean(localReference?.expression && analyzeConfigNode(localReference.expression, localReference.analysis, allowCompilerTransform, isCompilerTransformCollection, overriddenPropertyNames));
 	}
 	const scopedBinding = getScopedConfigBinding(identifier);
 	if (scopedBinding.wasFound) return Boolean(scopedBinding.initializer && analyzeConfigNode(scopedBinding.initializer, analysis, allowCompilerTransform, isCompilerTransformCollection, overriddenPropertyNames));
@@ -66045,7 +66073,7 @@ const analyzeConfigCallTarget = (callExpression, analysis, allowCompilerTransfor
 	}
 	const selectedProperty = getSelectedObjectProperty(target.expression, propertyName, analysis);
 	if (selectedProperty === null) return null;
-	return ts.isFunctionLike(selectedProperty) ? analyzeConfigFunction(selectedProperty, analysis, allowCompilerTransform, callExpression.arguments) : analyzeConfigNode(selectedProperty, analysis, allowCompilerTransform);
+	return ts.isFunctionLike(selectedProperty.node) ? analyzeConfigFunction(selectedProperty.node, selectedProperty.analysis, allowCompilerTransform, callExpression.arguments, analysis) : analyzeConfigNode(selectedProperty.node, selectedProperty.analysis, allowCompilerTransform);
 };
 const analyzeConfigNode = (node, analysis, allowCompilerTransform, isCompilerTransformCollection = false, excludedPropertyNames) => {
 	const excludedPropertiesVisitKey = excludedPropertyNames ? [...excludedPropertyNames].sort().join(",") : "";
@@ -66145,7 +66173,7 @@ const analyzeConfigNode = (node, analysis, allowCompilerTransform, isCompilerTra
 		if (ts.isIdentifier(node.expression)) {
 			if (analysis.localBindings.has(node.expression.text) || getScopedConfigBinding(node.expression).wasFound) {
 				const selectedProperty = getSelectedObjectProperty(node.expression, node.name.text, analysis);
-				return Boolean(selectedProperty && analyzeConfigNode(selectedProperty, analysis, allowCompilerTransform));
+				return Boolean(selectedProperty && analyzeConfigNode(selectedProperty.node, selectedProperty.analysis, allowCompilerTransform));
 			}
 			const importBinding = getImportBinding(analysis.sourceFile, node.expression.text);
 			if (importBinding?.isNamespace) {
@@ -66159,7 +66187,7 @@ const analyzeConfigNode = (node, analysis, allowCompilerTransform, isCompilerTra
 				return false;
 			}
 			const selectedProperty = getSelectedObjectProperty(node.expression, node.name.text, analysis);
-			if (selectedProperty) return analyzeConfigNode(selectedProperty, analysis, allowCompilerTransform);
+			if (selectedProperty) return analyzeConfigNode(selectedProperty.node, selectedProperty.analysis, allowCompilerTransform);
 			return false;
 		}
 		return analyzeConfigNode(node.expression, analysis, allowCompilerTransform);
@@ -66168,7 +66196,7 @@ const analyzeConfigNode = (node, analysis, allowCompilerTransform, isCompilerTra
 		if (ts.isIdentifier(node.expression)) {
 			if (analysis.localBindings.has(node.expression.text) || getScopedConfigBinding(node.expression).wasFound) {
 				const selectedProperty = getSelectedObjectProperty(node.expression, node.argumentExpression.text, analysis);
-				return Boolean(selectedProperty && analyzeConfigNode(selectedProperty, analysis, allowCompilerTransform));
+				return Boolean(selectedProperty && analyzeConfigNode(selectedProperty.node, selectedProperty.analysis, allowCompilerTransform));
 			}
 			const importBinding = getImportBinding(analysis.sourceFile, node.expression.text);
 			if (importBinding?.isNamespace) {
@@ -66181,7 +66209,7 @@ const analyzeConfigNode = (node, analysis, allowCompilerTransform, isCompilerTra
 				}));
 			}
 			const selectedProperty = getSelectedObjectProperty(node.expression, node.argumentExpression.text, analysis);
-			if (selectedProperty) return analyzeConfigNode(selectedProperty, analysis, allowCompilerTransform);
+			if (selectedProperty) return analyzeConfigNode(selectedProperty.node, selectedProperty.analysis, allowCompilerTransform);
 			return false;
 		}
 		return analyzeConfigNode(node.expression, analysis, allowCompilerTransform);
@@ -68558,6 +68586,7 @@ const classifyPackageRole = (filename) => {
 * Resolves the absolute path to read for a diagnostic's `filePath`,
 * accounting for the various shapes oxlint emits:
 *
+* - `file://` URL — decode to an absolute filesystem path.
 * - Absolute POSIX (`/abs/path/file.tsx`) — pass through.
 * - Absolute Windows (`C:/...` or `C:\...`) — pass through.
 * - `./relative` or bare relative — join against `rootDirectory`.
@@ -68567,6 +68596,7 @@ const classifyPackageRole = (filename) => {
 * use one canonical resolution path.
 */
 const resolveCandidateReadPath = (rootDirectory, filePath) => {
+	if (filePath.startsWith("file://")) return fileURLToPath(filePath);
 	const normalizedFile = filePath.replace(/\\/g, "/");
 	if (normalizedFile.startsWith("/") || /^[a-zA-Z]:\//.test(normalizedFile) || /^[a-zA-Z]:\\/.test(filePath)) return filePath;
 	return `${rootDirectory.replace(/\\/g, "/").replace(/\/$/, "")}/${normalizedFile.replace(/^\.\//, "")}`;
@@ -72875,7 +72905,10 @@ var Git = class Git extends Service()("react-doctor/Git") {
 				if (argvLengthChars > spawnArgsLengthCap) return yield* foldSpawnFailure(`spawn ENAMETOOLONG (${argvLengthChars} argv chars exceed ${spawnArgsLengthCap})`);
 				const handle = yield* spawner.spawn(make$1(input.command, [...input.args], {
 					cwd: input.directory,
-					env: input.env,
+					env: input.command === "git" ? {
+						...input.env,
+						GIT_DIR: void 0
+					} : input.env,
 					extendEnv: true
 				}));
 				const maxStdoutBytes = input.maxStdoutBytes;
@@ -73148,7 +73181,7 @@ var Git = class Git extends Service()("react-doctor/Git") {
 				"--diff-filter=ACMR",
 				"--relative"
 			]).pipe(map$3((result) => {
-				if (result.status !== 0) return [];
+				if (result.status !== 0) return null;
 				return splitNullSeparated(result.stdout);
 			})),
 			showStagedContent: (directory, relativePath, options) => runCommand({
@@ -77571,10 +77604,14 @@ const materializeSourceTree = (input) => gen(function* () {
 		materializedFiles.push(relativePath);
 	}
 	yield* sync(() => {
-		for (const configFilename of STAGED_FILES_PROJECT_CONFIG_FILENAMES) {
-			const sourcePath = path.join(input.directory, configFilename);
-			const targetPath = path.join(resolvedTempDirectory, configFilename);
-			if (fs.existsSync(sourcePath) && !fs.existsSync(targetPath)) fs.cpSync(sourcePath, targetPath);
+		for (const subdirectory of ["", ...input.configSubdirectories ?? []]) for (const configFilename of STAGED_FILES_PROJECT_CONFIG_FILENAMES) {
+			const sourcePath = path.join(input.directory, subdirectory, configFilename);
+			const targetPath = path.resolve(resolvedTempDirectory, subdirectory, configFilename);
+			if (!isPathInsideDirectory(targetPath, resolvedTempDirectory)) continue;
+			if (fs.existsSync(sourcePath) && !fs.existsSync(targetPath)) {
+				fs.mkdirSync(path.dirname(targetPath), { recursive: true });
+				fs.cpSync(sourcePath, targetPath);
+			}
 		}
 	});
 	return {
@@ -77607,15 +77644,17 @@ var StagedFiles = class StagedFiles extends Service()("react-doctor/StagedFiles"
 	static layerNode = effect(StagedFiles, gen(function* () {
 		const git = yield* Git;
 		return StagedFiles.of({
-			discoverSourceFiles: (directory) => git.stagedFilePaths(directory).pipe(map$3((entries) => entries.filter(isLintableSourceFile)), withSpan("StagedFiles.discoverSourceFiles")),
-			materialize: ({ directory, stagedFiles, tempDirectory }) => materializeSourceTree({
+			discoverSourceFiles: (directory) => git.stagedFilePaths(directory).pipe(map$3((entries) => entries === null ? null : entries.filter(isLintableSourceFile)), withSpan("StagedFiles.discoverSourceFiles")),
+			materialize: ({ directory, stagedFiles, tempDirectory, configSubdirectories }) => materializeSourceTree({
 				directory,
 				files: stagedFiles,
 				tempDirectory,
+				configSubdirectories,
 				readContent: (relativePath) => git.showStagedContent(directory, relativePath, { maxBufferBytes: GIT_SHOW_MAX_BUFFER_BYTES })
 			}).pipe(map$3((tree) => ({
 				tempDirectory: tree.tempDirectory,
 				stagedFiles: tree.materializedFiles,
+				unmaterializedFiles: tree.unmaterializedFiles,
 				cleanup: tree.cleanup
 			})), withSpan("StagedFiles.materialize"))
 		});
@@ -77630,6 +77669,7 @@ var StagedFiles = class StagedFiles extends Service()("react-doctor/StagedFiles"
 		materialize: ({ tempDirectory }) => succeed$2({
 			tempDirectory,
 			stagedFiles: snapshot.materializedFiles ?? snapshot.sourceFiles ?? [],
+			unmaterializedFiles: [],
 			cleanup: () => {}
 		})
 	}));
@@ -78339,6 +78379,7 @@ const METRIC = {
 	cliError: "cli.error",
 	cliEnvironmentError: "cli.env_error",
 	stagedSnapshotDivergence: "staged.snapshot_divergence",
+	stagedPerProject: "staged.per_project",
 	projectDetected: "project.detected",
 	projectPathSelected: "project.path_selected",
 	projectConfigSelected: "project.config_selected",
@@ -78424,7 +78465,7 @@ const makeNoopConsole = () => ({
 });
 //#endregion
 //#region src/cli/utils/version.ts
-const VERSION = "0.9.2-dev.3728102";
+const VERSION = "0.9.2-dev.86add14";
 //#endregion
 //#region src/cli/utils/json-mode.ts
 let context = null;
@@ -78782,13 +78823,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.2-dev.3728102`;
+const resolveSentryRelease = () => process.env.SENTRY_RELEASE || `react-doctor@0.9.2-dev.86add14`;
 /**
 * 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.2-dev.3728102") ? "development" : "production");
+const resolveSentryEnvironment = () => process.env.SENTRY_ENVIRONMENT || (isDevVersion("0.9.2-dev.86add14") ? "development" : "production");
 /**
 * Performance-tracing sample rate in `[0, 1]`. Reads `SENTRY_TRACES_SAMPLE_RATE`
 * (set to `0` to disable tracing) and falls back to
@@ -92245,16 +92286,19 @@ const formatClusterLocation = (cluster, resolveSourceRoot, hyperlinks) => {
 	if (!hyperlinks) return `${location}${contextTag}`;
 	return `${formatHyperlink(location, pathToFileURL(resolveAbsolutePath(lead.filePath, resolveSourceRoot(lead))).href)}${contextTag}`;
 };
-const buildDiagnosticClusterLines = (cluster, resolveSourceRoot, renderCodeFrame, hyperlinks) => {
+const buildDiagnosticClusterLines = (cluster, resolveSourceRoot, resolveFrameSourceRoot, renderCodeFrame, hyperlinks) => {
 	const lead = cluster.diagnostics[0];
 	const isMultiSite = cluster.diagnostics.length > 1;
+	const sourceRoot = resolveSourceRoot(lead);
+	const frameSourceRoot = resolveFrameSourceRoot(lead);
+	const frameFilePath = Path.isAbsolute(lead.filePath) && sourceRoot !== frameSourceRoot ? Path.relative(sourceRoot, lead.filePath) : lead.filePath;
 	const lines = ["", highlighter.gray(`${TOP_ERROR_DETAIL_INDENT}${formatClusterLocation(cluster, resolveSourceRoot, hyperlinks)}`)];
 	const codeFrame = renderCodeFrame ? buildCodeFrame({
-		filePath: lead.filePath,
+		filePath: frameFilePath,
 		line: cluster.startLine,
 		column: isMultiSite ? 0 : lead.column,
 		endLine: isMultiSite ? cluster.endLine : void 0,
-		rootDirectory: resolveSourceRoot(lead)
+		rootDirectory: frameSourceRoot
 	}) : null;
 	if (codeFrame) {
 		const boxInnerWidth = resolveMeasureWidth(8);
@@ -92267,7 +92311,7 @@ const buildDiagnosticClusterLines = (cluster, resolveSourceRoot, renderCodeFrame
 	}
 	return lines;
 };
-const buildRuleDetailBlock = (ruleKey, ruleDiagnostics, resolveSourceRoot, renderEverySite, isAgentEnvironment, hyperlinks) => {
+const buildRuleDetailBlock = (ruleKey, ruleDiagnostics, resolveSourceRoot, resolveFrameSourceRoot, renderEverySite, isAgentEnvironment, hyperlinks) => {
 	const representative = pickRepresentativeDiagnostic(ruleDiagnostics);
 	const { severity } = representative;
 	const trailingBadge = formatTrailingSiteBadge(ruleDiagnostics.length);
@@ -92289,7 +92333,7 @@ const buildRuleDetailBlock = (ruleKey, ruleDiagnostics, resolveSourceRoot, rende
 	}
 	const renderCodeFrame = severity === "error";
 	const sites = renderEverySite ? ruleDiagnostics : [representative];
-	if (!(isCollapsedWarningGroup && representative.help.includes(representative.filePath))) for (const cluster of clusterNearbyDiagnostics(sites)) lines.push(...buildDiagnosticClusterLines(cluster, resolveSourceRoot, renderCodeFrame, hyperlinks));
+	if (!(isCollapsedWarningGroup && representative.help.includes(representative.filePath))) for (const cluster of clusterNearbyDiagnostics(sites)) lines.push(...buildDiagnosticClusterLines(cluster, resolveSourceRoot, resolveFrameSourceRoot, renderCodeFrame, hyperlinks));
 	return lines;
 };
 const selectErrorRuleGroups = (diagnostics, rulePriority) => buildSortedRuleGroups(diagnostics.filter((diagnostic) => diagnostic.severity === "error"), rulePriority);
@@ -92315,7 +92359,7 @@ const buildMigrationScaleAdvisoryLines = (diagnostics) => {
 	return lines;
 };
 const getTopErrorRuleKeys = (diagnostics, limit, rulePriority) => new Set(selectTopErrorRuleGroups(diagnostics, limit, rulePriority).map(([ruleKey]) => ruleKey));
-const buildTopErrorsSection = (diagnostics, resolveSourceRoot, hyperlinks, rulePriority) => {
+const buildTopErrorsSection = (diagnostics, resolveSourceRoot, resolveFrameSourceRoot, hyperlinks, rulePriority) => {
 	const topRuleGroups = selectErrorRuleGroups(diagnostics, rulePriority).slice(0, 3);
 	if (topRuleGroups.length === 0) return {
 		lines: [],
@@ -92325,7 +92369,7 @@ const buildTopErrorsSection = (diagnostics, resolveSourceRoot, hyperlinks, ruleP
 	const blockOffsets = [];
 	for (const [ruleKey, ruleDiagnostics] of topRuleGroups) {
 		blockOffsets.push(lines.length);
-		lines.push(...buildRuleDetailBlock(ruleKey, ruleDiagnostics, resolveSourceRoot, false, false, hyperlinks));
+		lines.push(...buildRuleDetailBlock(ruleKey, ruleDiagnostics, resolveSourceRoot, resolveFrameSourceRoot, false, false, hyperlinks));
 		lines.push("");
 	}
 	return {
@@ -92363,18 +92407,19 @@ const buildOverviewHeaderLines = (diagnostics) => {
 * single Effect.forEach over Console.log so failures or fiber
 * interruption produce predictable partial output.
 */
-const printDiagnostics = (diagnostics, isVerbose, sourceRoot, rulePriority, isAgentEnvironment = false, onboarding = {}, hyperlinks = false) => gen(function* () {
+const printDiagnostics = (diagnostics, isVerbose, sourceRoot, rulePriority, isAgentEnvironment = false, onboarding = {}, hyperlinks = false, frameSourceRoot = sourceRoot) => gen(function* () {
 	const sectionPause = onboarding.sectionPause ?? void_;
 	const animateCountUp = onboarding.animateCountUp ?? false;
 	const resolveSourceRoot = typeof sourceRoot === "function" ? sourceRoot : () => sourceRoot;
+	const resolveFrameSourceRoot = typeof frameSourceRoot === "function" ? frameSourceRoot : () => frameSourceRoot;
 	let detailLines;
 	let topErrorBlockOffsets = [];
 	if (!isVerbose) {
-		const topErrors = buildTopErrorsSection(diagnostics, resolveSourceRoot, hyperlinks, rulePriority);
+		const topErrors = buildTopErrorsSection(diagnostics, resolveSourceRoot, resolveFrameSourceRoot, hyperlinks, rulePriority);
 		detailLines = topErrors.lines;
 		topErrorBlockOffsets = topErrors.blockOffsets;
 	} else detailLines = buildSortedRuleGroups(diagnostics, rulePriority).flatMap(([ruleKey, ruleDiagnostics]) => {
-		return [...buildRuleDetailBlock(ruleKey, ruleDiagnostics, resolveSourceRoot, true, isAgentEnvironment, hyperlinks), ""];
+		return [...buildRuleDetailBlock(ruleKey, ruleDiagnostics, resolveSourceRoot, resolveFrameSourceRoot, true, isAgentEnvironment, hyperlinks), ""];
 	});
 	const overflowLine = isVerbose ? void 0 : buildOverflowSummaryLine(diagnostics, rulePriority);
 	const categoryTallies = buildCategoryDiagnosticGroups(diagnostics, rulePriority).map(buildCategoryTally);
@@ -93638,26 +93683,26 @@ const finalizeAndRender = (input) => gen(function* () {
 //#region src/cli/utils/get-staged-files.ts
 const stagedFilesLayer = StagedFiles.layerNode.pipe(provide$2(Git.layerNode));
 const getStagedSourceFiles = async (directory) => {
+	let stagedSourceFiles;
 	try {
-		return [...await runPromise(gen(function* () {
+		stagedSourceFiles = await runPromise(gen(function* () {
 			return yield* (yield* StagedFiles).discoverSourceFiles(directory);
-		}).pipe(provide(stagedFilesLayer)))];
+		}).pipe(provide(stagedFilesLayer)));
 	} catch (error) {
 		cliLogger.warn(`Failed to discover staged files: ${messageFromUnknown(error)}`);
 		return [];
 	}
+	if (stagedSourceFiles === null) throw new CliInputError("Could not read the git index to list staged files. Check that git can read the index in this directory.");
+	return [...stagedSourceFiles];
 };
-const materializeStagedFiles = async (directory, stagedFiles, tempDirectory) => {
+const materializeStagedFiles = async (input) => {
 	const snapshot = await runPromise(gen(function* () {
-		return yield* (yield* StagedFiles).materialize({
-			directory,
-			stagedFiles,
-			tempDirectory
-		});
+		return yield* (yield* StagedFiles).materialize(input);
 	}).pipe(provide(stagedFilesLayer)));
 	return {
 		tempDirectory: snapshot.tempDirectory,
 		stagedFiles: [...snapshot.stagedFiles],
+		unmaterializedFiles: [...snapshot.unmaterializedFiles],
 		cleanup: snapshot.cleanup
 	};
 };
@@ -95531,13 +95576,18 @@ const printMultiProjectSummary = (input) => gen(function* () {
 	const scoreDiagnostics = new Set(filterScansForSurface(completedScans, "score"));
 	const displayedScoreDiagnostics = displayDiagnostics.filter((diagnostic) => scoreDiagnostics.has(diagnostic));
 	const projectRootByDiagnostic = /* @__PURE__ */ new WeakMap();
-	for (const scan of completedScans) for (const diagnostic of scan.result.diagnostics) projectRootByDiagnostic.set(diagnostic, scan.result.project.rootDirectory);
+	const frameSourceRootByDiagnostic = /* @__PURE__ */ new WeakMap();
+	for (const scan of completedScans) for (const diagnostic of scan.result.diagnostics) {
+		projectRootByDiagnostic.set(diagnostic, scan.result.project.rootDirectory);
+		frameSourceRootByDiagnostic.set(diagnostic, scan.frameSourceRoot ?? scan.result.project.rootDirectory);
+	}
 	const resolveDiagnosticSourceRoot = (diagnostic) => projectRootByDiagnostic.get(diagnostic) ?? "";
+	const resolveDiagnosticFrameSourceRoot = (diagnostic) => frameSourceRootByDiagnostic.get(diagnostic) ?? resolveDiagnosticSourceRoot(diagnostic);
 	const totalScannedFileCount = countUniqueScannedFiles(completedScans.map((scan) => scan.result));
 	yield* log(`${highlighter.success("✔")} Scanned ${totalScannedFileCount} ${totalScannedFileCount === 1 ? "file" : "files"} in ${formatElapsedTime(totalElapsedMilliseconds)}`);
 	if (displayDiagnostics.length > 0) {
 		yield* log("");
-		yield* printDiagnostics(displayDiagnostics, verbose, resolveDiagnosticSourceRoot, buildRulePriorityMap(completedScans.map((scan) => scan.result.score)), isCodingAgentEnvironment(), { animateCountUp: animateRender }, shouldRenderHyperlinks(process.stdout));
+		yield* printDiagnostics(displayDiagnostics, verbose, resolveDiagnosticSourceRoot, buildRulePriorityMap(completedScans.map((scan) => scan.result.score)), isCodingAgentEnvironment(), { animateCountUp: animateRender }, shouldRenderHyperlinks(process.stdout), resolveDiagnosticFrameSourceRoot);
 	}
 	const lowestScoredScan = findLowestScoredScan(completedScans);
 	const aggregateScore = lowestScoredScan?.result.score ?? null;
@@ -95925,6 +95975,45 @@ const runExplain = async (fileLineArgument, context) => {
 	}
 };
 //#endregion
+//#region src/cli/utils/run-project-scan-batch.ts
+/**
+* Run one scan per project through the same bounded pool as
+* `diagnose({ projects })`, with the batch spinner and its progress counter.
+*
+* Pool members must not toggle the module-level spinner-silent flag themselves —
+* overlapping save/restore pairs would race — so the batch owns that toggle once
+* around the whole run.
+*
+* A `scanProject` that returns `null` drops the project from the results: diff
+* mode skips projects with no changed source.
+*/
+const runProjectScanBatch = async (input) => {
+	const startTime = performance$1.now();
+	const projectCount = input.projects.length;
+	const isMultiProject = projectCount > 1;
+	const batchSpinner = isMultiProject && !input.isQuiet ? spinner(`Scanning ${projectCount} projects…`).start() : null;
+	const ownsBatchSpinnerSilence = isMultiProject && input.isSilent;
+	const wasSpinnerSilent = isSpinnerSilent();
+	if (ownsBatchSpinnerSilence) setSpinnerSilent(true);
+	let finishedProjectCount = 0;
+	let scanOutcomes;
+	try {
+		scanOutcomes = await mapWithConcurrency(input.projects, isMultiProject ? 4 : 1, async (project) => {
+			const scanOutcome = await input.scanProject(project);
+			finishedProjectCount += 1;
+			batchSpinner?.update(`Scanning ${projectCount} projects… (${finishedProjectCount}/${projectCount})`);
+			return scanOutcome;
+		});
+	} finally {
+		if (ownsBatchSpinnerSilence) setSpinnerSilent(wasSpinnerSilent);
+		batchSpinner?.stop();
+	}
+	return {
+		completedScans: scanOutcomes.filter((scanOutcome) => scanOutcome !== null),
+		elapsedMilliseconds: performance$1.now() - startTime
+	};
+};
+//#endregion
 //#region src/cli/utils/project-manifest-changed.ts
 const PACKAGE_JSON = "package.json";
 /**
@@ -95941,6 +96030,29 @@ const projectManifestChanged = (rootDirectory, projectDirectory, diffInfo) => {
 	return diffInfo.changedFiles.some((filePath) => toForwardSlashes(filePath) === manifestPath);
 };
 //#endregion
+//#region src/cli/utils/select-staged-projects.ts
+/**
+* Appended to the reason a `--staged` run could not scan per package. Shared so
+* both fallback sites word it identically.
+*/
+const STAGED_PROJECT_FALLBACK_HINT = "Scanning the staged files at the scan root instead — fix the `projects` entries in your config to scan per package.";
+/**
+* Resolve the project directories a `--staged` scan owns. The interactive picker
+* is always skipped: a commit hook has nobody to answer it.
+*/
+const selectStagedProjects = async (input) => {
+	if (input.projectFlag) return selectProjects(input.rootDirectory, input.projectFlag, true, void 0);
+	if (input.configProjects === void 0) return [input.rootDirectory];
+	try {
+		return await selectProjects(input.rootDirectory, void 0, true, input.configProjects);
+	} catch (error) {
+		if (!(error instanceof CliInputError)) throw error;
+		cliLogger.warn(`${error.message} ${STAGED_PROJECT_FALLBACK_HINT}`);
+		cliLogger.break();
+		return [input.rootDirectory];
+	}
+};
+//#endregion
 //#region src/cli/utils/should-fail-scan-gate.ts
 const shouldFailScanGate = (input) => {
 	if (input.blockingLevel === "none") return false;
@@ -96162,8 +96274,13 @@ const inspectAction = async (directory, flags, invocationCommand = "inspect") =>
 			json: flags.json
 		});
 		if (flags.staged) {
-			const stagedFiles = await getStagedSourceFiles(resolvedDirectory);
-			if (stagedFiles.length === 0) {
+			const configProjectsApply = (userConfig?.projects ?? []).some((projectName) => projectName.trim().length > 0) && scanTarget.requestedDirectory === scanTarget.configSourceDirectory;
+			const projectDirectories = await selectStagedProjects({
+				rootDirectory: resolvedDirectory,
+				projectFlag: flags.project,
+				configProjects: configProjectsApply ? userConfig?.projects : void 0
+			});
+			const reportNothingToScan = (input) => {
 				if (isJsonMode) writeJsonReport(buildJsonReport({
 					version: VERSION,
 					directory: resolvedDirectory,
@@ -96172,71 +96289,197 @@ const inspectAction = async (directory, flags, invocationCommand = "inspect") =>
 					scans: [],
 					totalElapsedMilliseconds: performance$1.now() - startTime
 				}));
-				else if (!isScoreOnly) cliLogger.dim("No staged source files found.");
+				else if (!isScoreOnly) if (input.severity === "warn") {
+					cliLogger.warn(input.reason);
+					cliLogger.break();
+				} else cliLogger.dim(input.reason);
+			};
+			const rootStagedFiles = await getStagedSourceFiles(resolvedDirectory);
+			if (rootStagedFiles.length === 0) {
+				reportNothingToScan({ reason: "No staged source files found." });
 				return;
 			}
-			if (!isQuiet) {
-				cliLogger.log(`Scanning ${highlighter.info(`${stagedFiles.length}`)} staged files...`);
+			const buildProjectScanContext = async (projectDirectory) => {
+				const projectScanTarget = projectDirectory === resolvedDirectory ? scanTarget : await resolveScanTarget(projectDirectory, { allowAmbiguous: true });
+				const scanDirectory = projectScanTarget.resolvedDirectory;
+				const treeRelativeDirectory = resolveProjectRelativeDirectory(resolvedDirectory, scanDirectory);
+				if (treeRelativeDirectory === null) return null;
+				return {
+					projectDirectory,
+					scanDirectory,
+					treeRelativeDirectory,
+					projectConfig: projectDirectory === resolvedDirectory ? userConfig : mergeReactDoctorConfigs(userConfig, projectScanTarget.userConfig ?? void 0),
+					projectConfigSourceDirectory: projectScanTarget.userConfig?.plugins === void 0 ? scanTarget.configSourceDirectory : projectScanTarget.configSourceDirectory
+				};
+			};
+			const projectScanContexts = [];
+			const seenScanDirectories = /* @__PURE__ */ new Set();
+			for (const projectDirectory of projectDirectories) {
+				const projectScanContext = await buildProjectScanContext(projectDirectory);
+				if (projectScanContext === null) {
+					if (flags.project) throw new CliInputError(`Project "${toRelativePath(projectDirectory, resolvedDirectory)}" is outside ${resolvedDirectory}, so it holds none of the staged files. Run --staged from a directory that contains the project.`);
+					continue;
+				}
+				if (seenScanDirectories.has(projectScanContext.scanDirectory)) continue;
+				seenScanDirectories.add(projectScanContext.scanDirectory);
+				projectScanContexts.push(projectScanContext);
+			}
+			if (projectScanContexts.length === 0) {
+				cliLogger.warn(`No configured project is inside ${resolvedDirectory}. ${STAGED_PROJECT_FALLBACK_HINT}`);
 				cliLogger.break();
+				const rootScanContext = await buildProjectScanContext(resolvedDirectory);
+				if (rootScanContext !== null) projectScanContexts.push(rootScanContext);
 			}
-			const tempDirectory = NFS.mkdtempSync(Path.join(tmpdir(), STAGED_FILES_TEMP_DIR_PREFIX));
-			const snapshot = await materializeStagedFiles(resolvedDirectory, stagedFiles, tempDirectory).catch((error) => {
-				NFS.rmSync(tempDirectory, {
-					recursive: true,
-					force: true
+			const contextsByLongestPathFirst = [...projectScanContexts].sort((left, right) => right.treeRelativeDirectory.length - left.treeRelativeDirectory.length);
+			const ownedStagedFiles = /* @__PURE__ */ new Map();
+			for (const stagedFile of rootStagedFiles) {
+				const owner = contextsByLongestPathFirst.find((context) => context.treeRelativeDirectory.length === 0 || stagedFile.startsWith(`${context.treeRelativeDirectory}/`));
+				if (owner === void 0) continue;
+				const ownedFiles = ownedStagedFiles.get(owner.scanDirectory);
+				if (ownedFiles === void 0) ownedStagedFiles.set(owner.scanDirectory, [stagedFile]);
+				else ownedFiles.push(stagedFile);
+			}
+			const stagedProjectScans = [];
+			for (const projectScanContext of projectScanContexts) {
+				const projectStagedFiles = ownedStagedFiles.get(projectScanContext.scanDirectory);
+				if (projectStagedFiles === void 0) continue;
+				stagedProjectScans.push({
+					...projectScanContext,
+					stagedFiles: projectStagedFiles
 				});
-				throw error;
-			});
+			}
+			if (stagedProjectScans.length === 0) {
+				reportNothingToScan({ reason: "No staged source files in the selected projects." });
+				return;
+			}
+			const selectedStagedFiles = stagedProjectScans.flatMap((projectScan) => projectScan.stagedFiles);
+			const stagedFileCount = selectedStagedFiles.length;
+			const unselectedStagedFileCount = rootStagedFiles.length - stagedFileCount;
+			if (!isQuiet) {
+				cliLogger.log(`Scanning ${highlighter.info(`${stagedFileCount}`)} staged files...`);
+				if (unselectedStagedFileCount > 0) cliLogger.dim(`${unselectedStagedFileCount} more staged file${unselectedStagedFileCount === 1 ? "" : "s"} outside the selected projects.`);
+				cliLogger.break();
+			}
 			const stagedWantsLines = resolveScope(flags, userConfig).scope === "lines";
 			const stagedLineRanges = stagedWantsLines ? await getChangedLineRanges({
 				directory: resolvedDirectory,
 				cached: true,
-				files: snapshot.stagedFiles
+				files: selectedStagedFiles
 			}) : null;
 			if (stagedWantsLines && stagedLineRanges === null && !isQuiet) {
 				cliLogger.warn("Could not determine staged changed lines; reporting all issues in staged files.");
 				cliLogger.break();
 			}
-			try {
-				const scanResult = await inspect(snapshot.tempDirectory, {
+			if (stagedProjectScans.some((projectScan) => projectScan.treeRelativeDirectory.length > 0)) recordCount(METRIC.stagedPerProject, 1, { projectCount: stagedProjectScans.length });
+			const tempDirectory = NFS.mkdtempSync(Path.join(tmpdir(), STAGED_FILES_TEMP_DIR_PREFIX));
+			const configSubdirectories = /* @__PURE__ */ new Set();
+			for (const projectScan of stagedProjectScans) {
+				configSubdirectories.add(projectScan.treeRelativeDirectory);
+				const projectRelativeDirectory = resolveProjectRelativeDirectory(resolvedDirectory, projectScan.projectDirectory);
+				if (projectRelativeDirectory !== null) configSubdirectories.add(projectRelativeDirectory);
+			}
+			const snapshot = await materializeStagedFiles({
+				directory: resolvedDirectory,
+				stagedFiles: selectedStagedFiles,
+				tempDirectory,
+				configSubdirectories: [...configSubdirectories]
+			}).catch((error) => {
+				NFS.rmSync(tempDirectory, {
+					recursive: true,
+					force: true
+				});
+				throw error;
+			});
+			const materializedStagedFiles = new Set(snapshot.stagedFiles);
+			const stagedProjectRuns = stagedProjectScans.map((projectScan) => ({
+				projectScan,
+				includePaths: resolveProjectSourceFilePaths(resolvedDirectory, projectScan.scanDirectory, projectScan.stagedFiles.filter((stagedFile) => materializedStagedFiles.has(stagedFile)))
+			})).filter((projectRun) => projectRun.includePaths.length > 0);
+			const isMultiProject = stagedProjectRuns.length > 1;
+			if (stagedProjectRuns.length === 0) {
+				snapshot.cleanup();
+				reportNothingToScan({
+					reason: `Could not read any of the ${stagedFileCount} staged file${stagedFileCount === 1 ? "" : "s"} out of the index, so nothing was scanned. An unusually large staged file is the usual cause.`,
+					severity: "warn"
+				});
+				return;
+			}
+			if (snapshot.unmaterializedFiles.length > 0 && !isQuiet) {
+				const stagedFileLabel = `staged file${stagedFileCount === 1 ? "" : "s"}`;
+				cliLogger.warn(`Skipped ${snapshot.unmaterializedFiles.length} of ${stagedFileCount} ${stagedFileLabel}; they could not be snapshotted from the index.`);
+				cliLogger.break();
+			}
+			const scanStagedProject = async (projectRun) => {
+				const { projectScan, includePaths } = projectRun;
+				const projectTempDirectory = Path.join(snapshot.tempDirectory, projectScan.treeRelativeDirectory);
+				const scanResult = await inspect(projectTempDirectory, {
 					...scanOptions,
 					deadlineEpochMs: scanDeadlineEpochMs,
-					includePaths: snapshot.stagedFiles,
-					configOverride: userConfig,
-					configSourceDirectory: scanTarget.configSourceDirectory ?? void 0,
-					changedLineRanges: stagedLineRanges ?? void 0
+					includePaths: [...includePaths],
+					configOverride: projectScan.projectConfig,
+					configSourceDirectory: projectScan.projectConfigSourceDirectory ?? void 0,
+					changedLineRanges: stagedLineRanges === null ? void 0 : resolveProjectChangedLineRanges(resolvedDirectory, projectScan.scanDirectory, stagedLineRanges),
+					suppressRendering: isMultiProject,
+					concurrentScan: isMultiProject
 				});
 				const remappedDiagnostics = scanResult.diagnostics.map((diagnostic) => ({
 					...diagnostic,
-					filePath: Path.isAbsolute(diagnostic.filePath) ? diagnostic.filePath.replaceAll(snapshot.tempDirectory, () => resolvedDirectory) : diagnostic.filePath
+					filePath: Path.isAbsolute(diagnostic.filePath) ? diagnostic.filePath.replaceAll(projectTempDirectory, () => projectScan.scanDirectory) : diagnostic.filePath
 				}));
-				finalizeScans({
-					completedScans: [{
-						directory: resolvedDirectory,
-						result: {
-							...scanResult,
-							diagnostics: remappedDiagnostics,
-							project: {
-								...scanResult.project,
-								rootDirectory: resolvedDirectory
-							}
-						},
-						config: userConfig
-					}],
-					mode: "staged",
-					diff: null,
-					baselineIntended: false,
-					isJsonMode,
-					isScoreOnly,
-					flags,
-					categoryFilters,
-					userConfig,
-					resolvedDirectory,
-					startTime
-				});
+				return {
+					directory: projectScan.scanDirectory,
+					result: {
+						...scanResult,
+						diagnostics: remappedDiagnostics,
+						project: {
+							...scanResult.project,
+							rootDirectory: projectScan.scanDirectory
+						}
+					},
+					config: projectScan.projectConfig,
+					frameSourceRoot: projectTempDirectory
+				};
+			};
+			const stagedBatch = await runProjectScanBatch({
+				projects: stagedProjectRuns,
+				isQuiet,
+				isSilent: scanOptions.silent === true,
+				scanProject: scanStagedProject
+			}).catch((error) => {
+				snapshot.cleanup();
+				throw error;
+			});
+			const completedScans = stagedBatch.completedScans;
+			try {
+				if (!isQuiet && isMultiProject) {
+					const showShareLink = !isShareOptedOut(completedScans, scanOptions.noScore) && !scanOptions.isCi;
+					await runPromise(printMultiProjectSummary({
+						completedScans,
+						categoryFilters,
+						verbose: Boolean(flags.verbose),
+						outputDirectory: flags.outputDir,
+						isOffline: !showShareLink,
+						projectName: Path.basename(resolvedDirectory),
+						totalElapsedMilliseconds: stagedBatch.elapsedMilliseconds
+					}));
+				}
+				if (flags.outputDir && isMultiProject && isQuiet) await runPromise(printDiagnosticsDump(filterDiagnosticsByCategories(filterScansForSurface(completedScans, scanOptions.outputSurface ?? "cli"), categoryFilters), flags.outputDir, false, "stderr"));
 			} finally {
 				snapshot.cleanup();
 			}
+			finalizeScans({
+				completedScans,
+				mode: "staged",
+				diff: null,
+				baselineIntended: false,
+				isJsonMode,
+				isScoreOnly,
+				flags,
+				categoryFilters,
+				userConfig,
+				resolvedDirectory,
+				startTime
+			});
 			return;
 		}
 		const projectDirectories = await selectProjects(resolvedDirectory, flags.project, skipPrompts, userConfig?.projects);
@@ -96301,7 +96544,6 @@ const inspectAction = async (directory, flags, invocationCommand = "inspect") =>
 			}
 			cliLogger.break();
 		}
-		const completedScans = [];
 		const isMultiProject = projectDirectories.length > 1;
 		const scanProject = async (projectDirectory) => {
 			const projectScanTarget = projectDirectory === resolvedDirectory ? scanTarget : await resolveScanTarget(projectDirectory, { allowAmbiguous: true });
@@ -96352,29 +96594,13 @@ const inspectAction = async (directory, flags, invocationCommand = "inspect") =>
 				config: projectConfig
 			};
 		};
-		const scanLoopStartTime = performance$1.now();
-		const projectCount = projectDirectories.length;
-		const batchSpinner = isMultiProject && !isQuiet ? spinner(`Scanning ${projectCount} projects…`).start() : null;
-		const ownsBatchSpinnerSilence = isMultiProject && scanOptions.silent === true;
-		const wasSpinnerSilent = isSpinnerSilent();
-		if (ownsBatchSpinnerSilence) setSpinnerSilent(true);
-		let finishedProjectCount = 0;
-		let scanOutcomes;
-		try {
-			scanOutcomes = await mapWithConcurrency(projectDirectories, isMultiProject ? 4 : 1, async (projectDirectory) => {
-				const scanOutcome = await scanProject(projectDirectory);
-				finishedProjectCount += 1;
-				batchSpinner?.update(`Scanning ${projectCount} projects… (${finishedProjectCount}/${projectCount})`);
-				return scanOutcome;
-			});
-		} finally {
-			if (ownsBatchSpinnerSilence) setSpinnerSilent(wasSpinnerSilent);
-			batchSpinner?.stop();
-		}
-		for (const scanOutcome of scanOutcomes) {
-			if (scanOutcome === null) continue;
-			completedScans.push(scanOutcome);
-		}
+		const projectBatch = await runProjectScanBatch({
+			projects: projectDirectories,
+			isQuiet,
+			isSilent: scanOptions.silent === true,
+			scanProject
+		});
+		const completedScans = projectBatch.completedScans;
 		if (!isQuiet && isMultiProject && completedScans.length > 0) {
 			const showShareLink = !isShareOptedOut(completedScans, scanOptions.noScore) && !scanOptions.isCi;
 			await runPromise(printMultiProjectSummary({
@@ -96384,7 +96610,7 @@ const inspectAction = async (directory, flags, invocationCommand = "inspect") =>
 				outputDirectory: flags.outputDir,
 				isOffline: !showShareLink,
 				projectName: Path.basename(resolvedDirectory),
-				totalElapsedMilliseconds: performance$1.now() - scanLoopStartTime
+				totalElapsedMilliseconds: projectBatch.elapsedMilliseconds
 			}));
 		}
 		const selectedSurfaceDiagnostics = filterDiagnosticsByCategories(filterScansForSurface(completedScans, scanOptions.outputSurface ?? "cli"), categoryFilters);
@@ -97530,7 +97756,7 @@ ${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("-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").option("--max-duration <seconds>", "scan time budget for the whole run, shared across workspace projects: past it, remaining lint batches and dead-code are skipped and partial results are reported (skipped files are listed in the JSON report)").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").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("-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>", "scan time budget for the whole run, shared across workspace projects: past it, remaining lint batches and dead-code are skipped and partial results are reported (skipped files are listed in the JSON report)").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(inspectAction);
 program.command("design [directory]").description("Run only the focused UI design diagnostics").addHelpText("after", renderDesignHelpEpilog).action((directory, _options, command) => 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((location, options) => whyAction(location, options));
@@ -97613,4 +97839,4 @@ Promise.resolve().then(() => assertNoRemovedFlags(process.argv)).then(() => prog
 export { toForwardSlashes as A, getCategoryImpact as B, buildRulePriorityMap as C, resolveBlockingLevel as D, formatLearnMoreLine as E, TUI_REPORT_DETAIL_WIDTH_FRACTION as F, runPromise as G, mapWithConcurrency as H, isCiEnvironment as I, succeed$3 as J, sync as K, DIAGNOSTIC_CATEGORY_BUCKETS as L, isUnicodeSupported as M, METRIC as N, isReactDoctorWorkflowInstalled as O, TUI_REPORT_COMPACT_MAX_ROWS as P, Progress as R, hasLintHardFailure as S, formatFixRecipeLine as T, mergeReactDoctorConfigs as U, highlighter as V, resolveScanTarget as W, canAnimateOnboarding as _, resolveCliInspectOptions as a, buildCodeFrame as b, detectLaunchableAgents as c, launchCliAgent as d, isShareOptedOut as f, doctorFace as g, easeOutCubic as h, selectProjects as i, findNearestPackageDirectory as j, recordCount as k, CLI_AGENT_BINARIES as l, printFooter as m, shouldFailScanGate as n, countUniqueScannedFiles as o, inspect as p, void_ as q, discoverWorkspacePackages as r, setUpGitHubActions as s, exitGracefully as t, copyToClipboard as u, computeProjectedScore as v, buildSortedRuleGroups as w, buildNoScoreMessage as x, formatElapsedTime as y, Reporter as z };
 
 //# sourceMappingURL=cli.js.map
-//# debugId=3ced4c14-18cb-5b0c-811c-3448b5c2f139
+//# debugId=2a10a6ef-ec19-5a23-88d5-c2e4d5e30eec