@posthog/wizard 1.25.0 → 1.27.0

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

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

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

@@ -0,0 +1,159 @@
+"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.runDjangoWizardAgent = runDjangoWizardAgent;
+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");
+/**
+ * Django framework configuration for the universal agent runner
+ */
+const MINIMUM_DJANGO_VERSION = '3.0.0';
+const DJANGO_AGENT_CONFIG = {
+    metadata: {
+        name: 'Django',
+        integration: constants_1.Integration.django,
+        docsUrl: 'https://posthog.com/docs/libraries/django',
+        unsupportedVersionDocsUrl: 'https://posthog.com/docs/libraries/python',
+        gatherContext: async (options) => {
+            const projectType = await (0, utils_1.getDjangoProjectType)(options);
+            const settingsFile = await (0, utils_1.findDjangoSettingsFile)(options);
+            return { projectType, settingsFile };
+        },
+    },
+    detection: {
+        packageName: 'django',
+        packageDisplayName: 'Django',
+        usesPackageJson: false,
+        getVersion: (_packageJson) => {
+            // For Django, 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.getDjangoVersionBucket,
+    },
+    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/Django project. Look for requirements.txt, pyproject.toml, setup.py, Pipfile, or manage.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.getDjangoProjectTypeName)(projectType)
+                : 'unknown';
+            // Map project type to framework ID for MCP docs resource
+            const frameworkIdMap = {
+                [utils_1.DjangoProjectType.STANDARD]: 'django',
+                [utils_1.DjangoProjectType.DRF]: 'django',
+                [utils_1.DjangoProjectType.WAGTAIL]: 'django',
+                [utils_1.DjangoProjectType.CHANNELS]: 'django',
+            };
+            const frameworkId = projectType ? frameworkIdMap[projectType] : 'django';
+            const lines = [
+                `Project type: ${projectTypeName}`,
+                `Framework docs ID: ${frameworkId} (use posthog://docs/frameworks/${frameworkId} for documentation)`,
+            ];
+            if (context.settingsFile) {
+                lines.push(`Settings file: ${context.settingsFile}`);
+            }
+            return lines;
+        },
+    },
+    ui: {
+        successMessage: 'PostHog integration complete',
+        estimatedDurationMinutes: 5,
+        getOutroChanges: (context) => {
+            const projectType = context.projectType;
+            const projectTypeName = projectType
+                ? (0, utils_1.getDjangoProjectTypeName)(projectType)
+                : 'Django';
+            return [
+                `Analyzed your ${projectTypeName} project structure`,
+                `Installed the PostHog Python package`,
+                `Configured PostHog in your Django settings`,
+                `Added PostHog middleware for automatic event tracking`,
+            ];
+        },
+        getOutroNextSteps: () => [
+            'Start your Django development server to see PostHog in action',
+            'Visit your PostHog dashboard to see incoming events',
+            'Use identify_context() within new_context() to associate events with users',
+        ],
+    },
+};
+/**
+ * Django wizard powered by the universal agent runner.
+ */
+async function runDjangoWizardAgent(options) {
+    if (options.debug) {
+        (0, debug_1.enableDebugLogs)();
+    }
+    // Check Django version - agent wizard requires >= 3.0.0
+    const djangoVersion = await (0, utils_1.getDjangoVersion)(options);
+    if (djangoVersion) {
+        const coercedVersion = semver.coerce(djangoVersion);
+        if (coercedVersion && semver.lt(coercedVersion, MINIMUM_DJANGO_VERSION)) {
+            const docsUrl = DJANGO_AGENT_CONFIG.metadata.unsupportedVersionDocsUrl ??
+                DJANGO_AGENT_CONFIG.metadata.docsUrl;
+            clack_1.default.log.warn(`Sorry: the wizard can't help you with Django ${djangoVersion}. Upgrade to Django ${MINIMUM_DJANGO_VERSION} or later, or check out the manual setup guide.`);
+            clack_1.default.log.info(`Setup Django manually: ${chalk_1.default.cyan(docsUrl)}`);
+            clack_1.default.outro('PostHog wizard will see you next time!');
+            return;
+        }
+    }
+    await (0, agent_runner_1.runAgentWizard)(DJANGO_AGENT_CONFIG, options);
+}
+//# sourceMappingURL=django-wizard-agent.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"django-wizard-agent.js","sourceRoot":"","sources":["../../../src/django/django-wizard-agent.ts"],"names":[],"mappings":"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","sourcesContent":["/* Django 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  getDjangoVersion,\n  getDjangoProjectType,\n  getDjangoProjectTypeName,\n  getDjangoVersionBucket,\n  DjangoProjectType,\n  findDjangoSettingsFile,\n} from './utils';\n\n/**\n * Django framework configuration for the universal agent runner\n */\nconst MINIMUM_DJANGO_VERSION = '3.0.0';\n\nconst DJANGO_AGENT_CONFIG: FrameworkConfig = {\n  metadata: {\n    name: 'Django',\n    integration: Integration.django,\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: (_packageJson: any) => {\n      // For Django, 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: getDjangoVersionBucket,\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 DjangoProjectType;\n      return {\n        projectType: projectType || 'unknown',\n      };\n    },\n  },\n\n  prompts: {\n    projectTypeDetection:\n      'This is a Python/Django project. Look for requirements.txt, pyproject.toml, setup.py, Pipfile, or manage.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 DjangoProjectType;\n      const projectTypeName = projectType\n        ? getDjangoProjectTypeName(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 = projectType ? frameworkIdMap[projectType] : '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: any) => {\n      const projectType = context.projectType as DjangoProjectType;\n      const projectTypeName = projectType\n        ? getDjangoProjectTypeName(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\n/**\n * Django wizard powered by the universal agent runner.\n */\nexport async function runDjangoWizardAgent(\n  options: WizardOptions,\n): Promise<void> {\n  if (options.debug) {\n    enableDebugLogs();\n  }\n\n  // Check Django version - agent wizard requires >= 3.0.0\n  const djangoVersion = await getDjangoVersion(options);\n\n  if (djangoVersion) {\n    const coercedVersion = semver.coerce(djangoVersion);\n    if (coercedVersion && semver.lt(coercedVersion, MINIMUM_DJANGO_VERSION)) {\n      const docsUrl =\n        DJANGO_AGENT_CONFIG.metadata.unsupportedVersionDocsUrl ??\n        DJANGO_AGENT_CONFIG.metadata.docsUrl;\n\n      clack.log.warn(\n        `Sorry: the wizard can't help you with Django ${djangoVersion}. Upgrade to Django ${MINIMUM_DJANGO_VERSION} or later, or check out the manual setup guide.`,\n      );\n      clack.log.info(`Setup Django manually: ${chalk.cyan(docsUrl)}`);\n      clack.outro('PostHog wizard will see you next time!');\n      return;\n    }\n  }\n\n  await runAgentWizard(DJANGO_AGENT_CONFIG, options);\n}\n"]}

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

