@posthog/wizard 1.33.0 → 1.35.0

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

@@ -161,88 +161,11 @@ exports.PYTHON_AGENT_CONFIG = {
             const packageManagerName = context.packageManager
                 ? (0, utils_1.getPackageManagerName)(context.packageManager)
                 : 'unknown';
-            const lines = [
+            return [
                 `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: {

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

@@ -1 +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 { 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      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"]}
+{"version":3,"file":"python-wizard-agent.js","sourceRoot":"","sources":["../../../src/python/python-wizard-agent.ts"],"names":[],"mappings":"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","sourcesContent":["/* Generic Python 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/rails/rails-wizard-agent.d.ts

@@ -0,0 +1,8 @@
+import type { FrameworkConfig } from '../lib/framework-config';
+import { RailsProjectType } from './utils';
+type RailsContext = {
+    projectType?: RailsProjectType;
+    initializersDir?: string;
+};
+export declare const RAILS_AGENT_CONFIG: FrameworkConfig<RailsContext>;
+export {};

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

@@ -0,0 +1,90 @@
+"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 utils_1 = require("./utils");
+exports.RAILS_AGENT_CONFIG = {
+    metadata: {
+        name: 'Ruby on Rails',
+        integration: constants_1.Integration.rails,
+        beta: true,
+        docsUrl: 'https://posthog.com/docs/libraries/ruby-on-rails',
+        unsupportedVersionDocsUrl: 'https://posthog.com/docs/libraries/ruby',
+        gatherContext: (options) => {
+            const projectType = (0, utils_1.getRailsProjectType)(options);
+            const initializersDir = (0, utils_1.findInitializersDir)(options);
+            return Promise.resolve({ projectType, initializersDir });
+        },
+    },
+    detection: {
+        packageName: 'rails',
+        packageDisplayName: 'Ruby on Rails',
+        usesPackageJson: false,
+        getVersion: () => undefined,
+        getVersionBucket: utils_1.getRailsVersionBucket,
+        minimumVersion: '6.0.0',
+        getInstalledVersion: (options) => Promise.resolve((0, utils_1.getRailsVersion)(options)),
+        detect: async (options) => (0, utils_1.isRailsProject)(options),
+        detectPackageManager: package_manager_detection_1.bundlerPackageManager,
+    },
+    environment: {
+        uploadToHosting: false,
+        getEnvVars: (apiKey, host) => ({
+            POSTHOG_API_KEY: apiKey,
+            POSTHOG_HOST: host,
+        }),
+    },
+    analytics: {
+        getTags: (context) => ({
+            projectType: context.projectType || 'unknown',
+        }),
+    },
+    prompts: {
+        projectTypeDetection: 'This is a Ruby on Rails project. Look for Gemfile, config/application.rb, bin/rails, and config/routes.rb to confirm.',
+        packageInstallation: "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.",
+        getAdditionalContextLines: (context) => {
+            const projectTypeName = context.projectType
+                ? (0, utils_1.getRailsProjectTypeName)(context.projectType)
+                : 'unknown';
+            const lines = [
+                `Project type: ${projectTypeName}`,
+                `Framework docs ID: ruby-on-rails (use posthog://docs/frameworks/ruby-on-rails for documentation)`,
+            ];
+            if (context.initializersDir) {
+                lines.push(`Initializers directory: ${context.initializersDir}`);
+            }
+            if (context.projectType === utils_1.RailsProjectType.API) {
+                lines.push('Note: This is an API-only Rails app — skip frontend posthog-js integration');
+            }
+            return lines;
+        },
+    },
+    ui: {
+        successMessage: 'PostHog integration complete',
+        estimatedDurationMinutes: 5,
+        getOutroChanges: (context) => {
+            const projectTypeName = context.projectType
+                ? (0, utils_1.getRailsProjectTypeName)(context.projectType)
+                : 'Rails';
+            const changes = [
+                `Analyzed your ${projectTypeName} project structure`,
+                `Installed the posthog-ruby and posthog-rails gems via Bundler`,
+                `Created PostHog initializer in config/initializers/posthog.rb`,
+                `Configured automatic exception capture and ActiveJob instrumentation`,
+            ];
+            if (context.projectType !== utils_1.RailsProjectType.API) {
+                changes.push('Added posthog-js snippet to the layout template for frontend tracking');
+            }
+            return changes;
+        },
+        getOutroNextSteps: () => [
+            'Start your Rails development server with `bin/rails server`',
+            'Visit your PostHog dashboard to see incoming events',
+            'Use PostHog.capture() to track custom events',
+            'Use PostHog.identify() to associate events with users',
+            'Define posthog_distinct_id on your User model for automatic user association',
+        ],
+    },
+};
+//# sourceMappingURL=rails-wizard-agent.js.map

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

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

