@posthog/wizard 2.45.0 → 2.47.0

package/dist/bin.js

@@ -1,21 +1,19 @@
 #!/usr/bin/env node
-import { B as Integration, Ct as headlessOption, K as POSTHOG_DOCS_URL, _t as getSkillsBaseUrl, a as getLogFilePath, f as getUI, ht as WIZARD_USER_AGENT, m as LoggingUI, p as setUI, r as debug, s as logToFile, wt as isHeadless, yt as VERSION } from "./debug-DBmxx59Q.js";
-import { n as analytics } from "./analytics-DQEuL6qS.js";
-import { r as setEntryCommand } from "./telemetry-DgahJGSx.js";
-import { n as isUsingTypeScript } from "./setup-utils-Qp-u6BZk.js";
-import { o as handleApiError } from "./api-uCMvDII5.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-BiU-S12q.js";
+import { n as analytics } from "./analytics-B4dny8FA.js";
+import { r as setEntryCommand } from "./telemetry-3Y8LxNVU.js";
+import { n as isUsingTypeScript } from "./setup-utils-BMy5Zj3Z.js";
+import { o as handleApiError } from "./api-CdPvsnUm.js";
 import "./wizard-session-tp4Zdbwl.js";
-import { r as runCleanups } from "./wizard-abort-BxtdkgI-.js";
-import { n as isNonInteractiveEnvironment } from "./environment-kZtkp7eG.js";
-import { n as runAgent, o as authenticate } from "./agent-runner-B0LTVFfw.js";
-import { l as recoverOrphanedSettingsBackups, p as AgentSignals } from "./agent-interface-CF7GsdFf.js";
-import { n as AUDIT_CHECKS_KEY, r as AUDIT_REPORT_FILE, t as AUDIT_CHECKS_FILE } from "./types-BRe_EzTW.js";
-import { i as fetchSkillMenu, t as WIZARD_TOOL_NAMES } from "./wizard-tools-Dg8o2lcH.js";
-import { h as SETUP_REPORT_FILE } from "./yara-hooks-pw86rZ8y.js";
-import { i as SPINNER_MESSAGE } from "./registry-D2V88NoC.js";
-import { S as parseRequirementsTxt, a as LINE_CHART_BLOCK, b as parsePipfile, g as detectIntegrationProjects, 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 resolveProjectDir, x as parsePyprojectToml, y as gatherFrameworkContext } from "./posthog-integration-dmWJZ8mj.js";
-import { n as safeReadFile, r as walkProjectFiles, t as IGNORED_DIRS } from "./file-utils-BAhYy5vC.js";
-import { n as readApiKeyFromEnv } from "./env-api-key-AcC_tz8G.js";
+import { r as runCleanups } from "./wizard-abort-D1UxHeiE.js";
+import { n as isNonInteractiveEnvironment } from "./environment-BT0RRheV.js";
+import { n as runAgent, o as authenticate } from "./agent-runner-D8pEOs_2.js";
+import { l as recoverOrphanedSettingsBackups, p as AgentSignals, v as WIZARD_TOOL_NAMES, x as fetchSkillMenu } from "./agent-interface-RZY46R62.js";
+import { _ as AUDIT_CHECKS_FILE, h as SETUP_REPORT_FILE, v as AUDIT_CHECKS_KEY, y as AUDIT_REPORT_FILE } from "./yara-hooks-D9PSjEqo.js";
+import { i as SPINNER_MESSAGE } from "./registry-Zp3B2L4q.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-BnWgrvts.js";
+import { t as IGNORED_DIRS } from "./file-utils-B1_Eciop.js";
+import { n as readApiKeyFromEnv } from "./env-api-key-C3LzH8Lr.js";
 import { satisfies } from "semver";
 import yargs from "yargs";
 import { hideBin } from "yargs/helpers";
