@posthog/wizard 2.52.0 → 2.53.0

package/dist/{terminal-tbxhJGlI.js → terminal-q-Sd8CdO.js}

@@ -1,19 +1,20 @@
-import { B as POSTHOG_APP_URL, ft as getSkillsBaseUrl, h as SERVICE_LABELS, s as logToFile } from "./debug-C3ZR1TVF.js";
-import { n as analytics } from "./analytics-BXz4SIuS.js";
-import { i as withUtm, n as openTrackedLink } from "./telemetry-qeKIGkte.js";
-import { t as getOrAskForProjectData } from "./setup-utils-DDzEnDxJ.js";
-import { a as fetchUserData, i as fetchSlackConnected } from "./api-BaacjH-Y.js";
+import { V as POSTHOG_APP_URL, ft as WIZARD_USER_AGENT, h as SERVICE_LABELS, pt as getSkillsBaseUrl, s as logToFile } from "./debug-tCr3A18e.js";
+import { n as analytics } from "./analytics-BC3iiS1p.js";
+import { i as withUtm, n as openTrackedLink } from "./telemetry-5NqJBWNN.js";
+import { t as getOrAskForProjectData } from "./setup-utils-t0jzKwBE.js";
+import { a as fetchUserData, i as fetchSlackConnected } from "./api-CXk-efCU.js";
 import "./wizard-session-BAZql11N.js";
-import { a as formatTokenCount, i as formatCostUsd } from "./agent-runner-B1qCtjid.js";
-import { b as fetchSkillMenu } from "./agent-interface-DoFVHRFh.js";
-import { y as AUDIT_SEVERITY_STYLE } from "./yara-hooks-CKsVxWiN.js";
-import { c as TextBlock, d as isLinesBlock, f as isObjectBlock, l as computeVisibleRange, m as Icons, p as Colors, u as isClearBlock } from "./posthog-integration-pnxhTbxw.js";
-import { a as ConfirmButton, d as Program, i as useKeyboardHintsContext, n as useKeyBindings, o as PromptLabel, r as KeyboardHintsProvider, t as PickerMenu, v as getKindMeta } from "./bin.js";
-import { r as totalTokenCount } from "./store-BCRdtfOH.js";
-import { n as AVAILABLE_FEATURES, o as isAllFeaturesSelected, t as ALL_FEATURE_VALUES } from "./defaults-DAE9_QMn.js";
+import { a as formatTokenCount, i as formatCostUsd } from "./agent-runner-CPuubcP_.js";
+import { x as fetchSkillMenu } from "./agent-interface-xWyATfJi.js";
+import { y as AUDIT_SEVERITY_STYLE } from "./yara-hooks-Cu0rEw1L.js";
+import { c as TextBlock, d as isClearBlock, f as isLinesBlock, h as Icons, l as computeVisibleRange, m as Colors, p as isObjectBlock } from "./posthog-integration-Bd-kybes.js";
+import { a as useStdoutDimensions, f as Program, i as useKeyboardHintsContext, n as useKeyBindings, o as ConfirmButton, r as KeyboardHintsProvider, s as PromptLabel, t as PickerMenu, y as getKindMeta } from "./bin.js";
+import { r as totalTokenCount } from "./store-qv5UdGQO.js";
+import { n as AVAILABLE_FEATURES, o as isAllFeaturesSelected, t as ALL_FEATURE_VALUES } from "./defaults-BWLIffh5.js";
 import opn from "opn";
 import * as fs$1 from "fs";
-import { Box, Text, measureElement, useInput, useStdout } from "ink";
+import axios from "axios";
+import { Box, Text, measureElement, useInput } from "ink";
 import { Component, Fragment, useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 import { Spinner } from "@inkjs/ui";
@@ -123,35 +124,6 @@ const ProgressList = ({ items, title }) => {
 	});
 };
 //#endregion
-//#region src/ui/tui/hooks/useStdoutDimensions.ts
-/**
-* useStdoutDimensions — Returns [columns, rows] and re-renders on terminal resize.
-*
-* Ink's useStdout() does not subscribe to resize events, so layout only updates
-* when something else causes a re-render. This hook listens to the stream's
-* 'resize' event (Node TTY) and updates state so the component re-renders
-* with the new dimensions.
-*/
-function useStdoutDimensions() {
-	const { stdout } = useStdout();
-	const [size, setSize] = useState(() => [stdout.columns || 80, stdout.rows || 24]);
-	useEffect(() => {
-		setSize([stdout.columns || 80, stdout.rows || 24]);
-		const stream = stdout;
-		if (typeof stream.on !== "function") return;
-		const onResize = () => {
-			const c = stdout.columns || 80;
-			const r = stdout.rows || 24;
-			if (c > 0 && r > 0) setSize([c, r]);
-		};
-		stream.on("resize", onResize);
-		return () => {
-			stream.off?.("resize", onResize);
-		};
-	}, [stdout]);
-	return size;
-}
-//#endregion
 //#region src/ui/tui/primitives/GroupedPickerMenu.tsx
 /**
 * GroupedPickerMenu — Multi-select with category headers.
@@ -182,6 +154,12 @@ const CHROME_OVERHEAD = 10;
 * single border top/bottom (2) + button text (1).
 */
 const MENU_CHROME = 6;
