react-doctor 0.2.8 → 0.2.10

package/dist/cli.js

@@ -1,5 +1,5 @@
 import { i as __toESM, n as __exportAll, r as __require, t as __commonJSMin } from "./rolldown-runtime-uZX_iqCz.js";
-import { A as isReactDoctorError, C as filterSourceFiles, D as groupBy, E as getDiffInfo, F as runInspect, I as toRelativePath, M as listWorkspacePackages, N as resolveScanTarget, O as highlighter, P as restoreLegacyThrow, S as filterDiagnosticsForSurface, T as formatReactDoctorError, _ as Score, a as DeadCode, b as buildJsonReportError, c as LintPartialFailures, d as OXLINT_NODE_REQUIREMENT, f as Progress, g as SKILL_NAME, h as SHARE_BASE_URL, i as Config, j as layerOtlp, k as isMonorepoRoot, l as Linter, m as Reporter, o as Files, p as Project, r as CANONICAL_GITHUB_URL, s as Git, t as cliLogger, u as NodeResolver, v as StagedFiles, w as formatErrorChain, x as discoverReactSubprojects, y as buildJsonReport } from "./cli-logger-C35LXalM.js";
+import { A as isReactDoctorError, C as filterSourceFiles, D as groupBy, E as getDiffInfo, F as runInspect, I as toRelativePath, M as listWorkspacePackages, N as resolveScanTarget, O as highlighter, P as restoreLegacyThrow, S as filterDiagnosticsForSurface, T as formatReactDoctorError, _ as Score, a as DeadCode, b as buildJsonReportError, c as LintPartialFailures, d as OXLINT_NODE_REQUIREMENT, f as Progress, g as SKILL_NAME, h as SHARE_BASE_URL, i as Config, j as layerOtlp, k as isMonorepoRoot, l as Linter, m as Reporter, o as Files, p as Project, r as CANONICAL_GITHUB_URL, s as Git, t as cliLogger, u as NodeResolver, v as StagedFiles, w as formatErrorChain, x as discoverReactSubprojects, y as buildJsonReport } from "./cli-logger-BRBUS1pE.js";
 import { createRequire } from "node:module";
 import { execFileSync, execSync } from "node:child_process";
 import path, { join } from "node:path";
@@ -6320,9 +6320,15 @@ const colorizeByScore = (text, score) => {
 	return highlighter.error(text);
 };
 //#endregion
+//#region src/cli/utils/constants.ts
+const STAGED_FILES_TEMP_DIR_PREFIX = "react-doctor-staged-";
+const INTERNAL_ERROR_JSON_FALLBACK = "{\"schemaVersion\":1,\"ok\":false,\"error\":{\"message\":\"Internal error\",\"name\":\"Error\",\"chain\":[]}}\n";
+//#endregion
 //#region src/cli/utils/render-score-header.ts
-const SCORE_BAR_ANIMATION_FRAME_COUNT = 40;
-const SCORE_BAR_ANIMATION_FRAME_DELAY_MS = 50;
+const RAINBOW_HUE_SHIFT_PER_FRAME = 9;
+const RAINBOW_GRADIENT_WIDTH = 80;
+const RAINBOW_OKLCH_LIGHTNESS = .638;
+const RAINBOW_OKLCH_CHROMA = .129;
 const easeOutCubic = (progress) => 1 - (1 - progress) ** 3;
 const sleep = (milliseconds) => Effect.promise(() => new Promise((resolve) => setTimeout(resolve, milliseconds)));
 const buildScoreBarSegments = (filledCount) => {
@@ -6333,6 +6339,36 @@ const buildScoreBarSegments = (filledCount) => {
 	};
 };
 const getFilledCount = (score) => Math.round(score / 100 * 50);