@@ -0,0 +1,37 @@
+import type { WizardOptions } from '../utils/types';
+export declare enum RailsProjectType {
+    STANDARD = "standard",// Traditional Rails app (rails new)
+    API = "api"
+}
+/**
+ * Get Rails version bucket for analytics
+ */
+export declare const getRailsVersionBucket: (version: string | undefined) => string;
+/**
+ * Check if a gem is present in the Gemfile
+ */
+export declare function hasGem(gemName: string, options: Pick<WizardOptions, 'installDir'>): boolean;
+/**
+ * Extract version for a gem from Gemfile
+ */
+export declare function getGemVersion(gemName: string, options: Pick<WizardOptions, 'installDir'>): string | undefined;
+/**
+ * Get Rails version from Gemfile
+ */
+export declare function getRailsVersion(options: Pick<WizardOptions, 'installDir'>): string | undefined;
+/**
+ * Detect Rails project type
+ */
+export declare function getRailsProjectType(options: WizardOptions): RailsProjectType;
+/**
+ * Get human-readable name for Rails project type
+ */
+export declare function getRailsProjectTypeName(projectType: RailsProjectType): string;
+/**
+ * Find the Rails initializers directory
+ */
+export declare function findInitializersDir(options: Pick<WizardOptions, 'installDir'>): string | undefined;
+/**
+ * Detect if the project is a Rails project by looking for typical Rails files
+ */
+export declare function isRailsProject(options: Pick<WizardOptions, 'installDir'>): Promise<boolean>;

package/dist/src/rails/utils.js

