@posthog/wizard 2.44.0 → 2.46.0

package/dist/bin.js

@@ -1,28 +1,27 @@
 #!/usr/bin/env node
-import { L as Integration, U as POSTHOG_DOCS_URL, a as getLogFilePath, bt as isHeadless, dt as WIZARD_USER_AGENT, f as getUI, ht as VERSION, m as LoggingUI, p as setUI, pt as getSkillsBaseUrl, r as debug, s as logToFile, yt as headlessOption } from "./debug-DXfQFmcM.js";
-import { n as analytics } from "./analytics-DSlQuwOT.js";
-import { r as setEntryCommand } from "./telemetry-DZShaH-y.js";
-import { n as isUsingTypeScript } from "./setup-utils-BQCl28D8.js";
-import { o as handleApiError } from "./api-BXduJZrw.js";
-import "./wizard-session-BAZql11N.js";
-import { r as runCleanups } from "./wizard-abort-C14PzXZ8.js";
-import { n as isNonInteractiveEnvironment } from "./environment-F1yw21dG.js";
-import { n as runAgent, o as authenticate } from "./agent-runner-BF6_f8Qh.js";
-import { l as recoverOrphanedSettingsBackups, p as AgentSignals } from "./agent-interface-BvTxWiol.js";
-import { i as fetchSkillMenu, t as WIZARD_TOOL_NAMES } from "./wizard-tools-B7SLjCic.js";
-import { n as AUDIT_CHECKS_KEY, r as AUDIT_REPORT_FILE, t as AUDIT_CHECKS_FILE } from "./types-y3HkjtSq.js";
-import { h as SETUP_REPORT_FILE } from "./yara-hooks-CPH8N4yz.js";
-import { i as SPINNER_MESSAGE, t as FRAMEWORK_REGISTRY } from "./registry-DcoBCMQR.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-BhLKCFsI.js";
-import { n as safeReadFile, r as walkProjectFiles, t as IGNORED_DIRS } from "./file-utils-D-7YfJ7A.js";
-import { n as readApiKeyFromEnv } from "./env-api-key-cjD4yfGT.js";
+import { B as Integration, Et as regionOption, K as POSTHOG_DOCS_URL, Tt as isHeadless, a as getLogFilePath, bt as VERSION, f as getUI, gt as WIZARD_USER_AGENT, m as LoggingUI, p as setUI, r as debug, s as logToFile, vt as getSkillsBaseUrl, wt as headlessOption } from "./debug-C9HmIrwx.js";
+import { n as analytics } from "./analytics-k76OWsl0.js";
+import { r as setEntryCommand } from "./telemetry-CYr4HgS2.js";
+import { n as isUsingTypeScript } from "./setup-utils-Cb5uACEO.js";
+import { o as handleApiError } from "./api-CmIWcW-U.js";
+import "./wizard-session-tp4Zdbwl.js";
+import { r as runCleanups } from "./wizard-abort-FuyIaI_0.js";
+import { n as isNonInteractiveEnvironment } from "./environment-NJykOp33.js";
+import { n as runAgent, o as authenticate } from "./agent-runner-CV3qh_2p.js";
+import { l as recoverOrphanedSettingsBackups, p as AgentSignals, v as WIZARD_TOOL_NAMES, x as fetchSkillMenu } from "./agent-interface-B8roB2UP.js";
+import { _ as AUDIT_CHECKS_FILE, h as SETUP_REPORT_FILE, v as AUDIT_CHECKS_KEY, y as AUDIT_REPORT_FILE } from "./yara-hooks-DdYRRxfH.js";
+import { i as SPINNER_MESSAGE } from "./registry-DT58jEYr.js";
+import { S as gatherFrameworkContext, _ as detectWarehousePrerequisites, a as LINE_CHART_BLOCK, g as WAREHOUSE_ABORT_CASES, 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 getDetectedWarehouseSources, x as resolveProjectDir, y as detectIntegrationProjects } from "./posthog-integration-Do997QON.js";
+import { t as IGNORED_DIRS } from "./file-utils-CLMcNIKi.js";
+import { n as readApiKeyFromEnv } from "./env-api-key-C3LzH8Lr.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, resolve, sep } from "path";
+import path, { join, relative } from "path";
 import * as os from "node:os";
 import * as path$1 from "node:path";
+import { join as join$1 } from "node:path";
 import { spawnSync } from "node:child_process";
 import * as fs$1 from "node:fs";
 import axios from "axios";
@@ -74,11 +73,6 @@ const GLOBAL_OPTIONS = {
 		describe: "Enable verbose logging\nenv: POSTHOG_WIZARD_DEBUG",
 		type: "boolean"
 	},
