@posthog/wizard 2.17.0 → 2.19.0

package/dist/{api-serd0SMY.js.map → api-Dw6_orDE.js.map}

@@ -1 +1 @@
-{"version":3,"file":"api-serd0SMY.js","names":[],"sources":["../src/lib/api.ts"],"sourcesContent":["import axios, { AxiosError } from 'axios';\nimport { z } from 'zod';\nimport { analytics } from '@utils/analytics';\nimport { WIZARD_USER_AGENT } from './constants';\n\n/**\n * User payload from `/api/users/@me/`. Schema typed for the fields the\n * wizard actually reads + passthrough on everything else so the full\n * upstream response rides through to the session for downstream features\n * (account-aware copy, plan-gated flows, org/team metadata, etc.).\n *\n * Top-level uses `.passthrough()` so unknown fields aren't stripped;\n * the few nested objects we care about (team, organization,\n * organizations[]) do the same so their additional fields survive too.\n *\n * Keep `distinct_id` required — analytics depends on it. Everything\n * else added here is nullish so partial responses don't fail parsing.\n */\nexport const ApiUserSchema = z\n  .object({\n    // Identifiers\n    distinct_id: z.string(),\n    uuid: z.string().nullish(),\n    id: z.number().nullish(),\n\n    // Profile\n    email: z.string().nullish(),\n    first_name: z.string().nullish(),\n    last_name: z.string().nullish(),\n    date_joined: z.string().nullish(),\n    is_email_verified: z.boolean().nullish(),\n    is_2fa_enabled: z.boolean().nullish(),\n    is_staff: z.boolean().nullish(),\n\n    // Preferences\n    theme_mode: z.string().nullish(),\n    toolbar_mode: z.string().nullish(),\n    hide_mcp_hints: z.boolean().nullish(),\n\n    // Optional / nullable on the backend — pre-onboarding signup paths\n    // return null and older accounts may not have it set. Treat as a\n    // hint, never a guarantee.\n    role_at_organization: z.string().nullish(),\n\n    // Current team + organization (objects from the API, kept typed on\n    // the fields the wizard uses; passthrough preserves the rest).\n    team: z\n      .object({\n        id: z.number(),\n        uuid: z.string().nullish(),\n        organization: z.string().uuid(),\n        api_token: z.string().nullish(),\n        project_id: z.number().nullish(),\n        name: z.string().nullish(),\n        timezone: z.string().nullish(),\n      })\n      .passthrough(),\n    organization: z\n      .object({\n        id: z.string().uuid(),\n        name: z.string().nullish(),\n        slug: z.string().nullish(),\n        membership_level: z.number().nullish(),\n        customer_id: z.string().nullish(),\n      })\n      .passthrough(),\n    organizations: z.array(\n      z\n        .object({\n          id: z.string().uuid(),\n          name: z.string().nullish(),\n          membership_level: z.number().nullish(),\n        })\n        .passthrough(),\n    ),\n  })\n  .passthrough();\n\n/**\n * Single activity log entry the wizard cares about. The PostHog endpoint\n * returns much more — schema kept minimal so changes upstream don't break us.\n *\n * @unused — no current caller after the Phase 6 streaming-agent pivot\n * dropped activity_log polling. Deliberately retained: this is a thin,\n * well-typed wrapper around a stable PostHog endpoint, and we're likely\n * to want it again for a future feature (e.g. \"what changed in your\n * project recently\"). Re-deriving the schema is more work than letting\n * it sit dormant.\n */\nexport const ActivityLogEntrySchema = z\n  .object({\n    scope: z.string().nullish(),\n    activity: z.string().nullish(),\n    created_at: z.string().nullish(),\n  })\n  .passthrough();\n\n/** @unused — see ActivityLogEntrySchema. */\nexport const ActivityLogResponseSchema = z.object({\n  results: z.array(ActivityLogEntrySchema),\n});\n\n/** @unused — see ActivityLogEntrySchema. */\nexport type ActivityLogEntry = z.infer<typeof ActivityLogEntrySchema>;\n\nexport const ApiProjectSchema = z.object({\n  id: z.number(),\n  uuid: z.string().uuid(),\n  organization: z.string().uuid(),\n  api_token: z.string(),\n  name: z.string(),\n});\n\nexport type ApiUser = z.infer<typeof ApiUserSchema>;\nexport type ApiProject = z.infer<typeof ApiProjectSchema>;\n\nexport class ApiError extends Error {\n  constructor(\n    message: string,\n    public readonly statusCode?: number,\n    public readonly endpoint?: string,\n  ) {\n    super(message);\n    this.name = 'ApiError';\n  }\n}\n\nexport async function fetchUserData(\n  accessToken: string,\n  baseUrl: string,\n): Promise<ApiUser> {\n  try {\n    const response = await axios.get(`${baseUrl}/api/users/@me/`, {\n      headers: {\n        Authorization: `Bearer ${accessToken}`,\n        'User-Agent': WIZARD_USER_AGENT,\n      },\n    });\n\n    return ApiUserSchema.parse(response.data);\n  } catch (error) {\n    const apiError = handleApiError(error, 'fetch user data');\n    analytics.captureException(apiError, {\n      endpoint: '/api/users/@me/',\n      baseUrl,\n    });\n    throw apiError;\n  }\n}\n\n/**\n * Best-effort fetch of recent activity log entries. Returns [] on any error\n * so callers can treat absence of results as \"haven't detected anything yet\"\n * rather than a hard failure.\n *\n * @unused — no current caller after the Phase 6 streaming-agent pivot\n * dropped activity_log polling from McpSuggestedPromptsScreen.\n * Deliberately retained for future features that want a soft signal of\n * recent project changes (e.g. dashboards, audit summaries). See the\n * ActivityLogEntrySchema doc comment for the keep-vs-delete rationale.\n */\nexport async function fetchRecentActivity(\n  accessToken: string,\n  projectId: number,\n  baseUrl: string,\n  since: Date,\n): Promise<ActivityLogEntry[]> {\n  try {\n    const response = await axios.get(\n      `${baseUrl}/api/projects/${projectId}/activity_log/`,\n      {\n        params: { limit: 10 },\n        headers: {\n          Authorization: `Bearer ${accessToken}`,\n          'User-Agent': WIZARD_USER_AGENT,\n        },\n        // Short timeout — best-effort probe, not a critical path.\n        timeout: 4000,\n      },\n    );\n    const parsed = ActivityLogResponseSchema.safeParse(response.data);\n    if (!parsed.success) return [];\n    const sinceMs = since.getTime();\n    return parsed.data.results.filter((entry) => {\n      if (!entry.created_at) return false;\n      const t = Date.parse(entry.created_at);\n      return Number.isFinite(t) && t >= sinceMs;\n    });\n  } catch {\n    return [];\n  }\n}\n\nexport async function fetchProjectData(\n  accessToken: string,\n  projectId: number,\n  baseUrl: string,\n): Promise<ApiProject> {\n  try {\n    const response = await axios.get(`${baseUrl}/api/projects/${projectId}/`, {\n      headers: {\n        Authorization: `Bearer ${accessToken}`,\n        'User-Agent': WIZARD_USER_AGENT,\n      },\n    });\n\n    return ApiProjectSchema.parse(response.data);\n  } catch (error) {\n    const apiError = handleApiError(error, 'fetch project data');\n    analytics.captureException(apiError, {\n      endpoint: `/api/projects/${projectId}/`,\n      baseUrl,\n      projectId,\n    });\n    throw apiError;\n  }\n}\n\nexport function handleApiError(error: unknown, operation: string): ApiError {\n  if (axios.isAxiosError(error)) {\n    const axiosError = error as AxiosError<{ detail?: string }>;\n    const status = axiosError.response?.status;\n    const detail = axiosError.response?.data?.detail;\n    const endpoint = axiosError.config?.url;\n\n    if (status === 401) {\n      return new ApiError(\n        `Authentication failed while trying to ${operation}`,\n        status,\n        endpoint,\n      );\n    }\n\n    if (status === 403) {\n      return new ApiError(\n        `Access denied while trying to ${operation}`,\n        status,\n        endpoint,\n      );\n    }\n\n    if (status === 404) {\n      return new ApiError(\n        `Resource not found while trying to ${operation}`,\n        status,\n        endpoint,\n      );\n    }\n\n    const message = detail || `Failed to ${operation}`;\n    return new ApiError(message, status, endpoint);\n  }\n\n  if (error instanceof z.ZodError) {\n    return new ApiError(`Invalid response format while trying to ${operation}`);\n  }\n\n  return new ApiError(\n    `Unexpected error while trying to ${operation}: ${\n      error instanceof Error ? error.message : 'Unknown error'\n    }`,\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"api-Dw6_orDE.js","names":[],"sources":["../src/lib/api.ts"],"sourcesContent":["import axios, { AxiosError } from 'axios';\nimport { z } from 'zod';\nimport { analytics } from '@utils/analytics';\nimport { WIZARD_USER_AGENT } from './constants';\n\n/**\n * User payload from `/api/users/@me/`. Schema typed for the fields the\n * wizard actually reads + passthrough on everything else so the full\n * upstream response rides through to the session for downstream features\n * (account-aware copy, plan-gated flows, org/team metadata, etc.).\n *\n * Top-level uses `.passthrough()` so unknown fields aren't stripped;\n * the few nested objects we care about (team, organization,\n * organizations[]) do the same so their additional fields survive too.\n *\n * Keep `distinct_id` required — analytics depends on it. Everything\n * else added here is nullish so partial responses don't fail parsing.\n */\nexport const ApiUserSchema = z\n  .object({\n    // Identifiers\n    distinct_id: z.string(),\n    uuid: z.string().nullish(),\n    id: z.number().nullish(),\n\n    // Profile\n    email: z.string().nullish(),\n    first_name: z.string().nullish(),\n    last_name: z.string().nullish(),\n    date_joined: z.string().nullish(),\n    is_email_verified: z.boolean().nullish(),\n    is_2fa_enabled: z.boolean().nullish(),\n    is_staff: z.boolean().nullish(),\n\n    // Preferences\n    theme_mode: z.string().nullish(),\n    toolbar_mode: z.string().nullish(),\n    hide_mcp_hints: z.boolean().nullish(),\n\n    // Optional / nullable on the backend — pre-onboarding signup paths\n    // return null and older accounts may not have it set. Treat as a\n    // hint, never a guarantee.\n    role_at_organization: z.string().nullish(),\n\n    // Current team + organization (objects from the API, kept typed on\n    // the fields the wizard uses; passthrough preserves the rest).\n    team: z\n      .object({\n        id: z.number(),\n        uuid: z.string().nullish(),\n        organization: z.string().uuid(),\n        api_token: z.string().nullish(),\n        project_id: z.number().nullish(),\n        name: z.string().nullish(),\n        timezone: z.string().nullish(),\n      })\n      .passthrough(),\n    organization: z\n      .object({\n        id: z.string().uuid(),\n        name: z.string().nullish(),\n        slug: z.string().nullish(),\n        membership_level: z.number().nullish(),\n        customer_id: z.string().nullish(),\n      })\n      .passthrough(),\n    organizations: z.array(\n      z\n        .object({\n          id: z.string().uuid(),\n          name: z.string().nullish(),\n          membership_level: z.number().nullish(),\n        })\n        .passthrough(),\n    ),\n  })\n  .passthrough();\n\n/**\n * Single activity log entry the wizard cares about. The PostHog endpoint\n * returns much more — schema kept minimal so changes upstream don't break us.\n *\n * @unused — no current caller after the Phase 6 streaming-agent pivot\n * dropped activity_log polling. Deliberately retained: this is a thin,\n * well-typed wrapper around a stable PostHog endpoint, and we're likely\n * to want it again for a future feature (e.g. \"what changed in your\n * project recently\"). Re-deriving the schema is more work than letting\n * it sit dormant.\n */\nexport const ActivityLogEntrySchema = z\n  .object({\n    scope: z.string().nullish(),\n    activity: z.string().nullish(),\n    created_at: z.string().nullish(),\n  })\n  .passthrough();\n\n/** @unused — see ActivityLogEntrySchema. */\nexport const ActivityLogResponseSchema = z.object({\n  results: z.array(ActivityLogEntrySchema),\n});\n\n/** @unused — see ActivityLogEntrySchema. */\nexport type ActivityLogEntry = z.infer<typeof ActivityLogEntrySchema>;\n\nexport const ApiProjectSchema = z.object({\n  id: z.number(),\n  uuid: z.string().uuid(),\n  organization: z.string().uuid(),\n  api_token: z.string(),\n  name: z.string(),\n});\n\nexport type ApiUser = z.infer<typeof ApiUserSchema>;\nexport type ApiProject = z.infer<typeof ApiProjectSchema>;\n\nexport class ApiError extends Error {\n  constructor(\n    message: string,\n    public readonly statusCode?: number,\n    public readonly endpoint?: string,\n  ) {\n    super(message);\n    this.name = 'ApiError';\n  }\n}\n\nexport async function fetchUserData(\n  accessToken: string,\n  baseUrl: string,\n): Promise<ApiUser> {\n  try {\n    const response = await axios.get(`${baseUrl}/api/users/@me/`, {\n      headers: {\n        Authorization: `Bearer ${accessToken}`,\n        'User-Agent': WIZARD_USER_AGENT,\n      },\n    });\n\n    return ApiUserSchema.parse(response.data);\n  } catch (error) {\n    const apiError = handleApiError(error, 'fetch user data');\n    analytics.captureException(apiError, {\n      endpoint: '/api/users/@me/',\n      baseUrl,\n    });\n    throw apiError;\n  }\n}\n\n/**\n * Best-effort fetch of recent activity log entries. Returns [] on any error\n * so callers can treat absence of results as \"haven't detected anything yet\"\n * rather than a hard failure.\n *\n * @unused — no current caller after the Phase 6 streaming-agent pivot\n * dropped activity_log polling from McpSuggestedPromptsScreen.\n * Deliberately retained for future features that want a soft signal of\n * recent project changes (e.g. dashboards, audit summaries). See the\n * ActivityLogEntrySchema doc comment for the keep-vs-delete rationale.\n */\nexport async function fetchRecentActivity(\n  accessToken: string,\n  projectId: number,\n  baseUrl: string,\n  since: Date,\n): Promise<ActivityLogEntry[]> {\n  try {\n    const response = await axios.get(\n      `${baseUrl}/api/projects/${projectId}/activity_log/`,\n      {\n        params: { limit: 10 },\n        headers: {\n          Authorization: `Bearer ${accessToken}`,\n          'User-Agent': WIZARD_USER_AGENT,\n        },\n        // Short timeout — best-effort probe, not a critical path.\n        timeout: 4000,\n      },\n    );\n    const parsed = ActivityLogResponseSchema.safeParse(response.data);\n    if (!parsed.success) return [];\n    const sinceMs = since.getTime();\n    return parsed.data.results.filter((entry) => {\n      if (!entry.created_at) return false;\n      const t = Date.parse(entry.created_at);\n      return Number.isFinite(t) && t >= sinceMs;\n    });\n  } catch {\n    return [];\n  }\n}\n\nexport async function fetchProjectData(\n  accessToken: string,\n  projectId: number,\n  baseUrl: string,\n): Promise<ApiProject> {\n  try {\n    const response = await axios.get(`${baseUrl}/api/projects/${projectId}/`, {\n      headers: {\n        Authorization: `Bearer ${accessToken}`,\n        'User-Agent': WIZARD_USER_AGENT,\n      },\n    });\n\n    return ApiProjectSchema.parse(response.data);\n  } catch (error) {\n    const apiError = handleApiError(error, 'fetch project data');\n    analytics.captureException(apiError, {\n      endpoint: `/api/projects/${projectId}/`,\n      baseUrl,\n      projectId,\n    });\n    throw apiError;\n  }\n}\n\nexport function handleApiError(error: unknown, operation: string): ApiError {\n  if (axios.isAxiosError(error)) {\n    const axiosError = error as AxiosError<{ detail?: string }>;\n    const status = axiosError.response?.status;\n    const detail = axiosError.response?.data?.detail;\n    const endpoint = axiosError.config?.url;\n\n    if (status === 401) {\n      return new ApiError(\n        `Authentication failed while trying to ${operation}`,\n        status,\n        endpoint,\n      );\n    }\n\n    if (status === 403) {\n      return new ApiError(\n        `Access denied while trying to ${operation}`,\n        status,\n        endpoint,\n      );\n    }\n\n    if (status === 404) {\n      return new ApiError(\n        `Resource not found while trying to ${operation}`,\n        status,\n        endpoint,\n      );\n    }\n\n    const message = detail || `Failed to ${operation}`;\n    return new ApiError(message, status, endpoint);\n  }\n\n  if (error instanceof z.ZodError) {\n    return new ApiError(`Invalid response format while trying to ${operation}`);\n  }\n\n  return new ApiError(\n    `Unexpected error while trying to ${operation}: ${\n      error instanceof Error ? error.message : 'Unknown error'\n    }`,\n  );\n}\n"],"mappings":"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"}

package/dist/bin.js

@@ -1,17 +1,16 @@
 #!/usr/bin/env node
-import { J as VERSION, M as POSTHOG_DOCS_URL, W as WIZARD_USER_AGENT, X as runtimeEnv, _ as SIGNUP_WIZARD_READINESS_CONFIG, h as LoggingUI, m as setUI, p as getUI, s as logToFile, v as evaluateWizardReadiness, y as getBlockingServiceKeys } from "./debug-Bx7nvCWW.js";
-import { t as analytics } from "./analytics-DN_Gy87F.js";
-import { n as isUsingTypeScript } from "./setup-utils-Bpfsap9L.js";
-import { a as getUiHostFromHost, n as getCloudUrlFromRegion } from "./urls-CTCJIxbR.js";
-import { a as handleApiError } from "./api-serd0SMY.js";
+import { J as VERSION, M as POSTHOG_DOCS_URL, W as WIZARD_USER_AGENT, _ as SIGNUP_WIZARD_READINESS_CONFIG, a as getLogFilePath, h as LoggingUI, m as setUI, p as getUI, s as logToFile, v as evaluateWizardReadiness, y as getBlockingServiceKeys } from "./debug-DnMO6O8O.js";
+import { t as analytics } from "./analytics-Df-Xb81i.js";
+import { n as isUsingTypeScript } from "./setup-utils-DetnhXo0.js";
+import { a as getUiHostFromHost, n as getCloudUrlFromRegion } from "./urls-BO7doNJG.js";
+import { a as handleApiError } from "./api-Dw6_orDE.js";
 import "./wizard-session-d27JGRGi.js";
-import { n as isNonInteractiveEnvironment } from "./environment-CiZVSSYt.js";
-import { _ as AUDIT_REPORT_FILE, d as WIZARD_TOOL_NAMES, g as AUDIT_CHECKS_KEY, h as AUDIT_CHECKS_FILE, t as AgentSignals } from "./agent-interface-7t5DBo2A.js";
-import { i as SPINNER_MESSAGE } from "./registry-B9k73FKR.js";
-import { a as PRODUCT_SUITE_BLOCK, i as LINE_CHART_BLOCK, n as posthogIntegrationConfig, o as StatusPeekTrigger, r as FUNNEL_BLOCK } from "./posthog-integration-Bv7987YJ.js";
-import { c as HEALTH_CHECK_STEP, o as Colors, r as isClearBlock } from "./TextBlock-D0Ep3zC9.js";
-import { t as IGNORED_DIRS } from "./file-utils-Dy9JncCo.js";
-import { n as readApiKeyFromEnv } from "./env-api-key-B3gE9Un0.js";
+import { n as isNonInteractiveEnvironment } from "./environment-Ls0H9ljT.js";
+import { _ as AUDIT_REPORT_FILE, c as AgentSignals, d as WIZARD_TOOL_NAMES, g as AUDIT_CHECKS_KEY, h as AUDIT_CHECKS_FILE } from "./agent-interface-CQU6x4Hj.js";
+import { i as SPINNER_MESSAGE } from "./registry-hBUgaWFx.js";
+import { a as PRODUCT_SUITE_BLOCK, f as Colors, i as LINE_CHART_BLOCK, l as isClearBlock, m as HEALTH_CHECK_STEP, n as posthogIntegrationConfig, o as StatusPeekTrigger, r as FUNNEL_BLOCK } from "./posthog-integration-C8qhJnI3.js";
+import { t as IGNORED_DIRS } from "./file-utils-VAXoyXVA.js";
+import { n as readApiKeyFromEnv } from "./env-api-key-MlzJYAvt.js";
 import { satisfies } from "semver";
 import yargs from "yargs";
 import { hideBin } from "yargs/helpers";
@@ -161,7 +160,7 @@ function runProvision(argv) {
 }
 async function provision({ email, region, name, jsonMode }) {
 	try {
-		const { provisionNewAccount } = await import("./provisioning-C96Kw-9D.js").then((n) => n.n);
+		const { provisionNewAccount } = await import("./provisioning-C-2ExcqY.js").then((n) => n.n);
 		if (!jsonMode) getUI().log.info(`Provisioning account for ${email} in ${region}...`);
 		emitResult(await provisionNewAccount(email, name, region), jsonMode);
 		process.exit(0);
@@ -223,49 +222,36 @@ const basicIntegrationCommand = {
 			type: "boolean",
 			hidden: true
 		},
-		skill: {
-			describe: "Run a specific context-mill skill by ID\nenv: POSTHOG_WIZARD_SKILL",
-			type: "string"
-		},
 		name: {
 			describe: "Name for account creation with --ci --signup\nenv: POSTHOG_WIZARD_NAME",
 			type: "string"
 		}
 	},
 	check: (argv) => {
-		if (argv.playground && (argv.ci || argv.skill)) throw new Error("--playground cannot be combined with --ci or --skill.");
-		if (typeof argv.skill === "string" && argv.skill.trim() === "") throw new Error("--skill needs a skill ID, e.g. --skill=\"foo\"");
+		if (argv.playground && argv.ci) throw new Error("--playground cannot be combined with --ci.");
 		return true;
 	},
 	handler: (argv) => {
 		(async () => {
-			if (argv.ci && argv.skill) {
-				const { runSkillMode } = await import("./skill-CPqcV8zp.js");
-				return runSkillMode(argv);
-			}
 			if (argv.ci) {
-				const { runCIInstall } = await import("./ci-install-BbJ7c3WK.js");
+				const { runCIInstall } = await import("./ci-install-BKAvFfK6.js");
 				return runCIInstall(argv);
 			}
 			if (isNonInteractiveEnvironment()) {
-				const { failNonInteractive } = await import("./non-interactive-DTaZnVq_.js");
+				const { failNonInteractive } = await import("./non-interactive-DcFLJtl_.js");
 				return failNonInteractive();
 			}
 			if (argv.playground) {
-				const { runPlayground } = await import("./playground-CR81Mwe3.js");
+				const { runPlayground } = await import("./playground-BZ0hGjbL.js");
 				return runPlayground();
 			}
-			if (argv.skill) {
-				const { runSkillMode } = await import("./skill-CPqcV8zp.js");
-				return runSkillMode(argv);
-			}
-			const { runInteractive } = await import("./interactive-BwIzklw0.js");
+			const { runInteractive } = await import("./interactive-D15byhpc.js");
 			runInteractive(argv);
 		})();
 	}
 };
 //#endregion
-//#region src/lib/programs/revenue-analytics/detect.ts
+//#region src/lib/programs/shared/package-scanning.ts
 const POSTHOG_SDKS$1 = [
 	"posthog-js",
 	"posthog-node",
@@ -278,18 +264,6 @@ const STRIPE_SDKS = [
 	"@stripe/stripe-js",
 	"@stripe/react-stripe-js"
 ];
-/** `[ABORT] <reason>` cases the revenue analytics skill can emit. */
-const REVENUE_ABORT_CASES = [{
-	match: /^could not find a posthog distinct_id$/i,
-	message: "Could not find a PostHog distinct_id",
-	body: "The agent could not find PostHog distinct_id usage in your codebase. Your users must be identified in PostHog before they can be tagged in Stripe. Please identify your users and try again.",
-	docsUrl: "https://posthog.com/docs/product-analytics/identify"
-}, {
-	match: /^could not find a stripe integration$/i,
-	message: "Could not find a Stripe integration",
-	body: "The Wizard could not find an existing Stripe customer, charge, subscription, or other Stripe operations. Please run the Revenue Analytics Wizard on a project with an existing Stripe integration.",
-	docsUrl: "https://posthog.com/docs/revenue-analytics"
-}];
 /**
 * Recursively find all package.json files under installDir (max depth 3),
 * skipping common ignored directories. Returns matches with detected SDKs.
@@ -325,6 +299,26 @@ function findPackageJsons(installDir, maxDepth = 3) {
 	scan(installDir, 0);
 	return matches;
 }
+//#endregion
+//#region src/lib/programs/revenue-analytics/detect.ts
+/**
+* Revenue analytics prerequisite detection.
+*
+* Scans the project for PostHog + Stripe SDKs and writes results
+* into frameworkContext for the intro screen to render.
+*/
+/** `[ABORT] <reason>` cases the revenue analytics skill can emit. */
+const REVENUE_ABORT_CASES = [{
+	match: /^could not find a posthog distinct_id$/i,
+	message: "Could not find a PostHog distinct_id",
+	body: "The agent could not find PostHog distinct_id usage in your codebase. Your users must be identified in PostHog before they can be tagged in Stripe. Please identify your users and try again.",
+	docsUrl: "https://posthog.com/docs/product-analytics/identify"
+}, {
+	match: /^could not find a stripe integration$/i,
+	message: "Could not find a Stripe integration",
+	body: "The Wizard could not find an existing Stripe customer, charge, subscription, or other Stripe operations. Please run the Revenue Analytics Wizard on a project with an existing Stripe integration.",
+	docsUrl: "https://posthog.com/docs/revenue-analytics"
+}];
 /**
 * Scan `session.installDir` for PostHog + Stripe SDKs. Writes detection
 * results into frameworkContext via the callback — either the detected
@@ -831,7 +825,7 @@ const EVENTS_AUDIT_SEED_CHECKS = [
 //#endregion
 //#region src/lib/programs/events-audit/index.ts
 const SETUP_REPORT_FILE = "posthog-events-audit-report.md";
-const DOCS_URL$1 = "https://posthog.com/docs/product-analytics/best-practices";
+const DOCS_URL$2 = "https://posthog.com/docs/product-analytics/best-practices";
 const eventsAuditConfig = {
 	command: "events-audit",
 	description: "Audit PostHog event tracking in this project",
@@ -853,7 +847,7 @@ const eventsAuditConfig = {
 			successMessage: "Events audit complete! You can view the report at ./posthog-events-audit-report.md",
 			estimatedDurationMinutes: 5,
 			reportFile: SETUP_REPORT_FILE,
-			docsUrl: DOCS_URL$1,
+			docsUrl: DOCS_URL$2,
 			errorMessage: "Events audit failed",
 			additionalFeatureQueue: session.additionalFeatureQueue,
 			customPrompt: (ctx) => `Audit PostHog event capture in this project. Do not modify any project files — produce a read-only report only.
@@ -871,7 +865,7 @@ Project context:
 					message: "Your events audit was successful",
 					reportFile: SETUP_REPORT_FILE,
 					changes: [],
-					docsUrl: DOCS_URL$1,
+					docsUrl: DOCS_URL$2,
 					continueUrl: sess.signup && cloudUrl ? `${cloudUrl}/products?source=wizard` : void 0,
 					dashboardUrl: sess.dashboardUrl ?? (cloudUrl ? `${cloudUrl}/dashboard` : void 0),
 					notebookUrl: sess.notebookUrl ?? void 0
@@ -1236,6 +1230,97 @@ const posthogDoctorConfig = {
 	disallowedTools: [WIZARD_TOOL_NAMES.wizardAsk]
 };
 //#endregion
+//#region src/lib/programs/web-analytics-doctor/detect.ts
+const WEB_ANALYTICS_ABORT_CASES = [
+	{
+		match: /^no web analytics events$/i,
+		message: "No web analytics events",
+		body: "The doctor found no $pageview events in the last 30 days, so there is nothing to audit yet. Make sure PostHog is initialized and capturing pageviews, then run the doctor again.",
+		docsUrl: "https://posthog.com/docs/web-analytics/getting-started"
+	},
+	{
+		match: /^insufficient permissions$/i,
+		message: "Insufficient permissions",
+		body: "The doctor could not query your project — the authenticated token is missing query access. Re-run the wizard to sign in again, or use a key with read access to your events.",
+		docsUrl: "https://posthog.com/docs/web-analytics"
+	},
+	{
+		match: /^posthog sdk not installed$/i,
+		message: "PostHog SDK not installed",
+		body: "The doctor could not find a PostHog SDK in this project. Install and configure PostHog first (run `npx @posthog/wizard`), then run the doctor to check your web analytics setup.",
+		docsUrl: "https://posthog.com/docs/libraries/js"
+	}
+];
+function detectWebAnalyticsPrerequisites(session, setFrameworkContext) {
+	const fail = (error) => setFrameworkContext("detectError", error);
+	const installDir = session.installDir;
+	if (!existsSync(installDir)) {
+		fail({
+			kind: "bad-directory",
+			path: installDir,
+			reason: "missing"
+		});
+		return;
+	}
+	try {
+		if (!statSync(installDir).isDirectory()) {
+			fail({
+				kind: "bad-directory",
+				path: installDir,
+				reason: "not-dir"
+			});
+			return;
+		}
+	} catch {
+		fail({
+			kind: "bad-directory",
+			path: installDir,
+			reason: "unreadable"
+		});
+		return;
+	}
+	const matches = findPackageJsons(installDir);
+	if (matches.length === 0) {
+		fail({ kind: "no-package-json" });
+		return;
+	}
+	const sdks = [...new Set(matches.flatMap((m) => m.posthogSdks))];
+	if (sdks.length === 0) {
+		fail({
+			kind: "no-posthog",
+			scannedCount: matches.length
+		});
+		return;
+	}
+	setFrameworkContext("detectedPosthogSdks", sdks);
+}
+//#endregion
+//#region src/lib/programs/web-analytics-doctor/steps.ts
+const WEB_ANALYTICS_DOCTOR_PROGRAM = [{
+	id: "detect",
+	label: "Detecting prerequisites",
+	onReady: (ctx) => detectWebAnalyticsPrerequisites(ctx.session, ctx.setFrameworkContext)
+}, ...AGENT_SKILL_STEPS];
+const webAnalyticsDoctorConfig = {
+	...createSkillProgram({
+		skillId: "web-analytics-doctor",
+		command: "web-analytics",
+		id: "web-analytics-doctor",
+		description: "Audit and fix your PostHog web analytics setup",
+		integrationLabel: "web-analytics-doctor",
+		customPrompt: "Run the web-analytics-doctor skill to check this project's PostHog web analytics setup. Audit read-only first, then present the findings to the user with a single wizard_ask multi-select and apply only the fixes they choose — editing project code and/or PostHog project settings via the MCP — before writing the report.",
+		successMessage: "Web analytics check complete! You can view the report at ./posthog-web-analytics-report.md",
+		reportFile: "posthog-web-analytics-report.md",
+		docsUrl: "https://posthog.com/docs/web-analytics",
+		spinnerMessage: "Checking your web analytics setup...",
+		estimatedDurationMinutes: 5,
+		requires: ["posthog-integration"],
+		abortCases: WEB_ANALYTICS_ABORT_CASES
+	}),
+	steps: WEB_ANALYTICS_DOCTOR_PROGRAM,
+	parentCommand: "audit"
+};
+//#endregion
 //#region src/lib/programs/migration/steps.ts
 const MIGRATION_PROGRAM = [
 	{
@@ -2627,6 +2712,7 @@ const PROGRAM_REGISTRY = [
 	eventsAuditConfig,
 	audit3000Config,
 	posthogDoctorConfig,
+	webAnalyticsDoctorConfig,
 	migrationConfig,
 	agentSkillConfig,
 	mcpAddConfig,
@@ -2647,6 +2733,7 @@ const Program = {
 	EventsAudit: eventsAuditConfig.id,
 	Audit3000: audit3000Config.id,
 	PosthogDoctor: posthogDoctorConfig.id,
+	WebAnalyticsDoctor: webAnalyticsDoctorConfig.id,
 	AgentSkill: agentSkillConfig.id,
 	McpAdd: mcpAddConfig.id,
 	McpRemove: mcpRemoveConfig.id,
@@ -2685,12 +2772,12 @@ const mcpAddCommand = {
 function runMcpAdd(argv) {
 	const features = parseFeatures(argv.features);
 	(async () => {
-		const { readApiKeyFromEnv } = await import("./env-api-key-B3gE9Un0.js").then((n) => n.t);
+		const { readApiKeyFromEnv } = await import("./env-api-key-MlzJYAvt.js").then((n) => n.t);
 		const apiKey = argv.apiKey || readApiKeyFromEnv();
 		const debug = argv.debug;
 		const localMcp = argv.local;
 		try {
-			const { startTUI } = await import("./start-tui-BZ7rEf3e.js");
+			const { startTUI } = await import("./start-tui-BfXoErKg.js");
 			const { buildSession } = await import("./wizard-session-y304gEEI.js");
 			const tui = startTUI(VERSION, Program.McpAdd);
 			tui.store.session = buildSession({
@@ -2702,7 +2789,7 @@ function runMcpAdd(argv) {
 		} catch (error) {
 			if (!isTUIUnavailable(error)) throw error;
 			setUI(new LoggingUI());
-			const { addMCPServerToClientsStep } = await import("./add-mcp-server-to-clients-D4PK6ulR.js").then((n) => n.r);
+			const { addMCPServerToClientsStep } = await import("./add-mcp-server-to-clients-CjnvTVj0.js").then((n) => n.r);
 			await addMCPServerToClientsStep({
 				local: localMcp,
 				features,
@@ -2741,7 +2828,7 @@ function runMcpRemove(argv) {
 		const debug = argv.debug;
 		const localMcp = argv.local;
 		try {
-			const { startTUI } = await import("./start-tui-BZ7rEf3e.js");
+			const { startTUI } = await import("./start-tui-BfXoErKg.js");
 			const { buildSession } = await import("./wizard-session-y304gEEI.js");
 			const tui = startTUI(VERSION, Program.McpRemove);
 			tui.store.session = buildSession({
@@ -2750,7 +2837,7 @@ function runMcpRemove(argv) {
 			});
 		} catch {
 			setUI(new LoggingUI());
-			const { removeMCPServerFromClientsStep } = await import("./add-mcp-server-to-clients-D4PK6ulR.js").then((n) => n.r);
+			const { removeMCPServerFromClientsStep } = await import("./add-mcp-server-to-clients-CjnvTVj0.js").then((n) => n.r);
 			await removeMCPServerFromClientsStep({ local: localMcp });
 		}
 	})();
@@ -2772,7 +2859,7 @@ function runMcpTutorial(argv) {
 		const debug = argv.debug;
 		const localMcp = argv.local;
 		try {
-			const { startTUI } = await import("./start-tui-BZ7rEf3e.js");
+			const { startTUI } = await import("./start-tui-BfXoErKg.js");
 			const { buildSession } = await import("./wizard-session-y304gEEI.js");
 			const tui = startTUI(VERSION, Program.McpTutorial);
 			tui.store.session = buildSession({
@@ -2827,11 +2914,10 @@ function runWizard(config, options) {
 	(async () => {
 		try {
 			const installDir = options.installDir || process.cwd();
-			const { startTUI } = await import("./start-tui-BZ7rEf3e.js");
+			const { startTUI } = await import("./start-tui-BfXoErKg.js");
 			const { buildSession, RunPhase } = await import("./wizard-session-y304gEEI.js");
-			const { TaskStreamPush } = await import("./task-stream-BI8rJg9H.js");
-			const { PostHogDestination } = await import("./posthog-BrLFkaji.js");
-			const { logToFile } = await import("./debug-BI-Js0PB.js");
+			const { TaskStreamPush } = await import("./task-stream-CZRj6auI.js");
+			const { PostHogDestination } = await import("./posthog-Cr37rnla.js");
 			tui = startTUI(WIZARD_VERSION, config.id);
 			const activeTui = tui;
 			const session = buildSession({
@@ -2867,8 +2953,9 @@ function runWizard(config, options) {
 			onSignal = () => {
 				if (signalled || exitInProgress) return;
 				signalled = true;
+				logToFile("[run-wizard] signal received, flushing task stream");
 				if (activeTui.store.session.runPhase === RunPhase.Running) activeTui.store.setRunPhase(RunPhase.Error);
-				activeStream.shutdown(2e3).finally(() => {
+				activeStream.shutdown(2e3).catch((e) => logToFile("[run-wizard] task stream shutdown error on signal:", e)).finally(() => {
 					try {
 						activeTui.unmount();
 					} catch {}
@@ -2882,12 +2969,13 @@ function runWizard(config, options) {
 			await activeTui.store.getGate("health-check");
 			const skipAgent = config.run == null;
 			if (skipAgent) {
-				const { getOrAskForProjectData } = await import("./setup-utils-Bpfsap9L.js").then((n) => n.r);
+				const { getOrAskForProjectData } = await import("./setup-utils-DetnhXo0.js").then((n) => n.r);
 				const { projectApiKey, host, accessToken, projectId } = await getOrAskForProjectData({
 					signup: session.signup,
 					ci: session.ci,
 					apiKey: session.apiKey,
-					projectId: session.projectId
+					projectId: session.projectId,
+					programId: config.id
 				});
 				activeTui.store.setCredentials({
 					accessToken,
@@ -2896,7 +2984,7 @@ function runWizard(config, options) {
 					projectId
 				});
 			} else {
-				const { runAgent } = await import("./agent-runner-CTkKLVhp.js");
+				const { runAgent } = await import("./agent-runner-Cj7saDkL.js");
 				await runAgent(config, activeTui.store.session);
 			}
 			const isDone = () => skipAgent ? activeTui.store.session.outroDismissed : activeTui.store.session.skillsComplete;
@@ -2919,7 +3007,7 @@ function runWizard(config, options) {
 			activeTui.unmount();
 			process.exit(0);
 		} catch (err) {
-			if (runtimeEnv("DEBUG") || runtimeEnv("POSTHOG_WIZARD_DEBUG")) console.error("TUI init failed:", err);
+			logToFile("[run-wizard] FATAL:", err);
 			exitInProgress = true;
 			if (onSignal) {
 				process.off("SIGINT", onSignal);
@@ -2931,6 +3019,8 @@ function runWizard(config, options) {
 			if (tui) try {
 				tui.unmount();
 			} catch {}
+			console.error("Wizard run failed:", err);
+			console.error(`Full logs: ${getLogFilePath()}`);
 			process.exit(1);
 		}
 	})();
@@ -2969,10 +3059,10 @@ function runWizardCI(config, options) {
 	(async () => {
 		const path = await import("path");
 		const { buildSession } = await import("./wizard-session-y304gEEI.js");
-		const { readEnvironment } = await import("./environment-CiZVSSYt.js").then((n) => n.t);
-		const { readApiKeyFromEnv } = await import("./env-api-key-B3gE9Un0.js").then((n) => n.t);
-		const { configureLogFileFromEnvironment, logToFile } = await import("./debug-BI-Js0PB.js");
-		const { wizardAbort, WizardError } = await import("./wizard-abort-QdRxGQp_.js");
+		const { readEnvironment } = await import("./environment-Ls0H9ljT.js").then((n) => n.t);
+		const { readApiKeyFromEnv } = await import("./env-api-key-MlzJYAvt.js").then((n) => n.t);
+		const { configureLogFileFromEnvironment, logToFile } = await import("./debug-Cp_wNn8i.js");
+		const { wizardAbort, WizardError } = await import("./wizard-abort-CtMY57ZE.js");
 		configureLogFileFromEnvironment();
 		const env = readEnvironment();
 		const apiKey = options.apiKey ?? readApiKeyFromEnv() ?? void 0;
@@ -3020,7 +3110,7 @@ function runWizardCI(config, options) {
 					})
 				});
 			}
-			const { runAgent } = await import("./agent-runner-CTkKLVhp.js");
+			const { runAgent } = await import("./agent-runner-Cj7saDkL.js");
 			await runAgent(config, session);
 		} catch (error) {
 			const errorMessage = error instanceof Error ? error.message : String(error);
@@ -3088,21 +3178,36 @@ const integrateCommand = {
 };
 //#endregion
 //#region src/commands/audit.ts
+const dispatchProgram = (config, argv) => {
+	const extras = config.mapCliOptions?.(argv) ?? {};
+	const options = {
+		...argv,
+		...extras
+	};
+	if (options.ci) runWizardCI(config, options);
+	else runWizard(config, options);
+};
+const webAnalyticsCommand = {
+	name: webAnalyticsDoctorConfig.command,
+	description: webAnalyticsDoctorConfig.description,
+	options: {
+		...skillProgramOptions,
+		...webAnalyticsDoctorConfig.cliOptions ?? {}
+	},
+	handler: (argv) => {
+		dispatchProgram(webAnalyticsDoctorConfig, argv);
+	}
+};
 const auditCommand = {
 	name: "audit",
 	description: auditConfig.description,
+	children: [webAnalyticsCommand],
 	options: {
 		...skillProgramOptions,
 		...auditConfig.cliOptions ?? {}
 	},
 	handler: (argv) => {
-		const extras = auditConfig.mapCliOptions?.(argv) ?? {};
-		const options = {
-			...argv,
-			...extras
-		};
-		if (options.ci) runWizardCI(auditConfig, options);
-		else runWizard(auditConfig, options);
+		dispatchProgram(auditConfig, argv);
 	}
 };
 //#endregion
@@ -3159,7 +3264,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-Bpfsap9L.js").then((n) => n.r);
+		const { getOrAskForProjectData } = await import("./setup-utils-DetnhXo0.js").then((n) => n.r);
 		const { host, accessToken, projectId } = await getOrAskForProjectData({
 			signup: false,
 			ci: true,
@@ -3176,7 +3281,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-serd0SMY.js").then((n) => n.n);
+		const { ApiError } = await import("./api-Dw6_orDE.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);
@@ -3242,7 +3347,7 @@ const revenueCommand = {
 //#endregion
 //#region src/commands/upload-sourcemaps.ts
 const uploadSourcemapsCommand = {
-	name: "upload-sourcemaps",
+	name: [errorTrackingUploadSourceMapsConfig.command, "upload-sourcemaps"],
 	description: errorTrackingUploadSourceMapsConfig.description,
 	options: {
 		...skillProgramOptions,
@@ -3259,14 +3364,66 @@ const uploadSourcemapsCommand = {
 	}
 };
 //#endregion
+//#region src/commands/basic-integration/skill.ts
+/** Run an arbitrary context-mill skill by id (`wizard skill <id>`, headless with `--ci`). */
+function runSkillMode(argv) {
+	const skillId = argv.skill;
+	const config = createSkillProgram({
+		skillId,
+		command: "skill",
+		id: "agent-skill",
+		description: `Run skill: ${skillId}`,
+		integrationLabel: skillId,
+		successMessage: `${skillId} completed!`,
+		reportFile: `posthog-${skillId}-report.md`,
+		docsUrl: POSTHOG_DOCS_URL,
+		spinnerMessage: `Running ${skillId}...`,
+		estimatedDurationMinutes: 5
+	});
+	const options = {
+		...argv,
+		skillId
+	};
+	if (argv.ci) runWizardCI(config, options);
+	else runWizard(config, options);
+}
+//#endregion
+//#region src/commands/skill.ts
+/** Read the `<skill-name>` positional (yargs camelCases the hyphenated key). */
+function readSkillName(argv) {
+	return String(argv.skillName ?? argv["skill-name"] ?? "").trim();
+}
+/**
+* `wizard skill <skill-name>` — run a single context-mill skill by id.
+*
+* Replaces the old `--skill=<id>` flag on the default command. The skill id
+* is fetched from context-mill's release at runtime (same mechanism the flag
+* used), so any published skill id works. Pass `--ci` to run headlessly.
+*/
+const skillCommand = {
+	name: "skill <skill-name>",
+	description: "Run a specific context-mill skill by name",
+	options: { ...skillProgramOptions },
+	check: (argv) => {
+		if (!readSkillName(argv)) throw new Error("skill needs a skill name, e.g. `wizard skill audit-events`");
+		return true;
+	},
+	handler: (argv) => {
+		runSkillMode({
+			...argv,
+			skill: readSkillName(argv)
+		});
+	}
+};
+//#endregion
 //#region bin.ts
 const NODE_VERSION_RANGE = ">=18.17.0";
 if (!satisfies(process.version, NODE_VERSION_RANGE)) {
 	console.log(`PostHog wizard requires Node.js ${NODE_VERSION_RANGE}. You are using Node.js ${process.version}. Please upgrade your Node.js version.`);
 	process.exit(1);
 }
-Wizard.use(basicIntegrationCommand).use(mcpCommand).use(integrateCommand).use(auditCommand).use(audit3000Command).use(doctorCommand).use(migrateCommand).use(eventsAuditCommand).use(revenueCommand).use(uploadSourcemapsCommand).init();
+Wizard.use(basicIntegrationCommand).use(mcpCommand).use(integrateCommand).use(auditCommand).use(audit3000Command).use(doctorCommand).use(migrateCommand).use(eventsAuditCommand).use(revenueCommand).use(uploadSourcemapsCommand).use(skillCommand).init();
 //#endregion
-export { getProgramConfig as a, getContentBlocks$1 as c, createSkillProgram as d, getContentBlocks$2 as f, Program as i, getKindMeta as l, STRIPE_SDKS as m, runWizard as n, DISPLAY_NAME as o, POSTHOG_SDKS$1 as p, PROGRAM_REGISTRY as r, SOURCE_MAPS_CONTEXT_KEYS as s, runWizardCI as t, fetchHealthIssues as u };
+export { getProgramConfig as a, getContentBlocks$1 as c, getContentBlocks$2 as d, POSTHOG_SDKS$1 as f, Program as i, getKindMeta as l, runWizard as n, DISPLAY_NAME as o, STRIPE_SDKS as p, PROGRAM_REGISTRY as r, SOURCE_MAPS_CONTEXT_KEYS as s, runWizardCI as t, fetchHealthIssues as u };
 
 //# sourceMappingURL=bin.js.map