@posthog/wizard 2.11.0 → 2.12.0

package/README.md

@@ -2,11 +2,14 @@
   <img alt="posthoglogo" src="https://user-images.githubusercontent.com/65415371/205059737-c8a4f836-4889-4654-902e-f302b187b6a0.png">
 </p>
 
-> **⚠️ Experimental:** This wizard is still in an experimental phase. If you
+
 > have any feedback, please drop an email to **[wizard@posthog.com](mailto:wizard@posthog.com)**.
 
 <h1>PostHog wizard ✨</h1>
-<h4>The PostHog wizard helps you quickly add PostHog to your project using AI.</h4>
+
+The PostHog wizard helps you quickly add PostHog to your project using AI.
+
+![Wizard clip](https://res.cloudinary.com/dmukukwp6/image/upload/q_auto,f_auto/pasted_image_2026_05_01_T19_53_26_002_Z_398f697f5c.png)
 
 # Usage
 
@@ -16,10 +19,11 @@ To use the wizard, you can run it directly using:
 npx @posthog/wizard
 ```
 
-Currently the wizard can be used for **React, NextJS, Svelte, Astro and React
-Native** projects. If you have other integrations you would like the wizard to
+Currently the wizard can be used for over 16 frameworks for frontend, backend, and mobile applications. If you have other integrations you would like the wizard to
 support, please open a [GitHub issue](https://github.com/posthog/wizard/issues)!
 
+Visit our [docs](https://posthog.com/docs/ai-engineering/ai-wizard) to learn more. 
+
 ## MCP Commands
 
 The wizard also includes commands for managing PostHog MCP (Model Context
@@ -44,6 +48,46 @@ npx @posthog/wizard revenue
 Requires PostHog and Stripe SDKs already installed. Supports `--ci` with the
 same flags as the main wizard.
 
+## Headless signup + install (agents / CI)
+
+For a fully non-interactive first-run (no existing PostHog account, no TTY,
+no browser), combine `--ci --signup --email`. The wizard provisions a new
+account, uses the returned personal API key to run the normal CI install,
+and wires PostHog into the project at `--install-dir`:
+
+```bash
+npx @posthog/wizard --ci --signup \
+  --email you@example.com \
+  --install-dir .
+```
+
+Optional flags: `--name "Your Name"`, `--region eu` (default `us`),
+`--integration nextjs` (else auto-detected).
+
+### Provision only
+
+If you just want credentials — for tests, pre-flight checks, or wiring up
+PostHog yourself — use the `provision` subcommand, which emits a structured
+`ProvisioningResult` and does nothing else:
+
+```bash
+# Human-readable (when stdout is a TTY)
+npx @posthog/wizard provision --email user@example.com --region us
+
+# Machine-readable — auto when stdout is piped, or force with --json
+npx @posthog/wizard provision --email user@example.com --region eu --json
+```
+
+Success prints the full `ProvisioningResult` (`projectApiKey`, `host`,
+`projectId`, `accountId`, `accessToken`, `refreshToken`, and
+`personalApiKey` if present). Failure exits 1; in `--json` mode the error
+is emitted to stderr as `{"error":"...","code":"..."}`, with `code` set to
+`email_exists` when the address is already registered.
+
+> ⚠️ **Output contains live credentials.** Pipe it into a secrets store —
+> do not let it be captured by shared CI logs. Mask the step output or
+> redirect stdout to a file your job reads and discards.
+
 # Options
 
 The following CLI arguments are available:
@@ -62,9 +106,6 @@ The following CLI arguments are available:
 | `--ci`            | Enable CI mode for non-interactive execution                     | boolean | `false` |                                                      | `POSTHOG_WIZARD_CI`            |
 | `--api-key`       | PostHog personal API key (phx_xxx) for authentication            | string  |         |                                                      | `POSTHOG_WIZARD_API_KEY`       |
 
-> Note: A large amount of the scaffolding for this came from the amazing Sentry
-> wizard, which you can find [here](https://github.com/getsentry/sentry-wizard)
-> 💖
 
 # CI Mode
 

package/dist/{McpScreen-DvUncZBi.js → AuditChecksViewer-DsfXIO9e.js}

@@ -1,15 +1,16 @@
-import { n as analytics, r as sessionProperties } from "./analytics-D3rY3TaN.js";
-import { n as isTaskStatus } from "./wizard-ui-BExOjdjA.js";
-import { r as buildSession } from "./wizard-session-D5bggSsu.js";
-import { t as SERVICE_LABELS } from "./readiness-gQvQNCeL.js";
+import { d as SERVICE_LABELS } from "./debug-Bkaqv1ab.js";
+import { n as isTaskStatus } from "./wizard-ui-YdGFRyu_.js";
+import { n as analytics, r as sessionProperties } from "./analytics-DmD31Ssc.js";
+import { r as buildSession } from "./wizard-session-BcNJTl2I.js";
+import { g as AUDIT_SEVERITY_STYLE } from "./agent-interface-D5W9BAB2.js";
 import { n as getKindMeta } from "./bin.js";
-import { n as AVAILABLE_FEATURES, t as ALL_FEATURE_VALUES } from "./defaults-CPH6eWhN.js";
-import { i as WORKFLOW_STEPS, t as WizardRouter } from "./router-SgzmfLGi.js";
+import { n as AVAILABLE_FEATURES, t as ALL_FEATURE_VALUES } from "./defaults-GbLPuHxj.js";
+import { i as WORKFLOW_STEPS, t as WizardRouter } from "./router-BTfmEDDJ.js";
 import * as fs$1 from "fs";
 import { Box, Text, measureElement, useInput, useStdout } from "ink";
-import { Component, createContext, useCallback, useContext, useEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
+import { Component, Fragment, createContext, useCallback, useContext, useEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
 import { atom, map } from "nanostores";
-import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 import { Spinner } from "@inkjs/ui";
 //#region src/ui/tui/store.ts
 /**
@@ -525,7 +526,7 @@ const ProgressList = ({ items, title }) => {
 	return /* @__PURE__ */ jsxs(Box, {
 		flexDirection: "column",
 		children: [
-			title && /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(Text, {
+			title && /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx(Text, {
 				bold: true,
 				children: title
 			}), /* @__PURE__ */ jsx(Text, { children: " " })] }),
@@ -1275,7 +1276,7 @@ const ModalOverlay = ({ borderColor, title, titleColor, width = 68, children, fe
 						children: feedback
 					})
 				}),
-				footer && /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(Box, {
+				footer && /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx(Box, {
 					marginY: 1,
 					children: /* @__PURE__ */ jsx(Divider, {})
 				}), footer] })
@@ -1290,10 +1291,10 @@ const ModalOverlay = ({ borderColor, title, titleColor, width = 68, children, fe
 * Only renders the last N lines that fit on screen.
 */
 /** Rows consumed by TitleBar + spacer + ScreenContainer padding + status bar + tab bar */
-const CHROME_ROWS = 8;
+const CHROME_ROWS$1 = 8;
 const LogViewer = ({ filePath, height }) => {
 	const [, rows] = useStdoutDimensions();
-	const visibleLines = height ?? Math.max(5, rows - CHROME_ROWS);
+	const visibleLines = height ?? Math.max(5, rows - CHROME_ROWS$1);
 	const [lines, setLines] = useState([]);
 	useEffect(() => {
 		const readTail = () => {
@@ -1461,7 +1462,7 @@ const DissolveTransition = ({ transitionKey, width, height, children, direction
 		maxTicks,
 		width
 	]);
-	if (phase === "idle") return /* @__PURE__ */ jsx(Fragment, { children: displayChildren });
+	if (phase === "idle") return /* @__PURE__ */ jsx(Fragment$1, { children: displayChildren });
 	const easedValue = easeInOutCirc(Math.min(tick / easerSteps, 1));
 	const activatedCount = Math.floor(easedValue * width);
 	const columnOrder = [];
@@ -1576,11 +1577,10 @@ var ScreenErrorBoundary = class extends Component {
 * screen content (inside the transition area) so all screens get it.
 */
 const MIN_WIDTH = 80;
-const MAX_WIDTH = 120;
 /** Use terminal width when small so we don't overflow; otherwise clamp to [MIN_WIDTH, MAX_WIDTH]. */
 function getContentWidth(terminalColumns) {
 	if (terminalColumns < MIN_WIDTH) return terminalColumns;
-	return Math.min(MAX_WIDTH, terminalColumns);
+	return Math.min(120, terminalColumns);
 }
 const ScreenContainer = ({ store, screens }) => {
 	const [columns, rows] = useStdoutDimensions();
@@ -2104,7 +2104,7 @@ const NodeBlock = ({ content, active, completed, onComplete }) => {
 		dimColor: true,
 		children: content
 	});
-	return /* @__PURE__ */ jsx(Fragment, { children: content });
+	return /* @__PURE__ */ jsx(Fragment$1, { children: content });
 };
 //#endregion
 //#region src/ui/tui/primitives/ContentSequencer.tsx
@@ -3098,7 +3098,7 @@ const TipsCard = ({ store }) => {
 					]
 				}) : /* @__PURE__ */ jsxs(Text, {
 					dimColor: true,
-					children: [tip.description, tip.url && /* @__PURE__ */ jsxs(Fragment, { children: [" ", /* @__PURE__ */ jsx(Text, {
+					children: [tip.description, tip.url && /* @__PURE__ */ jsxs(Fragment$1, { children: [" ", /* @__PURE__ */ jsx(Text, {
 						color: "cyan",
 						children: tip.url
 					})] })]
@@ -3417,7 +3417,7 @@ const McpScreen = ({ store, installer, mode = "install" }) => {
 						" MCP clients detected. Skipping..."
 					]
 				}),
-				phase === "ask" && /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsxs(Text, {
+				phase === "ask" && /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsxs(Text, {
 					dimColor: true,
 					children: ["Detected: ", clients.map((c) => c.name).join(", ")]
 				}), /* @__PURE__ */ jsx(Box, {
@@ -3455,7 +3455,7 @@ const McpScreen = ({ store, installer, mode = "install" }) => {
 				}),
 				phase === "done" && /* @__PURE__ */ jsx(Box, {
 					flexDirection: "column",
-					children: resultClients.length > 0 ? /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsxs(Text, {
+					children: resultClients.length > 0 ? /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsxs(Text, {
 						color: "green",
 						bold: true,
 						children: [
@@ -3480,7 +3480,316 @@ const McpScreen = ({ store, installer, mode = "install" }) => {
 		})]
 	});
 };
+/** ScreenContainer wraps content in paddingX={1} inside a width capped at
+*  MAX_WIDTH, so the actual width available to the viewer is
+*  min(cols, MAX_WIDTH) - 2. */
+function getViewerWidth(rawCols) {
+	return Math.min(120, rawCols) - 2;
+}
+function computeLayout(rawCols, termRows) {
+	const cols = getViewerWidth(rawCols);
+	const padding = 2;
+	const statusWidth = 2;
+	const fixedExceptLabel = padding + statusWidth + 2 + 18 + 2 + 2;
+	const labelWidth = Math.max(28, cols - fixedExceptLabel);
+	const detailIndent = statusWidth + 2 + 18 + 2;
+	const viewerChrome = 9;
+	return {
+		cols,
+		visibleHeight: Math.max(5, termRows - 10 - viewerChrome),
+		viewerChrome,
+		padding,
+		statusWidth,
+		areaWidth: 18,
+		labelWidth,
+		colGap: 2,
+		dividerWidth: Math.max(20, cols - padding),
+		detailIndent,
+		detailWidth: Math.max(20, cols - detailIndent - padding)
+	};
+}
+function truncate(text, max) {
+	if (max <= 0) return "";
+	if (text.length <= max) return text;
+	return text.slice(0, Math.max(1, max - 1)) + "…";
+}
+//#endregion
+//#region src/ui/tui/screens/audit/AuditChecksViewer/CheckRow.tsx
+const CheckRow = ({ item, layout }) => {
+	const style = AUDIT_SEVERITY_STYLE[item.status];
+	return /* @__PURE__ */ jsxs(Box, {
+		flexShrink: 0,
+		children: [
+			/* @__PURE__ */ jsx(Box, {
+				width: layout.statusWidth + layout.colGap,
+				children: /* @__PURE__ */ jsx(Text, {
+					color: style.color,
+					children: style.glyph
+				})
+			}),
+			/* @__PURE__ */ jsx(Box, {
+				width: layout.areaWidth + layout.colGap,
+				children: /* @__PURE__ */ jsx(Text, {
+					dimColor: true,
+					children: truncate(item.area, layout.areaWidth)
+				})
+			}),
+			/* @__PURE__ */ jsx(Box, {
+				width: layout.labelWidth + layout.colGap,
+				children: /* @__PURE__ */ jsx(Text, {
+					bold: item.status !== "pending",
+					dimColor: item.status === "pending",
+					children: truncate(item.label, layout.labelWidth)
+				})
+			})
+		]
+	});
+};
+//#endregion
+//#region src/ui/tui/screens/audit/AuditChecksViewer/DetailRow.tsx
+/** Indented under the CHECK column; wrap continuation aligns with the prefix. */
+const DetailRow = ({ item, layout }) => /* @__PURE__ */ jsxs(Box, {
+	flexShrink: 0,
+	children: [/* @__PURE__ */ jsx(Box, { width: layout.detailIndent }), /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		width: layout.detailWidth,
+		children: [item.file && /* @__PURE__ */ jsx(Text, {
+			dimColor: true,
+			wrap: "wrap",
+			children: `↳ File: ${item.file}`
+		}), item.details && /* @__PURE__ */ jsx(Text, {
+			dimColor: true,
+			italic: true,
+			wrap: "wrap",
+			children: `${item.file ? "  " : "↳ "}Details: ${item.details}`
+		})]
+	})]
+});
+//#endregion
+//#region src/ui/tui/screens/audit/AuditChecksViewer/Legend.tsx
+const Legend = () => /* @__PURE__ */ jsxs(Text, { children: [
+	/* @__PURE__ */ jsx(Text, {
+		color: "green",
+		children: "✔ pass"
+	}),
+	/* @__PURE__ */ jsx(Text, {
+		dimColor: true,
+		children: "   ·   "
+	}),
+	/* @__PURE__ */ jsx(Text, {
+		color: "red",
+		children: "✘ error"
+	}),
+	/* @__PURE__ */ jsx(Text, {
+		dimColor: true,
+		children: "   ·   "
+	}),
+	/* @__PURE__ */ jsx(Text, {
+		color: "yellow",
+		children: "⚠ warning"
+	}),
+	/* @__PURE__ */ jsx(Text, {
+		dimColor: true,
+		children: "   ·   "
+	}),
+	/* @__PURE__ */ jsx(Text, {
+		color: "cyan",
+		children: "• suggestion"
+	})
+] });
+//#endregion
+//#region src/ui/tui/screens/audit/AuditChecksViewer/Header.tsx
+function statusCounts(checks) {
+	const out = {
+		pending: 0,
+		pass: 0,
+		error: 0,
+		warning: 0,
+		suggestion: 0
+	};
+	for (const c of checks) out[c.status] += 1;
+	return out;
+}
+const Header = ({ layout }) => /* @__PURE__ */ jsxs(Box, { children: [
+	/* @__PURE__ */ jsx(Box, {
+		width: layout.statusWidth + layout.colGap,
+		children: /* @__PURE__ */ jsx(Text, {
+			dimColor: true,
+			bold: true,
+			children: " "
+		})
+	}),
+	/* @__PURE__ */ jsx(Box, {
+		width: layout.areaWidth + layout.colGap,
+		children: /* @__PURE__ */ jsx(Text, {
+			dimColor: true,
+			bold: true,
+			children: "AREA"
+		})
+	}),
+	/* @__PURE__ */ jsx(Box, {
+		width: layout.labelWidth + layout.colGap,
+		children: /* @__PURE__ */ jsx(Text, {
+			dimColor: true,
+			bold: true,
+			children: "CHECK"
+		})
+	})
+] });
+const Summary = ({ total, counts }) => /* @__PURE__ */ jsxs(Text, {
+	dimColor: true,
+	children: [
+		total,
+		" total · ",
+		counts.pending,
+		" pending · ",
+		counts.error,
+		" errors ·",
+		" ",
+		counts.warning,
+		" warnings · ",
+		counts.suggestion,
+		" suggestions · ",
+		counts.pass,
+		" ",
+		"passes"
+	]
+});
+//#endregion
+//#region src/ui/tui/screens/audit/AuditChecksViewer/Footer.tsx
+const Footer = ({ total, counts }) => /* @__PURE__ */ jsxs(Fragment$1, { children: [/* @__PURE__ */ jsx(Legend, {}), /* @__PURE__ */ jsx(Summary, {
+	total,
+	counts
+})] });
+//#endregion
+//#region src/ui/tui/screens/audit/AuditChecksViewer/sort.ts
+const STATUS_ORDER = {
+	error: 0,
+	warning: 1,
+	suggestion: 2,
+	pass: 3,
+	pending: 4
+};
+/** Issues at the top (error → warning → suggestion), then passes, then pending todos. */
+function sortChecks(checks) {
+	return [...checks].sort((a, b) => {
+		const da = STATUS_ORDER[a.status] - STATUS_ORDER[b.status];
+		if (da !== 0) return da;
+		return a.area.localeCompare(b.area);
+	});
+}
+//#endregion
+//#region src/ui/tui/screens/audit/AuditChecksViewer/AuditChecksViewer.tsx
+/**
+* AuditChecksViewer — "Audit plan" tab.
+*
+* Renders the full audit ledger as a scrollable table grouped by status:
+* resolved checks (issues + passes, sorted by severity) on top, pending
+* checks at the bottom, separated by a blank row.
+*
+* Two interactions, both registered via `useKeyBindings`:
+*   - `e`        — toggle detail rows (file:line + agent's `details` text)
+*   - `↑` / `↓`  — scroll one row at a time, clamped to content bounds
+*
+* Auto-expands on first mount when the ledger contains any issue, since
+* the AuditAreaPane's `[→] View issues` hint sends users here precisely
+* to read those details.
+*/
+const AuditChecksViewer = ({ checks }) => {
+	const [rawCols, termRows] = useStdoutDimensions();
+	const layout = computeLayout(rawCols, termRows);
+	const totalHeight = layout.visibleHeight + layout.viewerChrome;
+	const sorted = useMemo(() => sortChecks(checks), [checks]);
+	const resolved = sorted.filter((c) => c.status !== "pending");
+	const pending = sorted.filter((c) => c.status === "pending");
+	const hasExpandable = sorted.some((c) => Boolean(c.details || c.file));
+	const [expanded, setExpanded] = useState(sorted.some((c) => c.status === "error" || c.status === "warning" || c.status === "suggestion") && hasExpandable);
+	const allRows = useMemo(() => {
+		const rows = [];
+		const buildRow = (item) => {
+			rows.push(/* @__PURE__ */ jsx(CheckRow, {
+				item,
+				layout
+			}, item.id));
+			if (expanded && (item.details || item.file)) rows.push(/* @__PURE__ */ jsx(DetailRow, {
+				item,
+				layout
+			}, `${item.id}-detail`));
+		};
+		resolved.forEach(buildRow);
+		if (resolved.length > 0 && pending.length > 0) rows.push(/* @__PURE__ */ jsx(Box, { height: 1 }, "separator"));
+		pending.forEach(buildRow);
+		return rows;
+	}, [
+		resolved,
+		pending,
+		expanded,
+		layout
+	]);
+	const [offset, setOffset] = useState(0);
+	const maxOffset = Math.max(0, allRows.length - layout.visibleHeight);
+	const clampedOffset = Math.min(offset, maxOffset);
+	const hiddenAbove = clampedOffset;
+	const hiddenBelow = Math.max(0, allRows.length - clampedOffset - layout.visibleHeight);
+	const bindings = [];
+	if (hasExpandable) bindings.push({
+		match: "e",
+		label: "e",
+		action: expanded ? "collapse details" : "expand details",
+		handler: () => setExpanded((prev) => !prev)
+	});
+	bindings.push({
+		match: ["upArrow", "downArrow"],
+		label: "↑↓",
+		action: "scroll",
+		handler: (_input, key) => {
+			if (key.upArrow) setOffset((o) => Math.max(0, o - 1));
+			else if (key.downArrow) setOffset((o) => Math.min(maxOffset, o + 1));
+		}
+	});
+	useKeyBindings("audit-checks-viewer", bindings);
+	const visibleRows = allRows.slice(clampedOffset, clampedOffset + layout.visibleHeight);
+	return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		paddingX: 1,
+		height: totalHeight,
+		children: [
+			/* @__PURE__ */ jsx(Text, {
+				bold: true,
+				children: "Audit plan"
+			}),
+			/* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: "Read-only review of installation, identification, and event capture"
+			}),
+			/* @__PURE__ */ jsx(Box, { height: 1 }),
+			/* @__PURE__ */ jsx(Header, { layout }),
+			/* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: "─".repeat(layout.dividerWidth)
+			}),
+			/* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: hiddenAbove > 0 ? `↑ ${hiddenAbove} more` : " "
+			}),
+			/* @__PURE__ */ jsx(Box, {
+				flexDirection: "column",
+				height: layout.visibleHeight,
+				overflow: "hidden",
+				children: visibleRows.map((node, i) => /* @__PURE__ */ jsx(Fragment, { children: node }, `row-${clampedOffset + i}`))
+			}),
+			/* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: hiddenBelow > 0 ? `↓ ${hiddenBelow} more` : " "
+			}),
+			/* @__PURE__ */ jsx(Footer, {
+				total: checks.length,
+				counts: statusCounts(checks)
+			})
+		]
+	});
+};
 //#endregion
-export { Icons as C, Colors as S, PickerMenu as _, ServiceHealthList as a, SplitView as b, HNViewer as c, EventPlanViewer as d, LogViewer as f, useStdoutDimensions as g, GroupedPickerMenu as h, SEVERITY_ORDER as i, TabContainer as l, ConfirmationInput as m, IssueTable as n, TipsCard as o, ModalOverlay as p, SEVERITY_LABEL as r, LearnCard as s, McpScreen as t, ScreenContainer as u, ProgressList as v, WizardStore as w, CardLayout as x, LoadingBox as y };
+export { Colors as C, CardLayout as S, WizardStore as T, useStdoutDimensions as _, SEVERITY_ORDER as a, LoadingBox as b, LearnCard as c, ScreenContainer as d, EventPlanViewer as f, GroupedPickerMenu as g, ConfirmationInput as h, SEVERITY_LABEL as i, HNViewer as l, ModalOverlay as m, McpScreen as n, ServiceHealthList as o, LogViewer as p, IssueTable as r, TipsCard as s, AuditChecksViewer as t, TabContainer as u, PickerMenu as v, Icons as w, SplitView as x, ProgressList as y };
 
-//# sourceMappingURL=McpScreen-DvUncZBi.js.map
+//# sourceMappingURL=AuditChecksViewer-DsfXIO9e.js.map