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

package/dist/src/utils/shell-completions.d.ts

@@ -1,7 +1,7 @@
 type SupportedShell = 'zsh' | 'bash';
 export declare function detectShell(): SupportedShell | null;
-export declare const ZSH_COMPLETION_SCRIPT = "###-begin-amplitude-wizard-completions-###\n\n_amplitude_wizard() {\n  local state\n  local -a commands global_opts wizard_opts\n\n  commands=(\n    'login:Log in to your Amplitude account'\n    'logout:Log out of your Amplitude account'\n    'whoami:Show the currently logged-in Amplitude account'\n    'slack:Set up Amplitude Slack integration'\n    'mcp:MCP server management commands'\n    'completion:Print shell completion script'\n  )\n\n  global_opts=(\n    '--debug[Enable verbose logging]'\n    '--verbose[Print diagnostic info to the run log]'\n    '--signup[Create a new Amplitude account during setup]'\n    '--ci[Enable non-interactive CI mode]'\n    '--api-key[Amplitude project API key]:key:'\n    '--project-id[Amplitude project ID]:id:'\n    '--local-mcp[Use local MCP server at http://localhost:8787/mcp]'\n    {-h,--help}'[Show help]'\n    {-v,--version}'[Show version]'\n  )\n\n  wizard_opts=(\n    '--force-install[Force package install even if peer checks fail]'\n    '--install-dir[Directory to install Amplitude in]:dir:_files -/'\n    '--integration[Framework integration to set up]:integration:(nextjs vue react-router django flask fastapi javascript_web javascript_node python)'\n    '--menu[Show integration selection menu instead of auto-detecting]'\n    '--benchmark[Run in benchmark mode with per-phase token tracking]'\n  )\n\n  _arguments -C \\\n    '1: :->cmd' \\\n    '*:: :->args'\n\n  case $state in\n    cmd)\n      _describe 'command' commands\n      _arguments $global_opts $wizard_opts\n      ;;\n    args)\n      case ${words[1]} in\n        mcp)\n          local -a mcp_cmds\n          mcp_cmds=('add:Install Amplitude MCP server' 'remove:Remove Amplitude MCP server')\n          _arguments -C '1: :->sub' '*:: :->subargs'\n          case $state in\n            sub) _describe 'mcp command' mcp_cmds ;;\n            subargs) _arguments '--local[Use local MCP server at http://localhost:8787]' ;;\n          esac\n          ;;\n        login)\n          _arguments '--zone[Amplitude data center zone]:zone:(us eu)'\n          ;;\n        *)\n          _arguments $global_opts $wizard_opts\n          ;;\n      esac\n      ;;\n  esac\n}\n\n(( $+functions[compdef] )) || { autoload -Uz compinit; compinit; }\ncompdef _amplitude_wizard amplitude-wizard\n###-end-amplitude-wizard-completions-###";
-export declare const BASH_COMPLETION_SCRIPT = "###-begin-amplitude-wizard-completions-###\n_amplitude_wizard_completions() {\n  local cur prev\n  cur=\"${COMP_WORDS[COMP_CWORD]}\"\n  prev=\"${COMP_WORDS[COMP_CWORD-1]}\"\n\n  local commands=\"login logout whoami slack mcp completion\"\n  local global_flags=\"--debug --verbose --signup --ci --api-key --project-id --local-mcp --help --version\"\n  local wizard_flags=\"--force-install --install-dir --integration --menu --benchmark\"\n  local integrations=\"nextjs vue react-router django flask fastapi javascript_web javascript_node python\"\n\n  if [[ ${COMP_CWORD} -eq 1 ]]; then\n    COMPREPLY=($(compgen -W \"$commands $global_flags $wizard_flags\" -- \"$cur\"))\n    return\n  fi\n\n  case \"${COMP_WORDS[1]}\" in\n    mcp)\n      if [[ ${COMP_CWORD} -eq 2 ]]; then\n        COMPREPLY=($(compgen -W \"add remove\" -- \"$cur\"))\n      else\n        COMPREPLY=($(compgen -W \"--local\" -- \"$cur\"))\n      fi\n      ;;\n    login)\n      if [[ \"$prev\" == \"--zone\" ]]; then\n        COMPREPLY=($(compgen -W \"us eu\" -- \"$cur\"))\n      else\n        COMPREPLY=($(compgen -W \"--zone\" -- \"$cur\"))\n      fi\n      ;;\n    *)\n      if [[ \"$prev\" == \"--integration\" ]]; then\n        COMPREPLY=($(compgen -W \"$integrations\" -- \"$cur\"))\n      elif [[ \"$prev\" == \"--install-dir\" ]]; then\n        COMPREPLY=($(compgen -d -- \"$cur\"))\n      else\n        COMPREPLY=($(compgen -W \"$global_flags $wizard_flags\" -- \"$cur\"))\n      fi\n      ;;\n  esac\n}\ncomplete -F _amplitude_wizard_completions amplitude-wizard\n###-end-amplitude-wizard-completions-###";
+export declare const ZSH_COMPLETION_SCRIPT = "###-begin-amplitude-wizard-completions-###\n\n_amplitude_wizard() {\n  local state\n  local -a commands global_opts wizard_opts\n\n  commands=(\n    'login:Log in to your Amplitude account'\n    'logout:Log out of your Amplitude account'\n    'whoami:Show the currently logged-in Amplitude account'\n    'feedback:Send product feedback'\n    'slack:Set up Amplitude Slack integration'\n    'mcp:MCP server management commands'\n    'completion:Print shell completion script'\n  )\n\n  global_opts=(\n    '--debug[Enable verbose logging]'\n    '--verbose[Print diagnostic info to the run log]'\n    '--signup[Create a new Amplitude account during setup]'\n    '--ci[Enable non-interactive CI mode]'\n    '--api-key[Amplitude project API key]:key:'\n    '--project-id[Amplitude project ID]:id:'\n    '--local-mcp[Use local MCP server at http://localhost:8787/mcp]'\n    {-h,--help}'[Show help]'\n    {-v,--version}'[Show version]'\n  )\n\n  wizard_opts=(\n    '--force-install[Force package install even if peer checks fail]'\n    '--install-dir[Directory to install Amplitude in]:dir:_files -/'\n    '--integration[Framework integration to set up]:integration:(nextjs vue react-router django flask fastapi javascript_web javascript_node python)'\n    '--menu[Show integration selection menu instead of auto-detecting]'\n    '--benchmark[Run in benchmark mode with per-phase token tracking]'\n  )\n\n  _arguments -C \\\n    '1: :->cmd' \\\n    '*:: :->args'\n\n  case $state in\n    cmd)\n      _describe 'command' commands\n      _arguments $global_opts $wizard_opts\n      ;;\n    args)\n      case ${words[1]} in\n        mcp)\n          local -a mcp_cmds\n          mcp_cmds=('add:Install Amplitude MCP server' 'remove:Remove Amplitude MCP server')\n          _arguments -C '1: :->sub' '*:: :->subargs'\n          case $state in\n            sub) _describe 'mcp command' mcp_cmds ;;\n            subargs) _arguments '--local[Use local MCP server at http://localhost:8787]' ;;\n          esac\n          ;;\n        login)\n          _arguments '--zone[Amplitude data center zone]:zone:(us eu)'\n          ;;\n        feedback)\n          _arguments '--message[Feedback message]:message:' '-m[Feedback message]:message:'\n          ;;\n        *)\n          _arguments $global_opts $wizard_opts\n          ;;\n      esac\n      ;;\n  esac\n}\n\n(( $+functions[compdef] )) || { autoload -Uz compinit; compinit; }\ncompdef _amplitude_wizard amplitude-wizard\n###-end-amplitude-wizard-completions-###";
+export declare const BASH_COMPLETION_SCRIPT = "###-begin-amplitude-wizard-completions-###\n_amplitude_wizard_completions() {\n  local cur prev\n  cur=\"${COMP_WORDS[COMP_CWORD]}\"\n  prev=\"${COMP_WORDS[COMP_CWORD-1]}\"\n\n  local commands=\"login logout whoami feedback slack mcp completion\"\n  local global_flags=\"--debug --verbose --signup --ci --api-key --project-id --local-mcp --help --version\"\n  local wizard_flags=\"--force-install --install-dir --integration --menu --benchmark\"\n  local integrations=\"nextjs vue react-router django flask fastapi javascript_web javascript_node python\"\n\n  if [[ ${COMP_CWORD} -eq 1 ]]; then\n    COMPREPLY=($(compgen -W \"$commands $global_flags $wizard_flags\" -- \"$cur\"))\n    return\n  fi\n\n  case \"${COMP_WORDS[1]}\" in\n    mcp)\n      if [[ ${COMP_CWORD} -eq 2 ]]; then\n        COMPREPLY=($(compgen -W \"add remove\" -- \"$cur\"))\n      else\n        COMPREPLY=($(compgen -W \"--local\" -- \"$cur\"))\n      fi\n      ;;\n    login)\n      if [[ \"$prev\" == \"--zone\" ]]; then\n        COMPREPLY=($(compgen -W \"us eu\" -- \"$cur\"))\n      else\n        COMPREPLY=($(compgen -W \"--zone\" -- \"$cur\"))\n      fi\n      ;;\n    feedback)\n      COMPREPLY=($(compgen -W \"--message -m\" -- \"$cur\"))\n      ;;\n    *)\n      if [[ \"$prev\" == \"--integration\" ]]; then\n        COMPREPLY=($(compgen -W \"$integrations\" -- \"$cur\"))\n      elif [[ \"$prev\" == \"--install-dir\" ]]; then\n        COMPREPLY=($(compgen -d -- \"$cur\"))\n      else\n        COMPREPLY=($(compgen -W \"$global_flags $wizard_flags\" -- \"$cur\"))\n      fi\n      ;;\n  esac\n}\ncomplete -F _amplitude_wizard_completions amplitude-wizard\n###-end-amplitude-wizard-completions-###";
 /**
  * Silently appends `eval "$(amplitude-wizard completion)"` to the user's shell
  * RC file if it isn't already there.  Call fire-and-forget at startup.

package/dist/src/utils/shell-completions.js

@@ -72,6 +72,7 @@ _amplitude_wizard() {
     'login:Log in to your Amplitude account'
     'logout:Log out of your Amplitude account'
     'whoami:Show the currently logged-in Amplitude account'
+    'feedback:Send product feedback'
     'slack:Set up Amplitude Slack integration'
     'mcp:MCP server management commands'
     'completion:Print shell completion script'
@@ -120,6 +121,9 @@ _amplitude_wizard() {
         login)
           _arguments '--zone[Amplitude data center zone]:zone:(us eu)'
           ;;
+        feedback)
+          _arguments '--message[Feedback message]:message:' '-m[Feedback message]:message:'
+          ;;
         *)
           _arguments $global_opts $wizard_opts
           ;;
@@ -137,7 +141,7 @@ _amplitude_wizard_completions() {
   cur="${DB}COMP_WORDS[COMP_CWORD]}"
   prev="${DB}COMP_WORDS[COMP_CWORD-1]}"
 
-  local commands="login logout whoami slack mcp completion"
+  local commands="login logout whoami feedback slack mcp completion"
   local global_flags="--debug --verbose --signup --ci --api-key --project-id --local-mcp --help --version"
   local wizard_flags="--force-install --install-dir --integration --menu --benchmark"
   local integrations="nextjs vue react-router django flask fastapi javascript_web javascript_node python"
@@ -162,6 +166,9 @@ _amplitude_wizard_completions() {
         COMPREPLY=($(compgen -W "--zone" -- "$cur"))
       fi
       ;;
+    feedback)
+      COMPREPLY=($(compgen -W "--message -m" -- "$cur"))
+      ;;
     *)
       if [[ "$prev" == "--integration" ]]; then
         COMPREPLY=($(compgen -W "$integrations" -- "$cur"))

package/dist/src/utils/track-wizard-feedback.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Send a single feedback event to Amplitude via the Node SDK.
+ * Uses the same API key and server URL as other wizard telemetry.
+ */
+export declare function trackWizardFeedback(message: string): Promise<void>;

package/dist/src/utils/track-wizard-feedback.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.trackWizardFeedback = trackWizardFeedback;
+const analytics_node_1 = require("@amplitude/analytics-node");
+const uuid_1 = require("uuid");
+const analytics_js_1 = require("./analytics.js");
+/**
+ * Send a single feedback event to Amplitude via the Node SDK.
+ * Uses the same API key and server URL as other wizard telemetry.
+ */
+async function trackWizardFeedback(message) {
+    const trimmed = message.trim();
+    if (!trimmed) {
+        throw new Error('Feedback message cannot be empty');
+    }
+    const apiKey = (0, analytics_js_1.resolveTelemetryApiKey)();
+    if (!apiKey) {
+        throw new Error('Feedback cannot be sent: set AMPLITUDE_API_KEY or unset it to use the default telemetry project.');
+    }
+    const client = (0, analytics_node_1.createInstance)();
+    await client.init(apiKey, { serverUrl: (0, analytics_js_1.getAmplitudeNodeServerUrl)() }).promise;
+    const deviceId = (0, uuid_1.v4)();
+    client.track(analytics_js_1.WIZARD_FEEDBACK_EVENT_TYPE, { message: trimmed }, { device_id: deviceId });
+    await client.flush().promise;
+}

package/package.json

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