@posthog/wizard 1.36.1 → 2.0.0

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

@@ -38,72 +38,101 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runAgentWizard = runAgentWizard;
 const framework_config_1 = require("./framework-config");
-const clack_utils_1 = require("../utils/clack-utils");
+const wizard_session_1 = require("./wizard-session");
+const setup_utils_1 = require("../utils/setup-utils");
 const analytics_1 = require("../utils/analytics");
-const constants_1 = require("./constants");
-const clack_1 = __importDefault(require("../utils/clack"));
+const ui_1 = require("../ui");
 const agent_interface_1 = require("./agent-interface");
 const urls_1 = require("../utils/urls");
 const chalk_1 = __importDefault(require("chalk"));
 const semver = __importStar(require("semver"));
-const steps_1 = require("../steps");
 const anthropic_status_1 = require("../utils/anthropic-status");
 const debug_1 = require("../utils/debug");
 const benchmark_1 = require("./middleware/benchmark");
+const wizard_abort_1 = require("../utils/wizard-abort");
+/**
+ * Build a WizardOptions bag from a WizardSession (for code that still expects WizardOptions).
+ */
+function sessionToOptions(session) {
+    return {
+        installDir: session.installDir,
+        debug: session.debug,
+        forceInstall: session.forceInstall,
+        default: false,
+        signup: session.signup,
+        localMcp: session.localMcp,
+        ci: session.ci,
+        menu: session.menu,
+        benchmark: session.benchmark,
+        projectId: session.projectId,
+        apiKey: session.apiKey,
+    };
+}
 /**
  * Universal agent-powered wizard runner.
  * Handles the complete flow for any framework using PostHog MCP integration.
+ *
+ * All user decisions come from the session — no UI prompts.
  */
