@posthog/wizard 2.23.0 → 2.24.0

package/dist/bin.js

@@ -1,16 +1,16 @@
 #!/usr/bin/env node
-import { $ as VERSION, P as POSTHOG_DOCS_URL, Y as WIZARD_USER_AGENT, _ as SIGNUP_WIZARD_READINESS_CONFIG, a as getLogFilePath, h as LoggingUI, m as setUI, p as getUI, s as logToFile, v as evaluateWizardReadiness, y as getBlockingServiceKeys } from "./debug-CgT5MmVB.js";
-import { t as analytics } from "./analytics-9D4eGgmT.js";
-import { r as setEntryCommand } from "./telemetry-5rkeTd2_.js";
-import { n as isUsingTypeScript, t as getOrAskForProjectData } from "./setup-utils-Dwgkk8AQ.js";
-import { a as getUiHostFromHost, n as getCloudUrlFromRegion } from "./urls-Cb4SI9kf.js";
-import { o as handleApiError } from "./api-Dwd0B-E9.js";
+import { $ as VERSION, P as POSTHOG_DOCS_URL, Q as getSkillsBaseUrl, Y as WIZARD_USER_AGENT, _ as SIGNUP_WIZARD_READINESS_CONFIG, a as getLogFilePath, h as LoggingUI, m as setUI, p as getUI, s as logToFile, v as evaluateWizardReadiness, y as getBlockingServiceKeys } from "./debug-BUdVZP84.js";
+import { t as analytics } from "./analytics-BOWrR4qd.js";
+import { r as setEntryCommand } from "./telemetry-8zMpaIuK.js";
+import { n as isUsingTypeScript, t as getOrAskForProjectData } from "./setup-utils-Doh69vo4.js";
+import { a as getUiHostFromHost, n as getCloudUrlFromRegion } from "./urls-BUfvQmU4.js";
+import { o as handleApiError } from "./api-RXTR8yZo.js";
 import "./wizard-session-G3VWD6hv.js";
-import { r as runCleanups } from "./wizard-abort-DovHQa-j.js";
-import { n as isNonInteractiveEnvironment } from "./environment-CI2pTYTG.js";
-import { _ as AUDIT_CHECKS_KEY, f as WIZARD_TOOL_NAMES, g as AUDIT_CHECKS_FILE, l as AgentSignals, s as recoverOrphanedSettingsBackups, v as AUDIT_REPORT_FILE } from "./agent-interface-DjMPlXl0.js";
-import { i as SPINNER_MESSAGE } from "./registry-CD_DplSQ.js";
-import { a as PRODUCT_SUITE_BLOCK, f as Colors, i as LINE_CHART_BLOCK, l as isClearBlock, m as HEALTH_CHECK_STEP, n as posthogIntegrationConfig, o as StatusPeekTrigger, r as FUNNEL_BLOCK } from "./posthog-integration-BWbZU9Xq.js";
+import { r as runCleanups } from "./wizard-abort-BdGW4Tvi.js";
+import { n as isNonInteractiveEnvironment } from "./environment-G0Hv6_JI.js";
+import { _ as AUDIT_CHECKS_KEY, f as WIZARD_TOOL_NAMES, g as AUDIT_CHECKS_FILE, l as AgentSignals, m as fetchSkillMenu, s as recoverOrphanedSettingsBackups, v as AUDIT_REPORT_FILE } from "./agent-interface-CysYcZl5.js";
+import { i as SPINNER_MESSAGE } from "./registry-CEnQVctL.js";
+import { a as PRODUCT_SUITE_BLOCK, f as Colors, i as LINE_CHART_BLOCK, l as isClearBlock, m as HEALTH_CHECK_STEP, n as posthogIntegrationConfig, o as StatusPeekTrigger, p as Icons, r as FUNNEL_BLOCK } from "./posthog-integration-Bz3HWkHn.js";
 import { t as IGNORED_DIRS } from "./file-utils-VAXoyXVA.js";
 import { n as readApiKeyFromEnv } from "./env-api-key-MlzJYAvt.js";
 import { satisfies } from "semver";
@@ -20,7 +20,8 @@ import fs, { existsSync, readFileSync, readdirSync, statSync } from "fs";
 import path, { join, relative } from "path";
 import axios from "axios";
 import { z } from "zod";
-import { Text } from "ink";
+import { Box, Text, render, useInput } from "ink";
+import { createContext, createElement, useCallback, useContext, useEffect, useRef, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region src/commands/command.ts
 /** Extract the bare command word(s) from a yargs name spec, dropping positionals and aliases' arg syntax. */
@@ -34,16 +35,17 @@ function toCommandModule(cmd, parentPath) {
 		describe: cmd.description,
 		builder: (y) => {
 			let next = cmd.options ? y.options(cmd.options) : y;
+			for (const [key, opts] of Object.entries(cmd.positionals ?? {})) next = next.positional(key, opts);
 			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);
+			if (cmd.children?.length && !cmd.handler && !cmd.interactiveDefault) next = next.demandCommand(1);
 			return next;
 		},
 		handler: (argv) => {
 			if (entryCommand) setEntryCommand(entryCommand);
-			cmd.handler?.(argv);
+			(cmd.handler ?? cmd.interactiveDefault ?? (() => void 0))(argv);
 		}
 	};
 }
