@amplitude/wizard 1.0.0-beta.0

package/dist/src/ui/tui/screens/ActivationOptionsScreen.js

@@ -0,0 +1,57 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+/**
+ * ActivationOptionsScreen — "What would you like to do?" prompt.
+ *
+ * Shown when the user has the SDK installed but hasn't fully activated yet
+ * (1–49 events). Offers next-step options without forcing a full re-run.
+ */
+import { Box, Text } from 'ink';
+import { useSyncExternalStore } from 'react';
+import { PickerMenu } from '../primitives/index.js';
+import { Colors } from '../styles.js';
+import { OutroKind } from '../../../lib/wizard-session.js';
+import { OUTBOUND_URLS } from '../../../lib/constants.js';
+import opn from 'opn';
+const DOCS_URL = OUTBOUND_URLS.sdkDocs;
+export const ActivationOptionsScreen = ({ store, }) => {
+    useSyncExternalStore((cb) => store.subscribe(cb), () => store.getSnapshot());
+    const { snippetConfigured } = store.session;
+    const handleSelect = (value) => {
+        switch (value) {
+            case 'test-locally':
+                // Route to Framework Detection by treating this as a new project
+                store.setActivationOptionsComplete();
+                break;
+            case 'debug':
+                // Run the agent in debug mode
+                store.setActivationOptionsComplete();
+                break;
+            case 'docs':
+                opn(DOCS_URL, { wait: false }).catch(() => {
+                    /* fire-and-forget */
+                });
+                // Stay on screen — don't advance
+                break;
+            case 'exit':
+                store.setOutroData({
+                    kind: OutroKind.Cancel,
+                    message: 'Come back once your app is deployed and sending events.',
+                });
+                break;
+        }
+    };
+    return (_jsxs(Box, { flexDirection: "column", flexGrow: 1, children: [_jsxs(Text, { bold: true, color: Colors.accent, children: ["Your SDK is", snippetConfigured ? ' installed' : ' partially set up', " \u2014 waiting for events"] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { color: Colors.muted, children: "We can see your project is configured but hasn't received many events yet." }), _jsx(Text, { color: Colors.muted, children: "What would you like to do?" })] }), _jsx(Box, { marginTop: 1, children: _jsx(PickerMenu, { options: [
+                        {
+                            value: 'test-locally',
+                            label: 'Help me test locally',
+                            hint: 'run the setup agent',
+                        },
+                        { value: 'debug', label: "I'm blocked", hint: 'debug with Claude' },
+                        { value: 'docs', label: 'Take me to the docs', hint: DOCS_URL },
+                        {
+                            value: 'exit',
+                            label: "I'm done for now",
+                            hint: 'exit and resume later',
+                        },
+                    ], onSelect: (v) => handleSelect(v) }) })] }));
+};

package/dist/src/ui/tui/screens/AuthScreen.d.ts

