react-doctor 0.5.6-dev.eafac9d → 0.5.6-dev.ed0258c

package/dist/cli.js

@@ -1,5 +1,5 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="54905d6a-f06f-5f80-9fb6-7d4ab857d553")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="a06f0514-b1fa-5452-9c19-0140438862f8")}catch(e){}}();
 import { createRequire } from "node:module";
 import * as NodeChildProcess from "node:child_process";
 import { execFile, execFileSync, spawn, spawnSync } from "node:child_process";
@@ -14,7 +14,7 @@ import * as OS from "node:os";
 import os, { tmpdir } from "node:os";
 import { parseJSON5 } from "confbox";
 import * as NodeUrl from "node:url";
-import { fileURLToPath } from "node:url";
+import { fileURLToPath, pathToFileURL } from "node:url";
 import { createJiti } from "jiti";
 import * as Crypto from "node:crypto";
 import crypto, { createHash, randomUUID } from "node:crypto";
@@ -36793,6 +36793,11 @@ const ES_TARGET_YEAR_BY_NAME = {
 	esnext: 9999
 };
 /**
+* tsconfig filenames probed when resolving a project's TypeScript
+* compiler options — the root config first, then a monorepo base config.
+*/
+const TSCONFIG_FILENAMES = ["tsconfig.json", "tsconfig.base.json"];
+/**
 * Project-config files that `StagedFiles.materialize` copies into
 * the temp directory alongside staged sources so oxlint resolves
 * `tsconfig` / `package.json` / lint configs the same way it would
@@ -39692,15 +39697,10 @@ const buildCapabilities = (project) => {
 	}
 	if (project.tailwindVersion !== null) {
 		capabilities.add("tailwind");
-		const tailwind = parseTailwindMajorMinor(project.tailwindVersion);
-		if (isTailwindAtLeast(tailwind, {
+		if (isTailwindAtLeast(parseTailwindMajorMinor(project.tailwindVersion), {
 			major: 3,
 			minor: 4
 		})) capabilities.add("tailwind:3.4");
-		if (tailwind !== null && isTailwindAtLeast(tailwind, {
-			major: 4,
-			minor: 0
-		})) capabilities.add("tailwind:4");
 	}
 	if (project.zodVersion !== null) {
 		capabilities.add("zod");
@@ -39946,8 +39946,8 @@ const collectIgnorePatterns = (rootDirectory) => {
 	cachedPatternsByRoot.set(rootDirectory, patterns);
 	return patterns;
 };
+const isRecord$2 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 const KNIP_JSON_FILENAME = "knip.json";
-const isRecord$1$1 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 const readJsonFileSafe = (filePath) => {
 	let rawContents;
 	try {
@@ -39963,10 +39963,10 @@ const readJsonFileSafe = (filePath) => {
 };
 const readKnipConfig = (rootDirectory) => {
 	const knipJson = readJsonFileSafe(path.join(rootDirectory, KNIP_JSON_FILENAME));
-	if (isRecord$1$1(knipJson)) return knipJson;
+	if (isRecord$2(knipJson)) return knipJson;
 	const packageJson = readJsonFileSafe(path.join(rootDirectory, "package.json"));
-	const packageKnipConfig = isRecord$1$1(packageJson) ? packageJson.knip : null;
-	return isRecord$1$1(packageKnipConfig) ? packageKnipConfig : null;
+	const packageKnipConfig = isRecord$2(packageJson) ? packageJson.knip : null;
+	return isRecord$2(packageKnipConfig) ? packageKnipConfig : null;
 };
 const normalizePatternList = (value) => {
 	if (typeof value === "string" && value.length > 0) return [value];
@@ -39978,10 +39978,10 @@ const prefixWorkspacePatterns = (workspacePattern, patterns) => {
 	return patterns.map((pattern) => pattern.startsWith("!") ? `!${normalizedWorkspacePattern}/${pattern.slice(1)}` : `${normalizedWorkspacePattern}/${pattern}`);
 };
 const collectKnipWorkspacePatterns = (workspaces, settingName) => {
-	if (!isRecord$1$1(workspaces)) return [];
+	if (!isRecord$2(workspaces)) return [];
 	const patterns = [];
 	for (const [workspacePattern, workspaceConfig] of Object.entries(workspaces)) {
-		if (!isRecord$1$1(workspaceConfig)) continue;
+		if (!isRecord$2(workspaceConfig)) continue;
 		patterns.push(...prefixWorkspacePatterns(workspacePattern, normalizePatternList(workspaceConfig[settingName])));
 	}
 	return patterns;
@@ -40026,8 +40026,6 @@ const toCanonicalPath = (filePath) => {
 };
 const DEAD_CODE_PLUGIN = "deslop";
 const DEAD_CODE_CATEGORY = "Maintainability";
-const TSCONFIG_FILENAMES$1 = ["tsconfig.json", "tsconfig.base.json"];
-const isRecord$2 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 const DEAD_CODE_WORKER_SCRIPT = `
 const inputChunks = [];
 process.stdin.on("data", (chunk) => inputChunks.push(chunk));
@@ -40085,7 +40083,7 @@ process.stdin.on("end", () => {
 });
 `;
 const resolveTsConfigPath = (rootDirectory) => {
-	for (const filename of TSCONFIG_FILENAMES$1) {
+	for (const filename of TSCONFIG_FILENAMES) {
 		const candidate = Path.join(rootDirectory, filename);
 		if (NFS.existsSync(candidate)) return candidate;
 	}
@@ -41325,8 +41323,8 @@ const buildUserPluginRules = (userPlugin, severityControls) => {
 	}
 	return enabled;
 };
-const createOxlintConfig = ({ pluginPath, project, customRulesOnly = false, extendsPaths = [], ignoredTags = /* @__PURE__ */ new Set(), serverAuthFunctionNames, severityControls, userPlugins = [] }) => {
-	const reactHooksJsPlugin = resolveReactHooksJsPlugin(project.hasReactCompiler, customRulesOnly);
+const createOxlintConfig = ({ pluginPath, project, customRulesOnly = false, extendsPaths = [], ignoredTags = /* @__PURE__ */ new Set(), serverAuthFunctionNames, severityControls, userPlugins = [], disableReactHooksJsPlugin = false }) => {
+	const reactHooksJsPlugin = disableReactHooksJsPlugin ? null : resolveReactHooksJsPlugin(project.hasReactCompiler, customRulesOnly);
 	const reactCompilerRules = reactHooksJsPlugin ? applyRuleSeverityControls(filterRulesToAvailable(REACT_COMPILER_RULES, "react-hooks-js", reactHooksJsPlugin.availableRuleNames), severityControls) : {};
 	const jsPlugins = [];
 	if (reactHooksJsPlugin) jsPlugins.push(reactHooksJsPlugin.entry);
@@ -41386,7 +41384,6 @@ const resolveOxlintBinary = () => {
 	return Path.join(oxlintPackageDirectory, "bin", "oxlint");
 };
 const resolvePluginPath = () => esmRequire.resolve("oxlint-plugin-react-doctor");
-const TSCONFIG_FILENAMES = ["tsconfig.json", "tsconfig.base.json"];
 const resolveTsConfigRelativePath = (rootDirectory) => {
 	for (const filename of TSCONFIG_FILENAMES) if (NFS.existsSync(Path.join(rootDirectory, filename))) return `./${filename}`;
 	return null;
@@ -41758,7 +41755,7 @@ const scopeContainsNonImportBinding = (node, scopeNode, identifierName) => {
 const isIdentifierShadowedByLocalBinding = (identifier, sourceFile) => {
 	let currentNode = identifier.parent;
 	while (currentNode) {
-		if (isScopeNode(currentNode)) {
+		if (isScopeBoundary(currentNode)) {
 			if (scopeContainsNonImportBinding(currentNode, currentNode, identifier.text)) return true;
 		}
 		if (currentNode === sourceFile) return false;
@@ -41849,11 +41846,10 @@ const findResolutionInScope = (scopeNode, identifierName, reactImportBindings, s
 	});
 	return resolution;
 };
-const isScopeNode = isScopeBoundary;
 const resolveIdentifierBinding = (identifier, reactImportBindings, sourceFile, visitedDeclarations = /* @__PURE__ */ new Set()) => {
 	let currentNode = identifier.parent;
 	while (currentNode) {
-		if (isScopeNode(currentNode)) {
+		if (isScopeBoundary(currentNode)) {
 			const resolution = findResolutionInScope(currentNode, identifier.text, reactImportBindings, sourceFile, visitedDeclarations);
 			if (resolution) return resolution;
 		}
@@ -42023,9 +42019,9 @@ const parseOxlintOutput = (stdout, project, rootDirectory) => {
 	try {
 		parsed = JSON.parse(sanitizedStdout);
 	} catch {
-		throw new ReactDoctorError({ reason: new OxlintOutputUnparseable({ preview: stdout.slice(0, 200) }) });
+		throw new ReactDoctorError({ reason: new OxlintOutputUnparseable({ preview: stdout.slice(0, 600) }) });
 	}
-	if (!isOxlintOutput(parsed)) throw new ReactDoctorError({ reason: new OxlintOutputUnparseable({ preview: stdout.slice(0, 200) }) });
+	if (!isOxlintOutput(parsed)) throw new ReactDoctorError({ reason: new OxlintOutputUnparseable({ preview: stdout.slice(0, 600) }) });
 	const minifiedFileCache = /* @__PURE__ */ new Map();
 	const isMinifiedDiagnosticFile = (filename) => {
 		const absolutePath = Path.isAbsolute(filename) ? filename : Path.resolve(rootDirectory || ".", filename);
@@ -42316,6 +42312,28 @@ const writeOxlintConfig = (configPath, configToWrite) => {
 		NFS.closeSync(fileHandle);
 	}
 };
+const REACT_HOOKS_JS_DROP_PREFIX = "React Compiler rules (react-hooks-js/*) skipped — eslint-plugin-react-hooks failed to load in this environment";
+/**
+* Detects an oxlint config-load crash caused by the optional
+* `react-hooks-js` (eslint-plugin-react-hooks) React Compiler plugin and
+* builds the partial-failure note for it; returns `null` when the failure
+* was anything else.
+*
+* oxlint prints a framed error to stdout (not stderr) and exits non-zero
+* when a `jsPlugins` entry can't be imported; that non-JSON stdout
+* surfaces as `OxlintOutputUnparseable`. Because oxlint fails the WHOLE
+* config load on it, leaving the plugin in would drop every curated
+* react-doctor diagnostic too — so the caller retries with the plugin
+* stripped (issue #833). Both markers sit at the start of oxlint's
+* message, so they survive the `preview` slice even for deep pnpm paths.
+*/
+const reactHooksJsPluginDropNote = (error) => {
+	if (!(error instanceof ReactDoctorError) || error.reason._tag !== "OxlintOutputUnparseable") return null;
+	const { preview } = error.reason;
+	if (!preview.includes("Failed to load JS plugin") || !preview.includes("eslint-plugin-react-hooks")) return null;
+	const underlyingReason = preview.match(/Error:[^\n]*/)?.[0]?.trim();
+	return `${REACT_HOOKS_JS_DROP_PREFIX}${underlyingReason ? `: ${underlyingReason}` : ""}. Other rules ran normally.`;
+};
 /**
 * The oxlint runner. Composed of three pieces in `runners/oxlint/`:
 *
@@ -42343,15 +42361,16 @@ const runOxlint = async (options) => {
 	const pluginPath = resolvePluginPath();
 	const extendsPaths = (adoptExistingLintConfig && !customRulesOnly ? detectUserLintConfigPaths(rootDirectory) : []).filter(canOxlintExtendConfig);
 	const userPlugins = resolveUserPlugins(userConfig?.plugins, configSourceDirectory);
-	const buildConfig = (extendsForThisAttempt) => createOxlintConfig({
+	const buildConfig = (overrides) => createOxlintConfig({
 		pluginPath,
 		project,
 		customRulesOnly,
-		extendsPaths: extendsForThisAttempt,
+		extendsPaths: overrides.extendsPaths,
 		ignoredTags,
 		serverAuthFunctionNames,
 		severityControls,
-		userPlugins
+		userPlugins,
+		disableReactHooksJsPlugin: overrides.disableReactHooksJsPlugin
 	});
 	const restoreDisableDirectives = respectInlineDisables ? () => {} : await neutralizeDisableDirectives(rootDirectory, includePaths);
 	const configDirectory = NFS.mkdtempSync(Path.join(os.tmpdir(), "react-doctor-oxlintrc-"));
@@ -42387,12 +42406,22 @@ const runOxlint = async (options) => {
 			outputMaxBytes,
 			concurrency: options.concurrency
 		});
-		writeOxlintConfig(configPath, buildConfig(extendsPaths));
+		writeOxlintConfig(configPath, buildConfig({ extendsPaths }));
 		try {
 			return await runBatches();
 		} catch (error) {
+			const reactHooksJsDropNote = reactHooksJsPluginDropNote(error);
+			if (reactHooksJsDropNote !== null) {
+				writeOxlintConfig(configPath, buildConfig({
+					extendsPaths,
+					disableReactHooksJsPlugin: true
+				}));
+				const diagnostics = await runBatches();
+				onPartialFailure?.(reactHooksJsDropNote);
+				return diagnostics;
+			}
 			if (extendsPaths.length === 0) throw error;
-			writeOxlintConfig(configPath, buildConfig([]));
+			writeOxlintConfig(configPath, buildConfig({ extendsPaths: [] }));
 			return await runBatches();
 		}
 	} finally {
@@ -43844,7 +43873,7 @@ const FALSY_CI_FLAG_VALUES = new Set([
 	"false"
 ]);
 const isCiFlagSet = (value) => value !== void 0 && !FALSY_CI_FLAG_VALUES.has(value.toLowerCase());
-const isCiEnvironment = () => CI_ENVIRONMENT_VARIABLES.some((environmentVariable) => Boolean(process.env[environmentVariable])) || isCiFlagSet(process.env.CI);
+const isCiEnvironment = (env = process.env) => CI_ENVIRONMENT_VARIABLES.some((environmentVariable) => Boolean(env[environmentVariable])) || isCiFlagSet(env.CI);
 const detectCiProvider = () => {
 	for (const [environmentVariable, provider] of CI_PROVIDER_BY_ENVIRONMENT_VARIABLE) if (process.env[environmentVariable]) return provider;
 	return isCiFlagSet(process.env.CI) ? "unknown" : null;
@@ -43869,6 +43898,42 @@ const detectCodingAgent = () => {
 const isCodingAgentEnvironment = () => detectCodingAgent() !== null;
 const isCiOrCodingAgentEnvironment = () => isCiEnvironment() || isCodingAgentEnvironment();
 //#endregion
+//#region src/cli/utils/detect-terminal-kind.ts
+const TERMINAL_BY_TERM_PROGRAM = [
+	["vscode", "vscode"],
+	["iTerm.app", "iterm"],
+	["Apple_Terminal", "apple-terminal"],
+	["WezTerm", "wezterm"],
+	["ghostty", "ghostty"],
+	["Hyper", "hyper"],
+	["Tabby", "tabby"],
+	["rio", "rio"]
+];
+/**
+* Best-effort label for the terminal emulator / editor hosting the CLI,
+* derived from terminal-identity env vars. Recorded as the `terminalKind` run
+* tag so we can see where React Doctor is actually run (nvim, VS Code, iTerm,
+* …) — the split Sentry can't otherwise see. Low-cardinality and free of any
+* username/path/secret, so it's safe as a tag. Editor terminals (nvim/vim)
+* win over the outer emulator because that's the surface a user is reading in;
+* "ci" marks a run with no interactive terminal; "unknown" when nothing matches.
+*/
+const detectTerminalKind = (env = process.env) => {
+	if (env.NVIM) return "neovim";
+	if (env.VIM_TERMINAL) return "vim";
+	const termProgram = env.TERM_PROGRAM;
+	if (termProgram) {
+		for (const [marker, label] of TERMINAL_BY_TERM_PROGRAM) if (termProgram === marker) return label;
+	}
+	if (env.KITTY_WINDOW_ID || env.TERM === "xterm-kitty") return "kitty";
+	if (env.WT_SESSION) return "windows-terminal";
+	if (env.ALACRITTY_WINDOW_ID || env.TERM === "alacritty") return "alacritty";
+	if (env.VTE_VERSION) return "vte";
+	if (env.TMUX) return "tmux";
+	if (isCiEnvironment(env)) return "ci";
+	return "unknown";
+};
+//#endregion
 //#region src/cli/utils/is-git-hook-environment.ts
 const isGitHookEnvironment = () => Boolean(process.env.GIT_DIR);
 //#endregion
@@ -43891,6 +43956,7 @@ const NON_INTERACTIVE_ENVIRONMENT_VARIABLES = [
 const isNonInteractiveEnvironment = () => NON_INTERACTIVE_ENVIRONMENT_VARIABLES.some((envVariable) => Boolean(process.env[envVariable])) || isCodingAgentEnvironment();
 //#endregion
 //#region src/cli/utils/constants.ts
+const REACT_DOCTOR_CONFIG_PROJECT_NAME = "react-doctor";
 const STAGED_FILES_TEMP_DIR_PREFIX = "react-doctor-staged-";
 const BASELINE_FILES_TEMP_DIR_PREFIX = "react-doctor-baseline-";
 const GH_DEFAULT_BRANCH_PROBE_TIMEOUT_MS = 5e3;
@@ -43975,7 +44041,7 @@ const makeNoopConsole = () => ({
 });
 //#endregion
 //#region src/cli/utils/version.ts
-const VERSION = "0.5.6-dev.eafac9d";
+const VERSION = "0.5.6-dev.ed0258c";
 //#endregion
 //#region src/cli/utils/json-mode.ts
 let context = null;
@@ -44125,6 +44191,7 @@ const buildRunContext = () => {
 		viaAction: isOfficialGithubAction(),
 		codingAgent: detectCodingAgent(),
 		interactive: !isNonInteractiveEnvironment(),
+		terminalKind: detectTerminalKind(),
 		jsonMode: isJsonModeActive(),
 		invokedVia: detectInvokedVia()
 	};
@@ -44195,6 +44262,7 @@ const buildSentryScope = (runContext = buildRunContext()) => {
 		viaAction: runContext.viaAction,
 		codingAgent: runContext.codingAgent,
 		interactive: runContext.interactive,
+		terminalKind: runContext.terminalKind,
 		jsonMode: runContext.jsonMode,
 		invokedVia: runContext.invokedVia,
 		nodeMajor: runContext.nodeMajor
@@ -44333,13 +44401,13 @@ const isDevVersion = (version) => version === "0.0.0" || version.includes("-");
 * uploads source-map artifacts under, so stack frames symbolicate. Honors the
 * standard `SENTRY_RELEASE` override.
 */
-const resolveSentryRelease = () => process.env.SENTRY_RELEASE || `react-doctor@0.5.6-dev.eafac9d`;
+const resolveSentryRelease = () => process.env.SENTRY_RELEASE || `react-doctor@0.5.6-dev.ed0258c`;
 /**
 * Deployment environment shown in Sentry's environment filter. Defaults to
 * `production` for tagged releases and `development` for dev/unbuilt versions,
 * overridable via the standard `SENTRY_ENVIRONMENT` env var.
 */
-const resolveSentryEnvironment = () => process.env.SENTRY_ENVIRONMENT || (isDevVersion("0.5.6-dev.eafac9d") ? "development" : "production");
+const resolveSentryEnvironment = () => process.env.SENTRY_ENVIRONMENT || (isDevVersion("0.5.6-dev.ed0258c") ? "development" : "production");
 /**
 * Performance-tracing sample rate in `[0, 1]`. Reads `SENTRY_TRACES_SAMPLE_RATE`
 * (set to `0` to disable tracing) and falls back to
@@ -48196,6 +48264,15 @@ const boxText = (content, innerWidth) => {
 	].join("\n");
 };
 //#endregion
+//#region src/cli/utils/resolve-absolute-path.ts
+/**
+* Resolves a diagnostic's `filePath` (relative to its project root, or
+* already absolute) to an absolute path. Shared by the code-frame reader and
+* the terminal hyperlink builder so both turn a relative path into the same
+* on-disk location.
+*/
+const resolveAbsolutePath = (filePath, rootDirectory) => Path.isAbsolute(filePath) ? filePath : Path.resolve(rootDirectory || ".", filePath);
+//#endregion
 //#region src/cli/utils/build-code-frame.ts
 /**
 * Renders a syntax-highlighted source excerpt around a diagnostic site
@@ -48206,7 +48283,7 @@ const boxText = (content, innerWidth) => {
 */
 const buildCodeFrame = (input) => {
 	if (input.line <= 0) return null;
-	const absolutePath = Path.isAbsolute(input.filePath) ? input.filePath : Path.resolve(input.rootDirectory || ".", input.filePath);
+	const absolutePath = resolveAbsolutePath(input.filePath, input.rootDirectory);
 	let source;
 	try {
 		source = NFS.readFileSync(absolutePath, "utf8");
@@ -48246,6 +48323,16 @@ const resolveMeasureWidth = (reservedColumns = 0) => resolveClampedWidth({
 const DIVIDER_INDENT = "  ";
 const buildSectionDivider = () => highlighter.dim(`${DIVIDER_INDENT}${"─".repeat(resolveMeasureWidth(2))}`);
 //#endregion
+//#region src/cli/utils/format-hyperlink.ts
+const OSC = "\x1B]";
+const ST = "\x1B\\";
+/**
+* Wraps `text` in an OSC 8 hyperlink pointing at `uri`. The visible characters
+* are exactly `text`; the link is carried in escape sequences a capable
+* terminal turns into a click target.
+*/
+const formatHyperlink = (text, uri) => `${OSC}8;;${uri}${ST}${text}${OSC}8;;${ST}`;
+//#endregion
 //#region src/cli/utils/indent-multiline-text.ts
 const indentMultilineText = (text, linePrefix) => text.split("\n").map((lineText) => `${linePrefix}${lineText}`).join("\n");
 //#endregion
@@ -48399,17 +48486,23 @@ const clusterNearbyDiagnostics = (diagnostics) => {
 	}
 	return clusters;
 };
-const formatClusterLocation = (cluster) => {
+const formatClusterLocationText = (cluster) => {
+	const { filePath } = cluster.diagnostics[0];
+	if (cluster.startLine <= 0) return filePath;
+	if (cluster.endLine > cluster.startLine) return `${filePath}:${cluster.startLine}-${cluster.endLine}`;
+	return `${filePath}:${cluster.startLine}`;
+};
+const formatClusterLocation = (cluster, resolveSourceRoot, hyperlinks) => {
 	const lead = cluster.diagnostics[0];
 	const contextTag = formatFileContextTag(lead);
-	if (cluster.startLine <= 0) return `${lead.filePath}${contextTag}`;
-	if (cluster.endLine > cluster.startLine) return `${lead.filePath}:${cluster.startLine}-${cluster.endLine}${contextTag}`;
-	return `${lead.filePath}:${cluster.startLine}${contextTag}`;
+	const location = formatClusterLocationText(cluster);
+	if (!hyperlinks) return `${location}${contextTag}`;
+	return `${formatHyperlink(location, pathToFileURL(resolveAbsolutePath(lead.filePath, resolveSourceRoot(lead))).href)}${contextTag}`;
 };
-const buildDiagnosticClusterLines = (cluster, resolveSourceRoot, renderCodeFrame) => {
+const buildDiagnosticClusterLines = (cluster, resolveSourceRoot, renderCodeFrame, hyperlinks) => {
 	const lead = cluster.diagnostics[0];
 	const isMultiSite = cluster.diagnostics.length > 1;
-	const lines = ["", highlighter.gray(`${TOP_ERROR_DETAIL_INDENT}${formatClusterLocation(cluster)}`)];
+	const lines = ["", highlighter.gray(`${TOP_ERROR_DETAIL_INDENT}${formatClusterLocation(cluster, resolveSourceRoot, hyperlinks)}`)];
 	const codeFrame = renderCodeFrame ? buildCodeFrame({
 		filePath: lead.filePath,
 		line: cluster.startLine,
@@ -48428,7 +48521,7 @@ const buildDiagnosticClusterLines = (cluster, resolveSourceRoot, renderCodeFrame
 	}
 	return lines;
 };
-const buildRuleDetailBlock = (ruleKey, ruleDiagnostics, resolveSourceRoot, renderEverySite, isAgentEnvironment) => {
+const buildRuleDetailBlock = (ruleKey, ruleDiagnostics, resolveSourceRoot, renderEverySite, isAgentEnvironment, hyperlinks) => {
 	const representative = pickRepresentativeDiagnostic(ruleDiagnostics);
 	const { severity } = representative;
 	const trailingBadge = formatTrailingSiteBadge(ruleDiagnostics.length);
@@ -48448,7 +48541,7 @@ const buildRuleDetailBlock = (ruleKey, ruleDiagnostics, resolveSourceRoot, rende
 	}
 	const renderCodeFrame = severity === "error";
 	const sites = renderEverySite ? ruleDiagnostics : [representative];
-	if (!(isCollapsedWarningGroup && representative.help.includes(representative.filePath))) for (const cluster of clusterNearbyDiagnostics(sites)) lines.push(...buildDiagnosticClusterLines(cluster, resolveSourceRoot, renderCodeFrame));
+	if (!(isCollapsedWarningGroup && representative.help.includes(representative.filePath))) for (const cluster of clusterNearbyDiagnostics(sites)) lines.push(...buildDiagnosticClusterLines(cluster, resolveSourceRoot, renderCodeFrame, hyperlinks));
 	return lines;
 };
 const selectErrorRuleGroups = (diagnostics, rulePriority) => buildSortedRuleGroups(diagnostics.filter((diagnostic) => diagnostic.severity === "error"), rulePriority);
@@ -48461,7 +48554,7 @@ const buildOverflowSummaryLine = (diagnostics, rulePriority) => {
 	return `  ${highlighter.dim("Run")} ${command} ${highlighter.dim("to list every error and warning")}`;
 };
 const getTopErrorRuleKeys = (diagnostics, limit, rulePriority) => new Set(selectTopErrorRuleGroups(diagnostics, limit, rulePriority).map(([ruleKey]) => ruleKey));
-const buildTopErrorsSection = (diagnostics, resolveSourceRoot, rulePriority) => {
+const buildTopErrorsSection = (diagnostics, resolveSourceRoot, hyperlinks, rulePriority) => {
 	const topRuleGroups = selectErrorRuleGroups(diagnostics, rulePriority).slice(0, 3);
 	if (topRuleGroups.length === 0) return {
 		lines: [],
@@ -48471,7 +48564,7 @@ const buildTopErrorsSection = (diagnostics, resolveSourceRoot, rulePriority) =>
 	const blockOffsets = [];
 	for (const [ruleKey, ruleDiagnostics] of topRuleGroups) {
 		blockOffsets.push(lines.length);
-		lines.push(...buildRuleDetailBlock(ruleKey, ruleDiagnostics, resolveSourceRoot, false, false));
+		lines.push(...buildRuleDetailBlock(ruleKey, ruleDiagnostics, resolveSourceRoot, false, false, hyperlinks));
 		lines.push("");
 	}
 	return {
@@ -48509,18 +48602,18 @@ const buildOverviewHeaderLines = (diagnostics) => {
 * single Effect.forEach over Console.log so failures or fiber
 * interruption produce predictable partial output.
 */
-const printDiagnostics = (diagnostics, isVerbose, sourceRoot, rulePriority, isAgentEnvironment = false, onboarding = {}) => gen(function* () {
+const printDiagnostics = (diagnostics, isVerbose, sourceRoot, rulePriority, isAgentEnvironment = false, onboarding = {}, hyperlinks = false) => gen(function* () {
 	const sectionPause = onboarding.sectionPause ?? void_;
 	const animateCountUp = onboarding.animateCountUp ?? false;
 	const resolveSourceRoot = typeof sourceRoot === "function" ? sourceRoot : () => sourceRoot;
 	let detailLines;
 	let topErrorBlockOffsets = [];
 	if (!isVerbose) {
-		const topErrors = buildTopErrorsSection(diagnostics, resolveSourceRoot, rulePriority);
+		const topErrors = buildTopErrorsSection(diagnostics, resolveSourceRoot, hyperlinks, rulePriority);
 		detailLines = topErrors.lines;
 		topErrorBlockOffsets = topErrors.blockOffsets;
 	} else detailLines = buildSortedRuleGroups(diagnostics, rulePriority).flatMap(([ruleKey, ruleDiagnostics]) => {
-		return [...buildRuleDetailBlock(ruleKey, ruleDiagnostics, resolveSourceRoot, true, isAgentEnvironment), ""];
+		return [...buildRuleDetailBlock(ruleKey, ruleDiagnostics, resolveSourceRoot, true, isAgentEnvironment, hyperlinks), ""];
 	});
 	const overflowLine = isVerbose ? void 0 : buildOverflowSummaryLine(diagnostics, rulePriority);
 	const categoryTallies = buildCategoryDiagnosticGroups(diagnostics, rulePriority).map(buildCategoryTally);
@@ -48581,6 +48674,48 @@ const computeProjectedScore = async (topErrorSource, rescoreSource, currentScore
 //#endregion
 //#region src/cli/utils/filter-diagnostics-by-categories.ts
 const filterDiagnosticsByCategories = (diagnostics, categories) => categories.size === 0 ? [...diagnostics] : diagnostics.filter((diagnostic) => categories.has(diagnostic.category));
+//#endregion
+//#region src/cli/utils/supports-hyperlinks.ts
+const HYPERLINK_CAPABLE_TERM_PROGRAMS = new Set([
+	"iTerm.app",
+	"WezTerm",
+	"vscode",
+	"Hyper",
+	"ghostty",
+	"Tabby",
+	"rio"
+]);
+const parseVteVersion = (raw) => {
+	const parsed = Number.parseInt(raw ?? "", 10);
+	return Number.isNaN(parsed) ? 0 : parsed;
+};
+/**
+* Whether `stream` is a terminal that renders OSC 8 hyperlinks. Auto-detected
+* from terminal-identity env vars; the de-facto `FORCE_HYPERLINK` env var
+* overrides detection (`FORCE_HYPERLINK=0`/`false` forces off, any other value
+* forces on), mirroring how the ecosystem's terminal libraries gate the same
+* feature. Off for non-TTYs, `TERM=dumb`, and CI (whose log viewers render the
+* raw escape rather than a link). Unknown terminals default to off.
+*/
+const supportsHyperlinks = (stream = process.stdout, env = process.env) => {
+	const forced = env.FORCE_HYPERLINK;
+	if (forced !== void 0 && forced !== "") return forced !== "0" && forced.toLowerCase() !== "false";
+	if (stream.isTTY !== true) return false;
+	if (env.TERM === "dumb") return false;
+	if (isCiEnvironment(env)) return false;
+	if (env.WT_SESSION) return true;
+	if (env.KITTY_WINDOW_ID || env.TERM === "xterm-kitty") return true;
+	if (parseVteVersion(env.VTE_VERSION) >= 5e3) return true;
+	return Boolean(env.TERM_PROGRAM && HYPERLINK_CAPABLE_TERM_PROGRAMS.has(env.TERM_PROGRAM));
+};
+//#endregion
+//#region src/cli/utils/should-render-hyperlinks.ts
+/**
+* Whether to emit OSC 8 clickable `file:line` locations for this run: a
+* hyperlink-capable terminal AND not a coding agent (whose output parsers
+* would choke on the escape sequences).
+*/
+const shouldRenderHyperlinks = (stream = process.stdout) => supportsHyperlinks(stream) && !isCodingAgentEnvironment();
 const FORCE_ONBOARDING_ENV_VAR = "REACT_DOCTOR_FORCE_ONBOARDING";
 const FALSY_FLAG_VALUES = new Set([
 	"",
@@ -48600,10 +48735,9 @@ const canAnimateOnboarding = (stream = process.stdout) => {
 };
 //#endregion
 //#region src/cli/utils/onboarding-state.ts
-const GLOBAL_CONFIG_PROJECT_NAME$2 = "react-doctor";
 const ONBOARDED_AT_KEY = "onboardedAt";
 const getOnboardingStore = (options = {}) => new Conf({
-	projectName: GLOBAL_CONFIG_PROJECT_NAME$2,
+	projectName: REACT_DOCTOR_CONFIG_PROJECT_NAME,
 	cwd: options.cwd
 });
 const hasCompletedOnboarding = (options = {}) => {
@@ -49059,6 +49193,78 @@ const resolveCliCategories = (categoryFlag) => {
 	return resolvedCategories.length > 0 ? resolvedCategories : void 0;
 };
 //#endregion
+//#region src/cli/utils/git-hook-shared.ts
+const HOOK_FILE_NAME = "pre-commit";
+const HOOK_RELATIVE_PATH = "hooks/pre-commit";
+const LEGACY_HOOK_RUNNER_RELATIVE_PATH = ".react-doctor/hooks/pre-commit";
+const HUSKY_HOOKS_PATH = ".husky";
+const VITE_PLUS_HOOKS_PATH = ".vite-hooks";
+const LEFTHOOK_CONFIG_FILES = ["lefthook.yml", "lefthook.yaml"];
+const PRE_COMMIT_CONFIG_FILE = ".pre-commit-config.yaml";
+const OVERCOMMIT_CONFIG_FILE = ".overcommit.yml";
+const REACT_DOCTOR_COMMAND = "react-doctor --staged --blocking warning";
+const NON_BLOCKING_REACT_DOCTOR_COMMAND = [
+	"react_doctor_output=$(mktemp \"${TMPDIR:-/tmp}/react-doctor-hook.XXXXXX\");",
+	`if ${REACT_DOCTOR_COMMAND} > "$react_doctor_output" 2>&1; then`,
+	"rm -f \"$react_doctor_output\";",
+	"else",
+	"rm -f \"$react_doctor_output\";",
+	`printf "%s\\n" "React Doctor found staged regressions." "Run ${REACT_DOCTOR_COMMAND} to inspect." "Want them fixed? Ask your agent to run that command and resolve the findings." >&2;`,
+	"fi"
+].join(" ");
+const PACKAGE_JSON_FILE_NAME = "package.json";
+const runGit = (projectRoot, args) => {
+	try {
+		return execFileSync("git", [...args], {
+			cwd: projectRoot,
+			encoding: "utf8",
+			stdio: [
+				"ignore",
+				"pipe",
+				"ignore"
+			]
+		}).trim();
+	} catch {
+		return null;
+	}
+};
+const resolveGitPath = (baseDirectory, value) => Path.isAbsolute(value) ? value : Path.resolve(baseDirectory, value);
+const isRecord$1 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const getPackageJsonPath = (projectRoot) => Path.join(projectRoot, PACKAGE_JSON_FILE_NAME);
+const readPackageJson = (projectRoot) => {
+	try {
+		return JSON.parse(NFS.readFileSync(getPackageJsonPath(projectRoot), "utf8"));
+	} catch {
+		return null;
+	}
+};
+const writeJsonFile$1 = (filePath, value) => {
+	NFS.writeFileSync(filePath, `${JSON.stringify(value, null, 2)}\n`);
+};
+const packageHasDependency = (projectRoot, dependencyName) => {
+	const packageJson = readPackageJson(projectRoot);
+	if (!isRecord$1(packageJson)) return false;
+	return [
+		"dependencies",
+		"devDependencies",
+		"optionalDependencies"
+	].some((fieldName) => {
+		const dependencies = packageJson[fieldName];
+		return isRecord$1(dependencies) && typeof dependencies[dependencyName] === "string";
+	});
+};
+const packageHasRecordKey = (projectRoot, key) => {
+	const packageJson = readPackageJson(projectRoot);
+	return isRecord$1(packageJson) && isRecord$1(packageJson[key]);
+};
+const packageHasNestedRecordKey = (projectRoot, key, nestedKey) => {
+	const packageJson = readPackageJson(projectRoot);
+	if (!isRecord$1(packageJson)) return false;
+	const value = packageJson[key];
+	return isRecord$1(value) && isRecord$1(value[nestedKey]);
+};
+const ensureTrailingNewline = (content) => content.endsWith("\n") ? content : `${content}\n`;
+//#endregion
 //#region src/cli/utils/scan-result-cache.ts
 const CACHE_DISABLED_VALUES = new Set(["1", "true"]);
 const TOOLCHAIN_PACKAGE_SPECIFIERS = [
@@ -49069,7 +49275,7 @@ const TOOLCHAIN_PACKAGE_SPECIFIERS = [
 	"eslint-plugin-react-hooks/package.json"
 ];
 const bundledRequire = createRequire(import.meta.url);
-const isRecord$1 = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 const normalizeForStableJson = (value) => {
 	if (value === null) return null;
 	if (value === void 0) return void 0;
@@ -49098,24 +49304,9 @@ const stringifyStableJson = (value) => {
 	}
 };
 const hashString = (value) => crypto.createHash("sha1").update(value).digest("hex");
-const runGit$1 = (directory, args) => {
-	try {
-		return execFileSync("git", [...args], {
-			cwd: directory,
-			encoding: "utf8",
-			stdio: [
-				"ignore",
-				"pipe",
-				"ignore"
-			]
-		}).trim();
-	} catch {
-		return null;
-	}
-};
-const readHeadSha = (projectDirectory) => runGit$1(projectDirectory, ["rev-parse", "HEAD"]);
+const readHeadSha = (projectDirectory) => runGit(projectDirectory, ["rev-parse", "HEAD"]);
 const isWorktreeClean = (projectDirectory) => {
-	const status = runGit$1(projectDirectory, [
+	const status = runGit(projectDirectory, [
 		"status",
 		"--porcelain=v1",
 		"--untracked-files=normal"
@@ -49123,7 +49314,7 @@ const isWorktreeClean = (projectDirectory) => {
 	return status !== null && status.length === 0;
 };
 const hasHiddenTrackedFileState = (projectDirectory) => {
-	const output = runGit$1(projectDirectory, ["ls-files", "-v"]);
+	const output = runGit(projectDirectory, ["ls-files", "-v"]);
 	if (output === null) return true;
 	return output.split("\n").some((line) => line.length > 0 && line[0] !== "H");
 };
@@ -49136,7 +49327,7 @@ const resolveCacheFilePath = (projectDirectory) => {
 const readPersistedCache = (cacheFilePath) => {
 	try {
 		const parsed = JSON.parse(fs.readFileSync(cacheFilePath, "utf8"));
-		if (!isRecord$1(parsed) || parsed.version !== 1) return {
+		if (!isRecord(parsed) || parsed.version !== 1) return {
 			version: 1,
 			entries: []
 		};
@@ -49146,8 +49337,8 @@ const readPersistedCache = (cacheFilePath) => {
 		};
 		const entries = [];
 		for (const entry of parsed.entries) {
-			if (!isRecord$1(entry) || typeof entry.key !== "string" || typeof entry.createdAtMs !== "number") continue;
-			if (!isRecord$1(entry.payload) || !Array.isArray(entry.payload.diagnostics)) continue;
+			if (!isRecord(entry) || typeof entry.key !== "string" || typeof entry.createdAtMs !== "number") continue;
+			if (!isRecord(entry.payload) || !Array.isArray(entry.payload.diagnostics)) continue;
 			entries.push(entry);
 		}
 		return {
@@ -49679,6 +49870,7 @@ const finalizeAndRender = (input) => gen(function* () {
 	}
 	const animateRender = !options.silent && !options.verbose && canAnimateOnboarding(process.stdout);
 	const pause = onboardingSectionPause(animateRender);
+	const useHyperlinks = shouldRenderHyperlinks(process.stdout);
 	const demotedDiagnosticCount = diagnostics.length - surfaceDiagnostics.length;
 	const lintSourceFileCount = options.includePaths.length > 0 ? options.includePaths.length : project.sourceFileCount;
 	if (printedDiagnostics.length === 0) {
@@ -49704,7 +49896,7 @@ const finalizeAndRender = (input) => gen(function* () {
 	yield* printDiagnostics([...printedDiagnostics], options.verbose, directory, buildRulePriorityMap([score]), isCodingAgentEnvironment(), {
 		sectionPause: pause,
 		animateCountUp: animateRender
-	});
+	}, useHyperlinks);
 	if (options.isNonInteractiveEnvironment && options.outputSurface !== "prComment") yield* printAgentGuidance();
 	if (options.categoryFilters.size === 0 && demotedDiagnosticCount > 0) {
 		yield* log(highlighter.gray(`  ${demotedDiagnosticCount} demoted from the ${options.outputSurface} surface (e.g. design cleanup) — run \`npx react-doctor@latest .\` locally for the full list.`));
@@ -49897,16 +50089,7 @@ const buildHandoffPayload = (input) => {
 	try {
 		outputDirectory = writeDiagnosticsDirectory([...input.diagnostics], input.outputDirectory);
 	} catch {}
-	const lines = [
-		"Before fixing anything, first ask me whether I'd like to add React Doctor to CI so every pull request is scanned automatically. Explain that:",
-		`- It's used by teams at ${CI_TRUST_COMPANIES}.`,
-		"- I don't have to fix everything at once; CI keeps new PRs clean while I incrementally pay down the existing issues.",
-		`- Setup guide: ${CI_URL}`,
-		"If I say yes, run `npx react-doctor install` (or add the GitHub Actions workflow). Either way, then continue with the fixes below.",
-		"",
-		`Fix the top ${topGroups.length} React Doctor ${topGroups.length === 1 ? "issue" : "issues"} in ${input.projectName} on this pass — leave the rest for a follow-up.`,
-		""
-	];
+	const lines = [`Fix the top ${topGroups.length} React Doctor ${topGroups.length === 1 ? "issue" : "issues"} in ${input.projectName} on this pass — leave the rest for a follow-up.`, ""];
 	topGroups.forEach(([ruleKey, ruleDiagnostics], index) => {
 		const representative = ruleDiagnostics[0];
 		const severityLabel = representative.severity === "error" ? "ERROR" : "WARN";
@@ -49967,78 +50150,6 @@ const detectAvailableAgents = async () => {
 	return getSkillAgentTypes().filter((agent) => agent !== "universal" && detected.has(agent));
 };
 //#endregion
-//#region src/cli/utils/git-hook-shared.ts
-const HOOK_FILE_NAME = "pre-commit";
-const HOOK_RELATIVE_PATH = "hooks/pre-commit";
-const LEGACY_HOOK_RUNNER_RELATIVE_PATH = ".react-doctor/hooks/pre-commit";
-const HUSKY_HOOKS_PATH = ".husky";
-const VITE_PLUS_HOOKS_PATH = ".vite-hooks";
-const LEFTHOOK_CONFIG_FILES = ["lefthook.yml", "lefthook.yaml"];
-const PRE_COMMIT_CONFIG_FILE = ".pre-commit-config.yaml";
-const OVERCOMMIT_CONFIG_FILE = ".overcommit.yml";
-const REACT_DOCTOR_COMMAND = "react-doctor --staged --blocking warning";
-const NON_BLOCKING_REACT_DOCTOR_COMMAND = [
-	"react_doctor_output=$(mktemp \"${TMPDIR:-/tmp}/react-doctor-hook.XXXXXX\");",
-	`if ${REACT_DOCTOR_COMMAND} > "$react_doctor_output" 2>&1; then`,
-	"rm -f \"$react_doctor_output\";",
-	"else",
-	"rm -f \"$react_doctor_output\";",
-	`printf "%s\\n" "React Doctor found staged regressions." "Run ${REACT_DOCTOR_COMMAND} to inspect." "Want them fixed? Ask your agent to run that command and resolve the findings." >&2;`,
-	"fi"
-].join(" ");
-const PACKAGE_JSON_FILE_NAME = "package.json";
-const runGit = (projectRoot, args) => {
-	try {
-		return execFileSync("git", [...args], {
-			cwd: projectRoot,
-			encoding: "utf8",
-			stdio: [
-				"ignore",
-				"pipe",
-				"ignore"
-			]
-		}).trim();
-	} catch {
-		return null;
-	}
-};
-const resolveGitPath = (baseDirectory, value) => Path.isAbsolute(value) ? value : Path.resolve(baseDirectory, value);
-const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-const getPackageJsonPath = (projectRoot) => Path.join(projectRoot, PACKAGE_JSON_FILE_NAME);
-const readPackageJson = (projectRoot) => {
-	try {
-		return JSON.parse(NFS.readFileSync(getPackageJsonPath(projectRoot), "utf8"));
-	} catch {
-		return null;
-	}
-};
-const writeJsonFile$1 = (filePath, value) => {
-	NFS.writeFileSync(filePath, `${JSON.stringify(value, null, 2)}\n`);
-};
-const packageHasDependency = (projectRoot, dependencyName) => {
-	const packageJson = readPackageJson(projectRoot);
-	if (!isRecord(packageJson)) return false;
-	return [
-		"dependencies",
-		"devDependencies",
-		"optionalDependencies"
-	].some((fieldName) => {
-		const dependencies = packageJson[fieldName];
-		return isRecord(dependencies) && typeof dependencies[dependencyName] === "string";
-	});
-};
-const packageHasRecordKey = (projectRoot, key) => {
-	const packageJson = readPackageJson(projectRoot);
-	return isRecord(packageJson) && isRecord(packageJson[key]);
-};
-const packageHasNestedRecordKey = (projectRoot, key, nestedKey) => {
-	const packageJson = readPackageJson(projectRoot);
-	if (!isRecord(packageJson)) return false;
-	const value = packageJson[key];
-	return isRecord(value) && isRecord(value[nestedKey]);
-};
-const ensureTrailingNewline = (content) => content.endsWith("\n") ? content : `${content}\n`;
-//#endregion
 //#region src/cli/utils/install-doctor-script.ts
 const DOCTOR_SCRIPT_NAME = "doctor";
 const FALLBACK_DOCTOR_SCRIPT_NAME = "react-doctor";
@@ -50064,31 +50175,31 @@ const findNearestPackageDirectory = (startDirectory, stopDirectory) => {
 };
 const hasDoctorScript = (projectRoot) => {
 	const packageJson = readPackageJson(findNearestPackageDirectory(projectRoot) ?? projectRoot);
-	if (!isRecord(packageJson)) return false;
+	if (!isRecord$1(packageJson)) return false;
 	const scripts = packageJson.scripts;
-	if (!isRecord(scripts)) return false;
+	if (!isRecord$1(scripts)) return false;
 	return isReactDoctorScriptCommand(scripts[DOCTOR_SCRIPT_NAME]) || isReactDoctorScriptCommand(scripts[FALLBACK_DOCTOR_SCRIPT_NAME]);
 };
 const hasDoctorDependency = (packageJson) => DEPENDENCY_FIELD_NAMES.some((fieldName) => {
 	const dependencies = packageJson[fieldName];
-	return isRecord(dependencies) && Object.hasOwn(dependencies, "react-doctor");
+	return isRecord$1(dependencies) && Object.hasOwn(dependencies, "react-doctor");
 });
 const installDoctorScript = (options) => {
 	const packageDirectory = findNearestPackageDirectory(options.projectRoot) ?? options.projectRoot;
 	const packageJsonPath = getPackageJsonPath(packageDirectory);
 	const packageJson = readPackageJson(packageDirectory);
-	if (!isRecord(packageJson)) return {
+	if (!isRecord$1(packageJson)) return {
 		packageJsonPath,
 		scriptStatus: "skipped",
 		scriptReason: "missing-or-invalid-package-json"
 	};
 	const scripts = packageJson.scripts;
 	const scriptTarget = (() => {
-		if (scripts !== void 0 && !isRecord(scripts)) return {
+		if (scripts !== void 0 && !isRecord$1(scripts)) return {
 			status: "skipped",
 			reason: "invalid-scripts"
 		};
-		const scriptRecord = isRecord(scripts) ? scripts : {};
+		const scriptRecord = isRecord$1(scripts) ? scripts : {};
 		if (isReactDoctorScriptCommand(scriptRecord[DOCTOR_SCRIPT_NAME])) return {
 			scriptName: DOCTOR_SCRIPT_NAME,
 			status: "existing"
@@ -50122,7 +50233,7 @@ const installDoctorScript = (options) => {
 	if (scriptStatus === "created") writeJsonFile$1(packageJsonPath, {
 		...packageJson,
 		scripts: {
-			...isRecord(scripts) ? scripts : {},
+			...isRecord$1(scripts) ? scripts : {},
 			[scriptTarget.scriptName ?? DOCTOR_SCRIPT_NAME]: DOCTOR_SCRIPT_COMMAND
 		}
 	});
@@ -50276,38 +50387,52 @@ const upgradeReactDoctorWorkflowInPlace = (projectRoot) => {
 //#region src/cli/utils/hash-project-root.ts
 const hashProjectRoot = (projectRoot) => createHash("sha256").update(Path.resolve(projectRoot)).digest("hex");
 //#endregion
-//#region src/cli/utils/action-upgrade-prompt.ts
-const GLOBAL_CONFIG_PROJECT_NAME$1 = "react-doctor";
-const getActionUpgradeStore = (options = {}) => new Conf({
-	projectName: GLOBAL_CONFIG_PROJECT_NAME$1,
-	cwd: options.cwd
-});
-const hasHandledActionUpgrade = (projectRoot, storeOptions = {}) => {
-	try {
-		const upgrades = getActionUpgradeStore(storeOptions).get("actionUpgrades", {});
-		return Boolean(upgrades[hashProjectRoot(projectRoot)]);
-	} catch {
-		return true;
-	}
-};
-const recordActionUpgradeDecision = (projectRoot, outcome, storeOptions = {}) => {
-	try {
-		const store = getActionUpgradeStore(storeOptions);
-		const upgrades = store.get("actionUpgrades", {});
-		store.set("actionUpgrades", {
-			...upgrades,
-			[hashProjectRoot(projectRoot)]: {
-				rootDirectory: Path.resolve(projectRoot),
-				outcome,
-				at: (/* @__PURE__ */ new Date()).toISOString()
+//#region src/cli/utils/project-decision-store.ts
+const createProjectDecisionStore = (storeKey) => {
+	const getStore = (options = {}) => new Conf({
+		projectName: REACT_DOCTOR_CONFIG_PROJECT_NAME,
+		cwd: options.cwd
+	});
+	return {
+		getConfigPath: (options = {}) => getStore(options).path,
+		hasHandled: (projectRoot, options = {}) => {
+			try {
+				return Boolean(getStore(options).get(storeKey, {})[hashProjectRoot(projectRoot)]);
+			} catch {
+				return true;
 			}
-		});
-		return true;
-	} catch {
-		return false;
-	}
+		},
+		record: (projectRoot, outcome, options = {}) => {
+			try {
+				const store = getStore(options);
+				store.set(storeKey, {
+					...store.get(storeKey, {}),
+					[hashProjectRoot(projectRoot)]: {
+						rootDirectory: Path.resolve(projectRoot),
+						outcome,
+						at: (/* @__PURE__ */ new Date()).toISOString()
+					}
+				});
+				return true;
+			} catch {
+				return false;
+			}
+		}
+	};
 };
 //#endregion
+//#region src/cli/utils/action-upgrade-prompt.ts
+const store$1 = createProjectDecisionStore("actionUpgrades");
+store$1.getConfigPath;
+const hasHandledActionUpgrade = store$1.hasHandled;
+const recordActionUpgradeDecision = store$1.record;
+//#endregion
+//#region src/cli/utils/ci-prompt-decision.ts
+const store = createProjectDecisionStore("ciPrompts");
+store.getConfigPath;
+const hasHandledCiPrompt = store.hasHandled;
+const recordCiPromptDecision = store.record;
+//#endregion
 //#region src/cli/utils/open-url.ts
 const resolveOpenCommand = (url) => {
 	if (process$1.platform === "darwin") return {
@@ -50936,13 +51061,13 @@ const installPackageJsonHook = (options, strategy) => {
 	const packageJsonPath = getPackageJsonPath(options.projectRoot);
 	const didHookExist = NFS.existsSync(packageJsonPath);
 	const packageJson = readPackageJson(options.projectRoot);
-	const nextPackageJson = isRecord(packageJson) ? { ...packageJson } : {};
+	const nextPackageJson = isRecord$1(packageJson) ? { ...packageJson } : {};
 	const parentKeys = strategy.path.slice(0, -1);
 	const leafKey = strategy.path[strategy.path.length - 1];
 	let parent = nextPackageJson;
 	for (const key of parentKeys) {
 		const existing = parent[key];
-		const cloned = isRecord(existing) ? { ...existing } : {};
+		const cloned = isRecord$1(existing) ? { ...existing } : {};
 		parent[key] = cloned;
 		parent = cloned;
 	}
@@ -51113,7 +51238,7 @@ const isHuskyProject = (projectRoot) => NFS.existsSync(Path.join(projectRoot, ".
 const isVitePlusProject = (projectRoot) => packageHasDependency(projectRoot, "vite-plus");
 const isSimpleGitHooksProject = (projectRoot) => {
 	const packageJson = readPackageJson(projectRoot);
-	return isRecord(packageJson) && isRecord(packageJson["simple-git-hooks"]) || packageHasDependency(projectRoot, "simple-git-hooks") || NFS.existsSync(Path.join(projectRoot, ".simple-git-hooks.cjs"));
+	return isRecord$1(packageJson) && isRecord$1(packageJson["simple-git-hooks"]) || packageHasDependency(projectRoot, "simple-git-hooks") || NFS.existsSync(Path.join(projectRoot, ".simple-git-hooks.cjs"));
 };
 const getLefthookConfigPath = (projectRoot) => {
 	for (const fileName of LEFTHOOK_CONFIG_FILES) {
@@ -51279,7 +51404,7 @@ const detectPackageManager = (projectRoot) => {
 	let currentDirectory = Path.resolve(projectRoot);
 	while (true) {
 		const packageJson = readPackageJson(currentDirectory);
-		if (isRecord(packageJson) && typeof packageJson.packageManager === "string") {
+		if (isRecord$1(packageJson) && typeof packageJson.packageManager === "string") {
 			const packageManagerName = packageJson.packageManager.split("@")[0];
 			if (packageManagerName === "pnpm" || packageManagerName === "yarn" || packageManagerName === "bun" || packageManagerName === "npm") return packageManagerName;
 		}
@@ -51355,12 +51480,12 @@ const isSupplyChainTrustError = (error) => {
 const formatInstallCommand = (input) => [input.command, ...input.args].join(" ");
 const installReactDoctorDependency = async (options) => {
 	const packageJson = readPackageJson(options.projectRoot);
-	if (!isRecord(packageJson)) return {
+	if (!isRecord$1(packageJson)) return {
 		dependencyStatus: "skipped",
 		dependencyReason: "missing-or-invalid-package-json"
 	};
 	if (hasDoctorDependency(packageJson)) return { dependencyStatus: "existing" };
-	if (packageJson.devDependencies !== void 0 && !isRecord(packageJson.devDependencies)) return {
+	if (packageJson.devDependencies !== void 0 && !isRecord$1(packageJson.devDependencies)) return {
 		dependencyStatus: "skipped",
 		dependencyReason: "invalid-dev-dependencies"
 	};
@@ -51524,10 +51649,12 @@ const runInstallReactDoctor = async (options = {}) => {
 	const existingWorkflow = readReactDoctorWorkflow(projectRoot);
 	const canInstallWorkflow = !NFS.existsSync(workflowTargetPath);
 	const canUpgradeWorkflow = existingWorkflow !== null && workflowUsesV1Action(existingWorkflow.content) && !hasHandledActionUpgrade(projectRoot);
-	const shouldInstallWorkflow = canInstallWorkflow && (Boolean(options.yes) || !skipPrompts && await askAddToGitHubActions(prompt) === "yes");
+	const ciPromptOutcome = canInstallWorkflow && !options.yes && !skipPrompts && !hasHandledCiPrompt(projectRoot) ? await askAddToGitHubActions(prompt) : null;
+	const shouldInstallWorkflow = canInstallWorkflow && (Boolean(options.yes) || ciPromptOutcome === "yes");
 	const upgradePromptOutcome = canUpgradeWorkflow && !options.yes && !skipPrompts ? await askUpgradeActionVersion(prompt) : null;
 	const shouldUpgradeWorkflow = canUpgradeWorkflow && (Boolean(options.yes) || upgradePromptOutcome === "yes");
 	if (upgradePromptOutcome === "no" && !options.dryRun) recordActionUpgradeDecision(projectRoot, "declined");
+	if ((ciPromptOutcome === "yes" || ciPromptOutcome === "no") && !options.dryRun) recordCiPromptDecision(projectRoot, ciPromptOutcome === "yes" ? "accepted" : "declined");
 	const selectedAgents = skipPrompts ? detectedAgents : (await prompt({
 		type: "multiselect",
 		name: "agents",
@@ -51774,18 +51901,24 @@ const handoffToAgent = async (input) => {
 	if (!input.interactive || input.diagnostics.length === 0) return;
 	cliLogger.break();
 	const projectRootForCi = findNearestPackageDirectory(input.rootDirectory) ?? input.rootDirectory;
-	if (!isReactDoctorWorkflowInstalled(projectRootForCi)) {
+	const isGitHubActionsConfigured = isReactDoctorWorkflowInstalled(projectRootForCi);
+	if (!isGitHubActionsConfigured && !hasHandledCiPrompt(projectRootForCi)) {
 		const ciOutcome = await askAddToGitHubActions();
 		recordCount(METRIC.agentHandoff, 1, {
 			outcome: `ci-${ciOutcome}`,
 			diagnosticsCount: input.diagnostics.length
 		});
 		if (ciOutcome === "cancel") return;
+		recordCiPromptDecision(projectRootForCi, ciOutcome === "yes" ? "accepted" : "declined");
 		if (ciOutcome === "yes") {
 			await setUpGitHubActions({ rootDirectory: input.rootDirectory });
 			cliLogger.break();
 		}
-	} else await maybeOfferActionUpgrade(projectRootForCi);
+	} else if (isGitHubActionsConfigured) await maybeOfferActionUpgrade(projectRootForCi);
+	else recordCount(METRIC.agentHandoff, 1, {
+		outcome: "ci-suppressed",
+		diagnosticsCount: input.diagnostics.length
+	});
 	const { handoffTarget } = await prompts({
 		type: "select",
 		name: "handoffTarget",
@@ -52091,7 +52224,7 @@ const printMultiProjectSummary = (input) => gen(function* () {
 	yield* log(`${highlighter.success("✔")} Scanned ${totalScannedFileCount} ${totalScannedFileCount === 1 ? "file" : "files"} in ${formatElapsedTime(totalElapsedMilliseconds)}`);
 	if (displayDiagnostics.length > 0) {
 		yield* log("");
-		yield* printDiagnostics(displayDiagnostics, verbose, resolveDiagnosticSourceRoot, buildRulePriorityMap(completedScans.map((scan) => scan.result.score)), isCodingAgentEnvironment(), { animateCountUp: animateRender });
+		yield* printDiagnostics(displayDiagnostics, verbose, resolveDiagnosticSourceRoot, buildRulePriorityMap(completedScans.map((scan) => scan.result.score)), isCodingAgentEnvironment(), { animateCountUp: animateRender }, shouldRenderHyperlinks(process.stdout));
 	}
 	const lowestScoredScan = findLowestScoredScan(completedScans);
 	const aggregateScore = lowestScoredScan?.result.score ?? null;
@@ -52129,9 +52262,8 @@ const printMultiProjectSummary = (input) => gen(function* () {
 });
 //#endregion
 //#region src/cli/utils/prompt-install-setup.ts
-const GLOBAL_CONFIG_PROJECT_NAME = "react-doctor";
 const getSetupPromptStore = (options = {}) => new Conf({
-	projectName: GLOBAL_CONFIG_PROJECT_NAME,
+	projectName: REACT_DOCTOR_CONFIG_PROJECT_NAME,
 	cwd: options.cwd
 });
 const getSetupPromptProjectKey = (projectRoot) => hashProjectRoot(projectRoot);
@@ -52142,6 +52274,24 @@ const hasDisabledSetupPrompt = (projectRoot, storeOptions = {}) => {
 		return false;
 	}
 };
+const disableSetupPrompt = (projectRoot, storeOptions = {}) => {
+	try {
+		const store = getSetupPromptStore(storeOptions);
+		const projects = store.get("projects", {});
+		const projectKey = getSetupPromptProjectKey(projectRoot);
+		store.set("projects", {
+			...projects,
+			[projectKey]: {
+				...projects[projectKey] ?? {},
+				rootDirectory: Path.resolve(projectRoot),
+				setupPrompt: false
+			}
+		});
+		return true;
+	} catch {
+		return false;
+	}
+};
 const resolveInstallSetupProjectRoot = (options) => {
 	if (options.scanDirectories.length === 0) return findNearestPackageDirectory(options.scanRoot) ?? options.scanRoot;
 	const packageDirectories = /* @__PURE__ */ new Set();
@@ -52548,6 +52698,14 @@ const runExplain = async (fileLineArgument, context) => {
 		const colorizedRule = colorizeRuleByDiagnostic(ruleIdentifier, diagnostic.severity);
 		const severityLabel = colorizeRuleByDiagnostic(diagnostic.severity, diagnostic.severity);
 		cliLogger.log(`${severitySymbol} ${colorizedRule} ${highlighter.dim(`(${severityLabel})`)} — ${diagnostic.message}`);
+		const codeFrame = buildCodeFrame({
+			filePath: diagnostic.filePath,
+			line: diagnostic.line,
+			column: diagnostic.column,
+			endLine: diagnostic.endLine,
+			rootDirectory: targetDirectory
+		});
+		if (codeFrame) cliLogger.log(indentMultilineText(codeFrame, "  "));
 		if (diagnostic.category) cliLogger.dim(`  Category: ${diagnostic.category}`);
 		if (diagnostic.help) cliLogger.dim(`  ${diagnostic.help}`);
 		cliLogger.dim(`  If this needs follow-up or looks like a false positive, open: ${buildDiagnosticIssueUrl({
@@ -52944,6 +53102,7 @@ const inspectAction = async (directory, flags) => {
 			})) {
 				printAgentInstallHint();
 				recordCount(METRIC.agentInstallHintShown, 1);
+				disableSetupPrompt(setupProjectRoot);
 			}
 		}
 	} catch (error) {
@@ -53951,4 +54110,4 @@ Promise.resolve().then(() => assertNoRemovedFlags(process.argv)).then(() => prog
 export {};
 
 //# sourceMappingURL=cli.js.map
-//# debugId=54905d6a-f06f-5f80-9fb6-7d4ab857d553
+//# debugId=a06f0514-b1fa-5452-9c19-0140438862f8