@posthog/wizard 2.10.4 → 2.12.0

package/dist/{start-tui-DkT_H5zx.js → start-tui-DleQG3La.js}

@@ -1,19 +1,25 @@
-import { l as setUI, s as logToFile } from "./debug-CyJ_3dTP.js";
-import { i as CONTEXT_MILL_URL, l as Integration, u as OAUTH_PORTS, v as REMOTE_SKILLS_BASE_URL, w as getSkillsBaseUrl } from "./analytics-Cm6i5_gc.js";
-import { t as ADDITIONAL_FEATURE_LABELS } from "./wizard-session-Db6R023m.js";
-import { r as wizardAbort } from "./wizard-abort-DKctLd33.js";
-import { m as fetchSkillMenu, p as downloadSkill, r as getBlockingServiceKeys } from "./readiness-Cep84RsR.js";
-import { n as POSTHOG_SDKS, r as STRIPE_SDKS } from "./bin.js";
-import { t as ALL_FEATURE_VALUES } from "./defaults-DoVkE0gW.js";
-import { a as getSupportedClients, i as getInstalledClients, o as removeMCPServer } from "./add-mcp-server-to-clients-lfUH2pdU.js";
-import "./router-CXjdWNh2.js";
-import { _ as SplitView, a as HNViewer, b as Icons, c as EventPlanViewer, d as ConfirmationInput, g as LoadingBox, h as ProgressList, i as LearnCard, l as LogViewer, m as PickerMenu, n as ServiceHealthList, o as TabContainer, p as useStdoutDimensions, r as TipsCard, s as ScreenContainer, t as McpScreen, u as ModalOverlay, x as WizardStore, y as Colors } from "./McpScreen-LqnNwEfV.js";
+import { C as Integration, D as POSTHOG_DOCS_URL, H as getSkillsBaseUrl, N as REMOTE_SKILLS_BASE_URL, R as WIZARD_TOOLS_MENU_FLAG_KEY, f as SIGNUP_WIZARD_READINESS_CONFIG, l as setUI, m as getBlockingServiceKeys, s as logToFile, w as OAUTH_PORTS } from "./debug-Bkaqv1ab.js";
+import { a as relativeToInstallDir, n as WIZARD_LOG_FILE } from "./paths-DJS47p5x.js";
+import { n as analytics } from "./analytics-DmD31Ssc.js";
+import { l as ApiError, p as getUiHostFromHost } from "./setup-utils-Bv8z6HMb.js";
+import { t as ADDITIONAL_FEATURE_LABELS } from "./wizard-session-BcNJTl2I.js";
+import { r as wizardAbort } from "./wizard-abort-DfhWuzaw.js";
+import { _ as coerceAuditChecks, d as fetchSkillMenu, g as AUDIT_SEVERITY_STYLE, h as AUDIT_REPORT_FILE, m as AUDIT_CHECKS_KEY, p as AUDIT_CHECKS_FILE, u as downloadSkill, v as getAuditChecks } from "./agent-interface-D5W9BAB2.js";
+import { t as EVENT_PLAN_FILE } from "./posthog-integration-DX77Msto.js";
+import { a as POSTHOG_SDKS, o as STRIPE_SDKS, r as fetchHealthIssues } from "./bin.js";
+import { t as ALL_FEATURE_VALUES } from "./defaults-GbLPuHxj.js";
+import { a as getSupportedClients, c as removeMCPServer, i as getInstalledClients, o as getSupportedPluginClients, s as installPlugins, u as isPluginCapable } from "./add-mcp-server-to-clients-BKoew3aT.js";
+import "./router-BTfmEDDJ.js";
+import { C as Colors, T as WizardStore, _ as useStdoutDimensions, a as SEVERITY_ORDER, b as LoadingBox, c as LearnCard, d as ScreenContainer, f as EventPlanViewer, h as ConfirmationInput, i as SEVERITY_LABEL, l as HNViewer, m as ModalOverlay, n as McpScreen, o as ServiceHealthList, p as LogViewer, r as IssueTable, s as TipsCard, t as AuditChecksViewer, u as TabContainer, v as PickerMenu, w as Icons, x as SplitView, y as ProgressList } from "./AuditChecksViewer-DsfXIO9e.js";
+import { spawn, spawnSync } from "node:child_process";
 import { join } from "node:path";
+import * as fs$1 from "fs";
 import path from "path";
 import { Box, Text, render, useInput } from "ink";
-import { createElement, useEffect, useMemo, useState, useSyncExternalStore } from "react";
-import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-import { readdir, rm } from "node:fs/promises";
+import { Fragment, createElement, useEffect, useMemo, useState, useSyncExternalStore } from "react";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
+import { Spinner } from "@inkjs/ui";
+import { access, readdir, rm } from "node:fs/promises";
 //#region src/ui/tui/ink-ui.ts
 const ANSI_RE = /\x1b\[[0-9;]*m/g;
 function stripAnsi(s) {
@@ -28,7 +34,8 @@ var InkUI = class {
 	}
 	outro(message) {
 		this.store.pushStatus(stripAnsi(message));
-		if (!this.store.session.outroData) this.store.setOutroData({
+		const existing = this.store.session.outroData;
+		this.store.setOutroData(existing ?? {
 			kind: "success",
 			message: stripAnsi(message)
 		});
@@ -38,6 +45,20 @@ var InkUI = class {
 		this.store.setOutroData(data);
 		if (this.store.session.runPhase !== "error") this.store.setRunPhase("error");
 	}
+	waitForOutroDismissed() {
+		return new Promise((resolve) => {
+			if (this.store.session.outroDismissed) {
+				resolve();
+				return;
+			}
+			const unsub = this.store.subscribe(() => {
+				if (this.store.session.outroDismissed) {
+					unsub();
+					resolve();
+				}
+			});
+		});
+	}
 	setCredentials(credentials) {
 		this.store.setCredentials(credentials);
 	}
@@ -114,6 +135,9 @@ var InkUI = class {
 	setEventPlan(events) {
 		this.store.setEventPlan(events);
 	}
+	setFrameworkContext(key, value) {
+		this.store.setFrameworkContext(key, value);
+	}
 };
 //#endregion
 //#region src/ui/tui/screens/health/HealthCheckScreen.tsx
@@ -174,14 +198,18 @@ const HealthCheckScreen = ({ store }) => {
 		justifyContent: "center",
 		children: /* @__PURE__ */ jsx(LoadingBox, { message: "Checking service status..." })
 	});
-	const blockingKeys = getBlockingServiceKeys(result.health);
-	if (blockingKeys.length === 0) return null;
-	const isGithubReleasesDown = blockingKeys.includes("githubReleases");
+	const isSignup = store.session.signup;
+	const blockingKeys = getBlockingServiceKeys(result.health, isSignup ? SIGNUP_WIZARD_READINESS_CONFIG : void 0);
+	const warningKeys = isSignup ? getBlockingServiceKeys(result.health).filter((k) => !blockingKeys.includes(k)) : [];
+	const hasHardBlock = blockingKeys.length > 0;
+	const displayKeys = hasHardBlock ? blockingKeys : warningKeys;
+	if (displayKeys.length === 0) return null;
+	const isGithubReleasesDown = hasHardBlock && blockingKeys.includes("githubReleases");
 	const canDownloadSkills = result.health.githubReleases.status === "healthy";
 	const integration = store.session.integration;
-	const title = `Ongoing service disruptions`;
+	const title = hasHardBlock ? "Ongoing service disruptions" : "Service disruption detected";
 	const docsUrl = store.session.frameworkConfig?.metadata.docsUrl;
-	const description = isGithubReleasesDown ? "The Wizard can't download necessary skills from GitHub Releases right now." : "The Wizard may not work reliably while services are affected.";
+	const description = isGithubReleasesDown ? "The Wizard can't download necessary skills from GitHub Releases right now." : hasHardBlock ? "The Wizard cannot start while these services are down." : "Some services are degraded. You can continue, but parts of the wizard may not work reliably.";
 	const handleDownloadAndExit = async () => {
 		if (downloading) return;
 		setDownloading(true);
@@ -194,7 +222,7 @@ const HealthCheckScreen = ({ store }) => {
 		setDownloaded(true);
 	};
 	return /* @__PURE__ */ jsxs(ModalOverlay, {
-		borderColor: "red",
+		borderColor: hasHardBlock ? "red" : "yellow",
 		title,
 		width: 72,
 		footer: isGithubReleasesDown ? /* @__PURE__ */ jsx(ConfirmationInput, {
@@ -236,7 +264,7 @@ const HealthCheckScreen = ({ store }) => {
 					] })
 				}), /* @__PURE__ */ jsx(ServiceHealthList, {
 					health: result.health,
-					filterKeys: blockingKeys,
+					filterKeys: displayKeys,
 					showHealthy: false
 				})]
 			}),
@@ -259,6 +287,225 @@ const HealthCheckScreen = ({ store }) => {
 	});
 };
 //#endregion
