@posthog/wizard 2.15.0 → 2.16.1

package/dist/bin.js

@@ -1,39 +1,269 @@
 #!/usr/bin/env node
-import { t as __exportAll } from "./rolldown-runtime-B_-DWIq7.js";
-import { M as POSTHOG_DOCS_URL, W as WIZARD_USER_AGENT, X as VERSION, Y as runtimeEnv, _ as SIGNUP_WIZARD_READINESS_CONFIG, h as LoggingUI, m as setUI, p as getUI, s as logToFile, v as evaluateWizardReadiness, y as getBlockingServiceKeys } from "./debug-DRKLej5r.js";
-import { n as analytics } from "./analytics-Da4QHjMw.js";
-import { a as isUsingTypeScript, f as getCloudUrlFromRegion, m as getUiHostFromHost, u as handleApiError } from "./setup-utils-_P-or31U.js";
-import "./wizard-session-BlgiX-5d.js";
-import { g as AUDIT_REPORT_FILE, h as AUDIT_CHECKS_KEY, m as AUDIT_CHECKS_FILE, t as AgentSignals, u as WIZARD_TOOL_NAMES } from "./agent-interface-yB_27jG8.js";
-import { i as SPINNER_MESSAGE } from "./registry-CofBzIdU.js";
-import { c as HEALTH_CHECK_STEP, o as Colors, r as isClearBlock } from "./TextBlock-B_8bXLLs.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-D-DyEJvz.js";
-import { t as IGNORED_DIRS } from "./file-utils-DnTSiTJw.js";
+import { J as VERSION, M as POSTHOG_DOCS_URL, W as WIZARD_USER_AGENT, X as runtimeEnv, _ as SIGNUP_WIZARD_READINESS_CONFIG, h as LoggingUI, m as setUI, p as getUI, s as logToFile, v as evaluateWizardReadiness, y as getBlockingServiceKeys } from "./debug-ubpO6102.js";
+import { t as analytics } from "./analytics-DUuUurR3.js";
+import { a as isUsingTypeScript, f as getUiHostFromHost, u as getCloudUrlFromRegion } from "./setup-utils-D-uTycLX.js";
+import { s as handleApiError } from "./api-CGJ1iGps.js";
+import "./wizard-session-gsn8Z3bZ.js";
+import { n as isNonInteractiveEnvironment } from "./environment-BAaC5THg.js";
+import { g as AUDIT_REPORT_FILE, h as AUDIT_CHECKS_KEY, m as AUDIT_CHECKS_FILE, t as AgentSignals, u as WIZARD_TOOL_NAMES } from "./agent-interface-B4eUlMso.js";
+import { i as SPINNER_MESSAGE } from "./registry-DKgYqROt.js";
+import { a as PRODUCT_SUITE_BLOCK, i as LINE_CHART_BLOCK, n as posthogIntegrationConfig, o as StatusPeekTrigger, r as FUNNEL_BLOCK } from "./posthog-integration-Bf_vtWI9.js";
+import { c as HEALTH_CHECK_STEP, o as Colors, r as isClearBlock } from "./TextBlock-CdeZog_6.js";
+import { t as IGNORED_DIRS } from "./file-utils-DPmgn9Vm.js";
+import { n as readApiKeyFromEnv } from "./env-api-key-DEl3LJBv.js";
 import { satisfies } from "semver";
 import yargs from "yargs";
 import { hideBin } from "yargs/helpers";
-import readEnvModule from "read-env";
 import fs, { existsSync, readFileSync, readdirSync, statSync } from "fs";
 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,
