@posthog/wizard 2.11.0 → 2.12.0

package/dist/bin.js

@@ -1,16 +1,17 @@
 #!/usr/bin/env node
 import { t as __exportAll } from "./rolldown-runtime-B_-DWIq7.js";
-import { c as getUI, f as runtimeEnv, l as setUI, p as red, u as LoggingUI } from "./debug-gWEjmYVV.js";
-import { C as WIZARD_USER_AGENT, D as VERSION, n as analytics, p as POSTHOG_DOCS_URL } from "./analytics-D3rY3TaN.js";
-import { u as handleApiError } from "./setup-utils-y4s-3uKT.js";
-import { t as posthogIntegrationConfig } from "./posthog-integration-D4SRhJIQ.js";
-import { t as IGNORED_DIRS } from "./file-utils-Dy9JncCo.js";
+import { D as POSTHOG_DOCS_URL, G as VERSION, K as red, W as runtimeEnv, c as getUI, l as setUI, s as logToFile, u as LoggingUI, z as WIZARD_USER_AGENT } from "./debug-Bkaqv1ab.js";
+import { n as analytics } from "./analytics-DmD31Ssc.js";
+import { u as handleApiError } from "./setup-utils-Bv8z6HMb.js";
+import { h as AUDIT_REPORT_FILE, m as AUDIT_CHECKS_KEY, p as AUDIT_CHECKS_FILE } from "./agent-interface-D5W9BAB2.js";
+import { n as posthogIntegrationConfig } from "./posthog-integration-DX77Msto.js";
+import { t as IGNORED_DIRS } from "./file-utils-DnTSiTJw.js";
 import { satisfies } from "semver";
 import yargs from "yargs";
 import { hideBin } from "yargs/helpers";
 import readEnvModule from "read-env";
-import { existsSync, readFileSync, readdirSync, statSync } from "fs";
-import { join, relative } from "path";
+import fs, { existsSync, readFileSync, readdirSync, statSync } from "fs";
+import path, { join, relative } from "path";
 import axios from "axios";
 import { z } from "zod";
 import "fast-glob";
@@ -217,6 +218,191 @@ const revenueAnalyticsConfig = {
 	requires: ["posthog-integration"]
 };
 //#endregion
