@posthog/wizard 1.29.0 → 1.31.0

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

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

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

@@ -0,0 +1,183 @@
+"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.runLaravelWizardAgent = runLaravelWizardAgent;
+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");
+/**
+ * Laravel framework configuration for the universal agent runner
+ */
+const MINIMUM_LARAVEL_VERSION = '9.0.0';
+const LARAVEL_AGENT_CONFIG = {
+    metadata: {
+        name: 'Laravel',
+        integration: constants_1.Integration.laravel,
+        docsUrl: 'https://posthog.com/docs/libraries/php',
+        unsupportedVersionDocsUrl: 'https://posthog.com/docs/libraries/php',
+        gatherContext: async (options) => {
+            const projectType = await (0, utils_1.getLaravelProjectType)(options);
+            const serviceProvider = await (0, utils_1.findLaravelServiceProvider)(options);
+            const bootstrapFile = (0, utils_1.findLaravelBootstrapFile)(options);
+            const laravelStructure = (0, utils_1.detectLaravelStructure)(options);
+            return {
+                projectType,
+                serviceProvider,
+                bootstrapFile,
+                laravelStructure,
+            };
+        },
+    },
+    detection: {
+        packageName: 'laravel/framework',
+        packageDisplayName: 'Laravel',
+        usesPackageJson: false,
+        getVersion: (_packageJson) => {
+            // For Laravel, we don't use package.json. Version is extracted separately
+            // from composer.json in the wizard entry point
+            return undefined;
+        },
+        getVersionBucket: utils_1.getLaravelVersionBucket,
+    },
+    environment: {
+        uploadToHosting: false,
+        getEnvVars: (apiKey, host) => ({
+            POSTHOG_API_KEY: apiKey,
+            POSTHOG_HOST: host,
+        }),
+    },
+    analytics: {
+        getTags: (context) => {
+            const projectType = context.projectType;
+            return {
+                projectType: projectType || 'unknown',
+                laravelStructure: context.laravelStructure || 'unknown',
+            };
+        },
+    },
+    prompts: {
+        projectTypeDetection: 'This is a PHP/Laravel project. Look for composer.json, artisan CLI, and app/ directory structure to confirm. Check for Laravel-specific packages like laravel/framework.',
+        packageInstallation: 'Use Composer to install packages. Run `composer require posthog/posthog-php` without pinning a specific version.',
+        getAdditionalContextLines: (context) => {
+            const projectType = context.projectType;
+            const projectTypeName = projectType
+                ? (0, utils_1.getLaravelProjectTypeName)(projectType)
+                : 'unknown';
+            const lines = [
+                `Project type: ${projectTypeName}`,
+                `Framework docs ID: php (use posthog://docs/frameworks/php for documentation)`,
+                `Laravel structure: ${context.laravelStructure} (affects where to add configuration)`,
+            ];
+            if (context.serviceProvider) {
+                lines.push(`Service provider: ${context.serviceProvider}`);
+            }
+            if (context.bootstrapFile) {
+                lines.push(`Bootstrap file: ${context.bootstrapFile}`);
+            }
+            // Add Laravel-specific guidance based on version structure
+            if (context.laravelStructure === 'latest') {
+                lines.push('Note: Laravel 11+ uses simplified bootstrap/app.php for middleware and providers');
+            }
+            else {
+                lines.push('Note: Use app/Http/Kernel.php for middleware, app/Providers for service providers');
+            }
+            return lines;
+        },
+    },
+    ui: {
+        successMessage: 'PostHog integration complete',
+        estimatedDurationMinutes: 5,
+        getOutroChanges: (context) => {
+            const projectType = context.projectType;
+            const projectTypeName = projectType
+                ? (0, utils_1.getLaravelProjectTypeName)(projectType)
+                : 'Laravel';
+            const changes = [
+                `Analyzed your ${projectTypeName} project structure`,
+                `Installed the PostHog PHP package via Composer`,
+                `Configured PostHog in your Laravel application`,
+            ];
+            if (context.laravelStructure === 'latest') {
+                changes.push('Added PostHog initialization to bootstrap/app.php');
+            }
+            else {
+                changes.push('Created a PostHog service provider for initialization');
+            }
+            if (projectType === utils_1.LaravelProjectType.INERTIA) {
+                changes.push('Configured PostHog to work with Inertia.js');
+            }
+            if (projectType === utils_1.LaravelProjectType.LIVEWIRE) {
+                changes.push('Configured PostHog to work with Livewire');
+            }
+            return changes;
+        },
+        getOutroNextSteps: () => [
+            'Start your Laravel development server with `php artisan serve`',
+            'Visit your PostHog dashboard to see incoming events',
+            'Use PostHog::capture() to track custom events',
+            'Use PostHog::identify() to associate events with users',
+        ],
+    },
+};
+/**
+ * Laravel wizard powered by the universal agent runner.
+ */
+async function runLaravelWizardAgent(options) {
+    if (options.debug) {
+        (0, debug_1.enableDebugLogs)();
+    }
+    // Check Laravel version - agent wizard requires >= 9.0.0
+    const laravelVersion = (0, utils_1.getLaravelVersion)(options);
+    if (laravelVersion) {
+        const coercedVersion = semver.coerce(laravelVersion);
+        if (coercedVersion && semver.lt(coercedVersion, MINIMUM_LARAVEL_VERSION)) {
+            const docsUrl = LARAVEL_AGENT_CONFIG.metadata.unsupportedVersionDocsUrl ??
+                LARAVEL_AGENT_CONFIG.metadata.docsUrl;
+            clack_1.default.log.warn(`Sorry: the wizard can't help you with Laravel ${laravelVersion}. Upgrade to Laravel ${MINIMUM_LARAVEL_VERSION} or later, or check out the manual setup guide.`);
+            clack_1.default.log.info(`Setup Laravel manually: ${chalk_1.default.cyan(docsUrl)}`);
+            clack_1.default.outro('PostHog wizard will see you next time!');
+            return;
+        }
+    }
+    await (0, agent_runner_1.runAgentWizard)(LARAVEL_AGENT_CONFIG, options);
+}
+//# sourceMappingURL=laravel-wizard-agent.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"laravel-wizard-agent.js","sourceRoot":"","sources":["../../../src/laravel/laravel-wizard-agent.ts"],"names":[],"mappings":"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","sourcesContent":["/* Laravel 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  getLaravelVersion,\n  getLaravelProjectType,\n  getLaravelProjectTypeName,\n  getLaravelVersionBucket,\n  LaravelProjectType,\n  findLaravelServiceProvider,\n  findLaravelBootstrapFile,\n  detectLaravelStructure,\n} from './utils';\n\n/**\n * Laravel framework configuration for the universal agent runner\n */\nconst MINIMUM_LARAVEL_VERSION = '9.0.0';\n\nconst LARAVEL_AGENT_CONFIG: FrameworkConfig = {\n  metadata: {\n    name: 'Laravel',\n    integration: Integration.laravel,\n    docsUrl: 'https://posthog.com/docs/libraries/php',\n    unsupportedVersionDocsUrl: 'https://posthog.com/docs/libraries/php',\n    gatherContext: async (options: WizardOptions) => {\n      const projectType = await getLaravelProjectType(options);\n      const serviceProvider = await findLaravelServiceProvider(options);\n      const bootstrapFile = findLaravelBootstrapFile(options);\n      const laravelStructure = detectLaravelStructure(options);\n\n      return {\n        projectType,\n        serviceProvider,\n        bootstrapFile,\n        laravelStructure,\n      };\n    },\n  },\n\n  detection: {\n    packageName: 'laravel/framework',\n    packageDisplayName: 'Laravel',\n    usesPackageJson: false,\n    getVersion: (_packageJson: any) => {\n      // For Laravel, we don't use package.json. Version is extracted separately\n      // from composer.json in the wizard entry point\n      return undefined;\n    },\n    getVersionBucket: getLaravelVersionBucket,\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 LaravelProjectType;\n      return {\n        projectType: projectType || 'unknown',\n        laravelStructure: context.laravelStructure || 'unknown',\n      };\n    },\n  },\n\n  prompts: {\n    projectTypeDetection:\n      'This is a PHP/Laravel project. Look for composer.json, artisan CLI, and app/ directory structure to confirm. Check for Laravel-specific packages like laravel/framework.',\n    packageInstallation:\n      'Use Composer to install packages. Run `composer require posthog/posthog-php` without pinning a specific version.',\n    getAdditionalContextLines: (context: any) => {\n      const projectType = context.projectType as LaravelProjectType;\n      const projectTypeName = projectType\n        ? getLaravelProjectTypeName(projectType)\n        : 'unknown';\n\n      const lines = [\n        `Project type: ${projectTypeName}`,\n        `Framework docs ID: php (use posthog://docs/frameworks/php for documentation)`,\n        `Laravel structure: ${context.laravelStructure} (affects where to add configuration)`,\n      ];\n\n      if (context.serviceProvider) {\n        lines.push(`Service provider: ${context.serviceProvider}`);\n      }\n\n      if (context.bootstrapFile) {\n        lines.push(`Bootstrap file: ${context.bootstrapFile}`);\n      }\n\n      // Add Laravel-specific guidance based on version structure\n      if (context.laravelStructure === 'latest') {\n        lines.push(\n          'Note: Laravel 11+ uses simplified bootstrap/app.php for middleware and providers',\n        );\n      } else {\n        lines.push(\n          'Note: Use app/Http/Kernel.php for middleware, app/Providers for service providers',\n        );\n      }\n\n      return lines;\n    },\n  },\n\n  ui: {\n    successMessage: 'PostHog integration complete',\n    estimatedDurationMinutes: 5,\n    getOutroChanges: (context: any) => {\n      const projectType = context.projectType as LaravelProjectType;\n      const projectTypeName = projectType\n        ? getLaravelProjectTypeName(projectType)\n        : 'Laravel';\n\n      const changes = [\n        `Analyzed your ${projectTypeName} project structure`,\n        `Installed the PostHog PHP package via Composer`,\n        `Configured PostHog in your Laravel application`,\n      ];\n\n      if (context.laravelStructure === 'latest') {\n        changes.push('Added PostHog initialization to bootstrap/app.php');\n      } else {\n        changes.push('Created a PostHog service provider for initialization');\n      }\n\n      if (projectType === LaravelProjectType.INERTIA) {\n        changes.push('Configured PostHog to work with Inertia.js');\n      }\n\n      if (projectType === LaravelProjectType.LIVEWIRE) {\n        changes.push('Configured PostHog to work with Livewire');\n      }\n\n      return changes;\n    },\n    getOutroNextSteps: () => [\n      'Start your Laravel development server with `php artisan serve`',\n      'Visit your PostHog dashboard to see incoming events',\n      'Use PostHog::capture() to track custom events',\n      'Use PostHog::identify() to associate events with users',\n    ],\n  },\n};\n\n/**\n * Laravel wizard powered by the universal agent runner.\n */\nexport async function runLaravelWizardAgent(\n  options: WizardOptions,\n): Promise<void> {\n  if (options.debug) {\n    enableDebugLogs();\n  }\n\n  // Check Laravel version - agent wizard requires >= 9.0.0\n  const laravelVersion = getLaravelVersion(options);\n\n  if (laravelVersion) {\n    const coercedVersion = semver.coerce(laravelVersion);\n    if (coercedVersion && semver.lt(coercedVersion, MINIMUM_LARAVEL_VERSION)) {\n      const docsUrl =\n        LARAVEL_AGENT_CONFIG.metadata.unsupportedVersionDocsUrl ??\n        LARAVEL_AGENT_CONFIG.metadata.docsUrl;\n\n      clack.log.warn(\n        `Sorry: the wizard can't help you with Laravel ${laravelVersion}. Upgrade to Laravel ${MINIMUM_LARAVEL_VERSION} or later, or check out the manual setup guide.`,\n      );\n      clack.log.info(`Setup Laravel manually: ${chalk.cyan(docsUrl)}`);\n      clack.outro('PostHog wizard will see you next time!');\n      return;\n    }\n  }\n\n  await runAgentWizard(LARAVEL_AGENT_CONFIG, options);\n}\n"]}

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

