@posthog/wizard 2.14.3 → 2.16.0

package/dist/bin.js

@@ -1,13 +1,14 @@
 #!/usr/bin/env node
 import { t as __exportAll } from "./rolldown-runtime-B_-DWIq7.js";
-import { D as POSTHOG_DOCS_URL, G as VERSION, W as runtimeEnv, c as getUI, l as setUI, s as logToFile, u as LoggingUI, z as WIZARD_USER_AGENT } from "./debug-BOogNcWX.js";
-import { n as analytics } from "./analytics-DaDpDus8.js";
-import { a as isUsingTypeScript, d as getCloudUrlFromRegion, u as handleApiError } from "./setup-utils-Mzpk1vqG.js";
-import { g as AUDIT_REPORT_FILE, h as AUDIT_CHECKS_KEY, m as AUDIT_CHECKS_FILE, u as WIZARD_TOOL_NAMES } from "./agent-interface-cEdS_bNo.js";
-import { i as SPINNER_MESSAGE } from "./registry-DpROZPnl.js";
-import { c as HEALTH_CHECK_STEP, o as Colors } from "./TextBlock-DEHERFec.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-By5930Gz.js";
-import { t as IGNORED_DIRS } from "./file-utils-DPmgn9Vm.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";
 import { hideBin } from "yargs/helpers";
@@ -34,7 +35,7 @@ function readEnvironment() {
 }
 //#endregion
 //#region src/lib/programs/revenue-analytics/detect.ts
