@posthog/wizard 2.28.0 → 2.29.0

package/dist/bin.js

@@ -1,17 +1,17 @@
 #!/usr/bin/env node
-import { $ as getSkillsBaseUrl, P as POSTHOG_DOCS_URL, X as WIZARD_USER_AGENT, _ as SIGNUP_WIZARD_READINESS_CONFIG, a as getLogFilePath, et as VERSION, h as LoggingUI, m as setUI, p as getUI, r as debug, s as logToFile, v as evaluateWizardReadiness, y as getBlockingServiceKeys } from "./debug-BDwqX9QZ.js";
-import { t as analytics } from "./analytics-Ds4CvvcU.js";
-import { r as setEntryCommand } from "./telemetry-De90OWXL.js";
-import { n as isUsingTypeScript } from "./setup-utils-STqW1cwa.js";
-import { a as getUiHostFromHost, n as getCloudUrlFromRegion } from "./urls-DDUXt-oY.js";
-import { o as handleApiError } from "./api-Dye-Pi5r.js";
+import { I as POSTHOG_DOCS_URL, Q as WIZARD_USER_AGENT, a as getLogFilePath, h as LoggingUI, m as setUI, nt as VERSION, p as getUI, r as debug, s as logToFile, tt as getSkillsBaseUrl } from "./debug-CMZ7kqW1.js";
+import { t as analytics } from "./analytics-DvDjbNmK.js";
+import { r as setEntryCommand } from "./telemetry-DPVvKu5X.js";
+import { n as isUsingTypeScript } from "./setup-utils-DF6EKEeA.js";
+import { a as getUiHostFromHost, n as getCloudUrlFromRegion } from "./urls-Bur7Zb7A.js";
+import { o as handleApiError } from "./api-DfpSG5xU.js";
 import "./wizard-session-G3VWD6hv.js";
-import { r as runCleanups } from "./wizard-abort-B_Ri4Ant.js";
-import { n as isNonInteractiveEnvironment } from "./environment-BaqpBPme.js";
-import { S as AUDIT_REPORT_FILE, b as AUDIT_CHECKS_FILE, c as recoverOrphanedSettingsBackups, h as fetchSkillMenu, p as WIZARD_TOOL_NAMES, u as AgentSignals, x as AUDIT_CHECKS_KEY } from "./agent-interface-DRsyO_6R.js";
-import { i as SPINNER_MESSAGE } from "./registry-CSy1ilMT.js";
-import { _ as parseRequirementsTxt, a as PRODUCT_SUITE_BLOCK, f as Colors, g as parsePyprojectToml, h as parsePipfile, i as LINE_CHART_BLOCK, l as isClearBlock, m as HEALTH_CHECK_STEP, n as posthogIntegrationConfig, o as StatusPeekTrigger, p as Icons, r as FUNNEL_BLOCK } from "./posthog-integration-Bh31wBAT.js";
-import { n as safeReadFile, r as walkProjectFiles, t as IGNORED_DIRS } from "./file-utils-YnB1jGgs.js";
+import { r as runCleanups } from "./wizard-abort-D0UMhCP5.js";
+import { n as isNonInteractiveEnvironment } from "./environment-cVP7bGnh.js";
+import { S as AUDIT_REPORT_FILE, b as AUDIT_CHECKS_FILE, c as recoverOrphanedSettingsBackups, h as fetchSkillMenu, p as WIZARD_TOOL_NAMES, u as AgentSignals, x as AUDIT_CHECKS_KEY } from "./agent-interface-CVW8H9eF.js";
+import { i as SPINNER_MESSAGE } from "./registry-BgsYtCkS.js";
+import { _ as parsePyprojectToml, a as PRODUCT_SUITE_BLOCK, f as Colors, g as parsePipfile, i as LINE_CHART_BLOCK, l as isClearBlock, m as HEALTH_CHECK_STEP, n as posthogIntegrationConfig, o as StatusPeekTrigger, p as Icons, r as FUNNEL_BLOCK, v as parseRequirementsTxt } from "./posthog-integration-C_9G_kTS.js";
+import { n as safeReadFile, r as walkProjectFiles, t as IGNORED_DIRS } from "./file-utils-D1632P4x.js";
 import { n as readApiKeyFromEnv } from "./env-api-key-MlzJYAvt.js";
 import { satisfies } from "semver";
 import yargs from "yargs";
