@amplitude/wizard 1.0.0-beta.1 → 1.0.0-beta.2

package/dist/bin.js

@@ -201,12 +201,13 @@ void (0, yargs_1.default)((0, helpers_1.hideBin)(process.argv))
                     // returning users. This skips RegionSelect and Auth without requiring
                     // a persisted OAuth token.
                     const installDir = session.installDir;
-                    const [{ getStoredUser, getStoredToken }, { readAmpliConfig }, { getAPIKey }, { getHostFromRegion }, { logToFile },] = await Promise.all([
+                    const [{ getStoredUser, getStoredToken }, { readAmpliConfig }, { getAPIKey }, { getHostFromRegion }, { logToFile }, { fetchAmplitudeUser },] = await Promise.all([
                         import('./src/utils/ampli-settings.js'),
                         import('./src/lib/ampli-config.js'),
                         import('./src/utils/get-api-key.js'),
                         import('./src/utils/urls.js'),
                         import('./src/utils/debug.js'),
+                        import('./src/lib/api.js'),
                     ]);
                     // Zone: prefer a real (non-pending) stored user, fall back to
                     // the Zone field in the project-level ampli.json.
@@ -222,43 +223,108 @@ void (0, yargs_1.default)((0, helpers_1.hideBin)(process.argv))
                     }
                     // Skip Auth when we have a stored OAuth token — use it to fetch
                     // (or look up) the project API key, then pre-populate credentials.
+                    // When the workspace has multiple environments (projects), defer to
+                    // AuthScreen so the user can pick which project to instrument.
                     if (zone) {
                         const storedToken = realUser
                             ? getStoredToken(realUser.id, realUser.zone)
                             : getStoredToken(undefined, zone);
                         if (storedToken) {
-                            logToFile(`[bin] getAPIKey: zone=${zone} hasWorkspaceId=${!!session.selectedWorkspaceId}`);
-                            const projectApiKey = await getAPIKey({
-                                installDir,
-                                idToken: storedToken.idToken,
-                                zone,
-                                workspaceId: session.selectedWorkspaceId ?? undefined,
-                            });
-                            if (projectApiKey) {
-                                logToFile('[bin] getAPIKey: resolved project API key');
-                                (0, api_key_store_1.persistApiKey)(projectApiKey, installDir);
+                            // Check local storage first — if a key is already persisted
+                            // for this install dir, use it without fetching user data.
+                            const { readApiKeyWithSource } = await import('./src/utils/api-key-store.js');
+                            const localKey = readApiKeyWithSource(installDir);
+                            if (localKey) {
+                                logToFile('[bin] using locally stored API key');
                                 session.credentials = {
                                     accessToken: storedToken.idToken,
                                     idToken: storedToken.idToken,
-                                    projectApiKey,
+                                    projectApiKey: localKey.key,
                                     host: getHostFromRegion(zone),
                                     projectId: 0,
                                 };
-                                // Pre-populate activationLevel so DataSetup is also skipped,
-                                // giving a single wipe from Intro → Run/Setup.
-                                // DataSetup would set 'none' anyway (projectId=0 prevents the
-                                // real check), so this is equivalent — just earlier.
                                 session.activationLevel = 'none';
                                 session.projectHasData = false;
                             }
                             else {
-                                logToFile('[bin] getAPIKey: returned null — showing apiKeyNotice');
-                                // Region is already pre-populated above; prompt for the
-                                // key manually with a hint about org-admin permissions.
-                                session.apiKeyNotice =
-                                    "Your API key couldn't be fetched automatically. " +
-                                        'Only organization admins can access project API keys — ' +
-                                        'if you need one, ask an admin to share it with you.';
+                                // Fetch user data to check how many environments are available.
+                                const { fetchAmplitudeUser } = await import('./src/lib/api.js');
+                                try {
+                                    const userInfo = await fetchAmplitudeUser(storedToken.idToken, zone);
+                                    const workspaceId = session.selectedWorkspaceId ?? undefined;
+                                    // Find the relevant workspace and its environments
+                                    let envsWithKey = [];
+                                    for (const org of userInfo.orgs) {
+                                        const ws = workspaceId
+                                            ? org.workspaces.find((w) => w.id === workspaceId)
+                                            : org.workspaces[0];
+                                        if (ws?.environments) {
+                                            envsWithKey = ws.environments
+                                                .filter((env) => env.app?.apiKey)
+                                                .sort((a, b) => a.rank - b.rank);
+                                            break;
+                                        }
+                                    }
+                                    if (envsWithKey.length === 1) {
+                                        // Single environment — auto-select as before
+                                        const apiKey = envsWithKey[0].app.apiKey;
+                                        session.selectedProjectName = envsWithKey[0].name;
+                                        logToFile('[bin] single environment — auto-selecting API key');
+                                        (0, api_key_store_1.persistApiKey)(apiKey, installDir);
+                                        session.credentials = {
+                                            accessToken: storedToken.idToken,
+                                            idToken: storedToken.idToken,
+                                            projectApiKey: apiKey,
+                                            host: getHostFromRegion(zone),
+                                            projectId: 0,
+                                        };
+                                        session.activationLevel = 'none';
+                                        session.projectHasData = false;
+                                    }
+                                    else if (envsWithKey.length > 1) {
+                                        // Multiple environments — show the project picker via
+                                        // AuthScreen instead of auto-selecting.
+                                        logToFile(`[bin] ${envsWithKey.length} environments found — deferring to project picker`);
+                                        session.pendingOrgs = userInfo.orgs;
+                                        session.pendingAuthIdToken = storedToken.idToken;
+                                        session.pendingAuthAccessToken = storedToken.idToken;
+                                    }
+                                    else {
+                                        logToFile('[bin] no environments with API keys — showing apiKeyNotice');
+                                        session.apiKeyNotice =
+                                            "Your API key couldn't be fetched automatically. " +
+                                                'Only organization admins can access project API keys — ' +
+                                                'if you need one, ask an admin to share it with you.';
+                                    }
+                                }
+                                catch (err) {
+                                    logToFile(`[bin] fetchAmplitudeUser failed: ${err instanceof Error ? err.message : 'unknown'}`);
+                                    // Fall back to getAPIKey for backward compatibility
+                                    const projectApiKey = await getAPIKey({
+                                        installDir,
+                                        idToken: storedToken.idToken,
+                                        zone,
+                                        workspaceId: session.selectedWorkspaceId ?? undefined,
+                                    });
+                                    if (projectApiKey) {
+                                        (0, api_key_store_1.persistApiKey)(projectApiKey, installDir);
+                                        session.credentials = {
+                                            accessToken: storedToken.idToken,
+                                            idToken: storedToken.idToken,
+                                            projectApiKey,
+                                            host: getHostFromRegion(zone),
+                                            projectId: 0,
+                                        };
+                                        session.activationLevel = 'none';
+                                        session.projectHasData = false;
+                                    }
+                                    else {
+                                        session.apiKeyNotice =
+                                            "Your API key couldn't be fetched automatically. " +
+                                                'Only organization admins can access project API keys — ' +
+                                                'if you need one, ask an admin to share it with you.';
+                                    }
+                                }
                             }
                         }
                     }
@@ -271,8 +337,46 @@ void (0, yargs_1.default)((0, helpers_1.hideBin)(process.argv))
                     if (projectConfig.ok && projectConfig.config.WorkspaceId) {
                         session.selectedWorkspaceId = projectConfig.config.WorkspaceId;
                     }
+                    // Resolve org/workspace display names so /whoami shows them.
+                    // Uses the stored token to fetch user info — fire-and-forget so it
+                    // doesn't block startup.
+                    if (zone && session.selectedOrgId) {
+                        const storedToken = realUser
+                            ? getStoredToken(realUser.id, realUser.zone)
+                            : getStoredToken(undefined, zone);
+                        if (storedToken) {
+                            fetchAmplitudeUser(storedToken.idToken, zone)
+                                .then((userInfo) => {
+                                const org = userInfo.orgs.find((o) => o.id === session.selectedOrgId);
+                                if (org) {
+                                    session.selectedOrgName = org.name;
+                                    const ws = session.selectedWorkspaceId
+                                        ? org.workspaces.find((w) => w.id === session.selectedWorkspaceId)
+                                        : undefined;
+                                    if (ws) {
+                                        session.selectedWorkspaceName = ws.name;
+                                    }
+                                    // Update the store if it's already been assigned
+                                    if (tui.store.session === session) {
+                                        tui.store.emitChange();
+                                    }
+                                }
+                            })
+                                .catch(() => {
+                                // Non-fatal — /whoami will just show (none)
+                            });
+                        }
+                    }
                 }
                 tui.store.session = session;
+                // Initialize Amplitude Experiment feature flags (non-blocking).
+                const { initFeatureFlags } = await import('./src/lib/feature-flags.js');
+                await initFeatureFlags().catch(() => {
+                    // Flag init failure is non-fatal — all flags default to off
+                });
+                // Apply SDK-level opt-out based on feature flags
+                const { analytics } = await import('./src/utils/analytics.js');
+                analytics.applyOptOut();
                 const { FRAMEWORK_REGISTRY } = await import('./src/lib/registry.js');
                 const { detectIntegration } = await import('./src/run.js');
                 const installDir = session.installDir ?? process.cwd();
@@ -427,22 +531,27 @@ void (0, yargs_1.default)((0, helpers_1.hideBin)(process.argv))
                             tui.store.addDiscoveredFeature(DiscoveredFeature.Stripe);
                         }
                         // LLM SDK detection — sourced from Amplitude LLM analytics skill
