react-doctor 0.0.22 → 0.0.23

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:

package/dist/cli.js

@@ -446,7 +446,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 +1759,7 @@ const maybePromptSkillInstall = async (shouldSkipPrompts) => {
 
 //#endregion
 //#region src/cli.ts
-const VERSION = "0.0.22";
+const VERSION = "0.0.23";
 const exitWithFixHint = () => {
 	logger.break();
 	logger.log("Cancelled.");
@@ -1791,7 +1791,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 +1820,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 +1862,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 });