@posthog/wizard 1.36.0 → 2.0.0

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

@@ -1,11 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NUXT_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 semver_1 = require("../utils/semver");
+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 semver_1 = require("../../utils/semver");
 const getNuxtVersionBucket = (0, semver_1.createVersionBucket)();
 exports.NUXT_AGENT_CONFIG = {
     metadata: {
@@ -14,7 +14,9 @@ exports.NUXT_AGENT_CONFIG = {
         docsUrl: 'https://posthog.com/docs/libraries/nuxt',
         beta: true,
         gatherContext: async (options) => {
-            const packageJson = await (0, clack_utils_1.getPackageDotJson)(options);
+            const packageJson = await (0, setup_utils_1.tryGetPackageJson)(options);
+            if (!packageJson)
+                return {};
             const version = (0, package_json_1.getPackageVersion)('nuxt', packageJson);
             const versionBucket = getNuxtVersionBucket(version);
             return { versionBucket };
@@ -26,11 +28,11 @@ exports.NUXT_AGENT_CONFIG = {
         getVersion: (packageJson) => (0, package_json_1.getPackageVersion)('nuxt', packageJson),
         getVersionBucket: getNuxtVersionBucket,
         getInstalledVersion: async (options) => {
-            const packageJson = await (0, clack_utils_1.getPackageDotJson)(options);
-            return (0, package_json_1.getPackageVersion)('nuxt', packageJson);
+            const packageJson = await (0, setup_utils_1.tryGetPackageJson)(options);
+            return packageJson ? (0, package_json_1.getPackageVersion)('nuxt', 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)('nuxt', packageJson) : false;
         },
         detectPackageManager: package_manager_detection_1.detectNodePackageManagers,

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

@@ -0,0 +1 @@
+{"version":3,"file":"nuxt-wizard-agent.js","sourceRoot":"","sources":["../../../../src/frameworks/nuxt/nuxt-wizard-agent.ts"],"names":[],"mappings":"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","sourcesContent":["/* Nuxt 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 { createVersionBucket } from '../../utils/semver';\n\nconst getNuxtVersionBucket = createVersionBucket();\n\ntype NuxtContext = {\n  versionBucket?: string;\n};\n\nexport const NUXT_AGENT_CONFIG: FrameworkConfig<NuxtContext> = {\n  metadata: {\n    name: 'Nuxt',\n    integration: Integration.nuxt,\n    docsUrl: 'https://posthog.com/docs/libraries/nuxt',\n    beta: true,\n    gatherContext: async (options: WizardOptions) => {\n      const packageJson = await tryGetPackageJson(options);\n      if (!packageJson) return {};\n      const version = getPackageVersion('nuxt', packageJson);\n      const versionBucket = getNuxtVersionBucket(version);\n      return { versionBucket };\n    },\n  },\n\n  detection: {\n    packageName: 'nuxt',\n    packageDisplayName: 'Nuxt',\n    getVersion: (packageJson: unknown) =>\n      getPackageVersion('nuxt', packageJson as PackageDotJson),\n    getVersionBucket: getNuxtVersionBucket,\n    getInstalledVersion: async (options: WizardOptions) => {\n      const packageJson = await tryGetPackageJson(options);\n      return packageJson ? getPackageVersion('nuxt', packageJson) : undefined;\n    },\n    detect: async (options) => {\n      const packageJson = await tryGetPackageJson(options);\n      return packageJson ? hasPackageInstalled('nuxt', packageJson) : false;\n    },\n    detectPackageManager: detectNodePackageManagers,\n  },\n\n  environment: {\n    uploadToHosting: true,\n    getEnvVars: (apiKey: string, host: string) => ({\n      NUXT_PUBLIC_POSTHOG_KEY: apiKey,\n      NUXT_PUBLIC_POSTHOG_HOST: host,\n    }),\n  },\n\n  analytics: {\n    getTags: (context) => ({\n      ...(context.versionBucket\n        ? { versionBucket: context.versionBucket }\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    getAdditionalContextLines: (context) => {\n      const lines: string[] = [];\n      if (context.versionBucket) {\n        lines.push(`Nuxt version: ${context.versionBucket}`);\n      }\n      const frameworkId = 'nuxt';\n      lines.push(\n        `Framework docs ID: ${frameworkId} (use posthog://docs/frameworks/${frameworkId} for documentation)`,\n      );\n      return lines;\n    },\n  },\n\n  ui: {\n    successMessage: 'PostHog integration complete',\n    estimatedDurationMinutes: 5,\n    getOutroChanges: () => [\n      'Analyzed your Nuxt project structure',\n      'Configured PostHog module/plugin',\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/{python → frameworks/python}/python-wizard-agent.d.ts

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

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

@@ -37,9 +37,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PYTHON_AGENT_CONFIG = void 0;
-const framework_config_1 = require("../lib/framework-config");
-const package_manager_detection_1 = require("../lib/package-manager-detection");
-const constants_1 = require("../lib/constants");
+const framework_config_1 = require("../../lib/framework-config");
+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/python/python-wizard-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"python-wizard-agent.js","sourceRoot":"","sources":["../../../../src/frameworks/python/python-wizard-agent.ts"],"names":[],"mappings":"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","sourcesContent":["/* Generic Python language wizard using posthog-agent with PostHog MCP */\nimport type { WizardOptions } from '../../utils/types';\nimport type { FrameworkConfig } from '../../lib/framework-config';\nimport { PYTHON_PACKAGE_INSTALLATION } from '../../lib/framework-config';\nimport { detectPythonPackageManagers } 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  getPythonVersion,\n  getPythonVersionBucket,\n  detectPackageManager,\n  getPackageManagerName,\n  PythonPackageManager,\n} from './utils';\n\ntype PythonContext = {\n  packageManager?: PythonPackageManager;\n};\n\nexport const PYTHON_AGENT_CONFIG: FrameworkConfig<PythonContext> = {\n  metadata: {\n    name: 'Python Language',\n    integration: Integration.python,\n    beta: true,\n    docsUrl: 'https://posthog.com/docs/libraries/python',\n    gatherContext: async (options: WizardOptions) => {\n      const packageManager = await detectPackageManager(options);\n      return { packageManager };\n    },\n  },\n\n  detection: {\n    packageName: 'python',\n    packageDisplayName: 'Python',\n    usesPackageJson: false,\n    getVersion: () => undefined,\n    getVersionBucket: getPythonVersionBucket,\n    minimumVersion: '3.8.0',\n    getInstalledVersion: (options: WizardOptions) =>\n      Promise.resolve(getPythonVersion(options)),\n    detect: async (options) => {\n      const { installDir } = options;\n\n      // Look for Python package management files\n      const pythonConfigFiles = await fg(\n        [\n          '**/requirements*.txt',\n          '**/pyproject.toml',\n          '**/setup.py',\n          '**/Pipfile',\n        ],\n        {\n          cwd: installDir,\n          ignore: ['**/venv/**', '**/.venv/**', '**/env/**', '**/.env/**'],\n        },\n      );\n\n      if (pythonConfigFiles.length === 0) {\n        return false;\n      }\n\n      // Make sure this isn't Django or Flask (those should be detected first)\n      // Check for Django\n      const managePyMatches = await fg('**/manage.py', {\n        cwd: installDir,\n        ignore: ['**/venv/**', '**/.venv/**', '**/env/**', '**/.env/**'],\n      });\n\n      for (const match of managePyMatches) {\n        try {\n          const content = fs.readFileSync(\n            path.join(installDir, match),\n            'utf-8',\n          );\n          if (\n            content.includes('django') ||\n            content.includes('DJANGO_SETTINGS_MODULE')\n          ) {\n            return false; // Django detected, use django agent instead\n          }\n        } catch {\n          continue;\n        }\n      }\n\n      // Check for Flask\n      for (const configFile of pythonConfigFiles) {\n        try {\n          const content = fs.readFileSync(\n            path.join(installDir, configFile),\n            'utf-8',\n          );\n          if (\n            /^flask([<>=~!]|$|\\s)/im.test(content) ||\n            /[\"']flask[\"']/i.test(content)\n          ) {\n            return false; // Flask detected, use flask agent instead\n          }\n        } catch {\n          continue;\n        }\n      }\n\n      const pyFiles = await fg(\n        ['**/app.py', '**/wsgi.py', '**/application.py', '**/__init__.py'],\n        {\n          cwd: installDir,\n          ignore: [\n            '**/venv/**',\n            '**/.venv/**',\n            '**/env/**',\n            '**/.env/**',\n            '**/__pycache__/**',\n          ],\n        },\n      );\n\n      for (const pyFile of pyFiles) {\n        try {\n          const content = fs.readFileSync(\n            path.join(installDir, pyFile),\n            'utf-8',\n          );\n          if (\n            content.includes('from flask import') ||\n            content.includes('import flask') ||\n            /Flask\\s*\\(/.test(content)\n          ) {\n            return false; // Flask detected, use flask agent instead\n          }\n        } catch {\n          continue;\n        }\n      }\n\n      // If we have Python config files but it's not Django or Flask, it's a generic Python project\n      return true;\n    },\n    detectPackageManager: detectPythonPackageManagers,\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    packageInstallation: PYTHON_PACKAGE_INSTALLATION,\n    projectTypeDetection:\n      'This is a generic Python project. Look for requirements.txt, pyproject.toml, setup.py, or Pipfile to confirm.',\n    getAdditionalContextLines: (context) => {\n      const packageManagerName = context.packageManager\n        ? getPackageManagerName(context.packageManager)\n        : 'unknown';\n\n      return [\n        `Package manager: ${packageManagerName}`,\n        `Framework docs ID: python (use posthog://docs/frameworks/python for documentation)`,\n        `Project type: Generic Python application (CLI, script, worker, data pipeline, etc.)`,\n      ];\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 Python project structure`,\n        `Installed the PostHog Python package using ${packageManagerName}`,\n        `Created PostHog initialization using instance-based API (Posthog class)`,\n        `Configured exception autocapture and graceful shutdown`,\n        `Added example code for events, feature flags, and error capture (without PII)`,\n      ];\n    },\n    getOutroNextSteps: () => [\n      'Use Posthog() class (not module-level posthog) with enable_exception_autocapture=True',\n      'Call posthog_client.shutdown() on application exit (use atexit.register)',\n      'NEVER send PII in event properties (no emails, names, or user content)',\n      'Use posthog_client.capture() for events and posthog_client.identify() for users',\n      'Visit your PostHog dashboard to see incoming events',\n    ],\n  },\n};\n"]}

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

@@ -1,4 +1,4 @@
-import type { WizardOptions } from '../utils/types';
+import type { WizardOptions } from '../../utils/types';
 export declare enum PythonPackageManager {
     UV = "uv",
     POETRY = "poetry",

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/frameworks/python/utils.ts"],"names":[],"mappings":";;;AAkBA,4CAYC;AAKD,wDAGC;AAKD,oDAiGC;AAKD,sDAuBC;AAxKD,2DAA8C;AAG9C,IAAY,oBAUX;AAVD,WAAY,oBAAoB;IAC9B,iCAAS,CAAA;IACT,yCAAiB,CAAA;IACjB,mCAAW,CAAA;IACX,uCAAe,CAAA;IACf,mCAAW,CAAA;IACX,yCAAiB,CAAA;IACjB,uCAAe,CAAA;IACf,mCAAW,CAAA;IACX,2CAAmB,CAAA;AACrB,CAAC,EAVW,oBAAoB,oCAApB,oBAAoB,QAU/B;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,OAAsB;IACrD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAA,6BAAQ,EAAC,uCAAuC,EAAE;YAChE,GAAG,EAAE,OAAO,CAAC,UAAU;YACvB,QAAQ,EAAE,OAAO;SAClB,CAAC;aACC,IAAI,EAAE;aACN,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAC1B,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAgB,sBAAsB,CAAC,OAAe;IACpD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAC3C,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AACpC,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,oBAAoB,CACxC,OAAsB;IAEtB,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAC/B,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;IAEvC,yBAAyB;IACzB,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC;QACpD,OAAO,oBAAoB,CAAC,EAAE,CAAC;IACjC,CAAC;IAED,yCAAyC;IACzC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC;QAC3D,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAC7B,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,EACvC,OAAO,CACR,CAAC;YAEF,mBAAmB;YACnB,IAAI,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;gBACtC,OAAO,oBAAoB,CAAC,MAAM,CAAC;YACrC,CAAC;YAED,gBAAgB;YAChB,IAAI,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;gBACnC,OAAO,oBAAoB,CAAC,GAAG,CAAC;YAClC,CAAC;YAED,kBAAkB;YAClB,IAAI,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;gBACrC,OAAO,oBAAoB,CAAC,KAAK,CAAC;YACpC,CAAC;YAED,gBAAgB;YAChB,IAAI,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;gBACnC,OAAO,oBAAoB,CAAC,GAAG,CAAC;YAClC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,oBAAoB;QACtB,CAAC;IACH,CAAC;IAED,6BAA6B;IAC7B,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC;QACxD,OAAO,oBAAoB,CAAC,MAAM,CAAC;IACrC,CAAC;IAED,0BAA0B;IAC1B,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC;QACrD,OAAO,oBAAoB,CAAC,GAAG,CAAC;IAClC,CAAC;IAED,6CAA6C;IAC7C,IACE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QAC/C,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC,EACpD,CAAC;QACD,OAAO,oBAAoB,CAAC,MAAM,CAAC;IACrC,CAAC;IAED,wDAAwD;IACxD,IACE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;QACvD,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC,EACxD,CAAC;QACD,OAAO,oBAAoB,CAAC,KAAK,CAAC;IACpC,CAAC;IAED,2EAA2E;IAC3E,IACE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,kBAAkB,CAAC,CAAC;QACxD,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;QAChD,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QACjD,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC,EACtD,CAAC;QACD,OAAO,oBAAoB,CAAC,GAAG,CAAC;IAClC,CAAC;IAED,mCAAmC;IACnC,IAAI,CAAC;QACH,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;QAC9D,IACE,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC;YAC9B,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,WAAW,EAAE,EAC1C,CAAC;YACD,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;YAC9C,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;gBAC1C,OAAO,oBAAoB,CAAC,GAAG,CAAC;YAClC,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,WAAW;IACb,CAAC;IAED,OAAO,oBAAoB,CAAC,OAAO,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CACnC,cAAoC;IAEpC,QAAQ,cAAc,EAAE,CAAC;QACvB,KAAK,oBAAoB,CAAC,EAAE;YAC1B,OAAO,IAAI,CAAC;QACd,KAAK,oBAAoB,CAAC,MAAM;YAC9B,OAAO,QAAQ,CAAC;QAClB,KAAK,oBAAoB,CAAC,GAAG;YAC3B,OAAO,KAAK,CAAC;QACf,KAAK,oBAAoB,CAAC,KAAK;YAC7B,OAAO,OAAO,CAAC;QACjB,KAAK,oBAAoB,CAAC,GAAG;YAC3B,OAAO,KAAK,CAAC;QACf,KAAK,oBAAoB,CAAC,MAAM;YAC9B,OAAO,QAAQ,CAAC;QAClB,KAAK,oBAAoB,CAAC,KAAK;YAC7B,OAAO,OAAO,CAAC;QACjB,KAAK,oBAAoB,CAAC,GAAG;YAC3B,OAAO,KAAK,CAAC;QACf,KAAK,oBAAoB,CAAC,OAAO;YAC/B,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC","sourcesContent":["import { execSync } from 'node:child_process';\nimport type { WizardOptions } from '../../utils/types';\n\nexport enum PythonPackageManager {\n  UV = 'uv',\n  POETRY = 'poetry',\n  PDM = 'pdm',\n  HATCH = 'hatch',\n  RYE = 'rye',\n  PIPENV = 'pipenv',\n  CONDA = 'conda',\n  PIP = 'pip',\n  UNKNOWN = 'unknown',\n}\n\n/**\n * Get the installed Python version\n */\nexport function getPythonVersion(options: WizardOptions): string | undefined {\n  try {\n    const version = execSync('python --version || python3 --version', {\n      cwd: options.installDir,\n      encoding: 'utf-8',\n    })\n      .trim()\n      .replace('Python ', '');\n    return version;\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Bucket Python version for analytics (e.g., \"3.11.x\" -> \"3.11\")\n */\nexport function getPythonVersionBucket(version: string): string {\n  const match = version.match(/^(\\d+\\.\\d+)/);\n  return match ? match[1] : version;\n}\n\n/**\n * Detect which package manager the project uses\n */\nexport async function detectPackageManager(\n  options: WizardOptions,\n): Promise<PythonPackageManager> {\n  const { installDir } = options;\n  const fs = await import('node:fs');\n  const path = await import('node:path');\n\n  // Check for uv (uv.lock)\n  if (fs.existsSync(path.join(installDir, 'uv.lock'))) {\n    return PythonPackageManager.UV;\n  }\n\n  // Check pyproject.toml for various tools\n  if (fs.existsSync(path.join(installDir, 'pyproject.toml'))) {\n    try {\n      const content = fs.readFileSync(\n        path.join(installDir, 'pyproject.toml'),\n        'utf-8',\n      );\n\n      // Check for Poetry\n      if (content.includes('[tool.poetry]')) {\n        return PythonPackageManager.POETRY;\n      }\n\n      // Check for PDM\n      if (content.includes('[tool.pdm]')) {\n        return PythonPackageManager.PDM;\n      }\n\n      // Check for Hatch\n      if (content.includes('[tool.hatch]')) {\n        return PythonPackageManager.HATCH;\n      }\n\n      // Check for Rye\n      if (content.includes('[tool.rye]')) {\n        return PythonPackageManager.RYE;\n      }\n    } catch {\n      // Continue checking\n    }\n  }\n\n  // Check for Poetry lock file\n  if (fs.existsSync(path.join(installDir, 'poetry.lock'))) {\n    return PythonPackageManager.POETRY;\n  }\n\n  // Check for PDM lock file\n  if (fs.existsSync(path.join(installDir, 'pdm.lock'))) {\n    return PythonPackageManager.PDM;\n  }\n\n  // Check for Pipenv (Pipfile or Pipfile.lock)\n  if (\n    fs.existsSync(path.join(installDir, 'Pipfile')) ||\n    fs.existsSync(path.join(installDir, 'Pipfile.lock'))\n  ) {\n    return PythonPackageManager.PIPENV;\n  }\n\n  // Check for Conda (environment.yml or environment.yaml)\n  if (\n    fs.existsSync(path.join(installDir, 'environment.yml')) ||\n    fs.existsSync(path.join(installDir, 'environment.yaml'))\n  ) {\n    return PythonPackageManager.CONDA;\n  }\n\n  // Check for pip (requirements.txt, setup.py, setup.cfg, or pyproject.toml)\n  if (\n    fs.existsSync(path.join(installDir, 'requirements.txt')) ||\n    fs.existsSync(path.join(installDir, 'setup.py')) ||\n    fs.existsSync(path.join(installDir, 'setup.cfg')) ||\n    fs.existsSync(path.join(installDir, 'pyproject.toml'))\n  ) {\n    return PythonPackageManager.PIP;\n  }\n\n  // Check for requirements directory\n  try {\n    const requirementsDir = path.join(installDir, 'requirements');\n    if (\n      fs.existsSync(requirementsDir) &&\n      fs.statSync(requirementsDir).isDirectory()\n    ) {\n      const files = fs.readdirSync(requirementsDir);\n      if (files.some((f) => f.endsWith('.txt'))) {\n        return PythonPackageManager.PIP;\n      }\n    }\n  } catch {\n    // Continue\n  }\n\n  return PythonPackageManager.UNKNOWN;\n}\n\n/**\n * Get package manager display name\n */\nexport function getPackageManagerName(\n  packageManager: PythonPackageManager,\n): string {\n  switch (packageManager) {\n    case PythonPackageManager.UV:\n      return 'uv';\n    case PythonPackageManager.POETRY:\n      return 'Poetry';\n    case PythonPackageManager.PDM:\n      return 'PDM';\n    case PythonPackageManager.HATCH:\n      return 'Hatch';\n    case PythonPackageManager.RYE:\n      return 'Rye';\n    case PythonPackageManager.PIPENV:\n      return 'Pipenv';\n    case PythonPackageManager.CONDA:\n      return 'Conda';\n    case PythonPackageManager.PIP:\n      return 'pip';\n    case PythonPackageManager.UNKNOWN:\n      return 'unknown';\n  }\n}\n"]}

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

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

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

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RAILS_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.RAILS_AGENT_CONFIG = {
     metadata: {

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

@@ -0,0 +1 @@
+{"version":3,"file":"rails-wizard-agent.js","sourceRoot":"","sources":["../../../../src/frameworks/rails/rails-wizard-agent.ts"],"names":[],"mappings":"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","sourcesContent":["/* Ruby on Rails 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  getRailsVersion,\n  getRailsProjectType,\n  getRailsProjectTypeName,\n  getRailsVersionBucket,\n  RailsProjectType,\n  findInitializersDir,\n  isRailsProject,\n} from './utils';\n\ntype RailsContext = {\n  projectType?: RailsProjectType;\n  initializersDir?: string;\n};\n\nexport const RAILS_AGENT_CONFIG: FrameworkConfig<RailsContext> = {\n  metadata: {\n    name: 'Ruby on Rails',\n    integration: Integration.rails,\n    beta: true,\n    docsUrl: 'https://posthog.com/docs/libraries/ruby-on-rails',\n    unsupportedVersionDocsUrl: 'https://posthog.com/docs/libraries/ruby',\n    gatherContext: (options: WizardOptions) => {\n      const projectType = getRailsProjectType(options);\n      const initializersDir = findInitializersDir(options);\n      return Promise.resolve({ projectType, initializersDir });\n    },\n  },\n\n  detection: {\n    packageName: 'rails',\n    packageDisplayName: 'Ruby on Rails',\n    usesPackageJson: false,\n    getVersion: () => undefined,\n    getVersionBucket: getRailsVersionBucket,\n    minimumVersion: '6.0.0',\n    getInstalledVersion: (options: WizardOptions) =>\n      Promise.resolve(getRailsVersion(options)),\n    detect: async (options) => isRailsProject(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      projectType: context.projectType || 'unknown',\n    }),\n  },\n\n  prompts: {\n    projectTypeDetection:\n      'This is a Ruby on Rails project. Look for Gemfile, config/application.rb, bin/rails, and config/routes.rb to confirm.',\n    packageInstallation:\n      \"Use Bundler to install gems. Add `gem 'posthog-ruby'` and `gem 'posthog-rails'` to the Gemfile and run `bundle install`. Do not pin specific versions.\",\n    getAdditionalContextLines: (context) => {\n      const projectTypeName = context.projectType\n        ? getRailsProjectTypeName(context.projectType)\n        : 'unknown';\n\n      const lines = [\n        `Project type: ${projectTypeName}`,\n        `Framework docs ID: ruby-on-rails (use posthog://docs/frameworks/ruby-on-rails for documentation)`,\n      ];\n\n      if (context.initializersDir) {\n        lines.push(`Initializers directory: ${context.initializersDir}`);\n      }\n\n      if (context.projectType === RailsProjectType.API) {\n        lines.push(\n          'Note: This is an API-only Rails app — skip frontend posthog-js integration',\n        );\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        ? getRailsProjectTypeName(context.projectType)\n        : 'Rails';\n\n      const changes = [\n        `Analyzed your ${projectTypeName} project structure`,\n        `Installed the posthog-ruby and posthog-rails gems via Bundler`,\n        `Created PostHog initializer in config/initializers/posthog.rb`,\n        `Configured automatic exception capture and ActiveJob instrumentation`,\n      ];\n\n      if (context.projectType !== RailsProjectType.API) {\n        changes.push(\n          'Added posthog-js snippet to the layout template for frontend tracking',\n        );\n      }\n\n      return changes;\n    },\n    getOutroNextSteps: () => [\n      'Start your Rails development server with `bin/rails server`',\n      'Visit your PostHog dashboard to see incoming events',\n      'Use PostHog.capture() to track custom events',\n      'Use PostHog.identify() to associate events with users',\n      'Define posthog_distinct_id on your User model for automatic user association',\n    ],\n  },\n};\n"]}

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

@@ -1,4 +1,4 @@
-import type { WizardOptions } from '../utils/types';
+import type { WizardOptions } from '../../utils/types';
 export declare enum RailsProjectType {
     STANDARD = "standard",// Traditional Rails app (rails new)
     API = "api"

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

@@ -45,8 +45,8 @@ exports.getRailsProjectTypeName = getRailsProjectTypeName;
 exports.findInitializersDir = findInitializersDir;
 exports.isRailsProject = isRailsProject;
 const fast_glob_1 = __importDefault(require("fast-glob"));
-const clack_1 = __importDefault(require("../utils/clack"));
-const semver_1 = require("../utils/semver");
+const ui_1 = require("../../ui");
+const semver_1 = require("../../utils/semver");
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
 var RailsProjectType;
@@ -118,7 +118,7 @@ function getRailsProjectType(options) {
         try {
             const content = fs.readFileSync(appConfigPath, 'utf-8');
             if (content.includes('config.api_only = true')) {
-                clack_1.default.log.info('Detected Rails API-only project');
+                (0, ui_1.getUI)().setDetectedFramework('Rails API-only');
                 return RailsProjectType.API;
             }
         }
@@ -126,7 +126,7 @@ function getRailsProjectType(options) {
             // Continue to default
         }
     }
-    clack_1.default.log.info('Detected standard Rails project');
+    (0, ui_1.getUI)().setDetectedFramework('Rails');
     return RailsProjectType.STANDARD;
 }
 /**

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/frameworks/rails/utils.ts"],"names":[],"mappings":"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","sourcesContent":["import fg from 'fast-glob';\nimport { getUI } from '../../ui';\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 RailsProjectType {\n  STANDARD = 'standard', // Traditional Rails app (rails new)\n  API = 'api', // Rails API-only (rails new --api)\n}\n\nconst IGNORE_PATTERNS = [\n  '**/node_modules/**',\n  '**/vendor/**',\n  '**/vendor/bundle/**',\n  '**/tmp/**',\n  '**/log/**',\n  '**/storage/**',\n];\n\n/**\n * Get Rails version bucket for analytics\n */\nexport const getRailsVersionBucket = createVersionBucket();\n\n/**\n * Read and parse Gemfile contents\n */\nfunction readGemfile(\n  options: Pick<WizardOptions, 'installDir'>,\n): string | undefined {\n  const { installDir } = options;\n\n  const gemfilePath = path.join(installDir, 'Gemfile');\n  try {\n    return fs.readFileSync(gemfilePath, 'utf-8');\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Check if a gem is present in the Gemfile\n */\nexport function hasGem(\n  gemName: string,\n  options: Pick<WizardOptions, 'installDir'>,\n): boolean {\n  const content = readGemfile(options);\n  if (!content) return false;\n\n  // Match gem declarations like: gem 'rails', gem \"rails\", gem 'rails', '~> 7.0'\n  const gemPattern = new RegExp(`^\\\\s*gem\\\\s+['\"]${gemName}['\"]`, 'im');\n  return gemPattern.test(content);\n}\n\n/**\n * Extract version for a gem from Gemfile\n */\nexport function getGemVersion(\n  gemName: string,\n  options: Pick<WizardOptions, 'installDir'>,\n): string | undefined {\n  const content = readGemfile(options);\n  if (!content) return undefined;\n\n  const versionPattern = new RegExp(\n    `^\\\\s*gem\\\\s+['\"]${gemName}['\"]\\\\s*,\\\\s*['\"][^0-9]*([0-9]+\\\\.[0-9]+(?:\\\\.[0-9]+)?)['\"]`,\n    'im',\n  );\n  const match = content.match(versionPattern);\n  return match?.[1];\n}\n\n/**\n * Get Rails version from Gemfile\n */\nexport function getRailsVersion(\n  options: Pick<WizardOptions, 'installDir'>,\n): string | undefined {\n  return getGemVersion('rails', options);\n}\n\n/**\n * Detect Rails project type\n */\nexport function getRailsProjectType(options: WizardOptions): RailsProjectType {\n  const { installDir } = options;\n\n  // Check for API-only mode in config/application.rb\n  const appConfigPath = path.join(installDir, 'config/application.rb');\n  if (fs.existsSync(appConfigPath)) {\n    try {\n      const content = fs.readFileSync(appConfigPath, 'utf-8');\n      if (content.includes('config.api_only = true')) {\n        getUI().setDetectedFramework('Rails API-only');\n        return RailsProjectType.API;\n      }\n    } catch {\n      // Continue to default\n    }\n  }\n\n  getUI().setDetectedFramework('Rails');\n  return RailsProjectType.STANDARD;\n}\n\n/**\n * Get human-readable name for Rails project type\n */\nexport function getRailsProjectTypeName(projectType: RailsProjectType): string {\n  switch (projectType) {\n    case RailsProjectType.STANDARD:\n      return 'Standard Rails';\n    case RailsProjectType.API:\n      return 'Rails API';\n  }\n}\n\n/**\n * Find the Rails initializers directory\n */\nexport function findInitializersDir(\n  options: Pick<WizardOptions, 'installDir'>,\n): string | undefined {\n  const { installDir } = options;\n\n  const initializersDir = path.join(installDir, 'config/initializers');\n  if (fs.existsSync(initializersDir)) {\n    return 'config/initializers';\n  }\n\n  return undefined;\n}\n\n/**\n * Detect if the project is a Rails project by looking for typical Rails files\n */\nexport async function isRailsProject(\n  options: Pick<WizardOptions, 'installDir'>,\n): Promise<boolean> {\n  const { installDir } = options;\n\n  // Check for bin/rails\n  const binRailsPath = path.join(installDir, 'bin/rails');\n  if (fs.existsSync(binRailsPath)) {\n    return true;\n  }\n\n  // Check for config/application.rb with Rails reference\n  const appConfigPath = path.join(installDir, 'config/application.rb');\n  if (fs.existsSync(appConfigPath)) {\n    try {\n      const content = fs.readFileSync(appConfigPath, 'utf-8');\n      if (\n        content.includes('Rails::Application') ||\n        content.includes('require \"rails\"') ||\n        content.includes(\"require 'rails'\")\n      ) {\n        return true;\n      }\n    } catch {\n      // Continue to other checks\n    }\n  }\n\n  // Check Gemfile for rails gem\n  if (hasGem('rails', options)) {\n    return true;\n  }\n\n  // Check for typical Rails directory structure\n  const railsStructureFiles = await fg(\n    ['config/routes.rb', 'config/environment.rb'],\n    { cwd: installDir, ignore: IGNORE_PATTERNS },\n  );\n\n  return railsStructureFiles.length >= 2;\n}\n"]}

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

@@ -1,4 +1,4 @@
-import type { FrameworkConfig } from '../lib/framework-config';
+import type { FrameworkConfig } from '../../lib/framework-config';
 import { ReactNativeVariant } from './utils';
 type ReactNativeContext = {
     variant?: ReactNativeVariant;

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

@@ -1,10 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.REACT_NATIVE_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 utils_1 = require("./utils");
 exports.REACT_NATIVE_AGENT_CONFIG = {
     metadata: {
@@ -23,11 +23,13 @@ exports.REACT_NATIVE_AGENT_CONFIG = {
         getVersionBucket: utils_1.getReactNativeVersionBucket,
         minimumVersion: '0.73.0',
         getInstalledVersion: async (options) => {
-            const packageJson = await (0, clack_utils_1.getPackageDotJson)(options);
-            return (0, package_json_1.getPackageVersion)('react-native', packageJson);
+            const packageJson = await (0, setup_utils_1.tryGetPackageJson)(options);
+            return packageJson
+                ? (0, package_json_1.getPackageVersion)('react-native', 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-native', packageJson)
                 : false;

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

@@ -0,0 +1 @@
+{"version":3,"file":"react-native-wizard-agent.js","sourceRoot":"","sources":["../../../../src/frameworks/react-native/react-native-wizard-agent.ts"],"names":[],"mappings":"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","sourcesContent":["/* React Native 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 {\n  detectReactNativeVariant,\n  getReactNativeVariantName,\n  getReactNativeVersionBucket,\n  ReactNativeVariant,\n} from './utils';\n\ntype ReactNativeContext = {\n  variant?: ReactNativeVariant;\n};\n\nexport const REACT_NATIVE_AGENT_CONFIG: FrameworkConfig<ReactNativeContext> = {\n  metadata: {\n    name: 'React Native',\n    integration: Integration.reactNative,\n    docsUrl: 'https://posthog.com/docs/libraries/react-native',\n    gatherContext: async (options: WizardOptions) => {\n      const variant = await detectReactNativeVariant(options);\n      return { variant };\n    },\n  },\n\n  detection: {\n    packageName: 'react-native',\n    packageDisplayName: 'React Native',\n    getVersion: (packageJson: unknown) =>\n      getPackageVersion('react-native', packageJson as PackageDotJson),\n    getVersionBucket: getReactNativeVersionBucket,\n    minimumVersion: '0.73.0',\n    getInstalledVersion: async (options: WizardOptions) => {\n      const packageJson = await tryGetPackageJson(options);\n      return packageJson\n        ? getPackageVersion('react-native', packageJson)\n        : undefined;\n    },\n    detect: async (options) => {\n      const packageJson = await tryGetPackageJson(options);\n      return packageJson\n        ? hasPackageInstalled('react-native', packageJson)\n        : false;\n    },\n    detectPackageManager: detectNodePackageManagers,\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      variant:\n        context.variant === ReactNativeVariant.EXPO ? 'expo' : 'react-native',\n    }),\n  },\n\n  prompts: {\n    projectTypeDetection:\n      'This is a React Native project. Look for package.json, android/ and ios/ directories, and lockfiles to confirm. Check for expo in package.json to determine the variant.',\n    getAdditionalContextLines: (context) => {\n      const isExpo = context.variant === ReactNativeVariant.EXPO;\n      const frameworkId = 'react-native';\n\n      const lines = [\n        `Framework docs ID: ${frameworkId} (use posthog://docs/frameworks/${frameworkId} for documentation)`,\n        `Variant: ${isExpo ? 'Expo' : 'React Native'}`,\n      ];\n\n      if (isExpo) {\n        lines.push(\n          'Use `npx expo install` for package installation.',\n          'Use EXPO_PUBLIC_ prefix for environment variables exposed to the client.',\n        );\n      } else {\n        lines.push(\n          'This is a React Native project without Expo. Native linking may be required.',\n          'For iOS, ensure pods are installed after adding PostHog.',\n        );\n      }\n\n      return lines;\n    },\n  },\n\n  ui: {\n    successMessage: 'PostHog integration complete',\n    estimatedDurationMinutes: 10,\n    getOutroChanges: (context) => {\n      const variant = context.variant ?? ReactNativeVariant.REACT_NATIVE;\n      const variantName = getReactNativeVariantName(variant);\n      return [\n        `Analyzed your React Native project structure (${variantName})`,\n        `Installed and configured the PostHog React Native SDK`,\n        `Integrated PostHog into your application`,\n      ];\n    },\n    getOutroNextSteps: (context) => {\n      const isExpo = context.variant === ReactNativeVariant.EXPO;\n      const steps = [];\n\n      if (!isExpo) {\n        steps.push('Run `npx pod-install` to install iOS dependencies');\n      }\n\n      steps.push(\n        isExpo\n          ? 'Start your development server with `npx expo start` to see PostHog in action'\n          : 'Start your development server to see PostHog in action',\n        'Visit your PostHog dashboard to see incoming events',\n      );\n\n      return steps;\n    },\n  },\n};\n"]}

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

@@ -1,4 +1,4 @@
-import type { WizardOptions } from '../utils/types';
+import type { WizardOptions } from '../../utils/types';
 export declare const getReactNativeVersionBucket: (version: string | undefined) => string;
 export declare enum ReactNativeVariant {
     EXPO = "expo",

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;