@@ -75,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",
@@ -207,7 +200,7 @@ function runProvision(argv) {
 }
 async function provision({ email, region, name, baseUrl, jsonMode }) {
 	try {
-		const { provisionNewAccount } = await import("./provisioning-CcxCry5p.js").then((n) => n.n);
+		const { provisionNewAccount } = await import("./provisioning-DS8zDveH.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);
@@ -263,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.");
@@ -273,22 +267,22 @@ const basicIntegrationCommand = {
 		setEntryCommand("integrate");
 		(async () => {
 			if (isHeadless(argv)) {
-				const { runHeadlessInstall } = await import("./ci-install-Bow8-f0j.js");
+				const { runHeadlessInstall } = await import("./ci-install-g8govb-6.js");
 				return runHeadlessInstall(argv);
 			}
 			if (argv.ci) {
-				const { runCIInstall } = await import("./ci-install-Bow8-f0j.js");
+				const { runCIInstall } = await import("./ci-install-g8govb-6.js");
 				return runCIInstall(argv);
 			}
 			if (isNonInteractiveEnvironment()) {
-				const { failNonInteractive } = await import("./non-interactive-DQA9vn9f.js");
+				const { failNonInteractive } = await import("./non-interactive-C0NbQTcD.js");
 				return failNonInteractive();
 			}
 			if (argv.playground) {
-				const { runPlayground } = await import("./playground-CbEndzc8.js");
+				const { runPlayground } = await import("./playground-DZoNrDEM.js");
 				return runPlayground();
 			}
-			const { runInteractive } = await import("./interactive-Cyic0bGL.js");
+			const { runInteractive } = await import("./interactive-Bgb8njPS.js");
 			runInteractive(argv);
 		})();
 	}
@@ -531,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 = [
 	{
@@ -1637,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
@@ -2604,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",
@@ -2618,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,
@@ -2691,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:
@@ -2698,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` : ""}.
@@ -2766,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
@@ -2823,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" }]
         }
@@ -3171,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",
@@ -3205,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,
@@ -4281,6 +3623,61 @@ const mcpAnalyticsConfig = createSkillProgram({
 	}]
 });
 //#endregion
+//#region src/lib/programs/ai-observability/index.ts
+const AI_OBSERVABILITY_STEPS = AGENT_SKILL_STEPS.map((step) => step.id === "intro" ? {
+	...step,
+	screenId: "ai-observability-intro"
+} : step);
+const AI_OBSERVABILITY_REPORT_FILE = "posthog-ai-observability-report.md";
+/**
+* `wizard ai-observability` — wrap the project's LLM client calls so they emit
+* `$ai_generation` events into LLM Analytics.
+*
+* No `run.skillId`: the context-mill `ai-observability` group ships one variant
+* per (LLM provider × language) and the wizard does no provider detection —
+* the agent loads the menu, matches the manifest's vendor SDK, and installs
+* the right variant itself (see `customPrompt`). Stays flat while a single
+* "add AIO to a project" flow is the only action.
+*/
+const aiObservabilityConfig = {
+	command: "ai-observability",
+	description: "Add PostHog AI Observability to your LLM calls",
+	id: "ai-observability",
+	steps: AI_OBSERVABILITY_STEPS,
+	reportFile: AI_OBSERVABILITY_REPORT_FILE,
+	getContentBlocks: getContentBlocks$3,
+	run: {
+		integrationLabel: "ai-observability",
+		customPrompt: () => `Instrument this project's LLM calls with PostHog AI Observability.
+
+This flow has no pre-installed skill — you install the right one yourself:
+
+1. Call \`load_skill_menu\` with \`category: "ai-observability"\`. The menu is
+   the source of truth: one variant per (LLM provider × language), plus a
+   \`manual-capture\` variant for projects with no vendor SDK.
+
+2. Scan the project manifest (\`package.json\`, \`pyproject.toml\`,
+   \`requirements.txt\`) for a vendor LLM SDK and pick the variant that matches
+   it — the language follows the manifest (\`package.json\` → Node, Python
+   tooling → Python). Multiple SDKs (e.g. LangChain wrapping OpenAI) → prefer
+   the higher abstraction. No vendor SDK → the \`manual-capture\` variant.
+   Genuinely ambiguous → \`wizard_ask\` with a multi-choice picker.
+
+3. Call \`install_skill\` with the picked variant id. Then follow that skill's
+   \`SKILL.md\` and references end-to-end. The skill itself will install
+   packages, wire OTel, set env vars, and describe verification.
+
+Make only additive changes — do not touch existing PostHog init, identify
+calls, event capture, or dashboards. Those belong to other skills. The
+final report is written to ./${AI_OBSERVABILITY_REPORT_FILE}.`,
+		successMessage: `AI Observability configured! View the report at ./${AI_OBSERVABILITY_REPORT_FILE}`,
+		reportFile: AI_OBSERVABILITY_REPORT_FILE,
+		docsUrl: "https://posthog.com/docs/ai-observability",
+		spinnerMessage: "Setting up AI Observability...",
+		estimatedDurationMinutes: 5
+	}
+};
+//#endregion
 //#region src/lib/programs/slack/index.ts
 const slackConnectConfig = {
 	id: "slack",
@@ -4329,6 +3726,7 @@ const PROGRAM_REGISTRY = [
 	mcpRemoveConfig,
 	mcpTutorialConfig,
 	mcpAnalyticsConfig,
+	aiObservabilityConfig,
 	slackConnectConfig
 ];
 /**
@@ -4352,6 +3750,7 @@ const Program = {
 	McpRemove: mcpRemoveConfig.id,
 	McpTutorial: mcpTutorialConfig.id,
 	McpAnalytics: mcpAnalyticsConfig.id,
+	AiObservability: aiObservabilityConfig.id,
 	SlackConnect: slackConnectConfig.id
 };
 /**
@@ -4387,12 +3786,12 @@ const mcpAddCommand = {
 function runMcpAdd(argv) {
 	const features = parseFeatures(argv.features);
 	(async () => {
-		const { readApiKeyFromEnv } = await import("./env-api-key-AcC_tz8G.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-DHa_9aiB.js");
+			const { startTUI } = await import("./start-tui-CJ7i0pbr.js");
 			const { buildSession } = await import("./wizard-session-DWHe83uk.js");
 			const tui = startTUI(VERSION, Program.McpAdd);
 			tui.store.session = buildSession({
@@ -4405,7 +3804,7 @@ function runMcpAdd(argv) {
 		} catch (error) {
 			if (!isTUIUnavailable(error)) throw error;
 			setUI(new LoggingUI());
-			const { addMCPServerToClientsStep } = await import("./add-mcp-server-to-clients-CNzZMSat.js").then((n) => n.r);
+			const { addMCPServerToClientsStep } = await import("./add-mcp-server-to-clients-Dg64O4OZ.js").then((n) => n.r);
 			await addMCPServerToClientsStep({
 				local: localMcp,
 				features,
@@ -4444,7 +3843,7 @@ function runMcpRemove(argv) {
 		const debug = argv.debug;
 		const localMcp = argv.local;
 		try {
-			const { startTUI } = await import("./start-tui-DHa_9aiB.js");
+			const { startTUI } = await import("./start-tui-CJ7i0pbr.js");
 			const { buildSession } = await import("./wizard-session-DWHe83uk.js");
 			const tui = startTUI(VERSION, Program.McpRemove);
 			tui.store.session = buildSession({
@@ -4454,7 +3853,7 @@ function runMcpRemove(argv) {
 			});
 		} catch {
 			setUI(new LoggingUI());
-			const { removeMCPServerFromClientsStep } = await import("./add-mcp-server-to-clients-CNzZMSat.js").then((n) => n.r);
+			const { removeMCPServerFromClientsStep } = await import("./add-mcp-server-to-clients-Dg64O4OZ.js").then((n) => n.r);
 			await removeMCPServerFromClientsStep({ local: localMcp });
 		}
 	})();
@@ -4476,7 +3875,7 @@ function runMcpTutorial(argv) {
 		const debug = argv.debug;
 		const localMcp = argv.local;
 		try {
-			const { startTUI } = await import("./start-tui-DHa_9aiB.js");
+			const { startTUI } = await import("./start-tui-CJ7i0pbr.js");
 			const { buildSession } = await import("./wizard-session-DWHe83uk.js");
 			const tui = startTUI(VERSION, Program.McpTutorial);
 			tui.store.session = buildSession({
@@ -4557,10 +3956,10 @@ function runWizard(config, options) {
 	(async () => {
 		try {
 			const installDir = options.installDir || process.cwd();
-			const { startTUI } = await import("./start-tui-DHa_9aiB.js");
+			const { startTUI } = await import("./start-tui-CJ7i0pbr.js");
 			const { buildSession, RunPhase } = await import("./wizard-session-DWHe83uk.js");
-			const { TaskStreamPush } = await import("./task-stream-B7qia9eW.js");
-			const { PostHogDestination } = await import("./posthog-DFyux4Vw.js");
+			const { TaskStreamPush } = await import("./task-stream-DlgLKdMC.js");
+			const { PostHogDestination } = await import("./posthog-DZZbziJ1.js");
 			tui = startTUI(WIZARD_VERSION, config.id);
 			const activeTui = tui;
 			const session = buildSession({
@@ -4625,7 +4024,7 @@ function runWizard(config, options) {
 				if (shown(step)) await advanceStep(step, activeTui.store, config);
 			}
 			else if (skipAgent) {
-				const { getOrAskForProjectData } = await import("./setup-utils-Qp-u6BZk.js").then((n) => n.r);
+				const { getOrAskForProjectData } = await import("./setup-utils-BMy5Zj3Z.js").then((n) => n.r);
 				const { projectApiKey, host, accessToken, projectId } = await getOrAskForProjectData({
 					signup: session.signup,
 					ci: session.ci,
@@ -4687,15 +4086,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})`);
@@ -4728,10 +4126,10 @@ function runNonInteractive(config, options, mode) {
 	(async () => {
 		const path = await import("path");
 		const { buildSession, RunPhase, OutroKind } = await import("./wizard-session-DWHe83uk.js");
-		const { readEnvironment } = await import("./environment-kZtkp7eG.js").then((n) => n.t);
-		const { readApiKeyFromEnv } = await import("./env-api-key-AcC_tz8G.js").then((n) => n.t);
-		const { configureLogFileFromEnvironment, logToFile } = await import("./debug-BixHZmHv.js");
-		const { wizardAbort, WizardError } = await import("./wizard-abort-DpDmuCfA.js");
+		const { readEnvironment } = await import("./environment-BT0RRheV.js").then((n) => n.t);
+		const { readApiKeyFromEnv } = await import("./env-api-key-C3LzH8Lr.js").then((n) => n.t);
+		const { configureLogFileFromEnvironment, logToFile } = await import("./debug-DQWRmiju.js");
+		const { wizardAbort, WizardError } = await import("./wizard-abort-DoI_ZWM-.js");
 		configureLogFileFromEnvironment();
 		const env = readEnvironment();
 		const apiKey = options.apiKey ?? readApiKeyFromEnv() ?? void 0;
@@ -4752,7 +4150,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;
@@ -4762,9 +4161,9 @@ function runNonInteractive(config, options, mode) {
 		let store = null;
 		let taskStream = null;
 		if (mode === "headless") {
-			const { WizardStore } = await import("./store-DSwsITKX.js").then((n) => n.n);
-			const { HeadlessUI } = await import("./headless-ui-DWmMyhaP.js");
-			const { TaskStreamPush, PostHogDestination } = await import("./task-stream-B7qia9eW.js");
+			const { WizardStore } = await import("./store-CVZL9JJe.js").then((n) => n.n);
+			const { HeadlessUI } = await import("./headless-ui-DQVBpo0v.js");
+			const { TaskStreamPush, PostHogDestination } = await import("./task-stream-DlgLKdMC.js");
 			store = new WizardStore(config.id);
 			store.session = session;
 			setUI(new HeadlessUI(store));
@@ -4820,7 +4219,7 @@ function runNonInteractive(config, options, mode) {
 					});
 				}
 			}
-			const { runAgent } = await import("./agent-runner-B0LTVFfw.js").then((n) => n.t);
+			const { runAgent } = await import("./agent-runner-D8pEOs_2.js").then((n) => n.t);
 			await runAgent(config, session);
 			await settleStream(RunPhase.Completed);
 		} catch (error) {
@@ -4964,6 +4363,20 @@ function nativeCommandFactory(config, opts = {}) {
 */
 const mcpAnalyticsCommand = nativeCommandFactory(mcpAnalyticsConfig);
 //#endregion
+//#region src/commands/ai-observability.ts
+/**
+* `wizard ai-observability` — flat skill command, wire AI Observability into a
+* project today.
+*
+* Installs the OpenTelemetry SDK, the PostHog span processor, and the
+* provider-specific instrumentation so LLM calls emit `$ai_generation` events.
+* The `ai-observability` context-mill skill has one variant per (LLM provider ×
+* language); the agent picks the right one at run time by scanning the
+* project's manifest and (when ambiguous) asking the user via `wizard_ask`.
+* Stays flat while a single "add AIO to a project" flow is the only action.
+*/
+const aiObservabilityCommand = nativeCommandFactory(aiObservabilityConfig);
+//#endregion
 //#region src/lib/programs/dispatch-family.ts
 /**
 * Capture a CLI dispatch error, flush analytics, and exit. The wizard never
@@ -5749,7 +5162,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-Qp-u6BZk.js").then((n) => n.r);
+		const { getOrAskForProjectData } = await import("./setup-utils-BMy5Zj3Z.js").then((n) => n.r);
 		const { host, accessToken, projectId } = await getOrAskForProjectData({
 			signup: false,
 			ci: true,
@@ -5767,7 +5180,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-uCMvDII5.js").then((n) => n.n);
+		const { ApiError } = await import("./api-CdPvsnUm.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);
@@ -5849,7 +5262,7 @@ function runSlackConnect(argv) {
 	(async () => {
 		const debug = argv.debug;
 		try {
-			const { startTUI } = await import("./start-tui-DHa_9aiB.js");
+			const { startTUI } = await import("./start-tui-CJ7i0pbr.js");
 			const { buildSession } = await import("./wizard-session-DWHe83uk.js");
 			const tui = startTUI(VERSION, Program.SlackConnect);
 			tui.store.session = buildSession({
@@ -5973,105 +5386,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",
@@ -6229,8 +5543,8 @@ function resolveInstallDir() {
 	if (inline) return inline.slice(14);
 	return process.env.POSTHOG_WIZARD_INSTALL_DIR ?? process.cwd();
 }
-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();
+Wizard.use(basicIntegrationCommand).use(mcpCommand).use(mcpAnalyticsCommand).use(aiObservabilityCommand).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