+//#region src/ui/tui/screens/doctor/DoctorIntroScreen.tsx
+const DoctorIntroScreen = ({ store }) => {
+	useSyncExternalStore((cb) => store.subscribe(cb), () => store.getSnapshot());
+	return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		children: [
+			/* @__PURE__ */ jsxs(Box, {
+				flexDirection: "column",
+				marginBottom: 1,
+				children: [/* @__PURE__ */ jsx(Text, {
+					bold: true,
+					color: Colors.accent,
+					children: "PostHog Doctor"
+				}), /* @__PURE__ */ jsx(Text, {
+					dimColor: true,
+					children: "Scan your project configuration for issues that may need attention."
+				})]
+			}),
+			/* @__PURE__ */ jsxs(Box, {
+				flexDirection: "column",
+				marginBottom: 1,
+				children: [/* @__PURE__ */ jsx(Text, { children: "The wizard will:" }), /* @__PURE__ */ jsxs(Box, {
+					paddingLeft: 2,
+					flexDirection: "column",
+					children: [
+						/* @__PURE__ */ jsxs(Text, { children: [Icons.bullet, " Sign you in to PostHog"] }),
+						/* @__PURE__ */ jsxs(Text, { children: [Icons.bullet, " Fetch active health issues for your project"] }),
+						/* @__PURE__ */ jsxs(Text, { children: [Icons.bullet, " Show you what needs to be resolved, with docs links"] })
+					]
+				})]
+			}),
+			/* @__PURE__ */ jsx(PickerMenu, {
+				options: [{
+					label: "Continue",
+					value: "continue"
+				}, {
+					label: "Cancel",
+					value: "cancel"
+				}],
+				onSelect: (value) => {
+					if (value === "cancel") process.exit(0);
+					else store.completeSetup();
+				}
+			})
+		]
+	});
+};
+//#endregion
+//#region src/ui/tui/screens/doctor/DoctorReportScreen.tsx
+const DoctorReportScreen = ({ store }) => {
+	useSyncExternalStore((cb) => store.subscribe(cb), () => store.getSnapshot());
+	const { credentials } = store.session;
+	const accessToken = credentials?.accessToken;
+	const host = credentials?.host;
+	const projectId = credentials?.projectId;
+	const [state, setState] = useState({ kind: "loading" });
+	useEffect(() => {
+		if (!accessToken || !host || projectId == null) return;
+		let cancelled = false;
+		(async () => {
+			try {
+				const issues = await fetchHealthIssues(accessToken, host, projectId);
+				if (!cancelled) setState({
+					kind: "ready",
+					issues
+				});
+			} catch (err) {
+				if (!cancelled) setState({
+					kind: "error",
+					message: err instanceof ApiError && err.statusCode === 401 ? "Your PostHog session has expired. Re-run the wizard to sign in again." : err instanceof Error ? err.message : String(err)
+				});
+			}
+		})();
+		return () => {
+			cancelled = true;
+		};
+	}, [
+		accessToken,
+		host,
+		projectId
+	]);
+	if (!credentials) return /* @__PURE__ */ jsx(LoadingBox, { message: "Waiting for authentication..." });
+	if (state.kind === "loading") return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		children: [/* @__PURE__ */ jsx(Header, {
+			host: credentials.host,
+			projectId: credentials.projectId
+		}), /* @__PURE__ */ jsx(LoadingBox, { message: "Fetching health issues..." })]
+	});
+	const healthUrl = `${getUiHostFromHost(credentials.host)}/project/${credentials.projectId}/health`;
+	if (state.kind === "error") return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		children: [
+			/* @__PURE__ */ jsx(Header, {
+				host: credentials.host,
+				projectId: credentials.projectId
+			}),
+			/* @__PURE__ */ jsxs(Box, {
+				flexDirection: "column",
+				marginY: 1,
+				children: [/* @__PURE__ */ jsxs(Text, {
+					color: Colors.error,
+					bold: true,
+					children: [Icons.squareFilled, " Failed to fetch health issues"]
+				}), /* @__PURE__ */ jsx(Text, {
+					dimColor: true,
+					children: state.message
+				})]
+			}),
+			/* @__PURE__ */ jsx(PickerMenu, {
+				options: [{
+					label: "Continue",
+					value: "continue"
+				}],
+				onSelect: () => {
+					store.setOutroData({
+						kind: "error",
+						message: "Failed to fetch health issues",
+						body: state.message,
+						docsUrl: POSTHOG_DOCS_URL
+					});
+				}
+			})
+		]
+	});
+	const { issues } = state;
+	if (issues.length === 0) return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		children: [
+			/* @__PURE__ */ jsx(Header, {
+				host: credentials.host,
+				projectId: credentials.projectId
+			}),
+			/* @__PURE__ */ jsx(Box, {
+				marginY: 1,
+				children: /* @__PURE__ */ jsxs(Text, {
+					color: Colors.success,
+					bold: true,
+					children: [Icons.check, " No active issues — you're all set!"]
+				})
+			}),
+			/* @__PURE__ */ jsx(PickerMenu, {
+				options: [{
+					label: "Continue",
+					value: "continue"
+				}],
+				onSelect: () => {
+					store.setOutroData({
+						kind: "success",
+						message: "No active issues — your project looks healthy.",
+						docsUrl: POSTHOG_DOCS_URL,
+						continueUrl: healthUrl
+					});
+				}
+			})
+		]
+	});
+	return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		children: [
+			/* @__PURE__ */ jsx(Header, {
+				host: credentials.host,
+				projectId: credentials.projectId
+			}),
+			/* @__PURE__ */ jsx(Box, {
+				marginTop: 1,
+				children: /* @__PURE__ */ jsx(Text, { children: formatSummaryLine(issues) })
+			}),
+			/* @__PURE__ */ jsx(Box, {
+				flexDirection: "column",
+				marginBottom: 1,
+				children: /* @__PURE__ */ jsx(IssueTable, { issues })
+			}),
+			/* @__PURE__ */ jsx(PickerMenu, {
+				options: [{
+					label: "Continue",
+					value: "continue"
+				}],
+				onSelect: () => {
+					store.setOutroData({
+						kind: "success",
+						message: `Found ${issues.length} active issue${issues.length === 1 ? "" : "s"}.`,
+						body: "Open the dashboard in PostHog to dismiss or resolve issues.",
+						docsUrl: POSTHOG_DOCS_URL,
+						continueUrl: healthUrl
+					});
+				}
+			})
+		]
+	});
+};
+const Header = ({ host, projectId }) => /* @__PURE__ */ jsxs(Box, {
+	flexDirection: "column",
+	children: [/* @__PURE__ */ jsx(Text, {
+		bold: true,
+		color: Colors.accent,
+		children: "PostHog Doctor Report"
+	}), /* @__PURE__ */ jsxs(Text, {
+		dimColor: true,
+		children: [
+			"Project ",
+			projectId,
+			" ",
+			Icons.bullet,
+			" ",
+			host
+		]
+	})]
+});
+function formatSummaryLine(issues) {
+	const parts = [];
+	for (const sev of SEVERITY_ORDER) {
+		const n = issues.filter((i) => i.severity === sev).length;
+		if (n > 0) parts.push(`${n} ${SEVERITY_LABEL[sev].toLowerCase()}`);
+	}
+	const suffix = parts.length > 0 ? `: ${parts.join(", ")}` : "";
+	return `${issues.length} active issue${issues.length === 1 ? "" : "s"}${suffix}`;
+}
+//#endregion
 //#region src/ui/tui/screens/SettingsOverrideScreen.tsx
 function sourcePath(source) {
 	switch (source) {
@@ -477,7 +724,7 @@ const IntroScreenLayout = ({ installDir, title = "PostHog Wizard 🦔", showSubt
 			children: /* @__PURE__ */ jsx(WizardTitle, { title })
 		}), errorView]
 	});