+/**
+* Max visual rows the list renders regardless of terminal height, so a tall
+* terminal doesn't turn the menu into a full-screen wall. Mirrors
+* PickerMenu's MAX_LIST_ROWS.
+*/
+const MAX_LIST_ROWS = 12;
 /** Count the visual rows occupied by rows[start..end), accounting for header margins. */
 function countVisualRows(rows, start, end) {
 	let count = 0;
@@ -243,7 +221,7 @@ const GroupedPickerMenu = ({ message, groups, initialSelected, onSelect }) => {
 	const [selected, setSelected] = useState(() => new Set(initialSelected ?? allValues));
 	const [scrollOffset, setScrollOffset] = useState(0);
 	const focusedRowIdx = selectableIndices[focusedSelectable] ?? 0;
-	const viewportBudget = Math.max(5, termRows - CHROME_OVERHEAD - MENU_CHROME);
+	const viewportBudget = Math.max(5, Math.min(termRows - CHROME_OVERHEAD - MENU_CHROME, MAX_LIST_ROWS));
 	const needsScroll = countVisualRows(rows, 0, rows.length) > viewportBudget;
 	const effectiveBudget = needsScroll ? viewportBudget - 2 : viewportBudget;
 	useKeyBindings("grouped-picker", [
@@ -311,7 +289,7 @@ const GroupedPickerMenu = ({ message, groups, initialSelected, onSelect }) => {
 			/* @__PURE__ */ jsx(PromptLabel, { message }),
 			/* @__PURE__ */ jsxs(Box, {
 				flexDirection: "column",
-				marginTop: 1,
+				marginTop: message ? 1 : 0,
 				marginLeft: 2,
 				children: [
 					needsScroll && /* @__PURE__ */ jsx(Text, {
@@ -3065,6 +3043,82 @@ var neutralCrossSell = [{
 	"prompt": "List the top errors my users hit this week.",
 	"description": "Built-in error tracking — no separate tool."
 }];
+var generatedQuests = {
+	"funnel": {
+		"label": "Funnel your real events",
+		"prompt": "Build a funnel from these events in the most sensible order — {events} — over the last 30 days, and show me the biggest drop-off."
+	},
+	"trend": {
+		"label": "Trend {event}",
+		"prompt": "Show me a daily trend of {event} over the last 30 days and call out the biggest spike or dip."
+	},
+	"breakdown": {
+		"label": "Break down {event}",
+		"prompt": "Break down {event} over the last 30 days by the most common user property and show me the top segments."
+	}
+};
+var writeOnlyQuests = [{
+	"key": "verify",
+	"prompt": "Annotate today with 'PostHog wizard install'",
+	"description": "Creates a dated note on your project — visible on every chart. Delete anytime from PostHog."
+}, {
+	"key": "starter-dashboard",
+	"prompt": "Create a starter dashboard called 'My first dashboard (wizard MCP tutorial)' with a daily-active-users tile and a top-events tile.",
+	"description": "A real dashboard you can build on — no event history required."
+}];
+var activationCrossSell = {
+	"errorTracking": {
+		"product": "Error Tracking",
+		"label": "see what it'd catch",
+		"prompt": "I don't have error tracking data yet. Show me how to turn on PostHog Error Tracking in my stack and what it would capture.",
+		"description": "Built-in exception tracking — no separate Sentry bill."
+	},
+	"sessionReplay": {
+		"product": "Session Replay",
+		"label": "watch real sessions",
+		"prompt": "I don't have session recordings yet. Show me how to enable PostHog Session Replay and what I'd be able to see.",
+		"description": "Watch what users actually do — included on every plan."
+	},
+	"surveys": {
+		"product": "Surveys",
+		"label": "ask your users",
+		"prompt": "I'm not running surveys yet. Show me how to launch a PostHog survey and the kinds of questions teams ask.",
+		"description": "In-app surveys and NPS, collected next to your events."
+	},
+	"webAnalytics": {
+		"product": "Web Analytics",
+		"label": "GA-style dashboards",
+		"prompt": "I don't have pageview data yet. Show me how to enable PostHog Web Analytics and what the dashboard shows.",
+		"description": "First-party web analytics — no cookie banner."
+	},
+	"experiments": {
+		"product": "Experiments",
+		"label": "A/B test safely",
+		"prompt": "I haven't run experiments yet. Show me how PostHog Experiments work and what I'd need to start one.",
+		"description": "A/B tests that piggyback on your feature flags."
+	},
+	"featureFlags": {
+		"product": "Feature Flags",
+		"label": "ship behind a flag",
+		"prompt": "I don't have feature flags yet. Show me how to add a PostHog feature flag in my framework and how rollout works.",
+		"description": "Gradual rollouts and kill switches, evaluated locally."
+	},
+	"dataWarehouse": {
+		"product": "Data Warehouse",
+		"label": "join external data",
+		"prompt": "Show me how to connect a data warehouse source like Stripe to PostHog and what I could query once it's joined.",
+		"description": "Query Stripe / Salesforce / S3 alongside your events."
+	}
+};
+var seedOfferGreeting = {
+	"headline": "Fresh project — let's put something on the map.",
+	"bullets": [
+		"Your project hasn't logged events yet, so there's nothing to chart — yet.",
+		"I can send a small demo dataset so you can see funnels, trends, and dashboards in action.",
+		"Everything is tagged wizard_seed:true and uses wizard-demo-user-* distinct IDs — events are immutable in PostHog, but you can filter these out of any query."
+	],
+	"outro": "Want me to seed some demo data to explore?"
+};
 var slackApp = {
 	"learnMoreUrl": "https://posthog.com/slack",
 	"setupUrl": "https://app.posthog.com/integrations/slack",
@@ -3107,6 +3161,10 @@ const DEEP_DIVE_FOLLOW_UPS = deepDiveFollowUps;
 const CROSS_SELL_BY_ROLE = crossSellByRole;
 const NEUTRAL_CROSS_SELL = neutralCrossSell;
 const SLACK_APP = slackApp;
+const GENERATED_QUESTS = generatedQuests;
+const WRITE_ONLY_QUESTS = writeOnlyQuests;
+const ACTIVATION_CROSS_SELL = activationCrossSell;
+const SEED_OFFER_GREETING = seedOfferGreeting;
 const INTEGRATION_FAMILY = {
 	nextjs: "fullstack",
 	nuxt: "fullstack",
@@ -3239,6 +3297,158 @@ function getCrossSellPrompts(role) {
 	return CROSS_SELL_BY_ROLE[role];
 }
 /**
+* Order in which to offer activation cross-sells per role — products most
+* relevant to each audience first. Only products the scout found *absent*
+* are surfaced; this just picks which absent ones to lead with.
+*/
+const ACTIVATION_PRIORITY = {
+	founder: [
+		"sessionReplay",
+		"surveys",
+		"webAnalytics",
+		"experiments",
+		"dataWarehouse",
+		"errorTracking",
+		"featureFlags"
+	],
+	product: [
+		"sessionReplay",
+		"experiments",
+		"surveys",
+		"featureFlags",
+		"webAnalytics",
+		"errorTracking",
+		"dataWarehouse"
+	],
+	leadership: [
+		"surveys",
+		"dataWarehouse",
+		"sessionReplay",
+		"webAnalytics",
+		"experiments",
+		"errorTracking",
+		"featureFlags"
+	],
+	marketing: [
+		"sessionReplay",
+		"webAnalytics",
+		"surveys",
+		"experiments",
+		"dataWarehouse",
+		"featureFlags",
+		"errorTracking"
+	],
+	engineering: [
+		"errorTracking",
+		"sessionReplay",
+		"featureFlags",
+		"experiments",
+		"webAnalytics",
+		"dataWarehouse",
+		"surveys"
+	],
+	data: [
+		"dataWarehouse",
+		"experiments",
+		"sessionReplay",
+		"webAnalytics",
+		"errorTracking",
+		"surveys",
+		"featureFlags"
+	]
+};
+const NEUTRAL_ACTIVATION_PRIORITY = [
+	"sessionReplay",
+	"errorTracking",
+	"surveys",
+	"webAnalytics",
+	"experiments",
+	"featureFlags",
+	"dataWarehouse"
+];
+/** How many custom events to feed into a generated funnel prompt. */
+const FUNNEL_EVENT_LIMIT = 4;
+/** Fill `{placeholder}` tokens in a template; unknown tokens pass through. */
+function fillTemplate(template, vars) {
+	return template.replace(/\{(\w+)\}/g, (_, key) => vars[key] ?? `{${key}}`);
+}
+function getSeedOfferGreeting() {
+	return SEED_OFFER_GREETING;
+}
+/**
+* Generate quests from the project's REAL event names (idea 9). Returns a
+* funnel (when ≥2 custom events exist), a trend, and a breakdown — all
+* templated off `topCustomEvents`. Empty when there's nothing usable to
+* build from (no profile, degraded, or no custom events), so callers fall
+* back to the static kit.
+*/
+function getGeneratedQuests(profile) {
+	if (!profile || profile.degraded) return [];
+	const custom = profile.topCustomEvents;
+	if (custom.length === 0) return [];
+	const out = [];
+	const top = custom[0].name;
+	if (custom.length >= 2) {
+		const events = custom.slice(0, FUNNEL_EVENT_LIMIT).map((e) => e.name).join(", ");
+		out.push({
+			label: GENERATED_QUESTS.funnel.label,
+			prompt: fillTemplate(GENERATED_QUESTS.funnel.prompt, { events })
+		});
+	}
+	out.push({
+		label: fillTemplate(GENERATED_QUESTS.trend.label, { event: top }),
+		prompt: fillTemplate(GENERATED_QUESTS.trend.prompt, { event: top })
+	});
+	out.push({
+		label: fillTemplate(GENERATED_QUESTS.breakdown.label, { event: top }),
+		prompt: fillTemplate(GENERATED_QUESTS.breakdown.prompt, { event: top })
+	});
+	return out;
+}
+/**
+* Activation cross-sells (idea 4) for products the scout found NO data
+* for — turning a data-less dead end into "here's how to turn this on".
+* Ordered by role affinity, capped at `limit`. Empty when the profile is
+* missing/degraded (we only nag when we're confident a product is absent).
+*/
+function getActivationCrossSell(role, profile, limit = 2) {
+	if (!profile || profile.degraded) return [];
+	return (isTailoredRole(role) ? ACTIVATION_PRIORITY[role] : NEUTRAL_ACTIVATION_PRIORITY).filter((key) => profile.products[key] === false).slice(0, limit).map((key) => ACTIVATION_CROSS_SELL[key]).filter((o) => Boolean(o));
+}
+/**
+* The full, ordered candidate list for the tutorial picker, composed from
+* the scout's profile. The screen dedupes by prompt text and slices to its
+* display cap — this function owns *what* to offer and in what priority:
+*
+*   • no profile / degraded → legacy composition (pinned + cross-sell + kit)
+*   • empty                 → write-only quests + activation cross-sells
+*                             (no reads that would return nothing)
+*   • rich (+ real events)   → generated quests first, one activation nudge,
+*                             then role kit for flavor
+*   • sparse                → a safe pinned read + one generated quest +
+*                             role kit + one activation nudge
+*/
+function getTutorialPicker(role, integration, profile) {
+	if (!profile || profile.degraded) return [
+		PINNED_FIRST_PROMPT,
+		...getCrossSellPrompts(role),
+		...getRolePrompts(role, integration)
+	];
+	if (profile.tier === "empty") return [...WRITE_ONLY_QUESTS, ...getActivationCrossSell(role, profile, 2)];
+	const generated = getGeneratedQuests(profile);
+	if (profile.tier === "rich" && generated.length > 0) return [
+		...generated,
+		...getActivationCrossSell(role, profile, 1),
+		...getRolePrompts(role, integration)
+	];
+	return [
+		PINNED_FIRST_PROMPT,
+		...generated.slice(0, 1),
+		...getRolePrompts(role, integration),
+		...getActivationCrossSell(role, profile, 1)
+	];
+}
+/**
 * Resolve the "Take PostHog to Slack" card. Role-independent — the Slack
 * agent's two capabilities (code/PR + data) describe the product itself,
 * not role-specific examples.
@@ -3253,6 +3463,217 @@ function getSlackAppCard() {
 	};
 }
 //#endregion
+//#region src/lib/mcp-project-profile.ts
+/**
+* Project data profile — a cheap, best-effort "scout" of what a user's
+* PostHog project actually contains. Run once after auth, before the MCP
+* tutorial picker, so the tutorial can adapt to the terrain instead of
+* offering prompts that hit a data-less dead end (the failure mode where
+* a freshly-installed project has no events and the agent narrates
+* emptiness because it was told this is a demo).
+*
+* The profile drives three data-aware behaviours in the tutorial:
+*   • tier        empty → offer to seed demo events; sparse/rich → go
+*                 straight to quests.
+*   • topEvents   quests are generated from the project's REAL event names
+*                 (e.g. a funnel between the two busiest custom events),
+*                 never from a generic hardcoded list.
+*   • products    a product with no data becomes an "enable X" cross-sell
+*                 (which routes through docs-search and always returns
+*                 something) instead of a read that comes back empty.
+*
+* Every probe is best-effort and time-boxed: a slow or failing call
+* resolves to a conservative fallback rather than throwing. The tutorial
+* must never be blocked, slowed, or broken by the scout — a degraded
+* profile (`degraded: true`) simply falls back to the static role kit and
+* skips activation cross-sells (we only nag the user to "enable X" when
+* we are CONFIDENT X is absent).
+*/
+const PROBE_TIMEOUT_MS = 5e3;
+const SPARSE_EVENT_THRESHOLD = 50;
+const TOP_EVENTS_LIMIT = 25;
+const PROBE_WINDOW_DAYS = 30;
+/**
+* Non-`$`-prefixed events that are still PostHog system noise, so they
+* don't get templated into quests as if they were product events.
+*/
+const NON_DOLLAR_SYSTEM_EVENTS = new Set([
+	"survey sent",
+	"survey shown",
+	"survey dismissed"
+]);
+/** Every product assumed present — the safe "don't nag" default. */
+const ALL_PRODUCTS_PRESENT = {
+	webAnalytics: true,
+	errorTracking: true,
+	sessionReplay: true,
+	surveys: true,
+	featureFlags: true,
+	experiments: true,
+	dataWarehouse: true
+};
+/**
+* Conservative fallback used when the core events probe fails. Tier is
+* `sparse` (not `empty`) so we neither offer to seed a project we can't
+* confirm is empty nor claim it's rich; `degraded` tells consumers to use
+* the static role kit and skip activation cross-sells.
+*/
+function degradedProfile() {
+	return {
+		tier: "sparse",
+		totalEvents: 0,
+		distinctEventCount: 0,
+		topEvents: [],
+		topCustomEvents: [],
+		products: { ...ALL_PRODUCTS_PRESENT },
+		seeded: false,
+		degraded: true
+	};
+}
+/** Is this event name PostHog system noise rather than a product event? */
+function isSystemEvent(name) {
+	return name.startsWith("$") || NON_DOLLAR_SYSTEM_EVENTS.has(name);
+}
+/**
+* True only when the given ingestion host is a PostHog-managed cloud
+* region we know maps to a working ingestion endpoint. Used as a gate on
+* the seed offer: PostHog events are immutable in ClickHouse, so we must
+* NOT offer to write demo events into a self-hosted deployment where we
+* can't be sure the ingestion route will succeed (and where the operator
+* hasn't opted in to us leaving artifacts). Cloud-hosted users have
+* consented to the wizard's writes as part of using the hosted service.
+*/
+function isKnownCloudHost(apiHost) {
+	try {
+		const { host } = new URL(apiHost);
+		return host === "us.i.posthog.com" || host === "eu.i.posthog.com";
+	} catch {
+		return false;
+	}
+}
+/**
+* Pure profile assembler — turns raw probe outputs into a classified
+* profile. Exported so tier classification, custom-event filtering, and
+* product derivation can be unit-tested without touching the network.
+*
+* `rest` carries the REST existence checks; a `null` entry means the
+* check was inconclusive (failed/timed out) and the product defaults to
+* present so we never nag the user to enable it.
+*/
+function assembleProfile(topEvents, rest, opts) {
+	const totalEvents = topEvents.reduce((sum, e) => sum + e.count, 0);
+	const distinctEventCount = topEvents.length;
+	const topCustomEvents = topEvents.filter((e) => !isSystemEvent(e.name));
+	const has = (name) => topEvents.some((e) => e.name === name && e.count > 0);
+	let tier;
+	if (totalEvents === 0) tier = "empty";
+	else if (totalEvents < SPARSE_EVENT_THRESHOLD || distinctEventCount < 2) tier = "sparse";
+	else tier = "rich";
+	return {
+		tier,
+		totalEvents,
+		distinctEventCount,
+		topEvents,
+		topCustomEvents,
+		products: {
+			webAnalytics: has("$pageview"),
+			errorTracking: has("$exception"),
+			sessionReplay: rest.sessionReplay ?? true,
+			surveys: rest.surveys ?? true,
+			featureFlags: rest.featureFlags ?? true,
+			experiments: rest.experiments ?? true,
+			dataWarehouse: rest.dataWarehouse ?? true
+		},
+		seeded: opts?.seeded ?? false,
+		degraded: false
+	};
+}
+/**
+* Run a single HogQL query returning the top events by volume in the
+* probe window. Throws on any failure — the caller degrades the whole
+* profile when the core events probe can't run.
+*/
+async function queryTopEvents(accessToken, projectId, baseUrl) {
+	const url = `${baseUrl}/api/projects/${projectId}/query/`;
+	const rows = (await axios.post(url, { query: {
+		kind: "HogQLQuery",
+		query: `SELECT event, count() AS c FROM events WHERE timestamp > now() - INTERVAL ${PROBE_WINDOW_DAYS} DAY GROUP BY event ORDER BY c DESC LIMIT ${TOP_EVENTS_LIMIT}`
+	} }, {
+		headers: {
+			Authorization: `Bearer ${accessToken}`,
+			"User-Agent": WIZARD_USER_AGENT,
+			"Content-Type": "application/json"
+		},
+		timeout: PROBE_TIMEOUT_MS
+	})).data?.results;
+	if (!Array.isArray(rows)) return [];
+	return rows.map((row) => {
+		if (!Array.isArray(row)) return null;
+		const name = String(row[0] ?? "");
+		const count = Number(row[1] ?? 0);
+		if (!name || !Number.isFinite(count)) return null;
+		return {
+			name,
+			count
+		};
+	}).filter((e) => e !== null);
+}
+/**
+* Best-effort existence check against a list endpoint. Resolves to:
+*   true   — at least one row exists
+*   false  — endpoint returned a clean empty list
+*   null   — inconclusive (error, timeout, unexpected shape)
+* Never throws; `null` lets the assembler default the product to present.
+*/
+async function restExists(accessToken, projectId, baseUrl, resource) {
+	try {
+		const results = (await axios.get(`${baseUrl}/api/projects/${projectId}/${resource}/`, {
+			params: { limit: 1 },
+			headers: {
+				Authorization: `Bearer ${accessToken}`,
+				"User-Agent": WIZARD_USER_AGENT
+			},
+			timeout: PROBE_TIMEOUT_MS
+		})).data?.results;
+		if (!Array.isArray(results)) return null;
+		return results.length > 0;
+	} catch {
+		return null;
+	}
+}
+/**
+* Scout a project: one HogQL query for event volume + event names, plus a
+* handful of parallel REST existence checks for products that aren't
+* derivable from the event stream. Always resolves — returns a degraded
+* profile if the core events query fails.
+*/
+async function probeProjectData(args) {
+	const { accessToken, projectId, apiHost } = args;
+	const baseUrl = apiHost.replace(/\/$/, "");
+	try {
+		const [events, sessionReplay, surveys, featureFlags, experiments, warehouse] = await Promise.all([
+			queryTopEvents(accessToken, projectId, baseUrl),
+			restExists(accessToken, projectId, baseUrl, "session_recordings"),
+			restExists(accessToken, projectId, baseUrl, "surveys"),
+			restExists(accessToken, projectId, baseUrl, "feature_flags"),
+			restExists(accessToken, projectId, baseUrl, "experiments"),
+			restExists(accessToken, projectId, baseUrl, "warehouse_tables")
+		]);
+		const profile = assembleProfile(events, {
+			sessionReplay,
+			surveys,
+			featureFlags,
+			experiments,
+			dataWarehouse: warehouse
+		});
+		logToFile(`[probeProjectData] tier=${profile.tier} totalEvents=${profile.totalEvents} distinct=${profile.distinctEventCount} custom=${profile.topCustomEvents.length}`);
+		return profile;
+	} catch (err) {
+		logToFile(`[probeProjectData] degraded — probe failed: ${err instanceof Error ? err.message : String(err)}`);
+		return degradedProfile();
+	}
+}
+//#endregion
 //#region src/ui/tui/screens/McpSuggestedPromptsScreen.tsx
 /**
 * McpSuggestedPromptsScreen — shown after MCP install succeeds in the
@@ -3297,10 +3718,14 @@ const FOLLOW_UP_DELAY_MS = 3e3;
 const McpSuggestedPromptsScreen = ({ store, services }) => {
 	useSyncExternalStore((cb) => store.subscribe(cb), () => store.getSnapshot());
 	const session = store.session;
-	const kit = getRolePrompts(session.roleAtOrganization, session.integration);
-	const crossSell = useMemo(() => getCrossSellPrompts(session.roleAtOrganization), [session.roleAtOrganization]);
-	const greeting = useMemo(() => getRoleGreeting(session.roleAtOrganization), [session.roleAtOrganization]);
 	const [phase, setPhase] = useState("choose");
+	const [profile, setProfile] = useState(null);
+	const greeting = useMemo(() => getRoleGreeting(session.roleAtOrganization), [session.roleAtOrganization]);
+	const pickerCandidates = useMemo(() => getTutorialPicker(session.roleAtOrganization, session.integration, profile), [
+		session.roleAtOrganization,
+		session.integration,
+		profile
+	]);
 	const [loginError, setLoginError] = useState(null);
 	const startedTutorialRef = useRef(false);
 	const [runningPrompt, setRunningPrompt] = useState(null);
@@ -3313,6 +3738,7 @@ const McpSuggestedPromptsScreen = ({ store, services }) => {
 	const [lastToolCommand, setLastToolCommand] = useState(null);
 	const [branchHistory, setBranchHistory] = useState([]);
 	const runAbortRef = useRef(null);
+	const seedStartedRef = useRef(false);
 	const currentSessionIdRef = useRef(null);
 	useEffect(() => {
 		if (phase !== "authenticating") return;
@@ -3325,7 +3751,7 @@ const McpSuggestedPromptsScreen = ({ store, services }) => {
 				store.setRoleAtOrganization(roleAtOrganization);
 				store.setApiUser(user);
 				store.setLoginUrl(null);
-				setPhase(startedTutorialRef.current ? "greeting" : "choose");
+				setPhase(startedTutorialRef.current ? "scouting" : "choose");
 			} catch (err) {
 				if (cancelled) return;
 				const message = err instanceof Error ? err.message : String(err);
@@ -3343,6 +3769,77 @@ const McpSuggestedPromptsScreen = ({ store, services }) => {
 		services,
 		store
 	]);
+	useEffect(() => {
+		if (phase !== "scouting") return;
+		if (!session.credentials) return;
+		let cancelled = false;
+		const credentials = session.credentials;
+		(async () => {
+			let probed;
+			try {
+				probed = await services.probeProjectData(credentials);
+			} catch (err) {
+				logToFile(`[McpSuggestedPromptsScreen] probe failed: ${err instanceof Error ? err.message : String(err)}`);
+				probed = degradedProfile();
+			}
+			if (cancelled) return;
+			setProfile(probed);
+			const offerSeed = probed.tier === "empty" && isKnownCloudHost(credentials.host.apiHost);
+			analytics.wizardCapture("mcp suggested prompts scouted", {
+				tier: probed.tier,
+				totalEvents: probed.totalEvents,
+				distinctEvents: probed.distinctEventCount,
+				degraded: probed.degraded,
+				offerSeed
+			});
+			setPhase(offerSeed ? "seed-offer" : "greeting");
+		})();
+		return () => {
+			cancelled = true;
+		};
+	}, [
+		phase,
+		services,
+		session.credentials
+	]);
+	useEffect(() => {
+		if (phase !== "seeding") return;
+		if (seedStartedRef.current) return;
+		if (!session.credentials || !profile) return;
+		seedStartedRef.current = true;
+		let cancelled = false;
+		const controller = new AbortController();
+		const credentials = session.credentials;
+		const baseProfile = profile;
+		(async () => {
+			try {
+				const seeded = await services.seedDemoEvents({
+					credentials,
+					baseProfile,
+					signal: controller.signal
+				});
+				if (cancelled) return;
+				setProfile(seeded);
+				analytics.wizardCapture("mcp suggested prompts seeded", { totalEvents: seeded.totalEvents });
+			} catch (err) {
+				if (cancelled) return;
+				const message = err instanceof Error ? err.message : String(err);
+				logToFile(`[McpSuggestedPromptsScreen] seeding failed: ${message}`);
+				analytics.wizardCapture("mcp suggested prompts seed failed", { error: message });
+			}
+			if (cancelled) return;
+			setPhase("greeting");
+		})();
+		return () => {
+			cancelled = true;
+			controller.abort();
+		};
+	}, [
+		phase,
+		services,
+		session.credentials,
+		profile
+	]);
 	useEffect(() => {
 		if (phase !== "running") return;
 		if (!runningPrompt) return;
@@ -3433,12 +3930,21 @@ const McpSuggestedPromptsScreen = ({ store, services }) => {
 		if (choice === "login") {
 			analytics.wizardCapture("mcp suggested prompts choose", { choice: "login" });
 			startedTutorialRef.current = true;
-			setPhase(session.credentials ? "greeting" : "authenticating");
+			setPhase(session.credentials ? "scouting" : "authenticating");
 		} else {
 			analytics.wizardCapture("mcp suggested prompts choose", { choice: "exit" });
 			enterGoodbye();
 		}
 	};
+	const handleSeedChoice = (value) => {
+		if ((Array.isArray(value) ? value[0] : value) === "seed") {
+			analytics.wizardCapture("mcp suggested prompts seed offer", { choice: "seed" });
+			setPhase("seeding");
+		} else {
+			analytics.wizardCapture("mcp suggested prompts seed offer", { choice: "skip" });
+			setPhase("greeting");
+		}
+	};
 	const startRun = (prompt) => {
 		setRunningPrompt(prompt);
 		setRunCount((c) => c + 1);
@@ -3473,7 +3979,7 @@ const McpSuggestedPromptsScreen = ({ store, services }) => {
 			handler: () => {
 				if (phase === "goodbye") closeWizard();
 				else if (phase === "authenticating") setPhase("choose");
-				else if (phase === "running" || phase === "prompt-picker" || phase === "follow-up" || phase === "greeting") enterGoodbye();
+				else if (phase === "running" || phase === "prompt-picker" || phase === "follow-up" || phase === "greeting" || phase === "scouting" || phase === "seed-offer" || phase === "seeding") enterGoodbye();
 			}
 		},
 		{
@@ -3509,14 +4015,16 @@ const McpSuggestedPromptsScreen = ({ store, services }) => {
 					onSelect: handleChoice
 				}),
 				phase === "authenticating" && /* @__PURE__ */ jsx(AuthenticatingPhase, { loginUrl: session.loginUrl }),
+				phase === "scouting" && /* @__PURE__ */ jsx(ScoutingPhase, {}),
+				phase === "seed-offer" && /* @__PURE__ */ jsx(SeedOfferPhase, { onSelect: handleSeedChoice }),
+				phase === "seeding" && /* @__PURE__ */ jsx(SeedingPhase, {}),
 				phase === "greeting" && /* @__PURE__ */ jsx(GreetingPhase, {
 					greeting,
 					userDisplayName: session.apiUser?.first_name || null,
 					onComplete: () => setPhase("prompt-picker")
 				}),
 				phase === "prompt-picker" && /* @__PURE__ */ jsx(PromptPickerPhase, {
-					promptKit: kit,
-					crossSell,
+					candidates: pickerCandidates,
 					onSelect: handlePromptPick
 				}),
 				phase === "running" && runningPrompt && /* @__PURE__ */ jsx(RunningPhase, {
@@ -3562,6 +4070,7 @@ const McpSuggestedPromptsScreen = ({ store, services }) => {
 					installedClients: session.mcpInstalledClients,
 					role: session.roleAtOrganization,
 					integration: session.integration,
+					profile,
 					engaged: branchHistory.length > 0,
 					onClose: closeWizard
 				})
@@ -3655,6 +4164,90 @@ const AuthenticatingPhase = ({ loginUrl }) => /* @__PURE__ */ jsxs(Box, {
 		] })
 	})]
 });
+const ScoutingPhase = () => /* @__PURE__ */ jsxs(Box, {
+	flexDirection: "column",
+	children: [/* @__PURE__ */ jsx(Box, {
+		marginBottom: 1,
+		children: /* @__PURE__ */ jsx(Text, {
+			bold: true,
+			color: Colors.accent,
+			children: "MCP tutorial"
+		})
+	}), /* @__PURE__ */ jsx(LoadingBox, { message: "Scouting your project for data…" })]
+});
+const SeedOfferPhase = ({ onSelect }) => {
+	const copy = getSeedOfferGreeting();
+	return /* @__PURE__ */ jsxs(Box, {
+		flexDirection: "column",
+		children: [
+			/* @__PURE__ */ jsx(Box, {
+				marginBottom: 1,
+				children: /* @__PURE__ */ jsx(Text, {
+					bold: true,
+					color: Colors.accent,
+					children: copy.headline
+				})
+			}),
+			/* @__PURE__ */ jsx(Box, {
+				marginBottom: 1,
+				flexDirection: "column",
+				children: copy.bullets.map((bullet, i) => /* @__PURE__ */ jsxs(Text, { children: [
+					/* @__PURE__ */ jsx(Text, {
+						color: Colors.primary,
+						children: Icons.diamond
+					}),
+					" ",
+					/* @__PURE__ */ jsx(Text, {
+						dimColor: true,
+						children: bullet
+					})
+				] }, i))
+			}),
+			/* @__PURE__ */ jsx(Box, {
+				marginBottom: 1,
+				children: /* @__PURE__ */ jsx(Text, { children: copy.outro })
+			}),
+			/* @__PURE__ */ jsx(PickerMenu, {
+				options: [{
+					label: "Yes — send demo data",
+					value: "seed"
+				}, {
+					label: "No thanks, skip",
+					value: "skip"
+				}],
+				onSelect
+			}),
+			/* @__PURE__ */ jsx(Box, {
+				marginTop: 2,
+				children: /* @__PURE__ */ jsxs(Text, { children: [/* @__PURE__ */ jsx(Text, {
+					bold: true,
+					children: "[esc]"
+				}), /* @__PURE__ */ jsx(Text, { children: " to exit" })] })
+			})
+		]
+	});
+};
+const SeedingPhase = () => /* @__PURE__ */ jsxs(Box, {
+	flexDirection: "column",
+	children: [
+		/* @__PURE__ */ jsx(Box, {
+			marginBottom: 1,
+			children: /* @__PURE__ */ jsx(Text, {
+				bold: true,
+				color: Colors.accent,
+				children: "MCP tutorial"
+			})
+		}),
+		/* @__PURE__ */ jsx(LoadingBox, { message: "Sending demo events to your project…" }),
+		/* @__PURE__ */ jsx(Box, {
+			marginTop: 1,
+			children: /* @__PURE__ */ jsx(Text, {
+				dimColor: true,
+				children: "Backdated across the last 7 days, so your funnels and trends light up right away."
+			})
+		})
+	]
+});
 const GreetingPhase = ({ greeting, userDisplayName, onComplete }) => {
 	const blocks = [];
 	if (userDisplayName) blocks.push({
@@ -3708,13 +4301,9 @@ const GreetingPhase = ({ greeting, userDisplayName, onComplete }) => {
 		})]
 	});
 };
-const PromptPickerPhase = ({ promptKit, crossSell, onSelect }) => {
+const PromptPickerPhase = ({ candidates, onSelect }) => {
 	const seenPrompts = /* @__PURE__ */ new Set();
-	const options = [
-		PINNED_FIRST_PROMPT,
-		...crossSell,
-		...promptKit
-	].filter((o) => {
+	const options = candidates.filter((o) => {
 		if (seenPrompts.has(o.prompt)) return false;
 		seenPrompts.add(o.prompt);
 		return true;
@@ -3912,8 +4501,9 @@ const FollowUpPhase = ({ lastToolName, lastToolCommand, lastPrompt, chunks, role
 		})]
 	});
 };
-const GoodbyePhase = ({ installedClients, role, integration, engaged, onClose }) => {
-	const samples = getRolePrompts(role, integration).slice(0, 3);
+const GoodbyePhase = ({ installedClients, role, integration, profile, engaged, onClose }) => {
+	const generated = getGeneratedQuests(profile);
+	const samples = (generated.length > 0 ? generated : getRolePrompts(role, integration)).slice(0, 3);
 	const headline = engaged ? "Nice work. You can keep talking to PostHog anytime." : "You're all set — PostHog MCP is here when you're ready.";
 	const introLine = installedClients.length > 0 ? /* @__PURE__ */ jsxs(Text, { children: [
 		"MCP is set up in",
@@ -3955,6 +4545,26 @@ const GoodbyePhase = ({ installedClients, role, integration, engaged, onClose })
 					})
 				] }, i))
 			}),
+			profile?.seeded && /* @__PURE__ */ jsx(Box, {
+				marginBottom: 1,
+				children: /* @__PURE__ */ jsxs(Text, {
+					dimColor: true,
+					children: [
+						"Demo data is tagged ",
+						/* @__PURE__ */ jsx(Text, {
+							bold: true,
+							children: "wizard_seed:true"
+						}),
+						" and uses",
+						" ",
+						/* @__PURE__ */ jsx(Text, {
+							bold: true,
+							children: "wizard-demo-user-*"
+						}),
+						" distinct IDs — events are immutable in PostHog, but you can filter these out of any query or dashboard."
+					]
+				})
+			}),
 			/* @__PURE__ */ jsx(Box, {
 				marginBottom: 1,
 				children: /* @__PURE__ */ jsxs(Text, {
@@ -3981,6 +4591,140 @@ const GoodbyePhase = ({ installedClients, role, integration, engaged, onClose })
 	});
 };
 //#endregion
+//#region src/lib/mcp-seed-events.ts
+/**
+* Demo-event seeder for the MCP tutorial's empty-project path.
+*
+* When the scout (`probeProjectData`) finds a project with zero events, the
+* tutorial offers to send a small, coherent demo dataset so the read
+* quests have something real to chew on instead of dead-ending. The
+* dataset is a recognizable SaaS product funnel —
+*
+*   $pageview → signed_up → activated → feature_used → upgraded_to_paid
+*
+* — spread across ~12 synthetic users and backdated over the last 7 days,
+* so time-windowed funnels and trends include the data the moment it lands
+* (sidestepping ingestion lag for the queries the tutorial actually runs).
+*
+* Every seeded event carries `wizard_seed: true` and a synthetic
+* `wizard-demo-user-*` distinct id, so the user can find and clean up the
+* demo data from a single search in PostHog — the same "leave a trail"
+* principle as the `(wizard MCP tutorial)` artifact tagging.
+*
+* `$exception` is deliberately NOT seeded: leaving error tracking empty
+* keeps it available as an "enable error tracking" activation cross-sell,
+* which is exactly the kind of product-discovery beat the empty path is
+* meant to create.
+*/
+const SEED_USER_COUNT = 12;
+const DAY_MS = 1440 * 60 * 1e3;
+const demoUser = (i) => `wizard-demo-user-${i + 1}`;
+/**
+* A timestamp `daysAgo` days plus `hour` hours BEFORE `now`. Both offsets
+* are subtracted so every seeded event lands strictly in the past (daysAgo
+* maxes at 6 and hour at ~15, keeping the oldest event under the 7-day
+* window the tutorial's queries use).
+*/
+const at = (now, daysAgo, hour) => /* @__PURE__ */ new Date(now.getTime() - daysAgo * DAY_MS - hour * 60 * 60 * 1e3);
+/**
+* Build the deterministic demo dataset. Deterministic (no randomness) so
+* the returned profile counts always match what was sent and tests are
+* stable. Drop-off down the funnel is modelled by fewer users reaching
+* each step.
+*/
+function buildSeedEvents(now) {
+	const events = [];
+	const push = (event, userIdx, daysAgo, hour, properties = {}) => {
+		events.push({
+			event,
+			distinctId: demoUser(userIdx),
+			timestamp: at(now, daysAgo, hour),
+			properties: {
+				...properties,
+				wizard_seed: true
+			}
+		});
+	};
+	const PAGES = [
+		"/",
+		"/pricing",
+		"/signup",
+		"/app"
+	];
+	for (let i = 0; i < SEED_USER_COUNT; i++) for (let k = 0; k < 4; k++) push("$pageview", i, (i + k) % 7, 9 + k, { $current_url: `https://example.com${PAGES[k % PAGES.length]}` });
+	for (let i = 0; i < 10; i++) push("signed_up", i, 6 - i % 7, 10, { source: i % 2 ? "organic" : "ads" });
+	for (let i = 0; i < 7; i++) push("activated", i, 5 - i % 6, 11);
+	const FEATURES = [
+		"dashboards",
+		"insights",
+		"session_replay"
+	];
+	for (let i = 0; i < 7; i++) for (let k = 0; k < 3; k++) push("feature_used", i, 4 - (i + k) % 5, 12 + k, { feature: FEATURES[k % FEATURES.length] });
+	for (let i = 0; i < 3; i++) push("upgraded_to_paid", i, 2 - i % 3, 13, { plan: "pro" });
+	return events;
+}
+/** Tally a seed-event list into volume-sorted `EventVolume[]`. */
+function tallySeedEvents(events) {
+	const counts = /* @__PURE__ */ new Map();
+	for (const e of events) counts.set(e.event, (counts.get(e.event) ?? 0) + 1);
+	return [...counts.entries()].map(([name, count]) => ({
+		name,
+		count
+	})).sort((a, b) => b.count - a.count);
+}
+/**
+* The profile a successful seed produces, without sending anything.
+* Event-derived fields come from the demo dataset; REST-derived product
+* presence is carried forward from the pre-seed probe (so a project that
+* already had, say, feature flags defined keeps that signal). Exported so
+* the screen can preview the seeded state and tests can assert on it.
+*/
+function seededProfile(baseProfile, now) {
+	return assembleProfile(tallySeedEvents(buildSeedEvents(now)), {
+		sessionReplay: baseProfile.products.sessionReplay,
+		surveys: baseProfile.products.surveys,
+		featureFlags: baseProfile.products.featureFlags,
+		experiments: baseProfile.products.experiments,
+		dataWarehouse: baseProfile.products.dataWarehouse
+	}, { seeded: true });
+}
+/**
+* Send the demo dataset to the project's ingestion endpoint via
+* posthog-node, then resolve with the seeded profile. Throws if the send
+* fails so the caller can surface a soft error and fall back to the
+* write-only empty path.
+*/
+async function seedDemoEvents(args) {
+	const { projectApiKey, apiHost, baseProfile, signal } = args;
+	const now = args.now ?? /* @__PURE__ */ new Date();
+	if (signal?.aborted) throw new Error("Seeding aborted");
+	const events = buildSeedEvents(now);
+	logToFile(`[seedDemoEvents] sending ${events.length} demo events to ${apiHost}`);
+	const { PostHog } = await import("posthog-node");
+	const client = new PostHog(projectApiKey, {
+		host: apiHost,
+		flushAt: events.length,
+		flushInterval: 0,
+		disableGeoip: true
+	});
+	try {
+		for (const e of events) client.capture({
+			distinctId: e.distinctId,
+			event: e.event,
+			properties: e.properties,
+			timestamp: e.timestamp
+		});
+		await client.shutdown();
+	} catch (err) {
+		try {
+			await client.shutdown();
+		} catch {}
+		throw err;
+	}
+	if (signal?.aborted) throw new Error("Seeding aborted");
+	return seededProfile(baseProfile, now);
+}
+//#endregion
 //#region src/ui/tui/screens/audit/AuditChecksViewer/AreaHeaderRow.tsx
 /** Sub-header row inside the scrollable body — one per area group. */
 const AreaHeaderRow = ({ area, resolved, total }) => /* @__PURE__ */ jsxs(Box, {
@@ -5510,6 +6254,6 @@ function releaseTerminal() {
 	process.stdout.write(RESET_ATTRS + LEAVE_ALT_SCREEN);
 }
 //#endregion
-export { ConfirmationInput as A, TabContainer as C, LinkText as D, LogViewer as E, SplitView as F, CardLayout as I, useStdoutDimensions as M, ProgressList as N, extractUrls as O, LoadingBox as P, HNViewer as S, EventPlanViewer as T, SEVERITY_ORDER as _, useSkillEntry as a, LearnCard as b, SlackConnectScreen as c, AuditChecksViewer as d, McpSuggestedPromptsScreen as f, SEVERITY_LABEL as g, IssueTable as h, SkillSourceInfo as i, GroupedPickerMenu as j, ModalOverlay as k, AUDIT_AREA_SLIDES as l, McpScreen as m, releaseTerminal as n, OutroScreen as o, TAILORED_ROLES as p, AiOptInRequiredScreen as r, useDismissOnAnyKey as s, enterDarkTerminal as t, VisualBox as u, ServiceHealthList as v, ScreenContainer as w, ContentSequencer as x, TipsCard as y };
+export { LogViewer as A, TipsCard as C, TabContainer as D, HNViewer as E, GroupedPickerMenu as F, ProgressList as I, LoadingBox as L, extractUrls as M, ModalOverlay as N, ScreenContainer as O, ConfirmationInput as P, SplitView as R, ServiceHealthList as S, ContentSequencer as T, TAILORED_ROLES as _, useSkillEntry as a, SEVERITY_LABEL as b, SlackConnectScreen as c, AuditChecksViewer as d, seedDemoEvents as f, probeProjectData as g, assembleProfile as h, SkillSourceInfo as i, LinkText as j, EventPlanViewer as k, AUDIT_AREA_SLIDES as l, McpSuggestedPromptsScreen as m, releaseTerminal as n, OutroScreen as o, seededProfile as p, AiOptInRequiredScreen as r, useDismissOnAnyKey as s, enterDarkTerminal as t, VisualBox as u, McpScreen as v, LearnCard as w, SEVERITY_ORDER as x, IssueTable as y, CardLayout as z };
 
-//# sourceMappingURL=terminal-tbxhJGlI.js.map
+//# sourceMappingURL=terminal-q-Sd8CdO.js.map