@posthog/wizard 2.31.0 → 2.33.0

package/dist/bin.js

@@ -1,17 +1,17 @@
 #!/usr/bin/env node
-import { I as POSTHOG_DOCS_URL, Q as WIZARD_USER_AGENT, a as getLogFilePath, et as getSkillsBaseUrl, h as LoggingUI, m as setUI, p as getUI, r as debug, s as logToFile, tt as VERSION } from "./debug-n42RObru.js";
-import { t as analytics } from "./analytics-3GR9OyE9.js";
-import { r as setEntryCommand } from "./telemetry-CqysQT5U.js";
-import { n as isUsingTypeScript } from "./setup-utils-CoblNeRY.js";
-import { a as getUiHostFromHost, n as getCloudUrlFromRegion } from "./urls-BOcViDhS.js";
-import { o as handleApiError } from "./api-Dmc76exl.js";
-import "./wizard-session-G3VWD6hv.js";
-import { r as runCleanups } from "./wizard-abort-DFL5Um-M.js";
-import { n as isNonInteractiveEnvironment } from "./environment-BKPsjOXk.js";
-import { C as AUDIT_CHECKS_FILE, T as AUDIT_REPORT_FILE, c as recoverOrphanedSettingsBackups, g as WIZARD_TOOL_NAMES, h as SETUP_REPORT_FILE, u as AgentSignals, v as fetchSkillMenu, w as AUDIT_CHECKS_KEY } from "./agent-interface-DT_uyR45.js";
-import { i as SPINNER_MESSAGE } from "./registry-5SphnyxS.js";
-import { _ as parseRequirementsTxt, a as StatusPeekTrigger, c as isClearBlock, d as Colors, f as Icons, g as parsePyprojectToml, h as parsePipfile, i as PRODUCT_SUITE_BLOCK, n as FUNNEL_BLOCK, p as HEALTH_CHECK_STEP, r as LINE_CHART_BLOCK, t as posthogIntegrationConfig } from "./posthog-integration-YDzQBfhq.js";
-import { n as safeReadFile, r as walkProjectFiles, t as IGNORED_DIRS } from "./file-utils-ALRqLr0x.js";
+import { I as POSTHOG_DOCS_URL, Q as WIZARD_USER_AGENT, a as getLogFilePath, et as getSkillsBaseUrl, h as LoggingUI, m as setUI, p as getUI, r as debug, s as logToFile, tt as VERSION } from "./debug-BGMe1wP6.js";
+import { t as analytics } from "./analytics-CU4o3eF8.js";
+import { r as setEntryCommand } from "./telemetry-DknCDWP6.js";
+import { n as isUsingTypeScript } from "./setup-utils-CanVlGbX.js";
+import { a as getUiHostFromHost, n as getCloudUrlFromRegion } from "./urls-DrR6F_A3.js";
+import { o as handleApiError } from "./api-BBRfHEZ-.js";
+import "./wizard-session-CN55LYyZ.js";
+import { r as runCleanups } from "./wizard-abort-Cw818xPr.js";
+import { n as isNonInteractiveEnvironment } from "./environment-G41UFzou.js";
+import { C as AUDIT_CHECKS_FILE, T as AUDIT_REPORT_FILE, c as recoverOrphanedSettingsBackups, g as WIZARD_TOOL_NAMES, h as SETUP_REPORT_FILE, u as AgentSignals, v as fetchSkillMenu, w as AUDIT_CHECKS_KEY } from "./agent-interface-DCeQ5Oiw.js";
+import { i as SPINNER_MESSAGE } from "./registry-BVrvFTZ0.js";
+import { _ as parseRequirementsTxt, a as StatusPeekTrigger, c as isClearBlock, d as Colors, f as Icons, g as parsePyprojectToml, h as parsePipfile, i as PRODUCT_SUITE_BLOCK, n as FUNNEL_BLOCK, p as HEALTH_CHECK_STEP, r as LINE_CHART_BLOCK, t as posthogIntegrationConfig } from "./posthog-integration-gnC9v4kg.js";
+import { n as safeReadFile, r as walkProjectFiles, t as IGNORED_DIRS } from "./file-utils-D9InAvZd.js";
 import { n as readApiKeyFromEnv } from "./env-api-key-MlzJYAvt.js";
 import { satisfies } from "semver";
 import yargs from "yargs";
