@posthog/wizard 1.36.1 → 2.0.0

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"laravel-wizard-agent.js","sourceRoot":"","sources":["../../../../src/frameworks/laravel/laravel-wizard-agent.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAGA,mFAA6E;AAC7E,mDAAkD;AAClD,0DAA2B;AAC3B,4CAA8B;AAC9B,gDAAkC;AAClC,mCASiB;AASJ,QAAA,oBAAoB,GAAoC;IACnE,QAAQ,EAAE;QACR,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,uBAAW,CAAC,OAAO;QAChC,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,wCAAwC;QACjD,yBAAyB,EAAE,wCAAwC;QACnE,aAAa,EAAE,KAAK,EAAE,OAAsB,EAAE,EAAE;YAC9C,MAAM,WAAW,GAAG,MAAM,IAAA,6BAAqB,EAAC,OAAO,CAAC,CAAC;YACzD,MAAM,eAAe,GAAG,MAAM,IAAA,kCAA0B,EAAC,OAAO,CAAC,CAAC;YAClE,MAAM,aAAa,GAAG,IAAA,gCAAwB,EAAC,OAAO,CAAC,CAAC;YACxD,MAAM,gBAAgB,GAAG,IAAA,8BAAsB,EAAC,OAAO,CAAC,CAAC;YAEzD,OAAO;gBACL,WAAW;gBACX,eAAe;gBACf,aAAa;gBACb,gBAAgB;aACjB,CAAC;QACJ,CAAC;KACF;IAED,SAAS,EAAE;QACT,WAAW,EAAE,mBAAmB;QAChC,kBAAkB,EAAE,SAAS;QAC7B,eAAe,EAAE,KAAK;QACtB,UAAU,EAAE,GAAG,EAAE,CAAC,SAAS;QAC3B,gBAAgB,EAAE,+BAAuB;QACzC,cAAc,EAAE,OAAO;QACvB,mBAAmB,EAAE,CAAC,OAAsB,EAAE,EAAE,CAC9C,OAAO,CAAC,OAAO,CAAC,IAAA,yBAAiB,EAAC,OAAO,CAAC,CAAC;QAC7C,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACxB,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;YAE/B,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;YACrD,IAAI,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC/B,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;oBACtD,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;wBAC/D,OAAO,IAAI,CAAC;oBACd,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,2BAA2B;gBAC7B,CAAC;YACH,CAAC;YAED,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;YAC5D,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;gBAChC,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;oBACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;oBACrC,IACE,QAAQ,CAAC,OAAO,EAAE,CAAC,mBAAmB,CAAC;wBACvC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,mBAAmB,CAAC,EAC9C,CAAC;wBACD,OAAO,IAAI,CAAC;oBACd,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,2BAA2B;gBAC7B,CAAC;YACH,CAAC;YAED,MAAM,mBAAmB,GAAG,MAAM,IAAA,mBAAE,EAClC,CAAC,sBAAsB,EAAE,wBAAwB,CAAC,EAClD,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,cAAc,CAAC,EAAE,CAC9C,CAAC;YAEF,OAAO,mBAAmB,CAAC,MAAM,GAAG,CAAC,CAAC;QACxC,CAAC;QACD,oBAAoB,EAAE,kDAAsB;KAC7C;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,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,SAAS;YAC7C,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,SAAS;SACxD,CAAC;KACH;IAED,OAAO,EAAE;QACP,oBAAoB,EAClB,0KAA0K;QAC5K,mBAAmB,EACjB,kHAAkH;QACpH,yBAAyB,EAAE,CAAC,OAAO,EAAE,EAAE;YACrC,MAAM,eAAe,GAAG,OAAO,CAAC,WAAW;gBACzC,CAAC,CAAC,IAAA,iCAAyB,EAAC,OAAO,CAAC,WAAW,CAAC;gBAChD,CAAC,CAAC,SAAS,CAAC;YAEd,MAAM,KAAK,GAAG;gBACZ,iBAAiB,eAAe,EAAE;gBAClC,8EAA8E;gBAC9E,sBAAsB,OAAO,CAAC,gBAAgB,uCAAuC;aACtF,CAAC;YAEF,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;gBAC5B,KAAK,CAAC,IAAI,CAAC,qBAAqB,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;YAC7D,CAAC;YAED,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;gBAC1B,KAAK,CAAC,IAAI,CAAC,mBAAmB,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;YACzD,CAAC;YAED,2DAA2D;YAC3D,IAAI,OAAO,CAAC,gBAAgB,KAAK,QAAQ,EAAE,CAAC;gBAC1C,KAAK,CAAC,IAAI,CACR,kFAAkF,CACnF,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CACR,mFAAmF,CACpF,CAAC;YACJ,CAAC;YAED,OAAO,KAAK,CAAC;QACf,CAAC;KACF;IAED,EAAE,EAAE;QACF,cAAc,EAAE,8BAA8B;QAC9C,wBAAwB,EAAE,CAAC;QAC3B,eAAe,EAAE,CAAC,OAAO,EAAE,EAAE;YAC3B,MAAM,eAAe,GAAG,OAAO,CAAC,WAAW;gBACzC,CAAC,CAAC,IAAA,iCAAyB,EAAC,OAAO,CAAC,WAAW,CAAC;gBAChD,CAAC,CAAC,SAAS,CAAC;YAEd,MAAM,OAAO,GAAG;gBACd,iBAAiB,eAAe,oBAAoB;gBACpD,gDAAgD;gBAChD,gDAAgD;aACjD,CAAC;YAEF,IAAI,OAAO,CAAC,gBAAgB,KAAK,QAAQ,EAAE,CAAC;gBAC1C,OAAO,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;YACpE,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;YACxE,CAAC;YAED,IAAI,OAAO,CAAC,WAAW,KAAK,0BAAkB,CAAC,OAAO,EAAE,CAAC;gBACvD,OAAO,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;YAC7D,CAAC;YAED,IAAI,OAAO,CAAC,WAAW,KAAK,0BAAkB,CAAC,QAAQ,EAAE,CAAC;gBACxD,OAAO,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;YAC3D,CAAC;YAED,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,iBAAiB,EAAE,GAAG,EAAE,CAAC;YACvB,gEAAgE;YAChE,qDAAqD;YACrD,+CAA+C;YAC/C,wDAAwD;SACzD;KACF;CACF,CAAC","sourcesContent":["/* Laravel wizard using posthog-agent with PostHog MCP */\nimport type { WizardOptions } from '../../utils/types';\nimport type { FrameworkConfig } from '../../lib/framework-config';\nimport { composerPackageManager } 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  getLaravelVersion,\n  getLaravelProjectType,\n  getLaravelProjectTypeName,\n  getLaravelVersionBucket,\n  LaravelProjectType,\n  findLaravelServiceProvider,\n  findLaravelBootstrapFile,\n  detectLaravelStructure,\n} from './utils';\n\ntype LaravelContext = {\n  projectType?: LaravelProjectType;\n  serviceProvider?: string;\n  bootstrapFile?: string;\n  laravelStructure?: string;\n};\n\nexport const LARAVEL_AGENT_CONFIG: FrameworkConfig<LaravelContext> = {\n  metadata: {\n    name: 'Laravel',\n    integration: Integration.laravel,\n    beta: true,\n    docsUrl: 'https://posthog.com/docs/libraries/php',\n    unsupportedVersionDocsUrl: 'https://posthog.com/docs/libraries/php',\n    gatherContext: async (options: WizardOptions) => {\n      const projectType = await getLaravelProjectType(options);\n      const serviceProvider = await findLaravelServiceProvider(options);\n      const bootstrapFile = findLaravelBootstrapFile(options);\n      const laravelStructure = detectLaravelStructure(options);\n\n      return {\n        projectType,\n        serviceProvider,\n        bootstrapFile,\n        laravelStructure,\n      };\n    },\n  },\n\n  detection: {\n    packageName: 'laravel/framework',\n    packageDisplayName: 'Laravel',\n    usesPackageJson: false,\n    getVersion: () => undefined,\n    getVersionBucket: getLaravelVersionBucket,\n    minimumVersion: '9.0.0',\n    getInstalledVersion: (options: WizardOptions) =>\n      Promise.resolve(getLaravelVersion(options)),\n    detect: async (options) => {\n      const { installDir } = options;\n\n      const artisanPath = path.join(installDir, 'artisan');\n      if (fs.existsSync(artisanPath)) {\n        try {\n          const content = fs.readFileSync(artisanPath, 'utf-8');\n          if (content.includes('Laravel') || content.includes('Artisan')) {\n            return true;\n          }\n        } catch {\n          // Continue to other checks\n        }\n      }\n\n      const composerPath = path.join(installDir, 'composer.json');\n      if (fs.existsSync(composerPath)) {\n        try {\n          const content = fs.readFileSync(composerPath, 'utf-8');\n          const composer = JSON.parse(content);\n          if (\n            composer.require?.['laravel/framework'] ||\n            composer['require-dev']?.['laravel/framework']\n          ) {\n            return true;\n          }\n        } catch {\n          // Continue to other checks\n        }\n      }\n\n      const hasLaravelStructure = await fg(\n        ['**/bootstrap/app.php', '**/app/Http/Kernel.php'],\n        { cwd: installDir, ignore: ['**/vendor/**'] },\n      );\n\n      return hasLaravelStructure.length > 0;\n    },\n    detectPackageManager: composerPackageManager,\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      laravelStructure: context.laravelStructure || 'unknown',\n    }),\n  },\n\n  prompts: {\n    projectTypeDetection:\n      'This is a PHP/Laravel project. Look for composer.json, artisan CLI, and app/ directory structure to confirm. Check for Laravel-specific packages like laravel/framework.',\n    packageInstallation:\n      'Use Composer to install packages. Run `composer require posthog/posthog-php` without pinning a specific version.',\n    getAdditionalContextLines: (context) => {\n      const projectTypeName = context.projectType\n        ? getLaravelProjectTypeName(context.projectType)\n        : 'unknown';\n\n      const lines = [\n        `Project type: ${projectTypeName}`,\n        `Framework docs ID: php (use posthog://docs/frameworks/php for documentation)`,\n        `Laravel structure: ${context.laravelStructure} (affects where to add configuration)`,\n      ];\n\n      if (context.serviceProvider) {\n        lines.push(`Service provider: ${context.serviceProvider}`);\n      }\n\n      if (context.bootstrapFile) {\n        lines.push(`Bootstrap file: ${context.bootstrapFile}`);\n      }\n\n      // Add Laravel-specific guidance based on version structure\n      if (context.laravelStructure === 'latest') {\n        lines.push(\n          'Note: Laravel 11+ uses simplified bootstrap/app.php for middleware and providers',\n        );\n      } else {\n        lines.push(\n          'Note: Use app/Http/Kernel.php for middleware, app/Providers for service providers',\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        ? getLaravelProjectTypeName(context.projectType)\n        : 'Laravel';\n\n      const changes = [\n        `Analyzed your ${projectTypeName} project structure`,\n        `Installed the PostHog PHP package via Composer`,\n        `Configured PostHog in your Laravel application`,\n      ];\n\n      if (context.laravelStructure === 'latest') {\n        changes.push('Added PostHog initialization to bootstrap/app.php');\n      } else {\n        changes.push('Created a PostHog service provider for initialization');\n      }\n\n      if (context.projectType === LaravelProjectType.INERTIA) {\n        changes.push('Configured PostHog to work with Inertia.js');\n      }\n\n      if (context.projectType === LaravelProjectType.LIVEWIRE) {\n        changes.push('Configured PostHog to work with Livewire');\n      }\n\n      return changes;\n    },\n    getOutroNextSteps: () => [\n      'Start your Laravel development server with `php artisan serve`',\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    ],\n  },\n};\n"]}

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

