@posthog/wizard 1.31.1 → 1.32.0

package/dist/src/react-native/utils.js

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReactNativeVariant = exports.getReactNativeVersionBucket = void 0;
+exports.getReactNativeVariantName = getReactNativeVariantName;
+exports.detectReactNativeVariant = detectReactNativeVariant;
+const semver_1 = require("../utils/semver");
+const clack_utils_1 = require("../utils/clack-utils");
+const package_json_1 = require("../utils/package-json");
+const clack_1 = __importDefault(require("../utils/clack"));
+exports.getReactNativeVersionBucket = (0, semver_1.createVersionBucket)();
+var ReactNativeVariant;
+(function (ReactNativeVariant) {
+    ReactNativeVariant["EXPO"] = "expo";
+    ReactNativeVariant["REACT_NATIVE"] = "react-native";
+})(ReactNativeVariant || (exports.ReactNativeVariant = ReactNativeVariant = {}));
+function getReactNativeVariantName(variant) {
+    return variant === ReactNativeVariant.EXPO ? 'Expo' : 'React Native';
+}
+async function detectReactNativeVariant(options) {
+    const packageJson = await (0, clack_utils_1.tryGetPackageJson)(options);
+    if (packageJson && (0, package_json_1.hasPackageInstalled)('expo', packageJson)) {
+        clack_1.default.log.info(`Detected ${getReactNativeVariantName(ReactNativeVariant.EXPO)} 📱`);
+        return ReactNativeVariant.EXPO;
+    }
+    clack_1.default.log.info(`Detected ${getReactNativeVariantName(ReactNativeVariant.REACT_NATIVE)} 📱`);
+    return ReactNativeVariant.REACT_NATIVE;
+}
+//# sourceMappingURL=utils.js.map

package/dist/src/react-native/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/react-native/utils.ts"],"names":[],"mappings":";;;;;;AAaA,8DAEC;AAED,4DAgBC;AAjCD,4CAAsD;AACtD,sDAAyD;AACzD,wDAA4D;AAC5D,2DAAmC;AAGtB,QAAA,2BAA2B,GAAG,IAAA,4BAAmB,GAAE,CAAC;AAEjE,IAAY,kBAGX;AAHD,WAAY,kBAAkB;IAC5B,mCAAa,CAAA;IACb,mDAA6B,CAAA;AAC/B,CAAC,EAHW,kBAAkB,kCAAlB,kBAAkB,QAG7B;AAED,SAAgB,yBAAyB,CAAC,OAA2B;IACnE,OAAO,OAAO,KAAK,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC;AACvE,CAAC;AAEM,KAAK,UAAU,wBAAwB,CAC5C,OAA0C;IAE1C,MAAM,WAAW,GAAG,MAAM,IAAA,+BAAiB,EAAC,OAAO,CAAC,CAAC;IAErD,IAAI,WAAW,IAAI,IAAA,kCAAmB,EAAC,MAAM,EAAE,WAAW,CAAC,EAAE,CAAC;QAC5D,eAAK,CAAC,GAAG,CAAC,IAAI,CACZ,YAAY,yBAAyB,CAAC,kBAAkB,CAAC,IAAI,CAAC,KAAK,CACpE,CAAC;QACF,OAAO,kBAAkB,CAAC,IAAI,CAAC;IACjC,CAAC;IAED,eAAK,CAAC,GAAG,CAAC,IAAI,CACZ,YAAY,yBAAyB,CAAC,kBAAkB,CAAC,YAAY,CAAC,KAAK,CAC5E,CAAC;IACF,OAAO,kBAAkB,CAAC,YAAY,CAAC;AACzC,CAAC","sourcesContent":["import { createVersionBucket } from '../utils/semver';\nimport { tryGetPackageJson } from '../utils/clack-utils';\nimport { hasPackageInstalled } from '../utils/package-json';\nimport clack from '../utils/clack';\nimport type { WizardOptions } from '../utils/types';\n\nexport const getReactNativeVersionBucket = createVersionBucket();\n\nexport enum ReactNativeVariant {\n  EXPO = 'expo',\n  REACT_NATIVE = 'react-native',\n}\n\nexport function getReactNativeVariantName(variant: ReactNativeVariant): string {\n  return variant === ReactNativeVariant.EXPO ? 'Expo' : 'React Native';\n}\n\nexport async function detectReactNativeVariant(\n  options: Pick<WizardOptions, 'installDir'>,\n): Promise<ReactNativeVariant> {\n  const packageJson = await tryGetPackageJson(options);\n\n  if (packageJson && hasPackageInstalled('expo', packageJson)) {\n    clack.log.info(\n      `Detected ${getReactNativeVariantName(ReactNativeVariant.EXPO)} 📱`,\n    );\n    return ReactNativeVariant.EXPO;\n  }\n\n  clack.log.info(\n    `Detected ${getReactNativeVariantName(ReactNativeVariant.REACT_NATIVE)} 📱`,\n  );\n  return ReactNativeVariant.REACT_NATIVE;\n}\n"]}

package/dist/src/react-router/react-router-wizard-agent.d.ts

@@ -1,5 +1,7 @@
-import type { WizardOptions } from '../utils/types';
-/**
- * React Router wizard powered by the universal agent runner.
- */
-export declare function runReactRouterWizardAgent(options: WizardOptions): Promise<void>;
+import type { FrameworkConfig } from '../lib/framework-config';
+import { ReactRouterMode } from './utils';
+type ReactRouterContext = {
+    routerMode?: ReactRouterMode;
+};
+export declare const REACT_ROUTER_AGENT_CONFIG: FrameworkConfig<ReactRouterContext>;
+export {};

package/dist/src/react-router/react-router-wizard-agent.js

@@ -1,56 +1,11 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.runReactRouterWizardAgent = runReactRouterWizardAgent;
-const debug_1 = require("../utils/debug");
-const agent_runner_1 = require("../lib/agent-runner");
+exports.REACT_ROUTER_AGENT_CONFIG = void 0;
 const constants_1 = require("../lib/constants");
 const package_json_1 = require("../utils/package-json");
 const clack_utils_1 = require("../utils/clack-utils");
-const clack_1 = __importDefault(require("../utils/clack"));
-const chalk_1 = __importDefault(require("chalk"));
-const semver = __importStar(require("semver"));
 const utils_1 = require("./utils");