@@ -0,0 +1,31 @@
+import type { WizardOptions } from '../utils/types';
+export declare enum DjangoProjectType {
+    STANDARD = "standard",// Traditional Django project (django-admin startproject)
+    DRF = "drf",// Django REST Framework API
+    WAGTAIL = "wagtail",// Wagtail CMS
+    CHANNELS = "channels"
+}
+/**
+ * Get Django version bucket for analytics
+ */
+export declare function getDjangoVersionBucket(version: string | undefined): string;
+/**
+ * Extract Django version from requirements files or pyproject.toml
+ */
+export declare function getDjangoVersion(options: Pick<WizardOptions, 'installDir'>): Promise<string | undefined>;
+/**
+ * Detect Django project type
+ */
+export declare function getDjangoProjectType(options: WizardOptions): Promise<DjangoProjectType>;
+/**
+ * Get human-readable name for Django project type
+ */
+export declare function getDjangoProjectTypeName(projectType: DjangoProjectType): string;
+/**
+ * Find the main Django settings file
+ */
+export declare function findDjangoSettingsFile(options: Pick<WizardOptions, 'installDir'>): Promise<string | undefined>;
+/**
+ * Find the main Django urls.py file
+ */
+export declare function findDjangoUrlsFile(options: Pick<WizardOptions, 'installDir'>): Promise<string | undefined>;

