@posthog/wizard 2.79.1 → 2.80.1

package/dist/{main-CgKxbwMP.js → main-0p-YxUNa.js}

@@ -1,29 +1,19 @@
-import { I as WIZARD_TOOL_NAMES, et as fetchSkillMenu, u as recoverOrphanedSettingsBackups } from "./agent-interface-FkbaBJwz.js";
-import { n as ErrorCodes, t as emitWizardError } from "./emit-BSetXzDV.js";
-import { b as isHeadless, x as regionOption, y as headlessOption } from "./debug-kAHwWGg7.js";
-import { t as VERSION } from "./version-CHhJjz_H.js";
-import { o as initLocalDev, s as localMcpSkillsNotice } from "./local-dev-McsurOC-.js";
-import { $ as getSkillsBaseUrl, k as POSTHOG_DOCS_URL } from "./constants-DHCBSfnx.js";
-import { n as analytics } from "./analytics-DXK1gc12.js";
-import { r as setEntryCommand } from "./telemetry-B7zJdRmA.js";
-import "./errors-C2domSkK.js";
-import { t as LoggingUI } from "./logging-ui-Dza4D0MK.js";
-import { n as setUI, t as getUI } from "./ui-Q6-RvERF.js";
-import { t as isNonInteractiveEnvironment } from "./environment-BATlQxcQ.js";
-import "./agent-BWFhuLgo.js";
-import { h as AUDIT_CHECKS_FILE } from "./yara-hooks-BnxejtXK.js";
-import { A as installOrUpdatePostHogCli, B as webAnalyticsDoctorConfig, D as CLI_STEERING_TARGETS, E as errorTrackingUploadSourceMapsConfig, G as createSkillProgram, H as getKindMeta, K as warehouseSourceConfig, O as detectTargets, S as errorTrackingConfig, T as replayVisionConfig, U as fetchHealthIssues, V as posthogDoctorConfig, W as auditConfig, d as metricsConfig, f as aiObservabilityConfig, j as installSteeringSnippet, k as findTarget, m as selfDrivingConfig, o as Program, p as mcpAnalyticsConfig, q as revenueAnalyticsConfig, rt as Colors, s as agentSkillConfig, z as migrationConfig } from "./mint-failure-u8xQKNOn.js";
-import { i as runWizard, n as runWizardCI, t as runWizardHeadless } from "./runners-ov3EXF1n.js";
-import { t as PickerMenu } from "./PickerMenu-dG5DQCZA.js";
-import { t as readApiKeyFromEnv } from "./env-api-key-BP-NFFXt.js";
+import { n as ErrorCodes, t as emitWizardError } from "./emit-RfAewcWv.js";
+import { t as configureLogFile } from "./debug-BfQPD2Hg.js";
+import { M as POSTHOG_DOCS_URL, lt as initLocalDev, n as analytics, rt as getSkillsBaseUrl, ut as localMcpSkillsNotice } from "./analytics-D21z3E5l.js";
+import { $ as config$4, I as config$10, M as config$5, N as config$11, Q as config$6, T as Program, V as config$9, X as config$8, Z as config$7, _t as regionOption, at as config$3, ct as config, gt as isHeadless, ht as headlessOption, k as getProgramConfig, lt as createSkillProgram, ot as config$2, st as config$1, ut as CLI_STEERING_TARGETS } from "./programs-SeT1qNik.js";
+import { n as setEntryCommand } from "./links-Cyj6v8kg.js";
+import "./errors-CHrJzAZb.js";
+import { a as runWizard, c as underSignals, i as readApiKeyFromEnv, l as withSignals, n as runWizardCI, o as tuiSessionArgs, s as exitWith, t as runWizardHeadless, u as isNonInteractiveEnvironment } from "./runners-Dhu4pZTN.js";
+import { t as consoleLog } from "./console-log-O828zyiq.js";
+import { R as WIZARD_TOOL_NAMES, u as recoverOrphanedSettingsBackups } from "./agent-interface-CemBvTAA.js";
+import "./posthog-integration-bwHwE87a.js";
+import { x as AUDIT_CHECKS_FILE, y as fetchSkillMenu } from "./yara-hooks-D8YDyX7o.js";
+import { a as runCliAdd, d as runDoctorReport, i as runProvision, o as addMCPServerToClientsStep, r as listSkills, s as removeMCPServerFromClientsStep, t as Tool, u as DOCTOR } from "./tools-CCMV3DmB.js";
 import { Agent, setGlobalDispatcher } from "undici";
 import yargs from "yargs";
 import { hideBin } from "yargs/helpers";
-import * as path$1 from "node:path";
-import { Box, Text, render } from "ink";
-import { createElement } from "react";
-import * as readline from "node:readline/promises";
-//#region src/commands/command.ts
+//#region src/cli/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]);
@@ -50,7 +40,7 @@ function toCommandModule(cmd, parentPath) {
 	};
 }
 //#endregion
