@posthog/wizard 2.64.1 → 2.66.0

package/dist/bin.js

@@ -1,20 +1,21 @@
 #!/usr/bin/env node
-import { Ct as isHeadless, L as Integration, St as headlessOption, U as POSTHOG_DOCS_URL, a as getLogFilePath, f as getUI, gt as VERSION, m as LoggingUI, mt as getSkillsBaseUrl, p as setUI, pt as WIZARD_USER_AGENT, r as debug, s as logToFile, wt as regionOption } from "./debug-hy6aWAyk.js";
-import { n as analytics } from "./analytics-D3vKvr3l.js";
-import { r as setEntryCommand } from "./telemetry-6zaFfCcy.js";
-import { a as safeReadFile, o as walkProjectFiles } from "./bounded-fs-BeWc675I.js";
-import { n as isUsingTypeScript } from "./setup-utils-DNpldqge.js";
-import { o as handleApiError } from "./api-Bhe8jpUR.js";
-import "./wizard-session-BUhlJ1b8.js";
-import { i as wizardAbort, r as runCleanups } from "./wizard-abort-D6jJh8u5.js";
-import { n as isNonInteractiveEnvironment } from "./environment-Ktu0Ktjl.js";
-import { n as runAgent, s as authenticate } from "./agent-runner-DisJWxJa.js";
-import { p as writeJsonAtomic } from "./queue-tools-Jlz9dV_B.js";
-import { S as WIZARD_TOOL_NAMES, T as fetchSkillMenu, l as recoverOrphanedSettingsBackups, p as AgentSignals } from "./agent-interface-NurnwA01.js";
-import { S as SETUP_REPORT_FILE, _ as AUDIT_CHECKS_KEY, g as AUDIT_CHECKS_FILE, v as AUDIT_REPORT_FILE } from "./yara-hooks-DjReXmTQ.js";
-import { i as SPINNER_MESSAGE, t as FRAMEWORK_REGISTRY } from "./registry-PG_nV5Bf.js";
-import { C as scopeInstallDirToProject, D as detectFramework, E as gatherFrameworkContext, S as detectIntegrationProjects, T as resolveProjectDir, _ as HEALTH_CHECK_STEP, a as LINE_CHART_BLOCK, b as getDetectedWarehouseSources, d as isClearBlock, g as detectPostHogIntegration, 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 WAREHOUSE_ABORT_CASES, x as detectWarehouseSources, y as detectWarehousePrerequisites } from "./posthog-integration-DKlEg8-Q.js";
-import { n as readApiKeyFromEnv } from "./env-api-key-CMPe-WJp.js";
+import { Ct as isHeadless, L as Integration, St as headlessOption, U as POSTHOG_DOCS_URL, a as getLogFilePath, f as getUI, gt as VERSION, m as LoggingUI, mt as getSkillsBaseUrl, p as setUI, pt as WIZARD_USER_AGENT, r as debug, s as logToFile, wt as regionOption } from "./debug-BKqv-yfT.js";
+import { a as getLocalDev, i as checkLocalServices, o as initLocalDev, r as POSTHOG_LOCAL_URL, s as localMcpSkillsNotice } from "./local-dev-BN6NKQ0B.js";
+import { n as analytics } from "./analytics-D8JNuPAT.js";
+import { r as setEntryCommand } from "./telemetry-BllPiBKw.js";
+import { a as safeReadFile, o as walkProjectFiles } from "./bounded-fs-C6OjqZst.js";
+import { n as isUsingTypeScript } from "./setup-utils-aWZEdfwh.js";
+import { o as handleApiError } from "./api-CemGgyBv.js";
+import "./wizard-session-DTyLMPsX.js";
+import { i as wizardAbort, r as runCleanups } from "./wizard-abort-D9jiMkZA.js";
+import { n as isNonInteractiveEnvironment } from "./environment-Cl-fIQku.js";
+import { n as runAgent, s as authenticate } from "./agent-runner-DEeMqJxy.js";
+import { m as writeJsonAtomic } from "./queue-tools-DABh1Ssc.js";
+import { D as WIZARD_TOOL_NAMES, j as fetchSkillMenu, l as recoverOrphanedSettingsBackups, p as AgentSignals } from "./agent-interface-D3MNaDp3.js";
+import { S as SETUP_REPORT_FILE, _ as AUDIT_CHECKS_KEY, g as AUDIT_CHECKS_FILE, v as AUDIT_REPORT_FILE } from "./yara-hooks-BXDBIOBq.js";
+import { i as SPINNER_MESSAGE, t as FRAMEWORK_REGISTRY } from "./registry-CxNpCNAj.js";
+import { C as scopeInstallDirToProject, D as detectFramework, E as gatherFrameworkContext, S as detectIntegrationProjects, T as resolveProjectDir, _ as HEALTH_CHECK_STEP, a as LINE_CHART_BLOCK, b as getDetectedWarehouseSources, d as isClearBlock, g as detectPostHogIntegration, 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 WAREHOUSE_ABORT_CASES, x as detectWarehouseSources, y as detectWarehousePrerequisites } from "./posthog-integration-LxEBGkoe.js";
+import { n as readApiKeyFromEnv } from "./env-api-key-CzHDwfV2.js";
 import { satisfies } from "semver";
 import yargs from "yargs";
 import { hideBin } from "yargs/helpers";
