@posthog/wizard 1.36.1 → 2.0.0

package/dist/src/{react-native → frameworks/react-native}/utils.js

@@ -1,15 +1,12 @@
 "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"));
+const semver_1 = require("../../utils/semver");
+const setup_utils_1 = require("../../utils/setup-utils");
+const package_json_1 = require("../../utils/package-json");
+const ui_1 = require("../../ui");
 exports.getReactNativeVersionBucket = (0, semver_1.createVersionBucket)();
 var ReactNativeVariant;
 (function (ReactNativeVariant) {
@@ -20,12 +17,12 @@ function getReactNativeVariantName(variant) {
     return variant === ReactNativeVariant.EXPO ? 'Expo' : 'React Native';
 }
 async function detectReactNativeVariant(options) {
-    const packageJson = await (0, clack_utils_1.tryGetPackageJson)(options);
+    const packageJson = await (0, setup_utils_1.tryGetPackageJson)(options);
     if (packageJson && (0, package_json_1.hasPackageInstalled)('expo', packageJson)) {
-        clack_1.default.log.info(`Detected ${getReactNativeVariantName(ReactNativeVariant.EXPO)} 📱`);
+        (0, ui_1.getUI)().setDetectedFramework(`${getReactNativeVariantName(ReactNativeVariant.EXPO)} 📱`);
         return ReactNativeVariant.EXPO;
     }
-    clack_1.default.log.info(`Detected ${getReactNativeVariantName(ReactNativeVariant.REACT_NATIVE)} 📱`);
+    (0, ui_1.getUI)().setDetectedFramework(`${getReactNativeVariantName(ReactNativeVariant.REACT_NATIVE)} 📱`);
     return ReactNativeVariant.REACT_NATIVE;
 }
 //# sourceMappingURL=utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/frameworks/react-native/utils.ts"],"names":[],"mappings":";;;AAaA,8DAEC;AAED,4DAgBC;AAjCD,+CAAyD;AACzD,yDAA4D;AAC5D,2DAA+D;AAC/D,iCAAiC;AAGpB,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,IAAA,UAAK,GAAE,CAAC,oBAAoB,CAC1B,GAAG,yBAAyB,CAAC,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAC3D,CAAC;QACF,OAAO,kBAAkB,CAAC,IAAI,CAAC;IACjC,CAAC;IAED,IAAA,UAAK,GAAE,CAAC,oBAAoB,CAC1B,GAAG,yBAAyB,CAAC,kBAAkB,CAAC,YAAY,CAAC,KAAK,CACnE,CAAC;IACF,OAAO,kBAAkB,CAAC,YAAY,CAAC;AACzC,CAAC","sourcesContent":["import { createVersionBucket } from '../../utils/semver';\nimport { tryGetPackageJson } from '../../utils/setup-utils';\nimport { hasPackageInstalled } from '../../utils/package-json';\nimport { getUI } from '../../ui';\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    getUI().setDetectedFramework(\n      `${getReactNativeVariantName(ReactNativeVariant.EXPO)} 📱`,\n    );\n    return ReactNativeVariant.EXPO;\n  }\n\n  getUI().setDetectedFramework(\n    `${getReactNativeVariantName(ReactNativeVariant.REACT_NATIVE)} 📱`,\n  );\n  return ReactNativeVariant.REACT_NATIVE;\n}\n"]}

package/dist/src/{react-router → frameworks/react-router}/react-router-wizard-agent.d.ts

@@ -1,4 +1,4 @@
-import type { FrameworkConfig } from '../lib/framework-config';
+import type { FrameworkConfig } from '../../lib/framework-config';
 import { ReactRouterMode } from './utils';
 type ReactRouterContext = {
     routerMode?: ReactRouterMode;

package/dist/src/{react-router → frameworks/react-router}/react-router-wizard-agent.js

@@ -1,10 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.REACT_ROUTER_AGENT_CONFIG = void 0;
-const package_manager_detection_1 = require("../lib/package-manager-detection");
-const constants_1 = require("../lib/constants");
-const package_json_1 = require("../utils/package-json");
-const clack_utils_1 = require("../utils/clack-utils");
+const package_manager_detection_1 = require("../../lib/package-manager-detection");
+const constants_1 = require("../../lib/constants");
+const package_json_1 = require("../../utils/package-json");
+const setup_utils_1 = require("../../utils/setup-utils");
+const ui_1 = require("../../ui");
 const utils_1 = require("./utils");
 exports.REACT_ROUTER_AGENT_CONFIG = {
     metadata: {
@@ -14,7 +15,11 @@ exports.REACT_ROUTER_AGENT_CONFIG = {
         unsupportedVersionDocsUrl: 'https://posthog.com/docs/libraries/react',
         gatherContext: async (options) => {
             const routerMode = await (0, utils_1.getReactRouterMode)(options);
-            return { routerMode };
+            if (routerMode) {
+                (0, ui_1.getUI)().setDetectedFramework(`React Router ${(0, utils_1.getReactRouterModeName)(routerMode)}`);
+                return { routerMode };
+            }
+            return {};
         },
     },
     detection: {
@@ -24,11 +29,13 @@ exports.REACT_ROUTER_AGENT_CONFIG = {
         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);
+            const packageJson = await (0, setup_utils_1.tryGetPackageJson)(options);
+            return packageJson
+                ? (0, package_json_1.getPackageVersion)('react-router', packageJson)
+                : undefined;
         },
         detect: async (options) => {
-            const packageJson = await (0, clack_utils_1.tryGetPackageJson)(options);
+            const packageJson = await (0, setup_utils_1.tryGetPackageJson)(options);
             return packageJson
                 ? (0, package_json_1.hasPackageInstalled)('react-router', packageJson)
                 : false;

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

@@ -0,0 +1 @@
+{"version":3,"file":"react-router-wizard-agent.js","sourceRoot":"","sources":["../../../../src/frameworks/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 { detectNodePackageManagers } from '../../lib/package-manager-detection';\nimport { Integration } from '../../lib/constants';\nimport {\n  getPackageVersion,\n  hasPackageInstalled,\n  type PackageDotJson,\n} from '../../utils/package-json';\nimport { tryGetPackageJson } from '../../utils/setup-utils';\nimport { getUI } from '../../ui';\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      if (routerMode) {\n        getUI().setDetectedFramework(\n          `React Router ${getReactRouterModeName(routerMode)}`,\n        );\n        return { routerMode };\n      }\n      return {};\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 tryGetPackageJson(options);\n      return packageJson\n        ? getPackageVersion('react-router', packageJson)\n        : undefined;\n    },\n    detect: async (options) => {\n      const packageJson = await tryGetPackageJson(options);\n      return packageJson\n        ? hasPackageInstalled('react-router', packageJson)\n        : false;\n    },\n    detectPackageManager: detectNodePackageManagers,\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    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/frameworks/react-router/utils.d.ts

@@ -0,0 +1,13 @@
+import type { WizardOptions } from '../../utils/types';
+export declare enum ReactRouterMode {
+    V6 = "v6",
+    V7_FRAMEWORK = "v7-framework",
+    V7_DATA = "v7-data",
+    V7_DECLARATIVE = "v7-declarative"
+}
+export declare const getReactRouterVersionBucket: (version: string | undefined) => string;
+/**
+ * Detect React Router mode. Pure — returns null if ambiguous.
+ */
+export declare function getReactRouterMode(options: WizardOptions): Promise<ReactRouterMode | null>;
+export declare function getReactRouterModeName(mode: ReactRouterMode): string;

package/dist/src/{react-router → frameworks/react-router}/utils.js

@@ -41,12 +41,9 @@ exports.getReactRouterMode = getReactRouterMode;
 exports.getReactRouterModeName = getReactRouterModeName;
 const semver_1 = require("semver");
 const fast_glob_1 = __importDefault(require("fast-glob"));
-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 setup_utils_1 = require("../../utils/setup-utils");
+const package_json_1 = require("../../utils/package-json");
+const semver_2 = require("../../utils/semver");
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
 const semver = __importStar(require("semver"));
@@ -64,13 +61,7 @@ const IGNORE_PATTERNS = [
     '**/public/**',
     '**/.next/**',
 ];
-/**
- * Get React Router version bucket for analytics
- */
 exports.getReactRouterVersionBucket = (0, semver_2.createVersionBucket)();
-/**
- * Check if react-router.config.ts exists (indicates framework mode - React Router v7)
- */
 async function hasReactRouterConfig({ installDir, }) {
     const configMatches = await (0, fast_glob_1.default)('**/react-router.config.@(ts|js|tsx|jsx)', {
         dot: true,
@@ -79,9 +70,6 @@ async function hasReactRouterConfig({ installDir, }) {
     });
     return configMatches.length > 0;
 }
-/**
- * Search for createBrowserRouter usage in source files
- */
 async function hasCreateBrowserRouter({ installDir, }) {
     const sourceFiles = await (0, fast_glob_1.default)('**/*.@(ts|tsx|js|jsx)', {
         dot: true,
@@ -92,21 +80,16 @@ async function hasCreateBrowserRouter({ installDir, }) {
         try {
             const filePath = path.join(installDir, file);
             const content = fs.readFileSync(filePath, 'utf-8');
-            // Check for createBrowserRouter import or usage
             if (content.includes('createBrowserRouter')) {
                 return true;
             }
         }
         catch {
-            // Skip files that can't be read
             continue;
         }
     }
     return false;
 }
-/**
- * Search for declarative BrowserRouter usage
- */
 async function hasDeclarativeRouter({ installDir, }) {
     const sourceFiles = await (0, fast_glob_1.default)('**/*.@(ts|tsx|js|jsx)', {
         dot: true,
@@ -117,7 +100,6 @@ async function hasDeclarativeRouter({ installDir, }) {
         try {
             const filePath = path.join(installDir, file);
             const content = fs.readFileSync(filePath, 'utf-8');
-            // Check for BrowserRouter usage (JSX or import)
             if (content.includes('<BrowserRouter') ||
                 (content.includes('BrowserRouter') &&
                     (content.includes('from "react-router-dom"') ||
@@ -126,123 +108,44 @@ async function hasDeclarativeRouter({ installDir, }) {
             }
         }
         catch {
-            // Skip files that can't be read
             continue;
         }
     }
     return false;
 }
 /**
- * Detect React Router mode
+ * Detect React Router mode. Pure — returns null if ambiguous.
  */
 async function getReactRouterMode(options) {
     const { installDir } = options;
-    // First, get the React Router version
-    const packageJson = await (0, clack_utils_1.getPackageDotJson)(options);
+    const packageJson = await (0, setup_utils_1.tryGetPackageJson)(options);
+    if (!packageJson)
+        return null;
     const reactRouterVersion = (0, package_json_1.getPackageVersion)('react-router-dom', packageJson) ||
         (0, package_json_1.getPackageVersion)('react-router', packageJson);
     if (!reactRouterVersion) {
-        // If we can't detect version, ask the user
-        clack_1.default.log.info(`Learn more about React Router modes: ${chalk_1.default.cyan('https://reactrouter.com/start/modes')}`);
-        const result = await (0, clack_utils_1.abortIfCancelled)(clack_1.default.select({
-            message: 'What React Router version and mode are you using?',
-            options: [
-                {
-                    label: 'React Router v6',
-                    value: ReactRouterMode.V6,
-                },
-                {
-                    label: 'React Router v7 - Framework mode',
-                    value: ReactRouterMode.V7_FRAMEWORK,
-                },
-                {
-                    label: 'React Router v7 - Data mode',
-                    value: ReactRouterMode.V7_DATA,
-                },
-                {
-                    label: 'React Router v7 - Declarative mode',
-                    value: ReactRouterMode.V7_DECLARATIVE,
-                },
-            ],
-        }), constants_1.Integration.reactRouter);
-        return result;
+        return null;
     }
     const coercedVersion = semver.coerce(reactRouterVersion);
     const majorVersion = coercedVersion ? (0, semver_1.major)(coercedVersion) : null;
-    // If v6, return V6
     if (majorVersion === 6) {
-        clack_1.default.log.info('Detected React Router v6');
         return ReactRouterMode.V6;
     }
-    // If v7, detect the mode
     if (majorVersion === 7) {
-        // First check for framework mode (react-router.config.ts)
         const hasConfig = await hasReactRouterConfig({ installDir });
-        if (hasConfig) {
-            clack_1.default.log.info('Detected React Router v7 - Framework mode');
+        if (hasConfig)
             return ReactRouterMode.V7_FRAMEWORK;
-        }
-        // Check for data mode (createBrowserRouter)
         const hasDataMode = await hasCreateBrowserRouter({ installDir });
-        if (hasDataMode) {
-            clack_1.default.log.info('Detected React Router v7 - Data mode');
+        if (hasDataMode)
             return ReactRouterMode.V7_DATA;
-        }
-        // Check for declarative mode (BrowserRouter)
         const hasDeclarative = await hasDeclarativeRouter({ installDir });
-        if (hasDeclarative) {
-            clack_1.default.log.info('Detected React Router v7 - Declarative mode');
+        if (hasDeclarative)
             return ReactRouterMode.V7_DECLARATIVE;
-        }
-        // If v7 but can't detect mode, ask the user
-        clack_1.default.log.info(`Learn more about React Router modes: ${chalk_1.default.cyan('https://reactrouter.com/start/modes')}`);
-        const result = await (0, clack_utils_1.abortIfCancelled)(clack_1.default.select({
-            message: 'What React Router v7 mode are you using?',
-            options: [
-                {
-                    label: 'Framework mode',
-                    value: ReactRouterMode.V7_FRAMEWORK,
-                },
-                {
-                    label: 'Data mode',
-                    value: ReactRouterMode.V7_DATA,
-                },
-                {
-                    label: 'Declarative mode',
-                    value: ReactRouterMode.V7_DECLARATIVE,
-                },
-            ],
-        }), constants_1.Integration.reactRouter);
-        return result;
+        // v7 but can't detect mode
+        return null;
     }
-    // If version is not 6 or 7, default to asking
-    clack_1.default.log.info(`Learn more about React Router modes: ${chalk_1.default.cyan('https://reactrouter.com/start/modes')}`);
-    const result = await (0, clack_utils_1.abortIfCancelled)(clack_1.default.select({
-        message: 'What React Router version and mode are you using?',
-        options: [
-            {
-                label: 'React Router v6',
-                value: ReactRouterMode.V6,
-            },
-            {
-                label: 'React Router v7 - Framework mode',
-                value: ReactRouterMode.V7_FRAMEWORK,
-            },
-            {
-                label: 'React Router v7 - Data mode',
-                value: ReactRouterMode.V7_DATA,
-            },
-            {
-                label: 'React Router v7 - Declarative mode',
-                value: ReactRouterMode.V7_DECLARATIVE,
-            },
-        ],
-    }), constants_1.Integration.reactRouter);
-    return result;
+    return null;
 }
-/**
- * Get human-readable name for React Router mode
- */
 function getReactRouterModeName(mode) {
     switch (mode) {
         case ReactRouterMode.V6:

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/frameworks/react-router/utils.ts"],"names":[],"mappings":"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","sourcesContent":["import { major } from 'semver';\nimport fg from 'fast-glob';\nimport { tryGetPackageJson } from '../../utils/setup-utils';\nimport type { WizardOptions } from '../../utils/types';\nimport { getPackageVersion } from '../../utils/package-json';\nimport { createVersionBucket } from '../../utils/semver';\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport * as semver from 'semver';\n\nexport enum ReactRouterMode {\n  V6 = 'v6',\n  V7_FRAMEWORK = 'v7-framework',\n  V7_DATA = 'v7-data',\n  V7_DECLARATIVE = 'v7-declarative',\n}\n\nconst IGNORE_PATTERNS = [\n  '**/node_modules/**',\n  '**/dist/**',\n  '**/build/**',\n  '**/public/**',\n  '**/.next/**',\n];\n\nexport const getReactRouterVersionBucket = createVersionBucket();\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  return configMatches.length > 0;\n}\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      if (content.includes('createBrowserRouter')) {\n        return true;\n      }\n    } catch {\n      continue;\n    }\n  }\n\n  return false;\n}\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      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      continue;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Detect React Router mode. Pure — returns null if ambiguous.\n */\nexport async function getReactRouterMode(\n  options: WizardOptions,\n): Promise<ReactRouterMode | null> {\n  const { installDir } = options;\n\n  const packageJson = await tryGetPackageJson(options);\n  if (!packageJson) return null;\n\n  const reactRouterVersion =\n    getPackageVersion('react-router-dom', packageJson) ||\n    getPackageVersion('react-router', packageJson);\n\n  if (!reactRouterVersion) {\n    return null;\n  }\n\n  const coercedVersion = semver.coerce(reactRouterVersion);\n  const majorVersion = coercedVersion ? major(coercedVersion) : null;\n\n  if (majorVersion === 6) {\n    return ReactRouterMode.V6;\n  }\n\n  if (majorVersion === 7) {\n    const hasConfig = await hasReactRouterConfig({ installDir });\n    if (hasConfig) return ReactRouterMode.V7_FRAMEWORK;\n\n    const hasDataMode = await hasCreateBrowserRouter({ installDir });\n    if (hasDataMode) return ReactRouterMode.V7_DATA;\n\n    const hasDeclarative = await hasDeclarativeRouter({ installDir });\n    if (hasDeclarative) return ReactRouterMode.V7_DECLARATIVE;\n\n    // v7 but can't detect mode\n    return null;\n  }\n\n  return null;\n}\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/{ruby → frameworks/ruby}/ruby-wizard-agent.d.ts

@@ -1,4 +1,4 @@
-import type { FrameworkConfig } from '../lib/framework-config';
+import type { FrameworkConfig } from '../../lib/framework-config';
 import { RubyPackageManager } from './utils';
 type RubyContext = {
     packageManager?: RubyPackageManager;

package/dist/src/{ruby → frameworks/ruby}/ruby-wizard-agent.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RUBY_AGENT_CONFIG = void 0;
-const package_manager_detection_1 = require("../lib/package-manager-detection");
-const constants_1 = require("../lib/constants");
+const package_manager_detection_1 = require("../../lib/package-manager-detection");
+const constants_1 = require("../../lib/constants");
 const utils_1 = require("./utils");
 exports.RUBY_AGENT_CONFIG = {
     metadata: {

package/dist/src/frameworks/ruby/ruby-wizard-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ruby-wizard-agent.js","sourceRoot":"","sources":["../../../../src/frameworks/ruby/ruby-wizard-agent.ts"],"names":[],"mappings":"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","sourcesContent":["/* Generic Ruby language wizard using posthog-agent with PostHog MCP */\nimport type { WizardOptions } from '../../utils/types';\nimport type { FrameworkConfig } from '../../lib/framework-config';\nimport { bundlerPackageManager } from '../../lib/package-manager-detection';\nimport { Integration } from '../../lib/constants';\nimport {\n  getRubyVersion,\n  getRubyVersionBucket,\n  detectPackageManager,\n  getPackageManagerName,\n  RubyPackageManager,\n  isRubyProject,\n} from './utils';\n\ntype RubyContext = {\n  packageManager?: RubyPackageManager;\n};\n\nexport const RUBY_AGENT_CONFIG: FrameworkConfig<RubyContext> = {\n  metadata: {\n    name: 'Ruby',\n    integration: Integration.ruby,\n    beta: true,\n    docsUrl: 'https://posthog.com/docs/libraries/ruby',\n    gatherContext: (options: WizardOptions) => {\n      const packageManager = detectPackageManager(options);\n      return Promise.resolve({ packageManager });\n    },\n  },\n\n  detection: {\n    packageName: 'ruby',\n    packageDisplayName: 'Ruby',\n    usesPackageJson: false,\n    getVersion: () => undefined,\n    getVersionBucket: getRubyVersionBucket,\n    minimumVersion: '2.7.0',\n    getInstalledVersion: (options: WizardOptions) =>\n      Promise.resolve(getRubyVersion(options)),\n    detect: async (options) => isRubyProject(options),\n    detectPackageManager: bundlerPackageManager,\n  },\n\n  environment: {\n    uploadToHosting: false,\n    getEnvVars: (apiKey: string, host: string) => ({\n      POSTHOG_API_KEY: apiKey,\n      POSTHOG_HOST: host,\n    }),\n  },\n\n  analytics: {\n    getTags: (context) => {\n      const packageManagerName = context.packageManager\n        ? getPackageManagerName(context.packageManager)\n        : 'unknown';\n      return {\n        packageManager: packageManagerName,\n      };\n    },\n  },\n\n  prompts: {\n    projectTypeDetection:\n      'This is a Ruby project. Look for Gemfile, *.gemspec, .ruby-version, or *.rb files to confirm.',\n    packageInstallation:\n      \"Use Bundler if a Gemfile is present (add `gem 'posthog-ruby'` and run `bundle install`). Otherwise use `gem install posthog-ruby`. Do not pin a specific version.\",\n    getAdditionalContextLines: (context) => {\n      const packageManagerName = context.packageManager\n        ? getPackageManagerName(context.packageManager)\n        : 'unknown';\n\n      const lines = [\n        `Package manager: ${packageManagerName}`,\n        `Framework docs ID: ruby (use posthog://docs/frameworks/ruby for documentation)`,\n        `Project type: Generic Ruby application (CLI, script, gem, worker, etc.)`,\n        ``,\n        `## CRITICAL: Ruby PostHog Best Practices`,\n        ``,\n        `### 1. Gem Name vs Require`,\n        `The gem is named posthog-ruby but you require it as 'posthog':`,\n        `  gem 'posthog-ruby'  # in Gemfile`,\n        `  require 'posthog'   # in code (NOT require 'posthog-ruby')`,\n        ``,\n        `### 2. Use Instance-Based API (REQUIRED for scripts/CLIs)`,\n        `Use PostHog::Client.new for scripts and standalone applications:`,\n        ``,\n        `client = PostHog::Client.new(`,\n        `  api_key: ENV['POSTHOG_API_KEY'],`,\n        `  host: ENV['POSTHOG_HOST'] || 'https://us.i.posthog.com'`,\n        `)`,\n        ``,\n        `### 3. MUST Call shutdown Before Exit`,\n        `In scripts and CLIs, you MUST call client.shutdown or events will be lost:`,\n        ``,\n        `begin`,\n        `  client.capture(distinct_id: 'user_123', event: 'my_event')`,\n        `ensure`,\n        `  client.shutdown`,\n        `end`,\n        ``,\n        `### 4. capture_exception Takes Positional Args`,\n        `client.capture_exception(exception, distinct_id, additional_properties)`,\n        `Do NOT use keyword arguments for capture_exception.`,\n        ``,\n        `### 5. NEVER Send PII`,\n        `Do NOT include emails, names, phone numbers, or user content in event properties.`,\n      ];\n\n      return lines;\n    },\n  },\n\n  ui: {\n    successMessage: 'PostHog integration complete',\n    estimatedDurationMinutes: 5,\n    getOutroChanges: (context) => {\n      const packageManagerName = context.packageManager\n        ? getPackageManagerName(context.packageManager)\n        : 'package manager';\n      return [\n        `Analyzed your Ruby project structure`,\n        `Installed the posthog-ruby gem using ${packageManagerName}`,\n        `Created PostHog initialization with instance-based API`,\n        `Configured shutdown handler for proper event flushing`,\n      ];\n    },\n    getOutroNextSteps: () => [\n      'Use client.capture() for events and client.identify() for users',\n      'Always call client.shutdown() before your application exits',\n      'Visit your PostHog dashboard to see incoming events',\n    ],\n  },\n};\n"]}

package/dist/src/{ruby → frameworks/ruby}/utils.d.ts

@@ -1,4 +1,4 @@
-import type { WizardOptions } from '../utils/types';
+import type { WizardOptions } from '../../utils/types';
 export declare enum RubyPackageManager {
     BUNDLER = "bundler",
     MANUAL = "manual"

package/dist/src/{ruby → frameworks/ruby}/utils.js

@@ -42,7 +42,7 @@ exports.getPackageManagerName = getPackageManagerName;
 exports.getRubyVersion = getRubyVersion;
 exports.isRubyProject = isRubyProject;
 const fast_glob_1 = __importDefault(require("fast-glob"));
-const semver_1 = require("../utils/semver");
+const semver_1 = require("../../utils/semver");
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
 var RubyPackageManager;

package/dist/src/frameworks/ruby/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/frameworks/ruby/utils.ts"],"names":[],"mappings":"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","sourcesContent":["import fg from 'fast-glob';\nimport type { WizardOptions } from '../../utils/types';\nimport { createVersionBucket } from '../../utils/semver';\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\n\nexport enum RubyPackageManager {\n  BUNDLER = 'bundler',\n  MANUAL = 'manual',\n}\n\nconst IGNORE_PATTERNS = [\n  '**/node_modules/**',\n  '**/vendor/**',\n  '**/vendor/bundle/**',\n  '**/tmp/**',\n  '**/log/**',\n];\n\n/**\n * Get Ruby version bucket for analytics\n */\nexport const getRubyVersionBucket = createVersionBucket();\n\n/**\n * Detect Ruby package manager\n */\nexport function detectPackageManager(\n  options: Pick<WizardOptions, 'installDir'>,\n): RubyPackageManager {\n  const { installDir } = options;\n\n  const gemfilePath = path.join(installDir, 'Gemfile');\n  if (fs.existsSync(gemfilePath)) {\n    return RubyPackageManager.BUNDLER;\n  }\n\n  return RubyPackageManager.MANUAL;\n}\n\n/**\n * Get human-readable name for package manager\n */\nexport function getPackageManagerName(\n  packageManager: RubyPackageManager,\n): string {\n  switch (packageManager) {\n    case RubyPackageManager.BUNDLER:\n      return 'Bundler';\n    case RubyPackageManager.MANUAL:\n      return 'gem install';\n  }\n}\n\n/**\n * Get Ruby version from .ruby-version file or Gemfile\n */\nexport function getRubyVersion(\n  options: Pick<WizardOptions, 'installDir'>,\n): string | undefined {\n  const { installDir } = options;\n\n  // Check .ruby-version file\n  const rubyVersionPath = path.join(installDir, '.ruby-version');\n  try {\n    const content = fs.readFileSync(rubyVersionPath, 'utf-8').trim();\n    // Remove \"ruby-\" prefix if present\n    const version = content.replace(/^ruby-/, '');\n    if (/^[0-9]+\\.[0-9]+/.test(version)) {\n      return version;\n    }\n  } catch {\n    // Continue to other checks\n  }\n\n  // Check Gemfile for ruby version declaration\n  const gemfilePath = path.join(installDir, 'Gemfile');\n  try {\n    const content = fs.readFileSync(gemfilePath, 'utf-8');\n    const match = content.match(/ruby\\s+['\"]([0-9]+\\.[0-9]+(?:\\.[0-9]+)?)['\"]/);\n    if (match) {\n      return match[1];\n    }\n  } catch {\n    // No Gemfile\n  }\n\n  return undefined;\n}\n\n/**\n * Check if the project is a Ruby project (but not Rails)\n */\nexport async function isRubyProject(\n  options: Pick<WizardOptions, 'installDir'>,\n): Promise<boolean> {\n  const { installDir } = options;\n\n  // Check for Gemfile\n  const gemfilePath = path.join(installDir, 'Gemfile');\n  if (fs.existsSync(gemfilePath)) {\n    // Make sure this isn't a Rails project (Rails should be detected first)\n    try {\n      const content = fs.readFileSync(gemfilePath, 'utf-8');\n      if (/^\\s*gem\\s+['\"]rails['\"]/im.test(content)) {\n        return false; // Rails project, use rails agent instead\n      }\n    } catch {\n      // Continue checking\n    }\n    return true;\n  }\n\n  // Check for .ruby-version file\n  const rubyVersionPath = path.join(installDir, '.ruby-version');\n  if (fs.existsSync(rubyVersionPath)) {\n    return true;\n  }\n\n  // Check for *.gemspec files\n  const gemspecFiles = await fg('*.gemspec', {\n    cwd: installDir,\n    ignore: IGNORE_PATTERNS,\n  });\n\n  if (gemspecFiles.length > 0) {\n    return true;\n  }\n\n  // Check for Ruby source files in the root\n  const rubyFiles = await fg(['*.rb', 'lib/**/*.rb', 'bin/**/*.rb'], {\n    cwd: installDir,\n    ignore: IGNORE_PATTERNS,\n  });\n\n  return rubyFiles.length > 0;\n}\n"]}

package/dist/src/{svelte → frameworks/svelte}/svelte-wizard-agent.d.ts

@@ -1,4 +1,4 @@
-import type { FrameworkConfig } from '../lib/framework-config';
+import type { FrameworkConfig } from '../../lib/framework-config';
 type SvelteKitContext = Record<string, unknown>;
 export declare const SVELTEKIT_AGENT_CONFIG: FrameworkConfig<SvelteKitContext>;
 export {};

package/dist/src/{svelte → frameworks/svelte}/svelte-wizard-agent.js

@@ -1,10 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SVELTEKIT_AGENT_CONFIG = void 0;
-const package_manager_detection_1 = require("../lib/package-manager-detection");
-const constants_1 = require("../lib/constants");
-const package_json_1 = require("../utils/package-json");
-const clack_utils_1 = require("../utils/clack-utils");
+const package_manager_detection_1 = require("../../lib/package-manager-detection");
+const constants_1 = require("../../lib/constants");
+const package_json_1 = require("../../utils/package-json");
+const setup_utils_1 = require("../../utils/setup-utils");
 exports.SVELTEKIT_AGENT_CONFIG = {
     metadata: {
         name: 'SvelteKit',
@@ -20,7 +20,7 @@ exports.SVELTEKIT_AGENT_CONFIG = {
         packageDisplayName: 'SvelteKit',
         getVersion: (packageJson) => (0, package_json_1.getPackageVersion)('@sveltejs/kit', packageJson),
         detect: async (options) => {
-            const packageJson = await (0, clack_utils_1.tryGetPackageJson)(options);
+            const packageJson = await (0, setup_utils_1.tryGetPackageJson)(options);
             return packageJson
                 ? (0, package_json_1.hasPackageInstalled)('@sveltejs/kit', packageJson)
                 : false;

package/dist/src/frameworks/svelte/svelte-wizard-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"svelte-wizard-agent.js","sourceRoot":"","sources":["../../../../src/frameworks/svelte/svelte-wizard-agent.ts"],"names":[],"mappings":";;;AAEA,mFAAgF;AAChF,mDAAkD;AAClD,2DAIkC;AAClC,yDAA4D;AAI/C,QAAA,sBAAsB,GAAsC;IACvE,QAAQ,EAAE;QACR,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,uBAAW,CAAC,SAAS;QAClC,OAAO,EAAE,2CAA2C;QACpD,IAAI,EAAE,IAAI;QACV,oBAAoB,EAAE;YACpB,MAAM,EAAE,EAAE,GAAG,EAAE,4BAA4B,EAAE;SAC9C;KACF;IAED,SAAS,EAAE;QACT,WAAW,EAAE,eAAe;QAC5B,kBAAkB,EAAE,WAAW;QAC/B,UAAU,EAAE,CAAC,WAAoB,EAAE,EAAE,CACnC,IAAA,gCAAiB,EAAC,eAAe,EAAE,WAA6B,CAAC;QACnE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACxB,MAAM,WAAW,GAAG,MAAM,IAAA,+BAAiB,EAAC,OAAO,CAAC,CAAC;YACrD,OAAO,WAAW;gBAChB,CAAC,CAAC,IAAA,kCAAmB,EAAC,eAAe,EAAE,WAAW,CAAC;gBACnD,CAAC,CAAC,KAAK,CAAC;QACZ,CAAC;QACD,cAAc,EAAE,OAAO;QACvB,oBAAoB,EAAE,qDAAyB;KAChD;IAED,WAAW,EAAE;QACX,eAAe,EAAE,IAAI;QACrB,UAAU,EAAE,CAAC,MAAc,EAAE,IAAY,EAAE,EAAE,CAAC,CAAC;YAC7C,kBAAkB,EAAE,MAAM;YAC1B,mBAAmB,EAAE,IAAI;SAC1B,CAAC;KACH;IAED,SAAS,EAAE;QACT,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;KACpB;IAED,OAAO,EAAE;QACP,oBAAoB,EAClB,uLAAuL;QACzL,yBAAyB,EAAE,GAAG,EAAE,CAAC;YAC/B,0FAA0F;SAC3F;KACF;IAED,EAAE,EAAE;QACF,cAAc,EAAE,8BAA8B;QAC9C,wBAAwB,EAAE,CAAC;QAC3B,eAAe,EAAE,GAAG,EAAE,CAAC;YACrB,2CAA2C;YAC3C,6CAA6C;YAC7C,0CAA0C;SAC3C;QACD,iBAAiB,EAAE,GAAG,EAAE,CAAC;YACvB,wDAAwD;YACxD,qDAAqD;SACtD;KACF;CACF,CAAC","sourcesContent":["/* SvelteKit wizard using posthog-agent with PostHog MCP */\nimport type { FrameworkConfig } from '../../lib/framework-config';\nimport { detectNodePackageManagers } from '../../lib/package-manager-detection';\nimport { Integration } from '../../lib/constants';\nimport {\n  getPackageVersion,\n  hasPackageInstalled,\n  type PackageDotJson,\n} from '../../utils/package-json';\nimport { tryGetPackageJson } from '../../utils/setup-utils';\n\ntype SvelteKitContext = Record<string, unknown>;\n\nexport const SVELTEKIT_AGENT_CONFIG: FrameworkConfig<SvelteKitContext> = {\n  metadata: {\n    name: 'SvelteKit',\n    integration: Integration.sveltekit,\n    docsUrl: 'https://posthog.com/docs/libraries/svelte',\n    beta: true,\n    additionalMcpServers: {\n      svelte: { url: 'https://mcp.svelte.dev/mcp' },\n    },\n  },\n\n  detection: {\n    packageName: '@sveltejs/kit',\n    packageDisplayName: 'SvelteKit',\n    getVersion: (packageJson: unknown) =>\n      getPackageVersion('@sveltejs/kit', packageJson as PackageDotJson),\n    detect: async (options) => {\n      const packageJson = await tryGetPackageJson(options);\n      return packageJson\n        ? hasPackageInstalled('@sveltejs/kit', packageJson)\n        : false;\n    },\n    minimumVersion: '2.0.0',\n    detectPackageManager: detectNodePackageManagers,\n  },\n\n  environment: {\n    uploadToHosting: true,\n    getEnvVars: (apiKey: string, host: string) => ({\n      PUBLIC_POSTHOG_KEY: apiKey,\n      PUBLIC_POSTHOG_HOST: host,\n    }),\n  },\n\n  analytics: {\n    getTags: () => ({}),\n  },\n\n  prompts: {\n    projectTypeDetection:\n      'This is a JavaScript/TypeScript project using SvelteKit. Look for package.json, svelte.config.js, and lockfiles (package-lock.json, yarn.lock, pnpm-lock.yaml, bun.lockb) to confirm.',\n    getAdditionalContextLines: () => [\n      'Framework docs ID: sveltekit (use posthog://docs/frameworks/sveltekit for documentation)',\n    ],\n  },\n\n  ui: {\n    successMessage: 'PostHog integration complete',\n    estimatedDurationMinutes: 8,\n    getOutroChanges: () => [\n      'Analyzed your SvelteKit project structure',\n      'Created and configured PostHog initializers',\n      'Integrated PostHog into your application',\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/{swift → frameworks/swift}/swift-wizard-agent.d.ts

@@ -1,4 +1,4 @@
-import type { FrameworkConfig } from '../lib/framework-config';
+import type { FrameworkConfig } from '../../lib/framework-config';
 import { SwiftProjectType } from './utils';
 type SwiftContext = {
     projectType?: SwiftProjectType;

package/dist/src/{swift → frameworks/swift}/swift-wizard-agent.js

@@ -37,8 +37,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SWIFT_AGENT_CONFIG = void 0;
-const package_manager_detection_1 = require("../lib/package-manager-detection");
-const constants_1 = require("../lib/constants");
+const package_manager_detection_1 = require("../../lib/package-manager-detection");
+const constants_1 = require("../../lib/constants");
 const fast_glob_1 = __importDefault(require("fast-glob"));
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));

package/dist/src/frameworks/swift/swift-wizard-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"swift-wizard-agent.js","sourceRoot":"","sources":["../../../../src/frameworks/swift/swift-wizard-agent.ts"],"names":[],"mappings":"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","sourcesContent":["/* Swift wizard using posthog-agent with PostHog MCP */\nimport type { WizardOptions } from '../../utils/types';\nimport type { FrameworkConfig } from '../../lib/framework-config';\nimport { swiftPackageManager } from '../../lib/package-manager-detection';\nimport { Integration } from '../../lib/constants';\nimport fg from 'fast-glob';\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport {\n  detectSwiftProjectType,\n  getSwiftProjectTypeName,\n  SwiftProjectType,\n} from './utils';\n\ntype SwiftContext = {\n  projectType?: SwiftProjectType;\n};\n\nexport const SWIFT_AGENT_CONFIG: FrameworkConfig<SwiftContext> = {\n  metadata: {\n    name: 'Swift (iOS/macOS)',\n    integration: Integration.swift,\n    beta: true,\n    docsUrl: 'https://posthog.com/docs/libraries/ios',\n    preRunNotice:\n      'Please close the Xcode project before proceeding. Xcode may overwrite changes the wizard makes to project files.',\n    gatherContext: async (options: WizardOptions) => {\n      const projectType = await detectSwiftProjectType(options);\n      return { projectType };\n    },\n  },\n\n  detection: {\n    packageName: 'posthog-ios',\n    packageDisplayName: 'Swift',\n    usesPackageJson: false,\n    getVersion: () => undefined,\n    detect: async (options) => {\n      const { installDir } = options;\n\n      // Check for Xcode project\n      const xcodeProjects = await fg('*.xcodeproj', {\n        cwd: installDir,\n        onlyDirectories: true,\n      });\n\n      if (xcodeProjects.length > 0) {\n        // Verify it contains Swift source files\n        const swiftFiles = await fg('**/*.swift', {\n          cwd: installDir,\n          ignore: [\n            '**/.build/**',\n            '**/DerivedData/**',\n            '**/build/**',\n            '**/*.xcodeproj/**',\n            '**/Pods/**',\n          ],\n        });\n        if (swiftFiles.length > 0) {\n          return true;\n        }\n      }\n\n      // Check for Swift Package Manager project\n      const packageSwiftPath = path.join(installDir, 'Package.swift');\n      if (fs.existsSync(packageSwiftPath)) {\n        return true;\n      }\n\n      return false;\n    },\n    detectPackageManager: swiftPackageManager,\n  },\n\n  environment: {\n    uploadToHosting: false,\n    getEnvVars: (apiKey: string, host: string) => ({\n      POSTHOG_API_KEY: apiKey,\n      POSTHOG_HOST: host,\n    }),\n  },\n\n  analytics: {\n    getTags: (context) => ({\n      projectType: context.projectType || 'unknown',\n    }),\n  },\n\n  prompts: {\n    projectTypeDetection:\n      'This is a Swift project. Look for .xcodeproj directories, Package.swift, and .swift source files to confirm. Check for SwiftUI or UIKit imports to determine the UI framework.',\n    packageInstallation:\n      'Add the posthog-ios package via Swift Package Manager. For Xcode projects, add XCRemoteSwiftPackageReference and XCSwiftPackageProductDependency to the .pbxproj file. For Swift packages, add the dependency to Package.swift.',\n    getAdditionalContextLines: (context) => {\n      const projectTypeName = context.projectType\n        ? getSwiftProjectTypeName(context.projectType)\n        : 'unknown';\n\n      const lines = [\n        `Project type: ${projectTypeName}`,\n        `Framework docs ID: swift (use posthog://docs/frameworks/swift for documentation)`,\n      ];\n\n      return lines;\n    },\n  },\n\n  ui: {\n    successMessage: 'PostHog integration complete',\n    estimatedDurationMinutes: 5,\n    getOutroChanges: (context) => {\n      const projectTypeName = context.projectType\n        ? getSwiftProjectTypeName(context.projectType)\n        : 'Swift';\n\n      const changes = [\n        `Analyzed your ${projectTypeName} project structure`,\n        `Added the PostHog iOS SDK via Swift Package Manager`,\n        `Configured PostHog initialization in your app entry point`,\n        `Added event capture and user identification`,\n      ];\n\n      return changes;\n    },\n    getOutroNextSteps: () => [\n      'Set POSTHOG_API_KEY and POSTHOG_HOST in your Xcode scheme environment variables',\n      'Build and run your app to see PostHog in action',\n      'Visit your PostHog dashboard to see incoming events',\n    ],\n  },\n};\n"]}

package/dist/src/{swift → frameworks/swift}/utils.d.ts

@@ -1,4 +1,4 @@
-import type { WizardOptions } from '../utils/types';
+import type { WizardOptions } from '../../utils/types';
 export declare enum SwiftProjectType {
     SWIFTUI = "swiftui",
     UIKIT = "uikit",

package/dist/src/frameworks/swift/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/frameworks/swift/utils.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAWA,0DASC;AAED,wDAiDC;AAtED,0DAA2B;AAC3B,4CAA8B;AAC9B,gDAAkC;AAElC,IAAY,gBAIX;AAJD,WAAY,gBAAgB;IAC1B,uCAAmB,CAAA;IACnB,mCAAe,CAAA;IACf,+BAAW,CAAA;AACb,CAAC,EAJW,gBAAgB,gCAAhB,gBAAgB,QAI3B;AAED,SAAgB,uBAAuB,CAAC,WAA6B;IACnE,QAAQ,WAAW,EAAE,CAAC;QACpB,KAAK,gBAAgB,CAAC,OAAO;YAC3B,OAAO,SAAS,CAAC;QACnB,KAAK,gBAAgB,CAAC,KAAK;YACzB,OAAO,OAAO,CAAC;QACjB,KAAK,gBAAgB,CAAC,GAAG;YACvB,OAAO,eAAe,CAAC;IAC3B,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,sBAAsB,CAC1C,OAAsB;IAEtB,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAE/B,yEAAyE;IACzE,MAAM,eAAe,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC;IAC9E,MAAM,aAAa,GAAG,MAAM,IAAA,mBAAE,EAAC,aAAa,EAAE;QAC5C,GAAG,EAAE,UAAU;QACf,eAAe,EAAE,IAAI;KACtB,CAAC,CAAC;IAEH,IAAI,eAAe,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClD,OAAO,gBAAgB,CAAC,GAAG,CAAC;IAC9B,CAAC;IAED,wDAAwD;IACxD,MAAM,UAAU,GAAG,MAAM,IAAA,mBAAE,EAAC,YAAY,EAAE;QACxC,GAAG,EAAE,UAAU;QACf,MAAM,EAAE;YACN,cAAc;YACd,mBAAmB;YACnB,aAAa;YACb,mBAAmB;YACnB,YAAY;SACb;KACF,CAAC,CAAC;IAEH,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;YACtE,IAAI,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBACvC,UAAU,GAAG,IAAI,CAAC;YACpB,CAAC;YACD,IAAI,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;gBACrC,QAAQ,GAAG,IAAI,CAAC;YAClB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;IAED,IAAI,UAAU;QAAE,OAAO,gBAAgB,CAAC,OAAO,CAAC;IAChD,IAAI,QAAQ;QAAE,OAAO,gBAAgB,CAAC,KAAK,CAAC;IAE5C,OAAO,SAAS,CAAC;AACnB,CAAC","sourcesContent":["import type { WizardOptions } from '../../utils/types';\nimport fg from 'fast-glob';\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\n\nexport enum SwiftProjectType {\n  SWIFTUI = 'swiftui',\n  UIKIT = 'uikit',\n  SPM = 'spm',\n}\n\nexport function getSwiftProjectTypeName(projectType: SwiftProjectType): string {\n  switch (projectType) {\n    case SwiftProjectType.SWIFTUI:\n      return 'SwiftUI';\n    case SwiftProjectType.UIKIT:\n      return 'UIKit';\n    case SwiftProjectType.SPM:\n      return 'Swift Package';\n  }\n}\n\nexport async function detectSwiftProjectType(\n  options: WizardOptions,\n): Promise<SwiftProjectType | undefined> {\n  const { installDir } = options;\n\n  // Check if this is a pure SPM package (Package.swift without .xcodeproj)\n  const hasPackageSwift = fs.existsSync(path.join(installDir, 'Package.swift'));\n  const xcodeProjects = await fg('*.xcodeproj', {\n    cwd: installDir,\n    onlyDirectories: true,\n  });\n\n  if (hasPackageSwift && xcodeProjects.length === 0) {\n    return SwiftProjectType.SPM;\n  }\n\n  // Check Swift source files for SwiftUI vs UIKit imports\n  const swiftFiles = await fg('**/*.swift', {\n    cwd: installDir,\n    ignore: [\n      '**/.build/**',\n      '**/DerivedData/**',\n      '**/build/**',\n      '**/*.xcodeproj/**',\n      '**/Pods/**',\n    ],\n  });\n\n  let hasSwiftUI = false;\n  let hasUIKit = false;\n\n  for (const file of swiftFiles) {\n    try {\n      const content = fs.readFileSync(path.join(installDir, file), 'utf-8');\n      if (content.includes('import SwiftUI')) {\n        hasSwiftUI = true;\n      }\n      if (content.includes('import UIKit')) {\n        hasUIKit = true;\n      }\n    } catch {\n      continue;\n    }\n  }\n\n  if (hasSwiftUI) return SwiftProjectType.SWIFTUI;\n  if (hasUIKit) return SwiftProjectType.UIKIT;\n\n  return undefined;\n}\n"]}

package/dist/src/{tanstack-router → frameworks/tanstack-router}/tanstack-router-wizard-agent.d.ts

@@ -1,4 +1,4 @@
-import type { FrameworkConfig } from '../lib/framework-config';
+import type { FrameworkConfig } from '../../lib/framework-config';
 import { TanStackRouterMode } from './utils';
 type TanStackRouterContext = {
     routerMode?: TanStackRouterMode;

package/dist/src/{tanstack-router → frameworks/tanstack-router}/tanstack-router-wizard-agent.js

@@ -1,10 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TANSTACK_ROUTER_AGENT_CONFIG = void 0;
-const package_manager_detection_1 = require("../lib/package-manager-detection");
-const constants_1 = require("../lib/constants");
-const package_json_1 = require("../utils/package-json");
-const clack_utils_1 = require("../utils/clack-utils");
+const package_manager_detection_1 = require("../../lib/package-manager-detection");
+const constants_1 = require("../../lib/constants");
+const package_json_1 = require("../../utils/package-json");
+const setup_utils_1 = require("../../utils/setup-utils");
+const ui_1 = require("../../ui");
 const utils_1 = require("./utils");
 exports.TANSTACK_ROUTER_AGENT_CONFIG = {
     metadata: {
@@ -13,7 +14,11 @@ exports.TANSTACK_ROUTER_AGENT_CONFIG = {
         docsUrl: 'https://posthog.com/docs/libraries/react',
         gatherContext: async (options) => {
             const routerMode = await (0, utils_1.getTanStackRouterMode)(options);
-            return { routerMode };
+            if (routerMode) {
+                (0, ui_1.getUI)().setDetectedFramework(`TanStack Router ${(0, utils_1.getTanStackRouterModeName)(routerMode)}`);
+                return { routerMode };
+            }
+            return {};
         },
     },
     detection: {
@@ -23,11 +28,13 @@ exports.TANSTACK_ROUTER_AGENT_CONFIG = {
         getVersionBucket: utils_1.getTanStackRouterVersionBucket,
         minimumVersion: '1.0.0',
         getInstalledVersion: async (options) => {
-            const packageJson = await (0, clack_utils_1.getPackageDotJson)(options);
-            return (0, package_json_1.getPackageVersion)('@tanstack/react-router', packageJson);
+            const packageJson = await (0, setup_utils_1.tryGetPackageJson)(options);
+            return packageJson
+                ? (0, package_json_1.getPackageVersion)('@tanstack/react-router', packageJson)
+                : undefined;
         },
         detect: async (options) => {
-            const packageJson = await (0, clack_utils_1.tryGetPackageJson)(options);
+            const packageJson = await (0, setup_utils_1.tryGetPackageJson)(options);
             if (!packageJson) {
                 return false;
             }

package/dist/src/frameworks/tanstack-router/tanstack-router-wizard-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tanstack-router-wizard-agent.js","sourceRoot":"","sources":["../../../../src/frameworks/tanstack-router/tanstack-router-wizard-agent.ts"],"names":[],"mappings":"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","sourcesContent":["/* TanStack Router wizard using posthog-agent with PostHog MCP */\nimport type { WizardOptions } from '../../utils/types';\nimport type { FrameworkConfig } from '../../lib/framework-config';\nimport { detectNodePackageManagers } from '../../lib/package-manager-detection';\nimport { Integration } from '../../lib/constants';\nimport {\n  getPackageVersion,\n  hasPackageInstalled,\n  type PackageDotJson,\n} from '../../utils/package-json';\nimport { tryGetPackageJson } from '../../utils/setup-utils';\nimport { getUI } from '../../ui';\nimport {\n  getTanStackRouterMode,\n  getTanStackRouterModeName,\n  getTanStackRouterVersionBucket,\n  TanStackRouterMode,\n} from './utils';\n\ntype TanStackRouterContext = {\n  routerMode?: TanStackRouterMode;\n};\n\nexport const TANSTACK_ROUTER_AGENT_CONFIG: FrameworkConfig<TanStackRouterContext> =\n  {\n    metadata: {\n      name: 'React (TanStack Router)',\n      integration: Integration.tanstackRouter,\n      docsUrl: 'https://posthog.com/docs/libraries/react',\n      gatherContext: async (options: WizardOptions) => {\n        const routerMode = await getTanStackRouterMode(options);\n        if (routerMode) {\n          getUI().setDetectedFramework(\n            `TanStack Router ${getTanStackRouterModeName(routerMode)}`,\n          );\n          return { routerMode };\n        }\n        return {};\n      },\n    },\n\n    detection: {\n      packageName: '@tanstack/react-router',\n      packageDisplayName: 'TanStack Router',\n      getVersion: (packageJson: unknown) =>\n        getPackageVersion(\n          '@tanstack/react-router',\n          packageJson as PackageDotJson,\n        ),\n      getVersionBucket: getTanStackRouterVersionBucket,\n      minimumVersion: '1.0.0',\n      getInstalledVersion: async (options: WizardOptions) => {\n        const packageJson = await tryGetPackageJson(options);\n        return packageJson\n          ? getPackageVersion('@tanstack/react-router', packageJson)\n          : undefined;\n      },\n      detect: async (options) => {\n        const packageJson = await tryGetPackageJson(options);\n        if (!packageJson) {\n          return false;\n        }\n        // Exclude TanStack Start projects (they have their own integration)\n        if (hasPackageInstalled('@tanstack/react-start', packageJson)) {\n          return false;\n        }\n        return hasPackageInstalled('@tanstack/react-router', packageJson);\n      },\n      detectPackageManager: detectNodePackageManagers,\n    },\n\n    environment: {\n      uploadToHosting: false,\n      getEnvVars: (apiKey: string, host: string) => ({\n        VITE_PUBLIC_POSTHOG_KEY: apiKey,\n        VITE_PUBLIC_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      getAdditionalContextLines: (context) => {\n        const routerMode = context.routerMode;\n        const modeName = routerMode\n          ? getTanStackRouterModeName(routerMode)\n          : 'unknown';\n\n        // Map router mode to framework ID for MCP docs resource\n        const frameworkIdMap: Record<TanStackRouterMode, string> = {\n          [TanStackRouterMode.FILE_BASED]: 'react-tanstack-router-file-based',\n          [TanStackRouterMode.CODE_BASED]: 'react-tanstack-router-code-based',\n        };\n\n        const frameworkId = routerMode\n          ? frameworkIdMap[routerMode]\n          : 'react-tanstack-router-file-based';\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          ? getTanStackRouterModeName(context.routerMode)\n          : 'TanStack Router';\n        return [\n          `Analyzed your React (TanStack 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/frameworks/tanstack-router/utils.d.ts

@@ -0,0 +1,11 @@
+import type { WizardOptions } from '../../utils/types';
+export declare enum TanStackRouterMode {
+    FILE_BASED = "file-based",
+    CODE_BASED = "code-based"
+}
+export declare const getTanStackRouterVersionBucket: (version: string | undefined) => string;
+/**
+ * Detect TanStack Router mode. Pure — returns null if ambiguous.
+ */
+export declare function getTanStackRouterMode(options: WizardOptions): Promise<TanStackRouterMode | null>;
+export declare function getTanStackRouterModeName(mode: TanStackRouterMode): string;