@@ -1,4 +1,4 @@
-import type { WizardOptions } from '../utils/types';
+import type { WizardOptions } from '../../utils/types';
 export declare enum LaravelProjectType {
     STANDARD = "standard",// Basic Laravel app
     INERTIA = "inertia",// Inertia.js (Vue/React SPA) - may need JS SDK too

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

@@ -45,8 +45,8 @@ exports.findLaravelServiceProvider = findLaravelServiceProvider;
 exports.findLaravelBootstrapFile = findLaravelBootstrapFile;
 exports.detectLaravelStructure = detectLaravelStructure;
 const fast_glob_1 = __importDefault(require("fast-glob"));
-const clack_1 = __importDefault(require("../utils/clack"));
-const semver_1 = require("../utils/semver");
+const ui_1 = require("../../ui");
+const semver_1 = require("../../utils/semver");
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
 var LaravelProjectType;
@@ -171,15 +171,15 @@ async function hasLivewire(options) {
 async function getLaravelProjectType(options) {
     // Check for SPA/Reactive frameworks (important to detect - affects SDK needs)
     if (await hasInertia(options)) {
-        clack_1.default.log.info('Detected Laravel with Inertia.js');
+        (0, ui_1.getUI)().setDetectedFramework('Laravel with Inertia.js');
         return LaravelProjectType.INERTIA;
     }
     if (await hasLivewire(options)) {
-        clack_1.default.log.info('Detected Laravel with Livewire');
+        (0, ui_1.getUI)().setDetectedFramework('Laravel with Livewire');
         return LaravelProjectType.LIVEWIRE;
     }
     // Default to standard
-    clack_1.default.log.info('Detected standard Laravel project');
+    (0, ui_1.getUI)().setDetectedFramework('Laravel');
     return LaravelProjectType.STANDARD;
 }
 /**

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/frameworks/laravel/utils.ts"],"names":[],"mappings":"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","sourcesContent":["import fg from 'fast-glob';\nimport { getUI } from '../../ui';\nimport type { WizardOptions } from '../../utils/types';\nimport { createVersionBucket } from '../../utils/semver';\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\n\nexport enum LaravelProjectType {\n  STANDARD = 'standard', // Basic Laravel app\n  INERTIA = 'inertia', // Inertia.js (Vue/React SPA) - may need JS SDK too\n  LIVEWIRE = 'livewire', // Livewire (reactive components, includes Filament)\n}\n\n/**\n * Ignore patterns for Laravel projects\n */\nconst LARAVEL_IGNORE_PATTERNS = [\n  '**/node_modules/**',\n  '**/vendor/**',\n  '**/storage/**',\n  '**/bootstrap/cache/**',\n  '**/.phpunit.cache/**',\n  '**/public/build/**',\n  '**/public/hot/**',\n];\n\n/**\n * Get Laravel version bucket for analytics\n */\nexport const getLaravelVersionBucket = createVersionBucket();\n\n/**\n * Read and parse composer.json\n */\nexport function getComposerJson(\n  options: Pick<WizardOptions, 'installDir'>,\n): Record<string, any> | undefined {\n  const { installDir } = options;\n\n  const composerPath = path.join(installDir, 'composer.json');\n  try {\n    const content = fs.readFileSync(composerPath, 'utf-8');\n    return JSON.parse(content);\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Check if a package is installed (present in composer.json)\n */\nfunction hasComposerPackage(\n  packageName: string,\n  options: Pick<WizardOptions, 'installDir'>,\n): boolean {\n  const composer = getComposerJson(options);\n  if (!composer) return false;\n\n  return !!(\n    composer.require?.[packageName] || composer['require-dev']?.[packageName]\n  );\n}\n\n/**\n * Extract version for a package from composer.json\n */\nfunction getComposerPackageVersion(\n  packageName: string,\n  options: Pick<WizardOptions, 'installDir'>,\n): string | undefined {\n  const composer = getComposerJson(options);\n  if (!composer) return undefined;\n\n  const version =\n    composer.require?.[packageName] || composer['require-dev']?.[packageName];\n  if (version) {\n    // Clean version string (remove ^, ~, >=, etc.)\n    return version.replace(/^[\\^~>=<]+/, '');\n  }\n\n  return undefined;\n}\n\n/**\n * Check if a pattern exists in PHP source files\n */\nasync function hasLaravelCodePattern(\n  pattern: RegExp | string,\n  options: Pick<WizardOptions, 'installDir'>,\n  filePatterns: string[] = ['**/*.php'],\n): Promise<boolean> {\n  const { installDir } = options;\n\n  const phpFiles = await fg(filePatterns, {\n    cwd: installDir,\n    ignore: LARAVEL_IGNORE_PATTERNS,\n  });\n\n  const searchPattern =\n    typeof pattern === 'string' ? new RegExp(pattern) : pattern;\n\n  for (const phpFile of phpFiles) {\n    try {\n      const content = fs.readFileSync(path.join(installDir, phpFile), 'utf-8');\n      if (searchPattern.test(content)) return true;\n    } catch {\n      continue;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Get Laravel version from composer.json\n */\nexport function getLaravelVersion(\n  options: Pick<WizardOptions, 'installDir'>,\n): string | undefined {\n  return getComposerPackageVersion('laravel/framework', options);\n}\n\n/**\n * Get human-readable name for Laravel project type\n */\nexport function getLaravelProjectTypeName(\n  projectType: LaravelProjectType,\n): string {\n  switch (projectType) {\n    case LaravelProjectType.STANDARD:\n      return 'Standard Laravel';\n    case LaravelProjectType.INERTIA:\n      return 'Laravel with Inertia.js';\n    case LaravelProjectType.LIVEWIRE:\n      return 'Laravel with Livewire';\n    default:\n      return 'Laravel';\n  }\n}\n\n/**\n * Check for Inertia.js\n */\nasync function hasInertia(\n  options: Pick<WizardOptions, 'installDir'>,\n): Promise<boolean> {\n  return (\n    hasComposerPackage('inertiajs/inertia-laravel', options) ||\n    (await hasLaravelCodePattern(/Inertia::render|inertia\\(/, options))\n  );\n}\n\n/**\n * Check for Livewire\n */\nasync function hasLivewire(\n  options: Pick<WizardOptions, 'installDir'>,\n): Promise<boolean> {\n  return (\n    hasComposerPackage('livewire/livewire', options) ||\n    (await hasLaravelCodePattern(/extends\\s+Component|@livewire/, options))\n  );\n}\n\n/**\n * Detect Laravel project type\n */\nexport async function getLaravelProjectType(\n  options: WizardOptions,\n): Promise<LaravelProjectType> {\n  // Check for SPA/Reactive frameworks (important to detect - affects SDK needs)\n  if (await hasInertia(options)) {\n    getUI().setDetectedFramework('Laravel with Inertia.js');\n    return LaravelProjectType.INERTIA;\n  }\n  if (await hasLivewire(options)) {\n    getUI().setDetectedFramework('Laravel with Livewire');\n    return LaravelProjectType.LIVEWIRE;\n  }\n\n  // Default to standard\n  getUI().setDetectedFramework('Laravel');\n  return LaravelProjectType.STANDARD;\n}\n\n/**\n * Find the main service provider file\n */\nexport async function findLaravelServiceProvider(\n  options: Pick<WizardOptions, 'installDir'>,\n): Promise<string | undefined> {\n  const { installDir } = options;\n\n  // Look for AppServiceProvider first (most common place for setup)\n  const appServiceProvider = path.join(\n    installDir,\n    'app/Providers/AppServiceProvider.php',\n  );\n\n  if (fs.existsSync(appServiceProvider)) {\n    return 'app/Providers/AppServiceProvider.php';\n  }\n\n  // Fall back to searching for any service provider\n  const providers = await fg(['**/app/Providers/*ServiceProvider.php'], {\n    cwd: installDir,\n    ignore: LARAVEL_IGNORE_PATTERNS,\n  });\n\n  return providers[0];\n}\n\n/**\n * Find the bootstrap file (differs between Laravel versions)\n */\nexport function findLaravelBootstrapFile(\n  options: Pick<WizardOptions, 'installDir'>,\n): string | undefined {\n  const { installDir } = options;\n\n  // Laravel 11+ uses bootstrap/app.php with new structure\n  const bootstrapApp = path.join(installDir, 'bootstrap/app.php');\n  if (fs.existsSync(bootstrapApp)) {\n    return 'bootstrap/app.php';\n  }\n\n  // Older Laravel uses app/Http/Kernel.php\n  const httpKernel = path.join(installDir, 'app/Http/Kernel.php');\n  if (fs.existsSync(httpKernel)) {\n    return 'app/Http/Kernel.php';\n  }\n\n  return undefined;\n}\n\n/**\n * Detect Laravel version structure for configuration guidance\n */\nexport function detectLaravelStructure(\n  options: Pick<WizardOptions, 'installDir'>,\n): 'legacy' | 'modern' | 'latest' {\n  const version = getLaravelVersion(options);\n  if (!version) return 'modern';\n\n  try {\n    const majorVersion = parseInt(version.split('.')[0], 10);\n    if (majorVersion >= 11) return 'latest'; // Laravel 11+ (new structure)\n    if (majorVersion >= 9) return 'modern'; // Laravel 9-10\n    return 'legacy'; // Laravel 8 and below\n  } catch {\n    return 'modern';\n  }\n}\n"]}

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

@@ -1,4 +1,4 @@
-import type { FrameworkConfig } from '../lib/framework-config';
+import type { FrameworkConfig } from '../../lib/framework-config';
 import { NextJsRouter } from './utils';
 type NextjsContext = {
     router?: NextJsRouter;

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

@@ -1,10 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NEXTJS_AGENT_CONFIG = void 0;
-const package_manager_detection_1 = require("../lib/package-manager-detection");
-const constants_1 = require("../lib/constants");
-const package_json_1 = require("../utils/package-json");
-const clack_utils_1 = require("../utils/clack-utils");
+const package_manager_detection_1 = require("../../lib/package-manager-detection");
+const constants_1 = require("../../lib/constants");
+const package_json_1 = require("../../utils/package-json");
+const setup_utils_1 = require("../../utils/setup-utils");
+const ui_1 = require("../../ui");
 const utils_1 = require("./utils");
 exports.NEXTJS_AGENT_CONFIG = {
     metadata: {
@@ -14,7 +15,28 @@ exports.NEXTJS_AGENT_CONFIG = {
         unsupportedVersionDocsUrl: 'https://posthog.com/docs/libraries/next-js',
         gatherContext: async (options) => {
             const router = await (0, utils_1.getNextJsRouter)(options);
-            return { router };
+            if (router) {
+                const emoji = router === utils_1.NextJsRouter.APP_ROUTER ? '\u{1F4F1}' : '\u{1F4C3}';
+                (0, ui_1.getUI)().setDetectedFramework(`Next.js ${(0, utils_1.getNextJsRouterName)(router)} ${emoji}`);
+                return { router };
+            }
+            return {};
+        },
+        setup: {
+            questions: [
+                {
+                    key: 'router',
+                    message: 'Which Next.js router are you using?',
+                    options: [
+                        { label: 'App Router', value: utils_1.NextJsRouter.APP_ROUTER },
+                        { label: 'Pages Router', value: utils_1.NextJsRouter.PAGES_ROUTER },
+                    ],
+                    detect: async (opts) => {
+                        const result = await (0, utils_1.getNextJsRouter)(opts);
+                        return result;
+                    },
+                },
+            ],
         },
     },
     detection: {
@@ -24,11 +46,11 @@ exports.NEXTJS_AGENT_CONFIG = {
         getVersionBucket: utils_1.getNextJsVersionBucket,
         minimumVersion: '15.3.0',
         getInstalledVersion: async (options) => {
-            const packageJson = await (0, clack_utils_1.getPackageDotJson)(options);
-            return (0, package_json_1.getPackageVersion)('next', packageJson);
+            const packageJson = await (0, setup_utils_1.tryGetPackageJson)(options);
+            return packageJson ? (0, package_json_1.getPackageVersion)('next', packageJson) : undefined;
         },
         detect: async (options) => {
-            const packageJson = await (0, clack_utils_1.tryGetPackageJson)(options);
+            const packageJson = await (0, setup_utils_1.tryGetPackageJson)(options);
             return packageJson ? (0, package_json_1.hasPackageInstalled)('next', packageJson) : false;
         },
         detectPackageManager: package_manager_detection_1.detectNodePackageManagers,

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

@@ -0,0 +1 @@
+{"version":3,"file":"nextjs-wizard-agent.js","sourceRoot":"","sources":["../../../../src/frameworks/nextjs/nextjs-wizard-agent.ts"],"names":[],"mappings":"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","sourcesContent":["/* Simplified Next.js wizard using posthog-agent with PostHog MCP */\nimport type { WizardOptions } from '../../utils/types';\nimport type { FrameworkConfig } from '../../lib/framework-config';\nimport { detectNodePackageManagers } from '../../lib/package-manager-detection';\nimport { Integration } from '../../lib/constants';\nimport {\n  getPackageVersion,\n  hasPackageInstalled,\n  type PackageDotJson,\n} from '../../utils/package-json';\nimport { tryGetPackageJson } from '../../utils/setup-utils';\nimport { getUI } from '../../ui';\nimport {\n  getNextJsRouter,\n  getNextJsVersionBucket,\n  getNextJsRouterName,\n  NextJsRouter,\n} from './utils';\n\ntype NextjsContext = {\n  router?: NextJsRouter;\n};\n\nexport const NEXTJS_AGENT_CONFIG: FrameworkConfig<NextjsContext> = {\n  metadata: {\n    name: 'Next.js',\n    integration: Integration.nextjs,\n    docsUrl: 'https://posthog.com/docs/libraries/next-js',\n    unsupportedVersionDocsUrl: 'https://posthog.com/docs/libraries/next-js',\n    gatherContext: async (options: WizardOptions) => {\n      const router = await getNextJsRouter(options);\n      if (router) {\n        const emoji =\n          router === NextJsRouter.APP_ROUTER ? '\\u{1F4F1}' : '\\u{1F4C3}';\n        getUI().setDetectedFramework(\n          `Next.js ${getNextJsRouterName(router)} ${emoji}`,\n        );\n        return { router };\n      }\n      return {};\n    },\n    setup: {\n      questions: [\n        {\n          key: 'router',\n          message: 'Which Next.js router are you using?',\n          options: [\n            { label: 'App Router', value: NextJsRouter.APP_ROUTER },\n            { label: 'Pages Router', value: NextJsRouter.PAGES_ROUTER },\n          ],\n          detect: async (opts) => {\n            const result = await getNextJsRouter(opts);\n            return result;\n          },\n        },\n      ],\n    },\n  },\n\n  detection: {\n    packageName: 'next',\n    packageDisplayName: 'Next.js',\n    getVersion: (packageJson: unknown) =>\n      getPackageVersion('next', packageJson as PackageDotJson),\n    getVersionBucket: getNextJsVersionBucket,\n    minimumVersion: '15.3.0',\n    getInstalledVersion: async (options: WizardOptions) => {\n      const packageJson = await tryGetPackageJson(options);\n      return packageJson ? getPackageVersion('next', packageJson) : undefined;\n    },\n    detect: async (options) => {\n      const packageJson = await tryGetPackageJson(options);\n      return packageJson ? hasPackageInstalled('next', packageJson) : false;\n    },\n    detectPackageManager: detectNodePackageManagers,\n  },\n\n  environment: {\n    uploadToHosting: true,\n    getEnvVars: (apiKey: string, host: string) => ({\n      NEXT_PUBLIC_POSTHOG_KEY: apiKey,\n      NEXT_PUBLIC_POSTHOG_HOST: host,\n    }),\n  },\n\n  analytics: {\n    getTags: (context) => ({\n      router: context.router === NextJsRouter.APP_ROUTER ? 'app' : 'pages',\n    }),\n  },\n\n  prompts: {\n    projectTypeDetection:\n      'This is a JavaScript/TypeScript project. Look for package.json and lockfiles (package-lock.json, yarn.lock, pnpm-lock.yaml, bun.lockb) to confirm.',\n    getAdditionalContextLines: (context) => {\n      const routerType =\n        context.router === NextJsRouter.APP_ROUTER ? 'app' : 'pages';\n      return [`Router: ${routerType}`];\n    },\n  },\n\n  ui: {\n    successMessage: 'PostHog integration complete',\n    estimatedDurationMinutes: 8,\n    getOutroChanges: (context) => {\n      const router = context.router ?? NextJsRouter.APP_ROUTER;\n      const routerName = getNextJsRouterName(router);\n      return [\n        `Analyzed your Next.js project structure (${routerName})`,\n        `Created and configured PostHog initializers`,\n        `Integrated PostHog into your application`,\n      ];\n    },\n    getOutroNextSteps: () => {\n      return [\n        'Start your development server to see PostHog in action',\n        'Visit your PostHog dashboard to see incoming events',\n      ];\n    },\n  },\n};\n"]}

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

@@ -1,9 +1,12 @@
-import type { WizardOptions } from '../utils/types';
+import type { WizardOptions } from '../../utils/types';
 export declare const getNextJsVersionBucket: (version: string | undefined) => string;
 export declare enum NextJsRouter {
     APP_ROUTER = "app-router",
     PAGES_ROUTER = "pages-router"
 }
 export declare const IGNORE_PATTERNS: string[];
-export declare function getNextJsRouter({ installDir, }: Pick<WizardOptions, 'installDir'>): Promise<NextJsRouter>;
+/**
+ * Detect Next.js router type. Pure — returns null if ambiguous.
+ */
+export declare function getNextJsRouter({ installDir, }: Pick<WizardOptions, 'installDir'>): Promise<NextJsRouter | null>;
 export declare const getNextJsRouterName: (router: NextJsRouter) => "app router" | "pages router";

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

@@ -6,10 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getNextJsRouterName = exports.IGNORE_PATTERNS = exports.NextJsRouter = exports.getNextJsVersionBucket = void 0;
 exports.getNextJsRouter = getNextJsRouter;
 const fast_glob_1 = __importDefault(require("fast-glob"));
-const clack_utils_1 = require("../utils/clack-utils");
-const clack_1 = __importDefault(require("../utils/clack"));
-const constants_1 = require("../lib/constants");
-const semver_1 = require("../utils/semver");
+const semver_1 = require("../../utils/semver");
 exports.getNextJsVersionBucket = (0, semver_1.createVersionBucket)();
 var NextJsRouter;
 (function (NextJsRouter) {
@@ -23,6 +20,9 @@ exports.IGNORE_PATTERNS = [
     '**/public/**',
     '**/.next/**',
 ];
+/**
+ * Detect Next.js router type. Pure — returns null if ambiguous.
+ */
 async function getNextJsRouter({ installDir, }) {
     const pagesMatches = await (0, fast_glob_1.default)('**/pages/_app.@(ts|tsx|js|jsx)', {
         dot: true,
@@ -37,27 +37,13 @@ async function getNextJsRouter({ installDir, }) {
     });
     const hasAppDir = appMatches.length > 0;
     if (hasPagesDir && !hasAppDir) {
-        clack_1.default.log.info(`Detected ${(0, exports.getNextJsRouterName)(NextJsRouter.PAGES_ROUTER)} 📃`);
         return NextJsRouter.PAGES_ROUTER;
     }
     if (hasAppDir && !hasPagesDir) {
-        clack_1.default.log.info(`Detected ${(0, exports.getNextJsRouterName)(NextJsRouter.APP_ROUTER)} 📱`);
         return NextJsRouter.APP_ROUTER;
     }
-    const result = await (0, clack_utils_1.abortIfCancelled)(clack_1.default.select({
-        message: 'What router are you using?',
-        options: [
-            {
-                label: (0, exports.getNextJsRouterName)(NextJsRouter.APP_ROUTER),
-                value: NextJsRouter.APP_ROUTER,
-            },
-            {
-                label: (0, exports.getNextJsRouterName)(NextJsRouter.PAGES_ROUTER),
-                value: NextJsRouter.PAGES_ROUTER,
-            },
-        ],
-    }), constants_1.Integration.nextjs);
-    return result;
+    // Ambiguous (both or neither) — return null, SetupScreen handles it
+    return null;
 }
 const getNextJsRouterName = (router) => {
     return router === NextJsRouter.APP_ROUTER ? 'app router' : 'pages router';

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/frameworks/nextjs/utils.ts"],"names":[],"mappings":";;;;;;AAsBA,0CA6BC;AAnDD,0DAA2B;AAE3B,+CAAyD;AAE5C,QAAA,sBAAsB,GAAG,IAAA,4BAAmB,GAAE,CAAC;AAE5D,IAAY,YAGX;AAHD,WAAY,YAAY;IACtB,yCAAyB,CAAA;IACzB,6CAA6B,CAAA;AAC/B,CAAC,EAHW,YAAY,4BAAZ,YAAY,QAGvB;AAEY,QAAA,eAAe,GAAG;IAC7B,oBAAoB;IACpB,YAAY;IACZ,aAAa;IACb,cAAc;IACd,aAAa;CACd,CAAC;AAEF;;GAEG;AACI,KAAK,UAAU,eAAe,CAAC,EACpC,UAAU,GACwB;IAClC,MAAM,YAAY,GAAG,MAAM,IAAA,mBAAE,EAAC,gCAAgC,EAAE;QAC9D,GAAG,EAAE,IAAI;QACT,GAAG,EAAE,UAAU;QACf,MAAM,EAAE,uBAAe;KACxB,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;IAE5C,MAAM,UAAU,GAAG,MAAM,IAAA,mBAAE,EAAC,mCAAmC,EAAE;QAC/D,GAAG,EAAE,IAAI;QACT,GAAG,EAAE,UAAU;QACf,MAAM,EAAE,uBAAe;KACxB,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;IAExC,IAAI,WAAW,IAAI,CAAC,SAAS,EAAE,CAAC;QAC9B,OAAO,YAAY,CAAC,YAAY,CAAC;IACnC,CAAC;IAED,IAAI,SAAS,IAAI,CAAC,WAAW,EAAE,CAAC;QAC9B,OAAO,YAAY,CAAC,UAAU,CAAC;IACjC,CAAC;IAED,oEAAoE;IACpE,OAAO,IAAI,CAAC;AACd,CAAC;AAEM,MAAM,mBAAmB,GAAG,CAAC,MAAoB,EAAE,EAAE;IAC1D,OAAO,MAAM,KAAK,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,cAAc,CAAC;AAC5E,CAAC,CAAC;AAFW,QAAA,mBAAmB,uBAE9B","sourcesContent":["import fg from 'fast-glob';\nimport type { WizardOptions } from '../../utils/types';\nimport { createVersionBucket } from '../../utils/semver';\n\nexport const getNextJsVersionBucket = createVersionBucket();\n\nexport enum NextJsRouter {\n  APP_ROUTER = 'app-router',\n  PAGES_ROUTER = 'pages-router',\n}\n\nexport const IGNORE_PATTERNS = [\n  '**/node_modules/**',\n  '**/dist/**',\n  '**/build/**',\n  '**/public/**',\n  '**/.next/**',\n];\n\n/**\n * Detect Next.js router type. Pure — returns null if ambiguous.\n */\nexport async function getNextJsRouter({\n  installDir,\n}: Pick<WizardOptions, 'installDir'>): Promise<NextJsRouter | null> {\n  const pagesMatches = await fg('**/pages/_app.@(ts|tsx|js|jsx)', {\n    dot: true,\n    cwd: installDir,\n    ignore: IGNORE_PATTERNS,\n  });\n\n  const hasPagesDir = pagesMatches.length > 0;\n\n  const appMatches = await fg('**/app/**/layout.@(ts|tsx|js|jsx)', {\n    dot: true,\n    cwd: installDir,\n    ignore: IGNORE_PATTERNS,\n  });\n\n  const hasAppDir = appMatches.length > 0;\n\n  if (hasPagesDir && !hasAppDir) {\n    return NextJsRouter.PAGES_ROUTER;\n  }\n\n  if (hasAppDir && !hasPagesDir) {\n    return NextJsRouter.APP_ROUTER;\n  }\n\n  // Ambiguous (both or neither) — return null, SetupScreen handles it\n  return null;\n}\n\nexport const getNextJsRouterName = (router: NextJsRouter) => {\n  return router === NextJsRouter.APP_ROUTER ? 'app router' : 'pages router';\n};\n"]}

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

@@ -1,4 +1,4 @@
-import type { FrameworkConfig } from '../lib/framework-config';
+import type { FrameworkConfig } from '../../lib/framework-config';
 type NuxtContext = {
     versionBucket?: string;
 };

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

@@ -1,11 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NUXT_AGENT_CONFIG = void 0;
-const package_manager_detection_1 = require("../lib/package-manager-detection");
-const constants_1 = require("../lib/constants");
-const package_json_1 = require("../utils/package-json");
-const clack_utils_1 = require("../utils/clack-utils");
-const semver_1 = require("../utils/semver");
+const package_manager_detection_1 = require("../../lib/package-manager-detection");
+const constants_1 = require("../../lib/constants");
+const package_json_1 = require("../../utils/package-json");
+const setup_utils_1 = require("../../utils/setup-utils");
+const semver_1 = require("../../utils/semver");
 const getNuxtVersionBucket = (0, semver_1.createVersionBucket)();
 exports.NUXT_AGENT_CONFIG = {
     metadata: {
@@ -14,7 +14,9 @@ exports.NUXT_AGENT_CONFIG = {
         docsUrl: 'https://posthog.com/docs/libraries/nuxt',
         beta: true,
         gatherContext: async (options) => {
-            const packageJson = await (0, clack_utils_1.getPackageDotJson)(options);
+            const packageJson = await (0, setup_utils_1.tryGetPackageJson)(options);
+            if (!packageJson)
+                return {};
             const version = (0, package_json_1.getPackageVersion)('nuxt', packageJson);
             const versionBucket = getNuxtVersionBucket(version);
             return { versionBucket };
@@ -26,11 +28,11 @@ exports.NUXT_AGENT_CONFIG = {
         getVersion: (packageJson) => (0, package_json_1.getPackageVersion)('nuxt', packageJson),
         getVersionBucket: getNuxtVersionBucket,
         getInstalledVersion: async (options) => {
-            const packageJson = await (0, clack_utils_1.getPackageDotJson)(options);
-            return (0, package_json_1.getPackageVersion)('nuxt', packageJson);
+            const packageJson = await (0, setup_utils_1.tryGetPackageJson)(options);
+            return packageJson ? (0, package_json_1.getPackageVersion)('nuxt', packageJson) : undefined;
         },
         detect: async (options) => {
-            const packageJson = await (0, clack_utils_1.tryGetPackageJson)(options);
+            const packageJson = await (0, setup_utils_1.tryGetPackageJson)(options);
             return packageJson ? (0, package_json_1.hasPackageInstalled)('nuxt', packageJson) : false;
         },
         detectPackageManager: package_manager_detection_1.detectNodePackageManagers,

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

@@ -0,0 +1 @@
+{"version":3,"file":"nuxt-wizard-agent.js","sourceRoot":"","sources":["../../../../src/frameworks/nuxt/nuxt-wizard-agent.ts"],"names":[],"mappings":"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","sourcesContent":["/* Nuxt wizard using posthog-agent with PostHog MCP */\nimport type { WizardOptions } from '../../utils/types';\nimport type { FrameworkConfig } from '../../lib/framework-config';\nimport { detectNodePackageManagers } from '../../lib/package-manager-detection';\nimport { Integration } from '../../lib/constants';\nimport {\n  getPackageVersion,\n  hasPackageInstalled,\n  type PackageDotJson,\n} from '../../utils/package-json';\nimport { tryGetPackageJson } from '../../utils/setup-utils';\nimport { createVersionBucket } from '../../utils/semver';\n\nconst getNuxtVersionBucket = createVersionBucket();\n\ntype NuxtContext = {\n  versionBucket?: string;\n};\n\nexport const NUXT_AGENT_CONFIG: FrameworkConfig<NuxtContext> = {\n  metadata: {\n    name: 'Nuxt',\n    integration: Integration.nuxt,\n    docsUrl: 'https://posthog.com/docs/libraries/nuxt',\n    beta: true,\n    gatherContext: async (options: WizardOptions) => {\n      const packageJson = await tryGetPackageJson(options);\n      if (!packageJson) return {};\n      const version = getPackageVersion('nuxt', packageJson);\n      const versionBucket = getNuxtVersionBucket(version);\n      return { versionBucket };\n    },\n  },\n\n  detection: {\n    packageName: 'nuxt',\n    packageDisplayName: 'Nuxt',\n    getVersion: (packageJson: unknown) =>\n      getPackageVersion('nuxt', packageJson as PackageDotJson),\n    getVersionBucket: getNuxtVersionBucket,\n    getInstalledVersion: async (options: WizardOptions) => {\n      const packageJson = await tryGetPackageJson(options);\n      return packageJson ? getPackageVersion('nuxt', packageJson) : undefined;\n    },\n    detect: async (options) => {\n      const packageJson = await tryGetPackageJson(options);\n      return packageJson ? hasPackageInstalled('nuxt', packageJson) : false;\n    },\n    detectPackageManager: detectNodePackageManagers,\n  },\n\n  environment: {\n    uploadToHosting: true,\n    getEnvVars: (apiKey: string, host: string) => ({\n      NUXT_PUBLIC_POSTHOG_KEY: apiKey,\n      NUXT_PUBLIC_POSTHOG_HOST: host,\n    }),\n  },\n\n  analytics: {\n    getTags: (context) => ({\n      ...(context.versionBucket\n        ? { versionBucket: context.versionBucket }\n        : {}),\n    }),\n  },\n\n  prompts: {\n    projectTypeDetection:\n      'This is a JavaScript/TypeScript project. Look for package.json and lockfiles (package-lock.json, yarn.lock, pnpm-lock.yaml, bun.lockb) to confirm.',\n    getAdditionalContextLines: (context) => {\n      const lines: string[] = [];\n      if (context.versionBucket) {\n        lines.push(`Nuxt version: ${context.versionBucket}`);\n      }\n      const frameworkId = 'nuxt';\n      lines.push(\n        `Framework docs ID: ${frameworkId} (use posthog://docs/frameworks/${frameworkId} for documentation)`,\n      );\n      return lines;\n    },\n  },\n\n  ui: {\n    successMessage: 'PostHog integration complete',\n    estimatedDurationMinutes: 5,\n    getOutroChanges: () => [\n      'Analyzed your Nuxt project structure',\n      'Configured PostHog module/plugin',\n      'Integrated PostHog into your application',\n    ],\n    getOutroNextSteps: () => [\n      'Start your development server to see PostHog in action',\n      'Visit your PostHog dashboard to see incoming events',\n    ],\n  },\n};\n"]}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -1,10 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.REACT_NATIVE_AGENT_CONFIG = void 0;
-const package_manager_detection_1 = require("../lib/package-manager-detection");
-const constants_1 = require("../lib/constants");
-const package_json_1 = require("../utils/package-json");
-const clack_utils_1 = require("../utils/clack-utils");
+const package_manager_detection_1 = require("../../lib/package-manager-detection");
+const constants_1 = require("../../lib/constants");
+const package_json_1 = require("../../utils/package-json");
+const setup_utils_1 = require("../../utils/setup-utils");
 const utils_1 = require("./utils");
 exports.REACT_NATIVE_AGENT_CONFIG = {
     metadata: {
@@ -23,11 +23,13 @@ exports.REACT_NATIVE_AGENT_CONFIG = {
         getVersionBucket: utils_1.getReactNativeVersionBucket,
         minimumVersion: '0.73.0',
         getInstalledVersion: async (options) => {
-            const packageJson = await (0, clack_utils_1.getPackageDotJson)(options);
-            return (0, package_json_1.getPackageVersion)('react-native', packageJson);
+            const packageJson = await (0, setup_utils_1.tryGetPackageJson)(options);
+            return packageJson
+                ? (0, package_json_1.getPackageVersion)('react-native', packageJson)
+                : undefined;
         },
         detect: async (options) => {
-            const packageJson = await (0, clack_utils_1.tryGetPackageJson)(options);
+            const packageJson = await (0, setup_utils_1.tryGetPackageJson)(options);
             return packageJson
                 ? (0, package_json_1.hasPackageInstalled)('react-native', packageJson)
                 : false;

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

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

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

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