@posthog/wizard 2.25.0 → 2.27.0

package/dist/bin.js

@@ -1,17 +1,17 @@
 #!/usr/bin/env node
-import { $ as getSkillsBaseUrl, P as POSTHOG_DOCS_URL, X as WIZARD_USER_AGENT, _ as SIGNUP_WIZARD_READINESS_CONFIG, a as getLogFilePath, et as VERSION, h as LoggingUI, m as setUI, p as getUI, r as debug, s as logToFile, v as evaluateWizardReadiness, y as getBlockingServiceKeys } from "./debug-BwC7UkGH.js";
-import { t as analytics } from "./analytics-CDOujOSQ.js";
-import { r as setEntryCommand } from "./telemetry-DL28cCwY.js";
-import { n as isUsingTypeScript } from "./setup-utils-D87CyNkw.js";
-import { a as getUiHostFromHost, n as getCloudUrlFromRegion } from "./urls-vkJ5c0ix.js";
-import { o as handleApiError } from "./api-DNS-L-1U.js";
+import { $ as getSkillsBaseUrl, P as POSTHOG_DOCS_URL, X as WIZARD_USER_AGENT, _ as SIGNUP_WIZARD_READINESS_CONFIG, a as getLogFilePath, et as VERSION, h as LoggingUI, m as setUI, p as getUI, r as debug, s as logToFile, v as evaluateWizardReadiness, y as getBlockingServiceKeys } from "./debug-Br_xCc9s.js";
+import { t as analytics } from "./analytics-B7-uRKIJ.js";
+import { r as setEntryCommand } from "./telemetry-D3CnLknq.js";
+import { n as isUsingTypeScript } from "./setup-utils-CjKjaKcG.js";
+import { a as getUiHostFromHost, n as getCloudUrlFromRegion } from "./urls-JN8mo6lU.js";
+import { o as handleApiError } from "./api-2zPZQONC.js";
 import "./wizard-session-G3VWD6hv.js";
-import { r as runCleanups } from "./wizard-abort-CLGgMAEe.js";
-import { n as isNonInteractiveEnvironment } from "./environment-DQPoj9sU.js";
-import { S as AUDIT_REPORT_FILE, b as AUDIT_CHECKS_FILE, c as recoverOrphanedSettingsBackups, h as fetchSkillMenu, p as WIZARD_TOOL_NAMES, u as AgentSignals, x as AUDIT_CHECKS_KEY } from "./agent-interface-BsuUUPle.js";
-import { i as SPINNER_MESSAGE } from "./registry-BbRzCV5l.js";
-import { a as PRODUCT_SUITE_BLOCK, f as Colors, i as LINE_CHART_BLOCK, l as isClearBlock, m as HEALTH_CHECK_STEP, n as posthogIntegrationConfig, o as StatusPeekTrigger, p as Icons, r as FUNNEL_BLOCK } from "./posthog-integration-BL8-vC0V.js";
-import { t as IGNORED_DIRS } from "./file-utils-VAXoyXVA.js";
+import { r as runCleanups } from "./wizard-abort-gHZ7kHYo.js";
+import { n as isNonInteractiveEnvironment } from "./environment-CFXsie0G.js";
+import { S as AUDIT_REPORT_FILE, b as AUDIT_CHECKS_FILE, c as recoverOrphanedSettingsBackups, h as fetchSkillMenu, p as WIZARD_TOOL_NAMES, u as AgentSignals, x as AUDIT_CHECKS_KEY } from "./agent-interface-DpkR1mbC.js";
+import { i as SPINNER_MESSAGE } from "./registry-CIjJsxDE.js";
+import { _ as parseRequirementsTxt, a as PRODUCT_SUITE_BLOCK, f as Colors, g as parsePyprojectToml, h as parsePipfile, i as LINE_CHART_BLOCK, l as isClearBlock, m as HEALTH_CHECK_STEP, n as posthogIntegrationConfig, o as StatusPeekTrigger, p as Icons, r as FUNNEL_BLOCK } from "./posthog-integration-DWs8JM8J.js";
+import { n as safeReadFile, r as walkProjectFiles, t as IGNORED_DIRS } from "./file-utils-CHAj73KM.js";
 import { n as readApiKeyFromEnv } from "./env-api-key-MlzJYAvt.js";
 import { satisfies } from "semver";
 import yargs from "yargs";
