@posthog/wizard 2.15.0 → 2.16.0

package/dist/bin.js

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 import { t as __exportAll } from "./rolldown-runtime-B_-DWIq7.js";
-import { M as POSTHOG_DOCS_URL, W as WIZARD_USER_AGENT, X as VERSION, Y as runtimeEnv, _ as SIGNUP_WIZARD_READINESS_CONFIG, h as LoggingUI, m as setUI, p as getUI, s as logToFile, v as evaluateWizardReadiness, y as getBlockingServiceKeys } from "./debug-DRKLej5r.js";
-import { n as analytics } from "./analytics-Da4QHjMw.js";
-import { a as isUsingTypeScript, f as getCloudUrlFromRegion, m as getUiHostFromHost, u as handleApiError } from "./setup-utils-_P-or31U.js";
-import "./wizard-session-BlgiX-5d.js";
-import { g as AUDIT_REPORT_FILE, h as AUDIT_CHECKS_KEY, m as AUDIT_CHECKS_FILE, t as AgentSignals, u as WIZARD_TOOL_NAMES } from "./agent-interface-yB_27jG8.js";
-import { i as SPINNER_MESSAGE } from "./registry-CofBzIdU.js";
-import { c as HEALTH_CHECK_STEP, o as Colors, r as isClearBlock } from "./TextBlock-B_8bXLLs.js";
-import { a as LINE_CHART_BLOCK, i as FUNNEL_BLOCK, n as posthogIntegrationConfig, o as PRODUCT_SUITE_BLOCK, s as StatusPeekTrigger } from "./posthog-integration-D-DyEJvz.js";
+import { M as POSTHOG_DOCS_URL, W as WIZARD_USER_AGENT, X as VERSION, Y as runtimeEnv, _ as SIGNUP_WIZARD_READINESS_CONFIG, h as LoggingUI, m as setUI, p as getUI, s as logToFile, v as evaluateWizardReadiness, y as getBlockingServiceKeys } from "./debug-C4jRuzny.js";
+import { n as analytics } from "./analytics-DZaUgJte.js";
+import { a as isUsingTypeScript, f as getCloudUrlFromRegion, m as getUiHostFromHost, u as handleApiError } from "./setup-utils-DdAdxUTV.js";
+import "./wizard-session-Bi95IYca.js";
+import { g as AUDIT_REPORT_FILE, h as AUDIT_CHECKS_KEY, m as AUDIT_CHECKS_FILE, t as AgentSignals, u as WIZARD_TOOL_NAMES } from "./agent-interface-pBnqJL8P.js";
+import { i as SPINNER_MESSAGE } from "./registry-DqbwO5EL.js";
+import { c as HEALTH_CHECK_STEP, o as Colors, r as isClearBlock } from "./TextBlock-DJVhBkr3.js";
+import { a as LINE_CHART_BLOCK, i as FUNNEL_BLOCK, n as posthogIntegrationConfig, o as PRODUCT_SUITE_BLOCK, s as StatusPeekTrigger } from "./posthog-integration-CukaeYil.js";
 import { t as IGNORED_DIRS } from "./file-utils-DnTSiTJw.js";
 import { satisfies } from "semver";
 import yargs from "yargs";
@@ -2164,7 +2164,7 @@ const getContentBlocks = (store) => pace([
 const REPORT_FILE = "posthog-source-maps-report.md";
 const DOCS_URL = "https://posthog.com/docs/error-tracking/upload-source-maps";
 const errorTrackingUploadSourceMapsConfig = {
-	command: "upload-sourcemaps",
+	command: "upload-source-maps",
 	description: "Upload source maps to PostHog Error Tracking",
 	id: "error-tracking-upload-source-maps",
 	steps: ERROR_TRACKING_UPLOAD_SOURCE_MAPS_PROGRAM,
@@ -2221,8 +2221,28 @@ const mcpAddConfig = {
 		label: "Add MCP server",
 		screenId: "mcp-add",
 		isComplete: (s) => s.mcpComplete
+	}, {
+		id: "mcp-suggested-prompts",
+		label: "Suggested prompts",
+		screenId: "mcp-suggested-prompts",
+		show: (s) => s.mcpOutcome === "installed",
+		isComplete: (s) => s.mcpSuggestedPromptsDismissed
 	}]
 };
+/**
+* `wizard mcp remove` — single-step uninstall flow.
+*
+* DO NOT append `mcp-suggested-prompts` (or any other tutorial-shaped
+* step) here. A user who just removed MCP is opting OUT of the agent
+* having access to PostHog; immediately pivoting into a tutorial that
+* asks them to log in and try prompts is wrong on intent and confusing
+* on UX. The screen also reads `session.mcpInstalledClients` for its
+* Choose-phase copy ("MCP is installed for X") — that array is empty
+* post-remove, so the copy would be a lie.
+*
+* If you want a "did you mean to keep it?" confirmation, build that as
+* a screen earlier in this program — don't reuse the tutorial.
+*/
 const mcpRemoveConfig = {
 	id: "mcp-remove",
 	description: "Remove PostHog MCP server from supported clients",
@@ -2233,6 +2253,26 @@ const mcpRemoveConfig = {
 		isComplete: (s) => s.mcpComplete
 	}]
 };
