react-doctor 0.0.31 → 0.0.33

package/dist/cli.js

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 import { createRequire } from "node:module";
-import { execSync, spawn, spawnSync } from "node:child_process";
-import fs, { appendFileSync, existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
-import os, { homedir, tmpdir } from "node:os";
+import fs, { existsSync, mkdirSync, mkdtempSync, readdirSync, writeFileSync } from "node:fs";
+import os, { tmpdir } from "node:os";
 import path, { join } from "node:path";
 import { Command } from "commander";
 import { randomUUID } from "node:crypto";
 import { performance } from "node:perf_hooks";
+import { execSync, spawn, spawnSync } from "node:child_process";
 import pc from "picocolors";
 import basePrompts from "prompts";
 import { main } from "knip";
@@ -26,30 +26,25 @@ const SCORE_BAR_WIDTH_CHARS = 50;
 const SUMMARY_BOX_HORIZONTAL_PADDING_CHARS = 1;
 const SUMMARY_BOX_OUTER_INDENT_CHARS = 2;
 const SCORE_API_URL = "https://www.react.doctor/api/score";
-const ESTIMATE_SCORE_API_URL = "https://www.react.doctor/api/estimate-score";
 const SHARE_BASE_URL = "https://www.react.doctor/share";
-const OPEN_BASE_URL = "https://www.react.doctor/open";
 const FETCH_TIMEOUT_MS = 1e4;
 const GIT_LS_FILES_MAX_BUFFER_BYTES = 50 * 1024 * 1024;
 const SPAWN_ARGS_MAX_LENGTH_CHARS = 24e3;
+const OXLINT_MAX_FILES_PER_BATCH = 500;
 const OFFLINE_MESSAGE = "Score calculated locally (offline mode).";
 const DEFAULT_BRANCH_CANDIDATES = ["main", "master"];
 const ERROR_RULE_PENALTY = 1.5;
 const WARNING_RULE_PENALTY = .75;
-const ERROR_ESTIMATED_FIX_RATE = .85;
-const WARNING_ESTIMATED_FIX_RATE = .8;
 const MAX_KNIP_RETRIES = 5;
 const OXLINT_NODE_REQUIREMENT = "^20.19.0 || >=22.12.0";
 const OXLINT_RECOMMENDED_NODE_MAJOR = 24;
+const GIT_SHOW_MAX_BUFFER_BYTES = 10 * 1024 * 1024;
 const IGNORED_DIRECTORIES = new Set([
 	"node_modules",
 	"dist",
 	"build",
 	"coverage"
 ]);
-const AMI_WEBSITE_URL = "https://ami.dev";
-const AMI_INSTALL_URL = `${AMI_WEBSITE_URL}/install.sh`;
-const AMI_RELEASES_URL = "https://github.com/millionco/ami-releases/releases";
 
 //#endregion
 //#region src/utils/proxy-fetch.ts
@@ -123,22 +118,12 @@ const scoreFromRuleCounts = (errorRuleCount, warningRuleCount) => {
 	const penalty = errorRuleCount * ERROR_RULE_PENALTY + warningRuleCount * WARNING_RULE_PENALTY;
 	return Math.max(0, Math.round(PERFECT_SCORE - penalty));
 };
-const estimateScoreLocally = (diagnostics) => {
-	const { errorRuleCount, warningRuleCount } = countUniqueRules(diagnostics);
-	const currentScore = scoreFromRuleCounts(errorRuleCount, warningRuleCount);
-	const estimatedScore = scoreFromRuleCounts(Math.round(errorRuleCount * (1 - ERROR_ESTIMATED_FIX_RATE)), Math.round(warningRuleCount * (1 - WARNING_ESTIMATED_FIX_RATE)));
-	return {
-		currentScore,
-		currentLabel: getScoreLabel(currentScore),
-		estimatedScore,
-		estimatedLabel: getScoreLabel(estimatedScore)
-	};
-};
 const calculateScoreLocally = (diagnostics) => {
-	const { currentScore, currentLabel } = estimateScoreLocally(diagnostics);
+	const { errorRuleCount, warningRuleCount } = countUniqueRules(diagnostics);
+	const score = scoreFromRuleCounts(errorRuleCount, warningRuleCount);
 	return {
-		score: currentScore,
-		label: currentLabel
+		score,
+		label: getScoreLabel(score)
 	};
 };
 const calculateScore = async (diagnostics) => {
@@ -154,19 +139,6 @@ const calculateScore = async (diagnostics) => {
 		return calculateScoreLocally(diagnostics);
 	}
 };
-const fetchEstimatedScore = async (diagnostics) => {
-	try {
-		const response = await proxyFetch(ESTIMATE_SCORE_API_URL, {
-			method: "POST",
-			headers: { "Content-Type": "application/json" },
-			body: JSON.stringify({ diagnostics })
-		});
-		if (!response.ok) return estimateScoreLocally(diagnostics);
-		return await response.json();
-	} catch {
-		return estimateScoreLocally(diagnostics);
-	}
-};
 
 //#endregion
 //#region src/utils/highlighter.ts
@@ -206,6 +178,7 @@ const readPackageJson = (packageJsonPath) => {
 	try {
 		return JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
 	} catch (error) {
+		if (error instanceof SyntaxError) return {};
 		if (error instanceof Error && "code" in error) {
 			const { code } = error;
 			if (code === "EISDIR" || code === "EACCES") return {};
@@ -301,38 +274,58 @@ const isFileIgnoredByPatterns = (filePath, rootDirectory, patterns) => {
 
 //#endregion
 //#region src/utils/filter-diagnostics.ts
-const filterIgnoredDiagnostics = (diagnostics, config, rootDirectory) => {
-	const ignoredRules = new Set(Array.isArray(config.ignore?.rules) ? config.ignore.rules : []);
-	const ignoredFilePatterns = compileIgnoredFilePatterns(config);
-	if (ignoredRules.size === 0 && ignoredFilePatterns.length === 0) return diagnostics;
-	return diagnostics.filter((diagnostic) => {
-		const ruleIdentifier = `${diagnostic.plugin}/${diagnostic.rule}`;
-		if (ignoredRules.has(ruleIdentifier)) return false;
-		if (isFileIgnoredByPatterns(diagnostic.filePath, rootDirectory, ignoredFilePatterns)) return false;
-		return true;
-	});
-};
+const OPENING_TAG_PATTERN = /<([A-Z][\w.]*)/;
 const DISABLE_NEXT_LINE_PATTERN = /\/\/\s*react-doctor-disable-next-line\b(?:\s+(.+))?/;
 const DISABLE_LINE_PATTERN = /\/\/\s*react-doctor-disable-line\b(?:\s+(.+))?/;
-const isRuleSuppressed = (commentRules, ruleId) => {
-	if (!commentRules?.trim()) return true;
-	return commentRules.split(/[,\s]+/).some((rule) => rule.trim() === ruleId);
-};
-const filterInlineSuppressions = (diagnostics, rootDirectory) => {
-	const fileLineCache = /* @__PURE__ */ new Map();
-	const getFileLines = (filePath) => {
-		const cached = fileLineCache.get(filePath);
+const createFileLinesCache = (rootDirectory) => {
+	const cache = /* @__PURE__ */ new Map();
+	return (filePath) => {
+		const cached = cache.get(filePath);
 		if (cached !== void 0) return cached;
 		const absolutePath = path.isAbsolute(filePath) ? filePath : path.join(rootDirectory, filePath);
 		try {
 			const lines = fs.readFileSync(absolutePath, "utf-8").split("\n");
-			fileLineCache.set(filePath, lines);
+			cache.set(filePath, lines);
 			return lines;
 		} catch {
-			fileLineCache.set(filePath, null);
+			cache.set(filePath, null);
 			return null;
 		}
 	};
+};
+const isInsideTextComponent = (lines, diagnosticLine, textComponentNames) => {
+	for (let lineIndex = diagnosticLine - 1; lineIndex >= 0; lineIndex--) {
+		const match = lines[lineIndex].match(OPENING_TAG_PATTERN);
+		if (!match) continue;
+		const fullTagName = match[1];
+		const leafTagName = fullTagName.includes(".") ? fullTagName.split(".").at(-1) ?? fullTagName : fullTagName;
+		return textComponentNames.has(fullTagName) || textComponentNames.has(leafTagName);
+	}
+	return false;
+};
+const isRuleSuppressed = (commentRules, ruleId) => {
+	if (!commentRules?.trim()) return true;
+	return commentRules.split(/[,\s]+/).some((rule) => rule.trim() === ruleId);
+};
+const filterIgnoredDiagnostics = (diagnostics, config, rootDirectory) => {
+	const ignoredRules = new Set(Array.isArray(config.ignore?.rules) ? config.ignore.rules : []);
+	const ignoredFilePatterns = compileIgnoredFilePatterns(config);
+	const textComponentNames = new Set(Array.isArray(config.textComponents) ? config.textComponents : []);
+	const hasTextComponents = textComponentNames.size > 0;
+	const getFileLines = createFileLinesCache(rootDirectory);
+	return diagnostics.filter((diagnostic) => {
+		const ruleIdentifier = `${diagnostic.plugin}/${diagnostic.rule}`;
+		if (ignoredRules.has(ruleIdentifier)) return false;
+		if (isFileIgnoredByPatterns(diagnostic.filePath, rootDirectory, ignoredFilePatterns)) return false;
+		if (hasTextComponents && diagnostic.rule === "rn-no-raw-text" && diagnostic.line > 0) {
+			const lines = getFileLines(diagnostic.filePath);
+			if (lines && isInsideTextComponent(lines, diagnostic.line, textComponentNames)) return false;
+		}
+		return true;
+	});
+};
+const filterInlineSuppressions = (diagnostics, rootDirectory) => {
+	const getFileLines = createFileLinesCache(rootDirectory);
 	return diagnostics.filter((diagnostic) => {
 		if (diagnostic.line <= 0) return true;
 		const lines = getFileLines(diagnostic.filePath);
@@ -344,9 +337,9 @@ const filterInlineSuppressions = (diagnostics, rootDirectory) => {
 			if (lineMatch && isRuleSuppressed(lineMatch[1], ruleId)) return false;
 		}
 		if (diagnostic.line >= 2) {
-			const prevLine = lines[diagnostic.line - 2];
-			if (prevLine) {
-				const nextLineMatch = prevLine.match(DISABLE_NEXT_LINE_PATTERN);
+			const previousLine = lines[diagnostic.line - 2];
+			if (previousLine) {
+				const nextLineMatch = previousLine.match(DISABLE_NEXT_LINE_PATTERN);
 				if (nextLineMatch && isRuleSuppressed(nextLineMatch[1], ruleId)) return false;
 			}
 		}
@@ -881,8 +874,8 @@ const indentMultilineText = (text, linePrefix) => text.split("\n").map((lineText
 //#region src/utils/load-config.ts
 const CONFIG_FILENAME = "react-doctor.config.json";
 const PACKAGE_JSON_CONFIG_KEY = "reactDoctor";
-const loadConfig = (rootDirectory) => {
-	const configFilePath = path.join(rootDirectory, CONFIG_FILENAME);
+const loadConfigFromDirectory = (directory) => {
+	const configFilePath = path.join(directory, CONFIG_FILENAME);
 	if (isFile(configFilePath)) try {
 		const fileContent = fs.readFileSync(configFilePath, "utf-8");
 		const parsed = JSON.parse(fileContent);
@@ -891,7 +884,7 @@ const loadConfig = (rootDirectory) => {
 	} catch (error) {
 		console.warn(`Warning: Failed to parse ${CONFIG_FILENAME}: ${error instanceof Error ? error.message : String(error)}`);
 	}
-	const packageJsonPath = path.join(rootDirectory, "package.json");
+	const packageJsonPath = path.join(directory, "package.json");
 	if (isFile(packageJsonPath)) try {
 		const fileContent = fs.readFileSync(packageJsonPath, "utf-8");
 		const embeddedConfig = JSON.parse(fileContent)[PACKAGE_JSON_CONFIG_KEY];
@@ -901,6 +894,17 @@ const loadConfig = (rootDirectory) => {
 	}
 	return null;
 };
+const loadConfig = (rootDirectory) => {
+	const localConfig = loadConfigFromDirectory(rootDirectory);
+	if (localConfig) return localConfig;
+	let ancestorDirectory = path.dirname(rootDirectory);
+	while (ancestorDirectory !== path.dirname(ancestorDirectory)) {
+		const ancestorConfig = loadConfigFromDirectory(ancestorDirectory);
+		if (ancestorConfig) return ancestorConfig;
+		ancestorDirectory = path.dirname(ancestorDirectory);
+	}
+	return null;
+};
 
 //#endregion
 //#region src/utils/should-auto-select-current-choice.ts
@@ -925,12 +929,6 @@ let didPatchMultiselectToggleAll = false;
 let didPatchMultiselectSubmit = false;
 let didPatchSelectBanner = false;
 const selectBannerMap = /* @__PURE__ */ new Map();
-const setSelectBanner = (banner, targetIndex) => {
-	selectBannerMap.set(targetIndex, banner);
-};
-const clearSelectBanner = () => {
-	selectBannerMap.clear();
-};
 const onCancel = () => {
 	logger.break();
 	logger.log("Cancelled.");
@@ -1272,7 +1270,37 @@ const REACT_COMPILER_RULES = {
 	"react-hooks-js/incompatible-library": "error",
 	"react-hooks-js/todo": "error"
 };
-const createOxlintConfig = ({ pluginPath, framework, hasReactCompiler }) => ({
+const BUILTIN_REACT_RULES = {
+	"react/rules-of-hooks": "error",
+	"react/no-direct-mutation-state": "error",
+	"react/jsx-no-duplicate-props": "error",
+	"react/jsx-key": "error",
+	"react/no-children-prop": "warn",
+	"react/no-danger": "warn",
+	"react/jsx-no-script-url": "error",
+	"react/no-render-return-value": "warn",
+	"react/no-string-refs": "warn",
+	"react/no-is-mounted": "warn",
+	"react/require-render-return": "error",
+	"react/no-unknown-property": "warn"
+};
+const BUILTIN_A11Y_RULES = {
+	"jsx-a11y/alt-text": "error",
+	"jsx-a11y/anchor-is-valid": "warn",
+	"jsx-a11y/click-events-have-key-events": "warn",
+	"jsx-a11y/no-static-element-interactions": "warn",
+	"jsx-a11y/role-has-required-aria-props": "error",
+	"jsx-a11y/no-autofocus": "warn",
+	"jsx-a11y/heading-has-content": "warn",
+	"jsx-a11y/html-has-lang": "warn",
+	"jsx-a11y/no-redundant-roles": "warn",
+	"jsx-a11y/scope": "warn",
+	"jsx-a11y/tabindex-no-positive": "warn",
+	"jsx-a11y/label-has-associated-control": "warn",
+	"jsx-a11y/no-distracting-elements": "error",
+	"jsx-a11y/iframe-has-title": "warn"
+};
+const createOxlintConfig = ({ pluginPath, framework, hasReactCompiler, customRulesOnly = false }) => ({
 	categories: {
 		correctness: "off",
 		suspicious: "off",
@@ -1287,39 +1315,14 @@ const createOxlintConfig = ({ pluginPath, framework, hasReactCompiler }) => ({
 		"jsx-a11y",
 		...hasReactCompiler ? [] : ["react-perf"]
 	],
-	jsPlugins: [...hasReactCompiler ? [{
+	jsPlugins: [...hasReactCompiler && !customRulesOnly ? [{
 		name: "react-hooks-js",
 		specifier: esmRequire$1.resolve("eslint-plugin-react-hooks")
 	}] : [], pluginPath],
 	rules: {
-		"react/rules-of-hooks": "error",
-		"react/no-direct-mutation-state": "error",
-		"react/jsx-no-duplicate-props": "error",
-		"react/jsx-key": "error",
-		"react/no-children-prop": "warn",
-		"react/no-danger": "warn",
-		"react/jsx-no-script-url": "error",
-		"react/no-render-return-value": "warn",
-		"react/no-string-refs": "warn",
-		"react/no-is-mounted": "warn",
-		"react/require-render-return": "error",
-		"react/no-unknown-property": "warn",
-		"jsx-a11y/alt-text": "error",
-		"jsx-a11y/anchor-is-valid": "warn",
-		"jsx-a11y/click-events-have-key-events": "warn",
-		"jsx-a11y/no-static-element-interactions": "warn",
-		"jsx-a11y/no-noninteractive-element-interactions": "warn",
-		"jsx-a11y/role-has-required-aria-props": "error",
-		"jsx-a11y/no-autofocus": "warn",
-		"jsx-a11y/heading-has-content": "warn",
-		"jsx-a11y/html-has-lang": "warn",
-		"jsx-a11y/no-redundant-roles": "warn",
-		"jsx-a11y/scope": "warn",
-		"jsx-a11y/tabindex-no-positive": "warn",
-		"jsx-a11y/label-has-associated-control": "warn",
-		"jsx-a11y/no-distracting-elements": "error",
-		"jsx-a11y/iframe-has-title": "warn",
-		...hasReactCompiler ? REACT_COMPILER_RULES : {},
+		...customRulesOnly ? {} : BUILTIN_REACT_RULES,
+		...customRulesOnly ? {} : BUILTIN_A11Y_RULES,
+		...hasReactCompiler && !customRulesOnly ? REACT_COMPILER_RULES : {},
 		"react-doctor/no-derived-state-effect": "error",
 		"react-doctor/no-fetch-in-effect": "error",
 		"react-doctor/no-cascading-set-state": "warn",
@@ -1590,7 +1593,9 @@ const batchIncludePaths = (baseArgs, includePaths) => {
 	let currentBatchLength = baseArgsLength;
 	for (const filePath of includePaths) {
 		const entryLength = filePath.length + 1;
-		if (currentBatch.length > 0 && currentBatchLength + entryLength > SPAWN_ARGS_MAX_LENGTH_CHARS) {
+		const exceedsArgLength = currentBatch.length > 0 && currentBatchLength + entryLength > SPAWN_ARGS_MAX_LENGTH_CHARS;
+		const exceedsFileCount = currentBatch.length >= OXLINT_MAX_FILES_PER_BATCH;
+		if (exceedsArgLength || exceedsFileCount) {
 			batches.push(currentBatch);
 			currentBatch = [];
 			currentBatchLength = baseArgsLength;
@@ -1652,13 +1657,14 @@ const parseOxlintOutput = (stdout) => {
 		};
 	});
 };
-const runOxlint = async (rootDirectory, hasTypeScript, framework, hasReactCompiler, includePaths, nodeBinaryPath = process.execPath) => {
+const runOxlint = async (rootDirectory, hasTypeScript, framework, hasReactCompiler, includePaths, nodeBinaryPath = process.execPath, customRulesOnly = false) => {
 	if (includePaths !== void 0 && includePaths.length === 0) return [];
 	const configPath = path.join(os.tmpdir(), `react-doctor-oxlintrc-${process.pid}.json`);
 	const config = createOxlintConfig({
 		pluginPath: resolvePluginPath(),
 		framework,
-		hasReactCompiler
+		hasReactCompiler,
+		customRulesOnly
 	});
 	const restoreDisableDirectives = neutralizeDisableDirectives(rootDirectory, includePaths);
 	try {
@@ -1945,7 +1951,9 @@ const mergeScanOptions = (inputOptions, userConfig) => ({
 	verbose: inputOptions.verbose ?? userConfig?.verbose ?? false,
 	scoreOnly: inputOptions.scoreOnly ?? false,
 	offline: inputOptions.offline ?? false,
-	includePaths: inputOptions.includePaths ?? []
+	includePaths: inputOptions.includePaths ?? [],
+	customRulesOnly: userConfig?.customRulesOnly ?? false,
+	share: userConfig?.share ?? true
 });
 const printProjectDetection = (projectInfo, userConfig, isDiffMode, includePaths, lintSourceFileCount) => {
 	const frameworkLabel = formatFrameworkName(projectInfo.framework);
@@ -1965,7 +1973,7 @@ const printProjectDetection = (projectInfo, userConfig, isDiffMode, includePaths
 const scan = async (directory, inputOptions = {}) => {
 	const startTime = performance.now();
 	const projectInfo = discoverProject(directory);
-	const userConfig = loadConfig(directory);
+	const userConfig = inputOptions.configOverride !== void 0 ? inputOptions.configOverride : loadConfig(directory);
 	const options = mergeScanOptions(inputOptions, userConfig);
 	const { includePaths } = options;
 	const isDiffMode = includePaths.length > 0;
@@ -1980,7 +1988,7 @@ const scan = async (directory, inputOptions = {}) => {
 	const lintPromise = resolvedNodeBinaryPath ? (async () => {
 		const lintSpinner = options.scoreOnly ? null : spinner("Running lint checks...").start();
 		try {
-			const lintDiagnostics = await runOxlint(directory, projectInfo.hasTypeScript, projectInfo.framework, projectInfo.hasReactCompiler, lintIncludePaths, resolvedNodeBinaryPath);
+			const lintDiagnostics = await runOxlint(directory, projectInfo.hasTypeScript, projectInfo.framework, projectInfo.hasReactCompiler, lintIncludePaths, resolvedNodeBinaryPath, options.customRulesOnly);
 			lintSpinner?.succeed("Running lint checks.");
 			return lintDiagnostics;
 		} catch (error) {
@@ -2052,7 +2060,8 @@ const scan = async (directory, inputOptions = {}) => {
 	}
 	printDiagnostics(diagnostics, options.verbose);
 	const displayedSourceFileCount = isDiffMode ? includePaths.length : lintSourceFileCount;
-	printSummary(diagnostics, elapsedMilliseconds, scoreResult, projectInfo.projectName, displayedSourceFileCount, noScoreMessage, options.offline);
+	const shouldShowShareLink = !options.offline && options.share;
+	printSummary(diagnostics, elapsedMilliseconds, scoreResult, projectInfo.projectName, displayedSourceFileCount, noScoreMessage, !shouldShowShareLink);
 	if (hasSkippedChecks) {
 		const skippedLabel = skippedChecks.join(" and ");
 		logger.break();
@@ -2145,6 +2154,68 @@ const getDiffInfo = (directory, explicitBaseBranch) => {
 };
 const filterSourceFiles = (filePaths) => filePaths.filter((filePath) => SOURCE_FILE_PATTERN.test(filePath));
 
+//#endregion
+//#region src/utils/get-staged-files.ts
+const getStagedFilePaths = (directory) => {
+	const result = spawnSync("git", [
+		"diff",
+		"--cached",
+		"--name-only",
+		"--diff-filter=ACMR",
+		"--relative"
+	], {
+		cwd: directory,
+		stdio: "pipe",
+		maxBuffer: GIT_SHOW_MAX_BUFFER_BYTES
+	});
+	if (result.error || result.status !== 0) return [];
+	const output = result.stdout.toString().trim();
+	if (!output) return [];
+	return output.split("\n").filter(Boolean);
+};
+const readStagedContent = (directory, relativePath) => {
+	const result = spawnSync("git", ["show", `:${relativePath}`], {
+		cwd: directory,
+		stdio: "pipe",
+		maxBuffer: GIT_SHOW_MAX_BUFFER_BYTES
+	});
+	if (result.error || result.status !== 0) return null;
+	return result.stdout.toString();
+};
+const getStagedSourceFiles = (directory) => getStagedFilePaths(directory).filter((filePath) => SOURCE_FILE_PATTERN.test(filePath));
+const materializeStagedFiles = (directory, stagedFiles, tempDirectory) => {
+	const materializedFiles = [];
+	for (const relativePath of stagedFiles) {
+		const content = readStagedContent(directory, relativePath);
+		if (content === null) continue;
+		const targetPath = path.join(tempDirectory, relativePath);
+		fs.mkdirSync(path.dirname(targetPath), { recursive: true });
+		fs.writeFileSync(targetPath, content);
+		materializedFiles.push(relativePath);
+	}
+	for (const configFilename of [
+		"tsconfig.json",
+		"package.json",
+		"react-doctor.config.json"
+	]) {
+		const sourcePath = path.join(directory, configFilename);
+		const targetPath = path.join(tempDirectory, configFilename);
+		if (fs.existsSync(sourcePath) && !fs.existsSync(targetPath)) fs.cpSync(sourcePath, targetPath);
+	}
+	return {
+		tempDirectory,
+		stagedFiles: materializedFiles,
+		cleanup: () => {
+			try {
+				fs.rmSync(tempDirectory, {
+					recursive: true,
+					force: true
+				});
+			} catch {}
+		}
+	};
+};
+
 //#endregion
 //#region src/utils/handle-error.ts
 const DEFAULT_HANDLE_ERROR_OPTIONS = { shouldExit: true };
@@ -2207,179 +2278,9 @@ const promptProjectSelection = async (workspacePackages, rootDirectory) => {
 	return selectedDirectories;
 };
 
-//#endregion
-//#region src/utils/skill-prompt.ts
-const HOME_DIRECTORY = homedir();
-const CONFIG_DIRECTORY = join(HOME_DIRECTORY, ".react-doctor");
-const CONFIG_FILE = join(CONFIG_DIRECTORY, "config.json");
-const SKILL_NAME = "react-doctor";
-const WINDSURF_MARKER = "# React Doctor";
-const SKILL_DESCRIPTION = "Run after making React changes to catch issues early. Use when reviewing code, finishing a feature, or fixing bugs in a React project.";
-const SKILL_BODY = `Scans your React codebase for security, performance, correctness, and architecture issues. Outputs a 0-100 score with actionable diagnostics.
-
-## Usage
-
-\`\`\`bash
-npx -y react-doctor@latest . --verbose --diff
-\`\`\`
-
-## Workflow
-
-Run after making changes to catch issues early. Fix errors first, then re-run to verify the score improved.`;
-const SKILL_CONTENT = `---
-name: ${SKILL_NAME}
-description: ${SKILL_DESCRIPTION}
-version: 1.0.0
----
-
-# React Doctor
-
-${SKILL_BODY}
-`;
-const AGENTS_CONTENT = `# React Doctor
-
-${SKILL_DESCRIPTION}
-
-${SKILL_BODY}
-`;
-const CODEX_AGENT_CONFIG = `interface:
-  display_name: "${SKILL_NAME}"
-  short_description: "Diagnose and fix React codebase health issues"
-`;
-const readSkillPromptConfig = () => {
-	try {
-		if (!existsSync(CONFIG_FILE)) return {};
-		return JSON.parse(readFileSync(CONFIG_FILE, "utf-8"));
-	} catch {
-		return {};
-	}
-};
-const writeSkillPromptConfig = (config) => {
-	try {
-		mkdirSync(CONFIG_DIRECTORY, { recursive: true });
-		writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
-	} catch {}
-};
-const writeSkillFiles = (directory) => {
-	mkdirSync(directory, { recursive: true });
-	writeFileSync(join(directory, "SKILL.md"), SKILL_CONTENT);
-	writeFileSync(join(directory, "AGENTS.md"), AGENTS_CONTENT);
-};
-const isCommandAvailable = (command) => {
-	try {
-		execSync(`${process.platform === "win32" ? "where" : "which"} ${command}`, { stdio: "ignore" });
-		return true;
-	} catch {
-		return false;
-	}
-};
-const SKILL_TARGETS = [
-	{
-		name: "Claude Code",
-		detect: () => existsSync(join(HOME_DIRECTORY, ".claude")),
-		install: () => writeSkillFiles(join(HOME_DIRECTORY, ".claude", "skills", SKILL_NAME))
-	},
-	{
-		name: "Amp Code",
-		detect: () => existsSync(join(HOME_DIRECTORY, ".amp")),
-		install: () => writeSkillFiles(join(HOME_DIRECTORY, ".config", "amp", "skills", SKILL_NAME))
-	},
-	{
-		name: "Cursor",
-		detect: () => existsSync(join(HOME_DIRECTORY, ".cursor")),
-		install: () => writeSkillFiles(join(HOME_DIRECTORY, ".cursor", "skills", SKILL_NAME))
-	},
-	{
-		name: "OpenCode",
-		detect: () => isCommandAvailable("opencode") || existsSync(join(HOME_DIRECTORY, ".config", "opencode")),
-		install: () => writeSkillFiles(join(HOME_DIRECTORY, ".config", "opencode", "skills", SKILL_NAME))
-	},
-	{
-		name: "Windsurf",
-		detect: () => existsSync(join(HOME_DIRECTORY, ".codeium")) || existsSync(join(HOME_DIRECTORY, "Library", "Application Support", "Windsurf")),
-		install: () => {
-			const memoriesDirectory = join(HOME_DIRECTORY, ".codeium", "windsurf", "memories");
-			mkdirSync(memoriesDirectory, { recursive: true });
-			const rulesFile = join(memoriesDirectory, "global_rules.md");
-			if (existsSync(rulesFile)) {
-				if (readFileSync(rulesFile, "utf-8").includes(WINDSURF_MARKER)) return;
-				appendFileSync(rulesFile, `\n${WINDSURF_MARKER}\n\n${SKILL_CONTENT}`);
-			} else writeFileSync(rulesFile, `${WINDSURF_MARKER}\n\n${SKILL_CONTENT}`);
-		}
-	},
-	{
-		name: "Antigravity",
-		detect: () => isCommandAvailable("agy") || existsSync(join(HOME_DIRECTORY, ".gemini", "antigravity")),
-		install: () => writeSkillFiles(join(HOME_DIRECTORY, ".gemini", "antigravity", "skills", SKILL_NAME))
-	},
-	{
-		name: "Gemini CLI",
-		detect: () => isCommandAvailable("gemini") || existsSync(join(HOME_DIRECTORY, ".gemini")),
-		install: () => writeSkillFiles(join(HOME_DIRECTORY, ".gemini", "skills", SKILL_NAME))
-	},
-	{
-		name: "Codex",
-		detect: () => isCommandAvailable("codex") || existsSync(join(HOME_DIRECTORY, ".codex")),
-		install: () => {
-			const skillDirectory = join(HOME_DIRECTORY, ".codex", "skills", SKILL_NAME);
-			writeSkillFiles(skillDirectory);
-			const agentsDirectory = join(skillDirectory, "agents");
-			mkdirSync(agentsDirectory, { recursive: true });
-			writeFileSync(join(agentsDirectory, "openai.yaml"), CODEX_AGENT_CONFIG);
-		}
-	}
-];
-const installSkill = () => {
-	let installedCount = 0;
-	for (const target of SKILL_TARGETS) {
-		if (!target.detect()) continue;
-		try {
-			target.install();
-			logger.log(`  ${highlighter.success("✔")} ${target.name}`);
-			installedCount++;
-		} catch {
-			logger.dim(`  ✗ ${target.name} (failed)`);
-		}
-	}
-	try {
-		writeSkillFiles(join(".agents", SKILL_NAME));
-		logger.log(`  ${highlighter.success("✔")} .agents/`);
-		installedCount++;
-	} catch {
-		logger.dim("  ✗ .agents/ (failed)");
-	}
-	logger.break();
-	if (installedCount === 0) logger.dim("No supported tools detected.");
-	else logger.success("Done! The skill will activate when working on React projects.");
-};
-const maybePromptSkillInstall = async (shouldSkipPrompts) => {
-	const config = readSkillPromptConfig();
-	if (config.skillPromptDismissed) return;
-	if (shouldSkipPrompts) return;
-	logger.break();
-	logger.log(`${highlighter.info("💡")} Have your coding agent fix these issues automatically?`);
-	logger.dim(`   Install the ${highlighter.info("react-doctor")} skill to teach Cursor, Claude Code,`);
-	logger.dim("   Ami, and other AI agents how to diagnose and fix React issues.");
-	logger.break();
-	const { shouldInstall } = await prompts({
-		type: "confirm",
-		name: "shouldInstall",
-		message: "Install skill? (recommended)",
-		initial: true
-	});
-	if (shouldInstall) {
-		logger.break();
-		installSkill();
-	}
-	writeSkillPromptConfig({
-		...config,
-		skillPromptDismissed: true
-	});
-};
-
 //#endregion
 //#region src/cli.ts
-const VERSION = "0.0.31";
+const VERSION = "0.0.33";
 const VALID_FAIL_ON_LEVELS = new Set([
 	"error",
 	"warning",
@@ -2391,23 +2292,33 @@ const shouldFailForDiagnostics = (diagnostics, failOnLevel) => {
 	if (failOnLevel === "warning") return diagnostics.length > 0;
 	return diagnostics.some((diagnostic) => diagnostic.severity === "error");
 };
-const exitWithFixHint = () => {
+const resolveFailOnLevel = (programInstance, flags, userConfig) => {
+	const resolvedFailOn = programInstance.getOptionValueSource("failOn") === "cli" ? flags.failOn : userConfig?.failOn ?? flags.failOn;
+	return isValidFailOnLevel(resolvedFailOn) ? resolvedFailOn : "none";
+};
+const printAnnotations = (diagnostics) => {
+	for (const diagnostic of diagnostics) {
+		const level = diagnostic.severity === "error" ? "error" : "warning";
+		const title = `${diagnostic.plugin}/${diagnostic.rule}`;
+		const fileLocation = diagnostic.line > 0 ? `file=${diagnostic.filePath},line=${diagnostic.line}` : `file=${diagnostic.filePath}`;
+		console.log(`::${level} ${fileLocation},title=${title}::${diagnostic.message}`);
+	}
+};
+const exitGracefully = () => {
 	logger.break();
 	logger.log("Cancelled.");
-	logger.dim("Run `npx react-doctor@latest --fix` to fix issues.");
 	logger.break();
 	process.exit(0);
 };
-process.on("SIGINT", exitWithFixHint);
-process.on("SIGTERM", exitWithFixHint);
+process.on("SIGINT", exitGracefully);
+process.on("SIGTERM", exitGracefully);
 const AUTOMATED_ENVIRONMENT_VARIABLES = [
 	"CI",
 	"CLAUDECODE",
 	"CURSOR_AGENT",
 	"CODEX_CI",
 	"OPENCODE",
-	"AMP_HOME",
-	"AMI"
+	"AMP_HOME"
 ];
 const isAutomatedEnvironment = () => AUTOMATED_ENVIRONMENT_VARIABLES.some((envVariable) => Boolean(process.env[envVariable]));
 const resolveCliScanOptions = (flags, userConfig, programInstance) => {
@@ -2442,7 +2353,7 @@ const resolveDiffMode = async (diffInfo, effectiveDiff, shouldSkipPrompts, isSco
 	});
 	return Boolean(shouldScanChangedOnly);
 };
-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 detection").option("--no-dead-code", "skip dead code detection").option("--verbose", "show file details per rule").option("--score", "output only the score").option("-y, --yes", "skip prompts, scan all workspace projects").option("--project <name>", "select workspace project (comma-separated for multiple)").option("--diff [base]", "scan only files changed vs base branch").option("--offline", "skip telemetry (anonymous, not stored, only used to calculate score)").option("--ami", "enable Ami-related prompts").option("--fail-on <level>", "exit with error code on diagnostics: error, warning, none", "none").option("--fix", "open Ami to auto-fix all issues").action(async (directory, flags) => {
+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 detection").option("--no-dead-code", "skip dead code detection").option("--verbose", "show file details per rule").option("--score", "output only the score").option("-y, --yes", "skip prompts, scan all workspace projects").option("-n, --no", "skip prompts, always run a full scan (decline diff-only)").option("--project <name>", "select workspace project (comma-separated for multiple)").option("--diff [base]", "scan only files changed vs base branch").option("--offline", "skip telemetry (anonymous, not stored, only used to calculate score)").option("--staged", "scan only staged (git index) files for pre-commit hooks").option("--fail-on <level>", "exit with error code on diagnostics: error, warning, none", "none").option("--annotations", "output diagnostics as GitHub Actions annotations").action(async (directory, flags) => {
 	const isScoreOnly = flags.score;
 	try {
 		const resolvedDirectory = path.resolve(directory);
@@ -2452,8 +2363,34 @@ const program = new Command().name("react-doctor").description("Diagnose React c
 			logger.break();
 		}
 		const scanOptions = resolveCliScanOptions(flags, userConfig, program);
-		const shouldSkipPrompts = flags.yes || isAutomatedEnvironment() || !process.stdin.isTTY;
-		const shouldSkipAmiPrompts = shouldSkipPrompts || !flags.ami;
+		const shouldSkipPrompts = flags.yes || flags.no || isAutomatedEnvironment() || !process.stdin.isTTY;
+		if (flags.staged) {
+			const stagedFiles = getStagedSourceFiles(resolvedDirectory);
+			if (stagedFiles.length === 0) {
+				if (!isScoreOnly) logger.dim("No staged source files found.");
+				return;
+			}
+			if (!isScoreOnly) {
+				logger.log(`Scanning ${highlighter.info(`${stagedFiles.length}`)} staged files...`);
+				logger.break();
+			}
+			const snapshot = materializeStagedFiles(resolvedDirectory, stagedFiles, mkdtempSync(path.join(tmpdir(), "react-doctor-staged-")));
+			try {
+				const remappedDiagnostics = (await scan(snapshot.tempDirectory, {
+					...scanOptions,
+					includePaths: snapshot.stagedFiles,
+					configOverride: userConfig
+				})).diagnostics.map((diagnostic) => ({
+					...diagnostic,
+					filePath: path.isAbsolute(diagnostic.filePath) ? diagnostic.filePath.replace(snapshot.tempDirectory, resolvedDirectory) : diagnostic.filePath
+				}));
+				if (flags.annotations) printAnnotations(remappedDiagnostics);
+				if (shouldFailForDiagnostics(remappedDiagnostics, resolveFailOnLevel(program, flags, userConfig))) process.exitCode = 1;
+			} finally {
+				snapshot.cleanup();
+			}
+			return;
+		}
 		const projectDirectories = await selectProjects(resolvedDirectory, flags.project, shouldSkipPrompts);
 		const effectiveDiff = program.getOptionValueSource("diff") === "cli" ? flags.diff : userConfig?.diff;
 		const explicitBaseBranch = typeof effectiveDiff === "string" ? effectiveDiff : void 0;
@@ -2492,13 +2429,8 @@ const program = new Command().name("react-doctor").description("Diagnose React c
 			allDiagnostics.push(...scanResult.diagnostics);
 			if (!isScoreOnly) logger.break();
 		}
-		const resolvedFailOn = program.getOptionValueSource("failOn") === "cli" ? flags.failOn : userConfig?.failOn ?? flags.failOn;
-		if (shouldFailForDiagnostics(allDiagnostics, isValidFailOnLevel(resolvedFailOn) ? resolvedFailOn : "none")) process.exitCode = 1;
-		if (flags.fix) openAmiToFix(resolvedDirectory);
-		if (!isScoreOnly && !shouldSkipAmiPrompts && !flags.fix) {
-			await maybePromptSkillInstall(shouldSkipAmiPrompts);
-			await maybePromptFix(resolvedDirectory, allDiagnostics, flags.offline ? null : await fetchEstimatedScore(allDiagnostics));
-		}
+		if (flags.annotations) printAnnotations(allDiagnostics);
+		if (shouldFailForDiagnostics(allDiagnostics, resolveFailOnLevel(program, flags, userConfig))) process.exitCode = 1;
 	} catch (error) {
 		handleError(error);
 	}
@@ -2506,146 +2438,6 @@ const program = new Command().name("react-doctor").description("Diagnose React c
 ${highlighter.dim("Learn more:")}
   ${highlighter.info("https://github.com/millionco/react-doctor")}
 `);
-const DEEPLINK_FIX_PROMPT = "/{slash-command:ami:react-doctor}";
-const isAmiInstalled = () => {
-	if (process.platform === "darwin") return existsSync("/Applications/Ami.app") || existsSync(path.join(os.homedir(), "Applications", "Ami.app"));
-	if (process.platform === "win32") {
-		const { LOCALAPPDATA, PROGRAMFILES } = process.env;
-		return Boolean(LOCALAPPDATA && existsSync(path.join(LOCALAPPDATA, "Programs", "Ami", "Ami.exe"))) || Boolean(PROGRAMFILES && existsSync(path.join(PROGRAMFILES, "Ami", "Ami.exe")));
-	}
-	try {
-		execSync("which ami", { stdio: "ignore" });
-		return true;
-	} catch {
-		return false;
-	}
-};
-const installAmi = () => {
-	logger.log("Installing Ami...");
-	logger.break();
-	try {
-		execSync(`curl -fsSL ${AMI_INSTALL_URL} | bash`, { stdio: "inherit" });
-	} catch {
-		logger.error(`Failed to install Ami. Visit ${AMI_WEBSITE_URL} to install manually.`);
-		process.exit(1);
-	}
-	logger.break();
-};
-const openUrl = (url) => {
-	if (process.platform === "win32") {
-		execSync(`start "" "${url.replace(/%/g, "%%")}"`, { stdio: "ignore" });
-		return;
-	}
-	execSync(process.platform === "darwin" ? `open "${url}"` : `xdg-open "${url}"`, { stdio: "ignore" });
-};
-const buildDeeplinkParams = (directory) => {
-	const params = new URLSearchParams();
-	params.set("cwd", path.resolve(directory));
-	params.set("prompt", DEEPLINK_FIX_PROMPT);
-	params.set("mode", "agent");
-	params.set("autoSubmit", "true");
-	params.set("source", "react-doctor");
-	return params;
-};
-const buildDeeplink = (directory) => `ami://open-project?${buildDeeplinkParams(directory).toString()}`;
-const buildWebDeeplink = (directory) => `${OPEN_BASE_URL}?${buildDeeplinkParams(directory).toString()}`;
-const openAmiToFix = (directory) => {
-	const isInstalled = isAmiInstalled();
-	const deeplink = buildDeeplink(directory);
-	const webDeeplink = buildWebDeeplink(directory);
-	if (!isInstalled) {
-		if (process.platform === "darwin") {
-			installAmi();
-			if (isAmiInstalled()) logger.success("Ami installed successfully.");
-			else {
-				logger.error("Installation could not be verified.");
-				logger.dim(`Install manually at ${highlighter.info(AMI_WEBSITE_URL)}`);
-			}
-		} else {
-			logger.error("Ami is not installed.");
-			logger.dim(`Download at ${highlighter.info(AMI_RELEASES_URL)}`);
-		}
-		logger.break();
-		logger.dim("Open this link to start fixing:");
-		logger.info(webDeeplink);
-		return;
-	}
-	logger.log("Opening Ami...");
-	try {
-		openUrl(deeplink);
-		logger.success("Ami opened. Fixing your issues now.");
-	} catch {
-		logger.break();
-		logger.dim("Could not open Ami automatically. Open this link instead:");
-		logger.info(webDeeplink);
-	}
-};
-const FIX_METHOD_AMI = "ami";
-const FIX_COMMAND_HINT = "npx react-doctor@latest --fix";
-const buildAmiBanner = (issueCount, currentScore, estimatedScore) => {
-	const currentScoreDisplay = colorizeByScore(String(currentScore), currentScore);
-	const estimatedScoreDisplay = colorizeByScore(`~${estimatedScore}`, estimatedScore);
-	const issueLabel = issueCount === 1 ? "issue" : "issues";
-	return renderFramedBoxString([
-		createFramedLine(`Score: ${currentScore} → ~${estimatedScore}`, `Score: ${currentScoreDisplay} ${highlighter.dim("→")} ${estimatedScoreDisplay}`),
-		createFramedLine(""),
-		createFramedLine(`Ami is a coding agent built for React. It reads`, `${highlighter.info("Ami")} is a coding agent built for React. It reads`),
-		createFramedLine("your react-doctor report, understands your codebase,"),
-		createFramedLine(`and fixes ${issueCount} ${issueLabel} one by one — then re-runs the`, `and fixes ${highlighter.warn(String(issueCount))} ${issueLabel} one by one — then re-runs the`),
-		createFramedLine("scan to verify the score improved."),
-		createFramedLine(""),
-		createFramedLine(`Free to use. ${AMI_WEBSITE_URL}`, `Free to use. ${highlighter.info(AMI_WEBSITE_URL)}`)
-	]);
-};
-const buildSkipBanner = (issueCount, estimatedScore) => {
-	const issueLabel = issueCount === 1 ? "issue" : "issues";
-	const estimatedScoreDisplay = colorizeByScore(`~${estimatedScore}`, estimatedScore);
-	return renderFramedBoxString([
-		createFramedLine(`Skip fixing ${issueCount} ${issueLabel} and reaching ~${estimatedScore}?`, `Skip fixing ${highlighter.warn(String(issueCount))} ${issueLabel} and reaching ${estimatedScoreDisplay}?`),
-		createFramedLine(""),
-		createFramedLine(`Run ${FIX_COMMAND_HINT} anytime to come back.`, `Run ${highlighter.info(FIX_COMMAND_HINT)} anytime to come back.`)
-	]);
-};
-const configureFixBanners = (issueCount, estimatedScoreResult) => {
-	const { currentScore, estimatedScore } = estimatedScoreResult;
-	setSelectBanner(buildAmiBanner(issueCount, currentScore, estimatedScore), 0);
-	setSelectBanner(buildSkipBanner(issueCount, estimatedScore), 1);
-};
-const maybePromptFix = async (directory, diagnostics, estimatedScoreResult) => {
-	if (diagnostics.length === 0) return;
-	logger.break();
-	if (estimatedScoreResult) configureFixBanners(diagnostics.length, estimatedScoreResult);
-	const { fixMethod } = await prompts({
-		type: "select",
-		name: "fixMethod",
-		message: "Fix issues?",
-		choices: [{
-			title: "Use Ami (recommended)",
-			description: "Optimized coding agent for React Doctor",
-			value: FIX_METHOD_AMI
-		}, {
-			title: "Skip",
-			value: "skip"
-		}]
-	});
-	clearSelectBanner();
-	if (fixMethod === FIX_METHOD_AMI) openAmiToFix(directory);
-	else {
-		logger.break();
-		logger.dim(`  Run ${highlighter.info(FIX_COMMAND_HINT)} anytime to fix issues.`);
-	}
-};
-const fixAction = (directory) => {
-	try {
-		openAmiToFix(directory);
-	} catch (error) {
-		handleError(error);
-	}
-};
-const fixCommand = new Command("fix").description("Open Ami to auto-fix react-doctor issues").argument("[directory]", "project directory", ".").action(fixAction);
-const installAmiCommand = new Command("install-ami").description("Install Ami and open it to auto-fix issues").argument("[directory]", "project directory", ".").action(fixAction);
-program.addCommand(fixCommand);
-program.addCommand(installAmiCommand);
 const main$1 = async () => {
 	await program.parseAsync();
 };