@posthog/wizard 1.27.1 → 1.29.0

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

@@ -0,0 +1,5 @@
+import type { WizardOptions } from '../utils/types';
+/**
+ * Flask wizard powered by the universal agent runner.
+ */
+export declare function runFlaskWizardAgent(options: WizardOptions): Promise<void>;

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

@@ -0,0 +1,160 @@
+"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.runFlaskWizardAgent = runFlaskWizardAgent;
+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");
+/**
+ * Flask framework configuration for the universal agent runner
+ */
+const MINIMUM_FLASK_VERSION = '2.0.0';
+const FLASK_AGENT_CONFIG = {
+    metadata: {
+        name: 'Flask',
+        integration: constants_1.Integration.flask,
+        docsUrl: 'https://posthog.com/docs/libraries/python',
+        unsupportedVersionDocsUrl: 'https://posthog.com/docs/libraries/python',
+        gatherContext: async (options) => {
+            const projectType = await (0, utils_1.getFlaskProjectType)(options);
+            const appFile = await (0, utils_1.findFlaskAppFile)(options);
+            return { projectType, appFile };
+        },
+    },
+    detection: {
+        packageName: 'flask',
+        packageDisplayName: 'Flask',
+        usesPackageJson: false,
+        getVersion: (_packageJson) => {
+            // For Flask, 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.getFlaskVersionBucket,
+    },
+    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/Flask project. Look for requirements.txt, pyproject.toml, setup.py, Pipfile, or app.py/wsgi.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.getFlaskProjectTypeName)(projectType)
+                : 'unknown';
+            // Map project type to framework ID for MCP docs resource
+            const frameworkIdMap = {
+                [utils_1.FlaskProjectType.STANDARD]: 'flask',
+                [utils_1.FlaskProjectType.RESTFUL]: 'flask',
+                [utils_1.FlaskProjectType.RESTX]: 'flask',
+                [utils_1.FlaskProjectType.SMOREST]: 'flask',
+                [utils_1.FlaskProjectType.BLUEPRINT]: 'flask',
+            };
+            const frameworkId = projectType ? frameworkIdMap[projectType] : 'flask';
+            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.getFlaskProjectTypeName)(projectType)
+                : 'Flask';
+            return [
+                `Analyzed your ${projectTypeName} project structure`,
+                `Installed the PostHog Python package`,
+                `Configured PostHog in your Flask application`,
+                `Added PostHog initialization with automatic event tracking`,
+            ];
+        },
+        getOutroNextSteps: () => [
+            'Start your Flask development server to see PostHog in action',
+            'Visit your PostHog dashboard to see incoming events',
+            'Use posthog.identify() to associate events with users',
+        ],
+    },
+};
+/**
+ * Flask wizard powered by the universal agent runner.
+ */
+async function runFlaskWizardAgent(options) {
+    if (options.debug) {
+        (0, debug_1.enableDebugLogs)();
+    }
+    // Check Flask version - agent wizard requires >= 2.0.0
+    const flaskVersion = await (0, utils_1.getFlaskVersion)(options);
+    if (flaskVersion) {
+        const coercedVersion = semver.coerce(flaskVersion);
+        if (coercedVersion && semver.lt(coercedVersion, MINIMUM_FLASK_VERSION)) {
+            const docsUrl = FLASK_AGENT_CONFIG.metadata.unsupportedVersionDocsUrl ??
+                FLASK_AGENT_CONFIG.metadata.docsUrl;
+            clack_1.default.log.warn(`Sorry: the wizard can't help you with Flask ${flaskVersion}. Upgrade to Flask ${MINIMUM_FLASK_VERSION} or later, or check out the manual setup guide.`);
+            clack_1.default.log.info(`Setup Flask manually: ${chalk_1.default.cyan(docsUrl)}`);
+            clack_1.default.outro('PostHog wizard will see you next time!');
+            return;
+        }
+    }
+    await (0, agent_runner_1.runAgentWizard)(FLASK_AGENT_CONFIG, options);
+}
+//# sourceMappingURL=flask-wizard-agent.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flask-wizard-agent.js","sourceRoot":"","sources":["../../../src/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 { 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  getFlaskVersion,\n  getFlaskProjectType,\n  getFlaskProjectTypeName,\n  getFlaskVersionBucket,\n  FlaskProjectType,\n  findFlaskAppFile,\n} from './utils';\n\n/**\n * Flask framework configuration for the universal agent runner\n */\nconst MINIMUM_FLASK_VERSION = '2.0.0';\n\nconst FLASK_AGENT_CONFIG: FrameworkConfig = {\n  metadata: {\n    name: 'Flask',\n    integration: Integration.flask,\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: (_packageJson: any) => {\n      // For Flask, 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: getFlaskVersionBucket,\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 FlaskProjectType;\n      return {\n        projectType: projectType || 'unknown',\n      };\n    },\n  },\n\n  prompts: {\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    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 FlaskProjectType;\n      const projectTypeName = projectType\n        ? getFlaskProjectTypeName(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 = projectType ? frameworkIdMap[projectType] : '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: any) => {\n      const projectType = context.projectType as FlaskProjectType;\n      const projectTypeName = projectType\n        ? getFlaskProjectTypeName(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\n/**\n * Flask wizard powered by the universal agent runner.\n */\nexport async function runFlaskWizardAgent(\n  options: WizardOptions,\n): Promise<void> {\n  if (options.debug) {\n    enableDebugLogs();\n  }\n\n  // Check Flask version - agent wizard requires >= 2.0.0\n  const flaskVersion = await getFlaskVersion(options);\n\n  if (flaskVersion) {\n    const coercedVersion = semver.coerce(flaskVersion);\n    if (coercedVersion && semver.lt(coercedVersion, MINIMUM_FLASK_VERSION)) {\n      const docsUrl =\n        FLASK_AGENT_CONFIG.metadata.unsupportedVersionDocsUrl ??\n        FLASK_AGENT_CONFIG.metadata.docsUrl;\n\n      clack.log.warn(\n        `Sorry: the wizard can't help you with Flask ${flaskVersion}. Upgrade to Flask ${MINIMUM_FLASK_VERSION} or later, or check out the manual setup guide.`,\n      );\n      clack.log.info(`Setup Flask manually: ${chalk.cyan(docsUrl)}`);\n      clack.outro('PostHog wizard will see you next time!');\n      return;\n    }\n  }\n\n  await runAgentWizard(FLASK_AGENT_CONFIG, options);\n}\n"]}

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

