@posthog/wizard 2.80.1 → 2.81.0

package/dist/programs-DjCmEcxb.js

@@ -0,0 +1,3 @@
+import "./programs-Ml6OLybj.js";
+import { C as FRAMEWORK_REGISTRY } from "./posthog-integration-FAWfClH3.js";
+export { FRAMEWORK_REGISTRY };

package/dist/{programs-SeT1qNik.js → programs-Ml6OLybj.js}

@@ -1,18 +1,18 @@
-import { n as ErrorCodes } from "./emit-RfAewcWv.js";
-import { f as VERSION, l as WIZARD_TASK_STREAM_FILE, o as logToFile, p as HEADLESS_FLAG } from "./debug-BfQPD2Hg.js";
-import { B as REPLAY_VISION_SUPPORTED, E as ISSUES_URL, G as WIZARD_CONTACT_EMAIL, I as POSTHOG_PROXY_CLIENT_ID, J as WIZARD_OAUTH_SCOPES, L as POSTHOG_STATUS_PAGE_URL, M as POSTHOG_DOCS_URL, Q as WIZARD_PROVISIONING_SCOPES, S as GPT5_6_TERRA_MODEL, dt as resolveLocalDev, f as DEFAULT_AGENT_MODEL, h as EVENTS_AUDIT_REPORT_FILE, j as POSTHOG_DEV_CLIENT_ID, n as analytics, nt as WIZARD_USER_AGENT, o as mayReportScanResults, r as groupsFromUser, rt as getSkillsBaseUrl } from "./analytics-D21z3E5l.js";
-import { a as WizardError, n as sanitizeErrorDetail, t as classifyRunFailure } from "./errors-CHrJzAZb.js";
-import { i as readProjectFile, t as IGNORED_DIRS } from "./bounded-fs-CAsuF6al.js";
-import { n as isUsingTypeScript } from "./setup-utils-C5-WM-hS.js";
-import { r as currentCredentials, t as configureOAuthSession } from "./oauth-session-Dde79Ycm.js";
-import { m as checkSkillsOriginHealth, s as AgentSignals } from "./gateway-D3gIlR6b.js";
-import { R as WIZARD_TOOL_NAMES, _ as markGrantRevoked, c as checkAllSettingsConflicts, d as restoreClaudeSettings, g as isGrantRevoked, l as classifySettingsConflicts, nt as LONGER_ASK_TIMEOUT_MS, p as registerCleanup, s as backupAndFixClaudeSettings } from "./agent-interface-CemBvTAA.js";
-import { a as getOAuthUrl, s as resolveBaseUrl } from "./urls-BDELGZHq.js";
-import { C as detectFramework, O as runAgent, S as gatherFrameworkContext, T as SPINNER_MESSAGE, _ as toIntegrationCandidates, a as ProgramAbort, c as stampAiSdkDetected, d as findPackageJsons, f as DETECTED_WAREHOUSE_SOURCES_KEY, g as scopeInstallDirToProject, h as detectIntegrationProjects, i as withScopeAdditions, k as DEFAULT_BINDING, m as getDetectedWarehouseSources, n as WAREHOUSE_SOURCE_SCOPE_ADDITIONS, o as detectPostHogIntegration, p as detectWarehouseSources, s as reportWarehouseSourcesDetected, t as config$13, v as detectProjectsWithAgent, w as FRAMEWORK_REGISTRY, x as noteDetectedFramework, y as resolveProjectDir } from "./posthog-integration-bwHwE87a.js";
-import { p as appendStatus } from "./pi-cM_4Gd_9.js";
-import { v as writeJsonAtomic } from "./queue-tools-BIZSJyt6.js";
-import { C as coerceAuditChecks, S as AUDIT_REPORT_FILE, x as AUDIT_CHECKS_FILE } from "./yara-hooks-D8YDyX7o.js";
-import { t as resolveApiKeyProject } from "./api-key-login-h3E2G3zu.js";
+import { n as ErrorCodes } from "./emit-BqLCdV8Y.js";
+import { f as VERSION, l as WIZARD_TASK_STREAM_FILE, o as logToFile, p as HEADLESS_FLAG } from "./debug-sB20p-Ek.js";
+import { B as REPLAY_VISION_SUPPORTED, E as ISSUES_URL, G as WIZARD_CONTACT_EMAIL, I as POSTHOG_PROXY_CLIENT_ID, J as WIZARD_OAUTH_SCOPES, L as POSTHOG_STATUS_PAGE_URL, M as POSTHOG_DOCS_URL, Q as WIZARD_PROVISIONING_SCOPES, S as GPT5_6_TERRA_MODEL, dt as resolveLocalDev, f as DEFAULT_AGENT_MODEL, h as EVENTS_AUDIT_REPORT_FILE, j as POSTHOG_DEV_CLIENT_ID, n as analytics, nt as WIZARD_USER_AGENT, o as mayReportScanResults, r as groupsFromUser, rt as getSkillsBaseUrl } from "./analytics-CGGE7OSa.js";
+import { a as WizardError, n as sanitizeErrorDetail, t as classifyRunFailure } from "./errors-DhFeR8Sp.js";
+import { i as readProjectFile, t as IGNORED_DIRS } from "./bounded-fs-DwL2Tasp.js";
+import { n as isUsingTypeScript } from "./setup-utils-Dfgse6pY.js";
+import { r as currentCredentials, t as configureOAuthSession } from "./oauth-session-C2fVSGfr.js";
+import { m as checkSkillsOriginHealth, s as AgentSignals } from "./gateway-Dg4Fm-nC.js";
+import { B as WIZARD_TOOL_NAMES, _ as markGrantRevoked, c as checkAllSettingsConflicts, d as restoreClaudeSettings, g as isGrantRevoked, it as LONGER_ASK_TIMEOUT_MS, l as classifySettingsConflicts, p as registerCleanup, s as backupAndFixClaudeSettings } from "./agent-interface-BFzBnz10.js";
+import { a as getOAuthUrl, s as resolveBaseUrl } from "./urls-eFaChZ9d.js";
+import { C as FRAMEWORK_REGISTRY, D as runAgent, O as DEFAULT_BINDING, S as detectFramework, _ as detectProjectsWithAgent, a as detectPostHogIntegration, b as noteDetectedFramework, d as DETECTED_WAREHOUSE_SOURCES_KEY, f as detectWarehouseSources, g as toIntegrationCandidates, h as scopeInstallDirToProject, i as ProgramAbort, m as detectIntegrationProjects, n as WAREHOUSE_SOURCE_SCOPE_ADDITIONS, o as reportWarehouseSourcesDetected, p as getDetectedWarehouseSources, r as abortNoFrameworkDetected, s as stampAiSdkDetected, t as config$13, u as findPackageJsons, v as resolveProjectDir, w as SPINNER_MESSAGE, x as gatherFrameworkContext } from "./posthog-integration-FAWfClH3.js";
+import { p as appendStatus } from "./pi-Cw7CPXSl.js";
+import { v as writeJsonAtomic } from "./queue-tools-BQfRI_uD.js";
+import { C as coerceAuditChecks, S as AUDIT_REPORT_FILE, x as AUDIT_CHECKS_FILE } from "./yara-hooks-C4HOysrM.js";
+import { t as resolveApiKeyProject } from "./api-key-login-D0KBr1dx.js";
 import { valid } from "semver";
 import * as fs$1 from "fs";
 import fs, { existsSync, readFileSync, readdirSync, statSync } from "fs";
