@amplitude/wizard 1.0.0 → 1.2.0

package/dist/src/lib/wizard-session.js

@@ -33,6 +33,7 @@ exports.CliArgsSchema = zod_1.z.object({
     debug: zod_1.z.boolean().default(false),
     verbose: zod_1.z.boolean().default(false),
     ci: zod_1.z.boolean().default(false),
+    agent: zod_1.z.boolean().default(false),
     forceInstall: zod_1.z.boolean().default(false),
     signup: zod_1.z.boolean().default(false),
     localMcp: zod_1.z.boolean().default(false),
@@ -127,6 +128,7 @@ function buildSession(args) {
         forceInstall: validated.forceInstall ?? false,
         installDir: validated.installDir ?? process.cwd(),
         ci: validated.ci ?? false,
+        agent: false,
         signup: validated.signup ?? false,
         localMcp: validated.localMcp ?? false,
         apiKey: validated.apiKey,
@@ -141,6 +143,7 @@ function buildSession(args) {
         typescript: false,
         detectedFrameworkLabel: null,
         detectionComplete: false,
+        detectionResults: null,
         projectHasData: null,
         activationLevel: null,
         activationOptionsComplete: false,
@@ -164,6 +167,7 @@ function buildSession(args) {
         selectedWorkspaceId: null,
         selectedWorkspaceName: null,
         selectedProjectName: null,
+        selectedProjectId: null,
         loginUrl: null,
         credentials: null,
         apiKeyNotice: null,
@@ -176,9 +180,7 @@ function buildSession(args) {
         amplitudePreDetected: false,
         amplitudePreDetectedChoicePending: false,
         dataIngestionConfirmed: false,
-        checklistChartComplete: false,
-        checklistDashboardComplete: false,
-        checklistComplete: false,
+        checklistDashboardUrl: null,
         userEmail: null,
         _restoredFromCheckpoint: false,
     };

package/dist/src/run.d.ts

@@ -15,5 +15,22 @@ type Args = {
     benchmark?: boolean;
 };
 export declare function runWizard(argv: Args, session?: WizardSession): Promise<void>;
-export declare function detectIntegration(installDir: string): Promise<Integration | undefined>;
+/**
+ * Result of a single framework's detection attempt.
+ */
+export interface DetectionResult {
+    integration: Integration;
+    detected: boolean;
+    durationMs: number;
+    timedOut: boolean;
+    error?: string;
+    /** Installed version (if detected and getInstalledVersion is defined). */
+    version?: string;
+}
+/**
+ * Run all framework detectors in parallel and return the full results array.
+ * The winner is the first detected framework in Integration enum order
+ * (preserving the existing priority behavior).
+ */
+export declare function detectAllFrameworks(installDir: string, timeoutMs?: number): Promise<DetectionResult[]>;
 export {};

package/dist/src/run.js

@@ -4,12 +4,13 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runWizard = runWizard;
-exports.detectIntegration = detectIntegration;
+exports.detectAllFrameworks = detectAllFrameworks;
 const wizard_session_1 = require("./lib/wizard-session");
 const constants_1 = require("./lib/constants");
 const environment_1 = require("./utils/environment");
 const ui_1 = require("./ui");
 const path_1 = __importDefault(require("path"));
+const promises_1 = __importDefault(require("node:fs/promises"));
 const registry_1 = require("./lib/registry");
 const analytics_1 = require("./utils/analytics");
 const agent_runner_1 = require("./lib/agent-runner");
@@ -17,6 +18,7 @@ const events_1 = require("events");
 const chalk_1 = __importDefault(require("chalk"));
 const debug_1 = require("./utils/debug");
 const wizard_abort_1 = require("./utils/wizard-abort");
+const version_check_1 = require("./lib/version-check");
 events_1.EventEmitter.defaultMaxListeners = 50;
 async function runWizard(argv, session) {
     const finalArgs = {
@@ -115,29 +117,116 @@ async function runWizard(argv, session) {
         }
     }
 }
-async function detectIntegration(installDir) {
-    for (const integration of Object.values(constants_1.Integration)) {
+/**
+ * Run all framework detectors in parallel and return the full results array.
+ * The winner is the first detected framework in Integration enum order
+ * (preserving the existing priority behavior).
+ */
+async function detectAllFrameworks(installDir, timeoutMs = constants_1.DETECTION_TIMEOUT_MS) {
+    // Pre-validate installDir — fail fast instead of running 18 detectors
+    try {
+        await promises_1.default.access(installDir, promises_1.default.constants.R_OK);
+    }
+    catch {
+        (0, debug_1.logToFile)(`[detection] installDir is not readable: ${installDir}`);
+        return Object.values(constants_1.Integration).map((integration) => ({
+            integration,
+            detected: false,
+            durationMs: 0,
+            timedOut: false,
+            error: 'installDir not readable',
+        }));
+    }
+    const integrations = Object.values(constants_1.Integration);
+    const promises = integrations.map(async (integration) => {
         const config = registry_1.FRAMEWORK_REGISTRY[integration];
+        const start = performance.now();
+        // Both detect() and version check run inside a single Promise.race
+        // so a slow getInstalledVersion can't hang the entire detection.
+        const work = async () => {
+            const detected = await config.detection.detect({ installDir });
+            const result = {
+                integration,
+                detected: Boolean(detected),
+                durationMs: Math.round(performance.now() - start),
+                timedOut: false,
+            };
+            // Capture version for diagnostics (agent-runner handles version warnings)
+            if (result.detected &&
+                (config.detection.getInstalledVersion ||
+                    config.detection.getVersionCheckInfo)) {
+                try {
+                    const versionCheckInfo = await (0, version_check_1.getVersionCheckInfo)(config.detection, {
+                        installDir,
+                        debug: false,
+                        forceInstall: false,
+                        default: false,
+                        signup: false,
+                        localMcp: false,
+                        ci: false,
+                        menu: false,
+                        benchmark: false,
+                    });
+                    if (versionCheckInfo.version) {
+                        result.version = versionCheckInfo.version;
+                    }
+                }
+                catch (err) {
+                    (0, debug_1.logToFile)(`[detection] ${integration} version check failed: ${err instanceof Error ? err.message : err}`);
+                }
+            }
+            result.durationMs = Math.round(performance.now() - start);
+            return result;
+        };
         try {
-            const detected = await Promise.race([
-                config.detection.detect({ installDir }),
-                new Promise((resolve) => setTimeout(() => resolve(false), constants_1.DETECTION_TIMEOUT_MS)),
+            const result = await Promise.race([
+                work(),
+                new Promise((resolve) => setTimeout(() => resolve('timeout'), timeoutMs)),
             ]);
-            if (detected) {
-                return integration;
+            if (result === 'timeout') {
+                const durationMs = Math.round(performance.now() - start);
+                (0, debug_1.logToFile)(`[detection] ${integration} timed out after ${durationMs}ms`);
+                return {
+                    integration,
+                    detected: false,
+                    durationMs,
+                    timedOut: true,
+                };
             }
+            return result;
         }
-        catch {
-            // Skip frameworks whose detection throws
+        catch (err) {
+            const durationMs = Math.round(performance.now() - start);
+            const errorMsg = err instanceof Error ? err.message : String(err);
+            (0, debug_1.logToFile)(`[detection] ${integration} failed after ${durationMs}ms: ${errorMsg}`);
+            return {
+                integration,
+                detected: false,
+                durationMs,
+                timedOut: false,
+                error: errorMsg,
+            };
         }
-    }
+    });
+    return Promise.all(promises);
 }
 async function detectAndResolveIntegration(session) {
     if (!session.menu) {
-        const detectedIntegration = await detectIntegration(session.installDir);
-        if (detectedIntegration) {
-            (0, ui_1.getUI)().setDetectedFramework(registry_1.FRAMEWORK_REGISTRY[detectedIntegration].metadata.name);
-            return detectedIntegration;
+        const results = await detectAllFrameworks(session.installDir);
+        session.detectionResults = results;
+        const detected = results.filter((r) => r.detected);
+        const winner = detected[0];
+        // Analytics: capture detection metrics
+        analytics_1.analytics.wizardCapture('Framework Detection Complete', {
+            winner: winner?.integration ?? 'none',
+            matchCount: detected.length,
+            durationMs: Math.max(...results.map((r) => r.durationMs)),
+            errorCount: results.filter((r) => r.error).length,
+            timedOutCount: results.filter((r) => r.timedOut).length,
+        });
+        if (winner) {
+            (0, ui_1.getUI)().setDetectedFramework(registry_1.FRAMEWORK_REGISTRY[winner.integration].metadata.name);
+            return winner.integration;
         }
         // Framework not detected — fall back to generic Amplitude quickstart.
         (0, ui_1.getUI)().log.warn("Couldn't detect your framework. Falling back to the Amplitude quickstart guide.");

package/dist/src/ui/agent-ui.d.ts

@@ -54,6 +54,8 @@ export declare class AgentUI implements WizardUI {
         name: string;
         description: string;
     }>): void;
+    setEventIngestionDetected(eventNames: string[]): void;
+    setDashboardUrl(url: string): void;
     /**
      * Prompt the agent caller to select an environment from pendingOrgs.
      *

package/dist/src/ui/agent-ui.js

@@ -180,6 +180,16 @@ class AgentUI {
             data: { event: 'event_plan_set', events },
         });
     }
+    setEventIngestionDetected(eventNames) {
+        emit('result', `events_detected: ${eventNames.length} event types`, {
+            data: { event: 'events_detected', eventNames },
+        });
+    }
+    setDashboardUrl(url) {
+        emit('result', `dashboard_created: ${url}`, {
+            data: { event: 'dashboard_created', dashboardUrl: url },
+        });
+    }
     /**
      * Prompt the agent caller to select an environment from pendingOrgs.
      *

package/dist/src/ui/logging-ui.d.ts

@@ -53,4 +53,6 @@ export declare class LoggingUI implements WizardUI {
         name: string;
         description: string;
     }>): void;
+    setEventIngestionDetected(_eventNames: string[]): void;
+    setDashboardUrl(_url: string): void;
 }

package/dist/src/ui/logging-ui.js

@@ -153,5 +153,11 @@ class LoggingUI {
     setEventPlan(_events) {
         // No-op in CI mode
     }
+    setEventIngestionDetected(_eventNames) {
+        // No-op in CI/logging mode
+    }
+    setDashboardUrl(_url) {
+        // No-op in CI/logging mode
+    }
 }
 exports.LoggingUI = LoggingUI;

package/dist/src/ui/tui/components/ConsoleView.js

@@ -39,8 +39,21 @@ function executeCommand(raw, store) {
                 void import('../../../lib/api.js').then(({ fetchAmplitudeUser }) => {
                     fetchAmplitudeUser(store.session.credentials.idToken, store.session.region)
                         .then((userInfo) => {
-                        if (userInfo.email)
+                        if (userInfo.email) {
                             store.session.userEmail = userInfo.email;
+                            analytics.setDistinctId(userInfo.email);
+                            analytics.identifyUser({
+                                email: userInfo.email,
+                                org_id: store.session.selectedOrgId ?? undefined,
+                                org_name: store.session.selectedOrgName ?? undefined,
+                                workspace_id: store.session.selectedWorkspaceId ?? undefined,
+                                workspace_name: store.session.selectedWorkspaceName ?? undefined,
+                                project_id: store.session.selectedProjectId,
+                                project_name: store.session.selectedProjectName,
+                                region: store.session.region,
+                                integration: store.session.integration,
+                            });
+                        }
                         const orgId = store.session.selectedOrgId;
                         if (orgId) {
                             const org = userInfo.orgs.find((o) => o.id === orgId);

package/dist/src/ui/tui/components/JourneyStepper.js

@@ -18,7 +18,6 @@ const WIZARD_STEPS = [
     { screen: Screen.Auth, label: 'Auth' },
     { screen: Screen.Run, label: 'Setup' },
     { screen: Screen.DataIngestionCheck, label: 'Verify' },
-    { screen: Screen.Checklist, label: 'Explore' },
     { screen: Screen.Outro, label: 'Done' },
 ];
 /** Screens that belong to each step (for grouping substeps). */
@@ -27,8 +26,7 @@ const STEP_SCREENS = {
     Auth: [Screen.RegionSelect, Screen.Auth, Screen.DataSetup],
     Setup: [Screen.ActivationOptions, Screen.Setup, Screen.Run, Screen.Mcp],
     Verify: [Screen.DataIngestionCheck],
-    Explore: [Screen.Checklist, Screen.Slack],
-    Done: [Screen.Outro],
+    Done: [Screen.Outro, Screen.Slack],
 };
 function getStepState(stepLabel, currentScreen, completedScreens) {
     const screens = STEP_SCREENS[stepLabel] ?? [];

package/dist/src/ui/tui/flows.d.ts

@@ -21,7 +21,6 @@ export declare enum Screen {
     Run = "run",
     Mcp = "mcp",
     DataIngestionCheck = "data-ingestion-check",
-    Checklist = "checklist",
     Slack = "slack",
     Outro = "outro",
     McpAdd = "mcp-add",

package/dist/src/ui/tui/flows.js

@@ -23,7 +23,6 @@ export var Screen;
     Screen["Run"] = "run";
     Screen["Mcp"] = "mcp";
     Screen["DataIngestionCheck"] = "data-ingestion-check";
-    Screen["Checklist"] = "checklist";
     Screen["Slack"] = "slack";
     Screen["Outro"] = "outro";
     Screen["McpAdd"] = "mcp-add";
@@ -109,14 +108,7 @@ export const FLOWS = {
             show: (s) => s.runPhase !== RunPhase.Error && s.activationLevel !== 'full',
             isComplete: (s) => s.dataIngestionConfirmed,
         },
-        // 6. Post-setup checklist — first chart + first dashboard.
-        //    Skipped on error.
-        {
-            screen: Screen.Checklist,
-            show: (s) => s.runPhase !== RunPhase.Error,
-            isComplete: (s) => s.checklistComplete,
-        },
-        // 7. Slack integration setup (skipped on error)
+        // 6. Slack integration setup (skipped on error)
         {
             screen: Screen.Slack,
             show: (s) => s.runPhase !== RunPhase.Error,

package/dist/src/ui/tui/ink-ui.d.ts

@@ -59,4 +59,6 @@ export declare class InkUI implements WizardUI {
         name: string;
         description: string;
     }>): void;
+    setEventIngestionDetected(_eventNames: string[]): void;
+    setDashboardUrl(url: string): void;
 }

package/dist/src/ui/tui/ink-ui.js

@@ -139,4 +139,10 @@ export class InkUI {
     setEventPlan(events) {
         this.store.setEventPlan(events);
     }
+    setEventIngestionDetected(_eventNames) {
+        // In TUI mode, DataIngestionCheckScreen handles this via polling — no-op here.
+    }
+    setDashboardUrl(url) {
+        this.store.setChecklistDashboardUrl(url);
+    }
 }

package/dist/src/ui/tui/screen-registry.js

@@ -11,7 +11,6 @@ import { ActivationOptionsScreen } from './screens/ActivationOptionsScreen.js';
 import { RunScreen } from './screens/RunScreen.js';
 import { McpScreen } from './screens/McpScreen.js';
 import { DataIngestionCheckScreen } from './screens/DataIngestionCheckScreen.js';
-import { ChecklistScreen } from './screens/ChecklistScreen.js';
 import { SlackScreen } from './screens/SlackScreen.js';
 import { LogoutScreen } from './screens/LogoutScreen.js';
 import { LoginScreen } from './screens/LoginScreen.js';
@@ -53,7 +52,6 @@ export function createScreens(store, services) {
         [Screen.Run]: _jsx(RunScreen, { store: store }),
         [Screen.Mcp]: _jsx(McpScreen, { store: store, installer: services.mcpInstaller }),
         [Screen.DataIngestionCheck]: _jsx(DataIngestionCheckScreen, { store: store }),
-        [Screen.Checklist]: _jsx(ChecklistScreen, { store: store }),
         [Screen.Outro]: _jsx(OutroScreen, { store: store }),
         // Standalone MCP flows
         [Screen.McpAdd]: (_jsx(McpScreen, { store: store, installer: services.mcpInstaller, standalone: true })),

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

@@ -1,11 +1,13 @@
 /**
  * DataIngestionCheckScreen — "Start your app and trigger some actions" 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.
+ * Shown after MCP setup. Polls for events every 30 seconds:
+ *   1. MCP query_dataset (Bearer auth, works for all users, detects any track() call)
+ *   2. Thunder activation API (autocapture events only, session-cookie auth)
+ *   3. Data-API event catalog (taxonomy events as a proxy)
  *
  * Active guidance as prominent instruction with framework-aware hint.
- * BrailleSpinner while waiting. Success celebration when events arrive.
+ * BrailleSpinner while waiting. Success celebration (with event names) when events arrive.
  */
 import type { WizardStore } from '../store.js';
 interface DataIngestionCheckScreenProps {

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

@@ -2,11 +2,13 @@ import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
 /**
  * DataIngestionCheckScreen — "Start your app and trigger some actions" 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.
+ * Shown after MCP setup. Polls for events every 30 seconds:
+ *   1. MCP query_dataset (Bearer auth, works for all users, detects any track() call)
+ *   2. Thunder activation API (autocapture events only, session-cookie auth)
+ *   3. Data-API event catalog (taxonomy events as a proxy)
  *
  * Active guidance as prominent instruction with framework-aware hint.
- * BrailleSpinner while waiting. Success celebration when events arrive.
+ * BrailleSpinner while waiting. Success celebration (with event names) when events arrive.
  */
 import { Box, Text } from 'ink';
 import { useEffect, useRef, useState } from 'react';
@@ -14,7 +16,7 @@ import { useWizardStore } from '../hooks/useWizardStore.js';
 import { Colors, Icons } from '../styles.js';
 import { BrailleSpinner } from '../components/BrailleSpinner.js';
 import { useScreenInput } from '../hooks/useScreenInput.js';
-import { fetchProjectActivationStatus, fetchWorkspaceEventTypes, } from '../../../lib/api.js';
+import { extractProjectId, fetchAmplitudeUser, fetchHasAnyEventsMcp, fetchProjectActivationStatus, fetchWorkspaceEventTypes, } from '../../../lib/api.js';
 import { Integration } from '../../../lib/constants.js';
 import { OutroKind } from '../session-constants.js';
 import { logToFile } from '../../../utils/debug.js';
@@ -40,6 +42,8 @@ export const DataIngestionCheckScreen = ({ store, }) => {
     const { activationLevel } = session;
     const pollingRef = useRef(null);
     const celebrationTimerRef = useRef(null);
+    // Cache a lazily-resolved project ID across poll cycles.
+    const resolvedProjectIdRef = useRef(null);
     const [apiUnavailable, setApiUnavailable] = useState(false);
     const [eventTypes, setEventTypes] = useState(null);
     const [celebrating, setCelebrating] = useState(false);
@@ -60,6 +64,38 @@ export const DataIngestionCheckScreen = ({ store, }) => {
             setCelebrationReady(true);
         }, CELEBRATION_DELAY_MS);
     }
+    /**
+     * Silently refresh the OAuth token.
+     * Pass force=true to refresh even if the token appears locally valid
+     * (e.g. after an auth error — the token may have been server-side revoked).
+     */
+    async function refreshToken(force = false) {
+        try {
+            const { getStoredToken, getStoredUser, storeToken } = await import('../../../utils/ampli-settings.js');
+            const { refreshAccessToken } = await import('../../../utils/oauth.js');
+            const user = getStoredUser();
+            const stored = getStoredToken(user?.id, user?.zone);
+            if (!stored || !user)
+                return false;
+            if (!force && new Date() <= new Date(stored.expiresAt))
+                return false;
+            logToFile(`[DataIngestionCheck] refreshing token (force=${force})`);
+            const refreshed = await refreshAccessToken(stored.refreshToken, user.zone);
+            storeToken(user, {
+                accessToken: refreshed.accessToken,
+                idToken: refreshed.idToken,
+                refreshToken: refreshed.refreshToken,
+                expiresAt: refreshed.expiresAt,
+            });
+            store.updateTokens(refreshed.accessToken, refreshed.idToken);
+            logToFile('[DataIngestionCheck] token refreshed successfully');
+            return true;
+        }
+        catch (err) {
+            logToFile(`[DataIngestionCheck] token refresh failed: ${err instanceof Error ? err.message : String(err)}`);
+            return false;
+        }
+    }
     async function checkIngestion() {
         // Read from store.session at call time to avoid stale closures
         const currentSession = store.session;
@@ -76,6 +112,90 @@ export const DataIngestionCheckScreen = ({ store, }) => {
         }
         const zone = (currentRegion ?? 'us');
         const dataApiToken = currentCredentials.idToken ?? currentCredentials.accessToken;
+        // Silently refresh if the token has expired before making any API calls.
+        await refreshToken();
+        // Re-read credentials from the store in case refresh updated them.
+        let freshCredentials = store.session.credentials ?? currentCredentials;
+        // Step 1: Query via MCP (Bearer auth, works for all users).
+        // Uses _all event type so any custom track() calls are detected.
+        // Requires the numeric analytics project ID from workspace.environments[].app.id.
+        //
+        // selectedProjectId may be null if the startup fire-and-forget fetchAmplitudeUser
+        // failed (e.g. due to an expired token). Resolve lazily using the now-fresh token.
+        let effectiveProjectId = currentSession.selectedProjectId ?? resolvedProjectIdRef.current;
+        if (!effectiveProjectId) {
+            const tryResolve = async () => {
+                const userInfo = await fetchAmplitudeUser(freshCredentials.idToken ?? freshCredentials.accessToken, zone);
+                // Fall back to the first org if the stored ID doesn't match (stale checkpoint).
+                const org = currentSession.selectedOrgId
+                    ? userInfo.orgs.find((o) => o.id === currentSession.selectedOrgId) ??
+                        userInfo.orgs[0]
+                    : userInfo.orgs[0];
+                // Fall back to the first workspace if the stored ID doesn't match.
+                const ws = org && currentSession.selectedWorkspaceId
+                    ? org.workspaces.find((w) => w.id === currentSession.selectedWorkspaceId) ?? org.workspaces[0]
+                    : org?.workspaces[0];
+                const restoredFields = {};
+                if (org && !currentSession.selectedOrgId) {
+                    restoredFields.orgId = org.id;
+                    restoredFields.orgName = org.name;
+                    logToFile(`[DataIngestionCheck] lazily set orgId=${org.id}`);
+                }
+                if (ws && !currentSession.selectedWorkspaceId) {
+                    restoredFields.workspaceId = ws.id;
+                    restoredFields.workspaceName = ws.name;
+                    logToFile(`[DataIngestionCheck] lazily set workspaceId=${ws.id}`);
+                }
+                effectiveProjectId = ws ? extractProjectId(ws) : null;
+                if (effectiveProjectId) {
+                    resolvedProjectIdRef.current = effectiveProjectId;
+                    restoredFields.projectId = effectiveProjectId;
+                    logToFile(`[DataIngestionCheck] lazily resolved projectId=${effectiveProjectId}`);
+                }
+                else {
+                    logToFile('[DataIngestionCheck] lazy resolution: no environments with app.id');
+                }
+                if (Object.keys(restoredFields).length > 0) {
+                    store.restoreSessionIds(restoredFields);
+                }
+            };
+            try {
+                await tryResolve();
+            }
+            catch (resolveErr) {
+                const msg = resolveErr instanceof Error ? resolveErr.message : String(resolveErr);
+                logToFile(`[DataIngestionCheck] lazy resolution failed: ${msg}`);
+                if (msg.toLowerCase().includes('auth') ||
+                    msg.toLowerCase().includes('401') ||
+                    msg.toLowerCase().includes('403')) {
+                    const refreshed = await refreshToken(true);
+                    if (refreshed) {
+                        freshCredentials = store.session.credentials ?? freshCredentials;
+                        try {
+                            await tryResolve();
+                        }
+                        catch (retryErr) {
+                            logToFile(`[DataIngestionCheck] lazy resolution retry failed: ${retryErr instanceof Error
+                                ? retryErr.message
+                                : String(retryErr)}`);
+                        }
+                    }
+                }
+            }
+        }
+        if (effectiveProjectId) {
+            const result = await fetchHasAnyEventsMcp(freshCredentials.accessToken, effectiveProjectId);
+            logToFile(`[DataIngestionCheck] MCP check: hasEvents=${result.hasEvents} projectId=${effectiveProjectId} events=${result.activeEventNames.length}`);
+            if (result.hasEvents) {
+                setApiUnavailable(false);
+                confirmWithCelebration(result.activeEventNames);
+                return;
+            }
+        }
+        else {
+            logToFile('[DataIngestionCheck] MCP check skipped: no projectId resolved');
+        }
+        // Step 2: Try activation status via Thunder (org-scoped, autocapture events only).
         if (!currentSession.selectedOrgId) {
             setApiUnavailable(true);
             return;

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

@@ -48,9 +48,17 @@ export const OutroScreen = ({ store }) => {
     // ── Main outro views ─────────────────────────────────────────────────
     return (_jsxs(Box, { flexDirection: "column", flexGrow: 1, paddingX: 2, paddingY: 1, children: [outroData.kind === OutroKind.Success && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { color: Colors.success, bold: true, children: [Icons.checkmark, " Amplitude is live!"] }), store.eventPlan.length > 0 && (_jsxs(Text, { color: Colors.body, children: [store.eventPlan.length, " event", store.eventPlan.length !== 1 ? 's' : '', " instrumented", store.session.selectedProjectName
                                 ? ` in ${store.session.selectedProjectName}`
-                                : '', "."] })), outroData.changes && outroData.changes.length > 0 && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: outroData.changes.map((change, i) => (_jsxs(Text, { color: Colors.body, children: [Icons.bullet, " ", change] }, i))) })), store.eventPlan.length > 0 && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { color: Colors.secondary, bold: true, children: "Events" }), store.eventPlan.map((event) => (_jsxs(Text, { color: Colors.body, children: [Icons.diamond, " ", _jsx(Text, { bold: true, children: event.name }), _jsxs(Text, { color: Colors.muted, children: [" ", event.description] })] }, event.name)))] })), _jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: Colors.muted, children: ["Review changes in", ' ', _jsx(Text, { bold: true, color: Colors.secondary, children: "./amplitude-setup-report.md" })] }) })] })), outroData.kind === OutroKind.Error && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { color: Colors.error, bold: true, children: [Icons.cross, " Setup failed"] }), outroData.message && (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: Colors.body, children: outroData.message }) })), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Text, { color: Colors.secondary, children: [Icons.arrowRight, " Check your API key and network connection"] }), _jsxs(Text, { color: Colors.secondary, children: [Icons.arrowRight, " Run the wizard again with", ' ', _jsx(Text, { bold: true, children: "--debug" }), " for more detail"] }), outroData.docsUrl && (_jsxs(Text, { color: Colors.secondary, children: [Icons.arrowRight, " Docs:", ' ', _jsx(Text, { color: Colors.accent, children: outroData.docsUrl })] }))] })] })), outroData.kind === OutroKind.Cancel && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { color: Colors.warning, bold: true, children: [Icons.dash, " Setup cancelled"] }), outroData.message && (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: Colors.body, children: outroData.message }) })), outroData.docsUrl && (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: Colors.secondary, children: ["Manual setup:", ' ', _jsx(Text, { color: Colors.accent, children: outroData.docsUrl })] }) }))] })), _jsx(Box, { marginTop: 1, children: isSuccess ? (_jsx(PickerMenu, { options: [
+                                : '', "."] })), outroData.changes && outroData.changes.length > 0 && (_jsx(Box, { flexDirection: "column", marginTop: 1, children: outroData.changes.map((change, i) => (_jsxs(Text, { color: Colors.body, children: [Icons.bullet, " ", change] }, i))) })), store.eventPlan.length > 0 && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Text, { color: Colors.secondary, bold: true, children: "Events" }), store.eventPlan.map((event) => (_jsxs(Text, { color: Colors.body, children: [Icons.diamond, " ", _jsx(Text, { bold: true, children: event.name }), _jsxs(Text, { color: Colors.muted, children: [" ", event.description] })] }, event.name)))] })), store.session.checklistDashboardUrl && (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Text, { color: Colors.success, bold: true, children: [Icons.checkmark, " Dashboard ready:"] }), _jsx(Text, { color: Colors.muted, children: store.session.checklistDashboardUrl })] })), _jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: Colors.muted, children: ["Review changes in", ' ', _jsx(Text, { bold: true, color: Colors.secondary, children: "./amplitude-setup-report.md" })] }) })] })), outroData.kind === OutroKind.Error && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { color: Colors.error, bold: true, children: [Icons.cross, " Setup failed"] }), outroData.message && (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: Colors.body, children: outroData.message }) })), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsxs(Text, { color: Colors.secondary, children: [Icons.arrowRight, " Check your API key and network connection"] }), _jsxs(Text, { color: Colors.secondary, children: [Icons.arrowRight, " Run the wizard again with", ' ', _jsx(Text, { bold: true, children: "--debug" }), " for more detail"] }), outroData.docsUrl && (_jsxs(Text, { color: Colors.secondary, children: [Icons.arrowRight, " Docs:", ' ', _jsx(Text, { color: Colors.accent, children: outroData.docsUrl })] }))] })] })), outroData.kind === OutroKind.Cancel && (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { color: Colors.warning, bold: true, children: [Icons.dash, " Setup cancelled"] }), outroData.message && (_jsx(Box, { marginTop: 1, children: _jsx(Text, { color: Colors.body, children: outroData.message }) })), outroData.docsUrl && (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: Colors.secondary, children: ["Manual setup:", ' ', _jsx(Text, { color: Colors.accent, children: outroData.docsUrl })] }) }))] })), _jsx(Box, { marginTop: 1, children: isSuccess ? (_jsx(PickerMenu, { options: [
                         { label: 'View setup report', value: 'report' },
-                        { label: 'Open Amplitude dashboard', value: 'dashboard' },
+                        {
+                            label: store.session.checklistDashboardUrl
+                                ? 'Open your analytics dashboard'
+                                : 'Open Amplitude',
+                            value: 'dashboard',
+                            hint: store.session.checklistDashboardUrl
+                                ? undefined
+                                : 'amplitude.com',
+                        },
                         { label: 'Exit', value: 'exit' },
                     ], onSelect: (value) => {
                         const choice = Array.isArray(value) ? value[0] : value;
@@ -63,7 +71,8 @@ export const OutroScreen = ({ store }) => {
                         }
                         else if (choice === 'dashboard') {
                             const zone = (store.session.region ?? 'us');
-                            const url = OUTBOUND_URLS.overview[zone];
+                            const url = store.session.checklistDashboardUrl ??
+                                OUTBOUND_URLS.overview[zone];
                             opn(url, { wait: false }).catch(() => {
                                 /* fire-and-forget */
                             });

package/dist/src/ui/tui/store.d.ts

@@ -138,6 +138,20 @@ export declare class WizardStore {
     hideLoginOverlay(): void;
     /** Update just the access token in credentials without triggering auth analytics. */
     updateAccessToken(accessToken: string): void;
+    /** Update both access and id tokens (e.g. after a silent OAuth refresh). */
+    updateTokens(accessToken: string, idToken: string): void;
+    /**
+     * Restore org/workspace/project session IDs that weren't populated at startup
+     * (e.g. because the fire-and-forget fetchAmplitudeUser failed due to expired token).
+     * Only updates fields that are provided.
+     */
+    restoreSessionIds(fields: {
+        orgId?: string;
+        orgName?: string;
+        workspaceId?: string;
+        workspaceName?: string;
+        projectId?: string | null;
+    }): void;
     /** Request the TabContainer to switch to a tab by id. Clears after consumption. */
     setRequestedTab(id: string): void;
     clearRequestedTab(): void;
@@ -147,9 +161,7 @@ export declare class WizardStore {
     setActivationLevel(level: 'none' | 'partial' | 'full'): void;
     setSnippetConfigured(value: boolean): void;
     setDataIngestionConfirmed(): void;
-    setChecklistChartComplete(): void;
-    setChecklistDashboardComplete(): void;
-    setChecklistComplete(): void;
+    setChecklistDashboardUrl(url: string): void;
     setActivationOptionsComplete(): void;
     /**
      * Called from bin.ts when OAuth completes (browser redirect done).
@@ -172,6 +184,13 @@ export declare class WizardStore {
     }, workspace: {
         id: string;
         name: string;
+        environments?: Array<{
+            rank: number;
+            app: {
+                id: string;
+                apiKey?: string | null;
+            } | null;
+        }> | null;
     }, installDir: string): void;
     setServiceStatus(status: {
         description: string;