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

package/dist/bin.js

@@ -142,11 +142,6 @@ void (0, yargs_1.default)((0, helpers_1.hideBin)(process.argv))
     if (options.ci) {
         // Use LoggingUI for CI mode (no dependencies, no prompts)
         (0, ui_1.setUI)(new logging_ui_1.LoggingUI());
-        if (!options.apiKey) {
-            (0, ui_1.getUI)().intro(chalk_1.default.inverse(`Amplitude Wizard`));
-            (0, ui_1.getUI)().log.error('CI mode requires --api-key (Amplitude project API key)');
-            process.exit(1);
-        }
         if (!options.installDir) {
             (0, ui_1.getUI)().intro(chalk_1.default.inverse(`Amplitude Wizard`));
             (0, ui_1.getUI)().log.error('CI mode requires --install-dir (directory to install Amplitude in)');
@@ -161,7 +156,8 @@ void (0, yargs_1.default)((0, helpers_1.hideBin)(process.argv))
             'It appears you are running in a non-interactive environment.\n' +
             'Please run the wizard in an interactive terminal.\n\n' +
             'For CI/CD environments, use --ci mode:\n' +
-            '  npx @amplitude/wizard --ci --api-key <your-key> --install-dir .');
+            '  npx @amplitude/wizard --ci --install-dir . [--api-key <your-key>]\n' +
+            '  (--api-key is optional when a key can be resolved from env or stored credentials.)');
         process.exit(1);
     }
     else {
@@ -476,11 +472,19 @@ void (0, yargs_1.default)((0, helpers_1.hideBin)(process.argv))
                 const localDetection = detectAmplitudeInProject(installDir);
                 if (localDetection.confidence !== 'none') {
                     const { logToFile: log } = await import('./src/utils/debug.js');
-                    log(`[bin] Amplitude already detected (${localDetection.reason ?? 'unknown'}) — skipping agent`);
+                    log(`[bin] Amplitude already detected (${localDetection.reason ?? 'unknown'}) — prompting on MCP screen (continue vs run wizard)`);
                     const { RunPhase, OutroKind } = await import('./src/lib/wizard-session.js');
                     tui.store.setAmplitudePreDetected();
-                    tui.store.setOutroData({ kind: OutroKind.Success });
                     tui.store.setRunPhase(RunPhase.Completed);
+                    const runWizardAnyway = await tui.store.waitForPreDetectedChoice();
+                    if (runWizardAnyway) {
+                        log('[bin] user chose to run setup wizard despite pre-detection');
+                        tui.store.resetForAgentAfterPreDetected();
+                        await (0, run_1.runWizard)(options, tui.store.session);
+                    }
+                    else {
+                        tui.store.setOutroData({ kind: OutroKind.Success });
+                    }
                 }
                 else {
                     await (0, run_1.runWizard)(options, tui.store.session);
@@ -589,6 +593,36 @@ void (0, yargs_1.default)((0, helpers_1.hideBin)(process.argv))
         }
         process.exit(0);
     })();
