@posthog/wizard 1.36.0 → 2.0.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"angular-wizard-agent.js","sourceRoot":"","sources":["../../../../src/frameworks/angular/angular-wizard-agent.ts"],"names":[],"mappings":";;;AAGA,mFAAgF;AAChF,mDAAkD;AAClD,2DAIkC;AAClC,yDAA4D;AAC5D,mCAAkD;AAIrC,QAAA,oBAAoB,GAAoC;IACnE,QAAQ,EAAE;QACR,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,uBAAW,CAAC,OAAO;QAChC,OAAO,EAAE,4CAA4C;KACtD;IAED,SAAS,EAAE;QACT,WAAW,EAAE,eAAe;QAC5B,kBAAkB,EAAE,SAAS;QAC7B,UAAU,EAAE,CAAC,WAAoB,EAAE,EAAE,CACnC,IAAA,gCAAiB,EAAC,eAAe,EAAE,WAA6B,CAAC;QACnE,gBAAgB,EAAE,+BAAuB;QACzC,cAAc,EAAE,QAAQ;QACxB,mBAAmB,EAAE,KAAK,EAAE,OAAsB,EAAE,EAAE;YACpD,MAAM,WAAW,GAAG,MAAM,IAAA,+BAAiB,EAAC,OAAO,CAAC,CAAC;YACrD,OAAO,WAAW;gBAChB,CAAC,CAAC,IAAA,gCAAiB,EAAC,eAAe,EAAE,WAAW,CAAC;gBACjD,CAAC,CAAC,SAAS,CAAC;QAChB,CAAC;QACD,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACxB,MAAM,WAAW,GAAG,MAAM,IAAA,+BAAiB,EAAC,OAAO,CAAC,CAAC;YACrD,OAAO,WAAW;gBAChB,CAAC,CAAC,IAAA,kCAAmB,EAAC,eAAe,EAAE,WAAW,CAAC;gBACnD,CAAC,CAAC,KAAK,CAAC;QACZ,CAAC;QACD,oBAAoB,EAAE,qDAAyB;KAChD;IAED,WAAW,EAAE;QACX,eAAe,EAAE,KAAK;QACtB,UAAU,EAAE,CAAC,MAAc,EAAE,IAAY,EAAE,EAAE,CAAC,CAAC;YAC7C,kBAAkB,EAAE,MAAM;YAC1B,mBAAmB,EAAE,IAAI;SAC1B,CAAC;KACH;IAED,SAAS,EAAE;QACT,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;KACpB;IAED,OAAO,EAAE;QACP,oBAAoB,EAClB,2IAA2I;QAC7I,yBAAyB,EAAE,GAAG,EAAE;YAC9B,MAAM,WAAW,GAAG,SAAS,CAAC;YAE9B,OAAO;gBACL,sBAAsB,WAAW,mCAAmC,WAAW,qBAAqB;gBACpG,6FAA6F;gBAC7F,2FAA2F;aAC5F,CAAC;QACJ,CAAC;KACF;IAED,EAAE,EAAE;QACF,cAAc,EAAE,8BAA8B;QAC9C,wBAAwB,EAAE,CAAC;QAC3B,eAAe,EAAE,GAAG,EAAE,CAAC;YACrB,yCAAyC;YACzC,wCAAwC;YACxC,0CAA0C;SAC3C;QACD,iBAAiB,EAAE,GAAG,EAAE,CAAC;YACvB,wEAAwE;YACxE,qDAAqD;SACtD;KACF;CACF,CAAC","sourcesContent":["/* Angular 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 { getAngularVersionBucket } from './utils';\n\ntype AngularContext = Record<string, unknown>;\n\nexport const ANGULAR_AGENT_CONFIG: FrameworkConfig<AngularContext> = {\n  metadata: {\n    name: 'Angular',\n    integration: Integration.angular,\n    docsUrl: 'https://posthog.com/docs/libraries/angular',\n  },\n\n  detection: {\n    packageName: '@angular/core',\n    packageDisplayName: 'Angular',\n    getVersion: (packageJson: unknown) =>\n      getPackageVersion('@angular/core', packageJson as PackageDotJson),\n    getVersionBucket: getAngularVersionBucket,\n    minimumVersion: '19.0.0',\n    getInstalledVersion: async (options: WizardOptions) => {\n      const packageJson = await tryGetPackageJson(options);\n      return packageJson\n        ? getPackageVersion('@angular/core', packageJson)\n        : undefined;\n    },\n    detect: async (options) => {\n      const packageJson = await tryGetPackageJson(options);\n      return packageJson\n        ? hasPackageInstalled('@angular/core', packageJson)\n        : false;\n    },\n    detectPackageManager: detectNodePackageManagers,\n  },\n\n  environment: {\n    uploadToHosting: false,\n    getEnvVars: (apiKey: string, host: string) => ({\n      NG_APP_POSTHOG_KEY: apiKey,\n      NG_APP_POSTHOG_HOST: host,\n    }),\n  },\n\n  analytics: {\n    getTags: () => ({}),\n  },\n\n  prompts: {\n    projectTypeDetection:\n      'This is an Angular project. Look for package.json, angular.json, and lockfiles (package-lock.json, yarn.lock, pnpm-lock.yaml) to confirm.',\n    getAdditionalContextLines: () => {\n      const frameworkId = 'angular';\n\n      return [\n        `Framework docs ID: ${frameworkId} (use posthog://docs/frameworks/${frameworkId} for documentation)`,\n        'Angular uses dependency injection for services. PostHog should be initialized as a service.',\n        'For standalone components, ensure PostHog is properly provided in the application config.',\n      ];\n    },\n  },\n\n  ui: {\n    successMessage: 'PostHog integration complete',\n    estimatedDurationMinutes: 8,\n    getOutroChanges: () => [\n      `Analyzed your Angular project structure`,\n      `Created and configured PostHog service`,\n      `Integrated PostHog into your application`,\n    ],\n    getOutroNextSteps: () => [\n      'Start your development server with `ng serve` to see PostHog in action',\n      'Visit your PostHog dashboard to see incoming events',\n    ],\n  },\n};\n"]}

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

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getAngularVersionBucket = void 0;
-const semver_1 = require("../utils/semver");
+const semver_1 = require("../../utils/semver");
 /**
  * Get Angular version bucket for analytics
  */

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/frameworks/angular/utils.ts"],"names":[],"mappings":";;;AAAA,+CAAyD;AAEzD;;GAEG;AACU,QAAA,uBAAuB,GAAG,IAAA,4BAAmB,GAAE,CAAC","sourcesContent":["import { createVersionBucket } from '../../utils/semver';\n\n/**\n * Get Angular version bucket for analytics\n */\nexport const getAngularVersionBucket = createVersionBucket();\n"]}

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