+//#region src/lib/workflows/agent-skill/steps.ts
+const AGENT_SKILL_STEPS = [
+	{
+		id: "intro",
+		label: "Welcome",
+		screen: "agent-skill-intro",
+		gate: (session) => session.setupConfirmed
+	},
+	{
+		id: "auth",
+		label: "Authentication",
+		screen: "auth",
+		isComplete: (session) => session.credentials !== null
+	},
+	{
+		id: "run",
+		label: "Running",
+		screen: "run",
+		isComplete: (session) => session.runPhase === "completed" || session.runPhase === "error"
+	},
+	{
+		id: "outro",
+		label: "Done",
+		screen: "outro",
+		isComplete: (session) => session.outroDismissed
+	},
+	{
+		id: "skills",
+		label: "Skills",
+		screen: "keep-skills"
+	}
+];
+//#endregion
+//#region src/lib/workflows/agent-skill/index.ts
+var agent_skill_exports = /* @__PURE__ */ __exportAll({ createSkillWorkflow: () => createSkillWorkflow });
+function createSkillWorkflow(opts) {
+	return {
+		command: opts.command,
+		description: opts.description,
+		flowKey: opts.flowKey,
+		steps: AGENT_SKILL_STEPS,
+		run: {
+			skillId: opts.skillId,
+			integrationLabel: opts.integrationLabel,
+			customPrompt: opts.customPrompt ? () => opts.customPrompt : void 0,
+			successMessage: opts.successMessage,
+			reportFile: opts.reportFile,
+			docsUrl: opts.docsUrl,
+			spinnerMessage: opts.spinnerMessage,
+			estimatedDurationMinutes: opts.estimatedDurationMinutes,
+			buildOutroData: opts.buildOutroData,
+			abortCases: opts.abortCases
+		},
+		requires: opts.requires
+	};
+}
+//#endregion
+//#region src/lib/workflows/audit/detect.ts
+/** `[ABORT] <reason>` cases the audit skill can emit. Reason strings are
+*  defined in the skill's `Abort statuses` section. */
+const AUDIT_ABORT_CASES = [{
+	match: /^no posthog sdk found$/i,
+	message: "No PostHog SDK found",
+	body: "The audit needs an existing PostHog integration to review. No PostHog SDK appears in this project’s dependency manifests. Run the basic integration workflow to install PostHog first, then re-run the audit.",
+	docsUrl: "https://posthog.com/docs/getting-started/install"
+}];
+//#endregion
+//#region src/lib/workflows/audit/seed.ts
+/** The 10 data-integrity checks the audit runs. */
+const AUDIT_SEED_CHECKS = [
+	{
+		id: "sdk-installed",
+		area: "Installation",
+		label: "PostHog SDK installed",
+		status: "pending"
+	},
+	{
+		id: "sdk-up-to-date",
+		area: "Installation",
+		label: "SDK version up to date",
+		status: "pending"
+	},
+	{
+		id: "init-correct",
+		area: "Installation",
+		label: "Initialization is correct",
+		status: "pending"
+	},
+	{
+		id: "identify-stable-distinct-id",
+		area: "Identification",
+		label: "Stable distinct_id (not session UUID)",
+		status: "pending"
+	},
+	{
+		id: "identify-not-late",
+		area: "Identification",
+		label: "identify() called before captures / flag evals",
+		status: "pending"
+	},
+	{
+		id: "cross-runtime-distinct-id",
+		area: "Identification",
+		label: "Same distinct_id across client and server",
+		status: "pending"
+	},
+	{
+		id: "identify-reset-on-logout",
+		area: "Identification",
+		label: "reset() called on logout / account switch",
+		status: "pending"
+	},
+	{
+		id: "capture-event-names-static",
+		area: "Event Capture",
+		label: "Event names are static and consistent",
+		status: "pending"
+	},
+	{
+		id: "capture-uses-proxy",
+		area: "Event Capture",
+		label: "Captures route through a reverse proxy",
+		status: "pending"
+	},
+	{
+		id: "capture-growth-events",
+		area: "Event Capture",
+		label: "Key activation events captured",
+		status: "pending"
+	}
+];
+/** Atomically write the seeded ledger to the project's audit checks file. */
+function seedAuditLedger(installDir) {
+	const target = path.join(installDir, AUDIT_CHECKS_FILE);
+	const tmp = `${target}.tmp`;
+	fs.writeFileSync(tmp, JSON.stringify(AUDIT_SEED_CHECKS, null, 2), "utf8");
+	fs.renameSync(tmp, target);
+	logToFile(`seedAuditLedger: wrote ${AUDIT_SEED_CHECKS.length} entries to ${target}`);
+}
+//#endregion
+//#region src/lib/workflows/audit/index.ts
+/** Audit-specific screens for the shared agent-skill pipeline. */
+const AUDIT_SCREEN_BY_STEP = {
+	intro: "audit-intro",
+	run: "audit-run",
+	outro: "audit-outro"
+};
+const seedBeforeAuditRun = (session) => {
+	seedAuditLedger(session.installDir);
+	session.frameworkContext[AUDIT_CHECKS_KEY] = AUDIT_SEED_CHECKS;
+};
+const withAuditScreens = (steps) => steps.map((step) => {
+	const override = AUDIT_SCREEN_BY_STEP[step.id];
+	return override ? {
+		...step,
+		screen: override
+	} : step;
+});
+const auditSteps = withAuditScreens(AGENT_SKILL_STEPS);
+const baseConfig = createSkillWorkflow({
+	skillId: "audit",
+	command: "audit",
+	flowKey: "audit",
+	description: "Audit an existing PostHog integration for correctness and best practices",
+	integrationLabel: "audit",
+	customPrompt: "Run a comprehensive audit of the existing PostHog integration. Follow the skill workflow steps in order. Do not modify any project files — only create the final audit report.",
+	successMessage: "Audit complete! You can view the audit report at ./posthog-audit-report.md",
+	reportFile: AUDIT_REPORT_FILE,
+	docsUrl: "https://posthog.com/docs/product-analytics/best-practices",
+	spinnerMessage: "Auditing PostHog integration...",
+	estimatedDurationMinutes: 5,
+	requires: ["posthog-integration"],
+	abortCases: AUDIT_ABORT_CASES
+});
+const auditRun = async (session) => {
+	seedBeforeAuditRun(session);
+	if (!baseConfig.run) throw new Error("Audit workflow has no run configuration.");
+	return typeof baseConfig.run === "function" ? baseConfig.run(session) : baseConfig.run;
+};
+const auditConfig = {
+	...baseConfig,
+	steps: auditSteps,
+	run: auditRun
+};
+//#endregion
 //#region src/lib/workflows/posthog-doctor/steps.ts
 const POSTHOG_DOCTOR_WORKFLOW = [
 	{
@@ -364,6 +550,7 @@ function getKindMeta(kind) {
 const WORKFLOW_REGISTRY = [
 	posthogIntegrationConfig,
 	revenueAnalyticsConfig,
+	auditConfig,
 	{
 		command: "doctor",
 		description: "Diagnose your PostHog project for configuration issues and setup warnings",
@@ -502,32 +689,69 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 		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"
 		}
 	});
 }, (argv) => {
 	const options = { ...argv };
 	if (options.ci) {
 		if (!options.region) options.region = "us";
-		if (!options.apiKey) {
+		if (!options.installDir) {
 			setUI(new LoggingUI());
 			getUI().intro("PostHog Wizard");
-			getUI().log.error("CI mode requires --api-key (personal API key phx_xxx)");
+			getUI().log.error("CI mode requires --install-dir (directory to install in)");
 			process.exit(1);
 			return;
 		}
-		if (!options.installDir) {
+		if (!options.apiKey && !options.signup) {
 			setUI(new LoggingUI());
 			getUI().intro("PostHog Wizard");
-			getUI().log.error("CI mode requires --install-dir (directory to install in)");
+			getUI().log.error("CI mode requires --api-key (personal API key phx_xxx). To create a new account instead, use --signup --email you@example.com.");
+			process.exit(1);
+			return;
+		}
+		if (!options.apiKey && options.signup && !options.email) {
+			setUI(new LoggingUI());
+			getUI().intro("PostHog Wizard");
+			getUI().log.error("CI --signup requires --email to create a new account.");
 			process.exit(1);
 			return;
 		}
 		(async () => {
-			const { posthogIntegrationConfig } = await import("./posthog-integration-D4SRhJIQ.js").then((n) => n.n);
-			const { FRAMEWORK_REGISTRY } = await import("./registry-DaPKstG3.js").then((n) => n.n);
-			const { detectFramework, gatherFrameworkContext } = await import("./detection-B7GNzve-.js").then((n) => n.t);
-			const { analytics } = await import("./analytics-CfAUlt6-.js");
-			const { wizardAbort } = await import("./wizard-abort-DZmO_sIZ.js");
+			if (!options.apiKey && options.signup) {
+				setUI(new LoggingUI());
+				getUI().intro("PostHog Wizard");
+				try {
+					const { provisionNewAccount } = await import("./provisioning-CHfTOEvg.js");
+					const signupRegion = options.region.toUpperCase();
+					getUI().log.info(`Provisioning new PostHog account for ${String(options.email)} in ${signupRegion}...`);
+					const result = await provisionNewAccount(options.email, options.name ?? "", signupRegion);
+					if (!result.personalApiKey) {
+						getUI().log.error("Provisioning succeeded but no personal API key was returned — cannot continue install.");
+						process.exit(1);
+						return;
+					}
+					getUI().log.success("Account ready.");
+					getUI().log.info(`  Project API Key:  ${result.projectApiKey}`);
+					getUI().log.info(`  Personal API Key: ${result.personalApiKey}`);
+					getUI().log.info(`  Host:             ${result.host}`);
+					options.apiKey = result.personalApiKey;
+					if (options.projectId == null) options.projectId = result.projectId;
+				} catch (error) {
+					const msg = error instanceof Error ? error.message : String(error);
+					getUI().log.error(`Provisioning failed: ${msg}`);
+					process.exit(1);
+					return;
+				}
+			}
+			const { posthogIntegrationConfig } = await import("./posthog-integration-DX77Msto.js").then((n) => n.r);
+			const { FRAMEWORK_REGISTRY } = await import("./registry-CCtIsqb8.js").then((n) => n.n);
+			const { detectFramework, gatherFrameworkContext } = await import("./detection-C_RfYYDe.js").then((n) => n.t);
+			const { analytics } = await import("./analytics-JDitS2JI.js");
+			const { wizardAbort } = await import("./wizard-abort-DIhFXJ5N.js");
 			runWizardCI(posthogIntegrationConfig, options, async (session) => {
 				const integration = session.integration ?? await detectFramework(session.installDir);
 				if (!integration) {
@@ -560,11 +784,11 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 		getUI().log.error("This installer requires an interactive terminal (TTY) to run.\nIt appears you are running in a non-interactive environment.\nPlease run the wizard in an interactive terminal.\n\nFor CI/CD environments, use --ci mode:\n  npx @posthog/wizard --ci --region us --api-key phx_xxx");
 		process.exit(1);
 	} else if (options.playground) (async () => {
-		const { startPlayground } = await import("./start-playground-g1TxpCZ5.js");
+		const { startPlayground } = await import("./start-playground-DYNQ8rOz.js");
 		startPlayground(WIZARD_VERSION);
 	})();
 	else if (options.skill) (async () => {
-		const { createSkillWorkflow } = await import("./agent-skill-DJOzDaQV.js").then((n) => n.t);
+		const { createSkillWorkflow } = await Promise.resolve().then(() => agent_skill_exports);
 		const skillId = options.skill;
 		runWizard(createSkillWorkflow({
 			skillId,
@@ -583,7 +807,7 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 		});
 	})();
 	else (async () => {
-		const { posthogIntegrationConfig } = await import("./posthog-integration-D4SRhJIQ.js").then((n) => n.n);
+		const { posthogIntegrationConfig } = await import("./posthog-integration-DX77Msto.js").then((n) => n.r);
 		runWizard(posthogIntegrationConfig, options);
 	})();
 }).command("mcp <command>", "MCP server management commands", (yargs) => {
@@ -607,12 +831,12 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 		const options = { ...argv };
 		const mcpFeatures = options.features?.split(",").map((s) => s.trim()).filter(Boolean);
 		(async () => {
-			const { readApiKeyFromEnv } = await import("./env-api-key-DU8uIEvo.js");
+			const { readApiKeyFromEnv } = await import("./env-api-key-D5G2PrXW.js");
 			const apiKey = options.apiKey || readApiKeyFromEnv();
 			try {
-				const { startTUI } = await import("./start-tui-CQef69NR.js");
-				const { buildSession } = await import("./wizard-session-COhklXAF.js");
-				const { Flow } = await import("./router-SgzmfLGi.js").then((n) => n.n);
+				const { startTUI } = await import("./start-tui-DleQG3La.js");
+				const { buildSession } = await import("./wizard-session-BQC9vy9Z.js");
+				const { Flow } = await import("./router-BTfmEDDJ.js").then((n) => n.n);
 				const tui = startTUI(WIZARD_VERSION, Flow.McpAdd);
 				const session = buildSession({
 					debug: options.debug,
@@ -623,7 +847,7 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 				tui.store.session = session;
 			} catch {
 				setUI(new LoggingUI());
-				const { addMCPServerToClientsStep } = await import("./add-mcp-server-to-clients-Br1hDRiB.js").then((n) => n.r);
+				const { addMCPServerToClientsStep } = await import("./add-mcp-server-to-clients-BKoew3aT.js").then((n) => n.r);
 				await addMCPServerToClientsStep({
 					local: options.local,
 					features: mcpFeatures,
@@ -641,9 +865,9 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 		const options = { ...argv };
 		(async () => {
 			try {
-				const { startTUI } = await import("./start-tui-CQef69NR.js");
-				const { buildSession } = await import("./wizard-session-COhklXAF.js");
-				const { Flow } = await import("./router-SgzmfLGi.js").then((n) => n.n);
+				const { startTUI } = await import("./start-tui-DleQG3La.js");
+				const { buildSession } = await import("./wizard-session-BQC9vy9Z.js");
+				const { Flow } = await import("./router-BTfmEDDJ.js").then((n) => n.n);
 				const tui = startTUI(WIZARD_VERSION, Flow.McpRemove);
 				const session = buildSession({
 					debug: options.debug,
@@ -652,12 +876,69 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 				tui.store.session = session;
 			} catch {
 				setUI(new LoggingUI());
-				const { removeMCPServerFromClientsStep } = await import("./add-mcp-server-to-clients-Br1hDRiB.js").then((n) => n.r);
+				const { removeMCPServerFromClientsStep } = await import("./add-mcp-server-to-clients-BKoew3aT.js").then((n) => n.r);
 				await removeMCPServerFromClientsStep({ local: options.local });
 			}
 		})();
 	}).demandCommand(1, "You must specify a subcommand (add or remove)").help();
 });
+cli.command("provision", "Create a new PostHog account (headless, no TUI)", (yargs) => {
+	return yargs.options({
+		email: {
+			describe: "Email address for the new account",
+			type: "string",
+			demandOption: true
+		},
+		region: {
+			describe: "Cloud region (us or eu)",
+			choices: ["us", "eu"],
+			default: "us"
+		},
+		name: {
+			describe: "Name for the new account",
+			type: "string",
+			default: ""
+		},
+		json: {
+			describe: "Emit JSON result to stdout (defaults to true when stdout is not a TTY)",
+			type: "boolean"
+		}
+	}).example("wizard provision --email matt+test@posthog.com --region us", "").example("wizard provision --email user@example.com --region eu --json", "");
+}, (argv) => {
+	const email = argv.email;
+	const region = argv.region.toUpperCase();
+	const name = argv.name ?? "";
+	const jsonMode = argv.json === void 0 ? !process.stdout.isTTY : argv.json;
+	if (!jsonMode) setUI(new LoggingUI());
+	(async () => {
+		try {
+			const { provisionNewAccount } = await import("./provisioning-CHfTOEvg.js");
+			if (!jsonMode) getUI().log.info(`Provisioning account for ${email} in ${region}...`);
+			const result = await provisionNewAccount(email, name, region);
+			if (jsonMode) process.stdout.write(`${JSON.stringify(result)}\n`);
+			else {
+				getUI().log.success("Account provisioned successfully:");
+				getUI().log.info(`  API Key:       ${result.projectApiKey}`);
+				getUI().log.info(`  Host:          ${result.host}`);
+				getUI().log.info(`  Project ID:    ${result.projectId}`);
+				getUI().log.info(`  Account ID:    ${result.accountId}`);
+				getUI().log.info(`  Access Token:  ${result.accessToken}`);
+				getUI().log.info(`  Refresh Token: ${result.refreshToken}`);
+				if (result.personalApiKey) getUI().log.info(`  Personal API Key: ${result.personalApiKey}`);
+			}
+			process.exit(0);
+		} catch (error) {
+			const msg = error instanceof Error ? error.message : String(error);
+			const code = msg.includes("already associated") ? "email_exists" : "provisioning_failed";
+			if (jsonMode) process.stderr.write(`${JSON.stringify({
+				error: msg,
+				code
+			})}\n`);
+			else getUI().log.error(`Provisioning failed: ${msg}`);
+			process.exit(1);
+		}
+	})();
+});
 for (const wfConfig of getSubcommandWorkflows()) cli.command(wfConfig.command, wfConfig.description, (y) => y.options(skillSubcommandOptions), (argv) => {
 	const options = { ...argv };
 	if (options.ci) runWizardCI(wfConfig, options);
@@ -673,12 +954,12 @@ function runWizard(config, options) {
 	(async () => {
 		try {
 			const installDir = options.installDir || process.cwd();
-			const { startTUI } = await import("./start-tui-CQef69NR.js");
-			const { buildSession } = await import("./wizard-session-COhklXAF.js");
-			const { TaskStreamPush } = await import("./task-stream-DX_jKDQu.js");
-			const { FileDestination } = await import("./file-DhSBlq-x.js");
-			const { PostHogDestination } = await import("./posthog-ByrpqEjN.js");
-			const { analytics } = await import("./analytics-CfAUlt6-.js");
+			const { startTUI } = await import("./start-tui-DleQG3La.js");
+			const { buildSession } = await import("./wizard-session-BQC9vy9Z.js");
+			const { TaskStreamPush } = await import("./task-stream-CX7Uf6EM.js");
+			const { FileDestination } = await import("./file-8iNrXHkG.js");
+			const { PostHogDestination } = await import("./posthog-vm0k9PKS.js");
+			const { analytics } = await import("./analytics-JDitS2JI.js");
 			const tui = startTUI(WIZARD_VERSION, config.flowKey);
 			const session = buildSession({
 				debug: options.debug,
@@ -706,9 +987,10 @@ function runWizard(config, options) {
 			tui.store.onTasksChanged = () => void taskStream.push();
 			await tui.store.runReadyHooks();
 			await tui.store.getGate("intro");
+			await tui.store.getGate("health-check");
 			const skipAgent = config.run == null;
 			if (skipAgent) {
-				const { getOrAskForProjectData } = await import("./setup-utils-_ONxN-TT.js");
+				const { getOrAskForProjectData } = await import("./setup-utils-CoX-vLgw.js");
 				const { projectApiKey, host, accessToken, projectId } = await getOrAskForProjectData({
 					signup: session.signup,
 					ci: session.ci,
@@ -722,7 +1004,7 @@ function runWizard(config, options) {
 					projectId
 				});
 			} else {
-				const { runAgent } = await import("./agent-runner-fWYFO4H0.js");
+				const { runAgent } = await import("./agent-runner-B8Cx6X6x.js");
 				await runAgent(config, tui.store.session);
 			}
 			const isDone = () => skipAgent ? tui.store.session.outroDismissed : tui.store.session.skillsComplete;
@@ -773,11 +1055,11 @@ function runWizardCI(config, options, preRun) {
 	}
 	(async () => {
 		const path = await import("path");
-		const { buildSession } = await import("./wizard-session-COhklXAF.js");
+		const { buildSession } = await import("./wizard-session-BQC9vy9Z.js");
 		const { readEnvironment } = await Promise.resolve().then(() => environment_exports);
-		const { readApiKeyFromEnv } = await import("./env-api-key-DU8uIEvo.js");
-		const { configureLogFileFromEnvironment, logToFile } = await import("./debug-D-0xueVl.js");
-		const { wizardAbort, WizardError } = await import("./wizard-abort-DZmO_sIZ.js");
+		const { readApiKeyFromEnv } = await import("./env-api-key-D5G2PrXW.js");
+		const { configureLogFileFromEnvironment, logToFile } = await import("./debug-I5sRZubJ.js");
+		const { wizardAbort, WizardError } = await import("./wizard-abort-DIhFXJ5N.js");
 		configureLogFileFromEnvironment();
 		const env = readEnvironment();
 		const apiKey = options.apiKey ?? readApiKeyFromEnv() ?? void 0;
@@ -826,7 +1108,7 @@ function runWizardCI(config, options, preRun) {
 					})
 				});
 			}
-			const { runAgent } = await import("./agent-runner-fWYFO4H0.js");
+			const { runAgent } = await import("./agent-runner-B8Cx6X6x.js");
 			await runAgent(config, session);
 		} catch (error) {
 			const errorMessage = error instanceof Error ? error.message : String(error);
@@ -844,6 +1126,6 @@ function runWizardCI(config, options, preRun) {
 	});
 }
 //#endregion
-export { STRIPE_SDKS as a, POSTHOG_SDKS as i, getKindMeta as n, fetchHealthIssues as r, WORKFLOW_REGISTRY as t };
+export { POSTHOG_SDKS as a, AGENT_SKILL_STEPS as i, getKindMeta as n, STRIPE_SDKS as o, fetchHealthIssues as r, WORKFLOW_REGISTRY as t };
 
 //# sourceMappingURL=bin.js.map