@@ -0,0 +1,28 @@
+import type { WizardOptions } from '../utils/types';
+export declare enum FlaskProjectType {
+    STANDARD = "standard",// Basic Flask app
+    RESTFUL = "restful",// Flask-RESTful API
+    RESTX = "restx",// Flask-RESTX (Swagger docs)
+    SMOREST = "smorest",// flask-smorest (OpenAPI)
+    BLUEPRINT = "blueprint"
+}
+/**
+ * Get Flask version bucket for analytics
+ */
+export declare function getFlaskVersionBucket(version: string | undefined): string;
+/**
+ * Extract Flask version from requirements files or pyproject.toml
+ */
+export declare function getFlaskVersion(options: Pick<WizardOptions, 'installDir'>): Promise<string | undefined>;
+/**
+ * Detect Flask project type
+ */
+export declare function getFlaskProjectType(options: WizardOptions): Promise<FlaskProjectType>;
+/**
+ * Get human-readable name for Flask project type
+ */
+export declare function getFlaskProjectTypeName(projectType: FlaskProjectType): string;
+/**
+ * Find the main Flask app file
+ */
+export declare function findFlaskAppFile(options: Pick<WizardOptions, 'installDir'>): Promise<string | undefined>;

package/dist/src/flask/utils.js

@@ -0,0 +1,363 @@
+"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.FlaskProjectType = void 0;
+exports.getFlaskVersionBucket = getFlaskVersionBucket;
+exports.getFlaskVersion = getFlaskVersion;
+exports.getFlaskProjectType = getFlaskProjectType;
+exports.getFlaskProjectTypeName = getFlaskProjectTypeName;
+exports.findFlaskAppFile = findFlaskAppFile;
+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 FlaskProjectType;
+(function (FlaskProjectType) {
+    FlaskProjectType["STANDARD"] = "standard";
+    FlaskProjectType["RESTFUL"] = "restful";
+    FlaskProjectType["RESTX"] = "restx";
+    FlaskProjectType["SMOREST"] = "smorest";
+    FlaskProjectType["BLUEPRINT"] = "blueprint";
+})(FlaskProjectType || (exports.FlaskProjectType = FlaskProjectType = {}));
+const IGNORE_PATTERNS = [
+    '**/node_modules/**',
+    '**/dist/**',
+    '**/build/**',
+    '**/venv/**',
+    '**/.venv/**',
+    '**/env/**',
+    '**/.env/**',
+    '**/__pycache__/**',
+    '**/migrations/**',
+    '**/instance/**',
+];
+/**
+ * Get Flask version bucket for analytics
+ */
+function getFlaskVersionBucket(version) {
+    if (!version) {
+        return 'none';
+    }
+    try {
+        const minVer = (0, semver_1.minVersion)(version);
+        if (!minVer) {
+            return 'invalid';
+        }
+        const majorVersion = (0, semver_1.major)(minVer);
+        if (majorVersion >= 2) {
+            return `${majorVersion}.x`;
+        }
+        return `<2.0.0`;
+    }
+    catch {
+        return 'unknown';
+    }
+}
+/**
+ * Extract Flask version from requirements files or pyproject.toml
+ */
+async function getFlaskVersion(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 (Flask==3.0.0 or flask>=2.0)
+            const requirementsMatch = content.match(/[Ff]lask[=<>~!]+([0-9]+\.[0-9]+(?:\.[0-9]+)?)/);
+            if (requirementsMatch) {
+                return requirementsMatch[1];
+            }
+            // Try to extract from pyproject.toml format
+            const pyprojectMatch = content.match(/[Ff]lask["\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 Flask-RESTful is installed
+ */
+async function hasFlaskRESTful({ installDir, }) {
+    const requirementsFiles = await (0, fast_glob_1.default)(['**/requirements*.txt', '**/pyproject.toml', '**/Pipfile'], {
+        cwd: installDir,
+        ignore: IGNORE_PATTERNS,
+    });
+    for (const reqFile of requirementsFiles) {
+        try {
+            const content = fs.readFileSync(path.join(installDir, reqFile), 'utf-8');
+            if (content.includes('flask-restful') ||
+                content.includes('Flask-RESTful')) {
+                return true;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    // Also check imports 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('from flask_restful import') ||
+                content.includes('import flask_restful')) {
+                return true;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return false;
+}
+/**
+ * Check if Flask-RESTX is installed
+ */
+async function hasFlaskRESTX({ installDir, }) {
+    const requirementsFiles = await (0, fast_glob_1.default)(['**/requirements*.txt', '**/pyproject.toml', '**/Pipfile'], {
+        cwd: installDir,
+        ignore: IGNORE_PATTERNS,
+    });
+    for (const reqFile of requirementsFiles) {
+        try {
+            const content = fs.readFileSync(path.join(installDir, reqFile), 'utf-8');
+            if (content.includes('flask-restx') || content.includes('Flask-RESTX')) {
+                return true;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    // Also check imports 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('from flask_restx import') ||
+                content.includes('import flask_restx')) {
+                return true;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return false;
+}
+/**
+ * Check if flask-smorest is installed
+ */
+async function hasFlaskSmorest({ installDir, }) {
+    const requirementsFiles = await (0, fast_glob_1.default)(['**/requirements*.txt', '**/pyproject.toml', '**/Pipfile'], {
+        cwd: installDir,
+        ignore: IGNORE_PATTERNS,
+    });
+    for (const reqFile of requirementsFiles) {
+        try {
+            const content = fs.readFileSync(path.join(installDir, reqFile), 'utf-8');
+            if (content.includes('flask-smorest')) {
+                return true;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    // Also check imports 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('from flask_smorest import') ||
+                content.includes('import flask_smorest')) {
+                return true;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return false;
+}
+/**
+ * Check if app uses Flask Blueprints
+ */
+async function hasBlueprints({ 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('Blueprint(') ||
+                content.includes('register_blueprint(') ||
+                content.includes('from flask import Blueprint')) {
+                return true;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return false;
+}
+/**
+ * Detect Flask project type
+ */
+async function getFlaskProjectType(options) {
+    const { installDir } = options;
+    // Check for Flask-RESTX first (most specific - includes Swagger)
+    if (await hasFlaskRESTX({ installDir })) {
+        clack_1.default.log.info('Detected Flask-RESTX project');
+        return FlaskProjectType.RESTX;
+    }
+    // Check for flask-smorest (OpenAPI-first)
+    if (await hasFlaskSmorest({ installDir })) {
+        clack_1.default.log.info('Detected flask-smorest project');
+        return FlaskProjectType.SMOREST;
+    }
+    // Check for Flask-RESTful
+    if (await hasFlaskRESTful({ installDir })) {
+        clack_1.default.log.info('Detected Flask-RESTful project');
+        return FlaskProjectType.RESTFUL;
+    }
+    // Check for Blueprints (large app structure)
+    if (await hasBlueprints({ installDir })) {
+        clack_1.default.log.info('Detected Flask project with Blueprints');
+        return FlaskProjectType.BLUEPRINT;
+    }
+    // Default to standard Flask
+    clack_1.default.log.info('Detected standard Flask project');
+    return FlaskProjectType.STANDARD;
+}
+/**
+ * Get human-readable name for Flask project type
+ */
+function getFlaskProjectTypeName(projectType) {
+    switch (projectType) {
+        case FlaskProjectType.STANDARD:
+            return 'Standard Flask';
+        case FlaskProjectType.RESTFUL:
+            return 'Flask-RESTful';
+        case FlaskProjectType.RESTX:
+            return 'Flask-RESTX';
+        case FlaskProjectType.SMOREST:
+            return 'flask-smorest';
+        case FlaskProjectType.BLUEPRINT:
+            return 'Flask with Blueprints';
+    }
+}
+/**
+ * Find the main Flask app file
+ */
+async function findFlaskAppFile(options) {
+    const { installDir } = options;
+    // Common Flask app file patterns
+    const commonPatterns = [
+        '**/app.py',
+        '**/wsgi.py',
+        '**/application.py',
+        '**/run.py',
+        '**/main.py',
+        '**/__init__.py',
+    ];
+    const appFiles = await (0, fast_glob_1.default)(commonPatterns, {
+        cwd: installDir,
+        ignore: IGNORE_PATTERNS,
+    });
+    // Look for files with Flask() instantiation or create_app() factory
+    for (const appFile of appFiles) {
+        try {
+            const content = fs.readFileSync(path.join(installDir, appFile), 'utf-8');
+            // Check for Flask app instantiation or application factory
+            if (content.includes('Flask(__name__)') ||
+                content.includes('Flask(') ||
+                content.includes('def create_app(')) {
+                return appFile;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    // If no file with Flask() 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('Flask(__name__)') ||
+                content.includes('def create_app(')) {
+                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/flask/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/flask/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 FlaskProjectType {\n  STANDARD = 'standard', // Basic Flask app\n  RESTFUL = 'restful', // Flask-RESTful API\n  RESTX = 'restx', // Flask-RESTX (Swagger docs)\n  SMOREST = 'smorest', // flask-smorest (OpenAPI)\n  BLUEPRINT = 'blueprint', // Large app with blueprints\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  '**/instance/**',\n];\n\n/**\n * Get Flask version bucket for analytics\n */\nexport function getFlaskVersionBucket(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 >= 2) {\n      return `${majorVersion}.x`;\n    }\n    return `<2.0.0`;\n  } catch {\n    return 'unknown';\n  }\n}\n\n/**\n * Extract Flask version from requirements files or pyproject.toml\n */\nexport async function getFlaskVersion(\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 (Flask==3.0.0 or flask>=2.0)\n      const requirementsMatch = content.match(\n        /[Ff]lask[=<>~!]+([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]lask[\"\\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 Flask-RESTful is installed\n */\nasync function hasFlaskRESTful({\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 (\n        content.includes('flask-restful') ||\n        content.includes('Flask-RESTful')\n      ) {\n        return true;\n      }\n    } catch {\n      continue;\n    }\n  }\n\n  // Also check imports 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('from flask_restful import') ||\n        content.includes('import flask_restful')\n      ) {\n        return true;\n      }\n    } catch {\n      continue;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Check if Flask-RESTX is installed\n */\nasync function hasFlaskRESTX({\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('flask-restx') || content.includes('Flask-RESTX')) {\n        return true;\n      }\n    } catch {\n      continue;\n    }\n  }\n\n  // Also check imports 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('from flask_restx import') ||\n        content.includes('import flask_restx')\n      ) {\n        return true;\n      }\n    } catch {\n      continue;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Check if flask-smorest is installed\n */\nasync function hasFlaskSmorest({\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('flask-smorest')) {\n        return true;\n      }\n    } catch {\n      continue;\n    }\n  }\n\n  // Also check imports 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('from flask_smorest import') ||\n        content.includes('import flask_smorest')\n      ) {\n        return true;\n      }\n    } catch {\n      continue;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Check if app uses Flask Blueprints\n */\nasync function hasBlueprints({\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('Blueprint(') ||\n        content.includes('register_blueprint(') ||\n        content.includes('from flask import Blueprint')\n      ) {\n        return true;\n      }\n    } catch {\n      continue;\n    }\n  }\n\n  return false;\n}\n\n/**\n * Detect Flask project type\n */\nexport async function getFlaskProjectType(\n  options: WizardOptions,\n): Promise<FlaskProjectType> {\n  const { installDir } = options;\n\n  // Check for Flask-RESTX first (most specific - includes Swagger)\n  if (await hasFlaskRESTX({ installDir })) {\n    clack.log.info('Detected Flask-RESTX project');\n    return FlaskProjectType.RESTX;\n  }\n\n  // Check for flask-smorest (OpenAPI-first)\n  if (await hasFlaskSmorest({ installDir })) {\n    clack.log.info('Detected flask-smorest project');\n    return FlaskProjectType.SMOREST;\n  }\n\n  // Check for Flask-RESTful\n  if (await hasFlaskRESTful({ installDir })) {\n    clack.log.info('Detected Flask-RESTful project');\n    return FlaskProjectType.RESTFUL;\n  }\n\n  // Check for Blueprints (large app structure)\n  if (await hasBlueprints({ installDir })) {\n    clack.log.info('Detected Flask project with Blueprints');\n    return FlaskProjectType.BLUEPRINT;\n  }\n\n  // Default to standard Flask\n  clack.log.info('Detected standard Flask project');\n  return FlaskProjectType.STANDARD;\n}\n\n/**\n * Get human-readable name for Flask project type\n */\nexport function getFlaskProjectTypeName(projectType: FlaskProjectType): string {\n  switch (projectType) {\n    case FlaskProjectType.STANDARD:\n      return 'Standard Flask';\n    case FlaskProjectType.RESTFUL:\n      return 'Flask-RESTful';\n    case FlaskProjectType.RESTX:\n      return 'Flask-RESTX';\n    case FlaskProjectType.SMOREST:\n      return 'flask-smorest';\n    case FlaskProjectType.BLUEPRINT:\n      return 'Flask with Blueprints';\n  }\n}\n\n/**\n * Find the main Flask app file\n */\nexport async function findFlaskAppFile(\n  options: Pick<WizardOptions, 'installDir'>,\n): Promise<string | undefined> {\n  const { installDir } = options;\n\n  // Common Flask app file patterns\n  const commonPatterns = [\n    '**/app.py',\n    '**/wsgi.py',\n    '**/application.py',\n    '**/run.py',\n    '**/main.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 Flask() instantiation or create_app() factory\n  for (const appFile of appFiles) {\n    try {\n      const content = fs.readFileSync(path.join(installDir, appFile), 'utf-8');\n      // Check for Flask app instantiation or application factory\n      if (\n        content.includes('Flask(__name__)') ||\n        content.includes('Flask(') ||\n        content.includes('def create_app(')\n      ) {\n        return appFile;\n      }\n    } catch {\n      continue;\n    }\n  }\n\n  // If no file with Flask() 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 (\n        content.includes('Flask(__name__)') ||\n        content.includes('def create_app(')\n      ) {\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/lib/agent-interface.js

@@ -61,7 +61,20 @@ var AgentErrorType;
 /**
  * Package managers that can be used to run commands.
  */
-const PACKAGE_MANAGERS = ['npm', 'pnpm', 'yarn', 'bun', 'npx'];
+const PACKAGE_MANAGERS = [
+    // JavaScript
+    'npm',
+    'pnpm',
+    'yarn',
+    'bun',
+    'npx',
+    // Python
+    'pip',
+    'pip3',
+    'poetry',
+    'pipenv',
+    'uv',
+];
 /**
  * Safe scripts/commands that can be run with any package manager.
  * Uses startsWith matching, so 'build' matches 'build', 'build:prod', etc.