@@ -0,0 +1,187 @@
+"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.getRailsVersionBucket = exports.RailsProjectType = void 0;
+exports.hasGem = hasGem;
+exports.getGemVersion = getGemVersion;
+exports.getRailsVersion = getRailsVersion;
+exports.getRailsProjectType = getRailsProjectType;
+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 fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+var RailsProjectType;
+(function (RailsProjectType) {
+    RailsProjectType["STANDARD"] = "standard";
+    RailsProjectType["API"] = "api";
+})(RailsProjectType || (exports.RailsProjectType = RailsProjectType = {}));
+const IGNORE_PATTERNS = [
+    '**/node_modules/**',
+    '**/vendor/**',
+    '**/vendor/bundle/**',
+    '**/tmp/**',
+    '**/log/**',
+    '**/storage/**',
+];
+/**
+ * Get Rails version bucket for analytics
+ */
+exports.getRailsVersionBucket = (0, semver_1.createVersionBucket)();
+/**
+ * Read and parse Gemfile contents
+ */
+function readGemfile(options) {
+    const { installDir } = options;
+    const gemfilePath = path.join(installDir, 'Gemfile');
+    try {
+        return fs.readFileSync(gemfilePath, 'utf-8');
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Check if a gem is present in the Gemfile
+ */
+function hasGem(gemName, options) {
+    const content = readGemfile(options);
+    if (!content)
+        return false;
+    // Match gem declarations like: gem 'rails', gem "rails", gem 'rails', '~> 7.0'
+    const gemPattern = new RegExp(`^\\s*gem\\s+['"]${gemName}['"]`, 'im');
+    return gemPattern.test(content);
+}
+/**
+ * Extract version for a gem from Gemfile
+ */
+function getGemVersion(gemName, options) {
+    const content = readGemfile(options);
+    if (!content)
+        return undefined;
+    const versionPattern = new RegExp(`^\\s*gem\\s+['"]${gemName}['"]\\s*,\\s*['"][^0-9]*([0-9]+\\.[0-9]+(?:\\.[0-9]+)?)['"]`, 'im');
+    const match = content.match(versionPattern);
+    return match?.[1];
+}
+/**
+ * Get Rails version from Gemfile
+ */
+function getRailsVersion(options) {
+    return getGemVersion('rails', options);
+}
+/**
+ * Detect Rails project type
+ */
+function getRailsProjectType(options) {
+    const { installDir } = options;
+    // Check for API-only mode in config/application.rb
+    const appConfigPath = path.join(installDir, 'config/application.rb');
+    if (fs.existsSync(appConfigPath)) {
+        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');
+                return RailsProjectType.API;
+            }
+        }
+        catch {
+            // Continue to default
+        }
+    }
+    clack_1.default.log.info('Detected standard Rails project');
+    return RailsProjectType.STANDARD;
+}
+/**
+ * Get human-readable name for Rails project type
+ */
+function getRailsProjectTypeName(projectType) {
+    switch (projectType) {
+        case RailsProjectType.STANDARD:
+            return 'Standard Rails';
+        case RailsProjectType.API:
+            return 'Rails API';
+    }
+}
+/**
+ * Find the Rails initializers directory
+ */
+function findInitializersDir(options) {
+    const { installDir } = options;
+    const initializersDir = path.join(installDir, 'config/initializers');
+    if (fs.existsSync(initializersDir)) {
+        return 'config/initializers';
+    }
+    return undefined;
+}
+/**
+ * Detect if the project is a Rails project by looking for typical Rails files
+ */
+async function isRailsProject(options) {
+    const { installDir } = options;
+    // Check for bin/rails
+    const binRailsPath = path.join(installDir, 'bin/rails');
+    if (fs.existsSync(binRailsPath)) {
+        return true;
+    }
+    // Check for config/application.rb with Rails reference
+    const appConfigPath = path.join(installDir, 'config/application.rb');
+    if (fs.existsSync(appConfigPath)) {
+        try {
+            const content = fs.readFileSync(appConfigPath, 'utf-8');
+            if (content.includes('Rails::Application') ||
+                content.includes('require "rails"') ||
+                content.includes("require 'rails'")) {
+                return true;
+            }
+        }
+        catch {
+            // Continue to other checks
+        }
+    }
+    // Check Gemfile for rails gem
+    if (hasGem('rails', options)) {
+        return true;
+    }
+    // Check for typical Rails directory structure
+    const railsStructureFiles = await (0, fast_glob_1.default)(['config/routes.rb', 'config/environment.rb'], { cwd: installDir, ignore: IGNORE_PATTERNS });
+    return railsStructureFiles.length >= 2;
+}
+//# sourceMappingURL=utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/rails/utils.ts"],"names":[],"mappings":"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","sourcesContent":["import fg from 'fast-glob';\nimport clack from '../utils/clack';\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        clack.log.info('Detected Rails API-only project');\n        return RailsProjectType.API;\n      }\n    } catch {\n      // Continue to default\n    }\n  }\n\n  clack.log.info('Detected standard Rails project');\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/ruby/ruby-wizard-agent.d.ts

@@ -0,0 +1,7 @@
+import type { FrameworkConfig } from '../lib/framework-config';
+import { RubyPackageManager } from './utils';
+type RubyContext = {
+    packageManager?: RubyPackageManager;
+};
+export declare const RUBY_AGENT_CONFIG: FrameworkConfig<RubyContext>;
+export {};

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

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