@posthog/wizard 2.13.0 → 2.14.0

package/dist/bin.js

@@ -1,11 +1,13 @@
 #!/usr/bin/env node
 import { t as __exportAll } from "./rolldown-runtime-B_-DWIq7.js";
-import { D as POSTHOG_DOCS_URL, G as VERSION, K as red, W as runtimeEnv, c as getUI, l as setUI, s as logToFile, u as LoggingUI, z as WIZARD_USER_AGENT } from "./debug-Cqi6nVfX.js";
-import { n as analytics } from "./analytics-VM7laaFx.js";
-import { u as handleApiError } from "./setup-utils-CNV7FSlY.js";
-import { h as AUDIT_REPORT_FILE, m as AUDIT_CHECKS_KEY, p as AUDIT_CHECKS_FILE } from "./agent-interface-CV0-vtxj.js";
-import { n as posthogIntegrationConfig } from "./posthog-integration-BL21S3T6.js";
-import { t as IGNORED_DIRS } from "./file-utils-DnTSiTJw.js";
+import { D as POSTHOG_DOCS_URL, G as VERSION, W as runtimeEnv, c as getUI, f as SIGNUP_WIZARD_READINESS_CONFIG, l as setUI, m as getBlockingServiceKeys, p as evaluateWizardReadiness, s as logToFile, u as LoggingUI, z as WIZARD_USER_AGENT } from "./debug-CYUB-urp.js";
+import { n as analytics } from "./analytics-Dmnxu2zE.js";
+import { a as isUsingTypeScript, d as getCloudUrlFromRegion, u as handleApiError } from "./setup-utils-LvtZIY18.js";
+import { g as AUDIT_REPORT_FILE, h as AUDIT_CHECKS_KEY, m as AUDIT_CHECKS_FILE, u as WIZARD_TOOL_NAMES } from "./agent-interface-gP4pkZgS.js";
+import { i as SPINNER_MESSAGE } from "./registry-B92uyoWK.js";
+import { a as LINE_CHART_BLOCK, i as FUNNEL_BLOCK, n as posthogIntegrationConfig, o as PRODUCT_SUITE_BLOCK, s as StatusPeekTrigger } from "./posthog-integration-C-FFV5ny.js";
+import { o as Colors } from "./TextBlock-B3cm43YY.js";
+import { t as IGNORED_DIRS } from "./file-utils-DPmgn9Vm.js";
 import { satisfies } from "semver";
 import yargs from "yargs";
 import { hideBin } from "yargs/helpers";
@@ -15,6 +17,8 @@ import path, { join, relative } from "path";
 import axios from "axios";
 import { z } from "zod";
 import "fast-glob";