-async function runAgentWizard(config, options) {
-    if (options.debug) {
+async function runAgentWizard(config, session) {
+    if (session.debug) {
         (0, debug_1.enableDebugLogs)();
     }
     // Version check
     if (config.detection.minimumVersion && config.detection.getInstalledVersion) {
-        const version = await config.detection.getInstalledVersion(options);
+        const version = await config.detection.getInstalledVersion(sessionToOptions(session));
         if (version) {
             const coerced = semver.coerce(version);
             if (coerced && semver.lt(coerced, config.detection.minimumVersion)) {
                 const docsUrl = config.metadata.unsupportedVersionDocsUrl ?? config.metadata.docsUrl;
-                clack_1.default.log.warn(`Sorry: the wizard can't help you with ${config.metadata.name} ${version}. Upgrade to ${config.metadata.name} ${config.detection.minimumVersion} or later, or check out the manual setup guide.`);
-                clack_1.default.log.info(`Setup ${config.metadata.name} manually: ${chalk_1.default.cyan(docsUrl)}`);
-                clack_1.default.outro('PostHog wizard will see you next time!');
+                (0, ui_1.getUI)().log.warn(`Sorry: the wizard can't help you with ${config.metadata.name} ${version}. Upgrade to ${config.metadata.name} ${config.detection.minimumVersion} or later, or check out the manual setup guide.`);
+                (0, ui_1.getUI)().log.info(`Setup ${config.metadata.name} manually: ${chalk_1.default.cyan(docsUrl)}`);
+                (0, ui_1.getUI)().outro('PostHog wizard will see you next time!');
                 return;
             }
         }
     }
-    // Setup phase
-    (0, clack_utils_1.printWelcome)({ wizardName: (0, framework_config_1.getWelcomeMessage)(config.metadata.name) });
-    if (config.metadata.beta) {
-        clack_1.default.log.info(`${chalk_1.default.yellow('[BETA]')} The ${config.metadata.name} wizard is in beta. Questions or feedback? Email ${chalk_1.default.cyan('wizard@posthog.com')}`);
-    }
-    if (config.metadata.preRunNotice) {
-        clack_1.default.log.warn(config.metadata.preRunNotice);
-    }
-    clack_1.default.log.info(`We're about to read your project using our LLM gateway.\n\n.env* file contents will not leave your machine.\n\nOther files will be read and edited to provide a fully-custom PostHog integration.`);
-    const aiConsent = await (0, clack_utils_1.askForAIConsent)(options);
-    if (!aiConsent) {
-        await (0, clack_utils_1.abort)(`This wizard uses an LLM agent to intelligently modify your project. Please view the docs to set up ${config.metadata.name} manually instead: ${config.metadata.docsUrl}`, 0);
+    // Setup phase — informational only, no prompts
+    // Beta notice, pre-run notice, and welcome label are all derivable
+    // from session.frameworkConfig — IntroScreen reads them directly.
+    // Check Anthropic/Claude service status (pure — no prompt)
+    const statusResult = await (0, anthropic_status_1.checkAnthropicStatus)();
+    if (statusResult.status === 'down' || statusResult.status === 'degraded') {
+        (0, ui_1.getUI)().showServiceStatus({
+            description: statusResult.description,
+            statusPageUrl: 'https://status.claude.com',
+        });
     }
-    // Check Anthropic/Claude service status before proceeding
-    const statusOk = await (0, anthropic_status_1.checkAnthropicStatusWithPrompt)({ ci: options.ci });
-    if (!statusOk) {
-        await (0, clack_utils_1.abort)(`Please try again later, or set up ${config.metadata.name} manually: ${config.metadata.docsUrl}`, 0);
+    // Check for blocking env overrides in .claude/settings.json before login.
+    // These keys block the Wizard from accessing the PostHog LLM Gateway.
+    const blockingOverrideKeys = (0, agent_interface_1.checkClaudeSettingsOverrides)(session.installDir);
+    if (blockingOverrideKeys.length > 0) {
+        await (0, ui_1.getUI)().showSettingsOverride(blockingOverrideKeys, () => (0, agent_interface_1.backupAndFixClaudeSettings)(session.installDir));
     }
-    const typeScriptDetected = (0, clack_utils_1.isUsingTypeScript)(options);
-    await (0, clack_utils_1.confirmContinueIfNoOrDirtyGitRepo)(options);
+    // Disclosure text is static — IntroScreen renders it directly.
+    const typeScriptDetected = (0, setup_utils_1.isUsingTypeScript)({
+        installDir: session.installDir,
+    });
+    session.typescript = typeScriptDetected;
     // Framework detection and version
-    // Only check package.json for Node.js/JavaScript frameworks
     const usesPackageJson = config.detection.usesPackageJson !== false;
     let packageJson = null;
     let frameworkVersion;
     if (usesPackageJson) {
-        packageJson = await (0, clack_utils_1.getPackageDotJson)(options);
-        await (0, clack_utils_1.ensurePackageIsInstalled)(packageJson, config.detection.packageName, config.detection.packageDisplayName);
-        frameworkVersion = config.detection.getVersion(packageJson);
+        packageJson = await (0, setup_utils_1.tryGetPackageJson)({ installDir: session.installDir });
+        if (packageJson) {
+            // Log warning if package not installed, but continue (agent handles it)
+            const { hasPackageInstalled } = await import('../utils/package-json.js');
+            if (!hasPackageInstalled(config.detection.packageName, packageJson)) {
+                (0, ui_1.getUI)().log.warn(`${config.detection.packageDisplayName} does not seem to be installed. Continuing anyway — the agent will handle it.`);
+            }
+            frameworkVersion = config.detection.getVersion(packageJson);
+        }
+        else {
+            (0, ui_1.getUI)().log.warn('Could not find package.json. Continuing anyway — the agent will handle it.');
+        }
     }
     else {
-        // For non-Node frameworks (e.g., Django), version is handled differently
         frameworkVersion = config.detection.getVersion(null);
     }
     // Set analytics tags for framework version
@@ -111,16 +140,21 @@ async function runAgentWizard(config, options) {
         const versionBucket = config.detection.getVersionBucket(frameworkVersion);
         analytics_1.analytics.setTag(`${config.metadata.integration}-version`, versionBucket);
     }
-    analytics_1.analytics.capture(constants_1.WIZARD_INTERACTION_EVENT_NAME, {
-        action: 'started agent integration',
+    analytics_1.analytics.wizardCapture('agent started', {
         integration: config.metadata.integration,
     });
-    // Get PostHog credentials
-    const { projectApiKey, host, accessToken, projectId, cloudRegion } = await (0, clack_utils_1.getOrAskForProjectData)(options);
-    // Gather framework-specific context (e.g., Next.js router, React Native platform)
-    const frameworkContext = config.metadata.gatherContext
-        ? await config.metadata.gatherContext(options)
-        : {};
+    // Get PostHog credentials (region auto-detected from token)
+    const { projectApiKey, host, accessToken, projectId, cloudRegion } = await (0, setup_utils_1.getOrAskForProjectData)({
+        signup: session.signup,
+        ci: session.ci,
+        apiKey: session.apiKey,
+        projectId: session.projectId,
+    });
+    session.credentials = { accessToken, projectApiKey, host, projectId };
+    // Notify TUI that credentials are available (resolves past AuthScreen)
+    (0, ui_1.getUI)().setCredentials(session.credentials);
+    // Framework context was already gathered by SetupScreen + detection
+    const frameworkContext = session.frameworkContext;
     // Set analytics tags from framework context
     const contextTags = config.analytics.getTags(frameworkContext);
     Object.entries(contextTags).forEach(([key, value]) => {
@@ -134,102 +168,87 @@ async function runAgentWizard(config, options) {
         projectId,
     }, frameworkContext);
     // Initialize and run agent
-    const spinner = clack_1.default.spinner();
-    const mcpUrl = options.localMcp
+    const spinner = (0, ui_1.getUI)().spinner();
+    // Evaluate all feature flags at the start of the run so they can be sent to the LLM gateway
+    const wizardFlags = await analytics_1.analytics.getAllFlagsForWizard();
+    const wizardMetadata = (0, agent_interface_1.buildWizardMetadata)(wizardFlags);
+    // Determine MCP URL: CLI flag > env var > production default
+    const mcpUrl = session.localMcp
         ? 'http://localhost:8787/mcp'
         : process.env.MCP_URL || 'https://mcp.posthog.com/mcp';
+    const restoreSettings = () => (0, agent_interface_1.restoreClaudeSettings)(session.installDir);
+    (0, ui_1.getUI)().onEnterScreen('outro', restoreSettings);
+    (0, ui_1.getUI)().startRun();
     const agent = await (0, agent_interface_1.initializeAgent)({
-        workingDirectory: options.installDir,
+        workingDirectory: session.installDir,
         posthogMcpUrl: mcpUrl,
         posthogApiKey: accessToken,
         posthogApiHost: host,
         additionalMcpServers: config.metadata.additionalMcpServers,
         detectPackageManager: config.detection.detectPackageManager,
-    }, options);
-    const middleware = options.benchmark
-        ? (0, benchmark_1.createBenchmarkPipeline)(spinner, options)
+        wizardFlags,
+        wizardMetadata,
+    }, sessionToOptions(session));
+    const middleware = session.benchmark
+        ? (0, benchmark_1.createBenchmarkPipeline)(spinner, sessionToOptions(session))
         : undefined;
-    const agentResult = await (0, agent_interface_1.runAgent)(agent, integrationPrompt, options, spinner, {
+    const agentResult = await (0, agent_interface_1.runAgent)(agent, integrationPrompt, sessionToOptions(session), spinner, {
         estimatedDurationMinutes: config.ui.estimatedDurationMinutes,
         spinnerMessage: framework_config_1.SPINNER_MESSAGE,
         successMessage: config.ui.successMessage,
         errorMessage: 'Integration failed',
+        additionalFeatureQueue: session.additionalFeatureQueue,
     }, middleware);
     // Handle error cases detected in agent output
     if (agentResult.error === agent_interface_1.AgentErrorType.MCP_MISSING) {
-        analytics_1.analytics.captureException(new Error('Agent could not access PostHog MCP server'), {
-            integration: config.metadata.integration,
-            error_type: agent_interface_1.AgentErrorType.MCP_MISSING,
-            signal: agent_interface_1.AgentSignals.ERROR_MCP_MISSING,
+        await (0, wizard_abort_1.wizardAbort)({
+            message: `Could not access the PostHog MCP server\n\nThe wizard was unable to connect to the PostHog MCP server.\nThis could be due to a network issue or a configuration problem.\n\nPlease try again, or set up ${config.metadata.name} manually by following our documentation:\n${config.metadata.docsUrl}`,
+            error: new wizard_abort_1.WizardError('Agent could not access PostHog MCP server', {
+                integration: config.metadata.integration,
+                error_type: agent_interface_1.AgentErrorType.MCP_MISSING,
+                signal: agent_interface_1.AgentSignals.ERROR_MCP_MISSING,
+            }),
         });
-        const errorMessage = `
-${chalk_1.default.red('❌ Could not access the PostHog MCP server')}
-
-The wizard was unable to connect to the PostHog MCP server.
-This could be due to a network issue or a configuration problem.
-
-Please try again, or set up ${config.metadata.name} manually by following our documentation:
-${chalk_1.default.cyan(config.metadata.docsUrl)}`;
-        clack_1.default.outro(errorMessage);
-        await analytics_1.analytics.shutdown('error');
-        process.exit(1);
     }
     if (agentResult.error === agent_interface_1.AgentErrorType.RESOURCE_MISSING) {
-        analytics_1.analytics.captureException(new Error('Agent could not access setup resource'), {
-            integration: config.metadata.integration,
-            error_type: agent_interface_1.AgentErrorType.RESOURCE_MISSING,
-            signal: agent_interface_1.AgentSignals.ERROR_RESOURCE_MISSING,
+        await (0, wizard_abort_1.wizardAbort)({
+            message: `Could not access the setup resource\n\nThe wizard could not access the setup resource. This may indicate a version mismatch or a temporary service issue.\n\nPlease try again, or set up ${config.metadata.name} manually by following our documentation:\n${config.metadata.docsUrl}`,
+            error: new wizard_abort_1.WizardError('Agent could not access setup resource', {
+                integration: config.metadata.integration,
+                error_type: agent_interface_1.AgentErrorType.RESOURCE_MISSING,
+                signal: agent_interface_1.AgentSignals.ERROR_RESOURCE_MISSING,
+            }),
         });
-        const errorMessage = `
-${chalk_1.default.red('❌ Could not access the setup resource')}
-
-The wizard could not access the setup resource. This may indicate a version mismatch or a temporary service issue.
-
-Please try again, or set up ${config.metadata.name} manually by following our documentation:
-${chalk_1.default.cyan(config.metadata.docsUrl)}`;
-        clack_1.default.outro(errorMessage);
-        await analytics_1.analytics.shutdown('error');
-        process.exit(1);
     }
     if (agentResult.error === agent_interface_1.AgentErrorType.RATE_LIMIT ||
         agentResult.error === agent_interface_1.AgentErrorType.API_ERROR) {
-        analytics_1.analytics.capture(constants_1.WIZARD_INTERACTION_EVENT_NAME, {
-            action: 'api error',
+        analytics_1.analytics.wizardCapture('agent api error', {
             integration: config.metadata.integration,
             error_type: agentResult.error,
             error_message: agentResult.message,
         });
-        analytics_1.analytics.captureException(new Error(`API error: ${agentResult.message}`), {
-            integration: config.metadata.integration,
-            error_type: agentResult.error,
+        await (0, wizard_abort_1.wizardAbort)({
+            message: `API Error\n\n${agentResult.message || 'Unknown error'}\n\nPlease report this error to: wizard@posthog.com`,
+            error: new wizard_abort_1.WizardError(`API error: ${agentResult.message}`, {
+                integration: config.metadata.integration,
+                error_type: agentResult.error,
+            }),
         });
-        const errorMessage = `
-${chalk_1.default.red('❌ API Error')}
-
-${chalk_1.default.yellow(agentResult.message || 'Unknown error')}
-
-Please report this error to: ${chalk_1.default.cyan('wizard@posthog.com')}`;
-        clack_1.default.outro(errorMessage);
-        await analytics_1.analytics.shutdown('error');
-        process.exit(1);
     }
     // Build environment variables from OAuth credentials
     const envVars = config.environment.getEnvVars(projectApiKey, host);
-    // Upload environment variables to hosting providers (if configured)
+    // Upload environment variables to hosting providers (auto-accept)
     let uploadedEnvVars = [];
     if (config.environment.uploadToHosting) {
-        uploadedEnvVars = await (0, steps_1.uploadEnvironmentVariablesStep)(envVars, {
+        const { uploadEnvironmentVariablesStep } = await import('../steps/index.js');
+        uploadedEnvVars = await uploadEnvironmentVariablesStep(envVars, {
             integration: config.metadata.integration,
-            options,
+            session,
         });
     }
-    // Add MCP server to clients
-    await (0, steps_1.addMCPServerToClientsStep)({
-        integration: config.metadata.integration,
-        ci: options.ci,
-    });
-    // Build outro message
-    const continueUrl = options.signup
+    // MCP installation is handled by McpScreen — no prompt here
+    // Build outro data and store it for OutroScreen
+    const continueUrl = session.signup
         ? `${(0, urls_1.getCloudUrlFromRegion)(cloudRegion)}/products?source=wizard`
         : undefined;
     const changes = [
@@ -241,27 +260,13 @@ Please report this error to: ${chalk_1.default.cyan('wizard@posthog.com')}`;
             ? `Uploaded environment variables to your hosting provider`
             : '',
     ].filter(Boolean);
-    const nextSteps = [
-        ...config.ui.getOutroNextSteps(frameworkContext),
-        uploadedEnvVars.length === 0 && config.environment.uploadToHosting
-            ? `Upload your Project API key to your hosting provider`
-            : '',
-    ].filter(Boolean);
-    const outroMessage = `
-${chalk_1.default.green('Successfully installed PostHog!')}
-
-${chalk_1.default.cyan('What the agent did:')}
-${changes.map((change) => `• ${change}`).join('\n')}
-
-${chalk_1.default.yellow('Next steps:')}
-${nextSteps.map((step) => `• ${step}`).join('\n')}
-
-Learn more: ${chalk_1.default.cyan(config.metadata.docsUrl)}
-${continueUrl ? `\nContinue onboarding: ${chalk_1.default.cyan(continueUrl)}\n` : ``}
-${chalk_1.default.dim('Note: This wizard uses an LLM agent to analyze and modify your project. Please review the changes made.')}
-
-${chalk_1.default.dim(`How did this work for you? Drop us a line: wizard@posthog.com`)}`;
-    clack_1.default.outro(outroMessage);
+    session.outroData = {
+        kind: wizard_session_1.OutroKind.Success,
+        changes,
+        docsUrl: config.metadata.docsUrl,
+        continueUrl,
+    };
+    (0, ui_1.getUI)().outro(`Successfully installed PostHog!`);
     await analytics_1.analytics.shutdown('success');
 }
 /**
@@ -280,7 +285,7 @@ Project context:
 - PostHog Project ID: ${context.projectId}
 - Framework: ${config.metadata.name} ${context.frameworkVersion}
 - TypeScript: ${context.typescript ? 'Yes' : 'No'}
-- PostHog API Key: ${context.projectApiKey}
+- PostHog public token: ${context.projectApiKey}
 - PostHog Host: ${context.host}
 - Project type: ${config.prompts.projectTypeDetection}
 - Package installation: ${config.prompts.packageInstallation ?? framework_config_1.DEFAULT_PACKAGE_INSTALLATION}${additionalContext}
@@ -301,15 +306,16 @@ STEP 3: Run the installation command using Bash:
 
 STEP 4: Load the installed skill's SKILL.md file to understand what references are available.
 
-STEP 5: Follow the skill's workflow files in sequence. Look for numbered workflow files in the references (e.g., files with patterns like "1.0-", "1.1-", "1.2-"). Start with the first one and proceed through each step until completion. Each workflow file will tell you what to do and which file comes next. Never directly write PostHog keys directly to code files; always use environment variables.
+STEP 5: Follow the skill's workflow files in sequence. Look for numbered workflow files in the references (e.g., files with patterns like "1.0-", "1.1-", "1.2-"). Start with the first one and proceed through each step until completion. Each workflow file will tell you what to do and which file comes next. Never directly write PostHog tokens directly to code files; always use environment variables.
 
 STEP 6: Set up environment variables for PostHog using the wizard-tools MCP server (this runs locally — secret values never leave the machine):
    - Use check_env_keys to see which keys already exist in the project's .env file (e.g. .env.local or .env).
-   - Use set_env_values to create or update the PostHog API key and host, using the appropriate naming convention for ${config.metadata.name}. The tool will also ensure .gitignore coverage. Don't assume the presence of keys means the value is up to date. Write the correct value each time.
-   - Reference these environment variables in the code files you create instead of hardcoding the API key and host.
+   - Use set_env_values to create or update the PostHog public token and host, using the appropriate environment variable naming convention for ${config.metadata.name}, which you'll find in example code. The tool will also ensure .gitignore coverage. Don't assume the presence of keys means the value is up to date. Write the correct value each time.
+   - Reference these environment variables in the code files you create instead of hardcoding the public token and host.
 
 Important: Use the detect_package_manager tool (from the wizard-tools MCP server) to determine which package manager the project uses. Do not manually search for lockfiles or config files. Always install packages as a background task. Don't await completion; proceed with other work immediately after starting the installation. You must read a file immediately before attempting to write it, even if you have previously read it; failure to do so will cause a tool failure.
 
+
 `;
 }
 //# sourceMappingURL=agent-runner.js.map

package/dist/src/lib/agent-runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-runner.js","sourceRoot":"","sources":["../../../src/lib/agent-runner.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  DEFAULT_PACKAGE_INSTALLATION,\n  getWelcomeMessage,\n  SPINNER_MESSAGE,\n  type FrameworkConfig,\n} from './framework-config';\nimport type { WizardOptions } from '../utils/types';\nimport {\n  abort,\n  askForAIConsent,\n  confirmContinueIfNoOrDirtyGitRepo,\n  ensurePackageIsInstalled,\n  getOrAskForProjectData,\n  getPackageDotJson,\n  isUsingTypeScript,\n  printWelcome,\n} from '../utils/clack-utils';\nimport type { PackageDotJson } from '../utils/package-json';\nimport { analytics } from '../utils/analytics';\nimport { WIZARD_INTERACTION_EVENT_NAME } from './constants';\nimport clack from '../utils/clack';\nimport {\n  initializeAgent,\n  runAgent,\n  AgentSignals,\n  AgentErrorType,\n} from './agent-interface';\nimport { getCloudUrlFromRegion } from '../utils/urls';\nimport chalk from 'chalk';\nimport * as semver from 'semver';\nimport {\n  addMCPServerToClientsStep,\n  uploadEnvironmentVariablesStep,\n} from '../steps';\nimport { checkAnthropicStatusWithPrompt } from '../utils/anthropic-status';\nimport { enableDebugLogs } from '../utils/debug';\nimport { createBenchmarkPipeline } from './middleware/benchmark';\n\n/**\n * Universal agent-powered wizard runner.\n * Handles the complete flow for any framework using PostHog MCP integration.\n */\nexport async function runAgentWizard(\n  config: FrameworkConfig,\n  options: WizardOptions,\n): Promise<void> {\n  if (options.debug) {\n    enableDebugLogs();\n  }\n\n  // Version check\n  if (config.detection.minimumVersion && config.detection.getInstalledVersion) {\n    const version = await config.detection.getInstalledVersion(options);\n    if (version) {\n      const coerced = semver.coerce(version);\n      if (coerced && semver.lt(coerced, config.detection.minimumVersion)) {\n        const docsUrl =\n          config.metadata.unsupportedVersionDocsUrl ?? config.metadata.docsUrl;\n        clack.log.warn(\n          `Sorry: the wizard can't help you with ${config.metadata.name} ${version}. Upgrade to ${config.metadata.name} ${config.detection.minimumVersion} or later, or check out the manual setup guide.`,\n        );\n        clack.log.info(\n          `Setup ${config.metadata.name} manually: ${chalk.cyan(docsUrl)}`,\n        );\n        clack.outro('PostHog wizard will see you next time!');\n        return;\n      }\n    }\n  }\n\n  // Setup phase\n  printWelcome({ wizardName: getWelcomeMessage(config.metadata.name) });\n\n  if (config.metadata.beta) {\n    clack.log.info(\n      `${chalk.yellow('[BETA]')} The ${\n        config.metadata.name\n      } wizard is in beta. Questions or feedback? Email ${chalk.cyan(\n        'wizard@posthog.com',\n      )}`,\n    );\n  }\n\n  if (config.metadata.preRunNotice) {\n    clack.log.warn(config.metadata.preRunNotice);\n  }\n\n  clack.log.info(\n    `We're about to read your project using our LLM gateway.\\n\\n.env* file contents will not leave your machine.\\n\\nOther files will be read and edited to provide a fully-custom PostHog integration.`,\n  );\n\n  const aiConsent = await askForAIConsent(options);\n  if (!aiConsent) {\n    await abort(\n      `This wizard uses an LLM agent to intelligently modify your project. Please view the docs to set up ${config.metadata.name} manually instead: ${config.metadata.docsUrl}`,\n      0,\n    );\n  }\n\n  // Check Anthropic/Claude service status before proceeding\n  const statusOk = await checkAnthropicStatusWithPrompt({ ci: options.ci });\n  if (!statusOk) {\n    await abort(\n      `Please try again later, or set up ${config.metadata.name} manually: ${config.metadata.docsUrl}`,\n      0,\n    );\n  }\n\n  const typeScriptDetected = isUsingTypeScript(options);\n\n  await confirmContinueIfNoOrDirtyGitRepo(options);\n\n  // Framework detection and version\n  // Only check package.json for Node.js/JavaScript frameworks\n  const usesPackageJson = config.detection.usesPackageJson !== false;\n  let packageJson: PackageDotJson | null = null;\n  let frameworkVersion: string | undefined;\n\n  if (usesPackageJson) {\n    packageJson = await getPackageDotJson(options);\n    await ensurePackageIsInstalled(\n      packageJson,\n      config.detection.packageName,\n      config.detection.packageDisplayName,\n    );\n    frameworkVersion = config.detection.getVersion(packageJson);\n  } else {\n    // For non-Node frameworks (e.g., Django), version is handled differently\n    frameworkVersion = config.detection.getVersion(null);\n  }\n\n  // Set analytics tags for framework version\n  if (frameworkVersion && config.detection.getVersionBucket) {\n    const versionBucket = config.detection.getVersionBucket(frameworkVersion);\n    analytics.setTag(`${config.metadata.integration}-version`, versionBucket);\n  }\n\n  analytics.capture(WIZARD_INTERACTION_EVENT_NAME, {\n    action: 'started agent integration',\n    integration: config.metadata.integration,\n  });\n\n  // Get PostHog credentials\n  const { projectApiKey, host, accessToken, projectId, cloudRegion } =\n    await getOrAskForProjectData(options);\n\n  // Gather framework-specific context (e.g., Next.js router, React Native platform)\n  const frameworkContext = config.metadata.gatherContext\n    ? await config.metadata.gatherContext(options)\n    : {};\n\n  // Set analytics tags from framework context\n  const contextTags = config.analytics.getTags(frameworkContext);\n  Object.entries(contextTags).forEach(([key, value]) => {\n    analytics.setTag(key, value);\n  });\n\n  const integrationPrompt = buildIntegrationPrompt(\n    config,\n    {\n      frameworkVersion: frameworkVersion || 'latest',\n      typescript: typeScriptDetected,\n      projectApiKey,\n      host,\n      projectId,\n    },\n    frameworkContext,\n  );\n\n  // Initialize and run agent\n  const spinner = clack.spinner();\n\n  const mcpUrl = options.localMcp\n    ? 'http://localhost:8787/mcp'\n    : process.env.MCP_URL || 'https://mcp.posthog.com/mcp';\n\n  const agent = await initializeAgent(\n    {\n      workingDirectory: options.installDir,\n      posthogMcpUrl: mcpUrl,\n      posthogApiKey: accessToken,\n      posthogApiHost: host,\n      additionalMcpServers: config.metadata.additionalMcpServers,\n      detectPackageManager: config.detection.detectPackageManager,\n    },\n    options,\n  );\n\n  const middleware = options.benchmark\n    ? createBenchmarkPipeline(spinner, options)\n    : undefined;\n\n  const agentResult = await runAgent(\n    agent,\n    integrationPrompt,\n    options,\n    spinner,\n    {\n      estimatedDurationMinutes: config.ui.estimatedDurationMinutes,\n      spinnerMessage: SPINNER_MESSAGE,\n      successMessage: config.ui.successMessage,\n      errorMessage: 'Integration failed',\n    },\n    middleware,\n  );\n\n  // Handle error cases detected in agent output\n  if (agentResult.error === AgentErrorType.MCP_MISSING) {\n    analytics.captureException(\n      new Error('Agent could not access PostHog MCP server'),\n      {\n        integration: config.metadata.integration,\n        error_type: AgentErrorType.MCP_MISSING,\n        signal: AgentSignals.ERROR_MCP_MISSING,\n      },\n    );\n\n    const errorMessage = `\n${chalk.red('❌ Could not access the PostHog MCP server')}\n\nThe wizard was unable to connect to the PostHog MCP server.\nThis could be due to a network issue or a configuration problem.\n\nPlease try again, or set up ${\n      config.metadata.name\n    } manually by following our documentation:\n${chalk.cyan(config.metadata.docsUrl)}`;\n\n    clack.outro(errorMessage);\n    await analytics.shutdown('error');\n    process.exit(1);\n  }\n\n  if (agentResult.error === AgentErrorType.RESOURCE_MISSING) {\n    analytics.captureException(\n      new Error('Agent could not access setup resource'),\n      {\n        integration: config.metadata.integration,\n        error_type: AgentErrorType.RESOURCE_MISSING,\n        signal: AgentSignals.ERROR_RESOURCE_MISSING,\n      },\n    );\n\n    const errorMessage = `\n${chalk.red('❌ Could not access the setup resource')}\n\nThe wizard could not access the setup resource. This may indicate a version mismatch or a temporary service issue.\n\nPlease try again, or set up ${\n      config.metadata.name\n    } manually by following our documentation:\n${chalk.cyan(config.metadata.docsUrl)}`;\n\n    clack.outro(errorMessage);\n    await analytics.shutdown('error');\n    process.exit(1);\n  }\n\n  if (\n    agentResult.error === AgentErrorType.RATE_LIMIT ||\n    agentResult.error === AgentErrorType.API_ERROR\n  ) {\n    analytics.capture(WIZARD_INTERACTION_EVENT_NAME, {\n      action: 'api error',\n      integration: config.metadata.integration,\n      error_type: agentResult.error,\n      error_message: agentResult.message,\n    });\n\n    analytics.captureException(new Error(`API error: ${agentResult.message}`), {\n      integration: config.metadata.integration,\n      error_type: agentResult.error,\n    });\n\n    const errorMessage = `\n${chalk.red('❌ API Error')}\n\n${chalk.yellow(agentResult.message || 'Unknown error')}\n\nPlease report this error to: ${chalk.cyan('wizard@posthog.com')}`;\n\n    clack.outro(errorMessage);\n    await analytics.shutdown('error');\n    process.exit(1);\n  }\n\n  // Build environment variables from OAuth credentials\n  const envVars = config.environment.getEnvVars(projectApiKey, host);\n\n  // Upload environment variables to hosting providers (if configured)\n  let uploadedEnvVars: string[] = [];\n  if (config.environment.uploadToHosting) {\n    uploadedEnvVars = await uploadEnvironmentVariablesStep(envVars, {\n      integration: config.metadata.integration,\n      options,\n    });\n  }\n\n  // Add MCP server to clients\n  await addMCPServerToClientsStep({\n    integration: config.metadata.integration,\n    ci: options.ci,\n  });\n\n  // Build outro message\n  const continueUrl = options.signup\n    ? `${getCloudUrlFromRegion(cloudRegion)}/products?source=wizard`\n    : undefined;\n\n  const changes = [\n    ...config.ui.getOutroChanges(frameworkContext),\n    Object.keys(envVars).length > 0\n      ? `Added environment variables to .env file`\n      : '',\n    uploadedEnvVars.length > 0\n      ? `Uploaded environment variables to your hosting provider`\n      : '',\n  ].filter(Boolean);\n\n  const nextSteps = [\n    ...config.ui.getOutroNextSteps(frameworkContext),\n    uploadedEnvVars.length === 0 && config.environment.uploadToHosting\n      ? `Upload your Project API key to your hosting provider`\n      : '',\n  ].filter(Boolean);\n\n  const outroMessage = `\n${chalk.green('Successfully installed PostHog!')}\n\n${chalk.cyan('What the agent did:')}\n${changes.map((change) => `• ${change}`).join('\\n')}\n\n${chalk.yellow('Next steps:')}\n${nextSteps.map((step) => `• ${step}`).join('\\n')}\n\nLearn more: ${chalk.cyan(config.metadata.docsUrl)}\n${continueUrl ? `\\nContinue onboarding: ${chalk.cyan(continueUrl)}\\n` : ``}\n${chalk.dim(\n  'Note: This wizard uses an LLM agent to analyze and modify your project. Please review the changes made.',\n)}\n\n${chalk.dim(`How did this work for you? Drop us a line: wizard@posthog.com`)}`;\n\n  clack.outro(outroMessage);\n\n  await analytics.shutdown('success');\n}\n\n/**\n * Build the integration prompt for the agent.\n */\nfunction buildIntegrationPrompt(\n  config: FrameworkConfig,\n  context: {\n    frameworkVersion: string;\n    typescript: boolean;\n    projectApiKey: string;\n    host: string;\n    projectId: number;\n  },\n  frameworkContext: Record<string, unknown>,\n): string {\n  const additionalLines = config.prompts.getAdditionalContextLines\n    ? config.prompts.getAdditionalContextLines(frameworkContext)\n    : [];\n\n  const additionalContext =\n    additionalLines.length > 0\n      ? '\\n' + additionalLines.map((line) => `- ${line}`).join('\\n')\n      : '';\n\n  return `You have access to the PostHog MCP server which provides skills to integrate PostHog into this ${\n    config.metadata.name\n  } project.\n\nProject context:\n- PostHog Project ID: ${context.projectId}\n- Framework: ${config.metadata.name} ${context.frameworkVersion}\n- TypeScript: ${context.typescript ? 'Yes' : 'No'}\n- PostHog API Key: ${context.projectApiKey}\n- PostHog Host: ${context.host}\n- Project type: ${config.prompts.projectTypeDetection}\n- Package installation: ${\n    config.prompts.packageInstallation ?? DEFAULT_PACKAGE_INSTALLATION\n  }${additionalContext}\n\nInstructions (follow these steps IN ORDER - do not skip or reorder):\n\nSTEP 1: List available skills from the PostHog MCP server using ListMcpResourcesTool. If this tool is not available or you cannot access the MCP server, you must emit: ${\n    AgentSignals.ERROR_MCP_MISSING\n  } Could not access the PostHog MCP server and halt.\n\n   Review the skill descriptions and choose the one that best matches this project's framework and configuration.\n   If no suitable skill is found, or you cannot access the MCP server, you emit: ${\n     AgentSignals.ERROR_RESOURCE_MISSING\n   } Could not find a suitable skill for this project.\n\nSTEP 2: Fetch the chosen skill resource (e.g., posthog://skills/{skill-id}).\n   The resource returns a shell command to install the skill.\n\nSTEP 3: Run the installation command using Bash:\n   - Execute the EXACT command returned by the resource (do not modify it)\n   - This will download and extract the skill to .claude/skills/{skill-id}/\n\nSTEP 4: Load the installed skill's SKILL.md file to understand what references are available.\n\nSTEP 5: Follow the skill's workflow files in sequence. Look for numbered workflow files in the references (e.g., files with patterns like \"1.0-\", \"1.1-\", \"1.2-\"). Start with the first one and proceed through each step until completion. Each workflow file will tell you what to do and which file comes next. Never directly write PostHog keys directly to code files; always use environment variables.\n\nSTEP 6: Set up environment variables for PostHog using the wizard-tools MCP server (this runs locally — secret values never leave the machine):\n   - Use check_env_keys to see which keys already exist in the project's .env file (e.g. .env.local or .env).\n   - Use set_env_values to create or update the PostHog API key and host, using the appropriate naming convention for ${\n     config.metadata.name\n   }. The tool will also ensure .gitignore coverage. Don't assume the presence of keys means the value is up to date. Write the correct value each time.\n   - Reference these environment variables in the code files you create instead of hardcoding the API key and host.\n\nImportant: Use the detect_package_manager tool (from the wizard-tools MCP server) to determine which package manager the project uses. Do not manually search for lockfiles or config files. Always install packages as a background task. Don't await completion; proceed with other work immediately after starting the installation. You must read a file immediately before attempting to write it, even if you have previously read it; failure to do so will cause a tool failure.\n\n`;\n}\n"]}
+{"version":3,"file":"agent-runner.js","sourceRoot":"","sources":["../../../src/lib/agent-runner.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  DEFAULT_PACKAGE_INSTALLATION,\n  SPINNER_MESSAGE,\n  type FrameworkConfig,\n} from './framework-config';\nimport { type WizardSession, OutroKind } from './wizard-session';\nimport {\n  tryGetPackageJson,\n  isUsingTypeScript,\n  getOrAskForProjectData,\n} from '../utils/setup-utils';\nimport type { PackageDotJson } from '../utils/package-json';\nimport type { WizardOptions } from '../utils/types';\nimport { analytics } from '../utils/analytics';\nimport { getUI } from '../ui';\nimport {\n  initializeAgent,\n  runAgent,\n  AgentSignals,\n  AgentErrorType,\n  buildWizardMetadata,\n  checkClaudeSettingsOverrides,\n  backupAndFixClaudeSettings,\n  restoreClaudeSettings,\n} from './agent-interface';\nimport { getCloudUrlFromRegion } from '../utils/urls';\nimport chalk from 'chalk';\nimport * as semver from 'semver';\nimport { checkAnthropicStatus } from '../utils/anthropic-status';\nimport { enableDebugLogs } from '../utils/debug';\nimport { createBenchmarkPipeline } from './middleware/benchmark';\nimport { wizardAbort, WizardError } from '../utils/wizard-abort';\n\n/**\n * Build a WizardOptions bag from a WizardSession (for code that still expects WizardOptions).\n */\nfunction sessionToOptions(session: WizardSession): WizardOptions {\n  return {\n    installDir: session.installDir,\n    debug: session.debug,\n    forceInstall: session.forceInstall,\n    default: false,\n    signup: session.signup,\n    localMcp: session.localMcp,\n    ci: session.ci,\n    menu: session.menu,\n    benchmark: session.benchmark,\n    projectId: session.projectId,\n    apiKey: session.apiKey,\n  };\n}\n\n/**\n * Universal agent-powered wizard runner.\n * Handles the complete flow for any framework using PostHog MCP integration.\n *\n * All user decisions come from the session — no UI prompts.\n */\nexport async function runAgentWizard(\n  config: FrameworkConfig,\n  session: WizardSession,\n): Promise<void> {\n  if (session.debug) {\n    enableDebugLogs();\n  }\n\n  // Version check\n  if (config.detection.minimumVersion && config.detection.getInstalledVersion) {\n    const version = await config.detection.getInstalledVersion(\n      sessionToOptions(session),\n    );\n    if (version) {\n      const coerced = semver.coerce(version);\n      if (coerced && semver.lt(coerced, config.detection.minimumVersion)) {\n        const docsUrl =\n          config.metadata.unsupportedVersionDocsUrl ?? config.metadata.docsUrl;\n        getUI().log.warn(\n          `Sorry: the wizard can't help you with ${config.metadata.name} ${version}. Upgrade to ${config.metadata.name} ${config.detection.minimumVersion} or later, or check out the manual setup guide.`,\n        );\n        getUI().log.info(\n          `Setup ${config.metadata.name} manually: ${chalk.cyan(docsUrl)}`,\n        );\n        getUI().outro('PostHog wizard will see you next time!');\n        return;\n      }\n    }\n  }\n\n  // Setup phase — informational only, no prompts\n  // Beta notice, pre-run notice, and welcome label are all derivable\n  // from session.frameworkConfig — IntroScreen reads them directly.\n\n  // Check Anthropic/Claude service status (pure — no prompt)\n  const statusResult = await checkAnthropicStatus();\n  if (statusResult.status === 'down' || statusResult.status === 'degraded') {\n    getUI().showServiceStatus({\n      description: statusResult.description,\n      statusPageUrl: 'https://status.claude.com',\n    });\n  }\n\n  // Check for blocking env overrides in .claude/settings.json before login.\n  // These keys block the Wizard from accessing the PostHog LLM Gateway.\n  const blockingOverrideKeys = checkClaudeSettingsOverrides(session.installDir);\n  if (blockingOverrideKeys.length > 0) {\n    await getUI().showSettingsOverride(blockingOverrideKeys, () =>\n      backupAndFixClaudeSettings(session.installDir),\n    );\n  }\n\n  // Disclosure text is static — IntroScreen renders it directly.\n\n  const typeScriptDetected = isUsingTypeScript({\n    installDir: session.installDir,\n  });\n  session.typescript = typeScriptDetected;\n\n  // Framework detection and version\n  const usesPackageJson = config.detection.usesPackageJson !== false;\n  let packageJson: PackageDotJson | null = null;\n  let frameworkVersion: string | undefined;\n\n  if (usesPackageJson) {\n    packageJson = await tryGetPackageJson({ installDir: session.installDir });\n    if (packageJson) {\n      // Log warning if package not installed, but continue (agent handles it)\n      const { hasPackageInstalled } = await import('../utils/package-json.js');\n      if (!hasPackageInstalled(config.detection.packageName, packageJson)) {\n        getUI().log.warn(\n          `${config.detection.packageDisplayName} does not seem to be installed. Continuing anyway — the agent will handle it.`,\n        );\n      }\n      frameworkVersion = config.detection.getVersion(packageJson);\n    } else {\n      getUI().log.warn(\n        'Could not find package.json. Continuing anyway — the agent will handle it.',\n      );\n    }\n  } else {\n    frameworkVersion = config.detection.getVersion(null);\n  }\n\n  // Set analytics tags for framework version\n  if (frameworkVersion && config.detection.getVersionBucket) {\n    const versionBucket = config.detection.getVersionBucket(frameworkVersion);\n    analytics.setTag(`${config.metadata.integration}-version`, versionBucket);\n  }\n\n  analytics.wizardCapture('agent started', {\n    integration: config.metadata.integration,\n  });\n\n  // Get PostHog credentials (region auto-detected from token)\n  const { projectApiKey, host, accessToken, projectId, cloudRegion } =\n    await getOrAskForProjectData({\n      signup: session.signup,\n      ci: session.ci,\n      apiKey: session.apiKey,\n      projectId: session.projectId,\n    });\n\n  session.credentials = { accessToken, projectApiKey, host, projectId };\n\n  // Notify TUI that credentials are available (resolves past AuthScreen)\n  getUI().setCredentials(session.credentials);\n\n  // Framework context was already gathered by SetupScreen + detection\n  const frameworkContext = session.frameworkContext;\n\n  // Set analytics tags from framework context\n  const contextTags = config.analytics.getTags(frameworkContext);\n  Object.entries(contextTags).forEach(([key, value]) => {\n    analytics.setTag(key, value);\n  });\n\n  const integrationPrompt = buildIntegrationPrompt(\n    config,\n    {\n      frameworkVersion: frameworkVersion || 'latest',\n      typescript: typeScriptDetected,\n      projectApiKey,\n      host,\n      projectId,\n    },\n    frameworkContext,\n  );\n\n  // Initialize and run agent\n  const spinner = getUI().spinner();\n\n  // Evaluate all feature flags at the start of the run so they can be sent to the LLM gateway\n  const wizardFlags = await analytics.getAllFlagsForWizard();\n  const wizardMetadata = buildWizardMetadata(wizardFlags);\n\n  // Determine MCP URL: CLI flag > env var > production default\n  const mcpUrl = session.localMcp\n    ? 'http://localhost:8787/mcp'\n    : process.env.MCP_URL || 'https://mcp.posthog.com/mcp';\n\n  const restoreSettings = () => restoreClaudeSettings(session.installDir);\n  getUI().onEnterScreen('outro', restoreSettings);\n  getUI().startRun();\n\n  const agent = await initializeAgent(\n    {\n      workingDirectory: session.installDir,\n      posthogMcpUrl: mcpUrl,\n      posthogApiKey: accessToken,\n      posthogApiHost: host,\n      additionalMcpServers: config.metadata.additionalMcpServers,\n      detectPackageManager: config.detection.detectPackageManager,\n      wizardFlags,\n      wizardMetadata,\n    },\n    sessionToOptions(session),\n  );\n\n  const middleware = session.benchmark\n    ? createBenchmarkPipeline(spinner, sessionToOptions(session))\n    : undefined;\n\n  const agentResult = await runAgent(\n    agent,\n    integrationPrompt,\n    sessionToOptions(session),\n    spinner,\n    {\n      estimatedDurationMinutes: config.ui.estimatedDurationMinutes,\n      spinnerMessage: SPINNER_MESSAGE,\n      successMessage: config.ui.successMessage,\n      errorMessage: 'Integration failed',\n      additionalFeatureQueue: session.additionalFeatureQueue,\n    },\n    middleware,\n  );\n\n  // Handle error cases detected in agent output\n  if (agentResult.error === AgentErrorType.MCP_MISSING) {\n    await wizardAbort({\n      message: `Could not access the PostHog MCP server\\n\\nThe wizard was unable to connect to the PostHog MCP server.\\nThis could be due to a network issue or a configuration problem.\\n\\nPlease try again, or set up ${config.metadata.name} manually by following our documentation:\\n${config.metadata.docsUrl}`,\n      error: new WizardError('Agent could not access PostHog MCP server', {\n        integration: config.metadata.integration,\n        error_type: AgentErrorType.MCP_MISSING,\n        signal: AgentSignals.ERROR_MCP_MISSING,\n      }),\n    });\n  }\n\n  if (agentResult.error === AgentErrorType.RESOURCE_MISSING) {\n    await wizardAbort({\n      message: `Could not access the setup resource\\n\\nThe wizard could not access the setup resource. This may indicate a version mismatch or a temporary service issue.\\n\\nPlease try again, or set up ${config.metadata.name} manually by following our documentation:\\n${config.metadata.docsUrl}`,\n      error: new WizardError('Agent could not access setup resource', {\n        integration: config.metadata.integration,\n        error_type: AgentErrorType.RESOURCE_MISSING,\n        signal: AgentSignals.ERROR_RESOURCE_MISSING,\n      }),\n    });\n  }\n\n  if (\n    agentResult.error === AgentErrorType.RATE_LIMIT ||\n    agentResult.error === AgentErrorType.API_ERROR\n  ) {\n    analytics.wizardCapture('agent api error', {\n      integration: config.metadata.integration,\n      error_type: agentResult.error,\n      error_message: agentResult.message,\n    });\n\n    await wizardAbort({\n      message: `API Error\\n\\n${\n        agentResult.message || 'Unknown error'\n      }\\n\\nPlease report this error to: wizard@posthog.com`,\n      error: new WizardError(`API error: ${agentResult.message}`, {\n        integration: config.metadata.integration,\n        error_type: agentResult.error,\n      }),\n    });\n  }\n\n  // Build environment variables from OAuth credentials\n  const envVars = config.environment.getEnvVars(projectApiKey, host);\n\n  // Upload environment variables to hosting providers (auto-accept)\n  let uploadedEnvVars: string[] = [];\n  if (config.environment.uploadToHosting) {\n    const { uploadEnvironmentVariablesStep } = await import(\n      '../steps/index.js'\n    );\n    uploadedEnvVars = await uploadEnvironmentVariablesStep(envVars, {\n      integration: config.metadata.integration,\n      session,\n    });\n  }\n\n  // MCP installation is handled by McpScreen — no prompt here\n\n  // Build outro data and store it for OutroScreen\n  const continueUrl = session.signup\n    ? `${getCloudUrlFromRegion(cloudRegion)}/products?source=wizard`\n    : undefined;\n\n  const changes = [\n    ...config.ui.getOutroChanges(frameworkContext),\n    Object.keys(envVars).length > 0\n      ? `Added environment variables to .env file`\n      : '',\n    uploadedEnvVars.length > 0\n      ? `Uploaded environment variables to your hosting provider`\n      : '',\n  ].filter(Boolean);\n\n  session.outroData = {\n    kind: OutroKind.Success,\n    changes,\n    docsUrl: config.metadata.docsUrl,\n    continueUrl,\n  };\n\n  getUI().outro(`Successfully installed PostHog!`);\n\n  await analytics.shutdown('success');\n}\n\n/**\n * Build the integration prompt for the agent.\n */\nfunction buildIntegrationPrompt(\n  config: FrameworkConfig,\n  context: {\n    frameworkVersion: string;\n    typescript: boolean;\n    projectApiKey: string;\n    host: string;\n    projectId: number;\n  },\n  frameworkContext: Record<string, unknown>,\n): string {\n  const additionalLines = config.prompts.getAdditionalContextLines\n    ? config.prompts.getAdditionalContextLines(frameworkContext)\n    : [];\n\n  const additionalContext =\n    additionalLines.length > 0\n      ? '\\n' + additionalLines.map((line) => `- ${line}`).join('\\n')\n      : '';\n\n  return `You have access to the PostHog MCP server which provides skills to integrate PostHog into this ${\n    config.metadata.name\n  } project.\n\nProject context:\n- PostHog Project ID: ${context.projectId}\n- Framework: ${config.metadata.name} ${context.frameworkVersion}\n- TypeScript: ${context.typescript ? 'Yes' : 'No'}\n- PostHog public token: ${context.projectApiKey}\n- PostHog Host: ${context.host}\n- Project type: ${config.prompts.projectTypeDetection}\n- Package installation: ${\n    config.prompts.packageInstallation ?? DEFAULT_PACKAGE_INSTALLATION\n  }${additionalContext}\n\nInstructions (follow these steps IN ORDER - do not skip or reorder):\n\nSTEP 1: List available skills from the PostHog MCP server using ListMcpResourcesTool. If this tool is not available or you cannot access the MCP server, you must emit: ${\n    AgentSignals.ERROR_MCP_MISSING\n  } Could not access the PostHog MCP server and halt.\n\n   Review the skill descriptions and choose the one that best matches this project's framework and configuration.\n   If no suitable skill is found, or you cannot access the MCP server, you emit: ${\n     AgentSignals.ERROR_RESOURCE_MISSING\n   } Could not find a suitable skill for this project.\n\nSTEP 2: Fetch the chosen skill resource (e.g., posthog://skills/{skill-id}).\n   The resource returns a shell command to install the skill.\n\nSTEP 3: Run the installation command using Bash:\n   - Execute the EXACT command returned by the resource (do not modify it)\n   - This will download and extract the skill to .claude/skills/{skill-id}/\n\nSTEP 4: Load the installed skill's SKILL.md file to understand what references are available.\n\nSTEP 5: Follow the skill's workflow files in sequence. Look for numbered workflow files in the references (e.g., files with patterns like \"1.0-\", \"1.1-\", \"1.2-\"). Start with the first one and proceed through each step until completion. Each workflow file will tell you what to do and which file comes next. Never directly write PostHog tokens directly to code files; always use environment variables.\n\nSTEP 6: Set up environment variables for PostHog using the wizard-tools MCP server (this runs locally — secret values never leave the machine):\n   - Use check_env_keys to see which keys already exist in the project's .env file (e.g. .env.local or .env).\n   - Use set_env_values to create or update the PostHog public token and host, using the appropriate environment variable naming convention for ${\n     config.metadata.name\n   }, which you'll find in example code. The tool will also ensure .gitignore coverage. Don't assume the presence of keys means the value is up to date. Write the correct value each time.\n   - Reference these environment variables in the code files you create instead of hardcoding the public token and host.\n\nImportant: Use the detect_package_manager tool (from the wizard-tools MCP server) to determine which package manager the project uses. Do not manually search for lockfiles or config files. Always install packages as a background task. Don't await completion; proceed with other work immediately after starting the installation. You must read a file immediately before attempting to write it, even if you have previously read it; failure to do so will cause a tool failure.\n\n\n`;\n}\n"]}

package/dist/src/lib/api.d.ts

@@ -57,17 +57,17 @@ export declare const ApiProjectSchema: z.ZodObject<{
     api_token: z.ZodString;
     name: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    uuid: string;
-    name: string;
     id: number;
     organization: string;
-    api_token: string;
-}, {
     uuid: string;
+    api_token: string;
     name: string;
+}, {
     id: number;
     organization: string;
+    uuid: string;
     api_token: string;
+    name: string;
 }>;
 export type ApiUser = z.infer<typeof ApiUserSchema>;
 export type ApiProject = z.infer<typeof ApiProjectSchema>;

package/dist/src/lib/commandments.js

@@ -16,6 +16,7 @@ const WIZARD_COMMANDMENTS = [
     'Treat feature flags, custom properties, and event names as part of an analytics contract. Prefer reusing existing names and patterns in the project. When you must introduce new ones, make them clear, descriptive, and consistent with existing conventions, and avoid scattering the same flag or property across many unrelated callsites.',
     'Prefer minimal, targeted edits that achieve the requested behavior while preserving existing structure and style. Avoid large refactors, broad reformatting, or unrelated changes unless explicitly requested.',
     'Do not spawn subagents unless explicitly instructed to do so.',
+    'Use the TodoWrite tool to track your progress. Create a todo list at the start describing the high-level areas of work, mark each as in_progress when you begin it, and completed when done.',
 ].join('\n');
 function getWizardCommandments() {
     return WIZARD_COMMANDMENTS;

package/dist/src/lib/commandments.js.map

@@ -1 +1 @@
-{"version":3,"file":"commandments.js","sourceRoot":"","sources":["../../../src/lib/commandments.ts"],"names":[],"mappings":";;AAwBA,sDAEC;AA1BD;;;;;GAKG;AACH,MAAM,mBAAmB,GAAG;IAC1B,gLAAgL;IAEhL,4OAA4O;IAE5O,4LAA4L;IAE5L,oLAAoL;IAEpL,uMAAuM;IAEvM,gVAAgV;IAEhV,gNAAgN;IAEhN,+DAA+D;CAChE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,SAAgB,qBAAqB;IACnC,OAAO,mBAAmB,CAAC;AAC7B,CAAC","sourcesContent":["/**\n * Wizard-wide commandments that are always appended as a system prompt.\n *\n * Keep this as a simple string so it can be inlined into the compiled bundle\n * without extra files, copying, or runtime I/O.\n */\nconst WIZARD_COMMANDMENTS = [\n  'Never hallucinate a PostHog API key, host, or any other secret. Always use the real values that have been configured for this project (for example via environment variables).',\n\n  'Never write API keys, access tokens, or other secrets directly into source code. Always reference environment variables instead, and rely on the wizard-tools MCP server (check_env_keys / set_env_values) to create or update .env files.',\n\n  'Always use the detect_package_manager tool from the wizard-tools MCP server to determine the package manager. Do not guess based on lockfiles or hard-code npm, yarn, pnpm, bun, pip, etc.',\n\n  'When installing packages, start the installation as a background task and then continue with other work. Do not block waiting for installs to finish unless explicitly instructed.',\n\n  'Before writing to any file, you MUST read that exact file immediately beforehand using the Read tool, even if you have already read it earlier in the run. This avoids tool failures and stale edits.',\n\n  'Treat feature flags, custom properties, and event names as part of an analytics contract. Prefer reusing existing names and patterns in the project. When you must introduce new ones, make them clear, descriptive, and consistent with existing conventions, and avoid scattering the same flag or property across many unrelated callsites.',\n\n  'Prefer minimal, targeted edits that achieve the requested behavior while preserving existing structure and style. Avoid large refactors, broad reformatting, or unrelated changes unless explicitly requested.',\n\n  'Do not spawn subagents unless explicitly instructed to do so.',\n].join('\\n');\n\nexport function getWizardCommandments(): string {\n  return WIZARD_COMMANDMENTS;\n}\n"]}
+{"version":3,"file":"commandments.js","sourceRoot":"","sources":["../../../src/lib/commandments.ts"],"names":[],"mappings":";;AA0BA,sDAEC;AA5BD;;;;;GAKG;AACH,MAAM,mBAAmB,GAAG;IAC1B,gLAAgL;IAEhL,4OAA4O;IAE5O,4LAA4L;IAE5L,oLAAoL;IAEpL,uMAAuM;IAEvM,gVAAgV;IAEhV,gNAAgN;IAEhN,+DAA+D;IAE/D,8LAA8L;CAC/L,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,SAAgB,qBAAqB;IACnC,OAAO,mBAAmB,CAAC;AAC7B,CAAC","sourcesContent":["/**\n * Wizard-wide commandments that are always appended as a system prompt.\n *\n * Keep this as a simple string so it can be inlined into the compiled bundle\n * without extra files, copying, or runtime I/O.\n */\nconst WIZARD_COMMANDMENTS = [\n  'Never hallucinate a PostHog API key, host, or any other secret. Always use the real values that have been configured for this project (for example via environment variables).',\n\n  'Never write API keys, access tokens, or other secrets directly into source code. Always reference environment variables instead, and rely on the wizard-tools MCP server (check_env_keys / set_env_values) to create or update .env files.',\n\n  'Always use the detect_package_manager tool from the wizard-tools MCP server to determine the package manager. Do not guess based on lockfiles or hard-code npm, yarn, pnpm, bun, pip, etc.',\n\n  'When installing packages, start the installation as a background task and then continue with other work. Do not block waiting for installs to finish unless explicitly instructed.',\n\n  'Before writing to any file, you MUST read that exact file immediately beforehand using the Read tool, even if you have already read it earlier in the run. This avoids tool failures and stale edits.',\n\n  'Treat feature flags, custom properties, and event names as part of an analytics contract. Prefer reusing existing names and patterns in the project. When you must introduce new ones, make them clear, descriptive, and consistent with existing conventions, and avoid scattering the same flag or property across many unrelated callsites.',\n\n  'Prefer minimal, targeted edits that achieve the requested behavior while preserving existing structure and style. Avoid large refactors, broad reformatting, or unrelated changes unless explicitly requested.',\n\n  'Do not spawn subagents unless explicitly instructed to do so.',\n\n  'Use the TodoWrite tool to track your progress. Create a todo list at the start describing the high-level areas of work, mark each as in_progress when you begin it, and completed when done.',\n].join('\\n');\n\nexport function getWizardCommandments(): string {\n  return WIZARD_COMMANDMENTS;\n}\n"]}

package/dist/src/lib/constants.d.ts

@@ -1,5 +1,8 @@
 /**
- * Detection order matters: put framework-specific integrations BEFORE basic language fallbacks
+ * Shared constants for the PostHog wizard.
+ */
+/**
+ * Detection order matters: put framework-specific integrations BEFORE basic language fallbacks.
  */
 export declare enum Integration {
     nextjs = "nextjs",
@@ -19,10 +22,10 @@ export declare enum Integration {
     swift = "swift",
     android = "android",
     rails = "rails",
+    javascript_web = "javascript_web",
     python = "python",
     ruby = "ruby",
-    javascriptNode = "javascript_node",
-    javascript_web = "javascript_web"
+    javascriptNode = "javascript_node"
 }
 export interface Args {
     debug: boolean;
@@ -31,18 +34,28 @@ export interface Args {
 export declare const IS_DEV: boolean;
 export declare const DEBUG = false;
 export declare const DEFAULT_URL: string;
-export declare const ISSUES_URL = "https://github.com/posthog/wizard/issues";
 export declare const DEFAULT_HOST_URL: string;
+export declare const ISSUES_URL = "https://github.com/posthog/wizard/issues";
 export declare const ANALYTICS_POSTHOG_PUBLIC_PROJECT_WRITE_KEY = "sTMFPsFhdP1Ssg";
 export declare const ANALYTICS_HOST_URL = "https://internal-j.posthog.com";
 export declare const ANALYTICS_TEAM_TAG = "docs-and-wizard";
-export declare const DUMMY_PROJECT_API_KEY = "_YOUR_POSTHOG_PROJECT_API_KEY_";
+export declare const POSTHOG_OAUTH_URL: string;
+export declare const OAUTH_PORT = 8239;
 export declare const POSTHOG_US_CLIENT_ID = "c4Rdw8DIxgtQfA80IiSnGKlNX8QN00cFWF00QQhM";
 export declare const POSTHOG_EU_CLIENT_ID = "bx2C5sZRN03TkdjraCcetvQFPGH6N2Y9vRLkcKEy";
 export declare const POSTHOG_DEV_CLIENT_ID = "DC5uRLVbGI02YQ82grxgnK6Qn12SXWpCqdPb60oZ";
 export declare const POSTHOG_PROXY_CLIENT_ID = "c4Rdw8DIxgtQfA80IiSnGKlNX8QN00cFWF00QQhM";
-export declare const POSTHOG_OAUTH_URL: string;
-export declare const OAUTH_PORT = 8239;
-export declare const WIZARD_INTERACTION_EVENT_NAME = "wizard interaction";
+export declare const DUMMY_PROJECT_API_KEY = "_YOUR_POSTHOG_PROJECT_API_KEY_";
 export declare const WIZARD_REMARK_EVENT_NAME = "wizard remark";
-export declare const WIZARD_USER_AGENT = "posthog/wizard; version: 1.36.1";
+/** Feature flag key whose value selects a variant from WIZARD_VARIANTS. */
+export declare const WIZARD_VARIANT_FLAG_KEY = "wizard-variant";
+/** Variant key -> metadata for wizard run (VARIANT flag selects which entry to use). */
+export declare const WIZARD_VARIANTS: Record<string, Record<string, string>>;
+/** User-Agent for wizard HTTP requests and MCP server identification. */
+export declare const WIZARD_USER_AGENT = "posthog/wizard; version: 2.0.0";
+/** Header prefix for PostHog properties (e.g. X-POSTHOG-PROPERTY-VARIANT). */
+export declare const POSTHOG_PROPERTY_HEADER_PREFIX = "X-POSTHOG-PROPERTY-";
+/** Header prefix for PostHog feature flags. */
+export declare const POSTHOG_FLAG_HEADER_PREFIX = "X-POSTHOG-FLAG-";
+/** Timeout for framework / project detection probes (ms). */
+export declare const DETECTION_TIMEOUT_MS = 10000;