@posthog/wizard 2.13.0 → 2.14.0

package/dist/{start-tui-B_zwutLe.js → start-tui-BwQa3kmG.js}

@@ -1,16 +1,16 @@
-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-Cqi6nVfX.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-CYUB-urp.js";
 import { a as relativeToInstallDir, n as WIZARD_LOG_FILE } from "./paths-DJS47p5x.js";
-import { n as analytics } from "./analytics-VM7laaFx.js";
-import { l as ApiError, p as getUiHostFromHost } from "./setup-utils-CNV7FSlY.js";
-import { t as ADDITIONAL_FEATURE_LABELS } from "./wizard-session-BcNJTl2I.js";
-import { r as wizardAbort } from "./wizard-abort-CJkNkSjT.js";
-import { _ as coerceAuditChecks, d as fetchSkillMenu, g as AUDIT_SEVERITY_STYLE, m as AUDIT_CHECKS_KEY, p as AUDIT_CHECKS_FILE, u as downloadSkill, v as getAuditChecks } from "./agent-interface-CV0-vtxj.js";
-import { t as EVENT_PLAN_FILE } from "./posthog-integration-BL21S3T6.js";
-import { i as fetchHealthIssues, n as getWorkflowConfig, o as POSTHOG_SDKS, s as STRIPE_SDKS } 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-CUNR00bB.js";
-import "./router-COhhuIW3.js";
-import { E as WizardStore, S as SplitView, T as Icons, _ as useStdoutDimensions, a as SEVERITY_ORDER, b as ProgressList, 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 Colors, x as LoadingBox, y as useKeyBindings } from "./AuditChecksViewer-B0J7zcY2.js";
+import { n as analytics } from "./analytics-Dmnxu2zE.js";
+import { l as ApiError, p as getUiHostFromHost } from "./setup-utils-LvtZIY18.js";
+import { t as ADDITIONAL_FEATURE_LABELS } from "./wizard-session-CsI33S4_.js";
+import { r as wizardAbort } from "./wizard-abort-D-t5yDkY.js";
+import { _ as AUDIT_SEVERITY_STYLE, d as downloadSkill, f as fetchSkillMenu, h as AUDIT_CHECKS_KEY, m as AUDIT_CHECKS_FILE, v as coerceAuditChecks, y as getAuditChecks } from "./agent-interface-gP4pkZgS.js";
+import { t as EVENT_PLAN_FILE } from "./posthog-integration-C-FFV5ny.js";
+import { o as Colors, s as Icons } from "./TextBlock-B3cm43YY.js";
+import { c as POSTHOG_SDKS, l as STRIPE_SDKS, n as Program, o as fetchHealthIssues, r as getProgramConfig, s as getContentBlocks } from "./bin.js";
+import { t as ALL_FEATURE_VALUES } from "./defaults-DgKAzsD1.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-BTW9Ey5Z.js";
+import { C as ProgressList, D as WizardStore, S as useKeyBindings, T as SplitView, _ as ModalOverlay, a as IssueTable, b as useStdoutDimensions, c as ServiceHealthList, f as HNViewer, g as LogViewer, h as EventPlanViewer, i as McpScreen, l as TipsCard, m as ScreenContainer, n as AUDIT_AREA_SLIDES, o as SEVERITY_LABEL, p as TabContainer, r as AuditChecksViewer, s as SEVERITY_ORDER, t as AUDIT_3000_AREA_SLIDES, u as LearnCard, v as ConfirmationInput, w as LoadingBox, x as PickerMenu } from "./slides-yyC_W0RZ.js";
 import { spawn, spawnSync } from "node:child_process";
 import { join } from "node:path";
 import * as fs$1 from "fs";
@@ -18,7 +18,7 @@ import path from "path";
 import { Box, Text, render, useInput } from "ink";
 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 { Spinner, TextInput } 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;