-	readEnvironment: () => readEnvironment
-});
-const readEnv = typeof readEnvModule === "function" ? readEnvModule : readEnvModule.default;
-function isNonInteractiveEnvironment() {
-	if (!process.stdout.isTTY || !process.stderr.isTTY) return true;
-	return false;
+//#region src/commands/command.ts
+/** Extract the bare command word(s) from a yargs name spec, dropping positionals and aliases' arg syntax. */
+function commandKeys(name) {
+	return (typeof name === "string" ? [name] : name).map((n) => n.trim().split(/\s+/)[0]);
 }
-function readEnvironment() {
-	return readEnv("POSTHOG_WIZARD");
+function toCommandModule(cmd, parentPath) {
+	return {
+		command: cmd.name,
+		describe: cmd.description,
+		builder: (y) => {
+			let next = cmd.options ? y.options(cmd.options) : y;
+			if (cmd.check) next = next.check(cmd.check);
+			for (const [usage, description] of cmd.examples ?? []) next = next.example(usage, description);
+			const ownPath = [...parentPath, commandKeys(cmd.name)[0]];
+			for (const child of cmd.children ?? []) next = next.command(toCommandModule(child, ownPath));
+			if (cmd.children?.length && !cmd.handler) next = next.demandCommand(1);
+			return next;
+		},
+		handler: cmd.handler ?? (() => void 0)
+	};
 }
 //#endregion
+//#region src/wizard.ts
+/**
+* Global yargs options applied to every command. These are read from the
+* `POSTHOG_WIZARD` env prefix as well as flags.
+*/
+const GLOBAL_OPTIONS = {
+	debug: {
+		default: false,
+		describe: "Enable verbose logging\nenv: POSTHOG_WIZARD_DEBUG",
+		type: "boolean"
+	},
+	region: {
+		describe: "PostHog cloud region\nenv: POSTHOG_WIZARD_REGION",
+		choices: ["us", "eu"],
+		type: "string"
+	},
+	signup: {
+		default: false,
+		describe: "Create a new PostHog account during setup\nenv: POSTHOG_WIZARD_SIGNUP",
+		type: "boolean"
+	},
+	"local-mcp": {
+		default: false,
+		describe: "Use local MCP server at http://localhost:8787/mcp\nenv: POSTHOG_WIZARD_LOCAL_MCP",
+		type: "boolean"
+	},
+	telemetry: {
+		default: true,
+		describe: "Send wizard run state to PostHog (pass --no-telemetry to disable)\nenv: POSTHOG_WIZARD_TELEMETRY",
+		type: "boolean"
+	},
+	"api-key": {
+		describe: "PostHog personal API key (phx_xxx) for authentication\nenv: POSTHOG_WIZARD_API_KEY",
+		type: "string"
+	},
+	"project-id": {
+		describe: "PostHog project ID to use (optional; when not set, uses default from API key or OAuth)\nenv: POSTHOG_WIZARD_PROJECT_ID",
+		type: "string"
+	},
+	email: {
+		describe: "Email address for signup (used with --signup)\nenv: POSTHOG_WIZARD_EMAIL",
+		type: "string"
+	}
+};
+var Wizard = class Wizard {
+	cli;
+	constructor() {
+		let cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options(GLOBAL_OPTIONS);
+		this.cli = cli.strictOptions().fail((msg, err, parser) => {
+			const text = msg || err && err.message || "Invalid arguments";
+			process.stderr.write(`\n\x1b[1;91m✖ ${text}\x1b[0m\n\n`);
+			parser.showHelp();
+			process.exit(1);
+		}).help().alias("help", "h").version().alias("version", "v");
+	}
+	/** Start a chain; equivalent to `new Wizard().use(...cmds)`. */
+	static use(...cmds) {
+		return new Wizard().use(...cmds);
+	}
+	/** Register one or more commands with yargs. */
+	use(...cmds) {
+		for (const cmd of cmds) this.cli = this.cli.command(toCommandModule(cmd, []));
+		return this;
+	}
+	/** Parse argv and dispatch to the matching registered command. */
+	init() {
+		{
+			const argvHasCI = process.argv.slice(2).some((a) => a === "--ci" || a === "--no-ci" || a.startsWith("--ci="));
+			const envHasCI = process.env.POSTHOG_WIZARD_CI != null && process.env.POSTHOG_WIZARD_CI !== "";
+			if (argvHasCI || envHasCI) {
+				process.stderr.write(`\n\x1b[1;91m✖ CI mode is not currently supported in published builds.\x1b[0m\n\n`);
+				process.exit(1);
+			}
+		}
+		this.cli.wrap(process.stdout.isTTY ? this.cli.terminalWidth() : 80).argv;
+	}
+};
+//#endregion
+//#region src/commands/provision.ts
+const provisionCommand = {
+	name: "provision",
+	description: "Create a new PostHog account (headless, no TUI)",
+	options: {
+		email: {
+			describe: "Email address for the new account",
+			type: "string",
+			demandOption: true
+		},
+		region: {
+			describe: "Cloud region (us or eu)",
+			choices: ["us", "eu"],
+			default: "us"
+		},
+		name: {
+			describe: "Name for the new account",
+			type: "string",
+			default: ""
+		},
+		json: {
+			describe: "Emit JSON result to stdout (defaults to true when stdout is not a TTY)",
+			type: "boolean"
+		}
+	},
+	examples: [["wizard provision --email matt+test@posthog.com --region us", ""], ["wizard provision --email user@example.com --region eu --json", ""]],
+	handler: runProvision
+};
+function runProvision(argv) {
+	const jsonMode = argv.json === void 0 ? !process.stdout.isTTY : Boolean(argv.json);
+	if (!jsonMode) setUI(new LoggingUI());
+	provision({
+		email: argv.email,
+		region: argv.region.toUpperCase(),
+		name: argv.name ?? "",
+		jsonMode
+	});
+}
+async function provision({ email, region, name, jsonMode }) {
+	try {
+		const { provisionNewAccount } = await import("./provisioning-BlBnlcFd.js");
+		if (!jsonMode) getUI().log.info(`Provisioning account for ${email} in ${region}...`);
+		emitResult(await provisionNewAccount(email, name, region), jsonMode);
+		process.exit(0);
+	} catch (error) {
+		emitError(error, jsonMode);
+		process.exit(1);
+	}
+}
+function emitResult(result, jsonMode) {
+	if (jsonMode) {
+		process.stdout.write(`${JSON.stringify(result)}\n`);
+		return;
+	}
+	getUI().log.success("Account provisioned successfully:");
+	getUI().log.info(`  API Key:       ${result.projectApiKey}`);
+	getUI().log.info(`  Host:          ${result.host}`);
+	getUI().log.info(`  Project ID:    ${result.projectId}`);
+	getUI().log.info(`  Account ID:    ${result.accountId}`);
+	getUI().log.info(`  Access Token:  ${result.accessToken}`);
+	getUI().log.info(`  Refresh Token: ${result.refreshToken}`);
+	if (result.personalApiKey) getUI().log.info(`  Personal API Key: ${result.personalApiKey}`);
+}
+function emitError(error, jsonMode) {
+	const msg = error instanceof Error ? error.message : String(error);
+	const code = msg.includes("already associated") ? "email_exists" : "provisioning_failed";
+	if (jsonMode) {
+		process.stderr.write(`${JSON.stringify({
+			error: msg,
+			code
+		})}\n`);
+		return;
+	}
+	getUI().log.error(`Provisioning failed: ${msg}`);
+}
+//#endregion
+//#region src/commands/basic-integration/index.ts
+const basicIntegrationCommand = {
+	name: ["$0"],
+	description: "Run the PostHog setup wizard",
+	children: [provisionCommand],
+	options: {
+		"install-dir": {
+			describe: "Directory to install PostHog in\nenv: POSTHOG_WIZARD_INSTALL_DIR",
+			type: "string"
+		},
+		playground: {
+			default: false,
+			describe: "Launch the TUI primitives playground",
+			type: "boolean"
+		},
+		benchmark: {
+			default: false,
+			describe: "Run in benchmark mode with per-phase token tracking\nenv: POSTHOG_WIZARD_BENCHMARK",
+			type: "boolean"
+		},
+		"yara-report": {
+			default: false,
+			describe: "Print YARA scanner summary after the agent run\nenv: POSTHOG_WIZARD_YARA_REPORT",
+			type: "boolean",
+			hidden: true
+		},
+		skill: {
+			describe: "Run a specific context-mill skill by ID\nenv: POSTHOG_WIZARD_SKILL",
+			type: "string"
+		},
+		name: {
+			describe: "Name for account creation with --ci --signup\nenv: POSTHOG_WIZARD_NAME",
+			type: "string"
+		}
+	},
+	check: (argv) => {
+		if (argv.playground && (argv.ci || argv.skill)) throw new Error("--playground cannot be combined with --ci or --skill.");
+		if (typeof argv.skill === "string" && argv.skill.trim() === "") throw new Error("--skill needs a skill ID, e.g. --skill=\"foo\"");
+		return true;
+	},
+	handler: (argv) => {
+		(async () => {
+			if (argv.ci && argv.skill) {
+				const { runSkillMode } = await import("./skill-CnOQAZXp.js");
+				return runSkillMode(argv);
+			}
+			if (argv.ci) {
+				const { runCIInstall } = await import("./ci-install-DD7WMmIF.js");
+				return runCIInstall(argv);
+			}
+			if (isNonInteractiveEnvironment()) {
+				const { failNonInteractive } = await import("./non-interactive-l2AKE3jD.js");
+				return failNonInteractive();
+			}
+			if (argv.playground) {
+				const { runPlayground } = await import("./playground-DlE5RNfE.js");
+				return runPlayground();
+			}
+			if (argv.skill) {
+				const { runSkillMode } = await import("./skill-CnOQAZXp.js");
+				return runSkillMode(argv);
+			}
+			const { runInteractive } = await import("./interactive-BaMAq88Q.js");
+			runInteractive(argv);
+		})();
+	}
+};
+//#endregion
 //#region src/lib/programs/revenue-analytics/detect.ts
 const POSTHOG_SDKS$1 = [
 	"posthog-js",
@@ -297,7 +527,6 @@ const AGENT_SKILL_STEPS = [
 ];
 //#endregion
 //#region src/lib/programs/agent-skill/index.ts
-var agent_skill_exports = /* @__PURE__ */ __exportAll({ createSkillProgram: () => createSkillProgram });
 function createSkillProgram(opts) {
 	return {
 		command: opts.command,
@@ -334,7 +563,12 @@ const AUDIT_ABORT_CASES = [{
 }];
 //#endregion
 //#region src/lib/programs/audit/seed.ts
-/** The 10 data-integrity checks the audit runs. */
+/**
+* The 10 data-integrity checks the audit runs, plus one workflow row for the
+* notebook upload at the end (so the skill's `audit_resolve_checks` call for
+* `upload-notebook` succeeds — the skill writes the report to a PostHog
+* notebook as its final step).
+*/
 const AUDIT_SEED_CHECKS = [
 	{
 		id: "sdk-installed",
@@ -395,15 +629,32 @@ const AUDIT_SEED_CHECKS = [
 		area: "Event Capture",
 		label: "Key activation events captured",
 		status: "pending"
+	},
+	{
+		id: "write-report",
+		area: "Write report",
+		label: "Create posthog-audit-report.md",
+		status: "pending"
+	},
+	{
+		id: "upload-notebook",
+		area: "Upload notebook",
+		label: "Write the report into a PostHog notebook",
+		status: "pending"
 	}
 ];
-/** Atomically write the seeded ledger to the project's audit checks file. */
-function seedAuditLedger(installDir) {
+/**
+* Atomically write a seeded ledger to the project's audit checks file.
+*
+* Each audit-flavored program (doctor, events-audit) owns its own seed
+* shape — pass the seed in so this writer stays program-agnostic.
+*/
+function seedAuditLedger(installDir, checks = AUDIT_SEED_CHECKS) {
 	const target = path.join(installDir, AUDIT_CHECKS_FILE);
 	const tmp = `${target}.tmp`;
-	fs.writeFileSync(tmp, JSON.stringify(AUDIT_SEED_CHECKS, null, 2), "utf8");
+	fs.writeFileSync(tmp, JSON.stringify(checks, null, 2), "utf8");
 	fs.renameSync(tmp, target);
-	logToFile(`seedAuditLedger: wrote ${AUDIT_SEED_CHECKS.length} entries to ${target}`);
+	logToFile(`seedAuditLedger: wrote ${checks.length} entries to ${target}`);
 }
 //#endregion
 //#region src/lib/programs/audit/index.ts
@@ -443,7 +694,23 @@ const baseConfig$1 = createSkillProgram({
 const auditRun = async (session) => {
 	seedBeforeAuditRun(session);
 	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 baseRun = typeof baseConfig$1.run === "function" ? await baseConfig$1.run(session) : baseConfig$1.run;
+	return {
+		...baseRun,
+		buildOutroData: (sess, _credentials, cloudRegion) => {
+			const cloudUrl = cloudRegion ? getCloudUrlFromRegion(cloudRegion) : void 0;
+			const continueUrl = sess.signup && cloudUrl ? `${cloudUrl}/products?source=wizard` : void 0;
+			return {
+				kind: "success",
+				message: baseRun.successMessage,
+				reportFile: baseRun.reportFile,
+				docsUrl: baseRun.docsUrl,
+				continueUrl,
+				dashboardUrl: sess.dashboardUrl ?? void 0,
+				notebookUrl: sess.notebookUrl ?? void 0
+			};
+		}
+	};
 };
 const auditConfig = {
 	...baseConfig$1,
@@ -505,6 +772,62 @@ const EVENTS_AUDIT_PROGRAM = [
 	}
 ];
 //#endregion
+//#region src/lib/programs/events-audit/seed.ts
+/**
+* The 7 phases the events-audit skill marches through. One check per area
+* so PendingChecksList renders a clean linear pipeline (area = bold header,
+* single row = the active spinner).
+*
+* Phase ids match what the skill's step files resolve via
+* `mcp__wizard-tools__audit_resolve_checks` as each phase completes. The
+* skill's step 1 also seeds these same ids — keep both in sync so the
+* wizard pre-seed and the skill's MCP seed agree.
+*/
+const EVENTS_AUDIT_SEED_CHECKS = [
+	{
+		id: "detect-sdk",
+		area: "Detect SDK",
+		label: "Identify PostHog SDK(s) in dependencies",
+		status: "pending"
+	},
+	{
+		id: "scan-sites",
+		area: "Scan capture sites",
+		label: "Grep capture/identify/group call sites",
+		status: "pending"
+	},
+	{
+		id: "enrich-sites",
+		area: "Enrich",
+		label: "Subagent fan-out to read capture files",
+		status: "pending"
+	},
+	{
+		id: "query-volume",
+		area: "Query PostHog",
+		label: "30-day volume + last_seen via MCP",
+		status: "pending"
+	},
+	{
+		id: "write-report",
+		area: "Write report",
+		label: "Create posthog-events-audit-report.md",
+		status: "pending"
+	},
+	{
+		id: "create-dashboard",
+		area: "Create dashboard",
+		label: "Optional: dashboard for resolved events",
+		status: "pending"
+	},
+	{
+		id: "upload-notebook",
+		area: "Upload notebook",
+		label: "Write the report into a PostHog notebook",
+		status: "pending"
+	}
+];
+//#endregion
 //#region src/lib/programs/events-audit/index.ts
 const SETUP_REPORT_FILE = "posthog-events-audit-report.md";
 const DOCS_URL$1 = "https://posthog.com/docs/product-analytics/best-practices";
@@ -520,8 +843,8 @@ const eventsAuditConfig = {
 	run: (session) => {
 		const typeScriptDetected = isUsingTypeScript({ installDir: session.installDir });
 		session.typescript = typeScriptDetected;
-		seedAuditLedger(session.installDir);
-		session.frameworkContext[AUDIT_CHECKS_KEY] = AUDIT_SEED_CHECKS;
+		seedAuditLedger(session.installDir, EVENTS_AUDIT_SEED_CHECKS);
+		session.frameworkContext[AUDIT_CHECKS_KEY] = EVENTS_AUDIT_SEED_CHECKS;
 		return Promise.resolve({
 			skillId: "events-audit",
 			integrationLabel: "events-audit",
@@ -549,7 +872,8 @@ Project context:
 					changes: [],
 					docsUrl: DOCS_URL$1,
 					continueUrl: sess.signup && cloudUrl ? `${cloudUrl}/products?source=wizard` : void 0,
-					dashboardUrl: sess.dashboardUrl ?? (cloudUrl ? `${cloudUrl}/dashboard` : void 0)
+					dashboardUrl: sess.dashboardUrl ?? (cloudUrl ? `${cloudUrl}/dashboard` : void 0),
+					notebookUrl: sess.notebookUrl ?? void 0
 				};
 			}
 		});
@@ -1873,15 +2197,23 @@ const withPace = (block) => {
 };
 /** Apply the dwell multiplier to every block in a deck. */
 const pace = (blocks) => blocks.map(withPace);
-/** A minified production stack trace — the problem source maps solve. */
+/**
+* A minified production stack trace — the problem source maps solve. Framed as
+* a labelled, muted example (no error-red ✘) so a glance reads it as
+* illustrative content, not as the wizard itself having errored mid-run.
+*/
 const MINIFIED_TRACE = {
 	type: "lines",
 	interval: 400,
 	pause: 7e3,
 	lines: [
 		/* @__PURE__ */ jsx(Text, {
-			color: Colors.error,
-			children: "✘ TypeError: cart is undefined"
+			dimColor: true,
+			children: "example — minified production trace"
+		}),
+		/* @__PURE__ */ jsx(Text, {
+			color: Colors.muted,
+			children: "  TypeError: cart is undefined"
 		}),
 		/* @__PURE__ */ jsx(Text, {
 			dimColor: true,
@@ -1903,9 +2235,13 @@ const RESOLVED_TRACE = {
 	interval: 400,
 	pause: 8e3,
 	lines: [
+		/* @__PURE__ */ jsx(Text, {
+			dimColor: true,
+			children: "example — resolved with source maps"
+		}),
 		/* @__PURE__ */ jsx(Text, {
 			color: Colors.success,
-			children: "✔ TypeError: cart is undefined"
+			children: "  ✔ TypeError: cart is undefined"
 		}),
 		/* @__PURE__ */ jsxs(Text, { children: [
 			/* @__PURE__ */ jsx(Text, {
@@ -2164,7 +2500,7 @@ const getContentBlocks = (store) => pace([
 const REPORT_FILE = "posthog-source-maps-report.md";
 const DOCS_URL = "https://posthog.com/docs/error-tracking/upload-source-maps";
 const errorTrackingUploadSourceMapsConfig = {
-	command: "upload-sourcemaps",
+	command: "upload-source-maps",
 	description: "Upload source maps to PostHog Error Tracking",
 	id: "error-tracking-upload-source-maps",
 	steps: ERROR_TRACKING_UPLOAD_SOURCE_MAPS_PROGRAM,
@@ -2221,8 +2557,28 @@ const mcpAddConfig = {
 		label: "Add MCP server",
 		screenId: "mcp-add",
 		isComplete: (s) => s.mcpComplete
+	}, {
+		id: "mcp-suggested-prompts",
+		label: "Suggested prompts",
+		screenId: "mcp-suggested-prompts",
+		show: (s) => s.mcpOutcome === "installed",
+		isComplete: (s) => s.mcpSuggestedPromptsDismissed
 	}]
 };
+/**
+* `wizard mcp remove` — single-step uninstall flow.
+*
+* DO NOT append `mcp-suggested-prompts` (or any other tutorial-shaped
+* step) here. A user who just removed MCP is opting OUT of the agent
+* having access to PostHog; immediately pivoting into a tutorial that
+* asks them to log in and try prompts is wrong on intent and confusing
+* on UX. The screen also reads `session.mcpInstalledClients` for its
+* Choose-phase copy ("MCP is installed for X") — that array is empty
+* post-remove, so the copy would be a lie.
+*
+* If you want a "did you mean to keep it?" confirmation, build that as
+* a screen earlier in this program — don't reuse the tutorial.
+*/
 const mcpRemoveConfig = {
 	id: "mcp-remove",
 	description: "Remove PostHog MCP server from supported clients",
@@ -2233,6 +2589,26 @@ const mcpRemoveConfig = {
 		isComplete: (s) => s.mcpComplete
 	}]
 };
+/**
+* Standalone tutorial flow — boots directly into the Choose phase of
+* McpSuggestedPromptsScreen without going through MCP install first.
+* Useful for users who already installed MCP and want to revisit the
+* tutorial, or anyone who just wants to try the agent against PostHog
+* without touching their IDE config.
+*
+* The screen handles its own OAuth (via services.performLogin) so this
+* program doesn't pre-populate credentials.
+*/
+const mcpTutorialConfig = {
+	id: "mcp-tutorial",
+	description: "Try the PostHog MCP with your agent — no install needed",
+	steps: [{
+		id: "mcp-suggested-prompts",
+		label: "MCP tutorial",
+		screenId: "mcp-suggested-prompts",
+		isComplete: (s) => s.mcpSuggestedPromptsDismissed
+	}]
+};
 //#endregion
 //#region src/lib/programs/program-registry.ts
 const agentSkillConfig = {
@@ -2253,7 +2629,8 @@ const PROGRAM_REGISTRY = [
 	migrationConfig,
 	agentSkillConfig,
 	mcpAddConfig,
-	mcpRemoveConfig
+	mcpRemoveConfig,
+	mcpTutorialConfig
 ];
 /**
 * Typed program names. Values come from each config's `id`, so there's
@@ -2271,7 +2648,8 @@ const Program = {
 	PosthogDoctor: posthogDoctorConfig.id,
 	AgentSkill: agentSkillConfig.id,
 	McpAdd: mcpAddConfig.id,
-	McpRemove: mcpRemoveConfig.id
+	McpRemove: mcpRemoveConfig.id,
+	McpTutorial: mcpTutorialConfig.id
 };
 /**
 * Look up a program config by its id. `ProgramId` is a union of every
@@ -2281,432 +2659,150 @@ const Program = {
 function getProgramConfig(id) {
 	return PROGRAM_REGISTRY.find((c) => c.id === id);
 }
-/** All program configs that are exposed as CLI subcommands. */
-function getSubcommandPrograms() {
-	return PROGRAM_REGISTRY.filter((c) => c.command != null);
-}
 //#endregion
-//#region bin.ts
-const MIN_NODE_VERSION = ">=18.17.0";
-if (!satisfies(process.version, MIN_NODE_VERSION)) {
-	console.log(`PostHog wizard needs Node.js ${MIN_NODE_VERSION}. Detected ${process.version} — please upgrade Node and re-run.`);
-	process.exit(1);
-}
-const WIZARD_VERSION = VERSION;
-/** Shared yargs options for skill-based program subcommands. */
-const skillSubcommandOptions = {
-	debug: {
-		default: false,
-		describe: "Enable verbose logging",
-		type: "boolean"
-	},
-	"install-dir": {
-		describe: "Directory to install in",
-		type: "string"
-	},
-	"local-mcp": {
-		default: false,
-		describe: "Use local MCP server",
-		type: "boolean"
-	},
-	benchmark: {
-		default: false,
-		describe: "Run in benchmark mode",
-		type: "boolean"
-	},
-	"yara-report": {
-		default: false,
-		describe: "Print YARA scanner summary",
-		type: "boolean",
-		hidden: true
-	}
-};
-const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
-	debug: {
-		default: false,
-		describe: "Enable verbose logging\nenv: POSTHOG_WIZARD_DEBUG",
-		type: "boolean"
-	},
-	region: {
-		describe: "PostHog cloud region\nenv: POSTHOG_WIZARD_REGION",
-		choices: ["us", "eu"],
-		type: "string"
-	},
-	default: {
-		default: true,
-		describe: "Use default options for all prompts\nenv: POSTHOG_WIZARD_DEFAULT",
-		type: "boolean"
-	},
-	signup: {
-		default: false,
-		describe: "Create a new PostHog account during setup\nenv: POSTHOG_WIZARD_SIGNUP",
-		type: "boolean"
-	},
-	"local-mcp": {
-		default: false,
-		describe: "Use local MCP server at http://localhost:8787/mcp\nenv: POSTHOG_WIZARD_LOCAL_MCP",
-		type: "boolean"
-	},
-	"api-key": {
-		describe: "PostHog personal API key (phx_xxx) for authentication\nenv: POSTHOG_WIZARD_API_KEY",
-		type: "string"
-	},
-	"project-id": {
-		describe: "PostHog project ID to use (optional; when not set, uses default from API key or OAuth)\nenv: POSTHOG_WIZARD_PROJECT_ID",
-		type: "string"
-	},
-	email: {
-		describe: "Email address for signup (used with --signup)\nenv: POSTHOG_WIZARD_EMAIL",
-		type: "string"
-	},
-	telemetry: {
-		default: true,
-		describe: "Send wizard run state to PostHog (pass --no-telemetry to disable)\nenv: POSTHOG_WIZARD_TELEMETRY",
-		type: "boolean"
-	}
-}).command(["$0"], "Run the PostHog setup wizard", (yargs) => {
-	return yargs.options({
-		"force-install": {
+//#region src/commands/mcp/add.ts
+const mcpAddCommand = {
+	name: "add",
+	description: "Install PostHog MCP server to supported clients",
+	options: {
+		local: {
 			default: false,
-			describe: "Force install packages even if peer dependency checks fail\nenv: POSTHOG_WIZARD_FORCE_INSTALL",
+			describe: "Add local development MCP server (http://localhost:8787)",
 			type: "boolean"
 		},
-		"install-dir": {
-			describe: "Directory to install PostHog in\nenv: POSTHOG_WIZARD_INSTALL_DIR",
+		features: {
+			describe: "Comma-separated list of features to enable (default: all)",
 			type: "string"
 		},
-		playground: {
-			default: false,
-			describe: "Launch the TUI primitives playground",
-			type: "boolean"
-		},
-		integration: {
-			describe: "Integration to set up",
-			choices: [
-				"nextjs",
-				"astro",
-				"react",
-				"svelte",
-				"react-native",
-				"tanstack-router",
-				"tanstack-start"
-			],
+		"api-key": {
+			describe: "PostHog personal API key (phx_xxx) for MCP authentication",
 			type: "string"
-		},
-		menu: {
-			default: false,
-			describe: "Show menu for manual integration selection instead of auto-detecting\nenv: POSTHOG_WIZARD_MENU",
-			type: "boolean"
-		},
-		benchmark: {
-			default: false,
-			describe: "Run in benchmark mode with per-phase token tracking\nenv: POSTHOG_WIZARD_BENCHMARK",
-			type: "boolean"
-		},
-		"yara-report": {
-			default: false,
-			describe: "Print YARA scanner summary after the agent run\nenv: POSTHOG_WIZARD_YARA_REPORT",
-			type: "boolean",
-			hidden: true
-		},
-		skill: {
-			describe: "Run a specific context-mill skill by ID\nenv: POSTHOG_WIZARD_SKILL",
-			type: "string"
-		},
-		name: {
-			describe: "Name for account creation with --ci --signup\nenv: POSTHOG_WIZARD_NAME",
-			type: "string"
-		}
-	});
-}, (argv) => {
-	const options = { ...argv };
-	if (options.ci) {
-		if (!options.region) options.region = "us";
-		if (!options.installDir) {
-			setUI(new LoggingUI());
-			getUI().intro("PostHog Wizard");
-			getUI().log.error("CI mode requires --install-dir (directory to install in)");
-			process.exit(1);
-			return;
 		}
-		if (!options.apiKey && !options.signup) {
+	},
+	handler: runMcpAdd
+};
+function runMcpAdd(argv) {
+	const features = parseFeatures(argv.features);
+	(async () => {
+		const { readApiKeyFromEnv } = await import("./env-api-key-DEl3LJBv.js").then((n) => n.t);
+		const apiKey = argv.apiKey || readApiKeyFromEnv();
+		const debug = argv.debug;
+		const localMcp = argv.local;
+		try {
+			const { startTUI } = await import("./start-tui-DXrv6cof.js");
+			const { buildSession } = await import("./wizard-session-7tMjgOvP.js");
+			const tui = startTUI(VERSION, Program.McpAdd);
+			tui.store.session = buildSession({
+				debug,
+				localMcp,
+				mcpFeatures: features,
+				apiKey
+			});
+		} catch (error) {
+			if (!isTUIUnavailable(error)) throw error;
 			setUI(new LoggingUI());
-			getUI().intro("PostHog Wizard");
-			getUI().log.error("CI mode requires --api-key (personal API key phx_xxx). To create a new account instead, use --signup --email you@example.com.");
-			process.exit(1);
-			return;
+			const { addMCPServerToClientsStep } = await import("./add-mcp-server-to-clients-BS6Rjcwh.js").then((n) => n.r);
+			await addMCPServerToClientsStep({
+				local: localMcp,
+				features,
+				apiKey
+			});
 		}
-		if (!options.apiKey && options.signup && !options.email) {
+	})();
+}
+/**
+* Ink throws "Raw mode is not supported" when stdin has no TTY (piped input,
+* CI, some IDE terminals). That is the only TUI failure we degrade to
+* LoggingUI for — any other error from the TUI path is a real bug and must
+* surface rather than be silently swallowed.
+*/
+function isTUIUnavailable(error) {
+	return error instanceof Error && /raw mode is not supported/i.test(error.message);
+}
+function parseFeatures(raw) {
+	if (typeof raw !== "string") return void 0;
+	return raw.split(",").map((s) => s.trim()).filter(Boolean);
+}
+//#endregion
+//#region src/commands/mcp/remove.ts
+const mcpRemoveCommand = {
+	name: "remove",
+	description: "Remove PostHog MCP server from supported clients",
+	options: { local: {
+		default: false,
+		describe: "Remove local development MCP server (http://localhost:8787)",
+		type: "boolean"
+	} },
+	handler: runMcpRemove
+};
+function runMcpRemove(argv) {
+	(async () => {
+		const debug = argv.debug;
+		const localMcp = argv.local;
+		try {
+			const { startTUI } = await import("./start-tui-DXrv6cof.js");
+			const { buildSession } = await import("./wizard-session-7tMjgOvP.js");
+			const tui = startTUI(VERSION, Program.McpRemove);
+			tui.store.session = buildSession({
+				debug,
+				localMcp
+			});
+		} catch {
 			setUI(new LoggingUI());
-			getUI().intro("PostHog Wizard");
-			getUI().log.error("CI --signup requires --email to create a new account.");
-			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.`);
-			}
+			const { removeMCPServerFromClientsStep } = await import("./add-mcp-server-to-clients-BS6Rjcwh.js").then((n) => n.r);
+			await removeMCPServerFromClientsStep({ local: localMcp });
 		}
-		(async () => {
-			if (!options.apiKey && options.signup) {
-				setUI(new LoggingUI());
-				getUI().intro("PostHog Wizard");
-				try {
-					const { provisionNewAccount } = await import("./provisioning-COeHnCVG.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);
-					if (!result.personalApiKey) {
-						getUI().log.error("Provisioning succeeded but no personal API key was returned — cannot continue install.");
-						process.exit(1);
-						return;
-					}
-					getUI().log.success("Account ready.");
-					getUI().log.info(`  Project API Key:  ${result.projectApiKey}`);
-					getUI().log.info(`  Personal API Key: ${result.personalApiKey}`);
-					getUI().log.info(`  Host:             ${result.host}`);
-					options.apiKey = result.personalApiKey;
-					if (options.projectId == null) options.projectId = result.projectId;
-				} catch (error) {
-					const msg = error instanceof Error ? error.message : String(error);
-					getUI().log.error(`Provisioning failed: ${msg}`);
-					process.exit(1);
-					return;
-				}
-			}
-			const { posthogIntegrationConfig } = await import("./posthog-integration-D-DyEJvz.js").then((n) => n.r);
-			const { FRAMEWORK_REGISTRY } = await import("./registry-CofBzIdU.js").then((n) => n.n);
-			const { detectFramework, gatherFrameworkContext } = await import("./detection-0Pz2NncX.js").then((n) => n.t);
-			const { analytics } = await import("./analytics-BnR9904x.js");
-			const { wizardAbort } = await import("./wizard-abort-CuaS1eXn.js");
-			runWizardCI(posthogIntegrationConfig, options, async (session) => {
-				const integration = session.integration ?? await detectFramework(session.installDir);
-				if (!integration) {
-					await wizardAbort({ message: "Could not auto-detect your framework. Please specify --integration on the command line." });
-					return;
-				}
-				session.integration = integration;
-				analytics.setTag("integration", integration);
-				const frameworkConfig = FRAMEWORK_REGISTRY[integration];
-				session.frameworkConfig = frameworkConfig;
-				const context = await gatherFrameworkContext(frameworkConfig, {
-					installDir: session.installDir,
-					debug: session.debug,
-					forceInstall: session.forceInstall,
-					default: false,
-					signup: session.signup,
-					localMcp: session.localMcp,
-					ci: true,
-					menu: session.menu,
-					benchmark: session.benchmark,
-					yaraReport: session.yaraReport
-				});
-				for (const [key, value] of Object.entries(context)) if (!(key in session.frameworkContext)) session.frameworkContext[key] = value;
-			});
-		})().catch(() => {
-			process.exit(1);
-		});
-	} else if (isNonInteractiveEnvironment()) {
-		getUI().intro(`PostHog Wizard`);
-		getUI().log.error("This installer requires an interactive terminal (TTY) to run.\nIt appears you are running in a non-interactive environment.\n\nNon-interactive (CI) mode is not supported in published builds.\n");
-		process.exit(1);
-	} else if (options.playground) (async () => {
-		const { startPlayground } = await import("./start-playground-Bxd2KG2L.js");
-		startPlayground(WIZARD_VERSION);
-	})();
-	else if (options.skill) (async () => {
-		const { createSkillProgram } = await Promise.resolve().then(() => agent_skill_exports);
-		const skillId = options.skill;
-		runWizard(createSkillProgram({
-			skillId,
-			command: "skill",
-			id: "agent-skill",
-			description: `Run skill: ${skillId}`,
-			integrationLabel: skillId,
-			successMessage: `${skillId} completed!`,
-			reportFile: `posthog-${skillId}-report.md`,
-			docsUrl: POSTHOG_DOCS_URL,
-			spinnerMessage: `Running ${skillId}...`,
-			estimatedDurationMinutes: 5
-		}), {
-			...options,
-			skillId
-		});
-	})();
-	else (async () => {
-		const { posthogIntegrationConfig } = await import("./posthog-integration-D-DyEJvz.js").then((n) => n.r);
-		runWizard(posthogIntegrationConfig, options);
 	})();
-}).command("mcp <command>", "MCP server management commands", (yargs) => {
-	return yargs.command("add", "Install PostHog MCP server to supported clients", (yargs) => {
-		return yargs.options({
-			local: {
-				default: false,
-				describe: "Add local development MCP server (http://localhost:8787)",
-				type: "boolean"
-			},
-			features: {
-				describe: "Comma-separated list of features to enable (default: all)",
-				type: "string"
-			},
-			"api-key": {
-				describe: "PostHog personal API key (phx_xxx) for MCP authentication",
-				type: "string"
-			}
-		});
-	}, (argv) => {
-		const options = { ...argv };
-		const mcpFeatures = options.features?.split(",").map((s) => s.trim()).filter(Boolean);
-		(async () => {
-			const { readApiKeyFromEnv } = await import("./env-api-key-HFqv1l-z.js");
-			const apiKey = options.apiKey || readApiKeyFromEnv();
-			try {
-				const { startTUI } = await import("./start-tui-Bl8fCbp_.js");
-				const { buildSession } = await import("./wizard-session-DxU5ZMBN.js");
-				const tui = startTUI(WIZARD_VERSION, Program.McpAdd);
-				const session = buildSession({
-					debug: options.debug,
-					localMcp: options.local,
-					mcpFeatures,
-					apiKey
-				});
-				tui.store.session = session;
-			} catch {
-				setUI(new LoggingUI());
-				const { addMCPServerToClientsStep } = await import("./add-mcp-server-to-clients-Dq0n2yzq.js").then((n) => n.r);
-				await addMCPServerToClientsStep({
-					local: options.local,
-					features: mcpFeatures,
-					apiKey
-				});
-			}
-		})();
-	}).command("remove", "Remove PostHog MCP server from supported clients", (yargs) => {
-		return yargs.options({ local: {
-			default: false,
-			describe: "Remove local development MCP server (http://localhost:8787)",
-			type: "boolean"
-		} });
-	}, (argv) => {
-		const options = { ...argv };
-		(async () => {
-			try {
-				const { startTUI } = await import("./start-tui-Bl8fCbp_.js");
-				const { buildSession } = await import("./wizard-session-DxU5ZMBN.js");
-				const tui = startTUI(WIZARD_VERSION, Program.McpRemove);
-				const session = buildSession({
-					debug: options.debug,
-					localMcp: options.local
-				});
-				tui.store.session = session;
-			} catch {
-				setUI(new LoggingUI());
-				const { removeMCPServerFromClientsStep } = await import("./add-mcp-server-to-clients-Dq0n2yzq.js").then((n) => n.r);
-				await removeMCPServerFromClientsStep({ local: options.local });
-			}
-		})();
-	}).demandCommand(1, "You must specify a subcommand (add or remove)").help();
-});
-cli.command("provision", "Create a new PostHog account (headless, no TUI)", (yargs) => {
-	return yargs.options({
-		email: {
-			describe: "Email address for the new account",
-			type: "string",
-			demandOption: true
-		},
-		region: {
-			describe: "Cloud region (us or eu)",
-			choices: ["us", "eu"],
-			default: "us"
-		},
-		name: {
-			describe: "Name for the new account",
-			type: "string",
-			default: ""
-		},
-		json: {
-			describe: "Emit JSON result to stdout (defaults to true when stdout is not a TTY)",
-			type: "boolean"
-		}
-	}).example("wizard provision --email matt+test@posthog.com --region us", "").example("wizard provision --email user@example.com --region eu --json", "");
-}, (argv) => {
-	const email = argv.email;
-	const region = argv.region.toUpperCase();
-	const name = argv.name ?? "";
-	const jsonMode = argv.json === void 0 ? !process.stdout.isTTY : argv.json;
-	if (!jsonMode) setUI(new LoggingUI());
+}
+//#endregion
+//#region src/commands/mcp/tutorial.ts
+const mcpTutorialCommand = {
+	name: "tutorial",
+	description: "Try the PostHog MCP with your agent (no install needed)",
+	options: { local: {
+		default: false,
+		describe: "Point the tutorial at the local MCP server (http://localhost:8787)",
+		type: "boolean"
+	} },
+	handler: runMcpTutorial
+};
+function runMcpTutorial(argv) {
 	(async () => {
+		const debug = argv.debug;
+		const localMcp = argv.local;
 		try {
-			const { provisionNewAccount } = await import("./provisioning-COeHnCVG.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`);
-			else {
-				getUI().log.success("Account provisioned successfully:");
-				getUI().log.info(`  API Key:       ${result.projectApiKey}`);
-				getUI().log.info(`  Host:          ${result.host}`);
-				getUI().log.info(`  Project ID:    ${result.projectId}`);
-				getUI().log.info(`  Account ID:    ${result.accountId}`);
-				getUI().log.info(`  Access Token:  ${result.accessToken}`);
-				getUI().log.info(`  Refresh Token: ${result.refreshToken}`);
-				if (result.personalApiKey) getUI().log.info(`  Personal API Key: ${result.personalApiKey}`);
-			}
-			process.exit(0);
-		} catch (error) {
-			const msg = error instanceof Error ? error.message : String(error);
-			const code = msg.includes("already associated") ? "email_exists" : "provisioning_failed";
-			if (jsonMode) process.stderr.write(`${JSON.stringify({
-				error: msg,
-				code
-			})}\n`);
-			else getUI().log.error(`Provisioning failed: ${msg}`);
+			const { startTUI } = await import("./start-tui-DXrv6cof.js");
+			const { buildSession } = await import("./wizard-session-7tMjgOvP.js");
+			const tui = startTUI(VERSION, Program.McpTutorial);
+			tui.store.session = buildSession({
+				debug,
+				localMcp
+			});
+		} catch (err) {
+			setUI(new LoggingUI());
+			getUI().log.error(`The MCP tutorial requires an interactive terminal. ${err instanceof Error ? err.message : String(err)}`);
 			process.exit(1);
 		}
 	})();
-});
-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.strictOptions().fail((msg, err) => {
-	throw err || new Error(msg);
-}).help().alias("help", "h").version().alias("version", "v").wrap(process.stdout.isTTY ? cli.terminalWidth() : 80);
-{
-	const argvHasCI = process.argv.slice(2).some((a) => a === "--ci" || a === "--no-ci" || a.startsWith("--ci="));
-	const envHasCI = process.env.POSTHOG_WIZARD_CI != null && process.env.POSTHOG_WIZARD_CI !== "";
-	if (argvHasCI || envHasCI) exitWithProductionCIError();
-}
-try {
-	cli.parse();
-} catch (err) {
-	const RED = "\x1B[31m";
-	const BOLD = "\x1B[1m";
-	const RESET = "\x1B[0m";
-	const message = err instanceof Error ? err.message : String(err);
-	process.stderr.write(`${RED}${BOLD}✖ ${message}${RESET}\n`);
-	process.stderr.write("Run with --help to see available options.\n");
-	process.exit(1);
-}
-function exitWithProductionCIError() {
-	process.stderr.write(`✖ CI mode is not currently supported in published builds.\n`);
-	process.exit(1);
 }
+//#endregion
+//#region src/commands/mcp/index.ts
+const mcpCommand = {
+	name: "mcp",
+	description: "MCP server management commands",
+	children: [
+		mcpAddCommand,
+		mcpRemoveCommand,
+		mcpTutorialCommand
+	]
+};
+//#endregion
+//#region src/lib/runners/resolve-no-telemetry.ts
+/**
+* `--no-telemetry` flips `telemetry: false` via yargs negation;
+* `POSTHOG_WIZARD_NO_TELEMETRY` is honoured separately so the env-var
+* form documented in the README keeps working.
+*/
 function resolveNoTelemetry(options) {
 	if (options.telemetry === false) return true;
 	const env = process.env.POSTHOG_WIZARD_NO_TELEMETRY;
@@ -2714,6 +2810,9 @@ function resolveNoTelemetry(options) {
 	const norm = env.toLowerCase();
 	return norm !== "0" && norm !== "false";
 }
+//#endregion
+//#region src/lib/runners/run-wizard.ts
+const WIZARD_VERSION = VERSION;
 /**
 * Run a full wizard program in the TUI. Handles the full lifecycle: start TUI,
 * build session, run detection, wait for intro gate, execute the
@@ -2727,16 +2826,15 @@ function runWizard(config, options) {
 	(async () => {
 		try {
 			const installDir = options.installDir || process.cwd();
-			const { startTUI } = await import("./start-tui-Bl8fCbp_.js");
-			const { buildSession, RunPhase } = await import("./wizard-session-DxU5ZMBN.js");
-			const { TaskStreamPush } = await import("./task-stream-z6QFZtpC.js");
-			const { PostHogDestination } = await import("./posthog-B1G0raJU.js");
-			const { logToFile } = await import("./debug-D5kt4fxB.js");
+			const { startTUI } = await import("./start-tui-DXrv6cof.js");
+			const { buildSession, RunPhase } = await import("./wizard-session-7tMjgOvP.js");
+			const { TaskStreamPush } = await import("./task-stream-CF6QMVMv.js");
+			const { PostHogDestination } = await import("./posthog-DWL8uOcl.js");
+			const { logToFile } = await import("./debug-Cd0hPlZy.js");
 			tui = startTUI(WIZARD_VERSION, config.id);
 			const activeTui = tui;
 			const session = buildSession({
 				debug: options.debug,
-				forceInstall: options.forceInstall,
 				localMcp: options.localMcp,
 				installDir,
 				ci: false,
@@ -2744,8 +2842,6 @@ function runWizard(config, options) {
 				apiKey: options.apiKey,
 				projectId: options.projectId,
 				email: options.email,
-				menu: options.menu,
-				integration: options.integration,
 				benchmark: options.benchmark,
 				yaraReport: options.yaraReport,
 				noTelemetry: resolveNoTelemetry(options)
@@ -2785,7 +2881,7 @@ function runWizard(config, options) {
 			await activeTui.store.getGate("health-check");
 			const skipAgent = config.run == null;
 			if (skipAgent) {
-				const { getOrAskForProjectData } = await import("./setup-utils-C5iSJ3eg.js");
+				const { getOrAskForProjectData } = await import("./setup-utils-BHZEdkNZ.js");
 				const { projectApiKey, host, accessToken, projectId } = await getOrAskForProjectData({
 					signup: session.signup,
 					ci: session.ci,
@@ -2799,7 +2895,7 @@ function runWizard(config, options) {
 					projectId
 				});
 			} else {
-				const { runAgent } = await import("./agent-runner-C9sSudE0.js");
+				const { runAgent } = await import("./agent-runner-BxqiKVEf.js");
 				await runAgent(config, activeTui.store.session);
 			}
 			const isDone = () => skipAgent ? activeTui.store.session.outroDismissed : activeTui.store.session.skillsComplete;
@@ -2838,16 +2934,14 @@ function runWizard(config, options) {
 		}
 	})();
 }
+//#endregion
+//#region src/lib/runners/run-wizard-ci.ts
 /**
-* CI-mode pipeline shared by every non-interactive entry point.
-*
-* Validates flags, builds a `ci:true` session, runs `preRun` (or the
-* 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.
+* The single CI validation layer: defaults region and requires api-key and
+* install-dir. Every CI entry point routes through `runWizardCI`, so this is
+* the one place these checks live. UI must be initialized before calling.
 */
-function runWizardCI(config, options, preRun) {
-	setUI(new LoggingUI());
+function validateCiOptions(options) {
 	if (!options.region) options.region = "us";
 	if (!options.apiKey) {
 		getUI().intro("PostHog Wizard");
@@ -2859,28 +2953,37 @@ function runWizardCI(config, options, preRun) {
 		getUI().log.error("CI mode requires --install-dir (directory to install in)");
 		process.exit(1);
 	}
+}
+/**
+* CI-mode pipeline shared by every non-interactive entry point.
+*
+* Validates flags, builds a `ci:true` session, runs `config.ciPreRun` (or the
+* 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.
+*/
+function runWizardCI(config, options) {
+	setUI(new LoggingUI());
+	validateCiOptions(options);
 	(async () => {
 		const path = await import("path");
-		const { buildSession } = await import("./wizard-session-DxU5ZMBN.js");
-		const { readEnvironment } = await Promise.resolve().then(() => environment_exports);
-		const { readApiKeyFromEnv } = await import("./env-api-key-HFqv1l-z.js");
-		const { configureLogFileFromEnvironment, logToFile } = await import("./debug-D5kt4fxB.js");
-		const { wizardAbort, WizardError } = await import("./wizard-abort-CuaS1eXn.js");
+		const { buildSession } = await import("./wizard-session-7tMjgOvP.js");
+		const { readEnvironment } = await import("./environment-BAaC5THg.js").then((n) => n.t);
+		const { readApiKeyFromEnv } = await import("./env-api-key-DEl3LJBv.js").then((n) => n.t);
+		const { configureLogFileFromEnvironment, logToFile } = await import("./debug-Cd0hPlZy.js");
+		const { wizardAbort, WizardError } = await import("./wizard-abort-BGoBKgvC.js");
 		configureLogFileFromEnvironment();
 		const env = readEnvironment();
 		const apiKey = options.apiKey ?? readApiKeyFromEnv() ?? void 0;
 		const installDir = path.isAbsolute(options.installDir) ? options.installDir : path.join(process.cwd(), options.installDir);
 		const session = buildSession({
 			debug: options.debug,
-			forceInstall: options.forceInstall,
 			installDir,
 			ci: true,
 			signup: options.signup,
 			localMcp: options.localMcp,
 			apiKey,
 			email: options.email,
-			menu: options.menu,
-			integration: options.integration,
 			projectId: options.projectId,
 			benchmark: options.benchmark,
 			yaraReport: options.yaraReport,
@@ -2893,7 +2996,7 @@ function runWizardCI(config, options, preRun) {
 		getUI().intro("Welcome to the PostHog setup wizard");
 		getUI().log.info(`Running ${config.id} in CI mode`);
 		try {
-			if (preRun) await preRun(session);
+			if (config.ciPreRun) await config.ciPreRun(session);
 			else {
 				const readyCtx = {
 					session,
@@ -2916,7 +3019,7 @@ function runWizardCI(config, options, preRun) {
 					})
 				});
 			}
-			const { runAgent } = await import("./agent-runner-C9sSudE0.js");
+			const { runAgent } = await import("./agent-runner-BxqiKVEf.js");
 			await runAgent(config, session);
 		} catch (error) {
 			const errorMessage = error instanceof Error ? error.message : String(error);
@@ -2934,6 +3037,235 @@ function runWizardCI(config, options, preRun) {
 	});
 }
 //#endregion
-export { SOURCE_MAPS_CONTEXT_KEYS as a, fetchHealthIssues as c, STRIPE_SDKS as d, DISPLAY_NAME as i, getContentBlocks$2 as l, Program as n, getContentBlocks$1 as o, getProgramConfig as r, getKindMeta as s, PROGRAM_REGISTRY as t, POSTHOG_SDKS$1 as u };
+//#region src/commands/skill-program-options.ts
+/** Flags shared by every skill-based program command (integrate, audit, …). */
+const skillProgramOptions = {
+	debug: {
+		default: false,
+		describe: "Enable verbose logging",
+		type: "boolean"
+	},
+	"install-dir": {
+		describe: "Directory to install in",
+		type: "string"
+	},
+	"local-mcp": {
+		default: false,
+		describe: "Use local MCP server",
+		type: "boolean"
+	},
+	benchmark: {
+		default: false,
+		describe: "Run in benchmark mode",
+		type: "boolean"
+	},
+	"yara-report": {
+		default: false,
+		describe: "Print YARA scanner summary",
+		type: "boolean",
+		hidden: true
+	}
+};
+//#endregion
+//#region src/commands/integrate.ts
+const integrateCommand = {
+	name: "integrate",
+	description: posthogIntegrationConfig.description,
+	options: {
+		...skillProgramOptions,
+		...posthogIntegrationConfig.cliOptions ?? {}
+	},
+	handler: (argv) => {
+		const extras = posthogIntegrationConfig.mapCliOptions?.(argv) ?? {};
+		const options = {
+			...argv,
+			...extras
+		};
+		if (options.ci) runWizardCI(posthogIntegrationConfig, options);
+		else runWizard(posthogIntegrationConfig, options);
+	}
+};
+//#endregion
+//#region src/commands/audit.ts
+const auditCommand = {
+	name: "audit",
+	description: auditConfig.description,
+	options: {
+		...skillProgramOptions,
+		...auditConfig.cliOptions ?? {}
+	},
+	handler: (argv) => {
+		const extras = auditConfig.mapCliOptions?.(argv) ?? {};
+		const options = {
+			...argv,
+			...extras
+		};
+		if (options.ci) runWizardCI(auditConfig, options);
+		else runWizard(auditConfig, options);
+	}
+};
+//#endregion
+//#region src/commands/audit-3000.ts
+const audit3000Command = {
+	name: "audit-3000",
+	description: audit3000Config.description,
+	options: {
+		...skillProgramOptions,
+		...audit3000Config.cliOptions ?? {}
+	},
+	handler: (argv) => {
+		const extras = audit3000Config.mapCliOptions?.(argv) ?? {};
+		const options = {
+			...argv,
+			...extras
+		};
+		if (options.ci) runWizardCI(audit3000Config, options);
+		else runWizard(audit3000Config, options);
+	}
+};
+//#endregion
+//#region src/commands/doctor.ts
+const doctorCommand = {
+	name: "doctor",
+	description: posthogDoctorConfig.description,
+	options: {
+		...skillProgramOptions,
+		...posthogDoctorConfig.cliOptions ?? {}
+	},
+	handler: (argv) => {
+		const extras = posthogDoctorConfig.mapCliOptions?.(argv) ?? {};
+		const options = {
+			...argv,
+			...extras
+		};
+		if (options.ci) runDoctorCI(options);
+		else runWizard(posthogDoctorConfig, options);
+	}
+};
+const SEVERITY_ORDER = {
+	critical: 0,
+	warning: 1,
+	info: 2
+};
+async function runDoctorCI(options) {
+	setUI(new LoggingUI());
+	const apiKey = options.apiKey ?? readApiKeyFromEnv() ?? void 0;
+	if (!apiKey) {
+		getUI().intro("PostHog Wizard");
+		getUI().log.error("CI mode requires --api-key (personal API key phx_xxx)");
+		process.exit(1);
+	}
+	getUI().intro("Welcome to the PostHog setup wizard");
+	getUI().log.info("Running posthog-doctor in CI mode");
+	try {
+		const { getOrAskForProjectData } = await import("./setup-utils-BHZEdkNZ.js");
+		const { host, accessToken, projectId } = await getOrAskForProjectData({
+			signup: false,
+			ci: true,
+			apiKey,
+			projectId: options.projectId ? Number(options.projectId) : void 0
+		});
+		const issues = await fetchHealthIssues(accessToken, host, projectId);
+		if (issues.length === 0) {
+			getUI().log.success("No active issues — your project looks healthy.");
+			process.exit(0);
+		}
+		const sorted = [...issues].sort((a, b) => SEVERITY_ORDER[a.severity] - SEVERITY_ORDER[b.severity]);
+		getUI().log.warn(`${issues.length} active issue${issues.length === 1 ? "" : "s"} found:`);
+		for (const issue of sorted) getUI().log.info(`  • [${issue.severity}] ${getKindMeta(issue.kind).title}`);
+		process.exit(1);
+	} catch (error) {
+		const { ApiError } = await import("./api-B8OR0N1V.js");
+		const message = error instanceof ApiError && error.statusCode === 401 ? "Your PostHog API key is invalid or expired." : error instanceof Error ? error.message : String(error);
+		getUI().log.error(`Doctor failed: ${message}`);
+		process.exit(1);
+	}
+}
+//#endregion
+//#region src/commands/migrate.ts
+const migrateCommand = {
+	name: "migrate",
+	description: migrationConfig.description,
+	options: {
+		...skillProgramOptions,
+		...migrationConfig.cliOptions ?? {}
+	},
+	handler: (argv) => {
+		const extras = migrationConfig.mapCliOptions?.(argv) ?? {};
+		const options = {
+			...argv,
+			...extras
+		};
+		if (options.ci) runWizardCI(migrationConfig, options);
+		else runWizard(migrationConfig, options);
+	}
+};
+//#endregion
+//#region src/commands/events-audit.ts
+const eventsAuditCommand = {
+	name: "events-audit",
+	description: eventsAuditConfig.description,
+	options: {
+		...skillProgramOptions,
+		...eventsAuditConfig.cliOptions ?? {}
+	},
+	handler: (argv) => {
+		const extras = eventsAuditConfig.mapCliOptions?.(argv) ?? {};
+		const options = {
+			...argv,
+			...extras
+		};
+		if (options.ci) runWizardCI(eventsAuditConfig, options);
+		else runWizard(eventsAuditConfig, options);
+	}
+};
+//#endregion
+//#region src/commands/revenue.ts
+const revenueCommand = {
+	name: "revenue",
+	description: revenueAnalyticsConfig.description,
+	options: {
+		...skillProgramOptions,
+		...revenueAnalyticsConfig.cliOptions ?? {}
+	},
+	handler: (argv) => {
+		const extras = revenueAnalyticsConfig.mapCliOptions?.(argv) ?? {};
+		const options = {
+			...argv,
+			...extras
+		};
+		if (options.ci) runWizardCI(revenueAnalyticsConfig, options);
+		else runWizard(revenueAnalyticsConfig, options);
+	}
+};
+//#endregion
+//#region src/commands/upload-sourcemaps.ts
+const uploadSourcemapsCommand = {
+	name: "upload-sourcemaps",
+	description: errorTrackingUploadSourceMapsConfig.description,
+	options: {
+		...skillProgramOptions,
+		...errorTrackingUploadSourceMapsConfig.cliOptions ?? {}
+	},
+	handler: (argv) => {
+		const extras = errorTrackingUploadSourceMapsConfig.mapCliOptions?.(argv) ?? {};
+		const options = {
+			...argv,
+			...extras
+		};
+		if (options.ci) runWizardCI(errorTrackingUploadSourceMapsConfig, options);
+		else runWizard(errorTrackingUploadSourceMapsConfig, options);
+	}
+};
+//#endregion
+//#region bin.ts
+const NODE_VERSION_RANGE = ">=18.17.0";
+if (!satisfies(process.version, NODE_VERSION_RANGE)) {
+	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);
+}
+Wizard.use(basicIntegrationCommand).use(mcpCommand).use(integrateCommand).use(auditCommand).use(audit3000Command).use(doctorCommand).use(migrateCommand).use(eventsAuditCommand).use(revenueCommand).use(uploadSourcemapsCommand).init();
+//#endregion
+export { getProgramConfig as a, getContentBlocks$1 as c, createSkillProgram as d, getContentBlocks$2 as f, Program as i, getKindMeta as l, STRIPE_SDKS as m, runWizard as n, DISPLAY_NAME as o, POSTHOG_SDKS$1 as p, PROGRAM_REGISTRY as r, SOURCE_MAPS_CONTEXT_KEYS as s, runWizardCI as t, fetchHealthIssues as u };
 
 //# sourceMappingURL=bin.js.map