@@ -0,0 +1,18 @@
+/**
+ * AuthScreen — Multi-step authentication and account setup (SUSI flow).
+ *
+ * Steps:
+ *   1. OAuth waiting — spinner + login URL while browser auth happens
+ *   2. Org selection — picker if the user belongs to multiple orgs
+ *   3. Workspace selection — picker if the org has multiple workspaces
+ *   4. API key entry — text input for the Amplitude analytics write key
+ *
+ * The screen drives itself from session.pendingOrgs + session.credentials.
+ * When credentials are set the router resolves past this screen.
+ */
+import type { WizardStore } from '../store.js';
+interface AuthScreenProps {
+    store: WizardStore;
+}
+export declare const AuthScreen: ({ store }: AuthScreenProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/src/ui/tui/screens/AuthScreen.js

@@ -0,0 +1,107 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * AuthScreen — Multi-step authentication and account setup (SUSI flow).
+ *
+ * Steps:
+ *   1. OAuth waiting — spinner + login URL while browser auth happens
+ *   2. Org selection — picker if the user belongs to multiple orgs
+ *   3. Workspace selection — picker if the org has multiple workspaces
+ *   4. API key entry — text input for the Amplitude analytics write key
+ *
+ * The screen drives itself from session.pendingOrgs + session.credentials.
+ * When credentials are set the router resolves past this screen.
+ */
+import { Box, Text } from 'ink';
+import { useState, useEffect, useSyncExternalStore } from 'react';
+import { TextInput } from '@inkjs/ui';
+import { LoadingBox, PickerMenu } from '../primitives/index.js';
+import { Colors } from '../styles.js';
+import { DEFAULT_HOST_URL } from '../../../lib/constants.js';
+import { analytics } from '../../../utils/analytics.js';
+export const AuthScreen = ({ store }) => {
+    useSyncExternalStore((cb) => store.subscribe(cb), () => store.getSnapshot());
+    const { session } = store;
+    // Local step state — which org the user has selected in this render session
+    const [selectedOrg, setSelectedOrg] = useState(null);
+    const [apiKeyError, setApiKeyError] = useState('');
+    const [savedKeySource, setSavedKeySource] = useState(null);
+    const pendingOrgs = session.pendingOrgs;
+    // Auto-select the org when there's only one
+    const effectiveOrg = selectedOrg ?? (pendingOrgs?.length === 1 ? pendingOrgs[0] : null);
+    // Auto-select workspace when org has only one
+    const singleWorkspace = effectiveOrg?.workspaces.length === 1 ? effectiveOrg.workspaces[0] : null;
+    useEffect(() => {
+        if (effectiveOrg && singleWorkspace && !session.selectedWorkspaceId) {
+            store.setOrgAndWorkspace(effectiveOrg, singleWorkspace, session.installDir);
+        }
+    }, [effectiveOrg?.id, singleWorkspace?.id, session.selectedWorkspaceId]);
+    const workspaceChosen = session.selectedWorkspaceId !== null ||
+        (effectiveOrg !== null && effectiveOrg.workspaces.length === 1);
+    // Auto-advance past API key step if a saved key exists for this project
+    useEffect(() => {
+        if (!workspaceChosen || session.credentials !== null)
+            return;
+        void import('../../../utils/api-key-store.js').then(({ readApiKeyWithSource }) => {
+            const result = readApiKeyWithSource(session.installDir);
+            if (result) {
+                setSavedKeySource(result.source);
+                analytics.wizardCapture('api key submitted', {
+                    key_source: result.source,
+                });
+                store.setCredentials({
+                    accessToken: session.pendingAuthAccessToken ?? '',
+                    idToken: session.pendingAuthIdToken ?? undefined,
+                    projectApiKey: result.key,
+                    host: DEFAULT_HOST_URL,
+                    projectId: 0,
+                });
+                store.setProjectHasData(false);
+            }
+        });
+    }, [workspaceChosen, session.credentials]);
+    const needsOrgPick = pendingOrgs !== null && pendingOrgs.length > 1 && effectiveOrg === null;
+    const needsWorkspacePick = effectiveOrg !== null &&
+        effectiveOrg.workspaces.length > 1 &&
+        !session.selectedWorkspaceId;
+    const needsApiKey = effectiveOrg !== null && workspaceChosen && session.credentials === null;
+    const handleApiKeySubmit = (value) => {
+        const trimmed = value.trim();
+        if (!trimmed) {
+            setApiKeyError('API key cannot be empty');
+            return;
+        }
+        setApiKeyError('');
+        analytics.wizardCapture('api key submitted', {
+            key_source: 'manual_entry',
+        });
+        store.setCredentials({
+            accessToken: session.pendingAuthAccessToken ?? '',
+            idToken: session.pendingAuthIdToken ?? undefined,
+            projectApiKey: trimmed,
+            host: DEFAULT_HOST_URL,
+            projectId: 0,
+        });
+        // Fresh project: no existing event data — advance past DataSetup
+        store.setProjectHasData(false);
+        // Persist so the user doesn't have to enter it again
+        void import('../../../utils/api-key-store.js').then(({ persistApiKey }) => {
+            const source = persistApiKey(trimmed, session.installDir);
+            setSavedKeySource(source);
+        });
+    };
+    return (_jsxs(Box, { flexDirection: "column", flexGrow: 1, children: [_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsx(Text, { bold: true, color: Colors.accent, children: "Amplitude Setup Wizard" }), session.detectedFrameworkLabel && (_jsxs(Text, { children: [_jsxs(Text, { color: "green", children: ['✔', " "] }), _jsxs(Text, { children: ["Framework: ", session.detectedFrameworkLabel] })] }))] }), pendingOrgs === null && (_jsxs(_Fragment, { children: [_jsx(LoadingBox, { message: "Waiting for authentication..." }), session.loginUrl && (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { color: Colors.muted, children: "If the browser didn't open, copy and paste this URL:" }), _jsx(Text, { color: "cyan", children: session.loginUrl })] }))] })), needsOrgPick && pendingOrgs && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: Colors.muted, children: "Select your Amplitude organization:" }), _jsx(PickerMenu, { options: pendingOrgs.map((org) => ({
+                            label: org.name,
+                            value: org,
+                        })), onSelect: (value) => {
+                            const org = Array.isArray(value) ? value[0] : value;
+                            setSelectedOrg(org);
+                        } })] })), needsWorkspacePick && effectiveOrg && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { color: Colors.muted, children: ["Select a workspace in ", _jsx(Text, { color: "white", children: effectiveOrg.name }), ":"] }), _jsx(PickerMenu, { options: effectiveOrg.workspaces.map((ws) => ({
+                            label: ws.name,
+                            value: ws,
+                        })), onSelect: (value) => {
+                            const ws = Array.isArray(value) ? value[0] : value;
+                            store.setOrgAndWorkspace(effectiveOrg, ws, session.installDir);
+                        } })] })), needsApiKey && (_jsxs(Box, { flexDirection: "column", gap: 1, children: [_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: ["Enter your Amplitude project ", _jsx(Text, { bold: true, children: "API Key" })] }), _jsx(Text, { color: Colors.muted, children: "Amplitude \u2192 Settings \u2192 Projects \u2192 [your project] \u2192 API Keys" }), session.apiKeyNotice && (_jsx(Text, { color: "yellow", children: session.apiKeyNotice }))] }), _jsx(TextInput, { placeholder: "Paste API key here\u2026", onSubmit: handleApiKeySubmit }), apiKeyError && _jsx(Text, { color: "red", children: apiKeyError }), savedKeySource && (_jsxs(Text, { color: "green", children: ['✔ ', savedKeySource === 'keychain'
+                                ? 'API key saved to system keychain'
+                                : 'API key saved to .env.local'] }))] }))] }));
+};