-                        const LLM_PACKAGES = [
-                            'openai',
-                            '@anthropic-ai/sdk',
-                            'ai',
-                            '@ai-sdk/openai',
-                            'langchain',
-                            '@langchain/openai',
-                            '@langchain/langgraph',
-                            '@google/generative-ai',
-                            '@google/genai',
-                            '@instructor-ai/instructor',
-                            '@mastra/core',
-                            'portkey-ai',
-                        ];
-                        if (depNames.some((d) => LLM_PACKAGES.includes(d))) {
-                            tui.store.addDiscoveredFeature(DiscoveredFeature.LLM);
+                        // Gated by the wizard-llm-analytics feature flag.
+                        const { isFlagEnabled } = await import('./src/lib/feature-flags.js');
+                        const { FLAG_LLM_ANALYTICS } = await import('./src/lib/feature-flags.js');
+                        if (isFlagEnabled(FLAG_LLM_ANALYTICS)) {
+                            const LLM_PACKAGES = [
+                                'openai',
+                                '@anthropic-ai/sdk',
+                                'ai',
+                                '@ai-sdk/openai',
+                                'langchain',
+                                '@langchain/openai',
+                                '@langchain/langgraph',
+                                '@google/generative-ai',
+                                '@google/genai',
+                                '@instructor-ai/instructor',
+                                '@mastra/core',
+                                'portkey-ai',
+                            ];
+                            if (depNames.some((d) => LLM_PACKAGES.includes(d))) {
+                                tui.store.addDiscoveredFeature(DiscoveredFeature.LLM);
+                            }
                         }
                     }
                     catch {
@@ -611,6 +720,7 @@ void (0, yargs_1.default)((0, helpers_1.hideBin)(process.argv))
         if (!message) {
             (0, ui_1.getUI)().log.error('Usage: amplitude-wizard feedback <message>  or  feedback --message <message>');
             process.exit(1);
+            return;
         }
         try {
             const { trackWizardFeedback } = await import('./src/utils/track-wizard-feedback.js');

package/dist/src/lib/constants.d.ts

@@ -77,7 +77,7 @@ export declare const OUTBOUND_URLS: {
     /** New dashboard — opened from the Checklist screen. */
     newDashboard: (zone: AmplitudeZone, orgId?: string | null) => string;
     /** Slack integration settings — opened from the Slack screen. */
-    slackSettings: (zone: AmplitudeZone, orgName?: string | null) => string;
+    slackSettings: (zone: AmplitudeZone, orgId?: string | null, orgName?: string | null) => string;
     /** Products page — shown in the Outro for sign-up users. */
     products: (zone: AmplitudeZone) => string;
     /** SDK overview — opened from the Activation Options screen. */

package/dist/src/lib/constants.js

@@ -108,11 +108,15 @@ exports.OUTBOUND_URLS = {
     },
     // ── Post-setup ────────────────────────────────────────────────────────────
     /** Slack integration settings — opened from the Slack screen. */
-    slackSettings: (zone, orgName) => {
+    slackSettings: (zone, orgId, orgName) => {
         const base = exports.OUTBOUND_URLS.overview[zone];
-        return orgName
-            ? `${base}/analytics/${encodeURIComponent(orgName)}/settings/profile`
-            : `${base}/settings/profile`;
+        if (orgName) {
+            return `${base}/analytics/${encodeURIComponent(orgName)}/settings/profile`;
+        }
+        if (orgId) {
+            return `${base}/${orgId}/settings/profile`;
+        }
+        return `${base}/settings/profile`;
     },
     /** Products page — shown in the Outro for sign-up users. */
     products: (zone) => `${exports.OUTBOUND_URLS.overview[zone]}/products?source=wizard`,

package/dist/src/lib/feature-flags.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Feature flags powered by Amplitude Experiment (server-side local evaluation).
+ *
+ * Flags are fetched once at startup via `initFeatureFlags()` and evaluated
+ * synchronously thereafter — no per-check network calls.
+ */
+/** Gate for the LLM analytics additional-feature flow. */
+export declare const FLAG_LLM_ANALYTICS = "wizard-llm-analytics";
+/** Gate for agent-level analytics / telemetry instrumented by the wizard. */
+export declare const FLAG_AGENT_ANALYTICS = "wizard-agent-analytics";
+/**
+ * Initialize the Experiment local-evaluation client and pre-fetch flag configs.
+ * Safe to call multiple times — subsequent calls are no-ops.
+ *
+ * @param userId  Optional user ID for targeted flag evaluation.
+ * @param deviceId  Optional device ID for targeted flag evaluation.
+ */
+export declare function initFeatureFlags(userId?: string, deviceId?: string): Promise<void>;
+/**
+ * Evaluate a single feature flag. Returns the string variant value,
+ * or `undefined` if the flag is not set / client not initialized.
+ */
+export declare function getFlag(flagKey: string): string | undefined;
+/**
+ * Check whether a flag is enabled (variant is `'on'` or `'true'`).
+ * Returns `false` when the flag is absent or the client is not initialized.
+ */
+export declare function isFlagEnabled(flagKey: string): boolean;
+/**
+ * Return a snapshot of all evaluated flags (key -> string value).
+ */
+export declare function getAllFlags(): Record<string, string>;
+/**
+ * Re-evaluate flags for a specific user (e.g. after login).
+ * Updates the cached flags in place.
+ */
+export declare function refreshFlags(userId?: string, deviceId?: string): Promise<void>;

package/dist/src/lib/feature-flags.js

@@ -0,0 +1,119 @@
+"use strict";
+/**
+ * Feature flags powered by Amplitude Experiment (server-side local evaluation).
+ *
+ * Flags are fetched once at startup via `initFeatureFlags()` and evaluated
+ * synchronously thereafter — no per-check network calls.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FLAG_AGENT_ANALYTICS = exports.FLAG_LLM_ANALYTICS = void 0;
+exports.initFeatureFlags = initFeatureFlags;
+exports.getFlag = getFlag;
+exports.isFlagEnabled = isFlagEnabled;
+exports.getAllFlags = getAllFlags;
+exports.refreshFlags = refreshFlags;
+const experiment_node_server_1 = require("@amplitude/experiment-node-server");
+const debug_1 = require("../utils/debug");
+// ── Flag keys ────────────────────────────────────────────────────────
+/** Gate for the LLM analytics additional-feature flow. */
+exports.FLAG_LLM_ANALYTICS = 'wizard-llm-analytics';
+/** Gate for agent-level analytics / telemetry instrumented by the wizard. */
+exports.FLAG_AGENT_ANALYTICS = 'wizard-agent-analytics';
+// ── Deployment key ───────────────────────────────────────────────────
+/**
+ * Server deployment key for local evaluation.
+ * Override with `AMPLITUDE_EXPERIMENT_DEPLOYMENT_KEY` env var.
+ */
+const DEFAULT_DEPLOYMENT_KEY = 'server-YOTsk4MS1RWzLyIf1DmvNDUsdOGqkRdM';
+function resolveDeploymentKey() {
+    const fromEnv = process.env.AMPLITUDE_EXPERIMENT_DEPLOYMENT_KEY;
+    return (fromEnv ?? DEFAULT_DEPLOYMENT_KEY).trim();
+}
+// ── Singleton client ─────────────────────────────────────────────────
+let client = null;
+let cachedFlags = {};
+/**
+ * Initialize the Experiment local-evaluation client and pre-fetch flag configs.
+ * Safe to call multiple times — subsequent calls are no-ops.
+ *
+ * @param userId  Optional user ID for targeted flag evaluation.
+ * @param deviceId  Optional device ID for targeted flag evaluation.
+ */
+async function initFeatureFlags(userId, deviceId) {
+    if (client)
+        return; // already initialized
+    const deploymentKey = resolveDeploymentKey();
+    if (!deploymentKey) {
+        (0, debug_1.debug)('feature-flags: no deployment key — all flags default to off');
+        return;
+    }
+    try {
+        client = experiment_node_server_1.Experiment.initializeLocal(deploymentKey);
+        await client.start();
+        const user = {};
+        if (userId)
+            user.user_id = userId;
+        if (deviceId)
+            user.device_id = deviceId;
+        const variants = client.evaluateV2(user);
+        for (const [key, variant] of Object.entries(variants)) {
+            if (variant.value !== undefined && variant.value !== null) {
+                cachedFlags[key] = String(variant.value);
+            }
+        }
+        (0, debug_1.debug)('feature-flags: initialized with flags', cachedFlags);
+    }
+    catch (err) {
+        (0, debug_1.debug)('feature-flags: initialization failed, defaulting all flags off', err);
+        client = null;
+    }
+}
+/**
+ * Evaluate a single feature flag. Returns the string variant value,
+ * or `undefined` if the flag is not set / client not initialized.
+ */
+function getFlag(flagKey) {
+    return cachedFlags[flagKey];
+}
+/**
+ * Check whether a flag is enabled (variant is `'on'` or `'true'`).
+ * Returns `false` when the flag is absent or the client is not initialized.
+ */
+function isFlagEnabled(flagKey) {
+    const value = cachedFlags[flagKey];
+    return value === 'on' || value === 'true';
+}
+/**
+ * Return a snapshot of all evaluated flags (key -> string value).
+ */
+function getAllFlags() {
+    return { ...cachedFlags };
+}
+/**
+ * Re-evaluate flags for a specific user (e.g. after login).
+ * Updates the cached flags in place.
+ */
+async function refreshFlags(userId, deviceId) {
+    if (!client)
+        return;
+    try {
+        // Re-fetch flag configs in case they changed
+        await client.start();
+        const user = {};
+        if (userId)
+            user.user_id = userId;
+        if (deviceId)
+            user.device_id = deviceId;
+        const variants = client.evaluateV2(user);
+        cachedFlags = {};
+        for (const [key, variant] of Object.entries(variants)) {
+            if (variant.value !== undefined && variant.value !== null) {
+                cachedFlags[key] = String(variant.value);
+            }
+        }
+        (0, debug_1.debug)('feature-flags: refreshed flags', cachedFlags);
+    }
+    catch (err) {
+        (0, debug_1.debug)('feature-flags: refresh failed', err);
+    }
+}

package/dist/src/lib/wizard-session.d.ts

@@ -132,6 +132,14 @@ export interface WizardSession {
         workspaces: Array<{
             id: string;
             name: string;
+            environments?: Array<{
+                name: string;
+                rank: number;
+                app: {
+                    id: string;
+                    apiKey?: string | null;
+                } | null;
+            }> | null;
         }>;
     }> | null;
     /** OAuth id_token held during SUSI account-setup steps. */
@@ -146,6 +154,8 @@ export interface WizardSession {
     /** Workspace selected during SUSI (written to ampli.json). */
     selectedWorkspaceId: string | null;
     selectedWorkspaceName: string | null;
+    /** Project/environment selected during SUSI (displayed in TitleBar). */
+    selectedProjectName: string | null;
     /**
      * Notice shown on the API key entry step of AuthScreen.
      * Set when auto-fetch fails (e.g. user is not an org admin) so the user

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

@@ -109,6 +109,7 @@ function buildSession(args) {
         selectedOrgName: null,
         selectedWorkspaceId: null,
         selectedWorkspaceName: null,
+        selectedProjectName: null,
         loginUrl: null,
         credentials: null,
         apiKeyNotice: null,

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

@@ -30,5 +30,5 @@ export const App = ({ store }) => {
     const contentAreaWidth = Math.max(10, innerWidth - 2);
     const direction = store.lastNavDirection === 'pop' ? 'right' : 'left';
     const activeScreen = screens[store.currentScreen] ?? null;
-    return (_jsx(CommandModeContext.Provider, { value: store.commandMode, children: _jsx(Box, { flexDirection: "column", height: rows, width: columns, alignItems: "center", justifyContent: "flex-start", children: _jsxs(ConsoleView, { store: store, width: width, height: rows, children: [_jsx(TitleBar, { version: store.version, width: innerWidth }), _jsx(Box, { height: 1 }), _jsx(Box, { flexDirection: "column", flexGrow: 1, paddingX: 1, overflow: "hidden", children: _jsx(DissolveTransition, { transitionKey: store.currentScreen, width: contentAreaWidth, height: contentHeight, direction: direction, children: _jsx(ScreenErrorBoundary, { store: store, retryToken: store.screenErrorRetry, children: activeScreen }) }) })] }) }) }));
+    return (_jsx(CommandModeContext.Provider, { value: store.commandMode, children: _jsx(Box, { flexDirection: "column", height: rows, width: columns, alignItems: "center", justifyContent: "flex-start", children: _jsxs(ConsoleView, { store: store, width: width, height: rows, children: [_jsx(TitleBar, { version: store.version, width: innerWidth, orgName: store.session.selectedOrgName, projectName: store.session.selectedProjectName }), _jsx(Box, { height: 1 }), _jsx(Box, { flexDirection: "column", flexGrow: 1, paddingX: 1, overflow: "hidden", children: _jsx(DissolveTransition, { transitionKey: store.currentScreen, width: contentAreaWidth, height: contentHeight, direction: direction, children: _jsx(ScreenErrorBoundary, { store: store, retryToken: store.screenErrorRetry, children: activeScreen }) }) })] }) }) }));
 };

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

@@ -21,7 +21,7 @@ import { PickerMenu } from '../primitives/PickerMenu.js';
 import { Colors, Icons } from '../styles.js';
 import { Overlay } from '../router.js';
 import { queryConsole, resolveConsoleCredentials, buildSessionContext, } from '../../../lib/console-query.js';
-import { COMMANDS, getWhoamiText, getHelpText, parseFeedbackSlashInput, TEST_PROMPT, } from '../console-commands.js';
+import { COMMANDS, getWhoamiText, parseFeedbackSlashInput, TEST_PROMPT, } from '../console-commands.js';
 import { analytics } from '../../../utils/analytics.js';
 import { trackWizardFeedback } from '../../../utils/track-wizard-feedback.js';
 function executeCommand(raw, store) {
@@ -66,12 +66,9 @@ function executeCommand(raw, store) {
         case '/exit':
             store.setOutroData({ kind: OutroKind.Cancel, message: 'Exited.' });
             break;
-        case '/help':
-            store.setCommandFeedback(getHelpText());
-            break;
         default:
             if (cmd)
-                store.setCommandFeedback(`Unknown command: ${cmd}. Type /help.`);
+                store.setCommandFeedback(`Unknown command: ${cmd}. Type / to see available commands.`);
     }
 }
 export const ConsoleView = ({ store, width, height, children, }) => {

package/dist/src/ui/tui/components/TitleBar.d.ts

@@ -1,6 +1,8 @@
 interface TitleBarProps {
     version: string;
     width: number;
+    orgName?: string | null;
+    projectName?: string | null;
 }
-export declare const TitleBar: ({ version, width }: TitleBarProps) => import("react/jsx-runtime").JSX.Element;
+export declare const TitleBar: ({ version, width, orgName, projectName, }: TitleBarProps) => import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -1,16 +1,27 @@
-import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { Box, Text } from 'ink';
 import { Colors } from '../styles.js';
 const FEEDBACK = 'Feedback: wizard@amplitude.com ';
 const FEEDBACK_SHORT = ' wizard@amplitude.com ';
-export const TitleBar = ({ version, width }) => {
+export const TitleBar = ({ version, width, orgName, projectName, }) => {
     const fullTitle = ` Amplitude Wizard v${version}`;
-    const needShort = width < fullTitle.length + FEEDBACK.length;
+    // Build context string from org + project names
+    const contextParts = [];
+    if (orgName)
+        contextParts.push(orgName);
+    if (projectName)
+        contextParts.push(projectName);
+    const contextStr = contextParts.length > 0 ? ` ${contextParts.join(' / ')} ` : '';
+    const needShort = width < fullTitle.length + contextStr.length + FEEDBACK.length;
     const feedback = needShort ? FEEDBACK_SHORT : FEEDBACK;
-    const title = needShort && fullTitle.length + feedback.length > width
+    const title = needShort && fullTitle.length + contextStr.length + feedback.length > width
         ? ` Wizard v${version}`
         : fullTitle;
-    const gap = Math.max(0, width - title.length - feedback.length);
+    // If context doesn't fit even with the short title, drop it
+    const showContext = contextStr.length > 0 &&
+        title.length + contextStr.length + feedback.length <= width;
+    const middleText = showContext ? contextStr : '';
+    const gap = Math.max(0, width - title.length - middleText.length - feedback.length);
     const padding = ' '.repeat(gap);
-    return (_jsx(Box, { width: width, overflow: "hidden", children: _jsxs(Text, { backgroundColor: Colors.accent, color: "white", bold: true, children: [title, padding, feedback] }) }));
+    return (_jsxs(Box, { width: width, overflow: "hidden", children: [_jsx(Text, { backgroundColor: Colors.accent, color: "white", bold: true, children: title }), middleText ? (_jsxs(Text, { backgroundColor: Colors.accent, color: "white", dimColor: true, children: [padding, middleText] })) : (_jsx(Text, { backgroundColor: Colors.accent, color: "white", children: padding })), _jsx(Text, { backgroundColor: Colors.accent, color: "white", bold: true, children: feedback })] }));
 };

package/dist/src/ui/tui/console-commands.d.ts

@@ -12,8 +12,6 @@ export declare const COMMANDS: {
 export declare const TEST_PROMPT: string;
 /** Returns the feedback text for the /whoami command. */
 export declare function getWhoamiText(session: Pick<WizardSession, 'selectedOrgName' | 'selectedWorkspaceName' | 'region'>): string;
-/** Returns the feedback text for the /help command. */
-export declare function getHelpText(): string;
 /**
  * Parses `/feedback <message>` from a slash command line.
  * Returns `undefined` if the line is not a feedback command or the message is empty.

package/dist/src/ui/tui/console-commands.js

@@ -18,7 +18,6 @@ export const COMMANDS = [
     { cmd: '/test', desc: 'Run a prompt-skill demo (confirm + choose)' },
     { cmd: '/snake', desc: 'Play Snake' },
     { cmd: '/exit', desc: 'Exit the wizard' },
-    { cmd: '/help', desc: 'List available slash commands' },
 ];
 export const TEST_PROMPT = 'Demo the wizard prompt tools. ' +
     'First, use the wizard-tools:confirm tool to ask if I want to continue. ' +
@@ -28,11 +27,6 @@ export const TEST_PROMPT = 'Demo the wizard prompt tools. ' +
 export function getWhoamiText(session) {
     return `org: ${session.selectedOrgName ?? '(none)'}  workspace: ${session.selectedWorkspaceName ?? '(none)'}  region: ${session.region ?? '(none)'}`;
 }
-/** Returns the feedback text for the /help command. */
-export function getHelpText() {
-    const maxCmd = Math.max(...COMMANDS.map((c) => c.cmd.length));
-    return COMMANDS.map((c) => `${c.cmd.padEnd(maxCmd)}  ${c.desc}`).join('\n');
-}
 /**
  * Parses `/feedback <message>` from a slash command line.
  * Returns `undefined` if the line is not a feedback command or the message is empty.

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

@@ -5,7 +5,8 @@
  *   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
+ *   4. Project selection — picker if the workspace has multiple environments
+ *   5. API key entry — text input (only if no project key could be resolved)
  *
  * The screen drives itself from session.pendingOrgs + session.credentials.
  * When credentials are set the router resolves past this screen.

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

@@ -6,7 +6,8 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
  *   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
+ *   4. Project selection — picker if the workspace has multiple environments
+ *   5. API key entry — text input (only if no project key could be resolved)
  *
  * The screen drives itself from session.pendingOrgs + session.credentials.
  * When credentials are set the router resolves past this screen.
@@ -18,29 +19,67 @@ 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';
+/**
+ * Returns the environments with usable API keys from a workspace, sorted by rank.
+ */
+function getSelectableEnvironments(workspace) {
+    if (!workspace?.environments)
+        return [];
+    return workspace.environments
+        .filter((env) => env.app?.apiKey)
+        .sort((a, b) => a.rank - b.rank);
+}
 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);
+    // Track the selected workspace locally so we can access its environments
+    const [selectedWorkspace, setSelectedWorkspace] = useState(null);
+    const [selectedEnv, setSelectedEnv] = 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
+    // Resolve org: user-picked > single-org auto-select > pre-populated from session
+    const prePopulatedOrg = session.selectedOrgId && pendingOrgs
+        ? pendingOrgs.find((o) => o.id === session.selectedOrgId) ?? null
+        : null;
+    const effectiveOrg = selectedOrg ??
+        (pendingOrgs?.length === 1 ? pendingOrgs[0] : null) ??
+        prePopulatedOrg;
+    // Resolve workspace: user-picked > single-workspace auto-select > pre-populated from session
     const singleWorkspace = effectiveOrg?.workspaces.length === 1 ? effectiveOrg.workspaces[0] : null;
+    const prePopulatedWorkspace = session.selectedWorkspaceId && effectiveOrg
+        ? effectiveOrg.workspaces.find((ws) => ws.id === session.selectedWorkspaceId) ?? null
+        : null;
+    const effectiveWorkspace = selectedWorkspace ?? singleWorkspace ?? prePopulatedWorkspace ?? null;
     useEffect(() => {
-        if (effectiveOrg && singleWorkspace && !session.selectedWorkspaceId) {
-            store.setOrgAndWorkspace(effectiveOrg, singleWorkspace, session.installDir);
+        if (effectiveOrg && effectiveWorkspace && !session.selectedWorkspaceId) {
+            store.setOrgAndWorkspace(effectiveOrg, effectiveWorkspace, session.installDir);
         }
-    }, [effectiveOrg?.id, singleWorkspace?.id, session.selectedWorkspaceId]);
-    const workspaceChosen = session.selectedWorkspaceId !== null ||
-        (effectiveOrg !== null && effectiveOrg.workspaces.length === 1);
-    // Resolve API key: local storage first, then Amplitude backend (same as bin.ts
-    // for returning users) once org/workspace are on the session after OAuth.
+    }, [effectiveOrg?.id, effectiveWorkspace?.id, session.selectedWorkspaceId]);
+    // workspaceChosen requires the local workspace object (effectiveWorkspace)
+    // rather than just session.selectedWorkspaceId, because we need the
+    // environments list to drive the project picker. When selectedWorkspaceId is
+    // pre-populated from ampli.json but no workspace object exists yet,
+    // selectableEnvs would be empty and the picker would be bypassed.
+    const workspaceChosen = effectiveWorkspace !== null;
+    // Environments available in the selected workspace
+    const selectableEnvs = getSelectableEnvironments(effectiveWorkspace);
+    const hasMultipleEnvs = selectableEnvs.length > 1;
+    // Auto-select the environment when there's only one with an API key
     useEffect(() => {
-        if (!workspaceChosen || session.credentials !== null)
+        if (workspaceChosen && !selectedEnv && selectableEnvs.length === 1) {
+            setSelectedEnv(selectableEnvs[0]);
+            store.setSelectedProjectName(selectableEnvs[0].name);
+        }
+    }, [workspaceChosen, selectedEnv, selectableEnvs.length]);
+    // True once the user has picked an environment (or it was auto-selected),
+    // or there are no environments to pick from (falls through to manual key entry).
+    const envResolved = selectedEnv !== null || selectableEnvs.length === 0;
+    // Resolve API key from local storage, selected environment, or backend fetch.
+    useEffect(() => {
+        if (!workspaceChosen || !envResolved || session.credentials !== null)
             return;
         let cancelled = false;
         void (async () => {
@@ -50,6 +89,7 @@ export const AuthScreen = ({ store }) => {
             const { readApiKeyWithSource, persistApiKey } = await import('../../../utils/api-key-store.js');
             if (cancelled)
                 return;
+            // 1. Check local storage first
             const local = readApiKeyWithSource(s.installDir);
             if (local) {
                 setSavedKeySource(local.source);
@@ -67,6 +107,31 @@ export const AuthScreen = ({ store }) => {
                 store.setApiKeyNotice(null);
                 return;
             }
+            // 2. Use the API key from the selected environment
+            if (selectedEnv?.app?.apiKey) {
+                const apiKey = selectedEnv.app.apiKey;
+                const zone = (s.region ??
+                    s.pendingAuthCloudRegion ??
+                    'us');
+                const { getHostFromRegion } = await import('../../../utils/urls.js');
+                if (cancelled || store.session.credentials !== null)
+                    return;
+                persistApiKey(apiKey, s.installDir);
+                analytics.wizardCapture('API Key Submitted', {
+                    key_source: 'environment_picker',
+                });
+                store.setCredentials({
+                    accessToken: s.pendingAuthAccessToken ?? '',
+                    idToken: s.pendingAuthIdToken ?? undefined,
+                    projectApiKey: apiKey,
+                    host: getHostFromRegion(zone),
+                    projectId: 0,
+                });
+                store.setProjectHasData(false);
+                store.setApiKeyNotice(null);
+                return;
+            }
+            // 3. Fall back to backend fetch (no environments with keys available)
             const idToken = s.pendingAuthIdToken;
             if (!idToken)
                 return;
@@ -109,6 +174,8 @@ export const AuthScreen = ({ store }) => {
         };
     }, [
         workspaceChosen,
+        envResolved,
+        selectedEnv,
         session.credentials,
         session.selectedWorkspaceId,
         session.pendingAuthIdToken,
@@ -119,8 +186,15 @@ export const AuthScreen = ({ store }) => {
     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;
+        !selectedWorkspace;
+    const needsProjectPick = workspaceChosen && hasMultipleEnvs && !selectedEnv;
+    const needsApiKey = effectiveOrg !== null &&
+        workspaceChosen &&
+        envResolved &&
+        session.credentials === null &&
+        // Only show manual input if there's no selected env with a key
+        // (either no envs available, or the env had no key)
+        !selectedEnv?.app?.apiKey;
     const handleApiKeySubmit = (value) => {
         const trimmed = value.trim();
         if (!trimmed) {
@@ -158,7 +232,15 @@ export const AuthScreen = ({ store }) => {
                             value: ws,
                         })), onSelect: (value) => {
                             const ws = Array.isArray(value) ? value[0] : value;
+                            setSelectedWorkspace(ws);
                             store.setOrgAndWorkspace(effectiveOrg, ws, session.installDir);
+                        } })] })), needsProjectPick && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { color: Colors.muted, children: "Select a project:" }), _jsx(PickerMenu, { options: selectableEnvs.map((env) => ({
+                            label: env.name,
+                            value: env,
+                        })), onSelect: (value) => {
+                            const env = Array.isArray(value) ? value[0] : value;
+                            setSelectedEnv(env);
+                            store.setSelectedProjectName(env.name);
                         } })] })), 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/DataIngestionCheckScreen.js