@@ -190,7 +190,7 @@ function runProvision(argv) {
 }
 async function provision({ email, region, name, jsonMode }) {
 	try {
-		const { provisionNewAccount } = await import("./provisioning-DpdPWuzQ.js").then((n) => n.n);
+		const { provisionNewAccount } = await import("./provisioning-CgCxuoe6.js").then((n) => n.n);
 		if (!jsonMode) getUI().log.info(`Provisioning account for ${email} in ${region}...`);
 		emitResult(await provisionNewAccount(email, name, region), jsonMode);
 		process.exit(0);
@@ -255,25 +255,25 @@ const basicIntegrationCommand = {
 		setEntryCommand("integrate");
 		(async () => {
 			if (argv.ci) {
-				const { runCIInstall } = await import("./ci-install-6P61txQ4.js");
+				const { runCIInstall } = await import("./ci-install-Bzfo3nON.js");
 				return runCIInstall(argv);
 			}
 			if (isNonInteractiveEnvironment()) {
-				const { failNonInteractive } = await import("./non-interactive-BJctvoie.js");
+				const { failNonInteractive } = await import("./non-interactive-u4VG76Vi.js");
 				return failNonInteractive();
 			}
 			if (argv.playground) {
-				const { runPlayground } = await import("./playground-X-wOeuhv.js");
+				const { runPlayground } = await import("./playground-B6wgUvH-.js");
 				return runPlayground();
 			}
-			const { runInteractive } = await import("./interactive-DU3K6B8R.js");
+			const { runInteractive } = await import("./interactive-DCIL3NcQ.js");
 			runInteractive(argv);
 		})();
 	}
 };
 //#endregion
 //#region src/lib/programs/shared/package-scanning.ts
-const POSTHOG_SDKS$1 = [
+const POSTHOG_SDKS = [
 	"posthog-js",
 	"posthog-node",
 	"posthog-react-native",
@@ -306,7 +306,7 @@ function findPackageJsons(installDir, maxDepth = 3) {
 			if (entry.isFile() && entry.name === "package.json") try {
 				const pkg = JSON.parse(readFileSync(fullPath, "utf-8"));
 				const depNames = [...Object.keys(pkg.dependencies ?? {}), ...Object.keys(pkg.devDependencies ?? {})];
-				const posthogSdks = depNames.filter((d) => POSTHOG_SDKS$1.includes(d));
+				const posthogSdks = depNames.filter((d) => POSTHOG_SDKS.includes(d));
 				const stripeSdks = depNames.filter((d) => STRIPE_SDKS.includes(d));
 				matches.push({
 					path: relative(installDir, fullPath) || "package.json",
@@ -766,6 +766,293 @@ const SOURCE_DETECTORS = [
 			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",
@@ -814,6 +1101,31 @@ const SOURCE_DETECTORS = [
 			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
@@ -835,7 +1147,7 @@ const MAX_DEPTH = 3;
 * so the result is naturally deduped).
 */
 function detectWarehouseSources(installDir) {
-	const signals = collectSignals$1(installDir);
+	const signals = collectSignals(installDir);
 	const detected = [];
 	for (const detector of SOURCE_DETECTORS) {
 		const match = matchDetector(detector, signals);
@@ -862,7 +1174,7 @@ function matchDetector(detector, signals) {
 	}
 	return null;
 }
-function collectSignals$1(installDir) {
+function collectSignals(installDir) {
 	const signals = {
 		npm: /* @__PURE__ */ new Set(),
 		python: /* @__PURE__ */ new Set(),
@@ -2265,12 +2577,21 @@ const DISPLAY_NAME = {
 	webpack: "Webpack",
 	rollup: "Rollup"
 };
-const POSTHOG_SDKS = [
-	"posthog-js",
-	"posthog-node",
-	"posthog-react-native",
-	"posthog-android",
-	"posthog-ios"
+/**
+* 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.
+*/
+const AUTOMATABLE_VARIANTS = [
+	"web",
+	"nextjs",
+	"node",
+	"react",
+	"angular",
+	"nuxt",
+	"vite",
+	"webpack",
+	"rollup"
 ];
 /** `[ABORT] <reason>` cases the source maps skill can emit. */
 const SOURCE_MAPS_ABORT_CASES = [{
@@ -2284,199 +2605,40 @@ const SOURCE_MAPS_ABORT_CASES = [{
 	body: "The agent could not identify how to build your project. Source map upload runs as part of the production build. Add a build script to your project and run this wizard again.",
 	docsUrl: "https://posthog.com/docs/error-tracking/upload-source-maps"
 }];
-function collectSignals(installDir, maxDepth = 3) {
-	const signals = {
-		packageJsons: [],
-		hasXcodeProject: false,
-		hasPodfile: false,
-		hasSwiftPackage: false,
-		hasGradle: false,
-		hasPubspec: false,
-		scannedFileCount: 0
-	};
-	function scan(dir, depth) {
-		if (depth > maxDepth) return;
-		let entries;
-		try {
-			entries = readdirSync(dir, { withFileTypes: true });
-		} catch {
-			return;
-		}
-		for (const entry of entries) {
-			if (entry.name.startsWith(".") && entry.name !== ".") continue;
-			if (IGNORED_DIRS.has(entry.name)) continue;
-			const fullPath = join(dir, entry.name);
-			if (entry.isFile()) {
-				signals.scannedFileCount += 1;
-				if (entry.name === "package.json") try {
-					const pkg = JSON.parse(readFileSync(fullPath, "utf-8"));
-					const deps = new Set([...Object.keys(pkg.dependencies ?? {}), ...Object.keys(pkg.devDependencies ?? {})]);
-					signals.packageJsons.push({
-						path: relative(installDir, fullPath) || "package.json",
-						deps
-					});
-				} catch {}
-				else if (entry.name === "Podfile") signals.hasPodfile = true;
-				else if (entry.name === "Package.swift") signals.hasSwiftPackage = true;
-				else if (entry.name === "pubspec.yaml") signals.hasPubspec = true;
-				else if (entry.name === "build.gradle" || entry.name === "build.gradle.kts" || entry.name === "settings.gradle" || entry.name === "settings.gradle.kts") signals.hasGradle = true;
-			} else if (entry.isDirectory()) if (entry.name.endsWith(".xcodeproj")) signals.hasXcodeProject = true;
-			else scan(fullPath, depth + 1);
-		}
-	}
-	scan(installDir, 0);
-	return signals;
-}
-function pickJsVariant(deps) {
-	if (deps.has("react-native")) return "react-native";
-	if (deps.has("nuxt")) return "nuxt";
-	if (deps.has("next")) return "nextjs";
-	if (deps.has("@angular/core")) return "angular";
-	if (deps.has("vite")) return "vite";
-	if (deps.has("webpack")) return "webpack";
-	if (deps.has("rollup")) return "rollup";
-	if (deps.has("react")) return "react";
-	if (deps.has("posthog-node")) return "node";
-	return "web";
-}
-function selectVariant(signals) {
-	if (signals.hasPubspec) return "flutter";
-	if (signals.hasXcodeProject || signals.hasPodfile || signals.hasSwiftPackage) return "ios";
-	if (signals.hasGradle) return "android";
-	if (signals.packageJsons.length > 0) {
-		const allDeps = /* @__PURE__ */ new Set();
-		for (const pkg of signals.packageJsons) for (const dep of pkg.deps) allDeps.add(dep);
-		return pickJsVariant(allDeps);
-	}
-	return null;
-}
-function hasPostHogSdk(signals) {
-	for (const pkg of signals.packageJsons) for (const sdk of POSTHOG_SDKS) if (pkg.deps.has(sdk)) return true;
-	return signals.hasXcodeProject || signals.hasPodfile || signals.hasSwiftPackage || signals.hasGradle || signals.hasPubspec;
-}
 const SOURCE_MAPS_CONTEXT_KEYS = {
 	skillVariant: "sourceMapsSkillVariant",
 	displayName: "sourceMapsDisplayName",
 	packagePaths: "sourceMapsPackagePaths",
-	detectError: "detectError"
+	detectError: "detectError",
+	selectedVariant: "sourceMapsSelectedVariant",
+	selectedDisplayName: "sourceMapsSelectedDisplayName",
+	selectedPath: "sourceMapsSelectedPath"
 };
-/**
-* Scan `session.installDir` for platform / build-system signals. Writes
-* detection results into frameworkContext via the callback — either the
-* picked skill variant + display name, or a `SourceMapsDetectError`.
-*
-* The skill install happens later in the agent run, not here. This step
-* only picks which variant the prompt should ask the agent to load.
-*/
-function detectSourceMapsPrerequisites(session, setFrameworkContext) {
-	const fail = (error) => setFrameworkContext(SOURCE_MAPS_CONTEXT_KEYS.detectError, error);
-	const installDir = session.installDir;
-	if (!existsSync(installDir)) {
-		fail({
-			kind: "bad-directory",
-			path: installDir,
-			reason: "missing"
-		});
-		return;
-	}
-	try {
-		if (!statSync(installDir).isDirectory()) {
-			fail({
-				kind: "bad-directory",
-				path: installDir,
-				reason: "not-dir"
-			});
-			return;
-		}
-	} catch {
-		fail({
-			kind: "bad-directory",
-			path: installDir,
-			reason: "unreadable"
-		});
-		return;
-	}
-	const signals = collectSignals(installDir);
-	const variant = selectVariant(signals);
-	if (variant && [
-		"react-native",
-		"flutter",
-		"ios",
-		"android"
-	].includes(variant)) {
-		fail({
-			kind: "unsupported-platform",
-			detected: variant
-		});
-		return;
-	}
-	if (!variant) {
-		if (signals.scannedFileCount === 0) fail({ kind: "no-project-files" });
-		else fail({
-			kind: "unsupported-platform",
-			detected: "unknown"
-		});
-		return;
-	}
-	if (!hasPostHogSdk(signals)) {
-		fail({
-			kind: "no-posthog-sdk",
-			platform: variant
-		});
-		return;
-	}
-	setFrameworkContext(SOURCE_MAPS_CONTEXT_KEYS.skillVariant, variant);
-	setFrameworkContext(SOURCE_MAPS_CONTEXT_KEYS.displayName, DISPLAY_NAME[variant]);
-	setFrameworkContext(SOURCE_MAPS_CONTEXT_KEYS.packagePaths, signals.packageJsons.map((p) => p.path));
-}
 //#endregion
 //#region src/lib/programs/error-tracking-upload-source-maps/steps.ts
-function healthCheckReady(session) {
-	if (!session.readinessResult) return false;
-	if (session.signup) {
-		const hardBlocking = getBlockingServiceKeys(session.readinessResult.health, SIGNUP_WIZARD_READINESS_CONFIG);
-		const defaultBlocking = getBlockingServiceKeys(session.readinessResult.health);
-		if (hardBlocking.length === 0 && defaultBlocking.length === 0) return true;
-		return session.outageDismissed;
-	}
-	if (session.readinessResult.decision === "no") return session.outageDismissed;
-	return true;
+function projectSelected(session) {
+	return session.frameworkContext[SOURCE_MAPS_CONTEXT_KEYS.selectedVariant] != null;
 }
 const ERROR_TRACKING_UPLOAD_SOURCE_MAPS_PROGRAM = [
-	{
-		id: "detect",
-		label: "Detecting platform",
-		onReady: (ctx) => detectSourceMapsPrerequisites(ctx.session, ctx.setFrameworkContext)
-	},
 	{
 		id: "intro",
 		label: "Welcome",
 		screenId: "source-maps-intro",
 		gate: (session) => session.setupConfirmed
 	},
-	{
-		id: "health-check",
-		label: "Health check",
-		screenId: "health-check",
-		gate: healthCheckReady,
-		onInit: (ctx) => {
-			evaluateWizardReadiness().then((readiness) => {
-				ctx.setReadinessResult(readiness);
-			}).catch(() => {
-				ctx.setReadinessResult({
-					decision: "yes",
-					health: {},
-					reasons: []
-				});
-			});
-		}
-	},
 	{
 		id: "auth",
 		label: "Authentication",
 		screenId: "auth",
 		isComplete: (session) => session.credentials !== null
 	},
+	{
+		id: "detect",
+		label: "Detecting projects",
+		screenId: "source-maps-detect",
+		isComplete: projectSelected,
+		gate: projectSelected
+	},
 	{
 		id: "run",
 		label: "Upload source maps",
@@ -2501,8 +2663,9 @@ const SOURCE_MAPS_DETECTION_FAILED_PROMPT = `Detection did not pick a source map
 Emit: ${AgentSignals.ABORT} unsupported-platform
 Then halt.`;
 function buildSourceMapsUploadPrompt(params) {
-	const { displayName, variant, skillId, projectId, host, settingsUrl, uiHost } = params;
+	const { displayName, variant, skillId, projectPath, projectId, host, settingsUrl, uiHost } = params;
 	const platformLabel = displayName ?? variant;
+	const inSubproject = projectPath != null && projectPath !== ".";
 	return `You are wiring up PostHog Error Tracking source map upload for this ${platformLabel} project.
 
 Project context:
@@ -2510,8 +2673,11 @@ 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"}
 - 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` : ""}.
+
 The skill you install in STEP 2 is the source of truth for the HOW of every
 step: its "## Steps" section has an overview, tips and per-technology
 examples for each named step, and its reference files carry the exact
@@ -2992,10 +3158,16 @@ const errorTrackingUploadSourceMapsConfig = {
 	reportFile: REPORT_FILE$1,
 	getContentBlocks,
 	requires: ["posthog-integration"],
-	run: (session) => {
-		const variant = session.frameworkContext[SOURCE_MAPS_CONTEXT_KEYS.skillVariant];
-		const displayName = session.frameworkContext[SOURCE_MAPS_CONTEXT_KEYS.displayName];
-		const skillId = variant ? `error-tracking-upload-source-maps-${variant}` : void 0;
+	run: (_session) => {
+		const readSelection = () => {
+			const variant = getUI().getFrameworkContext(SOURCE_MAPS_CONTEXT_KEYS.selectedVariant);
+			return {
+				variant,
+				displayName: getUI().getFrameworkContext(SOURCE_MAPS_CONTEXT_KEYS.selectedDisplayName),
+				projectPath: getUI().getFrameworkContext(SOURCE_MAPS_CONTEXT_KEYS.selectedPath),
+				skillId: variant ? `error-tracking-upload-source-maps-${variant}` : void 0
+			};
+		};
 		return Promise.resolve({
 			integrationLabel: "error-tracking-upload-source-maps",
 			successMessage: "Source maps wired up!",
@@ -3006,20 +3178,23 @@ const errorTrackingUploadSourceMapsConfig = {
 			abortCases: SOURCE_MAPS_ABORT_CASES,
 			askTimeoutMs: 1800 * 1e3,
 			customPrompt: (ctx) => {
+				const { variant, displayName, projectPath, skillId } = readSelection();
 				if (!skillId || !variant) return SOURCE_MAPS_DETECTION_FAILED_PROMPT;
 				const uiHost = getUiHostFromHost(ctx.host).replace(/\/$/, "");
 				return buildSourceMapsUploadPrompt({
 					displayName,
 					variant,
 					skillId,
+					projectPath,
 					projectId: ctx.projectId,
 					host: ctx.host,
 					settingsUrl: `${uiHost}/project/${ctx.projectId}/settings/user-api-keys`,
 					uiHost
 				});
 			},
-			postRun: (sess) => {
-				if (variant) sess.frameworkContext["sourceMapsCompletedVariant"] = variant;
+			postRun: () => {
+				const { variant } = readSelection();
+				if (variant) getUI().setFrameworkContext("sourceMapsCompletedVariant", variant);
 				return Promise.resolve();
 			},
 			buildOutroData: () => {
@@ -3163,10 +3338,10 @@ function buildSelfDrivingPrompt(ctx) {
 	const inboxUrl = `${projectBase}/inbox`;
 	const optIn = (value) => value === true ? "ON" : value === false ? "OFF" : "unknown";
 	const optIns = ctx.teamProductOptIns;
-	return `You are setting up PostHog Self-driving for this project: you will enable the right signal sources, make sure GitHub is connected, tune the scout fleet, design custom scouts for what this product uniquely needs, and hand the user a configured inbox.
+	return `You are setting up PostHog Self-driving for this project: you will enable the right signal sources, make sure GitHub is connected, tune the scout troop, design custom scouts for what this product uniquely needs, and hand the user a configured inbox.
 
 Project URLs:
-- Integrations settings (GitHub App install): ${integrationsSettingsUrl}
+- Integrations settings: ${integrationsSettingsUrl}
 - Organization AI settings: ${orgAiSettingsUrl}
 - New data warehouse source (Linear / Zendesk / GitHub issues / pganalyze): ${newWarehouseSourceUrl}
 - Self-driving inbox: ${inboxUrl}
@@ -3193,7 +3368,7 @@ tasks, in this order:
   3. Connect GitHub (required)
   4. Enable signal sources
   5. Offer issue-tracker integrations
-  6. Configure the scout fleet
+  6. Configure the scout troop
   7. Design custom scouts
   8. Write report and hand off
 Drive the list with TaskUpdate — mark a task in_progress when you start
@@ -3231,9 +3406,10 @@ STEP 2 — Read project and current Signals state. (skill: "Read context")
 
 STEP 3 — Connect GitHub. REQUIRED. (skill: "Connect GitHub")
    Signals cannot research or fix issues without code access. Check for
-   an existing GitHub integration first; if absent, send the user to
-   ${integrationsSettingsUrl} via wizard_ask and verify the connection
-   after they confirm. If the user cannot connect now, emit
+   an existing GitHub integration first; if absent, send the user
+   through the GitHub App connection via wizard_ask exactly as the skill
+   describes (it builds the one-click authorize link), and verify the
+   connection after they confirm. If the user cannot connect now, emit
    ${AgentSignals.ABORT} github connection declined
    and halt — never finish setup without GitHub.
 
@@ -3251,20 +3427,20 @@ STEP 5 — Offer issue-tracker integrations. (skill: "Connected tools")
    never sends the user to paste credentials and never re-prompts. Enable
    a source only for a tool the user picked.
 
-STEP 6 — Configure the scout fleet. (skill: "Scouts")
-   Materialize the fleet, then enable only a small set — the "general"
+STEP 6 — Configure the scout troop. (skill: "Scouts")
+   Materialize the troop, then enable only a small set — the "general"
    scout plus the one or two specialists for the products this project
    uses most — and disable the rest, per the skill.
 
 STEP 7 — Design custom scouts for this product. (skill: "Custom scouts")
    You are the only actor that has read this repo — turn that into
    coverage per the skill: a real gap analysis of the project's
-   watchable surfaces against what the canonical fleet already covers,
+   watchable surfaces against what the built-in troop already covers,
    then custom scouts for the uncovered ones. Keep scout bodies
    high-level: describe the behavior and signal conditions to watch,
    referencing repo evidence by file/function name — never paste raw
    source, secrets, env values, or customer data into a scout body.
-   Never edit canonical scout bodies. Propose all candidates in ONE
+   Never edit built-in scout bodies. Propose all candidates in ONE
    batched wizard_ask
    before creating anything; the user declining everything (or finding
    no gap at all) is a valid outcome, not an abort. Mark the task
@@ -3281,12 +3457,12 @@ const SELF_DRIVING_TIPS = [
 	{
 		id: "what-is-a-signal-source",
 		title: "What's a signal source?",
-		description: "A signal source is a PostHog product or connected tool — errors, session replays, support, GitHub or Linear issues — that feeds findings into your Self-driving inbox."
+		description: "A signal source is one of the streams PostHog plugs straight into — your errors, session replays, support, GitHub or Linear issues. Each one watches its own stream and speaks up the moment something specific goes wrong there."
 	},
 	{
 		id: "what-is-a-scout",
 		title: "What's a scout?",
-		description: "Scouts are scheduled checks that scan your data and flag issues — a spike in errors, a dropping funnel — straight to your inbox."
+		description: "A scout is like an analyst PostHog runs for you on a schedule: rather than watching one stream, it ranges freely across your product data, looking for the bigger trends and surprises — a spike in errors, a funnel quietly dropping — that no single stream would catch."
 	},
 	{
 		id: "findings-in-inbox",
@@ -3573,7 +3749,7 @@ function runMcpAdd(argv) {
 		const debug = argv.debug;
 		const localMcp = argv.local;
 		try {
-			const { startTUI } = await import("./start-tui-BQJQ9_KJ.js");
+			const { startTUI } = await import("./start-tui-Deaj99It.js");
 			const { buildSession } = await import("./wizard-session-wPJtNl4c.js");
 			const tui = startTUI(VERSION, Program.McpAdd);
 			tui.store.session = buildSession({
@@ -3585,7 +3761,7 @@ function runMcpAdd(argv) {
 		} catch (error) {
 			if (!isTUIUnavailable(error)) throw error;
 			setUI(new LoggingUI());
-			const { addMCPServerToClientsStep } = await import("./add-mcp-server-to-clients-BzCc6be4.js").then((n) => n.r);
+			const { addMCPServerToClientsStep } = await import("./add-mcp-server-to-clients-B6Pj4IKt.js").then((n) => n.r);
 			await addMCPServerToClientsStep({
 				local: localMcp,
 				features,
@@ -3624,7 +3800,7 @@ function runMcpRemove(argv) {
 		const debug = argv.debug;
 		const localMcp = argv.local;
 		try {
-			const { startTUI } = await import("./start-tui-BQJQ9_KJ.js");
+			const { startTUI } = await import("./start-tui-Deaj99It.js");
 			const { buildSession } = await import("./wizard-session-wPJtNl4c.js");
 			const tui = startTUI(VERSION, Program.McpRemove);
 			tui.store.session = buildSession({
@@ -3633,7 +3809,7 @@ function runMcpRemove(argv) {
 			});
 		} catch {
 			setUI(new LoggingUI());
-			const { removeMCPServerFromClientsStep } = await import("./add-mcp-server-to-clients-BzCc6be4.js").then((n) => n.r);
+			const { removeMCPServerFromClientsStep } = await import("./add-mcp-server-to-clients-B6Pj4IKt.js").then((n) => n.r);
 			await removeMCPServerFromClientsStep({ local: localMcp });
 		}
 	})();
@@ -3655,7 +3831,7 @@ function runMcpTutorial(argv) {
 		const debug = argv.debug;
 		const localMcp = argv.local;
 		try {
-			const { startTUI } = await import("./start-tui-BQJQ9_KJ.js");
+			const { startTUI } = await import("./start-tui-Deaj99It.js");
 			const { buildSession } = await import("./wizard-session-wPJtNl4c.js");
 			const tui = startTUI(VERSION, Program.McpTutorial);
 			tui.store.session = buildSession({
@@ -3710,7 +3886,7 @@ function runWizard(config, options) {
 	(async () => {
 		try {
 			const installDir = options.installDir || process.cwd();
-			const { startTUI } = await import("./start-tui-BQJQ9_KJ.js");
+			const { startTUI } = await import("./start-tui-Deaj99It.js");
 			const { buildSession, RunPhase } = await import("./wizard-session-wPJtNl4c.js");
 			const { TaskStreamPush } = await import("./task-stream-BQNSp0qR.js");
 			const { PostHogDestination } = await import("./posthog-Cr37rnla.js");
@@ -3766,7 +3942,7 @@ function runWizard(config, options) {
 			await activeTui.store.getGate("health-check");
 			const skipAgent = config.run == null;
 			if (skipAgent) {
-				const { getOrAskForProjectData } = await import("./setup-utils-STqW1cwa.js").then((n) => n.r);
+				const { getOrAskForProjectData } = await import("./setup-utils-DF6EKEeA.js").then((n) => n.r);
 				const { projectApiKey, host, accessToken, projectId } = await getOrAskForProjectData({
 					signup: session.signup,
 					ci: session.ci,
@@ -3781,7 +3957,7 @@ function runWizard(config, options) {
 					projectId
 				});
 			} else {
-				const { runAgent } = await import("./agent-runner-MPlvLP8K.js");
+				const { runAgent } = await import("./agent-runner-VzTpPaVT.js");
 				await runAgent(config, activeTui.store.session);
 			}
 			const isDone = () => skipAgent ? activeTui.store.session.outroDismissed : activeTui.store.session.skillsComplete;
@@ -3858,10 +4034,10 @@ function runWizardCI(config, options) {
 	(async () => {
 		const path = await import("path");
 		const { buildSession } = await import("./wizard-session-wPJtNl4c.js");
-		const { readEnvironment } = await import("./environment-BaqpBPme.js").then((n) => n.t);
+		const { readEnvironment } = await import("./environment-cVP7bGnh.js").then((n) => n.t);
 		const { readApiKeyFromEnv } = await import("./env-api-key-MlzJYAvt.js").then((n) => n.t);
-		const { configureLogFileFromEnvironment, logToFile } = await import("./debug-D2iIa763.js");
-		const { wizardAbort, WizardError } = await import("./wizard-abort-Cht_9Mo0.js");
+		const { configureLogFileFromEnvironment, logToFile } = await import("./debug-HQ0NrBA2.js");
+		const { wizardAbort, WizardError } = await import("./wizard-abort-D3vY7K9a.js");
 		configureLogFileFromEnvironment();
 		const env = readEnvironment();
 		const apiKey = options.apiKey ?? readApiKeyFromEnv() ?? void 0;
@@ -3912,7 +4088,7 @@ function runWizardCI(config, options) {
 					})
 				});
 			}
-			const { runAgent } = await import("./agent-runner-MPlvLP8K.js");
+			const { runAgent } = await import("./agent-runner-VzTpPaVT.js");
 			await runAgent(config, session);
 		} catch (error) {
 			const errorMessage = error instanceof Error ? error.message : String(error);
@@ -4779,7 +4955,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-STqW1cwa.js").then((n) => n.r);
+		const { getOrAskForProjectData } = await import("./setup-utils-DF6EKEeA.js").then((n) => n.r);
 		const { host, accessToken, projectId } = await getOrAskForProjectData({
 			signup: false,
 			ci: true,
@@ -4796,7 +4972,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-Dye-Pi5r.js").then((n) => n.n);
+		const { ApiError } = await import("./api-DfpSG5xU.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);
@@ -4892,7 +5068,7 @@ function runSlackConnect(argv) {
 	(async () => {
 		const debug = argv.debug;
 		try {
-			const { startTUI } = await import("./start-tui-BQJQ9_KJ.js");
+			const { startTUI } = await import("./start-tui-Deaj99It.js");
 			const { buildSession } = await import("./wizard-session-wPJtNl4c.js");
 			const tui = startTUI(VERSION, Program.SlackConnect);
 			tui.store.session = buildSession({ debug });
@@ -5271,6 +5447,6 @@ function resolveInstallDir() {
 }
 Wizard.use(basicIntegrationCommand).use(mcpCommand).use(cliCommand).use(auditCommand).use(doctorCommand).use(migrateCommand).use(revenueCommand).use(warehouseCommand).use(selfDrivingCommand).use(slackCommand).use(uploadSourcemapsCommand).use(skillCommand).init();
 //#endregion
-export { getContentBlocks$2 as _, ConfirmButton as a, runWizard as c, getProgramConfig as d, DISPLAY_NAME as f, getDetectedWarehouseSources as g, fetchHealthIssues as h, useKeyboardHintsContext as i, PROGRAM_REGISTRY as l, getKindMeta as m, useKeyBindings as n, PromptLabel as o, SOURCE_MAPS_CONTEXT_KEYS as p, KeyboardHintsProvider as r, runWizardCI as s, PickerMenu as t, Program as u, POSTHOG_SDKS$1 as v, STRIPE_SDKS as y };
+export { getDetectedWarehouseSources as _, ConfirmButton as a, STRIPE_SDKS as b, runWizard as c, getProgramConfig as d, AUTOMATABLE_VARIANTS as f, fetchHealthIssues as g, getKindMeta as h, useKeyboardHintsContext as i, PROGRAM_REGISTRY as l, SOURCE_MAPS_CONTEXT_KEYS as m, useKeyBindings as n, PromptLabel as o, DISPLAY_NAME as p, KeyboardHintsProvider as r, runWizardCI as s, PickerMenu as t, Program as u, getContentBlocks$2 as v, POSTHOG_SDKS as y };
 
 //# sourceMappingURL=bin.js.map