package/dist/src/ui/tui/screens/ChecklistScreen.d.ts

@@ -0,0 +1,22 @@
+/**
+ * ChecklistScreen — Post-setup checklist for first chart and first dashboard.
+ *
+ * Shown after DataIngestionCheckScreen confirms events are flowing.
+ *
+ * Items:
+ *   [ ] Taxonomy agent   — @todo (in progress in parallel work)
+ *   [ ] First chart      — opens Amplitude in browser; marks complete on return
+ *   [ ] First dashboard  — unlocked after chart; opens Amplitude in browser
+ *
+ * The user can "Continue" at any time to skip remaining items and advance
+ * to Slack setup.
+ *
+ * Chart/dashboard creation via direct GraphQL API call is planned as a
+ * follow-up; for now the action opens the Amplitude web UI.
+ */
+import type { WizardStore } from '../store.js';
+interface ChecklistScreenProps {
+    store: WizardStore;
+}
+export declare const ChecklistScreen: ({ store }: ChecklistScreenProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/src/ui/tui/screens/ChecklistScreen.js

@@ -0,0 +1,122 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * ChecklistScreen — Post-setup checklist for first chart and first dashboard.
+ *
+ * Shown after DataIngestionCheckScreen confirms events are flowing.
+ *
+ * Items:
+ *   [ ] Taxonomy agent   — @todo (in progress in parallel work)
+ *   [ ] First chart      — opens Amplitude in browser; marks complete on return
+ *   [ ] First dashboard  — unlocked after chart; opens Amplitude in browser
+ *
+ * The user can "Continue" at any time to skip remaining items and advance
+ * to Slack setup.
+ *
+ * Chart/dashboard creation via direct GraphQL API call is planned as a
+ * follow-up; for now the action opens the Amplitude web UI.
+ */
+import { Box, Text } from 'ink';
+import { useEffect, useState, useSyncExternalStore } from 'react';
+import { PickerMenu } from '../primitives/index.js';
+import { Colors, Icons } from '../styles.js';
+import { OUTBOUND_URLS } from '../../../lib/constants.js';
+import opn from 'opn';
+import { analytics } from '../../../utils/analytics.js';
+import { fetchOwnedDashboards } from '../../../lib/api.js';
+export const ChecklistScreen = ({ store }) => {
+    useSyncExternalStore((cb) => store.subscribe(cb), () => store.getSnapshot());
+    const { session } = store;
+    const { checklistChartComplete, checklistDashboardComplete, region, selectedOrgId, } = session;
+    const [opening, setOpening] = useState(null);
+    const zone = (region ?? 'us');
+    // On mount, detect any charts/dashboards the user already owns in their org
+    // so a returning user sees the correct state without re-doing completed steps.
+    // Detection is org-scoped (Thunder has no project-level listing API); for a
+    // new-project user this is equivalent.
+    useEffect(() => {
+        const { credentials, selectedOrgId, checklistChartComplete, checklistDashboardComplete, } = store.session;
+        if (!credentials || !selectedOrgId)
+            return;
+        if (checklistChartComplete && checklistDashboardComplete)
+            return;
+        const idToken = credentials.idToken ?? credentials.accessToken;
+        const sessionZone = (store.session.region ?? 'us');
+        fetchOwnedDashboards(idToken, sessionZone, selectedOrgId)
+            .then(({ hasCharts, hasDashboards }) => {
+            if (hasCharts)
+                store.setChecklistChartComplete();
+            if (hasDashboards)
+                store.setChecklistDashboardComplete();
+        })
+            .catch(() => {
+            // fetchOwnedDashboards never rejects — handled defensively
+        });
+    }, []);
+    const chartUrl = OUTBOUND_URLS.newChart(zone, selectedOrgId);
+    const dashboardUrl = OUTBOUND_URLS.newDashboard(zone, selectedOrgId);
+    function openInBrowser(url, item) {
+        setOpening(item);
+        analytics.wizardCapture('checklist item opened', { item });
+        opn(url, { wait: false })
+            .catch(() => {
+            /* fire-and-forget */
+        })
+            .finally(() => {
+            setOpening(null);
+            if (item === 'chart')
+                store.setChecklistChartComplete();
+            if (item === 'dashboard')
+                store.setChecklistDashboardComplete();
+        });
+    }
+    function handleSelect(value) {
+        switch (value) {
+            case 'chart':
+                openInBrowser(chartUrl, 'chart');
+                break;
+            case 'dashboard':
+                openInBrowser(dashboardUrl, 'dashboard');
+                break;
+            case 'continue':
+                store.setChecklistComplete();
+                break;
+        }
+    }
+    const allDone = checklistChartComplete && checklistDashboardComplete;
+    const options = [
+        {
+            value: 'chart',
+            label: checklistChartComplete
+                ? `${Icons.check} First chart — done`
+                : `${Icons.squareOpen} Create your first chart`,
+            hint: checklistChartComplete ? undefined : 'opens in browser',
+            disabled: checklistChartComplete,
+        },
+        {
+            value: 'dashboard',
+            label: checklistDashboardComplete
+                ? `${Icons.check} First dashboard — done`
+                : checklistChartComplete
+                    ? `${Icons.squareOpen} Create your first dashboard`
+                    : `${Icons.squareOpen} Create your first dashboard`,
+            hint: checklistDashboardComplete
+                ? undefined
+                : checklistChartComplete
+                    ? 'opens in browser'
+                    : 'create a chart first',
+            disabled: checklistDashboardComplete || !checklistChartComplete,
+        },
+        {
+            value: 'taxonomy',
+            label: `${Icons.squareOpen} Set up taxonomy`,
+            hint: 'coming soon',
+            disabled: true,
+        },
+        {
+            value: 'continue',
+            label: allDone ? 'Done — continue' : 'Skip remaining and continue',
+            hint: allDone ? undefined : 'you can always do these in Amplitude later',
+        },
+    ];
+    return (_jsxs(Box, { flexDirection: "column", flexGrow: 1, paddingX: 2, paddingY: 1, children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: Colors.accent, children: "Set up your analytics" }) }), _jsxs(Box, { flexDirection: "column", gap: 1, marginBottom: 2, children: [_jsx(Text, { children: "Your events are flowing. Now let's build some views of your data." }), opening && (_jsx(Text, { color: Colors.muted, children: "Opening Amplitude in your browser..." }))] }), _jsx(PickerMenu, { options: options, onSelect: (v) => handleSelect(v) })] }));
+};

