@posthog/wizard 1.31.1 → 1.32.0

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

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/django/utils.ts"],"names":[],"mappings":"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","sourcesContent":["import { major, minVersion } from 'semver';\nimport fg from 'fast-glob';\nimport clack from '../utils/clack';\nimport type { WizardOptions } from '../utils/types';\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\n\nexport enum DjangoProjectType {\n  STANDARD = 'standard', // Traditional Django project (django-admin startproject)\n  DRF = 'drf', // Django REST Framework API\n  WAGTAIL = 'wagtail', // Wagtail CMS\n  CHANNELS = 'channels', // Django Channels (async/websockets)\n}\n\nconst IGNORE_PATTERNS = [\n  '**/node_modules/**',\n  '**/dist/**',\n  '**/build/**',\n  '**/venv/**',\n  '**/.venv/**',\n  '**/env/**',\n  '**/.env/**',\n  '**/__pycache__/**',\n  '**/migrations/**',\n];\n\n/**\n * Get Django version bucket for analytics\n */\nexport function getDjangoVersionBucket(version: string | undefined): string {\n  if (!version) {\n    return 'none';\n  }\n\n  try {\n    const minVer = minVersion(version);\n    if (!minVer) {\n      return 'invalid';\n    }\n    const majorVersion = major(minVer);\n    if (majorVersion >= 3) {\n      return `${majorVersion}.x`;\n    }\n    return `<3.0.0`;\n  } catch {\n    return 'unknown';\n  }\n}\n\n/**\n * Extract Django version from requirements files or pyproject.toml\n */\nexport async function getDjangoVersion(\n  options: Pick<WizardOptions, 'installDir'>,\n): Promise<string | undefined> {\n  const { installDir } = options;\n\n  // Check requirements files\n  const requirementsFiles = await fg(\n    ['**/requirements*.txt', '**/pyproject.toml', '**/setup.py', '**/Pipfile'],\n    {\n      cwd: installDir,\n      ignore: IGNORE_PATTERNS,\n    },\n  );\n\n  for (const reqFile of requirementsFiles) {\n    try {\n      const content = fs.readFileSync(path.join(installDir, reqFile), 'utf-8');\n\n      // Try to extract version from requirements.txt format (Django==4.2.0 or Django>=4.0)\n      const requirementsMatch = content.match(\n        /[Dd]jango[=<>~!]+([0-9]+\\.[0-9]+(?:\\.[0-9]+)?)/,\n      );\n      if (requirementsMatch) {\n        return requirementsMatch[1];\n      }\n\n      // Try to extract from pyproject.toml format\n      const pyprojectMatch = content.match(\n        /[Dd]jango[\"\\s]*[=<>~!]+\\s*[\"']?([0-9]+\\.[0-9]+(?:\\.[0-9]+)?)/,\n      );\n      if (pyprojectMatch) {\n        return pyprojectMatch[1];\n      }\n    } catch {\n      // Skip files that can't be read\n      continue;\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Check if Django REST Framework is installed\n */\nasync function hasDRF({\n  installDir,\n}: Pick<WizardOptions, 'installDir'>): Promise<boolean> {\n  const requirementsFiles = await fg(\n    ['**/requirements*.txt', '**/pyproject.toml', '**/Pipfile'],\n    {\n      cwd: installDir,\n      ignore: IGNORE_PATTERNS,\n    },\n  );\n\n  for (const reqFile of requirementsFiles) {\n    try {\n      const content = fs.readFileSync(path.join(installDir, reqFile), 'utf-8');\n      if (content.includes('djangorestframework')) {\n        return true;\n      }\n    } catch {\n      continue;\n    }\n  }\n\n  // Also check INSTALLED_APPS in settings\n  const settingsFiles = await fg('**/settings.py', {\n    cwd: installDir,\n    ignore: IGNORE_PATTERNS,\n  });\n\n  for (const settingsFile of settingsFiles) {\n    try {\n      const content = fs.readFileSync(\n        path.join(installDir, settingsFile),\n        'utf-8',\n      );\n      if (content.includes('rest_framework')) {\n        return true;\n      }\n    } catch {\n      continue;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Check if Wagtail is installed\n */\nasync function hasWagtail({\n  installDir,\n}: Pick<WizardOptions, 'installDir'>): Promise<boolean> {\n  const requirementsFiles = await fg(\n    ['**/requirements*.txt', '**/pyproject.toml', '**/Pipfile'],\n    {\n      cwd: installDir,\n      ignore: IGNORE_PATTERNS,\n    },\n  );\n\n  for (const reqFile of requirementsFiles) {\n    try {\n      const content = fs.readFileSync(path.join(installDir, reqFile), 'utf-8');\n      if (content.includes('wagtail')) {\n        return true;\n      }\n    } catch {\n      continue;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Check if Django Channels is installed\n */\nasync function hasChannels({\n  installDir,\n}: Pick<WizardOptions, 'installDir'>): Promise<boolean> {\n  const requirementsFiles = await fg(\n    ['**/requirements*.txt', '**/pyproject.toml', '**/Pipfile'],\n    {\n      cwd: installDir,\n      ignore: IGNORE_PATTERNS,\n    },\n  );\n\n  for (const reqFile of requirementsFiles) {\n    try {\n      const content = fs.readFileSync(path.join(installDir, reqFile), 'utf-8');\n      if (content.includes('channels')) {\n        return true;\n      }\n    } catch {\n      continue;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Detect Django project type\n */\nexport async function getDjangoProjectType(\n  options: WizardOptions,\n): Promise<DjangoProjectType> {\n  const { installDir } = options;\n\n  // Check for Wagtail first (CMS)\n  if (await hasWagtail({ installDir })) {\n    clack.log.info('Detected Django with Wagtail CMS');\n    return DjangoProjectType.WAGTAIL;\n  }\n\n  // Check for Django REST Framework\n  if (await hasDRF({ installDir })) {\n    clack.log.info('Detected Django REST Framework project');\n    return DjangoProjectType.DRF;\n  }\n\n  // Check for Django Channels\n  if (await hasChannels({ installDir })) {\n    clack.log.info('Detected Django Channels project');\n    return DjangoProjectType.CHANNELS;\n  }\n\n  // Default to standard Django\n  clack.log.info('Detected standard Django project');\n  return DjangoProjectType.STANDARD;\n}\n\n/**\n * Get human-readable name for Django project type\n */\nexport function getDjangoProjectTypeName(\n  projectType: DjangoProjectType,\n): string {\n  switch (projectType) {\n    case DjangoProjectType.STANDARD:\n      return 'Standard Django';\n    case DjangoProjectType.DRF:\n      return 'Django REST Framework';\n    case DjangoProjectType.WAGTAIL:\n      return 'Wagtail CMS';\n    case DjangoProjectType.CHANNELS:\n      return 'Django Channels';\n  }\n}\n\n/**\n * Find the main Django settings file\n */\nexport async function findDjangoSettingsFile(\n  options: Pick<WizardOptions, 'installDir'>,\n): Promise<string | undefined> {\n  const { installDir } = options;\n\n  // Look for settings.py files\n  const settingsFiles = await fg('**/settings.py', {\n    cwd: installDir,\n    ignore: IGNORE_PATTERNS,\n  });\n\n  if (settingsFiles.length === 0) {\n    // Try settings/__init__.py for split settings\n    const splitSettingsFiles = await fg('**/settings/__init__.py', {\n      cwd: installDir,\n      ignore: IGNORE_PATTERNS,\n    });\n\n    if (splitSettingsFiles.length > 0) {\n      return splitSettingsFiles[0];\n    }\n\n    return undefined;\n  }\n\n  // If multiple settings files, prefer the one next to manage.py or in root\n  if (settingsFiles.length === 1) {\n    return settingsFiles[0];\n  }\n\n  // Try to find the main settings file by looking for ROOT_URLCONF\n  for (const settingsFile of settingsFiles) {\n    try {\n      const content = fs.readFileSync(\n        path.join(installDir, settingsFile),\n        'utf-8',\n      );\n      if (content.includes('ROOT_URLCONF')) {\n        return settingsFile;\n      }\n    } catch {\n      continue;\n    }\n  }\n\n  // Default to first found\n  return settingsFiles[0];\n}\n\n/**\n * Find the main Django urls.py file\n */\nexport async function findDjangoUrlsFile(\n  options: Pick<WizardOptions, 'installDir'>,\n): Promise<string | undefined> {\n  const { installDir } = options;\n\n  // First, try to find the root urls.py referenced in settings\n  const settingsFile = await findDjangoSettingsFile(options);\n  if (settingsFile) {\n    try {\n      const settingsContent = fs.readFileSync(\n        path.join(installDir, settingsFile),\n        'utf-8',\n      );\n      const urlconfMatch = settingsContent.match(\n        /ROOT_URLCONF\\s*=\\s*['\"]([^'\"]+)['\"]/,\n      );\n      if (urlconfMatch) {\n        const urlconfPath = urlconfMatch[1].replace(/\\./g, '/') + '.py';\n        const fullPath = path.join(installDir, urlconfPath);\n        if (fs.existsSync(fullPath)) {\n          return urlconfPath;\n        }\n      }\n    } catch {\n      // Fall through to glob search\n    }\n  }\n\n  // Fallback to glob search\n  const urlsFiles = await fg('**/urls.py', {\n    cwd: installDir,\n    ignore: [...IGNORE_PATTERNS, '**/admin/**'],\n  });\n\n  if (urlsFiles.length === 0) {\n    return undefined;\n  }\n\n  // Prefer urls.py files that contain urlpatterns\n  for (const urlsFile of urlsFiles) {\n    try {\n      const content = fs.readFileSync(path.join(installDir, urlsFile), 'utf-8');\n      if (content.includes('urlpatterns')) {\n        return urlsFile;\n      }\n    } catch {\n      continue;\n    }\n  }\n\n  return urlsFiles[0];\n}\n"]}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/django/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 DjangoProjectType {\n  STANDARD = 'standard', // Traditional Django project (django-admin startproject)\n  DRF = 'drf', // Django REST Framework API\n  WAGTAIL = 'wagtail', // Wagtail CMS\n  CHANNELS = 'channels', // Django Channels (async/websockets)\n}\n\nconst IGNORE_PATTERNS = [\n  '**/node_modules/**',\n  '**/dist/**',\n  '**/build/**',\n  '**/venv/**',\n  '**/.venv/**',\n  '**/env/**',\n  '**/.env/**',\n  '**/__pycache__/**',\n  '**/migrations/**',\n];\n\n/**\n * Get Django version bucket for analytics\n */\nexport const getDjangoVersionBucket = createVersionBucket();\n\n/**\n * Extract Django version from requirements files or pyproject.toml\n */\nexport async function getDjangoVersion(\n  options: Pick<WizardOptions, 'installDir'>,\n): Promise<string | undefined> {\n  const { installDir } = options;\n\n  // Check requirements files\n  const requirementsFiles = await fg(\n    ['**/requirements*.txt', '**/pyproject.toml', '**/setup.py', '**/Pipfile'],\n    {\n      cwd: installDir,\n      ignore: IGNORE_PATTERNS,\n    },\n  );\n\n  for (const reqFile of requirementsFiles) {\n    try {\n      const content = fs.readFileSync(path.join(installDir, reqFile), 'utf-8');\n\n      // Try to extract version from requirements.txt format (Django==4.2.0 or Django>=4.0)\n      const requirementsMatch = content.match(\n        /[Dd]jango[=<>~!]+([0-9]+\\.[0-9]+(?:\\.[0-9]+)?)/,\n      );\n      if (requirementsMatch) {\n        return requirementsMatch[1];\n      }\n\n      // Try to extract from pyproject.toml format\n      const pyprojectMatch = content.match(\n        /[Dd]jango[\"\\s]*[=<>~!]+\\s*[\"']?([0-9]+\\.[0-9]+(?:\\.[0-9]+)?)/,\n      );\n      if (pyprojectMatch) {\n        return pyprojectMatch[1];\n      }\n    } catch {\n      // Skip files that can't be read\n      continue;\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Check if Django REST Framework is installed\n */\nasync function hasDRF({\n  installDir,\n}: Pick<WizardOptions, 'installDir'>): Promise<boolean> {\n  const requirementsFiles = await fg(\n    ['**/requirements*.txt', '**/pyproject.toml', '**/Pipfile'],\n    {\n      cwd: installDir,\n      ignore: IGNORE_PATTERNS,\n    },\n  );\n\n  for (const reqFile of requirementsFiles) {\n    try {\n      const content = fs.readFileSync(path.join(installDir, reqFile), 'utf-8');\n      if (content.includes('djangorestframework')) {\n        return true;\n      }\n    } catch {\n      continue;\n    }\n  }\n\n  // Also check INSTALLED_APPS in settings\n  const settingsFiles = await fg('**/settings.py', {\n    cwd: installDir,\n    ignore: IGNORE_PATTERNS,\n  });\n\n  for (const settingsFile of settingsFiles) {\n    try {\n      const content = fs.readFileSync(\n        path.join(installDir, settingsFile),\n        'utf-8',\n      );\n      if (content.includes('rest_framework')) {\n        return true;\n      }\n    } catch {\n      continue;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Check if Wagtail is installed\n */\nasync function hasWagtail({\n  installDir,\n}: Pick<WizardOptions, 'installDir'>): Promise<boolean> {\n  const requirementsFiles = await fg(\n    ['**/requirements*.txt', '**/pyproject.toml', '**/Pipfile'],\n    {\n      cwd: installDir,\n      ignore: IGNORE_PATTERNS,\n    },\n  );\n\n  for (const reqFile of requirementsFiles) {\n    try {\n      const content = fs.readFileSync(path.join(installDir, reqFile), 'utf-8');\n      if (content.includes('wagtail')) {\n        return true;\n      }\n    } catch {\n      continue;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Check if Django Channels is installed\n */\nasync function hasChannels({\n  installDir,\n}: Pick<WizardOptions, 'installDir'>): Promise<boolean> {\n  const requirementsFiles = await fg(\n    ['**/requirements*.txt', '**/pyproject.toml', '**/Pipfile'],\n    {\n      cwd: installDir,\n      ignore: IGNORE_PATTERNS,\n    },\n  );\n\n  for (const reqFile of requirementsFiles) {\n    try {\n      const content = fs.readFileSync(path.join(installDir, reqFile), 'utf-8');\n      if (content.includes('channels')) {\n        return true;\n      }\n    } catch {\n      continue;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Detect Django project type\n */\nexport async function getDjangoProjectType(\n  options: WizardOptions,\n): Promise<DjangoProjectType> {\n  const { installDir } = options;\n\n  // Check for Wagtail first (CMS)\n  if (await hasWagtail({ installDir })) {\n    clack.log.info('Detected Django with Wagtail CMS');\n    return DjangoProjectType.WAGTAIL;\n  }\n\n  // Check for Django REST Framework\n  if (await hasDRF({ installDir })) {\n    clack.log.info('Detected Django REST Framework project');\n    return DjangoProjectType.DRF;\n  }\n\n  // Check for Django Channels\n  if (await hasChannels({ installDir })) {\n    clack.log.info('Detected Django Channels project');\n    return DjangoProjectType.CHANNELS;\n  }\n\n  // Default to standard Django\n  clack.log.info('Detected standard Django project');\n  return DjangoProjectType.STANDARD;\n}\n\n/**\n * Get human-readable name for Django project type\n */\nexport function getDjangoProjectTypeName(\n  projectType: DjangoProjectType,\n): string {\n  switch (projectType) {\n    case DjangoProjectType.STANDARD:\n      return 'Standard Django';\n    case DjangoProjectType.DRF:\n      return 'Django REST Framework';\n    case DjangoProjectType.WAGTAIL:\n      return 'Wagtail CMS';\n    case DjangoProjectType.CHANNELS:\n      return 'Django Channels';\n  }\n}\n\n/**\n * Find the main Django settings file\n */\nexport async function findDjangoSettingsFile(\n  options: Pick<WizardOptions, 'installDir'>,\n): Promise<string | undefined> {\n  const { installDir } = options;\n\n  // Look for settings.py files\n  const settingsFiles = await fg('**/settings.py', {\n    cwd: installDir,\n    ignore: IGNORE_PATTERNS,\n  });\n\n  if (settingsFiles.length === 0) {\n    // Try settings/__init__.py for split settings\n    const splitSettingsFiles = await fg('**/settings/__init__.py', {\n      cwd: installDir,\n      ignore: IGNORE_PATTERNS,\n    });\n\n    if (splitSettingsFiles.length > 0) {\n      return splitSettingsFiles[0];\n    }\n\n    return undefined;\n  }\n\n  // If multiple settings files, prefer the one next to manage.py or in root\n  if (settingsFiles.length === 1) {\n    return settingsFiles[0];\n  }\n\n  // Try to find the main settings file by looking for ROOT_URLCONF\n  for (const settingsFile of settingsFiles) {\n    try {\n      const content = fs.readFileSync(\n        path.join(installDir, settingsFile),\n        'utf-8',\n      );\n      if (content.includes('ROOT_URLCONF')) {\n        return settingsFile;\n      }\n    } catch {\n      continue;\n    }\n  }\n\n  // Default to first found\n  return settingsFiles[0];\n}\n\n/**\n * Find the main Django urls.py file\n */\nexport async function findDjangoUrlsFile(\n  options: Pick<WizardOptions, 'installDir'>,\n): Promise<string | undefined> {\n  const { installDir } = options;\n\n  // First, try to find the root urls.py referenced in settings\n  const settingsFile = await findDjangoSettingsFile(options);\n  if (settingsFile) {\n    try {\n      const settingsContent = fs.readFileSync(\n        path.join(installDir, settingsFile),\n        'utf-8',\n      );\n      const urlconfMatch = settingsContent.match(\n        /ROOT_URLCONF\\s*=\\s*['\"]([^'\"]+)['\"]/,\n      );\n      if (urlconfMatch) {\n        const urlconfPath = urlconfMatch[1].replace(/\\./g, '/') + '.py';\n        const fullPath = path.join(installDir, urlconfPath);\n        if (fs.existsSync(fullPath)) {\n          return urlconfPath;\n        }\n      }\n    } catch {\n      // Fall through to glob search\n    }\n  }\n\n  // Fallback to glob search\n  const urlsFiles = await fg('**/urls.py', {\n    cwd: installDir,\n    ignore: [...IGNORE_PATTERNS, '**/admin/**'],\n  });\n\n  if (urlsFiles.length === 0) {\n    return undefined;\n  }\n\n  // Prefer urls.py files that contain urlpatterns\n  for (const urlsFile of urlsFiles) {\n    try {\n      const content = fs.readFileSync(path.join(installDir, urlsFile), 'utf-8');\n      if (content.includes('urlpatterns')) {\n        return urlsFile;\n      }\n    } catch {\n      continue;\n    }\n  }\n\n  return urlsFiles[0];\n}\n"]}

package/dist/src/fastapi/fastapi-wizard-agent.d.ts

@@ -0,0 +1,7 @@
+import type { WizardOptions } from '../utils/types';
+import type { FrameworkConfig } from '../lib/framework-config';
+export declare const FASTAPI_AGENT_CONFIG: FrameworkConfig;
+/**
+ * FastAPI wizard powered by the universal agent runner.
+ */
+export declare function runFastAPIWizardAgent(options: WizardOptions): Promise<void>;

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

@@ -0,0 +1,217 @@
+"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.FASTAPI_AGENT_CONFIG = void 0;
+exports.runFastAPIWizardAgent = runFastAPIWizardAgent;
+const debug_1 = require("../utils/debug");
+const agent_runner_1 = require("../lib/agent-runner");
+const constants_1 = require("../lib/constants");
+const clack_1 = __importDefault(require("../utils/clack"));
+const chalk_1 = __importDefault(require("chalk"));
+const semver = __importStar(require("semver"));
+const utils_1 = require("./utils");
+const fast_glob_1 = __importDefault(require("fast-glob"));
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+/**
+ * FastAPI framework configuration for the universal agent runner
+ */
+const MINIMUM_FASTAPI_VERSION = '0.100.0';
+exports.FASTAPI_AGENT_CONFIG = {
+    metadata: {
+        name: 'FastAPI',
+        integration: constants_1.Integration.fastapi,
+        docsUrl: 'https://posthog.com/docs/libraries/python',
+        unsupportedVersionDocsUrl: 'https://posthog.com/docs/libraries/python',
+        gatherContext: async (options) => {
+            const projectType = await (0, utils_1.getFastAPIProjectType)(options);
+            const appFile = await (0, utils_1.findFastAPIAppFile)(options);
+            return { projectType, appFile };
+        },
+    },
+    detection: {
+        packageName: 'fastapi',
+        packageDisplayName: 'FastAPI',
+        usesPackageJson: false,
+        getVersion: (_packageJson) => {
+            // For FastAPI, we don't use package.json. Version is extracted separately
+            // from requirements.txt or pyproject.toml in the wizard entry point
+            return undefined;
+        },
+        getVersionBucket: utils_1.getFastAPIVersionBucket,
+        getInstalledVersion: utils_1.getFastAPIVersion,
+        detect: async (options) => {
+            const { installDir } = options;
+            // Note: Django and Flask are checked before FastAPI in INTEGRATION_ORDER,
+            // so if we get here, the project is not a Django or Flask project.
+            // Check for FastAPI in requirements files
+            const requirementsFiles = await (0, fast_glob_1.default)([
+                '**/requirements*.txt',
+                '**/pyproject.toml',
+                '**/setup.py',
+                '**/Pipfile',
+            ], {
+                cwd: installDir,
+                ignore: ['**/venv/**', '**/.venv/**', '**/env/**', '**/.env/**'],
+            });
+            for (const reqFile of requirementsFiles) {
+                try {
+                    const content = fs.readFileSync(path.join(installDir, reqFile), 'utf-8');
+                    // Check for fastapi package (case-insensitive)
+                    // Match "fastapi" as a standalone package
+                    if (/^fastapi([<>=~!]|$|\s)/im.test(content) ||
+                        /["']fastapi["']/i.test(content)) {
+                        return true;
+                    }
+                }
+                catch {
+                    continue;
+                }
+            }
+            // Check for FastAPI app patterns in Python files
+            const pyFiles = await (0, fast_glob_1.default)(['**/main.py', '**/app.py', '**/application.py', '**/__init__.py'], {
+                cwd: installDir,
+                ignore: [
+                    '**/venv/**',
+                    '**/.venv/**',
+                    '**/env/**',
+                    '**/.env/**',
+                    '**/__pycache__/**',
+                ],
+            });
+            for (const pyFile of pyFiles) {
+                try {
+                    const content = fs.readFileSync(path.join(installDir, pyFile), 'utf-8');
+                    if (content.includes('from fastapi import') ||
+                        content.includes('import fastapi') ||
+                        /FastAPI\s*\(/.test(content)) {
+                        return true;
+                    }
+                }
+                catch {
+                    continue;
+                }
+            }
+            return false;
+        },
+    },
+    environment: {
+        uploadToHosting: false,
+        getEnvVars: (apiKey, host) => ({
+            POSTHOG_API_KEY: apiKey,
+            POSTHOG_HOST: host,
+        }),
+    },
+    analytics: {
+        getTags: (context) => {
+            const projectType = context.projectType;
+            return {
+                projectType: projectType || 'unknown',
+            };
+        },
+    },
+    prompts: {
+        projectTypeDetection: 'This is a Python/FastAPI project. Look for requirements.txt, pyproject.toml, setup.py, Pipfile, or main.py/app.py to confirm.',
+        packageInstallation: 'Use pip, poetry, or pipenv based on existing config files (requirements.txt, pyproject.toml, Pipfile). Do not pin the posthog version - just add "posthog" without version constraints.',
+        getAdditionalContextLines: (context) => {
+            const projectType = context.projectType;
+            const projectTypeName = projectType
+                ? (0, utils_1.getFastAPIProjectTypeName)(projectType)
+                : 'unknown';
+            // Map project type to framework ID for MCP docs resource
+            const frameworkIdMap = {
+                [utils_1.FastAPIProjectType.STANDARD]: 'fastapi',
+                [utils_1.FastAPIProjectType.ROUTER]: 'fastapi',
+                [utils_1.FastAPIProjectType.FULLSTACK]: 'fastapi',
+            };
+            const frameworkId = projectType ? frameworkIdMap[projectType] : 'fastapi';
+            const lines = [
+                `Project type: ${projectTypeName}`,
+                `Framework docs ID: ${frameworkId} (use posthog://docs/frameworks/${frameworkId} for documentation)`,
+            ];
+            if (context.appFile) {
+                lines.push(`App file: ${context.appFile}`);
+            }
+            return lines;
+        },
+    },
+    ui: {
+        successMessage: 'PostHog integration complete',
+        estimatedDurationMinutes: 5,
+        getOutroChanges: (context) => {
+            const projectType = context.projectType;
+            const projectTypeName = projectType
+                ? (0, utils_1.getFastAPIProjectTypeName)(projectType)
+                : 'FastAPI';
+            return [
+                `Analyzed your ${projectTypeName} project structure`,
+                `Installed the PostHog Python package`,
+                `Configured PostHog in your FastAPI application`,
+                `Added PostHog initialization with lifespan event handling`,
+            ];
+        },
+        getOutroNextSteps: () => [
+            'Start your FastAPI development server to see PostHog in action',
+            'Visit your PostHog dashboard to see incoming events',
+            'Use posthog.identify() to associate events with users',
+        ],
+    },
+};
+/**
+ * FastAPI wizard powered by the universal agent runner.
+ */
+async function runFastAPIWizardAgent(options) {
+    if (options.debug) {
+        (0, debug_1.enableDebugLogs)();
+    }
+    // Check FastAPI version - agent wizard requires >= 0.100.0
+    const fastapiVersion = await (0, utils_1.getFastAPIVersion)(options);
+    if (fastapiVersion) {
+        const coercedVersion = semver.coerce(fastapiVersion);
+        if (coercedVersion && semver.lt(coercedVersion, MINIMUM_FASTAPI_VERSION)) {
+            const docsUrl = exports.FASTAPI_AGENT_CONFIG.metadata.unsupportedVersionDocsUrl ??
+                exports.FASTAPI_AGENT_CONFIG.metadata.docsUrl;
+            clack_1.default.log.warn(`Sorry: the wizard can't help you with FastAPI ${fastapiVersion}. Upgrade to FastAPI ${MINIMUM_FASTAPI_VERSION} or later, or check out the manual setup guide.`);
+            clack_1.default.log.info(`Setup FastAPI manually: ${chalk_1.default.cyan(docsUrl)}`);
+            clack_1.default.outro('PostHog wizard will see you next time!');
+            return;
+        }
+    }
+    await (0, agent_runner_1.runAgentWizard)(exports.FASTAPI_AGENT_CONFIG, options);
+}
+//# sourceMappingURL=fastapi-wizard-agent.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fastapi-wizard-agent.js","sourceRoot":"","sources":["../../../src/fastapi/fastapi-wizard-agent.ts"],"names":[],"mappings":"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","sourcesContent":["/* FastAPI wizard using posthog-agent with PostHog MCP */\nimport type { WizardOptions } from '../utils/types';\nimport type { FrameworkConfig } from '../lib/framework-config';\nimport { enableDebugLogs } from '../utils/debug';\nimport { runAgentWizard } from '../lib/agent-runner';\nimport { Integration } from '../lib/constants';\nimport clack from '../utils/clack';\nimport chalk from 'chalk';\nimport * as semver from 'semver';\nimport {\n  getFastAPIVersion,\n  getFastAPIProjectType,\n  getFastAPIProjectTypeName,\n  getFastAPIVersionBucket,\n  FastAPIProjectType,\n  findFastAPIAppFile,\n} from './utils';\nimport fg from 'fast-glob';\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\n\n/**\n * FastAPI framework configuration for the universal agent runner\n */\nconst MINIMUM_FASTAPI_VERSION = '0.100.0';\n\nexport const FASTAPI_AGENT_CONFIG: FrameworkConfig = {\n  metadata: {\n    name: 'FastAPI',\n    integration: Integration.fastapi,\n    docsUrl: 'https://posthog.com/docs/libraries/python',\n    unsupportedVersionDocsUrl: 'https://posthog.com/docs/libraries/python',\n    gatherContext: async (options: WizardOptions) => {\n      const projectType = await getFastAPIProjectType(options);\n      const appFile = await findFastAPIAppFile(options);\n      return { projectType, appFile };\n    },\n  },\n\n  detection: {\n    packageName: 'fastapi',\n    packageDisplayName: 'FastAPI',\n    usesPackageJson: false,\n    getVersion: (_packageJson: any) => {\n      // For FastAPI, we don't use package.json. Version is extracted separately\n      // from requirements.txt or pyproject.toml in the wizard entry point\n      return undefined;\n    },\n    getVersionBucket: getFastAPIVersionBucket,\n    getInstalledVersion: getFastAPIVersion,\n    detect: async (options) => {\n      const { installDir } = options;\n\n      // Note: Django and Flask are checked before FastAPI in INTEGRATION_ORDER,\n      // so if we get here, the project is not a Django or Flask project.\n\n      // Check for FastAPI in requirements files\n      const requirementsFiles = 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      for (const reqFile of requirementsFiles) {\n        try {\n          const content = fs.readFileSync(\n            path.join(installDir, reqFile),\n            'utf-8',\n          );\n          // Check for fastapi package (case-insensitive)\n          // Match \"fastapi\" as a standalone package\n          if (\n            /^fastapi([<>=~!]|$|\\s)/im.test(content) ||\n            /[\"']fastapi[\"']/i.test(content)\n          ) {\n            return true;\n          }\n        } catch {\n          continue;\n        }\n      }\n\n      // Check for FastAPI app patterns in Python files\n      const pyFiles = await fg(\n        ['**/main.py', '**/app.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 fastapi import') ||\n            content.includes('import fastapi') ||\n            /FastAPI\\s*\\(/.test(content)\n          ) {\n            return true;\n          }\n        } catch {\n          continue;\n        }\n      }\n\n      return false;\n    },\n  },\n\n  environment: {\n    uploadToHosting: false,\n    getEnvVars: (apiKey: string, host: string) => ({\n      POSTHOG_API_KEY: apiKey,\n      POSTHOG_HOST: host,\n    }),\n  },\n\n  analytics: {\n    getTags: (context: any) => {\n      const projectType = context.projectType as FastAPIProjectType;\n      return {\n        projectType: projectType || 'unknown',\n      };\n    },\n  },\n\n  prompts: {\n    projectTypeDetection:\n      'This is a Python/FastAPI project. Look for requirements.txt, pyproject.toml, setup.py, Pipfile, or main.py/app.py to confirm.',\n    packageInstallation:\n      'Use pip, poetry, or pipenv based on existing config files (requirements.txt, pyproject.toml, Pipfile). Do not pin the posthog version - just add \"posthog\" without version constraints.',\n    getAdditionalContextLines: (context: any) => {\n      const projectType = context.projectType as FastAPIProjectType;\n      const projectTypeName = projectType\n        ? getFastAPIProjectTypeName(projectType)\n        : 'unknown';\n\n      // Map project type to framework ID for MCP docs resource\n      const frameworkIdMap: Record<FastAPIProjectType, string> = {\n        [FastAPIProjectType.STANDARD]: 'fastapi',\n        [FastAPIProjectType.ROUTER]: 'fastapi',\n        [FastAPIProjectType.FULLSTACK]: 'fastapi',\n      };\n\n      const frameworkId = projectType ? frameworkIdMap[projectType] : 'fastapi';\n\n      const lines = [\n        `Project type: ${projectTypeName}`,\n        `Framework docs ID: ${frameworkId} (use posthog://docs/frameworks/${frameworkId} for documentation)`,\n      ];\n\n      if (context.appFile) {\n        lines.push(`App file: ${context.appFile}`);\n      }\n\n      return lines;\n    },\n  },\n\n  ui: {\n    successMessage: 'PostHog integration complete',\n    estimatedDurationMinutes: 5,\n    getOutroChanges: (context: any) => {\n      const projectType = context.projectType as FastAPIProjectType;\n      const projectTypeName = projectType\n        ? getFastAPIProjectTypeName(projectType)\n        : 'FastAPI';\n      return [\n        `Analyzed your ${projectTypeName} project structure`,\n        `Installed the PostHog Python package`,\n        `Configured PostHog in your FastAPI application`,\n        `Added PostHog initialization with lifespan event handling`,\n      ];\n    },\n    getOutroNextSteps: () => [\n      'Start your FastAPI development server to see PostHog in action',\n      'Visit your PostHog dashboard to see incoming events',\n      'Use posthog.identify() to associate events with users',\n    ],\n  },\n};\n\n/**\n * FastAPI wizard powered by the universal agent runner.\n */\nexport async function runFastAPIWizardAgent(\n  options: WizardOptions,\n): Promise<void> {\n  if (options.debug) {\n    enableDebugLogs();\n  }\n\n  // Check FastAPI version - agent wizard requires >= 0.100.0\n  const fastapiVersion = await getFastAPIVersion(options);\n\n  if (fastapiVersion) {\n    const coercedVersion = semver.coerce(fastapiVersion);\n    if (coercedVersion && semver.lt(coercedVersion, MINIMUM_FASTAPI_VERSION)) {\n      const docsUrl =\n        FASTAPI_AGENT_CONFIG.metadata.unsupportedVersionDocsUrl ??\n        FASTAPI_AGENT_CONFIG.metadata.docsUrl;\n\n      clack.log.warn(\n        `Sorry: the wizard can't help you with FastAPI ${fastapiVersion}. Upgrade to FastAPI ${MINIMUM_FASTAPI_VERSION} or later, or check out the manual setup guide.`,\n      );\n      clack.log.info(`Setup FastAPI manually: ${chalk.cyan(docsUrl)}`);\n      clack.outro('PostHog wizard will see you next time!');\n      return;\n    }\n  }\n\n  await runAgentWizard(FASTAPI_AGENT_CONFIG, options);\n}\n"]}

package/dist/src/fastapi/utils.d.ts

@@ -0,0 +1,26 @@
+import type { WizardOptions } from '../utils/types';
+export declare enum FastAPIProjectType {
+    STANDARD = "standard",// Basic FastAPI app
+    ROUTER = "router",// FastAPI with APIRouter
+    FULLSTACK = "fullstack"
+}
+/**
+ * Get FastAPI version bucket for analytics
+ */
+export declare function getFastAPIVersionBucket(version: string | undefined): string;
+/**
+ * Extract FastAPI version from requirements files or pyproject.toml
+ */
+export declare function getFastAPIVersion(options: Pick<WizardOptions, 'installDir'>): Promise<string | undefined>;
+/**
+ * Detect FastAPI project type
+ */
+export declare function getFastAPIProjectType(options: WizardOptions): Promise<FastAPIProjectType>;
+/**
+ * Get human-readable name for FastAPI project type
+ */
+export declare function getFastAPIProjectTypeName(projectType: FastAPIProjectType): string;
+/**
+ * Find the main FastAPI app file
+ */
+export declare function findFastAPIAppFile(options: Pick<WizardOptions, 'installDir'>): Promise<string | undefined>;

package/dist/src/fastapi/utils.js

@@ -0,0 +1,258 @@
+"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.FastAPIProjectType = void 0;
+exports.getFastAPIVersionBucket = getFastAPIVersionBucket;
+exports.getFastAPIVersion = getFastAPIVersion;
+exports.getFastAPIProjectType = getFastAPIProjectType;
+exports.getFastAPIProjectTypeName = getFastAPIProjectTypeName;
+exports.findFastAPIAppFile = findFastAPIAppFile;
+const semver_1 = require("semver");
+const fast_glob_1 = __importDefault(require("fast-glob"));
+const clack_1 = __importDefault(require("../utils/clack"));
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+var FastAPIProjectType;
+(function (FastAPIProjectType) {
+    FastAPIProjectType["STANDARD"] = "standard";
+    FastAPIProjectType["ROUTER"] = "router";
+    FastAPIProjectType["FULLSTACK"] = "fullstack";
+})(FastAPIProjectType || (exports.FastAPIProjectType = FastAPIProjectType = {}));
+const IGNORE_PATTERNS = [
+    '**/node_modules/**',
+    '**/dist/**',
+    '**/build/**',
+    '**/venv/**',
+    '**/.venv/**',
+    '**/env/**',
+    '**/.env/**',
+    '**/__pycache__/**',
+    '**/migrations/**',
+];
+/**
+ * Get FastAPI version bucket for analytics
+ */
+function getFastAPIVersionBucket(version) {
+    if (!version) {
+        return 'none';
+    }
+    try {
+        const minVer = (0, semver_1.minVersion)(version);
+        if (!minVer) {
+            return 'invalid';
+        }
+        const majorVersion = (0, semver_1.major)(minVer);
+        // FastAPI 0.x is still the common version range
+        if (majorVersion === 0) {
+            return '0.x';
+        }
+        return `${majorVersion}.x`;
+    }
+    catch {
+        return 'unknown';
+    }
+}
+/**
+ * Extract FastAPI version from requirements files or pyproject.toml
+ */
+async function getFastAPIVersion(options) {
+    const { installDir } = options;
+    // Check requirements files
+    const requirementsFiles = await (0, fast_glob_1.default)(['**/requirements*.txt', '**/pyproject.toml', '**/setup.py', '**/Pipfile'], {
+        cwd: installDir,
+        ignore: IGNORE_PATTERNS,
+    });
+    for (const reqFile of requirementsFiles) {
+        try {
+            const content = fs.readFileSync(path.join(installDir, reqFile), 'utf-8');
+            // Try to extract version from requirements.txt format (fastapi==0.109.0 or fastapi>=0.100)
+            const requirementsMatch = content.match(/[Ff]ast[Aa][Pp][Ii][=<>~!]+([0-9]+\.[0-9]+(?:\.[0-9]+)?)/);
+            if (requirementsMatch) {
+                return requirementsMatch[1];
+            }
+            // Try to extract from pyproject.toml format
+            const pyprojectMatch = content.match(/[Ff]ast[Aa][Pp][Ii]["\s]*[=<>~!]+\s*["']?([0-9]+\.[0-9]+(?:\.[0-9]+)?)/);
+            if (pyprojectMatch) {
+                return pyprojectMatch[1];
+            }
+        }
+        catch {
+            // Skip files that can't be read
+            continue;
+        }
+    }
+    return undefined;
+}
+/**
+ * Check if app uses FastAPI APIRouter
+ */
+async function hasAPIRouter({ installDir, }) {
+    const pyFiles = await (0, fast_glob_1.default)(['**/*.py'], {
+        cwd: installDir,
+        ignore: IGNORE_PATTERNS,
+    });
+    for (const pyFile of pyFiles) {
+        try {
+            const content = fs.readFileSync(path.join(installDir, pyFile), 'utf-8');
+            if (content.includes('APIRouter(') ||
+                content.includes('include_router(') ||
+                content.includes('from fastapi import APIRouter')) {
+                return true;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return false;
+}
+/**
+ * Check if app uses Jinja2 templates (fullstack pattern)
+ */
+async function hasTemplates({ installDir, }) {
+    // Check for Jinja2Templates usage in Python files
+    const pyFiles = await (0, fast_glob_1.default)(['**/*.py'], {
+        cwd: installDir,
+        ignore: IGNORE_PATTERNS,
+    });
+    for (const pyFile of pyFiles) {
+        try {
+            const content = fs.readFileSync(path.join(installDir, pyFile), 'utf-8');
+            if (content.includes('Jinja2Templates') ||
+                content.includes('from fastapi.templating import')) {
+                return true;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    // Check for templates directory
+    const templateDirs = await (0, fast_glob_1.default)(['**/templates'], {
+        cwd: installDir,
+        ignore: IGNORE_PATTERNS,
+        onlyDirectories: true,
+    });
+    return templateDirs.length > 0;
+}
+/**
+ * Detect FastAPI project type
+ */
+async function getFastAPIProjectType(options) {
+    const { installDir } = options;
+    // Check for fullstack pattern (templates)
+    if (await hasTemplates({ installDir })) {
+        clack_1.default.log.info('Detected FastAPI fullstack project with templates');
+        return FastAPIProjectType.FULLSTACK;
+    }
+    // Check for APIRouter (modular structure)
+    if (await hasAPIRouter({ installDir })) {
+        clack_1.default.log.info('Detected FastAPI project with APIRouter');
+        return FastAPIProjectType.ROUTER;
+    }
+    // Default to standard FastAPI
+    clack_1.default.log.info('Detected standard FastAPI project');
+    return FastAPIProjectType.STANDARD;
+}
+/**
+ * Get human-readable name for FastAPI project type
+ */
+function getFastAPIProjectTypeName(projectType) {
+    switch (projectType) {
+        case FastAPIProjectType.STANDARD:
+            return 'Standard FastAPI';
+        case FastAPIProjectType.ROUTER:
+            return 'FastAPI with APIRouter';
+        case FastAPIProjectType.FULLSTACK:
+            return 'FastAPI Fullstack';
+    }
+}
+/**
+ * Find the main FastAPI app file
+ */
+async function findFastAPIAppFile(options) {
+    const { installDir } = options;
+    // Common FastAPI app file patterns
+    const commonPatterns = [
+        '**/main.py',
+        '**/app.py',
+        '**/application.py',
+        '**/api.py',
+        '**/__init__.py',
+    ];
+    const appFiles = await (0, fast_glob_1.default)(commonPatterns, {
+        cwd: installDir,
+        ignore: IGNORE_PATTERNS,
+    });
+    // Look for files with FastAPI() instantiation
+    for (const appFile of appFiles) {
+        try {
+            const content = fs.readFileSync(path.join(installDir, appFile), 'utf-8');
+            // Check for FastAPI app instantiation
+            if (content.includes('FastAPI(') ||
+                content.includes('from fastapi import FastAPI')) {
+                return appFile;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    // If no file with FastAPI() found, check all Python files
+    const allPyFiles = await (0, fast_glob_1.default)(['**/*.py'], {
+        cwd: installDir,
+        ignore: IGNORE_PATTERNS,
+    });
+    for (const pyFile of allPyFiles) {
+        try {
+            const content = fs.readFileSync(path.join(installDir, pyFile), 'utf-8');
+            if (content.includes('FastAPI(')) {
+                return pyFile;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    // Return first common pattern file if exists
+    if (appFiles.length > 0) {
+        return appFiles[0];
+    }
+    return undefined;
+}
+//# sourceMappingURL=utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/fastapi/utils.ts"],"names":[],"mappings":"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","sourcesContent":["import { major, minVersion } from 'semver';\nimport fg from 'fast-glob';\nimport clack from '../utils/clack';\nimport type { WizardOptions } from '../utils/types';\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\n\nexport enum FastAPIProjectType {\n  STANDARD = 'standard', // Basic FastAPI app\n  ROUTER = 'router', // FastAPI with APIRouter\n  FULLSTACK = 'fullstack', // FastAPI with templates (Jinja2)\n}\n\nconst IGNORE_PATTERNS = [\n  '**/node_modules/**',\n  '**/dist/**',\n  '**/build/**',\n  '**/venv/**',\n  '**/.venv/**',\n  '**/env/**',\n  '**/.env/**',\n  '**/__pycache__/**',\n  '**/migrations/**',\n];\n\n/**\n * Get FastAPI version bucket for analytics\n */\nexport function getFastAPIVersionBucket(version: string | undefined): string {\n  if (!version) {\n    return 'none';\n  }\n\n  try {\n    const minVer = minVersion(version);\n    if (!minVer) {\n      return 'invalid';\n    }\n    const majorVersion = major(minVer);\n    // FastAPI 0.x is still the common version range\n    if (majorVersion === 0) {\n      return '0.x';\n    }\n    return `${majorVersion}.x`;\n  } catch {\n    return 'unknown';\n  }\n}\n\n/**\n * Extract FastAPI version from requirements files or pyproject.toml\n */\nexport async function getFastAPIVersion(\n  options: Pick<WizardOptions, 'installDir'>,\n): Promise<string | undefined> {\n  const { installDir } = options;\n\n  // Check requirements files\n  const requirementsFiles = await fg(\n    ['**/requirements*.txt', '**/pyproject.toml', '**/setup.py', '**/Pipfile'],\n    {\n      cwd: installDir,\n      ignore: IGNORE_PATTERNS,\n    },\n  );\n\n  for (const reqFile of requirementsFiles) {\n    try {\n      const content = fs.readFileSync(path.join(installDir, reqFile), 'utf-8');\n\n      // Try to extract version from requirements.txt format (fastapi==0.109.0 or fastapi>=0.100)\n      const requirementsMatch = content.match(\n        /[Ff]ast[Aa][Pp][Ii][=<>~!]+([0-9]+\\.[0-9]+(?:\\.[0-9]+)?)/,\n      );\n      if (requirementsMatch) {\n        return requirementsMatch[1];\n      }\n\n      // Try to extract from pyproject.toml format\n      const pyprojectMatch = content.match(\n        /[Ff]ast[Aa][Pp][Ii][\"\\s]*[=<>~!]+\\s*[\"']?([0-9]+\\.[0-9]+(?:\\.[0-9]+)?)/,\n      );\n      if (pyprojectMatch) {\n        return pyprojectMatch[1];\n      }\n    } catch {\n      // Skip files that can't be read\n      continue;\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Check if app uses FastAPI APIRouter\n */\nasync function hasAPIRouter({\n  installDir,\n}: Pick<WizardOptions, 'installDir'>): Promise<boolean> {\n  const pyFiles = await fg(['**/*.py'], {\n    cwd: installDir,\n    ignore: IGNORE_PATTERNS,\n  });\n\n  for (const pyFile of pyFiles) {\n    try {\n      const content = fs.readFileSync(path.join(installDir, pyFile), 'utf-8');\n      if (\n        content.includes('APIRouter(') ||\n        content.includes('include_router(') ||\n        content.includes('from fastapi import APIRouter')\n      ) {\n        return true;\n      }\n    } catch {\n      continue;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Check if app uses Jinja2 templates (fullstack pattern)\n */\nasync function hasTemplates({\n  installDir,\n}: Pick<WizardOptions, 'installDir'>): Promise<boolean> {\n  // Check for Jinja2Templates usage in Python files\n  const pyFiles = await fg(['**/*.py'], {\n    cwd: installDir,\n    ignore: IGNORE_PATTERNS,\n  });\n\n  for (const pyFile of pyFiles) {\n    try {\n      const content = fs.readFileSync(path.join(installDir, pyFile), 'utf-8');\n      if (\n        content.includes('Jinja2Templates') ||\n        content.includes('from fastapi.templating import')\n      ) {\n        return true;\n      }\n    } catch {\n      continue;\n    }\n  }\n\n  // Check for templates directory\n  const templateDirs = await fg(['**/templates'], {\n    cwd: installDir,\n    ignore: IGNORE_PATTERNS,\n    onlyDirectories: true,\n  });\n\n  return templateDirs.length > 0;\n}\n\n/**\n * Detect FastAPI project type\n */\nexport async function getFastAPIProjectType(\n  options: WizardOptions,\n): Promise<FastAPIProjectType> {\n  const { installDir } = options;\n\n  // Check for fullstack pattern (templates)\n  if (await hasTemplates({ installDir })) {\n    clack.log.info('Detected FastAPI fullstack project with templates');\n    return FastAPIProjectType.FULLSTACK;\n  }\n\n  // Check for APIRouter (modular structure)\n  if (await hasAPIRouter({ installDir })) {\n    clack.log.info('Detected FastAPI project with APIRouter');\n    return FastAPIProjectType.ROUTER;\n  }\n\n  // Default to standard FastAPI\n  clack.log.info('Detected standard FastAPI project');\n  return FastAPIProjectType.STANDARD;\n}\n\n/**\n * Get human-readable name for FastAPI project type\n */\nexport function getFastAPIProjectTypeName(\n  projectType: FastAPIProjectType,\n): string {\n  switch (projectType) {\n    case FastAPIProjectType.STANDARD:\n      return 'Standard FastAPI';\n    case FastAPIProjectType.ROUTER:\n      return 'FastAPI with APIRouter';\n    case FastAPIProjectType.FULLSTACK:\n      return 'FastAPI Fullstack';\n  }\n}\n\n/**\n * Find the main FastAPI app file\n */\nexport async function findFastAPIAppFile(\n  options: Pick<WizardOptions, 'installDir'>,\n): Promise<string | undefined> {\n  const { installDir } = options;\n\n  // Common FastAPI app file patterns\n  const commonPatterns = [\n    '**/main.py',\n    '**/app.py',\n    '**/application.py',\n    '**/api.py',\n    '**/__init__.py',\n  ];\n\n  const appFiles = await fg(commonPatterns, {\n    cwd: installDir,\n    ignore: IGNORE_PATTERNS,\n  });\n\n  // Look for files with FastAPI() instantiation\n  for (const appFile of appFiles) {\n    try {\n      const content = fs.readFileSync(path.join(installDir, appFile), 'utf-8');\n      // Check for FastAPI app instantiation\n      if (\n        content.includes('FastAPI(') ||\n        content.includes('from fastapi import FastAPI')\n      ) {\n        return appFile;\n      }\n    } catch {\n      continue;\n    }\n  }\n\n  // If no file with FastAPI() found, check all Python files\n  const allPyFiles = await fg(['**/*.py'], {\n    cwd: installDir,\n    ignore: IGNORE_PATTERNS,\n  });\n\n  for (const pyFile of allPyFiles) {\n    try {\n      const content = fs.readFileSync(path.join(installDir, pyFile), 'utf-8');\n      if (content.includes('FastAPI(')) {\n        return pyFile;\n      }\n    } catch {\n      continue;\n    }\n  }\n\n  // Return first common pattern file if exists\n  if (appFiles.length > 0) {\n    return appFiles[0];\n  }\n\n  return undefined;\n}\n"]}