@@ -84,8 +84,11 @@ var InkUI = class {
 	showSettingsOverride(conflicts, backupAndFix) {
 		return this.store.showSettingsOverride(conflicts, backupAndFix);
 	}
-	showAuthError() {
-		this.store.showAuthError();
+	showAuthError(detail) {
+		this.store.showAuthError(detail);
+	}
+	requestQuestion(question) {
+		return this.store.requestQuestion(question);
 	}
 	startRun() {
 		this.store.setRunPhase("running");
@@ -135,6 +138,9 @@ var InkUI = class {
 	setEventPlan(events) {
 		this.store.setEventPlan(events);
 	}
+	setDashboardUrl(url) {
+		this.store.setDashboardUrl(url);
+	}
 	setFrameworkContext(key, value) {
 		this.store.setFrameworkContext(key, value);
 	}
@@ -142,14 +148,14 @@ var InkUI = class {
 //#endregion
 //#region src/ui/tui/screens/health/HealthCheckScreen.tsx
 /**
-* HealthCheckScreen — Flow screen between Intro and Auth.
+* HealthCheckScreen — Program screen between Intro and Auth.
 *
 * Three states:
 *   1. Checking: spinner while health check runs
 *   2. Healthy: isComplete returns true, router auto-advances to Auth
 *   3. Blocking outage: shows affected services with Continue/Exit
 */
-const EXAMPLE_PROMPT = "Integrate PostHog into this project using the skill files in .posthog/skills/. Read SKILL.md first, then follow the numbered workflow files in order.";
+const EXAMPLE_PROMPT = "Integrate PostHog into this project using the skill files in .posthog/skills/. Read SKILL.md first, then follow the numbered program files in order.";
 const SkillsDownloadedScreen = () => {
 	useInput(() => {
 		process.exit(0);
@@ -675,7 +681,7 @@ const PortConflictScreen = ({ store }) => {
 //#endregion
 //#region src/ui/tui/screens/IntroScreenLayout.tsx
 /**
-* IntroScreenLayout ��� Shared visual shell for all workflow intro screens.
+* IntroScreenLayout ��� Shared visual shell for all program intro screens.
 *
 * Purely presentational — no store subscription. Parent components own
 * the store subscription and pass derived data as props.
@@ -704,7 +710,7 @@ const WizardTitle = ({ title }) => /* @__PURE__ */ jsxs(Text, {
 		title
 	]
 });
-const IntroScreenLayout = ({ installDir, title = "PostHog Wizard 🦔", showSubtitle = true, body, showDetection = true, detectionRows, children, menuOptions, onSelect, workflowLabel, skillId, errorView }) => {
+const IntroScreenLayout = ({ installDir, title = "PostHog Wizard 🦔", showSubtitle = true, body, showDetection = true, detectionRows, children, menuOptions, onSelect, programLabel, skillId, errorView }) => {
 	const resolvedMenuOptions = menuOptions === void 0 ? [{
 		label: "Continue",
 		value: "continue"
@@ -777,17 +783,17 @@ const IntroScreenLayout = ({ installDir, title = "PostHog Wizard 🦔", showSubt
 						}),
 						" "
 					] }), /* @__PURE__ */ jsxs(Text, { children: [row.value, row.suffix ? ` ${row.suffix}` : ""] })] }, row.label)),
-					workflowLabel && /* @__PURE__ */ jsxs(Text, { children: [
-						"Workflow",
+					programLabel && /* @__PURE__ */ jsxs(Text, { children: [
+						"Program",
 						"  ",
 						/* @__PURE__ */ jsx(Text, {
 							color: "green",
 							children: "✔"
 						}),
 						" ",
-						workflowLabel
+						programLabel
 					] }),
-					workflowLabel === "agent-skill" && skillId && /* @__PURE__ */ jsxs(Text, { children: [
+					programLabel === "agent-skill" && skillId && /* @__PURE__ */ jsxs(Text, { children: [
 						"Skill",
 						"     ",
 						/* @__PURE__ */ jsx(Text, {
@@ -913,7 +919,7 @@ const FrameworkPicker = ({ store, onComplete }) => {
 		})),
 		onSelect: (value) => {
 			const integration = Array.isArray(value) ? value[0] : value;
-			import("./registry-BaMEaAKd.js").then((n) => n.n).then(({ FRAMEWORK_REGISTRY }) => {
+			import("./registry-B92uyoWK.js").then((n) => n.n).then(({ FRAMEWORK_REGISTRY }) => {
 				const config = FRAMEWORK_REGISTRY[integration];
 				store.setFrameworkConfig(integration, config);
 				store.setDetectedFramework(config.metadata.name);
@@ -984,10 +990,10 @@ const PostHogIntegrationIntroScreen = ({ store }) => {
 					/* @__PURE__ */ jsx(Text, {
 						italic: true,
 						color: "cyan",
-						children: session.workflowLabel
+						children: session.programLabel
 					}),
 					" ",
-					"workflow installs the PostHog SDKs, instruments event tracking, and integrates the following dev tools for your application:"
+					"program installs the PostHog SDKs, instruments event tracking, and integrates the following dev tools for your application:"
 				] })
 			}),
 			/* @__PURE__ */ jsxs(Box, {
@@ -1132,7 +1138,7 @@ const PostHogIntegrationIntroScreen = ({ store }) => {
 		detectionRows,
 		menuOptions: unsupported ? null : menuOptions,
 		onSelect: handleSelect,
-		workflowLabel: session.workflowLabel,
+		programLabel: session.programLabel,
 		skillId: session.skillId,
 		children: bodyChildren
 	});
@@ -1188,10 +1194,10 @@ const RevenueIntroScreen = ({ store }) => {
 					/* @__PURE__ */ jsx(Text, {
 						italic: true,
 						color: "cyan",
-						children: session.workflowLabel
+						children: session.programLabel
 					}),
 					" ",
-					"workflow links Stripe customers and purchases to PostHog product data and persons. It unlocks insights like:"
+					"program links Stripe customers and purchases to PostHog product data and persons. It unlocks insights like:"
 				] })
 			}),
 			/* @__PURE__ */ jsxs(Box, {
@@ -1276,7 +1282,7 @@ const RevenueIntroScreen = ({ store }) => {
 		showDetection: !showingMoreInfo,
 		detectionRows,
 		errorView,
-		workflowLabel: session.workflowLabel,
+		programLabel: session.programLabel,
 		skillId: session.skillId,
 		menuOptions,
 		onSelect: (value) => {
@@ -1411,11 +1417,39 @@ const DetectErrorBody = ({ error }) => {
 	}
 };
 //#endregion
+//#region src/ui/tui/screens/MigrationIntroScreen.tsx
+const MigrationIntroScreen = ({ store }) => {
+	useSyncExternalStore((cb) => store.subscribe(cb), () => store.getSnapshot());
+	const { session } = store;
+	const body = /* @__PURE__ */ jsx(Box, {
+		flexDirection: "column",
+		alignItems: "center",
+		children: /* @__PURE__ */ jsx(Text, { children: "Let's migrate this project to PostHog." })
+	});
+	return /* @__PURE__ */ jsx(IntroScreenLayout, {
+		installDir: session.installDir,
+		body,
+		programLabel: session.programLabel,
+		skillId: session.skillId,
+		menuOptions: [{
+			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/AgentSkillIntroScreen.tsx
 /**
-* AgentSkillIntroScreen — Default intro for generic agent-skill workflows.
+* AgentSkillIntroScreen — Default intro for generic agent-skill programs.
 *
-* Workflows that need a different intro ship their own screen component
+* Programs that need a different intro ship their own screen component
 * (see audit/AuditIntroScreen.tsx).
 */
 const AgentSkillIntroScreen = ({ store }) => {
@@ -1491,7 +1525,7 @@ const AgentSkillIntroScreen = ({ store }) => {
 		showSubtitle: !showingMoreInfo,
 		body,
 		showDetection: !showingMoreInfo,
-		workflowLabel: session.workflowLabel,
+		programLabel: session.programLabel,
 		skillId: session.skillId,
 		menuOptions,
 		onSelect: handleSelect
@@ -1499,12 +1533,12 @@ const AgentSkillIntroScreen = ({ store }) => {
 };
 //#endregion
 //#region src/ui/tui/screens/audit/AuditIntroScreen.tsx
-const AUDIT_SKILL_ID = "audit";
 const AuditIntroScreen = ({ store }) => {
 	useSyncExternalStore((cb) => store.subscribe(cb), () => store.getSnapshot());
 	const [showingMoreInfo, setShowingMoreInfo] = useState(false);
 	const { session } = store;
-	const { skillEntry, fetchFailed } = useSkillEntry(AUDIT_SKILL_ID, session.localMcp);
+	const skillId = session.skillId ?? "audit";
+	const { skillEntry, fetchFailed } = useSkillEntry(skillId, session.localMcp);
 	const body = showingMoreInfo ? /* @__PURE__ */ jsxs(Box, {
 		flexDirection: "column",
 		width: 56,
@@ -1522,15 +1556,15 @@ const AuditIntroScreen = ({ store }) => {
 				/* @__PURE__ */ jsx(Text, {
 					color: "cyan",
 					italic: true,
-					children: AUDIT_SKILL_ID
+					children: skillId
 				}),
 				" ",
-				"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."
+				"program 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,
+					skillId,
 					skillEntry,
 					fetchFailed
 				})
@@ -1568,7 +1602,7 @@ const AuditIntroScreen = ({ store }) => {
 		installDir: session.installDir,
 		body,
 		showDetection: !showingMoreInfo,
-		workflowLabel: session.workflowLabel,
+		programLabel: session.programLabel,
 		skillId: session.skillId,
 		menuOptions,
 		onSelect: handleSelect
@@ -1639,212 +1673,6 @@ function useFileWatcher(path, onUpdate, options = {}) {
 	}, [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"
-		})
-	] })
-] });
-const EventCaptureSlide = {
-	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/slides/index.ts
-const AUDIT_AREA_SLIDES = [
-	InstallationSlide,
-	IdentificationSlide,
-	EventCaptureSlide
-];
-//#endregion
 //#region src/ui/tui/screens/audit/AuditAreaPane.tsx
 /**
 * AuditAreaPane — left-pane slide that follows whatever area the agent is
@@ -2077,7 +1905,7 @@ const AuditRunScreen = ({ store }) => {
 	const statuses = store.statusMessages.length > 0 ? store.statusMessages : void 0;
 	const [columns] = useStdoutDimensions();
 	const checks = getAuditChecks(store.session);
-	const reportPath = `./${getWorkflowConfig(store.router.activeFlow)?.reportFile ?? "posthog-audit-report.md"}`;
+	const reportPath = `./${getProgramConfig(store.router.activeProgram).reportFile ?? "posthog-audit-report.md"}`;
 	const pendingChecksList = /* @__PURE__ */ jsx(PendingChecksList, { checks });
 	return /* @__PURE__ */ jsx(TabContainer, {
 		tabs: [
@@ -2204,7 +2032,7 @@ const AuditChecksOutroSection = ({ checks, installDir }) => {
 * 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 shown in the success headline comes from
-* the workflow's `successMessage`, so this screen is workflow-agnostic.
+* the program's `successMessage`, so this screen is program-agnostic.
 */
 const AuditOutroScreen = ({ store }) => {
 	useSyncExternalStore((cb) => store.subscribe(cb), () => store.getSnapshot());
@@ -2391,7 +2219,7 @@ const Audit3000IntroScreen = ({ store }) => {
 					children: AUDIT3000_SKILL_ID
 				}),
 				" ",
-				"workflow reviews your PostHog integration across 34 checks — SDK install, identification, event capture, event quality, stale feature flag hygiene, session replay (fix + optimize), and use-case expansion across 8 PostHog products. When enrichment is available it also produces a company profile and use-case match. Nothing in your project is modified."
+				"program reviews your PostHog integration across 34 checks — SDK install, identification, event capture, event quality, stale feature flag hygiene, session replay (fix + optimize), and use-case expansion across 8 PostHog products. When enrichment is available it also produces a company profile and use-case match. Nothing in your project is modified."
 			] }),
 			/* @__PURE__ */ jsx(Box, {
 				marginTop: 1,
@@ -2482,183 +2310,13 @@ const Audit3000IntroScreen = ({ store }) => {
 		installDir: session.installDir,
 		body,
 		showDetection: !showingMoreInfo,
-		workflowLabel: session.workflowLabel,
+		programLabel: session.programLabel,
 		skillId: session.skillId,
 		menuOptions,
 		onSelect: handleSelect
 	});
 };
 //#endregion
-//#region src/ui/tui/screens/audit-3000/slides/eventQuality.tsx
-const EventQualityVisual = () => /* @__PURE__ */ jsxs(VisualBox, { children: [
-	/* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
-		color: "green",
-		children: "event_clicked    "
-	}), /* @__PURE__ */ jsx(Text, {
-		color: "green",
-		children: "✓"
-	})] }),
-	/* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
-		color: "yellow",
-		children: "eventClicked     "
-	}), /* @__PURE__ */ jsx(Text, {
-		color: "yellow",
-		children: "~  duplicate?"
-	})] }),
-	/* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
-		color: "yellow",
-		children: "click_event      "
-	}), /* @__PURE__ */ jsx(Text, {
-		color: "yellow",
-		children: "~  duplicate?"
-	})] }),
-	/* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
-		color: "red",
-		children: "big_kitchen_sink "
-	}), /* @__PURE__ */ jsx(Text, {
-		color: "red",
-		children: "✗  22 props"
-	})] })
-] });
-const EventQualitySlide = {
-	area: "Event Quality",
-	intro: [
-		"LEVEL 5: EVENT QUALITY. The capture call-sites are clean. The events themselves are the real boss fight.",
-		"Scanning for: naming inconsistencies, semantic duplicates, kitchen-sink event payloads, and (if your PostHog project is linked) which captured events actually drive insights and dashboards.",
-		"4 subagents fan out in parallel. The ticker shows them clearing checks live."
-	],
-	visual: /* @__PURE__ */ jsx(EventQualityVisual, {}),
-	docsUrl: "https://posthog.com/docs/product-analytics/best-practices"
-};
-//#endregion
-//#region src/ui/tui/screens/audit-3000/slides/featureFlags.tsx
-const FeatureFlagsVisual = () => /* @__PURE__ */ jsxs(VisualBox, { children: [
-	/* @__PURE__ */ jsxs(Text, { children: [
-		/* @__PURE__ */ jsx(Text, {
-			color: "red",
-			children: "new-checkout-v2    "
-		}),
-		/* @__PURE__ */ jsx(Text, {
-			dimColor: true,
-			children: "no code refs   "
-		}),
-		/* @__PURE__ */ jsx(Text, {
-			color: "red",
-			children: "DROP"
-		})
-	] }),
-	/* @__PURE__ */ jsxs(Text, { children: [
-		/* @__PURE__ */ jsx(Text, {
-			color: "yellow",
-			children: "beta-dashboard     "
-		}),
-		/* @__PURE__ */ jsx(Text, {
-			dimColor: true,
-			children: "1 ref, 100% on "
-		}),
-		/* @__PURE__ */ jsx(Text, {
-			color: "yellow",
-			children: "REVIEW"
-		})
-	] }),
-	/* @__PURE__ */ jsxs(Text, { children: [
-		/* @__PURE__ */ jsx(Text, {
-			color: "green",
-			children: "killswitch-payments"
-		}),
-		/* @__PURE__ */ jsx(Text, {
-			dimColor: true,
-			children: "live experiment"
-		}),
-		/* @__PURE__ */ jsx(Text, {
-			color: "green",
-			children: "KEEP"
-		})
-	] })
-] });
-const FeatureFlagsSlide = {
-	area: "Feature Flags",
-	intro: [
-		"LEVEL 6: STALE FLAGS. Old flags add evaluation overhead and confuse the next engineer who wonders if a flag is still live.",
-		"Cross-referencing PostHog's stale-flag classification against your source tree. Each flag scored: safe-to-disable, needs-review, or unknown.",
-		"The final report ships with a copy-paste cleanup prompt. We never touch a flag."
-	],
-	visual: /* @__PURE__ */ jsx(FeatureFlagsVisual, {}),
-	docsUrl: "https://posthog.com/docs/feature-flags"
-};
-//#endregion
-//#region src/ui/tui/screens/audit-3000/slides/expansion.tsx
-const ExpansionVisual = () => /* @__PURE__ */ jsxs(VisualBox, { children: [
-	/* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
-		color: "cyan",
-		children: "product analytics  "
-	}), /* @__PURE__ */ jsx(Text, {
-		color: "green",
-		children: "■■■■■"
-	})] }),
-	/* @__PURE__ */ jsxs(Text, { children: [
-		/* @__PURE__ */ jsx(Text, {
-			color: "cyan",
-			children: "error tracking     "
-		}),
-		/* @__PURE__ */ jsx(Text, {
-			color: "red",
-			children: "□□□□□"
-		}),
-		/* @__PURE__ */ jsx(Text, {
-			dimColor: true,
-			children: "  sentry detected"
-		})
-	] }),
-	/* @__PURE__ */ jsxs(Text, { children: [
-		/* @__PURE__ */ jsx(Text, {
-			color: "cyan",
-			children: "session replay     "
-		}),
-		/* @__PURE__ */ jsx(Text, {
-			color: "yellow",
-			children: "■■□□□"
-		}),
-		/* @__PURE__ */ jsx(Text, {
-			dimColor: true,
-			children: "  partial"
-		})
-	] }),
-	/* @__PURE__ */ jsxs(Text, { children: [
-		/* @__PURE__ */ jsx(Text, {
-			color: "cyan",
-			children: "llm observability  "
-		}),
-		/* @__PURE__ */ jsx(Text, {
-			color: "red",
-			children: "□□□□□"
-		}),
-		/* @__PURE__ */ jsx(Text, {
-			dimColor: true,
-			children: "  greenfield"
-		})
-	] })
-] });
-//#endregion
-//#region src/ui/tui/screens/audit-3000/slides/index.ts
-const AUDIT_3000_AREA_SLIDES = [
-	InstallationSlide,
-	IdentificationSlide,
-	EventCaptureSlide,
-	EventQualitySlide,
-	FeatureFlagsSlide,
-	{
-		area: "Use Case: Expansion",
-		intro: [
-			"BONUS ROUND: EXPANSION. You might be paying for tools PostHog covers natively.",
-			"Scanning for competitive SDKs (Sentry, LaunchDarkly, Mixpanel, Datadog, OpenTelemetry, GA4) and PostHog coverage gaps across 8 product surfaces.",
-			"8 subagents in two waves of 4. Each one returns one of: cross-sell, greenfield, gap, or pass."
-		],
-		visual: /* @__PURE__ */ jsx(ExpansionVisual, {}),
-		docsUrl: "https://posthog.com/docs"
-	}
-];
-//#endregion
 //#region src/ui/tui/screens/audit-3000/Audit3000AreaPane.tsx
 /**
 * Audit-3000 right pane — arcade-flavoured fork of `AuditAreaPane`.
@@ -2773,7 +2431,7 @@ const WritingReport = ({ reportPath }) => /* @__PURE__ */ jsxs(Box, {
 //#region src/ui/tui/screens/audit-3000/Audit3000ChecksPanel.tsx
 /**
 * Audit-3000 left pane on the Run screen. Arcade-flavoured fork of the
-* audit workflow's `PendingChecksList`: a running score banner sits on
+* audit program's `PendingChecksList`: a running score banner sits on
 * top, then the area-level "level" headers underneath.
 *
 * Per-check rows are deliberately omitted here — the Hi-score Table tab
@@ -3180,7 +2838,7 @@ const Audit3000RunScreen = ({ store }) => {
 	const [columns] = useStdoutDimensions();
 	const [gameState, setGameState] = useState(() => initialState());
 	const checks = getAuditChecks(store.session);
-	const reportPath = `./${getWorkflowConfig(store.router.activeFlow)?.reportFile ?? AUDIT_3000_REPORT_FILE_FALLBACK}`;
+	const reportPath = `./${getProgramConfig(store.router.activeProgram).reportFile ?? AUDIT_3000_REPORT_FILE_FALLBACK}`;
 	const checksPanel = /* @__PURE__ */ jsx(Audit3000ChecksPanel, { checks });
 	return /* @__PURE__ */ jsx(TabContainer, {
 		tabs: [
@@ -3589,7 +3247,7 @@ const AuthScreen = ({ store }) => {
 * RunScreen — Default observational view of the agent run.
 *
 * Tabs: Status (LearnCard + ProgressList), Event plan (when present),
-* Tail logs, HN. Workflows that need a different tab list ship their own
+* Tail logs, HN. Programs that need a different tab list ship their own
 * screen component (see audit/AuditRunScreen.tsx).
 */
 const RunScreen = ({ store }) => {
@@ -3617,8 +3275,13 @@ const RunScreen = ({ store }) => {
 		});
 	}
 	const statuses = store.statusMessages.length > 0 ? store.statusMessages : void 0;
+	const activeProgram = store.router.activeProgram;
+	const learnBlocks = useMemo(() => {
+		return (getProgramConfig(activeProgram).getContentBlocks ?? getContentBlocks)(store);
+	}, [store, activeProgram]);
 	const leftPane = store.learnCardComplete ? /* @__PURE__ */ jsx(TipsCard, { store }) : /* @__PURE__ */ jsx(LearnCard, {
 		store,
+		blocks: learnBlocks,
 		onComplete: () => store.setLearnCardComplete()
 	});
 	const progressList = /* @__PURE__ */ jsx(ProgressList, {
@@ -3816,7 +3479,7 @@ const KeepSkillsScreen = ({ store }) => {
 /**
 * OutroScreen — Default post-run summary.
 *
-* Renders the success / error / cancel views from `outroData`. Workflows
+* Renders the success / error / cancel views from `outroData`. Programs
 * that need a different success view (e.g. with extra summary content)
 * ship their own screen component (see audit/AuditOutroScreen.tsx).
 */
@@ -3892,6 +3555,17 @@ const OutroScreen = ({ store }) => {
 							})
 						] }, event.name))]
 					}),
+					outroData.dashboardUrl && /* @__PURE__ */ jsx(Box, {
+						marginTop: 1,
+						children: /* @__PURE__ */ jsxs(Text, { children: [
+							"We've also made you a dashboard:",
+							" ",
+							/* @__PURE__ */ jsx(Text, {
+								color: "cyan",
+								children: outroData.dashboardUrl
+							})
+						] })
+					}),
 					outroData.docsUrl && /* @__PURE__ */ jsx(Box, {
 						marginTop: 1,
 						children: /* @__PURE__ */ jsxs(Text, { children: ["Learn more: ", /* @__PURE__ */ jsx(Text, {
@@ -3964,7 +3638,7 @@ const OutroScreen = ({ store }) => {
 //#endregion
 //#region src/ui/tui/screens/ExitScreen.tsx
 /**
-* ExitScreen — Final step in every workflow.
+* ExitScreen — Final step in every program.
 *
 * Renders nothing. Immediately exits the process.
 * The cleanup handler in start-tui.ts handles the exit summary line.
@@ -3978,15 +3652,22 @@ const ExitScreen = () => {
 //#endregion
 //#region src/ui/tui/screens/AuthErrorScreen.tsx
 /**
-* AuthErrorScreen — Shown when the Anthropic API returns a 401.
+* AuthErrorScreen — Shown when the PostHog LLM Gateway returns a 401.
 *
-* Claude Code's own auth can conflict with the wizard's OAuth token.
-* This overlay tells the user to log out of Claude Code and retry.
+* Two distinct causes:
+*  1. Claude Code settings.json / managed-settings overrides ANTHROPIC_*
+*     env vars — auth conflict. Tell the user to log out of Claude Code.
+*  2. The PostHog API key itself was rejected — bad prefix, missing scope,
+*     expired, or wrong region. Don't blame Claude Code in this case.
 */
-const AuthErrorScreen = () => {
+const AuthErrorScreen = ({ store }) => {
+	useSyncExternalStore((cb) => store.subscribe(cb), () => store.getSnapshot());
 	useInput(() => {
 		process.exit(1);
 	});
+	const detail = store.session.authErrorDetail;
+	const hasSettingsConflict = detail?.hasSettingsConflict ?? true;
+	const logFilePath = detail?.logFilePath;
 	return /* @__PURE__ */ jsxs(Box, {
 		flexDirection: "column",
 		flexGrow: 1,
@@ -3996,37 +3677,196 @@ const AuthErrorScreen = () => {
 				bold: true,
 				children: ["✘", " Authentication error"]
 			}),
-			/* @__PURE__ */ jsx(Box, {
+			hasSettingsConflict ? /* @__PURE__ */ jsxs(Fragment$1, { children: [
+				/* @__PURE__ */ jsx(Box, {
+					flexDirection: "column",
+					marginTop: 1,
+					children: /* @__PURE__ */ jsx(Text, { children: "The Wizard couldn't connect to the PostHog LLM Gateway. Claude Code settings on this machine are overriding the Wizard's credentials." })
+				}),
+				/* @__PURE__ */ jsx(Box, {
+					marginTop: 1,
+					children: /* @__PURE__ */ jsx(Text, {
+						dimColor: true,
+						children: "Try logging out of Claude Code temporarily and re-running the Wizard:"
+					})
+				}),
+				/* @__PURE__ */ jsx(Box, {
+					flexDirection: "column",
+					marginTop: 1,
+					paddingLeft: 2,
+					children: /* @__PURE__ */ jsx(Text, {
+						color: "cyan",
+						children: "claude auth logout"
+					})
+				})
+			] }) : /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx(Box, {
 				flexDirection: "column",
 				marginTop: 1,
-				children: /* @__PURE__ */ jsx(Text, { children: "The Wizard couldn't connect to the PostHog LLM Gateway. If you use Claude Code, its credentials might conflict with the Wizard." })
+				children: /* @__PURE__ */ jsx(Text, { children: "The PostHog LLM Gateway rejected the API key. Common causes:" })
+			}), /* @__PURE__ */ jsxs(Box, {
+				flexDirection: "column",
+				marginTop: 1,
+				paddingLeft: 2,
+				children: [
+					/* @__PURE__ */ jsxs(Text, { children: [
+						"•",
+						" Wrong key type — pass a personal API key (",
+						/* @__PURE__ */ jsx(Text, {
+							color: "cyan",
+							children: "phx_xxx"
+						}),
+						")."
+					] }),
+					/* @__PURE__ */ jsxs(Text, {
+						dimColor: true,
+						children: ["  ", "pha_ is an OAuth access token, phc_ is a project key."]
+					}),
+					/* @__PURE__ */ jsxs(Text, { children: [
+						"•",
+						" Missing scope — the key needs",
+						" ",
+						/* @__PURE__ */ jsx(Text, {
+							color: "cyan",
+							children: "llm_gateway:read"
+						}),
+						"."
+					] }),
+					/* @__PURE__ */ jsxs(Text, { children: ["•", " Expired or revoked key."] }),
+					/* @__PURE__ */ jsxs(Text, { children: [
+						"•",
+						" Region mismatch — ",
+						/* @__PURE__ */ jsx(Text, {
+							color: "cyan",
+							children: "--region"
+						}),
+						" must match where the key was issued (us vs eu)."
+					] })
+				]
+			})] }),
+			logFilePath && /* @__PURE__ */ jsx(Box, {
+				marginTop: 1,
+				children: /* @__PURE__ */ jsxs(Text, {
+					dimColor: true,
+					children: ["Verbose log: ", logFilePath]
+				})
 			}),
 			/* @__PURE__ */ jsx(Box, {
 				marginTop: 1,
+				children: /* @__PURE__ */ jsx(Text, {
+					color: Colors.muted,
+					children: "Press any key to exit"
+				})
+			})
+		]
+	});
+};
+//#endregion
+//#region src/ui/tui/screens/WizardAskScreen.tsx
+/**
+* WizardAskScreen — Overlay for the `wizard_ask` MCP tool.
+*
+* Walks the agent's question list one at a time and accumulates answers.
+* When the user submits the last question, the store resolves the
+* pending request and the overlay pops, returning the agent to its run.
+*/
+const WizardAskScreen = ({ store }) => {
+	useSyncExternalStore((cb) => store.subscribe(cb), () => store.getSnapshot());
+	const pending = store.session.pendingQuestion;
+	const [index, setIndex] = useState(0);
+	const [answers, setAnswers] = useState({});
+	const [lastPendingId, setLastPendingId] = useState(null);
+	if (!pending) return null;
+	if (pending.id !== lastPendingId) {
+		setLastPendingId(pending.id);
+		setIndex(0);
+		setAnswers({});
+		return null;
+	}
+	const question = pending.questions[index];
+	if (!question) return null;
+	const total = pending.questions.length;
+	const progress = total > 1 ? `Question ${index + 1} of ${total}` : null;
+	const submit = (value) => {
+		const next = {
+			...answers,
+			[question.id]: value
+		};
+		if (index + 1 < total) {
+			setAnswers(next);
+			setIndex(index + 1);
+			return;
+		}
+		store.resolvePendingQuestion(next);
+	};
+	return /* @__PURE__ */ jsxs(ModalOverlay, {
+		borderColor: Colors.accent,
+		title: `${Icons.diamond} ${pending.source}`,
+		titleColor: Colors.accent,
+		width: 72,
+		children: [
+			progress && /* @__PURE__ */ jsx(Box, {
+				marginBottom: 1,
 				children: /* @__PURE__ */ jsx(Text, {
 					dimColor: true,
-					children: "Try logging out of Claude Code temporarily and re-running the Wizard by running:"
+					children: progress
 				})
 			}),
 			/* @__PURE__ */ jsx(Box, {
 				flexDirection: "column",
-				marginTop: 1,
-				paddingLeft: 2,
-				children: /* @__PURE__ */ jsx(Text, {
-					color: "cyan",
-					children: "claude auth logout"
-				})
+				children: /* @__PURE__ */ jsx(Text, { children: question.prompt })
 			}),
 			/* @__PURE__ */ jsx(Box, {
 				marginTop: 1,
-				children: /* @__PURE__ */ jsx(Text, {
-					color: Colors.muted,
-					children: "Press any key to exit"
-				})
+				children: /* @__PURE__ */ jsx(QuestionInput, {
+					question,
+					onSubmit: submit
+				}, `${pending.id}:${question.id}`)
 			})
 		]
 	});
 };
+const QuestionInput = ({ question, onSubmit }) => {
+	switch (question.kind) {
+		case "single": return /* @__PURE__ */ jsx(PickerMenu, {
+			options: (question.options ?? []).map((o) => ({
+				label: o.label,
+				value: o.value
+			})),
+			onSelect: (value) => {
+				onSubmit(Array.isArray(value) ? value[0] : value);
+			}
+		});
+		case "multi": return /* @__PURE__ */ jsx(PickerMenu, {
+			mode: "multi",
+			options: (question.options ?? []).map((o) => ({
+				label: o.label,
+				value: o.value
+			})),
+			onSelect: (value) => {
+				onSubmit(Array.isArray(value) ? value : [value]);
+			}
+		});
+		case "text": return /* @__PURE__ */ jsxs(Box, {
+			flexDirection: "column",
+			width: "100%",
+			children: [/* @__PURE__ */ jsx(TextInput, {
+				placeholder: "Type your answer",
+				onSubmit: (value) => onSubmit(value)
+			}), /* @__PURE__ */ jsx(Box, {
+				marginTop: 1,
+				width: "100%",
+				justifyContent: "flex-end",
+				children: /* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
+					color: Colors.accent,
+					children: "ENTER"
+				}), /* @__PURE__ */ jsx(Text, {
+					dimColor: true,
+					children: " submit"
+				})] })
+			})]
+		});
+	}
+};
 //#endregion
 //#region src/ui/tui/services/mcp-installer.ts
 /**
@@ -4095,9 +3935,11 @@ function createScreens(store, services) {
 		["settings-override"]: /* @__PURE__ */ jsx(SettingsOverrideScreen, { store }),
 		["managed-settings"]: /* @__PURE__ */ jsx(ManagedSettingsScreen, { store }),
 		["port-conflict"]: /* @__PURE__ */ jsx(PortConflictScreen, { store }),
-		["auth-error"]: /* @__PURE__ */ jsx(AuthErrorScreen, {}),
+		["auth-error"]: /* @__PURE__ */ jsx(AuthErrorScreen, { store }),
+		["wizard-ask"]: /* @__PURE__ */ jsx(WizardAskScreen, { store }),
 		["intro"]: /* @__PURE__ */ jsx(PostHogIntegrationIntroScreen, { store }),
 		["revenue-intro"]: /* @__PURE__ */ jsx(RevenueIntroScreen, { store }),
+		["migration-intro"]: /* @__PURE__ */ jsx(MigrationIntroScreen, { store }),
 		["agent-skill-intro"]: /* @__PURE__ */ jsx(AgentSkillIntroScreen, { store }),
 		["audit-intro"]: /* @__PURE__ */ jsx(AuditIntroScreen, { store }),
 		["audit-run"]: /* @__PURE__ */ jsx(AuditRunScreen, { store }),
@@ -4161,16 +4003,16 @@ function releaseTerminal() {
 }
 function getExitLine(store) {
 	const outro = store.session.outroData;
-	const label = store.session.workflowLabel ?? "Wizard";
+	const label = store.session.programLabel ?? "Wizard";
 	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") {
+function startTUI(version, program = Program.PostHogIntegration) {
 	process.stdout.write(ENTER_ALT_SCREEN + BG_BLACK + CLEAR_SCREEN + CURSOR_HOME);
-	const store = new WizardStore(flow);
+	const store = new WizardStore(program);
 	store.version = version;
 	setUI(new InkUI(store));
 	const { unmount: inkUnmount } = render(createElement(App, { store }));
@@ -4192,4 +4034,4 @@ function startTUI(version, flow = "posthog-integration") {
 //#endregion
 export { startTUI };
 
-//# sourceMappingURL=start-tui-B_zwutLe.js.map
+//# sourceMappingURL=start-tui-BwQa3kmG.js.map