package/dist/src/django/utils.js

@@ -0,0 +1,325 @@
+"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.DjangoProjectType = void 0;
+exports.getDjangoVersionBucket = getDjangoVersionBucket;
+exports.getDjangoVersion = getDjangoVersion;
+exports.getDjangoProjectType = getDjangoProjectType;
+exports.getDjangoProjectTypeName = getDjangoProjectTypeName;
+exports.findDjangoSettingsFile = findDjangoSettingsFile;
+exports.findDjangoUrlsFile = findDjangoUrlsFile;
+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 DjangoProjectType;
+(function (DjangoProjectType) {
+    DjangoProjectType["STANDARD"] = "standard";
+    DjangoProjectType["DRF"] = "drf";
+    DjangoProjectType["WAGTAIL"] = "wagtail";
+    DjangoProjectType["CHANNELS"] = "channels";
+})(DjangoProjectType || (exports.DjangoProjectType = DjangoProjectType = {}));
+const IGNORE_PATTERNS = [
+    '**/node_modules/**',
+    '**/dist/**',
+    '**/build/**',
+    '**/venv/**',
+    '**/.venv/**',
+    '**/env/**',
+    '**/.env/**',
+    '**/__pycache__/**',
+    '**/migrations/**',
+];
+/**
+ * Get Django version bucket for analytics
+ */
+function getDjangoVersionBucket(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 >= 3) {
+            return `${majorVersion}.x`;
+        }
+        return `<3.0.0`;
+    }
+    catch {
+        return 'unknown';
+    }
+}
+/**
+ * Extract Django version from requirements files or pyproject.toml
+ */
+async function getDjangoVersion(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 (Django==4.2.0 or Django>=4.0)
+            const requirementsMatch = content.match(/[Dd]jango[=<>~!]+([0-9]+\.[0-9]+(?:\.[0-9]+)?)/);
+            if (requirementsMatch) {
+                return requirementsMatch[1];
+            }
+            // Try to extract from pyproject.toml format
+            const pyprojectMatch = content.match(/[Dd]jango["\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 Django REST Framework is installed
+ */
+async function hasDRF({ 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('djangorestframework')) {
+                return true;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    // Also check INSTALLED_APPS in settings
+    const settingsFiles = await (0, fast_glob_1.default)('**/settings.py', {
+        cwd: installDir,
+        ignore: IGNORE_PATTERNS,
+    });
+    for (const settingsFile of settingsFiles) {
+        try {
+            const content = fs.readFileSync(path.join(installDir, settingsFile), 'utf-8');
+            if (content.includes('rest_framework')) {
+                return true;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return false;
+}
+/**
+ * Check if Wagtail is installed
+ */
+async function hasWagtail({ 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('wagtail')) {
+                return true;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return false;
+}
+/**
+ * Check if Django Channels is installed
+ */
+async function hasChannels({ 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('channels')) {
+                return true;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return false;
+}
+/**
+ * Detect Django project type
+ */
+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');
+        return DjangoProjectType.WAGTAIL;
+    }
+    // Check for Django REST Framework
+    if (await hasDRF({ installDir })) {
+        clack_1.default.log.info('Detected Django REST Framework project');
+        return DjangoProjectType.DRF;
+    }
+    // Check for Django Channels
+    if (await hasChannels({ installDir })) {
+        clack_1.default.log.info('Detected Django Channels project');
+        return DjangoProjectType.CHANNELS;
+    }
+    // Default to standard Django
+    clack_1.default.log.info('Detected standard Django project');
+    return DjangoProjectType.STANDARD;
+}
+/**
+ * Get human-readable name for Django project type
+ */
+function getDjangoProjectTypeName(projectType) {
+    switch (projectType) {
+        case DjangoProjectType.STANDARD:
+            return 'Standard Django';
+        case DjangoProjectType.DRF:
+            return 'Django REST Framework';
+        case DjangoProjectType.WAGTAIL:
+            return 'Wagtail CMS';
+        case DjangoProjectType.CHANNELS:
+            return 'Django Channels';
+    }
+}
+/**
+ * Find the main Django settings file
+ */
+async function findDjangoSettingsFile(options) {
+    const { installDir } = options;
+    // Look for settings.py files
+    const settingsFiles = await (0, fast_glob_1.default)('**/settings.py', {
+        cwd: installDir,
+        ignore: IGNORE_PATTERNS,
+    });
+    if (settingsFiles.length === 0) {
+        // Try settings/__init__.py for split settings
+        const splitSettingsFiles = await (0, fast_glob_1.default)('**/settings/__init__.py', {
+            cwd: installDir,
+            ignore: IGNORE_PATTERNS,
+        });
+        if (splitSettingsFiles.length > 0) {
+            return splitSettingsFiles[0];
+        }
+        return undefined;
+    }
+    // If multiple settings files, prefer the one next to manage.py or in root
+    if (settingsFiles.length === 1) {
+        return settingsFiles[0];
+    }
+    // Try to find the main settings file by looking for ROOT_URLCONF
+    for (const settingsFile of settingsFiles) {
+        try {
+            const content = fs.readFileSync(path.join(installDir, settingsFile), 'utf-8');
+            if (content.includes('ROOT_URLCONF')) {
+                return settingsFile;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    // Default to first found
+    return settingsFiles[0];
+}
+/**
+ * Find the main Django urls.py file
+ */
+async function findDjangoUrlsFile(options) {
+    const { installDir } = options;
+    // First, try to find the root urls.py referenced in settings
+    const settingsFile = await findDjangoSettingsFile(options);
+    if (settingsFile) {
+        try {
+            const settingsContent = fs.readFileSync(path.join(installDir, settingsFile), 'utf-8');
+            const urlconfMatch = settingsContent.match(/ROOT_URLCONF\s*=\s*['"]([^'"]+)['"]/);
+            if (urlconfMatch) {
+                const urlconfPath = urlconfMatch[1].replace(/\./g, '/') + '.py';
+                const fullPath = path.join(installDir, urlconfPath);
+                if (fs.existsSync(fullPath)) {
+                    return urlconfPath;
+                }
+            }
+        }
+        catch {
+            // Fall through to glob search
+        }
+    }
+    // Fallback to glob search
+    const urlsFiles = await (0, fast_glob_1.default)('**/urls.py', {
+        cwd: installDir,
+        ignore: [...IGNORE_PATTERNS, '**/admin/**'],
+    });
+    if (urlsFiles.length === 0) {
+        return undefined;
+    }
+    // Prefer urls.py files that contain urlpatterns
+    for (const urlsFile of urlsFiles) {
+        try {
+            const content = fs.readFileSync(path.join(installDir, urlsFile), 'utf-8');
+            if (content.includes('urlpatterns')) {
+                return urlsFile;
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return urlsFiles[0];
+}
+//# sourceMappingURL=utils.js.map

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

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

package/dist/src/lib/agent-interface.d.ts

@@ -22,7 +22,11 @@ export declare enum AgentErrorType {
     /** Agent could not access the PostHog MCP server */
     MCP_MISSING = "WIZARD_MCP_MISSING",
     /** Agent could not access the setup resource */
-    RESOURCE_MISSING = "WIZARD_RESOURCE_MISSING"
+    RESOURCE_MISSING = "WIZARD_RESOURCE_MISSING",
+    /** API rate limit exceeded */
+    RATE_LIMIT = "WIZARD_RATE_LIMIT",
+    /** Generic API error */
+    API_ERROR = "WIZARD_API_ERROR"
 }
 export type AgentConfig = {
     workingDirectory: string;
@@ -44,6 +48,7 @@ type AgentRunConfig = {
  * - Build/typecheck/lint commands for verification
  * - Piping to tail/head for output limiting is allowed
  * - Stderr redirection (2>&1) is allowed
+ * - PostHog skill installation commands from MCP
  */
 export declare function wizardCanUseTool(toolName: string, input: Record<string, unknown>): {
     behavior: 'allow';
@@ -69,5 +74,6 @@ export declare function runAgent(agentConfig: AgentRunConfig, prompt: string, op
     errorMessage?: string;
 }): Promise<{
     error?: AgentErrorType;
+    message?: string;
 }>;
 export {};