@@ -45,11 +45,23 @@ export const DataIngestionCheckScreen = ({ store, }) => {
             return;
         }
         const zone = (region ?? 'us');
+        const idToken = credentials.idToken ?? credentials.accessToken;
         try {
-            const status = await fetchProjectActivationStatus(credentials.idToken ?? credentials.accessToken, zone, appId, session.selectedOrgId);
+            const status = await fetchProjectActivationStatus(idToken, zone, appId, session.selectedOrgId);
             logToFile(`[DataIngestionCheck] poll result: hasAnyEvents=${status.hasAnyEvents} hasDetSource=${status.hasDetSource}`);
             if (status.hasAnyEvents) {
                 store.setDataIngestionConfirmed();
+                return;
+            }
+            // The activation API only checks autocapture events (page_viewed,
+            // session_start, session_end). Custom track() calls won't appear there.
+            // Fall back to the event catalog which includes all event types.
+            if (session.selectedOrgId && session.selectedWorkspaceId) {
+                const catalogEvents = await fetchWorkspaceEventTypes(idToken, zone, session.selectedOrgId, session.selectedWorkspaceId);
+                logToFile(`[DataIngestionCheck] catalog fallback: ${catalogEvents.length} event types found`);
+                if (catalogEvents.length > 0) {
+                    store.setDataIngestionConfirmed();
+                }
             }
         }
         catch (err) {
@@ -57,7 +69,6 @@ export const DataIngestionCheckScreen = ({ store, }) => {
             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);

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

@@ -60,7 +60,6 @@ export const OutroScreen = ({ store }) => {
                             opn(url, { wait: false }).catch(() => {
                                 /* fire-and-forget */
                             });
-                            process.exit(0);
                         }
                         else {
                             process.exit(0);

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

@@ -16,10 +16,5 @@ interface SlackScreenProps {
     /** When provided, called on completion instead of setSlackComplete (overlay mode). */
     onComplete?: () => void;
 }
-/**
- * Build the Amplitude settings URL for Slack connection.
- * Uses the org name from the API; falls back to base URL.
- */
-export declare function slackSettingsUrl(baseUrl: string, orgName: string | null): string;
 export declare const SlackScreen: ({ store, standalone, onComplete, }: SlackScreenProps) => import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -26,16 +26,6 @@ var Phase;
     Phase["Waiting"] = "waiting";
     Phase["Done"] = "done";
 })(Phase || (Phase = {}));