@@ -66,8 +67,9 @@ function toCommandModule(cmd, parentPath) {
 * `POSTHOG_WIZARD` env prefix as well as flags.
 *
 * Options with `hidden: true` are "internal modes" — they don't show up in
-* `--help` but are still accepted on every command. The catalog of internal
-* flags and what each one does lives in CONTRIBUTING.md.
+* `--help` but are still accepted on every command. The `--local-*` flags live
+* in the constructor's `!IS_PRODUCTION_BUILD` block instead, so published
+* builds reject them; see `docs/local-dev.md`.
 */
 const GLOBAL_OPTIONS = {
 	debug: {
@@ -97,12 +99,6 @@ const GLOBAL_OPTIONS = {
 		describe: "Email address for signup (used with --signup)\nenv: POSTHOG_WIZARD_EMAIL",
 		type: "string"
 	},
-	"local-mcp": {
-		default: false,
-		describe: "Use local MCP server at http://localhost:8787/mcp\nenv: POSTHOG_WIZARD_LOCAL_MCP",
-		type: "boolean",
-		hidden: true
-	},
 	"base-url": {
 		describe: "Override the PostHog base URL (e.g. http://localhost:8010), bypassing region resolution. Pins the API host, cloud URL, and OAuth server.\nenv: POSTHOG_WIZARD_BASE_URL",
 		type: "string",
@@ -125,7 +121,15 @@ var Wizard = class Wizard {
 	cli;
 	constructor() {
 		let cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options(GLOBAL_OPTIONS);
-		this.cli = cli.strictOptions().strictCommands().fail((msg, err) => {
+		this.cli = cli.middleware((argv) => {
+			initLocalDev(argv);
+			const notice = localMcpSkillsNotice({
+				localDev: argv.localDev,
+				localMcp: argv.localMcp,
+				localContextMill: argv.localContextMill
+			});
+			if (notice) process.stderr.write(`\n\x1b[33m! ${notice}\x1b[0m\n\n`);
+		}).strictOptions().strictCommands().fail((msg, err) => {
 			const text = msg || err && err.message || "Invalid arguments";
 			process.stderr.write(`\n\x1b[1;91m✖ ${text}\x1b[0m\n  Run \`wizard --help\` to see available commands and options.\n\n`);
 			process.exit(1);
@@ -156,10 +160,29 @@ var Wizard = class Wizard {
 				process.stderr.write(`\n\x1b[1;91m✖ The --harness, --sequence, --model, and --capture-aio overrides are not available in published builds.\x1b[0m\n\n`);
 				process.exit(1);
 			}
+			const argvHasLocalTarget = args.some((a) => LOCAL_TARGET_FLAGS.some((f) => a === `--${f}` || a === `--no-${f}` || a.startsWith(`--${f}=`)));
+			const envHasLocalTarget = LOCAL_TARGET_ENV_VARS.some((k) => process.env[k] != null && process.env[k] !== "");
+			if (argvHasLocalTarget || envHasLocalTarget) {
+				process.stderr.write("\n\x1B[1;91m✖ The --local-dev, --local-context-mill, --local-mcp, and --local-posthog targets are not available in published builds.\x1B[0m\n  They point the wizard at development servers on localhost.\n\n");
+				process.exit(1);
+			}
 		}
 		this.cli.wrap(process.stdout.isTTY ? this.cli.terminalWidth() : 80).argv;
 	}
 };
+/** Excludes bare `local`: `wizard mcp add --local` stays available in prod. */
+const LOCAL_TARGET_FLAGS = [
+	"local-dev",
+	"local-context-mill",
+	"local-mcp",
+	"local-posthog"
+];
+const LOCAL_TARGET_ENV_VARS = [
+	"POSTHOG_WIZARD_LOCAL_DEV",
+	"POSTHOG_WIZARD_LOCAL_CONTEXT_MILL",
+	"POSTHOG_WIZARD_LOCAL_MCP",
+	"POSTHOG_WIZARD_LOCAL_POSTHOG"
+];
 //#endregion
 //#region src/commands/provision.ts
 const provisionCommand = {
@@ -202,7 +225,7 @@ function runProvision(argv) {
 }
 async function provision({ email, region, name, baseUrl, jsonMode }) {
 	try {
-		const { provisionNewAccount } = await import("./provisioning-QsG7HDCm.js").then((n) => n.r);
+		const { provisionNewAccount } = await import("./provisioning-BHTl91OZ.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);
@@ -269,22 +292,22 @@ const basicIntegrationCommand = {
 		setEntryCommand("integrate");
 		(async () => {
 			if (isHeadless(argv)) {
-				const { runHeadlessInstall } = await import("./ci-install-BpNzfghY.js");
+				const { runHeadlessInstall } = await import("./ci-install-DIB2n4Ju.js");
 				return runHeadlessInstall(argv);
 			}
 			if (argv.ci) {
-				const { runCIInstall } = await import("./ci-install-BpNzfghY.js");
+				const { runCIInstall } = await import("./ci-install-DIB2n4Ju.js");
 				return runCIInstall(argv);
 			}
 			if (isNonInteractiveEnvironment()) {
-				const { failNonInteractive } = await import("./non-interactive-73xGtug6.js");
+				const { failNonInteractive } = await import("./non-interactive-CNoYoEZp.js");
 				return failNonInteractive();
 			}
 			if (argv.playground) {
-				const { runPlayground } = await import("./playground-AEkWcB1E.js");
+				const { runPlayground } = await import("./playground-uHHgZChe.js");
 				return runPlayground();
 			}
-			const { runInteractive } = await import("./interactive-BUw1SEOz.js");
+			const { runInteractive } = await import("./interactive-D3LdFxZG.js");
 			runInteractive(argv);
 		})();
 	}
@@ -569,7 +592,10 @@ function buildPrompt(session) {
 		"The wizard detected the following data warehouse sources in this project:",
 		...sources.map((s) => `- ${s.label} (kind: ${s.kind}, mode: ${s.mode}) — ${s.matchedSignal}`),
 		"",
-		"Set these up in PostHog following the skill instructions: create `in-cli` sources directly via the PostHog MCP after collecting credentials; for `deep-link` sources, provide the user the pre-filled new-source URL."
+		"Each signal names the file it came from. Trust that path — the wizard read it. To confirm a key is set, call `check_env_keys` with the key names and no `filePath`; it scans every `.env` file in the project.",
+		"",
+		"Set these up in PostHog following the skill instructions: create `in-cli` sources directly via the PostHog MCP after collecting credentials; for `deep-link` sources, provide the user the pre-filled new-source URL.",
+		"Use the `kind` string exactly as printed above for `source_type` — PostHog rejects the display label."
 	].join("\n");
 }
 const warehouseSourceConfig = {
@@ -1953,8 +1979,12 @@ STEP 5 — Write the credentials to the env file. (skill: "Write credentials to
    Use the wizard-tools MCP server. Reuse the env file the skill tells you to
    pick — the prerequisite PostHog integration usually already wrote
    POSTHOG_* vars to one, so seed your keys alongside them.
-   - First call check_env_keys on that file (returns present/absent, never
-     values — don't read the file directly).
+   - First call check_env_keys with the key names and that file as filePath.
+     It answers { status: "present" | "missing", foundIn: [paths] } per key —
+     names and paths only, never values, so don't read the file directly.
+     "present" means a real env file sets the key; a key found only in a
+     committed template (.env.example and friends) reads as "missing",
+     because a template documents a key rather than setting it.
    - 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:
@@ -2936,7 +2966,10 @@ function toIntegrationReport(report) {
 }
 /** Run the Haiku detector over the repo and classify projects for integration. */
 async function detectSelfDrivingIntegrationProjects(session, onEvent) {
-	return toIntegrationReport(await detectIntegrationProjects(session, { onEvent }));
+	return toIntegrationReport(await detectIntegrationProjects(session, {
+		programId: "self-driving",
+		onEvent
+	}));
 }
 /**
 * Prepare the integration phase after the user picked a project on the
@@ -2952,9 +2985,7 @@ async function prepSelfDrivingIntegration(session) {
 	const context = await gatherFrameworkContext(frameworkConfig, {
 		installDir: session.installDir,
 		debug: session.debug,
-		default: false,
 		signup: session.signup,
-		localMcp: session.localMcp,
 		ci: session.ci,
 		benchmark: session.benchmark,
 		yaraReport: session.yaraReport
@@ -3773,7 +3804,8 @@ const mcpAddConfig = {
 			label: "Suggested prompts",
 			screenId: "mcp-suggested-prompts",
 			show: (s) => s.mcpOutcome === "installed",
-			isComplete: (s) => s.mcpSuggestedPromptsDismissed
+			isComplete: (s) => s.mcpSuggestedPromptsDismissed,
+			reportsAsProgramId: "mcp-tutorial"
 		}
 	]
 };
@@ -4006,9 +4038,7 @@ const replayVisionConfig = {
 		const context = await gatherFrameworkContext(frameworkConfig, {
 			installDir: session.installDir,
 			debug: session.debug,
-			default: false,
 			signup: session.signup,
-			localMcp: session.localMcp,
 			ci: true,
 			benchmark: session.benchmark,
 			yaraReport: session.yaraReport
@@ -4072,6 +4102,70 @@ final report is written to ./${AI_OBSERVABILITY_REPORT_FILE}.`,
 	}
 };
 //#endregion
+//#region src/lib/programs/metrics/index.ts
+const METRICS_STEPS = AGENT_SKILL_STEPS.map((step) => step.id === "intro" ? {
+	...step,
+	screenId: "metrics-intro"
+} : step);
+const METRICS_REPORT_FILE = "posthog-metrics-report.md";
+/**
+* `wizard metrics` — instrument the project with PostHog application metrics
+* (`posthog.metrics` counters, gauges, and histograms).
+*
+* No `run.skillId`: the context-mill `metrics` group ships one variant per
+* platform (python, nodejs, javascript, kubernetes, other/OTLP) and the agent
+* pulls the matching one itself — the flow's tasks and the linear
+* `customPrompt` both pick from the menu and install it. Stays flat while a
+* single "add metrics to a project" flow is the only action.
+*/
+const metricsConfig = {
+	command: "metrics",
+	description: "Add PostHog application metrics to your project",
+	id: "metrics",
+	agentFlow: "metrics",
+	steps: METRICS_STEPS,
+	reportFile: METRICS_REPORT_FILE,
+	getContentBlocks: getContentBlocks$3,
+	run: {
+		integrationLabel: "metrics",
+		customPrompt: () => `Instrument this project with PostHog application metrics.
+
+This flow has no pre-installed skill — you install the right one yourself:
+
+1. Call \`load_skill_menu\` with \`category: "metrics"\`. The menu is the
+   source of truth: one variant per platform.
+
+2. Pick the variant that matches the project:
+   - Python tooling (\`pyproject.toml\`, \`requirements.txt\`, \`Pipfile\`) →
+     \`metrics-python\` (needs \`posthog\` >= 7.23.0)
+   - \`package.json\` with server-side Node code → \`metrics-nodejs\`
+     (needs \`posthog-node\` >= 5.43.0)
+   - \`package.json\` that is browser-only → \`metrics-javascript\`
+     (needs \`posthog-js\` >= 1.399.0)
+   - Kubernetes manifests / Helm charts and the user wants cluster-level
+     scraping → \`metrics-kubernetes\`
+   - Any other language → \`metrics-other\` (plain OTLP exporter)
+   A full-stack app (e.g. Next.js) usually wants the server variant — metrics
+   measure service work, not user actions. Genuinely ambiguous →
+   \`wizard_ask\` with a multi-choice picker.
+
+3. Call \`install_skill\` with the picked variant id. Then follow that skill's
+   \`SKILL.md\` and references end-to-end — it covers where to place metrics
+   (middleware, background jobs, external calls, business commit sites) and
+   the low-cardinality attribute rules.
+
+Make only additive changes — reuse an existing PostHog client by adding the
+\`metrics\` config to it rather than constructing a second client, and do not
+touch existing identify calls, event capture, or dashboards. The final report
+is written to ./${METRICS_REPORT_FILE}.`,
+		successMessage: `Application metrics configured! View the report at ./${METRICS_REPORT_FILE}`,
+		reportFile: METRICS_REPORT_FILE,
+		docsUrl: "https://posthog.com/docs/metrics",
+		spinnerMessage: "Setting up application metrics...",
+		estimatedDurationMinutes: 5
+	}
+};
+//#endregion
 //#region src/lib/programs/slack/index.ts
 const slackConnectConfig = {
 	id: "slack",
@@ -4122,6 +4216,7 @@ const PROGRAM_REGISTRY = [
 	mcpAnalyticsConfig,
 	replayVisionConfig,
 	aiObservabilityConfig,
+	metricsConfig,
 	slackConnectConfig
 ];
 /**
@@ -4147,6 +4242,7 @@ const Program = {
 	McpAnalytics: mcpAnalyticsConfig.id,
 	ReplayVision: replayVisionConfig.id,
 	AiObservability: aiObservabilityConfig.id,
+	Metrics: metricsConfig.id,
 	SlackConnect: slackConnectConfig.id
 };
 /**
@@ -4186,20 +4282,30 @@ const mcpAddCommand = {
 		"api-key": {
 			describe: "PostHog personal API key (phx_xxx) for MCP authentication",
 			type: "string"
-		}
+		},
+		...headlessOption
 	},
 	handler: runMcpAdd
 };
 function runMcpAdd(argv) {
 	const features = parseFeatures(argv.features);
 	(async () => {
-		const { readApiKeyFromEnv } = await import("./env-api-key-CMPe-WJp.js").then((n) => n.t);
+		const { readApiKeyFromEnv } = await import("./env-api-key-CzHDwfV2.js").then((n) => n.t);
 		const apiKey = argv.apiKey || readApiKeyFromEnv();
 		const debug = argv.debug;
 		const localMcp = argv.local;
+		const args = {
+			local: localMcp,
+			features,
+			apiKey
+		};
+		if (isHeadless(argv)) {
+			await runHeadlessAdd(args);
+			return;
+		}
 		try {
-			const { startTUI } = await import("./start-tui-D4B0-2nr.js");
-			const { buildSession } = await import("./wizard-session-DZUDtS5d.js");
+			const { startTUI } = await import("./start-tui-BQH4mQIZ.js");
+			const { buildSession } = await import("./wizard-session-Cw7-_OcZ.js");
 			const tui = startTUI(VERSION, Program.McpAdd);
 			tui.store.session = buildSession({
 				debug,
@@ -4210,16 +4316,16 @@ function runMcpAdd(argv) {
 			});
 		} catch (error) {
 			if (!isTUIUnavailable(error)) throw error;
-			setUI(new LoggingUI());
-			const { addMCPServerToClientsStep } = await import("./add-mcp-server-to-clients-BUqb93_I.js").then((n) => n.r);
-			await addMCPServerToClientsStep({
-				local: localMcp,
-				features,
-				apiKey
-			});
+			await runHeadlessAdd(args);
 		}
 	})();
 }
+async function runHeadlessAdd(args) {
+	setUI(new LoggingUI());
+	const { addMCPServerToClientsStep } = await import("./add-mcp-server-to-clients-DWDEuDUR.js").then((n) => n.r);
+	const { installed, failed } = await addMCPServerToClientsStep(args);
+	if (failed.length > 0 || installed.length === 0) process.exitCode = 1;
+}
 function parseFeatures(raw) {
 	if (typeof raw !== "string") return void 0;
 	return raw.split(",").map((s) => s.trim()).filter(Boolean);
@@ -4229,20 +4335,27 @@ function parseFeatures(raw) {
 const mcpRemoveCommand = {
 	name: "remove",
 	description: "Remove PostHog MCP server from supported clients",
-	options: { local: {
-		default: false,
-		describe: "Remove local development MCP server (http://localhost:8787)",
-		type: "boolean"
-	} },
+	options: {
+		local: {
+			default: false,
+			describe: "Remove local development MCP server (http://localhost:8787)",
+			type: "boolean"
+		},
+		...headlessOption
+	},
 	handler: runMcpRemove
 };
 function runMcpRemove(argv) {
 	(async () => {
 		const debug = argv.debug;
 		const localMcp = argv.local;
+		if (isHeadless(argv)) {
+			await runHeadlessRemove(localMcp);
+			return;
+		}
 		try {
-			const { startTUI } = await import("./start-tui-D4B0-2nr.js");
-			const { buildSession } = await import("./wizard-session-DZUDtS5d.js");
+			const { startTUI } = await import("./start-tui-BQH4mQIZ.js");
+			const { buildSession } = await import("./wizard-session-Cw7-_OcZ.js");
 			const tui = startTUI(VERSION, Program.McpRemove);
 			tui.store.session = buildSession({
 				debug,
@@ -4251,12 +4364,16 @@ function runMcpRemove(argv) {
 			});
 		} catch (error) {
 			if (!isTUIUnavailable(error)) throw error;
-			setUI(new LoggingUI());
-			const { removeMCPServerFromClientsStep } = await import("./add-mcp-server-to-clients-BUqb93_I.js").then((n) => n.r);
-			await removeMCPServerFromClientsStep({ local: localMcp });
+			await runHeadlessRemove(localMcp);
 		}
 	})();
 }
+/** No exit code on an empty result: nothing to remove is the requested end state. */
+async function runHeadlessRemove(local) {
+	setUI(new LoggingUI());
+	const { removeMCPServerFromClientsStep } = await import("./add-mcp-server-to-clients-DWDEuDUR.js").then((n) => n.r);
+	await removeMCPServerFromClientsStep({ local });
+}
 //#endregion
 //#region src/commands/mcp/tutorial.ts
 const mcpTutorialCommand = {
@@ -4274,8 +4391,8 @@ function runMcpTutorial(argv) {
 		const debug = argv.debug;
 		const localMcp = argv.local;
 		try {
-			const { startTUI } = await import("./start-tui-D4B0-2nr.js");
-			const { buildSession } = await import("./wizard-session-DZUDtS5d.js");
+			const { startTUI } = await import("./start-tui-BQH4mQIZ.js");
+			const { buildSession } = await import("./wizard-session-Cw7-_OcZ.js");
 			const tui = startTUI(VERSION, Program.McpTutorial);
 			tui.store.session = buildSession({
 				debug,
@@ -4356,15 +4473,27 @@ function runWizard(config, options) {
 	(async () => {
 		try {
 			const installDir = options.installDir || process.cwd();
-			const { startTUI } = await import("./start-tui-D4B0-2nr.js");
-			const { buildSession, RunPhase } = await import("./wizard-session-DZUDtS5d.js");
-			const { TaskStreamPush } = await import("./task-stream-BGUP7yA-.js");
-			const { PostHogDestination } = await import("./posthog-4PljLcIz.js");
+			const { startTUI } = await import("./start-tui-BQH4mQIZ.js");
+			const { buildSession, RunPhase } = await import("./wizard-session-Cw7-_OcZ.js");
+			const { TaskStreamPush } = await import("./task-stream-jUARpyB5.js");
+			const { PostHogDestination } = await import("./posthog-ChzdlmCs.js");
+			const local = getLocalDev();
+			const localServicesError = await checkLocalServices({
+				...local,
+				localPosthog: local.localPosthog && !options.baseUrl
+			});
+			if (localServicesError) {
+				const { wizardAbort } = await import("./wizard-abort-pFFH7dcx.js");
+				await wizardAbort({ message: localServicesError });
+				return;
+			}
 			tui = startTUI(WIZARD_VERSION, config.id);
 			const activeTui = tui;
 			const session = buildSession({
 				debug: options.debug,
+				localDev: options.localDev,
 				localMcp: options.localMcp,
+				localPosthog: options.localPosthog,
 				installDir,
 				ci: false,
 				signup: options.signup,
@@ -4425,7 +4554,7 @@ function runWizard(config, options) {
 				if (shown(step)) await advanceStep(step, activeTui.store, config);
 			}
 			else if (skipAgent) {
-				const { getOrAskForProjectData } = await import("./setup-utils-DNpldqge.js").then((n) => n.r);
+				const { getOrAskForProjectData } = await import("./setup-utils-aWZEdfwh.js").then((n) => n.r);
 				const { projectApiKey, host, accessToken, projectId } = await getOrAskForProjectData({
 					signup: session.signup,
 					ci: session.ci,
@@ -4526,11 +4655,11 @@ function runNonInteractive(config, options, mode) {
 	analytics.setTag("build", mode);
 	(async () => {
 		const path = await import("path");
-		const { buildSession, RunPhase, OutroKind } = await import("./wizard-session-DZUDtS5d.js");
-		const { readEnvironment } = await import("./environment-Ktu0Ktjl.js").then((n) => n.t);
-		const { readApiKeyFromEnv } = await import("./env-api-key-CMPe-WJp.js").then((n) => n.t);
-		const { configureLogFileFromEnvironment, logToFile } = await import("./debug-DGfRPr2A.js");
-		const { wizardAbort, WizardError } = await import("./wizard-abort-PgTdRS1l.js");
+		const { buildSession, RunPhase, OutroKind } = await import("./wizard-session-Cw7-_OcZ.js");
+		const { readEnvironment } = await import("./environment-Cl-fIQku.js").then((n) => n.t);
+		const { readApiKeyFromEnv } = await import("./env-api-key-CzHDwfV2.js").then((n) => n.t);
+		const { configureLogFileFromEnvironment, logToFile } = await import("./debug-H-GTKvvU.js");
+		const { wizardAbort, WizardError } = await import("./wizard-abort-pFFH7dcx.js");
 		configureLogFileFromEnvironment();
 		const env = readEnvironment();
 		const apiKey = options.apiKey ?? readApiKeyFromEnv() ?? void 0;
@@ -4540,7 +4669,9 @@ function runNonInteractive(config, options, mode) {
 			installDir,
 			ci: true,
 			signup: options.signup,
+			localDev: options.localDev,
 			localMcp: options.localMcp,
+			localPosthog: options.localPosthog,
 			apiKey,
 			email: options.email,
 			projectId: options.projectId,
@@ -4560,12 +4691,21 @@ function runNonInteractive(config, options, mode) {
 		const runDef = typeof config.run === "object" ? config.run : null;
 		getUI().intro("Welcome to the PostHog setup wizard");
 		getUI().log.info(`Running ${config.id} in ${modeLabel(mode)} mode`);
+		const localServicesError = await checkLocalServices({
+			...getLocalDev(),
+			localMcp: session.localMcp,
+			localPosthog: session.baseUrl === POSTHOG_LOCAL_URL
+		});
+		if (localServicesError) {
+			await wizardAbort({ message: localServicesError });
+			return;
+		}
 		let store = null;
 		let taskStream = null;
 		if (mode === "headless") {
-			const { WizardStore } = await import("./store-DouLLelV.js").then((n) => n.n);
-			const { HeadlessUI } = await import("./headless-ui-zZLgs4QL.js");
-			const { TaskStreamPush, PostHogDestination } = await import("./task-stream-BGUP7yA-.js");
+			const { WizardStore } = await import("./store-P_7zUfbj.js").then((n) => n.n);
+			const { HeadlessUI } = await import("./headless-ui-DT3Db1bk.js");
+			const { TaskStreamPush, PostHogDestination } = await import("./task-stream-jUARpyB5.js");
 			store = new WizardStore(config.id);
 			store.session = session;
 			setUI(new HeadlessUI(store));
@@ -4621,7 +4761,7 @@ function runNonInteractive(config, options, mode) {
 					});
 				}
 			}
-			const { runAgent } = await import("./agent-runner-DisJWxJa.js").then((n) => n.t);
+			const { runAgent } = await import("./agent-runner-DEeMqJxy.js").then((n) => n.t);
 			await runAgent(config, session);
 			await settleStream(RunPhase.Completed);
 		} catch (error) {
@@ -4675,10 +4815,9 @@ function runWizardHeadless(config, options) {
 * Per-command options shared by every skill-based program command
 * (`audit events`, `migrate statsig`, `revenue`, `source-maps`, …).
 *
-* Only flags that are unique to skill commands live here. Global flags
-* (`--debug`, `--local-mcp`, `--benchmark`, `--yara-report`, `--ci`) are
-* declared once in `wizard.ts::GLOBAL_OPTIONS` and apply automatically
-* across every command — no need to repeat them per subcommand.
+* Only flags unique to skill commands live here. Global flags are declared
+* once in `wizard.ts` — both in `GLOBAL_OPTIONS` and, for the dev-only ones,
+* the `Wizard` constructor — and apply to every command automatically.
 */
 const skillProgramOptions = { "install-dir": {
 	describe: "Directory to install in",
@@ -4790,6 +4929,19 @@ const replayVisionCommand = nativeCommandFactory(replayVisionConfig);
 */
 const aiObservabilityCommand = nativeCommandFactory(aiObservabilityConfig);
 //#endregion
+//#region src/commands/metrics.ts
+/**
+* `wizard metrics` — flat skill command, wire PostHog application metrics
+* (counters, gauges, histograms via \`posthog.metrics\`) into a project.
+*
+* The `metrics` context-mill skill has one variant per platform (python,
+* nodejs, javascript, kubernetes, other/OTLP); the agent picks the right one
+* at run time by scanning the project's manifest and (when ambiguous) asking
+* the user via `wizard_ask`. Stays flat while a single "add metrics to a
+* project" flow is the only action.
+*/
+const metricsCommand = nativeCommandFactory(metricsConfig);
+//#endregion
 //#region src/lib/programs/dispatch-family.ts
 /**
 * Capture a CLI dispatch error, flush analytics, and exit. The wizard never
@@ -4852,7 +5004,7 @@ async function dispatchFamily(family, argv) {
 		dispatchProgram(native, argv);
 		return;
 	}
-	const skillsBaseUrl = getSkillsBaseUrl(Boolean(argv["local-mcp"]));
+	const skillsBaseUrl = getSkillsBaseUrl();
 	const menu = await fetchSkillMenu(skillsBaseUrl);
 	if (!menu) return exitDispatchError("registry unreachable", {
 		family,
@@ -5762,7 +5914,7 @@ function createFamilyPickerDefault(parentLabel, children, chooser = chooseFamily
 */
 function familyCommandFactory({ family, description, optionsFrom }) {
 	const openFamilyEntry = async (argv) => {
-		const toShow = pickerChildrenToShow(buildFamilyPickerChildren(family, (await fetchSkillMenu(getSkillsBaseUrl(Boolean(argv["local-mcp"]))))?.cliEntries ?? []));
+		const toShow = pickerChildrenToShow(buildFamilyPickerChildren(family, (await fetchSkillMenu(getSkillsBaseUrl()))?.cliEntries ?? []));
 		if (toShow.length === 1 && toShow[0]?.handler) {
 			await Promise.resolve(toShow[0].handler(argv));
 			return;
@@ -5838,7 +5990,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-DNpldqge.js").then((n) => n.r);
+		const { getOrAskForProjectData } = await import("./setup-utils-aWZEdfwh.js").then((n) => n.r);
 		const { host, accessToken, projectId } = await getOrAskForProjectData({
 			signup: false,
 			ci: true,
@@ -5856,7 +6008,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-Bhe8jpUR.js").then((n) => n.n);
+		const { ApiError } = await import("./api-CemGgyBv.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);
@@ -5938,8 +6090,8 @@ function runSlackConnect(argv) {
 	(async () => {
 		const debug = argv.debug;
 		try {
-			const { startTUI } = await import("./start-tui-D4B0-2nr.js");
-			const { buildSession } = await import("./wizard-session-DZUDtS5d.js");
+			const { startTUI } = await import("./start-tui-BQH4mQIZ.js");
+			const { buildSession } = await import("./wizard-session-Cw7-_OcZ.js");
 			const tui = startTUI(VERSION, Program.SlackConnect);
 			tui.store.session = buildSession({
 				debug,
@@ -6016,8 +6168,8 @@ const BROWSABLE_ROLES = new Set(["command", "skill"]);
 * step's own `menu-fetch-failed` handling, rather than adding a second network
 * dependency that could block an otherwise-valid run.
 */
-async function assertSkillExists(skillName, localMcp) {
-	const skillsBaseUrl = getSkillsBaseUrl(localMcp);
+async function assertSkillExists(skillName) {
+	const skillsBaseUrl = getSkillsBaseUrl();
 	const menu = await fetchSkillMenu(skillsBaseUrl);
 	if (!menu) return;
 	if (Object.values(menu.categories).flat().some((s) => s.id === skillName)) return;
@@ -6050,9 +6202,9 @@ const skillCommand = {
 	children: [{
 		name: "list",
 		description: "List every browsable skill in the catalog",
-		handler: (argv) => {
+		handler: () => {
 			runCommandHandler(async () => {
-				const skillsBaseUrl = getSkillsBaseUrl(Boolean(argv["local-mcp"]));
+				const skillsBaseUrl = getSkillsBaseUrl();
 				const menu = await fetchSkillMenu(skillsBaseUrl);
 				if (!menu) {
 					analytics.wizardCapture("cli dispatch error", {
@@ -6091,7 +6243,7 @@ const skillCommand = {
 	handler: (argv) => {
 		runCommandHandler(async () => {
 			const skillName = readSkillName(argv);
-			await assertSkillExists(skillName, Boolean(argv["local-mcp"]));
+			await assertSkillExists(skillName);
 			runSkillMode({
 				...argv,
 				skill: skillName
@@ -6269,7 +6421,7 @@ function resolveInstallDir() {
 	if (inline) return inline.slice(14);
 	return process.env.POSTHOG_WIZARD_INSTALL_DIR ?? process.cwd();
 }
-Wizard.use(basicIntegrationCommand).use(mcpCommand).use(mcpAnalyticsCommand).use(replayVisionCommand).use(aiObservabilityCommand).use(cliCommand).use(auditCommand).use(doctorCommand).use(migrateCommand).use(revenueCommand).use(warehouseCommand).use(selfDrivingCommand).use(slackCommand).use(uploadSourcemapsCommand).use(skillCommand).init();
+Wizard.use(basicIntegrationCommand).use(mcpCommand).use(mcpAnalyticsCommand).use(replayVisionCommand).use(aiObservabilityCommand).use(metricsCommand).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 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 };