-/**
- * React Router framework configuration for the universal agent runner.
- */
-const MINIMUM_REACT_ROUTER_VERSION = '6.0.0';
-const REACT_ROUTER_AGENT_CONFIG = {
+exports.REACT_ROUTER_AGENT_CONFIG = {
     metadata: {
         name: 'React Router',
         integration: constants_1.Integration.reactRouter,
@@ -66,6 +21,17 @@ const REACT_ROUTER_AGENT_CONFIG = {
         packageDisplayName: 'React Router',
         getVersion: (packageJson) => (0, package_json_1.getPackageVersion)('react-router', packageJson),
         getVersionBucket: utils_1.getReactRouterVersionBucket,
+        minimumVersion: '6.0.0',
+        getInstalledVersion: async (options) => {
+            const packageJson = await (0, clack_utils_1.getPackageDotJson)(options);
+            return (0, package_json_1.getPackageVersion)('react-router', packageJson);
+        },
+        detect: async (options) => {
+            const packageJson = await (0, clack_utils_1.tryGetPackageJson)(options);
+            return packageJson
+                ? (0, package_json_1.hasPackageInstalled)('react-router', packageJson)
+                : false;
+        },
     },
     environment: {
         uploadToHosting: false,
@@ -75,12 +41,9 @@ const REACT_ROUTER_AGENT_CONFIG = {
         }),
     },
     analytics: {
-        getTags: (context) => {
-            const routerMode = context.routerMode;
-            return {
-                routerMode: routerMode || 'unknown',
-            };
-        },
+        getTags: (context) => ({
+            routerMode: context.routerMode || 'unknown',
+        }),
     },
     prompts: {
         projectTypeDetection: 'This is a JavaScript/TypeScript project. Look for package.json and lockfiles (package-lock.json, yarn.lock, pnpm-lock.yaml, bun.lockb) to confirm.',
@@ -110,9 +73,8 @@ const REACT_ROUTER_AGENT_CONFIG = {
         successMessage: 'PostHog integration complete',
         estimatedDurationMinutes: 8,
         getOutroChanges: (context) => {
-            const routerMode = context.routerMode;
-            const modeName = routerMode
-                ? (0, utils_1.getReactRouterModeName)(routerMode)
+            const modeName = context.routerMode
+                ? (0, utils_1.getReactRouterModeName)(context.routerMode)
                 : 'React Router';
             return [
                 `Analyzed your React Router project structure (${modeName})`,
@@ -126,28 +88,4 @@ const REACT_ROUTER_AGENT_CONFIG = {
         ],
     },
 };
-/**
- * React Router wizard powered by the universal agent runner.
- */
-async function runReactRouterWizardAgent(options) {
-    if (options.debug) {
-        (0, debug_1.enableDebugLogs)();
-    }
-    // Check React Router version - agent wizard requires >= 6.0.0
-    const packageJson = await (0, clack_utils_1.getPackageDotJson)(options);
-    const reactRouterVersion = (0, package_json_1.getPackageVersion)('react-router', packageJson);
-    if (reactRouterVersion) {
-        const coercedVersion = semver.coerce(reactRouterVersion);
-        if (coercedVersion &&
-            semver.lt(coercedVersion, MINIMUM_REACT_ROUTER_VERSION)) {
-            const docsUrl = REACT_ROUTER_AGENT_CONFIG.metadata.unsupportedVersionDocsUrl ??
-                REACT_ROUTER_AGENT_CONFIG.metadata.docsUrl;
-            clack_1.default.log.warn(`Sorry: the wizard can't help you with React Router ${reactRouterVersion}. Upgrade to React Router ${MINIMUM_REACT_ROUTER_VERSION} or later, or check out the manual setup guide.`);
-            clack_1.default.log.info(`Setup React Router manually: ${chalk_1.default.cyan(docsUrl)}`);
-            clack_1.default.outro('PostHog wizard will see you next time!');
-            return;
-        }
-    }
-    await (0, agent_runner_1.runAgentWizard)(REACT_ROUTER_AGENT_CONFIG, options);
-}
 //# sourceMappingURL=react-router-wizard-agent.js.map

package/dist/src/react-router/react-router-wizard-agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"react-router-wizard-agent.js","sourceRoot":"","sources":["../../../src/react-router/react-router-wizard-agent.ts"],"names":[],"mappings":"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","sourcesContent":["/* React Router wizard using posthog-agent with PostHog MCP */\nimport type { WizardOptions } from '../utils/types';\nimport type { FrameworkConfig } from '../lib/framework-config';\nimport { enableDebugLogs } from '../utils/debug';\nimport { runAgentWizard } from '../lib/agent-runner';\nimport { Integration } from '../lib/constants';\nimport { getPackageVersion } from '../utils/package-json';\nimport { getPackageDotJson } from '../utils/clack-utils';\nimport clack from '../utils/clack';\nimport chalk from 'chalk';\nimport * as semver from 'semver';\nimport {\n  getReactRouterMode,\n  getReactRouterModeName,\n  getReactRouterVersionBucket,\n  ReactRouterMode,\n} from './utils';\n\n/**\n * React Router framework configuration for the universal agent runner.\n */\nconst MINIMUM_REACT_ROUTER_VERSION = '6.0.0';\n\nconst REACT_ROUTER_AGENT_CONFIG: FrameworkConfig = {\n  metadata: {\n    name: 'React Router',\n    integration: Integration.reactRouter,\n    docsUrl: 'https://posthog.com/docs/libraries/react',\n    unsupportedVersionDocsUrl: 'https://posthog.com/docs/libraries/react',\n    gatherContext: async (options: WizardOptions) => {\n      const routerMode = await getReactRouterMode(options);\n      return { routerMode };\n    },\n  },\n\n  detection: {\n    packageName: 'react-router',\n    packageDisplayName: 'React Router',\n    getVersion: (packageJson: any) =>\n      getPackageVersion('react-router', packageJson),\n    getVersionBucket: getReactRouterVersionBucket,\n  },\n\n  environment: {\n    uploadToHosting: false,\n    getEnvVars: (apiKey: string, host: string) => ({\n      REACT_APP_POSTHOG_KEY: apiKey,\n      REACT_APP_POSTHOG_HOST: host,\n    }),\n  },\n\n  analytics: {\n    getTags: (context: any) => {\n      const routerMode = context.routerMode as ReactRouterMode;\n      return {\n        routerMode: routerMode || 'unknown',\n      };\n    },\n  },\n\n  prompts: {\n    projectTypeDetection:\n      'This is a JavaScript/TypeScript project. Look for package.json and lockfiles (package-lock.json, yarn.lock, pnpm-lock.yaml, bun.lockb) to confirm.',\n    packageInstallation:\n      'Look for lockfiles to determine the package manager (npm, yarn, pnpm, bun). Do not manually edit package.json.',\n    getAdditionalContextLines: (context: any) => {\n      const routerMode = context.routerMode as ReactRouterMode;\n      const modeName = routerMode\n        ? getReactRouterModeName(routerMode)\n        : 'unknown';\n\n      // Map router mode to framework ID for MCP docs resource\n      const frameworkIdMap: Record<ReactRouterMode, string> = {\n        [ReactRouterMode.V6]: 'react-react-router-6',\n        [ReactRouterMode.V7_FRAMEWORK]: 'react-react-router-7-framework',\n        [ReactRouterMode.V7_DATA]: 'react-react-router-7-data',\n        [ReactRouterMode.V7_DECLARATIVE]: 'react-react-router-7-declarative',\n      };\n\n      const frameworkId = routerMode\n        ? frameworkIdMap[routerMode]\n        : ReactRouterMode.V7_FRAMEWORK;\n\n      return [\n        `Router mode: ${modeName}`,\n        `Framework docs ID: ${frameworkId} (use posthog://docs/frameworks/${frameworkId} for documentation)`,\n      ];\n    },\n  },\n\n  ui: {\n    successMessage: 'PostHog integration complete',\n    estimatedDurationMinutes: 8,\n    getOutroChanges: (context: any) => {\n      const routerMode = context.routerMode as ReactRouterMode;\n      const modeName = routerMode\n        ? getReactRouterModeName(routerMode)\n        : 'React Router';\n      return [\n        `Analyzed your React Router project structure (${modeName})`,\n        `Created and configured PostHog initializers`,\n        `Integrated PostHog into your application`,\n      ];\n    },\n    getOutroNextSteps: () => [\n      'Start your development server to see PostHog in action',\n      'Visit your PostHog dashboard to see incoming events',\n    ],\n  },\n};\n\n/**\n * React Router wizard powered by the universal agent runner.\n */\nexport async function runReactRouterWizardAgent(\n  options: WizardOptions,\n): Promise<void> {\n  if (options.debug) {\n    enableDebugLogs();\n  }\n\n  // Check React Router version - agent wizard requires >= 6.0.0\n  const packageJson = await getPackageDotJson(options);\n  const reactRouterVersion = getPackageVersion('react-router', packageJson);\n\n  if (reactRouterVersion) {\n    const coercedVersion = semver.coerce(reactRouterVersion);\n    if (\n      coercedVersion &&\n      semver.lt(coercedVersion, MINIMUM_REACT_ROUTER_VERSION)\n    ) {\n      const docsUrl =\n        REACT_ROUTER_AGENT_CONFIG.metadata.unsupportedVersionDocsUrl ??\n        REACT_ROUTER_AGENT_CONFIG.metadata.docsUrl;\n\n      clack.log.warn(\n        `Sorry: the wizard can't help you with React Router ${reactRouterVersion}. Upgrade to React Router ${MINIMUM_REACT_ROUTER_VERSION} or later, or check out the manual setup guide.`,\n      );\n      clack.log.info(`Setup React Router manually: ${chalk.cyan(docsUrl)}`);\n      clack.outro('PostHog wizard will see you next time!');\n      return;\n    }\n  }\n\n  await runAgentWizard(REACT_ROUTER_AGENT_CONFIG, options);\n}\n"]}
+{"version":3,"file":"react-router-wizard-agent.js","sourceRoot":"","sources":["../../../src/react-router/react-router-wizard-agent.ts"],"names":[],"mappings":"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","sourcesContent":["/* React Router wizard using posthog-agent with PostHog MCP */\nimport type { WizardOptions } from '../utils/types';\nimport type { FrameworkConfig } from '../lib/framework-config';\nimport { Integration } from '../lib/constants';\nimport {\n  getPackageVersion,\n  hasPackageInstalled,\n  type PackageDotJson,\n} from '../utils/package-json';\nimport { getPackageDotJson, tryGetPackageJson } from '../utils/clack-utils';\nimport {\n  getReactRouterMode,\n  getReactRouterModeName,\n  getReactRouterVersionBucket,\n  ReactRouterMode,\n} from './utils';\n\ntype ReactRouterContext = {\n  routerMode?: ReactRouterMode;\n};\n\nexport const REACT_ROUTER_AGENT_CONFIG: FrameworkConfig<ReactRouterContext> = {\n  metadata: {\n    name: 'React Router',\n    integration: Integration.reactRouter,\n    docsUrl: 'https://posthog.com/docs/libraries/react',\n    unsupportedVersionDocsUrl: 'https://posthog.com/docs/libraries/react',\n    gatherContext: async (options: WizardOptions) => {\n      const routerMode = await getReactRouterMode(options);\n      return { routerMode };\n    },\n  },\n\n  detection: {\n    packageName: 'react-router',\n    packageDisplayName: 'React Router',\n    getVersion: (packageJson: unknown) =>\n      getPackageVersion('react-router', packageJson as PackageDotJson),\n    getVersionBucket: getReactRouterVersionBucket,\n    minimumVersion: '6.0.0',\n    getInstalledVersion: async (options: WizardOptions) => {\n      const packageJson = await getPackageDotJson(options);\n      return getPackageVersion('react-router', packageJson);\n    },\n    detect: async (options) => {\n      const packageJson = await tryGetPackageJson(options);\n      return packageJson\n        ? hasPackageInstalled('react-router', packageJson)\n        : false;\n    },\n  },\n\n  environment: {\n    uploadToHosting: false,\n    getEnvVars: (apiKey: string, host: string) => ({\n      REACT_APP_POSTHOG_KEY: apiKey,\n      REACT_APP_POSTHOG_HOST: host,\n    }),\n  },\n\n  analytics: {\n    getTags: (context) => ({\n      routerMode: context.routerMode || 'unknown',\n    }),\n  },\n\n  prompts: {\n    projectTypeDetection:\n      'This is a JavaScript/TypeScript project. Look for package.json and lockfiles (package-lock.json, yarn.lock, pnpm-lock.yaml, bun.lockb) to confirm.',\n    packageInstallation:\n      'Look for lockfiles to determine the package manager (npm, yarn, pnpm, bun). Do not manually edit package.json.',\n    getAdditionalContextLines: (context) => {\n      const routerMode = context.routerMode;\n      const modeName = routerMode\n        ? getReactRouterModeName(routerMode)\n        : 'unknown';\n\n      // Map router mode to framework ID for MCP docs resource\n      const frameworkIdMap: Record<ReactRouterMode, string> = {\n        [ReactRouterMode.V6]: 'react-react-router-6',\n        [ReactRouterMode.V7_FRAMEWORK]: 'react-react-router-7-framework',\n        [ReactRouterMode.V7_DATA]: 'react-react-router-7-data',\n        [ReactRouterMode.V7_DECLARATIVE]: 'react-react-router-7-declarative',\n      };\n\n      const frameworkId = routerMode\n        ? frameworkIdMap[routerMode]\n        : ReactRouterMode.V7_FRAMEWORK;\n\n      return [\n        `Router mode: ${modeName}`,\n        `Framework docs ID: ${frameworkId} (use posthog://docs/frameworks/${frameworkId} for documentation)`,\n      ];\n    },\n  },\n\n  ui: {\n    successMessage: 'PostHog integration complete',\n    estimatedDurationMinutes: 8,\n    getOutroChanges: (context) => {\n      const modeName = context.routerMode\n        ? getReactRouterModeName(context.routerMode)\n        : 'React Router';\n      return [\n        `Analyzed your React Router project structure (${modeName})`,\n        `Created and configured PostHog initializers`,\n        `Integrated PostHog into your application`,\n      ];\n    },\n    getOutroNextSteps: () => [\n      'Start your development server to see PostHog in action',\n      'Visit your PostHog dashboard to see incoming events',\n    ],\n  },\n};\n"]}

package/dist/src/react-router/utils.d.ts

@@ -8,7 +8,7 @@ export declare enum ReactRouterMode {
 /**
  * Get React Router version bucket for analytics
  */
-export declare function getReactRouterVersionBucket(version: string | undefined): string;
+export declare const getReactRouterVersionBucket: (version: string | undefined) => string;
 /**
  * Detect React Router mode
  */

package/dist/src/react-router/utils.js

@@ -36,8 +36,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ReactRouterMode = void 0;
-exports.getReactRouterVersionBucket = getReactRouterVersionBucket;
+exports.getReactRouterVersionBucket = exports.ReactRouterMode = void 0;
 exports.getReactRouterMode = getReactRouterMode;
 exports.getReactRouterModeName = getReactRouterModeName;
 const semver_1 = require("semver");
@@ -46,6 +45,7 @@ const clack_utils_1 = require("../utils/clack-utils");
 const clack_1 = __importDefault(require("../utils/clack"));
 const constants_1 = require("../lib/constants");
 const package_json_1 = require("../utils/package-json");
+const semver_2 = require("../utils/semver");
 const chalk_1 = __importDefault(require("chalk"));
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
@@ -67,25 +67,7 @@ const IGNORE_PATTERNS = [
 /**
  * Get React Router version bucket for analytics
  */
-function getReactRouterVersionBucket(version) {
-    if (!version) {
-        return 'none';
-    }
-    try {
-        const minVer = (0, semver_1.minVersion)(version);
-        if (!minVer) {
-            return 'invalid';
-        }
-        const majorVersion = (0, semver_1.major)(minVer);
-        if (majorVersion >= 6) {
-            return `${majorVersion}.x`;
-        }
-        return `<6.0.0`;
-    }
-    catch {
-        return 'unknown';
-    }
-}
+exports.getReactRouterVersionBucket = (0, semver_2.createVersionBucket)();
 /**
  * Check if react-router.config.ts exists (indicates framework mode - React Router v7)
  */

package/dist/src/react-router/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/react-router/utils.ts"],"names":[],"mappings":"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","sourcesContent":["import { major, minVersion } from 'semver';\nimport fg from 'fast-glob';\nimport { abortIfCancelled, getPackageDotJson } from '../utils/clack-utils';\nimport clack from '../utils/clack';\nimport type { WizardOptions } from '../utils/types';\nimport { Integration } from '../lib/constants';\nimport { getPackageVersion } from '../utils/package-json';\nimport chalk from 'chalk';\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport * as semver from 'semver';\n\nexport enum ReactRouterMode {\n  V6 = 'v6', // React Router v6\n  V7_FRAMEWORK = 'v7-framework', // React Router v7 with react-router.config.ts\n  V7_DATA = 'v7-data', // React Router v7 with createBrowserRouter\n  V7_DECLARATIVE = 'v7-declarative', // React Router v7 with BrowserRouter\n}\n\nconst IGNORE_PATTERNS = [\n  '**/node_modules/**',\n  '**/dist/**',\n  '**/build/**',\n  '**/public/**',\n  '**/.next/**',\n];\n\n/**\n * Get React Router version bucket for analytics\n */\nexport function getReactRouterVersionBucket(\n  version: string | undefined,\n): string {\n  if (!version) {\n    return 'none';\n  }\n\n  try {\n    const minVer = minVersion(version);\n    if (!minVer) {\n      return 'invalid';\n    }\n    const majorVersion = major(minVer);\n    if (majorVersion >= 6) {\n      return `${majorVersion}.x`;\n    }\n    return `<6.0.0`;\n  } catch {\n    return 'unknown';\n  }\n}\n\n/**\n * Check if react-router.config.ts exists (indicates framework mode - React Router v7)\n */\nasync function hasReactRouterConfig({\n  installDir,\n}: Pick<WizardOptions, 'installDir'>): Promise<boolean> {\n  const configMatches = await fg('**/react-router.config.@(ts|js|tsx|jsx)', {\n    dot: true,\n    cwd: installDir,\n    ignore: IGNORE_PATTERNS,\n  });\n\n  return configMatches.length > 0;\n}\n\n/**\n * Search for createBrowserRouter usage in source files\n */\nasync function hasCreateBrowserRouter({\n  installDir,\n}: Pick<WizardOptions, 'installDir'>): Promise<boolean> {\n  const sourceFiles = await fg('**/*.@(ts|tsx|js|jsx)', {\n    dot: true,\n    cwd: installDir,\n    ignore: IGNORE_PATTERNS,\n  });\n\n  for (const file of sourceFiles) {\n    try {\n      const filePath = path.join(installDir, file);\n      const content = fs.readFileSync(filePath, 'utf-8');\n\n      // Check for createBrowserRouter import or usage\n      if (content.includes('createBrowserRouter')) {\n        return true;\n      }\n    } catch {\n      // Skip files that can't be read\n      continue;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Search for declarative BrowserRouter usage\n */\nasync function hasDeclarativeRouter({\n  installDir,\n}: Pick<WizardOptions, 'installDir'>): Promise<boolean> {\n  const sourceFiles = await fg('**/*.@(ts|tsx|js|jsx)', {\n    dot: true,\n    cwd: installDir,\n    ignore: IGNORE_PATTERNS,\n  });\n\n  for (const file of sourceFiles) {\n    try {\n      const filePath = path.join(installDir, file);\n      const content = fs.readFileSync(filePath, 'utf-8');\n\n      // Check for BrowserRouter usage (JSX or import)\n      if (\n        content.includes('<BrowserRouter') ||\n        (content.includes('BrowserRouter') &&\n          (content.includes('from \"react-router-dom\"') ||\n            content.includes(\"from 'react-router-dom'\")))\n      ) {\n        return true;\n      }\n    } catch {\n      // Skip files that can't be read\n      continue;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Detect React Router mode\n */\nexport async function getReactRouterMode(\n  options: WizardOptions,\n): Promise<ReactRouterMode> {\n  const { installDir } = options;\n\n  // First, get the React Router version\n  const packageJson = await getPackageDotJson(options);\n  const reactRouterVersion =\n    getPackageVersion('react-router-dom', packageJson) ||\n    getPackageVersion('react-router', packageJson);\n\n  if (!reactRouterVersion) {\n    // If we can't detect version, ask the user\n    clack.log.info(\n      `Learn more about React Router modes: ${chalk.cyan(\n        'https://reactrouter.com/start/modes',\n      )}`,\n    );\n    const result: ReactRouterMode = await abortIfCancelled(\n      clack.select({\n        message: 'What React Router version and mode are you using?',\n        options: [\n          {\n            label: 'React Router v6',\n            value: ReactRouterMode.V6,\n          },\n          {\n            label: 'React Router v7 - Framework mode',\n            value: ReactRouterMode.V7_FRAMEWORK,\n          },\n          {\n            label: 'React Router v7 - Data mode',\n            value: ReactRouterMode.V7_DATA,\n          },\n          {\n            label: 'React Router v7 - Declarative mode',\n            value: ReactRouterMode.V7_DECLARATIVE,\n          },\n        ],\n      }),\n      Integration.reactRouter,\n    );\n    return result;\n  }\n\n  const coercedVersion = semver.coerce(reactRouterVersion);\n  const majorVersion = coercedVersion ? major(coercedVersion) : null;\n\n  // If v6, return V6\n  if (majorVersion === 6) {\n    clack.log.info('Detected React Router v6');\n    return ReactRouterMode.V6;\n  }\n\n  // If v7, detect the mode\n  if (majorVersion === 7) {\n    // First check for framework mode (react-router.config.ts)\n    const hasConfig = await hasReactRouterConfig({ installDir });\n    if (hasConfig) {\n      clack.log.info('Detected React Router v7 - Framework mode');\n      return ReactRouterMode.V7_FRAMEWORK;\n    }\n\n    // Check for data mode (createBrowserRouter)\n    const hasDataMode = await hasCreateBrowserRouter({ installDir });\n    if (hasDataMode) {\n      clack.log.info('Detected React Router v7 - Data mode');\n      return ReactRouterMode.V7_DATA;\n    }\n\n    // Check for declarative mode (BrowserRouter)\n    const hasDeclarative = await hasDeclarativeRouter({ installDir });\n    if (hasDeclarative) {\n      clack.log.info('Detected React Router v7 - Declarative mode');\n      return ReactRouterMode.V7_DECLARATIVE;\n    }\n\n    // If v7 but can't detect mode, ask the user\n    clack.log.info(\n      `Learn more about React Router modes: ${chalk.cyan(\n        'https://reactrouter.com/start/modes',\n      )}`,\n    );\n    const result: ReactRouterMode = await abortIfCancelled(\n      clack.select({\n        message: 'What React Router v7 mode are you using?',\n        options: [\n          {\n            label: 'Framework mode',\n            value: ReactRouterMode.V7_FRAMEWORK,\n          },\n          {\n            label: 'Data mode',\n            value: ReactRouterMode.V7_DATA,\n          },\n          {\n            label: 'Declarative mode',\n            value: ReactRouterMode.V7_DECLARATIVE,\n          },\n        ],\n      }),\n      Integration.reactRouter,\n    );\n    return result;\n  }\n\n  // If version is not 6 or 7, default to asking\n  clack.log.info(\n    `Learn more about React Router modes: ${chalk.cyan(\n      'https://reactrouter.com/start/modes',\n    )}`,\n  );\n  const result: ReactRouterMode = await abortIfCancelled(\n    clack.select({\n      message: 'What React Router version and mode are you using?',\n      options: [\n        {\n          label: 'React Router v6',\n          value: ReactRouterMode.V6,\n        },\n        {\n          label: 'React Router v7 - Framework mode',\n          value: ReactRouterMode.V7_FRAMEWORK,\n        },\n        {\n          label: 'React Router v7 - Data mode',\n          value: ReactRouterMode.V7_DATA,\n        },\n        {\n          label: 'React Router v7 - Declarative mode',\n          value: ReactRouterMode.V7_DECLARATIVE,\n        },\n      ],\n    }),\n    Integration.reactRouter,\n  );\n  return result;\n}\n\n/**\n * Get human-readable name for React Router mode\n */\nexport function getReactRouterModeName(mode: ReactRouterMode): string {\n  switch (mode) {\n    case ReactRouterMode.V6:\n      return 'v6';\n    case ReactRouterMode.V7_FRAMEWORK:\n      return 'v7 Framework mode';\n    case ReactRouterMode.V7_DATA:\n      return 'v7 Data mode';\n    case ReactRouterMode.V7_DECLARATIVE:\n      return 'v7 Declarative mode';\n  }\n}\n"]}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/react-router/utils.ts"],"names":[],"mappings":"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","sourcesContent":["import { major } from 'semver';\nimport fg from 'fast-glob';\nimport { abortIfCancelled, getPackageDotJson } from '../utils/clack-utils';\nimport clack from '../utils/clack';\nimport type { WizardOptions } from '../utils/types';\nimport { Integration } from '../lib/constants';\nimport { getPackageVersion } from '../utils/package-json';\nimport { createVersionBucket } from '../utils/semver';\nimport chalk from 'chalk';\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport * as semver from 'semver';\n\nexport enum ReactRouterMode {\n  V6 = 'v6', // React Router v6\n  V7_FRAMEWORK = 'v7-framework', // React Router v7 with react-router.config.ts\n  V7_DATA = 'v7-data', // React Router v7 with createBrowserRouter\n  V7_DECLARATIVE = 'v7-declarative', // React Router v7 with BrowserRouter\n}\n\nconst IGNORE_PATTERNS = [\n  '**/node_modules/**',\n  '**/dist/**',\n  '**/build/**',\n  '**/public/**',\n  '**/.next/**',\n];\n\n/**\n * Get React Router version bucket for analytics\n */\nexport const getReactRouterVersionBucket = createVersionBucket();\n\n/**\n * Check if react-router.config.ts exists (indicates framework mode - React Router v7)\n */\nasync function hasReactRouterConfig({\n  installDir,\n}: Pick<WizardOptions, 'installDir'>): Promise<boolean> {\n  const configMatches = await fg('**/react-router.config.@(ts|js|tsx|jsx)', {\n    dot: true,\n    cwd: installDir,\n    ignore: IGNORE_PATTERNS,\n  });\n\n  return configMatches.length > 0;\n}\n\n/**\n * Search for createBrowserRouter usage in source files\n */\nasync function hasCreateBrowserRouter({\n  installDir,\n}: Pick<WizardOptions, 'installDir'>): Promise<boolean> {\n  const sourceFiles = await fg('**/*.@(ts|tsx|js|jsx)', {\n    dot: true,\n    cwd: installDir,\n    ignore: IGNORE_PATTERNS,\n  });\n\n  for (const file of sourceFiles) {\n    try {\n      const filePath = path.join(installDir, file);\n      const content = fs.readFileSync(filePath, 'utf-8');\n\n      // Check for createBrowserRouter import or usage\n      if (content.includes('createBrowserRouter')) {\n        return true;\n      }\n    } catch {\n      // Skip files that can't be read\n      continue;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Search for declarative BrowserRouter usage\n */\nasync function hasDeclarativeRouter({\n  installDir,\n}: Pick<WizardOptions, 'installDir'>): Promise<boolean> {\n  const sourceFiles = await fg('**/*.@(ts|tsx|js|jsx)', {\n    dot: true,\n    cwd: installDir,\n    ignore: IGNORE_PATTERNS,\n  });\n\n  for (const file of sourceFiles) {\n    try {\n      const filePath = path.join(installDir, file);\n      const content = fs.readFileSync(filePath, 'utf-8');\n\n      // Check for BrowserRouter usage (JSX or import)\n      if (\n        content.includes('<BrowserRouter') ||\n        (content.includes('BrowserRouter') &&\n          (content.includes('from \"react-router-dom\"') ||\n            content.includes(\"from 'react-router-dom'\")))\n      ) {\n        return true;\n      }\n    } catch {\n      // Skip files that can't be read\n      continue;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Detect React Router mode\n */\nexport async function getReactRouterMode(\n  options: WizardOptions,\n): Promise<ReactRouterMode> {\n  const { installDir } = options;\n\n  // First, get the React Router version\n  const packageJson = await getPackageDotJson(options);\n  const reactRouterVersion =\n    getPackageVersion('react-router-dom', packageJson) ||\n    getPackageVersion('react-router', packageJson);\n\n  if (!reactRouterVersion) {\n    // If we can't detect version, ask the user\n    clack.log.info(\n      `Learn more about React Router modes: ${chalk.cyan(\n        'https://reactrouter.com/start/modes',\n      )}`,\n    );\n    const result: ReactRouterMode = await abortIfCancelled(\n      clack.select({\n        message: 'What React Router version and mode are you using?',\n        options: [\n          {\n            label: 'React Router v6',\n            value: ReactRouterMode.V6,\n          },\n          {\n            label: 'React Router v7 - Framework mode',\n            value: ReactRouterMode.V7_FRAMEWORK,\n          },\n          {\n            label: 'React Router v7 - Data mode',\n            value: ReactRouterMode.V7_DATA,\n          },\n          {\n            label: 'React Router v7 - Declarative mode',\n            value: ReactRouterMode.V7_DECLARATIVE,\n          },\n        ],\n      }),\n      Integration.reactRouter,\n    );\n    return result;\n  }\n\n  const coercedVersion = semver.coerce(reactRouterVersion);\n  const majorVersion = coercedVersion ? major(coercedVersion) : null;\n\n  // If v6, return V6\n  if (majorVersion === 6) {\n    clack.log.info('Detected React Router v6');\n    return ReactRouterMode.V6;\n  }\n\n  // If v7, detect the mode\n  if (majorVersion === 7) {\n    // First check for framework mode (react-router.config.ts)\n    const hasConfig = await hasReactRouterConfig({ installDir });\n    if (hasConfig) {\n      clack.log.info('Detected React Router v7 - Framework mode');\n      return ReactRouterMode.V7_FRAMEWORK;\n    }\n\n    // Check for data mode (createBrowserRouter)\n    const hasDataMode = await hasCreateBrowserRouter({ installDir });\n    if (hasDataMode) {\n      clack.log.info('Detected React Router v7 - Data mode');\n      return ReactRouterMode.V7_DATA;\n    }\n\n    // Check for declarative mode (BrowserRouter)\n    const hasDeclarative = await hasDeclarativeRouter({ installDir });\n    if (hasDeclarative) {\n      clack.log.info('Detected React Router v7 - Declarative mode');\n      return ReactRouterMode.V7_DECLARATIVE;\n    }\n\n    // If v7 but can't detect mode, ask the user\n    clack.log.info(\n      `Learn more about React Router modes: ${chalk.cyan(\n        'https://reactrouter.com/start/modes',\n      )}`,\n    );\n    const result: ReactRouterMode = await abortIfCancelled(\n      clack.select({\n        message: 'What React Router v7 mode are you using?',\n        options: [\n          {\n            label: 'Framework mode',\n            value: ReactRouterMode.V7_FRAMEWORK,\n          },\n          {\n            label: 'Data mode',\n            value: ReactRouterMode.V7_DATA,\n          },\n          {\n            label: 'Declarative mode',\n            value: ReactRouterMode.V7_DECLARATIVE,\n          },\n        ],\n      }),\n      Integration.reactRouter,\n    );\n    return result;\n  }\n\n  // If version is not 6 or 7, default to asking\n  clack.log.info(\n    `Learn more about React Router modes: ${chalk.cyan(\n      'https://reactrouter.com/start/modes',\n    )}`,\n  );\n  const result: ReactRouterMode = await abortIfCancelled(\n    clack.select({\n      message: 'What React Router version and mode are you using?',\n      options: [\n        {\n          label: 'React Router v6',\n          value: ReactRouterMode.V6,\n        },\n        {\n          label: 'React Router v7 - Framework mode',\n          value: ReactRouterMode.V7_FRAMEWORK,\n        },\n        {\n          label: 'React Router v7 - Data mode',\n          value: ReactRouterMode.V7_DATA,\n        },\n        {\n          label: 'React Router v7 - Declarative mode',\n          value: ReactRouterMode.V7_DECLARATIVE,\n        },\n      ],\n    }),\n    Integration.reactRouter,\n  );\n  return result;\n}\n\n/**\n * Get human-readable name for React Router mode\n */\nexport function getReactRouterModeName(mode: ReactRouterMode): string {\n  switch (mode) {\n    case ReactRouterMode.V6:\n      return 'v6';\n    case ReactRouterMode.V7_FRAMEWORK:\n      return 'v7 Framework mode';\n    case ReactRouterMode.V7_DATA:\n      return 'v7 Data mode';\n    case ReactRouterMode.V7_DECLARATIVE:\n      return 'v7 Declarative mode';\n  }\n}\n"]}

package/dist/src/run.d.ts

@@ -11,6 +11,7 @@ type Args = {
     localMcp?: boolean;
     ci?: boolean;
     apiKey?: string;
+    menu?: boolean;
 };
 export declare function runWizard(argv: Args): Promise<void>;
 export {};

package/dist/src/run.js

@@ -5,24 +5,16 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runWizard = runWizard;
 const clack_utils_1 = require("./utils/clack-utils");
-const nextjs_wizard_agent_1 = require("./nextjs/nextjs-wizard-agent");
 const constants_1 = require("./lib/constants");
 const environment_1 = require("./utils/environment");
 const clack_1 = __importDefault(require("./utils/clack"));
 const path_1 = __importDefault(require("path"));
-const config_1 = require("./lib/config");
-const react_wizard_1 = require("./react/react-wizard");
+const registry_1 = require("./lib/registry");
 const analytics_1 = require("./utils/analytics");
-const svelte_wizard_1 = require("./svelte/svelte-wizard");
-const react_native_wizard_1 = require("./react-native/react-native-wizard");
-const astro_wizard_1 = require("./astro/astro-wizard");
-const react_router_wizard_agent_1 = require("./react-router/react-router-wizard-agent");
-const django_wizard_agent_1 = require("./django/django-wizard-agent");
-const flask_wizard_agent_1 = require("./flask/flask-wizard-agent");
-const laravel_wizard_agent_1 = require("./laravel/laravel-wizard-agent");
+const agent_runner_1 = require("./lib/agent-runner");
 const events_1 = require("events");
 const chalk_1 = __importDefault(require("chalk"));
-const errors_1 = require("./utils/errors");
+const debug_1 = require("./utils/debug");
 events_1.EventEmitter.defaultMaxListeners = 50;
 async function runWizard(argv) {
     const finalArgs = {
@@ -51,6 +43,7 @@ async function runWizard(argv) {
         localMcp: finalArgs.localMcp ?? false,
         ci: finalArgs.ci ?? false,
         apiKey: finalArgs.apiKey,
+        menu: finalArgs.menu ?? false,
     };
     clack_1.default.intro(`Welcome to the PostHog setup wizard ✨`);
     if (wizardOptions.ci) {
@@ -58,49 +51,9 @@ async function runWizard(argv) {
     }
     const integration = finalArgs.integration ?? (await getIntegrationForSetup(wizardOptions));
     analytics_1.analytics.setTag('integration', integration);
+    const config = registry_1.FRAMEWORK_REGISTRY[integration];
     try {
-        switch (integration) {
-            case constants_1.Integration.nextjs:
-                await (0, nextjs_wizard_agent_1.runNextjsWizardAgent)(wizardOptions);
-                break;
-            case constants_1.Integration.react:
-                await (0, react_wizard_1.runReactWizard)(wizardOptions);
-                break;
-            case constants_1.Integration.svelte:
-                await (0, svelte_wizard_1.runSvelteWizard)(wizardOptions);
-                break;
-            case constants_1.Integration.reactNative:
-                await (0, react_native_wizard_1.runReactNativeWizard)(wizardOptions);
-                break;
-            case constants_1.Integration.astro:
-                await (0, astro_wizard_1.runAstroWizard)(wizardOptions);
-                break;
-            case constants_1.Integration.reactRouter: {
-                const flagValue = await analytics_1.analytics.getFeatureFlag(constants_1.FeatureFlagDefinition.ReactRouter);
-                // In CI mode, bypass feature flags and always use the React Router wizard
-                if (wizardOptions.ci || flagValue === true) {
-                    await (0, react_router_wizard_agent_1.runReactRouterWizardAgent)(wizardOptions);
-                }
-                else {
-                    await (0, react_wizard_1.runReactWizard)(wizardOptions);
-                }
-                break;
-            }
-            case constants_1.Integration.django:
-                clack_1.default.log.info(`${chalk_1.default.yellow('[BETA]')} The Django wizard is in beta. Questions or feedback? Email ${chalk_1.default.cyan('wizard@posthog.com')}`);
-                await (0, django_wizard_agent_1.runDjangoWizardAgent)(wizardOptions);
-                break;
-            case constants_1.Integration.flask:
-                clack_1.default.log.info(`${chalk_1.default.yellow('[BETA]')} The Flask wizard is in beta. Questions or feedback? Email ${chalk_1.default.cyan('wizard@posthog.com')}`);
-                await (0, flask_wizard_agent_1.runFlaskWizardAgent)(wizardOptions);
-                break;
-            case constants_1.Integration.laravel:
-                clack_1.default.log.info(`${chalk_1.default.yellow('[BETA]')} The Laravel wizard is in beta. Questions or feedback? Email ${chalk_1.default.cyan('wizard@posthog.com')}`);
-                await (0, laravel_wizard_agent_1.runLaravelWizardAgent)(wizardOptions);
-                break;
-            default:
-                clack_1.default.log.error('No setup wizard selected!');
-        }
+        await (0, agent_runner_1.runAgentWizard)(config, wizardOptions);
     }
     catch (error) {
         analytics_1.analytics.captureException(error, {
@@ -108,44 +61,43 @@ async function runWizard(argv) {
             arguments: JSON.stringify(finalArgs),
         });
         await analytics_1.analytics.shutdown('error');
-        if (error instanceof errors_1.RateLimitError) {
-            clack_1.default.log.error('Wizard usage limit reached. Please try again later.');
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        const errorStack = error instanceof Error && error.stack ? error.stack : undefined;
+        // Log to file for debugging
+        (0, debug_1.logToFile)(`[Wizard run.ts] ERROR MESSAGE: ${errorMessage} `);
+        if (errorStack) {
+            (0, debug_1.logToFile)(`[Wizard run.ts] ERROR STACK: ${errorStack}`);
         }
-        else {
-            clack_1.default.log.error(`Something went wrong. You can read the documentation at ${chalk_1.default.cyan(`${config_1.INTEGRATION_CONFIG[integration].docsUrl}`)} to set up PostHog manually.`);
+        clack_1.default.log.error(`Something went wrong: ${chalk_1.default.red(errorMessage)}\n\nYou can read the documentation at ${chalk_1.default.cyan(config.metadata.docsUrl)} to set up PostHog manually.`);
+        if (wizardOptions.debug && errorStack) {
+            clack_1.default.log.info(chalk_1.default.dim(errorStack));
         }
         process.exit(1);
     }
 }
 async function detectIntegration(options) {
-    const integrationConfigs = Object.entries(config_1.INTEGRATION_CONFIG).sort(([a], [b]) => config_1.INTEGRATION_ORDER.indexOf(a) -
-        config_1.INTEGRATION_ORDER.indexOf(b));
-    for (const [integration, config] of integrationConfigs) {
-        const detected = await config.detect(options);
+    for (const integration of Object.values(constants_1.Integration)) {
+        const config = registry_1.FRAMEWORK_REGISTRY[integration];
+        const detected = await config.detection.detect(options);
         if (detected) {
             return integration;
         }
     }
 }
 async function getIntegrationForSetup(options) {
-    const detectedIntegration = await detectIntegration(options);
-    if (detectedIntegration) {
-        clack_1.default.log.success(`Detected integration: ${(0, constants_1.getIntegrationDescription)(detectedIntegration)}`);
-        return detectedIntegration;
+    if (!options.menu) {
+        const detectedIntegration = await detectIntegration(options);
+        if (detectedIntegration) {
+            clack_1.default.log.success(`Detected integration: ${registry_1.FRAMEWORK_REGISTRY[detectedIntegration].metadata.name}`);
+            return detectedIntegration;
+        }
     }
     const integration = await (0, clack_utils_1.abortIfCancelled)(clack_1.default.select({
         message: 'What do you want to set up?',
-        options: [
-            { value: constants_1.Integration.nextjs, label: 'Next.js' },
-            { value: constants_1.Integration.astro, label: 'Astro' },
-            { value: constants_1.Integration.react, label: 'React' },
-            { value: constants_1.Integration.reactRouter, label: 'React Router' },
-            { value: constants_1.Integration.django, label: 'Django' },
-            { value: constants_1.Integration.flask, label: 'Flask' },
-            { value: constants_1.Integration.laravel, label: 'Laravel' },
-            { value: constants_1.Integration.svelte, label: 'Svelte' },
-            { value: constants_1.Integration.reactNative, label: 'React Native' },
-        ],
+        options: Object.values(constants_1.Integration).map((value) => ({
+            value,
+            label: registry_1.FRAMEWORK_REGISTRY[value].metadata.name,
+        })),
     }));
     return integration;
 }

package/dist/src/run.js.map

@@ -1 +1 @@
-{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/run.ts"],"names":[],"mappings":"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","sourcesContent":["import { abortIfCancelled } from './utils/clack-utils';\n\nimport { runNextjsWizardAgent } from './nextjs/nextjs-wizard-agent';\nimport type { CloudRegion, WizardOptions } from './utils/types';\n\nimport {\n  getIntegrationDescription,\n  Integration,\n  FeatureFlagDefinition,\n} from './lib/constants';\nimport { readEnvironment } from './utils/environment';\nimport clack from './utils/clack';\nimport path from 'path';\nimport { INTEGRATION_CONFIG, INTEGRATION_ORDER } from './lib/config';\nimport { runReactWizard } from './react/react-wizard';\nimport { analytics } from './utils/analytics';\nimport { runSvelteWizard } from './svelte/svelte-wizard';\nimport { runReactNativeWizard } from './react-native/react-native-wizard';\nimport { runAstroWizard } from './astro/astro-wizard';\nimport { runReactRouterWizardAgent } from './react-router/react-router-wizard-agent';\nimport { runDjangoWizardAgent } from './django/django-wizard-agent';\nimport { runFlaskWizardAgent } from './flask/flask-wizard-agent';\nimport { runLaravelWizardAgent } from './laravel/laravel-wizard-agent';\nimport { EventEmitter } from 'events';\nimport chalk from 'chalk';\nimport { RateLimitError } from './utils/errors';\n\nEventEmitter.defaultMaxListeners = 50;\n\ntype Args = {\n  integration?: Integration;\n  debug?: boolean;\n  forceInstall?: boolean;\n  installDir?: string;\n  region?: CloudRegion;\n  default?: boolean;\n  signup?: boolean;\n  localMcp?: boolean;\n  ci?: boolean;\n  apiKey?: string;\n};\n\nexport async function runWizard(argv: Args) {\n  const finalArgs = {\n    ...argv,\n    ...readEnvironment(),\n  };\n\n  let resolvedInstallDir: string;\n  if (finalArgs.installDir) {\n    if (path.isAbsolute(finalArgs.installDir)) {\n      resolvedInstallDir = finalArgs.installDir;\n    } else {\n      resolvedInstallDir = path.join(process.cwd(), finalArgs.installDir);\n    }\n  } else {\n    resolvedInstallDir = process.cwd();\n  }\n\n  const wizardOptions: WizardOptions = {\n    debug: finalArgs.debug ?? false,\n    forceInstall: finalArgs.forceInstall ?? false,\n    installDir: resolvedInstallDir,\n    cloudRegion: finalArgs.region ?? undefined,\n    default: finalArgs.default ?? false,\n    signup: finalArgs.signup ?? false,\n    localMcp: finalArgs.localMcp ?? false,\n    ci: finalArgs.ci ?? false,\n    apiKey: finalArgs.apiKey,\n  };\n\n  clack.intro(`Welcome to the PostHog setup wizard ✨`);\n\n  if (wizardOptions.ci) {\n    clack.log.info(chalk.dim('Running in CI mode'));\n  }\n\n  const integration =\n    finalArgs.integration ?? (await getIntegrationForSetup(wizardOptions));\n\n  analytics.setTag('integration', integration);\n\n  try {\n    switch (integration) {\n      case Integration.nextjs:\n        await runNextjsWizardAgent(wizardOptions);\n        break;\n      case Integration.react:\n        await runReactWizard(wizardOptions);\n        break;\n      case Integration.svelte:\n        await runSvelteWizard(wizardOptions);\n        break;\n      case Integration.reactNative:\n        await runReactNativeWizard(wizardOptions);\n        break;\n      case Integration.astro:\n        await runAstroWizard(wizardOptions);\n        break;\n      case Integration.reactRouter: {\n        const flagValue = await analytics.getFeatureFlag(\n          FeatureFlagDefinition.ReactRouter,\n        );\n        // In CI mode, bypass feature flags and always use the React Router wizard\n        if (wizardOptions.ci || flagValue === true) {\n          await runReactRouterWizardAgent(wizardOptions);\n        } else {\n          await runReactWizard(wizardOptions);\n        }\n        break;\n      }\n      case Integration.django:\n        clack.log.info(\n          `${chalk.yellow(\n            '[BETA]',\n          )} The Django wizard is in beta. Questions or feedback? Email ${chalk.cyan(\n            'wizard@posthog.com',\n          )}`,\n        );\n        await runDjangoWizardAgent(wizardOptions);\n        break;\n      case Integration.flask:\n        clack.log.info(\n          `${chalk.yellow(\n            '[BETA]',\n          )} The Flask wizard is in beta. Questions or feedback? Email ${chalk.cyan(\n            'wizard@posthog.com',\n          )}`,\n        );\n        await runFlaskWizardAgent(wizardOptions);\n        break;\n      case Integration.laravel:\n        clack.log.info(\n          `${chalk.yellow(\n            '[BETA]',\n          )} The Laravel wizard is in beta. Questions or feedback? Email ${chalk.cyan(\n            'wizard@posthog.com',\n          )}`,\n        );\n        await runLaravelWizardAgent(wizardOptions);\n        break;\n      default:\n        clack.log.error('No setup wizard selected!');\n    }\n  } catch (error) {\n    analytics.captureException(error as Error, {\n      integration,\n      arguments: JSON.stringify(finalArgs),\n    });\n\n    await analytics.shutdown('error');\n\n    if (error instanceof RateLimitError) {\n      clack.log.error('Wizard usage limit reached. Please try again later.');\n    } else {\n      clack.log.error(\n        `Something went wrong. You can read the documentation at ${chalk.cyan(\n          `${INTEGRATION_CONFIG[integration].docsUrl}`,\n        )} to set up PostHog manually.`,\n      );\n    }\n    process.exit(1);\n  }\n}\n\nasync function detectIntegration(\n  options: Pick<WizardOptions, 'installDir'>,\n): Promise<Integration | undefined> {\n  const integrationConfigs = Object.entries(INTEGRATION_CONFIG).sort(\n    ([a], [b]) =>\n      INTEGRATION_ORDER.indexOf(a as Integration) -\n      INTEGRATION_ORDER.indexOf(b as Integration),\n  );\n\n  for (const [integration, config] of integrationConfigs) {\n    const detected = await config.detect(options);\n    if (detected) {\n      return integration as Integration;\n    }\n  }\n}\n\nasync function getIntegrationForSetup(\n  options: Pick<WizardOptions, 'installDir'>,\n) {\n  const detectedIntegration = await detectIntegration(options);\n\n  if (detectedIntegration) {\n    clack.log.success(\n      `Detected integration: ${getIntegrationDescription(detectedIntegration)}`,\n    );\n    return detectedIntegration;\n  }\n\n  const integration: Integration = await abortIfCancelled(\n    clack.select({\n      message: 'What do you want to set up?',\n      options: [\n        { value: Integration.nextjs, label: 'Next.js' },\n        { value: Integration.astro, label: 'Astro' },\n        { value: Integration.react, label: 'React' },\n        { value: Integration.reactRouter, label: 'React Router' },\n        { value: Integration.django, label: 'Django' },\n        { value: Integration.flask, label: 'Flask' },\n        { value: Integration.laravel, label: 'Laravel' },\n        { value: Integration.svelte, label: 'Svelte' },\n        { value: Integration.reactNative, label: 'React Native' },\n      ],\n    }),\n  );\n\n  return integration;\n}\n"]}
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/run.ts"],"names":[],"mappings":"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","sourcesContent":["import { abortIfCancelled } from './utils/clack-utils';\n\nimport type { CloudRegion, WizardOptions } from './utils/types';\n\nimport { Integration } from './lib/constants';\nimport { readEnvironment } from './utils/environment';\nimport clack from './utils/clack';\nimport path from 'path';\nimport { FRAMEWORK_REGISTRY } from './lib/registry';\nimport { analytics } from './utils/analytics';\nimport { runAgentWizard } from './lib/agent-runner';\nimport { EventEmitter } from 'events';\nimport chalk from 'chalk';\nimport { logToFile } from './utils/debug';\n\nEventEmitter.defaultMaxListeners = 50;\n\ntype Args = {\n  integration?: Integration;\n  debug?: boolean;\n  forceInstall?: boolean;\n  installDir?: string;\n  region?: CloudRegion;\n  default?: boolean;\n  signup?: boolean;\n  localMcp?: boolean;\n  ci?: boolean;\n  apiKey?: string;\n  menu?: boolean;\n};\n\nexport async function runWizard(argv: Args) {\n  const finalArgs = {\n    ...argv,\n    ...readEnvironment(),\n  };\n\n  let resolvedInstallDir: string;\n  if (finalArgs.installDir) {\n    if (path.isAbsolute(finalArgs.installDir)) {\n      resolvedInstallDir = finalArgs.installDir;\n    } else {\n      resolvedInstallDir = path.join(process.cwd(), finalArgs.installDir);\n    }\n  } else {\n    resolvedInstallDir = process.cwd();\n  }\n\n  const wizardOptions: WizardOptions = {\n    debug: finalArgs.debug ?? false,\n    forceInstall: finalArgs.forceInstall ?? false,\n    installDir: resolvedInstallDir,\n    cloudRegion: finalArgs.region ?? undefined,\n    default: finalArgs.default ?? false,\n    signup: finalArgs.signup ?? false,\n    localMcp: finalArgs.localMcp ?? false,\n    ci: finalArgs.ci ?? false,\n    apiKey: finalArgs.apiKey,\n    menu: finalArgs.menu ?? false,\n  };\n\n  clack.intro(`Welcome to the PostHog setup wizard ✨`);\n\n  if (wizardOptions.ci) {\n    clack.log.info(chalk.dim('Running in CI mode'));\n  }\n\n  const integration =\n    finalArgs.integration ?? (await getIntegrationForSetup(wizardOptions));\n\n  analytics.setTag('integration', integration);\n\n  const config = FRAMEWORK_REGISTRY[integration];\n\n  try {\n    await runAgentWizard(config, wizardOptions);\n  } catch (error) {\n    analytics.captureException(error as Error, {\n      integration,\n      arguments: JSON.stringify(finalArgs),\n    });\n\n    await analytics.shutdown('error');\n\n    const errorMessage = error instanceof Error ? error.message : String(error);\n    const errorStack =\n      error instanceof Error && error.stack ? error.stack : undefined;\n\n    // Log to file for debugging\n    logToFile(`[Wizard run.ts] ERROR MESSAGE: ${errorMessage} `);\n    if (errorStack) {\n      logToFile(`[Wizard run.ts] ERROR STACK: ${errorStack}`);\n    }\n\n    clack.log.error(\n      `Something went wrong: ${chalk.red(\n        errorMessage,\n      )}\\n\\nYou can read the documentation at ${chalk.cyan(\n        config.metadata.docsUrl,\n      )} to set up PostHog manually.`,\n    );\n\n    if (wizardOptions.debug && errorStack) {\n      clack.log.info(chalk.dim(errorStack));\n    }\n\n    process.exit(1);\n  }\n}\n\nasync function detectIntegration(\n  options: Pick<WizardOptions, 'installDir'>,\n): Promise<Integration | undefined> {\n  for (const integration of Object.values(Integration)) {\n    const config = FRAMEWORK_REGISTRY[integration];\n    const detected = await config.detection.detect(options);\n    if (detected) {\n      return integration;\n    }\n  }\n}\n\nasync function getIntegrationForSetup(\n  options: Pick<WizardOptions, 'installDir' | 'menu'>,\n) {\n  if (!options.menu) {\n    const detectedIntegration = await detectIntegration(options);\n\n    if (detectedIntegration) {\n      clack.log.success(\n        `Detected integration: ${FRAMEWORK_REGISTRY[detectedIntegration].metadata.name}`,\n      );\n      return detectedIntegration;\n    }\n  }\n\n  const integration: Integration = await abortIfCancelled(\n    clack.select({\n      message: 'What do you want to set up?',\n      options: Object.values(Integration).map((value) => ({\n        value,\n        label: FRAMEWORK_REGISTRY[value].metadata.name,\n      })),\n    }),\n  );\n\n  return integration;\n}\n"]}

package/dist/src/steps/add-mcp-server-to-clients/clients/claude-code.d.ts

@@ -8,12 +8,12 @@ export declare const ClaudeCodeMCPConfig: z.ZodObject<{
         args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     }, "strip", z.ZodTypeAny, {
-        env?: Record<string, string> | undefined;
         command?: string | undefined;
+        env?: Record<string, string> | undefined;
         args?: string[] | undefined;
     }, {
-        env?: Record<string, string> | undefined;
         command?: string | undefined;
+        env?: Record<string, string> | undefined;
         args?: string[] | undefined;
     }>, z.ZodObject<{
         url: z.ZodString;
@@ -31,12 +31,12 @@ export declare const ClaudeCodeMCPConfig: z.ZodObject<{
         args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     }, "strip", z.ZodTypeAny, {
-        env?: Record<string, string> | undefined;
         command?: string | undefined;
+        env?: Record<string, string> | undefined;
         args?: string[] | undefined;
     }, {
-        env?: Record<string, string> | undefined;
         command?: string | undefined;
+        env?: Record<string, string> | undefined;
         args?: string[] | undefined;
     }>, z.ZodObject<{
         url: z.ZodString;
@@ -54,12 +54,12 @@ export declare const ClaudeCodeMCPConfig: z.ZodObject<{
         args: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     }, "strip", z.ZodTypeAny, {
-        env?: Record<string, string> | undefined;
         command?: string | undefined;
+        env?: Record<string, string> | undefined;
         args?: string[] | undefined;
     }, {
-        env?: Record<string, string> | undefined;
         command?: string | undefined;
+        env?: Record<string, string> | undefined;
         args?: string[] | undefined;
     }>, z.ZodObject<{
         url: z.ZodString;