react-doctor 0.2.9 → 0.2.11-dev.d917f62

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-BliQX9s8.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-Df45H6Lw.js";
 import { createRequire } from "node:module";
 import { execFileSync, execSync } from "node:child_process";
 import path, { join } from "node:path";
@@ -6320,11 +6320,11 @@ 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 PERFECT_SCORE_RAINBOW_FRAME_COUNT = 16;
-const PERFECT_SCORE_RAINBOW_FRAME_DELAY_MS = 50;
 const RAINBOW_HUE_SHIFT_PER_FRAME = 9;
 const RAINBOW_GRADIENT_WIDTH = 80;
 const RAINBOW_OKLCH_LIGHTNESS = .638;
@@ -6433,8 +6433,8 @@ const buildInitialScoreHeaderLine = ({ isPerfectScore, shouldAnimate, lineIndex,
 };
 const printAnimatedScore = (scoreFaceLine, barFaceLine, score, label, projectName) => Effect.gen(function* () {
 	const isPerfectScore = score === 100;
-	for (let frame = 0; frame <= SCORE_BAR_ANIMATION_FRAME_COUNT; frame += 1) {
-		const progress = easeOutCubic(frame / SCORE_BAR_ANIMATION_FRAME_COUNT);
+	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({
@@ -6444,16 +6444,16 @@ const printAnimatedScore = (scoreFaceLine, barFaceLine, score, label, projectNam
 				frame,
 				projectName
 			})}`);
-			if (frame < SCORE_BAR_ANIMATION_FRAME_COUNT) yield* sleep(SCORE_BAR_ANIMATION_FRAME_DELAY_MS);
+			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 < PERFECT_SCORE_RAINBOW_FRAME_COUNT; frame += 1) {
+	for (let frame = 0; frame < 16; frame += 1) {
 		yield* writeScoreHeaderLine(`\x1b[4A\r${buildRainbowScoreHeaderFrame({
 			score,
 			displayScore: score,
@@ -6461,9 +6461,9 @@ const printAnimatedScore = (scoreFaceLine, barFaceLine, score, label, projectNam
 			frame,
 			projectName
 		})}`);
-		yield* sleep(PERFECT_SCORE_RAINBOW_FRAME_DELAY_MS);
+		yield* sleep(50);
 	}
-	yield* writeScoreHeaderLine(`\x1b[4A\r${buildFinalPerfectScoreHeaderFrame(score, label, PERFECT_SCORE_RAINBOW_FRAME_COUNT, projectName)}\x1b[2A`);
+	yield* writeScoreHeaderLine(`\x1b[4A\r${buildFinalPerfectScoreHeaderFrame(score, label, 16, projectName)}\x1b[2A`);
 });
 const printScoreHeader = (scoreResult, projectName) => Effect.gen(function* () {
 	const isPerfectScore = scoreResult.score === 100;
@@ -6666,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.9";
+const VERSION = "0.2.11-dev.d917f62";
 //#endregion
 //#region src/inspect.ts
 const silentConsole = makeNoopConsole();
@@ -6764,9 +6764,7 @@ const runInspectWithRuntime = async (directory, options, userConfig, hasConfigOv
 	const output = await Effect.runPromise(restoreLegacyThrow(programWithLayers));
 	const didLintFail = lintBindingMissing || output.didLintFail;
 	const lintFailureReason = lintBindingMissing ? `oxlint native binding not found for Node ${process.version}; expected one matching ${OXLINT_NODE_REQUIREMENT}` : output.lintFailureReason;
-	const lintFailureReasonTag = output.lintFailureReasonTag;
-	const isNativeBindingFailure = lintFailureReasonTag === "OxlintUnavailable" || lintFailureReasonTag === "OxlintSpawnFailed";
-	if (!options.scoreOnly && !lintBindingMissing && output.didLintFail && lintFailureReason !== null) if (isNativeBindingFailure && /native binding/.test(lintFailureReason)) runConsole(Console.log(highlighter.gray(`  Upgrade to Node ${OXLINT_NODE_REQUIREMENT} or run: npx -p oxlint@latest react-doctor@latest`)));
+	if (!options.scoreOnly && !lintBindingMissing && output.didLintFail && lintFailureReason !== null) if (output.lintFailureReasonKind === "native-binding-missing") runConsole(Console.log(highlighter.gray(`  Upgrade to Node ${OXLINT_NODE_REQUIREMENT} or run: npx -p oxlint@latest react-doctor@latest`)));
 	else runConsole(Console.error(highlighter.error(lintFailureReason)));
 	const inspectDiagnostics = output.diagnostics;
 	const score = didLintFail ? null : output.score;
@@ -6854,10 +6852,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) => {
@@ -7416,7 +7410,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;
@@ -7426,13 +7420,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) => {
@@ -7467,7 +7461,7 @@ const warnSetupPromptFailure = async (options, error) => {
 		return;
 	}
 	try {
-		const { cliLogger } = await import("./cli-logger-BliQX9s8.js").then((n) => n.n);
+		const { cliLogger } = await import("./cli-logger-Df45H6Lw.js").then((n) => n.n);
 		cliLogger.warn(message);
 	} catch {}
 };
@@ -7483,7 +7477,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 {
@@ -7502,7 +7496,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;
@@ -7567,15 +7561,17 @@ 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",
+			description: "Scan every source file",
 			value: "full"
 		}, {
-			title: `Changed files (${changedSourceFiles.length})`,
+			title: diffInfo.isCurrentChanges ? `Uncommitted changes (${changedSourceFiles.length})` : `Changed files on ${diffInfo.currentBranch ?? "this branch"} (${changedSourceFiles.length})`,
+			description: diffInfo.isCurrentChanges ? "Compare working tree changes against HEAD" : `Compare against ${diffInfo.baseBranch} from the branch merge-base`,
 			value: "branch"
 		}],
-		initial: 0
+		initial: diffInfo.isCurrentChanges ? 0 : 1
 	});
 	return scanScope === "branch";
 };
@@ -7605,13 +7601,13 @@ const VALID_FAIL_ON_LEVELS = new Set([
 	"warning",
 	"none"
 ]);
-const DEFAULT_FAIL_ON_LEVEL = "error";
+const DEFAULT_FAIL_ON_LEVEL = "none";
 const isValidFailOnLevel = (level) => VALID_FAIL_ON_LEVELS.has(level);
 const resolveFailOnLevel = (flags, userConfig) => {
 	const sourceValue = flags.failOn ?? userConfig?.failOn ?? DEFAULT_FAIL_ON_LEVEL;
 	if (isValidFailOnLevel(sourceValue)) return sourceValue;
-	cliLogger.warn(`Invalid failOn level "${sourceValue}". Expected one of: error, warning, none. Falling back to "none".`);
-	return "none";
+	cliLogger.warn(`Invalid failOn level "${sourceValue}". Expected one of: error, warning, none. Falling back to "${DEFAULT_FAIL_ON_LEVEL}".`);
+	return DEFAULT_FAIL_ON_LEVEL;
 };
 //#endregion
 //#region src/cli/utils/resolve-project-diff-include-paths.ts
@@ -7709,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);
@@ -7733,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),
@@ -7896,7 +7892,14 @@ const inspectAction = async (directory, flags) => {
 				cliLogger.log(`Scanning ${highlighter.info(`${stagedFiles.length}`)} staged files...`);
 				cliLogger.break();
 			}
-			const snapshot = await materializeStagedFiles(resolvedDirectory, stagedFiles, mkdtempSync(path.join(tmpdir(), STAGED_FILES_TEMP_DIR_PREFIX)));
+			const tempDirectory = mkdtempSync(path.join(tmpdir(), STAGED_FILES_TEMP_DIR_PREFIX));
+			const snapshot = await materializeStagedFiles(resolvedDirectory, stagedFiles, tempDirectory).catch((error) => {
+				rmSync(tempDirectory, {
+					recursive: true,
+					force: true
+				});
+				throw error;
+			});
 			try {
 				const scanResult = await inspect(snapshot.tempDirectory, {
 					...scanOptions,
@@ -7905,7 +7908,7 @@ const inspectAction = async (directory, flags) => {
 				});
 				const remappedDiagnostics = scanResult.diagnostics.map((diagnostic) => ({
 					...diagnostic,
-					filePath: path.isAbsolute(diagnostic.filePath) ? diagnostic.filePath.replaceAll(snapshot.tempDirectory, resolvedDirectory) : diagnostic.filePath
+					filePath: path.isAbsolute(diagnostic.filePath) ? diagnostic.filePath.replaceAll(snapshot.tempDirectory, () => resolvedDirectory) : diagnostic.filePath
 				}));
 				finalizeScans({
 					diagnostics: remappedDiagnostics,
@@ -7996,13 +7999,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,
@@ -8011,7 +8014,7 @@ const inspectAction = async (directory, flags) => {
 			});
 			if (shouldShowAgentInstallHint({
 				projectRoot: setupProjectRoot,
-				hasScoredScan,
+				hasCompletedScan,
 				isJsonMode,
 				isScoreOnly,
 				isStaged: Boolean(flags.staged)
@@ -8643,8 +8646,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",
@@ -8825,7 +8832,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();
@@ -8846,7 +8876,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:`,
@@ -8859,13 +8890,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}`);
@@ -8874,6 +8940,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();
@@ -8921,47 +8988,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;
 		}
 	}
 };
@@ -8971,7 +9006,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,
@@ -9111,7 +9146,7 @@ const stripUnknownCliFlags = (argv) => {
 //#region src/cli/index.ts
 process.on("SIGINT", exitGracefully);
 process.on("SIGTERM", exitGracefully);
-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("--lint", "enable linting").option("--no-lint", "skip linting").option("--dead-code", "enable dead-code analysis (default)").option("--no-dead-code", "skip dead-code analysis (unused files / exports / dependencies, circular imports)").option("--verbose", "show every rule and per-file details (default shows top 3 rules)").option("--score", "output only the score").option("--json", "output a single structured JSON report (suppresses other output)").option("--json-compact", "with --json, emit compact JSON (no indentation)").option("-y, --yes", "skip prompts, scan all workspace projects").option("--full", "force a full scan (overrides any `diff` value in config or `--diff`)").option("--project <name>", "select workspace project (comma-separated for multiple)").option("--diff [base]", "scan only files changed vs base branch (pass `false` to disable; overridden by --full)").option("--no-score", "skip the score API and the share URL").option("--staged", "scan only staged (git index) files for pre-commit hooks").option("--fail-on <level>", "exit with error code on diagnostics: error, warning, none (default: error)").option("--annotations", "output diagnostics as GitHub Actions annotations").option("--pr-comment", "tune CLI output for sticky PR comments (drops weak-signal rule families like `design` from the printed list and the fail-on gate; configure via config.surfaces)").option("--explain <file:line>", "diagnose why a rule fired or why a suppression didn't apply at a specific location").option("--why <file:line>", "alias for --explain").option("--respect-inline-disables", "respect inline `// eslint-disable*` / `// oxlint-disable*` comments (default)").option("--no-respect-inline-disables", "audit mode: neutralize inline lint suppressions before scanning").addHelpText("after", `
+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("--lint", "enable linting").option("--no-lint", "skip linting").option("--dead-code", "enable dead-code analysis (default)").option("--no-dead-code", "skip dead-code analysis (unused files / exports / dependencies, circular imports)").option("--verbose", "show every rule and per-file details (default shows top 3 rules)").option("--score", "output only the score").option("--json", "output a single structured JSON report (suppresses other output)").option("--json-compact", "with --json, emit compact JSON (no indentation)").option("-y, --yes", "skip prompts, scan all workspace projects").option("--full", "force a full scan (overrides any `diff` value in config or `--diff`)").option("--project <name>", "select workspace project (comma-separated for multiple)").option("--diff [base]", "scan only files changed vs base branch (pass `false` to disable; overridden by --full)").option("--no-score", "skip the score API and the share URL").option("--staged", "scan only staged (git index) files for pre-commit hooks").option("--fail-on <level>", "exit with error code on diagnostics: error, warning, none (default: none)").option("--annotations", "output diagnostics as GitHub Actions annotations").option("--pr-comment", "tune CLI output for sticky PR comments (drops weak-signal rule families like `design` from the printed list and the fail-on gate; configure via config.surfaces)").option("--explain <file:line>", "diagnose why a rule fired or why a suppression didn't apply at a specific location").option("--why <file:line>", "alias for --explain").option("--respect-inline-disables", "respect inline `// eslint-disable*` / `// oxlint-disable*` comments (default)").option("--no-respect-inline-disables", "audit mode: neutralize inline lint suppressions before scanning").addHelpText("after", `
 ${highlighter.dim("Configuration:")}
   Place a ${highlighter.info("react-doctor.config.json")} (or ${highlighter.info("\"reactDoctor\"")} key in your package.json) in the project root.
   CLI flags always override config values. See the README for the full schema.

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,18 @@ interface ProjectInfo {
   hasTypeScript: boolean;
   hasReactCompiler: boolean;
   hasTanStackQuery: boolean;
+  /**
+   * The declared `preact` version spec, or `null` when Preact isn't a
+   * dependency. Parallels `reactVersion` so a React-compatible runtime is
+   * modeled the same way React is. Drives the `preact` capability in
+   * `buildCapabilities` (which gates every `preact-*` rule) — keyed off
+   * this rather than `framework` because the dominant Preact setup
+   * (Preact-on-Vite) classifies as `framework: "vite"` but still needs
+   * Preact rules to fire.
+   */
+  preactVersion: string | null;
+  /** Parsed major from `preactVersion`, or `null` when absent/unparseable. Mirrors `reactMajorVersion`. */
+  preactMajorVersion: number | null;
   /**
    * `true` when the project (or any of its workspace packages) declares
    * React Native or Expo as a dependency. Enables the `react-native`
@@ -321,6 +335,13 @@ interface ProjectInfo {
    * — no `rn-*` rules load for the project at all.
    */
   hasReactNativeWorkspace: boolean;
+  /**
+   * `true` when the project (or any of its workspace packages) declares
+   * `react-native-reanimated`. Lets diagnostics surface reanimated's
+   * Compiler-compatible `.get()` / `.set()` accessors only where they
+   * apply, instead of on every React Native project.
+   */
+  hasReanimated: boolean;
   sourceFileCount: number;
 }
 //#endregion