@posthog/wizard 1.31.1 → 1.32.0

package/dist/src/python/python-wizard-agent.js

@@ -0,0 +1,269 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PYTHON_AGENT_CONFIG = void 0;
+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"));
+const utils_1 = require("./utils");
+exports.PYTHON_AGENT_CONFIG = {
+    metadata: {
+        name: 'Python Language',
+        integration: constants_1.Integration.python,
+        beta: true,
+        docsUrl: 'https://posthog.com/docs/libraries/python',
+        gatherContext: async (options) => {
+            const packageManager = await (0, utils_1.detectPackageManager)(options);
+            return { packageManager };
+        },
+    },
+    detection: {
+        packageName: 'python',
+        packageDisplayName: 'Python',
+        usesPackageJson: false,
+        getVersion: () => undefined,
+        getVersionBucket: utils_1.getPythonVersionBucket,
+        minimumVersion: '3.8.0',
+        getInstalledVersion: (options) => Promise.resolve((0, utils_1.getPythonVersion)(options)),
+        detect: async (options) => {
+            const { installDir } = options;
+            // Look for Python package management files
+            const pythonConfigFiles = await (0, fast_glob_1.default)([
+                '**/requirements*.txt',
+                '**/pyproject.toml',
+                '**/setup.py',
+                '**/Pipfile',
+            ], {
+                cwd: installDir,
+                ignore: ['**/venv/**', '**/.venv/**', '**/env/**', '**/.env/**'],
+            });
+            if (pythonConfigFiles.length === 0) {
+                return false;
+            }
+            // Make sure this isn't Django or Flask (those should be detected first)
+            // Check for Django
+            const managePyMatches = await (0, fast_glob_1.default)('**/manage.py', {
+                cwd: installDir,
+                ignore: ['**/venv/**', '**/.venv/**', '**/env/**', '**/.env/**'],
+            });
+            for (const match of managePyMatches) {
+                try {
+                    const content = fs.readFileSync(path.join(installDir, match), 'utf-8');
+                    if (content.includes('django') ||
+                        content.includes('DJANGO_SETTINGS_MODULE')) {
+                        return false; // Django detected, use django agent instead
+                    }
+                }
+                catch {
+                    continue;
+                }
+            }
+            // Check for Flask
+            for (const configFile of pythonConfigFiles) {
+                try {
+                    const content = fs.readFileSync(path.join(installDir, configFile), 'utf-8');
+                    if (/^flask([<>=~!]|$|\s)/im.test(content) ||
+                        /["']flask["']/i.test(content)) {
+                        return false; // Flask detected, use flask agent instead
+                    }
+                }
+                catch {
+                    continue;
+                }
+            }
+            const pyFiles = await (0, fast_glob_1.default)(['**/app.py', '**/wsgi.py', '**/application.py', '**/__init__.py'], {
+                cwd: installDir,
+                ignore: [
+                    '**/venv/**',
+                    '**/.venv/**',
+                    '**/env/**',
+                    '**/.env/**',
+                    '**/__pycache__/**',
+                ],
+            });
+            for (const pyFile of pyFiles) {
+                try {
+                    const content = fs.readFileSync(path.join(installDir, pyFile), 'utf-8');
+                    if (content.includes('from flask import') ||
+                        content.includes('import flask') ||
+                        /Flask\s*\(/.test(content)) {
+                        return false; // Flask detected, use flask agent instead
+                    }
+                }
+                catch {
+                    continue;
+                }
+            }
+            // If we have Python config files but it's not Django or Flask, it's a generic Python project
+            return true;
+        },
+    },
+    environment: {
+        uploadToHosting: false,
+        getEnvVars: (apiKey, host) => ({
+            POSTHOG_API_KEY: apiKey,
+            POSTHOG_HOST: host,
+        }),
+    },
+    analytics: {
+        getTags: (context) => {
+            const packageManagerName = context.packageManager
+                ? (0, utils_1.getPackageManagerName)(context.packageManager)
+                : 'unknown';
+            return {
+                packageManager: packageManagerName,
+            };
+        },
+    },
+    prompts: {
+        projectTypeDetection: 'This is a generic Python project. Look for requirements.txt, pyproject.toml, setup.py, or Pipfile to confirm.',
+        packageInstallation: 'Use pip, poetry, or pipenv based on existing config files (requirements.txt, pyproject.toml, Pipfile). Do not pin the posthog version - just add "posthog" without version constraints.',
+        getAdditionalContextLines: (context) => {
+            const packageManagerName = context.packageManager
+                ? (0, utils_1.getPackageManagerName)(context.packageManager)
+                : 'unknown';
+            const lines = [
+                `Package manager: ${packageManagerName}`,
+                `Framework docs ID: python (use posthog://docs/frameworks/python for documentation)`,
+                `Project type: Generic Python application (CLI, script, worker, data pipeline, etc.)`,
+                ``,
+                `## CRITICAL: Python PostHog Best Practices`,
+                ``,
+                `### 1. Use Instance-Based API (REQUIRED)`,
+                `Always use the Posthog() class constructor instead of module-level posthog:`,
+                ``,
+                `CORRECT:`,
+                `from posthog import Posthog`,
+                `posthog_client = Posthog(`,
+                `    api_key="your_api_key",`,
+                `    host="https://us.i.posthog.com",`,
+                `    debug=False,`,
+                `    enable_exception_autocapture=True,  # Auto-capture exceptions`,
+                `)`,
+                ``,
+                `INCORRECT (DO NOT USE):`,
+                `import posthog`,
+                `posthog.api_key = "your_api_key"  # Don't use module-level config`,
+                ``,
+                `### 2. Enable Exception Autocapture`,
+                `ALWAYS include enable_exception_autocapture=True in the Posthog() initialization to automatically track exceptions.`,
+                ``,
+                `### 3. NEVER Send PII (Personally Identifiable Information)`,
+                `DO NOT include in event properties:`,
+                `- Email addresses`,
+                `- Full names`,
+                `- Phone numbers`,
+                `- Physical addresses`,
+                `- IP addresses`,
+                `- Any user-generated content (messages, comments, form submissions)`,
+                ``,
+                `SAFE event properties:`,
+                `posthog_client.capture('contact_form_submitted', properties={`,
+                `    'message_length': len(message),  # Metadata is OK`,
+                `    'has_email': bool(email),  # Boolean flags are OK`,
+                `    'form_type': 'contact'  # Categories are OK`,
+                `})`,
+                ``,
+                `UNSAFE (DO NOT DO THIS):`,
+                `posthog_client.capture('form_submitted', properties={`,
+                `    'email': user_email,  # NEVER send actual email`,
+                `    'message': message_content,  # NEVER send user content`,
+                `    'name': user_name  # NEVER send names`,
+                `})`,
+                ``,
+                `### 4. Implement Graceful Shutdown`,
+                `ALWAYS call posthog_client.shutdown() when your application exits to ensure all events are flushed:`,
+                ``,
+                `import atexit`,
+                `atexit.register(posthog_client.shutdown)  # Ensures events are sent on exit`,
+                ``,
+                `For Django, use AppConfig.ready() to register the shutdown handler.`,
+                `For Flask, use @app.teardown_appcontext or atexit.`,
+                `For scripts/workers, call shutdown() explicitly or use atexit.`,
+                ``,
+                `### 5. For Django Projects`,
+                `Initialize PostHog in your AppConfig.ready() method:`,
+                ``,
+                `from django.apps import AppConfig`,
+                `from posthog import Posthog`,
+                ``,
+                `class YourAppConfig(AppConfig):`,
+                `    posthog_client = None`,
+                `    `,
+                `    def ready(self):`,
+                `        if YourAppConfig.posthog_client is None:`,
+                `            YourAppConfig.posthog_client = Posthog(`,
+                `                settings.POSTHOG_API_KEY,`,
+                `                host=settings.POSTHOG_HOST,`,
+                `                debug=settings.DEBUG,`,
+                `                enable_exception_autocapture=True,`,
+                `            )`,
+                `            import atexit`,
+                `            atexit.register(YourAppConfig.posthog_client.shutdown)`,
+                ``,
+                `IMPORTANT: These best practices are MANDATORY. The implementation will fail review if they are not followed.`,
+            ];
+            return lines;
+        },
+    },
+    ui: {
+        successMessage: 'PostHog integration complete',
+        estimatedDurationMinutes: 5,
+        getOutroChanges: (context) => {
+            const packageManagerName = context.packageManager
+                ? (0, utils_1.getPackageManagerName)(context.packageManager)
+                : 'package manager';
+            return [
+                `Analyzed your Python project structure`,
+                `Installed the PostHog Python package using ${packageManagerName}`,
+                `Created PostHog initialization using instance-based API (Posthog class)`,
+                `Configured exception autocapture and graceful shutdown`,
+                `Added example code for events, feature flags, and error capture (without PII)`,
+            ];
+        },
+        getOutroNextSteps: () => [
+            'Use Posthog() class (not module-level posthog) with enable_exception_autocapture=True',
+            'Call posthog_client.shutdown() on application exit (use atexit.register)',
+            'NEVER send PII in event properties (no emails, names, or user content)',
+            'Use posthog_client.capture() for events and posthog_client.identify() for users',
+            'Visit your PostHog dashboard to see incoming events',
+        ],
+    },
+};
+//# sourceMappingURL=python-wizard-agent.js.map

package/dist/src/python/python-wizard-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"python-wizard-agent.js","sourceRoot":"","sources":["../../../src/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 { 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  },\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 generic Python project. Look for requirements.txt, pyproject.toml, setup.py, or Pipfile to confirm.',\n    packageInstallation:\n      'Use pip, poetry, or pipenv based on existing config files (requirements.txt, pyproject.toml, Pipfile). Do not pin the posthog version - just add \"posthog\" without version constraints.',\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: python (use posthog://docs/frameworks/python for documentation)`,\n        `Project type: Generic Python application (CLI, script, worker, data pipeline, etc.)`,\n        ``,\n        `## CRITICAL: Python PostHog Best Practices`,\n        ``,\n        `### 1. Use Instance-Based API (REQUIRED)`,\n        `Always use the Posthog() class constructor instead of module-level posthog:`,\n        ``,\n        `CORRECT:`,\n        `from posthog import Posthog`,\n        `posthog_client = Posthog(`,\n        `    api_key=\"your_api_key\",`,\n        `    host=\"https://us.i.posthog.com\",`,\n        `    debug=False,`,\n        `    enable_exception_autocapture=True,  # Auto-capture exceptions`,\n        `)`,\n        ``,\n        `INCORRECT (DO NOT USE):`,\n        `import posthog`,\n        `posthog.api_key = \"your_api_key\"  # Don't use module-level config`,\n        ``,\n        `### 2. Enable Exception Autocapture`,\n        `ALWAYS include enable_exception_autocapture=True in the Posthog() initialization to automatically track exceptions.`,\n        ``,\n        `### 3. NEVER Send PII (Personally Identifiable Information)`,\n        `DO NOT include in event properties:`,\n        `- Email addresses`,\n        `- Full names`,\n        `- Phone numbers`,\n        `- Physical addresses`,\n        `- IP addresses`,\n        `- Any user-generated content (messages, comments, form submissions)`,\n        ``,\n        `SAFE event properties:`,\n        `posthog_client.capture('contact_form_submitted', properties={`,\n        `    'message_length': len(message),  # Metadata is OK`,\n        `    'has_email': bool(email),  # Boolean flags are OK`,\n        `    'form_type': 'contact'  # Categories are OK`,\n        `})`,\n        ``,\n        `UNSAFE (DO NOT DO THIS):`,\n        `posthog_client.capture('form_submitted', properties={`,\n        `    'email': user_email,  # NEVER send actual email`,\n        `    'message': message_content,  # NEVER send user content`,\n        `    'name': user_name  # NEVER send names`,\n        `})`,\n        ``,\n        `### 4. Implement Graceful Shutdown`,\n        `ALWAYS call posthog_client.shutdown() when your application exits to ensure all events are flushed:`,\n        ``,\n        `import atexit`,\n        `atexit.register(posthog_client.shutdown)  # Ensures events are sent on exit`,\n        ``,\n        `For Django, use AppConfig.ready() to register the shutdown handler.`,\n        `For Flask, use @app.teardown_appcontext or atexit.`,\n        `For scripts/workers, call shutdown() explicitly or use atexit.`,\n        ``,\n        `### 5. For Django Projects`,\n        `Initialize PostHog in your AppConfig.ready() method:`,\n        ``,\n        `from django.apps import AppConfig`,\n        `from posthog import Posthog`,\n        ``,\n        `class YourAppConfig(AppConfig):`,\n        `    posthog_client = None`,\n        `    `,\n        `    def ready(self):`,\n        `        if YourAppConfig.posthog_client is None:`,\n        `            YourAppConfig.posthog_client = Posthog(`,\n        `                settings.POSTHOG_API_KEY,`,\n        `                host=settings.POSTHOG_HOST,`,\n        `                debug=settings.DEBUG,`,\n        `                enable_exception_autocapture=True,`,\n        `            )`,\n        `            import atexit`,\n        `            atexit.register(YourAppConfig.posthog_client.shutdown)`,\n        ``,\n        `IMPORTANT: These best practices are MANDATORY. The implementation will fail review if they are not followed.`,\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 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/utils.d.ts

@@ -0,0 +1,28 @@
+import type { WizardOptions } from '../utils/types';
+export declare enum PythonPackageManager {
+    UV = "uv",
+    POETRY = "poetry",
+    PDM = "pdm",
+    HATCH = "hatch",
+    RYE = "rye",
+    PIPENV = "pipenv",
+    CONDA = "conda",
+    PIP = "pip",
+    UNKNOWN = "unknown"
+}
+/**
+ * Get the installed Python version
+ */
+export declare function getPythonVersion(options: WizardOptions): string | undefined;
+/**
+ * Bucket Python version for analytics (e.g., "3.11.x" -> "3.11")
+ */
+export declare function getPythonVersionBucket(version: string): string;
+/**
+ * Detect which package manager the project uses
+ */
+export declare function detectPackageManager(options: WizardOptions): Promise<PythonPackageManager>;
+/**
+ * Get package manager display name
+ */
+export declare function getPackageManagerName(packageManager: PythonPackageManager): string;

package/dist/src/python/utils.js

@@ -0,0 +1,147 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PythonPackageManager = void 0;
+exports.getPythonVersion = getPythonVersion;
+exports.getPythonVersionBucket = getPythonVersionBucket;
+exports.detectPackageManager = detectPackageManager;
+exports.getPackageManagerName = getPackageManagerName;
+const node_child_process_1 = require("node:child_process");
+var PythonPackageManager;
+(function (PythonPackageManager) {
+    PythonPackageManager["UV"] = "uv";
+    PythonPackageManager["POETRY"] = "poetry";
+    PythonPackageManager["PDM"] = "pdm";
+    PythonPackageManager["HATCH"] = "hatch";
+    PythonPackageManager["RYE"] = "rye";
+    PythonPackageManager["PIPENV"] = "pipenv";
+    PythonPackageManager["CONDA"] = "conda";
+    PythonPackageManager["PIP"] = "pip";
+    PythonPackageManager["UNKNOWN"] = "unknown";
+})(PythonPackageManager || (exports.PythonPackageManager = PythonPackageManager = {}));
+/**
+ * Get the installed Python version
+ */
+function getPythonVersion(options) {
+    try {
+        const version = (0, node_child_process_1.execSync)('python --version || python3 --version', {
+            cwd: options.installDir,
+            encoding: 'utf-8',
+        })
+            .trim()
+            .replace('Python ', '');
+        return version;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Bucket Python version for analytics (e.g., "3.11.x" -> "3.11")
+ */
+function getPythonVersionBucket(version) {
+    const match = version.match(/^(\d+\.\d+)/);
+    return match ? match[1] : version;
+}
+/**
+ * Detect which package manager the project uses
+ */
+async function detectPackageManager(options) {
+    const { installDir } = options;
+    const fs = await import('node:fs');
+    const path = await import('node:path');
+    // Check for uv (uv.lock)
+    if (fs.existsSync(path.join(installDir, 'uv.lock'))) {
+        return PythonPackageManager.UV;
+    }
+    // Check pyproject.toml for various tools
+    if (fs.existsSync(path.join(installDir, 'pyproject.toml'))) {
+        try {
+            const content = fs.readFileSync(path.join(installDir, 'pyproject.toml'), 'utf-8');
+            // Check for Poetry
+            if (content.includes('[tool.poetry]')) {
+                return PythonPackageManager.POETRY;
+            }
+            // Check for PDM
+            if (content.includes('[tool.pdm]')) {
+                return PythonPackageManager.PDM;
+            }
+            // Check for Hatch
+            if (content.includes('[tool.hatch]')) {
+                return PythonPackageManager.HATCH;
+            }
+            // Check for Rye
+            if (content.includes('[tool.rye]')) {
+                return PythonPackageManager.RYE;
+            }
+        }
+        catch {
+            // Continue checking
+        }
+    }
+    // Check for Poetry lock file
+    if (fs.existsSync(path.join(installDir, 'poetry.lock'))) {
+        return PythonPackageManager.POETRY;
+    }
+    // Check for PDM lock file
+    if (fs.existsSync(path.join(installDir, 'pdm.lock'))) {
+        return PythonPackageManager.PDM;
+    }
+    // Check for Pipenv (Pipfile or Pipfile.lock)
+    if (fs.existsSync(path.join(installDir, 'Pipfile')) ||
+        fs.existsSync(path.join(installDir, 'Pipfile.lock'))) {
+        return PythonPackageManager.PIPENV;
+    }
+    // Check for Conda (environment.yml or environment.yaml)
+    if (fs.existsSync(path.join(installDir, 'environment.yml')) ||
+        fs.existsSync(path.join(installDir, 'environment.yaml'))) {
+        return PythonPackageManager.CONDA;
+    }
+    // Check for pip (requirements.txt, setup.py, setup.cfg, or pyproject.toml)
+    if (fs.existsSync(path.join(installDir, 'requirements.txt')) ||
+        fs.existsSync(path.join(installDir, 'setup.py')) ||
+        fs.existsSync(path.join(installDir, 'setup.cfg')) ||
+        fs.existsSync(path.join(installDir, 'pyproject.toml'))) {
+        return PythonPackageManager.PIP;
+    }
+    // Check for requirements directory
+    try {
+        const requirementsDir = path.join(installDir, 'requirements');
+        if (fs.existsSync(requirementsDir) &&
+            fs.statSync(requirementsDir).isDirectory()) {
+            const files = fs.readdirSync(requirementsDir);
+            if (files.some((f) => f.endsWith('.txt'))) {
+                return PythonPackageManager.PIP;
+            }
+        }
+    }
+    catch {
+        // Continue
+    }
+    return PythonPackageManager.UNKNOWN;
+}
+/**
+ * Get package manager display name
+ */
+function getPackageManagerName(packageManager) {
+    switch (packageManager) {
+        case PythonPackageManager.UV:
+            return 'uv';
+        case PythonPackageManager.POETRY:
+            return 'Poetry';
+        case PythonPackageManager.PDM:
+            return 'PDM';
+        case PythonPackageManager.HATCH:
+            return 'Hatch';
+        case PythonPackageManager.RYE:
+            return 'Rye';
+        case PythonPackageManager.PIPENV:
+            return 'Pipenv';
+        case PythonPackageManager.CONDA:
+            return 'Conda';
+        case PythonPackageManager.PIP:
+            return 'pip';
+        case PythonPackageManager.UNKNOWN:
+            return 'unknown';
+    }
+}
+//# sourceMappingURL=utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/python/utils.ts"],"names":[],"mappings":"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","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/react-native/react-native-wizard-agent.d.ts

@@ -0,0 +1,7 @@
+import type { FrameworkConfig } from '../lib/framework-config';
+import { ReactNativeVariant } from './utils';
+type ReactNativeContext = {
+    variant?: ReactNativeVariant;
+};
+export declare const REACT_NATIVE_AGENT_CONFIG: FrameworkConfig<ReactNativeContext>;
+export {};

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

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REACT_NATIVE_AGENT_CONFIG = void 0;
+const constants_1 = require("../lib/constants");
+const package_json_1 = require("../utils/package-json");
+const clack_utils_1 = require("../utils/clack-utils");
+const utils_1 = require("./utils");
+exports.REACT_NATIVE_AGENT_CONFIG = {
+    metadata: {
+        name: 'React Native',
+        integration: constants_1.Integration.reactNative,
+        docsUrl: 'https://posthog.com/docs/libraries/react-native',
+        gatherContext: async (options) => {
+            const variant = await (0, utils_1.detectReactNativeVariant)(options);
+            return { variant };
+        },
+    },
+    detection: {
+        packageName: 'react-native',
+        packageDisplayName: 'React Native',
+        getVersion: (packageJson) => (0, package_json_1.getPackageVersion)('react-native', packageJson),
+        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);
+        },
+        detect: async (options) => {
+            const packageJson = await (0, clack_utils_1.tryGetPackageJson)(options);
+            return packageJson
+                ? (0, package_json_1.hasPackageInstalled)('react-native', packageJson)
+                : false;
+        },
+    },
+    environment: {
+        uploadToHosting: false,
+        getEnvVars: (apiKey, host) => ({
+            POSTHOG_API_KEY: apiKey,
+            POSTHOG_HOST: host,
+        }),
+    },
+    analytics: {
+        getTags: (context) => ({
+            variant: context.variant === utils_1.ReactNativeVariant.EXPO ? 'expo' : 'react-native',
+        }),
+    },
+    prompts: {
+        projectTypeDetection: '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.',
+        packageInstallation: 'Look for lockfiles to determine the package manager (npm, yarn, pnpm). Do not manually edit package.json.',
+        getAdditionalContextLines: (context) => {
+            const isExpo = context.variant === utils_1.ReactNativeVariant.EXPO;
+            const frameworkId = 'react-native';
+            const lines = [
+                `Framework docs ID: ${frameworkId} (use posthog://docs/frameworks/${frameworkId} for documentation)`,
+                `Variant: ${isExpo ? 'Expo' : 'React Native'}`,
+            ];
+            if (isExpo) {
+                lines.push('Use `npx expo install` for package installation.', 'Use EXPO_PUBLIC_ prefix for environment variables exposed to the client.');
+            }
+            else {
+                lines.push('This is a React Native project without Expo. Native linking may be required.', 'For iOS, ensure pods are installed after adding PostHog.');
+            }
+            return lines;
+        },
+    },
+    ui: {
+        successMessage: 'PostHog integration complete',
+        estimatedDurationMinutes: 10,
+        getOutroChanges: (context) => {
+            const variant = context.variant ?? utils_1.ReactNativeVariant.REACT_NATIVE;
+            const variantName = (0, utils_1.getReactNativeVariantName)(variant);
+            return [
+                `Analyzed your React Native project structure (${variantName})`,
+                `Installed and configured the PostHog React Native SDK`,
+                `Integrated PostHog into your application`,
+            ];
+        },
+        getOutroNextSteps: (context) => {
+            const isExpo = context.variant === utils_1.ReactNativeVariant.EXPO;
+            const steps = [];
+            if (!isExpo) {
+                steps.push('Run `npx pod-install` to install iOS dependencies');
+            }
+            steps.push(isExpo
+                ? 'Start your development server with `npx expo start` to see PostHog in action'
+                : 'Start your development server to see PostHog in action', 'Visit your PostHog dashboard to see incoming events');
+            return steps;
+        },
+    },
+};
+//# sourceMappingURL=react-native-wizard-agent.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"react-native-wizard-agent.js","sourceRoot":"","sources":["../../../src/react-native/react-native-wizard-agent.ts"],"names":[],"mappings":";;;AAGA,gDAA+C;AAC/C,wDAI+B;AAC/B,sDAA4E;AAC5E,mCAKiB;AAMJ,QAAA,yBAAyB,GAAwC;IAC5E,QAAQ,EAAE;QACR,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,uBAAW,CAAC,WAAW;QACpC,OAAO,EAAE,iDAAiD;QAC1D,aAAa,EAAE,KAAK,EAAE,OAAsB,EAAE,EAAE;YAC9C,MAAM,OAAO,GAAG,MAAM,IAAA,gCAAwB,EAAC,OAAO,CAAC,CAAC;YACxD,OAAO,EAAE,OAAO,EAAE,CAAC;QACrB,CAAC;KACF;IAED,SAAS,EAAE;QACT,WAAW,EAAE,cAAc;QAC3B,kBAAkB,EAAE,cAAc;QAClC,UAAU,EAAE,CAAC,WAAoB,EAAE,EAAE,CACnC,IAAA,gCAAiB,EAAC,cAAc,EAAE,WAA6B,CAAC;QAClE,gBAAgB,EAAE,mCAA2B;QAC7C,cAAc,EAAE,QAAQ;QACxB,mBAAmB,EAAE,KAAK,EAAE,OAAsB,EAAE,EAAE;YACpD,MAAM,WAAW,GAAG,MAAM,IAAA,+BAAiB,EAAC,OAAO,CAAC,CAAC;YACrD,OAAO,IAAA,gCAAiB,EAAC,cAAc,EAAE,WAAW,CAAC,CAAC;QACxD,CAAC;QACD,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,cAAc,EAAE,WAAW,CAAC;gBAClD,CAAC,CAAC,KAAK,CAAC;QACZ,CAAC;KACF;IAED,WAAW,EAAE;QACX,eAAe,EAAE,KAAK;QACtB,UAAU,EAAE,CAAC,MAAc,EAAE,IAAY,EAAE,EAAE,CAAC,CAAC;YAC7C,eAAe,EAAE,MAAM;YACvB,YAAY,EAAE,IAAI;SACnB,CAAC;KACH;IAED,SAAS,EAAE;QACT,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACrB,OAAO,EACL,OAAO,CAAC,OAAO,KAAK,0BAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc;SACxE,CAAC;KACH;IAED,OAAO,EAAE;QACP,oBAAoB,EAClB,0KAA0K;QAC5K,mBAAmB,EACjB,2GAA2G;QAC7G,yBAAyB,EAAE,CAAC,OAAO,EAAE,EAAE;YACrC,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,KAAK,0BAAkB,CAAC,IAAI,CAAC;YAC3D,MAAM,WAAW,GAAG,cAAc,CAAC;YAEnC,MAAM,KAAK,GAAG;gBACZ,sBAAsB,WAAW,mCAAmC,WAAW,qBAAqB;gBACpG,YAAY,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,EAAE;aAC/C,CAAC;YAEF,IAAI,MAAM,EAAE,CAAC;gBACX,KAAK,CAAC,IAAI,CACR,kDAAkD,EAClD,0EAA0E,CAC3E,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CACR,8EAA8E,EAC9E,0DAA0D,CAC3D,CAAC;YACJ,CAAC;YAED,OAAO,KAAK,CAAC;QACf,CAAC;KACF;IAED,EAAE,EAAE;QACF,cAAc,EAAE,8BAA8B;QAC9C,wBAAwB,EAAE,EAAE;QAC5B,eAAe,EAAE,CAAC,OAAO,EAAE,EAAE;YAC3B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,0BAAkB,CAAC,YAAY,CAAC;YACnE,MAAM,WAAW,GAAG,IAAA,iCAAyB,EAAC,OAAO,CAAC,CAAC;YACvD,OAAO;gBACL,iDAAiD,WAAW,GAAG;gBAC/D,uDAAuD;gBACvD,0CAA0C;aAC3C,CAAC;QACJ,CAAC;QACD,iBAAiB,EAAE,CAAC,OAAO,EAAE,EAAE;YAC7B,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,KAAK,0BAAkB,CAAC,IAAI,CAAC;YAC3D,MAAM,KAAK,GAAG,EAAE,CAAC;YAEjB,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,KAAK,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;YAClE,CAAC;YAED,KAAK,CAAC,IAAI,CACR,MAAM;gBACJ,CAAC,CAAC,8EAA8E;gBAChF,CAAC,CAAC,wDAAwD,EAC5D,qDAAqD,CACtD,CAAC;YAEF,OAAO,KAAK,CAAC;QACf,CAAC;KACF;CACF,CAAC","sourcesContent":["/* React Native wizard using posthog-agent with PostHog MCP */\nimport type { WizardOptions } from '../utils/types';\nimport type { FrameworkConfig } from '../lib/framework-config';\nimport { Integration } from '../lib/constants';\nimport {\n  getPackageVersion,\n  hasPackageInstalled,\n  type PackageDotJson,\n} from '../utils/package-json';\nimport { getPackageDotJson, tryGetPackageJson } from '../utils/clack-utils';\nimport {\n  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 getPackageDotJson(options);\n      return getPackageVersion('react-native', packageJson);\n    },\n    detect: async (options) => {\n      const packageJson = await tryGetPackageJson(options);\n      return packageJson\n        ? hasPackageInstalled('react-native', packageJson)\n        : false;\n    },\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    packageInstallation:\n      'Look for lockfiles to determine the package manager (npm, yarn, pnpm). Do not manually edit package.json.',\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/utils.d.ts

@@ -0,0 +1,8 @@
+import type { WizardOptions } from '../utils/types';
+export declare const getReactNativeVersionBucket: (version: string | undefined) => string;
+export declare enum ReactNativeVariant {
+    EXPO = "expo",
+    REACT_NATIVE = "react-native"
+}
+export declare function getReactNativeVariantName(variant: ReactNativeVariant): string;
+export declare function detectReactNativeVariant(options: Pick<WizardOptions, 'installDir'>): Promise<ReactNativeVariant>;