@posthog/wizard 2.34.0 → 2.36.0

package/dist/bin.js

@@ -1,23 +1,25 @@
 #!/usr/bin/env node
-import { I as POSTHOG_DOCS_URL, Q as WIZARD_USER_AGENT, a as getLogFilePath, et as getSkillsBaseUrl, h as LoggingUI, m as setUI, p as getUI, r as debug, s as logToFile, tt as VERSION } from "./debug-Cn4L5Ype.js";
-import { t as analytics } from "./analytics-DQ8IS1Hu.js";
-import { r as setEntryCommand } from "./telemetry-BTLJ-YnG.js";
-import { n as isUsingTypeScript } from "./setup-utils-B0oz3raQ.js";
-import { a as getUiHostFromHost, n as getCloudUrlFromRegion } from "./urls-DAVzgHGZ.js";
-import { o as handleApiError } from "./api-EghEV_u9.js";
-import "./wizard-session-CN55LYyZ.js";
-import { r as runCleanups } from "./wizard-abort-DqeMgCVr.js";
-import { n as isNonInteractiveEnvironment } from "./environment-D2WUIm8o.js";
-import { D as AUDIT_REPORT_FILE, E as AUDIT_CHECKS_KEY, T as AUDIT_CHECKS_FILE, _ as SETUP_REPORT_FILE, b as fetchSkillMenu, f as AgentSignals, l as recoverOrphanedSettingsBackups, v as WIZARD_TOOL_NAMES } from "./agent-interface-BcUv1qeh.js";
-import { i as SPINNER_MESSAGE } from "./registry-BfTeAX2z.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-C3m_uR5A.js";
-import { n as safeReadFile, r as walkProjectFiles, t as IGNORED_DIRS } from "./file-utils-CdQn6073.js";
-import { n as readApiKeyFromEnv } from "./env-api-key-MlzJYAvt.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-BpWrz3hX.js";
+import { t as analytics } from "./analytics-Be_wRgxD.js";
+import { r as setEntryCommand } from "./telemetry-D5WQ4-Ic.js";
+import { n as isUsingTypeScript } from "./setup-utils-BxdW2R0r.js";
+import { o as getUiHostFromHost } from "./urls-DpTCPWLD.js";
+import { t as HostResolution } from "./host-resolution-BD6TcZG0.js";
+import { o as handleApiError } from "./api-C_R_ybiA.js";
+import "./wizard-session-CqihOtk3.js";
+import { r as runCleanups } from "./wizard-abort-t41wO4Bh.js";
+import { n as isNonInteractiveEnvironment } from "./environment-Dc6VTWyK.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-CPn9pZ8j.js";
+import { n as runAgent, r as authenticate } from "./agent-runner-Cic1uZZ8.js";
+import { i as SPINNER_MESSAGE, t as FRAMEWORK_REGISTRY } from "./registry-DFazVUSE.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-B6pTHVcn.js";
+import { n as safeReadFile, r as walkProjectFiles, t as IGNORED_DIRS } from "./file-utils-Buj9-umf.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";
@@ -141,6 +143,11 @@ const GLOBAL_OPTIONS = {
 		type: "boolean",
 		hidden: true
 	},
+	"base-url": {
+		describe: "Override the PostHog base URL (e.g. http://localhost:8010), bypassing region resolution. Pins the API host, cloud URL, and OAuth server.\nenv: POSTHOG_WIZARD_BASE_URL",
+		type: "string",
+		hidden: true
+	},
 	benchmark: {
 		default: false,
 		describe: "Run in benchmark mode with per-phase token tracking\nenv: POSTHOG_WIZARD_BENCHMARK",
@@ -222,14 +229,15 @@ function runProvision(argv) {
 		email: argv.email,
 		region: argv.region.toUpperCase(),
 		name: argv.name ?? "",
+		baseUrl: argv.baseUrl,
 		jsonMode
 	});
 }
