@posthog/wizard 2.54.0 → 2.56.0

package/dist/bin.js

@@ -1,18 +1,18 @@
 #!/usr/bin/env node
-import { Ct as regionOption, L as Integration, St as isHeadless, U as POSTHOG_DOCS_URL, a as getLogFilePath, f as getUI, ft as WIZARD_USER_AGENT, ht as VERSION, m as LoggingUI, p as setUI, pt as getSkillsBaseUrl, r as debug, s as logToFile, xt as headlessOption } from "./debug-CbgLkSCY.js";
-import { n as analytics } from "./analytics-D7hsukY7.js";
-import { r as setEntryCommand } from "./telemetry-UBL5MQtw.js";
-import { a as walkProjectFiles, i as safeReadFile } from "./bounded-fs-Cq960M-V.js";
-import { n as isUsingTypeScript } from "./setup-utils-6qyTDNyd.js";
-import { o as handleApiError } from "./api-BSq9hLu5.js";
+import { Ct as regionOption, L as Integration, St as isHeadless, U as POSTHOG_DOCS_URL, a as getLogFilePath, f as getUI, ft as WIZARD_USER_AGENT, ht as VERSION, m as LoggingUI, p as setUI, pt as getSkillsBaseUrl, r as debug, s as logToFile, xt as headlessOption } from "./debug-B6VsAfeE.js";
+import { n as analytics } from "./analytics-Bcj98zOG.js";
+import { r as setEntryCommand } from "./telemetry-JfMjqBNP.js";
+import { a as safeReadFile, o as walkProjectFiles } from "./bounded-fs-DZEUmLFS.js";
+import { n as isUsingTypeScript } from "./setup-utils-Bh_HUFPV.js";
+import { o as handleApiError } from "./api-BT317Fnl.js";
 import "./wizard-session-CwgR5y3-.js";
-import { r as runCleanups } from "./wizard-abort-FIC6lKCs.js";
-import { n as isNonInteractiveEnvironment } from "./environment-BWuaOExh.js";
-import { n as runAgent, o as authenticate } from "./agent-runner-D6zGTJqn.js";
-import { l as recoverOrphanedSettingsBackups, p as AgentSignals, v as WIZARD_TOOL_NAMES, x as fetchSkillMenu } from "./agent-interface-CLvG6Rk9.js";
-import { S as SETUP_REPORT_FILE, _ as AUDIT_CHECKS_KEY, g as AUDIT_CHECKS_FILE, v as AUDIT_REPORT_FILE } from "./yara-hooks-DxpCD72V.js";
-import { i as SPINNER_MESSAGE } from "./registry-D0hx_-KP.js";
-import { C as gatherFrameworkContext, S as resolveProjectDir, _ as WAREHOUSE_ABORT_CASES, a as LINE_CHART_BLOCK, b as detectIntegrationProjects, d as isClearBlock, g as HEALTH_CHECK_STEP, h as Icons, i as FUNNEL_BLOCK, m as Colors, n as integrationRunStep, o as PRODUCT_SUITE_BLOCK, r as posthogIntegrationConfig, s as StatusPeekTrigger, u as wordWrap, v as detectWarehousePrerequisites, y as getDetectedWarehouseSources } from "./posthog-integration-Dy5cNPaa.js";
+import { r as runCleanups } from "./wizard-abort-CDIfvSu2.js";
+import { n as isNonInteractiveEnvironment } from "./environment-Dn-Vd-J3.js";
+import { n as runAgent, o as authenticate } from "./agent-runner-DmqRgcNz.js";
+import { l as recoverOrphanedSettingsBackups, p as AgentSignals, v as WIZARD_TOOL_NAMES, x as fetchSkillMenu } from "./agent-interface-CaSQlcUF.js";
+import { S as SETUP_REPORT_FILE, _ as AUDIT_CHECKS_KEY, g as AUDIT_CHECKS_FILE, v as AUDIT_REPORT_FILE } from "./yara-hooks-DyEPTBZF.js";
+import { i as SPINNER_MESSAGE } from "./registry-Bs7-Q1J9.js";
+import { C as resolveProjectDir, _ as WAREHOUSE_ABORT_CASES, a as LINE_CHART_BLOCK, b as detectWarehouseSources, d as isClearBlock, g as HEALTH_CHECK_STEP, h as Icons, i as FUNNEL_BLOCK, m as Colors, n as integrationRunStep, o as PRODUCT_SUITE_BLOCK, r as posthogIntegrationConfig, s as StatusPeekTrigger, u as wordWrap, v as detectWarehousePrerequisites, w as gatherFrameworkContext, x as detectIntegrationProjects, y as getDetectedWarehouseSources } from "./posthog-integration-Cdwv-ohr.js";
 import { n as readApiKeyFromEnv } from "./env-api-key-cjD4yfGT.js";
 import { satisfies } from "semver";
 import yargs from "yargs";