+})
+    .command('feedback', 'Send product feedback (Amplitude event: wizard: Feedback Submitted)', (yargs) => {
+    return yargs.options({
+        message: {
+            alias: 'm',
+            describe: 'Feedback message',
+            type: 'string',
+        },
+    });
+}, (argv) => {
+    void (async () => {
+        (0, ui_1.setUI)(new logging_ui_1.LoggingUI());
+        const fromFlag = typeof argv.message === 'string' ? argv.message.trim() : '';
+        const argvRest = argv._.slice(1).join(' ').trim();
+        const message = (fromFlag || argvRest).trim();
+        if (!message) {
+            (0, ui_1.getUI)().log.error('Usage: amplitude-wizard feedback <message>  or  feedback --message <message>');
+            process.exit(1);
+        }
+        try {
+            const { trackWizardFeedback } = await import('./src/utils/track-wizard-feedback.js');
+            await trackWizardFeedback(message);
+            console.log(chalk_1.default.green('✔ Thanks — your feedback was sent.'));
+            process.exit(0);
+        }
+        catch (e) {
+            console.error(chalk_1.default.red(`Feedback failed: ${e instanceof Error ? e.message : String(e)}`));
+            process.exit(1);
+        }
+    })();
 })
     .command('slack', 'Set up Amplitude Slack integration', (y) => y, (argv) => {
     void (async () => {

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@amplitude/wizard",
-    "version": "1.0.0-beta.0",
+    "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",
@@ -37,6 +37,7 @@
     },
     "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",

package/dist/src/lib/agent-interface.js

@@ -153,7 +153,7 @@ function backupAndFixClaudeSettings(workingDirectory) {
     for (const name of ['settings.json', 'settings']) {
         const filePath = path_1.default.join(workingDirectory, '.claude', name);
         const backupPath = `${filePath}.wizard-backup`;
-        analytics_1.analytics.wizardCapture('backedup-claude-settings');
+        analytics_1.analytics.wizardCapture('Claude Settings Backed Up');
         try {
             fs.copyFileSync(filePath, backupPath);
             fs.unlinkSync(filePath);
@@ -182,7 +182,7 @@ function restoreClaudeSettings(workingDirectory) {
         const backup = path_1.default.join(workingDirectory, '.claude', `${name}.wizard-backup`);
         try {
             fs.copyFileSync(backup, path_1.default.join(workingDirectory, '.claude', name));
-            analytics_1.analytics.wizardCapture('restored-claude-settings');
+            analytics_1.analytics.wizardCapture('Claude Settings Restored');
             return;
         }
         catch (error) {
@@ -490,10 +490,7 @@ function wizardCanUseTool(toolName, input) {
     if (DANGEROUS_OPERATORS.test(command)) {
         (0, debug_1.logToFile)(`Denying bash command with dangerous operators: ${command}`);
         (0, debug_1.debug)(`Denying bash command with dangerous operators: ${command}`);
-        analytics_1.analytics.wizardCapture('bash denied', {
-            reason: 'dangerous operators',
-            command,
-        });
+        (0, analytics_1.captureWizardError)('Bash Policy', 'Dangerous shell operators are not permitted', 'wizardCanUseBash', { deny_reason: 'dangerous operators', command });
         return {
             behavior: 'deny',
             message: `Bash command not allowed. Shell operators like ; \` $ ( ) are not permitted.`,
@@ -509,10 +506,7 @@ function wizardCanUseTool(toolName, input) {
         if (/[|&]/.test(baseCommand)) {
             (0, debug_1.logToFile)(`Denying bash command with multiple pipes: ${command}`);
             (0, debug_1.debug)(`Denying bash command with multiple pipes: ${command}`);
-            analytics_1.analytics.wizardCapture('bash denied', {
-                reason: 'multiple pipes',
-                command,
-            });
+            (0, analytics_1.captureWizardError)('Bash Policy', 'Multiple pipes are not permitted', 'wizardCanUseBash', { deny_reason: 'multiple pipes', command });
             return {
                 behavior: 'deny',
                 message: `Bash command not allowed. Only single pipe to tail/head is permitted.`,
@@ -528,10 +522,7 @@ function wizardCanUseTool(toolName, input) {
     if (/[|&]/.test(normalized)) {
         (0, debug_1.logToFile)(`Denying bash command with pipe/&: ${command}`);
         (0, debug_1.debug)(`Denying bash command with pipe/&: ${command}`);
-        analytics_1.analytics.wizardCapture('bash denied', {
-            reason: 'disallowed pipe',
-            command,
-        });
+        (0, analytics_1.captureWizardError)('Bash Policy', 'Pipes are only allowed with tail/head', 'wizardCanUseBash', { deny_reason: 'disallowed pipe', command });
         return {
             behavior: 'deny',
             message: `Bash command not allowed. Pipes are only permitted with tail/head for output limiting.`,
@@ -545,10 +536,7 @@ function wizardCanUseTool(toolName, input) {
     }
     (0, debug_1.logToFile)(`Denying bash command: ${command}`);
     (0, debug_1.debug)(`Denying bash command: ${command}`);
-    analytics_1.analytics.wizardCapture('bash denied', {
-        reason: 'not in allowlist',
-        command,
-    });
+    (0, analytics_1.captureWizardError)('Bash Policy', 'Command not in allowlist', 'wizardCanUseBash', { deny_reason: 'not in allowlist', command });
     return {
         behavior: 'deny',
         message: `Bash command not allowed. Only install, build, typecheck, lint, and formatting commands are permitted.`,
@@ -783,10 +771,10 @@ async function runAgent(agentConfig, prompt, options, spinner, config, middlewar
         if (remarkMatch && remarkMatch[1]) {
             const remark = remarkMatch[1].trim();
             if (remark) {
-                analytics_1.analytics.capture(constants_1.WIZARD_REMARK_EVENT_NAME, { remark });
+                analytics_1.analytics.wizardCapture('Wizard Remark', { remark });
             }
         }
-        analytics_1.analytics.wizardCapture('agent completed', {
+        analytics_1.analytics.wizardCapture('Agent Completed', {
             duration_ms: durationMs,
             duration_seconds: durationSeconds,
         });
@@ -883,7 +871,7 @@ async function runAgent(agentConfig, prompt, options, spinner, config, middlewar
         for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
             if (attempt > 0) {
                 (0, debug_1.logToFile)(`Agent stall retry: attempt ${attempt + 1} of ${MAX_RETRIES + 1}`);
-                analytics_1.analytics.wizardCapture('agent stall retry', { attempt });
+                analytics_1.analytics.wizardCapture('Agent Stall Retry', { attempt });
                 // Clear per-attempt output so stale error markers don't affect the fresh run
                 collectedText.length = 0;
                 recentStatuses.length = 0;
@@ -910,7 +898,7 @@ async function runAgent(agentConfig, prompt, options, spinner, config, middlewar
                     clearTimeout(staleTimer);
                 staleTimer = setTimeout(() => {
                     (0, debug_1.logToFile)(`Agent stalled — no message for ${STALL_TIMEOUT_MS / 1000}s (attempt ${attempt + 1})`);
-                    analytics_1.analytics.wizardCapture('agent stall detected', {
+                    analytics_1.analytics.wizardCapture('Agent Stall Detected', {
                         attempt: attempt + 1,
                         stall_timeout_ms: STALL_TIMEOUT_MS,
                     });

package/dist/src/lib/agent-runner.js

@@ -140,7 +140,7 @@ async function runAgentWizard(config, session) {
         const versionBucket = config.detection.getVersionBucket(frameworkVersion);
         analytics_1.analytics.setTag(`${config.metadata.integration}-version`, versionBucket);
     }
-    analytics_1.analytics.wizardCapture('agent started', {
+    analytics_1.analytics.wizardCapture('Agent Started', {
         integration: config.metadata.integration,
     });
     // Credentials are pre-set by bin.ts (TUI mode) via the AuthScreen SUSI flow.
@@ -256,9 +256,7 @@ async function runAgentWizard(config, session) {
     }, middleware);
     // Handle error cases detected in agent output
     if (agentResult.error === agent_interface_1.AgentErrorType.AUTH_ERROR) {
-        analytics_1.analytics.wizardCapture('agent auth error', {
-            integration: config.metadata.integration,
-        });
+        (0, analytics_1.captureWizardError)('Agent Authentication', 'Session expired or invalid during agent run', 'agent-runner', { integration: config.metadata.integration });
         const authMessage = `Authentication failed\n\nYour Amplitude session has expired. Please run the wizard again to log in.`;
         session.credentials = null;
         session.outroData = {
@@ -297,10 +295,9 @@ async function runAgentWizard(config, session) {
     }
     if (agentResult.error === agent_interface_1.AgentErrorType.RATE_LIMIT ||
         agentResult.error === agent_interface_1.AgentErrorType.API_ERROR) {
-        analytics_1.analytics.wizardCapture('agent api error', {
+        (0, analytics_1.captureWizardError)('Agent API', agentResult.message ?? 'Unknown API error', 'agent-runner', {
             integration: config.metadata.integration,
             error_type: agentResult.error,
-            error_message: agentResult.message,
         });
         await (0, wizard_abort_1.wizardAbort)({
             message: `API Error\n\n${agentResult.message || 'Unknown error'}\n\nPlease report this error to: wizard@amplitude.com`,
@@ -401,6 +398,7 @@ STEP 5: Set up environment variables for Amplitude using the wizard-tools MCP se
    - Reference these environment variables in the code files you create instead of hardcoding the public token and host.
 
 STEP 6: Add event tracking to this project using the instrumentation skills.
+   - Call load_skill_menu with category "taxonomy" and install **amplitude-quickstart-taxonomy-agent** using install_skill. Load its SKILL.md and follow it when **naming events**, choosing **properties**, and scoping a **starter-kit taxonomy** (business-outcome events, property limits, funnel/linkage rules). Keep using this skill alongside instrumentation so names stay analysis-ready.
    - Call load_skill_menu with category "instrumentation" to see available instrumentation skills.
    - Install the "add-analytics-instrumentation" skill using install_skill.
    - Load the installed skill's SKILL.md file to understand the workflow.

package/dist/src/lib/commandments.js

@@ -13,7 +13,7 @@ const WIZARD_COMMANDMENTS = [
     'Always use the detect_package_manager tool from the wizard-tools MCP server to determine the package manager. Do not guess based on lockfiles or hard-code npm, yarn, pnpm, bun, pip, etc.',
     'When installing packages, start the installation as a background task and then continue with other work. Do not block waiting for installs to finish unless explicitly instructed.',
     'Before writing to any file, you MUST read that exact file immediately beforehand using the Read tool, even if you have already read it earlier in the run. This avoids tool failures and stale edits.',
-    'Treat feature flags, custom properties, and event names as part of an analytics contract. Prefer reusing existing names and patterns in the project. When you must introduce new ones, make them clear, descriptive, and consistent with existing conventions, and avoid scattering the same flag or property across many unrelated callsites.',
+    'Treat feature flags, custom properties, and event names as part of an analytics contract. Prefer reusing existing names and patterns in the project. When you must introduce new ones, make them clear, descriptive, and consistent with existing conventions, and avoid scattering the same flag or property across many unrelated callsites. For instrumentation runs, load the bundled **amplitude-quickstart-taxonomy-agent** skill (taxonomy category via wizard-tools) and align new event names and properties with its starter-kit rules (business-outcome naming, small property sets, no redundant pageview events, funnel-friendly linkage).',
     'Prefer minimal, targeted edits that achieve the requested behavior while preserving existing structure and style. Avoid large refactors, broad reformatting, or unrelated changes unless explicitly requested.',
     'Do not spawn subagents unless explicitly instructed to do so.',
     'Use the TodoWrite tool to track your progress. Create a todo list at the start describing the high-level areas of work, mark each as in_progress when you begin it, and completed when done.',

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

@@ -105,11 +105,8 @@ export declare const OUTBOUND_URLS: {
     /** Bug reports and feedback. */
     githubIssues: string;
 };
-/** @deprecated Use OUTBOUND_URLS.githubIssues */
-export declare const ISSUES_URL: string;
 /** Placeholder embedded in generated code when the user skips key entry. */
 export declare const DUMMY_PROJECT_API_KEY = "_YOUR_AMPLITUDE_API_KEY_";
-export declare const WIZARD_REMARK_EVENT_NAME = "wizard remark";
 /** Feature flag key whose value selects a variant from WIZARD_VARIANTS. */
 export declare const WIZARD_VARIANT_FLAG_KEY = "wizard-variant";
 /** Variant key -> metadata for wizard run (VARIANT flag selects which entry to use). */

package/dist/src/lib/constants.js

@@ -3,7 +3,7 @@
  * Shared constants for the Amplitude wizard.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DETECTION_TIMEOUT_MS = exports.AMPLITUDE_FLAG_HEADER_PREFIX = exports.AMPLITUDE_PROPERTY_HEADER_PREFIX = exports.WIZARD_USER_AGENT = exports.WIZARD_VARIANTS = exports.WIZARD_VARIANT_FLAG_KEY = exports.WIZARD_REMARK_EVENT_NAME = exports.DUMMY_PROJECT_API_KEY = exports.ISSUES_URL = exports.OUTBOUND_URLS = exports.DEFAULT_AMPLITUDE_ZONE = exports.AMPLITUDE_ZONE_SETTINGS = exports.OAUTH_PORT = exports.ANALYTICS_TEAM_TAG = exports.ANALYTICS_HOST_URL = exports.ANALYTICS_AMPLITUDE_PUBLIC_PROJECT_WRITE_KEY = exports.DEFAULT_HOST_URL = exports.DEFAULT_URL = exports.DEBUG = exports.IS_DEV = exports.Integration = void 0;
+exports.DETECTION_TIMEOUT_MS = exports.AMPLITUDE_FLAG_HEADER_PREFIX = exports.AMPLITUDE_PROPERTY_HEADER_PREFIX = exports.WIZARD_USER_AGENT = exports.WIZARD_VARIANTS = exports.WIZARD_VARIANT_FLAG_KEY = exports.DUMMY_PROJECT_API_KEY = exports.OUTBOUND_URLS = exports.DEFAULT_AMPLITUDE_ZONE = exports.AMPLITUDE_ZONE_SETTINGS = exports.OAUTH_PORT = exports.ANALYTICS_TEAM_TAG = exports.ANALYTICS_HOST_URL = exports.ANALYTICS_AMPLITUDE_PUBLIC_PROJECT_WRITE_KEY = exports.DEFAULT_HOST_URL = exports.DEFAULT_URL = exports.DEBUG = exports.IS_DEV = exports.Integration = void 0;
 const package_json_1 = require("../../package.json");
 // ── Integration / CLI ───────────────────────────────────────────────
 /**
@@ -145,12 +145,9 @@ exports.OUTBOUND_URLS = {
     /** Bug reports and feedback. */
     githubIssues: 'https://github.com/amplitude/wizard/issues',
 };
-/** @deprecated Use OUTBOUND_URLS.githubIssues */
-exports.ISSUES_URL = exports.OUTBOUND_URLS.githubIssues;
 /** Placeholder embedded in generated code when the user skips key entry. */
 exports.DUMMY_PROJECT_API_KEY = '_YOUR_AMPLITUDE_API_KEY_';
 // ── Wizard run / variants ───────────────────────────────────────────
-exports.WIZARD_REMARK_EVENT_NAME = 'wizard remark';
 /** Feature flag key whose value selects a variant from WIZARD_VARIANTS. */
 exports.WIZARD_VARIANT_FLAG_KEY = 'wizard-variant';
 /** Variant key -> metadata for wizard run (VARIANT flag selects which entry to use). */

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

@@ -185,6 +185,12 @@ export interface WizardSession {
      * runPhase is set to Completed.
      */
     amplitudePreDetected: boolean;
+    /**
+     * While true, McpScreen shows a prompt: skip the agent (default) or run
+     * the setup wizard anyway. Cleared when the user chooses or when resetting
+     * for a forced wizard run.
+     */
+    amplitudePreDetectedChoicePending: boolean;
     /**
      * True once the activation check confirms events are flowing into the project.
      * Set immediately if activationLevel is already 'full', otherwise set after

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

@@ -119,6 +119,7 @@ function buildSession(args) {
         additionalFeatureQueue: [],
         frameworkConfig: null,
         amplitudePreDetected: false,
+        amplitudePreDetectedChoicePending: false,
         dataIngestionConfirmed: false,
         checklistChartComplete: false,
         checklistDashboardComplete: false,

package/dist/src/run.js

@@ -59,7 +59,7 @@ async function runWizard(argv, session) {
     const integration = session.integration ?? (await detectAndResolveIntegration(session));
     session.integration = integration;
     analytics_1.analytics.setTag('integration', integration);
-    analytics_1.analytics.wizardCapture('session started', {
+    analytics_1.analytics.wizardCapture('Session Started', {
         integration,
         ci: session.ci ?? false,
     });

package/dist/src/steps/add-mcp-server-to-clients/index.js

@@ -58,7 +58,7 @@ const addMCPServerToClientsStep = async ({ integration, local = false, ci = fals
     });
     ui.log.success(`Added the MCP server to:
   ${supportedClients.map((c) => `- ${c.name}`).join('\n  ')} `);
-    analytics_1.analytics.wizardCapture('mcp servers added', {
+    analytics_1.analytics.wizardCapture('MCP Servers Added', {
         clients: supportedClients.map((c) => c.name),
         integration,
     });
@@ -68,7 +68,7 @@ exports.addMCPServerToClientsStep = addMCPServerToClientsStep;
 const removeMCPServerFromClientsStep = async ({ integration, local = false, }) => {
     const installedClients = await (0, exports.getInstalledClients)(local);
     if (installedClients.length === 0) {
-        analytics_1.analytics.wizardCapture('mcp no servers to remove', {
+        analytics_1.analytics.wizardCapture('MCP No Servers To Remove', {
             integration,
         });
         return [];
@@ -78,7 +78,7 @@ const removeMCPServerFromClientsStep = async ({ integration, local = false, }) =
         await (0, exports.removeMCPServer)(installedClients, local);
         return installedClients.map((c) => c.name);
     });
-    analytics_1.analytics.wizardCapture('mcp servers removed', {
+    analytics_1.analytics.wizardCapture('MCP Servers Removed', {
         clients: results,
         integration,
     });

package/dist/src/steps/add-or-update-environment-variables.js

@@ -90,10 +90,7 @@ async function addOrUpdateEnvironmentVariablesStep({ installDir, variables, inte
             }
             catch (error) {
                 (0, ui_1.getUI)().log.warn(`Failed to update environment variables in ${chalk_1.default.bold.cyan(relativeEnvFilePath)}. Please update them manually.`);
-                analytics_1.analytics.wizardCapture('env vars error', {
-                    integration,
-                    error: error instanceof Error ? error.message : 'Unknown error',
-                });
+                (0, analytics_1.captureWizardError)('Environment Variables', error instanceof Error ? error.message : 'Unknown error', 'add-or-update-env:update-existing', { integration });
                 return {
                     relativeEnvFilePath,
                     addedEnvVariables,
@@ -112,10 +109,7 @@ async function addOrUpdateEnvironmentVariablesStep({ installDir, variables, inte
             }
             catch (error) {
                 (0, ui_1.getUI)().log.warn(`Failed to create ${chalk_1.default.bold.cyan(relativeEnvFilePath)} with environment variables. Please add them manually.`);
-                analytics_1.analytics.wizardCapture('env vars error', {
-                    integration,
-                    error: error instanceof Error ? error.message : 'Unknown error',
-                });
+                (0, analytics_1.captureWizardError)('Environment Variables', error instanceof Error ? error.message : 'Unknown error', 'add-or-update-env:create-new', { integration });
                 return {
                     relativeEnvFilePath,
                     addedEnvVariables,
@@ -141,10 +135,7 @@ async function addOrUpdateEnvironmentVariablesStep({ installDir, variables, inte
                 }
                 catch (error) {
                     (0, ui_1.getUI)().log.warn(`Failed to update ${chalk_1.default.bold.cyan('.gitignore')} to include ${chalk_1.default.bold.cyan(envFileName)}.`);
-                    analytics_1.analytics.wizardCapture('env vars error', {
-                        integration,
-                        error: error instanceof Error ? error.message : 'Unknown error',
-                    });
+                    (0, analytics_1.captureWizardError)('Environment Variables', error instanceof Error ? error.message : 'Unknown error', 'add-or-update-env:gitignore-update', { integration });
                     return {
                         relativeEnvFilePath,
                         addedEnvVariables,
@@ -165,10 +156,7 @@ async function addOrUpdateEnvironmentVariablesStep({ installDir, variables, inte
             }
             catch (error) {
                 (0, ui_1.getUI)().log.warn(`Failed to create ${chalk_1.default.bold.cyan('.gitignore')} with environment files.`);
-                analytics_1.analytics.wizardCapture('env vars error', {
-                    integration,
-                    error: error instanceof Error ? error.message : 'Unknown error',
-                });
+                (0, analytics_1.captureWizardError)('Environment Variables', error instanceof Error ? error.message : 'Unknown error', 'add-or-update-env:gitignore-create', { integration });
                 return {
                     relativeEnvFilePath,
                     addedEnvVariables,
@@ -176,7 +164,7 @@ async function addOrUpdateEnvironmentVariablesStep({ installDir, variables, inte
                 };
             }
         }
-        analytics_1.analytics.wizardCapture('env vars added', {
+        analytics_1.analytics.wizardCapture('Environment Variables Added', {
             integration,
         });
         return {

package/dist/src/steps/run-prettier.js

@@ -83,7 +83,7 @@ async function runPrettierStep({ installDir, integration, }) {
             return;
         }
         prettierSpinner.stop('Prettier has formatted your files.');
-        analytics_1.analytics.wizardCapture('ran prettier', {
+        analytics_1.analytics.wizardCapture('Prettier Ran', {
             integration,
         });
     });

package/dist/src/steps/upload-environment-variables/index.js

@@ -17,7 +17,7 @@ const uploadEnvironmentVariablesStep = async (envVars, { integration, session, }
         }
     }
     if (!provider) {
-        analytics_1.analytics.wizardCapture('env upload skipped', {
+        analytics_1.analytics.wizardCapture('Env Upload Skipped', {
             reason: 'no environment provider found',
             integration,
         });
@@ -28,7 +28,7 @@ const uploadEnvironmentVariablesStep = async (envVars, { integration, session, }
     const results = await (0, telemetry_1.traceStep)('uploading environment variables', async () => {
         return await provider.uploadEnvVars(envVars);
     });
-    analytics_1.analytics.wizardCapture('env uploaded', {
+    analytics_1.analytics.wizardCapture('Env Uploaded', {
         provider: provider.name,
         integration,
     });

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

@@ -21,8 +21,9 @@ 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, TEST_PROMPT, } from '../console-commands.js';
+import { COMMANDS, getWhoamiText, getHelpText, 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) {
     const [cmd] = raw.trim().split(/\s+/);
     switch (cmd) {
@@ -41,6 +42,19 @@ function executeCommand(raw, store) {
         case '/slack':
             store.showSlackOverlay();
             break;
+        case '/feedback': {
+            const message = parseFeedbackSlashInput(raw);
+            if (!message) {
+                store.setCommandFeedback('Usage: /feedback <your message>');
+                break;
+            }
+            void trackWizardFeedback(message)
+                .then(() => store.setCommandFeedback('Thanks — your feedback was sent.'))
+                .catch((err) => {
+                store.setCommandFeedback(`Could not send feedback: ${err instanceof Error ? err.message : String(err)}`);
+            });
+            break;
+        }
         case '/test':
             return TEST_PROMPT;
         case '/mcp':
@@ -116,7 +130,7 @@ export const ConsoleView = ({ store, width, height, children, }) => {
     }, { isActive: !inputActive });
     const handleSubmit = (value) => {
         const isSlashCommand = value.startsWith('/');
-        analytics.wizardCapture('agent message sent', {
+        analytics.wizardCapture('Agent Message Sent', {
             message_length: value.length,
             is_slash_command: isSlashCommand,
         });

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

@@ -14,3 +14,8 @@ export declare const TEST_PROMPT: string;
 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.
+ */
+export declare function parseFeedbackSlashInput(raw: string): string | undefined;

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

@@ -11,6 +11,10 @@ export const COMMANDS = [
     { cmd: '/whoami', desc: 'Show current user, org, and project' },
     { cmd: '/mcp', desc: 'Install or remove the Amplitude MCP server' },
     { cmd: '/slack', desc: 'Set up Amplitude Slack integration' },
+    {
+        cmd: '/feedback',
+        desc: 'Send product feedback (event: wizard: feedback submitted)',
+    },
     { cmd: '/test', desc: 'Run a prompt-skill demo (confirm + choose)' },
     { cmd: '/snake', desc: 'Play Snake' },
     { cmd: '/exit', desc: 'Exit the wizard' },
@@ -29,3 +33,14 @@ 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.
+ */
+export function parseFeedbackSlashInput(raw) {
+    const m = /^\s*\/feedback(?:\s+(.*))?\s*$/i.exec(raw);
+    if (!m)
+        return undefined;
+    const body = m[1]?.trim();
+    return body || undefined;
+}

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

@@ -16,7 +16,7 @@ import { useState, useEffect, useSyncExternalStore } from 'react';
 import { TextInput } from '@inkjs/ui';
 import { LoadingBox, PickerMenu } from '../primitives/index.js';
 import { Colors } from '../styles.js';
-import { DEFAULT_HOST_URL } from '../../../lib/constants.js';
+import { DEFAULT_HOST_URL, } from '../../../lib/constants.js';
 import { analytics } from '../../../utils/analytics.js';
 export const AuthScreen = ({ store }) => {
     useSyncExternalStore((cb) => store.subscribe(cb), () => store.getSnapshot());
@@ -37,28 +37,85 @@ export const AuthScreen = ({ store }) => {
     }, [effectiveOrg?.id, singleWorkspace?.id, session.selectedWorkspaceId]);
     const workspaceChosen = session.selectedWorkspaceId !== null ||
         (effectiveOrg !== null && effectiveOrg.workspaces.length === 1);
-    // Auto-advance past API key step if a saved key exists for this project
+    // 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.
     useEffect(() => {
         if (!workspaceChosen || session.credentials !== null)
             return;
-        void import('../../../utils/api-key-store.js').then(({ readApiKeyWithSource }) => {
-            const result = readApiKeyWithSource(session.installDir);
-            if (result) {
-                setSavedKeySource(result.source);
-                analytics.wizardCapture('api key submitted', {
-                    key_source: result.source,
+        let cancelled = false;
+        void (async () => {
+            const s = store.session;
+            if (s.credentials !== null)
+                return;
+            const { readApiKeyWithSource, persistApiKey } = await import('../../../utils/api-key-store.js');
+            if (cancelled)
+                return;
+            const local = readApiKeyWithSource(s.installDir);
+            if (local) {
+                setSavedKeySource(local.source);
+                analytics.wizardCapture('API Key Submitted', {
+                    key_source: local.source,
                 });
                 store.setCredentials({
-                    accessToken: session.pendingAuthAccessToken ?? '',
-                    idToken: session.pendingAuthIdToken ?? undefined,
-                    projectApiKey: result.key,
+                    accessToken: s.pendingAuthAccessToken ?? '',
+                    idToken: s.pendingAuthIdToken ?? undefined,
+                    projectApiKey: local.key,
                     host: DEFAULT_HOST_URL,
                     projectId: 0,
                 });
                 store.setProjectHasData(false);
+                store.setApiKeyNotice(null);
+                return;
             }
-        });
-    }, [workspaceChosen, session.credentials]);
+            const idToken = s.pendingAuthIdToken;
+            if (!idToken)
+                return;
+            const zone = (s.region ??
+                s.pendingAuthCloudRegion ??
+                'us');
+            const { getAPIKey } = await import('../../../utils/get-api-key.js');
+            const { getHostFromRegion } = await import('../../../utils/urls.js');
+            const projectApiKey = await getAPIKey({
+                installDir: s.installDir,
+                idToken,
+                zone,
+                workspaceId: s.selectedWorkspaceId ?? undefined,
+            });
+            if (cancelled || store.session.credentials !== null)
+                return;
+            if (projectApiKey) {
+                persistApiKey(projectApiKey, s.installDir);
+                analytics.wizardCapture('API Key Submitted', {
+                    key_source: 'backend_fetch',
+                });
+                store.setCredentials({
+                    accessToken: s.pendingAuthAccessToken ?? '',
+                    idToken: s.pendingAuthIdToken ?? undefined,
+                    projectApiKey,
+                    host: getHostFromRegion(zone),
+                    projectId: 0,
+                });
+                store.setProjectHasData(false);
+                store.setApiKeyNotice(null);
+            }
+            else {
+                store.setApiKeyNotice("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.');
+            }
+        })();
+        return () => {
+            cancelled = true;
+        };
+    }, [
+        workspaceChosen,
+        session.credentials,
+        session.selectedWorkspaceId,
+        session.pendingAuthIdToken,
+        session.region,
+        session.pendingAuthCloudRegion,
+        session.installDir,
+    ]);
     const needsOrgPick = pendingOrgs !== null && pendingOrgs.length > 1 && effectiveOrg === null;
     const needsWorkspacePick = effectiveOrg !== null &&
         effectiveOrg.workspaces.length > 1 &&
@@ -71,9 +128,10 @@ export const AuthScreen = ({ store }) => {
             return;
         }
         setApiKeyError('');
-        analytics.wizardCapture('api key submitted', {
+        analytics.wizardCapture('API Key Submitted', {
             key_source: 'manual_entry',
         });
+        store.setApiKeyNotice(null);
         store.setCredentials({
             accessToken: session.pendingAuthAccessToken ?? '',
             idToken: session.pendingAuthIdToken ?? undefined,

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

@@ -56,7 +56,7 @@ export const ChecklistScreen = ({ store }) => {
     const dashboardUrl = OUTBOUND_URLS.newDashboard(zone, selectedOrgId);
     function openInBrowser(url, item) {
         setOpening(item);
-        analytics.wizardCapture('checklist item opened', { item });
+        analytics.wizardCapture('Checklist Step Opened', { item });
         opn(url, { wait: false })
             .catch(() => {
             /* fire-and-forget */