-async function provision({ email, region, name, jsonMode }) {
+async function provision({ email, region, name, baseUrl, jsonMode }) {
 	try {
-		const { provisionNewAccount } = await import("./provisioning-wMzPfaaP.js").then((n) => n.n);
+		const { provisionNewAccount } = await import("./provisioning-C9ts56R5.js").then((n) => n.n);
 		if (!jsonMode) getUI().log.info(`Provisioning account for ${email} in ${region}...`);
-		emitResult(await provisionNewAccount(email, name, region), jsonMode);
+		emitResult(await provisionNewAccount(email, name, region, { baseUrl }), jsonMode);
 		process.exit(0);
 	} catch (error) {
 		emitError(error, jsonMode);
@@ -292,22 +300,22 @@ const basicIntegrationCommand = {
 		setEntryCommand("integrate");
 		(async () => {
 			if (isHeadless(argv)) {
-				const { runHeadlessInstall } = await import("./ci-install-ouGSf4zp.js");
+				const { runHeadlessInstall } = await import("./ci-install-B0BHTkGI.js");
 				return runHeadlessInstall(argv);
 			}
 			if (argv.ci) {
-				const { runCIInstall } = await import("./ci-install-ouGSf4zp.js");
+				const { runCIInstall } = await import("./ci-install-B0BHTkGI.js");
 				return runCIInstall(argv);
 			}
 			if (isNonInteractiveEnvironment()) {
-				const { failNonInteractive } = await import("./non-interactive-D6eksWIw.js");
+				const { failNonInteractive } = await import("./non-interactive-CFikUAzO.js");
 				return failNonInteractive();
 			}
 			if (argv.playground) {
-				const { runPlayground } = await import("./playground-BB2O8GyY.js");
+				const { runPlayground } = await import("./playground-Bl2iPxdt.js");
 				return runPlayground();
 			}
-			const { runInteractive } = await import("./interactive-CFGcWw43.js");
+			const { runInteractive } = await import("./interactive-BspTioP_.js");
 			runInteractive(argv);
 		})();
 	}
@@ -1632,17 +1640,17 @@ const auditRun = async (session) => {
 	const baseRun = typeof baseConfig.run === "function" ? await baseConfig.run(session) : baseConfig.run;
 	return {
 		...baseRun,
-		buildOutroData: (sess, _credentials, cloudRegion) => {
-			const cloudUrl = cloudRegion ? getCloudUrlFromRegion(cloudRegion) : void 0;
-			const continueUrl = sess.signup && cloudUrl ? `${cloudUrl}/products?source=wizard` : void 0;
+		buildOutroData: (session, _credentials, cloudRegion) => {
+			const cloudUrl = cloudRegion ? HostResolution.fromRegion(cloudRegion, { baseUrl: session.baseUrl }).appHost : void 0;
+			const continueUrl = session.signup && cloudUrl ? `${cloudUrl}/products?source=wizard` : void 0;
 			return {
 				kind: "success",
 				message: baseRun.successMessage,
 				reportFile: baseRun.reportFile,
 				docsUrl: baseRun.docsUrl,
 				continueUrl,
-				dashboardUrl: sess.dashboardUrl ?? void 0,
-				notebookUrl: sess.notebookUrl ?? void 0
+				dashboardUrl: session.dashboardUrl ?? void 0,
+				notebookUrl: session.notebookUrl ?? void 0
 			};
 		}
 	};
@@ -1798,7 +1806,7 @@ Project context:
 - PostHog Host: ${ctx.host}
 `,
 			buildOutroData: (sess, _credentials, cloudRegion) => {
-				const cloudUrl = cloudRegion ? getCloudUrlFromRegion(cloudRegion) : void 0;
+				const cloudUrl = cloudRegion ? HostResolution.fromRegion(cloudRegion, { baseUrl: sess.baseUrl }).appHost : void 0;
 				return {
 					kind: "success",
 					message: "Your events audit was successful",
@@ -3270,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
@@ -3330,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",
@@ -3345,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",
@@ -3352,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",
@@ -3373,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(/\/$/, "");
@@ -3836,24 +4021,25 @@ const mcpAddCommand = {
 function runMcpAdd(argv) {
 	const features = parseFeatures(argv.features);
 	(async () => {
-		const { readApiKeyFromEnv } = await import("./env-api-key-MlzJYAvt.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-B9qDcoGA.js");
-			const { buildSession } = await import("./wizard-session-BKEdX9mO.js");
+			const { startTUI } = await import("./start-tui-oGWfxdTd.js");
+			const { buildSession } = await import("./wizard-session-xzqycI7i.js");
 			const tui = startTUI(VERSION, Program.McpAdd);
 			tui.store.session = buildSession({
 				debug,
 				localMcp,
 				mcpFeatures: features,
-				apiKey
+				apiKey,
+				baseUrl: argv.baseUrl
 			});
 		} catch (error) {
 			if (!isTUIUnavailable(error)) throw error;
 			setUI(new LoggingUI());
-			const { addMCPServerToClientsStep } = await import("./add-mcp-server-to-clients-BjH4z7gH.js").then((n) => n.r);
+			const { addMCPServerToClientsStep } = await import("./add-mcp-server-to-clients-D5e3JbUC.js").then((n) => n.r);
 			await addMCPServerToClientsStep({
 				local: localMcp,
 				features,
@@ -3892,16 +4078,17 @@ function runMcpRemove(argv) {
 		const debug = argv.debug;
 		const localMcp = argv.local;
 		try {
-			const { startTUI } = await import("./start-tui-B9qDcoGA.js");
-			const { buildSession } = await import("./wizard-session-BKEdX9mO.js");
+			const { startTUI } = await import("./start-tui-oGWfxdTd.js");
+			const { buildSession } = await import("./wizard-session-xzqycI7i.js");
 			const tui = startTUI(VERSION, Program.McpRemove);
 			tui.store.session = buildSession({
 				debug,
-				localMcp
+				localMcp,
+				baseUrl: argv.baseUrl
 			});
 		} catch {
 			setUI(new LoggingUI());
-			const { removeMCPServerFromClientsStep } = await import("./add-mcp-server-to-clients-BjH4z7gH.js").then((n) => n.r);
+			const { removeMCPServerFromClientsStep } = await import("./add-mcp-server-to-clients-D5e3JbUC.js").then((n) => n.r);
 			await removeMCPServerFromClientsStep({ local: localMcp });
 		}
 	})();
@@ -3923,12 +4110,13 @@ function runMcpTutorial(argv) {
 		const debug = argv.debug;
 		const localMcp = argv.local;
 		try {
-			const { startTUI } = await import("./start-tui-B9qDcoGA.js");
-			const { buildSession } = await import("./wizard-session-BKEdX9mO.js");
+			const { startTUI } = await import("./start-tui-oGWfxdTd.js");
+			const { buildSession } = await import("./wizard-session-xzqycI7i.js");
 			const tui = startTUI(VERSION, Program.McpTutorial);
 			tui.store.session = buildSession({
 				debug,
-				localMcp
+				localMcp,
+				baseUrl: argv.baseUrl
 			});
 		} catch (err) {
 			setUI(new LoggingUI());
@@ -3965,6 +4153,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
@@ -3978,10 +4191,10 @@ function runWizard(config, options) {
 	(async () => {
 		try {
 			const installDir = options.installDir || process.cwd();
-			const { startTUI } = await import("./start-tui-B9qDcoGA.js");
-			const { buildSession, RunPhase } = await import("./wizard-session-BKEdX9mO.js");
-			const { TaskStreamPush } = await import("./task-stream-CPjpHFhI.js");
-			const { PostHogDestination } = await import("./posthog-DU6JXG00.js");
+			const { startTUI } = await import("./start-tui-oGWfxdTd.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;
 			const session = buildSession({
@@ -3993,9 +4206,11 @@ function runWizard(config, options) {
 				apiKey: options.apiKey,
 				projectId: options.projectId,
 				email: options.email,
+				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;
@@ -4031,15 +4246,22 @@ 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-B0oz3raQ.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-BxdW2R0r.js").then((n) => n.r);
 				const { projectApiKey, host, accessToken, projectId } = await getOrAskForProjectData({
 					signup: session.signup,
 					ci: session.ci,
 					apiKey: session.apiKey,
 					projectId: session.projectId,
+					baseUrl: session.baseUrl,
 					programId: config.id
 				});
 				activeTui.store.setCredentials({
@@ -4048,10 +4270,7 @@ function runWizard(config, options) {
 					host,
 					projectId
 				});
-			} else {
-				const { runAgent } = await import("./agent-runner-8g_pDAVs.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(() => {
@@ -4138,11 +4357,11 @@ function runNonInteractive(config, options, mode) {
 	analytics.setTag("build", mode);
 	(async () => {
 		const path = await import("path");
-		const { buildSession, RunPhase, OutroKind } = await import("./wizard-session-BKEdX9mO.js");
-		const { readEnvironment } = await import("./environment-D2WUIm8o.js").then((n) => n.t);
-		const { readApiKeyFromEnv } = await import("./env-api-key-MlzJYAvt.js").then((n) => n.t);
-		const { configureLogFileFromEnvironment, logToFile } = await import("./debug-BM7yop-T.js");
-		const { wizardAbort, WizardError } = await import("./wizard-abort-BAB8yvGF.js");
+		const { buildSession, RunPhase, OutroKind } = await import("./wizard-session-xzqycI7i.js");
+		const { readEnvironment } = await import("./environment-Dc6VTWyK.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-DJS2KPGb.js");
+		const { wizardAbort, WizardError } = await import("./wizard-abort-C1t9M-JN.js");
 		configureLogFileFromEnvironment();
 		const env = readEnvironment();
 		const apiKey = options.apiKey ?? readApiKeyFromEnv() ?? void 0;
@@ -4156,6 +4375,7 @@ function runNonInteractive(config, options, mode) {
 			apiKey,
 			email: options.email,
 			projectId: options.projectId,
+			baseUrl: options.baseUrl,
 			benchmark: options.benchmark,
 			yaraReport: options.yaraReport,
 			noTelemetry: resolveNoTelemetry(options),
@@ -4169,9 +4389,9 @@ function runNonInteractive(config, options, mode) {
 		let store = null;
 		let taskStream = null;
 		if (mode === "headless") {
-			const { WizardStore } = await import("./store-J2Rv955W.js").then((n) => n.n);
-			const { HeadlessUI } = await import("./headless-ui-CSqtmW-d.js");
-			const { TaskStreamPush, PostHogDestination } = await import("./task-stream-CPjpHFhI.js");
+			const { WizardStore } = await import("./store-Di9OvMql.js").then((n) => n.n);
+			const { HeadlessUI } = await import("./headless-ui-BplqZRcO.js");
+			const { TaskStreamPush, PostHogDestination } = await import("./task-stream-DkbGqxZv.js");
 			store = new WizardStore(config.id);
 			store.session = session;
 			setUI(new HeadlessUI(store));
@@ -4226,7 +4446,7 @@ function runNonInteractive(config, options, mode) {
 					});
 				}
 			}
-			const { runAgent } = await import("./agent-runner-8g_pDAVs.js");
+			const { runAgent } = await import("./agent-runner-Cic1uZZ8.js").then((n) => n.t);
 			await runAgent(config, session);
 			await settleStream(RunPhase.Completed);
 		} catch (error) {
@@ -5153,12 +5373,13 @@ 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-B0oz3raQ.js").then((n) => n.r);
+		const { getOrAskForProjectData } = await import("./setup-utils-BxdW2R0r.js").then((n) => n.r);
 		const { host, accessToken, projectId } = await getOrAskForProjectData({
 			signup: false,
 			ci: true,
 			apiKey,
-			projectId: options.projectId ? Number(options.projectId) : void 0
+			projectId: options.projectId ? Number(options.projectId) : void 0,
+			baseUrl: options.baseUrl
 		});
 		const issues = await fetchHealthIssues(accessToken, host, projectId);
 		if (issues.length === 0) {
@@ -5170,7 +5391,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-EghEV_u9.js").then((n) => n.n);
+		const { ApiError } = await import("./api-C_R_ybiA.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);
@@ -5214,6 +5435,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) => {
@@ -5247,10 +5473,13 @@ function runSlackConnect(argv) {
 	(async () => {
 		const debug = argv.debug;
 		try {
-			const { startTUI } = await import("./start-tui-B9qDcoGA.js");
-			const { buildSession } = await import("./wizard-session-BKEdX9mO.js");
+			const { startTUI } = await import("./start-tui-oGWfxdTd.js");
+			const { buildSession } = await import("./wizard-session-xzqycI7i.js");
 			const tui = startTUI(VERSION, Program.SlackConnect);
-			tui.store.session = buildSession({ debug });
+			tui.store.session = buildSession({
+				debug,
+				baseUrl: argv.baseUrl
+			});
 		} catch (err) {
 			setUI(new LoggingUI());
 			getUI().log.error(`Connecting Slack requires an interactive terminal. ${err instanceof Error ? err.message : String(err)}`);
@@ -5626,6 +5855,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