@@ -196,13 +196,38 @@ const MCP_ANALYTICS_ABORT_CASES = [
 		match: /^unsupported language for mcp analytics$/i,
 		errorCode: ErrorCodes.DetectUnsupportedPlatform,
 		message: "Unsupported language for MCP analytics",
-		body: "MCP analytics supports TypeScript/JavaScript (`@posthog/mcp`) and Python (`posthog.mcp`, shipped inside the `posthog` package). This project doesn't look like either, so there's nothing to instrument. See https://posthog.com/docs/mcp-analytics for the supported setups."
+		body: "MCP analytics supports TypeScript/JavaScript (`@posthog/mcp`), Python (`posthog.mcp`, shipped inside the `posthog` package), Go (`posthogmcpsdk`, for servers built on the official go-sdk), and Ruby (`PostHog::MCP`, shipped inside the `posthog-ruby` gem, experimental). This project doesn't look like any of them, so there's nothing to instrument. See https://posthog.com/docs/mcp-analytics for the supported setups."
 	},
 	{
 		match: /^no mcp server found$/i,
 		message: "No MCP server found",
 		body: "This command instruments an existing MCP server with PostHog analytics, but no MCP server was found in this project. If you just want PostHog product analytics, run `npx @posthog/wizard` instead."
 	},