@@ -0,0 +1,38 @@
+import type { WizardOptions } from '../utils/types';
+export declare enum LaravelProjectType {
+    STANDARD = "standard",// Basic Laravel app
+    INERTIA = "inertia",// Inertia.js (Vue/React SPA) - may need JS SDK too
+    LIVEWIRE = "livewire"
+}
+/**
+ * Get Laravel version bucket for analytics
+ */
+export declare function getLaravelVersionBucket(version: string | undefined): string;
+/**
+ * Read and parse composer.json
+ */
+export declare function getComposerJson(options: Pick<WizardOptions, 'installDir'>): Record<string, any> | undefined;
+/**
+ * Get Laravel version from composer.json
+ */
+export declare function getLaravelVersion(options: Pick<WizardOptions, 'installDir'>): string | undefined;
+/**
+ * Get human-readable name for Laravel project type
+ */
+export declare function getLaravelProjectTypeName(projectType: LaravelProjectType): string;
+/**
+ * Detect Laravel project type
+ */
+export declare function getLaravelProjectType(options: WizardOptions): Promise<LaravelProjectType>;
+/**
+ * Find the main service provider file
+ */
+export declare function findLaravelServiceProvider(options: Pick<WizardOptions, 'installDir'>): Promise<string | undefined>;
+/**
+ * Find the bootstrap file (differs between Laravel versions)
+ */
+export declare function findLaravelBootstrapFile(options: Pick<WizardOptions, 'installDir'>): string | undefined;
+/**
+ * Detect Laravel version structure for configuration guidance
+ */
+export declare function detectLaravelStructure(options: Pick<WizardOptions, 'installDir'>): 'legacy' | 'modern' | 'latest';

