@posthog/wizard 2.35.0 → 2.37.0

package/dist/bin.js

@@ -1,24 +1,25 @@
 #!/usr/bin/env node
-import { $ as getSkillsBaseUrl, I as POSTHOG_DOCS_URL, Z as WIZARD_USER_AGENT, a as getLogFilePath, et as VERSION, h as LoggingUI, m as setUI, p as getUI, r as debug, s as logToFile } from "./debug-DXWxKT5f.js";
-import { t as analytics } from "./analytics-DP_j88IC.js";
-import { r as setEntryCommand } from "./telemetry-CR-ilpWe.js";
-import { n as isUsingTypeScript } from "./setup-utils-DyTlaGOV.js";
-import { o as getUiHostFromHost } from "./urls-ChWit8SE.js";
-import { t as HostResolution } from "./host-resolution-Dw0fS8h5.js";
-import { o as handleApiError } from "./api-Bdxv7mWH.js";
-import "./wizard-session-BHoLQueN.js";
-import { r as runCleanups } from "./wizard-abort-BE_j8xUt.js";
-import { n as isNonInteractiveEnvironment } from "./environment-C4HyCWTC.js";
-import { D as AUDIT_CHECKS_KEY, E as AUDIT_CHECKS_FILE, O as AUDIT_REPORT_FILE, f as AgentSignals, l as recoverOrphanedSettingsBackups, v as SETUP_REPORT_FILE, x as fetchSkillMenu, y as WIZARD_TOOL_NAMES } from "./agent-interface-CXL9i_vX.js";
-import { i as SPINNER_MESSAGE } from "./registry-Dj17F0a-.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-Bj9WmwDq.js";
-import { n as safeReadFile, r as walkProjectFiles, t as IGNORED_DIRS } from "./file-utils-CW8XbbZP.js";
-import { n as readApiKeyFromEnv } from "./env-api-key-B3gE9Un0.js";
+import { $ as getSkillsBaseUrl, I as POSTHOG_DOCS_URL, Z as WIZARD_USER_AGENT, a as getLogFilePath, et as VERSION, h as LoggingUI, j as Integration, m as setUI, p as getUI, r as debug, s as logToFile } from "./debug-CZwmzyDx.js";
+import { t as analytics } from "./analytics-Du8Z_3oX.js";
+import { r as setEntryCommand } from "./telemetry-DJNpvkYP.js";
+import { n as isUsingTypeScript } from "./setup-utils-CR8X8Fmf.js";
+import { o as getUiHostFromHost } from "./urls-B1a2v93j.js";
+import { t as HostResolution } from "./host-resolution-DrOzdKdY.js";
+import { o as handleApiError } from "./api-BqKMQVhj.js";
+import "./wizard-session-CqihOtk3.js";
+import { r as runCleanups } from "./wizard-abort-BG8VNOI9.js";
+import { n as isNonInteractiveEnvironment } from "./environment-BRXwshJO.js";
+import { D as AUDIT_CHECKS_FILE, O as AUDIT_CHECKS_KEY, f as AgentSignals, k as AUDIT_REPORT_FILE, l as recoverOrphanedSettingsBackups, v as SETUP_REPORT_FILE, x as fetchSkillMenu, y as WIZARD_TOOL_NAMES } from "./agent-interface-D8jnkEnB.js";
+import { n as runAgent, r as authenticate } from "./agent-runner-BxIYcxmA.js";
+import { i as SPINNER_MESSAGE, t as FRAMEWORK_REGISTRY } from "./registry-B43CNAAx.js";
+import { _ as gatherFrameworkContext, a as LINE_CHART_BLOCK, b as parseRequirementsTxt, g as detectProjectsWithAgent, h as HEALTH_CHECK_STEP, i as FUNNEL_BLOCK, m as Icons, n as integrationRunStep, o as PRODUCT_SUITE_BLOCK, p as Colors, r as posthogIntegrationConfig, s as StatusPeekTrigger, u as isClearBlock, v as parsePipfile, y as parsePyprojectToml } from "./posthog-integration-Cx4RvC7E.js";
+import { n as safeReadFile, r as walkProjectFiles, t as IGNORED_DIRS } from "./file-utils-D6CWLaOm.js";
+import { n as readApiKeyFromEnv } from "./env-api-key-Db-mNPK2.js";
 import { satisfies } from "semver";
 import yargs from "yargs";
 import { hideBin } from "yargs/helpers";
 import fs, { existsSync, readFileSync, readdirSync, statSync } from "fs";