@@ -1,4 +1,4 @@
-import type { FrameworkConfig } from '../lib/framework-config';
+import type { FrameworkConfig } from '../../lib/framework-config';
 import { AstroRenderingMode } from './utils';
 type AstroContext = {
     renderingMode?: AstroRenderingMode;

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

@@ -1,10 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ASTRO_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.ASTRO_AGENT_CONFIG = {
     metadata: {
@@ -13,6 +14,7 @@ exports.ASTRO_AGENT_CONFIG = {
         docsUrl: 'https://posthog.com/docs/libraries/astro',
         gatherContext: async (options) => {
             const renderingMode = await (0, utils_1.getAstroRenderingMode)(options);
+            (0, ui_1.getUI)().setDetectedFramework(`Astro ${(0, utils_1.getAstroRenderingModeName)(renderingMode)}`);
             return { renderingMode };
         },
     },
@@ -23,11 +25,11 @@ exports.ASTRO_AGENT_CONFIG = {
         getVersionBucket: utils_1.getAstroVersionBucket,
         minimumVersion: '4.0.0',
         getInstalledVersion: async (options) => {
-            const packageJson = await (0, clack_utils_1.getPackageDotJson)(options);
-            return (0, package_json_1.getPackageVersion)('astro', packageJson);
+            const packageJson = await (0, setup_utils_1.tryGetPackageJson)(options);
+            return packageJson ? (0, package_json_1.getPackageVersion)('astro', 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)('astro', packageJson) : false;
         },
         detectPackageManager: package_manager_detection_1.detectNodePackageManagers,

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

@@ -0,0 +1 @@
+{"version":3,"file":"astro-wizard-agent.js","sourceRoot":"","sources":["../../../../src/frameworks/astro/astro-wizard-agent.ts"],"names":[],"mappings":"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","sourcesContent":["/* Astro 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  getAstroRenderingMode,\n  getAstroVersionBucket,\n  getAstroRenderingModeName,\n  AstroRenderingMode,\n} from './utils';\n\ntype AstroContext = {\n  renderingMode?: AstroRenderingMode;\n};\n\nexport const ASTRO_AGENT_CONFIG: FrameworkConfig<AstroContext> = {\n  metadata: {\n    name: 'Astro',\n    integration: Integration.astro,\n    docsUrl: 'https://posthog.com/docs/libraries/astro',\n    gatherContext: async (options: WizardOptions) => {\n      const renderingMode = await getAstroRenderingMode(options);\n      getUI().setDetectedFramework(\n        `Astro ${getAstroRenderingModeName(renderingMode)}`,\n      );\n      return { renderingMode };\n    },\n  },\n\n  detection: {\n    packageName: 'astro',\n    packageDisplayName: 'Astro',\n    getVersion: (packageJson: unknown) =>\n      getPackageVersion('astro', packageJson as PackageDotJson),\n    getVersionBucket: getAstroVersionBucket,\n    minimumVersion: '4.0.0',\n    getInstalledVersion: async (options: WizardOptions) => {\n      const packageJson = await tryGetPackageJson(options);\n      return packageJson ? getPackageVersion('astro', packageJson) : undefined;\n    },\n    detect: async (options) => {\n      const packageJson = await tryGetPackageJson(options);\n      return packageJson ? hasPackageInstalled('astro', packageJson) : false;\n    },\n    detectPackageManager: detectNodePackageManagers,\n  },\n\n  environment: {\n    uploadToHosting: true,\n    getEnvVars: (apiKey: string, host: string) => ({\n      PUBLIC_POSTHOG_KEY: apiKey,\n      PUBLIC_POSTHOG_HOST: host,\n    }),\n  },\n\n  analytics: {\n    getTags: (context) => ({\n      'rendering-mode': context.renderingMode ?? 'static',\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 modeName = getAstroRenderingModeName(\n        context.renderingMode ?? AstroRenderingMode.STATIC,\n      );\n\n      // Map rendering mode to framework ID for MCP docs resource\n      const frameworkIdMap: Record<AstroRenderingMode, string> = {\n        [AstroRenderingMode.STATIC]: 'astro-static',\n        [AstroRenderingMode.VIEW_TRANSITIONS]: 'astro-view-transitions',\n        [AstroRenderingMode.SSR]: 'astro-ssr',\n        [AstroRenderingMode.HYBRID]: 'astro-hybrid',\n      };\n\n      const frameworkId =\n        frameworkIdMap[context.renderingMode ?? AstroRenderingMode.STATIC];\n\n      const lines = [\n        `Rendering mode: ${modeName}`,\n        `Framework docs ID: ${frameworkId} (use posthog://docs/frameworks/${frameworkId} for documentation)`,\n      ];\n\n      // Add mode-specific guidance\n      if (context.renderingMode === AstroRenderingMode.VIEW_TRANSITIONS) {\n        lines.push(\n          'IMPORTANT: Use window.__posthog_initialized guard to prevent re-initialization during soft navigation',\n        );\n        lines.push(\n          \"IMPORTANT: Set capture_pageview: 'history_change' for automatic pageview tracking\",\n        );\n      }\n\n      if (\n        context.renderingMode === AstroRenderingMode.SSR ||\n        context.renderingMode === AstroRenderingMode.HYBRID\n      ) {\n        lines.push(\n          'IMPORTANT: Use posthog-node for server-side tracking in API routes',\n        );\n        lines.push(\n          'IMPORTANT: Create a singleton pattern for the posthog-node client',\n        );\n      }\n\n      return lines;\n    },\n  },\n\n  ui: {\n    successMessage: 'PostHog integration complete',\n    estimatedDurationMinutes: 6,\n    getOutroChanges: (context) => {\n      const modeName = getAstroRenderingModeName(\n        context.renderingMode ?? AstroRenderingMode.STATIC,\n      );\n      const changes = [\n        `Analyzed your Astro project structure (${modeName})`,\n        `Created PostHog component with is:inline script`,\n        `Integrated PostHog into your layout`,\n      ];\n\n      if (\n        context.renderingMode === AstroRenderingMode.SSR ||\n        context.renderingMode === AstroRenderingMode.HYBRID\n      ) {\n        changes.push(`Set up posthog-node for server-side tracking`);\n      }\n\n      if (context.renderingMode === AstroRenderingMode.VIEW_TRANSITIONS) {\n        changes.push(\n          `Added initialization guard for view transitions compatibility`,\n        );\n      }\n\n      return changes;\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/{astro → frameworks/astro}/utils.d.ts

@@ -1,4 +1,4 @@
-import type { WizardOptions } from '../utils/types';
+import type { WizardOptions } from '../../utils/types';
 export declare const getAstroVersionBucket: (version: string | undefined) => string;
 export declare enum AstroRenderingMode {
     STATIC = "static",
@@ -8,10 +8,7 @@ export declare enum AstroRenderingMode {
 }
 export declare const IGNORE_PATTERNS: string[];
 /**
- * Detect the Astro rendering mode by analyzing:
- * 1. astro.config.* for output mode
- * 2. Package.json for adapters
- * 3. Source files for view transitions usage
+ * Detect the Astro rendering mode. Pure — always resolves (Astro detection is reliable).
  */
 export declare function getAstroRenderingMode({ installDir, }: Pick<WizardOptions, 'installDir'>): Promise<AstroRenderingMode>;
 export declare const getAstroRenderingModeName: (mode: AstroRenderingMode) => string;

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

@@ -8,10 +8,7 @@ exports.getAstroRenderingMode = getAstroRenderingMode;
 const fast_glob_1 = __importDefault(require("fast-glob"));
 const promises_1 = __importDefault(require("fs/promises"));
 const path_1 = __importDefault(require("path"));
-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.getAstroVersionBucket = (0, semver_1.createVersionBucket)();
 var AstroRenderingMode;
 (function (AstroRenderingMode) {
@@ -26,13 +23,9 @@ exports.IGNORE_PATTERNS = [
     '**/.astro/**',
 ];
 /**
- * Detect the Astro rendering mode by analyzing:
- * 1. astro.config.* for output mode
- * 2. Package.json for adapters
- * 3. Source files for view transitions usage
+ * Detect the Astro rendering mode. Pure — always resolves (Astro detection is reliable).
  */
 async function getAstroRenderingMode({ installDir, }) {
-    // Check for astro config file
     const configMatches = await (0, fast_glob_1.default)('astro.config.@(mjs|ts|js)', {
         dot: true,
         cwd: installDir,
@@ -41,7 +34,6 @@ async function getAstroRenderingMode({ installDir, }) {
     let hasAdapter = false;
     let outputMode = null;
     let usesViewTransitions = false;
-    // Check package.json for adapters
     try {
         const packageJsonPath = path_1.default.join(installDir, 'package.json');
         const packageJsonContent = await promises_1.default.readFile(packageJsonPath, 'utf-8');
@@ -50,7 +42,6 @@ async function getAstroRenderingMode({ installDir, }) {
             ...packageJson.dependencies,
             ...packageJson.devDependencies,
         };
-        // Check for Astro adapters (node, vercel, netlify, cloudflare, etc.)
         hasAdapter = Object.keys(allDeps).some((dep) => dep.startsWith('@astrojs/') &&
             (dep.includes('node') ||
                 dep.includes('vercel') ||
@@ -61,12 +52,10 @@ async function getAstroRenderingMode({ installDir, }) {
     catch {
         // package.json not found or invalid
     }
-    // Parse astro config for output mode
     if (configMatches.length > 0) {
         try {
             const configPath = path_1.default.join(installDir, configMatches[0]);
             const configContent = await promises_1.default.readFile(configPath, 'utf-8');
-            // Simple regex to detect output mode
             const outputMatch = configContent.match(/output:\s*['"](\w+)['"]/);
             if (outputMatch) {
                 outputMode = outputMatch[1];
@@ -76,14 +65,12 @@ async function getAstroRenderingMode({ installDir, }) {
             // Config file not readable
         }
     }
-    // Check for view transitions usage
     const viewTransitionMatches = await (0, fast_glob_1.default)('**/*.@(astro|ts|tsx|js|jsx)', {
         dot: true,
         cwd: installDir,
         ignore: exports.IGNORE_PATTERNS,
     });
     for (const file of viewTransitionMatches.slice(0, 20)) {
-        // Check first 20 files
         try {
             const filePath = path_1.default.join(installDir, file);
             const content = await promises_1.default.readFile(filePath, 'utf-8');
@@ -98,52 +85,16 @@ async function getAstroRenderingMode({ installDir, }) {
             // File not readable
         }
     }
-    // Determine rendering mode based on findings
     if (usesViewTransitions) {
-        clack_1.default.log.info(`Detected Astro with View Transitions (ClientRouter) 🔄`);
         return AstroRenderingMode.VIEW_TRANSITIONS;
     }
     if (outputMode === 'server' && hasAdapter) {
-        clack_1.default.log.info(`Detected Astro SSR mode 🖥️`);
         return AstroRenderingMode.SSR;
     }
-    // In Astro 5, 'static' is the default and supports per-page SSR opt-in when an adapter is present
-    // This is the "hybrid" pattern even if output mode isn't explicitly set
     if (hasAdapter) {
-        clack_1.default.log.info(`Detected Astro hybrid mode 🔀`);
         return AstroRenderingMode.HYBRID;
     }
-    if (!hasAdapter) {
-        clack_1.default.log.info(`Detected Astro static mode 📄`);
-        return AstroRenderingMode.STATIC;
-    }
-    // If detection is ambiguous, ask the user
-    const result = await (0, clack_utils_1.abortIfCancelled)(clack_1.default.select({
-        message: 'What rendering mode is your Astro project using?',
-        options: [
-            {
-                label: (0, exports.getAstroRenderingModeName)(AstroRenderingMode.STATIC),
-                value: AstroRenderingMode.STATIC,
-                hint: 'Pre-rendered static HTML (default)',
-            },
-            {
-                label: (0, exports.getAstroRenderingModeName)(AstroRenderingMode.VIEW_TRANSITIONS),
-                value: AstroRenderingMode.VIEW_TRANSITIONS,
-                hint: 'Static with ClientRouter for SPA-like navigation',
-            },
-            {
-                label: (0, exports.getAstroRenderingModeName)(AstroRenderingMode.HYBRID),
-                value: AstroRenderingMode.HYBRID,
-                hint: 'Mostly static with some SSR pages',
-            },
-            {
-                label: (0, exports.getAstroRenderingModeName)(AstroRenderingMode.SSR),
-                value: AstroRenderingMode.SSR,
-                hint: 'Full server-side rendering',
-            },
-        ],
-    }), constants_1.Integration.astro);
-    return result;
+    return AstroRenderingMode.STATIC;
 }
 const getAstroRenderingModeName = (mode) => {
     switch (mode) {

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/frameworks/astro/utils.ts"],"names":[],"mappings":"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","sourcesContent":["import fg from 'fast-glob';\nimport fs from 'fs/promises';\nimport path from 'path';\nimport type { WizardOptions } from '../../utils/types';\nimport { createVersionBucket } from '../../utils/semver';\n\nexport const getAstroVersionBucket = createVersionBucket();\n\nexport enum AstroRenderingMode {\n  STATIC = 'static',\n  SSR = 'ssr',\n  HYBRID = 'hybrid',\n  VIEW_TRANSITIONS = 'view-transitions',\n}\n\nexport const IGNORE_PATTERNS = [\n  '**/node_modules/**',\n  '**/dist/**',\n  '**/.astro/**',\n];\n\n/**\n * Detect the Astro rendering mode. Pure — always resolves (Astro detection is reliable).\n */\nexport async function getAstroRenderingMode({\n  installDir,\n}: Pick<WizardOptions, 'installDir'>): Promise<AstroRenderingMode> {\n  const configMatches = await fg('astro.config.@(mjs|ts|js)', {\n    dot: true,\n    cwd: installDir,\n    ignore: IGNORE_PATTERNS,\n  });\n\n  let hasAdapter = false;\n  let outputMode: string | null = null;\n  let usesViewTransitions = false;\n\n  try {\n    const packageJsonPath = path.join(installDir, 'package.json');\n    const packageJsonContent = await fs.readFile(packageJsonPath, 'utf-8');\n    const packageJson = JSON.parse(packageJsonContent);\n    const allDeps = {\n      ...packageJson.dependencies,\n      ...packageJson.devDependencies,\n    };\n\n    hasAdapter = Object.keys(allDeps).some(\n      (dep) =>\n        dep.startsWith('@astrojs/') &&\n        (dep.includes('node') ||\n          dep.includes('vercel') ||\n          dep.includes('netlify') ||\n          dep.includes('cloudflare') ||\n          dep.includes('deno')),\n    );\n  } catch {\n    // package.json not found or invalid\n  }\n\n  if (configMatches.length > 0) {\n    try {\n      const configPath = path.join(installDir, configMatches[0]);\n      const configContent = await fs.readFile(configPath, 'utf-8');\n      const outputMatch = configContent.match(/output:\\s*['\"](\\w+)['\"]/);\n      if (outputMatch) {\n        outputMode = outputMatch[1];\n      }\n    } catch {\n      // Config file not readable\n    }\n  }\n\n  const viewTransitionMatches = await fg('**/*.@(astro|ts|tsx|js|jsx)', {\n    dot: true,\n    cwd: installDir,\n    ignore: IGNORE_PATTERNS,\n  });\n\n  for (const file of viewTransitionMatches.slice(0, 20)) {\n    try {\n      const filePath = path.join(installDir, file);\n      const content = await fs.readFile(filePath, 'utf-8');\n      if (\n        content.includes('ClientRouter') ||\n        content.includes('ViewTransitions') ||\n        content.includes('astro:transitions')\n      ) {\n        usesViewTransitions = true;\n        break;\n      }\n    } catch {\n      // File not readable\n    }\n  }\n\n  if (usesViewTransitions) {\n    return AstroRenderingMode.VIEW_TRANSITIONS;\n  }\n\n  if (outputMode === 'server' && hasAdapter) {\n    return AstroRenderingMode.SSR;\n  }\n\n  if (hasAdapter) {\n    return AstroRenderingMode.HYBRID;\n  }\n\n  return AstroRenderingMode.STATIC;\n}\n\nexport const getAstroRenderingModeName = (mode: AstroRenderingMode): string => {\n  switch (mode) {\n    case AstroRenderingMode.STATIC:\n      return 'Static (SSG)';\n    case AstroRenderingMode.VIEW_TRANSITIONS:\n      return 'View Transitions';\n    case AstroRenderingMode.SSR:\n      return 'Server (SSR)';\n    case AstroRenderingMode.HYBRID:\n      return 'Hybrid';\n    default:\n      return 'Static';\n  }\n};\n"]}

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

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

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

@@ -37,9 +37,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DJANGO_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/django/django-wizard-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"django-wizard-agent.js","sourceRoot":"","sources":["../../../../src/frameworks/django/django-wizard-agent.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAGA,iEAAyE;AACzE,mFAAkF;AAClF,mDAAkD;AAClD,0DAA2B;AAC3B,4CAA8B;AAC9B,gDAAkC;AAClC,mCAOiB;AAOJ,QAAA,mBAAmB,GAAmC;IACjE,QAAQ,EAAE;QACR,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,uBAAW,CAAC,MAAM;QAC/B,IAAI,EAAE,IAAI;QACV,OAAO,EAAE,2CAA2C;QACpD,yBAAyB,EAAE,2CAA2C;QACtE,aAAa,EAAE,KAAK,EAAE,OAAsB,EAAE,EAAE;YAC9C,MAAM,WAAW,GAAG,MAAM,IAAA,4BAAoB,EAAC,OAAO,CAAC,CAAC;YACxD,MAAM,YAAY,GAAG,MAAM,IAAA,8BAAsB,EAAC,OAAO,CAAC,CAAC;YAC3D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC;QACvC,CAAC;KACF;IAED,SAAS,EAAE;QACT,WAAW,EAAE,QAAQ;QACrB,kBAAkB,EAAE,QAAQ;QAC5B,eAAe,EAAE,KAAK;QACtB,UAAU,EAAE,GAAG,EAAE,CAAC,SAAS;QAC3B,gBAAgB,EAAE,8BAAsB;QACxC,cAAc,EAAE,OAAO;QACvB,mBAAmB,EAAE,CAAC,OAAsB,EAAE,EAAE,CAAC,IAAA,wBAAgB,EAAC,OAAO,CAAC;QAC1E,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACxB,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;YAE/B,MAAM,eAAe,GAAG,MAAM,IAAA,mBAAE,EAAC,cAAc,EAAE;gBAC/C,GAAG,EAAE,UAAU;gBACf,MAAM,EAAE,CAAC,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,CAAC;aACjE,CAAC,CAAC;YAEH,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/B,KAAK,MAAM,KAAK,IAAI,eAAe,EAAE,CAAC;oBACpC,IAAI,CAAC;wBACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAC7B,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,EAC5B,OAAO,CACR,CAAC;wBACF,4CAA4C;wBAC5C,IACE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;4BAC/B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;4BACjC,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAC;4BAC1C,2BAA2B,CAAC,IAAI,CAAC,OAAO,CAAC,EACzC,CAAC;4BACD,OAAO,IAAI,CAAC;wBACd,CAAC;oBACH,CAAC;oBAAC,MAAM,CAAC;wBACP,SAAS;oBACX,CAAC;gBACH,CAAC;YACH,CAAC;YAED,MAAM,iBAAiB,GAAG,MAAM,IAAA,mBAAE,EAChC,CAAC,sBAAsB,EAAE,mBAAmB,EAAE,aAAa,CAAC,EAC5D;gBACE,GAAG,EAAE,UAAU;gBACf,MAAM,EAAE,CAAC,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,YAAY,CAAC;aACjE,CACF,CAAC;YAEF,KAAK,MAAM,OAAO,IAAI,iBAAiB,EAAE,CAAC;gBACxC,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAC7B,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,EAC9B,OAAO,CACR,CAAC;oBACF,uEAAuE;oBACvE,uEAAuE;oBACvE,IACE,wBAAwB,CAAC,IAAI,CAAC,OAAO,CAAC;wBACtC,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,EAC/B,CAAC;wBACD,OAAO,IAAI,CAAC;oBACd,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,SAAS;gBACX,CAAC;YACH,CAAC;YAED,OAAO,KAAK,CAAC;QACf,CAAC;QACD,oBAAoB,EAAE,uDAA2B;KAClD;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;SAC9C,CAAC;KACH;IAED,OAAO,EAAE;QACP,mBAAmB,EAAE,8CAA2B;QAChD,oBAAoB,EAClB,yHAAyH;QAC3H,yBAAyB,EAAE,CAAC,OAAO,EAAE,EAAE;YACrC,MAAM,eAAe,GAAG,OAAO,CAAC,WAAW;gBACzC,CAAC,CAAC,IAAA,gCAAwB,EAAC,OAAO,CAAC,WAAW,CAAC;gBAC/C,CAAC,CAAC,SAAS,CAAC;YAEd,yDAAyD;YACzD,MAAM,cAAc,GAAsC;gBACxD,CAAC,yBAAiB,CAAC,QAAQ,CAAC,EAAE,QAAQ;gBACtC,CAAC,yBAAiB,CAAC,GAAG,CAAC,EAAE,QAAQ;gBACjC,CAAC,yBAAiB,CAAC,OAAO,CAAC,EAAE,QAAQ;gBACrC,CAAC,yBAAiB,CAAC,QAAQ,CAAC,EAAE,QAAQ;aACvC,CAAC;YAEF,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW;gBACrC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,WAAW,CAAC;gBACrC,CAAC,CAAC,QAAQ,CAAC;YAEb,MAAM,KAAK,GAAG;gBACZ,iBAAiB,eAAe,EAAE;gBAClC,sBAAsB,WAAW,mCAAmC,WAAW,qBAAqB;aACrG,CAAC;YAEF,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;gBACzB,KAAK,CAAC,IAAI,CAAC,kBAAkB,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;YACvD,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,gCAAwB,EAAC,OAAO,CAAC,WAAW,CAAC;gBAC/C,CAAC,CAAC,QAAQ,CAAC;YACb,OAAO;gBACL,iBAAiB,eAAe,oBAAoB;gBACpD,sCAAsC;gBACtC,4CAA4C;gBAC5C,uDAAuD;aACxD,CAAC;QACJ,CAAC;QACD,iBAAiB,EAAE,GAAG,EAAE,CAAC;YACvB,+DAA+D;YAC/D,qDAAqD;YACrD,4EAA4E;SAC7E;KACF;CACF,CAAC","sourcesContent":["/* Django 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  getDjangoVersion,\n  getDjangoProjectType,\n  getDjangoProjectTypeName,\n  getDjangoVersionBucket,\n  DjangoProjectType,\n  findDjangoSettingsFile,\n} from './utils';\n\ntype DjangoContext = {\n  projectType?: DjangoProjectType;\n  settingsFile?: string;\n};\n\nexport const DJANGO_AGENT_CONFIG: FrameworkConfig<DjangoContext> = {\n  metadata: {\n    name: 'Django',\n    integration: Integration.django,\n    beta: true,\n    docsUrl: 'https://posthog.com/docs/libraries/django',\n    unsupportedVersionDocsUrl: 'https://posthog.com/docs/libraries/python',\n    gatherContext: async (options: WizardOptions) => {\n      const projectType = await getDjangoProjectType(options);\n      const settingsFile = await findDjangoSettingsFile(options);\n      return { projectType, settingsFile };\n    },\n  },\n\n  detection: {\n    packageName: 'django',\n    packageDisplayName: 'Django',\n    usesPackageJson: false,\n    getVersion: () => undefined,\n    getVersionBucket: getDjangoVersionBucket,\n    minimumVersion: '3.0.0',\n    getInstalledVersion: (options: WizardOptions) => getDjangoVersion(options),\n    detect: async (options) => {\n      const { installDir } = options;\n\n      const managePyMatches = await fg('**/manage.py', {\n        cwd: installDir,\n        ignore: ['**/venv/**', '**/.venv/**', '**/env/**', '**/.env/**'],\n      });\n\n      if (managePyMatches.length > 0) {\n        for (const match of managePyMatches) {\n          try {\n            const content = fs.readFileSync(\n              path.join(installDir, match),\n              'utf-8',\n            );\n            // Check for actual Django imports and usage\n            if (\n              content.includes('from django') ||\n              content.includes('import django') ||\n              content.includes('DJANGO_SETTINGS_MODULE') ||\n              /execute_from_command_line/.test(content)\n            ) {\n              return true;\n            }\n          } catch {\n            continue;\n          }\n        }\n      }\n\n      const requirementsFiles = await fg(\n        ['**/requirements*.txt', '**/pyproject.toml', '**/setup.py'],\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          // Match Django as a package requirement, not in comments or other text\n          // Look for: django, django>=, django==, django~=, Django (capitalized)\n          if (\n            /^django([>=~!<\\s]|$)/im.test(content) ||\n            /[\"']django[\"']/i.test(content)\n          ) {\n            return true;\n          }\n        } catch {\n          continue;\n        }\n      }\n\n      return false;\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      projectType: context.projectType || 'unknown',\n    }),\n  },\n\n  prompts: {\n    packageInstallation: PYTHON_PACKAGE_INSTALLATION,\n    projectTypeDetection:\n      'This is a Python/Django project. Look for requirements.txt, pyproject.toml, setup.py, Pipfile, or manage.py to confirm.',\n    getAdditionalContextLines: (context) => {\n      const projectTypeName = context.projectType\n        ? getDjangoProjectTypeName(context.projectType)\n        : 'unknown';\n\n      // Map project type to framework ID for MCP docs resource\n      const frameworkIdMap: Record<DjangoProjectType, string> = {\n        [DjangoProjectType.STANDARD]: 'django',\n        [DjangoProjectType.DRF]: 'django',\n        [DjangoProjectType.WAGTAIL]: 'django',\n        [DjangoProjectType.CHANNELS]: 'django',\n      };\n\n      const frameworkId = context.projectType\n        ? frameworkIdMap[context.projectType]\n        : 'django';\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.settingsFile) {\n        lines.push(`Settings file: ${context.settingsFile}`);\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        ? getDjangoProjectTypeName(context.projectType)\n        : 'Django';\n      return [\n        `Analyzed your ${projectTypeName} project structure`,\n        `Installed the PostHog Python package`,\n        `Configured PostHog in your Django settings`,\n        `Added PostHog middleware for automatic event tracking`,\n      ];\n    },\n    getOutroNextSteps: () => [\n      'Start your Django development server to see PostHog in action',\n      'Visit your PostHog dashboard to see incoming events',\n      'Use identify_context() within new_context() to associate events with users',\n    ],\n  },\n};\n"]}

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

@@ -1,4 +1,4 @@
-import type { WizardOptions } from '../utils/types';
+import type { WizardOptions } from '../../utils/types';
 export declare enum DjangoProjectType {
     STANDARD = "standard",// Traditional Django project (django-admin startproject)
     DRF = "drf",// Django REST Framework API

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

@@ -43,8 +43,8 @@ exports.getDjangoProjectTypeName = getDjangoProjectTypeName;
 exports.findDjangoSettingsFile = findDjangoSettingsFile;
 exports.findDjangoUrlsFile = findDjangoUrlsFile;
 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 DjangoProjectType;
@@ -186,21 +186,21 @@ async function getDjangoProjectType(options) {
     const { installDir } = options;
     // Check for Wagtail first (CMS)
     if (await hasWagtail({ installDir })) {
-        clack_1.default.log.info('Detected Django with Wagtail CMS');
+        (0, ui_1.getUI)().setDetectedFramework('Django with Wagtail CMS');
         return DjangoProjectType.WAGTAIL;
     }
     // Check for Django REST Framework
     if (await hasDRF({ installDir })) {
-        clack_1.default.log.info('Detected Django REST Framework project');
+        (0, ui_1.getUI)().setDetectedFramework('Django REST Framework');
         return DjangoProjectType.DRF;
     }
     // Check for Django Channels
     if (await hasChannels({ installDir })) {
-        clack_1.default.log.info('Detected Django Channels project');
+        (0, ui_1.getUI)().setDetectedFramework('Django Channels');
         return DjangoProjectType.CHANNELS;
     }
     // Default to standard Django
-    clack_1.default.log.info('Detected standard Django project');
+    (0, ui_1.getUI)().setDetectedFramework('Django');
     return DjangoProjectType.STANDARD;
 }
 /**

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/frameworks/django/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 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    getUI().setDetectedFramework('Django with Wagtail CMS');\n    return DjangoProjectType.WAGTAIL;\n  }\n\n  // Check for Django REST Framework\n  if (await hasDRF({ installDir })) {\n    getUI().setDetectedFramework('Django REST Framework');\n    return DjangoProjectType.DRF;\n  }\n\n  // Check for Django Channels\n  if (await hasChannels({ installDir })) {\n    getUI().setDetectedFramework('Django Channels');\n    return DjangoProjectType.CHANNELS;\n  }\n\n  // Default to standard Django\n  getUI().setDetectedFramework('Django');\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/frameworks/fastapi/fastapi-wizard-agent.d.ts

@@ -0,0 +1,5 @@
+import type { FrameworkConfig } from '../../lib/framework-config';
+/**
+ * FastAPI framework configuration for the universal agent runner
+ */
+export declare const FASTAPI_AGENT_CONFIG: FrameworkConfig;

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

@@ -37,15 +37,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FASTAPI_AGENT_CONFIG = void 0;
-exports.runFastAPIWizardAgent = runFastAPIWizardAgent;
-const framework_config_1 = require("../lib/framework-config");
-const package_manager_detection_1 = require("../lib/package-manager-detection");
-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 framework_config_1 = require("../../lib/framework-config");
+const package_manager_detection_1 = require("../../lib/package-manager-detection");
+const constants_1 = require("../../lib/constants");
 const utils_1 = require("./utils");
 const fast_glob_1 = __importDefault(require("fast-glob"));
 const fs = __importStar(require("node:fs"));
@@ -53,7 +47,6 @@ 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',
@@ -195,26 +188,4 @@ exports.FASTAPI_AGENT_CONFIG = {
         ],
     },
 };
-/**
- * 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/frameworks/fastapi/fastapi-wizard-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fastapi-wizard-agent.js","sourceRoot":"","sources":["../../../../src/frameworks/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 { PYTHON_PACKAGE_INSTALLATION } from '../../lib/framework-config';\nimport { detectPythonPackageManagers } from '../../lib/package-manager-detection';\nimport { Integration } from '../../lib/constants';\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 */\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    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: any) => {\n      const projectType = context.projectType as FastAPIProjectType;\n      return {\n        projectType: projectType || 'unknown',\n      };\n    },\n  },\n\n  prompts: {\n    packageInstallation: PYTHON_PACKAGE_INSTALLATION,\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    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"]}

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

@@ -1,4 +1,4 @@
-import type { WizardOptions } from '../utils/types';
+import type { WizardOptions } from '../../utils/types';
 export declare enum FastAPIProjectType {
     STANDARD = "standard",// Basic FastAPI app
     ROUTER = "router",// FastAPI with APIRouter

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

@@ -44,7 +44,7 @@ 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 ui_1 = require("../../ui");
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
 var FastAPIProjectType;
@@ -177,16 +177,16 @@ 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');
+        (0, ui_1.getUI)().setDetectedFramework('FastAPI fullstack with templates');
         return FastAPIProjectType.FULLSTACK;
     }
     // Check for APIRouter (modular structure)
     if (await hasAPIRouter({ installDir })) {
-        clack_1.default.log.info('Detected FastAPI project with APIRouter');
+        (0, ui_1.getUI)().setDetectedFramework('FastAPI with APIRouter');
         return FastAPIProjectType.ROUTER;
     }
     // Default to standard FastAPI
-    clack_1.default.log.info('Detected standard FastAPI project');
+    (0, ui_1.getUI)().setDetectedFramework('FastAPI');
     return FastAPIProjectType.STANDARD;
 }
 /**

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/frameworks/fastapi/utils.ts"],"names":[],"mappings":"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","sourcesContent":["import { major, minVersion } from 'semver';\nimport fg from 'fast-glob';\nimport { getUI } from '../../ui';\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    getUI().setDetectedFramework('FastAPI fullstack with templates');\n    return FastAPIProjectType.FULLSTACK;\n  }\n\n  // Check for APIRouter (modular structure)\n  if (await hasAPIRouter({ installDir })) {\n    getUI().setDetectedFramework('FastAPI with APIRouter');\n    return FastAPIProjectType.ROUTER;\n  }\n\n  // Default to standard FastAPI\n  getUI().setDetectedFramework('FastAPI');\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"]}

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

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

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

@@ -37,9 +37,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FLASK_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/flask/flask-wizard-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flask-wizard-agent.js","sourceRoot":"","sources":["../../../../src/frameworks/flask/flask-wizard-agent.ts"],"names":[],"mappings":"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","sourcesContent":["/* Flask 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  getFlaskVersion,\n  getFlaskProjectType,\n  getFlaskProjectTypeName,\n  getFlaskVersionBucket,\n  FlaskProjectType,\n  findFlaskAppFile,\n} from './utils';\n\ntype FlaskContext = {\n  projectType?: FlaskProjectType;\n  appFile?: string;\n};\n\nexport const FLASK_AGENT_CONFIG: FrameworkConfig<FlaskContext> = {\n  metadata: {\n    name: 'Flask',\n    integration: Integration.flask,\n    beta: true,\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 getFlaskProjectType(options);\n      const appFile = await findFlaskAppFile(options);\n      return { projectType, appFile };\n    },\n  },\n\n  detection: {\n    packageName: 'flask',\n    packageDisplayName: 'Flask',\n    usesPackageJson: false,\n    getVersion: () => undefined,\n    getVersionBucket: getFlaskVersionBucket,\n    minimumVersion: '2.0.0',\n    getInstalledVersion: (options: WizardOptions) => getFlaskVersion(options),\n    detect: async (options) => {\n      const { installDir } = options;\n\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          if (\n            /^flask([<>=~!]|$|\\s)/im.test(content) ||\n            /[\"']flask[\"']/i.test(content)\n          ) {\n            return true;\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 true;\n          }\n        } catch {\n          continue;\n        }\n      }\n\n      return false;\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      projectType: context.projectType || 'unknown',\n    }),\n  },\n\n  prompts: {\n    packageInstallation: PYTHON_PACKAGE_INSTALLATION,\n    projectTypeDetection:\n      'This is a Python/Flask project. Look for requirements.txt, pyproject.toml, setup.py, Pipfile, or app.py/wsgi.py to confirm.',\n    getAdditionalContextLines: (context) => {\n      const projectTypeName = context.projectType\n        ? getFlaskProjectTypeName(context.projectType)\n        : 'unknown';\n\n      // Map project type to framework ID for MCP docs resource\n      const frameworkIdMap: Record<FlaskProjectType, string> = {\n        [FlaskProjectType.STANDARD]: 'flask',\n        [FlaskProjectType.RESTFUL]: 'flask',\n        [FlaskProjectType.RESTX]: 'flask',\n        [FlaskProjectType.SMOREST]: 'flask',\n        [FlaskProjectType.BLUEPRINT]: 'flask',\n      };\n\n      const frameworkId = context.projectType\n        ? frameworkIdMap[context.projectType]\n        : 'flask';\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) => {\n      const projectTypeName = context.projectType\n        ? getFlaskProjectTypeName(context.projectType)\n        : 'Flask';\n      return [\n        `Analyzed your ${projectTypeName} project structure`,\n        `Installed the PostHog Python package`,\n        `Configured PostHog in your Flask application`,\n        `Added PostHog initialization with automatic event tracking`,\n      ];\n    },\n    getOutroNextSteps: () => [\n      'Start your Flask 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"]}

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

@@ -1,4 +1,4 @@
-import type { WizardOptions } from '../utils/types';
+import type { WizardOptions } from '../../utils/types';
 export declare enum FlaskProjectType {
     STANDARD = "standard",// Basic Flask app
     RESTFUL = "restful",// Flask-RESTful API