package/dist/src/laravel/utils.js

@@ -0,0 +1,257 @@
+"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.LaravelProjectType = void 0;
+exports.getLaravelVersionBucket = getLaravelVersionBucket;
+exports.getComposerJson = getComposerJson;
+exports.getLaravelVersion = getLaravelVersion;
+exports.getLaravelProjectTypeName = getLaravelProjectTypeName;
+exports.getLaravelProjectType = getLaravelProjectType;
+exports.findLaravelServiceProvider = findLaravelServiceProvider;
+exports.findLaravelBootstrapFile = findLaravelBootstrapFile;
+exports.detectLaravelStructure = detectLaravelStructure;
+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 LaravelProjectType;
+(function (LaravelProjectType) {
+    LaravelProjectType["STANDARD"] = "standard";
+    LaravelProjectType["INERTIA"] = "inertia";
+    LaravelProjectType["LIVEWIRE"] = "livewire";
+})(LaravelProjectType || (exports.LaravelProjectType = LaravelProjectType = {}));
+/**
+ * Ignore patterns for Laravel projects
+ */
+const LARAVEL_IGNORE_PATTERNS = [
+    '**/node_modules/**',
+    '**/vendor/**',
+    '**/storage/**',
+    '**/bootstrap/cache/**',
+    '**/.phpunit.cache/**',
+    '**/public/build/**',
+    '**/public/hot/**',
+];
+/**
+ * Get Laravel version bucket for analytics
+ */
+function getLaravelVersionBucket(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 >= 9) {
+            return `${majorVersion}.x`;
+        }
+        return '<9.0.0';
+    }
+    catch {
+        return 'unknown';
+    }
+}
+/**
+ * Read and parse composer.json
+ */
+function getComposerJson(options) {
+    const { installDir } = options;
+    const composerPath = path.join(installDir, 'composer.json');
+    try {
+        const content = fs.readFileSync(composerPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Check if a package is installed (present in composer.json)
+ */
+function hasComposerPackage(packageName, options) {
+    const composer = getComposerJson(options);
+    if (!composer)
+        return false;
+    return !!(composer.require?.[packageName] || composer['require-dev']?.[packageName]);
+}
+/**
+ * Extract version for a package from composer.json
+ */
+function getComposerPackageVersion(packageName, options) {
+    const composer = getComposerJson(options);
+    if (!composer)
+        return undefined;
+    const version = composer.require?.[packageName] || composer['require-dev']?.[packageName];
+    if (version) {
+        // Clean version string (remove ^, ~, >=, etc.)
+        return version.replace(/^[\^~>=<]+/, '');
+    }
+    return undefined;
+}
+/**
+ * Check if a pattern exists in PHP source files
+ */
+async function hasLaravelCodePattern(pattern, options, filePatterns = ['**/*.php']) {
+    const { installDir } = options;
+    const phpFiles = await (0, fast_glob_1.default)(filePatterns, {
+        cwd: installDir,
+        ignore: LARAVEL_IGNORE_PATTERNS,
+    });
+    const searchPattern = typeof pattern === 'string' ? new RegExp(pattern) : pattern;
+    for (const phpFile of phpFiles) {
+        try {
+            const content = fs.readFileSync(path.join(installDir, phpFile), 'utf-8');
+            if (searchPattern.test(content))
+                return true;
+        }
+        catch {
+            continue;
+        }
+    }
+    return false;
+}
+/**
+ * Get Laravel version from composer.json
+ */
+function getLaravelVersion(options) {
+    return getComposerPackageVersion('laravel/framework', options);
+}
+/**
+ * Get human-readable name for Laravel project type
+ */
+function getLaravelProjectTypeName(projectType) {
+    switch (projectType) {
+        case LaravelProjectType.STANDARD:
+            return 'Standard Laravel';
+        case LaravelProjectType.INERTIA:
+            return 'Laravel with Inertia.js';
+        case LaravelProjectType.LIVEWIRE:
+            return 'Laravel with Livewire';
+        default:
+            return 'Laravel';
+    }
+}
+/**
+ * Check for Inertia.js
+ */
+async function hasInertia(options) {
+    return (hasComposerPackage('inertiajs/inertia-laravel', options) ||
+        (await hasLaravelCodePattern(/Inertia::render|inertia\(/, options)));
+}
+/**
+ * Check for Livewire
+ */
+async function hasLivewire(options) {
+    return (hasComposerPackage('livewire/livewire', options) ||
+        (await hasLaravelCodePattern(/extends\s+Component|@livewire/, options)));
+}
+/**
+ * Detect Laravel project type
+ */
+async function getLaravelProjectType(options) {
+    // Check for SPA/Reactive frameworks (important to detect - affects SDK needs)
+    if (await hasInertia(options)) {
+        clack_1.default.log.info('Detected Laravel with Inertia.js');
+        return LaravelProjectType.INERTIA;
+    }
+    if (await hasLivewire(options)) {
+        clack_1.default.log.info('Detected Laravel with Livewire');
+        return LaravelProjectType.LIVEWIRE;
+    }
+    // Default to standard
+    clack_1.default.log.info('Detected standard Laravel project');
+    return LaravelProjectType.STANDARD;
+}
+/**
+ * Find the main service provider file
+ */
+async function findLaravelServiceProvider(options) {
+    const { installDir } = options;
+    // Look for AppServiceProvider first (most common place for setup)
+    const appServiceProvider = path.join(installDir, 'app/Providers/AppServiceProvider.php');
+    if (fs.existsSync(appServiceProvider)) {
+        return 'app/Providers/AppServiceProvider.php';
+    }
+    // Fall back to searching for any service provider
+    const providers = await (0, fast_glob_1.default)(['**/app/Providers/*ServiceProvider.php'], {
+        cwd: installDir,
+        ignore: LARAVEL_IGNORE_PATTERNS,
+    });
+    return providers[0];
+}
+/**
+ * Find the bootstrap file (differs between Laravel versions)
+ */
+function findLaravelBootstrapFile(options) {
+    const { installDir } = options;
+    // Laravel 11+ uses bootstrap/app.php with new structure
+    const bootstrapApp = path.join(installDir, 'bootstrap/app.php');
+    if (fs.existsSync(bootstrapApp)) {
+        return 'bootstrap/app.php';
+    }
+    // Older Laravel uses app/Http/Kernel.php
+    const httpKernel = path.join(installDir, 'app/Http/Kernel.php');
+    if (fs.existsSync(httpKernel)) {
+        return 'app/Http/Kernel.php';
+    }
+    return undefined;
+}
+/**
+ * Detect Laravel version structure for configuration guidance
+ */
+function detectLaravelStructure(options) {
+    const version = getLaravelVersion(options);
+    if (!version)
+        return 'modern';
+    try {
+        const majorVersion = parseInt(version.split('.')[0], 10);
+        if (majorVersion >= 11)
+            return 'latest'; // Laravel 11+ (new structure)
+        if (majorVersion >= 9)
+            return 'modern'; // Laravel 9-10
+        return 'legacy'; // Laravel 8 and below
+    }
+    catch {
+        return 'modern';
+    }
+}
+//# sourceMappingURL=utils.js.map

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

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

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

@@ -12,6 +12,8 @@ export declare const AgentSignals: {
     readonly ERROR_MCP_MISSING: "[ERROR-MCP-MISSING]";
     /** Signal emitted when the agent cannot access the setup resource */
     readonly ERROR_RESOURCE_MISSING: "[ERROR-RESOURCE-MISSING]";
+    /** Signal emitted when the agent provides a remark about its run */
+    readonly WIZARD_REMARK: "[WIZARD-REMARK]";
 };
 export type AgentSignal = (typeof AgentSignals)[keyof typeof AgentSignals];
 /**

package/dist/src/lib/agent-interface.js

@@ -42,6 +42,8 @@ exports.AgentSignals = {
     ERROR_MCP_MISSING: '[ERROR-MCP-MISSING]',
     /** Signal emitted when the agent cannot access the setup resource */
     ERROR_RESOURCE_MISSING: '[ERROR-RESOURCE-MISSING]',
+    /** Signal emitted when the agent provides a remark about its run */
+    WIZARD_REMARK: '[WIZARD-REMARK]',
 };
 /**
  * Error types that can be returned from agent execution.
@@ -339,6 +341,16 @@ async function runAgent(agentConfig, prompt, options, spinner, config) {
         else {
             (0, debug_1.logToFile)(`Agent run completed in ${durationSeconds}s`);
         }
+        // Extract and capture the agent's reflection on the run
+        const outputText = collectedText.join('\n');
+        const remarkRegex = new RegExp(`${exports.AgentSignals.WIZARD_REMARK.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\s*(.+?)(?:\\n|$)`, 's');
+        const remarkMatch = outputText.match(remarkRegex);
+        if (remarkMatch && remarkMatch[1]) {
+            const remark = remarkMatch[1].trim();
+            if (remark) {
+                analytics_1.analytics.capture(constants_1.WIZARD_REMARK_EVENT_NAME, { remark });
+            }
+        }
         analytics_1.analytics.capture(constants_1.WIZARD_INTERACTION_EVENT_NAME, {
             action: 'agent integration completed',
             duration_ms: durationMs,
@@ -395,6 +407,31 @@ async function runAgent(agentConfig, prompt, options, spinner, config) {
                         (0, debug_1.debug)('CLI stderr:', data);
                     }
                 },
+                // Stop hook to have the agent reflect on its run
+                hooks: {
+                    Stop: [
+                        {
+                            hooks: [
+                                (input) => {
+                                    (0, debug_1.logToFile)('Stop hook triggered', {
+                                        stop_hook_active: input.stop_hook_active,
+                                    });
+                                    // Only ask for reflection on first stop (not after reflection is provided)
+                                    if (input.stop_hook_active) {
+                                        (0, debug_1.logToFile)('Stop hook: allowing stop (already reflected)');
+                                        return {}; // Allow stopping
+                                    }
+                                    (0, debug_1.logToFile)('Stop hook: requesting reflection');
+                                    return {
+                                        decision: 'block',
+                                        reason: `Before concluding, provide a brief remark about what information or guidance would have been useful to have in the integration prompt or documentation for this run. Specifically cite anything that would have prevented tool failures, erroneous edits, or other wasted turns. Format your response exactly as: ${exports.AgentSignals.WIZARD_REMARK} Your remark here`,
+                                    };
+                                },
+                            ],
+                            timeout: 30,
+                        },
+                    ],
+                },
             },
         });
         // Process the async generator