-import path, { join, relative } from "path";
+import path, { join, relative, resolve } from "path";
 import * as os from "node:os";
 import * as path$1 from "node:path";
 import { spawnSync } from "node:child_process";
@@ -234,7 +235,7 @@ function runProvision(argv) {
 }
 async function provision({ email, region, name, baseUrl, jsonMode }) {
 	try {
-		const { provisionNewAccount } = await import("./provisioning-BF2reo5_.js").then((n) => n.n);
+		const { provisionNewAccount } = await import("./provisioning-PosLaOt4.js").then((n) => n.n);
 		if (!jsonMode) getUI().log.info(`Provisioning account for ${email} in ${region}...`);
 		emitResult(await provisionNewAccount(email, name, region, { baseUrl }), jsonMode);
 		process.exit(0);
@@ -299,22 +300,22 @@ const basicIntegrationCommand = {
 		setEntryCommand("integrate");
 		(async () => {
 			if (isHeadless(argv)) {
-				const { runHeadlessInstall } = await import("./ci-install-BO-KLPLD.js");
+				const { runHeadlessInstall } = await import("./ci-install-UlWb3u5t.js");
 				return runHeadlessInstall(argv);
 			}
 			if (argv.ci) {
-				const { runCIInstall } = await import("./ci-install-BO-KLPLD.js");
+				const { runCIInstall } = await import("./ci-install-UlWb3u5t.js");
 				return runCIInstall(argv);
 			}
 			if (isNonInteractiveEnvironment()) {
-				const { failNonInteractive } = await import("./non-interactive-BW-MZYrP.js");
+				const { failNonInteractive } = await import("./non-interactive-BI5b25U7.js");
 				return failNonInteractive();
 			}
 			if (argv.playground) {
-				const { runPlayground } = await import("./playground-xuLBqzJM.js");
+				const { runPlayground } = await import("./playground-DDYYs2ub.js");
 				return runPlayground();
 			}
-			const { runInteractive } = await import("./interactive-pwrc7QM-.js");
+			const { runInteractive } = await import("./interactive-CXL8oJwb.js");
 			runInteractive(argv);
 		})();
 	}
@@ -3277,6 +3278,48 @@ const errorTrackingUploadSourceMapsConfig = {
 * PostHog-side flags (`product-autonomy`, `signals-scout`) are unchanged by
 * the wizard-side "self-driving" rename.
 */
+/** frameworkContext key holding the deterministic PostHog-presence result. */
+const POSTHOG_PRESENT_KEY = "postHogPresent";
+/**
+* frameworkContext key holding the repo-relative path of the project the user
+* picked on the integration-detect screen ("." for the repo root). The
+* integrate-run phase scopes its install dir to this so a monorepo integrates
+* into the chosen sub-app, not the root.
+*/
+const SELF_DRIVING_INTEGRATE_PATH_KEY = "selfDrivingIntegratePath";
+const POSTHOG_PACKAGE_RE = /(^|["'\s/=])posthog/im;
+/**
+* Deterministic, offline check: does the project already have a PostHog SDK?
+* Scans the common dependency manifests at the install dir for a `posthog`
+* package — the same signal the agentic detector reports as `hasPostHog`, but
+* instant and credential-free. Drives whether self-driving asks to integrate
+* first ("not found") or proceeds straight to setup ("found").
+*/
+function detectPostHogPresent(installDir) {
+	const manifests = [
+		"package.json",
+		"requirements.txt",
+		"pyproject.toml",
+		"Pipfile",
+		"Gemfile",
+		"go.mod",
+		"composer.json",
+		"pubspec.yaml"
+	];
+	for (const dir of [
+		".",
+		"app",
+		"frontend",
+		"backend"
+	]) for (const name of manifests) {
+		const path = join(installDir, dir, name);
+		if (!existsSync(path)) continue;
+		try {
+			if (POSTHOG_PACKAGE_RE.test(readFileSync(path, "utf8"))) return true;
+		} catch {}
+	}
+	return false;
+}
 /**
 * `[ABORT] <reason>` cases the self-driving skill can emit. The
 * reason strings are part of the skill contract — the context-mill
@@ -3337,9 +3380,110 @@ function detectSelfDrivingPrerequisites(session, setFrameworkContext) {
 		});
 		return;
 	}
+	setFrameworkContext(POSTHOG_PRESENT_KEY, detectPostHogPresent(installDir));
+}
+//#endregion
+//#region src/lib/programs/self-driving/detect-agentic.ts
+/**
+* Agentic (Haiku) detection for self-driving's integration phase.
+*
+* Mirrors source-maps: the integration-detect screen runs `detectSelfDriving-
+* IntegrationProjects` (the shared Haiku detector with the integration framework
+* targets), shows a project map, and the user picks one. This file supplies the
+* targets, maps the result back to `Integration`s, and classifies each project
+* as instrumentable (a framework the wizard supports that doesn't already have
+* PostHog). The screen writes the choice to the session; `prepSelfDriving-
+* Integration` then gathers the chosen project's framework context before the
+* integration agent runs (the runner scopes the install dir).
+*/
+/** Integration framework targets for the agentic detector (id → display name). */
+const INTEGRATION_TARGETS = Object.entries(FRAMEWORK_REGISTRY).map(([id, config]) => ({
+	id,
+	name: config.metadata.name
+}));
+const INTEGRATION_IDS = new Set(Object.values(Integration));
+function classify(integration, hasPostHog) {
+	if (integration == null) return {
+		instrumentable: false,
+		reason: "Not a framework the wizard can set up yet"
+	};
+	if (hasPostHog) return {
+		instrumentable: false,
+		reason: "Already has the PostHog SDK"
+	};
+	return { instrumentable: true };
+}
+/** Map a generic detection report into classified integration projects. */
+function toIntegrationReport(report) {
+	return {
+		repoType: report.repoType,
+		projects: report.projects.map((p) => {
+			const integration = p.targetId && INTEGRATION_IDS.has(p.targetId) ? p.targetId : null;
+			return {
+				path: p.path,
+				framework: p.framework,
+				integration,
+				hasPostHog: p.hasPostHog,
+				...classify(integration, p.hasPostHog)
+			};
+		})
+	};
+}
+/** Run the Haiku detector over the repo and classify projects for integration. */
+async function detectSelfDrivingIntegrationProjects(session, onEvent) {
+	return toIntegrationReport(await detectProjectsWithAgent(session, {
+		targets: INTEGRATION_TARGETS,
+		purpose: "set up a PostHog SDK integration",
+		onEvent
+	}));
+}
+/**
+* Prepare the integration phase after the user picked a project on the
+* integration-detect screen (which set `session.integration`, `frameworkConfig`,
+* and the chosen path). Scopes `installDir` to the chosen project — so a
+* monorepo integrates into the picked sub-app — and gathers that project's
+* framework context, mirroring posthog-integration's `ciPreRun`. Used as the
+* integrate-run step's `onRunPrep`.
+*/
+async function prepSelfDrivingIntegration(session) {
+	const frameworkConfig = session.frameworkConfig;
+	if (!frameworkConfig) return;
+	const context = await gatherFrameworkContext(frameworkConfig, {
+		installDir: session.installDir,
+		debug: session.debug,
+		default: false,
+		signup: session.signup,
+		localMcp: session.localMcp,
+		ci: session.ci,
+		benchmark: session.benchmark,
+		yaraReport: session.yaraReport
+	});
+	for (const [key, value] of Object.entries(context)) if (!(key in session.frameworkContext)) session.frameworkContext[key] = value;
 }
 //#endregion
 //#region src/lib/programs/self-driving/steps.ts
+/**
+* Self-driving program step list.
+*
+* detect → intro → integration-check → health-check → auth → integrate-detect →
+* integrate-run → self-driving-handoff → run → outro. A deterministic check in
+* `detect` decides whether PostHog is already in the project: found → the
+* integration screens are skipped and the integrate-run phase never shows; not
+* found → integration-check reports it and the only action sets up PostHog.
+* After auth, `integrate-detect` runs the Haiku detector and has the user pick
+* which project to set PostHog up in (a monorepo can have several);
+* `integrate-run` then runs the real integration program's agent (its own task
+* list) in that project. `self-driving-handoff` then bridges to Self-driving
+* ("PostHog is installed — now set up Self-driving") before the Self-driving
+* run. No keep-skills step: the setup skill is transient, so postRun removes it.
+*/
+/** True once detection found PostHog already present in the project. */
+const postHogPresent = (session) => session.frameworkContext[POSTHOG_PRESENT_KEY] === true;
+/** Absolute dir to integrate into: the picked sub-app, else the repo root. */
+const integrationDir = (session) => {
+	const rel = session.frameworkContext[SELF_DRIVING_INTEGRATE_PATH_KEY];
+	return typeof rel === "string" && rel !== "." ? resolve(session.installDir, rel) : session.installDir;
+};
 const SELF_DRIVING_PROGRAM = [
 	{
 		id: "detect",
@@ -3352,6 +3496,14 @@ const SELF_DRIVING_PROGRAM = [
 		screenId: "self-driving-intro",
 		gate: (session) => session.setupConfirmed
 	},
+	{
+		id: "integration-check",
+		label: "Integration",
+		screenId: "self-driving-integration-check",
+		show: (session) => !postHogPresent(session) && session.integrate === null,
+		isComplete: (session) => postHogPresent(session) || session.integrate !== null,
+		gate: (session) => postHogPresent(session) || session.integrate !== null
+	},
 	HEALTH_CHECK_STEP,
 	{
 		id: "auth",
@@ -3359,6 +3511,28 @@ const SELF_DRIVING_PROGRAM = [
 		screenId: "auth",
 		isComplete: (session) => session.credentials !== null
 	},
+	{
+		id: "integrate-detect",
+		label: "Detecting",
+		screenId: "self-driving-integration-detect",
+		show: (session) => session.integrate === true && session.integration == null,
+		isComplete: (session) => session.integration != null
+	},
+	{
+		...integrationRunStep,
+		id: "integrate-run",
+		onRunPrep: prepSelfDrivingIntegration,
+		targetDir: integrationDir,
+		show: (session) => session.integrate === true,
+		isComplete: (session) => session.completedRuns.includes("integrate-run")
+	},
+	{
+		id: "self-driving-handoff",
+		label: "Ready",
+		screenId: "self-driving-handoff",
+		show: (session) => session.integrate === true,
+		isComplete: (session) => session.selfDrivingHandoffConfirmed
+	},
 	{
 		id: "run",
 		label: "Self-driving",
@@ -3380,6 +3554,10 @@ const SELF_DRIVING_PROGRAM = [
 * every step (which MCP tools to call, which sources/scouts apply, how
 * to verify); this prompt carries the order, the wizard-specific
 * mechanics (wizard_ask, abort signals), and the project URLs.
+*
+* Integration (when the project has no PostHog yet) runs as a separate phase
+* before this — the real integration program, with its own screens and task
+* list — so this prompt only covers the Self-driving steps.
 */
 function buildSelfDrivingPrompt(ctx) {
 	const uiHost = getUiHostFromHost(ctx.host).replace(/\/$/, "");
@@ -3418,11 +3596,12 @@ tasks, in this order:
   1. Check Self-driving access
   2. Read project and current Self-driving state
   3. Connect GitHub (required)
+  3b. Enable products (replay, error tracking, support)
   4. Enable signal sources
   5. Offer issue-tracker integrations
   6. Configure the scout troop
-  7. Design custom scouts
-  8. Write report and hand off
+  6b. Design custom scouts
+  7. Write report and hand off
 Drive the list with TaskUpdate — mark a task in_progress when you start
 it and completed when done. If a step turns out to be a no-op (e.g.
 GitHub is already connected), still mark its task completed.
@@ -3470,6 +3649,19 @@ STEP 3 — Connect GitHub. REQUIRED. (skill: "Connect GitHub")
    ${AgentSignals.ABORT} github connection declined
    and halt — never finish setup without GitHub.
 
+STEP 3b — Enable products. (skill: "Enable products")
+   Turn ON the PostHog products Signals reads from — Session Replay,
+   Error Tracking, and Support — so the sources you enable next have data
+   to read. These are server-side enables with conservative defaults
+   (owned by the server, not you). The project-state block above covers
+   only Session Replay and Error Tracking, so you can skip those if they
+   are already ON; it does not show Support, but every enable is idempotent
+   so enabling any of them again is safe regardless. For a web app, also
+   make sure this repo's posthog-js
+   init doesn't disable them; for a pure backend or mobile app the server
+   flip is inert, so just record that for the report and move on. The skill
+   names the exact tool and the per-platform detail.
+
 STEP 4 — Enable signal sources. (skill: "Enable sources")
    Enable the sources that match what this product actually uses, per
    the skill. Never enable a source for a tool the user hasn't
@@ -3489,7 +3681,7 @@ STEP 6 — Configure the scout troop. (skill: "Scouts")
    scout plus the one or two specialists for the products this project
    uses most — and disable the rest, per the skill.
 
-STEP 7 — Design custom scouts for this product. (skill: "Custom scouts")
+STEP 6b — Design custom scouts for this product. (skill: "Custom scouts")
    You are the only actor that has read this repo — turn that into
    coverage per the skill: a real gap analysis of the project's
    watchable surfaces against what the built-in troop already covers,
@@ -3503,7 +3695,7 @@ STEP 7 — Design custom scouts for this product. (skill: "Custom scouts")
    no gap at all) is a valid outcome, not an abort. Mark the task
    completed either way.
 
-STEP 8 — Write the report and hand off. (skill: "Report")
+STEP 7 — Write the report and hand off. (skill: "Report")
    Write the report per the skill, including follow-ups for anything
    deferred. Tell the user findings will start appearing in their inbox
    at ${inboxUrl} within about 30 minutes.`;
@@ -3843,13 +4035,13 @@ const mcpAddCommand = {
 function runMcpAdd(argv) {
 	const features = parseFeatures(argv.features);
 	(async () => {
-		const { readApiKeyFromEnv } = await import("./env-api-key-B3gE9Un0.js").then((n) => n.t);
+		const { readApiKeyFromEnv } = await import("./env-api-key-Db-mNPK2.js").then((n) => n.t);
 		const apiKey = argv.apiKey || readApiKeyFromEnv();
 		const debug = argv.debug;
 		const localMcp = argv.local;
 		try {
-			const { startTUI } = await import("./start-tui-S4fBBfmO.js");
-			const { buildSession } = await import("./wizard-session-D0PJ9lsl.js");
+			const { startTUI } = await import("./start-tui-DeewAqJg.js");
+			const { buildSession } = await import("./wizard-session-xzqycI7i.js");
 			const tui = startTUI(VERSION, Program.McpAdd);
 			tui.store.session = buildSession({
 				debug,
@@ -3861,7 +4053,7 @@ function runMcpAdd(argv) {
 		} catch (error) {
 			if (!isTUIUnavailable(error)) throw error;
 			setUI(new LoggingUI());
-			const { addMCPServerToClientsStep } = await import("./add-mcp-server-to-clients-to65gLPl.js").then((n) => n.r);
+			const { addMCPServerToClientsStep } = await import("./add-mcp-server-to-clients-CNn9br9l.js").then((n) => n.r);
 			await addMCPServerToClientsStep({
 				local: localMcp,
 				features,
@@ -3900,8 +4092,8 @@ function runMcpRemove(argv) {
 		const debug = argv.debug;
 		const localMcp = argv.local;
 		try {
-			const { startTUI } = await import("./start-tui-S4fBBfmO.js");
-			const { buildSession } = await import("./wizard-session-D0PJ9lsl.js");
+			const { startTUI } = await import("./start-tui-DeewAqJg.js");
+			const { buildSession } = await import("./wizard-session-xzqycI7i.js");
 			const tui = startTUI(VERSION, Program.McpRemove);
 			tui.store.session = buildSession({
 				debug,
@@ -3910,7 +4102,7 @@ function runMcpRemove(argv) {
 			});
 		} catch {
 			setUI(new LoggingUI());
-			const { removeMCPServerFromClientsStep } = await import("./add-mcp-server-to-clients-to65gLPl.js").then((n) => n.r);
+			const { removeMCPServerFromClientsStep } = await import("./add-mcp-server-to-clients-CNn9br9l.js").then((n) => n.r);
 			await removeMCPServerFromClientsStep({ local: localMcp });
 		}
 	})();
@@ -3932,8 +4124,8 @@ function runMcpTutorial(argv) {
 		const debug = argv.debug;
 		const localMcp = argv.local;
 		try {
-			const { startTUI } = await import("./start-tui-S4fBBfmO.js");
-			const { buildSession } = await import("./wizard-session-D0PJ9lsl.js");
+			const { startTUI } = await import("./start-tui-DeewAqJg.js");
+			const { buildSession } = await import("./wizard-session-xzqycI7i.js");
 			const tui = startTUI(VERSION, Program.McpTutorial);
 			tui.store.session = buildSession({
 				debug,
@@ -3975,6 +4167,31 @@ function resolveNoTelemetry(options) {
 //#endregion
 //#region src/lib/runners/run-wizard.ts
 const WIZARD_VERSION = VERSION;
+/** The session a run step's agent runs in: scoped to the step's target dir
+* (e.g. a monorepo sub-app) with its own framework context, after any prep.
+* A step without `targetDir` runs in the live session, unchanged. */
+async function prepareRunSession(step, live) {
+	const session = step.targetDir ? {
+		...live,
+		installDir: step.targetDir(live),
+		frameworkContext: { ...live.frameworkContext }
+	} : live;
+	if (step.onRunPrep) await step.onRunPrep(session);
+	return session;
+}
+/** Advance one step of a composed run to completion: the auth screen
+* authenticates (every later run reuses it); a step carrying its own `run`
+* thunk runs that agent in its dir and is recorded in `completedRuns`; the
+* host program's own run screen runs `config.run`; any other screen waits for
+* the user to satisfy `isComplete`. */
+async function advanceStep(step, store, config) {
+	if (step.screenId === "auth") await authenticate(store.session, config.id);
+	else if (step.run) {
+		await step.run(await prepareRunSession(step, store.session));
+		store.completeRunStep(step.id);
+	} else if (step.screenId === "run") await runAgent(config, await prepareRunSession(step, store.session));
+	else if (step.isComplete) await store.waitUntil(step.isComplete);
+}
 /**
 * Run a full wizard program in the TUI. Handles the full lifecycle: start TUI,
 * build session, run detection, wait for intro gate, execute the
@@ -3988,9 +4205,9 @@ function runWizard(config, options) {
 	(async () => {
 		try {
 			const installDir = options.installDir || process.cwd();
-			const { startTUI } = await import("./start-tui-S4fBBfmO.js");
-			const { buildSession, RunPhase } = await import("./wizard-session-D0PJ9lsl.js");
-			const { TaskStreamPush } = await import("./task-stream-BVF6gi8x.js");
+			const { startTUI } = await import("./start-tui-DeewAqJg.js");
+			const { buildSession, RunPhase } = await import("./wizard-session-xzqycI7i.js");
+			const { TaskStreamPush } = await import("./task-stream-DkbGqxZv.js");
 			const { PostHogDestination } = await import("./posthog-BrLFkaji.js");
 			tui = startTUI(WIZARD_VERSION, config.id);
 			const activeTui = tui;
@@ -4006,7 +4223,8 @@ function runWizard(config, options) {
 				baseUrl: options.baseUrl,
 				benchmark: options.benchmark,
 				yaraReport: options.yaraReport,
-				noTelemetry: resolveNoTelemetry(options)
+				noTelemetry: resolveNoTelemetry(options),
+				integrate: options.integrate
 			});
 			session.programLabel = config.id;
 			if (options.skillId) session.skillId = options.skillId;
@@ -4042,10 +4260,16 @@ function runWizard(config, options) {
 			process.on("SIGTERM", onSignal);
 			await activeTui.store.runReadyHooks();
 			await activeTui.store.getGate("intro");
+			await activeTui.store.getGate("integration-check");
 			await activeTui.store.getGate("health-check");
 			const skipAgent = config.run == null;
-			if (skipAgent) {
-				const { getOrAskForProjectData } = await import("./setup-utils-DyTlaGOV.js").then((n) => n.r);
+			const shown = (s) => !s.show || s.show(activeTui.store.session);
+			if (config.steps.some((s) => s.run)) for (const step of config.steps) {
+				if (step.screenId === "outro") break;
+				if (shown(step)) await advanceStep(step, activeTui.store, config);
+			}
+			else if (skipAgent) {
+				const { getOrAskForProjectData } = await import("./setup-utils-CR8X8Fmf.js").then((n) => n.r);
 				const { projectApiKey, host, accessToken, projectId } = await getOrAskForProjectData({
 					signup: session.signup,
 					ci: session.ci,
@@ -4060,10 +4284,7 @@ function runWizard(config, options) {
 					host,
 					projectId
 				});
-			} else {
-				const { runAgent } = await import("./agent-runner-CCTTG_Rn.js");
-				await runAgent(config, activeTui.store.session);
-			}
+			} else await runAgent(config, activeTui.store.session);
 			const isDone = () => skipAgent ? activeTui.store.session.outroDismissed : activeTui.store.session.skillsComplete;
 			await new Promise((resolve) => {
 				const unsub = activeTui.store.subscribe(() => {
@@ -4150,11 +4371,11 @@ function runNonInteractive(config, options, mode) {
 	analytics.setTag("build", mode);
 	(async () => {
 		const path = await import("path");
-		const { buildSession, RunPhase, OutroKind } = await import("./wizard-session-D0PJ9lsl.js");
-		const { readEnvironment } = await import("./environment-C4HyCWTC.js").then((n) => n.t);
-		const { readApiKeyFromEnv } = await import("./env-api-key-B3gE9Un0.js").then((n) => n.t);
-		const { configureLogFileFromEnvironment, logToFile } = await import("./debug-Clw8ctxh.js");
-		const { wizardAbort, WizardError } = await import("./wizard-abort-CNYxdjJl.js");
+		const { buildSession, RunPhase, OutroKind } = await import("./wizard-session-xzqycI7i.js");
+		const { readEnvironment } = await import("./environment-BRXwshJO.js").then((n) => n.t);
+		const { readApiKeyFromEnv } = await import("./env-api-key-Db-mNPK2.js").then((n) => n.t);
+		const { configureLogFileFromEnvironment, logToFile } = await import("./debug-B4AH8Ahp.js");
+		const { wizardAbort, WizardError } = await import("./wizard-abort-DyAGpw-u.js");
 		configureLogFileFromEnvironment();
 		const env = readEnvironment();
 		const apiKey = options.apiKey ?? readApiKeyFromEnv() ?? void 0;
@@ -4182,9 +4403,9 @@ function runNonInteractive(config, options, mode) {
 		let store = null;
 		let taskStream = null;
 		if (mode === "headless") {
-			const { WizardStore } = await import("./store-vr5j37CU.js").then((n) => n.n);
-			const { HeadlessUI } = await import("./headless-ui-BoZYhNpE.js");
-			const { TaskStreamPush, PostHogDestination } = await import("./task-stream-BVF6gi8x.js");
+			const { WizardStore } = await import("./store-0uzey9Am.js").then((n) => n.n);
+			const { HeadlessUI } = await import("./headless-ui-DvkogF0b.js");
+			const { TaskStreamPush, PostHogDestination } = await import("./task-stream-DkbGqxZv.js");
 			store = new WizardStore(config.id);
 			store.session = session;
 			setUI(new HeadlessUI(store));
@@ -4239,7 +4460,7 @@ function runNonInteractive(config, options, mode) {
 					});
 				}
 			}
-			const { runAgent } = await import("./agent-runner-CCTTG_Rn.js");
+			const { runAgent } = await import("./agent-runner-BxIYcxmA.js").then((n) => n.t);
 			await runAgent(config, session);
 			await settleStream(RunPhase.Completed);
 		} catch (error) {
@@ -5166,7 +5387,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-DyTlaGOV.js").then((n) => n.r);
+		const { getOrAskForProjectData } = await import("./setup-utils-CR8X8Fmf.js").then((n) => n.r);
 		const { host, accessToken, projectId } = await getOrAskForProjectData({
 			signup: false,
 			ci: true,
@@ -5184,7 +5405,7 @@ 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-Bdxv7mWH.js").then((n) => n.n);
+		const { ApiError } = await import("./api-BqKMQVhj.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);
@@ -5228,6 +5449,11 @@ const selfDrivingCommand = {
 	description: selfDrivingConfig.description,
 	options: {
 		...skillProgramOptions,
+		integrate: {
+			describe: "Integrate the PostHog SDK first, then set up Self-driving — skips the \"do you already have PostHog?\" question. Use when the project isn't set up yet.",
+			type: "boolean",
+			default: false
+		},
 		...selfDrivingConfig.cliOptions ?? {}
 	},
 	check: (argv) => {
@@ -5261,8 +5487,8 @@ function runSlackConnect(argv) {
 	(async () => {
 		const debug = argv.debug;
 		try {
-			const { startTUI } = await import("./start-tui-S4fBBfmO.js");
-			const { buildSession } = await import("./wizard-session-D0PJ9lsl.js");
+			const { startTUI } = await import("./start-tui-DeewAqJg.js");
+			const { buildSession } = await import("./wizard-session-xzqycI7i.js");
 			const tui = startTUI(VERSION, Program.SlackConnect);
 			tui.store.session = buildSession({
 				debug,
@@ -5643,6 +5869,6 @@ function resolveInstallDir() {
 }
 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 { 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 };
+export { STRIPE_SDKS as C, POSTHOG_SDKS as S, SOURCE_MAPS_CONTEXT_KEYS as _, ConfirmButton as a, getDetectedWarehouseSources as b, runWizardCI as c, Program as d, getProgramConfig as f, DISPLAY_NAME as g, AUTOMATABLE_VARIANTS as h, useKeyboardHintsContext as i, runWizard as l, SELF_DRIVING_INTEGRATE_PATH_KEY as m, useKeyBindings as n, PromptLabel as o, detectSelfDrivingIntegrationProjects as p, KeyboardHintsProvider as r, runWizardHeadless as s, PickerMenu as t, PROGRAM_REGISTRY as u, getKindMeta as v, getContentBlocks$2 as x, fetchHealthIssues as y };
 
 //# sourceMappingURL=bin.js.map