-/**
- * Build the Amplitude settings URL for Slack connection.
- * Uses the org name from the API; falls back to base URL.
- */
-export function slackSettingsUrl(baseUrl, orgName) {
-    if (orgName) {
-        return `${baseUrl}/analytics/${encodeURIComponent(orgName)}/settings/profile`;
-    }
-    return `${baseUrl}/settings/profile`;
-}
 const markDone = (store, outcome, standalone, onComplete) => {
     if (onComplete) {
         onComplete();
@@ -78,7 +68,7 @@ export const SlackScreen = ({ store, standalone = false, onComplete, }) => {
             logToFile(`[SlackScreen] API fetch failed: ${err instanceof Error ? err.message : String(err)}`);
         });
     }, []);
-    const settingsUrl = slackSettingsUrl(OUTBOUND_URLS.overview[(region ?? 'us')], resolvedOrgName);
+    const settingsUrl = OUTBOUND_URLS.slackSettings((region ?? 'us'), store.session.selectedOrgId, resolvedOrgName);
     const handleConnect = () => {
         setPhase(Phase.Opening);
         opn(settingsUrl, { wait: false }).catch(() => {

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

@@ -97,6 +97,7 @@ export declare class WizardStore {
     setRunPhase(phase: RunPhase): void;
     setCredentials(credentials: WizardSession['credentials']): void;
     setApiKeyNotice(notice: string | null): void;
+    setSelectedProjectName(name: string | null): void;
     setFrameworkConfig(integration: WizardSession['integration'], config: WizardSession['frameworkConfig']): void;
     setDetectionComplete(): void;
     setDetectedFramework(label: string): void;
@@ -188,6 +189,8 @@ export declare class WizardStore {
     /**
      * Enable an additional feature: enqueue it for the stop hook
      * and set any feature-specific session flags.
+     * Respects Amplitude Experiment feature flags — if the corresponding
+     * flag is off the feature is silently skipped.
      */
     enableFeature(feature: AdditionalFeature): void;
     setAmplitudePreDetected(): void;

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

@@ -14,6 +14,7 @@ import { TaskStatus } from '../wizard-ui.js';
 import { AdditionalFeature, McpOutcome, SlackOutcome, RunPhase, buildSession, } from '../../lib/wizard-session.js';
 import { WizardRouter, Screen, Overlay, Flow, } from './router.js';
 import { analytics, sessionPropertiesCompact } from '../../utils/analytics.js';
+import { FLAG_LLM_ANALYTICS } from '../../lib/feature-flags.js';
 export { TaskStatus, Screen, Overlay, Flow, RunPhase, McpOutcome, SlackOutcome, };
 export class WizardStore {
     // ── Internal nanostore atoms ─────────────────────────────────────
@@ -128,6 +129,10 @@ export class WizardStore {
         this.$session.setKey('apiKeyNotice', notice);
         this.emitChange();
     }
+    setSelectedProjectName(name) {
+        this.$session.setKey('selectedProjectName', name);
+        this.emitChange();
+    }
     setFrameworkConfig(integration, config) {
         this.$session.setKey('integration', integration);
         this.$session.setKey('frameworkConfig', config);
@@ -405,8 +410,16 @@ export class WizardStore {
     /**
      * Enable an additional feature: enqueue it for the stop hook
      * and set any feature-specific session flags.
+     * Respects Amplitude Experiment feature flags — if the corresponding
+     * flag is off the feature is silently skipped.
      */
     enableFeature(feature) {
+        // Gate LLM analytics behind the wizard-llm-analytics feature flag
+        if (feature === AdditionalFeature.LLM) {
+            if (!analytics.isFeatureFlagEnabled(FLAG_LLM_ANALYTICS)) {
+                return;
+            }
+        }
         if (!this.session.additionalFeatureQueue.includes(feature)) {
             this.session.additionalFeatureQueue.push(feature);
         }

package/dist/src/utils/analytics.d.ts

@@ -36,8 +36,26 @@ export declare class Analytics {
      * per Amplitude quickstart taxonomy guidelines.
      */
     wizardCapture(eventName: string, properties?: Record<string, unknown>): void;
+    /**
+     * Apply feature-flag–based opt-out to the Amplitude SDK.
+     * Defaults to ON — only opts out when `wizard-agent-analytics` is explicitly 'off'/'false'.
+     */
+    applyOptOut(): void;
     private ensureInitStarted;
+    /**
+     * Initialize the Amplitude Experiment feature-flag client.
+     * Call once early in startup (e.g. after obtaining a user/device ID).
+     */
+    initFlags(): Promise<void>;
+    /**
+     * Re-evaluate flags after the user identity changes (e.g. post-login).
+     */
+    refreshFlags(): Promise<void>;
     getFeatureFlag(flagKey: string): Promise<string | boolean | undefined>;
+    /**
+     * Check if a flag is enabled (variant is 'on' or 'true').
+     */
+    isFeatureFlagEnabled(flagKey: string): boolean;
     /**
      * Evaluate all feature flags for the current user at the start of a run.
      * Result is cached; subsequent calls in the same run return the same map.

package/dist/src/utils/analytics.js

@@ -9,6 +9,7 @@ exports.captureWizardError = captureWizardError;
 const analytics_node_1 = require("@amplitude/analytics-node");
 const uuid_1 = require("uuid");
 const debug_1 = require("./debug");
+const feature_flags_1 = require("../lib/feature-flags");
 const DEFAULT_TELEMETRY_API_KEY = 'e5a2c9bdffe949f7da77e6b481e118fa';
 /**
  * Telemetry project API key. Empty or whitespace-only env value means “no key”
@@ -107,6 +108,18 @@ class Analytics {
     wizardCapture(eventName, properties) {
         this.capture(`wizard: ${eventName}`, properties);
     }
+    /**
+     * Apply feature-flag–based opt-out to the Amplitude SDK.
+     * Defaults to ON — only opts out when `wizard-agent-analytics` is explicitly 'off'/'false'.
+     */
+    applyOptOut() {
+        const flagValue = (0, feature_flags_1.getFlag)(feature_flags_1.FLAG_AGENT_ANALYTICS);
+        const optOut = flagValue === 'off' || flagValue === 'false';
+        this.client.setOptOut(optOut);
+        if (optOut) {
+            (0, debug_1.debug)('analytics: opted out via wizard-agent-analytics flag');
+        }
+    }
     ensureInitStarted() {
         if (this.initPromise !== null) {
             return;
@@ -119,10 +132,29 @@ class Analytics {
             serverUrl: getAmplitudeNodeServerUrl(),
         }).promise;
     }
+    /**
+     * Initialize the Amplitude Experiment feature-flag client.
+     * Call once early in startup (e.g. after obtaining a user/device ID).
+     */
+    async initFlags() {
+        await (0, feature_flags_1.initFeatureFlags)(this.distinctId, this.anonymousId);
+    }
+    /**
+     * Re-evaluate flags after the user identity changes (e.g. post-login).
+     */
+    async refreshFlags() {
+        await (0, feature_flags_1.refreshFlags)(this.distinctId, this.anonymousId);
+        this.activeFlags = (0, feature_flags_1.getAllFlags)();
+    }
     // eslint-disable-next-line @typescript-eslint/require-await
     async getFeatureFlag(flagKey) {
-        (0, debug_1.debug)('getFeatureFlag (noop):', flagKey);
-        return undefined;
+        return (0, feature_flags_1.getFlag)(flagKey);
+    }
+    /**
+     * Check if a flag is enabled (variant is 'on' or 'true').
+     */
+    isFeatureFlagEnabled(flagKey) {
+        return (0, feature_flags_1.isFlagEnabled)(flagKey);
     }
     /**
      * Evaluate all feature flags for the current user at the start of a run.
@@ -134,7 +166,7 @@ class Analytics {
         if (this.activeFlags !== null) {
             return this.activeFlags;
         }
-        this.activeFlags = {};
+        this.activeFlags = (0, feature_flags_1.getAllFlags)();
         return this.activeFlags;
     }
     async shutdown(status) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amplitude/wizard",
-  "version": "1.0.0-beta.1",
+  "version": "1.0.0-beta.2",
   "homepage": "https://github.com/amplitude/wizard",
   "repository": "https://github.com/amplitude/wizard",
   "description": "The Amplitude wizard helps you to configure your project",
@@ -38,6 +38,7 @@
   "dependencies": {
     "@amplitude/analytics-browser": "^2.0.0",
     "@amplitude/analytics-node": "^1.5.51",
+    "@amplitude/experiment-node-server": "^1.13.4",
     "@anthropic-ai/claude-agent-sdk": "0.2.7",
     "@inkjs/ui": "^2.0.0",
     "@inquirer/prompts": "^8.3.0",
@@ -103,7 +104,15 @@
     "node": ">=20",
     "npm": ">=3.10.7"
   },
-  "packageManager": "pnpm@10.23.0+sha512.21c4e5698002ade97e4efe8b8b4a89a8de3c85a37919f957e7a0f30f38fbc5bbdd05980ffe29179b2fb6e6e691242e098d945d1601772cad0fef5fb6411e2a4b",
+  "lint-staged": {
+    "*.{js,ts,tsx,jsx}": "pnpm fix"
+  },
+  "author": "Amplitude",
+  "license": "MIT",
+  "volta": {
+    "node": "20.18.2",
+    "pnpm": "10.23.0"
+  },
   "scripts": {
     "clean": "rm -rf ./dist",
     "prebuild": "pnpm clean",
@@ -125,21 +134,11 @@
     "proxy:bypass": "cd \"${JS_REPO:-../javascript}\"/server/packages/thunder && WIZARD_PROXY_DEV_BYPASS=1 aws-sso exec --profile us-prod-dev -- pnpm debug",
     "dev": "pnpm build && pnpm link --global && (trap 'kill 0' EXIT; pnpm proxy & pnpm build:watch)",
     "test:watch": "vitest",
-    "prepare": "husky",
     "flows": "node scripts/render-flows.mjs",
     "test:bdd": "cucumber-js",
     "test:bdd:watch": "cucumber-js --retry 0 2>&1 | npx nodemon --watch features --exec cucumber-js",
     "test:proxy": "vitest run --config vitest.config.proxy.ts",
     "test:proxy:smoke": "vitest run --config vitest.config.proxy.ts -t 'proxy:smoke'",
     "skills:refresh": "bash scripts/refresh-instrumentation-skills.sh"
-  },
-  "lint-staged": {
-    "*.{js,ts,tsx,jsx}": "pnpm fix"
-  },
-  "author": "Amplitude",
-  "license": "MIT",
-  "volta": {
-    "node": "20.18.2",
-    "pnpm": "10.23.0"
   }
-}
+}

package/dist/package.json

@@ -1,145 +0,0 @@
-{
-    "name": "@amplitude/wizard",
-    "version": "1.0.0-beta.1",
-    "homepage": "https://github.com/amplitude/wizard",
-    "repository": "https://github.com/amplitude/wizard",
-    "description": "The Amplitude wizard helps you to configure your project",
-    "keywords": [
-        "amplitude",
-        "wizard",
-        "sdk",
-        "cli",
-        "project",
-        "setup",
-        "install",
-        "configure"
-    ],
-    "bin": {
-        "amplitude-wizard": "dist/bin.js"
-    },
-    "publishConfig": {
-        "access": "public"
-    },
-    "man": [
-        "man/amplitude-wizard.1"
-    ],
-    "files": [
-        "dist/bin.*",
-        "dist/src",
-        "man/",
-        "package.json",
-        "README.md"
-    ],
-    "main": "dist/index.js",
-    "typings": "dist/index.d.ts",
-    "typescript": {
-        "definition": "dist/index.d.ts"
-    },
-    "dependencies": {
-        "@amplitude/analytics-browser": "^2.0.0",
-        "@amplitude/analytics-node": "^1.5.51",
-        "@anthropic-ai/claude-agent-sdk": "0.2.7",
-        "@inkjs/ui": "^2.0.0",
-        "@inquirer/prompts": "^8.3.0",
-        "@langchain/core": "^1.1.33",
-        "@pavus/snake-game": "^1.1.1",
-        "axios": "1.13.5",
-        "chalk": "^2.4.1",
-        "client-oauth2": "^4.3.3",
-        "conf": "^15.1.0",
-        "dotenv": "^16.4.7",
-        "fast-glob": "^3.3.3",
-        "glob": "9.3.5",
-        "ink": "^6.8.0",
-        "inquirer": "^6.2.0",
-        "jsonc-parser": "^3.3.1",
-        "lodash": "^4.17.21",
-        "magicast": "^0.2.10",
-        "nanostores": "^1.1.1",
-        "opn": "^5.4.0",
-        "pkce-challenge": "^6.0.0",
-        "randomstring": "^1.3.1",
-        "react": "^19.2.4",
-        "read-env": "^1.3.0",
-        "recast": "^0.23.3",
-        "semver": "^7.5.3",
-        "uuid": "^11.1.0",
-        "xcode": "3.0.1",
-        "xml-js": "^1.6.11",
-        "yargs": "^16.2.0",
-        "zod": "^4.3.6",
-        "zod-to-json-schema": "^3.25.1"
-    },
-    "devDependencies": {
-        "@anthropic-ai/sdk": "^0.79.0",
-        "@cucumber/cucumber": "^12.7.0",
-        "@eslint/js": "^10.0.1",
-        "@types/chai": "^4.3.17",
-        "@types/glob": "^7.2.0",
-        "@types/inquirer": "^0.0.43",
-        "@types/lodash": "^4.17.15",
-        "@types/node": "^20.19.37",
-        "@types/opn": "5.1.0",
-        "@types/react": "^19.2.14",
-        "@types/rimraf": "^3.0.2",
-        "@types/semver": "^7.3.7",
-        "@types/yargs": "^16.0.9",
-        "@vitest/coverage-v8": "^4.0.18",
-        "eslint": "^9.39.4",
-        "eslint-config-prettier": "^9.1.2",
-        "globals": "^17.4.0",
-        "husky": "^9.1.7",
-        "lint-staged": "^15.5.1",
-        "msw": "^2.10.4",
-        "prettier": "^2.8.7",
-        "rimraf": "^6.1.3",
-        "ts-node": "^10.9.1",
-        "tsx": "^4.20.3",
-        "typescript": "^5.0.4",
-        "typescript-eslint": "^8.57.1",
-        "vitest": "^4.0.18"
-    },
-    "engines": {
-        "node": ">=20",
-        "npm": ">=3.10.7"
-    },
-    "packageManager": "pnpm@10.23.0+sha512.21c4e5698002ade97e4efe8b8b4a89a8de3c85a37919f957e7a0f30f38fbc5bbdd05980ffe29179b2fb6e6e691242e098d945d1601772cad0fef5fb6411e2a4b",
-    "scripts": {
-        "clean": "rm -rf ./dist",
-        "prebuild": "pnpm clean",
-        "build:watch": "pnpm tsc -w",
-        "build": "pnpm tsc",
-        "postbuild": "chmod +x ./dist/bin.js && pnpm test:smoke",
-        "test:smoke": "node -e \"require('./dist/bin.js')\" 2>&1 | head -5 | grep -q 'Amplitude Wizard' || (echo 'Smoke test failed: compiled binary crashed on load' && exit 1)",
-        "lint": "pnpm lint:prettier && pnpm lint:eslint",
-        "lint:prettier": "prettier --check \"{lib,src,test}/**/*.ts\"",
-        "lint:eslint": "eslint . --cache --format stylish",
-        "fix": "pnpm fix:eslint && pnpm fix:prettier",
-        "fix:prettier": "prettier --write \"{lib,src,test}/**/*.ts\"",
-        "fix:eslint": "eslint . --format stylish --fix",
-        "test": "vitest run",
-        "test:e2e": "pnpm build && ./e2e-tests/run.sh",
-        "test:e2e-record": "export RECORD_FIXTURES=true && pnpm build && ./e2e-tests/run.sh",
-        "try": "tsx bin.ts",
-        "proxy": "cd \"${JS_REPO:-../javascript}\"/server/packages/thunder && aws-sso exec --profile us-prod-dev -- pnpm debug",
-        "proxy:bypass": "cd \"${JS_REPO:-../javascript}\"/server/packages/thunder && WIZARD_PROXY_DEV_BYPASS=1 aws-sso exec --profile us-prod-dev -- pnpm debug",
-        "dev": "pnpm build && pnpm link --global && (trap 'kill 0' EXIT; pnpm proxy & pnpm build:watch)",
-        "test:watch": "vitest",
-        "prepare": "husky",
-        "flows": "node scripts/render-flows.mjs",
-        "test:bdd": "cucumber-js",
-        "test:bdd:watch": "cucumber-js --retry 0 2>&1 | npx nodemon --watch features --exec cucumber-js",
-        "test:proxy": "vitest run --config vitest.config.proxy.ts",
-        "test:proxy:smoke": "vitest run --config vitest.config.proxy.ts -t 'proxy:smoke'",
-        "skills:refresh": "bash scripts/refresh-instrumentation-skills.sh"
-    },
-    "lint-staged": {
-        "*.{js,ts,tsx,jsx}": "pnpm fix"
-    },
-    "author": "Amplitude",
-    "license": "MIT",
-    "volta": {
-        "node": "20.18.2",
-        "pnpm": "10.23.0"
-    }
-}