package/dist/src/ui/tui/screens/DataIngestionCheckScreen.d.ts

@@ -0,0 +1,24 @@
+/**
+ * DataIngestionCheckScreen — "Waiting for your events..." polling screen.
+ *
+ * Shown after MCP setup. Polls the activation API every 30 seconds until the
+ * project starts receiving events, then auto-advances to the Checklist.
+ *
+ * For users who were already fully activated (activationLevel === 'full') when
+ * the wizard started, this screen confirms immediately on mount without polling.
+ *
+ * The user can exit and come back later — next time through, DataSetupScreen
+ * will re-check activation and this screen will confirm immediately if events
+ * have arrived.
+ *
+ * When the activation API is unavailable (e.g. external users hitting Thunder
+ * endpoints that require browser session auth), the screen falls back to showing
+ * cataloged event types from the data API so the user can verify events arrived,
+ * then manually confirms with Enter.
+ */
+import type { WizardStore } from '../store.js';
+interface DataIngestionCheckScreenProps {
+    store: WizardStore;
+}
+export declare const DataIngestionCheckScreen: ({ store, }: DataIngestionCheckScreenProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/src/ui/tui/screens/DataIngestionCheckScreen.js

@@ -0,0 +1,113 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * DataIngestionCheckScreen — "Waiting for your events..." polling screen.
+ *
+ * Shown after MCP setup. Polls the activation API every 30 seconds until the
+ * project starts receiving events, then auto-advances to the Checklist.
+ *
+ * For users who were already fully activated (activationLevel === 'full') when
+ * the wizard started, this screen confirms immediately on mount without polling.
+ *
+ * The user can exit and come back later — next time through, DataSetupScreen
+ * will re-check activation and this screen will confirm immediately if events
+ * have arrived.
+ *
+ * When the activation API is unavailable (e.g. external users hitting Thunder
+ * endpoints that require browser session auth), the screen falls back to showing
+ * cataloged event types from the data API so the user can verify events arrived,
+ * then manually confirms with Enter.
+ */
+import { Box, Text } from 'ink';
+import { useEffect, useRef, useState, useSyncExternalStore } from 'react';
+import { Colors, Icons } from '../styles.js';
+import { fetchProjectActivationStatus, fetchWorkspaceEventTypes, } from '../../../lib/api.js';
+import { logToFile } from '../../../utils/debug.js';
+import { OutroKind } from '../../../lib/wizard-session.js';
+import { useScreenInput } from '../hooks/useScreenInput.js';
+const POLL_INTERVAL_MS = 30_000;
+const MAX_EVENTS_SHOWN = 8;
+export const DataIngestionCheckScreen = ({ store, }) => {
+    useSyncExternalStore((cb) => store.subscribe(cb), () => store.getSnapshot());
+    const { session } = store;
+    const { credentials, region, activationLevel } = session;
+    const pollingRef = useRef(null);
+    const [apiUnavailable, setApiUnavailable] = useState(false);
+    const [eventTypes, setEventTypes] = useState(null);
+    async function checkIngestion() {
+        if (!credentials) {
+            setApiUnavailable(true);
+            return;
+        }
+        // credentials.projectId is 0 for OAuth users; fall back to workspace UUID
+        const appId = credentials.projectId || session.selectedWorkspaceId;
+        if (!appId) {
+            setApiUnavailable(true);
+            return;
+        }
+        const zone = (region ?? 'us');
+        try {
+            const status = await fetchProjectActivationStatus(credentials.idToken ?? credentials.accessToken, zone, appId, session.selectedOrgId);
+            logToFile(`[DataIngestionCheck] poll result: hasAnyEvents=${status.hasAnyEvents} hasDetSource=${status.hasDetSource}`);
+            if (status.hasAnyEvents) {
+                store.setDataIngestionConfirmed();
+            }
+        }
+        catch (err) {
+            logToFile(`[DataIngestionCheck] poll error: ${err instanceof Error ? err.message : String(err)}`);
+            setApiUnavailable(true);
+            // Fetch cataloged event types from the data API as a proxy for "events arrived"
+            if (session.selectedOrgId && session.selectedWorkspaceId) {
+                const idToken = credentials.idToken ?? credentials.accessToken;
+                fetchWorkspaceEventTypes(idToken, zone, session.selectedOrgId, session.selectedWorkspaceId)
+                    .then((names) => {
+                    setEventTypes(names);
+                })
+                    .catch(() => {
+                    setEventTypes([]);
+                });
+            }
+            else {
+                setEventTypes([]);
+            }
+        }
+    }
+    useEffect(() => {
+        // Already fully activated — confirm immediately and skip polling
+        if (activationLevel === 'full') {
+            store.setDataIngestionConfirmed();
+            return;
+        }
+        // Run once immediately, then set up the interval
+        void checkIngestion();
+        pollingRef.current = setInterval(() => {
+            void checkIngestion();
+        }, POLL_INTERVAL_MS);
+        return () => {
+            if (pollingRef.current !== null) {
+                clearInterval(pollingRef.current);
+            }
+        };
+    }, []);
+    useScreenInput((_char, key) => {
+        if (key.escape || _char === 'q') {
+            if (pollingRef.current !== null)
+                clearInterval(pollingRef.current);
+            store.setOutroData({
+                kind: OutroKind.Cancel,
+                message: 'Come back once your app is running and sending events. Your SDK is installed — you just need to trigger some actions.',
+            });
+            return;
+        }
+        // Manual confirmation when API is unavailable
+        if (apiUnavailable && key.return) {
+            if (pollingRef.current !== null)
+                clearInterval(pollingRef.current);
+            store.setDataIngestionConfirmed();
+        }
+    });
+    const shown = eventTypes?.slice(0, MAX_EVENTS_SHOWN) ?? [];
+    const overflow = (eventTypes?.length ?? 0) - MAX_EVENTS_SHOWN;
+    return (_jsxs(Box, { flexDirection: "column", flexGrow: 1, paddingX: 2, paddingY: 1, children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: Colors.accent, children: "Waiting for your events" }) }), _jsxs(Box, { flexDirection: "column", gap: 1, marginBottom: 2, children: [_jsx(Text, { children: "Your SDK is installed. Once you run your app and trigger some actions, events will start flowing into Amplitude." }), !apiUnavailable && (_jsx(Text, { color: Colors.muted, children: "Checking every 30 seconds \u2014 this screen will advance automatically." }))] }), apiUnavailable && eventTypes === null && (_jsxs(Box, { gap: 2, alignItems: "center", children: [_jsx(Text, { color: Colors.accent, children: Icons.diamond }), _jsx(Text, { color: Colors.muted, children: "Checking your event catalog..." })] })), apiUnavailable && eventTypes !== null && eventTypes.length > 0 && (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsx(Text, { color: Colors.muted, dimColor: true, children: "Events cataloged in your workspace:" }), _jsxs(Box, { flexDirection: "column", marginTop: 1, marginLeft: 2, children: [shown.map((name) => (_jsxs(Box, { gap: 2, children: [_jsx(Text, { color: Colors.accent, children: Icons.diamond }), _jsx(Text, { children: name })] }, name))), overflow > 0 && (_jsxs(Text, { color: Colors.muted, dimColor: true, children: ["... and ", overflow, " more"] }))] })] })), apiUnavailable && eventTypes !== null && eventTypes.length === 0 && (_jsxs(Box, { gap: 2, alignItems: "center", marginBottom: 1, children: [_jsx(Text, { color: Colors.accent, children: Icons.diamond }), _jsx(Text, { color: Colors.muted, children: "Waiting for your events..." })] })), !apiUnavailable && (_jsxs(Box, { gap: 2, alignItems: "center", children: [_jsx(Text, { color: Colors.accent, children: Icons.diamond }), _jsx(Text, { color: Colors.muted, children: "Waiting for your events..." })] })), _jsxs(Box, { marginTop: 2, flexDirection: "column", gap: 1, children: [apiUnavailable && (_jsxs(Text, { color: Colors.muted, dimColor: true, children: ["Press", ' ', _jsx(Text, { bold: true, color: Colors.muted, children: "Enter" }), ' ', eventTypes && eventTypes.length > 0
+                                ? 'to continue'
+                                : 'once you see events in your Amplitude dashboard'] })), _jsxs(Text, { color: Colors.muted, dimColor: true, children: ["Press", ' ', _jsx(Text, { bold: true, color: Colors.muted, children: "q" }), ' ', "or", ' ', _jsx(Text, { bold: true, color: Colors.muted, children: "Esc" }), ' ', "to exit and resume later"] })] })] }));
+};