-	region: {
-		describe: "PostHog cloud region\nenv: POSTHOG_WIZARD_REGION",
-		choices: ["us", "eu"],
-		type: "string"
-	},
 	signup: {
 		default: false,
 		describe: "Create a new PostHog account during setup\nenv: POSTHOG_WIZARD_SIGNUP",
@@ -206,7 +200,7 @@ function runProvision(argv) {
 }
 async function provision({ email, region, name, baseUrl, jsonMode }) {
 	try {
-		const { provisionNewAccount } = await import("./provisioning-jVZm2E-A.js").then((n) => n.n);
+		const { provisionNewAccount } = await import("./provisioning-DpqnGk3z.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);
@@ -262,7 +256,8 @@ const basicIntegrationCommand = {
 			type: "boolean",
 			hidden: true
 		},
-		...headlessOption
+		...headlessOption,
+		...regionOption
 	},
 	check: (argv) => {
 		if (argv.playground && (argv.ci || isHeadless(argv))) throw new Error("--playground cannot be combined with a headless run.");
@@ -272,22 +267,22 @@ const basicIntegrationCommand = {
 		setEntryCommand("integrate");
 		(async () => {
 			if (isHeadless(argv)) {
-				const { runHeadlessInstall } = await import("./ci-install-GirEJqu2.js");
+				const { runHeadlessInstall } = await import("./ci-install-CNEJxdHf.js");
 				return runHeadlessInstall(argv);
 			}
 			if (argv.ci) {
-				const { runCIInstall } = await import("./ci-install-GirEJqu2.js");
+				const { runCIInstall } = await import("./ci-install-CNEJxdHf.js");
 				return runCIInstall(argv);
 			}
 			if (isNonInteractiveEnvironment()) {
-				const { failNonInteractive } = await import("./non-interactive-BIHqcW8g.js");
+				const { failNonInteractive } = await import("./non-interactive-8Eypq_h-.js");
 				return failNonInteractive();
 			}
 			if (argv.playground) {
-				const { runPlayground } = await import("./playground-DwL36I2u.js");
+				const { runPlayground } = await import("./playground-C-9Q3ETa.js");
 				return runPlayground();
 			}
-			const { runInteractive } = await import("./interactive-Bmi82rsO.js");
+			const { runInteractive } = await import("./interactive-CIJRex02.js");
 			runInteractive(argv);
 		})();
 	}
@@ -530,809 +525,6 @@ 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: "Plaid",
-		label: "Plaid",
-		mode: "in-cli",
-		signals: {
-			npm: ["plaid"],
-			python: ["plaid-python", "plaid"],
-			ruby: ["plaid"],
-			envKeys: [/^PLAID_/]
-		}
-	},
-	{
-		kind: "Braintree",
-		label: "Braintree",
-		mode: "in-cli",
-		signals: {
-			npm: ["braintree"],
-			python: ["braintree"],
-			ruby: ["braintree"],
-			envKeys: [/^BRAINTREE_/]
-		}
-	},
-	{
-		kind: "Square",
-		label: "Square",
-		mode: "in-cli",
-		signals: {
-			npm: ["square"],
-			python: ["squareup"],
-			ruby: ["square"],
-			envKeys: [/^SQUARE_/]
-		}
-	},
-	{
-		kind: "GoCardless",
-		label: "GoCardless",
-		mode: "in-cli",
-		signals: {
-			npm: ["gocardless-nodejs"],
-			python: ["gocardless-pro"],
-			ruby: ["gocardless_pro"],
-			envKeys: [/^GOCARDLESS_/]
-		}
-	},
-	{
-		kind: "Mollie",
-		label: "Mollie",
-		mode: "in-cli",
-		signals: {
-			npm: ["@mollie/api-client"],
-			python: ["mollie-api-python"],
-			envKeys: [/^MOLLIE_/]
-		}
-	},
-	{
-		kind: "CheckoutCom",
-		label: "Checkout.com",
-		mode: "in-cli",
-		signals: {
-			npm: ["checkout-sdk-node"],
-			python: ["checkout-sdk"],
-			envKeys: [/^CKO_/, /^CHECKOUT_COM_/]
-		}
-	},
-	{
-		kind: "Recurly",
-		label: "Recurly",
-		mode: "in-cli",
-		signals: {
-			npm: ["recurly"],
-			python: ["recurly"],
-			ruby: ["recurly"],
-			envKeys: [/^RECURLY_/]
-		}
-	},
-	{
-		kind: "RevenueCat",
-		label: "RevenueCat",
-		mode: "in-cli",
-		signals: {
-			npm: [
-				"@revenuecat/purchases-js",
-				"react-native-purchases",
-				"@revenuecat/purchases-capacitor"
-			],
-			envKeys: [/^REVENUE_?CAT_/]
-		}
-	},
-	{
-		kind: "Twilio",
-		label: "Twilio",
-		mode: "in-cli",
-		signals: {
-			npm: ["twilio"],
-			python: ["twilio"],
-			ruby: ["twilio-ruby"],
-			envKeys: [/^TWILIO_/]
-		}
-	},
-	{
-		kind: "SendGrid",
-		label: "SendGrid",
-		mode: "in-cli",
-		signals: {
-			npm: ["@sendgrid/mail", "@sendgrid/client"],
-			python: ["sendgrid"],
-			ruby: ["sendgrid-ruby"],
-			envKeys: [/^SENDGRID_/]
-		}
-	},
-	{
-		kind: "Mailgun",
-		label: "Mailgun",
-		mode: "in-cli",
-		signals: {
-			npm: ["mailgun.js", "mailgun-js"],
-			python: ["mailgun"],
-			ruby: ["mailgun-ruby"],
-			envKeys: [/^MAILGUN_/]
-		}
-	},
-	{
-		kind: "Postmark",
-		label: "Postmark",
-		mode: "in-cli",
-		signals: {
-			npm: ["postmark"],
-			python: ["postmarker"],
-			ruby: ["postmark"],
-			envKeys: [/^POSTMARK_/]
-		}
-	},
-	{
-		kind: "Brevo",
-		label: "Brevo",
-		mode: "in-cli",
-		signals: {
-			npm: ["@getbrevo/brevo", "sib-api-v3-sdk"],
-			python: ["sib-api-v3-sdk"],
-			envKeys: [/^BREVO_/]
-		}
-	},
-	{
-		kind: "MailerLite",
-		label: "MailerLite",
-		mode: "in-cli",
-		signals: {
-			npm: ["@mailerlite/mailerlite-nodejs"],
-			python: ["mailerlite"],
-			envKeys: [/^MAILERLITE_/]
-		}
-	},
-	{
-		kind: "Mailjet",
-		label: "Mailjet",
-		mode: "in-cli",
-		signals: {
-			npm: ["node-mailjet"],
-			python: ["mailjet-rest"],
-			envKeys: [/^MAILJET_/, /^MJ_APIKEY_/]
-		}
-	},
-	{
-		kind: "LaunchDarkly",
-		label: "LaunchDarkly",
-		mode: "in-cli",
-		signals: {
-			npm: [
-				"launchdarkly-node-server-sdk",
-				"@launchdarkly/node-server-sdk",
-				"launchdarkly-js-client-sdk",
-				"launchdarkly-react-client-sdk"
-			],
-			python: ["launchdarkly-server-sdk"],
-			ruby: ["launchdarkly-server-sdk"],
-			envKeys: [/^LAUNCHDARKLY_/, /^LD_SDK_KEY$/]
-		}
-	},
-	{
-		kind: "Optimizely",
-		label: "Optimizely",
-		mode: "in-cli",
-		signals: {
-			npm: ["@optimizely/optimizely-sdk"],
-			python: ["optimizely-sdk"],
-			envKeys: [/^OPTIMIZELY_/]
-		}
-	},
-	{
-		kind: "Braze",
-		label: "Braze",
-		mode: "in-cli",
-		signals: {
-			npm: ["@braze/web-sdk", "@braze/react-native-sdk"],
-			python: ["braze-client"],
-			envKeys: [/^BRAZE_/]
-		}
-	},
-	{
-		kind: "Rollbar",
-		label: "Rollbar",
-		mode: "in-cli",
-		signals: {
-			npm: ["rollbar"],
-			python: ["rollbar", "pyrollbar"],
-			ruby: ["rollbar"],
-			envKeys: [/^ROLLBAR_/]
-		}
-	},
-	{
-		kind: "Okta",
-		label: "Okta",
-		mode: "in-cli",
-		signals: {
-			npm: [
-				"@okta/okta-sdk-nodejs",
-				"@okta/okta-auth-js",
-				"@okta/okta-react"
-			],
-			python: ["okta"],
-			envKeys: [/^OKTA_/]
-		}
-	},
-	{
-		kind: "WorkOS",
-		label: "WorkOS",
-		mode: "in-cli",
-		signals: {
-			npm: ["@workos-inc/node"],
-			python: ["workos"],
-			envKeys: [/^WORKOS_/]
-		}
-	},
-	{
-		kind: "Notion",
-		label: "Notion",
-		mode: "in-cli",
-		signals: {
-			npm: ["@notionhq/client"],
-			python: ["notion-client"],
-			envKeys: [/^NOTION_/]
-		}
-	},
-	{
-		kind: "FullStory",
-		label: "FullStory",
-		mode: "in-cli",
-		signals: {
-			npm: ["@fullstory/browser", "@fullstory/react-native"],
-			envKeys: [/^FULLSTORY_/]
-		}
-	},
-	{
-		kind: "Amplitude",
-		label: "Amplitude",
-		mode: "in-cli",
-		signals: {
-			npm: [
-				"@amplitude/analytics-browser",
-				"@amplitude/analytics-node",
-				"@amplitude/analytics-react-native",
-				"amplitude-js"
-			],
-			python: ["amplitude-analytics"],
-			envKeys: [/^AMPLITUDE_/]
-		}
-	},
-	{
-		kind: "Mixpanel",
-		label: "Mixpanel",
-		mode: "in-cli",
-		signals: {
-			npm: ["mixpanel", "mixpanel-browser"],
-			python: ["mixpanel"],
-			ruby: ["mixpanel-ruby"],
-			envKeys: [/^MIXPANEL_/]
-		}
-	},
-	{
-		kind: "Pendo",
-		label: "Pendo",
-		mode: "in-cli",
-		signals: {
-			npm: ["@pendo/agent"],
-			envKeys: [/^PENDO_/]
-		}
-	},
-	{
-		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$/]
-		}
-	},
-	{
-		kind: "Slack",
-		label: "Slack",
-		mode: "deep-link",
-		signals: {
-			npm: ["@slack/web-api", "@slack/bolt"],
-			python: ["slack-sdk", "slack-bolt"],
-			envKeys: [/^SLACK_(BOT|APP|SIGNING|CLIENT)_/]
-		}
-	},
-	{
-		kind: "Github",
-		label: "GitHub",
-		mode: "deep-link",
-		signals: {
-			npm: [
-				"@octokit/rest",
-				"@octokit/core",
-				"@octokit/graphql",
-				"octokit"
-			],
-			python: ["pygithub"],
-			ruby: ["octokit"]
-		}
-	}
-];
-//#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(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(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;
-	}
-	analytics.setTag("warehouse_source_kinds", sources.map((s) => s.kind).join(","));
-	analytics.setTag("warehouse_source_modes", sources.map((s) => `${s.kind}:${s.mode}`).join(","));
-	analytics.setTag("warehouse_source_count", sources.length);
-	setFrameworkContext(DETECTED_WAREHOUSE_SOURCES_KEY, sources);
-}
-//#endregion
 //#region src/lib/programs/warehouse-source/steps.ts
 const WAREHOUSE_SOURCE_PROGRAM = [
 	{
@@ -1636,7 +828,10 @@ const auditConfig = {
 	run: auditRun,
 	allowedTools: ["Agent"],
 	disallowedTools: [WIZARD_TOOL_NAMES.wizardAsk],
-	cliOptions: { ...headlessOption }
+	cliOptions: {
+		...headlessOption,
+		...regionOption
+	}
 };
 //#endregion
 //#region src/lib/programs/events-audit/steps.ts
@@ -2603,10 +1798,12 @@ const DISPLAY_NAME = {
 };
 /**
 * Variants the wizard can wire up source-map upload for automatically. The
-* native variants (react-native, android, flutter, ios) are recognised but not
-* yet automatable, so the agentic picker treats them as non-instrumentable.
+* native variants (react-native, flutter) are recognised but not yet
+* automatable, so the agentic picker treats them as non-instrumentable.
 */
 const AUTOMATABLE_VARIANTS = [
+	"android",
+	"ios",
 	"web",
 	"nextjs",
 	"node",
@@ -2617,6 +1814,11 @@ const AUTOMATABLE_VARIANTS = [
 	"webpack",
 	"rollup"
 ];
+/**
+* Variants the wizard pre-installs a machine-global `posthog-cli` for — their
+* build shells out to it with no npx / local-dep fallback. JS variants stay out.
+*/
+const VARIANTS_REQUIRING_POSTHOG_CLI = new Set(["ios", "android"]);
 /** `[ABORT] <reason>` cases the source maps skill can emit. */
 const SOURCE_MAPS_ABORT_CASES = [{
 	match: /^no posthog sdk detected$/i,
@@ -2690,6 +1892,28 @@ function buildSourceMapsUploadPrompt(params) {
 	const { displayName, variant, skillId, projectPath, projectId, host, settingsUrl, uiHost } = params;
 	const platformLabel = displayName ?? variant;
 	const inSubproject = projectPath != null && projectPath !== ".";
+	const projectLine = inSubproject ? `- Project directory (relative to the wizard's working directory): ${projectPath}` : "- Project directory: the wizard's working directory (even when it sits inside a larger git repo, this directory is the project root)";
+	const credentialSteps = `STEP 4 — Make the credentials readable at build time. (skill: "Make credentials available at build time")
+   Follow the skill's step. Wizard-specific: if it calls for a loader (e.g.
+   \`dotenv\`), install it SILENTLY — do NOT ask the user or call wizard_ask.
+   Skip this step entirely if the platform already auto-loads .env.
+
+STEP 5 — Write the credentials to the env file. (skill: "Write credentials to the env file")
+   Use the wizard-tools MCP server. Reuse the env file the skill tells you to
+   pick — the prerequisite PostHog integration usually already wrote
+   POSTHOG_* vars to one, so seed your keys alongside them.
+   - First call check_env_keys on that file (returns present/absent, never
+     values — don't read the file directly).
+   - Env tool path rule: ${inSubproject ? `Tool filePaths are relative to the wizard's working directory, not the selected project directory. Treat the skill's env path as relative to the selected project and prefix it with \`${projectPath}/\` when calling the tools: for example, pass \`${projectPath}/.env\`, not \`.env\` (which would target the wizard's working directory).` : `Tool filePaths are relative to the wizard's working directory. For an env file at this project root, pass \`.env\`; never prefix it with this directory's path inside an ancestor repository.`}
+   - Then call set_env_values, passing the STEP 1 secretRef as a value
+     object, not a literal string:
+       values: {
+         "POSTHOG_CLI_API_KEY": { secretRef: "<the ref from STEP 1>" },
+         "POSTHOG_CLI_PROJECT_ID": "${projectId}",
+         "POSTHOG_CLI_HOST": "${uiHost}"
+       }
+   Variable names follow the skill's per-uploader conventions. The wizard
+   resolves the ref locally before writing, so you never see the key value.`;
 	return `You are wiring up PostHog Error Tracking source map upload for this ${platformLabel} project.
 
 Project context:
@@ -2697,7 +1921,7 @@ Project context:
 - PostHog Host: ${host}
 - Detected platform: ${platformLabel}
 - Skill to use: ${skillId}
-${inSubproject ? `- Project directory (relative to repo root): ${projectPath}` : "- Project directory: the repo root"}
+${projectLine}
 - Personal API keys settings page: ${settingsUrl}
 
 All file changes, build/run commands, and config edits target the project directory above${inSubproject ? ` — this is a monorepo, so scope your work to \`${projectPath}\` and do not touch other packages` : ""}.
@@ -2765,26 +1989,7 @@ STEP 3 — Apply build-config changes. (skill: "Apply build-config changes")
    Make the bundler / build-config changes the skill's step instructs. The
    skill and its reference are the source of truth for this platform.
 
-STEP 4 — Make the credentials readable at build time. (skill: "Make credentials available at build time")
-   Follow the skill's step. Wizard-specific: if it calls for a loader (e.g.
-   \`dotenv\`), install it SILENTLY — do NOT ask the user or call wizard_ask.
-   Skip this step entirely if the platform already auto-loads .env.
-
-STEP 5 — Write the credentials to the env file. (skill: "Write credentials to the env file")
-   Use the wizard-tools MCP server. Reuse the env file the skill tells you to
-   pick — the prerequisite PostHog integration usually already wrote
-   POSTHOG_* vars to one, so seed your keys alongside them.
-   - First call check_env_keys on that file (returns present/absent, never
-     values — don't read the file directly).
-   - Then call set_env_values, passing the STEP 1 secretRef as a value
-     object, not a literal string:
-       values: {
-         "POSTHOG_CLI_API_KEY": { secretRef: "<the ref from STEP 1>" },
-         "POSTHOG_CLI_PROJECT_ID": "${projectId}",
-         "POSTHOG_CLI_HOST": "${host}"
-       }
-   Variable names follow the skill's per-uploader conventions. The wizard
-   resolves the ref locally before writing, so you never see the key value.
+${credentialSteps}
 
 STEP 6 — Identify the build AND run commands. (skill: "Identify the build and run commands")
    Per the skill, resolve the production BUILD command and the RUN command
@@ -2822,13 +2027,24 @@ STEP 8 — Offer to test the local setup. (skill: "Test the local setup")
    If "yes", follow the skill's "Test the local setup" step for the
    platform-appropriate affordance, the captureException shape, the
    placement, and the read-before-edit / always-revert rules. Then pause for
-   the user with wizard_ask, baking the EXACT build and run commands from
-   STEP 6 (and the exact button label / route) into the prompt as literal,
-   copy-pasteable steps. Separate each numbered step with \\n\\n so the TUI
-   renders them as distinct lines:
+   the user with wizard_ask, baking the build-and-run flow (and the exact
+   button label / route) into the prompt as literal, copy-pasteable
+   numbered steps:
+   - Steps 1-2: the production build, then launching the app and
+     triggering the test affordance. Source them from STEP 6 and the
+     skill's "Test the local setup" step — when the skill gives the
+     platform's test flow as verbatim steps (IDE-driven platforms like
+     Xcode do), use its wording and do NOT invent CLI build commands,
+     debugger steps, or relaunch steps it doesn't state. Quote CLI
+     commands verbatim. When build and run are one action (an IDE Run),
+     fold them into step 1 and make step 2 just triggering the affordance.
+   - The last step is always the Error Tracking check, exactly as in the
+     template.
+   Separate each numbered step with \\n\\n so the TUI renders them as
+   distinct lines:
         {
           id: "test-done",
-          prompt: "1) Run \`<your detected build command>\` to upload source maps and build the app with the test affordance.\\n\\n2) Start the app with \`<your detected run command>\`, then click the \\"<your test button label>\\" button (or hit \`<your test route>\`).\\n\\n3) Open Error Tracking in PostHog (${uiHost}/project/${projectId}/error_tracking) and confirm the test error appears with a source-resolved stack trace pointing at real source files (not minified bundle paths).\\n\\nWhen you're done, select Continue and I'll revert the test code.",
+          prompt: "1) <production build step — it uploads source maps and builds the app with the test affordance>\\n\\n2) <run step>, then click the \\"<your test button label>\\" button (or hit \`<your test route>\`).\\n\\n3) Open Error Tracking in PostHog (${uiHost}/project/${projectId}/error_tracking) and confirm the test error appears with a source-resolved stack trace pointing at real source files (not minified bundle paths).\\n\\nWhen you're done, select Continue and I'll revert the test code.",
           kind: "single",
           options: [{ label: "Continue (revert test code)", value: "continue" }]
         }
@@ -3170,9 +2386,135 @@ const getContentBlocks$1 = (store) => pace([
 	}
 ]);
 //#endregion
+//#region src/steps/install-cli-steering/index.ts
+const dirExists = (...segments) => {
+	try {
+		return fs$1.existsSync(path$1.join(os.homedir(), ...segments));
+	} catch {
+		return false;
+	}
+};
+const CLI_STEERING_TARGETS = [
+	{
+		id: "claude-code",
+		name: "Claude Code",
+		instructionsPath: () => path$1.join(os.homedir(), ".claude", "CLAUDE.md"),
+		isDetected: () => dirExists(".claude")
+	},
+	{
+		id: "codex",
+		name: "Codex",
+		instructionsPath: () => path$1.join(os.homedir(), ".codex", "AGENTS.md"),
+		isDetected: () => dirExists(".codex")
+	},
+	{
+		id: "gemini",
+		name: "Gemini CLI",
+		instructionsPath: () => path$1.join(os.homedir(), ".gemini", "GEMINI.md"),
+		isDetected: () => dirExists(".gemini")
+	}
+];
+function findTarget(id) {
+	return CLI_STEERING_TARGETS.find((target) => target.id === id);
+}
+function detectTargets() {
+	return CLI_STEERING_TARGETS.filter((target) => target.isDetected());
+}
+const spawnOptions = {
+	encoding: "utf-8",
+	shell: process.platform === "win32"
+};
+/**
+* Install or update the PostHog CLI in the user's environment. `npm install
+* --global @posthog/cli@latest` covers both first-time installs and upgrades
+* for existing npm-installed CLIs.
+*/
+function installOrUpdatePostHogCli() {
+	const args = [
+		"install",
+		"--global",
+		"@posthog/cli@latest"
+	];
+	debug(`Running npm ${args.join(" ")}`);
+	const result = spawnSync("npm", args, spawnOptions);
+	if (result.error) return {
+		success: false,
+		error: `Failed to run npm: ${result.error.message}. Is Node.js installed?`,
+		errorObject: result.error
+	};
+	if (result.status !== 0) {
+		const message = (result.stderr || result.stdout || "").trim() || `npm install --global @posthog/cli@latest exited with status ${result.status ?? "unknown"}`;
+		return {
+			success: false,
+			error: message,
+			errorObject: new Error(message)
+		};
+	}
+	return { success: true };
+}
+/**
+* Delegate the actual write to the installed `posthog-cli api agents-md
+* install`. The steering snippet lives in the CLI (its single source of truth),
+* so the command should run only after `installOrUpdatePostHogCli` refreshes
+* the CLI to the latest release.
+*/
+function installSteeringSnippet(filePath) {
+	const args = [
+		"api",
+		"agents-md",
+		"install",
+		"--path",
+		filePath
+	];
+	debug(`Running posthog-cli ${args.join(" ")}`);
+	const result = spawnSync("posthog-cli", args, {
+		...spawnOptions,
+		env: {
+			...process.env,
+			POSTHOG_CLI_EXPERIMENTAL_API: "1"
+		}
+	});
+	if (result.error) return {
+		success: false,
+		filePath,
+		error: `Failed to run posthog-cli: ${result.error.message}. Make sure npm's global bin directory is on your PATH.`
+	};
+	if (result.status !== 0) return {
+		success: false,
+		filePath,
+		error: (result.stderr || result.stdout || "").trim() || `posthog-cli exited with status ${result.status ?? "unknown"}`
+	};
+	return {
+		success: true,
+		filePath
+	};
+}
+//#endregion
 //#region src/lib/programs/error-tracking-upload-source-maps/index.ts
 const REPORT_FILE$1 = "posthog-source-maps-report.md";
 const DOCS_URL$1 = "https://posthog.com/docs/error-tracking/upload-source-maps";
+let postHogCliInstallAttempted = false;
+/**
+* Pre-install posthog-cli for variants that need a machine-global copy
+* (`VARIANTS_REQUIRING_POSTHOG_CLI`). The agent can't — warlock blocks
+* `npm install -g` — so the wizard does it in-process. Warn, don't fail.
+*/
+function ensurePostHogCli(variant) {
+	if (postHogCliInstallAttempted) return;
+	postHogCliInstallAttempted = true;
+	const result = installOrUpdatePostHogCli();
+	if (!result.success) {
+		analytics.wizardCapture("source maps posthog-cli preinstall failed", {
+			variant,
+			error: String(result.error).slice(0, 500)
+		});
+		analytics.captureException(result.errorObject ?? /* @__PURE__ */ new Error(`posthog-cli pre-install failed: ${result.error}`), {
+			source: "source_maps_cli_preinstall",
+			variant
+		});
+		getUI().log.warn(`Could not pre-install posthog-cli (${result.error}). Your release build will fail to upload debug symbols until it's installed: npm install -g @posthog/cli@latest`);
+	}
+}
 const errorTrackingUploadSourceMapsConfig = {
 	command: "upload-source-maps",
 	description: "Upload source maps to PostHog Error Tracking",
@@ -3204,6 +2546,7 @@ const errorTrackingUploadSourceMapsConfig = {
 			customPrompt: (ctx) => {
 				const { variant, displayName, projectPath, skillId } = readSelection();
 				if (!skillId || !variant) return SOURCE_MAPS_DETECTION_FAILED_PROMPT;
+				if (VARIANTS_REQUIRING_POSTHOG_CLI.has(variant)) ensurePostHogCli(variant);
 				const uiHost = ctx.host.appHost.replace(/\/$/, "");
 				return buildSourceMapsUploadPrompt({
 					displayName,
@@ -3444,23 +2787,6 @@ function detectSelfDrivingPrerequisites(session, setFrameworkContext) {
 }
 //#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 {
@@ -3492,11 +2818,7 @@ function toIntegrationReport(report) {
 }
 /** 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
-	}));
+	return toIntegrationReport(await detectIntegrationProjects(session, { onEvent }));
 }
 /**
 * Prepare the integration phase after the user picked a project on the
@@ -3523,36 +2845,10 @@ async function prepSelfDrivingIntegration(session) {
 }
 //#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.
-* The picked path originates from LLM output; if it resolves outside the
-* repo (defense-in-depth on top of the coerce-layer clamp), fall back to
-* the root rather than run the agent elsewhere.
-*/
-const integrationDir = (session) => {
-	const rel = session.frameworkContext[SELF_DRIVING_INTEGRATE_PATH_KEY];
-	if (typeof rel !== "string" || rel === ".") return session.installDir;
-	const root = resolve(session.installDir);
-	const dir = resolve(root, rel);
-	return dir === root || dir.startsWith(root + sep) ? dir : root;
-};
+/** Absolute dir to integrate into: the picked sub-app (LLM output — the shared resolver clamps escapes), else the repo root. */
+const integrationDir = (session) => resolveProjectDir(session.installDir, session.frameworkContext[SELF_DRIVING_INTEGRATE_PATH_KEY]);
 const SELF_DRIVING_PROGRAM = [
 	{
 		id: "detect",
@@ -4433,13 +3729,13 @@ const mcpAddCommand = {
 function runMcpAdd(argv) {
 	const features = parseFeatures(argv.features);
 	(async () => {
-		const { readApiKeyFromEnv } = await import("./env-api-key-cjD4yfGT.js").then((n) => n.t);
+		const { readApiKeyFromEnv } = await import("./env-api-key-C3LzH8Lr.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-DgSKFMVh.js");
-			const { buildSession } = await import("./wizard-session-C5lZPPEc.js");
+			const { startTUI } = await import("./start-tui-Cwc-PFma.js");
+			const { buildSession } = await import("./wizard-session-DWHe83uk.js");
 			const tui = startTUI(VERSION, Program.McpAdd);
 			tui.store.session = buildSession({
 				debug,
@@ -4451,7 +3747,7 @@ function runMcpAdd(argv) {
 		} catch (error) {
 			if (!isTUIUnavailable(error)) throw error;
 			setUI(new LoggingUI());
-			const { addMCPServerToClientsStep } = await import("./add-mcp-server-to-clients-D5qsqCkj.js").then((n) => n.r);
+			const { addMCPServerToClientsStep } = await import("./add-mcp-server-to-clients-Bv2CBSil.js").then((n) => n.r);
 			await addMCPServerToClientsStep({
 				local: localMcp,
 				features,
@@ -4490,8 +3786,8 @@ function runMcpRemove(argv) {
 		const debug = argv.debug;
 		const localMcp = argv.local;
 		try {
-			const { startTUI } = await import("./start-tui-DgSKFMVh.js");
-			const { buildSession } = await import("./wizard-session-C5lZPPEc.js");
+			const { startTUI } = await import("./start-tui-Cwc-PFma.js");
+			const { buildSession } = await import("./wizard-session-DWHe83uk.js");
 			const tui = startTUI(VERSION, Program.McpRemove);
 			tui.store.session = buildSession({
 				debug,
@@ -4500,7 +3796,7 @@ function runMcpRemove(argv) {
 			});
 		} catch {
 			setUI(new LoggingUI());
-			const { removeMCPServerFromClientsStep } = await import("./add-mcp-server-to-clients-D5qsqCkj.js").then((n) => n.r);
+			const { removeMCPServerFromClientsStep } = await import("./add-mcp-server-to-clients-Bv2CBSil.js").then((n) => n.r);
 			await removeMCPServerFromClientsStep({ local: localMcp });
 		}
 	})();
@@ -4522,8 +3818,8 @@ function runMcpTutorial(argv) {
 		const debug = argv.debug;
 		const localMcp = argv.local;
 		try {
-			const { startTUI } = await import("./start-tui-DgSKFMVh.js");
-			const { buildSession } = await import("./wizard-session-C5lZPPEc.js");
+			const { startTUI } = await import("./start-tui-Cwc-PFma.js");
+			const { buildSession } = await import("./wizard-session-DWHe83uk.js");
 			const tui = startTUI(VERSION, Program.McpTutorial);
 			tui.store.session = buildSession({
 				debug,
@@ -4603,10 +3899,10 @@ function runWizard(config, options) {
 	(async () => {
 		try {
 			const installDir = options.installDir || process.cwd();
-			const { startTUI } = await import("./start-tui-DgSKFMVh.js");
-			const { buildSession, RunPhase } = await import("./wizard-session-C5lZPPEc.js");
-			const { TaskStreamPush } = await import("./task-stream-0Pk0tPBN.js");
-			const { PostHogDestination } = await import("./posthog-DwKlq0HM.js");
+			const { startTUI } = await import("./start-tui-Cwc-PFma.js");
+			const { buildSession, RunPhase } = await import("./wizard-session-DWHe83uk.js");
+			const { TaskStreamPush } = await import("./task-stream-DQT3vjwS.js");
+			const { PostHogDestination } = await import("./posthog-DZZbziJ1.js");
 			tui = startTUI(WIZARD_VERSION, config.id);
 			const activeTui = tui;
 			const session = buildSession({
@@ -4639,6 +3935,7 @@ function runWizard(config, options) {
 					getCredentials: () => activeTui.store.session.credentials,
 					onError: (err) => logToFile("[task-stream-push]", err.message)
 				})],
+				eventPlanPath: config.eventPlanFile ? join$1(session.installDir, config.eventPlanFile) : void 0,
 				enabled: taskStreamEnabled
 			});
 			const activeStream = taskStream;
@@ -4670,7 +3967,7 @@ function runWizard(config, options) {
 				if (shown(step)) await advanceStep(step, activeTui.store, config);
 			}
 			else if (skipAgent) {
-				const { getOrAskForProjectData } = await import("./setup-utils-BQCl28D8.js").then((n) => n.r);
+				const { getOrAskForProjectData } = await import("./setup-utils-Cb5uACEO.js").then((n) => n.r);
 				const { projectApiKey, host, accessToken, projectId } = await getOrAskForProjectData({
 					signup: session.signup,
 					ci: session.ci,
@@ -4732,15 +4029,14 @@ function modeLabel(mode) {
 	return mode === "headless" ? "Headless" : "CI";
 }
 /**
-* The single non-interactive validation layer: defaults region and requires
-* api-key and install-dir. Every non-interactive entry point routes through
+* The single non-interactive validation layer: requires api-key and
+* install-dir. Every non-interactive entry point routes through
 * `runNonInteractive`, so this is the one place these checks live. UI must be
 * initialized before calling.
 */
 function validateNonInteractiveOptions(options, mode) {
 	const label = modeLabel(mode);
 	const keyHint = mode === "headless" ? "personal API key phx_xxx or pha_ OAuth access token" : "personal API key phx_xxx";
-	if (!options.region) options.region = "us";
 	if (!options.apiKey) {
 		getUI().intro("PostHog Wizard");
 		getUI().log.error(`${label} mode requires --api-key (${keyHint})`);
@@ -4772,11 +4068,11 @@ function runNonInteractive(config, options, mode) {
 	analytics.setTag("build", mode);
 	(async () => {
 		const path = await import("path");
-		const { buildSession, RunPhase, OutroKind } = await import("./wizard-session-C5lZPPEc.js");
-		const { readEnvironment } = await import("./environment-F1yw21dG.js").then((n) => n.t);
-		const { readApiKeyFromEnv } = await import("./env-api-key-cjD4yfGT.js").then((n) => n.t);
-		const { configureLogFileFromEnvironment, logToFile } = await import("./debug-BOFxiVVs.js");
-		const { wizardAbort, WizardError } = await import("./wizard-abort-UCm4Pd5m.js");
+		const { buildSession, RunPhase, OutroKind } = await import("./wizard-session-DWHe83uk.js");
+		const { readEnvironment } = await import("./environment-NJykOp33.js").then((n) => n.t);
+		const { readApiKeyFromEnv } = await import("./env-api-key-C3LzH8Lr.js").then((n) => n.t);
+		const { configureLogFileFromEnvironment, logToFile } = await import("./debug-BwIo7nwn.js");
+		const { wizardAbort, WizardError } = await import("./wizard-abort-D_-v1zvS.js");
 		configureLogFileFromEnvironment();
 		const env = readEnvironment();
 		const apiKey = options.apiKey ?? readApiKeyFromEnv() ?? void 0;
@@ -4797,7 +4093,8 @@ function runNonInteractive(config, options, mode) {
 			harness: options.harness,
 			sequence: options.sequence,
 			model: options.model,
-			...env
+			...env,
+			region: options.region ?? env.region
 		});
 		session.programLabel = config.id;
 		if (config.skillId) session.skillId = config.skillId;
@@ -4807,9 +4104,9 @@ function runNonInteractive(config, options, mode) {
 		let store = null;
 		let taskStream = null;
 		if (mode === "headless") {
-			const { WizardStore } = await import("./store-C79GoHCQ.js").then((n) => n.n);
-			const { HeadlessUI } = await import("./headless-ui-Dni0gPND.js");
-			const { TaskStreamPush, PostHogDestination } = await import("./task-stream-0Pk0tPBN.js");
+			const { WizardStore } = await import("./store-4sj-vWr5.js").then((n) => n.n);
+			const { HeadlessUI } = await import("./headless-ui-B3QKxbz8.js");
+			const { TaskStreamPush, PostHogDestination } = await import("./task-stream-DQT3vjwS.js");
 			store = new WizardStore(config.id);
 			store.session = session;
 			setUI(new HeadlessUI(store));
@@ -4820,6 +4117,7 @@ function runNonInteractive(config, options, mode) {
 					getCredentials: () => session.credentials,
 					onError: (e) => logToFile("[headless task-stream]", e.message)
 				})],
+				eventPlanPath: config.eventPlanFile ? join$1(session.installDir, config.eventPlanFile) : void 0,
 				enabled: !session.noTelemetry
 			});
 			taskStream.attach();
@@ -4864,7 +4162,7 @@ function runNonInteractive(config, options, mode) {
 					});
 				}
 			}
-			const { runAgent } = await import("./agent-runner-BF6_f8Qh.js").then((n) => n.t);
+			const { runAgent } = await import("./agent-runner-CV3qh_2p.js").then((n) => n.t);
 			await runAgent(config, session);
 			await settleStream(RunPhase.Completed);
 		} catch (error) {
@@ -5793,7 +5091,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-BQCl28D8.js").then((n) => n.r);
+		const { getOrAskForProjectData } = await import("./setup-utils-Cb5uACEO.js").then((n) => n.r);
 		const { host, accessToken, projectId } = await getOrAskForProjectData({
 			signup: false,
 			ci: true,
@@ -5811,7 +5109,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-BXduJZrw.js").then((n) => n.n);
+		const { ApiError } = await import("./api-CmIWcW-U.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);
@@ -5893,8 +5191,8 @@ function runSlackConnect(argv) {
 	(async () => {
 		const debug = argv.debug;
 		try {
-			const { startTUI } = await import("./start-tui-DgSKFMVh.js");
-			const { buildSession } = await import("./wizard-session-C5lZPPEc.js");
+			const { startTUI } = await import("./start-tui-Cwc-PFma.js");
+			const { buildSession } = await import("./wizard-session-DWHe83uk.js");
 			const tui = startTUI(VERSION, Program.SlackConnect);
 			tui.store.session = buildSession({
 				debug,
@@ -6017,105 +5315,6 @@ const skillCommand = {
 	}
 };
 //#endregion
-//#region src/steps/install-cli-steering/index.ts
-const dirExists = (...segments) => {
-	try {
-		return fs$1.existsSync(path$1.join(os.homedir(), ...segments));
-	} catch {
-		return false;
-	}
-};
-const CLI_STEERING_TARGETS = [
-	{
-		id: "claude-code",
-		name: "Claude Code",
-		instructionsPath: () => path$1.join(os.homedir(), ".claude", "CLAUDE.md"),
-		isDetected: () => dirExists(".claude")
-	},
-	{
-		id: "codex",
-		name: "Codex",
-		instructionsPath: () => path$1.join(os.homedir(), ".codex", "AGENTS.md"),
-		isDetected: () => dirExists(".codex")
-	},
-	{
-		id: "gemini",
-		name: "Gemini CLI",
-		instructionsPath: () => path$1.join(os.homedir(), ".gemini", "GEMINI.md"),
-		isDetected: () => dirExists(".gemini")
-	}
-];
-function findTarget(id) {
-	return CLI_STEERING_TARGETS.find((target) => target.id === id);
-}
-function detectTargets() {
-	return CLI_STEERING_TARGETS.filter((target) => target.isDetected());
-}
-const spawnOptions = {
-	encoding: "utf-8",
-	shell: process.platform === "win32"
-};
-/**
-* Install or update the PostHog CLI in the user's environment. `npm install
-* --global @posthog/cli@latest` covers both first-time installs and upgrades
-* for existing npm-installed CLIs.
-*/
-function installOrUpdatePostHogCli() {
-	const args = [
-		"install",
-		"--global",
-		"@posthog/cli@latest"
-	];
-	debug(`Running npm ${args.join(" ")}`);
-	const result = spawnSync("npm", args, spawnOptions);
-	if (result.error) return {
-		success: false,
-		error: `Failed to run npm: ${result.error.message}. Is Node.js installed?`
-	};
-	if (result.status !== 0) return {
-		success: false,
-		error: (result.stderr || result.stdout || "").trim() || `npm install --global @posthog/cli@latest exited with status ${result.status ?? "unknown"}`
-	};
-	return { success: true };
-}
-/**
-* Delegate the actual write to the installed `posthog-cli api agents-md
-* install`. The steering snippet lives in the CLI (its single source of truth),
-* so the command should run only after `installOrUpdatePostHogCli` refreshes
-* the CLI to the latest release.
-*/
-function installSteeringSnippet(filePath) {
-	const args = [
-		"api",
-		"agents-md",
-		"install",
-		"--path",
-		filePath
-	];
-	debug(`Running posthog-cli ${args.join(" ")}`);
-	const result = spawnSync("posthog-cli", args, {
-		...spawnOptions,
-		env: {
-			...process.env,
-			POSTHOG_CLI_EXPERIMENTAL_API: "1"
-		}
-	});
-	if (result.error) return {
-		success: false,
-		filePath,
-		error: `Failed to run posthog-cli: ${result.error.message}. Make sure npm's global bin directory is on your PATH.`
-	};
-	if (result.status !== 0) return {
-		success: false,
-		filePath,
-		error: (result.stderr || result.stdout || "").trim() || `posthog-cli exited with status ${result.status ?? "unknown"}`
-	};
-	return {
-		success: true,
-		filePath
-	};
-}
-//#endregion
 //#region src/commands/cli/add.ts
 const cliAddCommand = {
 	name: "add",
@@ -6275,6 +5474,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 { 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$3 as x, fetchHealthIssues as y };
+export { STRIPE_SDKS as S, SOURCE_MAPS_CONTEXT_KEYS as _, ConfirmButton as a, getContentBlocks$3 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, POSTHOG_SDKS as x, fetchHealthIssues as y };
 
 //# sourceMappingURL=bin.js.map