react-doctor 0.2.14-dev.b612664 → 0.2.14-dev.daef23c

package/dist/index.js

@@ -59,6 +59,7 @@ var Diagnostic = class extends Schema.Class("Diagnostic")({
 	plugin: Schema.String,
 	rule: Schema.String,
 	severity: Severity,
+	title: Schema.optional(Schema.String),
 	message: Schema.String,
 	help: Schema.String,
 	url: Schema.optional(Schema.String),
@@ -2094,6 +2095,8 @@ const isFile = (filePath) => {
 	}
 };
 const SOURCE_FILE_PATTERN = /\.(tsx?|jsx?)$/;
+const GENERATED_BUNDLE_FILE_PATTERN = /\.(iife|umd|global|min)\.js$/i;
+const MINIFIED_SNIFF_BYTES = 65536;
 const GIT_LS_FILES_MAX_BUFFER_BYTES = 50 * 1024 * 1024;
 const IGNORED_DIRECTORIES = new Set([
 	".git",
@@ -2109,6 +2112,34 @@ const IGNORED_DIRECTORIES = new Set([
 	"out",
 	"storybook-static"
 ]);
+const isLintableSourceFile = (filePath) => SOURCE_FILE_PATTERN.test(filePath) && !GENERATED_BUNDLE_FILE_PATTERN.test(filePath);
+const isMinifiedSource = (absolutePath) => {
+	let fileDescriptor;
+	try {
+		fileDescriptor = fs.openSync(absolutePath, "r");
+		const buffer = Buffer.alloc(MINIFIED_SNIFF_BYTES);
+		const bytesRead = fs.readSync(fileDescriptor, buffer, 0, MINIFIED_SNIFF_BYTES, 0);
+		const prefix = buffer.toString("utf8", 0, bytesRead);
+		const lines = prefix.split("\n");
+		const longestLineLength = lines.reduce((longest, line) => Math.max(longest, line.length), 0);
+		const averageLineLength = prefix.length / lines.length;
+		return longestLineLength > 1e3 && averageLineLength > 500;
+	} catch {
+		return false;
+	} finally {
+		if (fileDescriptor !== void 0) fs.closeSync(fileDescriptor);
+	}
+};
+const isLargeMinifiedFile = (absolutePath) => {
+	let sizeBytes;
+	try {
+		sizeBytes = fs.statSync(absolutePath).size;
+	} catch {
+		return false;
+	}
+	if (sizeBytes < 2e4) return false;
+	return isMinifiedSource(absolutePath);
+};
 const IGNORABLE_READDIR_ERROR_CODES = new Set([
 	"EACCES",
 	"EPERM",
@@ -2139,7 +2170,7 @@ const countSourceFilesViaFilesystem = (rootDirectory) => {
 				if (!entry.name.startsWith(".") && !IGNORED_DIRECTORIES.has(entry.name)) stack.push(path.join(currentDirectory, entry.name));
 				continue;
 			}
-			if (entry.isFile() && SOURCE_FILE_PATTERN.test(entry.name)) count++;
+			if (entry.isFile() && isLintableSourceFile(entry.name) && !isLargeMinifiedFile(path.join(currentDirectory, entry.name))) count++;
 		}
 	}
 	return count;
@@ -2157,7 +2188,7 @@ const countSourceFilesViaGit = (rootDirectory) => {
 		maxBuffer: GIT_LS_FILES_MAX_BUFFER_BYTES
 	});
 	if (result.error || result.status !== 0) return null;
-	return result.stdout.split("\0").filter((filePath) => filePath.length > 0 && SOURCE_FILE_PATTERN.test(filePath)).length;
+	return result.stdout.split("\0").filter((filePath) => filePath.length > 0 && isLintableSourceFile(filePath) && !isLargeMinifiedFile(path.resolve(rootDirectory, filePath))).length;
 };
 const countSourceFiles = (rootDirectory) => countSourceFilesViaGit(rootDirectory) ?? countSourceFilesViaFilesystem(rootDirectory);
 const cachedPackageJsons = /* @__PURE__ */ new Map();
@@ -3240,7 +3271,18 @@ const STAGED_FILES_PROJECT_CONFIG_FILENAMES = [
 ];
 const OXLINT_OUTPUT_MAX_BYTES = 50 * 1024 * 1024;
 const OXLINT_SPAWN_TIMEOUT_MS = 6e4;
+const DEAD_CODE_WORKER_MAX_OLD_SPACE_MB = 8192;
 const RECOMMENDED_PNPM_MINIMUM_RELEASE_AGE_MINUTES = 10080;
+const DIAGNOSTIC_CATEGORY_BUCKETS = [
+	"Security",
+	"Bugs",
+	"Performance",
+	"Accessibility",
+	"Maintainability"
+];
+const APP_ONLY_RULE_KEYS = new Set(["react-hooks-js/static-components", "react-doctor/no-render-prop-children"]);
+const COMPILER_CLEANUP_BUCKET = "compiler-cleanup";
+const COMPILER_CLEANUP_RULE_KEYS = new Set(["react-doctor/react-compiler-no-manual-memoization"]);
 const MAX_GLOB_PATTERN_LENGTH_CHARS = 1024;
 const CONFIG_CACHE_TTL_MS = 300 * 1e3;
 var InvalidGlobPatternError = class extends Error {
@@ -3360,10 +3402,11 @@ const restampSeverity = (diagnostic, override) => {
 */
 const buildRuleSeverityControls = (config) => {
 	if (!config) return void 0;
-	if (config.rules === void 0 && config.categories === void 0) return void 0;
+	if (config.rules === void 0 && config.categories === void 0 && config.buckets === void 0) return;
 	return {
 		...config.rules !== void 0 ? { rules: config.rules } : {},
-		...config.categories !== void 0 ? { categories: config.categories } : {}
+		...config.categories !== void 0 ? { categories: config.categories } : {},
+		...config.buckets !== void 0 ? { buckets: config.buckets } : {}
 	};
 };
 const JSX_OPENER_TAG_PATTERN = /<[A-Za-z][\w.]*/g;
@@ -3727,6 +3770,69 @@ const resolveRuleSeverityOverride = (input, controls) => {
 	}
 	return input.category !== void 0 ? controls.categories?.[input.category] : void 0;
 };
+const cachedRoleByPackageDirectory = /* @__PURE__ */ new Map();
+const cachedPackageDirectoryByFilename = /* @__PURE__ */ new Map();
+const findNearestPackageDirectory = (filename) => {
+	if (!filename) return null;
+	const fromCache = cachedPackageDirectoryByFilename.get(filename);
+	if (fromCache !== void 0) return fromCache;
+	let currentDirectory = path.dirname(filename);
+	while (true) {
+		const candidatePackageJsonPath = path.join(currentDirectory, "package.json");
+		let hasPackageJson = false;
+		try {
+			hasPackageJson = fs.statSync(candidatePackageJsonPath).isFile();
+		} catch {
+			hasPackageJson = false;
+		}
+		if (hasPackageJson) {
+			cachedPackageDirectoryByFilename.set(filename, currentDirectory);
+			return currentDirectory;
+		}
+		const parentDirectory = path.dirname(currentDirectory);
+		if (parentDirectory === currentDirectory) {
+			cachedPackageDirectoryByFilename.set(filename, null);
+			return null;
+		}
+		currentDirectory = parentDirectory;
+	}
+};
+const readManifest = (packageJsonPath) => {
+	try {
+		const parsed = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
+		if (typeof parsed === "object" && parsed !== null) return parsed;
+		return null;
+	} catch {
+		return null;
+	}
+};
+const hasPublishContract = (manifest) => typeof manifest.name === "string" && manifest.name.length > 0 && manifest.exports !== void 0 && manifest.exports !== null && manifest.private !== true;
+const classifyByDirectoryCohort = (packageDirectory) => {
+	let current = packageDirectory;
+	while (true) {
+		if (path.basename(current) === "apps") return "app";
+		const parent = path.dirname(current);
+		if (parent === current) return null;
+		current = parent;
+	}
+};
+const clearPackageRoleCache = () => {
+	cachedRoleByPackageDirectory.clear();
+	cachedPackageDirectoryByFilename.clear();
+};
+const classifyPackageRole = (filename) => {
+	if (!filename) return "unknown";
+	const packageDirectory = findNearestPackageDirectory(filename);
+	if (!packageDirectory) return "unknown";
+	const cached = cachedRoleByPackageDirectory.get(packageDirectory);
+	if (cached !== void 0) return cached;
+	const manifest = readManifest(path.join(packageDirectory, "package.json"));
+	let result;
+	if (manifest && hasPublishContract(manifest)) result = "library";
+	else result = classifyByDirectoryCohort(path.dirname(packageDirectory)) ?? "unknown";
+	cachedRoleByPackageDirectory.set(packageDirectory, result);
+	return result;
+};
 /**
 * Resolves the absolute path to read for a diagnostic's `filePath`,
 * accounting for the various shapes oxlint emits:
@@ -3862,10 +3968,13 @@ const collectStringSet = (values) => {
 *    wins over `test-noise`)
 * 2. severity overrides (top-level `rules` / `categories`, with
 *    `"off"` dropping)
-* 3. ignore filters (rules / file patterns / per-file overrides)
-* 4. `rn-no-raw-text` suppression via configured `textComponents` and
+* 3. warning suppression (only when `showWarnings` is false: drops every
+*    `"warning"`-severity diagnostic unless a severity override opts a
+*    specific rule / category back in)
+* 4. ignore filters (rules / file patterns / per-file overrides)
+* 5. `rn-no-raw-text` suppression via configured `textComponents` and
 *    `rawTextWrapperComponents` (config-driven JSX enclosure checks)
-* 5. inline suppressions (`// react-doctor-disable-next-line ...`)
+* 6. inline suppressions (`// react-doctor-disable-next-line ...`)
 *
 * Returns `null` when the diagnostic is dropped, the (possibly
 * severity-restamped) diagnostic otherwise.
@@ -3875,7 +3984,7 @@ const collectStringSet = (values) => {
 * `mergeAndFilterDiagnostics` wrapper apply this closure per element.
 */
 const buildDiagnosticPipeline = (input) => {
-	const { rootDirectory, userConfig, readFileLinesSync, respectInlineDisables } = input;
+	const { rootDirectory, userConfig, readFileLinesSync, respectInlineDisables, showWarnings } = input;
 	const severityControls = buildRuleSeverityControls(userConfig);
 	const ignoredRules = new Set(Array.isArray(userConfig?.ignore?.rules) ? userConfig.ignore.rules.filter((rule) => typeof rule === "string") : []);
 	const ignoredFilePatterns = compileIgnoredFilePatterns(userConfig);
@@ -3886,6 +3995,15 @@ const buildDiagnosticPipeline = (input) => {
 	const hasRawTextWrappers = rawTextWrapperComponentNames.size > 0;
 	const fileLinesCache = /* @__PURE__ */ new Map();
 	const testFileCache = /* @__PURE__ */ new Map();
+	const libraryFileCache = /* @__PURE__ */ new Map();
+	const isLibraryFile = (filePath) => {
+		let cached = libraryFileCache.get(filePath);
+		if (cached === void 0) {
+			cached = classifyPackageRole(resolveCandidateReadPath(rootDirectory, filePath)) === "library";
+			libraryFileCache.set(filePath, cached);
+		}
+		return cached;
+	};
 	const getFileLines = (filePath) => {
 		const cached = fileLinesCache.get(filePath);
 		if (cached !== void 0) return cached;
@@ -3912,6 +4030,10 @@ const buildDiagnosticPipeline = (input) => {
 		for (const ignored of ignoredRules) if (isSameRuleKey(ignored, ruleIdentifier)) return true;
 		return false;
 	};
+	const isAppOnlyRule = (ruleIdentifier) => {
+		for (const appOnlyRuleKey of APP_ONLY_RULE_KEYS) if (isSameRuleKey(appOnlyRuleKey, ruleIdentifier)) return true;
+		return false;
+	};
 	const isRnRawTextSuppressedByConfig = (diagnostic) => {
 		if (diagnostic.rule !== "rn-no-raw-text") return false;
 		if (diagnostic.line <= 0) return false;
@@ -3925,15 +4047,22 @@ const buildDiagnosticPipeline = (input) => {
 	return { apply: (diagnostic) => {
 		if (shouldAutoSuppress(diagnostic)) return null;
 		let current = diagnostic;
+		let explicitSeverityOverride;
+		let explicitRuleOverride;
 		if (severityControls) {
 			const { ruleKey, category } = getDiagnosticRuleIdentity(current);
-			const override = resolveRuleSeverityOverride({
+			explicitRuleOverride = resolveRuleSeverityOverride({ ruleKey }, severityControls);
+			explicitSeverityOverride = resolveRuleSeverityOverride({
 				ruleKey,
 				category
 			}, severityControls);
-			if (override === "off") return null;
-			if (override !== void 0) current = restampSeverity(current, override);
+			if (explicitSeverityOverride === "off") return null;
+			if (explicitSeverityOverride !== void 0) current = restampSeverity(current, explicitSeverityOverride);
+		}
+		if (explicitRuleOverride === void 0) {
+			if (isAppOnlyRule(`${current.plugin}/${current.rule}`) && isLibraryFile(current.filePath)) return null;
 		}
+		if (!showWarnings && current.severity === "warning" && explicitSeverityOverride !== "warn") return null;
 		if (userConfig) {
 			if (isRuleIgnored(`${current.plugin}/${current.rule}`)) return null;
 			if (isFileIgnoredByPatterns(current.filePath, rootDirectory, ignoredFilePatterns)) return null;
@@ -4165,10 +4294,18 @@ const VALID_RULE_SEVERITIES = [
 	"warn",
 	"off"
 ];
+const KNOWN_CATEGORY_LABEL = DIAGNOSTIC_CATEGORY_BUCKETS.join(", ");
+const isDiagnosticCategoryBucket = (value) => DIAGNOSTIC_CATEGORY_BUCKETS.includes(value);
+const filterKnownCategories = (fieldName, categories) => categories.filter((category) => {
+	if (isDiagnosticCategoryBucket(category)) return true;
+	warnConfigIssue(`config field "${fieldName}" lists "${category}", which is not a known category (expected one of: ${KNOWN_CATEGORY_LABEL}); ignoring the entry.`);
+	return false;
+});
 const BOOLEAN_FIELD_NAMES = [
 	"lint",
 	"deadCode",
 	"verbose",
+	"warnings",
 	"customRulesOnly",
 	"share",
 	"noScore",
@@ -4217,13 +4354,15 @@ const validateSurfaceControls = (surface, rawControls) => {
 		warnConfigIssue(`config field "surfaces.${surface}" must be an object (got ${typeof rawControls}); ignoring this surface.`);
 		return;
 	}
-	const validated = {};
+	const validatedSurfaceControls = {};
 	for (const fieldName of SURFACE_CONTROL_FIELD_NAMES) {
 		if (rawControls[fieldName] === void 0) continue;
-		const result = validateStringArrayField(`surfaces.${surface}.${fieldName}`, rawControls[fieldName]);
-		if (result !== void 0) validated[fieldName] = result;
+		const qualifiedName = `surfaces.${surface}.${fieldName}`;
+		const result = validateStringArrayField(qualifiedName, rawControls[fieldName]);
+		if (result === void 0) continue;
+		validatedSurfaceControls[fieldName] = fieldName === "includeCategories" || fieldName === "excludeCategories" ? filterKnownCategories(qualifiedName, result) : result;
 	}
-	return validated;
+	return validatedSurfaceControls;
 };
 const validateSurfacesField = (rawSurfaces) => {
 	if (!isPlainObject$1(rawSurfaces)) {
@@ -4241,7 +4380,7 @@ const validateSurfacesField = (rawSurfaces) => {
 	}
 	return validated;
 };
-const validateSeverityMap = (fieldName, rawMap) => {
+const validateSeverityMap = (fieldName, rawMap, keysAreCategories = false) => {
 	if (!isPlainObject$1(rawMap)) {
 		warnConfigIssue(`config field "${fieldName}" must be an object (got ${typeof rawMap}); ignoring this field.`);
 		return;
@@ -4252,6 +4391,10 @@ const validateSeverityMap = (fieldName, rawMap) => {
 			warnConfigIssue(`config field "${fieldName}" has an empty key; ignoring the entry.`);
 			continue;
 		}
+		if (keysAreCategories && !isDiagnosticCategoryBucket(key)) {
+			warnConfigIssue(`config field "${fieldName}.${key}" is not a known category (expected one of: ${KNOWN_CATEGORY_LABEL}); ignoring the entry.`);
+			continue;
+		}
 		if (!isRuleSeverity(value)) {
 			warnConfigIssue(`config field "${fieldName}.${key}" must be one of: ${VALID_RULE_SEVERITIES.join(", ")} (got ${formatType(value)}); ignoring the entry.`);
 			continue;
@@ -4272,7 +4415,7 @@ const validateConfigTypes = (config) => {
 	for (const fieldName of BOOLEAN_FIELD_NAMES) applyFieldValidator(config, validated, fieldName, (value) => coerceMaybeBooleanString(fieldName, value));
 	for (const fieldName of STRING_FIELD_NAMES) applyFieldValidator(config, validated, fieldName, (value) => validateString(fieldName, value));
 	applyFieldValidator(config, validated, "surfaces", validateSurfacesField);
-	for (const fieldName of SEVERITY_FIELD_NAMES) applyFieldValidator(config, validated, fieldName, (value) => validateSeverityMap(fieldName, value));
+	for (const fieldName of SEVERITY_FIELD_NAMES) applyFieldValidator(config, validated, fieldName, (value) => validateSeverityMap(fieldName, value, fieldName === "categories"));
 	applyFieldValidator(config, validated, "plugins", (value) => validateStringArrayField("plugins", value));
 	return validated;
 };
@@ -4356,11 +4499,12 @@ const resolveConfigRootDir = (config, configSourceDirectory) => {
 	}
 	return resolvedRootDir;
 };
-const resolveDiagnoseTarget = (directory) => {
+const resolveDiagnoseTarget = (directory, options = {}) => {
 	if (isFile(path.join(directory, "package.json"))) return directory;
 	const reactSubprojects = discoverReactSubprojects(directory);
 	if (reactSubprojects.length === 0) return null;
 	if (reactSubprojects.length === 1) return reactSubprojects[0].directory;
+	if (options.allowAmbiguous === true) return null;
 	throw new AmbiguousProjectError(directory, reactSubprojects.map((subproject) => path.relative(directory, subproject.directory)).toSorted());
 };
 /**
@@ -4374,7 +4518,8 @@ const resolveDiagnoseTarget = (directory) => {
 *      project root, if configured.
 *   4. Walk into a nested React subproject when the requested
 *      directory has no `package.json` of its own (raises
-*      `AmbiguousProjectError` when multiple candidates exist).
+*      `AmbiguousProjectError` when multiple candidates exist unless
+*      the caller opts into keeping the wrapper directory).
 *
 * Throws `ProjectNotFoundError` when neither the requested directory
 * nor any discoverable nested project has a `package.json`.
@@ -4386,14 +4531,14 @@ const resolveDiagnoseTarget = (directory) => {
 * via its own cache). Routing through `resolveScanTarget` keeps every
 * shell in agreement on what "the scan directory" means.
 */
-const resolveScanTarget = (requestedDirectory) => {
+const resolveScanTarget = (requestedDirectory, options = {}) => {
 	const absoluteRequested = path.resolve(requestedDirectory);
 	const loadedConfig = loadConfigWithSource(absoluteRequested);
 	const userConfig = loadedConfig?.config ?? null;
 	const configSourceDirectory = loadedConfig?.sourceDirectory ?? null;
 	const redirectedDirectory = resolveConfigRootDir(userConfig, configSourceDirectory);
 	const directoryAfterRedirect = redirectedDirectory ?? absoluteRequested;
-	const resolvedDirectory = resolveDiagnoseTarget(directoryAfterRedirect) ?? directoryAfterRedirect;
+	const resolvedDirectory = resolveDiagnoseTarget(directoryAfterRedirect, options) ?? directoryAfterRedirect;
 	if (!isDirectory(resolvedDirectory)) throw existsSync(resolvedDirectory) ? new NotADirectoryError(resolvedDirectory) : new ProjectNotFoundError(resolvedDirectory);
 	return {
 		resolvedDirectory,
@@ -4572,99 +4717,6 @@ const checkReducedMotion = (rootDirectory) => {
 	return [MISSING_REDUCED_MOTION_DIAGNOSTIC];
 };
 const computeJsxIncludePaths = (includePaths) => includePaths.length > 0 ? includePaths.filter((filePath) => JSX_FILE_PATTERN.test(filePath)) : void 0;
-const toStringSet = (values) => {
-	if (!values || values.length === 0) return /* @__PURE__ */ new Set();
-	return new Set(values.filter((value) => typeof value === "string" && value.length > 0));
-};
-const buildResolvedControls = (surface, userControls) => {
-	const excludeTags = new Set(DEFAULT_SURFACE_EXCLUDED_TAGS[surface]);
-	const includeTags = toStringSet(userControls?.includeTags);
-	for (const tag of includeTags) excludeTags.delete(tag);
-	for (const tag of toStringSet(userControls?.excludeTags)) excludeTags.add(tag);
-	return {
-		includeTags,
-		excludeTags,
-		includeCategories: toStringSet(userControls?.includeCategories),
-		excludeCategories: toStringSet(userControls?.excludeCategories),
-		includeRuleKeys: toStringSet(userControls?.includeRules),
-		excludeRuleKeys: toStringSet(userControls?.excludeRules)
-	};
-};
-const intersects = (values, candidates) => values.some((value) => candidates.has(value));
-const isDiagnosticOnSurface = (diagnostic, surface, config) => {
-	const resolved = buildResolvedControls(surface, config?.surfaces?.[surface]);
-	const { ruleKey, category, tags } = getDiagnosticRuleIdentity(diagnostic);
-	if (resolved.includeRuleKeys.has(ruleKey)) return true;
-	if (resolved.includeCategories.has(category)) return true;
-	if (intersects(tags, resolved.includeTags)) return true;
-	if (resolved.excludeRuleKeys.has(ruleKey)) return false;
-	if (resolved.excludeCategories.has(category)) return false;
-	if (intersects(tags, resolved.excludeTags)) return false;
-	return true;
-};
-const filterDiagnosticsForSurface = (diagnostics, surface, config) => diagnostics.filter((diagnostic) => isDiagnosticOnSurface(diagnostic, surface, config));
-const listSourceFilesViaGit = (rootDirectory) => {
-	const result = spawnSync("git", [
-		"ls-files",
-		"-z",
-		"--cached",
-		"--others",
-		"--exclude-standard"
-	], {
-		cwd: rootDirectory,
-		encoding: "utf-8",
-		maxBuffer: GIT_LS_FILES_MAX_BUFFER_BYTES
-	});
-	if (result.error || result.status !== 0) return null;
-	return result.stdout.split("\0").filter((filePath) => filePath.length > 0 && SOURCE_FILE_PATTERN.test(filePath));
-};
-const listSourceFilesViaFilesystem = (rootDirectory) => {
-	const filePaths = [];
-	const stack = [rootDirectory];
-	while (stack.length > 0) {
-		const currentDirectory = stack.pop();
-		const entries = readDirectoryEntries(currentDirectory);
-		for (const entry of entries) {
-			const absolutePath = path.join(currentDirectory, entry.name);
-			if (entry.isDirectory()) {
-				if (!entry.name.startsWith(".") && !IGNORED_DIRECTORIES.has(entry.name)) stack.push(absolutePath);
-				continue;
-			}
-			if (entry.isFile() && SOURCE_FILE_PATTERN.test(entry.name)) filePaths.push(path.relative(rootDirectory, absolutePath).replace(/\\/g, "/"));
-		}
-	}
-	return filePaths;
-};
-const listSourceFiles = (rootDirectory) => listSourceFilesViaGit(rootDirectory) ?? listSourceFilesViaFilesystem(rootDirectory);
-const resolveLintIncludePaths = (rootDirectory, userConfig) => {
-	if (!Array.isArray(userConfig?.ignore?.files) || userConfig.ignore.files.length === 0) return;
-	const ignoredPatterns = compileIgnoredFilePatterns(userConfig);
-	return listSourceFiles(rootDirectory).filter((filePath) => {
-		if (!JSX_FILE_PATTERN.test(filePath)) return false;
-		return !isFileIgnoredByPatterns(filePath, rootDirectory, ignoredPatterns);
-	});
-};
-var Config = class Config extends Context.Service()("react-doctor/Config") {
-	static layerNode = Layer.effect(Config, Effect.gen(function* () {
-		const cache = yield* Cache.make({
-			capacity: 16,
-			timeToLive: CONFIG_CACHE_TTL_MS,
-			lookup: (directory) => Effect.sync(() => {
-				const loaded = loadConfigWithSource(directory);
-				const redirected = resolveConfigRootDir(loaded?.config ?? null, loaded?.sourceDirectory ?? null);
-				return {
-					config: loaded?.config ?? null,
-					resolvedDirectory: redirected ?? directory,
-					configSourceDirectory: loaded?.sourceDirectory ?? null
-				};
-			})
-		});
-		return Config.of({ resolve: Effect.fn("Config.resolve")(function* (directory) {
-			return yield* Cache.get(cache, directory);
-		}) });
-	}));
-	static layerOf = (resolved) => Layer.succeed(Config, Config.of({ resolve: () => Effect.succeed(resolved) }));
-};
 const LINGUIST_ATTRIBUTE_PATTERN = /^linguist-(?:vendored|generated)(?:=([a-zA-Z0-9]+))?$/i;
 const FALSY_VALUES = new Set([
 	"false",
@@ -4746,6 +4798,30 @@ const collectIgnorePatterns = (rootDirectory) => {
 	cachedPatternsByRoot.set(rootDirectory, patterns);
 	return patterns;
 };
+/**
+* Resolves a path to its canonical, symlink-free form, falling back to
+* the input when it cannot be realpath'd (broken symlink, permission
+* error) so a best-effort normalization never throws.
+*
+* deslop's dead-code module graph is collected with `fast-glob` (which
+* keeps the scan root's symlinks intact) while imports are resolved
+* through `oxc-resolver` (which returns realpath'd targets). When the
+* project root sits behind a symlink — e.g. macOS iCloud-synced
+* `~/Documents` / `~/Desktop`, or a symlinked checkout — those two path
+* spaces diverge: every resolved import misses the graph and the files
+* they point at (commonly every `@/…` alias target) are mis-reported as
+* unreachable. Canonicalizing the root before the scan keeps both path
+* spaces in agreement.
+*/
+const toCanonicalPath = (filePath) => {
+	try {
+		return fs.realpathSync(filePath);
+	} catch {
+		return filePath;
+	}
+};
+const DEAD_CODE_PLUGIN = "deslop";
+const DEAD_CODE_CATEGORY = "Maintainability";
 const TSCONFIG_FILENAMES$1 = ["tsconfig.json", "tsconfig.base.json"];
 const DEAD_CODE_WORKER_SCRIPT = `
 const inputChunks = [];
@@ -4921,7 +4997,11 @@ const buildDeadCodeWorkerError = (workerError) => {
 	return error;
 };
 const createDeadCodeWorker = (input) => {
-	const child = spawn(process.execPath, ["-e", DEAD_CODE_WORKER_SCRIPT], {
+	const child = spawn(process.execPath, [
+		`--max-old-space-size=${DEAD_CODE_WORKER_MAX_OLD_SPACE_MB}`,
+		"-e",
+		DEAD_CODE_WORKER_SCRIPT
+	], {
 		stdio: [
 			"pipe",
 			"pipe",
@@ -4996,7 +5076,8 @@ const runDeadCodeWorkerWithTimeout = (handle, timeoutMs) => new Promise((resolve
 	});
 });
 const checkDeadCode = async (options) => {
-	const { rootDirectory, userConfig } = options;
+	const { userConfig } = options;
+	const rootDirectory = toCanonicalPath(options.rootDirectory);
 	if (!fs.existsSync(path.join(rootDirectory, "package.json"))) return [];
 	const ignorePatterns = collectDeadCodeIgnorePatterns(rootDirectory, userConfig);
 	const result = parseDeadCodeWorkerResult(await runDeadCodeWorkerWithTimeout((options.createWorker ?? createDeadCodeWorker)({
@@ -5009,59 +5090,162 @@ const checkDeadCode = async (options) => {
 	const diagnostics = [];
 	for (const unusedFile of result.unusedFiles) diagnostics.push({
 		filePath: toRelative(unusedFile.path),
-		plugin: "deslop",
+		plugin: DEAD_CODE_PLUGIN,
 		rule: "unused-file",
 		severity: "warning",
 		message: "Unused file — not reachable from any entry point",
 		help: "Delete the file if it is truly unreachable, or import it from an entry point.",
 		line: 0,
 		column: 0,
-		category: "Dead Code"
+		category: DEAD_CODE_CATEGORY
 	});
 	for (const unusedExport of result.unusedExports) {
 		const label = unusedExport.isTypeOnly ? "type export" : "export";
 		diagnostics.push({
 			filePath: toRelative(unusedExport.path),
-			plugin: "deslop",
+			plugin: DEAD_CODE_PLUGIN,
 			rule: unusedExport.isTypeOnly ? "unused-type" : "unused-export",
 			severity: "warning",
 			message: `Unused ${label}: \`${unusedExport.name}\``,
 			help: "Drop the `export` keyword (or remove the declaration) if no other module uses this symbol.",
 			line: unusedExport.line,
 			column: unusedExport.column,
-			category: "Dead Code"
+			category: DEAD_CODE_CATEGORY
 		});
 	}
 	for (const unusedDependency of result.unusedDependencies) {
 		const label = unusedDependency.isDevDependency ? "devDependency" : "dependency";
 		diagnostics.push({
 			filePath: "package.json",
-			plugin: "deslop",
+			plugin: DEAD_CODE_PLUGIN,
 			rule: unusedDependency.isDevDependency ? "unused-dev-dependency" : "unused-dependency",
 			severity: "warning",
 			message: `Unused ${label}: \`${unusedDependency.name}\``,
 			help: "Remove the dependency from package.json if it is genuinely unused.",
 			line: 0,
 			column: 0,
-			category: "Dead Code"
+			category: DEAD_CODE_CATEGORY
 		});
 	}
 	for (const cycle of result.circularDependencies) {
 		if (cycle.files.length === 0) continue;
 		diagnostics.push({
 			filePath: toRelative(cycle.files[0]),
-			plugin: "deslop",
+			plugin: DEAD_CODE_PLUGIN,
 			rule: "circular-dependency",
 			severity: "warning",
 			message: `Circular import cycle: ${cycle.files.map(toRelative).join(" → ")}`,
 			help: "Break the cycle by extracting the shared code into a third module that both files import.",
 			line: 0,
 			column: 0,
-			category: "Dead Code"
+			category: DEAD_CODE_CATEGORY
 		});
 	}
 	return diagnostics;
 };
+const DEAD_CODE_RULE_KEY_PREFIX = `${DEAD_CODE_PLUGIN}/`;
+const isSurfacingOverride = (override) => override === "warn" || override === "error";
+const deadCodeMaySurfaceWhenWarningsHidden = (userConfig) => {
+	const severityControls = buildRuleSeverityControls(userConfig);
+	if (!severityControls) return false;
+	if (isSurfacingOverride(severityControls.categories?.["Maintainability"])) return true;
+	for (const [ruleKey, override] of Object.entries(severityControls.rules ?? {})) if (ruleKey.startsWith(DEAD_CODE_RULE_KEY_PREFIX) && isSurfacingOverride(override)) return true;
+	return false;
+};
+const toStringSet = (values) => {
+	if (!values || values.length === 0) return /* @__PURE__ */ new Set();
+	return new Set(values.filter((value) => typeof value === "string" && value.length > 0));
+};
+const buildResolvedControls = (surface, userControls) => {
+	const excludeTags = new Set(DEFAULT_SURFACE_EXCLUDED_TAGS[surface]);
+	const includeTags = toStringSet(userControls?.includeTags);
+	for (const tag of includeTags) excludeTags.delete(tag);
+	for (const tag of toStringSet(userControls?.excludeTags)) excludeTags.add(tag);
+	return {
+		includeTags,
+		excludeTags,
+		includeCategories: toStringSet(userControls?.includeCategories),
+		excludeCategories: toStringSet(userControls?.excludeCategories),
+		includeRuleKeys: toStringSet(userControls?.includeRules),
+		excludeRuleKeys: toStringSet(userControls?.excludeRules)
+	};
+};
+const intersects = (values, candidates) => values.some((value) => candidates.has(value));
+const isDiagnosticOnSurface = (diagnostic, surface, config) => {
+	const resolved = buildResolvedControls(surface, config?.surfaces?.[surface]);
+	const { ruleKey, category, tags } = getDiagnosticRuleIdentity(diagnostic);
+	if (resolved.includeRuleKeys.has(ruleKey)) return true;
+	if (resolved.includeCategories.has(category)) return true;
+	if (intersects(tags, resolved.includeTags)) return true;
+	if (resolved.excludeRuleKeys.has(ruleKey)) return false;
+	if (resolved.excludeCategories.has(category)) return false;
+	if (intersects(tags, resolved.excludeTags)) return false;
+	return true;
+};
+const filterDiagnosticsForSurface = (diagnostics, surface, config) => diagnostics.filter((diagnostic) => isDiagnosticOnSurface(diagnostic, surface, config));
+const excludeMinifiedFiles = (rootDirectory, relativePaths) => relativePaths.filter((relativePath) => !isLargeMinifiedFile(path.resolve(rootDirectory, relativePath)));
+const listSourceFilesViaGit = (rootDirectory) => {
+	const result = spawnSync("git", [
+		"ls-files",
+		"-z",
+		"--cached",
+		"--others",
+		"--exclude-standard"
+	], {
+		cwd: rootDirectory,
+		encoding: "utf-8",
+		maxBuffer: GIT_LS_FILES_MAX_BUFFER_BYTES
+	});
+	if (result.error || result.status !== 0) return null;
+	return result.stdout.split("\0").filter((filePath) => filePath.length > 0 && isLintableSourceFile(filePath));
+};
+const listSourceFilesViaFilesystem = (rootDirectory) => {
+	const filePaths = [];
+	const stack = [rootDirectory];
+	while (stack.length > 0) {
+		const currentDirectory = stack.pop();
+		const entries = readDirectoryEntries(currentDirectory);
+		for (const entry of entries) {
+			const absolutePath = path.join(currentDirectory, entry.name);
+			if (entry.isDirectory()) {
+				if (!entry.name.startsWith(".") && !IGNORED_DIRECTORIES.has(entry.name)) stack.push(absolutePath);
+				continue;
+			}
+			if (entry.isFile() && isLintableSourceFile(entry.name)) filePaths.push(path.relative(rootDirectory, absolutePath).replace(/\\/g, "/"));
+		}
+	}
+	return filePaths;
+};
+const listSourceFiles = (rootDirectory) => excludeMinifiedFiles(rootDirectory, listSourceFilesViaGit(rootDirectory) ?? listSourceFilesViaFilesystem(rootDirectory));
+const resolveLintIncludePaths = (rootDirectory, userConfig) => {
+	if (!Array.isArray(userConfig?.ignore?.files) || userConfig.ignore.files.length === 0) return;
+	const ignoredPatterns = compileIgnoredFilePatterns(userConfig);
+	return listSourceFiles(rootDirectory).filter((filePath) => {
+		if (!JSX_FILE_PATTERN.test(filePath)) return false;
+		return !isFileIgnoredByPatterns(filePath, rootDirectory, ignoredPatterns);
+	});
+};
+var Config = class Config extends Context.Service()("react-doctor/Config") {
+	static layerNode = Layer.effect(Config, Effect.gen(function* () {
+		const cache = yield* Cache.make({
+			capacity: 16,
+			timeToLive: CONFIG_CACHE_TTL_MS,
+			lookup: (directory) => Effect.sync(() => {
+				const loaded = loadConfigWithSource(directory);
+				const redirected = resolveConfigRootDir(loaded?.config ?? null, loaded?.sourceDirectory ?? null);
+				return {
+					config: loaded?.config ?? null,
+					resolvedDirectory: redirected ?? directory,
+					configSourceDirectory: loaded?.sourceDirectory ?? null
+				};
+			})
+		});
+		return Config.of({ resolve: Effect.fn("Config.resolve")(function* (directory) {
+			return yield* Cache.get(cache, directory);
+		}) });
+	}));
+	static layerOf = (resolved) => Layer.succeed(Config, Config.of({ resolve: () => Effect.succeed(resolved) }));
+};
 /**
 * `DeadCode` runs whole-project reachability analysis and streams
 * diagnostics. Reachability is a whole-project property — the
@@ -5567,12 +5751,12 @@ const findFilesWithDisableDirectivesViaGit = async (rootDirectory, includePaths)
 		return null;
 	}
 	if (grepResult === null) return null;
-	return grepResult.stdout.split("\n").filter((filePath) => filePath.length > 0 && SOURCE_FILE_PATTERN.test(filePath));
+	return grepResult.stdout.split("\n").filter((filePath) => filePath.length > 0 && isLintableSourceFile(filePath));
 };
 const findFilesWithDisableDirectivesViaFilesystem = (rootDirectory, includePaths) => {
 	const matches = [];
 	const checkFile = (relativePath) => {
-		if (!SOURCE_FILE_PATTERN.test(relativePath)) return;
+		if (!isLintableSourceFile(relativePath)) return;
 		const absolutePath = path.join(rootDirectory, relativePath);
 		let content;
 		try {
@@ -5815,10 +5999,14 @@ const resolveSettingsRootDirectory = (rootDirectory) => {
 	if (!fs.existsSync(rootDirectory)) return rootDirectory;
 	return fs.realpathSync(rootDirectory);
 };
+const resolveCompilerCleanupBucketSeverity = (ruleKey, severityControls) => {
+	if (!COMPILER_CLEANUP_RULE_KEYS.has(ruleKey)) return void 0;
+	return severityControls?.buckets?.[COMPILER_CLEANUP_BUCKET];
+};
 const applyRuleSeverityControls = (rules, severityControls) => {
 	const enabledRules = {};
 	for (const [ruleKey, defaultSeverity] of Object.entries(rules)) {
-		const severity = resolveRuleSeverityOverride({ ruleKey }, severityControls) ?? defaultSeverity;
+		const severity = resolveRuleSeverityOverride({ ruleKey }, severityControls) ?? resolveCompilerCleanupBucketSeverity(ruleKey, severityControls) ?? defaultSeverity;
 		if (severity === "off") continue;
 		enabledRules[ruleKey] = severity;
 	}
@@ -5860,7 +6048,7 @@ const createOxlintConfig = ({ pluginPath, project, customRulesOnly = false, exte
 			category: rule.category
 		}, severityControls);
 		if (rule.defaultEnabled === false && explicitSeverity === void 0) continue;
-		const severity = explicitSeverity ?? rule.severity;
+		const severity = explicitSeverity ?? resolveCompilerCleanupBucketSeverity(registryEntry.key, severityControls) ?? rule.severity;
 		if (severity === "off") continue;
 		enabledReactDoctorRules[registryEntry.key] = severity;
 	}
@@ -6032,7 +6220,7 @@ const KNOWN_SECRET_RULES = [
 	}
 ];
 const CANDIDATE_TOKEN_PATTERN = /[A-Za-z0-9_][A-Za-z0-9_-]*/g;
-const GIT_OBJECT_ID_PATTERN = /^(?:[0-9a-f]{40}|[0-9a-f]{64})$/;
+const HEX_DIGEST_PATTERN = /^(?:[0-9a-f]{32}|[0-9a-f]{40}|[0-9a-f]{64})$/;
 const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 const HAS_LETTER_PATTERN = /[A-Za-z]/;
 const HAS_DIGIT_PATTERN = /[0-9]/;
@@ -6049,7 +6237,7 @@ const shannonEntropyBits = (value) => {
 const looksLikeHighEntropySecret = (token) => {
 	if (token.length < 32) return false;
 	if (!HAS_LETTER_PATTERN.test(token) || !HAS_DIGIT_PATTERN.test(token)) return false;
-	if (GIT_OBJECT_ID_PATTERN.test(token) || UUID_PATTERN.test(token)) return false;
+	if (HEX_DIGEST_PATTERN.test(token) || UUID_PATTERN.test(token)) return false;
 	return shannonEntropyBits(token) >= 3;
 };
 const redactHighEntropyTokens = (text) => text.replace(CANDIDATE_TOKEN_PATTERN, (token) => looksLikeHighEntropySecret(token) ? REDACTED_PLACEHOLDER : token);
@@ -6376,25 +6564,26 @@ const shouldSuppressLocalUseHookDiagnostic = (diagnostic, rootDirectory) => {
 	return bindingResolution !== null && !bindingResolution.isReactUseBinding;
 };
 const FILEPATH_WITH_LOCATION_PATTERN = /\S+\.\w+:\d+:\d+[\s\S]*$/;
-const REACT_COMPILER_MESSAGE = "React Compiler can't optimize this code";
+const REACT_COMPILER_TITLE = "React Compiler can't optimize this";
+const REACT_COMPILER_MESSAGE = "This component misses React Compiler's automatic memoization & re-renders more than it should. Rewrite the flagged code so the compiler can optimize it.";
 const PLUGIN_CATEGORY_MAP = {
-	react: "Correctness",
-	"react-hooks": "Correctness",
-	"react-hooks-js": "React Compiler",
-	"react-doctor": "Other",
+	react: "Bugs",
+	"react-hooks": "Bugs",
+	"react-hooks-js": "Performance",
+	"react-doctor": "Bugs",
 	"jsx-a11y": "Accessibility",
-	effect: "State & Effects",
-	eslint: "Correctness",
-	oxc: "Correctness",
-	typescript: "Correctness",
-	unicorn: "Correctness",
-	import: "Bundle Size",
-	promise: "Correctness",
-	n: "Correctness",
-	node: "Correctness",
-	vitest: "Correctness",
-	jest: "Correctness",
-	nextjs: "Next.js"
+	effect: "Bugs",
+	eslint: "Bugs",
+	oxc: "Bugs",
+	typescript: "Bugs",
+	unicorn: "Bugs",
+	import: "Performance",
+	promise: "Bugs",
+	n: "Bugs",
+	node: "Bugs",
+	vitest: "Bugs",
+	jest: "Bugs",
+	nextjs: "Bugs"
 };
 const lookupOwnString = (record, key) => Object.hasOwn(record, key) ? record[key] : void 0;
 const getRuleRecommendation = (ruleName, project) => {
@@ -6402,6 +6591,8 @@ const getRuleRecommendation = (ruleName, project) => {
 	return reactDoctorPlugin.rules[ruleName]?.recommendation;
 };
 const getRuleCategory = (ruleName) => reactDoctorPlugin.rules[ruleName]?.category;
+const getRuleTitle = (ruleName) => reactDoctorPlugin.rules[ruleName]?.title;
+const resolveDiagnosticTitle = (plugin, rule) => plugin === "react-hooks-js" ? REACT_COMPILER_TITLE : getRuleTitle(rule);
 const cleanDiagnosticMessage = (message, help, plugin, rule, project) => {
 	const cleaned = resolveCleanedDiagnostic(typeof message === "string" ? message : "", typeof help === "string" ? help : "", plugin, rule, project);
 	return {
@@ -6430,7 +6621,7 @@ const parseRuleCode = (code) => {
 		rule: match[2]
 	};
 };
-const resolveDiagnosticCategory = (plugin, rule) => getRuleCategory(rule) ?? lookupOwnString(PLUGIN_CATEGORY_MAP, plugin) ?? "Other";
+const resolveDiagnosticCategory = (plugin, rule) => getRuleCategory(rule) ?? lookupOwnString(PLUGIN_CATEGORY_MAP, plugin) ?? "Bugs";
 const isOxlintOutput = (value) => {
 	if (typeof value !== "object" || value === null) return false;
 	const candidate = value;
@@ -6454,7 +6645,16 @@ const parseOxlintOutput = (stdout, project, rootDirectory) => {
 		throw new ReactDoctorError({ reason: new OxlintOutputUnparseable({ preview: stdout.slice(0, 200) }) });
 	}
 	if (!isOxlintOutput(parsed)) throw new ReactDoctorError({ reason: new OxlintOutputUnparseable({ preview: stdout.slice(0, 200) }) });
-	return parsed.diagnostics.filter((diagnostic) => diagnostic.code && SOURCE_FILE_PATTERN.test(diagnostic.filename) && !shouldSuppressLocalUseHookDiagnostic(diagnostic, rootDirectory)).map((diagnostic) => {
+	const minifiedFileCache = /* @__PURE__ */ new Map();
+	const isMinifiedDiagnosticFile = (filename) => {
+		const absolutePath = path.isAbsolute(filename) ? filename : path.resolve(rootDirectory || ".", filename);
+		const cached = minifiedFileCache.get(absolutePath);
+		if (cached !== void 0) return cached;
+		const minified = isMinifiedSource(absolutePath);
+		minifiedFileCache.set(absolutePath, minified);
+		return minified;
+	};
+	return parsed.diagnostics.filter((diagnostic) => diagnostic.code && isLintableSourceFile(diagnostic.filename) && !isMinifiedDiagnosticFile(diagnostic.filename) && !shouldSuppressLocalUseHookDiagnostic(diagnostic, rootDirectory)).map((diagnostic) => {
 		const { plugin, rule } = parseRuleCode(diagnostic.code);
 		const primaryLabel = diagnostic.labels[0];
 		const cleaned = cleanDiagnosticMessage(diagnostic.message, diagnostic.help, plugin, rule, project);
@@ -6463,6 +6663,7 @@ const parseOxlintOutput = (stdout, project, rootDirectory) => {
 			plugin,
 			rule,
 			severity: diagnostic.severity,
+			title: resolveDiagnosticTitle(plugin, rule),
 			message: cleaned.message,
 			help: cleaned.help,
 			url: diagnostic.url,
@@ -6880,7 +7081,8 @@ var Progress = class Progress extends Context.Service()("react-doctor/Progress")
 	static layerNoop = Layer.succeed(Progress, Progress.of({ start: () => Effect.succeed({
 		update: () => Effect.void,
 		succeed: () => Effect.void,
-		fail: () => Effect.void
+		fail: () => Effect.void,
+		stop: () => Effect.void
 	}) }));
 	static layerCapture = Layer.effect(Progress, Effect.map(ProgressCapture, (events) => Progress.of({ start: (text) => Effect.gen(function* () {
 		yield* Ref.update(events, (existing) => [...existing, {
@@ -6899,6 +7101,10 @@ var Progress = class Progress extends Context.Service()("react-doctor/Progress")
 			fail: (displayText) => Ref.update(events, (existing) => [...existing, {
 				_tag: "Failed",
 				text: displayText
+			}]),
+			stop: () => Ref.update(events, (existing) => [...existing, {
+				_tag: "Stopped",
+				text
 			}])
 		};
 	}) }))).pipe(Layer.provideMerge(ProgressCapture.layer));
@@ -7148,15 +7354,18 @@ const runInspect = (input, hooks = {}) => Effect.gen(function* () {
 		repo
 	}).pipe(Effect.orElseSucceed(() => null)) : Effect.succeed(null));
 	const lintIncludePaths = computeJsxIncludePaths([...input.includePaths]) ?? resolveLintIncludePaths(scanDirectory, resolvedConfig.config);
+	const scannedFilePaths = input.suppressScanSummary ? (lintIncludePaths ?? (yield* filesService.listSourceFiles(scanDirectory))).map((relativePath) => path.resolve(scanDirectory, relativePath)) : [];
 	const beforeLint = hooks.beforeLint ?? NO_HOOKS.beforeLint;
 	const afterLint = hooks.afterLint ?? NO_HOOKS.afterLint;
 	yield* beforeLint(project, lintIncludePaths ?? void 0);
 	const isDiffMode = input.includePaths.length > 0;
+	const showWarnings = input.warnings ?? resolvedConfig.config?.warnings ?? false;
 	const transform = buildDiagnosticPipeline({
 		rootDirectory: scanDirectory,
 		userConfig: resolvedConfig.config,
 		readFileLinesSync: fileReader(filesService, scanDirectory),
-		respectInlineDisables: input.respectInlineDisables
+		respectInlineDisables: input.respectInlineDisables,
+		showWarnings
 	});
 	const applyPerElementPipeline = (rawStream) => rawStream.pipe(Stream.filterMap(filterMapNullable(transform.apply)), Stream.tap((diagnostic) => reporterService.emit(diagnostic)));
 	const environmentDiagnostics = isDiffMode ? [] : [...checkReducedMotion(scanDirectory), ...checkPnpmHardening(scanDirectory)];
@@ -7202,7 +7411,7 @@ const runInspect = (input, hooks = {}) => Effect.gen(function* () {
 	const lintFailureState = yield* Ref.get(lintFailure);
 	yield* afterLint(lintFailureState.didFail);
 	if (lintFailureState.didFail) yield* scanProgress.fail(formatLintFailText(lintFailureState.reasonTag, process.version));
-	const shouldRunDeadCode = input.runDeadCode && !isDiffMode;
+	const shouldRunDeadCode = input.runDeadCode && !isDiffMode && (showWarnings || deadCodeMaySurfaceWhenWarningsHidden(resolvedConfig.config));
 	const deadCodeCollected = lintFailureState.didFail || !shouldRunDeadCode ? [] : yield* scanProgress.update("Analyzing dead code...").pipe(Effect.andThen(Stream.runCollect(applyPerElementPipeline(deadCodeService.run({
 		rootDirectory: scanDirectory,
 		userConfig: resolvedConfig.config
@@ -7214,9 +7423,11 @@ const runInspect = (input, hooks = {}) => Effect.gen(function* () {
 		return Stream.empty;
 	}))))))));
 	const deadCodeFailureState = yield* Ref.get(deadCodeFailure);
-	const scanElapsedSeconds = ((Date.now() - scanStartTime) / 1e3).toFixed(1);
+	const scanElapsedMilliseconds = Date.now() - scanStartTime;
+	const scanElapsedSeconds = (scanElapsedMilliseconds / 1e3).toFixed(1);
 	const totalFileCount = lastReportedTotalFileCount || (lintIncludePaths?.length ?? project.sourceFileCount);
 	if (!lintFailureState.didFail) if (deadCodeFailureState.didFail) yield* scanProgress.fail(DEAD_CODE_FAIL_TEXT);
+	else if (input.suppressScanSummary) yield* scanProgress.stop();
 	else yield* scanProgress.succeed(`Scanned ${totalFileCount} ${totalFileCount === 1 ? "file" : "files"} in ${scanElapsedSeconds}s`);
 	yield* reporterService.finalize;
 	const finalDiagnostics = [
@@ -7257,7 +7468,10 @@ const runInspect = (input, hooks = {}) => Effect.gen(function* () {
 		lintFailureReasonKind: lintFailureState.reasonKind,
 		lintPartialFailures,
 		didDeadCodeFail: deadCodeFailureState.didFail,
-		deadCodeFailureReason: deadCodeFailureState.reason
+		deadCodeFailureReason: deadCodeFailureState.reason,
+		scannedFileCount: totalFileCount,
+		scannedFilePaths,
+		scanElapsedMilliseconds
 	};
 }).pipe(Effect.withSpan("runInspect", { attributes: {
 	"inspect.directory": input.directory,
@@ -7383,7 +7597,7 @@ const isPathInsideDirectory = (childAbsolutePath, parentAbsolutePath) => {
 	static layerNode = Layer.effect(StagedFiles, Effect.gen(function* () {
 		const git = yield* Git;
 		return StagedFiles.of({
-			discoverSourceFiles: (directory) => git.stagedFilePaths(directory).pipe(Effect.map((entries) => entries.filter((entry) => SOURCE_FILE_PATTERN.test(entry)))),
+			discoverSourceFiles: (directory) => git.stagedFilePaths(directory).pipe(Effect.map((entries) => entries.filter(isLintableSourceFile))),
 			materialize: ({ directory, stagedFiles, tempDirectory }) => Effect.gen(function* () {
 				const materializedFiles = [];
 				const resolvedTempDirectory = path.resolve(tempDirectory);
@@ -7592,7 +7806,7 @@ const getDiffInfo = (directory, explicitBaseBranch) => Effect.runPromise(Effect.
 	GitBaseBranchInvalid: (reason) => Effect.die(new Error(reason.detail)),
 	GitBaseBranchMissing: (reason) => Effect.die(new Error(reason.message))
 })));
-const filterSourceFiles = (filePaths) => filePaths.filter((filePath) => SOURCE_FILE_PATTERN.test(filePath));
+const filterSourceFiles = (filePaths) => filePaths.filter(isLintableSourceFile);
 var import_picocolors = /* @__PURE__ */ __toESM((/* @__PURE__ */ __commonJSMin(((exports, module) => {
 	let p = process || {}, argv = p.argv || [], env = p.env || {};
 	let isColorSupported = !(!!env.NO_COLOR || argv.includes("--no-color")) && (!!env.FORCE_COLOR || argv.includes("--color") || p.platform === "win32" || (p.stdout || {}).isTTY && env.TERM !== "dumb" || !!env.CI);
@@ -7679,6 +7893,7 @@ const buildInspectProgram = (scanTarget, options, configOverride) => {
 		includePaths,
 		customRulesOnly: effectiveConfig?.customRulesOnly ?? false,
 		respectInlineDisables: options.respectInlineDisables ?? effectiveConfig?.respectInlineDisables ?? true,
+		warnings: options.warnings ?? effectiveConfig?.warnings ?? false,
 		adoptExistingLintConfig: effectiveConfig?.adoptExistingLintConfig ?? true,
 		ignoredTags: new Set(effectiveConfig?.ignore?.tags ?? []),
 		runDeadCode: options.deadCode ?? effectiveConfig?.deadCode ?? true,
@@ -7716,6 +7931,7 @@ const clearCaches = () => {
 	clearConfigCache();
 	clearPackageJsonCache();
 	clearIgnorePatternsCache();
+	clearPackageRoleCache();
 	clearAutoSuppressionCaches();
 };
 const toJsonReport = (result, options) => buildJsonReport({