@posthog/wizard 2.59.0 → 2.61.0

package/dist/bin.js

@@ -1,23 +1,24 @@
 #!/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-CxHQG5NZ.js";
-import { n as analytics } from "./analytics-D8LSdEq7.js";
-import { r as setEntryCommand } from "./telemetry-B62x5mwZ.js";
-import { a as safeReadFile, o as walkProjectFiles } from "./bounded-fs-xzOAybCw.js";
-import { n as isUsingTypeScript } from "./setup-utils-CcYGniRV.js";
-import { o as handleApiError } from "./api-XEopttY8.js";
-import "./wizard-session-CwgR5y3-.js";
-import { r as runCleanups } from "./wizard-abort-I6tR10Mx.js";
-import { n as isNonInteractiveEnvironment } from "./environment-D6GAX3yG.js";
-import { n as runAgent, o as authenticate } from "./agent-runner-2CRvJ1nS.js";
-import { S as WIZARD_TOOL_NAMES, T as fetchSkillMenu, l as recoverOrphanedSettingsBackups, p as AgentSignals } from "./agent-interface-DB8B9fET.js";
-import { S as SETUP_REPORT_FILE, _ as AUDIT_CHECKS_KEY, g as AUDIT_CHECKS_FILE, v as AUDIT_REPORT_FILE } from "./yara-hooks-CpvNIFdW.js";
-import { i as SPINNER_MESSAGE } from "./registry-CkGCJVqq.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-D-4mdP4b.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-8-IIHr5f.js";
+import { n as analytics } from "./analytics-CkIyBHfd.js";
+import { r as setEntryCommand } from "./telemetry-DSzPCPtQ.js";
+import { a as safeReadFile, o as walkProjectFiles } from "./bounded-fs-B-qlKB0h.js";
+import { n as isUsingTypeScript } from "./setup-utils-C2rGcUFv.js";
+import { o as handleApiError } from "./api-XHQTOfIi.js";
+import "./wizard-session-BUhlJ1b8.js";
+import { r as runCleanups } from "./wizard-abort-Cz916Qq5.js";
+import { n as isNonInteractiveEnvironment } from "./environment-BffaZJRI.js";
+import { n as runAgent, s as authenticate } from "./agent-runner-DLAvB67P.js";
+import { d as writeJsonAtomic } from "./queue-tools-OynU-m2F.js";
+import { S as WIZARD_TOOL_NAMES, T as fetchSkillMenu, l as recoverOrphanedSettingsBackups, p as AgentSignals } from "./agent-interface-Bm4ZNGGV.js";
+import { S as SETUP_REPORT_FILE, _ as AUDIT_CHECKS_KEY, g as AUDIT_CHECKS_FILE, v as AUDIT_REPORT_FILE } from "./yara-hooks-DgScuNrT.js";
+import { i as SPINNER_MESSAGE } from "./registry-eXzDlt51.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-DbZ2oza2.js";
 import { n as readApiKeyFromEnv } from "./env-api-key-cjD4yfGT.js";
 import { satisfies } from "semver";
 import yargs from "yargs";
 import { hideBin } from "yargs/helpers";
-import fs, { existsSync, readFileSync, readdirSync, statSync } from "fs";
+import { existsSync, readFileSync, readdirSync, statSync } from "fs";
 import path, { join, relative } from "path";
 import * as os from "node:os";
 import * as path$1 from "node:path";
@@ -27,9 +28,10 @@ import * as fs$1 from "node:fs";
 import axios from "axios";
 import { z } from "zod";
 import { Box, Text, render, useInput, useStdout } from "ink";