+const joinScoreHeaderFrame = (lines) => `${lines[0]}\n\r${lines[1]}\n\r${lines[2]}\n\r${lines[3]}\n`;
+const buildRawScoreBar = (displayScore) => {
+	const { filledSegment, emptySegment } = buildScoreBarSegments(getFilledCount(displayScore));
+	return filledSegment + emptySegment;
+};
+const buildScoreHeaderLine = (faceLine, rightColumnContent) => {
+	return `  ${faceLine}${rightColumnContent.length > 0 ? "  " : ""}${rightColumnContent}`;
+};
+const getRightColumnOffset = (faceLine) => `  ${faceLine}  `.length;
+const clampColorChannel = (value) => Math.max(0, Math.min(255, Math.round(value)));
+const encodeSrgb = (value) => value <= .0031308 ? value * 12.92 : 1.055 * value ** (1 / 2.4) - .055;
+const oklchToRgb = (lightness, chroma, hue) => {
+	const hueRadians = hue * Math.PI / 180;
+	const labA = chroma * Math.cos(hueRadians);
+	const labB = chroma * Math.sin(hueRadians);
+	const longCone = (lightness + .3963377774 * labA + .2158037573 * labB) ** 3;
+	const mediumCone = (lightness - .1055613458 * labA - .0638541728 * labB) ** 3;
+	const shortCone = (lightness - .0894841775 * labA - 1.291485548 * labB) ** 3;
+	return {
+		red: clampColorChannel(encodeSrgb(4.0767416621 * longCone - 3.3077115913 * mediumCone + .2309699292 * shortCone) * 255),
+		green: clampColorChannel(encodeSrgb(-1.2684380046 * longCone + 2.6097574011 * mediumCone - .3413193965 * shortCone) * 255),
+		blue: clampColorChannel(encodeSrgb(-.0041960863 * longCone - .7034186147 * mediumCone + 1.707614701 * shortCone) * 255)
+	};
+};
+const colorizeTrueColor = (text, { red, green, blue }) => `\x1b[38;2;${red};${green};${blue}m${text}\x1b[39m`;
+const colorizeRainbowText = (text, frame, offset = 0) => [...text].map((character, index) => {
+	if (character === " ") return character;
+	return colorizeTrueColor(character, oklchToRgb(RAINBOW_OKLCH_LIGHTNESS, RAINBOW_OKLCH_CHROMA, ((index + offset) / RAINBOW_GRADIENT_WIDTH * 360 + frame * RAINBOW_HUE_SHIFT_PER_FRAME) % 360));
+}).join("");
+const buildRainbowHeaderLine = (faceLine, rightColumnContent, frame) => colorizeRainbowText(buildScoreHeaderLine(faceLine, rightColumnContent), frame);
 const buildScoreBar = (displayScore, colorScore = displayScore) => {
 	const { filledSegment, emptySegment } = buildScoreBarSegments(getFilledCount(displayScore));
 	return colorizeByScore(filledSegment, colorScore) + highlighter.dim(emptySegment);
@@ -6343,18 +6379,19 @@ const getDoctorFace = (score) => {
 	return ["x x", " ▽ "];
 };
 const BRANDING_LINE = `React Doctor ${highlighter.dim("(https://react.doctor)")}`;
-const buildFaceRenderedLines = (score) => {
+const RAW_BRANDING_LINE = "React Doctor (https://react.doctor)";
+const buildRawFaceLines = (score) => {
 	const [eyes, mouth] = getDoctorFace(score);
-	const colorize = (text) => colorizeByScore(text, score);
 	return [
 		"┌─────┐",
 		`│ ${eyes} │`,
 		`│ ${mouth} │`,
 		"└─────┘"
-	].map(colorize);
+	];
 };
-const buildScoreHeaderLine = (faceLine, rightColumnContent) => {
-	return `  ${faceLine}${rightColumnContent.length > 0 ? "  " : ""}${rightColumnContent}`;
+const buildFaceRenderedLines = (score) => {
+	const colorize = (text) => colorizeByScore(text, score);
+	return buildRawFaceLines(score).map(colorize);
 };
 const writeScoreHeaderLine = (line) => Effect.sync(() => {
 	process.stdout.write(line);
@@ -6365,29 +6402,97 @@ const buildScoreLine = (displayScore, finalScore, label, projectName) => {
 	const projectSuffix = projectName ? ` ${highlighter.dim("·")} ${highlighter.dim(projectName)}` : "";
 	return `${scoreNumber} ${highlighter.dim(`/ 100`)} ${scoreLabel}${projectSuffix}`;
 };
+const buildRawScoreLine = (displayScore, label, projectName) => {
+	return `${displayScore} / 100 ${label}${projectName ? ` · ${projectName}` : ""}`;
+};
+const buildRainbowScoreHeaderFrame = ({ score, displayScore, label, frame, projectName }) => {
+	const rawFaceLines = buildRawFaceLines(score);
+	return joinScoreHeaderFrame([
+		buildRainbowHeaderLine(rawFaceLines[0] ?? "", buildRawScoreLine(displayScore, label, projectName), frame),
+		buildRainbowHeaderLine(rawFaceLines[1] ?? "", buildRawScoreBar(displayScore), frame),
+		buildRainbowHeaderLine(rawFaceLines[2] ?? "", RAW_BRANDING_LINE, frame),
+		buildRainbowHeaderLine(rawFaceLines[3] ?? "", "", frame)
+	]);
+};
+const buildFinalPerfectScoreHeaderFrame = (score, label, frame, projectName) => {
+	const rawFaceLines = buildRawFaceLines(score);
+	const renderedFaceLines = buildFaceRenderedLines(score);
+	const rainbowBarLine = colorizeRainbowText(buildRawScoreBar(score), frame, getRightColumnOffset(rawFaceLines[1] ?? ""));
+	return joinScoreHeaderFrame([
+		buildScoreHeaderLine(renderedFaceLines[0] ?? "", buildScoreLine(score, score, label, projectName)),
+		buildScoreHeaderLine(renderedFaceLines[1] ?? "", rainbowBarLine),
+		buildScoreHeaderLine(renderedFaceLines[2] ?? "", BRANDING_LINE),
+		buildScoreHeaderLine(renderedFaceLines[3] ?? "", "")
+	]);
+};
+const buildInitialScoreHeaderLine = ({ isPerfectScore, shouldAnimate, lineIndex, renderedFaceLine, rawFaceLine, rightColumnContent, rawRightColumnContent, score }) => {
+	if (!isPerfectScore) return buildScoreHeaderLine(renderedFaceLine, rightColumnContent);
+	if (shouldAnimate) return buildRainbowHeaderLine(rawFaceLine, rawRightColumnContent, 0);
+	if (lineIndex !== 1) return buildScoreHeaderLine(renderedFaceLine, rightColumnContent);
+	return buildScoreHeaderLine(renderedFaceLine, colorizeRainbowText(buildRawScoreBar(score), 0, getRightColumnOffset(rawFaceLine)));
+};
 const printAnimatedScore = (scoreFaceLine, barFaceLine, score, label, projectName) => Effect.gen(function* () {
-	for (let frame = 0; frame <= SCORE_BAR_ANIMATION_FRAME_COUNT; frame += 1) {
-		const progress = easeOutCubic(frame / SCORE_BAR_ANIMATION_FRAME_COUNT);
+	const isPerfectScore = score === 100;
+	for (let frame = 0; frame <= 40; frame += 1) {
+		const progress = easeOutCubic(frame / 40);
 		const animatedScore = Math.round(score * progress);
+		if (isPerfectScore) {
+			yield* writeScoreHeaderLine(`${frame === 0 ? "" : "\x1B[4A"}\r${buildRainbowScoreHeaderFrame({
+				score,
+				displayScore: animatedScore,
+				label,
+				frame,
+				projectName
+			})}`);
+			if (frame < 40) yield* sleep(50);
+			continue;
+		}
 		const animatedScoreLine = buildScoreLine(animatedScore, score, label, projectName);
 		const animatedBarLine = buildScoreBar(animatedScore, score);
 		yield* writeScoreHeaderLine(`${frame === 0 ? "" : "\x1B[2A"}\r${buildScoreHeaderLine(scoreFaceLine, animatedScoreLine)}\n\r${buildScoreHeaderLine(barFaceLine, animatedBarLine)}\n`);
-		if (frame < SCORE_BAR_ANIMATION_FRAME_COUNT) yield* sleep(SCORE_BAR_ANIMATION_FRAME_DELAY_MS);
+		if (frame < 40) yield* sleep(50);
+	}
+	if (!isPerfectScore) return;
+	for (let frame = 0; frame < 16; frame += 1) {
+		yield* writeScoreHeaderLine(`\x1b[4A\r${buildRainbowScoreHeaderFrame({
+			score,
+			displayScore: score,
+			label,
+			frame,
+			projectName
+		})}`);
+		yield* sleep(50);
 	}
+	yield* writeScoreHeaderLine(`\x1b[4A\r${buildFinalPerfectScoreHeaderFrame(score, label, 16, projectName)}\x1b[2A`);
 });
 const printScoreHeader = (scoreResult, projectName) => Effect.gen(function* () {
+	const isPerfectScore = scoreResult.score === 100;
 	const renderedFaceLines = buildFaceRenderedLines(scoreResult.score);
+	const rawFaceLines = buildRawFaceLines(scoreResult.score);
 	const shouldAnimate = !isSpinnerSilent() && isSpinnerInteractive(process.stdout);
+	const displayScore = shouldAnimate ? 0 : scoreResult.score;
 	const rightColumnLines = [
-		buildScoreLine(shouldAnimate ? 0 : scoreResult.score, scoreResult.score, scoreResult.label, projectName),
+		buildScoreLine(displayScore, scoreResult.score, scoreResult.label, projectName),
 		shouldAnimate ? buildScoreBar(0, scoreResult.score) : buildScoreBar(scoreResult.score),
 		BRANDING_LINE,
 		""
 	];
-	for (let lineIndex = 0; lineIndex < renderedFaceLines.length; lineIndex += 1) {
-		const rightColumnContent = rightColumnLines[lineIndex] ?? "";
-		yield* Console.log(buildScoreHeaderLine(renderedFaceLines[lineIndex], rightColumnContent));
-	}
+	const rawRightColumnLines = [
+		buildRawScoreLine(displayScore, scoreResult.label, projectName),
+		buildRawScoreBar(displayScore),
+		RAW_BRANDING_LINE,
+		""
+	];
+	for (let lineIndex = 0; lineIndex < renderedFaceLines.length; lineIndex += 1) yield* Console.log(buildInitialScoreHeaderLine({
+		isPerfectScore,
+		shouldAnimate,
+		lineIndex,
+		renderedFaceLine: renderedFaceLines[lineIndex] ?? "",
+		rawFaceLine: rawFaceLines[lineIndex] ?? "",
+		rightColumnContent: rightColumnLines[lineIndex] ?? "",
+		rawRightColumnContent: rawRightColumnLines[lineIndex] ?? "",
+		score: scoreResult.score
+	}));
 	yield* Console.log("");
 	if (shouldAnimate) {
 		yield* writeScoreHeaderLine("\x1B[5A");
@@ -6561,7 +6666,7 @@ const resolveOxlintNodeEffect = (isLintEnabled, isQuiet) => Effect.gen(function*
 const resolveOxlintNode = (isLintEnabled, isQuiet) => Effect.runPromise(resolveOxlintNodeEffect(isLintEnabled, isQuiet).pipe(Effect.provide(NodeResolver.layerNode)));
 //#endregion
 //#region src/cli/utils/version.ts
-const VERSION = "0.2.8";
+const VERSION = "0.2.10";
 //#endregion
 //#region src/inspect.ts
 const silentConsole = makeNoopConsole();
@@ -6749,10 +6854,6 @@ const finalizeAndRender = (input) => Effect.gen(function* () {
 	return buildResult();
 });
 //#endregion
-//#region src/cli/utils/constants.ts
-const STAGED_FILES_TEMP_DIR_PREFIX = "react-doctor-staged-";
-const INTERNAL_ERROR_JSON_FALLBACK = "{\"schemaVersion\":1,\"ok\":false,\"error\":{\"message\":\"Internal error\",\"name\":\"Error\",\"chain\":[]}}\n";
-//#endregion
 //#region src/cli/utils/get-staged-files.ts
 const stagedFilesLayer = StagedFiles.layerNode.pipe(Layer.provide(Git.layerNode));
 const getStagedSourceFiles = async (directory) => {
@@ -7311,7 +7412,7 @@ const disableSetupPrompt = (projectRoot, storeOptions = {}) => {
 	return true;
 };
 const shouldPromptInstallSetup = (options) => {
-	if (!options.hasScoredScan) return false;
+	if (!(options.hasCompletedScan ?? options.hasScoredScan ?? false)) return false;
 	if (options.isJsonMode) return false;
 	if (options.isScoreOnly) return false;
 	if (options.isStaged) return false;
@@ -7321,13 +7422,13 @@ const shouldPromptInstallSetup = (options) => {
 	return !hasDoctorScript(options.projectRoot);
 };
 const resolveInstallSetupProjectRoot = (options) => {
-	if (options.completedScanDirectories.length === 0) return findNearestPackageDirectory(options.scanRoot) ?? options.scanRoot;
+	if (options.scanDirectories.length === 0) return findNearestPackageDirectory(options.scanRoot) ?? options.scanRoot;
 	const packageDirectories = /* @__PURE__ */ new Set();
-	for (const scanDirectory of options.completedScanDirectories) {
+	for (const scanDirectory of options.scanDirectories) {
 		const packageDirectory = findNearestPackageDirectory(scanDirectory, options.scanRoot) ?? findNearestPackageDirectory(scanDirectory) ?? scanDirectory;
 		packageDirectories.add(packageDirectory);
 	}
-	if (packageDirectories.size !== 1) return null;
+	if (packageDirectories.size !== 1) return findNearestPackageDirectory(options.scanRoot, options.scanRoot);
 	return [...packageDirectories][0] ?? null;
 };
 const defaultWait = (milliseconds) => new Promise((resolve) => {
@@ -7362,7 +7463,7 @@ const warnSetupPromptFailure = async (options, error) => {
 		return;
 	}
 	try {
-		const { cliLogger } = await import("./cli-logger-C35LXalM.js").then((n) => n.n);
+		const { cliLogger } = await import("./cli-logger-BRBUS1pE.js").then((n) => n.n);
 		cliLogger.warn(message);
 	} catch {}
 };
@@ -7378,7 +7479,7 @@ const promptInstallSetup = async (options) => {
 			writeLine("You can always run `npx react-doctor@latest install` to set it up later.");
 			return;
 		}
-		const install = options.install ?? (await Promise.resolve().then(() => install_skill_exports)).runInstallSkill;
+		const install = options.install ?? (await Promise.resolve().then(() => install_react_doctor_exports)).runInstallReactDoctor;
 		const previousExitCode = process.exitCode;
 		let setupExitCode;
 		try {
@@ -7397,7 +7498,7 @@ const promptInstallSetup = async (options) => {
 	}
 };
 const shouldShowAgentInstallHint = (options) => {
-	if (!options.hasScoredScan) return false;
+	if (!(options.hasCompletedScan ?? options.hasScoredScan ?? false)) return false;
 	if (options.isJsonMode) return false;
 	if (options.isScoreOnly) return false;
 	if (options.isStaged) return false;
@@ -7462,7 +7563,7 @@ const resolveDiffMode = async (diffInfo, effectiveDiff, shouldSkipPrompts, isQui
 	const { scanScope } = await prompts({
 		type: "select",
 		name: "scanScope",
-		message: "Select",
+		message: "Choose what to scan",
 		choices: [{
 			title: "Full codebase",
 			value: "full"
@@ -7604,7 +7705,7 @@ const selectProjects = async (rootDirectory, projectFlag, skipPrompts) => {
 	}
 	if (packages.length === 0) return [rootDirectory];
 	if (packages.length === 1) {
-		cliLogger.log(`${highlighter.success("✔")} Select projects to scan ${highlighter.dim("›")} ${packages[0].name}`);
+		cliLogger.log(`${highlighter.success("✔")} Select projects ${highlighter.dim("›")} ${packages[0].name}`);
 		return [packages[0].directory];
 	}
 	if (projectFlag) return resolveProjectFlag(projectFlag, packages);
@@ -7628,13 +7729,13 @@ const resolveProjectFlag = (projectFlag, workspacePackages) => {
 	return resolvedDirectories;
 };
 const printDiscoveredProjects = (packages) => {
-	cliLogger.log(`${highlighter.success("✔")} Select projects to scan ${highlighter.dim("›")} ${packages.map((workspacePackage) => workspacePackage.name).join(", ")}`);
+	cliLogger.log(`${highlighter.success("✔")} Select projects ${highlighter.dim("›")} ${packages.map((workspacePackage) => workspacePackage.name).join(", ")}`);
 };
 const promptProjectSelection = async (workspacePackages, rootDirectory) => {
 	const { selectedDirectories } = await prompts({
 		type: "multiselect",
 		name: "selectedDirectories",
-		message: "Select projects to scan",
+		message: "Select projects",
 		choices: workspacePackages.map((workspacePackage) => ({
 			title: workspacePackage.name,
 			description: path.relative(rootDirectory, workspacePackage.directory),
@@ -7891,13 +7992,13 @@ const inspectAction = async (directory, flags) => {
 		});
 		const setupProjectRoot = resolveInstallSetupProjectRoot({
 			scanRoot: resolvedDirectory,
-			completedScanDirectories: completedScans.map((scan) => scan.directory)
+			scanDirectories: projectDirectories
 		});
 		if (setupProjectRoot !== null) {
-			const hasScoredScan = completedScans.some((scan) => scan.result.score !== null);
+			const hasCompletedScan = completedScans.length > 0;
 			await promptInstallSetup({
 				projectRoot: setupProjectRoot,
-				hasScoredScan,
+				hasCompletedScan,
 				issueCount: filterDiagnosticsForSurface(allDiagnostics, scanOptions.outputSurface ?? "cli", userConfig).length,
 				isJsonMode,
 				isScoreOnly,
@@ -7906,7 +8007,7 @@ const inspectAction = async (directory, flags) => {
 			});
 			if (shouldShowAgentInstallHint({
 				projectRoot: setupProjectRoot,
-				hasScoredScan,
+				hasCompletedScan,
 				isJsonMode,
 				isScoreOnly,
 				isStaged: Boolean(flags.staged)
@@ -8538,8 +8639,12 @@ const installReactDoctorGitHook = (options) => {
 	return installDirectGitHook(options);
 };
 //#endregion
-//#region src/cli/utils/install-skill.ts
-var install_skill_exports = /* @__PURE__ */ __exportAll({ runInstallSkill: () => runInstallSkill });
+//#region src/cli/utils/install-react-doctor.ts
+var install_react_doctor_exports = /* @__PURE__ */ __exportAll({ runInstallReactDoctor: () => runInstallReactDoctor });
+const SETUP_OPTION_GIT_HOOK = "git-hook";
+const SETUP_OPTION_AGENT_HOOKS = "agent-hooks";
+const SETUP_OPTION_WORKFLOW = "workflow";
+const SETUP_OPTION_SKIP = "skip";
 const CONFIG_ONLY_GIT_HOOK_KINDS = new Set([
 	"ghooks",
 	"git-hooks-js",
@@ -8646,7 +8751,8 @@ const defaultInstallDependencyRunner = (input) => {
 		env: {
 			...process.env,
 			REACT_DOCTOR_INSTALL: "1"
-		}
+		},
+		shell: process.platform === "win32"
 	});
 };
 const installReactDoctorDependency = async (options) => {
@@ -8719,7 +8825,30 @@ const getSkillSourceDirectory = () => {
 	const distDirectory = path.dirname(fileURLToPath(import.meta.url));
 	return path.join(distDirectory, "skills", SKILL_NAME);
 };
-const runInstallSkill = async (options = {}) => {
+const canInstallNativeAgentHooks = (agents) => agents.some((agent) => agent === "claude-code" || agent === "cursor");
+const buildWorkflowContent = () => [
+	"name: React Doctor",
+	"",
+	"on:",
+	"  pull_request:",
+	"    branches: [main]",
+	"",
+	"permissions:",
+	"  contents: read",
+	"  pull-requests: write",
+	"",
+	"jobs:",
+	"  react-doctor:",
+	"    runs-on: ubuntu-latest",
+	"    steps:",
+	"      - uses: actions/checkout@v4",
+	"      - uses: millionco/react-doctor@main",
+	"        with:",
+	"          github-token: ${{ secrets.GITHUB_TOKEN }}",
+	"          diff: main",
+	""
+].join("\n");
+const runInstallReactDoctor = async (options = {}) => {
 	const requestedProjectRoot = options.projectRoot ?? process.cwd();
 	const projectRoot = findNearestPackageDirectory(requestedProjectRoot) ?? requestedProjectRoot;
 	const sourceDir = options.sourceDir ?? getSkillSourceDirectory();
@@ -8740,7 +8869,8 @@ const runInstallSkill = async (options = {}) => {
 	const gitHookTarget = options.gitHookPath === void 0 ? detectGitHookTarget(projectRoot) : options.gitHookPath === null ? null : buildManualGitHookTarget(options.gitHookPath, projectRoot);
 	const gitHookPath = gitHookTarget?.hookPath;
 	const promptOptions = options.onPromptCancel === void 0 ? {} : { onCancel: options.onPromptCancel };
-	const selectedAgents = skipPrompts ? detectedAgents : (await prompts({
+	const prompt = options.prompt ?? prompts;
+	const selectedAgents = skipPrompts ? detectedAgents : (await prompt({
 		type: "multiselect",
 		name: "agents",
 		message: `Install the ${highlighter.info(`/react-doctor`)} skill for:`,
@@ -8753,13 +8883,48 @@ const runInstallSkill = async (options = {}) => {
 		min: 1
 	}, promptOptions)).agents ?? [];
 	if (selectedAgents.length === 0) return;
-	const shouldInstallGitHook = gitHookPath !== null && gitHookPath !== void 0 && (Boolean(options.yes) || !skipPrompts && Boolean((await prompts({
-		type: "confirm",
-		name: "installGitHook",
-		message: "Check for issues before each commit?",
-		initial: true
-	}, promptOptions)).installGitHook));
-	const shouldInstallAgentHooks = Boolean(options.agentHooks);
+	const workflowsDirectory = path.join(projectRoot, ".github", "workflows");
+	const workflowTargetPath = path.join(workflowsDirectory, "react-doctor.yml");
+	const hasExistingWorkflows = existsSync(workflowsDirectory);
+	const canInstallWorkflow = !existsSync(workflowTargetPath);
+	const setupActionChoices = [
+		...gitHookPath === null || gitHookPath === void 0 ? [] : [{
+			title: "Pre-commit hook",
+			description: "Check staged changes before each commit",
+			value: SETUP_OPTION_GIT_HOOK,
+			selected: true
+		}],
+		...canInstallNativeAgentHooks(selectedAgents) ? [{
+			title: "Agent hooks",
+			description: "Ask Claude Code or Cursor to scan after code edits",
+			value: SETUP_OPTION_AGENT_HOOKS,
+			selected: Boolean(options.agentHooks)
+		}] : [],
+		...canInstallWorkflow ? [{
+			title: "GitHub Actions workflow",
+			description: "Scan pull requests in CI",
+			value: SETUP_OPTION_WORKFLOW,
+			selected: hasExistingWorkflows
+		}] : []
+	];
+	const setupChoices = setupActionChoices.length === 0 ? [] : [{
+		title: "Skip optional setup",
+		description: "Install only the agent skill and package setup",
+		value: SETUP_OPTION_SKIP,
+		selected: false
+	}, ...setupActionChoices];
+	const selectedSetupOptions = skipPrompts || setupChoices.length === 0 ? [] : (await prompt({
+		type: "multiselect",
+		name: "setupOptions",
+		message: "Select additional React Doctor setup:",
+		choices: setupChoices,
+		instructions: false
+	}, promptOptions)).setupOptions ?? [];
+	const selectedSetupActions = selectedSetupOptions.filter((setupOption) => setupOption !== SETUP_OPTION_SKIP);
+	const didSkipOptionalSetup = selectedSetupActions.length === 0 && selectedSetupOptions.includes(SETUP_OPTION_SKIP);
+	const shouldInstallGitHook = gitHookPath !== null && gitHookPath !== void 0 && (Boolean(options.yes) || !didSkipOptionalSetup && selectedSetupActions.includes(SETUP_OPTION_GIT_HOOK));
+	const shouldInstallAgentHooks = Boolean(options.agentHooks) || !didSkipOptionalSetup && selectedSetupActions.includes(SETUP_OPTION_AGENT_HOOKS);
+	const shouldInstallWorkflow = !skipPrompts && !didSkipOptionalSetup && canInstallWorkflow && selectedSetupActions.includes(SETUP_OPTION_WORKFLOW);
 	if (options.dryRun) {
 		cliLogger.log(`Dry run — would install ${SKILL_NAME} skill for:`);
 		for (const agent of selectedAgents) cliLogger.dim(`  - ${getSkillAgentConfig(agent).displayName}`);
@@ -8768,6 +8933,7 @@ const runInstallSkill = async (options = {}) => {
 		cliLogger.dim("  Dev dependency: react-doctor");
 		if (shouldInstallGitHook) cliLogger.dim(`  Git hook: ${gitHookPath}`);
 		if (shouldInstallAgentHooks) cliLogger.dim("  Agent hooks: Claude Code / Cursor when selected");
+		if (shouldInstallWorkflow) cliLogger.dim(`  GitHub Actions workflow: ${path.relative(projectRoot, workflowTargetPath)}`);
 		return;
 	}
 	const installSpinner = spinner(`Installing ${SKILL_NAME} skill...`).start();
@@ -8815,47 +8981,15 @@ const runInstallSkill = async (options = {}) => {
 			throw error;
 		}
 	}
-	const workflowsDirectory = path.join(projectRoot, ".github", "workflows");
-	const workflowTargetPath = path.join(workflowsDirectory, "react-doctor.yml");
-	if (!existsSync(workflowTargetPath) && !skipPrompts) {
-		const hasExistingWorkflows = existsSync(workflowsDirectory);
-		const { shouldInstallWorkflow } = await prompts({
-			type: "confirm",
-			name: "shouldInstallWorkflow",
-			message: "Add a GitHub Actions workflow to scan PRs?",
-			initial: hasExistingWorkflows
-		}, promptOptions);
-		if (shouldInstallWorkflow) {
-			if (!hasExistingWorkflows) mkdirSync(workflowsDirectory, { recursive: true });
-			const workflowSpinner = spinner("Adding GitHub Actions workflow...").start();
-			try {
-				writeFileSync(workflowTargetPath, [
-					"name: React Doctor",
-					"",
-					"on:",
-					"  pull_request:",
-					"    branches: [main]",
-					"",
-					"permissions:",
-					"  contents: read",
-					"  pull-requests: write",
-					"",
-					"jobs:",
-					"  react-doctor:",
-					"    runs-on: ubuntu-latest",
-					"    steps:",
-					"      - uses: actions/checkout@v4",
-					"      - uses: millionco/react-doctor@main",
-					"        with:",
-					"          github-token: ${{ secrets.GITHUB_TOKEN }}",
-					"          diff: main",
-					""
-				].join("\n"));
-				workflowSpinner.succeed(`GitHub Actions workflow added at ${path.relative(projectRoot, workflowTargetPath)}.`);
-			} catch (error) {
-				workflowSpinner.fail("Failed to add GitHub Actions workflow.");
-				throw error;
-			}
+	if (shouldInstallWorkflow) {
+		if (!hasExistingWorkflows) mkdirSync(workflowsDirectory, { recursive: true });
+		const workflowSpinner = spinner("Adding GitHub Actions workflow...").start();
+		try {
+			writeFileSync(workflowTargetPath, buildWorkflowContent());
+			workflowSpinner.succeed(`GitHub Actions workflow added at ${path.relative(projectRoot, workflowTargetPath)}.`);
+		} catch (error) {
+			workflowSpinner.fail("Failed to add GitHub Actions workflow.");
+			throw error;
 		}
 	}
 };
@@ -8865,7 +8999,7 @@ const installAction = async (options, command) => {
 	Effect.runSync(printBrandedHeader);
 	try {
 		const parentOptions = command?.parent?.opts?.();
-		await runInstallSkill({
+		await runInstallReactDoctor({
 			yes: options.yes ?? parentOptions?.yes,
 			dryRun: options.dryRun,
 			agentHooks: options.agentHooks,

package/dist/index.d.ts

@@ -232,7 +232,9 @@ interface ReactDoctorConfig {
    * `categories` field, but keyed by React Doctor's display
    * categories (`"Server"`, `"React Native"`, `"Architecture"`,
    * `"Bundle Size"`, `"State & Effects"`, `"Security"`,
-   * `"Accessibility"`, `"Performance"`, `"Correctness"`, …).
+   * `"Accessibility"`, `"Performance"`, `"Correctness"`,
+   * `"Next.js"`, `"Preact"`, `"TanStack Query"`,
+   * `"TanStack Start"`, …).
    *
    * ```json
    * { "categories": { "React Native": "warn", "Server": "off" } }
@@ -296,7 +298,7 @@ interface Diagnostic {
 }
 //#endregion
 //#region src/types/project-info.d.ts
-type Framework = "nextjs" | "vite" | "cra" | "remix" | "gatsby" | "expo" | "react-native" | "tanstack-start" | "unknown";
+type Framework = "nextjs" | "vite" | "cra" | "remix" | "gatsby" | "expo" | "react-native" | "tanstack-start" | "preact" | "unknown";
 interface ProjectInfo {
   rootDirectory: string;
   projectName: string;
@@ -307,6 +309,16 @@ interface ProjectInfo {
   hasTypeScript: boolean;
   hasReactCompiler: boolean;
   hasTanStackQuery: boolean;
+  /**
+   * `true` when `preact` is declared anywhere in the project's
+   * dependency manifest. Drives the `preact` capability in
+   * `buildCapabilities`, which gates every `preact-*` rule. Modeled
+   * on `hasTanStackQuery` rather than the `framework` field because
+   * the dominant Preact setup today is Preact-on-Vite — those
+   * projects classify as `framework: "vite"` for build-tool reasons
+   * but still need Preact-specific rules to fire.
+   */
+  hasPreact: boolean;
   /**
    * `true` when the project (or any of its workspace packages) declares
    * React Native or Expo as a dependency. Enables the `react-native`
@@ -355,8 +367,14 @@ interface DiagnoseResult {
   skippedCheckReasons?: Record<string, string>;
   project: ProjectInfo;
   elapsedMilliseconds: number;
-} //#endregion
-//#region src/types/handle-error.d.ts
+}
+/**
+ * A single project to scan as part of a `diagnoseProjects()` batch.
+ * Scan options (`deadCode`, `lint`, etc.) are flat on the entry and
+ * layer on top of the global defaults — omitted fields fall through.
+ * `config` is a full `ReactDoctorConfig` override that replaces the
+ * on-disk `react-doctor.config.json` for this project's scan.
+ */
 //#endregion
 //#region src/types/inspect.d.ts
 interface InspectResult {
@@ -492,13 +510,18 @@ declare class PackageJsonNotFoundError extends Error {
   readonly directory: string;
   constructor(directory: string, options?: ErrorOptions);
 }
+declare class NotADirectoryError extends Error {
+  readonly name = "NotADirectoryError";
+  readonly resolvedPath: string;
+  constructor(resolvedPath: string, options?: ErrorOptions);
+}
 declare class AmbiguousProjectError extends Error {
   readonly name = "AmbiguousProjectError";
   readonly directory: string;
   readonly candidates: readonly string[];
   constructor(directory: string, candidates: readonly string[], options?: ErrorOptions);
 }
-declare const isProjectDiscoveryError: (value: unknown) => value is ProjectNotFoundError | NoReactDependencyError | PackageJsonNotFoundError | AmbiguousProjectError; //#endregion
+declare const isProjectDiscoveryError: (value: unknown) => value is ProjectNotFoundError | NoReactDependencyError | PackageJsonNotFoundError | NotADirectoryError | AmbiguousProjectError; //#endregion
 //#region src/project-info/utils/is-directory.d.ts
 //#endregion
 //#region src/errors.d.ts
@@ -651,7 +674,41 @@ declare const summarizeDiagnostics: (diagnostics: Diagnostic[], worstScore?: num
 //#endregion
 //#region ../api/dist/index.d.ts
 //#region src/diagnose.d.ts
-declare const diagnose: (directory: string, options?: DiagnoseOptions) => Promise<DiagnoseResult>; //#endregion
+declare const diagnose: (directory: string, options?: DiagnoseOptions) => Promise<DiagnoseResult>;
+/**
+ * Scan multiple projects in parallel and return per-project scores,
+ * diagnostics, and an aggregate score (worst-of across all projects).
+ *
+ * Each project runs its own independent `runInspect` pipeline — the
+ * same pipeline `diagnose()` uses — so per-project config overrides,
+ * dead-code analysis, and scoring all work identically to a single
+ * `diagnose()` call.
+ *
+ * Projects that fail (e.g. missing `package.json`, no React dependency)
+ * are included in the result with `ok: false` rather than aborting the
+ * entire batch, so callers always receive partial results.
+ *
+ * ```ts
+ * const result = await diagnoseProjects({
+ *   projects: [
+ *     { directory: "packages/app" },
+ *     { directory: "packages/shared", deadCode: false },
+ *     { directory: "packages/admin", config: {
+ *       rules: { "react-doctor/no-array-index-as-key": "off" },
+ *     }},
+ *   ],
+ *   concurrency: 4,
+ * });
+ *
+ * for (const project of result.projects) {
+ *   if (project.ok) {
+ *     console.log(project.directory, project.score);
+ *   } else {
+ *     console.error(project.directory, project.error);
+ *   }
+ * }
+ * ```
+ */
 //#endregion
 //#region src/index.d.ts
 declare const clearCaches: () => void;
@@ -662,5 +719,5 @@ interface ToJsonReportOptions {
 }
 declare const toJsonReport: (result: DiagnoseResult, options: ToJsonReportOptions) => JsonReport;
 //#endregion
-export { AmbiguousProjectError, type DiagnoseOptions, type DiagnoseResult, type Diagnostic, type DiffInfo, type JsonReport, type JsonReportDiffInfo, type JsonReportError, type JsonReportMode, type JsonReportProjectEntry, type JsonReportSummary, NoReactDependencyError, PackageJsonNotFoundError, type ProjectInfo, ProjectNotFoundError, type ReactDoctorConfig, ReactDoctorError, type ScoreResult, buildJsonReport, buildJsonReportError, clearCaches, diagnose, filterSourceFiles, getDiffInfo, isProjectDiscoveryError, isReactDoctorError, summarizeDiagnostics, toJsonReport };
+export { AmbiguousProjectError, type DiagnoseOptions, type DiagnoseResult, type Diagnostic, type DiffInfo, type JsonReport, type JsonReportDiffInfo, type JsonReportError, type JsonReportMode, type JsonReportProjectEntry, type JsonReportSummary, NoReactDependencyError, NotADirectoryError, PackageJsonNotFoundError, type ProjectInfo, ProjectNotFoundError, type ReactDoctorConfig, ReactDoctorError, type ScoreResult, buildJsonReport, buildJsonReportError, clearCaches, diagnose, filterSourceFiles, getDiffInfo, isProjectDiscoveryError, isReactDoctorError, summarizeDiagnostics, toJsonReport };
 //# sourceMappingURL=index.d.ts.map