package/dist/src/ui/tui/screens/DataSetupScreen.d.ts

@@ -0,0 +1,17 @@
+/**
+ * DataSetupScreen — Checks whether the connected Amplitude project has event data.
+ *
+ * Calls the Amplitude Data API to determine the project's activation level:
+ *   'full'    — 50+ events / well-established data → Options menu
+ *   'partial' — snippet installed but few events   → ActivationOptions screen
+ *   'none'    — no events, no snippet              → Framework Detection
+ *
+ * The router's isComplete predicate (projectHasData !== null) advances past
+ * this screen automatically once the value is set.
+ */
+import type { WizardStore } from '../store.js';
+interface DataSetupScreenProps {
+    store: WizardStore;
+}
+export declare const DataSetupScreen: ({ store }: DataSetupScreenProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/src/ui/tui/screens/DataSetupScreen.js

@@ -0,0 +1,73 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * DataSetupScreen — Checks whether the connected Amplitude project has event data.
+ *
+ * Calls the Amplitude Data API to determine the project's activation level:
+ *   'full'    — 50+ events / well-established data → Options menu
+ *   'partial' — snippet installed but few events   → ActivationOptions screen
+ *   'none'    — no events, no snippet              → Framework Detection
+ *
+ * The router's isComplete predicate (projectHasData !== null) advances past
+ * this screen automatically once the value is set.
+ */
+import { Box } from 'ink';
+import { useEffect, useSyncExternalStore } from 'react';
+import { LoadingBox } from '../primitives/index.js';
+import { fetchProjectActivationStatus } from '../../../lib/api.js';
+import { detectAmplitudeInProject } from '../../../lib/detect-amplitude.js';
+import { logToFile } from '../../../utils/debug.js';
+export const DataSetupScreen = ({ store }) => {
+    useSyncExternalStore((cb) => store.subscribe(cb), () => store.getSnapshot());
+    useEffect(() => {
+        if (store.session.projectHasData !== null)
+            return;
+        const { credentials, region, selectedOrgId, selectedWorkspaceId } = store.session;
+        // credentials.projectId is 0 for OAuth users; fall back to the workspace UUID
+        const appId = store.session.credentials?.projectId || selectedWorkspaceId || null;
+        // No credentials or project ID — can't check, fall through to Framework Detection
+        if (!credentials || !appId || !selectedOrgId) {
+            logToFile('[DataSetup] no credentials/appId — skipping activation check');
+            store.setActivationLevel('none');
+            return;
+        }
+        const zone = (region ?? 'us');
+        logToFile(`[DataSetup] checking activation for appId=${appId} zone=${zone}`);
+        // Run local static check in parallel with the API call.
+        const localDetection = detectAmplitudeInProject(store.session.installDir);
+        logToFile(`[DataSetup] local detection: confidence=${localDetection.confidence} reason=${localDetection.reason ?? 'none'}`);
+        void fetchProjectActivationStatus(credentials.idToken ?? credentials.accessToken, zone, appId, selectedOrgId)
+            .then((status) => {
+            logToFile(`[DataSetup] activation status: ${JSON.stringify(status)}`);
+            store.setSnippetConfigured(status.hasDetSource);
+            if (status.hasAnyEvents && status.hasDetSource) {
+                // Has both SDK and events — use a heuristic: if all three core event types
+                // are present, call it full.
+                const isFull = status.hasPageViewedEvent &&
+                    status.hasSessionStartEvent &&
+                    status.hasSessionEndEvent;
+                store.setActivationLevel(isFull ? 'full' : 'partial');
+            }
+            else if (status.hasDetSource) {
+                // SDK installed but no events yet
+                store.setActivationLevel('partial');
+            }
+            else if (localDetection.confidence !== 'none') {
+                // API sees no SDK, but local files suggest Amplitude is already installed.
+                // Treat as partial so the wizard asks what they need rather than running
+                // the full install agent.
+                logToFile(`[DataSetup] upgrading to partial via local detection: ${localDetection.reason}`);
+                store.setActivationLevel('partial');
+            }
+            else {
+                // No SDK, no events, no local evidence — full install needed
+                store.setActivationLevel('none');
+            }
+        })
+            .catch((err) => {
+            logToFile(`[DataSetup] activation check failed: ${err instanceof Error ? err.message : String(err)} — falling back to local detection`);
+            // If the API fails, use local detection as a fallback.
+            store.setActivationLevel(localDetection.confidence !== 'none' ? 'partial' : 'none');
+        });
+    }, []);
+    return (_jsx(Box, { flexDirection: "column", flexGrow: 1, children: _jsx(LoadingBox, { message: "Checking project setup\u2026" }) }));
+};

package/dist/src/ui/tui/screens/IntroScreen.d.ts

@@ -0,0 +1,16 @@
+/**
+ * IntroScreen — Welcome, framework detection, and continue/cancel prompt.
+ *
+ * Three states:
+ *   1. Detecting: spinner while bin.ts runs detection
+ *   2. Detection failed: auto-selects Generic, then continue/cancel
+ *   3. Detection succeeded: show result, then continue/cancel
+ *
+ * Calls store.completeSetup() which unblocks bin.ts to start runWizard.
+ */
+import type { WizardStore } from '../store.js';
+interface IntroScreenProps {
+    store: WizardStore;
+}
+export declare const IntroScreen: ({ store }: IntroScreenProps) => import("react/jsx-runtime").JSX.Element;
+export {};