-const POSTHOG_SDKS = [
+const POSTHOG_SDKS$1 = [
 	"posthog-js",
 	"posthog-node",
 	"posthog-react-native",
@@ -79,7 +80,7 @@ function findPackageJsons(installDir, maxDepth = 3) {
 			if (entry.isFile() && entry.name === "package.json") try {
 				const pkg = JSON.parse(readFileSync(fullPath, "utf-8"));
 				const depNames = [...Object.keys(pkg.dependencies ?? {}), ...Object.keys(pkg.devDependencies ?? {})];
-				const posthogSdks = depNames.filter((d) => POSTHOG_SDKS.includes(d));
+				const posthogSdks = depNames.filter((d) => POSTHOG_SDKS$1.includes(d));
 				const stripeSdks = depNames.filter((d) => STRIPE_SDKS.includes(d));
 				matches.push({
 					path: relative(installDir, fullPath) || "package.json",
@@ -212,7 +213,7 @@ const REVENUE_ANALYTICS_PROGRAM = [
 * skill-based program (audit, revenue-analytics, agent-skill, etc.)
 * runs. Skill programs don't need the full PostHog onboarding narrative.
 */
-const getContentBlocks$1 = (store) => {
+const getContentBlocks$2 = (store) => {
 	return [
 		{
 			content: "Welcome.",
@@ -244,7 +245,7 @@ const revenueAnalyticsConfig = {
 	description: "Set up PostHog revenue analytics (e.g. Stripe integration)",
 	id: "revenue-analytics-setup",
 	steps: REVENUE_ANALYTICS_PROGRAM,
-	getContentBlocks: getContentBlocks$1,
+	getContentBlocks: getContentBlocks$2,
 	allowedTools: ["Agent"],
 	disallowedTools: [WIZARD_TOOL_NAMES.wizardAsk],
 	run: {
@@ -305,7 +306,7 @@ function createSkillProgram(opts) {
 		skillId: opts.skillId,
 		steps: AGENT_SKILL_STEPS,
 		reportFile: opts.reportFile,
-		getContentBlocks: getContentBlocks$1,
+		getContentBlocks: getContentBlocks$2,
 		run: {
 			skillId: opts.skillId,
 			integrationLabel: opts.integrationLabel,
@@ -506,7 +507,7 @@ const EVENTS_AUDIT_PROGRAM = [
 //#endregion
 //#region src/lib/programs/events-audit/index.ts
 const SETUP_REPORT_FILE = "posthog-events-audit-report.md";
-const DOCS_URL = "https://posthog.com/docs/product-analytics/best-practices";
+const DOCS_URL$1 = "https://posthog.com/docs/product-analytics/best-practices";
 const eventsAuditConfig = {
 	command: "events-audit",
 	description: "Audit PostHog event tracking in this project",
@@ -528,7 +529,7 @@ const eventsAuditConfig = {
 			successMessage: "Events audit complete! You can view the report at ./posthog-events-audit-report.md",
 			estimatedDurationMinutes: 5,
 			reportFile: SETUP_REPORT_FILE,
-			docsUrl: DOCS_URL,
+			docsUrl: DOCS_URL$1,
 			errorMessage: "Events audit failed",
 			additionalFeatureQueue: session.additionalFeatureQueue,
 			customPrompt: (ctx) => `Audit PostHog event capture in this project. Do not modify any project files — produce a read-only report only.
@@ -546,7 +547,7 @@ Project context:
 					message: "Your events audit was successful",
 					reportFile: SETUP_REPORT_FILE,
 					changes: [],
-					docsUrl: DOCS_URL,
+					docsUrl: DOCS_URL$1,
 					continueUrl: sess.signup && cloudUrl ? `${cloudUrl}/products?source=wizard` : void 0,
 					dashboardUrl: sess.dashboardUrl ?? (cloudUrl ? `${cloudUrl}/dashboard` : void 0)
 				};
@@ -1188,7 +1189,7 @@ const PRICING_STRUCTURE_BLOCK = {
 *   - posthog.com/docs/feature-flags/common-questions
 *   - posthog.com/docs/experiments/best-practices
 */
-const getContentBlocks = (store) => [
+const getContentBlocks$1 = (store) => [
 	{
 		content: "Hello.",
 		pause: 3e3,
@@ -1440,7 +1441,7 @@ const migrationConfig = {
 	skillId: PRODUCT_TO_SKILL_ID.statsig,
 	steps: MIGRATION_PROGRAM,
 	reportFile: MIGRATION_REPORT_FILE,
-	getContentBlocks,
+	getContentBlocks: getContentBlocks$1,
 	allowedTools: ["Agent"],
 	disallowedTools: [WIZARD_TOOL_NAMES.wizardAsk],
 	cliOptions: { product: {
@@ -1464,6 +1465,753 @@ const migrationConfig = {
 	requires: ["posthog-integration"]
 };
 //#endregion
+//#region src/lib/programs/error-tracking-upload-source-maps/detect.ts
+const DISPLAY_NAME = {
+	web: "Web (JavaScript)",
+	nextjs: "Next.js",
+	node: "Node.js",
+	react: "React",
+	angular: "Angular",
+	nuxt: "Nuxt",
+	"react-native": "React Native",
+	android: "Android",
+	flutter: "Flutter",
+	ios: "iOS",
+	vite: "Vite",
+	webpack: "Webpack",
+	rollup: "Rollup"
+};
+const POSTHOG_SDKS = [
+	"posthog-js",
+	"posthog-node",
+	"posthog-react-native",
+	"posthog-android",
+	"posthog-ios"
+];
+/** `[ABORT] <reason>` cases the source maps skill can emit. */
+const SOURCE_MAPS_ABORT_CASES = [{
+	match: /^no posthog sdk detected$/i,
+	message: "No PostHog SDK detected",
+	body: "The agent could not find a PostHog SDK in your project. Source map upload requires the SDK to already be installed so it can report errors. Run `npx @posthog/wizard` first to install the SDK.",
+	docsUrl: "https://posthog.com/docs/error-tracking"
+}, {
+	match: /^build command not found$/i,
+	message: "Build command not found",
+	body: "The agent could not identify how to build your project. Source map upload runs as part of the production build. Add a build script to your project and run this wizard again.",
+	docsUrl: "https://posthog.com/docs/error-tracking/upload-source-maps"
+}];
+function collectSignals(installDir, maxDepth = 3) {
+	const signals = {
+		packageJsons: [],
+		hasXcodeProject: false,
+		hasPodfile: false,
+		hasSwiftPackage: false,
+		hasGradle: false,
+		hasPubspec: false,
+		scannedFileCount: 0
+	};
+	function scan(dir, depth) {
+		if (depth > maxDepth) return;
+		let entries;
+		try {
+			entries = readdirSync(dir, { withFileTypes: true });
+		} catch {
+			return;
+		}
+		for (const entry of entries) {
+			if (entry.name.startsWith(".") && entry.name !== ".") continue;
+			if (IGNORED_DIRS.has(entry.name)) continue;
+			const fullPath = join(dir, entry.name);
+			if (entry.isFile()) {
+				signals.scannedFileCount += 1;
+				if (entry.name === "package.json") try {
+					const pkg = JSON.parse(readFileSync(fullPath, "utf-8"));
+					const deps = new Set([...Object.keys(pkg.dependencies ?? {}), ...Object.keys(pkg.devDependencies ?? {})]);
+					signals.packageJsons.push({
+						path: relative(installDir, fullPath) || "package.json",
+						deps
+					});
+				} catch {}
+				else if (entry.name === "Podfile") signals.hasPodfile = true;
+				else if (entry.name === "Package.swift") signals.hasSwiftPackage = true;
+				else if (entry.name === "pubspec.yaml") signals.hasPubspec = true;
+				else if (entry.name === "build.gradle" || entry.name === "build.gradle.kts" || entry.name === "settings.gradle" || entry.name === "settings.gradle.kts") signals.hasGradle = true;
+			} else if (entry.isDirectory()) if (entry.name.endsWith(".xcodeproj")) signals.hasXcodeProject = true;
+			else scan(fullPath, depth + 1);
+		}
+	}
+	scan(installDir, 0);
+	return signals;
+}
+function pickJsVariant(deps) {
+	if (deps.has("react-native")) return "react-native";
+	if (deps.has("nuxt")) return "nuxt";
+	if (deps.has("next")) return "nextjs";
+	if (deps.has("@angular/core")) return "angular";
+	if (deps.has("vite")) return "vite";
+	if (deps.has("webpack")) return "webpack";
+	if (deps.has("rollup")) return "rollup";
+	if (deps.has("react")) return "react";
+	if (deps.has("posthog-node")) return "node";
+	return "web";
+}
+function selectVariant(signals) {
+	if (signals.hasPubspec) return "flutter";
+	if (signals.hasXcodeProject || signals.hasPodfile || signals.hasSwiftPackage) return "ios";
+	if (signals.hasGradle) return "android";
+	if (signals.packageJsons.length > 0) {
+		const allDeps = /* @__PURE__ */ new Set();
+		for (const pkg of signals.packageJsons) for (const dep of pkg.deps) allDeps.add(dep);
+		return pickJsVariant(allDeps);
+	}
+	return null;
+}
+function hasPostHogSdk(signals) {
+	for (const pkg of signals.packageJsons) for (const sdk of POSTHOG_SDKS) if (pkg.deps.has(sdk)) return true;
+	return signals.hasXcodeProject || signals.hasPodfile || signals.hasSwiftPackage || signals.hasGradle || signals.hasPubspec;
+}
+const SOURCE_MAPS_CONTEXT_KEYS = {
+	skillVariant: "sourceMapsSkillVariant",
+	displayName: "sourceMapsDisplayName",
+	packagePaths: "sourceMapsPackagePaths",
+	detectError: "detectError"
+};
+/**
+* Scan `session.installDir` for platform / build-system signals. Writes
+* detection results into frameworkContext via the callback — either the
+* picked skill variant + display name, or a `SourceMapsDetectError`.
+*
+* The skill install happens later in the agent run, not here. This step
+* only picks which variant the prompt should ask the agent to load.
+*/
+function detectSourceMapsPrerequisites(session, setFrameworkContext) {
+	const fail = (error) => setFrameworkContext(SOURCE_MAPS_CONTEXT_KEYS.detectError, error);
+	const installDir = session.installDir;
+	if (!existsSync(installDir)) {
+		fail({
+			kind: "bad-directory",
+			path: installDir,
+			reason: "missing"
+		});
+		return;
+	}
+	try {
+		if (!statSync(installDir).isDirectory()) {
+			fail({
+				kind: "bad-directory",
+				path: installDir,
+				reason: "not-dir"
+			});
+			return;
+		}
+	} catch {
+		fail({
+			kind: "bad-directory",
+			path: installDir,
+			reason: "unreadable"
+		});
+		return;
+	}
+	const signals = collectSignals(installDir);
+	const variant = selectVariant(signals);
+	if (variant && [
+		"react-native",
+		"flutter",
+		"ios",
+		"android"
+	].includes(variant)) {
+		fail({
+			kind: "unsupported-platform",
+			detected: variant
+		});
+		return;
+	}
+	if (!variant) {
+		if (signals.scannedFileCount === 0) fail({ kind: "no-project-files" });
+		else fail({
+			kind: "unsupported-platform",
+			detected: "unknown"
+		});
+		return;
+	}
+	if (!hasPostHogSdk(signals)) {
+		fail({
+			kind: "no-posthog-sdk",
+			platform: variant
+		});
+		return;
+	}
+	setFrameworkContext(SOURCE_MAPS_CONTEXT_KEYS.skillVariant, variant);
+	setFrameworkContext(SOURCE_MAPS_CONTEXT_KEYS.displayName, DISPLAY_NAME[variant]);
+	setFrameworkContext(SOURCE_MAPS_CONTEXT_KEYS.packagePaths, signals.packageJsons.map((p) => p.path));
+}
+//#endregion
+//#region src/lib/programs/error-tracking-upload-source-maps/steps.ts
+function healthCheckReady(session) {
+	if (!session.readinessResult) return false;
+	if (session.signup) {
+		const hardBlocking = getBlockingServiceKeys(session.readinessResult.health, SIGNUP_WIZARD_READINESS_CONFIG);
+		const defaultBlocking = getBlockingServiceKeys(session.readinessResult.health);
+		if (hardBlocking.length === 0 && defaultBlocking.length === 0) return true;
+		return session.outageDismissed;
+	}
+	if (session.readinessResult.decision === "no") return session.outageDismissed;
+	return true;
+}
+const ERROR_TRACKING_UPLOAD_SOURCE_MAPS_PROGRAM = [
+	{
+		id: "detect",
+		label: "Detecting platform",
+		onReady: (ctx) => detectSourceMapsPrerequisites(ctx.session, ctx.setFrameworkContext)
+	},
+	{
+		id: "intro",
+		label: "Welcome",
+		screenId: "source-maps-intro",
+		gate: (session) => session.setupConfirmed
+	},
+	{
+		id: "health-check",
+		label: "Health check",
+		screenId: "health-check",
+		gate: healthCheckReady,
+		onInit: (ctx) => {
+			evaluateWizardReadiness().then((readiness) => {
+				ctx.setReadinessResult(readiness);
+			}).catch(() => {
+				ctx.setReadinessResult({
+					decision: "yes",
+					health: {},
+					reasons: []
+				});
+			});
+		}
+	},
+	{
+		id: "auth",
+		label: "Authentication",
+		screenId: "auth",
+		isComplete: (session) => session.credentials !== null
+	},
+	{
+		id: "run",
+		label: "Upload source maps",
+		screenId: "run",
+		isComplete: (session) => session.runPhase === "completed" || session.runPhase === "error"
+	},
+	{
+		id: "outro",
+		label: "Done",
+		screenId: "source-maps-outro",
+		isComplete: (session) => session.outroDismissed
+	},
+	{
+		id: "skills",
+		label: "Skills",
+		screenId: "keep-skills"
+	}
+];
+//#endregion
+//#region src/lib/programs/error-tracking-upload-source-maps/prompt.ts
+const SOURCE_MAPS_DETECTION_FAILED_PROMPT = `Detection did not pick a source maps skill variant for this project.
+Emit: ${AgentSignals.ABORT} unsupported-platform
+Then halt.`;
+function buildSourceMapsUploadPrompt(params) {
+	const { displayName, variant, skillId, projectId, host, settingsUrl, uiHost } = params;
+	const platformLabel = displayName ?? variant;
+	return `You are wiring up PostHog Error Tracking source map upload for this ${platformLabel} project.
+
+Project context:
+- PostHog Project ID: ${projectId}
+- PostHog Host: ${host}
+- Detected platform: ${platformLabel}
+- Skill to use: ${skillId}
+- Personal API keys settings page: ${settingsUrl}
+
+The skill you install in STEP 2 is the source of truth for the HOW of every
+step: its "## Steps" section has an overview, tips and per-technology
+examples for each named step, and its reference files carry the exact
+per-framework API. The STEPS below give the order, the conditionals, and the
+wizard-specific mechanics (which MCP tool to call, signals to emit) — read
+the matching skill step (named in parentheses) before doing the work, and do
+not invent steps the skill doesn't describe.
+
+Follow these steps IN ORDER. Do not skip or reorder.
+
+Before doing any work, create your FULL task list in a single TaskCreate
+call so the user can follow your progress in the TUI. Use exactly these
+tasks, in this order — do not collapse, rename, or omit any of them:
+  1. Get personal API key
+  2. Install source maps skill
+  3. Apply build-config changes (per skill)
+  4. Make credentials readable at build time
+  5. Write keys to .env
+  6. Identify build & run commands
+  7. Test the local setup
+  8. Summarise & hand off
+Drive the list with TaskUpdate — mark a task in_progress when you start it
+and completed when done. ALWAYS keep task 7 ("Test the local setup") in the
+list even if the user declines testing in STEP 7: mark it completed rather
+than deleting it, so the user can see testing was offered.
+
+STEP 1 — Get a personal API key from the user. (skill: "Get a personal API key")
+   The wizard cannot mint keys — never call the PostHog API or any tool to
+   create one. Ask the user with the wizard_ask MCP tool; you receive the
+   answer as a vaulted secretRef (never the raw value), which you reuse in
+   STEP 5:
+     {
+       id: "api-key",
+       prompt: "Paste your PostHog personal API key below.\\n\\nDon't have one yet? Create one here:\\n${settingsUrl}\\n\\nWhen creating the key, choose the 'Source map upload' preset, then come back and paste it here.",
+       kind: "text",
+       sensitive: true
+     }
+   Keep the \\n line breaks exactly as written — Ink's <Text> renders them
+   as separate lines. The answer is { secretRef: "secret:..." }.
+   If wizard_ask is unavailable (CI / non-interactive), emit
+   ${AgentSignals.ABORT} requires-interactive-mode and halt.
+
+STEP 2 — Install the skill.
+   Call install_skill (wizard-tools MCP server) with skillId "${skillId}".
+   Do NOT run shell commands to install skills. Then read the installed
+   SKILL.md and its reference files — they drive STEPS 3-8.
+   If install fails, emit ${AgentSignals.ERROR_RESOURCE_MISSING} skill ${skillId} could not be installed.
+
+STEP 3 — Apply build-config changes. (skill: "Apply build-config changes")
+   Make the bundler / build-config changes the skill's step instructs. The
+   skill and its reference are the source of truth for this platform.
+
+STEP 4 — Make the credentials readable at build time. (skill: "Make credentials available at build time")
+   Follow the skill's step. Wizard-specific: if it calls for a loader (e.g.
+   \`dotenv\`), install it SILENTLY — do NOT ask the user or call wizard_ask.
+   Skip this step entirely if the platform already auto-loads .env.
+
+STEP 5 — Write the credentials to the env file. (skill: "Write credentials to the env file")
+   Use the wizard-tools MCP server. Reuse the env file the skill tells you to
+   pick — the prerequisite PostHog integration usually already wrote
+   POSTHOG_* vars to one, so seed your keys alongside them.
+   - First call check_env_keys on that file (returns present/absent, never
+     values — don't read the file directly).
+   - Then call set_env_values, passing the STEP 1 secretRef as a value
+     object, not a literal string:
+       values: {
+         "POSTHOG_CLI_API_KEY": { secretRef: "<the ref from STEP 1>" },
+         "POSTHOG_CLI_PROJECT_ID": "${projectId}",
+         "POSTHOG_CLI_HOST": "${host}"
+       }
+   Variable names follow the skill's per-uploader conventions. The wizard
+   resolves the ref locally before writing, so you never see the key value.
+
+STEP 6 — Identify the build AND run commands. (skill: "Identify the build and run commands")
+   Per the skill, resolve the production BUILD command and the RUN command
+   for THIS project (use detect_package_manager for the package manager). Do
+   NOT run either yourself — the user runs them. If you cannot identify a
+   build command, emit ${AgentSignals.ABORT} build command not found.
+
+STEP 7 — Offer to test the local setup. (skill: "Test the local setup")
+   Call wizard_ask:
+     {
+       id: "test-affordance",
+       prompt: "Want me to help you test your local setup? I'll add a temporary test button (or route) to your app so you can confirm errors show up in Error Tracking with readable stack traces after your next build. I'll remove it once you've confirmed it works.",
+       kind: "single",
+       options: [
+         { label: "Yes, help me test it", value: "yes" },
+         { label: "No, I'll test on my own later",  value: "no"  }
+       ]
+     }
+
+   If "no", skip to STEP 8.
+
+   If "yes", follow the skill's "Test the local setup" step for the
+   platform-appropriate affordance, the captureException shape, the
+   placement, and the read-before-edit / always-revert rules. Then pause for
+   the user with wizard_ask, baking the EXACT build and run commands from
+   STEP 6 (and the exact button label / route) into the prompt as literal,
+   copy-pasteable steps. Separate each numbered step with \\n\\n so the TUI
+   renders them as distinct lines:
+        {
+          id: "test-done",
+          prompt: "1) Run \`<your detected build command>\` to upload source maps and build the app with the test affordance.\\n\\n2) Start the app with \`<your detected run command>\`, then click the \\"<your test button label>\\" button (or hit \`<your test route>\`).\\n\\n3) Open Error Tracking in PostHog (${uiHost}/project/${projectId}/error_tracking) and confirm the test error appears with a source-resolved stack trace pointing at real source files (not minified bundle paths).\\n\\nWhen you're done, select Continue and I'll revert the test code.",
+          kind: "single",
+          options: [{ label: "Continue (revert test code)", value: "continue" }]
+        }
+   After the user continues, revert the test code per the skill's rules and
+   surface any failure in STEP 8.
+
+STEP 8 — Summarise and hand off. (skill: "Verify and hand off")
+   Follow the skill's "Verify and hand off" step. The Symbol sets page for
+   this project — where the user confirms the upload landed — is:
+   ${uiHost}/project/${projectId}/error_tracking/configuration
+`;
+}
+//#endregion
+//#region src/lib/programs/error-tracking-upload-source-maps/content/index.tsx
+/**
+* Source-maps learn-deck — the narrative played in the run screen's left
+* pane (LearnCard) while the agent wires source-map upload into the build.
+*
+* It educates the user on what source maps are and why uploading them
+* matters, built around a before/after stack-trace contrast: a minified
+* production trace nobody can read, then the same trace resolved back to
+* real source. Program-owned; wired onto the program's getContentBlocks.
+*
+* Lines stay narrow (~36 cols) because this renders in the left half of a
+* split pane — see LearnCard's paneWidth math.
+*/
+/**
+* Per-slide dwell multiplier. Each block stays on screen for `pause * SLIDE_PACE`
+* ms after it finishes animating, before the deck advances. Bump this single
+* knob to give every slide more reading time. Clear (page-break) blocks are
+* left untouched so the blank gap between slides stays snappy.
+*/
+const SLIDE_PACE = 1.5;
+const withPace = (block) => {
+	if (typeof block === "string" || isClearBlock(block) || block.pause == null) return block;
+	return {
+		...block,
+		pause: Math.round(block.pause * SLIDE_PACE)
+	};
+};
+/** Apply the dwell multiplier to every block in a deck. */
+const pace = (blocks) => blocks.map(withPace);
+/** A minified production stack trace — the problem source maps solve. */
+const MINIFIED_TRACE = {
+	type: "lines",
+	interval: 400,
+	pause: 7e3,
+	lines: [
+		/* @__PURE__ */ jsx(Text, {
+			color: Colors.error,
+			children: "✘ TypeError: cart is undefined"
+		}),
+		/* @__PURE__ */ jsx(Text, {
+			dimColor: true,
+			children: "    at t.min.js:1:48213"
+		}),
+		/* @__PURE__ */ jsx(Text, {
+			dimColor: true,
+			children: "    at t.min.js:1:9402"
+		}),
+		/* @__PURE__ */ jsx(Text, {
+			dimColor: true,
+			children: "    at t.min.js:1:71150"
+		})
+	]
+};
+/** The same trace, resolved through uploaded source maps. */
+const RESOLVED_TRACE = {
+	type: "lines",
+	interval: 400,
+	pause: 8e3,
+	lines: [
+		/* @__PURE__ */ jsx(Text, {
+			color: Colors.success,
+			children: "✔ TypeError: cart is undefined"
+		}),
+		/* @__PURE__ */ jsxs(Text, { children: [
+			/* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: "    at "
+			}),
+			/* @__PURE__ */ jsx(Text, {
+				color: "cyan",
+				children: "Cart.tsx:42"
+			}),
+			/* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: "  loadCart"
+			})
+		] }),
+		/* @__PURE__ */ jsxs(Text, { children: [
+			/* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: "    at "
+			}),
+			/* @__PURE__ */ jsx(Text, {
+				color: "cyan",
+				children: "App.tsx:88"
+			}),
+			/* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: "   render"
+			})
+		] }),
+		/* @__PURE__ */ jsxs(Text, { children: [
+			/* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: "    at "
+			}),
+			/* @__PURE__ */ jsx(Text, {
+				color: "cyan",
+				children: "index.tsx:5"
+			}),
+			/* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: "  main"
+			})
+		] })
+	]
+};
+/**
+* How a bundle is tied to its map: PostHog injects a chunk-ID marker into the
+* built JS and stamps the matching source map with the same ID.
+*/
+const CHUNK_ID_LINK = {
+	type: "lines",
+	interval: 450,
+	pause: 7500,
+	lines: [
+		/* @__PURE__ */ jsx(Text, {
+			dimColor: true,
+			children: "app.min.js"
+		}),
+		/* @__PURE__ */ jsx(Text, {
+			dimColor: true,
+			children: "  …minified code…"
+		}),
+		/* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
+			color: "cyan",
+			children: "  //# chunkId=a1b2c3d4"
+		}), /* @__PURE__ */ jsx(Text, {
+			dimColor: true,
+			children: "  ← injected"
+		})] }),
+		/* @__PURE__ */ jsx(Text, {
+			dimColor: true,
+			children: "        ↕  matched by id"
+		}),
+		/* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
+			dimColor: true,
+			children: "app.min.js.map"
+		}), /* @__PURE__ */ jsx(Text, {
+			dimColor: true,
+			children: "  ← uploaded"
+		})] })
+	]
+};
+/** Many similar exceptions collapse into a single issue. */
+const GROUPING = {
+	type: "lines",
+	interval: 450,
+	pause: 7e3,
+	lines: [
+		/* @__PURE__ */ jsx(Text, {
+			dimColor: true,
+			children: "exception ─┐"
+		}),
+		/* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
+			dimColor: true,
+			children: "exception ─┼──→ "
+		}), /* @__PURE__ */ jsx(Text, {
+			color: Colors.accent,
+			bold: true,
+			children: "1 issue"
+		})] }),
+		/* @__PURE__ */ jsx(Text, {
+			dimColor: true,
+			children: "exception ─┘"
+		})
+	]
+};
+const getContentBlocks = (store) => pace([
+	{
+		content: "Welcome.",
+		pause: 3e3,
+		mode: 0,
+		animationInterval: 160
+	},
+	{
+		content: "I'm wiring PostHog Error Tracking into your build.",
+		pause: 5e3
+	},
+	{
+		type: "clear",
+		pause: 1500
+	},
+	{
+		content: "When you ship to production, your code gets minified.",
+		pause: 5e3
+	},
+	{
+		content: "Thousands of readable lines collapse into one dense bundle.",
+		pause: 5e3
+	},
+	{
+		content: "So a thrown error gives you a stack trace like this:",
+		pause: 2e3
+	},
+	MINIFIED_TRACE,
+	{
+		content: "Just offsets into a file no human can read.",
+		pause: 5e3
+	},
+	{
+		type: "clear",
+		pause: 1500
+	},
+	{
+		content: "Source maps are the key.",
+		pause: 3500
+	},
+	{
+		content: "They map every position in that bundle back to your original source — the real file, line, and function.",
+		pause: 6e3
+	},
+	{
+		content: "Right now I'm hooking source-map generation and upload into your build, tied to each release you ship.",
+		pause: 6e3
+	},
+	{
+		type: "clear",
+		pause: 1500
+	},
+	{
+		content: "But how does PostHog know which map belongs to which build?",
+		pause: 4500
+	},
+	{
+		content: "During the build, it injects a unique chunk ID into each bundle:",
+		pause: 2500
+	},
+	CHUNK_ID_LINK,
+	{
+		content: "The matching source map is stamped with that same ID before it ships to PostHog.",
+		pause: 6e3
+	},
+	{
+		content: "When an error comes in, PostHog reads the chunk ID off the bundle, finds the map with the exact same ID, and uses it to map each frame back to your source — even for a release you shipped weeks ago.",
+		pause: 8e3
+	},
+	{
+		type: "clear",
+		pause: 1500
+	},
+	{
+		content: "So that same error becomes:",
+		pause: 2e3
+	},
+	RESOLVED_TRACE,
+	{
+		content: "Readable stack traces, straight from production.",
+		pause: 5e3
+	},
+	{
+		content: "You debug a live error like it happened on your own machine.",
+		pause: 6e3
+	},
+	{
+		type: "clear",
+		pause: 1500
+	},
+	{
+		content: "Zooming out — this is how Error Tracking works.",
+		pause: 4e3
+	},
+	{
+		content: "Every error your app throws is captured as an exception.",
+		pause: 5e3
+	},
+	{
+		content: "PostHog groups similar exceptions into a single issue:",
+		pause: 2500
+	},
+	GROUPING,
+	{
+		content: "So a bug that fires ten thousand times is one issue to triage — not ten thousand alerts.",
+		pause: 6500
+	},
+	{
+		type: "clear",
+		pause: 1500
+	},
+	{
+		content: "And this is where source maps earn their keep again.",
+		pause: 4500
+	},
+	{
+		content: "Grouping reads the stack trace. Minified frames all look alike — so unrelated crashes get merged, and one real bug scatters across many issues.",
+		pause: 8e3
+	},
+	{
+		content: "With source maps, PostHog groups on your real frames — so each distinct bug lands as one clean issue.",
+		pause: 7e3
+	},
+	{
+		type: "clear",
+		pause: 1500
+	},
+	{
+		pause: 5e3,
+		persist: true,
+		content: /* @__PURE__ */ jsx(StatusPeekTrigger, { store })
+	},
+	{
+		pause: 9e4,
+		content: /* @__PURE__ */ jsxs(Text, { children: [
+			"Press",
+			" ",
+			/* @__PURE__ */ jsx(Text, {
+				color: Colors.accent,
+				bold: true,
+				children: "S"
+			}),
+			" ",
+			"to follow along — or sit tight, I'll let you know when it's done."
+		] })
+	}
+]);
+//#endregion
+//#region src/lib/programs/error-tracking-upload-source-maps/index.ts
+const REPORT_FILE = "posthog-source-maps-report.md";
+const DOCS_URL = "https://posthog.com/docs/error-tracking/upload-source-maps";
+const errorTrackingUploadSourceMapsConfig = {
+	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,
+	reportFile: REPORT_FILE,
+	getContentBlocks,
+	requires: ["posthog-integration"],
+	run: (session) => {
+		const variant = session.frameworkContext[SOURCE_MAPS_CONTEXT_KEYS.skillVariant];
+		const displayName = session.frameworkContext[SOURCE_MAPS_CONTEXT_KEYS.displayName];
+		const skillId = variant ? `error-tracking-upload-source-maps-${variant}` : void 0;
+		return Promise.resolve({
+			integrationLabel: "error-tracking-upload-source-maps",
+			successMessage: "Source maps wired up!",
+			reportFile: REPORT_FILE,
+			docsUrl: DOCS_URL,
+			spinnerMessage: "Wiring up source maps...",
+			estimatedDurationMinutes: 3,
+			abortCases: SOURCE_MAPS_ABORT_CASES,
+			customPrompt: (ctx) => {
+				if (!skillId || !variant) return SOURCE_MAPS_DETECTION_FAILED_PROMPT;
+				const uiHost = getUiHostFromHost(ctx.host).replace(/\/$/, "");
+				return buildSourceMapsUploadPrompt({
+					displayName,
+					variant,
+					skillId,
+					projectId: ctx.projectId,
+					host: ctx.host,
+					settingsUrl: `${uiHost}/project/${ctx.projectId}/settings/user-api-keys`,
+					uiHost
+				});
+			},
+			postRun: (sess) => {
+				if (variant) sess.frameworkContext["sourceMapsCompletedVariant"] = variant;
+				return Promise.resolve();
+			},
+			buildOutroData: () => {
+				return {
+					kind: "success",
+					message: "Source maps wired up!",
+					reportFile: REPORT_FILE,
+					docsUrl: DOCS_URL
+				};
+			}
+		});
+	}
+};
+//#endregion
 //#region src/lib/programs/mcp/index.ts
 const mcpAddConfig = {
 	id: "mcp-add",
@@ -1473,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",
@@ -1485,18 +2253,39 @@ 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 = {
 	id: "agent-skill",
 	description: "Run an arbitrary context-mill skill",
 	steps: AGENT_SKILL_STEPS,
-	getContentBlocks: getContentBlocks$1,
+	getContentBlocks: getContentBlocks$2,
 	allowedTools: ["Agent"]
 };
 const PROGRAM_REGISTRY = [
 	posthogIntegrationConfig,
 	revenueAnalyticsConfig,
+	errorTrackingUploadSourceMapsConfig,
 	auditConfig,
 	eventsAuditConfig,
 	audit3000Config,
@@ -1504,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
@@ -1514,6 +2304,7 @@ const PROGRAM_REGISTRY = [
 const Program = {
 	PostHogIntegration: posthogIntegrationConfig.id,
 	RevenueAnalyticsSetup: revenueAnalyticsConfig.id,
+	ErrorTrackingUploadSourceMaps: errorTrackingUploadSourceMapsConfig.id,
 	Migration: migrationConfig.id,
 	Audit: auditConfig.id,
 	EventsAudit: eventsAuditConfig.id,
@@ -1521,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
@@ -1537,12 +2329,12 @@ function getSubcommandPrograms() {
 }
 //#endregion
 //#region bin.ts
-const WIZARD_VERSION = VERSION;
-const NODE_VERSION_RANGE = ">=18.17.0";
-if (!satisfies(process.version, NODE_VERSION_RANGE)) {
-	console.log(`PostHog wizard requires Node.js ${NODE_VERSION_RANGE}. You are using Node.js ${process.version}. Please upgrade your Node.js version.`);
+const MIN_NODE_VERSION = ">=18.17.0";
+if (!satisfies(process.version, MIN_NODE_VERSION)) {
+	console.log(`PostHog wizard needs Node.js ${MIN_NODE_VERSION}. Detected ${process.version} — please upgrade Node and re-run.`);
 	process.exit(1);
 }
+const WIZARD_VERSION = VERSION;
 /** Shared yargs options for skill-based program subcommands. */
 const skillSubcommandOptions = {
 	debug: {
@@ -1597,11 +2389,6 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 		describe: "Use local MCP server at http://localhost:8787/mcp\nenv: POSTHOG_WIZARD_LOCAL_MCP",
 		type: "boolean"
 	},
-	ci: {
-		default: false,
-		describe: "Enable CI mode for non-interactive execution\nenv: POSTHOG_WIZARD_CI",
-		type: "boolean"
-	},
 	"api-key": {
 		describe: "PostHog personal API key (phx_xxx) for authentication\nenv: POSTHOG_WIZARD_API_KEY",
 		type: "string"
@@ -1613,6 +2400,11 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 	email: {
 		describe: "Email address for signup (used with --signup)\nenv: POSTHOG_WIZARD_EMAIL",
 		type: "string"
+	},
+	telemetry: {
+		default: true,
+		describe: "Send wizard run state to PostHog (pass --no-telemetry to disable)\nenv: POSTHOG_WIZARD_TELEMETRY",
+		type: "boolean"
 	}
 }).command(["$0"], "Run the PostHog setup wizard", (yargs) => {
 	return yargs.options({
@@ -1710,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-gHqu_MXL.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);
@@ -1732,11 +2524,11 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 					return;
 				}
 			}
-			const { posthogIntegrationConfig } = await import("./posthog-integration-By5930Gz.js").then((n) => n.r);
-			const { FRAMEWORK_REGISTRY } = await import("./registry-DpROZPnl.js").then((n) => n.n);
-			const { detectFramework, gatherFrameworkContext } = await import("./detection-OCF8fpfp.js").then((n) => n.t);
-			const { analytics } = await import("./analytics-Bw8E-yhX.js");
-			const { wizardAbort } = await import("./wizard-abort-CYW83OG5.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) {
@@ -1766,10 +2558,10 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 		});
 	} else if (isNonInteractiveEnvironment()) {
 		getUI().intro(`PostHog Wizard`);
-		getUI().log.error("This installer requires an interactive terminal (TTY) to run.\nIt appears you are running in a non-interactive environment.\nPlease run the wizard in an interactive terminal.\n\nFor CI/CD environments, use --ci mode:\n  npx @posthog/wizard --ci --region us --api-key phx_xxx");
+		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-zZL5y9id.js");
+		const { startPlayground } = await import("./start-playground-B40O4tye.js");
 		startPlayground(WIZARD_VERSION);
 	})();
 	else if (options.skill) (async () => {
@@ -1792,7 +2584,7 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 		});
 	})();
 	else (async () => {
-		const { posthogIntegrationConfig } = await import("./posthog-integration-By5930Gz.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) => {
@@ -1816,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-D5G2PrXW.js");
+			const { readApiKeyFromEnv } = await import("./env-api-key-DU8uIEvo.js");
 			const apiKey = options.apiKey || readApiKeyFromEnv();
 			try {
-				const { startTUI } = await import("./start-tui-Cz7RZSn_.js");
-				const { buildSession } = await import("./wizard-session-CPhhll4P.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,
@@ -1831,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-B48J7VVO.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,
@@ -1849,8 +2641,8 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 		const options = { ...argv };
 		(async () => {
 			try {
-				const { startTUI } = await import("./start-tui-Cz7RZSn_.js");
-				const { buildSession } = await import("./wizard-session-CPhhll4P.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,
@@ -1859,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-B48J7VVO.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({
@@ -1895,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-gHqu_MXL.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`);
@@ -1934,23 +2750,56 @@ for (const programConfig of getSubcommandPrograms()) cli.command(programConfig.c
 	if (options.ci) runWizardCI(programConfig, options);
 	else runWizard(programConfig, options);
 });
-cli.help().alias("help", "h").version().alias("version", "v").wrap(process.stdout.isTTY ? cli.terminalWidth() : 80).argv;
+cli.strictOptions().fail((msg, err) => {
+	throw err || new Error(msg);
+}).help().alias("help", "h").version().alias("version", "v").wrap(process.stdout.isTTY ? cli.terminalWidth() : 80);
+{
+	const argvHasCI = process.argv.slice(2).some((a) => a === "--ci" || a === "--no-ci" || a.startsWith("--ci="));
+	const envHasCI = process.env.POSTHOG_WIZARD_CI != null && process.env.POSTHOG_WIZARD_CI !== "";
+	if (argvHasCI || envHasCI) exitWithProductionCIError();
+}
+try {
+	cli.parse();
+} catch (err) {
+	const RED = "\x1B[31m";
+	const BOLD = "\x1B[1m";
+	const RESET = "\x1B[0m";
+	const message = err instanceof Error ? err.message : String(err);
+	process.stderr.write(`${RED}${BOLD}✖ ${message}${RESET}\n`);
+	process.stderr.write("Run with --help to see available options.\n");
+	process.exit(1);
+}
+function exitWithProductionCIError() {
+	process.stderr.write(`✖ CI mode is not currently supported in published builds.\n`);
+	process.exit(1);
+}
+function resolveNoTelemetry(options) {
+	if (options.telemetry === false) return true;
+	const env = process.env.POSTHOG_WIZARD_NO_TELEMETRY;
+	if (env == null || env === "") return false;
+	const norm = env.toLowerCase();
+	return norm !== "0" && norm !== "false";
+}
 /**
 * Run a full wizard program in the TUI. Handles the full lifecycle: start TUI,
 * build session, run detection, wait for intro gate, execute the
 * agent pipeline, wait for outro dismissal, then exit.
 */
 function runWizard(config, options) {
+	let tui = null;
+	let taskStream = null;
+	let onSignal = null;
+	let exitInProgress = false;
 	(async () => {
 		try {
 			const installDir = options.installDir || process.cwd();
-			const { startTUI } = await import("./start-tui-Cz7RZSn_.js");
-			const { buildSession } = await import("./wizard-session-CPhhll4P.js");
-			const { TaskStreamPush } = await import("./task-stream-DUpUZmFQ.js");
-			const { FileDestination } = await import("./file-BKbKreWF.js");
-			const { PostHogDestination } = await import("./posthog-BbQf_Hzq.js");
-			const { analytics } = await import("./analytics-Bw8E-yhX.js");
-			const tui = startTUI(WIZARD_VERSION, config.id);
+			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({
 				debug: options.debug,
 				forceInstall: options.forceInstall,
@@ -1964,43 +2813,64 @@ function runWizard(config, options) {
 				menu: options.menu,
 				integration: options.integration,
 				benchmark: options.benchmark,
-				yaraReport: options.yaraReport
+				yaraReport: options.yaraReport,
+				noTelemetry: resolveNoTelemetry(options)
 			});
 			session.programLabel = config.id;
 			if (options.skillId) session.skillId = options.skillId;
 			else if (config.skillId) session.skillId = config.skillId;
-			tui.store.session = session;
-			const taskStream = new TaskStreamPush({
-				store: tui.store,
+			activeTui.store.session = session;
+			const taskStreamEnabled = !session.noTelemetry;
+			taskStream = new TaskStreamPush({
+				store: activeTui.store,
 				programId: config.id,
-				destinations: [new FileDestination(), new PostHogDestination()]
+				destinations: [new PostHogDestination({
+					getCredentials: () => activeTui.store.session.credentials,
+					onError: (err) => logToFile("[task-stream-push]", err.message)
+				})],
+				enabled: taskStreamEnabled
 			});
-			tui.store.onTasksChanged = () => void taskStream.push();
-			await tui.store.runReadyHooks();
-			await tui.store.getGate("intro");
-			await tui.store.getGate("health-check");
+			const activeStream = taskStream;
+			activeStream.attach();
+			let signalled = false;
+			onSignal = () => {
+				if (signalled || exitInProgress) return;
+				signalled = true;
+				if (activeTui.store.session.runPhase === RunPhase.Running) activeTui.store.setRunPhase(RunPhase.Error);
+				activeStream.shutdown(2e3).finally(() => {
+					try {
+						activeTui.unmount();
+					} catch {}
+					process.exit(130);
+				});
+			};
+			process.on("SIGINT", onSignal);
+			process.on("SIGTERM", onSignal);
+			await activeTui.store.runReadyHooks();
+			await activeTui.store.getGate("intro");
+			await activeTui.store.getGate("health-check");
 			const skipAgent = config.run == null;
 			if (skipAgent) {
-				const { getOrAskForProjectData } = await import("./setup-utils-ptemIB6g.js");
+				const { getOrAskForProjectData } = await import("./setup-utils-C5uZ9g60.js");
 				const { projectApiKey, host, accessToken, projectId } = await getOrAskForProjectData({
 					signup: session.signup,
 					ci: session.ci,
 					apiKey: session.apiKey,
 					projectId: session.projectId
 				});
-				tui.store.setCredentials({
+				activeTui.store.setCredentials({
 					accessToken,
 					projectApiKey,
 					host,
 					projectId
 				});
 			} else {
-				const { runAgent } = await import("./agent-runner-CK5r-zQF.js");
-				await runAgent(config, tui.store.session);
+				const { runAgent } = await import("./agent-runner-H1FP6XTc.js");
+				await runAgent(config, activeTui.store.session);
 			}
-			const isDone = () => skipAgent ? tui.store.session.outroDismissed : tui.store.session.skillsComplete;
+			const isDone = () => skipAgent ? activeTui.store.session.outroDismissed : activeTui.store.session.skillsComplete;
 			await new Promise((resolve) => {
-				const unsub = tui.store.subscribe(() => {
+				const unsub = activeTui.store.subscribe(() => {
 					if (isDone()) {
 						unsub();
 						resolve();
@@ -2011,15 +2881,26 @@ function runWizard(config, options) {
 					resolve();
 				}
 			});
-			try {
-				await taskStream.dispose();
-			} catch (error) {
-				analytics.captureException(error);
-			}
-			tui.unmount();
+			exitInProgress = true;
+			await activeStream.shutdown(2e3);
+			process.off("SIGINT", onSignal);
+			process.off("SIGTERM", onSignal);
+			activeTui.unmount();
 			process.exit(0);
 		} catch (err) {
 			if (runtimeEnv("DEBUG") || runtimeEnv("POSTHOG_WIZARD_DEBUG")) console.error("TUI init failed:", err);
+			exitInProgress = true;
+			if (onSignal) {
+				process.off("SIGINT", onSignal);
+				process.off("SIGTERM", onSignal);
+			}
+			if (taskStream) try {
+				await taskStream.shutdown(2e3);
+			} catch {}
+			if (tui) try {
+				tui.unmount();
+			} catch {}
+			process.exit(1);
 		}
 	})();
 }
@@ -2046,11 +2927,11 @@ function runWizardCI(config, options, preRun) {
 	}
 	(async () => {
 		const path = await import("path");
-		const { buildSession } = await import("./wizard-session-CPhhll4P.js");
+		const { buildSession } = await import("./wizard-session-DPGTaJ4W.js");
 		const { readEnvironment } = await Promise.resolve().then(() => environment_exports);
-		const { readApiKeyFromEnv } = await import("./env-api-key-D5G2PrXW.js");
-		const { configureLogFileFromEnvironment, logToFile } = await import("./debug-B_PK52GI.js");
-		const { wizardAbort, WizardError } = await import("./wizard-abort-CYW83OG5.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;
@@ -2069,6 +2950,7 @@ function runWizardCI(config, options, preRun) {
 			projectId: options.projectId,
 			benchmark: options.benchmark,
 			yaraReport: options.yaraReport,
+			noTelemetry: resolveNoTelemetry(options),
 			...env
 		});
 		session.programLabel = config.id;
@@ -2100,7 +2982,7 @@ function runWizardCI(config, options, preRun) {
 					})
 				});
 			}
-			const { runAgent } = await import("./agent-runner-CK5r-zQF.js");
+			const { runAgent } = await import("./agent-runner-H1FP6XTc.js");
 			await runAgent(config, session);
 		} catch (error) {
 			const errorMessage = error instanceof Error ? error.message : String(error);
@@ -2118,6 +3000,6 @@ function runWizardCI(config, options, preRun) {
 	});
 }
 //#endregion
-export { getKindMeta as a, POSTHOG_SDKS as c, getContentBlocks as i, STRIPE_SDKS as l, Program as n, fetchHealthIssues as o, getProgramConfig as r, getContentBlocks$1 as s, PROGRAM_REGISTRY as t };
+export { SOURCE_MAPS_CONTEXT_KEYS as a, fetchHealthIssues as c, STRIPE_SDKS as d, DISPLAY_NAME as i, getContentBlocks$2 as l, Program as n, getContentBlocks$1 as o, getProgramConfig as r, getKindMeta as s, PROGRAM_REGISTRY as t, POSTHOG_SDKS$1 as u };
 
 //# sourceMappingURL=bin.js.map