@@ -27,6 +27,7 @@ import { z } from "zod";
 import { Box, Text, render, useInput } from "ink";
 import { createContext, createElement, useCallback, useContext, useEffect, useRef, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
+import { access, rm } from "node:fs/promises";
 import * as readline from "node:readline/promises";
 //#region src/commands/command.ts
 /** Extract the bare command word(s) from a yargs name spec, dropping positionals and aliases' arg syntax. */
@@ -189,7 +190,7 @@ function runProvision(argv) {
 }
 async function provision({ email, region, name, jsonMode }) {
 	try {
-		const { provisionNewAccount } = await import("./provisioning-DLOiFSM9.js").then((n) => n.n);
+		const { provisionNewAccount } = await import("./provisioning-CUwxxByi.js").then((n) => n.n);
 		if (!jsonMode) getUI().log.info(`Provisioning account for ${email} in ${region}...`);
 		emitResult(await provisionNewAccount(email, name, region), jsonMode);
 		process.exit(0);
@@ -254,18 +255,18 @@ const basicIntegrationCommand = {
 		setEntryCommand("integrate");
 		(async () => {
 			if (argv.ci) {
-				const { runCIInstall } = await import("./ci-install-_9A7tL36.js");
+				const { runCIInstall } = await import("./ci-install-CpGSFNDi.js");
 				return runCIInstall(argv);
 			}
 			if (isNonInteractiveEnvironment()) {
-				const { failNonInteractive } = await import("./non-interactive-csP4yGdA.js");
+				const { failNonInteractive } = await import("./non-interactive--4CK1bkn.js");
 				return failNonInteractive();
 			}
 			if (argv.playground) {
-				const { runPlayground } = await import("./playground-C-lpKoKC.js");
+				const { runPlayground } = await import("./playground-De_BxaCh.js");
 				return runPlayground();
 			}
-			const { runInteractive } = await import("./interactive-DT5dLd7N.js");
+			const { runInteractive } = await import("./interactive-lfAs6vF7.js");
 			runInteractive(argv);
 		})();
 	}
@@ -508,6 +509,571 @@ const revenueAnalyticsConfig = {
 	requires: ["posthog-integration"]
 };
 //#endregion
+//#region src/lib/warehouse-sources/registry.ts
+const SOURCE_DETECTORS = [
+	{
+		kind: "Postgres",
+		label: "PostgreSQL",
+		mode: "in-cli",
+		signals: {
+			npm: [
+				"pg",
+				"postgres",
+				"postgres.js",
+				"knex",
+				"sequelize"
+			],
+			python: [
+				"psycopg",
+				"psycopg2",
+				"psycopg2-binary",
+				"asyncpg"
+			],
+			ruby: ["pg"],
+			envKeys: [
+				/^DATABASE_URL$/,
+				/^POSTGRES_/,
+				/^PG(HOST|DATABASE|USER|PORT)$/
+			]
+		}
+	},
+	{
+		kind: "MySQL",
+		label: "MySQL",
+		mode: "in-cli",
+		signals: {
+			npm: ["mysql", "mysql2"],
+			python: [
+				"pymysql",
+				"mysqlclient",
+				"mysql-connector-python"
+			],
+			ruby: ["mysql2"],
+			envKeys: [/^MYSQL_/]
+		}
+	},
+	{
+		kind: "MongoDB",
+		label: "MongoDB",
+		mode: "in-cli",
+		signals: {
+			npm: ["mongodb", "mongoose"],
+			python: ["pymongo", "motor"],
+			ruby: ["mongo", "mongoid"],
+			envKeys: [/^MONGO(DB)?_/]
+		}
+	},
+	{
+		kind: "Snowflake",
+		label: "Snowflake",
+		mode: "in-cli",
+		signals: {
+			npm: ["snowflake-sdk"],
+			python: ["snowflake-connector-python", "snowflake-sqlalchemy"],
+			envKeys: [/^SNOWFLAKE_/]
+		}
+	},
+	{
+		kind: "BigQuery",
+		label: "BigQuery",
+		mode: "in-cli",
+		signals: {
+			npm: ["@google-cloud/bigquery"],
+			python: ["google-cloud-bigquery"],
+			envKeys: [/^BIGQUERY_/]
+		}
+	},
+	{
+		kind: "Redshift",
+		label: "Redshift",
+		mode: "in-cli",
+		signals: {
+			npm: ["node-redshift"],
+			python: ["redshift-connector"],
+			envKeys: [/^REDSHIFT_/]
+		}
+	},
+	{
+		kind: "MSSQL",
+		label: "SQL Server",
+		mode: "in-cli",
+		signals: {
+			npm: ["mssql", "tedious"],
+			python: ["pyodbc", "pymssql"],
+			envKeys: [/^MSSQL_/]
+		}
+	},
+	{
+		kind: "Supabase",
+		label: "Supabase",
+		mode: "in-cli",
+		signals: {
+			npm: ["@supabase/supabase-js"],
+			python: ["supabase"],
+			envKeys: [/^SUPABASE_/]
+		}
+	},
+	{
+		kind: "ClickHouse",
+		label: "ClickHouse",
+		mode: "in-cli",
+		signals: {
+			npm: ["@clickhouse/client"],
+			python: ["clickhouse-connect", "clickhouse-driver"],
+			envKeys: [/^CLICKHOUSE_/]
+		}
+	},
+	{
+		kind: "Convex",
+		label: "Convex",
+		mode: "in-cli",
+		signals: {
+			npm: ["convex"],
+			python: ["convex"],
+			envKeys: [/^CONVEX_/, /^NEXT_PUBLIC_CONVEX_URL$/]
+		}
+	},
+	{
+		kind: "Stripe",
+		label: "Stripe",
+		mode: "in-cli",
+		signals: {
+			npm: [
+				"stripe",
+				"@stripe/stripe-js",
+				"@stripe/react-stripe-js"
+			],
+			python: ["stripe"],
+			ruby: ["stripe"],
+			envKeys: [/^STRIPE_(SECRET|API)_KEY$/]
+		}
+	},
+	{
+		kind: "Clerk",
+		label: "Clerk",
+		mode: "in-cli",
+		signals: {
+			npm: [
+				"@clerk/nextjs",
+				"@clerk/clerk-react",
+				"@clerk/backend",
+				"@clerk/express",
+				"@clerk/fastify",
+				"@clerk/remix"
+			],
+			envKeys: [/^CLERK_SECRET_KEY$/, /^NEXT_PUBLIC_CLERK_/]
+		}
+	},
+	{
+		kind: "Resend",
+		label: "Resend",
+		mode: "in-cli",
+		signals: {
+			npm: ["resend"],
+			python: ["resend"],
+			envKeys: [/^RESEND_API_KEY$/]
+		}
+	},
+	{
+		kind: "Shopify",
+		label: "Shopify",
+		mode: "in-cli",
+		signals: {
+			npm: ["@shopify/shopify-api", "shopify-api-node"],
+			python: ["shopifyapi"],
+			envKeys: [/^SHOPIFY_/]
+		}
+	},
+	{
+		kind: "Klaviyo",
+		label: "Klaviyo",
+		mode: "in-cli",
+		signals: {
+			npm: ["klaviyo-api"],
+			python: ["klaviyo-api"],
+			envKeys: [/^KLAVIYO_/]
+		}
+	},
+	{
+		kind: "Chargebee",
+		label: "Chargebee",
+		mode: "in-cli",
+		signals: {
+			npm: ["chargebee"],
+			python: ["chargebee"],
+			envKeys: [/^CHARGEBEE_/]
+		}
+	},
+	{
+		kind: "Paddle",
+		label: "Paddle",
+		mode: "in-cli",
+		signals: {
+			npm: ["@paddle/paddle-node-sdk", "@paddle/paddle-js"],
+			envKeys: [/^PADDLE_/]
+		}
+	},
+	{
+		kind: "Polar",
+		label: "Polar",
+		mode: "in-cli",
+		signals: {
+			npm: ["@polar-sh/sdk", "@polar-sh/nextjs"],
+			envKeys: [/^POLAR_/]
+		}
+	},
+	{
+		kind: "Mailchimp",
+		label: "Mailchimp",
+		mode: "in-cli",
+		signals: {
+			npm: ["@mailchimp/mailchimp_marketing"],
+			python: ["mailchimp-marketing"],
+			envKeys: [/^MAILCHIMP_/]
+		}
+	},
+	{
+		kind: "CustomerIO",
+		label: "Customer.io",
+		mode: "in-cli",
+		signals: {
+			npm: ["customerio-node"],
+			python: ["customerio"],
+			envKeys: [/^CUSTOMER_?IO_/]
+		}
+	},
+	{
+		kind: "Typeform",
+		label: "Typeform",
+		mode: "in-cli",
+		signals: {
+			npm: ["@typeform/api-client"],
+			envKeys: [/^TYPEFORM_/]
+		}
+	},
+	{
+		kind: "Sentry",
+		label: "Sentry",
+		mode: "in-cli",
+		signals: {
+			npm: [
+				"@sentry/node",
+				"@sentry/browser",
+				"@sentry/react",
+				"@sentry/nextjs"
+			],
+			python: ["sentry-sdk"],
+			ruby: ["sentry-ruby"]
+		}
+	},
+	{
+		kind: "Salesforce",
+		label: "Salesforce",
+		mode: "deep-link",
+		signals: {
+			npm: ["jsforce"],
+			python: ["simple-salesforce"],
+			envKeys: [/^SALESFORCE_/]
+		}
+	},
+	{
+		kind: "Hubspot",
+		label: "HubSpot",
+		mode: "deep-link",
+		signals: {
+			npm: ["@hubspot/api-client"],
+			python: ["hubspot-api-client"],
+			envKeys: [/^HUBSPOT_/]
+		}
+	},
+	{
+		kind: "Zendesk",
+		label: "Zendesk",
+		mode: "deep-link",
+		signals: {
+			npm: ["node-zendesk"],
+			python: ["zenpy"],
+			envKeys: [/^ZENDESK_/]
+		}
+	},
+	{
+		kind: "Intercom",
+		label: "Intercom",
+		mode: "deep-link",
+		signals: {
+			npm: ["intercom-client", "@intercom/messenger-js-sdk"],
+			python: ["python-intercom"],
+			envKeys: [/^INTERCOM_/]
+		}
+	},
+	{
+		kind: "Linear",
+		label: "Linear",
+		mode: "deep-link",
+		signals: {
+			npm: ["@linear/sdk"],
+			envKeys: [/^LINEAR_API_KEY$/]
+		}
+	}
+];
+//#endregion
+//#region src/lib/warehouse-sources/detect.ts
+/**
+* Data warehouse source detection.
+*
+* Scans a project for codebase signals (npm/python/ruby deps, `.env` key
+* names) and matches them against the `SOURCE_DETECTORS` registry. Pure
+* function: no store mutations, no UI calls. Reads files locally — only the
+* wizard process does this; the agent never sees secret values.
+*
+* Note we only read `.env` KEY NAMES, never values.
+*/
+const MAX_DEPTH = 3;
+/**
+* Detect which warehouse sources the project at `installDir` appears to use.
+* Returns one `DetectedSource` per matched registry entry (kinds are unique,
+* so the result is naturally deduped).
+*/
+function detectWarehouseSources(installDir) {
+	const signals = collectSignals$1(installDir);
+	const detected = [];
+	for (const detector of SOURCE_DETECTORS) {
+		const match = matchDetector(detector, signals);
+		if (match) detected.push({
+			kind: detector.kind,
+			label: detector.label,
+			mode: detector.mode,
+			matchedSignal: match
+		});
+	}
+	return detected;
+}
+/** Returns a human-readable description of the first matching signal, or null. */
+function matchDetector(detector, signals) {
+	const { npm, python, ruby, envKeys } = detector.signals;
+	const npmHit = npm?.find((dep) => signals.npm.has(dep));
+	if (npmHit) return `found \`${npmHit}\` in package.json`;
+	const pyHit = python?.find((dep) => signals.python.has(dep));
+	if (pyHit) return `found \`${pyHit}\` in Python dependencies`;
+	const rubyHit = ruby?.find((gem) => signals.ruby.has(gem));
+	if (rubyHit) return `found \`${rubyHit}\` in Gemfile`;
+	if (envKeys) {
+		for (const key of signals.envKeys) if (envKeys.some((re) => re.test(key))) return `found \`${key}\` in .env`;
+	}
+	return null;
+}
+function collectSignals$1(installDir) {
+	const signals = {
+		npm: /* @__PURE__ */ new Set(),
+		python: /* @__PURE__ */ new Set(),
+		ruby: /* @__PURE__ */ new Set(),
+		envKeys: /* @__PURE__ */ new Set()
+	};
+	walkProjectFiles(installDir, (name, fullPath) => ingestFile(name, fullPath, signals), MAX_DEPTH);
+	return signals;
+}
+/**
+* Route a file to the right parser BY NAME, reading its contents only when the
+* name matches one of the ~6 manifests we care about. Checking the name first
+* avoids slurping every file in the tree (lockfiles, binaries, assets) into
+* memory just to discard it.
+*/
+function ingestFile(name, fullPath, signals) {
+	const ingest = ingestorFor(name);
+	if (!ingest) return;
+	const content = safeReadFile(fullPath);
+	if (content === null) return;
+	ingest(content, signals);
+}
+/** Pick the parser for a manifest filename, or null if it's not one we read. */
+function ingestorFor(name) {
+	if (name === "package.json") return addNpmDeps;
+	if (name === "requirements.txt") return (c, s) => parseRequirementsTxt(c).forEach((d) => s.python.add(d));
+	if (name === "pyproject.toml") return (c, s) => parsePyprojectToml(c).forEach((d) => s.python.add(d));
+	if (name === "Pipfile") return (c, s) => parsePipfile(c).forEach((d) => s.python.add(d));
+	if (name === "Gemfile") return (c, s) => parseGemfile(c).forEach((g) => s.ruby.add(g));
+	if (name.startsWith(".env")) return (c, s) => parseEnvKeys(c).forEach((k) => s.envKeys.add(k));
+	return null;
+}
+function addNpmDeps(content, signals) {
+	try {
+		const pkg = JSON.parse(content);
+		for (const dep of Object.keys({
+			...pkg.dependencies,
+			...pkg.devDependencies
+		})) signals.npm.add(dep);
+	} catch (error) {
+		analytics.captureException(error instanceof Error ? error : new Error(String(error)), { step: "detectWarehouseSources.parsePackageJson" });
+	}
+}
+/** Extract gem names from `gem 'name'` declarations. */
+function parseGemfile(content) {
+	const gems = [];
+	for (const match of content.matchAll(/^\s*gem\s+['"]([^'"]+)['"]/gm)) gems.push(match[1]);
+	return gems;
+}
+/** Extract KEY NAMES from a dotenv file. Values are intentionally discarded. */
+function parseEnvKeys(content) {
+	const keys = [];
+	for (const line of content.split("\n")) {
+		const trimmed = line.trim();
+		if (!trimmed || trimmed.startsWith("#")) continue;
+		const match = trimmed.match(/^(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=/);
+		if (match) keys.push(match[1]);
+	}
+	return keys;
+}
+//#endregion
+//#region src/lib/programs/warehouse-source/detect.ts
+/**
+* Warehouse-source program detection step.
+*
+* Thin adapter over `detectWarehouseSources` that writes results into
+* frameworkContext for the intro screen, plus the `[ABORT]` cases the
+* data-warehouse-source-setup skill can emit.
+*/
+/** frameworkContext key holding the detected sources (set on success). */
+const DETECTED_WAREHOUSE_SOURCES_KEY = "detectedWarehouseSources";
+/**
+* Read the detected sources out of frameworkContext. Single accessor shared by
+* the intro screen and the prompt builder so the key + cast live in one place.
+*/
+function getDetectedWarehouseSources(session) {
+	return session.frameworkContext["detectedWarehouseSources"] ?? [];
+}
+/** `[ABORT] <reason>` cases the skill can emit. */
+const WAREHOUSE_ABORT_CASES = [{
+	match: /^no data sources? detected\.?$/i,
+	message: "No data source detected",
+	body: "The agent could not confirm a data warehouse source to connect. Run this command from a project that uses a supported source (a database, Stripe, etc.).",
+	docsUrl: "https://posthog.com/docs/data-warehouse"
+}, {
+	match: /^source creation failed\.?$/i,
+	message: "Source creation failed",
+	body: "PostHog could not create the data warehouse source with the credentials provided. Double-check the connection details and try again, or set the source up directly in the PostHog app.",
+	docsUrl: "https://posthog.com/docs/data-warehouse"
+}];
+/**
+* Scan `session.installDir` for warehouse-source signals. Writes the detected
+* sources (or a `detectError`) into frameworkContext for the intro screen.
+*/
+function detectWarehousePrerequisites(session, setFrameworkContext) {
+	const fail = (error) => setFrameworkContext("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 (error) {
+		analytics.captureException(error instanceof Error ? error : new Error(String(error)), {
+			step: "detectWarehousePrerequisites.stat",
+			path: installDir
+		});
+		fail({
+			kind: "bad-directory",
+			path: installDir,
+			reason: "unreadable"
+		});
+		return;
+	}
+	const sources = detectWarehouseSources(installDir);
+	if (sources.length === 0) {
+		fail({ kind: "no-sources" });
+		return;
+	}
+	setFrameworkContext(DETECTED_WAREHOUSE_SOURCES_KEY, sources);
+}
+//#endregion
+//#region src/lib/programs/warehouse-source/steps.ts
+const WAREHOUSE_SOURCE_PROGRAM = [
+	{
+		id: "detect",
+		label: "Detecting data sources",
+		onReady: (ctx) => detectWarehousePrerequisites(ctx.session, ctx.setFrameworkContext)
+	},
+	{
+		id: "intro",
+		label: "Welcome",
+		screenId: "warehouse-intro",
+		gate: (session) => session.setupConfirmed
+	},
+	{
+		id: "auth",
+		label: "Authentication",
+		screenId: "auth",
+		isComplete: (session) => session.credentials !== null
+	},
+	{
+		id: "run",
+		label: "Data warehouse",
+		screenId: "run",
+		isComplete: (session) => session.runPhase === "completed" || session.runPhase === "error"
+	},
+	{
+		id: "outro",
+		label: "Done",
+		screenId: "outro",
+		isComplete: (session) => session.outroDismissed
+	},
+	{
+		id: "skills",
+		label: "Skills",
+		screenId: "keep-skills"
+	}
+];
+//#endregion
+//#region src/lib/programs/warehouse-source/index.ts
+/**
+* Inject the detected sources (and their creation mode) into the prompt so the
+* skill knows what to set up. The *how* — in-CLI creation vs deep-link, field
+* collection, validation — lives in the skill, not here.
+*/
+function buildPrompt(session) {
+	const sources = getDetectedWarehouseSources(session);
+	if (sources.length === 0) return "Set up a data warehouse source for this project.";
+	return [
+		"The wizard detected the following data warehouse sources in this project:",
+		...sources.map((s) => `- ${s.label} (kind: ${s.kind}, mode: ${s.mode}) — ${s.matchedSignal}`),
+		"",
+		"Set these up in PostHog following the skill instructions: create `in-cli` sources directly via the PostHog MCP after collecting credentials; for `deep-link` sources, provide the user the pre-filled new-source URL."
+	].join("\n");
+}
+const warehouseSourceConfig = {
+	command: "warehouse",
+	description: "Detect and connect a data warehouse source (Postgres, Stripe, …)",
+	id: "warehouse-source",
+	skillId: "data-warehouse-source-setup",
+	steps: WAREHOUSE_SOURCE_PROGRAM,
+	getContentBlocks: getContentBlocks$2,
+	reportFile: "posthog-warehouse-report.md",
+	allowedTools: ["Agent"],
+	run: (session) => Promise.resolve({
+		skillId: "data-warehouse-source-setup",
+		integrationLabel: "data-warehouse-source-setup",
+		customPrompt: () => buildPrompt(session),
+		successMessage: "Data warehouse source connected!",
+		reportFile: "posthog-warehouse-report.md",
+		docsUrl: "https://posthog.com/docs/data-warehouse",
+		spinnerMessage: "Connecting your data source...",
+		estimatedDurationMinutes: 5,
+		abortCases: WAREHOUSE_ABORT_CASES
+	}),
+	requires: ["posthog-integration"]
+};
+//#endregion
 //#region src/lib/programs/agent-skill/steps.ts
 const AGENT_SKILL_STEPS = [
 	{
@@ -846,7 +1412,7 @@ const EVENTS_AUDIT_SEED_CHECKS = [
 //#endregion
 //#region src/lib/programs/events-audit/index.ts
 const SETUP_REPORT_FILE = "posthog-events-audit-report.md";
-const DOCS_URL$2 = "https://posthog.com/docs/product-analytics/best-practices";
+const DOCS_URL$3 = "https://posthog.com/docs/product-analytics/best-practices";
 const eventsAuditConfig = {
 	command: "events-audit",
 	description: "Audit PostHog event tracking in this project",
@@ -868,7 +1434,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$2,
+			docsUrl: DOCS_URL$3,
 			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.
@@ -886,7 +1452,7 @@ Project context:
 					message: "Your events audit was successful",
 					reportFile: SETUP_REPORT_FILE,
 					changes: [],
-					docsUrl: DOCS_URL$2,
+					docsUrl: DOCS_URL$3,
 					continueUrl: sess.signup && cloudUrl ? `${cloudUrl}/products?source=wizard` : void 0,
 					dashboardUrl: sess.dashboardUrl ?? (cloudUrl ? `${cloudUrl}/dashboard` : void 0),
 					notebookUrl: sess.notebookUrl ?? void 0
@@ -2415,15 +2981,15 @@ const getContentBlocks = (store) => pace([
 ]);
 //#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 REPORT_FILE$1 = "posthog-source-maps-report.md";
+const DOCS_URL$1 = "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",
 	requiresAi: true,
 	steps: ERROR_TRACKING_UPLOAD_SOURCE_MAPS_PROGRAM,
-	reportFile: REPORT_FILE,
+	reportFile: REPORT_FILE$1,
 	getContentBlocks,
 	requires: ["posthog-integration"],
 	run: (session) => {
@@ -2433,8 +2999,8 @@ const errorTrackingUploadSourceMapsConfig = {
 		return Promise.resolve({
 			integrationLabel: "error-tracking-upload-source-maps",
 			successMessage: "Source maps wired up!",
-			reportFile: REPORT_FILE,
-			docsUrl: DOCS_URL,
+			reportFile: REPORT_FILE$1,
+			docsUrl: DOCS_URL$1,
 			spinnerMessage: "Wiring up source maps...",
 			estimatedDurationMinutes: 3,
 			abortCases: SOURCE_MAPS_ABORT_CASES,
@@ -2460,14 +3026,363 @@ const errorTrackingUploadSourceMapsConfig = {
 				return {
 					kind: "success",
 					message: "Source maps wired up!",
-					reportFile: REPORT_FILE,
-					docsUrl: DOCS_URL
+					reportFile: REPORT_FILE$1,
+					docsUrl: DOCS_URL$1
 				};
 			}
 		});
 	}
 };
 //#endregion
+//#region src/lib/programs/self-driving/detect.ts
+/**
+* Self-driving prerequisite detection + abort vocabulary.
+*
+* The only thing worth verifying before auth is local and cheap: that
+* `session.installDir` is a real, readable directory. We deliberately do
+* NOT require the base posthog-integration report to be present — it is a
+* report many users never commit, and `requires: ['posthog-integration']`
+* is metadata, not a hard runtime gate. Real readiness (integration state
+* + beta access) is established by the agent's STEP 1 Signals API probe at
+* the start of the run. The beta gates (the `product-autonomy` access flag
+* and `signals-scout` enrollment — PostHog-side flag names, unchanged by
+* the wizard-side "self-driving" rename) are PostHog-internal flags with no
+* customer-facing read API, which is why that probe lives in the run and
+* emits a structured `[ABORT]` when the product is not available.
+*/
+/**
+* `[ABORT] <reason>` cases the self-driving skill can emit. The
+* reason strings are part of the skill contract — the context-mill
+* `self-driving-setup` skill emits these exact strings.
+*/
+const SELF_DRIVING_ABORT_CASES = [
+	{
+		match: /^self-driving is not available for this project$/i,
+		message: "PostHog Self-driving is not available for this project",
+		body: "Self-driving is in beta and is enabled per team by PostHog. This project does not appear to have access yet. Reach out to your PostHog contact (or wizard@posthog.com) to join the beta, then run the wizard again."
+	},
+	{
+		match: /^github connection declined$/i,
+		message: "GitHub connection required",
+		body: "Self-driving needs GitHub access to research issues in your code and open fixes, so setup cannot finish without it. Nothing was left half-configured. When you are ready to install the PostHog GitHub App, run the wizard again."
+	},
+	{
+		match: /^requires-interactive-mode$/i,
+		message: "Interactive terminal required",
+		body: "Self-driving setup asks questions along the way (GitHub and issue trackers), so it needs an interactive terminal. Run the wizard outside CI / non-interactive mode."
+	},
+	{
+		match: /^requirements-incomplete$/i,
+		message: "Setup needs your input",
+		body: "The wizard could not collect the answers this setup needs (the environment was non-interactive, or the question budget ran out). Nothing was left half-configured. Run the wizard again in an interactive terminal."
+	}
+];
+/**
+* Verify `session.installDir` is a readable directory. Writes a
+* `SelfDrivingDetectError` to frameworkContext on failure — the intro
+* screen renders it and blocks.
+*/
+function detectSelfDrivingPrerequisites(session, setFrameworkContext) {
+	const fail = (error) => setFrameworkContext("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;
+	}
+}
+//#endregion
+//#region src/lib/programs/self-driving/steps.ts
+const SELF_DRIVING_PROGRAM = [
+	{
+		id: "detect",
+		label: "Detecting prerequisites",
+		onReady: (ctx) => detectSelfDrivingPrerequisites(ctx.session, ctx.setFrameworkContext)
+	},
+	{
+		id: "intro",
+		label: "Welcome",
+		screenId: "self-driving-intro",
+		gate: (session) => session.setupConfirmed
+	},
+	HEALTH_CHECK_STEP,
+	{
+		id: "auth",
+		label: "Authentication",
+		screenId: "auth",
+		isComplete: (session) => session.credentials !== null
+	},
+	{
+		id: "run",
+		label: "Self-driving",
+		screenId: "run",
+		isComplete: (session) => session.runPhase === "completed" || session.runPhase === "error"
+	},
+	{
+		id: "outro",
+		label: "Done",
+		screenId: "outro",
+		isComplete: (session) => session.outroDismissed
+	}
+];
+//#endregion
+//#region src/lib/programs/self-driving/prompt.ts
+/**
+* Build the self-driving run prompt. The installed
+* `self-driving-setup` skill is the source of truth for the HOW of
+* 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.
+*/
+function buildSelfDrivingPrompt(ctx) {
+	const uiHost = getUiHostFromHost(ctx.host).replace(/\/$/, "");
+	const projectBase = `${uiHost}/project/${ctx.projectId}`;
+	const integrationsSettingsUrl = `${projectBase}/settings/environment-integrations`;
+	const orgAiSettingsUrl = `${uiHost}/settings/organization#organization-ai-consent`;
+	const newWarehouseSourceUrl = `${projectBase}/pipeline/new/source`;
+	const inboxUrl = `${projectBase}/inbox`;
+	const optIn = (value) => value === true ? "ON" : value === false ? "OFF" : "unknown";
+	const optIns = ctx.teamProductOptIns;
+	return `You are setting up PostHog Self-driving for this project: you will enable the right signal sources, make sure GitHub is connected, tune the scout fleet, design custom scouts for what this product uniquely needs, and hand the user a configured inbox.
+
+Project URLs:
+- Integrations settings (GitHub App install): ${integrationsSettingsUrl}
+- Organization AI settings: ${orgAiSettingsUrl}
+- New data warehouse source (Linear / Zendesk / GitHub issues / pganalyze): ${newWarehouseSourceUrl}
+- Self-driving inbox: ${inboxUrl}
+
+Project state read at auth time (PostHog project settings — authoritative
+for whether a product is enabled, regardless of what this repo
+instruments; products are often instrumented from other repos or the
+snippet, so repo evidence may rule a product IN but never OUT):
+- Session replay recording: ${optIn(optIns?.sessionReplay)}
+- Exception autocapture (error tracking): ${optIn(optIns?.exceptionAutocapture)}
+- Surveys: ${optIn(optIns?.surveys)}
+
+The installed skill is the source of truth for the HOW of every step:
+which MCP tools to call, which sources and scouts apply to this product,
+and how to verify each change. The STEPS below give the order and the
+wizard-specific mechanics — read the matching skill reference before
+doing the work, and do not invent steps the skill doesn't describe.
+
+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:
+  1. Check Self-driving access
+  2. Read project and current Self-driving state
+  3. Connect GitHub (required)
+  4. Enable signal sources
+  5. Offer issue-tracker integrations
+  6. Configure the scout fleet
+  7. Design custom scouts
+  8. 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.
+
+Wizard mechanics:
+- Ask the user things ONLY with the wizard_ask MCP tool, and batch
+  related questions (e.g. one multi-select for all issue trackers, not
+  one ask per tool). The per-run ask budget is limited.
+- If wizard_ask is unavailable (CI / non-interactive), emit
+  ${AgentSignals.ABORT} requires-interactive-mode and halt.
+- When a step requires the user to do something in the browser, give
+  them the exact URL inside the wizard_ask prompt text — do not try to
+  open a browser yourself.
+- Emit ${AgentSignals.STATUS} lines as you complete each step so the
+  user sees progress.
+
+Follow these steps IN ORDER. Do not skip or reorder.
+
+STEP 1 — Check Self-driving access. (skill: "Check access")
+   Probe the Signals API as the skill describes. If the API is not
+   available for this project (permission or not-found errors), emit
+   ${AgentSignals.ABORT} self-driving is not available for this project
+   and halt.
+
+STEP 2 — Read project and current Signals state. (skill: "Read context")
+   If ./posthog-setup-report.md exists, read it as a strong hint for what
+   THIS repo instruments — but it is often absent (users frequently don't
+   commit it), so do NOT depend on it. Combine whatever you find with the
+   project-state block above and the skill's server-side usage probes —
+   repo evidence rules products in, never out. Do a light scan ONLY for
+   what neither covers. List the currently enabled signal sources so every
+   later write is idempotent.
+
+STEP 3 — Connect GitHub. REQUIRED. (skill: "Connect GitHub")
+   Signals cannot research or fix issues without code access. Check for
+   an existing GitHub integration first; if absent, send the user to
+   ${integrationsSettingsUrl} via wizard_ask and verify the connection
+   after they confirm. If the user cannot connect now, emit
+   ${AgentSignals.ABORT} github connection declined
+   and halt — never finish setup without GitHub.
+
+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
+   confirmed they use.
+
+STEP 5 — Offer issue-tracker integrations. (skill: "Connected tools")
+   One batched multi-select wizard_ask for the external tools the skill
+   lists. The run auto-connects the ones it can (GitHub Issues, and
+   Linear via a one-click OAuth link), verifying each with a single
+   silent check — never nudge. It arms the rest as dormant responders to
+   finish later: for tools it can't auto-connect (Zendesk, pganalyze) it
+   never sends the user to paste credentials and never re-prompts. Enable
+   a source only for a tool the user picked.
+
+STEP 6 — Configure the scout fleet. (skill: "Scouts")
+   Materialize the fleet and disable the scouts whose product surface
+   this project lacks, per the skill.
+
+STEP 7 — 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 canonical fleet already covers,
+   then custom scouts for the uncovered ones. Keep scout bodies
+   high-level: describe the behavior and signal conditions to watch,
+   referencing repo evidence by file/function name — never paste raw
+   source, secrets, env values, or customer data into a scout body.
+   Never edit canonical scout bodies. Propose all candidates in ONE
+   batched wizard_ask
+   before creating anything; the user declining everything (or finding
+   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")
+   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.`;
+}
+//#endregion
+//#region src/lib/programs/self-driving/content/tips.ts
+const SELF_DRIVING_TIPS = [
+	{
+		id: "what-is-a-signal-source",
+		title: "What's a signal source?",
+		description: "A signal source is a PostHog product or connected tool — errors, session replays, support, GitHub or Linear issues — that feeds findings into your Self-driving inbox."
+	},
+	{
+		id: "what-is-a-scout",
+		title: "What's a scout?",
+		description: "Scouts are scheduled checks that scan your data and flag issues — a spike in errors, a dropping funnel — straight to your inbox."
+	},
+	{
+		id: "findings-in-inbox",
+		title: "Findings land in your inbox",
+		description: "Once setup finishes, PostHog starts scanning within ~30 minutes and surfaces what it finds in your Self-driving inbox — grouped, researched, and ready to act on."
+	}
+];
+const getTips = () => SELF_DRIVING_TIPS;
+//#endregion
+//#region src/lib/programs/self-driving/index.ts
+const SELF_DRIVING_SKILL_ID = "self-driving-setup";
+const REPORT_FILE = "posthog-self-driving-report.md";
+const DOCS_URL = "https://posthog.com/docs";
+const SUCCESS_MESSAGE = "Self-driving is on! PostHog will start scanning within ~30 minutes and surface findings in your inbox.";
+const WIZARD_MARKER = ".posthog-wizard";
+/**
+* Remove the installed setup skill. It is transient orchestration
+* knowledge (unlike integration skills such as the Next.js one, which
+* are worth keeping for the user's coding agents), so the program
+* cleans it up instead of showing the keep-skills prompt. Marker-
+* guarded: only directories the wizard installed are touched.
+*/
+async function removeInstalledSkill(installDir) {
+	const skillDir = join(installDir, ".claude", "skills", SELF_DRIVING_SKILL_ID);
+	try {
+		await access(join(skillDir, WIZARD_MARKER));
+	} catch {
+		return;
+	}
+	await rm(skillDir, {
+		recursive: true,
+		force: true
+	}).catch(() => void 0);
+}
+const run = {
+	skillId: SELF_DRIVING_SKILL_ID,
+	integrationLabel: SELF_DRIVING_SKILL_ID,
+	customPrompt: buildSelfDrivingPrompt,
+	successMessage: SUCCESS_MESSAGE,
+	reportFile: REPORT_FILE,
+	docsUrl: DOCS_URL,
+	spinnerMessage: "Setting up PostHog Self-driving...",
+	estimatedDurationMinutes: 10,
+	abortCases: SELF_DRIVING_ABORT_CASES,
+	maxQuestions: 13,
+	richLinks: true,
+	askTimeoutMs: 1800 * 1e3,
+	postRun: async (session) => {
+		await removeInstalledSkill(session.installDir);
+	},
+	buildOutroData: (_session, credentials) => {
+		return {
+			kind: "success",
+			message: "Self-driving is on. PostHog is scanning your project — first findings hit your inbox within ~30 minutes.",
+			primaryLink: {
+				label: "Your Self-driving inbox",
+				url: `${getUiHostFromHost(credentials.host).replace(/\/$/, "")}/project/${credentials.projectId}/inbox`
+			},
+			nextSteps: {
+				heading: "In your inbox you can:",
+				items: [
+					"Review the findings PostHog surfaces",
+					"Triage what matters and dismiss the noise",
+					"Kick off fixes and open issues"
+				]
+			},
+			reportFile: REPORT_FILE
+		};
+	}
+};
+const selfDrivingConfig = {
+	...createSkillProgram({
+		skillId: SELF_DRIVING_SKILL_ID,
+		command: "self-driving",
+		id: "self-driving",
+		description: "Set up PostHog Self-driving for this project",
+		integrationLabel: SELF_DRIVING_SKILL_ID,
+		successMessage: SUCCESS_MESSAGE,
+		reportFile: REPORT_FILE,
+		docsUrl: DOCS_URL,
+		spinnerMessage: "Setting up PostHog Self-driving...",
+		estimatedDurationMinutes: 10,
+		requires: ["posthog-integration"],
+		abortCases: SELF_DRIVING_ABORT_CASES
+	}),
+	steps: SELF_DRIVING_PROGRAM,
+	run,
+	getTips,
+	getContentBlocks: (store) => {
+		const blocks = getContentBlocks$2(store);
+		return blocks.map((b, i) => i === blocks.length - 1 && typeof b === "object" ? {
+			...b,
+			pause: 5e3
+		} : b);
+	}
+};
+//#endregion
 //#region src/lib/programs/mcp/index.ts
 const mcpAddConfig = {
 	id: "mcp-add",
@@ -2583,12 +3498,14 @@ const agentSkillConfig = {
 const PROGRAM_REGISTRY = [
 	posthogIntegrationConfig,
 	revenueAnalyticsConfig,
+	warehouseSourceConfig,
 	errorTrackingUploadSourceMapsConfig,
 	auditConfig,
 	eventsAuditConfig,
 	posthogDoctorConfig,
 	webAnalyticsDoctorConfig,
 	migrationConfig,
+	selfDrivingConfig,
 	agentSkillConfig,
 	mcpAddConfig,
 	mcpRemoveConfig,
@@ -2603,12 +3520,14 @@ const PROGRAM_REGISTRY = [
 const Program = {
 	PostHogIntegration: posthogIntegrationConfig.id,
 	RevenueAnalyticsSetup: revenueAnalyticsConfig.id,
+	WarehouseSource: warehouseSourceConfig.id,
 	ErrorTrackingUploadSourceMaps: errorTrackingUploadSourceMapsConfig.id,
 	Migration: migrationConfig.id,
 	Audit: auditConfig.id,
 	EventsAudit: eventsAuditConfig.id,
 	PosthogDoctor: posthogDoctorConfig.id,
 	WebAnalyticsDoctor: webAnalyticsDoctorConfig.id,
+	SelfDriving: selfDrivingConfig.id,
 	AgentSkill: agentSkillConfig.id,
 	McpAdd: mcpAddConfig.id,
 	McpRemove: mcpRemoveConfig.id,
@@ -2653,7 +3572,7 @@ function runMcpAdd(argv) {
 		const debug = argv.debug;
 		const localMcp = argv.local;
 		try {
-			const { startTUI } = await import("./start-tui-DnAG57vY.js");
+			const { startTUI } = await import("./start-tui-Cbw0kVr3.js");
 			const { buildSession } = await import("./wizard-session-wPJtNl4c.js");
 			const tui = startTUI(VERSION, Program.McpAdd);
 			tui.store.session = buildSession({
@@ -2665,7 +3584,7 @@ function runMcpAdd(argv) {
 		} catch (error) {
 			if (!isTUIUnavailable(error)) throw error;
 			setUI(new LoggingUI());
-			const { addMCPServerToClientsStep } = await import("./add-mcp-server-to-clients-t0xe8gn1.js").then((n) => n.r);
+			const { addMCPServerToClientsStep } = await import("./add-mcp-server-to-clients-D2XNlVgw.js").then((n) => n.r);
 			await addMCPServerToClientsStep({
 				local: localMcp,
 				features,
@@ -2704,7 +3623,7 @@ function runMcpRemove(argv) {
 		const debug = argv.debug;
 		const localMcp = argv.local;
 		try {
-			const { startTUI } = await import("./start-tui-DnAG57vY.js");
+			const { startTUI } = await import("./start-tui-Cbw0kVr3.js");
 			const { buildSession } = await import("./wizard-session-wPJtNl4c.js");
 			const tui = startTUI(VERSION, Program.McpRemove);
 			tui.store.session = buildSession({
@@ -2713,7 +3632,7 @@ function runMcpRemove(argv) {
 			});
 		} catch {
 			setUI(new LoggingUI());
-			const { removeMCPServerFromClientsStep } = await import("./add-mcp-server-to-clients-t0xe8gn1.js").then((n) => n.r);
+			const { removeMCPServerFromClientsStep } = await import("./add-mcp-server-to-clients-D2XNlVgw.js").then((n) => n.r);
 			await removeMCPServerFromClientsStep({ local: localMcp });
 		}
 	})();
@@ -2735,7 +3654,7 @@ function runMcpTutorial(argv) {
 		const debug = argv.debug;
 		const localMcp = argv.local;
 		try {
-			const { startTUI } = await import("./start-tui-DnAG57vY.js");
+			const { startTUI } = await import("./start-tui-Cbw0kVr3.js");
 			const { buildSession } = await import("./wizard-session-wPJtNl4c.js");
 			const tui = startTUI(VERSION, Program.McpTutorial);
 			tui.store.session = buildSession({
@@ -2790,7 +3709,7 @@ function runWizard(config, options) {
 	(async () => {
 		try {
 			const installDir = options.installDir || process.cwd();
-			const { startTUI } = await import("./start-tui-DnAG57vY.js");
+			const { startTUI } = await import("./start-tui-Cbw0kVr3.js");
 			const { buildSession, RunPhase } = await import("./wizard-session-wPJtNl4c.js");
 			const { TaskStreamPush } = await import("./task-stream-BQNSp0qR.js");
 			const { PostHogDestination } = await import("./posthog-Cr37rnla.js");
@@ -2846,7 +3765,7 @@ function runWizard(config, options) {
 			await activeTui.store.getGate("health-check");
 			const skipAgent = config.run == null;
 			if (skipAgent) {
-				const { getOrAskForProjectData } = await import("./setup-utils-D87CyNkw.js").then((n) => n.r);
+				const { getOrAskForProjectData } = await import("./setup-utils-CjKjaKcG.js").then((n) => n.r);
 				const { projectApiKey, host, accessToken, projectId } = await getOrAskForProjectData({
 					signup: session.signup,
 					ci: session.ci,
@@ -2861,7 +3780,7 @@ function runWizard(config, options) {
 					projectId
 				});
 			} else {
-				const { runAgent } = await import("./agent-runner-L_-kJ3y3.js");
+				const { runAgent } = await import("./agent-runner-D7hIITUf.js");
 				await runAgent(config, activeTui.store.session);
 			}
 			const isDone = () => skipAgent ? activeTui.store.session.outroDismissed : activeTui.store.session.skillsComplete;
@@ -2938,10 +3857,10 @@ function runWizardCI(config, options) {
 	(async () => {
 		const path = await import("path");
 		const { buildSession } = await import("./wizard-session-wPJtNl4c.js");
-		const { readEnvironment } = await import("./environment-DQPoj9sU.js").then((n) => n.t);
+		const { readEnvironment } = await import("./environment-CFXsie0G.js").then((n) => n.t);
 		const { readApiKeyFromEnv } = await import("./env-api-key-MlzJYAvt.js").then((n) => n.t);
-		const { configureLogFileFromEnvironment, logToFile } = await import("./debug-CZQcMAJT.js");
-		const { wizardAbort, WizardError } = await import("./wizard-abort-BRXKRL4F.js");
+		const { configureLogFileFromEnvironment, logToFile } = await import("./debug-CDLYQOQh.js");
+		const { wizardAbort, WizardError } = await import("./wizard-abort-BPr0xo7i.js");
 		configureLogFileFromEnvironment();
 		const env = readEnvironment();
 		const apiKey = options.apiKey ?? readApiKeyFromEnv() ?? void 0;
@@ -2992,7 +3911,7 @@ function runWizardCI(config, options) {
 					})
 				});
 			}
-			const { runAgent } = await import("./agent-runner-L_-kJ3y3.js");
+			const { runAgent } = await import("./agent-runner-D7hIITUf.js");
 			await runAgent(config, session);
 		} catch (error) {
 			const errorMessage = error instanceof Error ? error.message : String(error);
@@ -3210,6 +4129,34 @@ const PromptLabel = ({ message }) => {
 	}) });
 };
 //#endregion
+//#region src/ui/tui/primitives/ConfirmButton.tsx
+/**
+* ConfirmButton — the confirm row used to submit a selection.
+*
+* Pure render. Multi-select menus (PickerMenu mode="multi", GroupedPickerMenu)
+* append this below their options as the final focusable row: the user toggles
+* options with enter, then arrows down onto this row and presses enter to
+* submit. This replaces the older "enter anywhere submits" pattern, which
+* confused people who expected enter to toggle the focused item.
+*
+* Renders flat, mirroring the option rows — a focus triangle and the label,
+* accent and bold when focused, dimmed otherwise — so it lines up under the
+* options instead of sitting in a separate boxed target.
+*/
+const ConfirmButton = ({ label = "Confirm", focused, count }) => {
+	const text = count && count > 0 ? `${label} (${count})` : label;
+	return /* @__PURE__ */ jsxs(Text, {
+		color: focused ? Colors.accent : void 0,
+		bold: focused,
+		dimColor: !focused,
+		children: [
+			focused ? Icons.triangleSmallRight : " ",
+			" ",
+			text
+		]
+	});
+};
+//#endregion
 //#region src/ui/tui/hooks/keyboard-hints-utils.ts
 /** Default priorities by key type. */
 const DEFAULT_PRIORITY = {
@@ -3345,8 +4292,10 @@ function useKeyBindings(id, bindings) {
 //#region src/ui/tui/primitives/PickerMenu.tsx
 /**
 * PickerMenu — Single and multi select.
-* Single mode: custom renderer with small triangle indicator.
-* Multi mode: checkbox glyphs with space to toggle.
+* Single mode: custom renderer with small triangle indicator; enter selects.
+* Multi mode: checkbox glyphs toggled with enter, plus a focusable
+*   Confirm button below the options. The cursor moves onto the button and
+*   enter submits — see MultiPickerMenu for the rationale.
 *
 * Key bindings are declared via useKeyBindings, which auto-registers
 * hints in the KeyboardHintsBar.
@@ -3372,6 +4321,12 @@ function firstEnabled(options) {
 	const idx = options.findIndex((o) => !o.disabled);
 	return idx === -1 ? 0 : idx;
 }
+/** Index of the last enabled option, for wrapping from the button onto
+*  the bottom of the grid. */
+function lastEnabled(options) {
+	for (let i = options.length - 1; i >= 0; i--) if (!options[i]?.disabled) return i;
+	return options.length - 1;
+}
 const PickerMenu = ({ message, options, mode = "single", centered = false, columns = 1, optionMarginBottom = 0, onSelect }) => {
 	if (mode === "multi") return /* @__PURE__ */ jsx(MultiPickerMenu, {
 		message,
@@ -3475,60 +4430,90 @@ const SinglePickerMenu = ({ message, options, centered = false, columns = 1, opt
 		})]
 	});
 };
-/** Custom multi-select with checkbox glyphs and accent highlight. */
+/**
+* Custom multi-select with checkbox glyphs and accent highlight.
+*
+* Interaction model (shared with GroupedPickerMenu):
+*   - \u2191\u2193 move the cursor through the options AND onto the Confirm button,
+*     which lives just past the last option.
+*   - enter toggles the focused option (no more "space toggles but enter
+*     advances" split that tripped people up). Space is kept as an
+*     undocumented alias, but the hints bar advertises only enter.
+*   - moving onto the Confirm button and pressing enter submits the
+*     current selection.
+*/
 const MultiPickerMenu = ({ message, options, centered = false, columns = 1, optionMarginBottom = 0, onSelect }) => {
 	const [focused, setFocused] = useState(() => firstEnabled(options));
+	const [onButton, setOnButton] = useState(false);
 	const [selected, setSelected] = useState(/* @__PURE__ */ new Set());
 	const rows = Math.ceil(options.length / columns);
 	useEffect(() => {
 		if (focused >= options.length || options[focused]?.disabled) setFocused(firstEnabled(options));
 	}, [options, focused]);
-	const bindings = [
-		{
-			match: ["upArrow", "downArrow"],
-			label: "↑↓",
-			action: "navigate",
-			handler: (_input, key) => {
-				if (key.upArrow) setFocused(stepEnabled(options, rows, focused, -1));
-				if (key.downArrow) setFocused(stepEnabled(options, rows, focused, 1));
+	const confirm = () => {
+		onSelect([...selected].sort((a, b) => a - b).map((i) => options[i].value));
+	};
+	const bindings = [{
+		match: ["upArrow", "downArrow"],
+		label: "↑↓",
+		action: "navigate",
+		handler: (_input, key) => {
+			if (key.upArrow) {
+				if (onButton) {
+					setOnButton(false);
+					setFocused(lastEnabled(options));
+					return;
+				}
+				const col = Math.floor(focused / rows);
+				let r = focused % rows - 1;
+				while (r >= 0 && options[col * rows + r]?.disabled) r--;
+				if (r >= 0) setFocused(col * rows + r);
+				else setOnButton(true);
 			}
-		},
-		{
-			match: "space",
-			label: "space",
-			action: "toggle",
-			handler: () => {
-				if (options[focused]?.disabled) return;
-				setSelected((prev) => {
-					const next = new Set(prev);
-					if (next.has(focused)) {
-						next.delete(focused);
-						return next;
-					}
-					if (options[focused]?.exclusive) return new Set([focused]);
-					for (const i of next) if (options[i]?.exclusive) next.delete(i);
-					next.add(focused);
-					return next;
-				});
+			if (key.downArrow) {
+				if (onButton) {
+					setOnButton(false);
+					setFocused(firstEnabled(options));
+					return;
+				}
+				const col = Math.floor(focused / rows);
+				const row = focused % rows;
+				const colLen = Math.min(rows, options.length - col * rows);
+				let r = row + 1;
+				while (r < colLen && options[col * rows + r]?.disabled) r++;
+				if (r < colLen) setFocused(col * rows + r);
+				else setOnButton(true);
 			}
-		},
-		{
-			match: "return",
-			label: "enter",
-			action: "confirm",
-			handler: () => {
-				if (selected.size === 0) {
-					const hovered = options[focused];
-					if (hovered && !hovered.disabled) onSelect(hovered.value);
-				} else onSelect([...selected].sort().map((i) => options[i].value));
+		}
+	}, {
+		match: ["space", "return"],
+		label: "enter",
+		action: "select",
+		handler: () => {
+			if (onButton) {
+				confirm();
+				return;
 			}
+			if (options[focused]?.disabled) return;
+			setSelected((prev) => {
+				const next = new Set(prev);
+				if (next.has(focused)) {
+					next.delete(focused);
+					return next;
+				}
+				if (options[focused]?.exclusive) return new Set([focused]);
+				for (const i of next) if (options[i]?.exclusive) next.delete(i);
+				next.add(focused);
+				return next;
+			});
 		}
-	];
+	}];
 	if (columns > 1) bindings.splice(1, 0, {
 		match: ["leftArrow", "rightArrow"],
 		label: "←→",
 		action: "navigate",
 		handler: (_input, key) => {
+			if (onButton) return;
 			const col = Math.floor(focused / rows);
 			const row = focused % rows;
 			let next = focused;
@@ -3550,43 +4535,65 @@ const MultiPickerMenu = ({ message, options, centered = false, columns = 1, opti
 	return /* @__PURE__ */ jsxs(Box, {
 		flexDirection: "column",
 		alignItems: centered ? "center" : void 0,
-		children: [/* @__PURE__ */ jsx(PromptLabel, { message }), /* @__PURE__ */ jsx(Box, {
-			flexDirection: "row",
-			gap: 4,
-			marginLeft: centered ? 0 : 2,
-			marginTop: 1,
-			children: columnArrays.map((colOpts, colIdx) => /* @__PURE__ */ jsx(Box, {
-				flexDirection: "column",
-				children: colOpts.map((opt, rowIdx) => {
-					const flatIdx = colIdx * rows + rowIdx;
-					const isFocused = flatIdx === focused;
-					const isSelected = selected.has(flatIdx);
-					const label = opt.hint ? `${opt.label} (${opt.hint})` : opt.label;
-					const checkbox = isSelected ? Icons.squareFilled : Icons.squareOpen;
-					return /* @__PURE__ */ jsxs(Box, {
-						gap: 1,
-						marginBottom: optionMarginBottom,
-						children: [
-							/* @__PURE__ */ jsx(Text, {
-								color: isSelected ? "white" : Colors.muted,
-								dimColor: !isFocused && !isSelected,
-								children: checkbox
-							}),
-							opt.icon && /* @__PURE__ */ jsx(Text, {
-								color: opt.icon.color,
-								children: opt.icon.glyph
-							}),
-							/* @__PURE__ */ jsx(Text, {
-								color: opt.disabled ? Colors.muted : isFocused ? Colors.accent : void 0,
-								bold: isFocused && !opt.disabled,
-								dimColor: !isFocused || opt.disabled,
-								children: label
-							})
-						]
-					}, flatIdx);
+		children: [
+			/* @__PURE__ */ jsx(PromptLabel, { message }),
+			/* @__PURE__ */ jsx(Box, {
+				flexDirection: "row",
+				gap: 4,
+				marginLeft: centered ? 0 : 2,
+				marginTop: 1,
+				children: columnArrays.map((colOpts, colIdx) => /* @__PURE__ */ jsx(Box, {
+					flexDirection: "column",
+					children: colOpts.map((opt, rowIdx) => {
+						const flatIdx = colIdx * rows + rowIdx;
+						const isFocused = !onButton && flatIdx === focused;
+						const isSelected = selected.has(flatIdx);
+						const label = opt.hint ? `${opt.label} (${opt.hint})` : opt.label;
+						const checkbox = isSelected ? Icons.squareFilled : Icons.squareOpen;
+						return /* @__PURE__ */ jsxs(Box, {
+							flexDirection: "column",
+							marginBottom: optionMarginBottom,
+							children: [/* @__PURE__ */ jsxs(Box, {
+								gap: 1,
+								children: [
+									/* @__PURE__ */ jsx(Text, {
+										color: isSelected ? "white" : Colors.muted,
+										dimColor: !isFocused && !isSelected,
+										children: checkbox
+									}),
+									opt.icon && /* @__PURE__ */ jsx(Text, {
+										color: opt.icon.color,
+										children: opt.icon.glyph
+									}),
+									/* @__PURE__ */ jsx(Text, {
+										color: opt.disabled ? Colors.muted : isFocused ? Colors.accent : void 0,
+										bold: isFocused && !opt.disabled,
+										dimColor: !isFocused || opt.disabled,
+										children: label
+									})
+								]
+							}), opt.description && /* @__PURE__ */ jsx(Box, {
+								marginLeft: 4,
+								width: 56,
+								children: /* @__PURE__ */ jsx(Text, {
+									dimColor: true,
+									wrap: "wrap",
+									children: opt.description
+								})
+							})]
+						}, flatIdx);
+					})
+				}, colIdx))
+			}),
+			/* @__PURE__ */ jsx(Box, {
+				marginTop: 1,
+				marginLeft: centered ? 0 : 2,
+				children: /* @__PURE__ */ jsx(ConfirmButton, {
+					focused: onButton,
+					count: selected.size
 				})
-			}, colIdx))
-		})]
+			})
+		]
 	});
 };
 //#endregion
@@ -3771,7 +4778,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-D87CyNkw.js").then((n) => n.r);
+		const { getOrAskForProjectData } = await import("./setup-utils-CjKjaKcG.js").then((n) => n.r);
 		const { host, accessToken, projectId } = await getOrAskForProjectData({
 			signup: false,
 			ci: true,
@@ -3788,7 +4795,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-DNS-L-1U.js").then((n) => n.n);
+		const { ApiError } = await import("./api-2zPZQONC.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);
@@ -3836,6 +4843,39 @@ const migrateCommand = nativeCommandFactory(migrationConfig);
 */
 const revenueCommand = nativeCommandFactory(revenueAnalyticsConfig);
 //#endregion
+//#region src/commands/warehouse.ts
+/**
+* `wizard warehouse` — detect and connect a data warehouse source.
+*
+* Mirrors `revenue-analytics`: flat skill command driven by the
+* warehouse-source program.
+*/
+const warehouseCommand = nativeCommandFactory(warehouseSourceConfig);
+//#endregion
+//#region src/commands/self-driving.ts
+const selfDrivingCommand = {
+	name: "self-driving",
+	description: selfDrivingConfig.description,
+	options: {
+		...skillProgramOptions,
+		...selfDrivingConfig.cliOptions ?? {}
+	},
+	check: (argv) => {
+		if (argv.signup) throw new Error("`self-driving` cannot run with --signup. It builds on an existing PostHog integration — run the base `wizard` to create your account and set up PostHog first, then run `wizard self-driving`.");
+		if (argv.ci) throw new Error("`self-driving` cannot run in CI mode — it requires interactive steps (GitHub connect, issue-tracker selection, custom-scout approval).");
+		return true;
+	},
+	handler: (argv) => {
+		const extras = selfDrivingConfig.mapCliOptions?.(argv) ?? {};
+		const options = {
+			...argv,
+			...extras
+		};
+		if (options.ci) runWizardCI(selfDrivingConfig, options);
+		else runWizard(selfDrivingConfig, options);
+	}
+};
+//#endregion
 //#region src/commands/slack.ts
 const slackCommand = {
 	name: "slack",
@@ -3851,7 +4891,7 @@ function runSlackConnect(argv) {
 	(async () => {
 		const debug = argv.debug;
 		try {
-			const { startTUI } = await import("./start-tui-DnAG57vY.js");
+			const { startTUI } = await import("./start-tui-Cbw0kVr3.js");
 			const { buildSession } = await import("./wizard-session-wPJtNl4c.js");
 			const tui = startTUI(VERSION, Program.SlackConnect);
 			tui.store.session = buildSession({ debug });
@@ -4228,8 +5268,8 @@ function resolveInstallDir() {
 	if (inline) return inline.slice(14);
 	return process.env.POSTHOG_WIZARD_INSTALL_DIR ?? process.cwd();
 }
-Wizard.use(basicIntegrationCommand).use(mcpCommand).use(cliCommand).use(auditCommand).use(doctorCommand).use(migrateCommand).use(revenueCommand).use(slackCommand).use(uploadSourcemapsCommand).use(skillCommand).init();
+Wizard.use(basicIntegrationCommand).use(mcpCommand).use(cliCommand).use(auditCommand).use(doctorCommand).use(migrateCommand).use(revenueCommand).use(warehouseCommand).use(selfDrivingCommand).use(slackCommand).use(uploadSourcemapsCommand).use(skillCommand).init();
 //#endregion
-export { POSTHOG_SDKS$1 as _, PromptLabel as a, PROGRAM_REGISTRY as c, DISPLAY_NAME as d, SOURCE_MAPS_CONTEXT_KEYS as f, getContentBlocks$2 as g, fetchHealthIssues as h, useKeyboardHintsContext as i, Program as l, getKindMeta as m, useKeyBindings as n, runWizardCI as o, getContentBlocks$1 as p, KeyboardHintsProvider as r, runWizard as s, PickerMenu as t, getProgramConfig as u, STRIPE_SDKS as v };
+export { getContentBlocks$2 as _, ConfirmButton as a, runWizard as c, getProgramConfig as d, DISPLAY_NAME as f, getDetectedWarehouseSources as g, fetchHealthIssues as h, useKeyboardHintsContext as i, PROGRAM_REGISTRY as l, getKindMeta as m, useKeyBindings as n, PromptLabel as o, SOURCE_MAPS_CONTEXT_KEYS as p, KeyboardHintsProvider as r, runWizardCI as s, PickerMenu as t, Program as u, POSTHOG_SDKS$1 as v, STRIPE_SDKS as y };
 
 //# sourceMappingURL=bin.js.map