@@ -200,7 +200,7 @@ function runProvision(argv) {
 }
 async function provision({ email, region, name, baseUrl, jsonMode }) {
 	try {
-		const { provisionNewAccount } = await import("./provisioning-CS6fQriR.js").then((n) => n.n);
+		const { provisionNewAccount } = await import("./provisioning-sDvZgL0E.js").then((n) => n.r);
 		if (!jsonMode) getUI().log.info(`Provisioning account for ${email} in ${region}...`);
 		emitResult(await provisionNewAccount(email, name, region, { baseUrl }), jsonMode);
 		process.exit(0);
@@ -267,22 +267,22 @@ const basicIntegrationCommand = {
 		setEntryCommand("integrate");
 		(async () => {
 			if (isHeadless(argv)) {
-				const { runHeadlessInstall } = await import("./ci-install-w-mywB9x.js");
+				const { runHeadlessInstall } = await import("./ci-install-Jcf6VvMs.js");
 				return runHeadlessInstall(argv);
 			}
 			if (argv.ci) {
-				const { runCIInstall } = await import("./ci-install-w-mywB9x.js");
+				const { runCIInstall } = await import("./ci-install-Jcf6VvMs.js");
 				return runCIInstall(argv);
 			}
 			if (isNonInteractiveEnvironment()) {
-				const { failNonInteractive } = await import("./non-interactive-eXT2_WCR.js");
+				const { failNonInteractive } = await import("./non-interactive-DWiL-3rV.js");
 				return failNonInteractive();
 			}
 			if (argv.playground) {
-				const { runPlayground } = await import("./playground-DuBvnGkP.js");
+				const { runPlayground } = await import("./playground-CkMYkXiw.js");
 				return runPlayground();
 			}
-			const { runInteractive } = await import("./interactive-D-MVMdBl.js");
+			const { runInteractive } = await import("./interactive-BU4h53in.js");
 			runInteractive(argv);
 		})();
 	}
@@ -1785,17 +1785,27 @@ const DISPLAY_NAME = {
 	ios: "iOS",
 	vite: "Vite",
 	webpack: "Webpack",
-	rollup: "Rollup"
+	rollup: "Rollup",
+	go: "Go",
+	rust: "Rust"
 };
 /**
-* Variants the wizard can wire up source-map upload for automatically. React
-* Native is recognised but not yet automatable, so the agentic picker treats
-* it as non-instrumentable.
+* Variants the wizard can wire up source-map upload for automatically. Go and
+* Rust upload native debug symbols (`posthog-cli symbol-sets upload`) instead
+* of source maps, but the wiring is the same shape.
+*
+* Invariant: every variant listed here must have a published
+* `error-tracking-upload-source-maps-<variant>` skill in context-mill —
+* STEP 2 of the run installs that exact id, so an entry without a shipped
+* skill fails every run for that stack.
 */
 const AUTOMATABLE_VARIANTS = [
 	"android",
 	"ios",
+	"react-native",
 	"flutter",
+	"go",
+	"rust",
 	"web",
 	"nextjs",
 	"node",
@@ -1808,28 +1818,56 @@ const AUTOMATABLE_VARIANTS = [
 ];
 /**
 * 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. Flutter counts here despite emitting plain `.js.map` files: a Flutter
-* project has no `package.json`, so there is no npx or local dependency to
-* fall back to when the post-build step invokes the CLI.
+* build shells out to it with no npx / local-dep fallback. Web JS variants stay
+* out. React Native counts as native here — its Xcode build phases and Gradle
+* tasks invoke the global CLI. Flutter counts too despite emitting plain
+* `.js.map` files: a Flutter project has no `package.json`, so there is no npx
+* or local dependency to fall back to when the post-build step invokes the CLI.
 */
 const VARIANTS_REQUIRING_POSTHOG_CLI = new Set([
 	"ios",
 	"android",
-	"flutter"
+	"react-native",
+	"flutter",
+	"go",
+	"rust"
 ]);
+/**
+* Automatable variants whose SDK the wizard's default flow cannot install —
+* remediation for a missing SDK is a manual install (posthog-go /
+* posthog-rs), not `npx @posthog/wizard`. Drives the missing-SDK copy in the
+* picker and the classifier.
+*/
+const MANUAL_SDK_INSTALL = {
+	go: "add the posthog-go module first",
+	rust: "add the posthog-rs crate first"
+};
+const MANUAL_SDK_VARIANTS = Object.keys(MANUAL_SDK_INSTALL);
+/** Dependency string that identifies the Rust SDK in Cargo.toml. */
+const RUST_SDK_CRATE = "posthog-rs";
+/** Module path that identifies the Go SDK in go.mod. */
+const GO_SDK_MODULE = "github.com/posthog/posthog-go";
 /** `[ABORT] <reason>` cases the source maps skill can emit. */
-const SOURCE_MAPS_ABORT_CASES = [{
-	match: /^no posthog sdk detected$/i,
-	message: "No PostHog SDK detected",
-	body: "The agent could not find a PostHog SDK in your project. Source map upload requires the SDK to already be installed so it can report errors. Run `npx @posthog/wizard` first to install the SDK.",
-	docsUrl: "https://posthog.com/docs/error-tracking"
-}, {
-	match: /^build command not found$/i,
-	message: "Build command not found",
-	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"
-}];
+const SOURCE_MAPS_ABORT_CASES = [
+	{
+		match: /^no posthog sdk detected$/i,
+		message: "No PostHog SDK detected",
+		body: "The agent could not find a PostHog SDK in your project. Source map upload requires the SDK to already be installed so it can report errors. Run `npx @posthog/wizard` first to install the SDK (for Go and Rust, add posthog-go / posthog-rs by hand first — the wizard cannot install the SDK for those stacks yet).",
+		docsUrl: "https://posthog.com/docs/error-tracking"
+	},
+	{
+		match: /^build command not found$/i,
+		message: "Build command not found",
+		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"
+	},
+	{
+		match: /^bare react native not supported$/i,
+		message: "Bare React Native is not supported",
+		body: "Source-map upload for React Native requires Expo, and this project has no `expo` package. Bare React Native builds cannot inject the chunk IDs PostHog needs to resolve stack traces.",
+		docsUrl: "https://posthog.com/docs/error-tracking/upload-source-maps/react-native"
+	}
+];
 const SOURCE_MAPS_CONTEXT_KEYS = {
 	skillVariant: "sourceMapsSkillVariant",
 	displayName: "sourceMapsDisplayName",
@@ -1888,7 +1926,7 @@ 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, projectPath, projectId, host, settingsUrl, uiHost } = params;
+	const { displayName, variant, skillId, projectPath, projectId, host, settingsUrl, uiHost, reportFile } = 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)";
@@ -1903,7 +1941,7 @@ STEP 5 — Write the credentials to the env file. (skill: "Write credentials to
    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.`}
+   - 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).${variant === "rust" ? ` Cargo workspace exception: when the skill places the env file at the workspace root instead, pass the path of the ROOT manifest's directory relative to the wizard's working directory (e.g. \`rust/.env\` for a workspace root at \`rust/\`, or plain \`.env\` when the workspace root IS the working directory) — not the member path.` : ""}` : `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: {
@@ -1923,7 +1961,14 @@ Project context:
 ${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` : ""}.
+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` : ""}.${variant === "rust" && inSubproject ? `
+Cargo workspace exception: if the selected project is a member of a Cargo
+workspace (resolve the root with \`cargo locate-project --workspace
+--message-format plain\`), the workspace root's Cargo.toml (for \`[profile.*]\`
+edits), the workspace-level \`target/\` directory, and a \`.env\` next to the
+root manifest are IN SCOPE — treat them as part of the selected project, and
+follow the skill's workspace guidance for which paths to use. Every other
+package stays off-limits.` : ""}
 
 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
@@ -2051,8 +2096,16 @@ STEP 8 — Offer to test the local setup. (skill: "Test the local setup")
    surface any failure in STEP 9.
 
 STEP 9 — Summarise and hand off. (skill: "Verify and hand off")
-   Follow the skill's "Verify and hand off" step. The Symbol sets page for
-   this project — where the user confirms the upload landed — is:
+   Follow the skill's "Verify and hand off" step. Write the hand-off to
+   \`${reportFile}\` at the WIZARD'S WORKING DIRECTORY — pass exactly
+   \`${reportFile}\` as the file path, never prefixed with the selected
+   project directory; this file is the one exception to the project-scope
+   rule above. Cover: the files you changed (paths only), the exact build
+   and upload commands, every CI secret the user still has to create, and
+   how to verify the upload — then give the same summary in chat. Never
+   write secret values into the report, only variable names. The success
+   screen points the user at this file, so do not skip it. The Symbol sets page for this project — where the user
+   confirms the upload landed — is:
    ${uiHost}/project/${projectId}/error_tracking/configuration
 `;
 }
@@ -2555,7 +2608,8 @@ const errorTrackingUploadSourceMapsConfig = {
 					projectId: ctx.projectId,
 					host: ctx.host.apiHost,
 					settingsUrl: `${uiHost}/project/${ctx.projectId}/settings/user-api-keys`,
-					uiHost
+					uiHost,
+					reportFile: REPORT_FILE$1
 				});
 			},
 			postRun: () => {
@@ -2605,6 +2659,12 @@ const POSTHOG_PRESENT_KEY = "postHogPresent";
 * into the chosen sub-app, not the root.
 */
 const SELF_DRIVING_INTEGRATE_PATH_KEY = "selfDrivingIntegratePath";
+/** Self-driving's own detected-tools key — not the warehouse one, which the integration program reads. */
+const SELF_DRIVING_DETECTED_TOOLS_KEY = "selfDrivingDetectedTools";
+/** Read the detected tools out of frameworkContext. */
+function getSelfDrivingDetectedTools(session) {
+	return session.frameworkContext["selfDrivingDetectedTools"] ?? [];
+}
 const POSTHOG_PACKAGE_RE = /(^|["'\s/=:.@])posthog/im;
 const POSTHOG_MANIFESTS = [
 	"package.json",
@@ -2790,6 +2850,44 @@ function detectSelfDrivingPrerequisites(session, setFrameworkContext) {
 		return;
 	}
 	setFrameworkContext(POSTHOG_PRESENT_KEY, detectPostHogPresent(installDir));
+	detectConnectedTools(installDir, setFrameworkContext);
+}
+/** Step 5's ask options intersected with `SOURCE_DETECTORS` — reconcile when the skill's catalog grows. */
+const SELF_DRIVING_TOOL_KINDS = new Set([
+	"Github",
+	"GitLab",
+	"Gitea",
+	"Linear",
+	"Jira",
+	"Shortcut",
+	"Sentry",
+	"Rollbar",
+	"Bugsnag",
+	"Honeybadger",
+	"Raygun",
+	"Zendesk",
+	"Freshdesk",
+	"Front",
+	"Gorgias",
+	"Kustomer",
+	"Plain",
+	"Snyk",
+	"Canny",
+	"Productboard",
+	"GoogleSearchConsole"
+]);
+/** Scan for inbox-connectable tools so STEP 5 can surface them first. Best-effort — never blocks detection. */
+function detectConnectedTools(installDir, setFrameworkContext) {
+	try {
+		const tools = detectWarehouseSources(installDir).filter((s) => SELF_DRIVING_TOOL_KINDS.has(s.kind));
+		analytics.setTag("connected_tools_detected_count", tools.length);
+		if (tools.length === 0) return;
+		analytics.setTag("connected_tools_detected", tools.map((s) => s.kind).join(","));
+		setFrameworkContext(SELF_DRIVING_DETECTED_TOOLS_KEY, tools);
+	} catch (error) {
+		analytics.setTag("connected_tools_detected_count", -1);
+		analytics.captureException(error instanceof Error ? error : new Error(String(error)), { step: "detectConnectedTools" });
+	}
 }
 //#endregion
 //#region src/lib/programs/self-driving/detect-agentic.ts
@@ -2920,17 +3018,38 @@ const SELF_DRIVING_PROGRAM = [
 //#endregion
 //#region src/lib/programs/self-driving/prompt.ts
 /**
+* Render the deterministic codebase-tool scan for the prompt. STEP 4 and
+* STEP 5 read this instead of the agent doing its own flaky "light scan":
+* enable the matching signal sources, and surface detected tools first in the
+* connected-tools ask rather than dumping the full ~500-source catalog. When
+* nothing is detected we still say so explicitly, so the agent falls back to
+* the skill's default ordering instead of inventing a scan.
+*/
+function renderDetectedTools(sources) {
+	if (sources.length === 0) return `Tools detected in this codebase: none found by the dependency + env scan. Use the skill's default ordering for STEP 5.`;
+	return [
+		"Tools detected in this codebase (deterministic dependency + env-key scan — this is evidence, not a guess):",
+		...sources.map((s) => `- ${s.label} (source_type: ${s.kind}) — ${s.matchedSignal}`),
+		"",
+		"Use this list in STEP 4 (enable the matching signal sources) and STEP 5 (surface these detected tools first in the connected-tools ask, ahead of the SaaS basics and the \"others\" option), exactly as the skill describes. Never enable or pre-select a tool the user has not confirmed."
+	].join("\n");
+}
+/**
 * Build the self-driving run prompt. The installed
 * `self-driving-setup` skill is the source of truth for the HOW of
 * every step (which MCP tools to call, which sources/scouts apply, how
 * to verify); this prompt carries the order, the wizard-specific
 * mechanics (wizard_ask, abort signals), and the project URLs.
 *
+* `detectedSources` is the deterministic codebase scan (from the detect step);
+* it drives STEP 4/STEP 5 tool prioritisation. Empty is fine — the block then
+* tells the agent to use the skill's default ordering.
+*
 * Integration (when the project has no PostHog yet) runs as a separate phase
 * before this — the real integration program, with its own screens and task
 * list — so this prompt only covers the Self-driving steps.
 */
-function buildSelfDrivingPrompt(ctx) {
+function buildSelfDrivingPrompt(ctx, detectedSources = []) {
 	const uiHost = ctx.host.appHost.replace(/\/$/, "");
 	const projectBase = `${uiHost}/project/${ctx.projectId}`;
 	const integrationsSettingsUrl = `${projectBase}/settings/environment-integrations`;
@@ -2955,6 +3074,8 @@ snippet, so repo evidence may rule a product IN but never OUT):
 - Exception autocapture (error tracking): ${optIn(optIns?.exceptionAutocapture)}
 - Surveys: ${optIn(optIns?.surveys)}
 
+${renderDetectedTools(detectedSources)}
+
 The installed skill is the source of truth for the HOW of every step:
 which MCP tools to call, which sources and scouts apply to this product,
 and how to verify each change. The STEPS below give the order and the
@@ -3040,7 +3161,10 @@ STEP 4 — Enable signal sources. (skill: "Enable sources")
 
 STEP 5 — Offer issue-tracker integrations. (skill: "Connected tools")
    One batched multi-select wizard_ask for the external tools the skill
-   lists. The run auto-connects the ones it can (GitHub Issues, and
+   lists. Order it per the skill: the tools from the "Tools detected in
+   this codebase" list above come first, then the SaaS basics, then an
+   "others" option for the long tail — never dump the whole catalog.
+   The run auto-connects the ones it can (GitHub Issues, and
    Linear via a one-click OAuth link), verifying each with a single
    silent check — never nudge. For GitHub Issues: when the GitHub
    integration has exactly one repository connected, use that repo by
@@ -3053,9 +3177,11 @@ STEP 5 — Offer issue-tracker integrations. (skill: "Connected tools")
 
 STEP 6 — Configure the scout troop. (skill: "Scouts")
    Materialize the troop, read the project's enforced scout-run budget
-   (24 runs a day by default), then enable only a small set — the
-   "general" scout plus the two or three specialists for the products
-   this project uses most — and disable the rest, per the skill.
+   (100 runs a day by default), then enable a selective set — the
+   "general" scout plus the three to five specialists for the products
+   this project uses most — and disable the rest, per the skill. The
+   whole troop, including step 6b's custom scouts, stays at or under
+   ten enabled scouts.
 
 STEP 6b — Design custom scouts for this product. (skill: "Custom scouts")
    You are the only actor that has read this repo — turn that into
@@ -3091,7 +3217,7 @@ const SELF_DRIVING_TIPS = [
 	{
 		id: "scout",
 		title: "Scout",
-		description: "An agent on a schedule, watching your sources for anomalies and patterns. Your project gets up to 24 scout runs a day by default."
+		description: "An agent on a schedule, watching your sources for anomalies and patterns. Your project gets up to 100 scout runs a day by default."
 	},
 	{
 		id: "signal-report",
@@ -3451,10 +3577,10 @@ async function removeInstalledSkill(installDir) {
 		force: true
 	}).catch(() => void 0);
 }
-const run = {
+const buildRun = (session) => Promise.resolve({
 	skillId: SELF_DRIVING_SKILL_ID,
 	integrationLabel: SELF_DRIVING_SKILL_ID,
-	customPrompt: buildSelfDrivingPrompt,
+	customPrompt: (ctx) => buildSelfDrivingPrompt(ctx, getSelfDrivingDetectedTools(session)),
 	successMessage: SUCCESS_MESSAGE,
 	reportFile: REPORT_FILE,
 	docsUrl: DOCS_URL,
@@ -3489,7 +3615,7 @@ const run = {
 			reportFile: REPORT_FILE
 		};
 	}
-};
+});
 const selfDrivingConfig = {
 	...createSkillProgram({
 		skillId: SELF_DRIVING_SKILL_ID,
@@ -3506,7 +3632,7 @@ const selfDrivingConfig = {
 		abortCases: SELF_DRIVING_ABORT_CASES
 	}),
 	steps: SELF_DRIVING_PROGRAM,
-	run,
+	run: buildRun,
 	getTips,
 	getContentBlocks
 };
@@ -3798,7 +3924,7 @@ function runMcpAdd(argv) {
 		const debug = argv.debug;
 		const localMcp = argv.local;
 		try {
-			const { startTUI } = await import("./start-tui-DNkm-n-4.js");
+			const { startTUI } = await import("./start-tui-DEgpLYEQ.js");
 			const { buildSession } = await import("./wizard-session-DsK16SGs.js");
 			const tui = startTUI(VERSION, Program.McpAdd);
 			tui.store.session = buildSession({
@@ -3811,7 +3937,7 @@ function runMcpAdd(argv) {
 		} catch (error) {
 			if (!isTUIUnavailable(error)) throw error;
 			setUI(new LoggingUI());
-			const { addMCPServerToClientsStep } = await import("./add-mcp-server-to-clients-B3TcwTT5.js").then((n) => n.r);
+			const { addMCPServerToClientsStep } = await import("./add-mcp-server-to-clients-CVA6Wbmu.js").then((n) => n.r);
 			await addMCPServerToClientsStep({
 				local: localMcp,
 				features,
@@ -3850,7 +3976,7 @@ function runMcpRemove(argv) {
 		const debug = argv.debug;
 		const localMcp = argv.local;
 		try {
-			const { startTUI } = await import("./start-tui-DNkm-n-4.js");
+			const { startTUI } = await import("./start-tui-DEgpLYEQ.js");
 			const { buildSession } = await import("./wizard-session-DsK16SGs.js");
 			const tui = startTUI(VERSION, Program.McpRemove);
 			tui.store.session = buildSession({
@@ -3860,7 +3986,7 @@ function runMcpRemove(argv) {
 			});
 		} catch {
 			setUI(new LoggingUI());
-			const { removeMCPServerFromClientsStep } = await import("./add-mcp-server-to-clients-B3TcwTT5.js").then((n) => n.r);
+			const { removeMCPServerFromClientsStep } = await import("./add-mcp-server-to-clients-CVA6Wbmu.js").then((n) => n.r);
 			await removeMCPServerFromClientsStep({ local: localMcp });
 		}
 	})();
@@ -3882,7 +4008,7 @@ function runMcpTutorial(argv) {
 		const debug = argv.debug;
 		const localMcp = argv.local;
 		try {
-			const { startTUI } = await import("./start-tui-DNkm-n-4.js");
+			const { startTUI } = await import("./start-tui-DEgpLYEQ.js");
 			const { buildSession } = await import("./wizard-session-DsK16SGs.js");
 			const tui = startTUI(VERSION, Program.McpTutorial);
 			tui.store.session = buildSession({
@@ -3927,7 +4053,8 @@ function resolveNoTelemetry(options) {
 const WIZARD_VERSION = VERSION;
 /** The session a run step's agent runs in: scoped to the step's target dir
 * (e.g. a monorepo sub-app) with its own framework context, after any prep.
-* A step without `targetDir` runs in the live session, unchanged. */
+* A step without `targetDir` runs in the live session, unchanged.
+* The frameworkContext copy is shallow and unfiltered — name keys per owning program. */
 async function prepareRunSession(step, live) {
 	const session = step.targetDir ? {
 		...live,
@@ -3963,9 +4090,9 @@ function runWizard(config, options) {
 	(async () => {
 		try {
 			const installDir = options.installDir || process.cwd();
-			const { startTUI } = await import("./start-tui-DNkm-n-4.js");
+			const { startTUI } = await import("./start-tui-DEgpLYEQ.js");
 			const { buildSession, RunPhase } = await import("./wizard-session-DsK16SGs.js");
-			const { TaskStreamPush } = await import("./task-stream-BdJV-usk.js");
+			const { TaskStreamPush } = await import("./task-stream-aKusWX0h.js");
 			const { PostHogDestination } = await import("./posthog-DDLIrku0.js");
 			tui = startTUI(WIZARD_VERSION, config.id);
 			const activeTui = tui;
@@ -4032,7 +4159,7 @@ function runWizard(config, options) {
 				if (shown(step)) await advanceStep(step, activeTui.store, config);
 			}
 			else if (skipAgent) {
-				const { getOrAskForProjectData } = await import("./setup-utils-6qyTDNyd.js").then((n) => n.r);
+				const { getOrAskForProjectData } = await import("./setup-utils-Bh_HUFPV.js").then((n) => n.r);
 				const { projectApiKey, host, accessToken, projectId } = await getOrAskForProjectData({
 					signup: session.signup,
 					ci: session.ci,
@@ -4134,10 +4261,10 @@ function runNonInteractive(config, options, mode) {
 	(async () => {
 		const path = await import("path");
 		const { buildSession, RunPhase, OutroKind } = await import("./wizard-session-DsK16SGs.js");
-		const { readEnvironment } = await import("./environment-BWuaOExh.js").then((n) => n.t);
+		const { readEnvironment } = await import("./environment-Dn-Vd-J3.js").then((n) => n.t);
 		const { readApiKeyFromEnv } = await import("./env-api-key-cjD4yfGT.js").then((n) => n.t);
-		const { configureLogFileFromEnvironment, logToFile } = await import("./debug-CX6ZqL9r.js");
-		const { wizardAbort, WizardError } = await import("./wizard-abort-BRsd7-aB.js");
+		const { configureLogFileFromEnvironment, logToFile } = await import("./debug-B_d72khs.js");
+		const { wizardAbort, WizardError } = await import("./wizard-abort-CeTBd8IM.js");
 		configureLogFileFromEnvironment();
 		const env = readEnvironment();
 		const apiKey = options.apiKey ?? readApiKeyFromEnv() ?? void 0;
@@ -4170,9 +4297,9 @@ function runNonInteractive(config, options, mode) {
 		let store = null;
 		let taskStream = null;
 		if (mode === "headless") {
-			const { WizardStore } = await import("./store-sIaF89XA.js").then((n) => n.n);
-			const { HeadlessUI } = await import("./headless-ui-rH97E35y.js");
-			const { TaskStreamPush, PostHogDestination } = await import("./task-stream-BdJV-usk.js");
+			const { WizardStore } = await import("./store-DGt4jqrg.js").then((n) => n.n);
+			const { HeadlessUI } = await import("./headless-ui-DhtLuoOS.js");
+			const { TaskStreamPush, PostHogDestination } = await import("./task-stream-aKusWX0h.js");
 			store = new WizardStore(config.id);
 			store.session = session;
 			setUI(new HeadlessUI(store));
@@ -4228,7 +4355,7 @@ function runNonInteractive(config, options, mode) {
 					});
 				}
 			}
-			const { runAgent } = await import("./agent-runner-D6zGTJqn.js").then((n) => n.t);
+			const { runAgent } = await import("./agent-runner-DmqRgcNz.js").then((n) => n.t);
 			await runAgent(config, session);
 			await settleStream(RunPhase.Completed);
 		} catch (error) {
@@ -4767,6 +4894,8 @@ const CHROME_OVERHEAD = 13;
 const MAX_LIST_ROWS = 12;
 /** Extra rows a multi-select adds below its options: marginTop + Confirm button. */
 const CONFIRM_CHROME = 3;
+/** Lists shorter than this never page — tall rows would split 2-3 options into pages of one. */
+const MIN_COUNT_TO_PAGE = 5;
 /** Width the multi-select wraps option descriptions to (matches the render). */
 const DESCRIPTION_WIDTH = 56;
 /**
@@ -4780,7 +4909,7 @@ const DESCRIPTION_WIDTH = 56;
 function usePickerViewport(count, rowCost, chromeBelow, enabled, focused) {
 	const [, termRows] = useStdoutDimensions();
 	const budget = Math.max(5, Math.min(termRows - CHROME_OVERHEAD - chromeBelow, MAX_LIST_ROWS));
-	const needsScroll = enabled && count * rowCost > budget;
+	const needsScroll = enabled && count >= MIN_COUNT_TO_PAGE && count * rowCost > budget;
 	const perPage = needsScroll ? Math.max(1, Math.floor((budget - 2) / rowCost)) : count;
 	const pageCount = Math.max(1, Math.ceil(count / perPage));
 	const start = Math.floor(focused / perPage) * perPage;
@@ -5308,7 +5437,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-6qyTDNyd.js").then((n) => n.r);
+		const { getOrAskForProjectData } = await import("./setup-utils-Bh_HUFPV.js").then((n) => n.r);
 		const { host, accessToken, projectId } = await getOrAskForProjectData({
 			signup: false,
 			ci: true,
@@ -5326,7 +5455,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-BSq9hLu5.js").then((n) => n.n);
+		const { ApiError } = await import("./api-BT317Fnl.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);
@@ -5408,7 +5537,7 @@ function runSlackConnect(argv) {
 	(async () => {
 		const debug = argv.debug;
 		try {
-			const { startTUI } = await import("./start-tui-DNkm-n-4.js");
+			const { startTUI } = await import("./start-tui-DEgpLYEQ.js");
 			const { buildSession } = await import("./wizard-session-DsK16SGs.js");
 			const tui = startTUI(VERSION, Program.SlackConnect);
 			tui.store.session = buildSession({
@@ -5677,7 +5806,19 @@ const cliCommand = {
 //#region bin.ts
 const NODE_VERSION_RANGE = ">=22.22.0";
 if (!satisfies(process.version, NODE_VERSION_RANGE)) {
-	console.log(`PostHog wizard requires Node.js ${NODE_VERSION_RANGE}. You are using Node.js ${process.version}. Please upgrade your Node.js version.`);
+	console.log([
+		`The PostHog wizard needs a newer version of Node.js to run.`,
+		``,
+		`  You have:  ${process.version}`,
+		`  You need:  v${NODE_VERSION_RANGE.replace(">=", "")} or later`,
+		``,
+		`To update Node.js:`,
+		``,
+		`  Download the latest version from https://nodejs.org/en/download`,
+		`  Or, if you use nvm, run: nvm install 22 && nvm use 22`,
+		``,
+		`Then run the wizard again. Stuck? Email wizard@posthog.com and we'll help.`
+	].join("\n"));
 	process.exit(1);
 }
 recoverOrphanedSettingsBackups(resolveInstallDir());
@@ -5691,6 +5832,6 @@ function resolveInstallDir() {
 }
 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, DISPLAY_NAME as _, useStdoutDimensions as a, fetchHealthIssues as b, runWizardHeadless as c, PROGRAM_REGISTRY as d, Program as f, AUTOMATABLE_VARIANTS as g, SELF_DRIVING_INTEGRATE_PATH_KEY as h, useKeyboardHintsContext as i, runWizardCI as l, detectSelfDrivingIntegrationProjects as m, useKeyBindings as n, ConfirmButton as o, getProgramConfig as p, KeyboardHintsProvider as r, PromptLabel as s, PickerMenu as t, runWizard as u, SOURCE_MAPS_CONTEXT_KEYS as v, getContentBlocks$3 as x, getKindMeta as y };
+export { getKindMeta as C, STRIPE_SDKS as D, POSTHOG_SDKS as E, SOURCE_MAPS_CONTEXT_KEYS as S, getContentBlocks$3 as T, DISPLAY_NAME as _, useStdoutDimensions as a, MANUAL_SDK_VARIANTS as b, runWizardHeadless as c, PROGRAM_REGISTRY as d, Program as f, AUTOMATABLE_VARIANTS as g, SELF_DRIVING_INTEGRATE_PATH_KEY as h, useKeyboardHintsContext as i, runWizardCI as l, detectSelfDrivingIntegrationProjects as m, useKeyBindings as n, ConfirmButton as o, getProgramConfig as p, KeyboardHintsProvider as r, PromptLabel as s, PickerMenu as t, runWizard as u, GO_SDK_MODULE as v, fetchHealthIssues as w, RUST_SDK_CRATE as x, MANUAL_SDK_INSTALL as y };
 
 //# sourceMappingURL=bin.js.map