+import { Text } from "ink";
+import { jsx, jsxs } from "react/jsx-runtime";
 //#region src/utils/environment.ts
 var environment_exports = /* @__PURE__ */ __exportAll({
 	isNonInteractiveEnvironment: () => isNonInteractiveEnvironment,
@@ -29,7 +33,7 @@ function readEnvironment() {
 	return readEnv("POSTHOG_WIZARD");
 }
 //#endregion
-//#region src/lib/workflows/revenue-analytics/detect.ts
+//#region src/lib/programs/revenue-analytics/detect.ts
 const POSTHOG_SDKS = [
 	"posthog-js",
 	"posthog-node",
@@ -163,47 +167,85 @@ function detectRevenuePrerequisites(session, setFrameworkContext) {
 	setFrameworkContext("detectedPackagePaths", matches.filter((m) => m.posthogSdks.length > 0 || m.stripeSdks.length > 0).map((m) => m.path));
 }
 //#endregion
-//#region src/lib/workflows/revenue-analytics/index.ts
-const revenueAnalyticsConfig = {
-	command: "revenue",
-	description: "Set up PostHog revenue analytics (e.g. Stripe integration)",
-	flowKey: "revenue-analytics-setup",
-	steps: [
-		{
-			id: "detect",
-			label: "Detecting prerequisites",
-			onReady: (ctx) => detectRevenuePrerequisites(ctx.session, ctx.setFrameworkContext)
-		},
-		{
-			id: "intro",
-			label: "Welcome",
-			screen: "revenue-intro",
-			gate: (session) => session.setupConfirmed
-		},
-		{
-			id: "auth",
-			label: "Authentication",
-			screen: "auth",
-			isComplete: (session) => session.credentials !== null
-		},
+//#region src/lib/programs/revenue-analytics/steps.ts
+const REVENUE_ANALYTICS_PROGRAM = [
+	{
+		id: "detect",
+		label: "Detecting prerequisites",
+		onReady: (ctx) => detectRevenuePrerequisites(ctx.session, ctx.setFrameworkContext)
+	},
+	{
+		id: "intro",
+		label: "Welcome",
+		screenId: "revenue-intro",
+		gate: (session) => session.setupConfirmed
+	},
+	{
+		id: "auth",
+		label: "Authentication",
+		screenId: "auth",
+		isComplete: (session) => session.credentials !== null
+	},
+	{
+		id: "run",
+		label: "Revenue analytics",
+		screenId: "run",
+		isComplete: (session) => session.runPhase === "completed" || session.runPhase === "error"
+	},
+	{
+		id: "outro",
+		label: "Done",
+		screenId: "outro",
+		isComplete: (session) => session.outroDismissed
+	},
+	{
+		id: "skills",
+		label: "Skills",
+		screenId: "keep-skills"
+	}
+];
+//#endregion
+//#region src/lib/programs/agent-skill/content/index.tsx
+/**
+* Agent-skill learn-deck — the short three-line sequence shown while a
+* skill-based program (audit, revenue-analytics, agent-skill, etc.)
+* runs. Skill programs don't need the full PostHog onboarding narrative.
+*/
+const getContentBlocks$1 = (store) => {
+	return [
 		{
-			id: "run",
-			label: "Revenue analytics",
-			screen: "run",
-			isComplete: (session) => session.runPhase === "completed" || session.runPhase === "error"
+			content: "Welcome.",
+			pause: 3e3,
+			mode: 0,
+			animationInterval: 160
 		},
 		{
-			id: "outro",
-			label: "Done",
-			screen: "outro",
-			isComplete: (session) => session.outroDismissed
+			content: "The Wizard is an agent.",
+			pause: 4e3
 		},
 		{
-			id: "skills",
-			label: "Skills",
-			screen: "keep-skills"
+			pause: 6e4,
+			content: /* @__PURE__ */ jsxs(Text, { children: [
+				"Running the ",
+				/* @__PURE__ */ jsx(Text, {
+					color: "cyan",
+					children: store?.session.skillId ?? "unknown"
+				}),
+				" skill..."
+			] })
 		}
-	],
+	];
+};
+//#endregion
+//#region src/lib/programs/revenue-analytics/index.ts
+const revenueAnalyticsConfig = {
+	command: "revenue",
+	description: "Set up PostHog revenue analytics (e.g. Stripe integration)",
+	id: "revenue-analytics-setup",
+	steps: REVENUE_ANALYTICS_PROGRAM,
+	getContentBlocks: getContentBlocks$1,
+	allowedTools: ["Agent"],
+	disallowedTools: [WIZARD_TOOL_NAMES.wizardAsk],
 	run: {
 		skillId: "revenue-analytics-setup",
 		integrationLabel: "revenue-analytics-setup",
@@ -218,48 +260,50 @@ const revenueAnalyticsConfig = {
 	requires: ["posthog-integration"]
 };
 //#endregion
-//#region src/lib/workflows/agent-skill/steps.ts
+//#region src/lib/programs/agent-skill/steps.ts
 const AGENT_SKILL_STEPS = [
 	{
 		id: "intro",
 		label: "Welcome",
-		screen: "agent-skill-intro",
+		screenId: "agent-skill-intro",
 		gate: (session) => session.setupConfirmed
 	},
 	{
 		id: "auth",
 		label: "Authentication",
-		screen: "auth",
+		screenId: "auth",
 		isComplete: (session) => session.credentials !== null
 	},
 	{
 		id: "run",
 		label: "Running",
-		screen: "run",
+		screenId: "run",
 		isComplete: (session) => session.runPhase === "completed" || session.runPhase === "error"
 	},
 	{
 		id: "outro",
 		label: "Done",
-		screen: "outro",
+		screenId: "outro",
 		isComplete: (session) => session.outroDismissed
 	},
 	{
 		id: "skills",
 		label: "Skills",
-		screen: "keep-skills"
+		screenId: "keep-skills"
 	}
 ];
 //#endregion
-//#region src/lib/workflows/agent-skill/index.ts
-var agent_skill_exports = /* @__PURE__ */ __exportAll({ createSkillWorkflow: () => createSkillWorkflow });
-function createSkillWorkflow(opts) {
+//#region src/lib/programs/agent-skill/index.ts
+var agent_skill_exports = /* @__PURE__ */ __exportAll({ createSkillProgram: () => createSkillProgram });
+function createSkillProgram(opts) {
 	return {
 		command: opts.command,
 		description: opts.description,
-		flowKey: opts.flowKey,
+		id: opts.id,
+		skillId: opts.skillId,
 		steps: AGENT_SKILL_STEPS,
 		reportFile: opts.reportFile,
+		getContentBlocks: getContentBlocks$1,
 		run: {
 			skillId: opts.skillId,
 			integrationLabel: opts.integrationLabel,
@@ -276,17 +320,17 @@ function createSkillWorkflow(opts) {
 	};
 }
 //#endregion
-//#region src/lib/workflows/audit/detect.ts
+//#region src/lib/programs/audit/detect.ts
 /** `[ABORT] <reason>` cases the audit skill can emit. Reason strings are
 *  defined in the skill's `Abort statuses` section. */
 const AUDIT_ABORT_CASES = [{
 	match: /^no posthog sdk found$/i,
 	message: "No PostHog SDK found",
-	body: "The audit needs an existing PostHog integration to review. No PostHog SDK appears in this project’s dependency manifests. Run the basic integration workflow to install PostHog first, then re-run the audit.",
+	body: "The audit needs an existing PostHog integration to review. No PostHog SDK appears in this project’s dependency manifests. Run the basic integration program to install PostHog first, then re-run the audit.",
 	docsUrl: "https://posthog.com/docs/getting-started/install"
 }];
 //#endregion
-//#region src/lib/workflows/audit/seed.ts
+//#region src/lib/programs/audit/seed.ts
 /** The 10 data-integrity checks the audit runs. */
 const AUDIT_SEED_CHECKS = [
 	{
@@ -359,7 +403,7 @@ function seedAuditLedger(installDir) {
 	logToFile(`seedAuditLedger: wrote ${AUDIT_SEED_CHECKS.length} entries to ${target}`);
 }
 //#endregion
-//#region src/lib/workflows/audit/index.ts
+//#region src/lib/programs/audit/index.ts
 /** Audit-specific screens for the shared agent-skill pipeline. */
 const AUDIT_SCREEN_BY_STEP = {
 	intro: "audit-intro",
@@ -374,17 +418,17 @@ const withAuditScreens = (steps) => steps.map((step) => {
 	const override = AUDIT_SCREEN_BY_STEP[step.id];
 	return override ? {
 		...step,
-		screen: override
+		screenId: override
 	} : step;
 });
 const auditSteps = withAuditScreens(AGENT_SKILL_STEPS);
-const baseConfig$1 = createSkillWorkflow({
+const baseConfig$1 = createSkillProgram({
 	skillId: "audit",
 	command: "audit",
-	flowKey: "audit",
+	id: "audit",
 	description: "Audit an existing PostHog integration for correctness and best practices",
 	integrationLabel: "audit",
-	customPrompt: "Run a comprehensive audit of the existing PostHog integration. Follow the skill workflow steps in order. Do not modify any project files — only create the final audit report.",
+	customPrompt: "Run a comprehensive audit of the existing PostHog integration. Follow the skill program steps in order. Do not modify any project files — only create the final audit report.",
 	successMessage: "Audit complete! You can view the audit report at ./posthog-audit-report.md",
 	reportFile: AUDIT_REPORT_FILE,
 	docsUrl: "https://posthog.com/docs/product-analytics/best-practices",
@@ -395,16 +439,148 @@ const baseConfig$1 = createSkillWorkflow({
 });
 const auditRun = async (session) => {
 	seedBeforeAuditRun(session);
-	if (!baseConfig$1.run) throw new Error("Audit workflow has no run configuration.");
+	if (!baseConfig$1.run) throw new Error("Audit program has no run configuration.");
 	return typeof baseConfig$1.run === "function" ? baseConfig$1.run(session) : baseConfig$1.run;
 };
 const auditConfig = {
 	...baseConfig$1,
 	steps: auditSteps,
-	run: auditRun
+	run: auditRun,
+	allowedTools: ["Agent"],
+	disallowedTools: [WIZARD_TOOL_NAMES.wizardAsk]
+};
+//#endregion
+//#region src/lib/programs/events-audit/steps.ts
+function needsSetup(session) {
+	const config = session.frameworkConfig;
+	if (!config?.metadata.setup?.questions) return false;
+	return config.metadata.setup.questions.some((q) => !(q.key in session.frameworkContext));
+}
+function healthCheckReady(session) {
+	if (!session.readinessResult) return false;
+	if (session.signup) {
+		const hardBlocking = getBlockingServiceKeys(session.readinessResult.health, SIGNUP_WIZARD_READINESS_CONFIG);
+		const defaultBlocking = getBlockingServiceKeys(session.readinessResult.health);
+		if (hardBlocking.length === 0 && defaultBlocking.length === 0) return true;
+		return session.outageDismissed;
+	}
+	if (session.readinessResult.decision === "no") return session.outageDismissed;
+	return true;
+}
+const EVENTS_AUDIT_PROGRAM = [
+	{
+		id: "intro",
+		label: "Welcome",
+		screenId: "audit-intro",
+		gate: (session) => session.setupConfirmed
+	},
+	{
+		id: "health-check",
+		label: "Health check",
+		screenId: "health-check",
+		gate: healthCheckReady,
+		onInit: (ctx) => {
+			evaluateWizardReadiness().then((readiness) => {
+				ctx.setReadinessResult(readiness);
+			}).catch(() => {
+				ctx.setReadinessResult({
+					decision: "yes",
+					health: {},
+					reasons: []
+				});
+			});
+		}
+	},
+	{
+		id: "setup",
+		label: "Setup",
+		screenId: "setup",
+		show: needsSetup,
+		isComplete: (session) => !needsSetup(session)
+	},
+	{
+		id: "auth",
+		label: "Authentication",
+		screenId: "auth",
+		isComplete: (session) => session.credentials !== null
+	},
+	{
+		id: "run",
+		label: "Events audit",
+		screenId: "audit-run",
+		isComplete: (session) => session.runPhase === "completed" || session.runPhase === "error"
+	},
+	{
+		id: "mcp",
+		label: "MCP servers",
+		screenId: "mcp",
+		isComplete: (session) => session.mcpComplete
+	},
+	{
+		id: "outro",
+		label: "Done",
+		screenId: "audit-outro",
+		isComplete: (session) => session.outroDismissed
+	},
+	{
+		id: "keep-skills",
+		label: "Keep Skills",
+		screenId: "keep-skills"
+	}
+];
+//#endregion
+//#region src/lib/programs/events-audit/index.ts
+const SETUP_REPORT_FILE = "posthog-events-audit-report.md";
+const DOCS_URL = "https://posthog.com/docs/product-analytics/best-practices";
+const eventsAuditConfig = {
+	command: "events-audit",
+	description: "Audit PostHog event tracking in this project",
+	id: "events-audit",
+	skillId: "events-audit",
+	steps: EVENTS_AUDIT_PROGRAM,
+	reportFile: SETUP_REPORT_FILE,
+	allowedTools: ["Agent"],
+	disallowedTools: [WIZARD_TOOL_NAMES.wizardAsk],
+	run: (session) => {
+		const typeScriptDetected = isUsingTypeScript({ installDir: session.installDir });
+		session.typescript = typeScriptDetected;
+		seedAuditLedger(session.installDir);
+		session.frameworkContext[AUDIT_CHECKS_KEY] = AUDIT_SEED_CHECKS;
+		return Promise.resolve({
+			skillId: "events-audit",
+			integrationLabel: "events-audit",
+			spinnerMessage: SPINNER_MESSAGE,
+			successMessage: "Events audit complete! You can view the report at ./posthog-events-audit-report.md",
+			estimatedDurationMinutes: 5,
+			reportFile: SETUP_REPORT_FILE,
+			docsUrl: DOCS_URL,
+			errorMessage: "Events audit failed",
+			additionalFeatureQueue: session.additionalFeatureQueue,
+			customPrompt: (ctx) => `Audit PostHog event capture in this project. Do not modify any project files — produce a read-only report only.
+
+Project context:
+- PostHog Project ID: ${ctx.projectId}
+- TypeScript: ${typeScriptDetected ? "Yes" : "No"}
+- PostHog public token: ${ctx.projectApiKey}
+- PostHog Host: ${ctx.host}
+`,
+			buildOutroData: (sess, _credentials, cloudRegion) => {
+				const cloudUrl = cloudRegion ? getCloudUrlFromRegion(cloudRegion) : void 0;
+				return {
+					kind: "success",
+					message: "Your events audit was successful",
+					reportFile: SETUP_REPORT_FILE,
+					changes: [],
+					docsUrl: DOCS_URL,
+					continueUrl: sess.signup && cloudUrl ? `${cloudUrl}/products?source=wizard` : void 0,
+					dashboardUrl: sess.dashboardUrl ?? (cloudUrl ? `${cloudUrl}/dashboard` : void 0)
+				};
+			}
+		});
+	}
 };
 //#endregion
-//#region src/lib/workflows/audit-3000/index.ts
+//#region src/lib/programs/audit-3000/index.ts
 const AUDIT3000_REPORT_FILE = "posthog-audit-3000-report.md";
 const AUDIT3000_EXTRA_CHECKS = [
 	{
@@ -573,14 +749,14 @@ const withAudit3000Screens = (steps) => steps.map((step) => {
 	const override = AUDIT3000_SCREEN_BY_STEP[step.id];
 	return override ? {
 		...step,
-		screen: override
+		screenId: override
 	} : step;
 });
 const audit3000Steps = withAudit3000Screens(AGENT_SKILL_STEPS);
-const baseConfig = createSkillWorkflow({
+const baseConfig = createSkillProgram({
 	skillId: "audit-3000",
 	command: "audit-3000",
-	flowKey: "audit-3000",
+	id: "audit-3000",
 	description: "Audit an existing PostHog integration (v3000 — adds event quality, stale-flag hygiene, customer enrichment, use-case match)",
 	integrationLabel: "audit-3000",
 	customPrompt: "Run the audit-3000 skill end-to-end. Follow the step chain starting at references/1-version.md. Do not modify any project files — only create the final audit report and (when enrichment is enabled) the enrichment report.",
@@ -594,44 +770,46 @@ const baseConfig = createSkillWorkflow({
 });
 const audit3000Run = async (session) => {
 	seedBeforeAudit3000Run(session);
-	if (!baseConfig.run) throw new Error("audit-3000 workflow has no run configuration.");
+	if (!baseConfig.run) throw new Error("audit-3000 program has no run configuration.");
 	return typeof baseConfig.run === "function" ? baseConfig.run(session) : baseConfig.run;
 };
 const audit3000Config = {
 	...baseConfig,
 	steps: audit3000Steps,
-	run: audit3000Run
+	run: audit3000Run,
+	allowedTools: ["Agent"],
+	disallowedTools: [WIZARD_TOOL_NAMES.wizardAsk]
 };
 //#endregion
-//#region src/lib/workflows/posthog-doctor/steps.ts
-const POSTHOG_DOCTOR_WORKFLOW = [
+//#region src/lib/programs/posthog-doctor/steps.ts
+const POSTHOG_DOCTOR_PROGRAM = [
 	{
 		id: "intro",
 		label: "Welcome",
-		screen: "doctor-intro",
+		screenId: "doctor-intro",
 		gate: (session) => session.setupConfirmed
 	},
 	{
 		id: "auth",
 		label: "Authentication",
-		screen: "auth",
+		screenId: "auth",
 		isComplete: (session) => session.credentials !== null
 	},
 	{
 		id: "report",
 		label: "Doctor report",
-		screen: "doctor-report",
+		screenId: "doctor-report",
 		isComplete: (session) => session.outroData !== null
 	},
 	{
 		id: "outro",
 		label: "Done",
-		screen: "outro",
+		screenId: "outro",
 		isComplete: (session) => session.outroDismissed
 	}
 ];
 //#endregion
-//#region src/lib/workflows/posthog-doctor/types.ts
+//#region src/lib/programs/posthog-doctor/types.ts
 const HealthIssueSeveritySchema = z.enum([
 	"critical",
 	"warning",
@@ -655,7 +833,7 @@ const HealthIssueListResponseSchema = z.object({
 	previous: z.string().nullable().optional()
 });
 //#endregion
-//#region src/lib/workflows/posthog-doctor/fetch.ts
+//#region src/lib/programs/posthog-doctor/fetch.ts
 async function fetchHealthIssues(accessToken, baseUrl, projectId) {
 	const endpoint = `/api/environments/${projectId}/health_issues/`;
 	const url = `${baseUrl}${endpoint}?status=active&dismissed=false&limit=250`;
@@ -676,7 +854,7 @@ async function fetchHealthIssues(accessToken, baseUrl, projectId) {
 	}
 }
 //#endregion
-//#region src/lib/workflows/posthog-doctor/kind-metadata.ts
+//#region src/lib/programs/posthog-doctor/kind-metadata.ts
 const KIND_METADATA = {
 	ingestion_lag: {
 		title: "Ingestion is delayed",
@@ -746,36 +924,649 @@ function getKindMeta(kind) {
 	};
 }
 //#endregion
-//#region src/lib/workflows/workflow-registry.ts
-const WORKFLOW_REGISTRY = [
+//#region src/lib/programs/posthog-doctor/index.ts
+const posthogDoctorConfig = {
+	command: "doctor",
+	description: "Diagnose your PostHog project for configuration issues and setup warnings",
+	id: "posthog-doctor",
+	steps: POSTHOG_DOCTOR_PROGRAM,
+	allowedTools: ["Agent"],
+	disallowedTools: [WIZARD_TOOL_NAMES.wizardAsk]
+};
+//#endregion
+//#region src/lib/programs/migration/steps.ts
+const MIGRATION_PROGRAM = [
+	{
+		id: "intro",
+		label: "Welcome",
+		screenId: "migration-intro",
+		gate: (session) => session.setupConfirmed
+	},
+	{
+		id: "auth",
+		label: "Authentication",
+		screenId: "auth",
+		isComplete: (session) => session.credentials !== null
+	},
+	{
+		id: "run",
+		label: "Migration",
+		screenId: "run",
+		isComplete: (session) => session.runPhase === "completed" || session.runPhase === "error"
+	},
+	{
+		id: "outro",
+		label: "Done",
+		screenId: "outro",
+		isComplete: (session) => session.outroDismissed
+	},
+	{
+		id: "skills",
+		label: "Skills",
+		screenId: "keep-skills"
+	}
+];
+//#endregion
+//#region src/lib/programs/migration/content/vendor-stack.tsx
+/**
+* Vendor cost stack — the multi-tool baseline a typical migration target has
+* before consolidating onto PostHog. Numbers from each vendor's published
+* starter pricing.
+*/
+const VENDOR_STACK_BLOCK = {
+	type: "lines",
+	interval: 600,
+	pause: 9e3,
+	lines: [
+		/* @__PURE__ */ jsx(Text, {
+			bold: true,
+			children: "  Typical pre-migration stack"
+		}),
+		/* @__PURE__ */ jsx(Text, { children: " " }),
+		/* @__PURE__ */ jsxs(Text, { children: [
+			/* @__PURE__ */ jsx(Text, {
+				color: "gray",
+				children: "  Sentry"
+			}),
+			/* @__PURE__ */ jsx(Text, { children: "         error tracking      " }),
+			/* @__PURE__ */ jsx(Text, {
+				color: "red",
+				children: "$26/mo+"
+			})
+		] }),
+		/* @__PURE__ */ jsxs(Text, { children: [
+			/* @__PURE__ */ jsx(Text, {
+				color: "gray",
+				children: "  LaunchDarkly"
+			}),
+			/* @__PURE__ */ jsx(Text, { children: "   feature flags       " }),
+			/* @__PURE__ */ jsx(Text, {
+				color: "red",
+				children: "$8.33/mo+"
+			})
+		] }),
+		/* @__PURE__ */ jsxs(Text, { children: [
+			/* @__PURE__ */ jsx(Text, {
+				color: "gray",
+				children: "  Amplitude"
+			}),
+			/* @__PURE__ */ jsx(Text, { children: "      product analytics   " }),
+			/* @__PURE__ */ jsx(Text, {
+				color: "red",
+				children: "$49/mo+"
+			})
+		] }),
+		/* @__PURE__ */ jsxs(Text, { children: [
+			/* @__PURE__ */ jsx(Text, {
+				color: "gray",
+				children: "  Braintrust"
+			}),
+			/* @__PURE__ */ jsx(Text, { children: "     LLM analytics       " }),
+			/* @__PURE__ */ jsx(Text, {
+				color: "red",
+				children: "$50/mo+"
+			})
+		] }),
+		/* @__PURE__ */ jsx(Text, {
+			color: "gray",
+			children: "  ─────────────────────────────────────"
+		}),
+		/* @__PURE__ */ jsxs(Text, { children: [
+			/* @__PURE__ */ jsx(Text, { children: "  Total" }),
+			/* @__PURE__ */ jsx(Text, { children: "                              " }),
+			/* @__PURE__ */ jsx(Text, {
+				bold: true,
+				color: "red",
+				children: "$133/mo+"
+			})
+		] }),
+		/* @__PURE__ */ jsx(Text, {
+			dimColor: true,
+			children: "  plus ~450KB of JavaScript SDKs"
+		})
+	]
+};
+//#endregion
+//#region src/lib/programs/migration/content/free-tier.tsx
+/**
+* PostHog free-tier highlights — the numbers a migrating team gets back when
+* they consolidate. Sourced from posthog.com/pricing.md.
+*/
+const FREE_TIER_BLOCK = {
+	type: "lines",
+	interval: 400,
+	pause: 9e3,
+	lines: [
+		/* @__PURE__ */ jsx(Text, {
+			bold: true,
+			children: "  Free every month, on every product"
+		}),
+		/* @__PURE__ */ jsx(Text, { children: " " }),
+		/* @__PURE__ */ jsxs(Text, { children: [
+			/* @__PURE__ */ jsx(Text, {
+				color: Colors.accent,
+				children: "  1,000,000  "
+			}),
+			/* @__PURE__ */ jsx(Text, { children: "events " }),
+			/* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: "product analytics"
+			})
+		] }),
+		/* @__PURE__ */ jsxs(Text, { children: [
+			/* @__PURE__ */ jsx(Text, {
+				color: Colors.accent,
+				children: "  1,000,000  "
+			}),
+			/* @__PURE__ */ jsx(Text, { children: "requests " }),
+			/* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: "feature flags + experiments"
+			})
+		] }),
+		/* @__PURE__ */ jsxs(Text, { children: [
+			/* @__PURE__ */ jsx(Text, {
+				color: Colors.accent,
+				children: "      5,000  "
+			}),
+			/* @__PURE__ */ jsx(Text, { children: "recordings " }),
+			/* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: "session replay"
+			})
+		] }),
+		/* @__PURE__ */ jsxs(Text, { children: [
+			/* @__PURE__ */ jsx(Text, {
+				color: Colors.accent,
+				children: "    100,000  "
+			}),
+			/* @__PURE__ */ jsx(Text, { children: "exceptions " }),
+			/* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: "error tracking"
+			})
+		] }),
+		/* @__PURE__ */ jsxs(Text, { children: [
+			/* @__PURE__ */ jsx(Text, {
+				color: Colors.accent,
+				children: "    100,000  "
+			}),
+			/* @__PURE__ */ jsx(Text, { children: "events " }),
+			/* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: "LLM analytics"
+			})
+		] }),
+		/* @__PURE__ */ jsxs(Text, { children: [
+			/* @__PURE__ */ jsx(Text, {
+				color: Colors.accent,
+				children: "      50 GB  "
+			}),
+			/* @__PURE__ */ jsx(Text, { children: "logs " }),
+			/* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: "logs"
+			})
+		] }),
+		/* @__PURE__ */ jsxs(Text, { children: [
+			/* @__PURE__ */ jsx(Text, {
+				color: Colors.accent,
+				children: "      1,500  "
+			}),
+			/* @__PURE__ */ jsx(Text, { children: "responses " }),
+			/* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: "surveys"
+			})
+		] }),
+		/* @__PURE__ */ jsxs(Text, { children: [
+			/* @__PURE__ */ jsx(Text, {
+				color: Colors.accent,
+				children: "  1,000,000  "
+			}),
+			/* @__PURE__ */ jsx(Text, { children: "rows " }),
+			/* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: "data warehouse"
+			})
+		] })
+	]
+};
+//#endregion
+//#region src/lib/programs/migration/content/pricing-structure.tsx
+/**
+* Pricing structure block — what happens after the free tier.
+*/
+const PRICING_STRUCTURE_BLOCK = {
+	type: "lines",
+	interval: 500,
+	pause: 8e3,
+	lines: [
+		/* @__PURE__ */ jsx(Text, {
+			bold: true,
+			children: "  After the free tier"
+		}),
+		/* @__PURE__ */ jsx(Text, { children: " " }),
+		/* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
+			color: Colors.accent,
+			children: "  $0 "
+		}), /* @__PURE__ */ jsx(Text, { children: "base price · pay only for what you use" })] }),
+		/* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
+			color: Colors.accent,
+			children: "  ◆ "
+		}), /* @__PURE__ */ jsx(Text, { children: "per-event prices decrease with volume" })] }),
+		/* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
+			color: Colors.accent,
+			children: "  ◆ "
+		}), /* @__PURE__ */ jsx(Text, { children: "no per-seat charges — your whole team is included" })] }),
+		/* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
+			color: Colors.accent,
+			children: "  ◆ "
+		}), /* @__PURE__ */ jsx(Text, { children: "web analytics bundled with product analytics" })] }),
+		/* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
+			color: Colors.accent,
+			children: "  ◆ "
+		}), /* @__PURE__ */ jsx(Text, { children: "experiments bundled with feature flags" })] }),
+		/* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
+			color: Colors.accent,
+			children: "  ◆ "
+		}), /* @__PURE__ */ jsx(Text, { children: "revenue analytics bundled with data warehouse" })] })
+	]
+};
+//#endregion
+//#region src/lib/programs/migration/content/index.tsx
+/**
+* Migration learn deck (statsig variant). Statsig is the only `migrate`
+* variant today, so this deck plays as-is when the wizard runs
+* `migrate --product=statsig`. Three movements:
+*
+*   1. Welcome and reassure.
+*   2. What to expect — the migration is replacement-only, takes a few
+*      minutes, leaves the build green.
+*   3. What's a little different — how flags and experiments work in
+*      PostHog, presented as right-way guidance rather than gotchas.
+*
+* FF/experiments guidance paraphrased from PostHog public docs:
+*   - posthog.com/docs/feature-flags/best-practices
+*   - posthog.com/docs/feature-flags/common-questions
+*   - posthog.com/docs/experiments/best-practices
+*/
+const getContentBlocks = (store) => [
+	{
+		content: "Hello.",
+		pause: 3e3,
+		mode: 0,
+		animationInterval: 160
+	},
+	{
+		content: "The Wizard is an agent.",
+		pause: 4e3
+	},
+	{
+		content: "As we speak, it’s making a plan to migrate from Statsig to PostHog.",
+		pause: 6e3
+	},
+	{
+		content: "PostHog covers the cost of running this agent.",
+		pause: 4e3
+	},
+	{
+		type: "clear",
+		pause: 2e3
+	},
+	{
+		pause: 5e3,
+		persist: true,
+		content: /* @__PURE__ */ jsx(StatusPeekTrigger, { store })
+	},
+	{
+		pause: 6e3,
+		persist: true,
+		content: /* @__PURE__ */ jsxs(Text, { children: [
+			"Press",
+			" ",
+			/* @__PURE__ */ jsx(Text, {
+				color: Colors.accent,
+				bold: true,
+				children: "S"
+			}),
+			" ",
+			"to expand or collapse the status."
+		] })
+	},
+	{
+		type: "clear",
+		pause: 2e3
+	},
+	{
+		content: "Here’s what to expect.",
+		pause: 3e3
+	},
+	{
+		content: "The migration takes about ten minutes.",
+		pause: 3e3
+	},
+	{
+		content: "Every Statsig call gets replaced in place with its PostHog equivalent.",
+		pause: 5500
+	},
+	{
+		content: "Nothing new gets added. No extra captures, no surprise instrumentation.",
+		pause: 5500
+	},
+	{
+		content: "The Statsig package gets removed at the end. We’ll run build and lint to clean up after ourselves.",
+		pause: 6500
+	},
+	{
+		type: "clear",
+		pause: 2e3
+	},
+	{
+		content: "A few things work a little differently in PostHog.",
+		pause: 4500
+	},
+	{
+		content: /* @__PURE__ */ jsxs(Text, { children: [
+			"Flags evaluate against a stable user. Call",
+			" ",
+			/* @__PURE__ */ jsx(Text, {
+				bold: true,
+				color: Colors.accent,
+				children: "identify()"
+			}),
+			" ",
+			"first, then check the flag."
+		] }),
+		pause: 6e3,
+		persist: true
+	},
+	{
+		content: "For anything in the first paint, evaluate server-side and bootstrap the values into the client.",
+		pause: 6500
+	},
+	{
+		content: /* @__PURE__ */ jsxs(Text, { children: [
+			"In production, route requests through a reverse proxy to avoid ad blockers breaking your flags.",
+			"\n",
+			/* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: "https://posthog.com/docs/advanced/proxy"
+			})
+		] }),
+		pause: 6500,
+		persist: true
+	},
+	{
+		content: "When a flag reaches 100% rollout, retire it. Flags are signals, not switches.",
+		pause: 5500
+	},
+	{
+		content: /* @__PURE__ */ jsxs(Text, { children: [
+			"Name flags descriptively. No double negatives. Reflect the return type.",
+			" ",
+			/* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: "For example "
+			}),
+			/* @__PURE__ */ jsx(Text, {
+				bold: true,
+				children: "show-new-checkout"
+			}),
+			/* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: "."
+			})
+		] }),
+		pause: 6500,
+		persist: true
+	},
+	{
+		type: "clear",
+		pause: 1500
+	},
+	{
+		content: /* @__PURE__ */ jsx(Text, {
+			bold: true,
+			color: Colors.accent,
+			children: "Experiments"
+		}),
+		pause: 2500,
+		persist: true
+	},
+	{
+		content: "Change one thing per variant. Multiple changes in one variant blur the result.",
+		pause: 5500
+	},
+	{
+		content: "Decide the running time up front. PostHog includes a sample-size and duration calculator in the setup flow.",
+		pause: 6500
+	},
+	{
+		content: "Roll out to 5–10% first. Watch the metrics. Then increase.",
+		pause: 5e3
+	},
+	{
+		content: "Exclude users who already completed the flow. They can’t be affected by the test.",
+		pause: 5500
+	},
+	{
+		type: "clear",
+		pause: 1500
+	},
+	{
+		content: "Flags and experiments live alongside the rest of your data.",
+		pause: 4500
+	},
+	{
+		content: "Ship behind a flag, watch replays, check analytics for impact.",
+		pause: 4500
+	},
+	{
+		type: "clear",
+		pause: 1500
+	},
+	{
+		content: "PostHog also provides every other analytics and AI tool to build your product.",
+		pause: 4500
+	},
+	PRODUCT_SUITE_BLOCK,
+	{
+		type: "clear",
+		pause: 1500
+	},
+	{
+		content: "And consolidating onto one platform saves real money.",
+		pause: 4500
+	},
+	{
+		content: "Here’s the math.",
+		pause: 1500
+	},
+	VENDOR_STACK_BLOCK,
+	{
+		type: "clear",
+		pause: 1500
+	},
+	{
+		content: "Pricing is usage-based, with a generous free tier.",
+		pause: 4e3
+	},
+	FREE_TIER_BLOCK,
+	{
+		type: "clear",
+		pause: 1500
+	},
+	PRICING_STRUCTURE_BLOCK,
+	{
+		type: "clear",
+		pause: 1500
+	},
+	{
+		content: "Gain clarity and really understand your users.",
+		pause: 4e3
+	},
+	{
+		content: "Use trends to measure growth.",
+		pause: 2500
+	},
+	LINE_CHART_BLOCK,
+	{
+		type: "clear",
+		pause: 500
+	},
+	{
+		content: "Use funnels to reveal bottlenecks.",
+		pause: 2500
+	},
+	FUNNEL_BLOCK
+];
+//#endregion
+//#region src/lib/programs/migration/index.ts
+const MIGRATION_REPORT_FILE = "migration-report.md";
+const MIGRATION_ABORT_CASES = [{
+	match: /^no source-sdk calls found$/i,
+	message: "No source-SDK calls found",
+	body: "The migration needs an existing third-party SDK to migrate from. No calls to the source SDK appear anywhere in this project. If you haven't installed PostHog yet, you don't need this command — run `npx @posthog/wizard@latest` to add PostHog from scratch."
+}];
+/**
+* Map each `--product=<id>` choice to the context-mill skill ID that handles
+* it. Adding a variant: drop a new row here. The CLI `choices` and the
+* runtime lookup both read from this map, so the two stay in sync.
+*/
+const PRODUCT_TO_SKILL_ID = { statsig: "migrate-statsig" };
+const MIGRATE_PRODUCTS = Object.keys(PRODUCT_TO_SKILL_ID);
+const migrationConfig = {
+	command: "migrate",
+	description: "Migrate to PostHog from another analytics provider",
+	id: "migration",
+	skillId: PRODUCT_TO_SKILL_ID.statsig,
+	steps: MIGRATION_PROGRAM,
+	reportFile: MIGRATION_REPORT_FILE,
+	getContentBlocks,
+	allowedTools: ["Agent"],
+	disallowedTools: [WIZARD_TOOL_NAMES.wizardAsk],
+	cliOptions: { product: {
+		describe: "Source SDK to migrate from",
+		type: "string",
+		choices: MIGRATE_PRODUCTS,
+		demandOption: true
+	} },
+	mapCliOptions: (argv) => ({ skillId: PRODUCT_TO_SKILL_ID[argv.product] }),
+	run: {
+		skillId: PRODUCT_TO_SKILL_ID.statsig,
+		integrationLabel: "migration",
+		customPrompt: () => `Migrate this project from its existing third-party analytics, feature-flag, and observability tools to PostHog. Run the \`migrate\` skill end-to-end: follow the step chain starting at references/1-presence.md. Only replace existing source-SDK call sites with PostHog equivalents — make zero unrelated changes and no net-new instrumentation. The final report is written to ./${MIGRATION_REPORT_FILE}.`,
+		successMessage: `Migration complete! View the report at ./${MIGRATION_REPORT_FILE}`,
+		reportFile: MIGRATION_REPORT_FILE,
+		docsUrl: "",
+		spinnerMessage: "Migrating to PostHog...",
+		estimatedDurationMinutes: 8,
+		abortCases: MIGRATION_ABORT_CASES
+	},
+	requires: ["posthog-integration"]
+};
+//#endregion
+//#region src/lib/programs/mcp/index.ts
+const mcpAddConfig = {
+	id: "mcp-add",
+	description: "Add PostHog MCP server to supported clients",
+	steps: [{
+		id: "mcp-add",
+		label: "Add MCP server",
+		screenId: "mcp-add",
+		isComplete: (s) => s.mcpComplete
+	}]
+};
+const mcpRemoveConfig = {
+	id: "mcp-remove",
+	description: "Remove PostHog MCP server from supported clients",
+	steps: [{
+		id: "mcp-remove",
+		label: "Remove MCP server",
+		screenId: "mcp-remove",
+		isComplete: (s) => s.mcpComplete
+	}]
+};
+//#endregion
+//#region src/lib/programs/program-registry.ts
+const agentSkillConfig = {
+	id: "agent-skill",
+	description: "Run an arbitrary context-mill skill",
+	steps: AGENT_SKILL_STEPS,
+	getContentBlocks: getContentBlocks$1,
+	allowedTools: ["Agent"]
+};
+const PROGRAM_REGISTRY = [
 	posthogIntegrationConfig,
 	revenueAnalyticsConfig,
 	auditConfig,
+	eventsAuditConfig,
 	audit3000Config,
-	{
-		command: "doctor",
-		description: "Diagnose your PostHog project for configuration issues and setup warnings",
-		flowKey: "posthog-doctor",
-		steps: POSTHOG_DOCTOR_WORKFLOW
-	}
+	posthogDoctorConfig,
+	migrationConfig,
+	agentSkillConfig,
+	mcpAddConfig,
+	mcpRemoveConfig
 ];
-/** Look up a workflow config by its flowKey. */
-function getWorkflowConfig(flowKey) {
-	return WORKFLOW_REGISTRY.find((c) => c.flowKey === flowKey);
+/**
+* Typed program names. Values come from each config's `id`, so there's
+* no parallel string list to keep in sync — adding `Program.Foo` here is
+* just exposing `fooConfig.id` under a friendly name for call sites.
+*/
+const Program = {
+	PostHogIntegration: posthogIntegrationConfig.id,
+	RevenueAnalyticsSetup: revenueAnalyticsConfig.id,
+	Migration: migrationConfig.id,
+	Audit: auditConfig.id,
+	EventsAudit: eventsAuditConfig.id,
+	Audit3000: audit3000Config.id,
+	PosthogDoctor: posthogDoctorConfig.id,
+	AgentSkill: agentSkillConfig.id,
+	McpAdd: mcpAddConfig.id,
+	McpRemove: mcpRemoveConfig.id
+};
+/**
+* Look up a program config by its id. `ProgramId` is a union of every
+* registered id, so the lookup is statically guaranteed to find a match
+* — the `!` is a load-bearing assertion of that invariant, not a hope.
+*/
+function getProgramConfig(id) {
+	return PROGRAM_REGISTRY.find((c) => c.id === id);
 }
-/** All workflow configs that are exposed as CLI subcommands. */
-function getSubcommandWorkflows() {
-	return WORKFLOW_REGISTRY.filter((c) => c.command != null);
+/** All program configs that are exposed as CLI subcommands. */
+function getSubcommandPrograms() {
+	return PROGRAM_REGISTRY.filter((c) => c.command != null);
 }
 //#endregion
 //#region bin.ts
 const WIZARD_VERSION = VERSION;
 const NODE_VERSION_RANGE = ">=18.17.0";
 if (!satisfies(process.version, NODE_VERSION_RANGE)) {
-	red(`PostHog wizard requires Node.js ${NODE_VERSION_RANGE}. You are using Node.js ${process.version}. Please upgrade your Node.js version.`);
+	console.log(`PostHog wizard requires Node.js ${NODE_VERSION_RANGE}. You are using Node.js ${process.version}. Please upgrade your Node.js version.`);
 	process.exit(1);
 }
-/** Shared yargs options for skill-based workflow subcommands. */
+/** Shared yargs options for skill-based program subcommands. */
 const skillSubcommandOptions = {
 	debug: {
 		default: false,
@@ -925,12 +1716,24 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 			process.exit(1);
 			return;
 		}
+		if (options.apiKey) {
+			const apiKeyValue = String(options.apiKey);
+			if (!apiKeyValue.startsWith("phx_")) {
+				setUI(new LoggingUI());
+				getUI().intro("PostHog Wizard");
+				const prefix = apiKeyValue.slice(0, 4);
+				let hint = "";
+				if (prefix === "pha_") hint = " (pha_ is an OAuth access token — CI mode expects a personal API key)";
+				else if (prefix === "phc_") hint = " (phc_ is a project/client key — CI mode expects a personal API key)";
+				getUI().log.warn(`--api-key does not start with "phx_"${hint}. Continuing anyway, but the LLM Gateway may reject it with a 401.`);
+			}
+		}
 		(async () => {
 			if (!options.apiKey && options.signup) {
 				setUI(new LoggingUI());
 				getUI().intro("PostHog Wizard");
 				try {
-					const { provisionNewAccount } = await import("./provisioning-BdQ1ONIg.js");
+					const { provisionNewAccount } = await import("./provisioning-ByWo5KcQ.js");
 					const signupRegion = options.region.toUpperCase();
 					getUI().log.info(`Provisioning new PostHog account for ${String(options.email)} in ${signupRegion}...`);
 					const result = await provisionNewAccount(options.email, options.name ?? "", signupRegion);
@@ -952,11 +1755,11 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 					return;
 				}
 			}
-			const { posthogIntegrationConfig } = await import("./posthog-integration-BL21S3T6.js").then((n) => n.r);
-			const { FRAMEWORK_REGISTRY } = await import("./registry-BaMEaAKd.js").then((n) => n.n);
-			const { detectFramework, gatherFrameworkContext } = await import("./detection-CSjmal-X.js").then((n) => n.t);
-			const { analytics } = await import("./analytics-BH7bEHQR.js");
-			const { wizardAbort } = await import("./wizard-abort-Dl0BkqhT.js");
+			const { posthogIntegrationConfig } = await import("./posthog-integration-C-FFV5ny.js").then((n) => n.r);
+			const { FRAMEWORK_REGISTRY } = await import("./registry-B92uyoWK.js").then((n) => n.n);
+			const { detectFramework, gatherFrameworkContext } = await import("./detection-D651Eb5k.js").then((n) => n.t);
+			const { analytics } = await import("./analytics-tslsXyf9.js");
+			const { wizardAbort } = await import("./wizard-abort-BTBccRto.js");
 			runWizardCI(posthogIntegrationConfig, options, async (session) => {
 				const integration = session.integration ?? await detectFramework(session.installDir);
 				if (!integration) {
@@ -989,16 +1792,16 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 		getUI().log.error("This installer requires an interactive terminal (TTY) to run.\nIt appears you are running in a non-interactive environment.\nPlease run the wizard in an interactive terminal.\n\nFor CI/CD environments, use --ci mode:\n  npx @posthog/wizard --ci --region us --api-key phx_xxx");
 		process.exit(1);
 	} else if (options.playground) (async () => {
-		const { startPlayground } = await import("./start-playground-C9GWnVdM.js");
+		const { startPlayground } = await import("./start-playground-BhwBUq-a.js");
 		startPlayground(WIZARD_VERSION);
 	})();
 	else if (options.skill) (async () => {
-		const { createSkillWorkflow } = await Promise.resolve().then(() => agent_skill_exports);
+		const { createSkillProgram } = await Promise.resolve().then(() => agent_skill_exports);
 		const skillId = options.skill;
-		runWizard(createSkillWorkflow({
+		runWizard(createSkillProgram({
 			skillId,
 			command: "skill",
-			flowKey: "agent-skill",
+			id: "agent-skill",
 			description: `Run skill: ${skillId}`,
 			integrationLabel: skillId,
 			successMessage: `${skillId} completed!`,
@@ -1012,7 +1815,7 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 		});
 	})();
 	else (async () => {
-		const { posthogIntegrationConfig } = await import("./posthog-integration-BL21S3T6.js").then((n) => n.r);
+		const { posthogIntegrationConfig } = await import("./posthog-integration-C-FFV5ny.js").then((n) => n.r);
 		runWizard(posthogIntegrationConfig, options);
 	})();
 }).command("mcp <command>", "MCP server management commands", (yargs) => {
@@ -1039,10 +1842,9 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 			const { readApiKeyFromEnv } = await import("./env-api-key-D5G2PrXW.js");
 			const apiKey = options.apiKey || readApiKeyFromEnv();
 			try {
-				const { startTUI } = await import("./start-tui-B_zwutLe.js");
-				const { buildSession } = await import("./wizard-session-BQC9vy9Z.js");
-				const { Flow } = await import("./router-COhhuIW3.js").then((n) => n.n);
-				const tui = startTUI(WIZARD_VERSION, Flow.McpAdd);
+				const { startTUI } = await import("./start-tui-BwQa3kmG.js");
+				const { buildSession } = await import("./wizard-session-CPhhll4P.js");
+				const tui = startTUI(WIZARD_VERSION, Program.McpAdd);
 				const session = buildSession({
 					debug: options.debug,
 					localMcp: options.local,
@@ -1052,7 +1854,7 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 				tui.store.session = session;
 			} catch {
 				setUI(new LoggingUI());
-				const { addMCPServerToClientsStep } = await import("./add-mcp-server-to-clients-CUNR00bB.js").then((n) => n.r);
+				const { addMCPServerToClientsStep } = await import("./add-mcp-server-to-clients-BTW9Ey5Z.js").then((n) => n.r);
 				await addMCPServerToClientsStep({
 					local: options.local,
 					features: mcpFeatures,
@@ -1070,10 +1872,9 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 		const options = { ...argv };
 		(async () => {
 			try {
-				const { startTUI } = await import("./start-tui-B_zwutLe.js");
-				const { buildSession } = await import("./wizard-session-BQC9vy9Z.js");
-				const { Flow } = await import("./router-COhhuIW3.js").then((n) => n.n);
-				const tui = startTUI(WIZARD_VERSION, Flow.McpRemove);
+				const { startTUI } = await import("./start-tui-BwQa3kmG.js");
+				const { buildSession } = await import("./wizard-session-CPhhll4P.js");
+				const tui = startTUI(WIZARD_VERSION, Program.McpRemove);
 				const session = buildSession({
 					debug: options.debug,
 					localMcp: options.local
@@ -1081,7 +1882,7 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 				tui.store.session = session;
 			} catch {
 				setUI(new LoggingUI());
-				const { removeMCPServerFromClientsStep } = await import("./add-mcp-server-to-clients-CUNR00bB.js").then((n) => n.r);
+				const { removeMCPServerFromClientsStep } = await import("./add-mcp-server-to-clients-BTW9Ey5Z.js").then((n) => n.r);
 				await removeMCPServerFromClientsStep({ local: options.local });
 			}
 		})();
@@ -1117,7 +1918,7 @@ cli.command("provision", "Create a new PostHog account (headless, no TUI)", (yar
 	if (!jsonMode) setUI(new LoggingUI());
 	(async () => {
 		try {
-			const { provisionNewAccount } = await import("./provisioning-BdQ1ONIg.js");
+			const { provisionNewAccount } = await import("./provisioning-ByWo5KcQ.js");
 			if (!jsonMode) getUI().log.info(`Provisioning account for ${email} in ${region}...`);
 			const result = await provisionNewAccount(email, name, region);
 			if (jsonMode) process.stdout.write(`${JSON.stringify(result)}\n`);
@@ -1144,14 +1945,21 @@ cli.command("provision", "Create a new PostHog account (headless, no TUI)", (yar
 		}
 	})();
 });
-for (const wfConfig of getSubcommandWorkflows()) cli.command(wfConfig.command, wfConfig.description, (y) => y.options(skillSubcommandOptions), (argv) => {
-	const options = { ...argv };
-	if (options.ci) runWizardCI(wfConfig, options);
-	else runWizard(wfConfig, options);
+for (const programConfig of getSubcommandPrograms()) cli.command(programConfig.command, programConfig.description, (y) => y.options({
+	...skillSubcommandOptions,
+	...programConfig.cliOptions ?? {}
+}), (argv) => {
+	const extras = programConfig.mapCliOptions?.(argv) ?? {};
+	const options = {
+		...argv,
+		...extras
+	};
+	if (options.ci) runWizardCI(programConfig, options);
+	else runWizard(programConfig, options);
 });
 cli.help().alias("help", "h").version().alias("version", "v").wrap(process.stdout.isTTY ? cli.terminalWidth() : 80).argv;
 /**
-* Run a full wizard workflow in the TUI. Handles the full lifecycle: start TUI,
+* Run a full wizard program in the TUI. Handles the full lifecycle: start TUI,
 * build session, run detection, wait for intro gate, execute the
 * agent pipeline, wait for outro dismissal, then exit.
 */
@@ -1159,13 +1967,13 @@ function runWizard(config, options) {
 	(async () => {
 		try {
 			const installDir = options.installDir || process.cwd();
-			const { startTUI } = await import("./start-tui-B_zwutLe.js");
-			const { buildSession } = await import("./wizard-session-BQC9vy9Z.js");
-			const { TaskStreamPush } = await import("./task-stream-CX7Uf6EM.js");
-			const { FileDestination } = await import("./file-8iNrXHkG.js");
-			const { PostHogDestination } = await import("./posthog-vm0k9PKS.js");
-			const { analytics } = await import("./analytics-BH7bEHQR.js");
-			const tui = startTUI(WIZARD_VERSION, config.flowKey);
+			const { startTUI } = await import("./start-tui-BwQa3kmG.js");
+			const { buildSession } = await import("./wizard-session-CPhhll4P.js");
+			const { TaskStreamPush } = await import("./task-stream-DUpUZmFQ.js");
+			const { FileDestination } = await import("./file-BKbKreWF.js");
+			const { PostHogDestination } = await import("./posthog-BbQf_Hzq.js");
+			const { analytics } = await import("./analytics-tslsXyf9.js");
+			const tui = startTUI(WIZARD_VERSION, config.id);
 			const session = buildSession({
 				debug: options.debug,
 				forceInstall: options.forceInstall,
@@ -1181,12 +1989,13 @@ function runWizard(config, options) {
 				benchmark: options.benchmark,
 				yaraReport: options.yaraReport
 			});
-			session.workflowLabel = config.flowKey;
+			session.programLabel = config.id;
 			if (options.skillId) session.skillId = options.skillId;
+			else if (config.skillId) session.skillId = config.skillId;
 			tui.store.session = session;
 			const taskStream = new TaskStreamPush({
 				store: tui.store,
-				workflowId: config.flowKey,
+				programId: config.id,
 				destinations: [new FileDestination(), new PostHogDestination()]
 			});
 			tui.store.onTasksChanged = () => void taskStream.push();
@@ -1195,7 +2004,7 @@ function runWizard(config, options) {
 			await tui.store.getGate("health-check");
 			const skipAgent = config.run == null;
 			if (skipAgent) {
-				const { getOrAskForProjectData } = await import("./setup-utils-CU4FIqjB.js");
+				const { getOrAskForProjectData } = await import("./setup-utils-D5aNKrba.js");
 				const { projectApiKey, host, accessToken, projectId } = await getOrAskForProjectData({
 					signup: session.signup,
 					ci: session.ci,
@@ -1209,7 +2018,7 @@ function runWizard(config, options) {
 					projectId
 				});
 			} else {
-				const { runAgent } = await import("./agent-runner-LvVQH31D.js");
+				const { runAgent } = await import("./agent-runner-Bxi71jnp.js");
 				await runAgent(config, tui.store.session);
 			}
 			const isDone = () => skipAgent ? tui.store.session.outroDismissed : tui.store.session.skillsComplete;
@@ -1241,7 +2050,7 @@ function runWizard(config, options) {
 * CI-mode pipeline shared by every non-interactive entry point.
 *
 * Validates flags, builds a `ci:true` session, runs `preRun` (or the
-* workflow's `onReady` hooks by default), executes `runAgent`, and
+* program's `onReady` hooks by default), executes `runAgent`, and
 * routes any failure through `wizardAbort`. `wizardAbort` owns all
 * exits — never add a raw `process.exit` here.
 */
@@ -1260,11 +2069,11 @@ function runWizardCI(config, options, preRun) {
 	}
 	(async () => {
 		const path = await import("path");
-		const { buildSession } = await import("./wizard-session-BQC9vy9Z.js");
+		const { buildSession } = await import("./wizard-session-CPhhll4P.js");
 		const { readEnvironment } = await Promise.resolve().then(() => environment_exports);
 		const { readApiKeyFromEnv } = await import("./env-api-key-D5G2PrXW.js");
-		const { configureLogFileFromEnvironment, logToFile } = await import("./debug-BdcTB7EF.js");
-		const { wizardAbort, WizardError } = await import("./wizard-abort-Dl0BkqhT.js");
+		const { configureLogFileFromEnvironment, logToFile } = await import("./debug-Du7qXlug.js");
+		const { wizardAbort, WizardError } = await import("./wizard-abort-BTBccRto.js");
 		configureLogFileFromEnvironment();
 		const env = readEnvironment();
 		const apiKey = options.apiKey ?? readApiKeyFromEnv() ?? void 0;
@@ -1285,10 +2094,11 @@ function runWizardCI(config, options, preRun) {
 			yaraReport: options.yaraReport,
 			...env
 		});
-		session.workflowLabel = config.flowKey;
+		session.programLabel = config.id;
+		if (config.skillId) session.skillId = config.skillId;
 		const runDef = typeof config.run === "object" ? config.run : null;
 		getUI().intro("Welcome to the PostHog setup wizard");
-		getUI().log.info(`Running ${config.flowKey} in CI mode`);
+		getUI().log.info(`Running ${config.id} in CI mode`);
 		try {
 			if (preRun) await preRun(session);
 			else {
@@ -1307,13 +2117,13 @@ function runWizardCI(config, options, preRun) {
 				const detectError = session.frameworkContext.detectError;
 				if (detectError) await wizardAbort({
 					message: `Prerequisites not met: ${detectError.kind}\n\nSee ${runDef?.docsUrl ?? "https://posthog.com/docs"}`,
-					error: new WizardError(`${config.flowKey} prerequisites failed`, {
-						integration: config.flowKey,
+					error: new WizardError(`${config.id} prerequisites failed`, {
+						integration: config.id,
 						detect_error_kind: detectError.kind
 					})
 				});
 			}
-			const { runAgent } = await import("./agent-runner-LvVQH31D.js");
+			const { runAgent } = await import("./agent-runner-Bxi71jnp.js");
 			await runAgent(config, session);
 		} catch (error) {
 			const errorMessage = error instanceof Error ? error.message : String(error);
@@ -1331,6 +2141,6 @@ function runWizardCI(config, options, preRun) {
 	});
 }
 //#endregion
-export { AGENT_SKILL_STEPS as a, fetchHealthIssues as i, getWorkflowConfig as n, POSTHOG_SDKS as o, getKindMeta as r, STRIPE_SDKS as s, WORKFLOW_REGISTRY as t };
+export { getKindMeta as a, POSTHOG_SDKS as c, getContentBlocks as i, STRIPE_SDKS as l, Program as n, fetchHealthIssues as o, getProgramConfig as r, getContentBlocks$1 as s, PROGRAM_REGISTRY as t };
 
 //# sourceMappingURL=bin.js.map