-import { createContext, createElement, useCallback, useContext, useEffect, useRef, useState } from "react";
+import { createContext, createElement, useCallback, useContext, useEffect, useMemo, useRef, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { access, rm } from "node:fs/promises";
+import Fuse from "fuse.js";
 import * as readline from "node:readline/promises";
 //#region src/commands/command.ts
 /** Extract the bare command word(s) from a yargs name spec, dropping positionals and aliases' arg syntax. */
@@ -200,7 +202,7 @@ function runProvision(argv) {
 }
 async function provision({ email, region, name, baseUrl, jsonMode }) {
 	try {
-		const { provisionNewAccount } = await import("./provisioning-C1bETgMf.js").then((n) => n.r);
+		const { provisionNewAccount } = await import("./provisioning-CzRepu4H.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 +269,22 @@ const basicIntegrationCommand = {
 		setEntryCommand("integrate");
 		(async () => {
 			if (isHeadless(argv)) {
-				const { runHeadlessInstall } = await import("./ci-install-hArQ6Imb.js");
+				const { runHeadlessInstall } = await import("./ci-install-C9BAoO2n.js");
 				return runHeadlessInstall(argv);
 			}
 			if (argv.ci) {
-				const { runCIInstall } = await import("./ci-install-hArQ6Imb.js");
+				const { runCIInstall } = await import("./ci-install-C9BAoO2n.js");
 				return runCIInstall(argv);
 			}
 			if (isNonInteractiveEnvironment()) {
-				const { failNonInteractive } = await import("./non-interactive-xhKZWWgs.js");
+				const { failNonInteractive } = await import("./non-interactive-C9vQaJF2.js");
 				return failNonInteractive();
 			}
 			if (argv.playground) {
-				const { runPlayground } = await import("./playground-BChSh0sx.js");
+				const { runPlayground } = await import("./playground-DmGHAiON.js");
 				return runPlayground();
 			}
-			const { runInteractive } = await import("./interactive-DRxZ-vOw.js");
+			const { runInteractive } = await import("./interactive-C9vepji1.js");
 			runInteractive(argv);
 		})();
 	}
@@ -665,10 +667,18 @@ const AUDIT_ABORT_CASES = [{
 //#endregion
 //#region src/lib/programs/audit/seed.ts
 /**
-* The 10 data-integrity checks the audit runs, plus one workflow row for the
-* notebook upload at the end (so the skill's `audit_resolve_checks` call for
-* `upload-notebook` succeeds — the skill writes the report to a PostHog
-* notebook as its final step).
+* The 10 source-tree checks the audit runs, plus one row for the PostHog-side
+* sweep and two workflow rows at the end (so the skill's
+* `audit_resolve_checks` calls for `write-report` and `upload-notebook`
+* succeed — the skill writes the report to disk, then mirrors it into a
+* PostHog notebook as its final step).
+*
+* `posthog-side-findings` is a sweep row, not a rule: the skill reads what
+* PostHog itself already computed for this project (error-tracking
+* recommendations, health issues) and appends one row per open finding via
+* `audit_add_checks`. That's why the seed can't enumerate them — the list is
+* whatever the project's data says today, and it grows as PostHog ships new
+* checks, with no wizard release needed.
 */
 const AUDIT_SEED_CHECKS = [
 	{
@@ -731,6 +741,12 @@ const AUDIT_SEED_CHECKS = [
 		label: "Key activation events captured",
 		status: "pending"
 	},
+	{
+		id: "live-data-findings",
+		area: "Live Data",
+		label: "Open findings in PostHog",
+		status: "pending"
+	},
 	{
 		id: "write-report",
 		area: "Write report",
@@ -752,9 +768,7 @@ const AUDIT_SEED_CHECKS = [
 */
 function seedAuditLedger(installDir, checks = AUDIT_SEED_CHECKS) {
 	const target = path.join(installDir, AUDIT_CHECKS_FILE);
-	const tmp = `${target}.tmp`;
-	fs.writeFileSync(tmp, JSON.stringify(checks, null, 2), "utf8");
-	fs.renameSync(tmp, target);
+	writeJsonAtomic(target, checks);
 	logToFile(`seedAuditLedger: wrote ${checks.length} entries to ${target}`);
 }
 //#endregion
@@ -3058,7 +3072,7 @@ function buildSelfDrivingPrompt(ctx, detectedSources = []) {
 	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 troop, 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, put Replay Vision scanners on its key flows, and hand the user a configured inbox.
 
 Project URLs:
 - Integrations settings: ${integrationsSettingsUrl}
@@ -3093,6 +3107,7 @@ tasks, in this order:
   5. Offer issue-tracker integrations
   6. Configure the scout troop
   6b. Design custom scouts
+  6c. Set up Replay Vision scanners
   7. Write report and hand off
 Drive the list with TaskUpdate — mark a task in_progress when you start
 it and completed when done. If a step turns out to be a no-op (e.g.
@@ -3183,6 +3198,16 @@ STEP 6 — Configure the scout troop. (skill: "Scouts")
    whole troop, including step 6b's custom scouts, stays at or under
    ten enabled scouts.
 
+   Then tell the user what the troop is, before STEP 6b asks them to add
+   to it. Scouts are PostHog's built-in ones, and the user has not seen
+   the list: without it, STEP 6b asks them to approve additions to a
+   baseline they cannot picture. Send one short message naming each
+   scout you enabled with a plain one-line description of what it
+   watches, and say how many you left disabled and that they can turn
+   those on later from the inbox. No wizard_ask here, it is not a
+   question. Keep each line to one sentence and do not restate the
+   skill's internals.
+
 STEP 6b — 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
@@ -3201,11 +3226,29 @@ STEP 6b — Design custom scouts for this product. (skill: "Custom scouts")
    no gap at all) is a valid outcome, not an abort. Mark the task
    completed either way.
 
+STEP 6c — Set up Replay Vision scanners. (skill: "Replay Vision scanners")
+   Create the scanner skeletons the skill defines, filling the per-product
+   blanks it leaves you from this repo's code. Scanners need Session Replay
+   on (STEP 3b). Every failure here — no recordings yet, a backend-only
+   project, the scanner API missing — is a follow-up, never an abort; mark
+   the task completed regardless.
+
 STEP 7 — Write the report and hand off. (skill: "Report")
    Write the report per the skill, including follow-ups for anything
    deferred. Tell the user findings will start appearing in their inbox
    at ${inboxUrl} within about 30 minutes.`;
 }
+/** One line, for a screen that only has room to say what it costs. */
+const PRICING_SHORT = `Agents charge a flat $15 per pull request they ship.`;
+/** The same fact at length, plus the bit people are surprised by later. */
+const PRICING_LONG = `A report that ships a pull request costs a flat $15. Everything else follows your usual PostHog usage-based pricing.`;
+/**
+* Nothing caps the spend unless you set it, which is worth saying out loud. Checked against
+* billing: `custom_limits_map` starts empty and a product with no custom limit resolves to
+* `usage_limit: None`, i.e. uncapped. A free plan is capped by its own allocation instead,
+* hence the qualifier.
+*/
+const NO_DEFAULT_LIMIT = "A paid plan has no monthly cap until you set one. Add a PR limit in your inbox sidebar, and agents pause when they hit it.";
 //#endregion
 //#region src/lib/programs/self-driving/content/tips.ts
 const SELF_DRIVING_TIPS = [
@@ -3219,6 +3262,11 @@ const SELF_DRIVING_TIPS = [
 		title: "Scout",
 		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: "scanner",
+		title: "Scanner",
+		description: "Where a scout reads your data, a scanner watches session recordings — an LLM spotting what broke on screen. It spends Replay Vision quota, so it stays scoped to your key flows."
+	},
 	{
 		id: "signal-report",
 		title: "Signal → report",
@@ -3232,7 +3280,7 @@ const SELF_DRIVING_TIPS = [
 	{
 		id: "pricing",
 		title: "What it costs",
-		description: "Watching is free. You pay a flat $15 only when a report ships a PR."
+		description: `${PRICING_LONG} ${NO_DEFAULT_LIMIT}`
 	},
 	{
 		id: "work-anywhere",
@@ -3471,8 +3519,12 @@ const getContentBlocks = (store) => {
 			pause: 6e3
 		},
 		{
-			content: "That PR is the only thing you pay for: a flat $15 per report that ships a PR. Watching is free.",
-			pause: 6e3
+			content: PRICING_LONG,
+			pause: 5e3
+		},
+		{
+			content: NO_DEFAULT_LIMIT,
+			pause: 5e3
 		},
 		CLEAR,
 		{
@@ -3607,11 +3659,12 @@ const buildRun = (session) => Promise.resolve({
 				items: [
 					"Investigate reports with the agent",
 					"Tag teammates to loop them in",
-					"Kick off a PR when you like the proposed fix ($15 flat)",
+					`Kick off a PR when you like the proposed fix ($15 flat)`,
+					"Cap the spend with a monthly PR limit in the sidebar",
 					"Or work from Slack (tag @PostHog) and MCP"
 				]
 			},
-			body: "Pricing: scouts, signals, and reports are free. You pay a flat $15 only when a report ships a PR.",
+			body: `${PRICING_LONG} ${NO_DEFAULT_LIMIT}`,
 			reportFile: REPORT_FILE
 		};
 	}
@@ -3903,6 +3956,17 @@ function getProgramConfig(id) {
 	return PROGRAM_REGISTRY.find((c) => c.id === id);
 }
 //#endregion
+//#region src/commands/mcp/tui-availability.ts
+/**
+* Ink throws "Raw mode is not supported" when stdin has no TTY (piped input,
+* CI, some IDE terminals). That is the only TUI failure the mcp commands
+* degrade to LoggingUI for — any other error from the TUI path is a real bug
+* and must surface rather than be silently swallowed.
+*/
+function isTUIUnavailable(error) {
+	return error instanceof Error && /raw mode is not supported/i.test(error.message);
+}
+//#endregion
 //#region src/commands/mcp/add.ts
 const mcpAddCommand = {
 	name: "add",
@@ -3932,8 +3996,8 @@ function runMcpAdd(argv) {
 		const debug = argv.debug;
 		const localMcp = argv.local;
 		try {
-			const { startTUI } = await import("./start-tui-BqyCxVie.js");
-			const { buildSession } = await import("./wizard-session-DsK16SGs.js");
+			const { startTUI } = await import("./start-tui-BYTQwgvK.js");
+			const { buildSession } = await import("./wizard-session-DZUDtS5d.js");
 			const tui = startTUI(VERSION, Program.McpAdd);
 			tui.store.session = buildSession({
 				debug,
@@ -3945,7 +4009,7 @@ function runMcpAdd(argv) {
 		} catch (error) {
 			if (!isTUIUnavailable(error)) throw error;
 			setUI(new LoggingUI());
-			const { addMCPServerToClientsStep } = await import("./add-mcp-server-to-clients-OsyI-Bkn.js").then((n) => n.r);
+			const { addMCPServerToClientsStep } = await import("./add-mcp-server-to-clients-KNIHRN_m.js").then((n) => n.r);
 			await addMCPServerToClientsStep({
 				local: localMcp,
 				features,
@@ -3954,15 +4018,6 @@ function runMcpAdd(argv) {
 		}
 	})();
 }
-/**
-* Ink throws "Raw mode is not supported" when stdin has no TTY (piped input,
-* CI, some IDE terminals). That is the only TUI failure we degrade to
-* LoggingUI for — any other error from the TUI path is a real bug and must
-* surface rather than be silently swallowed.
-*/
-function isTUIUnavailable(error) {
-	return error instanceof Error && /raw mode is not supported/i.test(error.message);
-}
 function parseFeatures(raw) {
 	if (typeof raw !== "string") return void 0;
 	return raw.split(",").map((s) => s.trim()).filter(Boolean);
@@ -3984,17 +4039,18 @@ function runMcpRemove(argv) {
 		const debug = argv.debug;
 		const localMcp = argv.local;
 		try {
-			const { startTUI } = await import("./start-tui-BqyCxVie.js");
-			const { buildSession } = await import("./wizard-session-DsK16SGs.js");
+			const { startTUI } = await import("./start-tui-BYTQwgvK.js");
+			const { buildSession } = await import("./wizard-session-DZUDtS5d.js");
 			const tui = startTUI(VERSION, Program.McpRemove);
 			tui.store.session = buildSession({
 				debug,
 				localMcp,
 				baseUrl: argv.baseUrl
 			});
-		} catch {
+		} catch (error) {
+			if (!isTUIUnavailable(error)) throw error;
 			setUI(new LoggingUI());
-			const { removeMCPServerFromClientsStep } = await import("./add-mcp-server-to-clients-OsyI-Bkn.js").then((n) => n.r);
+			const { removeMCPServerFromClientsStep } = await import("./add-mcp-server-to-clients-KNIHRN_m.js").then((n) => n.r);
 			await removeMCPServerFromClientsStep({ local: localMcp });
 		}
 	})();
@@ -4016,8 +4072,8 @@ function runMcpTutorial(argv) {
 		const debug = argv.debug;
 		const localMcp = argv.local;
 		try {
-			const { startTUI } = await import("./start-tui-BqyCxVie.js");
-			const { buildSession } = await import("./wizard-session-DsK16SGs.js");
+			const { startTUI } = await import("./start-tui-BYTQwgvK.js");
+			const { buildSession } = await import("./wizard-session-DZUDtS5d.js");
 			const tui = startTUI(VERSION, Program.McpTutorial);
 			tui.store.session = buildSession({
 				debug,
@@ -4098,10 +4154,10 @@ function runWizard(config, options) {
 	(async () => {
 		try {
 			const installDir = options.installDir || process.cwd();
-			const { startTUI } = await import("./start-tui-BqyCxVie.js");
-			const { buildSession, RunPhase } = await import("./wizard-session-DsK16SGs.js");
-			const { TaskStreamPush } = await import("./task-stream-C_xfqch0.js");
-			const { PostHogDestination } = await import("./posthog-B6grWFSr.js");
+			const { startTUI } = await import("./start-tui-BYTQwgvK.js");
+			const { buildSession, RunPhase } = await import("./wizard-session-DZUDtS5d.js");
+			const { TaskStreamPush } = await import("./task-stream-DAU6Z6u6.js");
+			const { PostHogDestination } = await import("./posthog-BitL59Wc.js");
 			tui = startTUI(WIZARD_VERSION, config.id);
 			const activeTui = tui;
 			const session = buildSession({
@@ -4167,7 +4223,7 @@ function runWizard(config, options) {
 				if (shown(step)) await advanceStep(step, activeTui.store, config);
 			}
 			else if (skipAgent) {
-				const { getOrAskForProjectData } = await import("./setup-utils-CcYGniRV.js").then((n) => n.r);
+				const { getOrAskForProjectData } = await import("./setup-utils-C2rGcUFv.js").then((n) => n.r);
 				const { projectApiKey, host, accessToken, projectId } = await getOrAskForProjectData({
 					signup: session.signup,
 					ci: session.ci,
@@ -4268,11 +4324,11 @@ function runNonInteractive(config, options, mode) {
 	analytics.setTag("build", mode);
 	(async () => {
 		const path = await import("path");
-		const { buildSession, RunPhase, OutroKind } = await import("./wizard-session-DsK16SGs.js");
-		const { readEnvironment } = await import("./environment-D6GAX3yG.js").then((n) => n.t);
+		const { buildSession, RunPhase, OutroKind } = await import("./wizard-session-DZUDtS5d.js");
+		const { readEnvironment } = await import("./environment-BffaZJRI.js").then((n) => n.t);
 		const { readApiKeyFromEnv } = await import("./env-api-key-cjD4yfGT.js").then((n) => n.t);
-		const { configureLogFileFromEnvironment, logToFile } = await import("./debug-BC-RNoVX.js");
-		const { wizardAbort, WizardError } = await import("./wizard-abort-DPCzBsvy.js");
+		const { configureLogFileFromEnvironment, logToFile } = await import("./debug-npp6DzBK.js");
+		const { wizardAbort, WizardError } = await import("./wizard-abort-B_Sa9K3g.js");
 		configureLogFileFromEnvironment();
 		const env = readEnvironment();
 		const apiKey = options.apiKey ?? readApiKeyFromEnv() ?? void 0;
@@ -4305,9 +4361,9 @@ function runNonInteractive(config, options, mode) {
 		let store = null;
 		let taskStream = null;
 		if (mode === "headless") {
-			const { WizardStore } = await import("./store-suEDuCAn.js").then((n) => n.n);
-			const { HeadlessUI } = await import("./headless-ui-BGLCn1Dw.js");
-			const { TaskStreamPush, PostHogDestination } = await import("./task-stream-C_xfqch0.js");
+			const { WizardStore } = await import("./store-pBYMaEuj.js").then((n) => n.n);
+			const { HeadlessUI } = await import("./headless-ui-Dy_l8hCT.js");
+			const { TaskStreamPush, PostHogDestination } = await import("./task-stream-DAU6Z6u6.js");
 			store = new WizardStore(config.id);
 			store.session = session;
 			setUI(new HeadlessUI(store));
@@ -4363,7 +4419,7 @@ function runNonInteractive(config, options, mode) {
 					});
 				}
 			}
-			const { runAgent } = await import("./agent-runner-2CRvJ1nS.js").then((n) => n.t);
+			const { runAgent } = await import("./agent-runner-DLAvB67P.js").then((n) => n.t);
 			await runAgent(config, session);
 			await settleStream(RunPhase.Completed);
 		} catch (error) {
@@ -4641,6 +4697,81 @@ function pickerChildrenToShow(children) {
 	return defaults.length > 0 ? [...defaults] : [...children];
 }
 //#endregion
+//#region src/ui/tui/primitives/picker-filter.ts
+/**
+* Filter-as-you-type matching for PickerMenu. Split out from the component so the
+* ranking is testable on its own — the component only decides when to call it.
+*/
+/**
+* Fuzzy fallback config. `ignoreLocation` because a term matching at the end of a
+* description is as good as one at the start, and Fuse's default distance window
+* would score the late match away. 0.5 is the loosest threshold that still bottoms
+* out: below it `gthb` misses `GitHub` entirely, which is the whole point of having
+* a fuzzy pass; above it the tail grows without surfacing anything new at the top.
+*/
+const FUSE_OPTIONS = {
+	keys: [
+		{
+			name: "label",
+			weight: 3
+		},
+		{
+			name: "hint",
+			weight: 1
+		},
+		{
+			name: "description",
+			weight: 1
+		}
+	],
+	ignoreLocation: true,
+	threshold: .5,
+	includeScore: true
+};
+function buildPickerIndex(options) {
+	return new Fuse(options, FUSE_OPTIONS);
+}
+function haystack(option) {
+	return `${option.label} ${option.hint ?? ""} ${option.description ?? ""}`.toLowerCase();
+}
+/**
+* Rank options against a query, best first, or `null` for an empty query.
+*
+* Two passes, literal before fuzzy. Anything that literally contains every
+* whitespace-separated term wins outright, in the list's own order — that covers how
+* people actually type (`git iss` → `GitHub issues`) and keeps the common case as
+* tight as a plain substring filter, which fuzzy matching on its own is not: Fuse at
+* a threshold loose enough to forgive `gthb` also lets a third of the list through
+* on `replay`.
+*
+* Only when nothing matches literally does Fuse get a turn, so a typo degrades to a
+* ranked guess instead of an empty list. Terms are AND-ed there too, each matched
+* fuzzily on its own — Fuse's bitap pass over the whole query would otherwise need
+* `git iss` to be a near-edit of the text it's matching. Scores are distances (0 is
+* exact) and sum across terms, hence the ascending sort; ties keep the order the
+* first term put them in, since the sort is stable.
+*/
+function rankOptions(fuse, options, query) {
+	const terms = query.toLowerCase().split(/\s+/).filter(Boolean);
+	if (!terms.length) return null;
+	const literal = options.filter((option) => terms.every((term) => haystack(option).includes(term)));
+	if (literal.length) return literal;
+	let surviving = null;
+	for (const term of terms) {
+		const hits = new Map(fuse.search(term).map(({ item, score }) => [item, score ?? 0]));
+		if (surviving === null) {
+			surviving = hits;
+			continue;
+		}
+		for (const [option, total] of surviving) {
+			const score = hits.get(option);
+			if (score === void 0) surviving.delete(option);
+			else surviving.set(option, total + score);
+		}
+	}
+	return [...surviving ?? []].sort(([, a], [, b]) => a - b).map(([option]) => option);
+}
+//#endregion
 //#region src/ui/tui/primitives/PromptLabel.tsx
 /**
 * PromptLabel — Compact inline label for input prompts.
@@ -4722,6 +4853,8 @@ const DEFAULT_PRIORITY = {
 	["leftArrow"]: 1,
 	["rightArrow"]: 1,
 	["space"]: 10,
+	["printable"]: 12,
+	["backspace"]: 13,
 	["escape"]: 20,
 	["return"]: 21
 };
@@ -4739,6 +4872,8 @@ function matchesKey(m, input, key) {
 		case "return": return !!key.return;
 		case "escape": return !!key.escape;
 		case "space": return input === " ";
+		case "backspace": return !!key.backspace || !!key.delete;
+		case "printable": return input.length === 1 && input >= " " && input !== "" && Object.entries(key).every(([flag, on]) => !on || flag === "shift");
 		default: return input === m;
 	}
 }
@@ -4931,29 +5066,70 @@ function usePickerViewport(count, rowCost, chromeBelow, enabled, focused) {
 		pageStep: (f, dir) => (Math.floor(f / perPage) + dir + pageCount) % pageCount * perPage
 	};
 }
-const PickerMenu = ({ message, options, mode = "single", centered = false, columns = 1, optionMarginBottom = 0, onSelect }) => {
-	if (mode === "multi") return /* @__PURE__ */ jsx(MultiPickerMenu, {
-		message,
+/** Lists at least this long get filtering. Shorter ones fit on a page or two,
+*  where a filter row costs more rows than it saves. */
+const FILTER_MIN_OPTIONS = 10;
+const PickerMenu = ({ message, options, mode = "single", centered = false, columns = 1, optionMarginBottom = 0, filterable, onSelect }) => {
+	const canFilter = filterable ?? options.length >= FILTER_MIN_OPTIONS;
+	const [filter, setFilter] = useState("");
+	const fuse = useMemo(() => canFilter ? buildPickerIndex(options) : null, [options, canFilter]);
+	const visible = useMemo(() => fuse ? rankOptions(fuse, options, filter) ?? options : options, [
+		fuse,
 		options,
-		centered,
-		columns,
-		optionMarginBottom,
-		onSelect
-	});
-	return /* @__PURE__ */ jsx(SinglePickerMenu, {
+		filter
+	]);
+	const [selected, setSelected] = useState(/* @__PURE__ */ new Set());
+	const shared = {
 		message,
-		options,
+		options: visible,
 		centered,
-		columns,
 		optionMarginBottom,
-		onSelect
-	});
+		onSelect,
+		filter: canFilter ? filter : null,
+		setFilter,
+		totalCount: options.length
+	};
+	const key = String(filter);
+	if (mode === "multi") return /* @__PURE__ */ jsx(MultiPickerMenu, {
+		...shared,
+		columns,
+		allOptions: options,
+		selected,
+		setSelected
+	}, key);
+	return /* @__PURE__ */ jsx(SinglePickerMenu, {
+		...shared,
+		columns
+	}, key);
 };
+/**
+* Backspace and free typing. Append these last: `Printable` matches almost any
+* key, and bindings resolve in order, so anything specific has to be registered
+* first to keep working. Both share a label/action so the hints bar shows one.
+*/
+function filterBindings(filter, setFilter) {
+	return [{
+		match: "backspace",
+		label: "type",
+		action: "filter",
+		handler: () => setFilter(filter.slice(0, -1))
+	}, {
+		match: "printable",
+		label: "type",
+		action: "filter",
+		handler: (input) => setFilter(filter + input)
+	}];
+}
+/** The filter row above a filterable list: what's typed, and how much it left. */
+const FilterRow = ({ filter, shown, total }) => /* @__PURE__ */ jsx(Box, { children: /* @__PURE__ */ jsx(Text, {
+	dimColor: true,
+	children: filter ? `Filter: ${filter} (${shown} of ${total})` : `Type to filter ${total} options`
+}) });
 /** Custom single-select with triangle indicator and accent highlight. */
-const SinglePickerMenu = ({ message, options, centered = false, columns = 1, optionMarginBottom = 0, onSelect }) => {
+const SinglePickerMenu = ({ message, options, centered = false, columns = 1, optionMarginBottom = 0, filter, setFilter, totalCount, onSelect }) => {
 	const [focused, setFocused] = useState(() => firstEnabled(options));
 	const rows = Math.ceil(options.length / columns);
-	const viewport = usePickerViewport(options.length, 1 + optionMarginBottom, 0, columns === 1, focused);
+	const viewport = usePickerViewport(options.length, 1 + optionMarginBottom, filter !== null ? 1 : 0, columns === 1, focused);
 	useEffect(() => {
 		if (focused >= options.length || options[focused]?.disabled) setFocused(firstEnabled(options));
 	}, [options, focused]);
@@ -4963,22 +5139,10 @@ const SinglePickerMenu = ({ message, options, centered = false, columns = 1, opt
 			label: "↑↓",
 			action: "navigate",
 			handler: (_input, key) => {
-				const dir = key.upArrow ? -1 : 1;
-				if (columns === 1) {
-					const { start, end } = viewport;
-					const span = end - start;
-					let r = focused;
-					for (let i = 0; i < span; i++) {
-						r = start + (r - start + dir + span) % span;
-						if (!options[r]?.disabled) break;
-					}
-					setFocused(r);
-					return;
-				}
-				setFocused(stepEnabled(options, rows, focused, dir));
+				setFocused(stepEnabled(options, rows, focused, key.upArrow ? -1 : 1));
 			}
 		},
-		...viewport.needsScroll ? [{
+		...viewport.needsScroll && filter === null ? [{
 			match: ["n", "p"],
 			label: "n/p",
 			action: "page",
@@ -5017,6 +5181,7 @@ const SinglePickerMenu = ({ message, options, centered = false, columns = 1, opt
 			setFocused(next);
 		}
 	});
+	if (filter !== null) bindings.push(...filterBindings(filter, setFilter));
 	useKeyBindings("single-picker", bindings);
 	const columnArrays = [];
 	for (let c = 0; c < columns; c++) columnArrays.push(options.slice(c * rows, c * rows + rows));
@@ -5050,27 +5215,38 @@ const SinglePickerMenu = ({ message, options, centered = false, columns = 1, opt
 	return /* @__PURE__ */ jsxs(Box, {
 		flexDirection: "column",
 		alignItems: align,
-		children: [/* @__PURE__ */ jsx(PromptLabel, { message }), viewport.needsScroll ? /* @__PURE__ */ jsxs(Box, {
-			flexDirection: "column",
-			children: [
-				/* @__PURE__ */ jsx(Text, {
-					dimColor: true,
-					children: viewport.hiddenAbove > 0 ? `↑ ${viewport.hiddenAbove} more [P] for previous page` : " "
-				}),
-				options.slice(viewport.start, viewport.end).map((opt, relIdx) => renderOption(opt, viewport.start + relIdx)),
-				/* @__PURE__ */ jsx(Text, {
-					dimColor: true,
-					children: viewport.hiddenBelow > 0 ? `↓ ${viewport.hiddenBelow} more [N] for next page` : " "
-				})
-			]
-		}) : /* @__PURE__ */ jsx(Box, {
-			flexDirection: "row",
-			gap: 4,
-			children: columnArrays.map((colOpts, colIdx) => /* @__PURE__ */ jsx(Box, {
+		children: [
+			/* @__PURE__ */ jsx(PromptLabel, { message }),
+			filter !== null && /* @__PURE__ */ jsx(FilterRow, {
+				filter,
+				shown: options.length,
+				total: totalCount
+			}),
+			filter && options.length === 0 ? /* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: "No options match. Backspace to widen the filter."
+			}) : viewport.needsScroll ? /* @__PURE__ */ jsxs(Box, {
 				flexDirection: "column",
-				children: colOpts.map((opt, rowIdx) => renderOption(opt, colIdx * rows + rowIdx))
-			}, colIdx))
-		})]
+				children: [
+					/* @__PURE__ */ jsx(Text, {
+						dimColor: true,
+						children: viewport.hiddenAbove > 0 ? `↑ ${viewport.hiddenAbove} more${filter === null ? " [P] for previous page" : ""}` : " "
+					}),
+					options.slice(viewport.start, viewport.end).map((opt, relIdx) => renderOption(opt, viewport.start + relIdx)),
+					/* @__PURE__ */ jsx(Text, {
+						dimColor: true,
+						children: viewport.hiddenBelow > 0 ? `↓ ${viewport.hiddenBelow} more${filter === null ? " [N] for next page" : ""}` : " "
+					})
+				]
+			}) : /* @__PURE__ */ jsx(Box, {
+				flexDirection: "row",
+				gap: 4,
+				children: columnArrays.map((colOpts, colIdx) => /* @__PURE__ */ jsx(Box, {
+					flexDirection: "column",
+					children: colOpts.map((opt, rowIdx) => renderOption(opt, colIdx * rows + rowIdx))
+				}, colIdx))
+			})
+		]
 	});
 };
 /**
@@ -5085,18 +5261,17 @@ const SinglePickerMenu = ({ message, options, centered = false, columns = 1, opt
 *   - moving onto the Confirm button and pressing enter submits the
 *     current selection.
 */
-const MultiPickerMenu = ({ message, options, centered = false, columns = 1, optionMarginBottom = 0, onSelect }) => {
+const MultiPickerMenu = ({ message, options, centered = false, columns = 1, optionMarginBottom = 0, filter, setFilter, totalCount, allOptions, selected, setSelected, onSelect }) => {
 	const [focused, setFocused] = useState(() => firstEnabled(options));
 	const [onButton, setOnButton] = useState(false);
-	const [selected, setSelected] = useState(/* @__PURE__ */ new Set());
 	const rows = Math.ceil(options.length / columns);
 	const rowCost = options.reduce((max, opt) => Math.max(max, 1 + optionMarginBottom + (opt.description ? wordWrap(opt.description, DESCRIPTION_WIDTH).length : 0)), 1);
-	const viewport = usePickerViewport(options.length, rowCost, CONFIRM_CHROME, columns === 1, focused);
+	const viewport = usePickerViewport(options.length, rowCost, CONFIRM_CHROME + (filter !== null ? 1 : 0), columns === 1, focused);
 	useEffect(() => {
 		if (focused >= options.length || options[focused]?.disabled) setFocused(firstEnabled(options));
 	}, [options, focused]);
 	const confirm = () => {
-		onSelect([...selected].sort((a, b) => a - b).map((i) => options[i].value));
+		onSelect(allOptions.filter((option) => selected.has(option.label)).map((option) => option.value));
 	};
 	const bindings = [
 		{
@@ -5110,13 +5285,6 @@ const MultiPickerMenu = ({ message, options, centered = false, columns = 1, opti
 					setFocused(dir === -1 ? lastEnabled(options, viewport.start, viewport.end) : firstEnabled(options, viewport.start, viewport.end));
 					return;
 				}
-				if (columns === 1) {
-					let r = focused + dir;
-					while (r >= viewport.start && r < viewport.end && options[r]?.disabled) r += dir;
-					if (r >= viewport.start && r < viewport.end) setFocused(r);
-					else setOnButton(true);
-					return;
-				}
 				const col = Math.floor(focused / rows);
 				const row = focused % rows;
 				const colLen = Math.min(rows, options.length - col * rows);
@@ -5126,7 +5294,7 @@ const MultiPickerMenu = ({ message, options, centered = false, columns = 1, opti
 				else setOnButton(true);
 			}
 		},
-		...viewport.needsScroll ? [{
+		...viewport.needsScroll && filter === null ? [{
 			match: ["n", "p"],
 			label: "n/p",
 			action: "page",
@@ -5137,7 +5305,7 @@ const MultiPickerMenu = ({ message, options, centered = false, columns = 1, opti
 			}
 		}] : [],
 		{
-			match: ["space", "return"],
+			match: filter !== null ? "return" : ["space", "return"],
 			label: "enter",
 			action: "select",
 			handler: () => {
@@ -5145,16 +5313,18 @@ const MultiPickerMenu = ({ message, options, centered = false, columns = 1, opti
 					confirm();
 					return;
 				}
-				if (options[focused]?.disabled) return;
+				const option = options[focused];
+				if (!option || option.disabled) return;
+				const label = option.label;
 				setSelected((prev) => {
 					const next = new Set(prev);
-					if (next.has(focused)) {
-						next.delete(focused);
+					if (next.has(label)) {
+						next.delete(label);
 						return next;
 					}
-					if (options[focused]?.exclusive) return new Set([focused]);
-					for (const i of next) if (options[i]?.exclusive) next.delete(i);
-					next.add(focused);
+					if (option.exclusive) return new Set([label]);
+					for (const picked of next) if (allOptions.find((o) => o.label === picked)?.exclusive) next.delete(picked);
+					next.add(label);
 					return next;
 				});
 			}
@@ -5181,12 +5351,13 @@ const MultiPickerMenu = ({ message, options, centered = false, columns = 1, opti
 			setFocused(next);
 		}
 	});
+	if (filter !== null) bindings.push(...filterBindings(filter, setFilter));
 	useKeyBindings("multi-picker", bindings);
 	const columnArrays = [];
 	for (let c = 0; c < columns; c++) columnArrays.push(options.slice(c * rows, c * rows + rows));
 	const renderOption = (opt, flatIdx) => {
 		const isFocused = !onButton && flatIdx === focused;
-		const isSelected = selected.has(flatIdx);
+		const isSelected = selected.has(opt.label);
 		const label = opt.hint ? `${opt.label} (${opt.hint})` : opt.label;
 		const checkbox = isSelected ? Icons.squareFilled : Icons.squareOpen;
 		return /* @__PURE__ */ jsxs(Box, {
@@ -5227,6 +5398,15 @@ const MultiPickerMenu = ({ message, options, centered = false, columns = 1, opti
 		alignItems: centered ? "center" : void 0,
 		children: [
 			/* @__PURE__ */ jsx(PromptLabel, { message }),
+			filter !== null && /* @__PURE__ */ jsx(FilterRow, {
+				filter,
+				shown: options.length,
+				total: totalCount
+			}),
+			filter && options.length === 0 && /* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: "No options match. Backspace to widen the filter."
+			}),
 			viewport.needsScroll ? /* @__PURE__ */ jsxs(Box, {
 				flexDirection: "column",
 				marginLeft: centered ? 0 : 2,
@@ -5234,12 +5414,12 @@ const MultiPickerMenu = ({ message, options, centered = false, columns = 1, opti
 				children: [
 					/* @__PURE__ */ jsx(Text, {
 						dimColor: true,
-						children: viewport.hiddenAbove > 0 ? `↑ ${viewport.hiddenAbove} more [P] for previous page` : " "
+						children: viewport.hiddenAbove > 0 ? `↑ ${viewport.hiddenAbove} more${filter === null ? " [P] for previous page" : ""}` : " "
 					}),
 					options.slice(viewport.start, viewport.end).map((opt, relIdx) => renderOption(opt, viewport.start + relIdx)),
 					/* @__PURE__ */ jsx(Text, {
 						dimColor: true,
-						children: viewport.hiddenBelow > 0 ? `↓ ${viewport.hiddenBelow} more [N] for next page` : " "
+						children: viewport.hiddenBelow > 0 ? `↓ ${viewport.hiddenBelow} more${filter === null ? " [N] for next page" : ""}` : " "
 					})
 				]
 			}) : /* @__PURE__ */ jsx(Box, {
@@ -5445,7 +5625,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-CcYGniRV.js").then((n) => n.r);
+		const { getOrAskForProjectData } = await import("./setup-utils-C2rGcUFv.js").then((n) => n.r);
 		const { host, accessToken, projectId } = await getOrAskForProjectData({
 			signup: false,
 			ci: true,
@@ -5463,7 +5643,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-XEopttY8.js").then((n) => n.n);
+		const { ApiError } = await import("./api-XHQTOfIi.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);
@@ -5545,8 +5725,8 @@ function runSlackConnect(argv) {
 	(async () => {
 		const debug = argv.debug;
 		try {
-			const { startTUI } = await import("./start-tui-BqyCxVie.js");
-			const { buildSession } = await import("./wizard-session-DsK16SGs.js");
+			const { startTUI } = await import("./start-tui-BYTQwgvK.js");
+			const { buildSession } = await import("./wizard-session-DZUDtS5d.js");
 			const tui = startTUI(VERSION, Program.SlackConnect);
 			tui.store.session = buildSession({
 				debug,
@@ -5878,6 +6058,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 { 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 };
+export { STRIPE_SDKS as A, MANUAL_SDK_VARIANTS as C, fetchHealthIssues as D, getKindMeta as E, getContentBlocks$3 as O, MANUAL_SDK_INSTALL as S, SOURCE_MAPS_CONTEXT_KEYS as T, detectSelfDrivingIntegrationProjects as _, useStdoutDimensions as a, DISPLAY_NAME as b, runWizardHeadless as c, PROGRAM_REGISTRY as d, Program as f, PRICING_SHORT as g, PRICING_LONG as h, useKeyboardHintsContext as i, POSTHOG_SDKS as k, runWizardCI as l, NO_DEFAULT_LIMIT as m, useKeyBindings as n, ConfirmButton as o, getProgramConfig as p, KeyboardHintsProvider as r, PromptLabel as s, PickerMenu as t, runWizard as u, SELF_DRIVING_INTEGRATE_PATH_KEY as v, RUST_SDK_CRATE as w, GO_SDK_MODULE as x, AUTOMATABLE_VARIANTS as y };
 
 //# sourceMappingURL=bin.js.map