react-doctor 0.0.22 → 0.0.24

package/README.md

@@ -15,6 +15,15 @@ One command scans your codebase for security, performance, correctness, and arch
 
 https://github.com/user-attachments/assets/07cc88d9-9589-44c3-aa73-5d603cb1c570
 
+## How it works
+
+React Doctor detects your framework (Next.js, Vite, Remix, etc.), React version, and compiler setup, then runs two analysis passes **in parallel**:
+
+1. **Lint**: Checks 60+ rules across state & effects, performance, architecture, bundle size, security, correctness, accessibility, and framework-specific categories (Next.js, React Native). Rules are toggled automatically based on your project setup.
+2. **Dead code**: Detects unused files, exports, types, and duplicates.
+
+Diagnostics are filtered through your config, then scored by severity (errors weigh more than warnings) to produce a **0–100 health score** (75+ Great, 50–74 Needs work, <50 Critical).
+
 ## Install
 
 Run this at your project root:
@@ -53,6 +62,7 @@ Options:
   -y, --yes         skip prompts, scan all workspace projects
   --project <name>  select workspace project (comma-separated for multiple)
   --diff [base]     scan only files changed vs base branch
+  --no-ami          skip Ami-related prompts
   --fix             open Ami to auto-fix all issues
   --prompt          copy latest scan output to clipboard
   -h, --help        display help for command

package/dist/cli.js

@@ -183,6 +183,11 @@ const VITE_CONFIG_FILENAMES = [
 	"vite.config.mjs",
 	"vite.config.cjs"
 ];
+const EXPO_APP_CONFIG_FILENAMES = [
+	"app.json",
+	"app.config.js",
+	"app.config.ts"
+];
 const REACT_COMPILER_CONFIG_PATTERN = /react-compiler|reactCompiler/;
 const FRAMEWORK_PACKAGES = {
 	next: "nextjs",
@@ -369,6 +374,7 @@ const detectReactCompiler = (directory, packageJson) => {
 	if (hasCompilerInConfigFiles(directory, NEXT_CONFIG_FILENAMES)) return true;
 	if (hasCompilerInConfigFiles(directory, BABEL_CONFIG_FILENAMES)) return true;
 	if (hasCompilerInConfigFiles(directory, VITE_CONFIG_FILENAMES)) return true;
+	if (hasCompilerInConfigFiles(directory, EXPO_APP_CONFIG_FILENAMES)) return true;
 	let ancestorDirectory = path.dirname(directory);
 	while (ancestorDirectory !== path.dirname(ancestorDirectory)) {
 		const ancestorPackagePath = path.join(ancestorDirectory, "package.json");
@@ -446,7 +452,7 @@ const filterIgnoredDiagnostics = (diagnostics, config) => {
 	return diagnostics.filter((diagnostic) => {
 		const ruleIdentifier = `${diagnostic.plugin}/${diagnostic.rule}`;
 		if (ignoredRules.has(ruleIdentifier)) return false;
-		const normalizedPath = diagnostic.filePath.replace(/\\/g, "/");
+		const normalizedPath = diagnostic.filePath.replace(/\\/g, "/").replace(/^\.\//, "");
 		if (ignoredFilePatterns.some((pattern) => pattern.test(normalizedPath))) return false;
 		return true;
 	});
@@ -1759,7 +1765,7 @@ const maybePromptSkillInstall = async (shouldSkipPrompts) => {
 
 //#endregion
 //#region src/cli.ts
-const VERSION = "0.0.22";
+const VERSION = "0.0.24";
 const exitWithFixHint = () => {
 	logger.break();
 	logger.log("Cancelled.");
@@ -1791,7 +1797,7 @@ const resolveDiffMode = async (diffInfo, effectiveDiff, shouldSkipPrompts, isSco
 	});
 	return Boolean(shouldScanBranchOnly);
 };
-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("--no-lint", "skip linting").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("--fix", "open Ami to auto-fix all issues").option("--prompt", "copy latest scan output to clipboard").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("--no-lint", "skip linting").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("--no-ami", "skip Ami-related prompts").option("--fix", "open Ami to auto-fix all issues").option("--prompt", "copy latest scan output to clipboard").action(async (directory, flags) => {
 	const isScoreOnly = flags.score && !flags.prompt;
 	const shouldCopyPromptOutput = flags.prompt;
 	startLoggerCapture();
@@ -1820,6 +1826,7 @@ const program = new Command().name("react-doctor").description("Diagnose React c
 			process.env.AMI
 		].some(Boolean);
 		const shouldSkipPrompts = flags.yes || isAutomatedEnvironment || !process.stdin.isTTY;
+		const shouldSkipAmiPrompts = shouldSkipPrompts || !flags.ami;
 		const projectDirectories = await selectProjects(resolvedDirectory, flags.project, shouldSkipPrompts);
 		const effectiveDiff = isCliOverride("diff") ? flags.diff : userConfig?.diff;
 		const explicitBaseBranch = typeof effectiveDiff === "string" ? effectiveDiff : void 0;
@@ -1861,8 +1868,8 @@ const program = new Command().name("react-doctor").description("Diagnose React c
 		if (flags.fix) openAmiToFix(resolvedDirectory);
 		if (shouldCopyPromptOutput) copyPromptToClipboard(capturedScanOutput, !isScoreOnly);
 		else if (!isScoreOnly) {
-			await maybePromptSkillInstall(shouldSkipPrompts);
-			if (!shouldSkipPrompts && !flags.fix) await maybePromptFix(resolvedDirectory, allDiagnostics, flags.offline ? null : await fetchEstimatedScore(allDiagnostics), capturedScanOutput);
+			await maybePromptSkillInstall(shouldSkipAmiPrompts);
+			if (!shouldSkipAmiPrompts && !flags.fix) await maybePromptFix(resolvedDirectory, allDiagnostics, flags.offline ? null : await fetchEstimatedScore(allDiagnostics), capturedScanOutput);
 		}
 	} catch (error) {
 		handleError(error, { shouldExit: !shouldCopyPromptOutput });