@posthog/wizard 2.12.0 → 2.13.0

package/dist/bin.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 import { t as __exportAll } from "./rolldown-runtime-B_-DWIq7.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 { 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-Cqi6nVfX.js";
+import { n as analytics } from "./analytics-VM7laaFx.js";
+import { u as handleApiError } from "./setup-utils-CNV7FSlY.js";
+import { h as AUDIT_REPORT_FILE, m as AUDIT_CHECKS_KEY, p as AUDIT_CHECKS_FILE } from "./agent-interface-CV0-vtxj.js";
+import { n as posthogIntegrationConfig } from "./posthog-integration-BL21S3T6.js";
 import { t as IGNORED_DIRS } from "./file-utils-DnTSiTJw.js";
 import { satisfies } from "semver";
 import yargs from "yargs";
@@ -259,6 +259,7 @@ function createSkillWorkflow(opts) {
 		description: opts.description,
 		flowKey: opts.flowKey,
 		steps: AGENT_SKILL_STEPS,
+		reportFile: opts.reportFile,
 		run: {
 			skillId: opts.skillId,
 			integrationLabel: opts.integrationLabel,
@@ -377,7 +378,7 @@ const withAuditScreens = (steps) => steps.map((step) => {
 	} : step;
 });
 const auditSteps = withAuditScreens(AGENT_SKILL_STEPS);
-const baseConfig = createSkillWorkflow({
+const baseConfig$1 = createSkillWorkflow({
 	skillId: "audit",
 	command: "audit",
 	flowKey: "audit",
@@ -394,15 +395,214 @@ const baseConfig = createSkillWorkflow({
 });
 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;
+	if (!baseConfig$1.run) throw new Error("Audit workflow has no run configuration.");
+	return typeof baseConfig$1.run === "function" ? baseConfig$1.run(session) : baseConfig$1.run;
 };
 const auditConfig = {
-	...baseConfig,
+	...baseConfig$1,
 	steps: auditSteps,
 	run: auditRun
 };
 //#endregion
+//#region src/lib/workflows/audit-3000/index.ts
+const AUDIT3000_REPORT_FILE = "posthog-audit-3000-report.md";
+const AUDIT3000_EXTRA_CHECKS = [
+	{
+		id: "event-naming-standardization",
+		area: "Event Quality",
+		label: "Event naming convention is consistent",
+		status: "pending"
+	},
+	{
+		id: "event-duplicates-and-bloat",
+		area: "Event Quality",
+		label: "No duplicate or bloated event capture",
+		status: "pending"
+	},
+	{
+		id: "event-quality-context-review",
+		area: "Event Quality",
+		label: "Event property context reviewed",
+		status: "pending"
+	},
+	{
+		id: "event-usage-coverage",
+		area: "Event Quality",
+		label: "Captured events match insights / dashboards usage",
+		status: "pending"
+	},
+	{
+		id: "stale-feature-flags-reviewed",
+		area: "Feature Flags",
+		label: "Stale feature flags reviewed",
+		status: "pending"
+	},
+	{
+		id: "replay-minimum-duration-set",
+		area: "Session Replay",
+		label: "Minimum duration set on init",
+		status: "pending"
+	},
+	{
+		id: "replay-mask-config",
+		area: "Session Replay",
+		label: "Mask config covers sensitive surfaces",
+		status: "pending"
+	},
+	{
+		id: "replay-disabled-in-test-envs",
+		area: "Session Replay",
+		label: "Disabled in test / CI environments",
+		status: "pending"
+	},
+	{
+		id: "replay-strict-minimum-duration",
+		area: "Session Replay",
+		label: "Strict minimum duration enforced",
+		status: "pending"
+	},
+	{
+		id: "replay-sampling-rate",
+		area: "Session Replay — Optimize",
+		label: "Sampling rate tuned for cost",
+		status: "pending"
+	},
+	{
+		id: "replay-triggers-configured",
+		area: "Session Replay — Optimize",
+		label: "Triggers configured (event / URL / flag)",
+		status: "pending"
+	},
+	{
+		id: "replay-network-recording-filtered",
+		area: "Session Replay — Optimize",
+		label: "Network recording filtered",
+		status: "pending"
+	},
+	{
+		id: "replay-mobile-sampling",
+		area: "Session Replay — Optimize",
+		label: "Mobile sampling configured",
+		status: "pending"
+	},
+	{
+		id: "expansion-product-analytics",
+		area: "Use Case: Expansion",
+		label: "Product analytics coverage",
+		status: "pending"
+	},
+	{
+		id: "expansion-error-tracking",
+		area: "Use Case: Expansion",
+		label: "Error tracking coverage",
+		status: "pending"
+	},
+	{
+		id: "expansion-llm-observability",
+		area: "Use Case: Expansion",
+		label: "LLM observability coverage",
+		status: "pending"
+	},
+	{
+		id: "expansion-session-replay",
+		area: "Use Case: Expansion",
+		label: "Session replay coverage",
+		status: "pending"
+	},
+	{
+		id: "expansion-feature-flags",
+		area: "Use Case: Expansion",
+		label: "Feature flags coverage",
+		status: "pending"
+	},
+	{
+		id: "expansion-surveys",
+		area: "Use Case: Expansion",
+		label: "Surveys coverage",
+		status: "pending"
+	},
+	{
+		id: "expansion-logs",
+		area: "Use Case: Expansion",
+		label: "Logs coverage",
+		status: "pending"
+	},
+	{
+		id: "expansion-web-analytics",
+		area: "Use Case: Expansion",
+		label: "Web analytics coverage",
+		status: "pending"
+	},
+	{
+		id: "customer-enrichment",
+		area: "Additional Sections",
+		label: "Customer enrichment (Harmonic + PDL)",
+		status: "pending"
+	},
+	{
+		id: "use-case-match",
+		area: "Additional Sections",
+		label: "Use-case match",
+		status: "pending"
+	},
+	{
+		id: "final-report",
+		area: "Additional Sections",
+		label: "Final audit report written",
+		status: "pending"
+	}
+];
+const AUDIT3000_SEED_CHECKS = [...AUDIT_SEED_CHECKS, ...AUDIT3000_EXTRA_CHECKS];
+const AUDIT3000_SCREEN_BY_STEP = {
+	intro: "audit-3000-intro",
+	run: "audit-3000-run",
+	outro: "audit-3000-outro"
+};
+const seedAudit3000Ledger = (installDir) => {
+	const target = path.join(installDir, AUDIT_CHECKS_FILE);
+	const tmp = `${target}.tmp`;
+	fs.writeFileSync(tmp, JSON.stringify(AUDIT3000_SEED_CHECKS, null, 2), "utf8");
+	fs.renameSync(tmp, target);
+	logToFile(`seedAudit3000Ledger: wrote ${AUDIT3000_SEED_CHECKS.length} entries to ${target}`);
+};
+const seedBeforeAudit3000Run = (session) => {
+	seedAudit3000Ledger(session.installDir);
+	session.frameworkContext[AUDIT_CHECKS_KEY] = AUDIT3000_SEED_CHECKS;
+};
+const withAudit3000Screens = (steps) => steps.map((step) => {
+	const override = AUDIT3000_SCREEN_BY_STEP[step.id];
+	return override ? {
+		...step,
+		screen: override
+	} : step;
+});
+const audit3000Steps = withAudit3000Screens(AGENT_SKILL_STEPS);
+const baseConfig = createSkillWorkflow({
+	skillId: "audit-3000",
+	command: "audit-3000",
+	flowKey: "audit-3000",
+	description: "Audit an existing PostHog integration (v3000 — adds event quality, stale-flag hygiene, customer enrichment, use-case match)",
+	integrationLabel: "audit-3000",
+	customPrompt: "Run the audit-3000 skill end-to-end. Follow the step chain starting at references/1-version.md. Do not modify any project files — only create the final audit report and (when enrichment is enabled) the enrichment report.",
+	successMessage: `Audit complete! View the report at ./${AUDIT3000_REPORT_FILE}`,
+	reportFile: AUDIT3000_REPORT_FILE,
+	docsUrl: "https://posthog.com/docs/product-analytics/best-practices",
+	spinnerMessage: "Running PostHog Audit 3000...",
+	estimatedDurationMinutes: 6,
+	requires: ["posthog-integration"],
+	abortCases: AUDIT_ABORT_CASES
+});
+const audit3000Run = async (session) => {
+	seedBeforeAudit3000Run(session);
+	if (!baseConfig.run) throw new Error("audit-3000 workflow has no run configuration.");
+	return typeof baseConfig.run === "function" ? baseConfig.run(session) : baseConfig.run;
+};
+const audit3000Config = {
+	...baseConfig,
+	steps: audit3000Steps,
+	run: audit3000Run
+};
+//#endregion
 //#region src/lib/workflows/posthog-doctor/steps.ts
 const POSTHOG_DOCTOR_WORKFLOW = [
 	{
@@ -551,6 +751,7 @@ const WORKFLOW_REGISTRY = [
 	posthogIntegrationConfig,
 	revenueAnalyticsConfig,
 	auditConfig,
+	audit3000Config,
 	{
 		command: "doctor",
 		description: "Diagnose your PostHog project for configuration issues and setup warnings",
@@ -558,6 +759,10 @@ const WORKFLOW_REGISTRY = [
 		steps: POSTHOG_DOCTOR_WORKFLOW
 	}
 ];
+/** Look up a workflow config by its flowKey. */
+function getWorkflowConfig(flowKey) {
+	return WORKFLOW_REGISTRY.find((c) => c.flowKey === flowKey);
+}
 /** All workflow configs that are exposed as CLI subcommands. */
 function getSubcommandWorkflows() {
 	return WORKFLOW_REGISTRY.filter((c) => c.command != null);
@@ -725,7 +930,7 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 				setUI(new LoggingUI());
 				getUI().intro("PostHog Wizard");
 				try {
-					const { provisionNewAccount } = await import("./provisioning-CHfTOEvg.js");
+					const { provisionNewAccount } = await import("./provisioning-BdQ1ONIg.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);
@@ -747,11 +952,11 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 					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");
+			const { posthogIntegrationConfig } = await import("./posthog-integration-BL21S3T6.js").then((n) => n.r);
+			const { FRAMEWORK_REGISTRY } = await import("./registry-BaMEaAKd.js").then((n) => n.n);
+			const { detectFramework, gatherFrameworkContext } = await import("./detection-CSjmal-X.js").then((n) => n.t);
+			const { analytics } = await import("./analytics-BH7bEHQR.js");
+			const { wizardAbort } = await import("./wizard-abort-Dl0BkqhT.js");
 			runWizardCI(posthogIntegrationConfig, options, async (session) => {
 				const integration = session.integration ?? await detectFramework(session.installDir);
 				if (!integration) {
@@ -784,7 +989,7 @@ 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-DYNQ8rOz.js");
+		const { startPlayground } = await import("./start-playground-C9GWnVdM.js");
 		startPlayground(WIZARD_VERSION);
 	})();
 	else if (options.skill) (async () => {
@@ -807,7 +1012,7 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 		});
 	})();
 	else (async () => {
-		const { posthogIntegrationConfig } = await import("./posthog-integration-DX77Msto.js").then((n) => n.r);
+		const { posthogIntegrationConfig } = await import("./posthog-integration-BL21S3T6.js").then((n) => n.r);
 		runWizard(posthogIntegrationConfig, options);
 	})();
 }).command("mcp <command>", "MCP server management commands", (yargs) => {
@@ -834,9 +1039,9 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 			const { readApiKeyFromEnv } = await import("./env-api-key-D5G2PrXW.js");
 			const apiKey = options.apiKey || readApiKeyFromEnv();
 			try {
-				const { startTUI } = await import("./start-tui-DleQG3La.js");
+				const { startTUI } = await import("./start-tui-B_zwutLe.js");
 				const { buildSession } = await import("./wizard-session-BQC9vy9Z.js");
-				const { Flow } = await import("./router-BTfmEDDJ.js").then((n) => n.n);
+				const { Flow } = await import("./router-COhhuIW3.js").then((n) => n.n);
 				const tui = startTUI(WIZARD_VERSION, Flow.McpAdd);
 				const session = buildSession({
 					debug: options.debug,
@@ -847,7 +1052,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-BKoew3aT.js").then((n) => n.r);
+				const { addMCPServerToClientsStep } = await import("./add-mcp-server-to-clients-CUNR00bB.js").then((n) => n.r);
 				await addMCPServerToClientsStep({
 					local: options.local,
 					features: mcpFeatures,
@@ -865,9 +1070,9 @@ const cli = yargs(hideBin(process.argv)).env("POSTHOG_WIZARD").options({
 		const options = { ...argv };
 		(async () => {
 			try {
-				const { startTUI } = await import("./start-tui-DleQG3La.js");
+				const { startTUI } = await import("./start-tui-B_zwutLe.js");
 				const { buildSession } = await import("./wizard-session-BQC9vy9Z.js");
-				const { Flow } = await import("./router-BTfmEDDJ.js").then((n) => n.n);
+				const { Flow } = await import("./router-COhhuIW3.js").then((n) => n.n);
 				const tui = startTUI(WIZARD_VERSION, Flow.McpRemove);
 				const session = buildSession({
 					debug: options.debug,
@@ -876,7 +1081,7 @@ 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-BKoew3aT.js").then((n) => n.r);
+				const { removeMCPServerFromClientsStep } = await import("./add-mcp-server-to-clients-CUNR00bB.js").then((n) => n.r);
 				await removeMCPServerFromClientsStep({ local: options.local });
 			}
 		})();
@@ -912,7 +1117,7 @@ cli.command("provision", "Create a new PostHog account (headless, no TUI)", (yar
 	if (!jsonMode) setUI(new LoggingUI());
 	(async () => {
 		try {
-			const { provisionNewAccount } = await import("./provisioning-CHfTOEvg.js");
+			const { provisionNewAccount } = await import("./provisioning-BdQ1ONIg.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`);
@@ -954,12 +1159,12 @@ function runWizard(config, options) {
 	(async () => {
 		try {
 			const installDir = options.installDir || process.cwd();
-			const { startTUI } = await import("./start-tui-DleQG3La.js");
+			const { startTUI } = await import("./start-tui-B_zwutLe.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 { analytics } = await import("./analytics-BH7bEHQR.js");
 			const tui = startTUI(WIZARD_VERSION, config.flowKey);
 			const session = buildSession({
 				debug: options.debug,
@@ -990,7 +1195,7 @@ function runWizard(config, options) {
 			await tui.store.getGate("health-check");
 			const skipAgent = config.run == null;
 			if (skipAgent) {
-				const { getOrAskForProjectData } = await import("./setup-utils-CoX-vLgw.js");
+				const { getOrAskForProjectData } = await import("./setup-utils-CU4FIqjB.js");
 				const { projectApiKey, host, accessToken, projectId } = await getOrAskForProjectData({
 					signup: session.signup,
 					ci: session.ci,
@@ -1004,7 +1209,7 @@ function runWizard(config, options) {
 					projectId
 				});
 			} else {
-				const { runAgent } = await import("./agent-runner-B8Cx6X6x.js");
+				const { runAgent } = await import("./agent-runner-LvVQH31D.js");
 				await runAgent(config, tui.store.session);
 			}
 			const isDone = () => skipAgent ? tui.store.session.outroDismissed : tui.store.session.skillsComplete;
@@ -1058,8 +1263,8 @@ function runWizardCI(config, options, preRun) {
 		const { buildSession } = await import("./wizard-session-BQC9vy9Z.js");
 		const { readEnvironment } = await Promise.resolve().then(() => environment_exports);
 		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");
+		const { configureLogFileFromEnvironment, logToFile } = await import("./debug-BdcTB7EF.js");
+		const { wizardAbort, WizardError } = await import("./wizard-abort-Dl0BkqhT.js");
 		configureLogFileFromEnvironment();
 		const env = readEnvironment();
 		const apiKey = options.apiKey ?? readApiKeyFromEnv() ?? void 0;
@@ -1108,7 +1313,7 @@ function runWizardCI(config, options, preRun) {
 					})
 				});
 			}
-			const { runAgent } = await import("./agent-runner-B8Cx6X6x.js");
+			const { runAgent } = await import("./agent-runner-LvVQH31D.js");
 			await runAgent(config, session);
 		} catch (error) {
 			const errorMessage = error instanceof Error ? error.message : String(error);
@@ -1126,6 +1331,6 @@ function runWizardCI(config, options, preRun) {
 	});
 }
 //#endregion
-export { POSTHOG_SDKS as a, AGENT_SKILL_STEPS as i, getKindMeta as n, STRIPE_SDKS as o, fetchHealthIssues as r, WORKFLOW_REGISTRY as t };
+export { AGENT_SKILL_STEPS as a, fetchHealthIssues as i, getWorkflowConfig as n, POSTHOG_SDKS as o, getKindMeta as r, STRIPE_SDKS as s, WORKFLOW_REGISTRY as t };
 
 //# sourceMappingURL=bin.js.map