+	{
+		match: /^go mcp server is not built on the official go-sdk$/i,
+		message: "Go MCP server not built on the official go-sdk",
+		body: "The Go SDK instruments servers built on the official `github.com/modelcontextprotocol/go-sdk`. This server uses another library, so there is no one-line setup. See https://posthog.com/docs/mcp-analytics/installation/go for the supported setup."
+	},
+	{
+		match: /^go toolchain older than 1\.25$/i,
+		message: "Go toolchain older than 1.25",
+		body: "`posthogmcpsdk` needs Go 1.25 or later, and the installed toolchain couldn't switch to a newer one. Upgrade Go, then run the command again."
+	},
+	{
+		match: /^ruby mcp server is not built on the official mcp gem$/i,
+		message: "Ruby MCP server not built on the official mcp gem",
+		body: "The Ruby SDK instruments servers built on the official `mcp` gem, or a custom dispatcher through `PostHog::MCP::Client`. This server uses another library. See https://posthog.com/docs/mcp-analytics/installation/ruby for the supported setups."
+	},
+	{
+		match: /^ruby older than 3\.0$/i,
+		message: "Ruby older than 3.0",
+		body: "`PostHog::MCP` needs Ruby 3.0 or later. Upgrade Ruby, then run the command again."
+	},
+	{
+		match: /^ruby mcp gem older than 1\.4$/i,
+		message: "Ruby mcp gem older than 1.4",
+		body: "`PostHog::MCP.instrument` needs the `mcp` gem at 1.4 or later. The wizard doesn't change your `mcp` version. Upgrade it, then run the command again."
+	},
 	{
 		match: /^could not locate the server entry point$/i,
 		message: "Could not locate the MCP server entry point",
@@ -212,10 +237,10 @@ const MCP_ANALYTICS_ABORT_CASES = [
 /**
 * `wizard mcp-analytics` — flat skill command.
 *
-* Instruments the user's own MCP server with the `@posthog/mcp` SDK so it
-* reports `$mcp_*` analytics about itself. This is the opposite of
-* `wizard mcp add` (which installs the PostHog MCP *server* into a coding
-* agent) — keep the two distinct.
+* Instruments the user's own MCP server with the PostHog MCP SDK for its
+* language (TypeScript, Python, Go, or Ruby) so it reports `$mcp_*` analytics about
+* itself. This is the opposite of `wizard mcp add` (which installs the
+* PostHog MCP *server* into a coding agent) — keep the two distinct.
 *
 * Flat while instrumenting is the only action. If an uninstrument / `remove`
 * leaf ever lands, restructure into a family with `familyCommandFactory` and
@@ -229,7 +254,7 @@ const config$12 = createSkillProgram({
 	id: "mcp-analytics",
 	description: "Add PostHog MCP Analytics to your MCP server",
 	integrationLabel: "mcp-analytics",
-	customPrompt: `Instrument this project's MCP server with PostHog MCP analytics. Run the \`mcp-analytics\` skill end-to-end: detect the server style, install \`@posthog/mcp\` and \`posthog-node\`, wrap the server (or use \`PostHogMCP\` for a custom dispatcher), wire the project API key and host, and verify. Make only additive changes — do not alter tool behavior. The final report is written to ./${MCP_ANALYTICS_REPORT_FILE}.`,
+	customPrompt: `Instrument this project's MCP server with PostHog MCP analytics. Run the \`mcp-analytics\` skill end-to-end: detect the language and server style, install the PostHog MCP SDK for that language (\`@posthog/mcp\` for TypeScript, \`posthog\` for Python, \`posthogmcpsdk\` for Go, \`posthog-ruby\` for Ruby), wrap the server (or use the custom-dispatcher client where the skill says so), wire the project API key and host, and verify. Make only additive changes — do not alter tool behavior. For a Ruby server, the report must open by saying the Ruby SDK is experimental and not officially supported. The final report is written to ./${MCP_ANALYTICS_REPORT_FILE}.`,
 	successMessage: `MCP analytics configured! View the report at ./${MCP_ANALYTICS_REPORT_FILE}`,
 	reportFile: MCP_ANALYTICS_REPORT_FILE,
 	docsUrl: "https://posthog.com/docs/mcp-analytics",
@@ -281,6 +306,11 @@ If this repo also contains a web or mobile app, run the command from that projec
   https://posthog.com/docs/session-replay`
 	});
 }
+const NO_FRAMEWORK_GUIDANCE = {
+	message: "Could not find a Replay Vision compatible framework",
+	docsLabel: "Supported replay platforms:",
+	docsUrl: "https://posthog.com/docs/session-replay"
+};
 /**
 * `[ABORT]` reasons the replay-vision skill emits when the run can't proceed.
 * Kept in sync with the stop conditions in the skill's `description.md`
@@ -302,7 +332,8 @@ const REPLAY_VISION_ABORT_CASES = [{
 */
 async function detectReplayVisionProject(ctx) {
 	const integration = await detectFramework(ctx.session.installDir);
-	if (integration && !REPLAY_VISION_SUPPORTED.has(integration)) abortUnsupportedPlatform$1(integration);
+	if (!integration) abortNoFrameworkDetected(NO_FRAMEWORK_GUIDANCE);
+	if (!REPLAY_VISION_SUPPORTED.has(integration)) abortUnsupportedPlatform$1(integration);
 	await detectPostHogIntegration(ctx);
 }
 /**
@@ -351,10 +382,7 @@ const config$11 = {
 	ciPreRun: async (session, runner) => {
 		await scopeInstallDirToProject(session, runner);
 		const integration = await detectFramework(session.installDir);
-		if (!integration) throw new ProgramAbort({
-			code: ErrorCodes.DetectNoFramework,
-			message: "Could not auto-detect your framework for this project."
-		});
+		if (!integration) abortNoFrameworkDetected(NO_FRAMEWORK_GUIDANCE);
 		if (!REPLAY_VISION_SUPPORTED.has(integration)) abortUnsupportedPlatform$1(integration);
 		session.integration = integration;
 		analytics.setTag("integration", integration);
@@ -1009,6 +1037,24 @@ const configs = [{
 	}
 }, config$8];
 //#endregion
+//#region src/shared/oauth-scopes.ts
+/**
+* Extra scope the Connect-Slack step needs on top of `WIZARD_OAUTH_SCOPES`.
+*
+* The step polls `/api/projects/:id/integrations/` (`fetchSlackConnected`)
+* to render the already-connected variant and to flip live once the user
+* completes the Slack OAuth step in the browser. Without `integration:read`
+* the first poll 403s, the screen stops polling, and an already-connected
+* project is nagged with the connect nudge. Used by the `wizard slack` tool,
+* where the step is the whole flow.
+*/
+const CONNECT_SLACK_SCOPE_ADDITIONS = ["integration:read"];
+/** `base` then `additions`, deduped, base first. */
+function withScopeAdditions(base, additions) {
+	if (!additions || additions.length === 0) return base;
+	return [...new Set([...base, ...additions])];
+}
+//#endregion
 //#region src/programs/web-analytics-doctor/detect.ts
 const WEB_ANALYTICS_ABORT_CASES = [
 	{
@@ -2903,10 +2949,7 @@ const config$1 = {
 	ciPreRun: async (session, runner) => {
 		await scopeInstallDirToProject(session, runner);
 		const integration = await detectFramework(session.installDir);
-		if (!integration) throw new ProgramAbort({
-			code: ErrorCodes.DetectNoFramework,
-			message: "Could not auto-detect your framework for this project."
-		});
+		if (!integration) abortNoFrameworkDetected();
 		if (ERROR_TRACKING_UNSUPPORTED.has(integration)) abortUnsupportedPlatform(integration);
 		session.integration = integration;
 		analytics.setTag("integration", integration);
@@ -3880,7 +3923,8 @@ async function invokeProgram(programId, callerInput, options) {
 	const runResults = [];
 	const artifacts = {};
 	const settle = (outcome, failure) => {
-		if (failure) recordFailure(store, failure);
+		if (failure && signal.aborted) recordCancel(store, failure);
+		else if (failure) recordFailure(store, failure);
 		else recordSuccess(store);
 		const diagnostics = progress.diagnostics();
 		for (const diagnostic of diagnostics) logToFile(`[agent-runner] progress diagnostic (${diagnostic.eventKind} run=${diagnostic.runId}): ${diagnostic.message}`);
@@ -4281,6 +4325,16 @@ function recordFailure(store, failure) {
 		store.setRunPhase("error");
 	});
 }
+/** A settled caller cancel, recorded in the store: the cancel outro and the phase. */
+function recordCancel(store, failure) {
+	store.batch(() => {
+		store.setOutroData({
+			kind: "cancel",
+			message: failure.message
+		});
+		store.setRunPhase("error");
+	});
+}
 /** Service health, once per invocation, unless the host already checked it. A failure stops the run. */
 async function checkReadiness(programId, config, store, context) {
 	const known = store.session.readinessResult;
@@ -4820,7 +4874,7 @@ var WizardRunSync = class {
 				type: "local_folder",
 				project_name: projectName
 			},
-			...valid("2.80.1") ? { wizard_version: VERSION } : {},
+			...valid("2.81.0") ? { wizard_version: VERSION } : {},
 			idempotency_key: randomUUID()
 		});
 		const result = await this.request("POST", "", body, this.tasksAbort.signal);
@@ -5343,6 +5397,6 @@ function apiKeyCredentials(apiKey, options = {}) {
 	}) };
 }
 //#endregion
-export { config$7 as $, getProvisioningScopesForProgram as A, SOURCE_MAPS_CONTEXT_KEYS as B, oauthErrorFromTokenBody as C, getCommandPath as D, findProgramConfig as E, detectErrorTrackingProjects as F, detectSelfDrivingIntegrationProjects as G, NO_DEFAULT_LIMIT as H, config$2 as I, POSTHOG_PRESENT_KEY as J, GITHUB_REQUIRED_BODY as K, detectSourceMapsProjects as L, config as M, config$1 as N, getOAuthScopesForProgram as O, ERROR_TRACKING_PROJECT_PATH_KEY as P, config$6 as Q, DISPLAY_NAME as R, oauthErrorFromCallbackParams as S, Program as T, PRICING_LONG as U, config$3 as V, PRICING_SHORT as W, config$4 as X, SELF_DRIVING_INTEGRATE_PATH_KEY as Y, config$5 as Z, missingOAuthScopes as _, regionOption as _t, PostHogDestination as a, config$9 as at, buildCallbackErrorHtml as b, buildSession as c, config$12 as ct, SessionStore as d, detectTargets as dt, getAuditChecks as et, applyAgentProgress as f, findTarget as ft, getOAuthClientId as g, isHeadless as gt, OAuthTokenResponseSchema as h, headlessOption as ht, createWizardRunSync as i, getBlockingServiceKeys as it, getSubcommandPrograms as j, getProgramConfig as k, TASK_OUTCOMES_KEY as l, createSkillProgram as lt, logIn as m, installSteeringSnippet as mt, resolveApiKeyLogin as n, SIGNUP_WIZARD_READINESS_CONFIG as nt, createFileDestination as o, config$10 as ot, TaskStatus as p, installOrUpdatePostHogCli as pt, GITHUB_REQUIRED_MESSAGE as q, TaskStreamPush as r, evaluateWizardReadiness as rt, storeInteraction as s, config$11 as st, apiKeyCredentials as t, SERVICE_LABELS as tt, runProgram as u, CLI_STEERING_TARGETS as ut, parseOAuthScopes as v, PROGRAM_REGISTRY as w, buildOAuthFailureMessage as x, OAuthError as y, MANUAL_SDK_VARIANTS as z };
+export { config$7 as $, getProvisioningScopesForProgram as A, SOURCE_MAPS_CONTEXT_KEYS as B, oauthErrorFromTokenBody as C, getCommandPath as D, findProgramConfig as E, detectErrorTrackingProjects as F, detectSelfDrivingIntegrationProjects as G, NO_DEFAULT_LIMIT as H, config$2 as I, POSTHOG_PRESENT_KEY as J, GITHUB_REQUIRED_BODY as K, detectSourceMapsProjects as L, config as M, config$1 as N, getOAuthScopesForProgram as O, ERROR_TRACKING_PROJECT_PATH_KEY as P, config$6 as Q, DISPLAY_NAME as R, oauthErrorFromCallbackParams as S, Program as T, PRICING_LONG as U, config$3 as V, PRICING_SHORT as W, config$4 as X, SELF_DRIVING_INTEGRATE_PATH_KEY as Y, config$5 as Z, missingOAuthScopes as _, headlessOption as _t, PostHogDestination as a, evaluateWizardReadiness as at, buildCallbackErrorHtml as b, buildSession as c, config$10 as ct, SessionStore as d, createSkillProgram as dt, CONNECT_SLACK_SCOPE_ADDITIONS as et, applyAgentProgress as f, CLI_STEERING_TARGETS as ft, getOAuthClientId as g, installSteeringSnippet as gt, OAuthTokenResponseSchema as h, installOrUpdatePostHogCli as ht, createWizardRunSync as i, SIGNUP_WIZARD_READINESS_CONFIG as it, getSubcommandPrograms as j, getProgramConfig as k, TASK_OUTCOMES_KEY as l, config$11 as lt, logIn as m, findTarget as mt, resolveApiKeyLogin as n, getAuditChecks as nt, createFileDestination as o, getBlockingServiceKeys as ot, TaskStatus as p, detectTargets as pt, GITHUB_REQUIRED_MESSAGE as q, TaskStreamPush as r, SERVICE_LABELS as rt, storeInteraction as s, config$9 as st, apiKeyCredentials as t, withScopeAdditions as tt, runProgram as u, config$12 as ut, parseOAuthScopes as v, isHeadless as vt, PROGRAM_REGISTRY as w, buildOAuthFailureMessage as x, OAuthError as y, regionOption as yt, MANUAL_SDK_VARIANTS as z };
 
-//# sourceMappingURL=programs-SeT1qNik.js.map
+//# sourceMappingURL=programs-Ml6OLybj.js.map