@@ -29,6 +29,37 @@ import { createContext, createElement, useCallback, useContext, useEffect, useRe
 import { jsx, jsxs } from "react/jsx-runtime";
 import { access, rm } from "node:fs/promises";
 import * as readline from "node:readline/promises";
+//#region src/lib/headless-mode.ts
+/**
+* Headless mode — the published-build, non-interactive run path.
+*
+* The headless flag and `--ci` both drive a non-interactive install
+* (session.ci === true), but through dedicated entry points so they can
+* diverge: runHeadlessInstall → runWizardHeadless for headless,
+* runCIInstall → runWizardCI for `--ci`. Both delegate to one shared pipeline
+* (runNonInteractive) today; the only forks are the api-key prefixes accepted
+* (ci-install) and the analytics build tag (the mode passed to the runner).
+*
+* The flag is deliberately named `--headless-DONOTUSE-EXPERIMENTAL` and hidden
+* from `--help`: the contract is still unstable and subject to breaking
+* changes, so it must not be advertised or relied on by external callers. This
+* module is the single source of truth for the flag's name and detection — keep
+* the scary name out of every other file so a future rename is one edit here.
+*/
+/**
+* The on-CLI flag name. Intentionally ugly + undocumented; do not surface it in
+* `--help`, the README, or user-facing error messages.
+*/
+const HEADLESS_FLAG = "headless-DONOTUSE-EXPERIMENTAL";
+/**
+* Read the headless signal off a parsed argv / options bag. yargs always sets
+* the value under the declared key (`HEADLESS_FLAG`), so reading that key is
+* reliable regardless of camel-case expansion.
+*/
+function isHeadless(options) {
+	return options[HEADLESS_FLAG] === true;
+}
+//#endregion
 //#region src/commands/command.ts
 /** Extract the bare command word(s) from a yargs name spec, dropping positionals and aliases' arg syntax. */
 function commandKeys(name) {
@@ -98,6 +129,12 @@ const GLOBAL_OPTIONS = {
 		describe: "Email address for signup (used with --signup)\nenv: POSTHOG_WIZARD_EMAIL",
 		type: "string"
 	},
+	[HEADLESS_FLAG]: {
+		default: false,
+		describe: "EXPERIMENTAL — do not use. Unstable, subject to breaking changes.",
+		type: "boolean",
+		hidden: true
+	},
 	"local-mcp": {
 		default: false,
 		describe: "Use local MCP server at http://localhost:8787/mcp\nenv: POSTHOG_WIZARD_LOCAL_MCP",
@@ -190,7 +227,7 @@ function runProvision(argv) {
 }
 async function provision({ email, region, name, jsonMode }) {
 	try {
-		const { provisionNewAccount } = await import("./provisioning-ql6mjOVq.js").then((n) => n.n);
+		const { provisionNewAccount } = await import("./provisioning-C3qglLdc.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);
@@ -248,25 +285,29 @@ const basicIntegrationCommand = {
 		}
 	},
 	check: (argv) => {
-		if (argv.playground && argv.ci) throw new Error("--playground cannot be combined with --ci.");
+		if (argv.playground && (argv.ci || isHeadless(argv))) throw new Error("--playground cannot be combined with a headless run.");
 		return true;
 	},
 	handler: (argv) => {
 		setEntryCommand("integrate");
 		(async () => {
+			if (isHeadless(argv)) {
+				const { runHeadlessInstall } = await import("./ci-install-D-otkGW6.js");
+				return runHeadlessInstall(argv);
+			}
 			if (argv.ci) {
-				const { runCIInstall } = await import("./ci-install-QWrT_cW8.js");
+				const { runCIInstall } = await import("./ci-install-D-otkGW6.js");
 				return runCIInstall(argv);
 			}
 			if (isNonInteractiveEnvironment()) {
-				const { failNonInteractive } = await import("./non-interactive-BM4hUmlI.js");
+				const { failNonInteractive } = await import("./non-interactive-BXx6Q-D0.js");
 				return failNonInteractive();
 			}
 			if (argv.playground) {
-				const { runPlayground } = await import("./playground-C7SbDVI4.js");
+				const { runPlayground } = await import("./playground-Bgtxrusl.js");
 				return runPlayground();
 			}
-			const { runInteractive } = await import("./interactive-ChaxKwhe.js");
+			const { runInteractive } = await import("./interactive-D2CKikzz.js");
 			runInteractive(argv);
 		})();
 	}
@@ -3216,13 +3257,18 @@ const errorTrackingUploadSourceMapsConfig = {
 * `session.installDir` is a real, readable directory. We deliberately do
 * NOT require the base posthog-integration report to be present — it is a
 * report many users never commit, and `requires: ['posthog-integration']`
-* is metadata, not a hard runtime gate. Real readiness (integration state
-* + beta access) is established by the agent's STEP 1 Signals API probe at
-* the start of the run. The beta gates (the `product-autonomy` access flag
-* and `signals-scout` enrollment — PostHog-side flag names, unchanged by
-* the wizard-side "self-driving" rename) are PostHog-internal flags with no
-* customer-facing read API, which is why that probe lives in the run and
-* emits a structured `[ABORT]` when the product is not available.
+* is metadata, not a hard runtime gate.
+*
+* Self-driving is now in OPEN beta — available to every team — so STEP 1
+* no longer probes the Signals API as an access gate; it completes
+* instantly so the run opens with a fast first checkmark. The
+* `self-driving is not available for this project` abort below is kept
+* only as a safety net: if the Signals API genuinely can't be reached
+* during the run (a hard error that is unexpected in open beta), the skill
+* emits it and the wizard renders a friendly "try again" screen — now with
+* open-beta wording, not the old closed, per-team "join the beta" copy. The
+* PostHog-side flags (`product-autonomy`, `signals-scout`) are unchanged by
+* the wizard-side "self-driving" rename.
 */
 /**
 * `[ABORT] <reason>` cases the self-driving skill can emit. The
@@ -3233,7 +3279,7 @@ const SELF_DRIVING_ABORT_CASES = [
 	{
 		match: /^self-driving is not available for this project$/i,
 		message: "PostHog Self-driving is not available for this project",
-		body: "Self-driving is in beta and is enabled per team by PostHog. This project does not appear to have access yet. Reach out to your PostHog contact (or wizard@posthog.com) to join the beta, then run the wizard again."
+		body: "Self-driving is in open beta and available to every team, so this is unexpected — the PostHog Signals API could not be reached for this project. Nothing was changed. Try again in a moment, and if it keeps happening reach out to wizard@posthog.com."
 	},
 	{
 		match: /^github connection declined$/i,
@@ -3389,8 +3435,13 @@ Wizard mechanics:
 Follow these steps IN ORDER. Do not skip or reorder.
 
 STEP 1 — Check Self-driving access. (skill: "Check access")
-   Probe the Signals API as the skill describes. If the API is not
-   available for this project (permission or not-found errors), emit
+   Self-driving is in open beta and available to every team, so there is
+   no access gate to probe. Do NOT call any MCP tool here — mark this task
+   in_progress and then completed right away and emit the
+   ${AgentSignals.STATUS} line, so the user sees an immediate first step.
+   Only if the Signals API later turns out to be genuinely unreachable for
+   this project (a hard error on every Signals call, unexpected in open
+   beta) should you emit
    ${AgentSignals.ABORT} self-driving is not available for this project
    and halt.
 
@@ -3640,6 +3691,45 @@ const mcpTutorialConfig = {
 	}]
 };
 //#endregion
+//#region src/lib/programs/mcp-analytics/index.ts
+const MCP_ANALYTICS_REPORT_FILE = "posthog-mcp-analytics-report.md";
+/**
+* `wizard mcp-analytics` — flat skill command.
+*
+* Instruments the user's own MCP server with the `@posthog/mcp` SDK so it
+* reports `$mcp_*` analytics about itself. This is the opposite of
+* `wizard mcp add` (which installs the PostHog MCP *server* into a coding
+* agent) — keep the two distinct.
+*
+* Flat while instrumenting is the only action. If an uninstrument / `remove`
+* leaf ever lands, restructure into a family with `familyCommandFactory` and
+* publish each leaf as a `cliEntries` entry with `parentCommand:
+* 'mcp-analytics'` from context-mill — a deliberate breaking change, done then,
+* not pre-emptively.
+*/
+const mcpAnalyticsConfig = createSkillProgram({
+	skillId: "mcp-analytics",
+	command: "mcp-analytics",
+	id: "mcp-analytics",
+	description: "Add PostHog MCP analytics to your MCP server",
+	integrationLabel: "mcp-analytics",
+	customPrompt: `Instrument this project's MCP server with PostHog MCP analytics. Run the \`mcp-analytics\` skill end-to-end: detect the server style, install \`@posthog/mcp\` and \`posthog-node\`, wrap the server (or use \`PostHogMCP\` for a custom dispatcher), wire the project API key and host, and verify. Make only additive changes — do not alter tool behavior. The final report is written to ./${MCP_ANALYTICS_REPORT_FILE}.`,
+	successMessage: `MCP analytics configured! View the report at ./${MCP_ANALYTICS_REPORT_FILE}`,
+	reportFile: MCP_ANALYTICS_REPORT_FILE,
+	docsUrl: "https://posthog.com/docs/mcp-analytics",
+	spinnerMessage: "Setting up MCP analytics...",
+	estimatedDurationMinutes: 5,
+	abortCases: [{
+		match: /^not a javascript mcp server$/i,
+		message: "Not a JavaScript/TypeScript MCP server",
+		body: "MCP analytics is currently TypeScript/JavaScript-only — the `@posthog/mcp` SDK is a Node package (a Python SDK is on the roadmap). This project doesn't look like a JS/TS MCP server, so there's nothing to instrument. See https://posthog.com/docs/mcp-analytics for the supported setups."
+	}, {
+		match: /^no mcp server found$/i,
+		message: "No MCP server found",
+		body: "This command instruments an existing MCP server with PostHog analytics, but no MCP server was found in this project. If you just want PostHog product analytics, run `npx @posthog/wizard` instead."
+	}]
+});
+//#endregion
 //#region src/lib/programs/slack/index.ts
 const slackConnectConfig = {
 	id: "slack",
@@ -3687,6 +3777,7 @@ const PROGRAM_REGISTRY = [
 	mcpAddConfig,
 	mcpRemoveConfig,
 	mcpTutorialConfig,
+	mcpAnalyticsConfig,
 	slackConnectConfig
 ];
 /**
@@ -3709,6 +3800,7 @@ const Program = {
 	McpAdd: mcpAddConfig.id,
 	McpRemove: mcpRemoveConfig.id,
 	McpTutorial: mcpTutorialConfig.id,
+	McpAnalytics: mcpAnalyticsConfig.id,
 	SlackConnect: slackConnectConfig.id
 };
 /**
@@ -3749,8 +3841,8 @@ function runMcpAdd(argv) {
 		const debug = argv.debug;
 		const localMcp = argv.local;
 		try {
-			const { startTUI } = await import("./start-tui-D_woOYMc.js");
-			const { buildSession } = await import("./wizard-session-wPJtNl4c.js");
+			const { startTUI } = await import("./start-tui-YE7bybIr.js");
+			const { buildSession } = await import("./wizard-session-BKEdX9mO.js");
 			const tui = startTUI(VERSION, Program.McpAdd);
 			tui.store.session = buildSession({
 				debug,
@@ -3761,7 +3853,7 @@ function runMcpAdd(argv) {
 		} catch (error) {
 			if (!isTUIUnavailable(error)) throw error;
 			setUI(new LoggingUI());
-			const { addMCPServerToClientsStep } = await import("./add-mcp-server-to-clients-BPBRx_Nz.js").then((n) => n.r);
+			const { addMCPServerToClientsStep } = await import("./add-mcp-server-to-clients-Dhq75Hda.js").then((n) => n.r);
 			await addMCPServerToClientsStep({
 				local: localMcp,
 				features,
@@ -3800,8 +3892,8 @@ function runMcpRemove(argv) {
 		const debug = argv.debug;
 		const localMcp = argv.local;
 		try {
-			const { startTUI } = await import("./start-tui-D_woOYMc.js");
-			const { buildSession } = await import("./wizard-session-wPJtNl4c.js");
+			const { startTUI } = await import("./start-tui-YE7bybIr.js");
+			const { buildSession } = await import("./wizard-session-BKEdX9mO.js");
 			const tui = startTUI(VERSION, Program.McpRemove);
 			tui.store.session = buildSession({
 				debug,
@@ -3809,7 +3901,7 @@ function runMcpRemove(argv) {
 			});
 		} catch {
 			setUI(new LoggingUI());
-			const { removeMCPServerFromClientsStep } = await import("./add-mcp-server-to-clients-BPBRx_Nz.js").then((n) => n.r);
+			const { removeMCPServerFromClientsStep } = await import("./add-mcp-server-to-clients-Dhq75Hda.js").then((n) => n.r);
 			await removeMCPServerFromClientsStep({ local: localMcp });
 		}
 	})();
@@ -3831,8 +3923,8 @@ function runMcpTutorial(argv) {
 		const debug = argv.debug;
 		const localMcp = argv.local;
 		try {
-			const { startTUI } = await import("./start-tui-D_woOYMc.js");
-			const { buildSession } = await import("./wizard-session-wPJtNl4c.js");
+			const { startTUI } = await import("./start-tui-YE7bybIr.js");
+			const { buildSession } = await import("./wizard-session-BKEdX9mO.js");
 			const tui = startTUI(VERSION, Program.McpTutorial);
 			tui.store.session = buildSession({
 				debug,
@@ -3886,10 +3978,10 @@ function runWizard(config, options) {
 	(async () => {
 		try {
 			const installDir = options.installDir || process.cwd();
-			const { startTUI } = await import("./start-tui-D_woOYMc.js");
-			const { buildSession, RunPhase } = await import("./wizard-session-wPJtNl4c.js");
-			const { TaskStreamPush } = await import("./task-stream-BQNSp0qR.js");
-			const { PostHogDestination } = await import("./posthog-Cr37rnla.js");
+			const { startTUI } = await import("./start-tui-YE7bybIr.js");
+			const { buildSession, RunPhase } = await import("./wizard-session-BKEdX9mO.js");
+			const { TaskStreamPush } = await import("./task-stream-CPjpHFhI.js");
+			const { PostHogDestination } = await import("./posthog-DU6JXG00.js");
 			tui = startTUI(WIZARD_VERSION, config.id);
 			const activeTui = tui;
 			const session = buildSession({
@@ -3942,7 +4034,7 @@ function runWizard(config, options) {
 			await activeTui.store.getGate("health-check");
 			const skipAgent = config.run == null;
 			if (skipAgent) {
-				const { getOrAskForProjectData } = await import("./setup-utils-CoblNeRY.js").then((n) => n.r);
+				const { getOrAskForProjectData } = await import("./setup-utils-CanVlGbX.js").then((n) => n.r);
 				const { projectApiKey, host, accessToken, projectId } = await getOrAskForProjectData({
 					signup: session.signup,
 					ci: session.ci,
@@ -3957,7 +4049,7 @@ function runWizard(config, options) {
 					projectId
 				});
 			} else {
-				const { runAgent } = await import("./agent-runner-DfRka7f7.js");
+				const { runAgent } = await import("./agent-runner-BRajaO84.js");
 				await runAgent(config, activeTui.store.session);
 			}
 			const isDone = () => skipAgent ? activeTui.store.session.outroDismissed : activeTui.store.session.skillsComplete;
@@ -4000,44 +4092,57 @@ function runWizard(config, options) {
 	})();
 }
 //#endregion
-//#region src/lib/runners/run-wizard-ci.ts
+//#region src/lib/runners/run-non-interactive.ts
+/** User-facing label for a non-interactive mode. */
+function modeLabel(mode) {
+	return mode === "headless" ? "Headless" : "CI";
+}
 /**
-* The single CI validation layer: defaults region and requires api-key and
-* install-dir. Every CI entry point routes through `runWizardCI`, so this is
-* the one place these checks live. UI must be initialized before calling.
+* The single non-interactive validation layer: defaults region and requires
+* api-key and install-dir. Every non-interactive entry point routes through
+* `runNonInteractive`, so this is the one place these checks live. UI must be
+* initialized before calling.
 */
-function validateCiOptions(options) {
+function validateNonInteractiveOptions(options, mode) {
+	const label = modeLabel(mode);
+	const keyHint = mode === "headless" ? "personal API key phx_xxx or pha_ OAuth access token" : "personal API key phx_xxx";
 	if (!options.region) options.region = "us";
 	if (!options.apiKey) {
 		getUI().intro("PostHog Wizard");
-		getUI().log.error("CI mode requires --api-key (personal API key phx_xxx)");
+		getUI().log.error(`${label} mode requires --api-key (${keyHint})`);
 		process.exit(1);
 	}
 	if (!options.installDir) {
 		getUI().intro("PostHog Wizard");
-		getUI().log.error("CI mode requires --install-dir (directory to install in)");
+		getUI().log.error(`${label} mode requires --install-dir (directory to install in)`);
 		process.exit(1);
 	}
 }
 /**
-* CI-mode pipeline shared by every non-interactive entry point.
+* Non-interactive pipeline shared by CI (`runWizardCI`) and headless
+* (`runWizardHeadless`) runs.
 *
 * Validates flags, builds a `ci:true` session, runs `config.ciPreRun` (or the
 * program's `onReady` hooks by default), executes `runAgent`, and routes any
 * failure through `wizardAbort`. `wizardAbort` owns all exits — never add a
 * raw `process.exit` here.
+*
+* `mode` is the only difference between the two callers today (it sets the
+* analytics build tag and the user-facing label). Keeping it a parameter is
+* what lets CI and headless share this body now and diverge later — branch on
+* `mode` here, or stop sharing this function entirely.
 */
-function runWizardCI(config, options) {
+function runNonInteractive(config, options, mode) {
 	setUI(new LoggingUI());
-	validateCiOptions(options);
-	analytics.setTag("build", "ci");
+	validateNonInteractiveOptions(options, mode);
+	analytics.setTag("build", mode);
 	(async () => {
 		const path = await import("path");
-		const { buildSession } = await import("./wizard-session-wPJtNl4c.js");
-		const { readEnvironment } = await import("./environment-BKPsjOXk.js").then((n) => n.t);
+		const { buildSession, RunPhase, OutroKind } = await import("./wizard-session-BKEdX9mO.js");
+		const { readEnvironment } = await import("./environment-G41UFzou.js").then((n) => n.t);
 		const { readApiKeyFromEnv } = await import("./env-api-key-MlzJYAvt.js").then((n) => n.t);
-		const { configureLogFileFromEnvironment, logToFile } = await import("./debug-aqoKImO6.js");
-		const { wizardAbort, WizardError } = await import("./wizard-abort-C0siBgn5.js");
+		const { configureLogFileFromEnvironment, logToFile } = await import("./debug-BewTLNNr.js");
+		const { wizardAbort, WizardError } = await import("./wizard-abort-DMvS0YXD.js");
 		configureLogFileFromEnvironment();
 		const env = readEnvironment();
 		const apiKey = options.apiKey ?? readApiKeyFromEnv() ?? void 0;
@@ -4060,7 +4165,34 @@ function runWizardCI(config, options) {
 		if (config.skillId) session.skillId = config.skillId;
 		const runDef = typeof config.run === "object" ? config.run : null;
 		getUI().intro("Welcome to the PostHog setup wizard");
-		getUI().log.info(`Running ${config.id} in CI mode`);
+		getUI().log.info(`Running ${config.id} in ${modeLabel(mode)} mode`);
+		let store = null;
+		let taskStream = null;
+		if (mode === "headless") {
+			const { WizardStore } = await import("./store-D15C9YSW.js").then((n) => n.n);
+			const { HeadlessUI } = await import("./headless-ui-xjHVVUqe.js");
+			const { TaskStreamPush, PostHogDestination } = await import("./task-stream-CPjpHFhI.js");
+			store = new WizardStore(config.id);
+			store.session = session;
+			setUI(new HeadlessUI(store));
+			taskStream = new TaskStreamPush({
+				store,
+				programId: config.id,
+				destinations: [new PostHogDestination({
+					getCredentials: () => session.credentials,
+					onError: (e) => logToFile("[headless task-stream]", e.message)
+				})],
+				enabled: !session.noTelemetry
+			});
+			taskStream.attach();
+			store.setRunPhase(RunPhase.Running);
+		}
+		const settleStream = async (phase, outroData) => {
+			if (!store || !taskStream) return;
+			if (outroData) store.setOutroData(outroData);
+			store.setRunPhase(phase);
+			await taskStream.shutdown(2e3);
+		};
 		try {
 			if (config.ciPreRun) await config.ciPreRun(session);
 			else {
@@ -4080,24 +4212,36 @@ function runWizardCI(config, options) {
 				};
 				for (const step of config.steps) if (step.onReady) await step.onReady(readyCtx);
 				const detectError = session.frameworkContext.detectError;
-				if (detectError) await wizardAbort({
-					message: `Prerequisites not met: ${detectError.kind}\n\nSee ${runDef?.docsUrl ?? "https://posthog.com/docs"}`,
-					error: new WizardError(`${config.id} prerequisites failed`, {
-						integration: config.id,
-						detect_error_kind: detectError.kind
-					})
-				});
+				if (detectError) {
+					await settleStream(RunPhase.Error, {
+						kind: OutroKind.Error,
+						message: `Prerequisites not met: ${detectError.kind}`
+					});
+					await wizardAbort({
+						message: `Prerequisites not met: ${detectError.kind}\n\nSee ${runDef?.docsUrl ?? "https://posthog.com/docs"}`,
+						error: new WizardError(`${config.id} prerequisites failed`, {
+							integration: config.id,
+							detect_error_kind: detectError.kind
+						})
+					});
+				}
 			}
-			const { runAgent } = await import("./agent-runner-DfRka7f7.js");
+			const { runAgent } = await import("./agent-runner-BRajaO84.js");
 			await runAgent(config, session);
+			await settleStream(RunPhase.Completed);
 		} catch (error) {
 			const errorMessage = error instanceof Error ? error.message : String(error);
 			const errorStack = error instanceof Error && error.stack ? error.stack : void 0;
-			logToFile(`[bin.ts CI] ERROR: ${errorMessage}`);
-			if (errorStack) logToFile(`[bin.ts CI] STACK: ${errorStack}`);
+			logToFile(`[${mode}] ERROR: ${errorMessage}`);
+			if (errorStack) logToFile(`[${mode}] STACK: ${errorStack}`);
 			const debugInfo = session.debug && errorStack ? `\n\n${errorStack}` : "";
+			const docsUrl = session.frameworkConfig?.metadata.docsUrl ?? runDef?.docsUrl ?? "https://posthog.com/docs";
+			await settleStream(RunPhase.Error, {
+				kind: OutroKind.Error,
+				message: errorMessage
+			});
 			await wizardAbort({
-				message: `Something went wrong: ${errorMessage}\n\nYou can read the documentation at ${session.frameworkConfig?.metadata.docsUrl ?? runDef?.docsUrl ?? "https://posthog.com/docs"} to set up manually.${debugInfo}`,
+				message: `Something went wrong: ${errorMessage}\n\nYou can read the documentation at ${docsUrl} to set up manually.${debugInfo}`,
 				error
 			});
 		}
@@ -4106,6 +4250,31 @@ function runWizardCI(config, options) {
 	});
 }
 //#endregion
+//#region src/lib/runners/run-wizard-ci.ts
+/**
+* CI-mode entry point (`--ci`, dev/test builds). A thin shell over the shared
+* non-interactive pipeline — see `runNonInteractive`. Kept as its own function
+* so CI and headless (`runWizardHeadless`) can diverge without re-threading the
+* many callers that route here.
+*/
+function runWizardCI(config, options) {
+	runNonInteractive(config, options, "ci");
+}
+//#endregion
+//#region src/lib/runners/run-wizard-headless.ts
+/**
+* Headless entry point (the experimental published-build, non-interactive run
+* path; see @lib/headless-mode). A thin shell over the shared non-interactive
+* pipeline — see `runNonInteractive`. Today it behaves exactly like
+* `runWizardCI`; it exists as a separate function so headless can diverge later
+* (its own auth handling, telemetry, prompts, …) without touching CI or its
+* callers. Diverge by branching on the mode inside `runNonInteractive`, or by
+* giving this function its own body.
+*/
+function runWizardHeadless(config, options) {
+	runNonInteractive(config, options, "headless");
+}
+//#endregion
 //#region src/commands/skill-program-options.ts
 /**
 * Per-command options shared by every skill-based program command
@@ -4171,6 +4340,35 @@ function mergeCommandOptions(config) {
 	};
 }
 //#endregion
+//#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/mcp-analytics.ts
+/**
+* `wizard mcp-analytics` — flat skill command, instrument-an-MCP-server today.
+*
+* Distinct from `wizard mcp add`: this instruments the user's own MCP server
+* 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);
+//#endregion
 //#region src/lib/programs/dispatch-family.ts
 /**
 * Capture a CLI dispatch error, flush analytics, and exit. The wizard never
@@ -4955,7 +5153,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-CoblNeRY.js").then((n) => n.r);
+		const { getOrAskForProjectData } = await import("./setup-utils-CanVlGbX.js").then((n) => n.r);
 		const { host, accessToken, projectId } = await getOrAskForProjectData({
 			signup: false,
 			ci: true,
@@ -4972,32 +5170,13 @@ 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-Dmc76exl.js").then((n) => n.n);
+		const { ApiError } = await import("./api-BBRfHEZ-.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/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/migrate.ts
 /**
 * `wizard migrate` — flat skill command, Statsig today.
@@ -5068,8 +5247,8 @@ function runSlackConnect(argv) {
 	(async () => {
 		const debug = argv.debug;
 		try {
-			const { startTUI } = await import("./start-tui-D_woOYMc.js");
-			const { buildSession } = await import("./wizard-session-wPJtNl4c.js");
+			const { startTUI } = await import("./start-tui-YE7bybIr.js");
+			const { buildSession } = await import("./wizard-session-BKEdX9mO.js");
 			const tui = startTUI(VERSION, Program.SlackConnect);
 			tui.store.session = buildSession({ debug });
 		} catch (err) {
@@ -5445,8 +5624,8 @@ function resolveInstallDir() {
 	if (inline) return inline.slice(14);
 	return process.env.POSTHOG_WIZARD_INSTALL_DIR ?? process.cwd();
 }
-Wizard.use(basicIntegrationCommand).use(mcpCommand).use(cliCommand).use(auditCommand).use(doctorCommand).use(migrateCommand).use(revenueCommand).use(warehouseCommand).use(selfDrivingCommand).use(slackCommand).use(uploadSourcemapsCommand).use(skillCommand).init();
+Wizard.use(basicIntegrationCommand).use(mcpCommand).use(mcpAnalyticsCommand).use(cliCommand).use(auditCommand).use(doctorCommand).use(migrateCommand).use(revenueCommand).use(warehouseCommand).use(selfDrivingCommand).use(slackCommand).use(uploadSourcemapsCommand).use(skillCommand).init();
 //#endregion
-export { getDetectedWarehouseSources as _, ConfirmButton as a, STRIPE_SDKS as b, runWizard as c, getProgramConfig as d, AUTOMATABLE_VARIANTS as f, fetchHealthIssues as g, getKindMeta as h, useKeyboardHintsContext as i, PROGRAM_REGISTRY as l, SOURCE_MAPS_CONTEXT_KEYS as m, useKeyBindings as n, PromptLabel as o, DISPLAY_NAME as p, KeyboardHintsProvider as r, runWizardCI as s, PickerMenu as t, Program as u, getContentBlocks$2 as v, POSTHOG_SDKS as y };
+export { fetchHealthIssues as _, ConfirmButton as a, POSTHOG_SDKS as b, runWizardCI as c, Program as d, getProgramConfig as f, getKindMeta as g, SOURCE_MAPS_CONTEXT_KEYS as h, useKeyboardHintsContext as i, runWizard as l, DISPLAY_NAME as m, useKeyBindings as n, PromptLabel as o, AUTOMATABLE_VARIANTS as p, KeyboardHintsProvider as r, runWizardHeadless as s, PickerMenu as t, PROGRAM_REGISTRY as u, getDetectedWarehouseSources as v, STRIPE_SDKS as x, getContentBlocks$2 as y };
 
 //# sourceMappingURL=bin.js.map