-//#region src/wizard.ts
+//#region src/cli/wizard.ts
 /**
 * Global yargs options applied to every command. These are read from the
 * `POSTHOG_WIZARD` env prefix as well as flags.
@@ -66,6 +56,10 @@ const GLOBAL_OPTIONS = {
 		describe: "Enable verbose logging\nenv: POSTHOG_WIZARD_DEBUG",
 		type: "boolean"
 	},
+	"log-file": {
+		describe: "Write the debug log to this file (default: posthog-wizard.log in the temp dir)\nenv: POSTHOG_WIZARD_LOG_FILE",
+		type: "string"
+	},
 	signup: {
 		default: false,
 		describe: "Create a new PostHog account during setup\nenv: POSTHOG_WIZARD_SIGNUP",
@@ -116,6 +110,10 @@ var Wizard = class Wizard {
 	constructor() {
 		let cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options(GLOBAL_OPTIONS);
 		this.cli = cli.middleware((argv) => {
+			if (typeof argv.logFile === "string" && argv.logFile) configureLogFile({
+				path: argv.logFile,
+				pin: true
+			});
 			initLocalDev(argv);
 			const notice = localMcpSkillsNotice({
 				localDev: argv.localDev,
@@ -194,7 +192,7 @@ const LOCAL_TARGET_ENV_VARS = [
 	"POSTHOG_WIZARD_LOCAL_POSTHOG"
 ];
 //#endregion
-//#region src/commands/provision.ts
+//#region src/cli/commands/provision.ts
 const provisionCommand = {
 	name: "provision",
 	description: "Create a new PostHog account (headless, no TUI)",
@@ -220,58 +218,20 @@ const provisionCommand = {
 		}
 	},
 	examples: [["wizard provision --email matt+test@posthog.com --region us", ""], ["wizard provision --email user@example.com --region eu --json", ""]],
-	handler: runProvision
+	handler: provision
 };
-function runProvision(argv) {
+function provision(argv) {
 	const jsonMode = argv.json === void 0 ? !process.stdout.isTTY : Boolean(argv.json);
-	if (!jsonMode) setUI(new LoggingUI());
-	provision({
+	exitWith(() => runProvision({
 		email: argv.email,
 		region: argv.region.toUpperCase(),
 		name: argv.name ?? "",
 		baseUrl: argv.baseUrl,
 		jsonMode
-	});
-}
-async function provision({ email, region, name, baseUrl, jsonMode }) {
-	try {
-		const { provisionNewAccount } = await import("./provisioning-OGFGlzf7.js");
-		if (!jsonMode) getUI().log.info(`Provisioning account for ${email} in ${region}...`);
-		emitResult(await provisionNewAccount(email, name, region, { baseUrl }), 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}`);
+	}, { log: consoleLog }));
 }
 //#endregion
-//#region src/commands/basic-integration/index.ts
+//#region src/cli/commands/basic-integration/index.ts
 const basicIntegrationCommand = {
 	name: ["$0"],
 	description: "Run the PostHog setup wizard",
@@ -302,41 +262,41 @@ const basicIntegrationCommand = {
 		setEntryCommand("integrate");
 		(async () => {
 			if (isHeadless(argv)) {
-				const { runHeadlessInstall } = await import("./ci-install-COcV8SY2.js");
+				const { runHeadlessInstall } = await import("./ci-install-CEYE02t-.js");
 				return runHeadlessInstall(argv);
 			}
 			if (argv.ci) {
-				const { runCIInstall } = await import("./ci-install-COcV8SY2.js");
+				const { runCIInstall } = await import("./ci-install-CEYE02t-.js");
 				return runCIInstall(argv);
 			}
 			if (isNonInteractiveEnvironment()) {
-				const { failNonInteractive } = await import("./non-interactive-DyVC1AGc.js");
+				const { failNonInteractive } = await import("./non-interactive-DxRBc73O.js");
 				return failNonInteractive();
 			}
 			if (argv.playground) {
-				const { runPlayground } = await import("./playground-BlYRBMj7.js");
+				const { runPlayground } = await import("./playground-DTKy0XHT.js");
 				return runPlayground();
 			}
-			const { runInteractive } = await import("./interactive-B_Ti_CsS.js");
+			const { runInteractive } = await import("./interactive-tdxZKWax.js");
 			runInteractive(argv);
 		})();
 	}
 };
 //#endregion
-//#region src/commands/mcp/tui-availability.ts
+//#region src/cli/commands/mcp/tui-availability.ts
 /**
 * startTUI throws CliInteractiveRequired, and Ink throws "Raw mode is not
 * supported", when stdin has no TTY (piped input, CI, some IDE terminals).
-* That is the only TUI failure the mcp commands
-* degrade to LoggingUI for — any other error from the TUI path is a real bug
-* and must surface rather than be silently swallowed.
+* That is the only TUI failure the mcp commands degrade to console output for
+* — any other error from the TUI path is a real bug and must surface rather
+* than be silently swallowed.
 */
 function isTUIUnavailable(error) {
 	if (!(error instanceof Error)) return false;
 	return error.code === ErrorCodes.CliInteractiveRequired || /raw mode is not supported/i.test(error.message);
 }
 //#endregion
