react-doctor 0.0.7 → 0.0.9

package/dist/cli.js

@@ -14,6 +14,23 @@ import { fileURLToPath } from "node:url";
 import ora from "ora";
 import basePrompts from "prompts";
 
+//#region src/constants.ts
+const SOURCE_FILE_PATTERN = /\.(tsx?|jsx?)$/;
+const JSX_FILE_PATTERN = /\.(tsx|jsx)$/;
+const MILLISECONDS_PER_SECOND = 1e3;
+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 SEPARATOR_LENGTH_CHARS = 40;
+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 SHARE_BASE_URL = "https://www.react.doctor/share";
+const OFFLINE_MESSAGE = "You are offline, could not calculate score. Reconnect to calculate.";
+
+//#endregion
 //#region src/utils/highlighter.ts
 const highlighter = {
 	error: pc.red,
@@ -23,58 +40,74 @@ const highlighter = {
 	dim: pc.dim
 };
 
+//#endregion
+//#region src/utils/strip-ansi.ts
+const ANSI_ESCAPE_SEQUENCE = String.raw`\u001B\[[0-9;]*m`;
+const ANSI_ESCAPE_PATTERN = new RegExp(ANSI_ESCAPE_SEQUENCE, "g");
+const stripAnsi = (text) => text.replace(ANSI_ESCAPE_PATTERN, "");
+
 //#endregion
 //#region src/utils/logger.ts
+const loggerCaptureState = {
+	isEnabled: false,
+	lines: []
+};
+const captureLogLine = (text) => {
+	if (!loggerCaptureState.isEnabled) return;
+	loggerCaptureState.lines.push(stripAnsi(text));
+};
+const writeLogLine = (text) => {
+	console.log(text);
+	captureLogLine(text);
+};
+const startLoggerCapture = () => {
+	loggerCaptureState.isEnabled = true;
+	loggerCaptureState.lines = [];
+};
+const stopLoggerCapture = () => {
+	const capturedOutput = loggerCaptureState.lines.join("\n");
+	loggerCaptureState.isEnabled = false;
+	loggerCaptureState.lines = [];
+	return capturedOutput;
+};
 const logger = {
 	error(...args) {
-		console.log(highlighter.error(args.join(" ")));
+		writeLogLine(highlighter.error(args.join(" ")));
 	},
 	warn(...args) {
-		console.log(highlighter.warn(args.join(" ")));
+		writeLogLine(highlighter.warn(args.join(" ")));
 	},
 	info(...args) {
-		console.log(highlighter.info(args.join(" ")));
+		writeLogLine(highlighter.info(args.join(" ")));
 	},
 	success(...args) {
-		console.log(highlighter.success(args.join(" ")));
+		writeLogLine(highlighter.success(args.join(" ")));
 	},
 	dim(...args) {
-		console.log(highlighter.dim(args.join(" ")));
+		writeLogLine(highlighter.dim(args.join(" ")));
 	},
 	log(...args) {
-		console.log(args.join(" "));
+		writeLogLine(args.join(" "));
 	},
 	break() {
-		console.log("");
+		writeLogLine("");
 	}
 };
 
 //#endregion
 //#region src/utils/handle-error.ts
-const handleError = (error) => {
+const DEFAULT_HANDLE_ERROR_OPTIONS = { shouldExit: true };
+const handleError = (error, options = DEFAULT_HANDLE_ERROR_OPTIONS) => {
 	logger.break();
 	logger.error("Something went wrong. Please check the error below for more details.");
 	logger.error("If the problem persists, please open an issue on GitHub.");
 	logger.error("");
 	if (error instanceof Error) logger.error(error.message);
 	logger.break();
-	process.exit(1);
+	if (options.shouldExit) process.exit(1);
+	process.exitCode = 1;
 };
 
-//#endregion
-//#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) => {
@@ -325,11 +358,13 @@ const discoverProject = (directory) => {
 		if (!reactVersion) reactVersion = ancestorInfo.reactVersion;
 		if (framework === "unknown") framework = ancestorInfo.framework;
 	}
+	const projectName = packageJson.name ?? path.basename(directory);
 	const hasTypeScript = fs.existsSync(path.join(directory, "tsconfig.json"));
 	const sourceFileCount = countSourceFiles(directory);
 	const hasReactCompiler = detectReactCompiler(directory, packageJson);
 	return {
 		rootDirectory: directory,
+		projectName,
 		reactVersion,
 		framework,
 		hasTypeScript,
@@ -448,12 +483,45 @@ const silenced = async (fn) => {
 		console.warn = originalWarn;
 	}
 };
-const runKnip = async (rootDirectory) => {
+const findMonorepoRoot = (directory) => {
+	let currentDirectory = path.dirname(directory);
+	while (currentDirectory !== path.dirname(currentDirectory)) {
+		if (fs.existsSync(path.join(currentDirectory, "pnpm-workspace.yaml")) || (() => {
+			const packageJsonPath = path.join(currentDirectory, "package.json");
+			if (!fs.existsSync(packageJsonPath)) return false;
+			const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
+			return Array.isArray(packageJson.workspaces) || packageJson.workspaces?.packages;
+		})()) return currentDirectory;
+		currentDirectory = path.dirname(currentDirectory);
+	}
+	return null;
+};
+const runKnipWithOptions = async (knipCwd, workspaceName) => {
 	const options = await silenced(() => createOptions({
-		cwd: rootDirectory,
-		isShowProgress: false
+		cwd: knipCwd,
+		isShowProgress: false,
+		...workspaceName ? { workspace: workspaceName } : {}
 	}));
-	const { issues } = await silenced(() => main(options));
+	return await silenced(() => main(options));
+};
+const hasNodeModules = (directory) => {
+	const nodeModulesPath = path.join(directory, "node_modules");
+	return fs.existsSync(nodeModulesPath) && fs.statSync(nodeModulesPath).isDirectory();
+};
+const runKnip = async (rootDirectory) => {
+	const monorepoRoot = findMonorepoRoot(rootDirectory);
+	if (!(hasNodeModules(rootDirectory) || monorepoRoot !== null && hasNodeModules(monorepoRoot))) return [];
+	let knipResult;
+	if (monorepoRoot) {
+		const packageJsonPath = path.join(rootDirectory, "package.json");
+		const workspaceName = (fs.existsSync(packageJsonPath) ? JSON.parse(fs.readFileSync(packageJsonPath, "utf-8")) : {}).name ?? path.basename(rootDirectory);
+		try {
+			knipResult = await runKnipWithOptions(monorepoRoot, workspaceName);
+		} catch {
+			knipResult = await runKnipWithOptions(rootDirectory);
+		}
+	} else knipResult = await runKnipWithOptions(rootDirectory);
+	const { issues } = knipResult;
 	const diagnostics = [];
 	for (const unusedFile of issues.files) diagnostics.push({
 		filePath: path.relative(rootDirectory, unusedFile),
@@ -482,7 +550,7 @@ const NEXTJS_RULES = {
 	"react-doctor/nextjs-no-img-element": "warn",
 	"react-doctor/nextjs-async-client-component": "error",
 	"react-doctor/nextjs-no-a-element": "warn",
-	"react-doctor/nextjs-no-use-search-params-without-suspense": "error",
+	"react-doctor/nextjs-no-use-search-params-without-suspense": "warn",
 	"react-doctor/nextjs-no-client-fetch-for-server-data": "warn",
 	"react-doctor/nextjs-missing-metadata": "warn",
 	"react-doctor/nextjs-no-client-side-redirect": "warn",
@@ -514,12 +582,6 @@ const REACT_COMPILER_RULES = {
 	"react-hooks-js/incompatible-library": "error",
 	"react-hooks-js/todo": "error"
 };
-const REACT_PERF_RULES = {
-	"react-perf/jsx-no-new-object-as-prop": "warn",
-	"react-perf/jsx-no-new-array-as-prop": "warn",
-	"react-perf/jsx-no-new-function-as-prop": "warn",
-	"react-perf/jsx-no-jsx-as-prop": "warn"
-};
 const createOxlintConfig = ({ pluginPath, framework, hasReactCompiler }) => ({
 	categories: {
 		correctness: "off",
@@ -549,7 +611,6 @@ const createOxlintConfig = ({ pluginPath, framework, hasReactCompiler }) => ({
 		"react/jsx-no-script-url": "error",
 		"react/no-render-return-value": "warn",
 		"react/no-string-refs": "warn",
-		"react/no-unescaped-entities": "warn",
 		"react/no-is-mounted": "warn",
 		"react/require-render-return": "error",
 		"react/no-unknown-property": "warn",
@@ -568,7 +629,7 @@ const createOxlintConfig = ({ pluginPath, framework, hasReactCompiler }) => ({
 		"jsx-a11y/label-has-associated-control": "warn",
 		"jsx-a11y/no-distracting-elements": "error",
 		"jsx-a11y/iframe-has-title": "warn",
-		...hasReactCompiler ? REACT_COMPILER_RULES : REACT_PERF_RULES,
+		...hasReactCompiler ? REACT_COMPILER_RULES : {},
 		"react-doctor/no-derived-state-effect": "error",
 		"react-doctor/no-fetch-in-effect": "error",
 		"react-doctor/no-cascading-set-state": "warn",
@@ -578,7 +639,6 @@ const createOxlintConfig = ({ pluginPath, framework, hasReactCompiler }) => ({
 		"react-doctor/rerender-lazy-state-init": "warn",
 		"react-doctor/rerender-functional-setstate": "warn",
 		"react-doctor/rerender-dependencies": "error",
-		"react-doctor/no-generic-handler-names": "warn",
 		"react-doctor/no-giant-component": "warn",
 		"react-doctor/no-render-in-render": "warn",
 		"react-doctor/no-nested-component-definition": "error",
@@ -586,7 +646,7 @@ const createOxlintConfig = ({ pluginPath, framework, hasReactCompiler }) => ({
 		"react-doctor/no-layout-property-animation": "error",
 		"react-doctor/rerender-memo-with-default-value": "warn",
 		"react-doctor/rendering-animate-svg-wrapper": "warn",
-		"react-doctor/rendering-usetransition-loading": "warn",
+		"react-doctor/no-inline-prop-on-memo-component": "warn",
 		"react-doctor/rendering-hydration-no-flicker": "warn",
 		"react-doctor/no-transition-all": "warn",
 		"react-doctor/no-global-css-variable-animation": "error",
@@ -868,12 +928,17 @@ const spinner = (text) => ({ start() {
 	};
 } });
 
+//#endregion
+//#region src/utils/indent-multiline-text.ts
+const indentMultilineText = (text, linePrefix) => text.split("\n").map((lineText) => `${linePrefix}${lineText}`).join("\n");
+
 //#endregion
 //#region src/scan.ts
 const SEVERITY_ORDER = {
 	error: 0,
 	warning: 1
 };
+const colorizeBySeverity = (text, severity) => severity === "error" ? highlighter.error(text) : highlighter.warn(text);
 const sortBySeverity = (diagnosticGroups) => diagnosticGroups.toSorted(([, diagnosticsA], [, diagnosticsB]) => {
 	return SEVERITY_ORDER[diagnosticsA[0].severity] - SEVERITY_ORDER[diagnosticsB[0].severity];
 });
@@ -891,11 +956,11 @@ const printDiagnostics = (diagnostics, isVerbose) => {
 	const sortedRuleGroups = sortBySeverity([...groupBy(diagnostics, (diagnostic) => `${diagnostic.plugin}/${diagnostic.rule}`).entries()]);
 	for (const [, ruleDiagnostics] of sortedRuleGroups) {
 		const firstDiagnostic = ruleDiagnostics[0];
-		const icon = firstDiagnostic.severity === "error" ? highlighter.error("✗") : highlighter.warn("⚠");
+		const icon = colorizeBySeverity(firstDiagnostic.severity === "error" ? "✗" : "⚠", firstDiagnostic.severity);
 		const count = ruleDiagnostics.length;
-		const countLabel = count > 1 ? ` (${count})` : "";
+		const countLabel = count > 1 ? colorizeBySeverity(` (${count})`, firstDiagnostic.severity) : "";
 		logger.log(`  ${icon} ${firstDiagnostic.message}${countLabel}`);
-		if (firstDiagnostic.help) logger.dim(`    ${firstDiagnostic.help}`);
+		if (firstDiagnostic.help) logger.dim(indentMultilineText(firstDiagnostic.help, "    "));
 		if (isVerbose) {
 			const fileLines = buildFileLineMap(ruleDiagnostics);
 			for (const [filePath, lines] of fileLines) {
@@ -942,12 +1007,39 @@ const colorizeByScore = (text, score) => {
 	if (score >= SCORE_OK_THRESHOLD) return highlighter.warn(text);
 	return highlighter.error(text);
 };
-const buildScoreBar = (score) => {
+const createFramedLine = (plainText, renderedText = plainText) => ({
+	plainText,
+	renderedText
+});
+const buildScoreBarSegments = (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);
+	return {
+		filledSegment: "█".repeat(filledCount),
+		emptySegment: "░".repeat(emptyCount)
+	};
+};
+const buildPlainScoreBar = (score) => {
+	const { filledSegment, emptySegment } = buildScoreBarSegments(score);
+	return `${filledSegment}${emptySegment}`;
+};
+const buildScoreBar = (score) => {
+	const { filledSegment, emptySegment } = buildScoreBarSegments(score);
+	return colorizeByScore(filledSegment, score) + highlighter.dim(emptySegment);
+};
+const printFramedBox = (framedLines) => {
+	if (framedLines.length === 0) return;
+	const borderColorizer = highlighter.dim;
+	const outerIndent = " ".repeat(SUMMARY_BOX_OUTER_INDENT_CHARS);
+	const horizontalPadding = " ".repeat(SUMMARY_BOX_HORIZONTAL_PADDING_CHARS);
+	const maximumLineLength = Math.max(...framedLines.map((framedLine) => framedLine.plainText.length));
+	const borderLine = "─".repeat(maximumLineLength + SUMMARY_BOX_HORIZONTAL_PADDING_CHARS * 2);
+	logger.log(`${outerIndent}${borderColorizer(`┌${borderLine}┐`)}`);
+	for (const framedLine of framedLines) {
+		const trailingSpaces = " ".repeat(maximumLineLength - framedLine.plainText.length);
+		logger.log(`${outerIndent}${borderColorizer("│")}${horizontalPadding}${framedLine.renderedText}${trailingSpaces}${horizontalPadding}${borderColorizer("│")}`);
+	}
+	logger.log(`${outerIndent}${borderColorizer(`└${borderLine}┘`)}`);
 };
 const printScoreGauge = (score, label) => {
 	const scoreDisplay = colorizeByScore(`${score}`, score);
@@ -974,25 +1066,65 @@ const printBranding = (score) => {
 	logger.log(`  React Doctor ${highlighter.dim("(www.react.doctor)")}`);
 	logger.break();
 };
-const printSummary = (diagnostics, elapsedMilliseconds, scoreResult) => {
+const buildShareUrl = (diagnostics, scoreResult, projectName) => {
+	const errorCount = diagnostics.filter((diagnostic) => diagnostic.severity === "error").length;
+	const warningCount = diagnostics.filter((diagnostic) => diagnostic.severity === "warning").length;
+	const affectedFileCount = collectAffectedFiles(diagnostics).size;
+	const params = new URLSearchParams();
+	params.set("p", projectName);
+	if (scoreResult) params.set("s", String(scoreResult.score));
+	if (errorCount > 0) params.set("e", String(errorCount));
+	if (warningCount > 0) params.set("w", String(warningCount));
+	if (affectedFileCount > 0) params.set("f", String(affectedFileCount));
+	return `${SHARE_BASE_URL}?${params.toString()}`;
+};
+const printSummary = (diagnostics, elapsedMilliseconds, scoreResult, projectName) => {
 	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 summaryLineParts = [];
+	const summaryLinePartsPlain = [];
+	if (errorCount > 0) {
+		const errorText = `✗ ${errorCount} error${errorCount === 1 ? "" : "s"}`;
+		summaryLinePartsPlain.push(errorText);
+		summaryLineParts.push(highlighter.error(errorText));
 	}
-	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("  ")}`);
+	if (warningCount > 0) {
+		const warningText = `⚠ ${warningCount} warning${warningCount === 1 ? "" : "s"}`;
+		summaryLinePartsPlain.push(warningText);
+		summaryLineParts.push(highlighter.warn(warningText));
+	}
+	const fileCountText = `across ${affectedFileCount} file${affectedFileCount === 1 ? "" : "s"}`;
+	const elapsedTimeText = `in ${elapsed}`;
+	summaryLinePartsPlain.push(fileCountText);
+	summaryLinePartsPlain.push(elapsedTimeText);
+	summaryLineParts.push(highlighter.dim(fileCountText));
+	summaryLineParts.push(highlighter.dim(elapsedTimeText));
+	const summaryFramedLines = [];
+	if (scoreResult) {
+		const [eyes, mouth] = getDoctorFace(scoreResult.score);
+		const scoreColorizer = (text) => colorizeByScore(text, scoreResult.score);
+		summaryFramedLines.push(createFramedLine("┌─────┐", scoreColorizer("┌─────┐")));
+		summaryFramedLines.push(createFramedLine(`│ ${eyes} │`, scoreColorizer(`│ ${eyes} │`)));
+		summaryFramedLines.push(createFramedLine(`│ ${mouth} │`, scoreColorizer(`│ ${mouth} │`)));
+		summaryFramedLines.push(createFramedLine("└─────┘", scoreColorizer("└─────┘")));
+		summaryFramedLines.push(createFramedLine("React Doctor (www.react.doctor)", `React Doctor ${highlighter.dim("(www.react.doctor)")}`));
+		summaryFramedLines.push(createFramedLine(""));
+		const scoreLinePlainText = `${scoreResult.score} / ${PERFECT_SCORE}  ${scoreResult.label}`;
+		const scoreLineRenderedText = `${colorizeByScore(String(scoreResult.score), scoreResult.score)} / ${PERFECT_SCORE}  ${colorizeByScore(scoreResult.label, scoreResult.score)}`;
+		summaryFramedLines.push(createFramedLine(scoreLinePlainText, scoreLineRenderedText));
+		summaryFramedLines.push(createFramedLine(""));
+		summaryFramedLines.push(createFramedLine(buildPlainScoreBar(scoreResult.score), buildScoreBar(scoreResult.score)));
+		summaryFramedLines.push(createFramedLine(""));
+	} else {
+		summaryFramedLines.push(createFramedLine("React Doctor (www.react.doctor)", `React Doctor ${highlighter.dim("(www.react.doctor)")}`));
+		summaryFramedLines.push(createFramedLine(""));
+		summaryFramedLines.push(createFramedLine(OFFLINE_MESSAGE, highlighter.dim(OFFLINE_MESSAGE)));
+		summaryFramedLines.push(createFramedLine(""));
+	}
+	summaryFramedLines.push(createFramedLine(summaryLinePartsPlain.join("  "), summaryLineParts.join("  ")));
+	printFramedBox(summaryFramedLines);
 	try {
 		const diagnosticsDirectory = writeDiagnosticsDirectory(diagnostics);
 		logger.break();
@@ -1000,6 +1132,9 @@ const printSummary = (diagnostics, elapsedMilliseconds, scoreResult) => {
 	} catch {
 		logger.break();
 	}
+	const shareUrl = buildShareUrl(diagnostics, scoreResult, projectName);
+	logger.break();
+	logger.dim(`  Share your results: ${highlighter.info(shareUrl)}`);
 };
 const scan = async (directory, options) => {
 	const startTime = performance.now();
@@ -1063,18 +1198,46 @@ const scan = async (directory, options) => {
 		return;
 	}
 	printDiagnostics(diagnostics, options.verbose);
-	printSummary(diagnostics, elapsedMilliseconds, scoreResult);
+	printSummary(diagnostics, elapsedMilliseconds, scoreResult, projectInfo.projectName);
+};
+
+//#endregion
+//#region src/utils/should-select-all-choices.ts
+const shouldSelectAllChoices = (choiceStates) => {
+	return choiceStates.filter((choiceState) => !choiceState.disabled).some((choiceState) => choiceState.selected !== true);
 };
 
 //#endregion
 //#region src/utils/prompts.ts
+const require = createRequire(import.meta.url);
+const PROMPTS_MULTISELECT_MODULE_PATH = "prompts/lib/elements/multiselect";
+let didPatchMultiselectToggleAll = false;
 const onCancel = () => {
 	logger.break();
 	logger.log("Cancelled.");
 	logger.break();
 	process.exit(0);
 };
+const patchMultiselectToggleAll = () => {
+	if (didPatchMultiselectToggleAll) return;
+	didPatchMultiselectToggleAll = true;
+	const multiselectPromptConstructor = require(PROMPTS_MULTISELECT_MODULE_PATH);
+	multiselectPromptConstructor.prototype.toggleAll = function() {
+		const isCurrentChoiceDisabled = Boolean(this.value[this.cursor]?.disabled);
+		if (this.maxChoices !== void 0 || isCurrentChoiceDisabled) {
+			this.bell();
+			return;
+		}
+		const shouldSelectAllEnabledChoices = shouldSelectAllChoices(this.value);
+		for (const choiceState of this.value) {
+			if (choiceState.disabled) continue;
+			choiceState.selected = shouldSelectAllEnabledChoices;
+		}
+		this.render();
+	};
+};
 const prompts = (questions) => {
+	patchMultiselectToggleAll();
 	return basePrompts(questions, { onCancel });
 };
 
@@ -1084,10 +1247,14 @@ const selectProjects = async (rootDirectory, projectFlag, skipPrompts) => {
 	let packages = listWorkspacePackages(rootDirectory);
 	if (packages.length === 0) packages = discoverReactSubprojects(rootDirectory);
 	if (packages.length === 0) return [rootDirectory];
+	if (packages.length === 1) {
+		logger.log(`${highlighter.success("✔")} Select projects to scan ${highlighter.dim("›")} ${packages[0].name}`);
+		return [packages[0].directory];
+	}
 	if (projectFlag) return resolveProjectFlag(projectFlag, packages);
 	if (skipPrompts) {
 		printDiscoveredProjects(packages);
-		process.exit(0);
+		return packages.map((workspacePackage) => workspacePackage.directory);
 	}
 	return promptProjectSelection(packages, rootDirectory);
 };
@@ -1150,9 +1317,10 @@ const writeConfig = (config) => {
 const installSkill = () => {
 	try {
 		execSync(`npx -y skills add ${SKILL_REPO}`, { stdio: "inherit" });
-		return true;
 	} catch {
-		return false;
+		logger.break();
+		logger.dim("Skill install failed. You can install manually:");
+		logger.dim(`  npx skills add ${SKILL_REPO}`);
 	}
 };
 const maybePromptSkillInstall = async (shouldSkipPrompts) => {
@@ -1160,8 +1328,9 @@ const maybePromptSkillInstall = async (shouldSkipPrompts) => {
 	if (config.skillPromptDismissed) return;
 	if (shouldSkipPrompts) return;
 	logger.break();
-	logger.log(`${highlighter.info("💡")} Install the ${highlighter.info("react-doctor")} skill for your coding agent?`);
-	logger.dim("   Adds React best practices to Cursor, Claude Code, Copilot, and more.");
+	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, Copilot,`);
+	logger.dim("   Ami, and other AI agents how to diagnose and fix these React issues.");
 	logger.break();
 	const { shouldInstall } = await prompts({
 		type: "confirm",
@@ -1171,14 +1340,7 @@ const maybePromptSkillInstall = async (shouldSkipPrompts) => {
 	});
 	if (shouldInstall) {
 		logger.break();
-		if (installSkill()) {
-			logger.break();
-			logger.success("Skill installed!");
-		} else {
-			logger.break();
-			logger.dim("Skill install failed. You can install manually:");
-			logger.dim(`  npx skills add ${SKILL_REPO}`);
-		}
+		installSkill();
 	}
 	writeConfig({
 		...config,
@@ -1186,15 +1348,85 @@ const maybePromptSkillInstall = async (shouldSkipPrompts) => {
 	});
 };
 
+//#endregion
+//#region src/utils/global-install.ts
+const isGloballyInstalled = () => {
+	try {
+		return !execSync("which react-doctor", {
+			stdio: "pipe",
+			encoding: "utf-8"
+		}).trim().includes("/_npx/");
+	} catch {
+		return false;
+	}
+};
+const maybeInstallGlobally = () => {
+	try {
+		if (isGloballyInstalled()) return;
+		const child = spawn("npm", [
+			"install",
+			"-g",
+			"react-doctor@latest"
+		], {
+			detached: true,
+			stdio: "ignore"
+		});
+		child.on("error", () => {});
+		child.unref();
+	} catch {}
+};
+
+//#endregion
+//#region src/utils/copy-to-clipboard.ts
+const getClipboardCommands = () => {
+	if (process.platform === "darwin") return [{
+		command: "pbcopy",
+		args: []
+	}];
+	if (process.platform === "win32") return [{
+		command: "clip",
+		args: []
+	}];
+	return [
+		{
+			command: "wl-copy",
+			args: []
+		},
+		{
+			command: "xclip",
+			args: ["-selection", "clipboard"]
+		},
+		{
+			command: "xsel",
+			args: ["--clipboard", "--input"]
+		}
+	];
+};
+const copyToClipboard = (text) => {
+	const clipboardCommands = getClipboardCommands();
+	for (const clipboardCommand of clipboardCommands) if (spawnSync(clipboardCommand.command, clipboardCommand.args, {
+		input: text,
+		stdio: [
+			"pipe",
+			"ignore",
+			"ignore"
+		],
+		encoding: "utf8"
+	}).status === 0) return true;
+	return false;
+};
+
 //#endregion
 //#region src/cli.ts
-const VERSION = "0.0.7";
+const VERSION = "0.0.9";
 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("--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) => {
+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").option("--prompt", "copy latest scan output to clipboard").action(async (directory, flags) => {
+	const isScoreOnly = flags.score && !flags.prompt;
+	const shouldCopyPromptOutput = flags.prompt;
+	if (shouldCopyPromptOutput) startLoggerCapture();
 	try {
 		const resolvedDirectory = path.resolve(directory);
-		const isScoreOnly = flags.score;
 		if (!isScoreOnly) {
 			logger.log(`react-doctor v${VERSION}`);
 			logger.break();
@@ -1202,10 +1434,20 @@ const program = new Command().name("react-doctor").description("Diagnose React c
 		const scanOptions = {
 			lint: flags.lint,
 			deadCode: flags.deadCode,
-			verbose: Boolean(flags.verbose),
+			verbose: flags.prompt || Boolean(flags.verbose),
 			scoreOnly: isScoreOnly
 		};
-		const shouldSkipPrompts = flags.yes || Boolean(process.env.CI) || Boolean(process.env.CLAUDECODE) || Boolean(process.env.AMI) || !process.stdin.isTTY;
+		const isAutomatedEnvironment = [
+			process.env.CI,
+			process.env.CLAUDECODE,
+			process.env.CURSOR_TRACE_ID,
+			process.env.CURSOR_AGENT,
+			process.env.CODEX_CI,
+			process.env.OPENCODE,
+			process.env.AMP_HOME,
+			process.env.AMI
+		].some(Boolean);
+		const shouldSkipPrompts = flags.yes || isAutomatedEnvironment || !process.stdin.isTTY;
 		const projectDirectories = await selectProjects(resolvedDirectory, flags.project, shouldSkipPrompts);
 		for (const projectDirectory of projectDirectories) {
 			if (!isScoreOnly) {
@@ -1216,17 +1458,23 @@ const program = new Command().name("react-doctor").description("Diagnose React c
 			if (!isScoreOnly) logger.break();
 		}
 		if (flags.fix) openAmiToFix(resolvedDirectory);
-		if (!isScoreOnly) await maybePromptSkillInstall(shouldSkipPrompts);
+		if (!isScoreOnly && !flags.prompt) {
+			await maybePromptSkillInstall(shouldSkipPrompts);
+			if (!shouldSkipPrompts && !flags.fix) await maybePromptAmiFix(resolvedDirectory);
+		}
 	} catch (error) {
-		handleError(error);
+		handleError(error, { shouldExit: !shouldCopyPromptOutput });
+	} finally {
+		if (shouldCopyPromptOutput) copyPromptToClipboard(stopLoggerCapture(), !isScoreOnly);
 	}
 }).addHelpText("after", `
 ${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 OPEN_PROJECT_DELAY_S = 2;
+const FIX_PROMPT = "Fix all issues reported in the react-doctor diagnostics below, one by one. After applying fixes, run `react-dcotor` again to verify the results improved.";
+const REACT_DOCTOR_OUTPUT_LABEL = "react-doctor output";
+const SCAN_SUMMARY_SEPARATOR = "─".repeat(SEPARATOR_LENGTH_CHARS);
 const isAmiInstalled = () => {
 	try {
 		execSync("ls /Applications/Ami.app", { stdio: "ignore" });
@@ -1250,19 +1498,45 @@ const openAmiToFix = (directory) => {
 	const resolvedDirectory = path.resolve(directory);
 	if (!isAmiInstalled()) installAmi();
 	logger.log("Opening Ami to fix react-doctor issues...");
-	const encodedDirectory = encodeURIComponent(resolvedDirectory);
-	const encodedPrompt = encodeURIComponent(AMI_FIX_PROMPT);
-	const openProjectDeeplink = `ami://open-project?cwd=${encodedDirectory}`;
-	const newChatDeeplink = `ami://new-chat?prompt=${encodedPrompt}&mode=agent&send=true`;
+	const deeplink = `ami://open-project?cwd=${encodeURIComponent(resolvedDirectory)}&prompt=${encodeURIComponent(FIX_PROMPT)}&mode=agent`;
 	try {
-		execSync(`open "${openProjectDeeplink}" && sleep ${OPEN_PROJECT_DELAY_S} && open "${newChatDeeplink}"`, { stdio: "ignore" });
+		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 these URLs manually:");
-		logger.info(openProjectDeeplink);
-		logger.info(newChatDeeplink);
+		logger.dim("Could not open Ami automatically. Open this URL manually:");
+		logger.info(deeplink);
+	}
+};
+const buildPromptWithOutput = (reactDoctorOutput) => {
+	const summaryStartIndex = reactDoctorOutput.indexOf(SCAN_SUMMARY_SEPARATOR);
+	const normalizedReactDoctorOutput = (summaryStartIndex === -1 ? reactDoctorOutput : reactDoctorOutput.slice(0, summaryStartIndex).trimEnd()).trim();
+	return `${FIX_PROMPT}\n\n${REACT_DOCTOR_OUTPUT_LABEL}:\n\`\`\`\n${normalizedReactDoctorOutput.length > 0 ? normalizedReactDoctorOutput : "No output captured."}\n\`\`\``;
+};
+const copyPromptToClipboard = (reactDoctorOutput, shouldLogResult) => {
+	const promptWithOutput = buildPromptWithOutput(reactDoctorOutput);
+	const didCopyPromptToClipboard = copyToClipboard(promptWithOutput);
+	if (!shouldLogResult) return;
+	if (didCopyPromptToClipboard) {
+		logger.success("Copied latest scan output to clipboard");
+		return;
 	}
+	logger.warn("Could not copy prompt to clipboard automatically. Use this prompt:");
+	logger.info(promptWithOutput);
+};
+const maybePromptAmiFix = async (directory) => {
+	logger.break();
+	logger.log(`Fix these issues with ${highlighter.info("Ami")}?`);
+	logger.dim("   Ami is a coding agent built to understand your codebase and fix issues");
+	logger.dim(`   automatically. Learn more at ${highlighter.info("https://ami.dev")}`);
+	logger.break();
+	const { shouldFix } = await prompts({
+		type: "confirm",
+		name: "shouldFix",
+		message: "Open Ami to fix?",
+		initial: true
+	});
+	if (shouldFix) openAmiToFix(directory);
 };
 const fixAction = (directory) => {
 	try {
@@ -1272,10 +1546,11 @@ const fixAction = (directory) => {
 	}
 };
 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);
+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 () => {
+	maybeInstallGlobally();
 	await program.parseAsync();
 };
 main$1();