react-doctor 0.0.4 → 0.0.6

package/dist/cli.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import { createRequire } from "node:module";
+import { execSync, spawn, spawnSync } from "node:child_process";
 import path, { join } from "node:path";
 import { Command } from "commander";
 import pc from "picocolors";
@@ -7,7 +8,6 @@ import { randomUUID } from "node:crypto";
 import fs, { mkdirSync, writeFileSync } from "node:fs";
 import os, { tmpdir } from "node:os";
 import { performance } from "node:perf_hooks";
-import { execSync, spawn, spawnSync } from "node:child_process";
 import { main } from "knip";
 import { createOptions } from "knip/session";
 import { fileURLToPath } from "node:url";
@@ -65,8 +65,36 @@ const handleError = (error) => {
 //#region src/constants.ts
 const SOURCE_FILE_PATTERN = /\.(tsx?|jsx?)$/;
 const JSX_FILE_PATTERN = /\.(tsx|jsx)$/;
+const MILLISECONDS_PER_SECOND = 1e3;
 const SEPARATOR_LENGTH_CHARS = 62;
 const ERROR_PREVIEW_LENGTH_CHARS = 200;
+const PERFECT_SCORE = 100;
+const SCORE_GOOD_THRESHOLD = 75;
+const SCORE_OK_THRESHOLD = 50;
+const SCORE_BAR_WIDTH_CHARS = 50;
+const SCORE_API_URL = "https://www.react.doctor/api/score";
+const OFFLINE_MESSAGE = "You are offline, could not calculate score. Reconnect to calculate.";
+
+//#endregion
+//#region src/utils/calculate-score.ts
+const calculateScore = async (diagnostics) => {
+	const payload = diagnostics.map((diagnostic) => ({
+		plugin: diagnostic.plugin,
+		rule: diagnostic.rule,
+		severity: diagnostic.severity
+	}));
+	try {
+		const response = await fetch(SCORE_API_URL, {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify({ diagnostics: payload })
+		});
+		if (!response.ok) return null;
+		return await response.json();
+	} catch {
+		return null;
+	}
+};
 
 //#endregion
 //#region src/utils/read-package-json.ts
@@ -149,15 +177,15 @@ const parsePnpmWorkspacePatterns = (rootDirectory) => {
 	if (!fs.existsSync(workspacePath)) return [];
 	const content = fs.readFileSync(workspacePath, "utf-8");
 	const patterns = [];
-	let insidePackagesBlock = false;
+	let isInsidePackagesBlock = false;
 	for (const line of content.split("\n")) {
 		const trimmed = line.trim();
 		if (trimmed === "packages:") {
-			insidePackagesBlock = true;
+			isInsidePackagesBlock = true;
 			continue;
 		}
-		if (insidePackagesBlock && trimmed.startsWith("-")) patterns.push(trimmed.replace(/^-\s*/, "").replace(/["']/g, ""));
-		else if (insidePackagesBlock && trimmed.length > 0 && !trimmed.startsWith("#")) insidePackagesBlock = false;
+		if (isInsidePackagesBlock && trimmed.startsWith("-")) patterns.push(trimmed.replace(/^-\s*/, "").replace(/["']/g, ""));
+		else if (isInsidePackagesBlock && trimmed.length > 0 && !trimmed.startsWith("#")) isInsidePackagesBlock = false;
 	}
 	return patterns;
 };
@@ -218,6 +246,25 @@ const hasReactDependency = (packageJson) => {
 	const allDependencies = collectAllDependencies(packageJson);
 	return Object.keys(allDependencies).some((packageName) => packageName === "next" || packageName.includes("react"));
 };
+const discoverReactSubprojects = (rootDirectory) => {
+	if (!fs.existsSync(rootDirectory) || !fs.statSync(rootDirectory).isDirectory()) return [];
+	const entries = fs.readdirSync(rootDirectory, { withFileTypes: true });
+	const packages = [];
+	for (const entry of entries) {
+		if (!entry.isDirectory() || entry.name.startsWith(".") || entry.name === "node_modules") continue;
+		const subdirectory = path.join(rootDirectory, entry.name);
+		const packageJsonPath = path.join(subdirectory, "package.json");
+		if (!fs.existsSync(packageJsonPath)) continue;
+		const packageJson = readPackageJson(packageJsonPath);
+		if (!hasReactDependency(packageJson)) continue;
+		const name = packageJson.name ?? entry.name;
+		packages.push({
+			name,
+			directory: subdirectory
+		});
+	}
+	return packages;
+};
 const listWorkspacePackages = (rootDirectory) => {
 	const packageJsonPath = path.join(rootDirectory, "package.json");
 	if (!fs.existsSync(packageJsonPath)) return [];
@@ -312,15 +359,33 @@ const MOTION_LIBRARY_PACKAGES = new Set(["framer-motion", "motion"]);
 //#region src/utils/check-reduced-motion.ts
 const REDUCED_MOTION_GREP_PATTERN = "prefers-reduced-motion|useReducedMotion";
 const REDUCED_MOTION_FILE_GLOBS = "\"*.ts\" \"*.tsx\" \"*.js\" \"*.jsx\" \"*.css\" \"*.scss\"";
+const MISSING_REDUCED_MOTION_DIAGNOSTIC = {
+	filePath: "package.json",
+	plugin: "react-doctor",
+	rule: "require-reduced-motion",
+	severity: "error",
+	message: "Project uses a motion library but has no prefers-reduced-motion handling — required for accessibility (WCAG 2.3.3)",
+	help: "Add `useReducedMotion()` from your animation library, or a `@media (prefers-reduced-motion: reduce)` CSS query",
+	line: 0,
+	column: 0,
+	category: "Accessibility",
+	weight: 2
+};
 const checkReducedMotion = (rootDirectory) => {
 	const packageJsonPath = path.join(rootDirectory, "package.json");
 	if (!fs.existsSync(packageJsonPath)) return [];
-	const packageJson = readPackageJson(packageJsonPath);
-	const allDependencies = {
-		...packageJson.dependencies,
-		...packageJson.devDependencies
-	};
-	if (!Object.keys(allDependencies).some((packageName) => MOTION_LIBRARY_PACKAGES.has(packageName))) return [];
+	let hasMotionLibrary = false;
+	try {
+		const packageJson = readPackageJson(packageJsonPath);
+		const allDependencies = {
+			...packageJson.dependencies,
+			...packageJson.devDependencies
+		};
+		hasMotionLibrary = Object.keys(allDependencies).some((packageName) => MOTION_LIBRARY_PACKAGES.has(packageName));
+	} catch {
+		return [];
+	}
+	if (!hasMotionLibrary) return [];
 	try {
 		execSync(`git grep -ql -E "${REDUCED_MOTION_GREP_PATTERN}" -- ${REDUCED_MOTION_FILE_GLOBS}`, {
 			cwd: rootDirectory,
@@ -328,17 +393,7 @@ const checkReducedMotion = (rootDirectory) => {
 		});
 		return [];
 	} catch {
-		return [{
-			filePath: "package.json",
-			plugin: "react-doctor",
-			rule: "require-reduced-motion",
-			severity: "error",
-			message: "Project uses a motion library but has no prefers-reduced-motion handling — required for accessibility (WCAG 2.3.3)",
-			help: "Add `useReducedMotion()` from your animation library, or a `@media (prefers-reduced-motion: reduce)` CSS query",
-			line: 0,
-			column: 0,
-			category: "Accessibility"
-		}];
+		return [MISSING_REDUCED_MOTION_DIAGNOSTIC];
 	}
 };
 
@@ -373,7 +428,8 @@ const collectIssueRecords = (records, issueType, rootDirectory) => {
 		help: "",
 		line: 0,
 		column: 0,
-		category: KNIP_CATEGORY_MAP[issueType] ?? "Dead Code"
+		category: KNIP_CATEGORY_MAP[issueType] ?? "Dead Code",
+		weight: 1
 	});
 	return diagnostics;
 };
@@ -408,7 +464,8 @@ const runKnip = async (rootDirectory) => {
 		help: "This file is not imported by any other file in the project.",
 		line: 0,
 		column: 0,
-		category: KNIP_CATEGORY_MAP["files"]
+		category: KNIP_CATEGORY_MAP["files"],
+		weight: 1
 	});
 	for (const issueType of [
 		"exports",
@@ -429,6 +486,11 @@ const NEXTJS_RULES = {
 	"react-doctor/nextjs-no-client-fetch-for-server-data": "warn",
 	"react-doctor/nextjs-missing-metadata": "warn",
 	"react-doctor/nextjs-no-client-side-redirect": "warn",
+	"react-doctor/nextjs-no-redirect-in-try-catch": "warn",
+	"react-doctor/nextjs-image-missing-sizes": "warn",
+	"react-doctor/nextjs-no-native-script": "warn",
+	"react-doctor/nextjs-inline-script-missing-id": "warn",
+	"react-doctor/nextjs-no-font-link": "warn",
 	"react-doctor/nextjs-no-css-link": "warn",
 	"react-doctor/nextjs-no-polyfill-script": "warn",
 	"react-doctor/nextjs-no-head-import": "error"
@@ -698,7 +760,11 @@ const resolveOxlintBinary = () => {
 };
 const resolvePluginPath = () => {
 	const currentDirectory = path.dirname(fileURLToPath(import.meta.url));
-	return path.join(currentDirectory, "react-doctor-plugin.js");
+	const pluginPath = path.join(currentDirectory, "react-doctor-plugin.js");
+	if (fs.existsSync(pluginPath)) return pluginPath;
+	const distPluginPath = path.resolve(currentDirectory, "../../dist/react-doctor-plugin.js");
+	if (fs.existsSync(distPluginPath)) return distPluginPath;
+	return pluginPath;
 };
 const resolveDiagnosticCategory = (plugin, rule) => {
 	return RULE_CATEGORY_MAP[`${plugin}/${rule}`] ?? PLUGIN_CATEGORY_MAP[plugin] ?? "Other";
@@ -770,7 +836,34 @@ const runOxlint = async (rootDirectory, hasTypeScript, framework, hasReactCompil
 
 //#endregion
 //#region src/utils/spinner.ts
-const spinner = (text) => ora({ text });
+let sharedInstance = null;
+let activeCount = 0;
+const pendingTexts = /* @__PURE__ */ new Set();
+const finalize = (method, originalText, displayText) => {
+	pendingTexts.delete(originalText);
+	activeCount--;
+	if (activeCount <= 0 || !sharedInstance) {
+		sharedInstance?.[method](displayText);
+		sharedInstance = null;
+		activeCount = 0;
+		return;
+	}
+	sharedInstance.stop();
+	ora(displayText).start()[method](displayText);
+	const [remainingText] = pendingTexts;
+	if (remainingText) sharedInstance.text = remainingText;
+	sharedInstance.start();
+};
+const spinner = (text) => ({ start() {
+	activeCount++;
+	pendingTexts.add(text);
+	if (!sharedInstance) sharedInstance = ora({ text }).start();
+	else sharedInstance.text = text;
+	return {
+		succeed: (displayText) => finalize("succeed", text, displayText),
+		fail: (displayText) => finalize("fail", text, displayText)
+	};
+} });
 
 //#endregion
 //#region src/scan.ts
@@ -781,12 +874,17 @@ const SEVERITY_ORDER = {
 const sortBySeverity = (diagnosticGroups) => diagnosticGroups.toSorted(([, diagnosticsA], [, diagnosticsB]) => {
 	return SEVERITY_ORDER[diagnosticsA[0].severity] - SEVERITY_ORDER[diagnosticsB[0].severity];
 });
-const collectAffectedFiles = (diagnostics) => {
-	const files = /* @__PURE__ */ new Set();
-	for (const diagnostic of diagnostics) files.add(diagnostic.filePath);
-	return files;
+const collectAffectedFiles = (diagnostics) => new Set(diagnostics.map((diagnostic) => diagnostic.filePath));
+const buildFileLineMap = (diagnostics) => {
+	const fileLines = /* @__PURE__ */ new Map();
+	for (const diagnostic of diagnostics) {
+		const lines = fileLines.get(diagnostic.filePath) ?? [];
+		if (diagnostic.line > 0) lines.push(diagnostic.line);
+		fileLines.set(diagnostic.filePath, lines);
+	}
+	return fileLines;
 };
-const printDiagnostics = (diagnostics) => {
+const printDiagnostics = (diagnostics, isVerbose) => {
 	const sortedRuleGroups = sortBySeverity([...groupBy(diagnostics, (diagnostic) => `${diagnostic.plugin}/${diagnostic.rule}`).entries()]);
 	for (const [, ruleDiagnostics] of sortedRuleGroups) {
 		const firstDiagnostic = ruleDiagnostics[0];
@@ -795,31 +893,23 @@ const printDiagnostics = (diagnostics) => {
 		const countLabel = count > 1 ? ` (${count})` : "";
 		logger.log(`  ${icon} ${firstDiagnostic.message}${countLabel}`);
 		if (firstDiagnostic.help) logger.dim(`    ${firstDiagnostic.help}`);
-		const fileLines = /* @__PURE__ */ new Map();
-		for (const diagnostic of ruleDiagnostics) {
-			const lines = fileLines.get(diagnostic.filePath) ?? [];
-			if (diagnostic.line > 0) lines.push(diagnostic.line);
-			fileLines.set(diagnostic.filePath, lines);
-		}
-		for (const [filePath, lines] of fileLines) {
-			const lineLabel = lines.length > 0 ? `: ${lines.join(", ")}` : "";
-			logger.dim(`    ${filePath}${lineLabel}`);
+		if (isVerbose) {
+			const fileLines = buildFileLineMap(ruleDiagnostics);
+			for (const [filePath, lines] of fileLines) {
+				const lineLabel = lines.length > 0 ? `: ${lines.join(", ")}` : "";
+				logger.dim(`    ${filePath}${lineLabel}`);
+			}
 		}
 		logger.break();
 	}
 };
 const formatElapsedTime = (elapsedMilliseconds) => {
-	if (elapsedMilliseconds < 1e3) return `${Math.round(elapsedMilliseconds)}ms`;
-	return `${(elapsedMilliseconds / 1e3).toFixed(1)}s`;
+	if (elapsedMilliseconds < MILLISECONDS_PER_SECOND) return `${Math.round(elapsedMilliseconds)}ms`;
+	return `${(elapsedMilliseconds / MILLISECONDS_PER_SECOND).toFixed(1)}s`;
 };
 const formatRuleSummary = (ruleKey, ruleDiagnostics) => {
 	const firstDiagnostic = ruleDiagnostics[0];
-	const fileLines = /* @__PURE__ */ new Map();
-	for (const diagnostic of ruleDiagnostics) {
-		const lines = fileLines.get(diagnostic.filePath) ?? [];
-		if (diagnostic.line > 0) lines.push(diagnostic.line);
-		fileLines.set(diagnostic.filePath, lines);
-	}
+	const fileLines = buildFileLineMap(ruleDiagnostics);
 	const sections = [
 		`Rule: ${ruleKey}`,
 		`Severity: ${firstDiagnostic.severity}`,
@@ -844,57 +934,133 @@ const writeDiagnosticsDirectory = (diagnostics) => {
 	writeFileSync(join(outputDirectory, "diagnostics.json"), JSON.stringify(diagnostics, null, 2));
 	return outputDirectory;
 };
-const printSummary = (diagnostics, elapsedMilliseconds) => {
+const colorizeByScore = (text, score) => {
+	if (score >= SCORE_GOOD_THRESHOLD) return highlighter.success(text);
+	if (score >= SCORE_OK_THRESHOLD) return highlighter.warn(text);
+	return highlighter.error(text);
+};
+const buildScoreBar = (score) => {
+	const filledCount = Math.round(score / PERFECT_SCORE * SCORE_BAR_WIDTH_CHARS);
+	const emptyCount = SCORE_BAR_WIDTH_CHARS - filledCount;
+	const filled = "█".repeat(filledCount);
+	const empty = "░".repeat(emptyCount);
+	return colorizeByScore(filled, score) + highlighter.dim(empty);
+};
+const printScoreGauge = (score, label) => {
+	const scoreDisplay = colorizeByScore(`${score}`, score);
+	const labelDisplay = colorizeByScore(label, score);
+	logger.log(`  ${scoreDisplay} / ${PERFECT_SCORE}  ${labelDisplay}`);
+	logger.break();
+	logger.log(`  ${buildScoreBar(score)}`);
+	logger.break();
+};
+const getDoctorFace = (score) => {
+	if (score >= SCORE_GOOD_THRESHOLD) return ["◠ ◠", " ▽ "];
+	if (score >= SCORE_OK_THRESHOLD) return ["• •", " ─ "];
+	return ["x x", " ▽ "];
+};
+const printBranding = (score) => {
+	if (score !== void 0) {
+		const [eyes, mouth] = getDoctorFace(score);
+		const colorize = (text) => colorizeByScore(text, score);
+		logger.log(colorize("  ┌─────┐"));
+		logger.log(colorize(`  │ ${eyes} │`));
+		logger.log(colorize(`  │ ${mouth} │`));
+		logger.log(colorize("  └─────┘"));
+	}
+	logger.log(`  React Doctor ${highlighter.dim("(www.react.doctor)")}`);
+	logger.break();
+};
+const printSummary = (diagnostics, elapsedMilliseconds, scoreResult) => {
 	const errorCount = diagnostics.filter((diagnostic) => diagnostic.severity === "error").length;
 	const warningCount = diagnostics.filter((diagnostic) => diagnostic.severity === "warning").length;
 	const affectedFileCount = collectAffectedFiles(diagnostics).size;
 	const elapsed = formatElapsedTime(elapsedMilliseconds);
 	logger.log("─".repeat(SEPARATOR_LENGTH_CHARS));
 	logger.break();
+	printBranding(scoreResult?.score);
+	if (scoreResult) printScoreGauge(scoreResult.score, scoreResult.label);
+	else {
+		logger.dim(`  ${OFFLINE_MESSAGE}`);
+		logger.break();
+	}
 	const parts = [];
 	if (errorCount > 0) parts.push(highlighter.error(`${errorCount} error${errorCount === 1 ? "" : "s"}`));
 	if (warningCount > 0) parts.push(highlighter.warn(`${warningCount} warning${warningCount === 1 ? "" : "s"}`));
 	parts.push(highlighter.dim(`across ${affectedFileCount} file${affectedFileCount === 1 ? "" : "s"}`));
 	parts.push(highlighter.dim(`in ${elapsed}`));
-	logger.log(parts.join("  "));
-	const diagnosticsDirectory = writeDiagnosticsDirectory(diagnostics);
-	logger.break();
-	logger.dim(`Full diagnostics written to ${diagnosticsDirectory}`);
+	logger.log(`  ${parts.join("  ")}`);
+	try {
+		const diagnosticsDirectory = writeDiagnosticsDirectory(diagnostics);
+		logger.break();
+		logger.dim(`  Full diagnostics written to ${diagnosticsDirectory}`);
+	} catch {
+		logger.break();
+	}
 };
 const scan = async (directory, options) => {
 	const startTime = performance.now();
 	const projectInfo = discoverProject(directory);
 	if (!projectInfo.reactVersion) throw new Error("No React dependency found in package.json");
-	const frameworkLabel = formatFrameworkName(projectInfo.framework);
-	const languageLabel = projectInfo.hasTypeScript ? "TypeScript" : "JavaScript";
-	const completeStep = (message) => {
-		spinner(message).start().succeed(message);
-	};
-	completeStep(`Detecting framework. Found ${highlighter.info(frameworkLabel)}.`);
-	completeStep(`Detecting React version. Found ${highlighter.info(`React ${projectInfo.reactVersion}`)}.`);
-	completeStep(`Detecting language. Found ${highlighter.info(languageLabel)}.`);
-	completeStep(`Detecting React Compiler. ${projectInfo.hasReactCompiler ? highlighter.info("Found React Compiler.") : "Not found."}`);
-	completeStep(`Found ${highlighter.info(`${projectInfo.sourceFileCount}`)} source files.`);
-	logger.break();
-	const diagnostics = [];
-	if (options.lint) {
-		const lintSpinner = spinner("Running lint checks...").start();
-		diagnostics.push(...await runOxlint(directory, projectInfo.hasTypeScript, projectInfo.framework, projectInfo.hasReactCompiler));
-		lintSpinner.succeed("Running lint checks.");
-	}
-	if (options.deadCode) {
-		const deadCodeSpinner = spinner("Detecting dead code...").start();
-		diagnostics.push(...await runKnip(directory));
-		deadCodeSpinner.succeed("Detecting dead code.");
+	if (!options.scoreOnly) {
+		const frameworkLabel = formatFrameworkName(projectInfo.framework);
+		const languageLabel = projectInfo.hasTypeScript ? "TypeScript" : "JavaScript";
+		const completeStep = (message) => {
+			spinner(message).start().succeed(message);
+		};
+		completeStep(`Detecting framework. Found ${highlighter.info(frameworkLabel)}.`);
+		completeStep(`Detecting React version. Found ${highlighter.info(`React ${projectInfo.reactVersion}`)}.`);
+		completeStep(`Detecting language. Found ${highlighter.info(languageLabel)}.`);
+		completeStep(`Detecting React Compiler. ${projectInfo.hasReactCompiler ? highlighter.info("Found React Compiler.") : "Not found."}`);
+		completeStep(`Found ${highlighter.info(`${projectInfo.sourceFileCount}`)} source files.`);
+		logger.break();
 	}
-	diagnostics.push(...checkReducedMotion(directory));
+	const lintPromise = options.lint ? (async () => {
+		const lintSpinner = options.scoreOnly ? null : spinner("Running lint checks...").start();
+		try {
+			const lintDiagnostics = await runOxlint(directory, projectInfo.hasTypeScript, projectInfo.framework, projectInfo.hasReactCompiler);
+			lintSpinner?.succeed("Running lint checks.");
+			return lintDiagnostics;
+		} catch {
+			lintSpinner?.fail("Lint checks failed (non-fatal, skipping).");
+			return [];
+		}
+	})() : Promise.resolve([]);
+	const deadCodePromise = options.deadCode ? (async () => {
+		const deadCodeSpinner = options.scoreOnly ? null : spinner("Detecting dead code...").start();
+		try {
+			const knipDiagnostics = await runKnip(directory);
+			deadCodeSpinner?.succeed("Detecting dead code.");
+			return knipDiagnostics;
+		} catch {
+			deadCodeSpinner?.fail("Dead code detection failed (non-fatal, skipping).");
+			return [];
+		}
+	})() : Promise.resolve([]);
+	const [lintDiagnostics, deadCodeDiagnostics] = await Promise.all([lintPromise, deadCodePromise]);
+	const diagnostics = [
+		...lintDiagnostics,
+		...deadCodeDiagnostics,
+		...checkReducedMotion(directory)
+	];
 	const elapsedMilliseconds = performance.now() - startTime;
+	const scoreResult = await calculateScore(diagnostics);
+	if (options.scoreOnly) {
+		if (scoreResult) logger.log(`${scoreResult.score}`);
+		else logger.dim(OFFLINE_MESSAGE);
+		return;
+	}
 	if (diagnostics.length === 0) {
 		logger.success("No issues found!");
+		logger.break();
+		if (scoreResult) {
+			printBranding(scoreResult.score);
+			printScoreGauge(scoreResult.score, scoreResult.label);
+		} else logger.dim(`  ${OFFLINE_MESSAGE}`);
 		return;
 	}
-	printDiagnostics(diagnostics);
-	printSummary(diagnostics, elapsedMilliseconds);
+	printDiagnostics(diagnostics, options.verbose);
+	printSummary(diagnostics, elapsedMilliseconds, scoreResult);
 };
 
 //#endregion
@@ -911,11 +1077,16 @@ const prompts = (questions) => {
 
 //#endregion
 //#region src/utils/select-projects.ts
-const selectProjects = async (rootDirectory, projectFlag) => {
-	const workspacePackages = listWorkspacePackages(rootDirectory);
-	if (workspacePackages.length === 0) return [rootDirectory];
-	if (projectFlag) return resolveProjectFlag(projectFlag, workspacePackages);
-	return promptProjectSelection(workspacePackages, rootDirectory);
+const selectProjects = async (rootDirectory, projectFlag, skipPrompts) => {
+	let packages = listWorkspacePackages(rootDirectory);
+	if (packages.length === 0) packages = discoverReactSubprojects(rootDirectory);
+	if (packages.length === 0) return [rootDirectory];
+	if (projectFlag) return resolveProjectFlag(projectFlag, packages);
+	if (skipPrompts) {
+		printDiscoveredProjects(packages);
+		process.exit(0);
+	}
+	return promptProjectSelection(packages, rootDirectory);
 };
 const resolveProjectFlag = (projectFlag, workspacePackages) => {
 	const requestedNames = projectFlag.split(",").map((name) => name.trim());
@@ -930,6 +1101,15 @@ const resolveProjectFlag = (projectFlag, workspacePackages) => {
 	}
 	return resolvedDirectories;
 };
+const printDiscoveredProjects = (packages) => {
+	logger.log(`${highlighter.success("✔")} Found ${highlighter.info(`${packages.length}`)} React projects:`);
+	logger.break();
+	for (const workspacePackage of packages) logger.log(`  ${highlighter.dim("─")} ${workspacePackage.directory}`);
+	logger.break();
+	logger.dim(`Run with a specific path to scan a project:`);
+	logger.dim(`  npx -y react-doctor@latest <path>`);
+	logger.break();
+};
 const promptProjectSelection = async (workspacePackages, rootDirectory) => {
 	const { selectedDirectories } = await prompts({
 		type: "multiselect",
@@ -947,25 +1127,34 @@ const promptProjectSelection = async (workspacePackages, rootDirectory) => {
 
 //#endregion
 //#region src/cli.ts
-const VERSION = "0.0.4";
+const VERSION = "0.0.6";
 process.on("SIGINT", () => process.exit(0));
 process.on("SIGTERM", () => process.exit(0));
-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("--project <name>", "select workspace project (comma-separated for multiple)").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("--fix", "open Ami to auto-fix all issues").action(async (directory, flags) => {
 	try {
 		const resolvedDirectory = path.resolve(directory);
-		logger.log(`react-doctor v${VERSION}`);
-		logger.break();
+		const isScoreOnly = flags.score;
+		if (!isScoreOnly) {
+			logger.log(`react-doctor v${VERSION}`);
+			logger.break();
+		}
 		const scanOptions = {
 			lint: flags.lint,
-			deadCode: flags.deadCode
+			deadCode: flags.deadCode,
+			verbose: Boolean(flags.verbose),
+			scoreOnly: isScoreOnly
 		};
-		const projectDirectories = await selectProjects(resolvedDirectory, flags.project);
+		const shouldSkipPrompts = flags.yes || Boolean(process.env.CI) || Boolean(process.env.CLAUDECODE) || Boolean(process.env.AMI) || !process.stdin.isTTY;
+		const projectDirectories = await selectProjects(resolvedDirectory, flags.project, shouldSkipPrompts);
 		for (const projectDirectory of projectDirectories) {
-			logger.dim(`Scanning ${projectDirectory}...`);
-			logger.break();
+			if (!isScoreOnly) {
+				logger.dim(`Scanning ${projectDirectory}...`);
+				logger.break();
+			}
 			await scan(projectDirectory, scanOptions);
-			logger.break();
+			if (!isScoreOnly) logger.break();
 		}
+		if (flags.fix) openAmiToFix(resolvedDirectory);
 	} catch (error) {
 		handleError(error);
 	}
@@ -973,6 +1162,55 @@ const program = new Command().name("react-doctor").description("Diagnose React c
 ${highlighter.dim("Learn more:")}
   ${highlighter.info("https://github.com/aidenybai/react-doctor")}
 `);
+const AMI_INSTALL_URL = "https://ami.dev/install.sh";
+const AMI_FIX_PROMPT = "Run npx -y react-doctor@latest . --verbose, read every diagnostic, then fix all issues one by one. After fixing, re-run react-doctor to verify the score improved.";
+const buildAmiDeeplink = (projectDirectory) => {
+	return `ami://new-chat?cwd=${encodeURIComponent(projectDirectory)}&prompt=${encodeURIComponent(AMI_FIX_PROMPT)}&mode=agent`;
+};
+const isAmiInstalled = () => {
+	try {
+		execSync("ls /Applications/Ami.app", { stdio: "ignore" });
+		return true;
+	} catch {
+		return false;
+	}
+};
+const installAmi = () => {
+	logger.log("Ami not found. Installing...");
+	logger.break();
+	try {
+		execSync(`curl -fsSL ${AMI_INSTALL_URL} | bash`, { stdio: "inherit" });
+	} catch {
+		logger.error("Failed to install Ami. Visit https://ami.dev to install manually.");
+		process.exit(1);
+	}
+	logger.break();
+};
+const openAmiToFix = (directory) => {
+	const resolvedDirectory = path.resolve(directory);
+	if (!isAmiInstalled()) installAmi();
+	logger.log("Opening Ami to fix react-doctor issues...");
+	const deeplink = buildAmiDeeplink(resolvedDirectory);
+	try {
+		execSync(`open "${deeplink}"`, { stdio: "ignore" });
+		logger.success("Opened Ami with react-doctor fix prompt.");
+	} catch {
+		logger.break();
+		logger.dim("Could not open Ami automatically. Open this URL manually:");
+		logger.info(deeplink);
+	}
+};
+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("Open Ami to auto-fix react-doctor issues").argument("[directory]", "project directory", ".").action(fixAction);
+program.addCommand(fixCommand);
+program.addCommand(installAmiCommand);
 const main$1 = async () => {
 	await program.parseAsync();
 };