-//#region src/commands/mcp/add.ts
+//#region src/cli/commands/mcp/add.ts
 const mcpAddCommand = {
 	name: "add",
 	description: "Install PostHog MCP server to supported clients",
@@ -360,49 +320,42 @@ const mcpAddCommand = {
 };
 function runMcpAdd(argv) {
 	const features = parseFeatures(argv.features);
-	(async () => {
-		const { readApiKeyFromEnv } = await import("./env-api-key-CaWEDj_9.js");
-		const apiKey = argv.apiKey || readApiKeyFromEnv();
-		const debug = argv.debug;
-		const localMcp = argv.local;
-		const args = {
-			local: localMcp,
-			features,
-			apiKey
-		};
-		if (isHeadless(argv)) {
-			await runHeadlessAdd(args);
-			return;
-		}
+	const apiKey = argv.apiKey || readApiKeyFromEnv();
+	const localMcp = argv.local;
+	const headless = () => addMCPServerToClientsStep({
+		local: localMcp,
+		features,
+		apiKey
+	}, { log: consoleLog.log });
+	if (isHeadless(argv)) {
+		exitWith(headless);
+		return;
+	}
+	exitWith(async () => {
 		try {
-			const { startTUI } = await import("./start-tui-Bo2L0bar.js");
-			const { buildSession } = await import("./wizard-session-DGaUHOF3.js");
-			const tui = startTUI(VERSION, Program.McpAdd);
-			tui.store.session = buildSession({
-				debug,
-				localMcp,
-				mcpFeatures: features,
-				apiKey,
-				baseUrl: argv.baseUrl
-			});
+			const { runTuiTool } = await import("./tui-BUZ2PWqN.js");
+			return await underSignals((signal) => runTuiTool(Tool.McpAdd, {
+				session: {
+					debug: argv.debug,
+					localMcp,
+					mcpFeatures: features,
+					apiKey,
+					baseUrl: argv.baseUrl
+				},
+				signal
+			}));
 		} catch (error) {
 			if (!isTUIUnavailable(error)) throw error;
-			await runHeadlessAdd(args);
+			return headless();
 		}
-	})();
-}
-async function runHeadlessAdd(args) {
-	setUI(new LoggingUI());
-	const { addMCPServerToClientsStep } = await import("./add-mcp-server-to-clients-artmN7mz.js");
-	const { installed, failed } = await addMCPServerToClientsStep(args);
-	if (failed.length > 0 || installed.length === 0) process.exitCode = 1;
+	});
 }
 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
+//#region src/cli/commands/mcp/remove.ts
 const mcpRemoveCommand = {
 	name: "remove",
 	description: "Remove PostHog MCP server from supported clients",
@@ -417,36 +370,31 @@ const mcpRemoveCommand = {
 	handler: runMcpRemove
 };
 function runMcpRemove(argv) {
-	(async () => {
-		const debug = argv.debug;
-		const localMcp = argv.local;
-		if (isHeadless(argv)) {
-			await runHeadlessRemove(localMcp);
-			return;
-		}
+	const localMcp = argv.local;
+	const headless = () => removeMCPServerFromClientsStep({ local: localMcp }, { log: consoleLog.log });
+	if (isHeadless(argv)) {
+		exitWith(headless);
+		return;
+	}
+	exitWith(async () => {
 		try {
-			const { startTUI } = await import("./start-tui-Bo2L0bar.js");
-			const { buildSession } = await import("./wizard-session-DGaUHOF3.js");
-			const tui = startTUI(VERSION, Program.McpRemove);
-			tui.store.session = buildSession({
-				debug,
-				localMcp,
-				baseUrl: argv.baseUrl
-			});
+			const { runTuiTool } = await import("./tui-BUZ2PWqN.js");
+			return await underSignals((signal) => runTuiTool(Tool.McpRemove, {
+				session: {
+					debug: argv.debug,
+					localMcp,
+					baseUrl: argv.baseUrl
+				},
+				signal
+			}));
 		} catch (error) {
 			if (!isTUIUnavailable(error)) throw error;
-			await runHeadlessRemove(localMcp);
+			return headless();
 		}
-	})();
-}
-/** No exit code on an empty result: nothing to remove is the requested end state. */
-async function runHeadlessRemove(local) {
-	setUI(new LoggingUI());
-	const { removeMCPServerFromClientsStep } = await import("./add-mcp-server-to-clients-artmN7mz.js");
-	await removeMCPServerFromClientsStep({ local });
+	});
 }
 //#endregion
-//#region src/commands/mcp/tutorial.ts
+//#region src/cli/commands/mcp/tutorial.ts
 const mcpTutorialCommand = {
 	name: "tutorial",
 	description: "Try the PostHog MCP with your agent (no install needed)",
@@ -458,31 +406,29 @@ const mcpTutorialCommand = {
 	handler: runMcpTutorial
 };
 function runMcpTutorial(argv) {
-	(async () => {
-		const debug = argv.debug;
-		const localMcp = argv.local;
+	exitWith(async () => {
 		try {
-			const { startTUI } = await import("./start-tui-Bo2L0bar.js");
-			const { buildSession } = await import("./wizard-session-DGaUHOF3.js");
-			const tui = startTUI(VERSION, Program.McpTutorial);
-			tui.store.session = buildSession({
-				debug,
-				localMcp,
-				baseUrl: argv.baseUrl
-			});
+			const { runTuiTool } = await import("./tui-BUZ2PWqN.js");
+			return await underSignals((signal) => runTuiTool(Tool.McpTutorial, {
+				session: {
+					debug: argv.debug,
+					localMcp: argv.local,
+					baseUrl: argv.baseUrl
+				},
+				signal
+			}));
 		} catch (err) {
-			setUI(new LoggingUI());
-			getUI().log.error(`The MCP tutorial requires an interactive terminal. ${err instanceof Error ? err.message : String(err)}`);
+			consoleLog.log.error(`The MCP tutorial requires an interactive terminal. ${err instanceof Error ? err.message : String(err)}`);
 			emitWizardError({
 				code: ErrorCodes.CliInteractiveRequired,
 				message: "The MCP tutorial requires an interactive terminal."
 			});
-			process.exit(1);
+			return 1;
 		}
-	})();
+	});
 }
 //#endregion
-//#region src/commands/mcp/index.ts
+//#region src/cli/commands/mcp/index.ts
 const mcpCommand = {
 	name: "mcp",
 	description: "MCP server management commands",
@@ -493,7 +439,7 @@ const mcpCommand = {
 	]
 };
 //#endregion
-//#region src/commands/skill-program-options.ts
+//#region src/cli/commands/skill-program-options.ts
 /**
 * Per-command options shared by every skill-based program command
 * (`audit events`, `migrate statsig`, `revenue`, `source-maps`, …).
@@ -507,7 +453,7 @@ const skillProgramOptions = { "install-dir": {
 	type: "string"
 } };
 //#endregion
-//#region src/commands/factories/shared.ts
+//#region src/cli/commands/factories/shared.ts
 /**
 * Dispatch a parsed yargs invocation to the wizard runner. Applies the
 * program's `mapCliOptions` transform, then routes to `runWizardHeadless`,
@@ -562,7 +508,7 @@ function mergeCommandOptions(config) {
 	};
 }
 //#endregion
-//#region src/commands/factories/native-command-factory.ts
+//#region src/cli/commands/factories/native-command-factory.ts
 /**
 * Build a yargs `Command` from a wizard-native `ProgramConfig`.
 *
@@ -581,7 +527,7 @@ function nativeCommandFactory(config, opts = {}) {
 	};
 }
 //#endregion
-//#region src/commands/mcp-analytics.ts
+//#region src/cli/commands/mcp-analytics.ts
 /**
 * `wizard mcp-analytics` — flat skill command, instrument-an-MCP-server today.
 *
@@ -589,9 +535,9 @@ function nativeCommandFactory(config, opts = {}) {
 * with the `@posthog/mcp` SDK, rather than installing the PostHog MCP server
 * into a coding agent. Stays flat while instrumenting is the only action.
 */
-const mcpAnalyticsCommand = nativeCommandFactory(mcpAnalyticsConfig);
+const mcpAnalyticsCommand = nativeCommandFactory(config);
 //#endregion
-//#region src/commands/replay-vision.ts
+//#region src/cli/commands/replay-vision.ts
 /**
 * `wizard replay-vision` — flat skill command, set up Replay vision today.
 *
@@ -600,9 +546,9 @@ const mcpAnalyticsCommand = nativeCommandFactory(mcpAnalyticsConfig);
 * reuses the integration-v2 install/init mini-agents when the repo has no
 * PostHog integration yet.
 */
-const replayVisionCommand = nativeCommandFactory(replayVisionConfig);
+const replayVisionCommand = nativeCommandFactory(config$1);
 //#endregion
-//#region src/commands/ai-observability.ts
+//#region src/cli/commands/ai-observability.ts
 /**
 * `wizard ai-observability` — flat skill command, wire AI Observability into a
 * project today.
@@ -614,9 +560,9 @@ const replayVisionCommand = nativeCommandFactory(replayVisionConfig);
 * project's manifest and (when ambiguous) asking the user via `wizard_ask`.
 * Stays flat while a single "add AIO to a project" flow is the only action.
 */
-const aiObservabilityCommand = nativeCommandFactory(aiObservabilityConfig);
+const aiObservabilityCommand = nativeCommandFactory(config$2);
 //#endregion
-//#region src/commands/metrics.ts
+//#region src/cli/commands/metrics.ts
 /**
 * `wizard metrics` — flat skill command, wire PostHog application metrics
 * (counters, gauges, histograms via \`posthog.metrics\`) into a project.
@@ -627,9 +573,52 @@ const aiObservabilityCommand = nativeCommandFactory(aiObservabilityConfig);
 * the user via `wizard_ask`. Stays flat while a single "add metrics to a
 * project" flow is the only action.
 */
-const metricsCommand = nativeCommandFactory(metricsConfig);
+const metricsCommand = nativeCommandFactory(config$3);
+//#endregion
+//#region src/cli/commands/cli/index.ts
+const cliCommand = {
+	name: "cli",
+	description: "PostHog CLI agent integration commands",
+	children: [{
+		name: "add",
+		description: "Install or update PostHog CLI and add steering instructions to your coding agent's global instructions file",
+		options: {
+			agent: {
+				describe: "Agent to install the instructions for",
+				choices: CLI_STEERING_TARGETS.map((target) => target.id),
+				type: "string"
+			},
+			path: {
+				describe: "Write to an explicit instructions file instead of a detected agent",
+				type: "string"
+			},
+			all: {
+				default: false,
+				describe: "Install for every detected agent without prompting",
+				type: "boolean"
+			}
+		},
+		examples: [
+			["wizard cli add", "Detect your coding agents and pick one"],
+			["wizard cli add --agent claude-code", "Install for Claude Code (~/.claude/CLAUDE.md)"],
+			["wizard cli add --all", "Install for every detected agent"],
+			["wizard cli add --path ./AGENTS.md", "Install into a specific instructions file"]
+		],
+		check: (argv) => {
+			if (argv.all && (argv.agent || argv.path)) throw new Error("--all cannot be combined with --agent or --path");
+			return true;
+		},
+		handler: (argv) => {
+			exitWith(() => runCliAdd({
+				agent: typeof argv.agent === "string" ? argv.agent : void 0,
+				path: typeof argv.path === "string" ? argv.path : void 0,
+				all: argv.all === true
+			}, { log: consoleLog }));
+		}
+	}]
+};
 //#endregion
-//#region src/programs/dispatch-family.ts
+//#region src/cli/commands/dispatch-family.ts
 /**
 * Capture a CLI dispatch error, flush analytics, and exit. The wizard never
 * starts a run from these paths — use flush() (not shutdown()) so we don't
@@ -661,27 +650,27 @@ async function exitDispatchError(reason, properties, message, code = 1) {
 * without touching the registry. Adding a native is a wizard PR.
 */
 /** Wizard-native subcommands keyed by family. */
-const NATIVE_HANDLERS = { audit: { "web-analytics": webAnalyticsDoctorConfig } };
+const NATIVE_HANDLERS = { audit: { "web-analytics": config$4 } };
 /**
 * Resolve a fetched CliEntry to the ProgramConfig that actually runs it.
 * Most entries run via the generic agent-skill program with the entry's
 * `skillId` injected. The comprehensive `audit all` is the one exception —
-* skillId 'audit' triggers the specialized auditConfig (custom hooks,
+* skillId 'audit' triggers the specialized `audit` program (custom hooks,
 * content blocks, screens).
 *
 * This is the one place that knows a subcommand belongs to `audit`, so the
 * generic skill program picks up the ledger here rather than for every skill.
 */
 function configForCliEntry(entry, family) {
-	if (entry.skillId === "audit") return auditConfig;
+	if (entry.skillId === "audit") return getProgramConfig(Program.Audit);
 	return {
-		...agentSkillConfig,
+		...config$5,
 		skillId: entry.skillId,
 		...family === "audit" ? {
 			auditLedgerFile: AUDIT_CHECKS_FILE,
 			streamWorkflowId: family,
 			allowedTools: [
-				...agentSkillConfig.allowedTools ?? [],
+				...config$5.allowedTools ?? [],
 				WIZARD_TOOL_NAMES.auditSeedChecks,
 				WIZARD_TOOL_NAMES.auditAddChecks,
 				WIZARD_TOOL_NAMES.auditResolveChecks
@@ -766,25 +755,7 @@ function pickerChildrenToShow(children) {
 	return defaults.length > 0 ? [...defaults] : [...children];
 }
 //#endregion
-//#region src/commands/factories/family-picker.tsx
-function FamilyPickerApp(props) {
-	return createElement(Box, {
-		flexDirection: "column",
-		paddingX: 1,
-		paddingY: 1
-	}, createElement(Text, {
-		bold: true,
-		color: Colors.accent
-	}, props.parentLabel), createElement(Box, { height: 1 }), createElement(PickerMenu, {
-		message: "Pick a subcommand",
-		options: props.options,
-		optionMarginBottom: 1,
-		onSelect: (value) => {
-			const cmd = Array.isArray(value) ? value[0] : value;
-			if (cmd) props.onSelect(cmd);
-		}
-	}));
-}
+//#region src/cli/commands/factories/family-picker.ts
 function describe(child) {
 	return commandKeys(child.name)[0] ?? "";
 }
@@ -804,30 +775,19 @@ function orderFamilyChildren(children) {
 	return [...defaults, ...rest];
 }
 /**
-* Render the picker. Resolves once the user has selected a child;
-* dispatching the child's handler is the caller's responsibility (so this
-* function stays pure-UI and easy to test by stubbing `render`).
+* Render the picker over a family's children. Resolves once the user has
+* selected a child; dispatching the child's handler is the caller's
+* responsibility.
 */
-function chooseFamilyChild(parentLabel, children) {
+async function chooseFamilyChild(parentLabel, children) {
 	const ordered = orderFamilyChildren(children);
-	if (ordered.length === 0) return Promise.resolve(null);
-	const options = ordered.map((child) => ({
+	if (ordered.length === 0) return null;
+	const { renderFamilyPicker } = await import("./tui-BUZ2PWqN.js");
+	return renderFamilyPicker(parentLabel, ordered.map((child) => ({
 		label: describe(child),
 		value: child,
 		hint: child.description
-	}));
-	return new Promise((resolve) => {
-		let app = null;
-		const handleSelect = (cmd) => {
-			app?.unmount();
-			resolve(cmd);
-		};
-		app = render(createElement(FamilyPickerApp, {
-			parentLabel,
-			options,
-			onSelect: handleSelect
-		}));
-	});
+	})));
 }
 /**
 * Returns an `interactiveDefault` handler for a family parent's no-leaf
@@ -852,7 +812,7 @@ function createFamilyPickerDefault(parentLabel, children, chooser = chooseFamily
 	};
 }
 //#endregion
-//#region src/commands/factories/family-command-factory.ts
+//#region src/cli/commands/factories/family-command-factory.ts
 /**
 * Build a yargs `Command` for a family parent (`wizard audit`, etc.).
 *
@@ -894,7 +854,7 @@ function familyCommandFactory({ family, description, optionsFrom }) {
 	};
 }
 //#endregion
-//#region src/commands/audit.ts
+//#region src/cli/commands/audit.ts
 /**
 * The `wizard audit` family.
 *
@@ -907,80 +867,39 @@ function familyCommandFactory({ family, description, optionsFrom }) {
 * Adding a new skill-backed audit subcommand is a context-mill release —
 * no wizard release needed.
 */
+const audit = getProgramConfig(Program.Audit);
 const auditCommand = familyCommandFactory({
 	family: "audit",
-	description: auditConfig.description,
-	optionsFrom: auditConfig
+	description: audit.description,
+	optionsFrom: audit
 });
 //#endregion
-//#region src/commands/doctor.ts
+//#region src/cli/commands/doctor.ts
 const doctorCommand = {
 	name: "doctor",
-	description: posthogDoctorConfig.description,
-	options: {
-		...skillProgramOptions,
-		...posthogDoctorConfig.cliOptions ?? {}
-	},
+	description: DOCTOR.description,
+	options: { ...skillProgramOptions },
 	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)");
-		emitWizardError({
-			code: ErrorCodes.ArgsMissingApiKey,
-			message: "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-CVS86NYR.js");
-		const { host, accessToken, projectId } = await getOrAskForProjectData({
-			signup: false,
-			ci: true,
-			apiKey,
-			projectId: options.projectId ? Number(options.projectId) : void 0,
-			baseUrl: options.baseUrl
-		});
-		const issues = await fetchHealthIssues(accessToken, host.apiHost, projectId);
-		if (issues.length === 0) {
-			getUI().log.success("No active issues — your project looks healthy.");
-			process.exit(0);
+		const options = { ...argv };
+		if (options.ci) {
+			exitWith(() => runDoctorReport({
+				apiKey: options.apiKey ?? readApiKeyFromEnv() ?? void 0,
+				projectId: options.projectId ? Number(options.projectId) : void 0,
+				baseUrl: options.baseUrl
+			}, { log: consoleLog }));
+			return;
 		}
-		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-Cm9UtKZh.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}`);
-		emitWizardError({
-			code: error instanceof ApiError && error.statusCode === 401 ? ErrorCodes.AuthInvalidOrExpired : ErrorCodes.InternalUnhandled,
-			message
+		withSignals(async (signal) => {
+			const { runTuiTool } = await import("./tui-BUZ2PWqN.js");
+			return runTuiTool(Tool.PosthogDoctor, {
+				session: tuiSessionArgs(options),
+				signal
+			});
 		});
-		process.exit(1);
 	}
-}
+};
 //#endregion
-//#region src/commands/migrate.ts
+//#region src/cli/commands/migrate.ts
 /**
 * `wizard migrate` — flat skill command, Statsig today.
 *
@@ -991,30 +910,30 @@ async function runDoctorCI(options) {
 * (`wizard migrate` stops running Statsig directly), so do it explicitly
 * when the second vendor arrives, not pre-emptively.
 */
-const migrateCommand = nativeCommandFactory(migrationConfig);
+const migrateCommand = nativeCommandFactory(config$6);
 //#endregion
-//#region src/commands/revenue.ts
+//#region src/cli/commands/revenue.ts
 /**
 * `wizard revenue-analytics` — flat skill command, Stripe today.
 *
 * Stays flat while there's only one provider. Restructure into a family
 * if/when a second provider lands.
 */
-const revenueCommand = nativeCommandFactory(revenueAnalyticsConfig);
+const revenueCommand = nativeCommandFactory(config$7);
 //#endregion
-//#region src/commands/warehouse.ts
+//#region src/cli/commands/warehouse.ts
 /**
 * `wizard warehouse` — detect and connect a data warehouse source.
 *
 * Mirrors `revenue-analytics`: flat skill command driven by the
 * warehouse-source program.
 */
-const warehouseCommand = nativeCommandFactory(warehouseSourceConfig);
+const warehouseCommand = nativeCommandFactory(config$8);
 //#endregion
-//#region src/commands/self-driving.ts
+//#region src/cli/commands/self-driving.ts
 const selfDrivingCommand = {
 	name: "self-driving",
-	description: selfDrivingConfig.description,
+	description: config$9.description,
 	options: {
 		...skillProgramOptions,
 		integrate: {
@@ -1022,7 +941,7 @@ const selfDrivingCommand = {
 			type: "boolean",
 			default: false
 		},
-		...selfDrivingConfig.cliOptions ?? {}
+		...config$9.cliOptions ?? {}
 	},
 	check: (argv) => {
 		if (argv.signup) throw new Error("`self-driving` cannot run with --signup. Just run `wizard self-driving`: when your project has no PostHog, it asks whether you already have an account and offers to create one for you (no flag needed).");
@@ -1030,17 +949,17 @@ const selfDrivingCommand = {
 		return true;
 	},
 	handler: (argv) => {
-		const extras = selfDrivingConfig.mapCliOptions?.(argv) ?? {};
+		const extras = config$9.mapCliOptions?.(argv) ?? {};
 		const options = {
 			...argv,
 			...extras
 		};
-		if (options.ci) runWizardCI(selfDrivingConfig, options);
-		else runWizard(selfDrivingConfig, options);
+		if (options.ci) runWizardCI(config$9, options);
+		else runWizard(config$9, options);
 	}
 };
 //#endregion
-//#region src/commands/slack.ts
+//#region src/cli/commands/slack.ts
 const slackCommand = {
 	name: "slack",
 	description: "Connect PostHog to your Slack",
@@ -1052,48 +971,47 @@ const slackCommand = {
 	}]
 };
 function runSlackConnect(argv) {
-	(async () => {
-		const debug = argv.debug;
+	exitWith(async () => {
 		try {
-			const { startTUI } = await import("./start-tui-Bo2L0bar.js");
-			const { buildSession } = await import("./wizard-session-DGaUHOF3.js");
-			const tui = startTUI(VERSION, Program.SlackConnect);
-			tui.store.session = buildSession({
-				debug,
-				baseUrl: argv.baseUrl
-			});
+			const { runTuiTool } = await import("./tui-BUZ2PWqN.js");
+			return await underSignals((signal) => runTuiTool(Tool.SlackConnect, {
+				session: {
+					debug: argv.debug,
+					baseUrl: argv.baseUrl
+				},
+				signal
+			}));
 		} catch (err) {
-			setUI(new LoggingUI());
-			getUI().log.error(`Connecting Slack requires an interactive terminal. ${err instanceof Error ? err.message : String(err)}`);
+			consoleLog.log.error(`Connecting Slack requires an interactive terminal. ${err instanceof Error ? err.message : String(err)}`);
 			emitWizardError({
 				code: ErrorCodes.CliInteractiveRequired,
 				message: "Connecting Slack requires an interactive terminal."
 			});
-			process.exit(1);
+			return 1;
 		}
-	})();
+	});
 }
 //#endregion
-//#region src/commands/upload-sourcemaps.ts
+//#region src/cli/commands/upload-sourcemaps.ts
 const uploadSourcemapsCommand = {
-	name: [errorTrackingUploadSourceMapsConfig.command, "upload-sourcemaps"],
-	description: errorTrackingUploadSourceMapsConfig.description,
+	name: [config$10.command, "upload-sourcemaps"],
+	description: config$10.description,
 	options: {
 		...skillProgramOptions,
-		...errorTrackingUploadSourceMapsConfig.cliOptions ?? {}
+		...config$10.cliOptions ?? {}
 	},
 	handler: (argv) => {
-		const extras = errorTrackingUploadSourceMapsConfig.mapCliOptions?.(argv) ?? {};
+		const extras = config$10.mapCliOptions?.(argv) ?? {};
 		const options = {
 			...argv,
 			...extras
 		};
-		if (options.ci) runWizardCI(errorTrackingUploadSourceMapsConfig, options);
-		else runWizard(errorTrackingUploadSourceMapsConfig, options);
+		if (options.ci) runWizardCI(config$10, options);
+		else runWizard(config$10, options);
 	}
 };
 //#endregion
-//#region src/commands/error-tracking.ts
+//#region src/cli/commands/error-tracking.ts
 /**
 * `wizard error-tracking` — flat skill command, set up error tracking today.
 *
@@ -1102,9 +1020,9 @@ const uploadSourcemapsCommand = {
 * reuses the integration-v2 install/init mini-agents when the repo has no
 * PostHog integration yet, so it works on uninstrumented projects too.
 */
-const errorTrackingCommand = nativeCommandFactory(errorTrackingConfig);
+const errorTrackingCommand = nativeCommandFactory(config$11);
 //#endregion
-//#region src/commands/basic-integration/skill.ts
+//#region src/cli/commands/basic-integration/skill.ts
 /** Run an arbitrary context-mill skill by id (`wizard skill <id>`, headless with `--ci`). */
 function runSkillMode(argv) {
 	const skillId = argv.skill;
@@ -1128,12 +1046,11 @@ function runSkillMode(argv) {
 	else runWizard(config, options);
 }
 //#endregion
-//#region src/commands/skill.ts
+//#region src/cli/commands/skill.ts
 /** Read the `<skill-name>` positional (yargs camelCases the hyphenated key). */
 function readSkillName(argv) {
 	return String(argv.skillName ?? argv["skill-name"] ?? "").trim();
 }
-const BROWSABLE_ROLES = new Set(["command", "skill"]);
 /**
 * Reject an unknown skill id before the wizard authenticates.
 *
@@ -1164,10 +1081,6 @@ async function assertSkillExists(skillName) {
 	} catch {}
 	throw new Error(`Unknown skill "${skillName}". Run \`wizard skill list\` to see available skills.`);
 }
-function formatEntry(entry) {
-	const path = entry.parentCommand ? `wizard ${entry.parentCommand} ${entry.command}` : entry.command ? `wizard ${entry.command}` : `wizard skill ${entry.skillId}`;
-	return `  ${entry.skillId.padEnd(38)}  ${path.padEnd(36)}  ${entry.description}`;
-}
 /**
 * `wizard skill <skill-name>` — run a single context-mill skill by id.
 * `wizard skill list`         — list every browsable skill in the catalog.
@@ -1179,52 +1092,17 @@ function formatEntry(entry) {
 const skillCommand = {
 	name: "skill <skill-name>",
 	description: "Run a specific context-mill skill by name (or `list` them)",
-	children: [{
-		name: "list",
-		description: "List every browsable skill in the catalog",
-		handler: () => {
-			runCommandHandler(async () => {
-				const skillsBaseUrl = getSkillsBaseUrl();
-				const menu = await fetchSkillMenu(skillsBaseUrl);
-				if (!menu) {
-					analytics.wizardCapture("cli dispatch error", {
-						reason: "registry unreachable",
-						family: "skill",
-						sub: "list",
-						skillsBaseUrl
-					});
-					try {
-						await analytics.flush();
-					} catch {}
-					process.stderr.write("\n\x1B[1;91m✖ Couldn't reach the skill registry.\x1B[0m\n  Check your network connection and try again.\n\n");
-					emitWizardError({
-						code: ErrorCodes.SkillMenuFetchFailed,
-						message: "Couldn't reach the skill registry."
-					});
-					process.exit(1);
-				}
-				const entries = (menu.cliEntries ?? []).filter((e) => BROWSABLE_ROLES.has(e.role));
-				if (entries.length === 0) {
-					process.stdout.write("No skills found.\n");
-					return;
-				}
-				process.stdout.write(`${entries.length} skill${entries.length === 1 ? "" : "s"}:\n`);
-				process.stdout.write(`  ${"SKILL ID".padEnd(38)}  ${"COMMAND".padEnd(36)}  DESCRIPTION\n`);
-				for (const entry of entries) process.stdout.write(`${formatEntry(entry)}\n`);
-			});
-		}
-	}],
 	options: { ...skillProgramOptions },
 	positionals: { "skill-name": {
 		type: "string",
 		describe: "Skill id to run (e.g. audit-events), or `list`"
 	} },
 	check: (argv) => {
-		if (argv.skillName == null && argv["skill-name"] == null) return true;
 		if (!readSkillName(argv)) throw new Error("skill needs a skill name, e.g. `wizard skill audit-events`");
 		return true;
 	},
 	handler: (argv) => {
+		if (readSkillName(argv) === "list") return exitWith(listSkills);
 		runCommandHandler(async () => {
 			const skillName = readSkillName(argv);
 			await assertSkillExists(skillName);
@@ -1236,148 +1114,13 @@ const skillCommand = {
 	}
 };
 //#endregion
-//#region src/commands/cli/add.ts
-const cliAddCommand = {
-	name: "add",
-	description: "Install or update PostHog CLI and add steering instructions to your coding agent's global instructions file",
-	options: {
-		agent: {
-			describe: "Agent to install the instructions for",
-			choices: CLI_STEERING_TARGETS.map((target) => target.id),
-			type: "string"
-		},
-		path: {
-			describe: "Write to an explicit instructions file instead of a detected agent",
-			type: "string"
-		},
-		all: {
-			default: false,
-			describe: "Install for every detected agent without prompting",
-			type: "boolean"
-		}
-	},
-	examples: [
-		["wizard cli add", "Detect your coding agents and pick one"],
-		["wizard cli add --agent claude-code", "Install for Claude Code (~/.claude/CLAUDE.md)"],
-		["wizard cli add --all", "Install for every detected agent"],
-		["wizard cli add --path ./AGENTS.md", "Install into a specific instructions file"]
-	],
-	check: (argv) => {
-		if (argv.all && (argv.agent || argv.path)) throw new Error("--all cannot be combined with --agent or --path");
-		return true;
-	},
-	handler: (argv) => {
-		runCliAdd(argv);
-	}
-};
-async function runCliAdd(argv) {
-	setUI(new LoggingUI());
-	const ui = getUI();
-	ui.intro("PostHog CLI setup");
-	const files = await resolveTargetFiles(argv);
-	if (files.length === 0) {
-		process.exit(1);
-		return;
-	}
-	ui.log.info("Installing or updating PostHog CLI...");
-	const cliInstallResult = installOrUpdatePostHogCli();
-	if (!cliInstallResult.success) {
-		ui.log.error(`Failed to install or update PostHog CLI: ${cliInstallResult.error ?? ""}`);
-		analytics.wizardCapture("cli steering installed", {
-			files: files.length,
-			failures: files.length,
-			cli_install_failed: true,
-			agent: typeof argv.agent === "string" ? argv.agent : void 0
-		});
-		process.exit(1);
-		return;
-	}
-	ui.log.success("Installed or updated PostHog CLI.");
-	let failures = 0;
-	for (const file of files) {
-		const result = installSteeringSnippet(file);
-		if (result.success) ui.log.success(`Installed PostHog steering instructions in ${file}`);
-		else {
-			failures += 1;
-			ui.log.error(`Failed to update ${file}: ${result.error ?? ""}`);
-		}
-	}
-	analytics.wizardCapture("cli steering installed", {
-		files: files.length,
-		failures,
-		agent: typeof argv.agent === "string" ? argv.agent : void 0
-	});
-	if (failures > 0) {
-		process.exit(1);
-		return;
-	}
-	ui.outro("Done. PostHog CLI is installed and your agent will now use `posthog-cli api` for PostHog tasks.");
-	process.exit(0);
-}
-/** Resolve which instruction files to write, from flags, detection, or a prompt. */
-async function resolveTargetFiles(argv) {
-	const ui = getUI();
-	if (typeof argv.path === "string" && argv.path.trim()) return [path$1.resolve(argv.path.trim())];
-	if (typeof argv.agent === "string") {
-		const target = findTarget(argv.agent);
-		if (!target) {
-			ui.log.error(`Unsupported agent: ${argv.agent}`);
-			return [];
-		}
-		return [target.instructionsPath()];
-	}
-	const detected = detectTargets();
-	if (detected.length === 0) {
-		ui.log.error("No supported coding agents detected. Pass --agent <id> or --path <file> to choose a target.");
-		ui.log.info(`Supported agents: ${CLI_STEERING_TARGETS.map((t) => t.id).join(", ")}`);
-		return [];
-	}
-	if (argv.all === true) {
-		ui.log.info(`Installing for all detected agents: ${detected.map((t) => t.name).join(", ")}`);
-		return detected.map((target) => target.instructionsPath());
-	}
-	if (detected.length === 1) {
-		ui.log.info(`Detected ${detected[0].name} (${detected[0].instructionsPath()})`);
-		return [detected[0].instructionsPath()];
-	}
-	if (!process.stdin.isTTY || !process.stdout.isTTY) {
-		ui.log.info(`Installing for all detected agents: ${detected.map((t) => t.name).join(", ")}`);
-		return detected.map((target) => target.instructionsPath());
-	}
-	return (await promptForTargets(detected)).map((target) => target.instructionsPath());
-}
-/** Minimal numbered selection — this command is intentionally not a TUI flow. */
-async function promptForTargets(detected) {
-	const ui = getUI();
-	ui.log.info("Which coding agent are you using?");
-	detected.forEach((target, index) => {
-		ui.log.info(`  ${index + 1}) ${target.name} (${target.instructionsPath()})`);
-	});
-	ui.log.info(`  ${detected.length + 1}) All of the above`);
-	const rl = readline.createInterface({
-		input: process.stdin,
-		output: process.stdout
-	});
-	try {
-		for (;;) {
-			const answer = (await rl.question(`Select 1-${detected.length + 1}: `)).trim();
-			const choice = Number(answer);
-			if (Number.isInteger(choice) && choice >= 1 && choice <= detected.length) return [detected[choice - 1]];
-			if (choice === detected.length + 1) return detected;
-			ui.log.warn(`Enter a number between 1 and ${detected.length + 1}.`);
-		}
-	} finally {
-		rl.close();
-	}
+//#region src/cli/index.ts
+/** The CLI's one entry: `main.ts` runs the `wizard` command line through it. */
+/** Register every command and run the one `process.argv` names. */
+function runCli() {
+	Wizard.use(basicIntegrationCommand).use(mcpCommand).use(mcpAnalyticsCommand).use(replayVisionCommand).use(aiObservabilityCommand).use(metricsCommand).use(cliCommand).use(auditCommand).use(doctorCommand).use(migrateCommand).use(revenueCommand).use(warehouseCommand).use(selfDrivingCommand).use(slackCommand).use(uploadSourcemapsCommand).use(errorTrackingCommand).use(skillCommand).init();
 }
 //#endregion
-//#region src/commands/cli/index.ts
-const cliCommand = {
-	name: "cli",
-	description: "PostHog CLI agent integration commands",
-	children: [cliAddCommand]
-};
-//#endregion
 //#region main.ts
 setGlobalDispatcher(new Agent({ allowH2: false }));
 recoverOrphanedSettingsBackups(resolveInstallDir());
@@ -1389,8 +1132,8 @@ function resolveInstallDir() {
 	if (inline) return inline.slice(14);
 	return process.env.POSTHOG_WIZARD_INSTALL_DIR ?? process.cwd();
 }
-Wizard.use(basicIntegrationCommand).use(mcpCommand).use(mcpAnalyticsCommand).use(replayVisionCommand).use(aiObservabilityCommand).use(metricsCommand).use(cliCommand).use(auditCommand).use(doctorCommand).use(migrateCommand).use(revenueCommand).use(warehouseCommand).use(selfDrivingCommand).use(slackCommand).use(uploadSourcemapsCommand).use(errorTrackingCommand).use(skillCommand).init();
+runCli();
 //#endregion
 export {};
 
-//# sourceMappingURL=main-CgKxbwMP.js.map
+//# sourceMappingURL=main-0p-YxUNa.js.map