-	return /* @__PURE__ */ jsx(Fragment, { children: /* @__PURE__ */ jsxs(Box, {
+	return /* @__PURE__ */ jsx(Fragment$1, { children: /* @__PURE__ */ jsxs(Box, {
 		flexDirection: "column",
 		flexGrow: 1,
 		alignItems: "center",
@@ -568,6 +815,69 @@ const IntroScreenLayout = ({ installDir, title = "PostHog Wizard 🦔", showSubt
 	}) });
 };
 //#endregion
+//#region src/ui/tui/screens/SkillSourceInfo.tsx
+/**
+* Shared "Skill: <id> / URL: <downloadUrl>" block for intro screens.
+*
+* `useSkillEntry` fetches the entry from the skill menu and re-runs when
+* `skillId` or `local` change. The previous fetch is cancelled (its result
+* is ignored) so a session that flips `local=false → true` mid-mount picks
+* up the right base URL.
+*
+* `<SkillSourceInfo>` renders the block, taking the entry as a prop so the
+* caller can reuse the same hook result for additional UI (e.g. showing
+* `skillEntry.name`) without invoking the hook twice.
+*/
+function useSkillEntry(skillId, local) {
+	const [skillEntry, setSkillEntry] = useState(null);
+	const [fetchFailed, setFetchFailed] = useState(false);
+	useEffect(() => {
+		if (!skillId) {
+			setFetchFailed(true);
+			return;
+		}
+		let cancelled = false;
+		setSkillEntry(null);
+		setFetchFailed(false);
+		fetchSkillMenu(getSkillsBaseUrl(local)).then((menu) => {
+			if (cancelled) return;
+			if (!menu) {
+				setFetchFailed(true);
+				return;
+			}
+			const match = Object.values(menu.categories).flat().find((s) => s.id === skillId);
+			if (match) setSkillEntry(match);
+			else setFetchFailed(true);
+		});
+		return () => {
+			cancelled = true;
+		};
+	}, [skillId, local]);
+	return {
+		skillEntry,
+		fetchFailed
+	};
+}
+const SkillSourceInfo = ({ skillId, skillEntry, fetchFailed }) => /* @__PURE__ */ jsxs(Box, {
+	flexDirection: "column",
+	children: [/* @__PURE__ */ jsxs(Text, { children: [
+		"Skill:",
+		" ",
+		/* @__PURE__ */ jsx(Text, {
+			italic: true,
+			color: "cyan",
+			children: skillId ?? "unknown"
+		})
+	] }), /* @__PURE__ */ jsxs(Text, { children: [
+		"URL:",
+		" ",
+		/* @__PURE__ */ jsx(Text, {
+			color: "cyan",
+			children: skillEntry?.downloadUrl ?? (fetchFailed ? "unavailable" : "Loading...")
+		})
+	] })]
+});
+//#endregion
 //#region src/ui/tui/screens/PostHogIntegrationIntroScreen.tsx
 /**
 * PostHogIntegrationIntroScreen — Intro screen for the core PostHog integration.
@@ -578,6 +888,19 @@ const IntroScreenLayout = ({ installDir, title = "PostHog Wizard 🦔", showSubt
 *   3. Unsupported version: upgrade prompt
 *   4. Detection succeeded: continue/change-framework/cancel
 */
+const TOOLS = [{
+	label: "Troubleshoot Integration",
+	command: "doctor"
+}];
+function launchTool(command, installDir) {
+	releaseTerminal();
+	const result = spawnSync(process.execPath, [
+		process.argv[1],
+		command,
+		`--install-dir=${installDir}`
+	], { stdio: "inherit" });
+	process.exit(result.status ?? 0);
+}
 /** Framework picker shown when auto-detection fails. */
 const FrameworkPicker = ({ store, onComplete }) => {
 	return /* @__PURE__ */ jsx(PickerMenu, {
@@ -590,7 +913,7 @@ const FrameworkPicker = ({ store, onComplete }) => {
 		})),
 		onSelect: (value) => {
 			const integration = Array.isArray(value) ? value[0] : value;
-			import("./registry-BIV1wRpo.js").then((n) => n.n).then(({ FRAMEWORK_REGISTRY }) => {
+			import("./registry-CCtIsqb8.js").then((n) => n.n).then(({ FRAMEWORK_REGISTRY }) => {
 				const config = FRAMEWORK_REGISTRY[integration];
 				store.setFrameworkConfig(integration, config);
 				store.setDetectedFramework(config.metadata.name);
@@ -603,21 +926,33 @@ const PostHogIntegrationIntroScreen = ({ store }) => {
 	useSyncExternalStore((cb) => store.subscribe(cb), () => store.getSnapshot());
 	const [pickingFramework, setPickingFramework] = useState(false);
 	const [manuallySelected, setManuallySelected] = useState(false);
-	const [showingMoreInfo, setShowingMoreInfo] = useState(false);
+	const [view, setView] = useState("default");
+	const [toolsEnabled, setToolsEnabled] = useState(false);
+	useEffect(() => {
+		let cancelled = false;
+		analytics.getAllFlagsForWizard().then((flags) => {
+			const value = flags[WIZARD_TOOLS_MENU_FLAG_KEY];
+			if (!cancelled && value && value !== "false") setToolsEnabled(true);
+		});
+		return () => {
+			cancelled = true;
+		};
+	}, []);
 	const { session } = store;
 	const config = session.frameworkConfig;
 	const frameworkLabel = session.detectedFrameworkLabel ?? config?.metadata.name;
+	const { skillEntry, fetchFailed } = useSkillEntry(session.skillId, session.localMcp);
 	const detecting = !session.detectionComplete;
 	const needsFrameworkPick = session.detectionComplete && !session.frameworkConfig;
 	const unsupported = session.unsupportedVersion;
-	const showContinue = session.frameworkConfig !== null && !detecting && !pickingFramework && !showingMoreInfo && !unsupported;
+	const showContinue = session.frameworkConfig !== null && !detecting && !pickingFramework && view === "default" && !unsupported;
 	const title = detecting ? "PostHog Wizard starting up" : "PostHog Wizard 🦔";
 	let body = null;
 	if (detecting) body = /* @__PURE__ */ jsx(Box, {
 		marginY: 1,
 		children: /* @__PURE__ */ jsx(LoadingBox, { message: "Detecting project framework..." })
 	});
-	else if (needsFrameworkPick && !pickingFramework) body = /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(Box, {
+	else if (needsFrameworkPick && !pickingFramework) body = /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx(Box, {
 		marginY: 1,
 		children: /* @__PURE__ */ jsx(Text, {
 			dimColor: true,
@@ -631,9 +966,10 @@ const PostHogIntegrationIntroScreen = ({ store }) => {
 		store,
 		onComplete: () => setPickingFramework(false)
 	});
-	else if (showingMoreInfo) body = /* @__PURE__ */ jsxs(Box, {
+	else if (view === "more-info") body = /* @__PURE__ */ jsxs(Box, {
 		flexDirection: "column",
 		width: 56,
+		flexShrink: 0,
 		children: [
 			/* @__PURE__ */ jsxs(Text, { children: ["The wizard is an agent that executes PostHog tasks. Its code is open source: ", /* @__PURE__ */ jsx(Text, {
 				color: "cyan",
@@ -665,21 +1001,21 @@ const PostHogIntegrationIntroScreen = ({ store }) => {
 					/* @__PURE__ */ jsxs(Text, { children: [`\u2022`, " Error Tracking"] })
 				]
 			}),
-			/* @__PURE__ */ jsx(Box, {
+			/* @__PURE__ */ jsxs(Box, {
 				flexDirection: "column",
 				marginTop: 1,
-				children: /* @__PURE__ */ jsxs(Text, { children: [
-					"If you prefer your own AI setup, download the skill:",
-					" ",
-					/* @__PURE__ */ jsxs(Text, {
-						color: "cyan",
-						children: [CONTEXT_MILL_URL, "/releases"]
+				children: [/* @__PURE__ */ jsx(Text, { children: "If you prefer your own AI setup, download the skill:" }), /* @__PURE__ */ jsx(Box, {
+					marginTop: 1,
+					children: /* @__PURE__ */ jsx(SkillSourceInfo, {
+						skillId: session.skillId,
+						skillEntry,
+						fetchFailed
 					})
-				] })
+				})]
 			})
 		]
 	});
-	else if (showContinue) body = /* @__PURE__ */ jsx(Fragment, { children: /* @__PURE__ */ jsx(Box, { children: /* @__PURE__ */ jsx(Text, { children: "Let's do two hours of work in eight minutes." }) }) });
+	else if (showContinue) body = /* @__PURE__ */ jsx(Fragment$1, { children: /* @__PURE__ */ jsx(Box, { children: /* @__PURE__ */ jsx(Text, { children: "Let's do two hours of work in eight minutes." }) }) });
 	const detectionRows = [];
 	if (frameworkLabel) {
 		const suffixParts = [];
@@ -739,7 +1075,14 @@ const PostHogIntegrationIntroScreen = ({ store }) => {
 		]
 	});
 	let menuOptions = null;
-	if (showingMoreInfo) menuOptions = [{
+	if (view === "tools") menuOptions = [...TOOLS.map((t) => ({
+		label: t.label,
+		value: t.command
+	})), {
+		label: "Back",
+		value: "back"
+	}];
+	else if (view === "more-info") menuOptions = [{
 		label: "Back",
 		value: "back"
 	}];
@@ -752,6 +1095,10 @@ const PostHogIntegrationIntroScreen = ({ store }) => {
 			label: "Change framework",
 			value: "framework"
 		},
+		...toolsEnabled ? [{
+			label: "Tools",
+			value: "tools"
+		}] : [],
 		{
 			label: "More info",
 			value: "more-info"
@@ -762,18 +1109,24 @@ const PostHogIntegrationIntroScreen = ({ store }) => {
 		}
 	];
 	const handleSelect = (value) => {
+		if (view === "tools") {
+			if (value === "back") setView("default");
+			else launchTool(value, session.installDir);
+			return;
+		}
 		if (value === "cancel") process.exit(0);
 		else if (value === "framework") {
 			setPickingFramework(true);
 			setManuallySelected(true);
-		} else if (value === "more-info") setShowingMoreInfo(true);
-		else if (value === "back") setShowingMoreInfo(false);
+		} else if (value === "more-info") setView("more-info");
+		else if (value === "tools") setView("tools");
+		else if (value === "back") setView("default");
 		else store.completeSetup();
 	};
 	return /* @__PURE__ */ jsx(IntroScreenLayout, {
 		installDir: session.installDir,
 		title,
-		showSubtitle: !showingMoreInfo,
+		showSubtitle: view === "default",
 		body,
 		showDetection: showContinue,
 		detectionRows,
@@ -816,6 +1169,7 @@ const RevenueIntroScreen = ({ store }) => {
 	const body = showingMoreInfo ? /* @__PURE__ */ jsxs(Box, {
 		flexDirection: "column",
 		width: 56,
+		flexShrink: 0,
 		children: [
 			/* @__PURE__ */ jsxs(Text, { children: [
 				"The wizard is an agent that executes PostHog tasks. Its code is open source: ",
@@ -851,7 +1205,7 @@ const RevenueIntroScreen = ({ store }) => {
 				]
 			})
 		]
-	}) : /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsxs(Box, {
+	}) : /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsxs(Box, {
 		flexDirection: "column",
 		alignItems: "center",
 		children: [/* @__PURE__ */ jsx(Text, { children: "Let's create revenue analytics with Stripe and PostHog." }), /* @__PURE__ */ jsx(Box, {
@@ -879,7 +1233,7 @@ const RevenueIntroScreen = ({ store }) => {
 			]
 		}, p))]
 	})] });
-	const errorView = detectError ? /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsxs(Box, {
+	const errorView = detectError ? /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsxs(Box, {
 		flexDirection: "column",
 		marginBottom: 1,
 		children: [/* @__PURE__ */ jsxs(Text, {
@@ -941,7 +1295,7 @@ const DetectErrorBody = ({ error }) => {
 				"not-dir": "is not a directory",
 				unreadable: "could not be accessed"
 			}[error.reason];
-			return /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsxs(Text, { children: [
+			return /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsxs(Text, { children: [
 				"This path ",
 				reasonText,
 				":"
@@ -950,7 +1304,7 @@ const DetectErrorBody = ({ error }) => {
 				children: ["  ", error.path]
 			})] });
 		}
-		case "no-package-json": return /* @__PURE__ */ jsxs(Fragment, { children: [
+		case "no-package-json": return /* @__PURE__ */ jsxs(Fragment$1, { children: [
 			/* @__PURE__ */ jsx(Text, { children: "No package.json found in this directory." }),
 			/* @__PURE__ */ jsx(Text, {
 				dimColor: true,
@@ -961,7 +1315,7 @@ const DetectErrorBody = ({ error }) => {
 				children: "Run this command from your project root."
 			})
 		] });
-		case "no-sdks": return /* @__PURE__ */ jsxs(Fragment, { children: [
+		case "no-sdks": return /* @__PURE__ */ jsxs(Fragment$1, { children: [
 			/* @__PURE__ */ jsxs(Text, { children: [
 				"Neither PostHog nor Stripe SDKs detected (scanned",
 				" ",
@@ -1010,7 +1364,7 @@ const DetectErrorBody = ({ error }) => {
 				})
 			})
 		] });
-		case "missing-posthog": return /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsxs(Text, { children: [
+		case "missing-posthog": return /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsxs(Text, { children: [
 			"Found Stripe (",
 			error.foundStripe.join(", "),
 			") but no PostHog SDK."
@@ -1028,7 +1382,7 @@ const DetectErrorBody = ({ error }) => {
 				]
 			})
 		})] });
-		case "missing-stripe": return /* @__PURE__ */ jsxs(Fragment, { children: [
+		case "missing-stripe": return /* @__PURE__ */ jsxs(Fragment$1, { children: [
 			/* @__PURE__ */ jsxs(Text, { children: [
 				"Found PostHog (",
 				error.foundPosthog.join(", "),
@@ -1059,41 +1413,22 @@ const DetectErrorBody = ({ error }) => {
 //#endregion
 //#region src/ui/tui/screens/AgentSkillIntroScreen.tsx
 /**
-* AgentSkillIntroScreen — Intro screen for the generic agent-skill workflow.
+* AgentSkillIntroScreen — Default intro for generic agent-skill workflows.
 *
-* Main menu: one-liner body, detection rows, continue/cancel.
-* More info: skill name, download URL fetched from the skill menu.
+* Workflows that need a different intro ship their own screen component
+* (see audit/AuditIntroScreen.tsx).
 */
 const AgentSkillIntroScreen = ({ store }) => {
 	useSyncExternalStore((cb) => store.subscribe(cb), () => store.getSnapshot());
 	const [showingMoreInfo, setShowingMoreInfo] = useState(false);
-	const [skillEntry, setSkillEntry] = useState(null);
-	const [fetchFailed, setFetchFailed] = useState(false);
 	const { session } = store;
 	const skillId = session.skillId ?? "unknown";
-	const isMainMenu = !showingMoreInfo;
-	useEffect(() => {
-		if (!showingMoreInfo || skillEntry || fetchFailed) return;
-		fetchSkillMenu(getSkillsBaseUrl(session.localMcp)).then((menu) => {
-			if (!menu) {
-				setFetchFailed(true);
-				return;
-			}
-			const match = Object.values(menu.categories).flat().find((s) => s.id === skillId);
-			if (match) setSkillEntry(match);
-			else setFetchFailed(true);
-		});
-	}, [
-		showingMoreInfo,
-		skillEntry,
-		fetchFailed,
-		skillId,
-		session.localMcp
-	]);
+	const { skillEntry, fetchFailed } = useSkillEntry(skillId, session.localMcp);
 	let body;
 	if (showingMoreInfo) body = /* @__PURE__ */ jsxs(Box, {
 		flexDirection: "column",
 		width: 56,
+		flexShrink: 0,
 		children: [
 			/* @__PURE__ */ jsx(Box, {
 				flexDirection: "column",
@@ -1103,23 +1438,11 @@ const AgentSkillIntroScreen = ({ store }) => {
 					children: "https://github.com/PostHog/wizard"
 				})] })
 			}),
-			/* @__PURE__ */ jsxs(Text, { children: [
-				"Skill:",
-				" ",
-				/* @__PURE__ */ jsx(Text, {
-					italic: true,
-					color: "cyan",
-					children: skillEntry?.id ?? skillId
-				})
-			] }),
-			/* @__PURE__ */ jsxs(Text, { children: [
-				"URL:",
-				" ",
-				/* @__PURE__ */ jsx(Text, {
-					color: "cyan",
-					children: skillEntry?.downloadUrl ?? (fetchFailed ? "unavailable" : "Loading...")
-				})
-			] }),
+			/* @__PURE__ */ jsx(SkillSourceInfo, {
+				skillId,
+				skillEntry,
+				fetchFailed
+			}),
 			/* @__PURE__ */ jsx(Box, {
 				marginTop: 1,
 				children: /* @__PURE__ */ jsx(Text, {
@@ -1167,7 +1490,7 @@ const AgentSkillIntroScreen = ({ store }) => {
 		installDir: session.installDir,
 		showSubtitle: !showingMoreInfo,
 		body,
-		showDetection: isMainMenu,
+		showDetection: !showingMoreInfo,
 		workflowLabel: session.workflowLabel,
 		skillId: session.skillId,
 		menuOptions,
@@ -1175,39 +1498,813 @@ const AgentSkillIntroScreen = ({ store }) => {
 	});
 };
 //#endregion
-//#region src/ui/tui/screens/SetupScreen.tsx
-/**
-* SetupScreen — Generic framework disambiguation.
-*
-* Iterates unresolved setup questions from the FrameworkConfig
-* and renders a PickerMenu for each. If all questions are auto-resolved,
-* this screen is skipped entirely (the router skips it via its show() predicate).
-*/
-const SetupScreen = ({ store }) => {
+//#region src/ui/tui/screens/audit/AuditIntroScreen.tsx
+const AUDIT_SKILL_ID = "audit";
+const AuditIntroScreen = ({ store }) => {
 	useSyncExternalStore((cb) => store.subscribe(cb), () => store.getSnapshot());
-	const config = store.session.frameworkConfig;
-	const questions = config?.metadata.setup?.questions ?? [];
-	const [currentIndex, setCurrentIndex] = useState(0);
-	const [resolving, setResolving] = useState(true);
-	useEffect(() => {
-		(async () => {
-			for (const q of questions) {
-				if (q.key in store.session.frameworkContext) continue;
-				try {
-					const detected = await q.detect({ installDir: store.session.installDir });
-					if (detected !== null) store.setFrameworkContext(q.key, detected);
-				} catch {}
-			}
-			setResolving(false);
-		})();
-	}, []);
-	if (resolving) return /* @__PURE__ */ jsx(Box, {
+	const [showingMoreInfo, setShowingMoreInfo] = useState(false);
+	const { session } = store;
+	const { skillEntry, fetchFailed } = useSkillEntry(AUDIT_SKILL_ID, session.localMcp);
+	const body = showingMoreInfo ? /* @__PURE__ */ jsxs(Box, {
 		flexDirection: "column",
-		flexGrow: 1,
-		children: /* @__PURE__ */ jsx(Text, {
-			dimColor: true,
-			children: "Detecting project configuration..."
-		})
+		width: 56,
+		children: [
+			/* @__PURE__ */ jsx(Box, {
+				marginBottom: 1,
+				children: /* @__PURE__ */ jsxs(Text, { children: ["The wizard is an agent that executes PostHog tasks. Its code is open source: ", /* @__PURE__ */ jsx(Text, {
+					color: "cyan",
+					children: "https://github.com/PostHog/wizard"
+				})] })
+			}),
+			/* @__PURE__ */ jsxs(Text, { children: [
+				"The",
+				" ",
+				/* @__PURE__ */ jsx(Text, {
+					color: "cyan",
+					italic: true,
+					children: AUDIT_SKILL_ID
+				}),
+				" ",
+				"workflow reviews your project's PostHog integration against best practices to help you capture high-quality events and writes a report for suggested actions. Nothing in your project will be modified."
+			] }),
+			/* @__PURE__ */ jsx(Box, {
+				marginTop: 1,
+				children: /* @__PURE__ */ jsx(SkillSourceInfo, {
+					skillId: AUDIT_SKILL_ID,
+					skillEntry,
+					fetchFailed
+				})
+			})
+		]
+	}) : /* @__PURE__ */ jsx(Box, {
+		flexDirection: "column",
+		alignItems: "center",
+		children: /* @__PURE__ */ jsx(Text, { children: "Let's review your existing PostHog setup for best practices." })
+	});
+	const menuOptions = showingMoreInfo ? [{
+		label: "Back",
+		value: "back"
+	}] : [
+		{
+			label: "Continue",
+			value: "continue"
+		},
+		{
+			label: "More info",
+			value: "more-info"
+		},
+		{
+			label: "Cancel",
+			value: "cancel"
+		}
+	];
+	const handleSelect = (value) => {
+		if (value === "cancel") process.exit(0);
+		else if (value === "more-info") setShowingMoreInfo(true);
+		else if (value === "back") setShowingMoreInfo(false);
+		else store.completeSetup();
+	};
+	return /* @__PURE__ */ jsx(IntroScreenLayout, {
+		installDir: session.installDir,
+		body,
+		showDetection: !showingMoreInfo,
+		workflowLabel: session.workflowLabel,
+		skillId: session.skillId,
+		menuOptions,
+		onSelect: handleSelect
+	});
+};
+//#endregion
+//#region src/ui/tui/hooks/file-watcher.ts
+/**
+* File watcher (UI concern).
+*
+* `fs.watch` alone is unreliable for atomic-rename writes (which is how Claude
+* rewrites JSON files), so the watcher pairs `fs.watch` with a continuous
+* mtime-polled re-read. The poll catches missed events; the watch keeps
+* latency low when it does fire. We dedupe with `mtimeMs` so steady-state
+* polls cost a single `stat`.
+*
+* Screens that need to mirror an agent-emitted JSON file into the store call
+* `useFileWatcher(absolutePath, onUpdate)`; the watcher starts on mount and
+* tears down on unmount.
+*/
+const DEFAULT_POLL_INTERVAL_MS = 5e3;
+const DEFAULT_ATTACH_RETRY_INTERVAL_MS = 1e3;
+/** Watch `path` for JSON updates and call `onUpdate(parsed)` whenever the
+*  file's mtime changes and the contents are valid JSON. Caller must invoke
+*  `handle.stop()` to release the watcher. */
+function startFileWatcher(path, onUpdate, options = {}) {
+	const pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+	const attachRetryIntervalMs = options.attachRetryIntervalMs ?? DEFAULT_ATTACH_RETRY_INTERVAL_MS;
+	const watchers = [];
+	const intervals = [];
+	let lastMtimeMs = 0;
+	const read = (force = false) => {
+		try {
+			const stat = fs$1.statSync(path);
+			if (!force && stat.mtimeMs === lastMtimeMs) return;
+			lastMtimeMs = stat.mtimeMs;
+			onUpdate(JSON.parse(fs$1.readFileSync(path, "utf-8")));
+		} catch {}
+	};
+	intervals.push(setInterval(() => read(), pollIntervalMs));
+	try {
+		watchers.push(fs$1.watch(path, () => read(true)));
+		read(true);
+	} catch {
+		const attachInterval = setInterval(() => {
+			try {
+				fs$1.accessSync(path);
+				clearInterval(attachInterval);
+				const idx = intervals.indexOf(attachInterval);
+				if (idx >= 0) intervals.splice(idx, 1);
+				watchers.push(fs$1.watch(path, () => read(true)));
+			} catch {}
+		}, attachRetryIntervalMs);
+		intervals.push(attachInterval);
+	}
+	return { stop() {
+		for (const w of watchers) w.close();
+		for (const i of intervals) clearInterval(i);
+	} };
+}
+/** React hook wrapping `startFileWatcher`. Starts on mount, stops on unmount
+*  or when `path` changes. `onUpdate` and `options` are captured at mount
+*  time — change `path` to restart with a new callback. */
+function useFileWatcher(path, onUpdate, options = {}) {
+	useEffect(() => {
+		const handle = startFileWatcher(path, onUpdate, options);
+		return () => handle.stop();
+	}, [path]);
+}
+//#endregion
+//#region src/ui/tui/screens/audit/slides/shared.tsx
+/** Narrow bordered box for the small ASCII illustrations in baseline slides. */
+const VisualBox = ({ children }) => /* @__PURE__ */ jsx(Box, {
+	borderStyle: "single",
+	borderColor: Colors.muted,
+	paddingX: 1,
+	flexDirection: "column",
+	marginBottom: 1,
+	children
+});
+//#endregion
+//#region src/ui/tui/screens/audit/slides/installation.tsx
+const InstallationVisual = () => /* @__PURE__ */ jsxs(VisualBox, { children: [
+	/* @__PURE__ */ jsx(Text, {
+		dimColor: true,
+		children: "app boot"
+	}),
+	/* @__PURE__ */ jsxs(Text, { children: [
+		/* @__PURE__ */ jsx(Text, {
+			dimColor: true,
+			children: "  ▼ "
+		}),
+		/* @__PURE__ */ jsx(Text, {
+			color: "green",
+			children: "posthog.init(...)"
+		}),
+		/* @__PURE__ */ jsx(Text, {
+			dimColor: true,
+			children: "   once"
+		})
+	] }),
+	/* @__PURE__ */ jsx(Text, {
+		dimColor: true,
+		children: "  │"
+	}),
+	/* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
+		dimColor: true,
+		children: "  ▼ "
+	}), /* @__PURE__ */ jsx(Text, {
+		color: "cyan",
+		children: "posthog.capture('pageview')"
+	})] }),
+	/* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
+		dimColor: true,
+		children: "    "
+	}), /* @__PURE__ */ jsx(Text, {
+		color: "cyan",
+		children: "posthog.capture('signup')"
+	})] }),
+	/* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
+		dimColor: true,
+		children: "    "
+	}), /* @__PURE__ */ jsx(Text, {
+		color: "cyan",
+		children: "posthog.capture('purchase')"
+	})] })
+] });
+const InstallationSlide = {
+	area: "Installation",
+	intro: [
+		"PostHog releases frequent SDK updates to fix bugs and add new features. We're checking your project's SDK version and making sure it's up to date.",
+		"We're also checking that your SDK is initialized correctly and in the right part of your app's lifecycle.",
+		"This ensures you won't miss any autocaptured events."
+	],
+	visual: /* @__PURE__ */ jsx(InstallationVisual, {}),
+	docsUrl: "https://posthog.com/docs/getting-started/install"
+};
+//#endregion
+//#region src/ui/tui/screens/audit/slides/identification.tsx
+const IdentificationVisual = () => /* @__PURE__ */ jsxs(VisualBox, { children: [
+	/* @__PURE__ */ jsxs(Text, { children: [
+		/* @__PURE__ */ jsx(Text, {
+			bold: true,
+			children: "browser "
+		}),
+		/* @__PURE__ */ jsx(Text, {
+			dimColor: true,
+			children: "capture"
+		}),
+		/* @__PURE__ */ jsx(Text, { children: " (" }),
+		/* @__PURE__ */ jsx(Text, {
+			color: "cyan",
+			children: "u_42"
+		}),
+		/* @__PURE__ */ jsx(Text, { children: ", \"click\")" })
+	] }),
+	/* @__PURE__ */ jsx(Text, {
+		dimColor: true,
+		children: "           │"
+	}),
+	/* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
+		dimColor: true,
+		children: "           ▼ "
+	}), /* @__PURE__ */ jsx(Text, {
+		color: "green",
+		children: "same distinct_id"
+	})] }),
+	/* @__PURE__ */ jsx(Text, {
+		dimColor: true,
+		children: "           │"
+	}),
+	/* @__PURE__ */ jsxs(Text, { children: [
+		/* @__PURE__ */ jsx(Text, {
+			bold: true,
+			children: "server  "
+		}),
+		/* @__PURE__ */ jsx(Text, {
+			dimColor: true,
+			children: "capture"
+		}),
+		/* @__PURE__ */ jsx(Text, { children: " (" }),
+		/* @__PURE__ */ jsx(Text, {
+			color: "cyan",
+			children: "u_42"
+		}),
+		/* @__PURE__ */ jsx(Text, { children: ", \"charged\")" })
+	] })
+] });
+const IdentificationSlide = {
+	area: "Identification",
+	intro: [
+		"For events to be useful, they need to be reliably attributed to a user.",
+		"We're checking your project's `identify()` calls to make sure they're correctly and consistently implemented.",
+		"We're also checking that your `distinct_id`s are correctly passed between your client and server runtimes if applicable."
+	],
+	visual: /* @__PURE__ */ jsx(IdentificationVisual, {}),
+	docsUrl: "https://posthog.com/docs/product-analytics/identify"
+};
+//#endregion
+//#region src/ui/tui/screens/audit/slides/eventCapture.tsx
+const CaptureVisual = () => /* @__PURE__ */ jsxs(VisualBox, { children: [
+	/* @__PURE__ */ jsxs(Text, { children: [
+		/* @__PURE__ */ jsx(Text, {
+			color: "cyan",
+			children: "pageview   "
+		}),
+		/* @__PURE__ */ jsx(Text, {
+			color: "green",
+			children: "████████████"
+		}),
+		/* @__PURE__ */ jsx(Text, {
+			dimColor: true,
+			children: " 1000"
+		})
+	] }),
+	/* @__PURE__ */ jsxs(Text, { children: [
+		/* @__PURE__ */ jsx(Text, {
+			color: "cyan",
+			children: "signup     "
+		}),
+		/* @__PURE__ */ jsx(Text, {
+			color: "green",
+			children: "████████"
+		}),
+		/* @__PURE__ */ jsx(Text, {
+			dimColor: true,
+			children: "      640"
+		})
+	] }),
+	/* @__PURE__ */ jsxs(Text, { children: [
+		/* @__PURE__ */ jsx(Text, {
+			color: "cyan",
+			children: "activated  "
+		}),
+		/* @__PURE__ */ jsx(Text, {
+			color: "green",
+			children: "█████"
+		}),
+		/* @__PURE__ */ jsx(Text, {
+			dimColor: true,
+			children: "         410"
+		})
+	] }),
+	/* @__PURE__ */ jsxs(Text, { children: [
+		/* @__PURE__ */ jsx(Text, {
+			color: "cyan",
+			children: "purchased  "
+		}),
+		/* @__PURE__ */ jsx(Text, {
+			color: "green",
+			children: "██"
+		}),
+		/* @__PURE__ */ jsx(Text, {
+			dimColor: true,
+			children: "            120"
+		})
+	] })
+] });
+//#endregion
+//#region src/ui/tui/screens/audit/slides/index.ts
+const AUDIT_AREA_SLIDES = [
+	InstallationSlide,
+	IdentificationSlide,
+	{
+		area: "Event Capture",
+		intro: [
+			"Everything you do in PostHog starts with event captures. Every dashboard, insight, funnel, cohort, and replay is built on top of events.",
+			"We're checking that your project's event capture calls cover key user actions and use sensible event names, so you can build high-quality insights and reports.",
+			"We're also checking that you use a reverse proxy so your events are not blocked by ad blockers or tracking blockers."
+		],
+		visual: /* @__PURE__ */ jsx(CaptureVisual, {}),
+		docsUrl: "https://posthog.com/docs/product-analytics/capture-events"
+	}
+];
+//#endregion
+//#region src/ui/tui/screens/audit/AuditAreaPane.tsx
+/**
+* AuditAreaPane — left-pane slide that follows whatever area the agent is
+* currently checking, plus a wrap-up state once every check is resolved
+* and the agent has moved on to writing the report.
+*
+* Three states, gated top-down on the ledger:
+*   1. firstPending defined          → render the slide for that area
+*   2. checks empty                  → blank (the seed hook fires before
+*                                       this screen mounts in practice;
+*                                       this is just defensive)
+*   3. all checks non-pending        → "writing report" wrap-up
+*
+* Pressing `O` opens the active slide's docs URL.
+*/
+const FINDING_STATUSES = [
+	"error",
+	"warning",
+	"suggestion"
+];
+const isFinding = (c) => FINDING_STATUSES.includes(c.status);
+const fallbackSlide = (area) => ({
+	area,
+	intro: [`Verifying ${area.toLowerCase()}…`],
+	docsUrl: ""
+});
+const openLink = (url) => {
+	spawn(process.platform === "darwin" ? "open" : process.platform === "win32" ? "cmd" : "xdg-open", process.platform === "win32" ? [
+		"/c",
+		"start",
+		"",
+		url
+	] : [url], {
+		detached: true,
+		stdio: "ignore"
+	}).unref();
+};
+const AuditAreaPane = ({ checks, reportPath }) => {
+	const activeArea = checks.filter((c) => c.status === "pending")[0]?.area;
+	const slide = activeArea ? AUDIT_AREA_SLIDES.find((s) => s.area === activeArea) ?? fallbackSlide(activeArea) : null;
+	useInput((input) => {
+		if (input.toLowerCase() === "o" && slide?.docsUrl) openLink(slide.docsUrl);
+	});
+	if (slide) return /* @__PURE__ */ jsx(ActiveSlide, {
+		slide,
+		hasFindings: checks.some(isFinding)
+	});
+	if (checks.length === 0) return null;
+	return /* @__PURE__ */ jsx(WritingReport, { reportPath });
+};
+const ActiveSlide = ({ slide, hasFindings }) => /* @__PURE__ */ jsxs(Box, {
+	flexDirection: "column",
+	paddingX: 1,
+	children: [
+		/* @__PURE__ */ jsxs(Text, {
+			bold: true,
+			color: Colors.accent,
+			children: ["Verifying ", slide.area.toLowerCase()]
+		}),
+		/* @__PURE__ */ jsx(Box, { height: 1 }),
+		slide.visual,
+		slide.intro.map((paragraph, i) => /* @__PURE__ */ jsxs(Fragment, { children: [i > 0 && /* @__PURE__ */ jsx(Box, { height: 1 }), /* @__PURE__ */ jsx(Text, { children: paragraph })] }, i)),
+		/* @__PURE__ */ jsx(Box, {
+			marginTop: 1,
+			children: /* @__PURE__ */ jsxs(Text, {
+				dimColor: true,
+				children: [slide.docsUrl && /* @__PURE__ */ jsxs(Fragment$1, { children: [
+					"[",
+					/* @__PURE__ */ jsx(Text, {
+						color: Colors.accent,
+						children: "O"
+					}),
+					"] Learn more"
+				] }), hasFindings && /* @__PURE__ */ jsxs(Fragment$1, { children: [
+					slide.docsUrl && "  ",
+					"[",
+					/* @__PURE__ */ jsx(Text, {
+						color: Colors.accent,
+						children: "→"
+					}),
+					"] View issues"
+				] })]
+			})
+		})
+	]
+});
+const WritingReport = ({ reportPath }) => /* @__PURE__ */ jsxs(Box, {
+	flexDirection: "column",
+	paddingX: 1,
+	children: [
+		/* @__PURE__ */ jsx(Text, {
+			bold: true,
+			color: Colors.accent,
+			children: "We've wrapped up the review."
+		}),
+		/* @__PURE__ */ jsx(Box, { height: 1 }),
+		/* @__PURE__ */ jsxs(Text, { children: [
+			"To help you get the most out of your PostHog integration, we're preparing a report for you at ",
+			/* @__PURE__ */ jsx(Text, {
+				color: "cyan",
+				children: reportPath
+			}),
+			"."
+		] }),
+		/* @__PURE__ */ jsx(Box, { height: 1 }),
+		/* @__PURE__ */ jsx(Text, { children: "We'll cover what we checked and suggest where we can improve the existing integration." }),
+		/* @__PURE__ */ jsx(Box, { height: 1 }),
+		/* @__PURE__ */ jsx(Text, {
+			dimColor: true,
+			children: "Hang tight!"
+		})
+	]
+});
+//#endregion
+//#region src/ui/tui/screens/audit/PendingChecksList.tsx
+function groupByArea(checks) {
+	const order = [];
+	const map = /* @__PURE__ */ new Map();
+	for (const c of checks) {
+		if (!map.has(c.area)) {
+			map.set(c.area, []);
+			order.push(c.area);
+		}
+		map.get(c.area).push(c);
+	}
+	return order.map((area) => ({
+		area,
+		checks: map.get(area)
+	}));
+}
+function groupIcon(group) {
+	const total = group.checks.length;
+	const complete = group.checks.filter((c) => c.status !== "pending").length;
+	if (complete === 0) return {
+		icon: Icons.squareOpen,
+		color: Colors.muted
+	};
+	if (complete === total) return {
+		icon: Icons.squareFilled,
+		color: Colors.success
+	};
+	return {
+		icon: Icons.triangleRight,
+		color: Colors.primary
+	};
+}
+const GroupHeader = ({ group, showIcon, isActive }) => {
+	const complete = group.checks.filter((c) => c.status !== "pending").length;
+	const total = group.checks.length;
+	const { icon, color } = groupIcon(group);
+	return /* @__PURE__ */ jsxs(Box, { children: [isActive ? /* @__PURE__ */ jsx(Box, {
+		marginRight: 1,
+		children: /* @__PURE__ */ jsx(Spinner, {})
+	}) : showIcon ? /* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
+		color,
+		children: icon
+	}), " "] }) : null, /* @__PURE__ */ jsxs(Text, { children: [
+		/* @__PURE__ */ jsx(Text, {
+			bold: true,
+			children: group.area
+		}),
+		" ",
+		/* @__PURE__ */ jsxs(Text, {
+			dimColor: true,
+			children: [
+				"(",
+				complete,
+				"/",
+				total,
+				")"
+			]
+		})
+	] })] });
+};
+const CheckRow = ({ check }) => {
+	const { glyph, color } = AUDIT_SEVERITY_STYLE[check.status];
+	return /* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
+		color,
+		children: glyph
+	}), /* @__PURE__ */ jsxs(Text, {
+		dimColor: check.status === "pending",
+		children: [" ", check.label]
+	})] });
+};
+const COLLAPSE_BELOW_ROWS = 24;
+const PendingChecksList = ({ checks }) => {
+	const [, termRows] = useStdoutDimensions();
+	if (checks.length === 0) return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		children: [
+			/* @__PURE__ */ jsx(Text, {
+				bold: true,
+				children: "Checks"
+			}),
+			/* @__PURE__ */ jsx(Text, { children: " " }),
+			/* @__PURE__ */ jsx(LoadingBox, { message: "Seeding audit checklist..." })
+		]
+	});
+	const groups = groupByArea(checks);
+	const activeIndex = groups.findIndex((g) => g.checks.some((c) => c.status === "pending"));
+	return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		children: [
+			/* @__PURE__ */ jsx(Text, {
+				bold: true,
+				children: "Checks"
+			}),
+			/* @__PURE__ */ jsx(Text, { children: " " }),
+			termRows < COLLAPSE_BELOW_ROWS ? groups.map((group, i) => /* @__PURE__ */ jsx(GroupHeader, {
+				group,
+				showIcon: true,
+				isActive: i === activeIndex
+			}, group.area)) : groups.map((group, i) => /* @__PURE__ */ jsxs(Box, {
+				flexDirection: "column",
+				marginTop: i === 0 ? 0 : 1,
+				children: [/* @__PURE__ */ jsx(GroupHeader, {
+					group,
+					showIcon: false,
+					isActive: i === activeIndex
+				}), group.checks.map((c) => /* @__PURE__ */ jsx(CheckRow, { check: c }, c.id))]
+			}, group.area))
+		]
+	});
+};
+//#endregion
+//#region src/ui/tui/screens/audit/AuditRunScreen.tsx
+const AuditRunScreen = ({ store }) => {
+	useSyncExternalStore((cb) => store.subscribe(cb), () => store.getSnapshot());
+	useFileWatcher(join(store.session.installDir, AUDIT_CHECKS_FILE), (parsed) => store.setFrameworkContext(AUDIT_CHECKS_KEY, coerceAuditChecks(parsed)));
+	const statuses = store.statusMessages.length > 0 ? store.statusMessages : void 0;
+	const [columns] = useStdoutDimensions();
+	const checks = getAuditChecks(store.session);
+	const reportPath = `./${AUDIT_REPORT_FILE}`;
+	const pendingChecksList = /* @__PURE__ */ jsx(PendingChecksList, { checks });
+	return /* @__PURE__ */ jsx(TabContainer, {
+		tabs: [
+			{
+				id: "status",
+				label: "Status",
+				component: columns < 80 ? /* @__PURE__ */ jsx(Box, {
+					flexDirection: "column",
+					flexGrow: 1,
+					children: pendingChecksList
+				}) : /* @__PURE__ */ jsx(SplitView, {
+					left: /* @__PURE__ */ jsx(AuditAreaPane, {
+						checks,
+						reportPath
+					}),
+					right: pendingChecksList
+				})
+			},
+			{
+				id: "audit-checks",
+				label: "Audit plan",
+				component: /* @__PURE__ */ jsx(AuditChecksViewer, { checks })
+			},
+			{
+				id: "logs",
+				label: "Tail logs",
+				component: /* @__PURE__ */ jsx(LogViewer, { filePath: WIZARD_LOG_FILE })
+			},
+			{
+				id: "hn",
+				label: "HN",
+				component: /* @__PURE__ */ jsx(HNViewer, {})
+			}
+		],
+		statusMessage: statuses,
+		expandableStatus: true,
+		store
+	});
+};
+//#endregion
+//#region src/ui/tui/screens/audit/AuditChecksOutroSection.tsx
+const MAX_VISIBLE = 6;
+const AuditChecksOutroSection = ({ checks, installDir }) => {
+	if (checks.length === 0) return null;
+	const errors = checks.filter((c) => c.status === "error");
+	const warnings = checks.filter((c) => c.status === "warning");
+	const suggestions = checks.filter((c) => c.status === "suggestion");
+	const problematic = [
+		...errors,
+		...warnings,
+		...suggestions
+	];
+	const visible = problematic.slice(0, MAX_VISIBLE);
+	const hidden = problematic.length - visible.length;
+	return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		marginTop: 1,
+		children: [
+			/* @__PURE__ */ jsx(Text, {
+				color: "cyan",
+				bold: true,
+				children: "Items audited:"
+			}),
+			/* @__PURE__ */ jsxs(Text, {
+				dimColor: true,
+				children: [
+					checks.length,
+					" checks · ",
+					errors.length,
+					" errors · ",
+					warnings.length,
+					" ",
+					"warnings · ",
+					suggestions.length,
+					" suggestions"
+				]
+			}),
+			problematic.length === 0 ? /* @__PURE__ */ jsxs(Text, {
+				color: "green",
+				children: ["•", " No issues found."]
+			}) : /* @__PURE__ */ jsxs(Fragment$1, { children: [visible.map((item) => {
+				const style = AUDIT_SEVERITY_STYLE[item.status];
+				return /* @__PURE__ */ jsxs(Box, {
+					flexDirection: "column",
+					marginTop: 1,
+					children: [/* @__PURE__ */ jsxs(Text, { children: [
+						/* @__PURE__ */ jsx(Text, {
+							color: style.color,
+							children: style.glyph
+						}),
+						" ",
+						/* @__PURE__ */ jsx(Text, {
+							bold: true,
+							children: item.label
+						}),
+						" ",
+						/* @__PURE__ */ jsxs(Text, {
+							dimColor: true,
+							children: [
+								"(",
+								item.area,
+								")"
+							]
+						})
+					] }), item.file && /* @__PURE__ */ jsxs(Text, {
+						dimColor: true,
+						children: ["  ", relativeToInstallDir(item.file, installDir)]
+					})]
+				}, item.id);
+			}), hidden > 0 && /* @__PURE__ */ jsxs(Text, {
+				dimColor: true,
+				children: [
+					"… and ",
+					hidden,
+					" more — see the report."
+				]
+			})] })
+		]
+	});
+};
+//#endregion
+//#region src/ui/tui/screens/audit/AuditOutroScreen.tsx
+/**
+* AuditOutroScreen — Audit-specific post-run summary. Renders the standard
+* success / error / cancel views with the audit checks summary inlined into
+* the success body. The report path is hardcoded to AUDIT_REPORT_FILE.
+*/
+const AuditOutroScreen = ({ store }) => {
+	useSyncExternalStore((cb) => store.subscribe(cb), () => store.getSnapshot());
+	useInput(() => {
+		store.setOutroDismissed();
+	});
+	const outroData = store.session.outroData;
+	if (!outroData) return /* @__PURE__ */ jsx(Box, {
+		flexDirection: "column",
+		flexGrow: 1,
+		children: /* @__PURE__ */ jsx(Text, {
+			dimColor: true,
+			children: "Finishing up..."
+		})
+	});
+	return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		flexGrow: 1,
+		children: [
+			outroData.kind === "success" && /* @__PURE__ */ jsxs(Box, {
+				flexDirection: "column",
+				children: [
+					/* @__PURE__ */ jsxs(Text, {
+						color: "green",
+						bold: true,
+						children: ["✔ ", outroData.message || "Audit complete!"]
+					}),
+					/* @__PURE__ */ jsx(AuditChecksOutroSection, {
+						checks: getAuditChecks(store.session),
+						installDir: store.session.installDir
+					}),
+					outroData.docsUrl && /* @__PURE__ */ jsx(Box, {
+						marginTop: 1,
+						children: /* @__PURE__ */ jsxs(Text, { children: ["Learn more: ", /* @__PURE__ */ jsx(Text, {
+							color: "cyan",
+							children: outroData.docsUrl
+						})] })
+					})
+				]
+			}),
+			outroData.kind === "error" && /* @__PURE__ */ jsxs(Box, {
+				flexDirection: "column",
+				children: [/* @__PURE__ */ jsxs(Text, {
+					color: "red",
+					bold: true,
+					children: ["✘ ", outroData.message || "An error occurred"]
+				}), outroData.body && /* @__PURE__ */ jsx(Box, {
+					marginTop: 1,
+					children: /* @__PURE__ */ jsx(Text, {
+						dimColor: true,
+						children: outroData.body
+					})
+				})]
+			}),
+			outroData.kind === "cancel" && /* @__PURE__ */ jsxs(Text, {
+				color: "yellow",
+				children: ["■ ", outroData.message || "Cancelled"]
+			}),
+			/* @__PURE__ */ jsx(Box, {
+				marginTop: 1,
+				children: /* @__PURE__ */ jsx(Text, {
+					color: Colors.muted,
+					children: "Press any key to continue"
+				})
+			})
+		]
+	});
+};
+//#endregion
+//#region src/ui/tui/screens/SetupScreen.tsx
+/**
+* SetupScreen — Generic framework disambiguation.
+*
+* Iterates unresolved setup questions from the FrameworkConfig
+* and renders a PickerMenu for each. If all questions are auto-resolved,
+* this screen is skipped entirely (the router skips it via its show() predicate).
+*/
+const SetupScreen = ({ store }) => {
+	useSyncExternalStore((cb) => store.subscribe(cb), () => store.getSnapshot());
+	const config = store.session.frameworkConfig;
+	const questions = config?.metadata.setup?.questions ?? [];
+	const [currentIndex, setCurrentIndex] = useState(0);
+	const [resolving, setResolving] = useState(true);
+	useEffect(() => {
+		(async () => {
+			for (const q of questions) {
+				if (q.key in store.session.frameworkContext) continue;
+				try {
+					const detected = await q.detect({ installDir: store.session.installDir });
+					if (detected !== null) store.setFrameworkContext(q.key, detected);
+				} catch {}
+			}
+			setResolving(false);
+		})();
+	}, []);
+	if (resolving) return /* @__PURE__ */ jsx(Box, {
+		flexDirection: "column",
+		flexGrow: 1,
+		children: /* @__PURE__ */ jsx(Text, {
+			dimColor: true,
+			children: "Detecting project configuration..."
+		})
 	});
 	const unresolved = questions.filter((q) => !(q.key in store.session.frameworkContext));
 	if (unresolved.length === 0) return null;
@@ -1309,18 +2406,21 @@ const AuthScreen = ({ store }) => {
 //#endregion
 //#region src/ui/tui/screens/RunScreen.tsx
 /**
-* RunScreen — Tabbed observational view of the agent run.
-*
-* Two tabs:
-*   - Status: SplitView with LearnCard (left) + ProgressList (right)
-*   - Logs: LogViewer tailing the wizard log file
+* RunScreen — Default observational view of the agent run.
 *
-* No prompts — the agent runs headlessly.
-* LearnCard shows animated educational content and reacts to discovered features.
+* Tabs: Status (LearnCard + ProgressList), Event plan (when present),
+* Tail logs, HN. Workflows that need a different tab list ship their own
+* screen component (see audit/AuditRunScreen.tsx).
 */
-const LOG_FILE = "/tmp/posthog-wizard.log";
 const RunScreen = ({ store }) => {
 	useSyncExternalStore((cb) => store.subscribe(cb), () => store.getSnapshot());
+	useFileWatcher(join(store.session.installDir, EVENT_PLAN_FILE), (parsed) => {
+		if (!Array.isArray(parsed)) return;
+		store.setEventPlan(parsed.map((e) => ({
+			name: e.name ?? e.event ?? "",
+			description: e.description ?? ""
+		})));
+	});
 	const [columns] = useStdoutDimensions();
 	const progressItems = store.tasks.map((t) => ({
 		label: t.label,
@@ -1367,7 +2467,7 @@ const RunScreen = ({ store }) => {
 			{
 				id: "logs",
 				label: "Tail logs",
-				component: /* @__PURE__ */ jsx(LogViewer, { filePath: LOG_FILE })
+				component: /* @__PURE__ */ jsx(LogViewer, { filePath: WIZARD_LOG_FILE })
 			},
 			{
 				id: "hn",
@@ -1390,6 +2490,7 @@ const RunScreen = ({ store }) => {
 *
 * When done, calls store.setSkillsComplete() and exits the process.
 */
+const WIZARD_MARKER = ".posthog-wizard";
 const KeepSkillsScreen = ({ store }) => {
 	useSyncExternalStore((cb) => store.subscribe(cb), () => store.getSnapshot());
 	const [phase, setPhase] = useState("loading");
@@ -1401,7 +2502,12 @@ const KeepSkillsScreen = ({ store }) => {
 				const dirs = (await readdir(skillsDir, { withFileTypes: true })).filter((e) => e.isDirectory());
 				const result = [];
 				for (const dir of dirs) {
-					const children = await readdir(join(skillsDir, dir.name));
+					try {
+						await access(join(skillsDir, dir.name, WIZARD_MARKER));
+					} catch {
+						continue;
+					}
+					const children = (await readdir(join(skillsDir, dir.name))).filter((c) => c !== WIZARD_MARKER);
 					result.push({
 						name: dir.name,
 						children
@@ -1425,8 +2531,14 @@ const KeepSkillsScreen = ({ store }) => {
 	};
 	const handleRemove = async () => {
 		setPhase("removing");
+		for (const skill of skills) try {
+			await rm(join(skillsDir, skill.name), {
+				recursive: true,
+				force: true
+			});
+		} catch {}
 		try {
-			await rm(skillsDir, {
+			if ((await readdir(skillsDir)).length === 0) await rm(skillsDir, {
 				recursive: true,
 				force: true
 			});
@@ -1452,7 +2564,7 @@ const KeepSkillsScreen = ({ store }) => {
 					dimColor: true,
 					children: "Checking installed skills..."
 				}),
-				phase === "ask" && /* @__PURE__ */ jsxs(Fragment, { children: [
+				phase === "ask" && /* @__PURE__ */ jsxs(Fragment$1, { children: [
 					/* @__PURE__ */ jsx(Text, {
 						dimColor: true,
 						children: "The wizard installed open-source skills that help AI coding agents integrate PostHog into your project:"
@@ -1522,9 +2634,11 @@ const KeepSkillsScreen = ({ store }) => {
 //#endregion
 //#region src/ui/tui/screens/OutroScreen.tsx
 /**
-* OutroScreen — Summary after the agent run.
-* Reads store.session.outroData to render success, error, or cancel view.
-* Keeps the process alive until the user presses a key to exit.
+* OutroScreen — Default post-run summary.
+*
+* Renders the success / error / cancel views from `outroData`. Workflows
+* that need a different success view (e.g. with extra summary content)
+* ship their own screen component (see audit/AuditOutroScreen.tsx).
 */
 const OutroScreen = ({ store }) => {
 	useSyncExternalStore((cb) => store.subscribe(cb), () => store.getSnapshot());
@@ -1550,11 +2664,14 @@ const OutroScreen = ({ store }) => {
 					/* @__PURE__ */ jsxs(Text, {
 						color: "green",
 						bold: true,
-						children: [
-							"✔",
-							" ",
-							outroData.message || "Done!"
-						]
+						children: ["✔ ", outroData.message || "Done!"]
+					}),
+					outroData.body && /* @__PURE__ */ jsx(Box, {
+						marginTop: 1,
+						children: /* @__PURE__ */ jsx(Text, {
+							dimColor: true,
+							children: outroData.body
+						})
 					}),
 					outroData.reportFile && /* @__PURE__ */ jsx(Box, {
 						marginTop: 1,
@@ -1574,11 +2691,7 @@ const OutroScreen = ({ store }) => {
 							color: "cyan",
 							bold: true,
 							children: "What the agent did:"
-						}), outroData.changes.map((change, i) => /* @__PURE__ */ jsxs(Text, { children: [
-							"•",
-							" ",
-							change
-						] }, i))]
+						}), outroData.changes.map((change, i) => /* @__PURE__ */ jsxs(Text, { children: ["• ", change] }, i))]
 					}),
 					store.eventPlan.length > 0 && /* @__PURE__ */ jsxs(Box, {
 						flexDirection: "column",
@@ -1588,8 +2701,7 @@ const OutroScreen = ({ store }) => {
 							bold: true,
 							children: "Events added:"
 						}), store.eventPlan.map((event) => /* @__PURE__ */ jsxs(Text, { children: [
-							"•",
-							" ",
+							"• ",
 							/* @__PURE__ */ jsx(Text, {
 								bold: true,
 								children: event.name
@@ -1622,10 +2734,10 @@ const OutroScreen = ({ store }) => {
 							children: "Note: This wizard uses an LLM agent to analyze and modify your project. Please review the changes made."
 						})
 					}),
-					/* @__PURE__ */ jsx(Box, { children: /* @__PURE__ */ jsx(Text, {
+					/* @__PURE__ */ jsx(Text, {
 						dimColor: true,
 						children: "How did this work for you? Drop us a line: wizard@posthog.com"
-					}) })
+					})
 				]
 			}),
 			outroData.kind === "error" && /* @__PURE__ */ jsxs(Box, {
@@ -1634,11 +2746,7 @@ const OutroScreen = ({ store }) => {
 					/* @__PURE__ */ jsxs(Text, {
 						color: "red",
 						bold: true,
-						children: [
-							"✘",
-							" ",
-							outroData.message || "An error occurred"
-						]
+						children: ["✘ ", outroData.message || "An error occurred"]
 					}),
 					outroData.body && /* @__PURE__ */ jsx(Box, {
 						marginTop: 1,
@@ -1660,11 +2768,7 @@ const OutroScreen = ({ store }) => {
 				flexDirection: "column",
 				children: /* @__PURE__ */ jsxs(Text, {
 					color: "yellow",
-					children: [
-						"■",
-						" ",
-						outroData.message || "Cancelled"
-					]
+					children: ["■ ", outroData.message || "Cancelled"]
 				})
 			}),
 			/* @__PURE__ */ jsx(Box, {
@@ -1763,7 +2867,10 @@ function createMcpInstaller() {
 				name: c.name,
 				raw: c
 			}));
-			return supported.map((c) => ({ name: c.name }));
+			return supported.map((c) => ({
+				name: c.name,
+				supportsPlugin: isPluginCapable(c) && c.supportsPlugin()
+			}));
 		},
 		async install(clientNames, features, apiKey) {
 			const resolvedFeatures = features ?? [...ALL_FEATURE_VALUES];
@@ -1786,6 +2893,15 @@ function createMcpInstaller() {
 			if (installed.length === 0) return [];
 			await removeMCPServer(installed);
 			return installed.map((c) => c.name);
+		},
+		async installPlugins(clientNames) {
+			const pluginClients = getSupportedPluginClients(cachedClients.filter((c) => clientNames.includes(c.name)).map((c) => c.raw));
+			const installed = await installPlugins(pluginClients);
+			analytics.wizardCapture("mcp plugins installed", {
+				clients: installed,
+				attempted: pluginClients.map((c) => c.name)
+			});
+			return installed;
 		}
 	};
 }
@@ -1803,7 +2919,12 @@ function createScreens(store, services) {
 		["intro"]: /* @__PURE__ */ jsx(PostHogIntegrationIntroScreen, { store }),
 		["revenue-intro"]: /* @__PURE__ */ jsx(RevenueIntroScreen, { store }),
 		["agent-skill-intro"]: /* @__PURE__ */ jsx(AgentSkillIntroScreen, { store }),
+		["audit-intro"]: /* @__PURE__ */ jsx(AuditIntroScreen, { store }),
+		["audit-run"]: /* @__PURE__ */ jsx(AuditRunScreen, { store }),
+		["audit-outro"]: /* @__PURE__ */ jsx(AuditOutroScreen, { store }),
 		["health-check"]: /* @__PURE__ */ jsx(HealthCheckScreen, { store }),
+		["doctor-intro"]: /* @__PURE__ */ jsx(DoctorIntroScreen, { store }),
+		["doctor-report"]: /* @__PURE__ */ jsx(DoctorReportScreen, { store }),
 		["setup"]: /* @__PURE__ */ jsx(SetupScreen, { store }),
 		["auth"]: /* @__PURE__ */ jsx(AuthScreen, { store }),
 		["run"]: /* @__PURE__ */ jsx(RunScreen, { store }),
@@ -1852,10 +2973,16 @@ const LEAVE_ALT_SCREEN = "\x1B[?1049l";
 const GREEN = "\x1B[32m";
 const BOLD = "\x1B[1m";
 const DIM = "\x1B[2m";
+function releaseTerminal() {
+	process.stdout.write(RESET_ATTRS + LEAVE_ALT_SCREEN);
+}
 function getExitLine(store) {
 	const outro = store.session.outroData;
 	const label = store.session.workflowLabel ?? "Wizard";
-	if (outro?.kind === "success") return `${GREEN}${BOLD}\u2714${RESET_ATTRS} ${outro.message ?? `${label} completed successfully.`}`;
+	if (outro?.kind === "success") {
+		const message = outro.message ?? `${label} completed successfully.`;
+		return `${GREEN}${BOLD}\u2714${RESET_ATTRS} ${message}${outro.reportFile && !message.includes(outro.reportFile) ? ` Check ./${outro.reportFile} for details.` : ""}`;
+	}
 	return `${DIM}${label} exited.${RESET_ATTRS}`;
 }
 function startTUI(version, flow = "posthog-integration") {
@@ -1869,7 +2996,7 @@ function startTUI(version, flow = "posthog-integration") {
 		if (cleaned) return;
 		cleaned = true;
 		inkUnmount();
-		process.stdout.write(RESET_ATTRS + LEAVE_ALT_SCREEN);
+		releaseTerminal();
 		process.stdout.write(getExitLine(store) + "\n");
 	};
 	process.on("exit", cleanup);
@@ -1882,4 +3009,4 @@ function startTUI(version, flow = "posthog-integration") {
 //#endregion
 export { startTUI };
 
-//# sourceMappingURL=start-tui-DkT_H5zx.js.map
+//# sourceMappingURL=start-tui-DleQG3La.js.map