@@ -52,6 +54,10 @@ function toCommandModule(cmd, parentPath) {
 /**
 * Global yargs options applied to every command. These are read from the
 * `POSTHOG_WIZARD` env prefix as well as flags.
+*
+* Options with `hidden: true` are "internal modes" — they don't show up in
+* `--help` but are still accepted on every command. The catalog of internal
+* flags and what each one does lives in CONTRIBUTING.md.
 */
 const GLOBAL_OPTIONS = {
 	debug: {
@@ -69,11 +75,6 @@ const GLOBAL_OPTIONS = {
 		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",
@@ -90,16 +91,33 @@ const GLOBAL_OPTIONS = {
 	email: {
 		describe: "Email address for signup (used with --signup)\nenv: POSTHOG_WIZARD_EMAIL",
 		type: "string"
+	},
+	"local-mcp": {
+		default: false,
+		describe: "Use local MCP server at http://localhost:8787/mcp\nenv: POSTHOG_WIZARD_LOCAL_MCP",
+		type: "boolean",
+		hidden: true
+	},
+	benchmark: {
+		default: false,
+		describe: "Run in benchmark mode with per-phase token tracking\nenv: POSTHOG_WIZARD_BENCHMARK",
+		type: "boolean",
+		hidden: true
+	},
+	"yara-report": {
+		default: false,
+		describe: "Print YARA scanner summary after the agent run\nenv: POSTHOG_WIZARD_YARA_REPORT",
+		type: "boolean",
+		hidden: true
 	}
 };
 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) => {
+		this.cli = cli.strictOptions().strictCommands().fail((msg, err) => {
 			const text = msg || err && err.message || "Invalid arguments";
-			process.stderr.write(`\n\x1b[1;91m✖ ${text}\x1b[0m\n\n`);
-			parser.showHelp();
+			process.stderr.write(`\n\x1b[1;91m✖ ${text}\x1b[0m\n  Run \`wizard --help\` to see available commands and options.\n\n`);
 			process.exit(1);
 		}).help().alias("help", "h").version().alias("version", "v");
 	}
@@ -166,7 +184,7 @@ function runProvision(argv) {
 }
 async function provision({ email, region, name, jsonMode }) {
 	try {
-		const { provisionNewAccount } = await import("./provisioning-B30Be2NA.js").then((n) => n.n);
+		const { provisionNewAccount } = await import("./provisioning-CgwvlsIl.js").then((n) => n.n);
 		if (!jsonMode) getUI().log.info(`Provisioning account for ${email} in ${region}...`);
 		emitResult(await provisionNewAccount(email, name, region), jsonMode);
 		process.exit(0);
@@ -212,25 +230,15 @@ const basicIntegrationCommand = {
 			describe: "Directory to install PostHog in\nenv: POSTHOG_WIZARD_INSTALL_DIR",
 			type: "string"
 		},
+		name: {
+			describe: "Name for account creation with --ci --signup\nenv: POSTHOG_WIZARD_NAME",
+			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
-		},
-		name: {
-			describe: "Name for account creation with --ci --signup\nenv: POSTHOG_WIZARD_NAME",
-			type: "string"
 		}
 	},
 	check: (argv) => {
@@ -241,18 +249,18 @@ const basicIntegrationCommand = {
 		setEntryCommand("integrate");
 		(async () => {
 			if (argv.ci) {
-				const { runCIInstall } = await import("./ci-install-DGXCpvKh.js");
+				const { runCIInstall } = await import("./ci-install-BscZ60Ec.js");
 				return runCIInstall(argv);
 			}
 			if (isNonInteractiveEnvironment()) {
-				const { failNonInteractive } = await import("./non-interactive-6hadW20x.js");
+				const { failNonInteractive } = await import("./non-interactive-BfqXlY8R.js");
 				return failNonInteractive();
 			}
 			if (argv.playground) {
-				const { runPlayground } = await import("./playground-z4A5dHPv.js");
+				const { runPlayground } = await import("./playground-4sqLVVJL.js");
 				return runPlayground();
 			}
-			const { runInteractive } = await import("./interactive-D52p_opJ.js");
+			const { runInteractive } = await import("./interactive-fh2iyewb.js");
 			runInteractive(argv);
 		})();
 	}
@@ -473,9 +481,10 @@ const getContentBlocks$2 = (store) => {
 //#endregion
 //#region src/lib/programs/revenue-analytics/index.ts
 const revenueAnalyticsConfig = {
-	command: "revenue",
+	command: "revenue-analytics",
 	description: "Set up PostHog revenue analytics (e.g. Stripe integration)",
 	id: "revenue-analytics-setup",
+	skillId: "revenue-analytics-setup",
 	steps: REVENUE_ANALYTICS_PROGRAM,
 	getContentBlocks: getContentBlocks$2,
 	allowedTools: ["Agent"],
@@ -678,7 +687,7 @@ const withAuditScreens = (steps) => steps.map((step) => {
 	} : step;
 });
 const auditSteps = withAuditScreens(AGENT_SKILL_STEPS);
-const baseConfig$1 = createSkillProgram({
+const baseConfig = createSkillProgram({
 	skillId: "audit",
 	command: "audit",
 	id: "audit",
@@ -695,8 +704,8 @@ const baseConfig$1 = createSkillProgram({
 });
 const auditRun = async (session) => {
 	seedBeforeAuditRun(session);
-	if (!baseConfig$1.run) throw new Error("Audit program has no run configuration.");
-	const baseRun = typeof baseConfig$1.run === "function" ? await baseConfig$1.run(session) : baseConfig$1.run;
+	if (!baseConfig.run) throw new Error("Audit program has no run configuration.");
+	const baseRun = typeof baseConfig.run === "function" ? await baseConfig.run(session) : baseConfig.run;
 	return {
 		...baseRun,
 		buildOutroData: (sess, _credentials, cloudRegion) => {
@@ -715,7 +724,7 @@ const auditRun = async (session) => {
 	};
 };
 const auditConfig = {
-	...baseConfig$1,
+	...baseConfig,
 	steps: auditSteps,
 	run: auditRun,
 	allowedTools: ["Agent"],
@@ -882,207 +891,6 @@ Project context:
 	}
 };
 //#endregion
-//#region src/lib/programs/audit-3000/index.ts
-const AUDIT3000_REPORT_FILE = "posthog-audit-3000-report.md";
-const AUDIT3000_EXTRA_CHECKS = [
-	{
-		id: "event-naming-standardization",
-		area: "Event Quality",
-		label: "Event naming convention is consistent",
-		status: "pending"
-	},
-	{
-		id: "event-duplicates-and-bloat",
-		area: "Event Quality",
-		label: "No duplicate or bloated event capture",
-		status: "pending"
-	},
-	{
-		id: "event-quality-context-review",
-		area: "Event Quality",
-		label: "Event property context reviewed",
-		status: "pending"
-	},
-	{
-		id: "event-usage-coverage",
-		area: "Event Quality",
-		label: "Captured events match insights / dashboards usage",
-		status: "pending"
-	},
-	{
-		id: "stale-feature-flags-reviewed",
-		area: "Feature Flags",
-		label: "Stale feature flags reviewed",
-		status: "pending"
-	},
-	{
-		id: "replay-minimum-duration-set",
-		area: "Session Replay",
-		label: "Minimum duration set on init",
-		status: "pending"
-	},
-	{
-		id: "replay-mask-config",
-		area: "Session Replay",
-		label: "Mask config covers sensitive surfaces",
-		status: "pending"
-	},
-	{
-		id: "replay-disabled-in-test-envs",
-		area: "Session Replay",
-		label: "Disabled in test / CI environments",
-		status: "pending"
-	},
-	{
-		id: "replay-strict-minimum-duration",
-		area: "Session Replay",
-		label: "Strict minimum duration enforced",
-		status: "pending"
-	},
-	{
-		id: "replay-sampling-rate",
-		area: "Session Replay — Optimize",
-		label: "Sampling rate tuned for cost",
-		status: "pending"
-	},
-	{
-		id: "replay-triggers-configured",
-		area: "Session Replay — Optimize",
-		label: "Triggers configured (event / URL / flag)",
-		status: "pending"
-	},
-	{
-		id: "replay-network-recording-filtered",
-		area: "Session Replay — Optimize",
-		label: "Network recording filtered",
-		status: "pending"
-	},
-	{
-		id: "replay-mobile-sampling",
-		area: "Session Replay — Optimize",
-		label: "Mobile sampling configured",
-		status: "pending"
-	},
-	{
-		id: "expansion-product-analytics",
-		area: "Use Case: Expansion",
-		label: "Product analytics coverage",
-		status: "pending"
-	},
-	{
-		id: "expansion-error-tracking",
-		area: "Use Case: Expansion",
-		label: "Error tracking coverage",
-		status: "pending"
-	},
-	{
-		id: "expansion-llm-observability",
-		area: "Use Case: Expansion",
-		label: "LLM observability coverage",
-		status: "pending"
-	},
-	{
-		id: "expansion-session-replay",
-		area: "Use Case: Expansion",
-		label: "Session replay coverage",
-		status: "pending"
-	},
-	{
-		id: "expansion-feature-flags",
-		area: "Use Case: Expansion",
-		label: "Feature flags coverage",
-		status: "pending"
-	},
-	{
-		id: "expansion-surveys",
-		area: "Use Case: Expansion",
-		label: "Surveys coverage",
-		status: "pending"
-	},
-	{
-		id: "expansion-logs",
-		area: "Use Case: Expansion",
-		label: "Logs coverage",
-		status: "pending"
-	},
-	{
-		id: "expansion-web-analytics",
-		area: "Use Case: Expansion",
-		label: "Web analytics coverage",
-		status: "pending"
-	},
-	{
-		id: "customer-enrichment",
-		area: "Additional Sections",
-		label: "Customer enrichment (Harmonic + PDL)",
-		status: "pending"
-	},
-	{
-		id: "use-case-match",
-		area: "Additional Sections",
-		label: "Use-case match",
-		status: "pending"
-	},
-	{
-		id: "final-report",
-		area: "Additional Sections",
-		label: "Final audit report written",
-		status: "pending"
-	}
-];
-const AUDIT3000_SEED_CHECKS = [...AUDIT_SEED_CHECKS, ...AUDIT3000_EXTRA_CHECKS];
-const AUDIT3000_SCREEN_BY_STEP = {
-	intro: "audit-3000-intro",
-	run: "audit-3000-run",
-	outro: "audit-3000-outro"
-};
-const seedAudit3000Ledger = (installDir) => {
-	const target = path.join(installDir, AUDIT_CHECKS_FILE);
-	const tmp = `${target}.tmp`;
-	fs.writeFileSync(tmp, JSON.stringify(AUDIT3000_SEED_CHECKS, null, 2), "utf8");
-	fs.renameSync(tmp, target);
-	logToFile(`seedAudit3000Ledger: wrote ${AUDIT3000_SEED_CHECKS.length} entries to ${target}`);
-};
-const seedBeforeAudit3000Run = (session) => {
-	seedAudit3000Ledger(session.installDir);
-	session.frameworkContext[AUDIT_CHECKS_KEY] = AUDIT3000_SEED_CHECKS;
-};
-const withAudit3000Screens = (steps) => steps.map((step) => {
-	const override = AUDIT3000_SCREEN_BY_STEP[step.id];
-	return override ? {
-		...step,
-		screenId: override
-	} : step;
-});
-const audit3000Steps = withAudit3000Screens(AGENT_SKILL_STEPS);
-const baseConfig = createSkillProgram({
-	skillId: "audit-3000",
-	command: "audit-3000",
-	id: "audit-3000",
-	description: "Audit an existing PostHog integration (v3000 — adds event quality, stale-flag hygiene, customer enrichment, use-case match)",
-	integrationLabel: "audit-3000",
-	customPrompt: "Run the audit-3000 skill end-to-end. Follow the step chain starting at references/1-version.md. Do not modify any project files — only create the final audit report and (when enrichment is enabled) the enrichment report.",
-	successMessage: `Audit complete! View the report at ./${AUDIT3000_REPORT_FILE}`,
-	reportFile: AUDIT3000_REPORT_FILE,
-	docsUrl: "https://posthog.com/docs/product-analytics/best-practices",
-	spinnerMessage: "Running PostHog Audit 3000...",
-	estimatedDurationMinutes: 6,
-	requires: ["posthog-integration"],
-	abortCases: AUDIT_ABORT_CASES
-});
-const audit3000Run = async (session) => {
-	seedBeforeAudit3000Run(session);
-	if (!baseConfig.run) throw new Error("audit-3000 program has no run configuration.");
-	return typeof baseConfig.run === "function" ? baseConfig.run(session) : baseConfig.run;
-};
-const audit3000Config = {
-	...baseConfig,
-	steps: audit3000Steps,
-	run: audit3000Run,
-	allowedTools: ["Agent"],
-	disallowedTools: [WIZARD_TOOL_NAMES.wizardAsk]
-};
-//#endregion
 //#region src/lib/programs/posthog-doctor/steps.ts
 const POSTHOG_DOCTOR_PROGRAM = [
 	{
@@ -1845,32 +1653,19 @@ const MIGRATION_ABORT_CASES = [{
 	message: "No source-SDK calls found",
 	body: "The migration needs an existing third-party SDK to migrate from. No calls to the source SDK appear anywhere in this project. If you haven't installed PostHog yet, you don't need this command — run `npx @posthog/wizard@latest` to add PostHog from scratch."
 }];
-/**
-* Map each `--product=<id>` choice to the context-mill skill ID that handles
-* it. Adding a variant: drop a new row here. The CLI `choices` and the
-* runtime lookup both read from this map, so the two stay in sync.
-*/
-const PRODUCT_TO_SKILL_ID = { statsig: "migrate-statsig" };
-const MIGRATE_PRODUCTS = Object.keys(PRODUCT_TO_SKILL_ID);
+const DEFAULT_MIGRATE_SKILL_ID = "migrate-statsig";
 const migrationConfig = {
 	command: "migrate",
 	description: "Migrate to PostHog from another analytics provider",
 	id: "migration",
-	skillId: PRODUCT_TO_SKILL_ID.statsig,
+	skillId: DEFAULT_MIGRATE_SKILL_ID,
 	steps: MIGRATION_PROGRAM,
 	reportFile: MIGRATION_REPORT_FILE,
 	getContentBlocks: getContentBlocks$1,
 	allowedTools: ["Agent"],
 	disallowedTools: [WIZARD_TOOL_NAMES.wizardAsk],
-	cliOptions: { product: {
-		describe: "Source SDK to migrate from",
-		type: "string",
-		choices: MIGRATE_PRODUCTS,
-		demandOption: true
-	} },
-	mapCliOptions: (argv) => ({ skillId: PRODUCT_TO_SKILL_ID[argv.product] }),
 	run: {
-		skillId: PRODUCT_TO_SKILL_ID.statsig,
+		skillId: DEFAULT_MIGRATE_SKILL_ID,
 		integrationLabel: "migration",
 		customPrompt: () => `Migrate this project from its existing third-party analytics, feature-flag, and observability tools to PostHog. Run the \`migrate\` skill end-to-end: follow the step chain starting at references/1-presence.md. Only replace existing source-SDK call sites with PostHog equivalents — make zero unrelated changes and no net-new instrumentation. The final report is written to ./${MIGRATION_REPORT_FILE}.`,
 		successMessage: `Migration complete! View the report at ./${MIGRATION_REPORT_FILE}`,
@@ -2796,7 +2591,19 @@ const agentSkillConfig = {
 	description: "Run an arbitrary context-mill skill",
 	steps: AGENT_SKILL_STEPS,
 	getContentBlocks: getContentBlocks$2,
-	allowedTools: ["Agent"]
+	allowedTools: ["Agent"],
+	run: (session) => {
+		const skillId = session.skillId ?? "agent-skill";
+		return Promise.resolve({
+			skillId,
+			integrationLabel: skillId,
+			spinnerMessage: `Running ${skillId}...`,
+			successMessage: `${skillId} complete!`,
+			estimatedDurationMinutes: 5,
+			reportFile: `posthog-${skillId}-report.md`,
+			docsUrl: POSTHOG_DOCS_URL
+		});
+	}
 };
 const PROGRAM_REGISTRY = [
 	posthogIntegrationConfig,
@@ -2804,7 +2611,6 @@ const PROGRAM_REGISTRY = [
 	errorTrackingUploadSourceMapsConfig,
 	auditConfig,
 	eventsAuditConfig,
-	audit3000Config,
 	posthogDoctorConfig,
 	webAnalyticsDoctorConfig,
 	migrationConfig,
@@ -2826,7 +2632,6 @@ const Program = {
 	Migration: migrationConfig.id,
 	Audit: auditConfig.id,
 	EventsAudit: eventsAuditConfig.id,
-	Audit3000: audit3000Config.id,
 	PosthogDoctor: posthogDoctorConfig.id,
 	WebAnalyticsDoctor: webAnalyticsDoctorConfig.id,
 	AgentSkill: agentSkillConfig.id,
@@ -2873,7 +2678,7 @@ function runMcpAdd(argv) {
 		const debug = argv.debug;
 		const localMcp = argv.local;
 		try {
-			const { startTUI } = await import("./start-tui-SLeEzlJs.js");
+			const { startTUI } = await import("./start-tui-CywbSvZE.js");
 			const { buildSession } = await import("./wizard-session-wPJtNl4c.js");
 			const tui = startTUI(VERSION, Program.McpAdd);
 			tui.store.session = buildSession({
@@ -2885,7 +2690,7 @@ function runMcpAdd(argv) {
 		} catch (error) {
 			if (!isTUIUnavailable(error)) throw error;
 			setUI(new LoggingUI());
-			const { addMCPServerToClientsStep } = await import("./add-mcp-server-to-clients-BEziI3z9.js").then((n) => n.r);
+			const { addMCPServerToClientsStep } = await import("./add-mcp-server-to-clients-BU8Owthq.js").then((n) => n.r);
 			await addMCPServerToClientsStep({
 				local: localMcp,
 				features,
@@ -2924,7 +2729,7 @@ function runMcpRemove(argv) {
 		const debug = argv.debug;
 		const localMcp = argv.local;
 		try {
-			const { startTUI } = await import("./start-tui-SLeEzlJs.js");
+			const { startTUI } = await import("./start-tui-CywbSvZE.js");
 			const { buildSession } = await import("./wizard-session-wPJtNl4c.js");
 			const tui = startTUI(VERSION, Program.McpRemove);
 			tui.store.session = buildSession({
@@ -2933,7 +2738,7 @@ function runMcpRemove(argv) {
 			});
 		} catch {
 			setUI(new LoggingUI());
-			const { removeMCPServerFromClientsStep } = await import("./add-mcp-server-to-clients-BEziI3z9.js").then((n) => n.r);
+			const { removeMCPServerFromClientsStep } = await import("./add-mcp-server-to-clients-BU8Owthq.js").then((n) => n.r);
 			await removeMCPServerFromClientsStep({ local: localMcp });
 		}
 	})();
@@ -2955,7 +2760,7 @@ function runMcpTutorial(argv) {
 		const debug = argv.debug;
 		const localMcp = argv.local;
 		try {
-			const { startTUI } = await import("./start-tui-SLeEzlJs.js");
+			const { startTUI } = await import("./start-tui-CywbSvZE.js");
 			const { buildSession } = await import("./wizard-session-wPJtNl4c.js");
 			const tui = startTUI(VERSION, Program.McpTutorial);
 			tui.store.session = buildSession({
@@ -3010,7 +2815,7 @@ function runWizard(config, options) {
 	(async () => {
 		try {
 			const installDir = options.installDir || process.cwd();
-			const { startTUI } = await import("./start-tui-SLeEzlJs.js");
+			const { startTUI } = await import("./start-tui-CywbSvZE.js");
 			const { buildSession, RunPhase } = await import("./wizard-session-wPJtNl4c.js");
 			const { TaskStreamPush } = await import("./task-stream-CZawuzlz.js");
 			const { PostHogDestination } = await import("./posthog-Cr37rnla.js");
@@ -3066,7 +2871,7 @@ function runWizard(config, options) {
 			await activeTui.store.getGate("health-check");
 			const skipAgent = config.run == null;
 			if (skipAgent) {
-				const { getOrAskForProjectData } = await import("./setup-utils-Dwgkk8AQ.js").then((n) => n.r);
+				const { getOrAskForProjectData } = await import("./setup-utils-Doh69vo4.js").then((n) => n.r);
 				const { projectApiKey, host, accessToken, projectId } = await getOrAskForProjectData({
 					signup: session.signup,
 					ci: session.ci,
@@ -3081,7 +2886,7 @@ function runWizard(config, options) {
 					projectId
 				});
 			} else {
-				const { runAgent } = await import("./agent-runner-Bv-7z-pQ.js");
+				const { runAgent } = await import("./agent-runner-Br0OxBxd.js");
 				await runAgent(config, activeTui.store.session);
 			}
 			const isDone = () => skipAgent ? activeTui.store.session.outroDismissed : activeTui.store.session.skillsComplete;
@@ -3158,10 +2963,10 @@ function runWizardCI(config, options) {
 	(async () => {
 		const path = await import("path");
 		const { buildSession } = await import("./wizard-session-wPJtNl4c.js");
-		const { readEnvironment } = await import("./environment-CI2pTYTG.js").then((n) => n.t);
+		const { readEnvironment } = await import("./environment-G0Hv6_JI.js").then((n) => n.t);
 		const { readApiKeyFromEnv } = await import("./env-api-key-MlzJYAvt.js").then((n) => n.t);
-		const { configureLogFileFromEnvironment, logToFile } = await import("./debug-DayHBBST.js");
-		const { wizardAbort, WizardError } = await import("./wizard-abort-DW2-ZjiS.js");
+		const { configureLogFileFromEnvironment, logToFile } = await import("./debug-BgH07S-e.js");
+		const { wizardAbort, WizardError } = await import("./wizard-abort-Ni-mKJ58.js");
 		configureLogFileFromEnvironment();
 		const env = readEnvironment();
 		const apiKey = options.apiKey ?? readApiKeyFromEnv() ?? void 0;
@@ -3212,7 +3017,7 @@ function runWizardCI(config, options) {
 					})
 				});
 			}
-			const { runAgent } = await import("./agent-runner-Bv-7z-pQ.js");
+			const { runAgent } = await import("./agent-runner-Br0OxBxd.js");
 			await runAgent(config, session);
 		} catch (error) {
 			const errorMessage = error instanceof Error ? error.message : String(error);
@@ -3231,107 +3036,732 @@ function runWizardCI(config, options) {
 }
 //#endregion
 //#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);
-	}
-};
+/**
+* Per-command options shared by every skill-based program command
+* (`audit events`, `migrate statsig`, `revenue`, `source-maps`, …).
+*
+* Only flags that are unique to skill commands live here. Global flags
+* (`--debug`, `--local-mcp`, `--benchmark`, `--yara-report`, `--ci`) are
+* declared once in `wizard.ts::GLOBAL_OPTIONS` and apply automatically
+* across every command — no need to repeat them per subcommand.
+*/
+const skillProgramOptions = { "install-dir": {
+	describe: "Directory to install in",
+	type: "string"
+} };
 //#endregion
-//#region src/commands/audit.ts
-const dispatchProgram = (config, argv) => {
-	const extras = config.mapCliOptions?.(argv) ?? {};
+//#region src/commands/factories/shared.ts
+/**
+* Dispatch a parsed yargs invocation to the wizard runner. Applies the
+* program's `mapCliOptions` transform, then routes to `runWizard` or
+* `runWizardCI` based on the `--ci` flag.
+*
+* Every command file used to inline this; the factories call it instead.
+*/
+/**
+* Run a command's async body as fire-and-forget while still surfacing failures.
+* yargs handlers are synchronous, so async work kicks off a detached promise —
+* without this, a rejection becomes an unhandled promise rejection (no message,
+* wrong exit code). This awaits the work and turns any error into a clean
+* message + non-zero exit.
+*/
+function runCommandHandler(work) {
+	(async () => {
+		try {
+			await work();
+		} catch (err) {
+			const msg = err instanceof Error ? err.message : String(err);
+			process.stderr.write(`\n\x1b[1;91m✖ ${msg}\x1b[0m\n\n`);
+			process.exit(1);
+		}
+	})();
+}
+function dispatchProgram(config, argv) {
+	const argvRecord = argv;
+	const extras = config.mapCliOptions?.(argvRecord) ?? {};
 	const options = {
-		...argv,
+		...argvRecord,
 		...extras
 	};
 	if (options.ci) runWizardCI(config, options);
 	else runWizard(config, options);
-};
-const webAnalyticsCommand = {
-	name: webAnalyticsDoctorConfig.command,
-	description: webAnalyticsDoctorConfig.description,
-	options: {
+}
+/**
+* Merge the standard skill-program flags (`--debug`, `--install-dir`, etc.)
+* with any program-specific options declared on `cliOptions`.
+*
+* Program-specific options shadow the standard ones — that's intentional, so
+* a program can override a default flag if it ever needs to.
+*/
+function mergeCommandOptions(config) {
+	return {
 		...skillProgramOptions,
-		...webAnalyticsDoctorConfig.cliOptions ?? {}
-	},
-	handler: (argv) => {
-		dispatchProgram(webAnalyticsDoctorConfig, argv);
+		...config.cliOptions ?? {}
+	};
+}
+//#endregion
+//#region src/lib/programs/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
+* fire a "setup wizard finished" event for a parse error that didn't run.
+*/
+async function exitDispatchError(reason, properties, message, code = 1) {
+	analytics.wizardCapture("cli dispatch error", {
+		reason,
+		...properties
+	});
+	try {
+		await analytics.flush();
+	} catch {}
+	process.stderr.write(message);
+	return process.exit(code);
+}
+/**
+* Family commands (`wizard audit`, `wizard migrate`, ...) resolve their
+* subcommands at runtime against the published `cliEntries` inside
+* `skill-menu.json`. Adding a subcommand is a context-mill release — no
+* wizard release needed.
+*
+* Wizard-native subcommands (programs that aren't backed by a single skill,
+* e.g. `wizard audit web-analytics`) live here in code, dispatched directly
+* without touching the registry. Adding a native is a wizard PR.
+*/
+/** Wizard-native subcommands keyed by family. */
+const NATIVE_HANDLERS = { audit: { "web-analytics": webAnalyticsDoctorConfig } };
+/**
+* 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,
+* content blocks, screens).
+*/
+function configForCliEntry(entry) {
+	if (entry.skillId === "audit") return auditConfig;
+	return {
+		...agentSkillConfig,
+		skillId: entry.skillId
+	};
+}
+function familyEntries(family, entries) {
+	return entries.filter((e) => e.role === "command" && e.parentCommand === family && Boolean(e.command));
+}
+/**
+* Dispatch `wizard <family> <sub>` to the right program.
+*
+* Order:
+*   1. Native handler for (family, sub) — runs immediately, no network.
+*   2. Fetched CliEntry — runs the resolved skill.
+*   3. Unknown — prints the available list and exits non-zero.
+*/
+async function dispatchFamily(family, argv) {
+	const sub = argv.skill?.trim();
+	if (!sub) return exitDispatchError("missing subcommand", { family }, `\n\x1b[1;91m✖ \`wizard ${family}\` requires a subcommand.\x1b[0m\n  Pass one (e.g. \`wizard ${family} <subcommand>\`), or run it in an interactive terminal to pick from a menu.\n\n`);
+	const native = NATIVE_HANDLERS[family]?.[sub];
+	if (native) {
+		dispatchProgram(native, argv);
+		return;
+	}
+	const skillsBaseUrl = getSkillsBaseUrl(Boolean(argv["local-mcp"]));
+	const menu = await fetchSkillMenu(skillsBaseUrl);
+	if (!menu) return exitDispatchError("registry unreachable", {
+		family,
+		sub,
+		skillsBaseUrl
+	}, `\n\x1b[1;91m✖ Couldn't reach the skill registry at ${skillsBaseUrl}.\x1b[0m\n  Check your network connection and try again.\n\n`);
+	const entries = menu.cliEntries ?? [];
+	const entry = familyEntries(family, entries).find((e) => e.command === sub);
+	if (entry) {
+		dispatchProgram(configForCliEntry(entry), argv);
+		return;
 	}
+	const available = [...Object.keys(NATIVE_HANDLERS[family] ?? {}), ...familyEntries(family, entries).map((e) => e.command)].sort();
+	return exitDispatchError("unknown subcommand", {
+		family,
+		sub,
+		available
+	}, `\n\x1b[1;91m✖ Unknown subcommand "${sub}" under \`${family}\`.\x1b[0m\n` + (available.length ? `  Available: ${available.join(", ")}\n\n` : `  No subcommands published for "${family}" yet.\n\n`));
+}
+/**
+* Build the children list shown in the family's interactive picker.
+* Combines native handlers with skill-backed entries from the live registry.
+* Used by `familyCommandFactory`'s `interactiveDefault`.
+*/
+function buildFamilyPickerChildren(family, entries) {
+	const natives = Object.entries(NATIVE_HANDLERS[family] ?? {}).map(([cmd, program]) => ({
+		name: cmd,
+		description: program.description,
+		handler: (argv) => dispatchProgram(program, argv)
+	}));
+	const live = familyEntries(family, entries).map((entry) => ({
+		name: entry.command,
+		description: entry.description,
+		handler: (argv) => {
+			dispatchFamily(family, {
+				...argv,
+				skill: entry.command
+			});
+		},
+		default: entry.default
+	}));
+	return [...natives, ...live];
+}
+/**
+* The children the family picker shows **today**: only the leaf marked
+* `default` (e.g. `audit events`). Every other subcommand stays runnable
+* directly (`wizard audit <name>`) — they just aren't listed in the picker yet.
+* Falls back to all children when nothing is marked `default`.
+*
+* Temporary: when we're ready to surface the full menu, return `children`
+* unchanged (and delete this note).
+*/
+function pickerChildrenToShow(children) {
+	const defaults = children.filter((c) => c.default);
+	return defaults.length > 0 ? [...defaults] : [...children];
+}
+//#endregion
+//#region src/ui/tui/primitives/PromptLabel.tsx
+/**
+* PromptLabel — Compact inline label for input prompts.
+*
+* Renders: [!] message
+* where [!] is black text on accent background.
+*/
+const PromptLabel = ({ message }) => {
+	return /* @__PURE__ */ jsx(Box, { children: /* @__PURE__ */ jsxs(Text, {
+		bold: true,
+		color: Colors.accent,
+		children: [" ", message]
+	}) });
 };
-const auditCommand = {
-	name: "audit",
-	description: auditConfig.description,
-	children: [webAnalyticsCommand],
-	options: {
-		...skillProgramOptions,
-		...auditConfig.cliOptions ?? {}
-	},
-	handler: (argv) => {
-		dispatchProgram(auditConfig, argv);
+//#endregion
+//#region src/ui/tui/hooks/keyboard-hints-utils.ts
+/** Default priorities by key type. */
+const DEFAULT_PRIORITY = {
+	["upArrow"]: 0,
+	["downArrow"]: 0,
+	["leftArrow"]: 1,
+	["rightArrow"]: 1,
+	["space"]: 10,
+	["escape"]: 20,
+	["return"]: 21
+};
+/** Get the default display priority for a key match. */
+function getDefaultPriority(match) {
+	return DEFAULT_PRIORITY[Array.isArray(match) ? match[0] : match] ?? 15;
+}
+/** Check if a KeyMatchOrChar matches the given input string and key flags. */
+function matchesKey(m, input, key) {
+	switch (m) {
+		case "upArrow": return !!key.upArrow;
+		case "downArrow": return !!key.downArrow;
+		case "leftArrow": return !!key.leftArrow;
+		case "rightArrow": return !!key.rightArrow;
+		case "return": return !!key.return;
+		case "escape": return !!key.escape;
+		case "space": return input === " ";
+		default: return input === m;
+	}
+}
+/** Serialize hints for comparison. */
+function hintsKey(hints) {
+	return hints.map((h) => `${h.label}:${h.action}`).join("|");
+}
+/** Deduplicate hints by label+action and sort by priority. */
+function deduplicateAndSort(hints) {
+	const seen = /* @__PURE__ */ new Set();
+	const deduped = [];
+	for (const hint of hints) {
+		const k = `${hint.label}:${hint.action}`;
+		if (!seen.has(k)) {
+			seen.add(k);
+			deduped.push(hint);
+		}
 	}
+	deduped.sort((a, b) => a.priority - b.priority);
+	return deduped;
+}
+//#endregion
+//#region src/ui/tui/hooks/useKeyboardHints.tsx
+/**
+* KeyboardHintsProvider — Context for collecting and displaying keyboard hints.
+*
+* Input components register their hints via useKeyBindings. The provider
+* flattens, deduplicates, and sorts them. The hints bar stays visible for as
+* long as a screen has registered hints — it never auto-dismisses.
+*/
+const KeyboardHintsContext = createContext({
+	register: () => void 0,
+	unregister: () => void 0,
+	hints: []
+});
+const useKeyboardHintsContext = () => useContext(KeyboardHintsContext);
+const KeyboardHintsProvider = ({ children }) => {
+	const registrationsRef = useRef(/* @__PURE__ */ new Map());
+	const [hints, setHints] = useState([]);
+	const prevHintsKeyRef = useRef("");
+	const recompute = useCallback(() => {
+		const all = [];
+		for (const h of registrationsRef.current.values()) all.push(...h);
+		const deduped = deduplicateAndSort(all);
+		const newKey = hintsKey(deduped);
+		if (newKey !== prevHintsKeyRef.current) {
+			prevHintsKeyRef.current = newKey;
+			setHints(deduped);
+		}
+	}, []);
+	const register = useCallback((id, h) => {
+		registrationsRef.current.set(id, h);
+		recompute();
+	}, [recompute]);
+	const unregister = useCallback((id) => {
+		registrationsRef.current.delete(id);
+		recompute();
+	}, [recompute]);
+	return /* @__PURE__ */ jsx(KeyboardHintsContext.Provider, {
+		value: {
+			register,
+			unregister,
+			hints
+		},
+		children
+	});
 };
 //#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);
+//#region src/ui/tui/hooks/useKeyBindings.ts
+/**
+* useKeyBindings — Declarative keyboard input + automatic hint registration.
+*
+* Replaces raw `useInput` in input components. Define bindings as data;
+* the hook wires up the Ink input handler AND registers hints in the
+* KeyboardHintsProvider. One source of truth for keys and their labels.
+*/
+/**
+* Declarative key bindings hook. Replaces `useInput` in input components.
+* Registers hints automatically with the KeyboardHintsProvider.
+*
+* @param id Unique identifier for this component's hints registration
+* @param bindings Array of key binding definitions
+*/
+function useKeyBindings(id, bindings) {
+	const ctx = useKeyboardHintsContext();
+	const hintsRef = useRef("");
+	const hints = bindings.map((b) => ({
+		label: b.label,
+		action: b.action,
+		priority: b.priority ?? getDefaultPriority(b.match)
+	}));
+	const serialized = hints.map((h) => `${h.label}:${h.action}:${h.priority}`).join("|");
+	useEffect(() => {
+		if (serialized !== hintsRef.current) {
+			hintsRef.current = serialized;
+			ctx.register(id, hints);
+		}
+		return () => ctx.unregister(id);
+	}, [id, serialized]);
+	useInput((input, key) => {
+		for (const binding of bindings) if ((Array.isArray(binding.match) ? binding.match : [binding.match]).some((m) => matchesKey(m, input, key))) {
+			binding.handler(input, key);
+			return;
+		}
+	});
+}
+//#endregion
+//#region src/ui/tui/primitives/PickerMenu.tsx
+/**
+* PickerMenu — Single and multi select.
+* Single mode: custom renderer with small triangle indicator.
+* Multi mode: checkbox glyphs with space to toggle.
+*
+* Key bindings are declared via useKeyBindings, which auto-registers
+* hints in the KeyboardHintsBar.
+*/
+/**
+* Step through a column's options in `dir`, wrapping, until an enabled
+* option is found. Returns `from` unchanged if the column is entirely
+* disabled.
+*/
+function stepEnabled(options, rows, from, dir) {
+	const colStart = Math.floor(from / rows) * rows;
+	const colLen = Math.min(rows, options.length - colStart);
+	let row = from % rows;
+	for (let i = 0; i < colLen; i++) {
+		row = (row + dir + colLen) % colLen;
+		const idx = colStart + row;
+		if (!options[idx]?.disabled) return idx;
 	}
+	return from;
+}
+/** Index of the first enabled option, for the initial focus. */
+function firstEnabled(options) {
+	const idx = options.findIndex((o) => !o.disabled);
+	return idx === -1 ? 0 : idx;
+}
+const PickerMenu = ({ message, options, mode = "single", centered = false, columns = 1, optionMarginBottom = 0, onSelect }) => {
+	if (mode === "multi") return /* @__PURE__ */ jsx(MultiPickerMenu, {
+		message,
+		options,
+		centered,
+		columns,
+		optionMarginBottom,
+		onSelect
+	});
+	return /* @__PURE__ */ jsx(SinglePickerMenu, {
+		message,
+		options,
+		centered,
+		columns,
+		optionMarginBottom,
+		onSelect
+	});
+};
+/** Custom single-select with triangle indicator and accent highlight. */
+const SinglePickerMenu = ({ message, options, centered = false, columns = 1, optionMarginBottom = 0, onSelect }) => {
+	const [focused, setFocused] = useState(() => firstEnabled(options));
+	const rows = Math.ceil(options.length / columns);
+	useEffect(() => {
+		if (focused >= options.length || options[focused]?.disabled) setFocused(firstEnabled(options));
+	}, [options, focused]);
+	const bindings = [{
+		match: ["upArrow", "downArrow"],
+		label: "↑↓",
+		action: "navigate",
+		handler: (_input, key) => {
+			if (key.upArrow) setFocused(stepEnabled(options, rows, focused, -1));
+			if (key.downArrow) setFocused(stepEnabled(options, rows, focused, 1));
+		}
+	}, {
+		match: "return",
+		label: "enter",
+		action: "select",
+		handler: () => {
+			const selected = options[focused];
+			if (selected && !selected.disabled) onSelect(selected.value);
+		}
+	}];
+	if (columns > 1) bindings.splice(1, 0, {
+		match: ["leftArrow", "rightArrow"],
+		label: "←→",
+		action: "navigate",
+		handler: (_input, key) => {
+			const col = Math.floor(focused / rows);
+			const row = focused % rows;
+			let next = focused;
+			if (key.leftArrow) {
+				const prevCol = col > 0 ? col - 1 : columns - 1;
+				next = Math.min(prevCol * rows + row, options.length - 1);
+			}
+			if (key.rightArrow) {
+				const nextCol = col < columns - 1 ? col + 1 : 0;
+				next = Math.min(nextCol * rows + row, options.length - 1);
+			}
+			if (options[next]?.disabled) next = stepEnabled(options, rows, next, 1);
+			setFocused(next);
+		}
+	});
+	useKeyBindings("single-picker", bindings);
+	const columnArrays = [];
+	for (let c = 0; c < columns; c++) columnArrays.push(options.slice(c * rows, c * rows + rows));
+	return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		alignItems: centered ? "center" : void 0,
+		children: [/* @__PURE__ */ jsx(PromptLabel, { message }), /* @__PURE__ */ jsx(Box, {
+			flexDirection: "row",
+			gap: 4,
+			children: columnArrays.map((colOpts, colIdx) => /* @__PURE__ */ jsx(Box, {
+				flexDirection: "column",
+				children: colOpts.map((opt, rowIdx) => {
+					const flatIdx = colIdx * rows + rowIdx;
+					const isFocused = flatIdx === focused;
+					const label = opt.hint ? `${opt.label} (${opt.hint})` : opt.label;
+					return /* @__PURE__ */ jsxs(Box, {
+						gap: 1,
+						marginBottom: optionMarginBottom,
+						children: [
+							/* @__PURE__ */ jsx(Text, {
+								color: isFocused ? Colors.accent : void 0,
+								dimColor: !isFocused,
+								children: isFocused ? Icons.triangleSmallRight : " "
+							}),
+							opt.icon && /* @__PURE__ */ jsx(Text, {
+								color: opt.icon.color,
+								children: opt.icon.glyph
+							}),
+							/* @__PURE__ */ jsx(Text, {
+								color: opt.disabled ? Colors.muted : isFocused ? Colors.accent : void 0,
+								bold: isFocused && !opt.disabled,
+								dimColor: !isFocused || opt.disabled,
+								children: label
+							})
+						]
+					}, flatIdx);
+				})
+			}, colIdx))
+		})]
+	});
+};
+/** Custom multi-select with checkbox glyphs and accent highlight. */
+const MultiPickerMenu = ({ message, options, centered = false, columns = 1, optionMarginBottom = 0, onSelect }) => {
+	const [focused, setFocused] = useState(() => firstEnabled(options));
+	const [selected, setSelected] = useState(/* @__PURE__ */ new Set());
+	const rows = Math.ceil(options.length / columns);
+	useEffect(() => {
+		if (focused >= options.length || options[focused]?.disabled) setFocused(firstEnabled(options));
+	}, [options, focused]);
+	const bindings = [
+		{
+			match: ["upArrow", "downArrow"],
+			label: "↑↓",
+			action: "navigate",
+			handler: (_input, key) => {
+				if (key.upArrow) setFocused(stepEnabled(options, rows, focused, -1));
+				if (key.downArrow) setFocused(stepEnabled(options, rows, focused, 1));
+			}
+		},
+		{
+			match: "space",
+			label: "space",
+			action: "toggle",
+			handler: () => {
+				if (options[focused]?.disabled) return;
+				setSelected((prev) => {
+					const next = new Set(prev);
+					if (next.has(focused)) {
+						next.delete(focused);
+						return next;
+					}
+					if (options[focused]?.exclusive) return new Set([focused]);
+					for (const i of next) if (options[i]?.exclusive) next.delete(i);
+					next.add(focused);
+					return next;
+				});
+			}
+		},
+		{
+			match: "return",
+			label: "enter",
+			action: "confirm",
+			handler: () => {
+				if (selected.size === 0) {
+					const hovered = options[focused];
+					if (hovered && !hovered.disabled) onSelect(hovered.value);
+				} else onSelect([...selected].sort().map((i) => options[i].value));
+			}
+		}
+	];
+	if (columns > 1) bindings.splice(1, 0, {
+		match: ["leftArrow", "rightArrow"],
+		label: "←→",
+		action: "navigate",
+		handler: (_input, key) => {
+			const col = Math.floor(focused / rows);
+			const row = focused % rows;
+			let next = focused;
+			if (key.leftArrow) {
+				const prevCol = col > 0 ? col - 1 : columns - 1;
+				next = Math.min(prevCol * rows + row, options.length - 1);
+			}
+			if (key.rightArrow) {
+				const nextCol = col < columns - 1 ? col + 1 : 0;
+				next = Math.min(nextCol * rows + row, options.length - 1);
+			}
+			if (options[next]?.disabled) next = stepEnabled(options, rows, next, 1);
+			setFocused(next);
+		}
+	});
+	useKeyBindings("multi-picker", bindings);
+	const columnArrays = [];
+	for (let c = 0; c < columns; c++) columnArrays.push(options.slice(c * rows, c * rows + rows));
+	return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		alignItems: centered ? "center" : void 0,
+		children: [/* @__PURE__ */ jsx(PromptLabel, { message }), /* @__PURE__ */ jsx(Box, {
+			flexDirection: "row",
+			gap: 4,
+			marginLeft: centered ? 0 : 2,
+			marginTop: 1,
+			children: columnArrays.map((colOpts, colIdx) => /* @__PURE__ */ jsx(Box, {
+				flexDirection: "column",
+				children: colOpts.map((opt, rowIdx) => {
+					const flatIdx = colIdx * rows + rowIdx;
+					const isFocused = flatIdx === focused;
+					const isSelected = selected.has(flatIdx);
+					const label = opt.hint ? `${opt.label} (${opt.hint})` : opt.label;
+					const checkbox = isSelected ? Icons.squareFilled : Icons.squareOpen;
+					return /* @__PURE__ */ jsxs(Box, {
+						gap: 1,
+						marginBottom: optionMarginBottom,
+						children: [
+							/* @__PURE__ */ jsx(Text, {
+								color: isSelected ? "white" : Colors.muted,
+								dimColor: !isFocused && !isSelected,
+								children: checkbox
+							}),
+							opt.icon && /* @__PURE__ */ jsx(Text, {
+								color: opt.icon.color,
+								children: opt.icon.glyph
+							}),
+							/* @__PURE__ */ jsx(Text, {
+								color: opt.disabled ? Colors.muted : isFocused ? Colors.accent : void 0,
+								bold: isFocused && !opt.disabled,
+								dimColor: !isFocused || opt.disabled,
+								children: label
+							})
+						]
+					}, flatIdx);
+				})
+			}, colIdx))
+		})]
+	});
 };
 //#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);
+		}
+	}));
+}
+function describe(child) {
+	return commandKeys(child.name)[0] ?? "";
+}
+/**
+* Reorder children so the `default`-marked entry is first, while
+* preserving the relative order of the rest. The picker's initial
+* focus is index 0, so this is what makes "press Enter on
+* `wizard audit`" run the default leaf (today `audit events`).
+*
+* Exported for testability — the ordering logic stays pure and
+* inspectable without mounting Ink.
+*/
+function orderFamilyChildren(children) {
+	const selectable = children.filter((c) => c.handler || c.children?.length);
+	const defaults = selectable.filter((c) => c.default);
+	const rest = selectable.filter((c) => !c.default);
+	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`).
+*/
+function chooseFamilyChild(parentLabel, children) {
+	const ordered = orderFamilyChildren(children);
+	if (ordered.length === 0) return Promise.resolve(null);
+	const options = 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
+* invocation. Always opens the picker; the `default`-marked child is
+* shown first (pre-highlighted), so a single Enter keystroke runs it.
+*
+* Discovery + consent in one extra keystroke vs. auto-running silently.
+*
+* Wire onto a family parent:
+*   export const auditCommand: Command = {
+*     name: 'audit',
+*     description: '...',
+*     children: [...],
+*     interactiveDefault: createFamilyPickerDefault('audit', auditChildren),
+*   };
+*/
+function createFamilyPickerDefault(parentLabel, children, chooser = chooseFamilyChild) {
+	return async (argv) => {
+		const chosen = await chooser(parentLabel, children);
+		if (!chosen) return;
+		await Promise.resolve(chosen.handler?.(argv));
+	};
+}
+//#endregion
+//#region src/commands/factories/family-command-factory.ts
+/**
+* Build a yargs `Command` for a family parent (`wizard audit`, etc.).
+*
+*   - `wizard <family> <sub>` — `dispatchFamily` resolves `<sub>` against
+*     native handlers first, then the live `cliEntries` from
+*     `skill-menu.json`. Unknown subs error with the available list.
+*   - `wizard <family>` (no positional) — in an interactive terminal, runs the
+*     family's single shown entry directly (today `audit events`, so the user
+*     lands on its intro screen); opens the picker once a family shows more than
+*     one. In non-TTY/CI, falls through to `dispatchFamily`, which prints
+*     "requires a subcommand" rather than running something unprompted.
+*
+* No static yargs children. New skill-backed subcommands appear after a
+* context-mill release without a wizard release. New *native* subcommands
+* (rare) are added by updating `NATIVE_HANDLERS` in `dispatch-family.ts`.
+*/
+function familyCommandFactory({ family, description, optionsFrom }) {
+	const openFamilyEntry = async (argv) => {
+		const toShow = pickerChildrenToShow(buildFamilyPickerChildren(family, (await fetchSkillMenu(getSkillsBaseUrl(Boolean(argv["local-mcp"]))))?.cliEntries ?? []));
+		if (toShow.length === 1 && toShow[0]?.handler) {
+			await Promise.resolve(toShow[0].handler(argv));
+			return;
+		}
+		await createFamilyPickerDefault(`wizard ${family}`, toShow)(argv);
+	};
+	return {
+		name: `${family} [skill]`,
+		description,
+		options: mergeCommandOptions(optionsFrom),
+		positionals: { skill: {
+			type: "string",
+			describe: "Subcommand to run (omit to run the default)"
+		} },
+		handler: (argv) => {
+			const sub = argv.skill?.trim();
+			runCommandHandler(() => sub || !process.stdout.isTTY ? dispatchFamily(family, argv) : openFamilyEntry(argv));
+		},
+		interactiveDefault: openFamilyEntry
+	};
+}
+//#endregion
+//#region src/commands/audit.ts
+/**
+* The `wizard audit` family.
+*
+* Subcommands are resolved at runtime: the wizard fetches `cliEntries` from
+* `skill-menu.json` and dispatches based on `parentCommand: 'audit'`. The
+* wizard-native handler for `web-analytics` lives in `NATIVE_HANDLERS` over
+* in `dispatch-family.ts`. `wizard audit` with no positional opens the
+* family picker, which combines native + live entries.
+*
+* Adding a new skill-backed audit subcommand is a context-mill release —
+* no wizard release needed.
+*/
+const auditCommand = familyCommandFactory({
+	family: "audit",
+	description: auditConfig.description,
+	optionsFrom: auditConfig
+});
+//#endregion
 //#region src/commands/doctor.ts
 const doctorCommand = {
 	name: "doctor",
@@ -3366,7 +3796,7 @@ async function runDoctorCI(options) {
 	getUI().intro("Welcome to the PostHog setup wizard");
 	getUI().log.info("Running posthog-doctor in CI mode");
 	try {
-		const { getOrAskForProjectData } = await import("./setup-utils-Dwgkk8AQ.js").then((n) => n.r);
+		const { getOrAskForProjectData } = await import("./setup-utils-Doh69vo4.js").then((n) => n.r);
 		const { host, accessToken, projectId } = await getOrAskForProjectData({
 			signup: false,
 			ci: true,
@@ -3383,69 +3813,53 @@ async function runDoctorCI(options) {
 		for (const issue of sorted) getUI().log.info(`  • [${issue.severity}] ${getKindMeta(issue.kind).title}`);
 		process.exit(1);
 	} catch (error) {
-		const { ApiError } = await import("./api-Dwd0B-E9.js").then((n) => n.n);
+		const { ApiError } = await import("./api-RXTR8yZo.js").then((n) => n.n);
 		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);
-	}
-};
+//#region src/commands/factories/native-command-factory.ts
+/**
+* Build a yargs `Command` from a wizard-native `ProgramConfig`.
+*
+* Collapses the previously duplicated boilerplate (read `config.command`,
+* merge skill-program flags with program-specific options, dispatch via
+* `runWizard` / `runWizardCI`) into a single call.
+*/
+function nativeCommandFactory(config, opts = {}) {
+	if (!config.command) throw new Error(`nativeCommandFactory: program "${config.id}" has no \`command\` — wizard-native programs must declare a CLI name`);
+	return {
+		name: config.command,
+		description: config.description,
+		options: mergeCommandOptions(config),
+		children: opts.children,
+		handler: (argv) => dispatchProgram(config, argv)
+	};
+}
 //#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);
-	}
-};
+//#region src/commands/migrate.ts
+/**
+* `wizard migrate` — flat skill command, Statsig today.
+*
+* Stays flat while there's only one vendor. When a second vendor lands,
+* restructure into a family with `familyCommandFactory` and publish each
+* vendor as a `cliEntries` entry with `parentCommand: 'migrate'` from
+* context-mill. That move is a deliberate breaking change for users
+* (`wizard migrate` stops running Statsig directly), so do it explicitly
+* when the second vendor arrives, not pre-emptively.
+*/
+const migrateCommand = nativeCommandFactory(migrationConfig);
 //#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);
-	}
-};
+/**
+* `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);
 //#endregion
 //#region src/commands/slack.ts
 const slackCommand = {
@@ -3462,7 +3876,7 @@ function runSlackConnect(argv) {
 	(async () => {
 		const debug = argv.debug;
 		try {
-			const { startTUI } = await import("./start-tui-SLeEzlJs.js");
+			const { startTUI } = await import("./start-tui-CywbSvZE.js");
 			const { buildSession } = await import("./wizard-session-wPJtNl4c.js");
 			const tui = startTUI(VERSION, Program.SlackConnect);
 			tui.store.session = buildSession({ debug });
@@ -3522,8 +3936,14 @@ function runSkillMode(argv) {
 function readSkillName(argv) {
 	return String(argv.skillName ?? argv["skill-name"] ?? "").trim();
 }
+const BROWSABLE_ROLES = new Set(["command", "skill"]);
+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.
 *
 * Replaces the old `--skill=<id>` flag on the default command. The skill id
 * is fetched from context-mill's release at runtime (same mechanism the flag
@@ -3531,9 +3951,41 @@ function readSkillName(argv) {
 */
 const skillCommand = {
 	name: "skill <skill-name>",
-	description: "Run a specific context-mill skill by 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: (argv) => {
+			runCommandHandler(async () => {
+				const skillsBaseUrl = getSkillsBaseUrl(Boolean(argv["local-mcp"]));
+				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");
+					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 },
 	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;
 	},
@@ -3560,8 +4012,8 @@ function resolveInstallDir() {
 	if (inline) return inline.slice(14);
 	return process.env.POSTHOG_WIZARD_INSTALL_DIR ?? process.cwd();
 }
-Wizard.use(basicIntegrationCommand).use(mcpCommand).use(integrateCommand).use(auditCommand).use(audit3000Command).use(doctorCommand).use(migrateCommand).use(eventsAuditCommand).use(revenueCommand).use(slackCommand).use(uploadSourcemapsCommand).use(skillCommand).init();
+Wizard.use(basicIntegrationCommand).use(mcpCommand).use(auditCommand).use(doctorCommand).use(migrateCommand).use(revenueCommand).use(slackCommand).use(uploadSourcemapsCommand).use(skillCommand).init();
 //#endregion
-export { getProgramConfig as a, getContentBlocks$1 as c, getContentBlocks$2 as d, POSTHOG_SDKS$1 as f, Program as i, getKindMeta as l, runWizard as n, DISPLAY_NAME as o, STRIPE_SDKS as p, PROGRAM_REGISTRY as r, SOURCE_MAPS_CONTEXT_KEYS as s, runWizardCI as t, fetchHealthIssues as u };
+export { POSTHOG_SDKS$1 as _, PromptLabel as a, PROGRAM_REGISTRY as c, DISPLAY_NAME as d, SOURCE_MAPS_CONTEXT_KEYS as f, getContentBlocks$2 as g, fetchHealthIssues as h, useKeyboardHintsContext as i, Program as l, getKindMeta as m, useKeyBindings as n, runWizardCI as o, getContentBlocks$1 as p, KeyboardHintsProvider as r, runWizard as s, PickerMenu as t, getProgramConfig as u, STRIPE_SDKS as v };
 
 //# sourceMappingURL=bin.js.map