+/**
+* Standalone tutorial flow — boots directly into the Choose phase of
+* McpSuggestedPromptsScreen without going through MCP install first.
+* Useful for users who already installed MCP and want to revisit the
+* tutorial, or anyone who just wants to try the agent against PostHog
+* without touching their IDE config.
+*
+* The screen handles its own OAuth (via services.performLogin) so this
+* program doesn't pre-populate credentials.
+*/
+const mcpTutorialConfig = {
+	id: "mcp-tutorial",
+	description: "Try the PostHog MCP with your agent — no install needed",
+	steps: [{
+		id: "mcp-suggested-prompts",
+		label: "MCP tutorial",
+		screenId: "mcp-suggested-prompts",
+		isComplete: (s) => s.mcpSuggestedPromptsDismissed
+	}]
+};
 //#endregion
 //#region src/lib/programs/program-registry.ts
 const agentSkillConfig = {
@@ -2253,7 +2293,8 @@ const PROGRAM_REGISTRY = [
 	migrationConfig,
 	agentSkillConfig,
 	mcpAddConfig,
-	mcpRemoveConfig
+	mcpRemoveConfig,
+	mcpTutorialConfig
 ];
 /**
 * Typed program names. Values come from each config's `id`, so there's
@@ -2271,7 +2312,8 @@ const Program = {
 	PosthogDoctor: posthogDoctorConfig.id,
 	AgentSkill: agentSkillConfig.id,
 	McpAdd: mcpAddConfig.id,
-	McpRemove: mcpRemoveConfig.id
+	McpRemove: mcpRemoveConfig.id,
+	McpTutorial: mcpTutorialConfig.id
 };
 /**
 * Look up a program config by its id. `ProgramId` is a union of every
@@ -2460,7 +2502,7 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 				setUI(new LoggingUI());
 				getUI().intro("PostHog Wizard");
 				try {
-					const { provisionNewAccount } = await import("./provisioning-COeHnCVG.js");
+					const { provisionNewAccount } = await import("./provisioning-Ch6i8dRV.js");
 					const signupRegion = options.region.toUpperCase();
 					getUI().log.info(`Provisioning new PostHog account for ${String(options.email)} in ${signupRegion}...`);
 					const result = await provisionNewAccount(options.email, options.name ?? "", signupRegion);
@@ -2482,11 +2524,11 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 					return;
 				}
 			}
-			const { posthogIntegrationConfig } = await import("./posthog-integration-D-DyEJvz.js").then((n) => n.r);
-			const { FRAMEWORK_REGISTRY } = await import("./registry-CofBzIdU.js").then((n) => n.n);
-			const { detectFramework, gatherFrameworkContext } = await import("./detection-0Pz2NncX.js").then((n) => n.t);
-			const { analytics } = await import("./analytics-BnR9904x.js");
-			const { wizardAbort } = await import("./wizard-abort-CuaS1eXn.js");
+			const { posthogIntegrationConfig } = await import("./posthog-integration-CukaeYil.js").then((n) => n.r);
+			const { FRAMEWORK_REGISTRY } = await import("./registry-DqbwO5EL.js").then((n) => n.n);
+			const { detectFramework, gatherFrameworkContext } = await import("./detection-4eukp9HD.js").then((n) => n.t);
+			const { analytics } = await import("./analytics-DqeW7XYt.js");
+			const { wizardAbort } = await import("./wizard-abort-BlYGA1Jk.js");
 			runWizardCI(posthogIntegrationConfig, options, async (session) => {
 				const integration = session.integration ?? await detectFramework(session.installDir);
 				if (!integration) {
@@ -2519,7 +2561,7 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 		getUI().log.error("This installer requires an interactive terminal (TTY) to run.\nIt appears you are running in a non-interactive environment.\n\nNon-interactive (CI) mode is not supported in published builds.\n");
 		process.exit(1);
 	} else if (options.playground) (async () => {
-		const { startPlayground } = await import("./start-playground-Bxd2KG2L.js");
+		const { startPlayground } = await import("./start-playground-B40O4tye.js");
 		startPlayground(WIZARD_VERSION);
 	})();
 	else if (options.skill) (async () => {
@@ -2542,7 +2584,7 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 		});
 	})();
 	else (async () => {
-		const { posthogIntegrationConfig } = await import("./posthog-integration-D-DyEJvz.js").then((n) => n.r);
+		const { posthogIntegrationConfig } = await import("./posthog-integration-CukaeYil.js").then((n) => n.r);
 		runWizard(posthogIntegrationConfig, options);
 	})();
 }).command("mcp <command>", "MCP server management commands", (yargs) => {
@@ -2566,11 +2608,11 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 		const options = { ...argv };
 		const mcpFeatures = options.features?.split(",").map((s) => s.trim()).filter(Boolean);
 		(async () => {
-			const { readApiKeyFromEnv } = await import("./env-api-key-HFqv1l-z.js");
+			const { readApiKeyFromEnv } = await import("./env-api-key-DU8uIEvo.js");
 			const apiKey = options.apiKey || readApiKeyFromEnv();
 			try {
-				const { startTUI } = await import("./start-tui-Bl8fCbp_.js");
-				const { buildSession } = await import("./wizard-session-DxU5ZMBN.js");
+				const { startTUI } = await import("./start-tui-CH_ZzQXx.js");
+				const { buildSession } = await import("./wizard-session-DPGTaJ4W.js");
 				const tui = startTUI(WIZARD_VERSION, Program.McpAdd);
 				const session = buildSession({
 					debug: options.debug,
@@ -2581,7 +2623,7 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 				tui.store.session = session;
 			} catch {
 				setUI(new LoggingUI());
-				const { addMCPServerToClientsStep } = await import("./add-mcp-server-to-clients-Dq0n2yzq.js").then((n) => n.r);
+				const { addMCPServerToClientsStep } = await import("./add-mcp-server-to-clients-9jQjc-CO.js").then((n) => n.r);
 				await addMCPServerToClientsStep({
 					local: options.local,
 					features: mcpFeatures,
@@ -2599,8 +2641,8 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 		const options = { ...argv };
 		(async () => {
 			try {
-				const { startTUI } = await import("./start-tui-Bl8fCbp_.js");
-				const { buildSession } = await import("./wizard-session-DxU5ZMBN.js");
+				const { startTUI } = await import("./start-tui-CH_ZzQXx.js");
+				const { buildSession } = await import("./wizard-session-DPGTaJ4W.js");
 				const tui = startTUI(WIZARD_VERSION, Program.McpRemove);
 				const session = buildSession({
 					debug: options.debug,
@@ -2609,11 +2651,35 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 				tui.store.session = session;
 			} catch {
 				setUI(new LoggingUI());
-				const { removeMCPServerFromClientsStep } = await import("./add-mcp-server-to-clients-Dq0n2yzq.js").then((n) => n.r);
+				const { removeMCPServerFromClientsStep } = await import("./add-mcp-server-to-clients-9jQjc-CO.js").then((n) => n.r);
 				await removeMCPServerFromClientsStep({ local: options.local });
 			}
 		})();
-	}).demandCommand(1, "You must specify a subcommand (add or remove)").help();
+	}).command("tutorial", "Try the PostHog MCP with your agent (no install needed)", (yargs) => {
+		return yargs.options({ local: {
+			default: false,
+			describe: "Point the tutorial at the local MCP server (http://localhost:8787)",
+			type: "boolean"
+		} });
+	}, (argv) => {
+		const options = { ...argv };
+		(async () => {
+			try {
+				const { startTUI } = await import("./start-tui-CH_ZzQXx.js");
+				const { buildSession } = await import("./wizard-session-DPGTaJ4W.js");
+				const tui = startTUI(WIZARD_VERSION, Program.McpTutorial);
+				const session = buildSession({
+					debug: options.debug,
+					localMcp: options.local
+				});
+				tui.store.session = session;
+			} catch (err) {
+				setUI(new LoggingUI());
+				getUI().log.error(`The MCP tutorial requires an interactive terminal. ${err instanceof Error ? err.message : String(err)}`);
+				process.exit(1);
+			}
+		})();
+	}).demandCommand(1, "You must specify a subcommand (add, remove, or tutorial)").help();
 });
 cli.command("provision", "Create a new PostHog account (headless, no TUI)", (yargs) => {
 	return yargs.options({
@@ -2645,7 +2711,7 @@ cli.command("provision", "Create a new PostHog account (headless, no TUI)", (yar
 	if (!jsonMode) setUI(new LoggingUI());
 	(async () => {
 		try {
-			const { provisionNewAccount } = await import("./provisioning-COeHnCVG.js");
+			const { provisionNewAccount } = await import("./provisioning-Ch6i8dRV.js");
 			if (!jsonMode) getUI().log.info(`Provisioning account for ${email} in ${region}...`);
 			const result = await provisionNewAccount(email, name, region);
 			if (jsonMode) process.stdout.write(`${JSON.stringify(result)}\n`);
@@ -2727,11 +2793,11 @@ function runWizard(config, options) {
 	(async () => {
 		try {
 			const installDir = options.installDir || process.cwd();
-			const { startTUI } = await import("./start-tui-Bl8fCbp_.js");
-			const { buildSession, RunPhase } = await import("./wizard-session-DxU5ZMBN.js");
-			const { TaskStreamPush } = await import("./task-stream-z6QFZtpC.js");
-			const { PostHogDestination } = await import("./posthog-B1G0raJU.js");
-			const { logToFile } = await import("./debug-D5kt4fxB.js");
+			const { startTUI } = await import("./start-tui-CH_ZzQXx.js");
+			const { buildSession, RunPhase } = await import("./wizard-session-DPGTaJ4W.js");
+			const { TaskStreamPush } = await import("./task-stream-CoEsidgG.js");
+			const { PostHogDestination } = await import("./posthog-7B92c2Ed.js");
+			const { logToFile } = await import("./debug-B6rX6xye.js");
 			tui = startTUI(WIZARD_VERSION, config.id);
 			const activeTui = tui;
 			const session = buildSession({
@@ -2785,7 +2851,7 @@ function runWizard(config, options) {
 			await activeTui.store.getGate("health-check");
 			const skipAgent = config.run == null;
 			if (skipAgent) {
-				const { getOrAskForProjectData } = await import("./setup-utils-C5iSJ3eg.js");
+				const { getOrAskForProjectData } = await import("./setup-utils-C5uZ9g60.js");
 				const { projectApiKey, host, accessToken, projectId } = await getOrAskForProjectData({
 					signup: session.signup,
 					ci: session.ci,
@@ -2799,7 +2865,7 @@ function runWizard(config, options) {
 					projectId
 				});
 			} else {
-				const { runAgent } = await import("./agent-runner-C9sSudE0.js");
+				const { runAgent } = await import("./agent-runner-H1FP6XTc.js");
 				await runAgent(config, activeTui.store.session);
 			}
 			const isDone = () => skipAgent ? activeTui.store.session.outroDismissed : activeTui.store.session.skillsComplete;
@@ -2861,11 +2927,11 @@ function runWizardCI(config, options, preRun) {
 	}
 	(async () => {
 		const path = await import("path");
-		const { buildSession } = await import("./wizard-session-DxU5ZMBN.js");
+		const { buildSession } = await import("./wizard-session-DPGTaJ4W.js");
 		const { readEnvironment } = await Promise.resolve().then(() => environment_exports);
-		const { readApiKeyFromEnv } = await import("./env-api-key-HFqv1l-z.js");
-		const { configureLogFileFromEnvironment, logToFile } = await import("./debug-D5kt4fxB.js");
-		const { wizardAbort, WizardError } = await import("./wizard-abort-CuaS1eXn.js");
+		const { readApiKeyFromEnv } = await import("./env-api-key-DU8uIEvo.js");
+		const { configureLogFileFromEnvironment, logToFile } = await import("./debug-B6rX6xye.js");
+		const { wizardAbort, WizardError } = await import("./wizard-abort-BlYGA1Jk.js");
 		configureLogFileFromEnvironment();
 		const env = readEnvironment();
 		const apiKey = options.apiKey ?? readApiKeyFromEnv() ?? void 0;
@@ -2916,7 +2982,7 @@ function runWizardCI(config, options, preRun) {
 					})
 				});
 			}
-			const { runAgent } = await import("./agent-runner-C9sSudE0.js");
+			const { runAgent } = await import("./agent-runner-H1FP6XTc.js");
 			await runAgent(config, session);
 		} catch (error) {
 			const errorMessage = error instanceof Error ? error.message : String(error);