@posthog/wizard 2.9.1 → 2.10.1

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

@@ -1,325 +0,0 @@
-"use strict";
-/**
- * Unified workflow runner.
- *
- * Single configurable pipeline for all workflows. Each workflow
- * provides a WorkflowRun (via the `run` field on WorkflowConfig)
- * that controls:
- *   - Whether a skill is pre-installed or discovered at runtime
- *   - How the agent prompt is built
- *   - What MCP servers and package manager detector to use
- *   - What happens after the agent completes
- *
- * The pipeline itself is fixed:
- *   init → health check → settings → OAuth → [skill install] →
- *   agent init → prompt → run → errors → [postRun] → outro
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.runAgent = runAgent;
-exports.runWorkflow = runWorkflow;
-const fs_1 = require("fs");
-const path_1 = require("path");
-const wizard_session_1 = require("../wizard-session");
-const setup_utils_1 = require("../../utils/setup-utils");
-const analytics_1 = require("../../utils/analytics");
-const ui_1 = require("../../ui");
-const agent_interface_1 = require("./agent-interface");
-const urls_1 = require("../../utils/urls");
-const readiness_1 = require("../health-checks/readiness");
-const debug_1 = require("../../utils/debug");
-const benchmark_1 = require("../middleware/benchmark");
-const wizard_abort_1 = require("../../utils/wizard-abort");
-const yara_hooks_1 = require("../yara-hooks");
-const package_manager_1 = require("../detection/package-manager");
-const constants_1 = require("../constants");
-const wizard_tools_1 = require("../wizard-tools");
-const agent_prompt_1 = require("./agent-prompt");
-// ── Helpers ──────────────────────────────────────────────────────────
-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,
-        yaraReport: session.yaraReport,
-    };
-}
-// ── Runner ───────────────────────────────────────────────────────────
-/**
- * Resolve a WorkflowConfig's agent run definition and execute the pipeline.
- * Entry point for bin.ts — handles buildRunConfig, bootstrap, and (future) run field.
- */
-async function runAgent(workflowConfig, session) {
-    if (!workflowConfig.run) {
-        throw new Error(`Workflow "${workflowConfig.flowKey}" has no run configuration.`);
-    }
-    const runDef = typeof workflowConfig.run === 'function'
-        ? await workflowConfig.run(session)
-        : workflowConfig.run;
-    await runWorkflow(session, runDef);
-}
-/**
- * Run a workflow's agent pipeline.
- *
- * This is the single execution path for all workflows — both skill-based
- * (revenue analytics) and framework-based (core integration). The
- * `WorkflowRun` controls what varies between them.
- */
-async function runWorkflow(session, config) {
-    // 1. Init logging + debug
-    (0, debug_1.initLogFile)();
-    (0, debug_1.logToFile)(`[agent-runner] START ${config.integrationLabel}`);
-    if (session.debug) {
-        (0, debug_1.enableDebugLogs)();
-    }
-    const skillsBaseUrl = (0, constants_1.getSkillsBaseUrl)(session.localMcp);
-    // 2. Health check (guarded — skip if TUI already ran it)
-    if (!session.readinessResult) {
-        (0, debug_1.logToFile)('[agent-runner] evaluating wizard readiness');
-        const readiness = await (0, readiness_1.evaluateWizardReadiness)();
-        (0, debug_1.logToFile)(`[agent-runner] readiness=${readiness.decision}`);
-        if (readiness.decision === readiness_1.WizardReadiness.No) {
-            await (0, ui_1.getUI)().showBlockingOutage(readiness);
-        }
-        else if (readiness.decision === readiness_1.WizardReadiness.YesWithWarnings) {
-            (0, ui_1.getUI)().setReadinessWarnings(readiness);
-        }
-    }
-    // 3. Settings conflicts
-    const settingsConflicts = (0, agent_interface_1.checkAllSettingsConflicts)(session.installDir);
-    (0, debug_1.logToFile)(`[agent-runner] settings conflicts: ${settingsConflicts.length > 0
-        ? settingsConflicts
-            .map((c) => `${c.source}(${c.keys.join(',')})`)
-            .join('; ')
-        : 'none'}`);
-    if (settingsConflicts.length > 0) {
-        for (const conflict of settingsConflicts) {
-            const level = conflict.source === 'managed' ? 'org' : conflict.source;
-            analytics_1.analytics.wizardCapture('settings conflict detected', {
-                level,
-                keys: conflict.keys,
-            });
-        }
-        await (0, ui_1.getUI)().showSettingsOverride(settingsConflicts, () => (0, agent_interface_1.backupAndFixClaudeSettings)(session.installDir));
-        (0, debug_1.logToFile)('[agent-runner] settings override resolved');
-    }
-    analytics_1.analytics.wizardCapture('agent started', {
-        integration: config.integrationLabel,
-        workflow: config.integrationLabel,
-        skill_id: config.skillId ?? null,
-    });
-    // 4. OAuth
-    (0, debug_1.logToFile)('[agent-runner] starting OAuth');
-    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 };
-    (0, ui_1.getUI)().setCredentials(session.credentials);
-    // 5. Skill install (if skillId provided)
-    let skillPath;
-    if (config.skillId) {
-        (0, debug_1.logToFile)(`[agent-runner] installing skill ${config.skillId}`);
-        const installResult = await (0, wizard_tools_1.installSkillById)(config.skillId, session.installDir, skillsBaseUrl);
-        if (installResult.kind !== 'ok') {
-            await abortOnInstallFailure(config.integrationLabel, installResult);
-            return;
-        }
-        skillPath = installResult.path;
-        (0, debug_1.logToFile)(`[agent-runner] skill installed at ${skillPath}`);
-    }
-    // 6. Initialize agent
-    const spinner = (0, ui_1.getUI)().spinner();
-    const wizardFlags = await analytics_1.analytics.getAllFlagsForWizard();
-    const wizardMetadata = (0, agent_interface_1.buildWizardMetadata)(wizardFlags);
-    const mcpUrl = session.localMcp
-        ? 'http://localhost:8787/mcp'
-        : process.env.MCP_URL ||
-            (cloudRegion === 'eu'
-                ? 'https://mcp-eu.posthog.com/mcp'
-                : 'https://mcp.posthog.com/mcp');
-    const restoreSettings = () => (0, agent_interface_1.restoreClaudeSettings)(session.installDir);
-    (0, ui_1.getUI)().onEnterScreen('outro', restoreSettings);
-    if (session.yaraReport) {
-        (0, wizard_abort_1.registerCleanup)(() => {
-            const reportPath = (0, yara_hooks_1.writeScanReport)();
-            if (reportPath) {
-                const summary = (0, yara_hooks_1.formatScanReport)();
-                (0, ui_1.getUI)().log.info(`YARA scan report: ${reportPath}${summary ?? ''}`);
-            }
-        });
-    }
-    (0, ui_1.getUI)().startRun();
-    const agent = await (0, agent_interface_1.initializeAgent)({
-        workingDirectory: session.installDir,
-        posthogMcpUrl: mcpUrl,
-        posthogApiKey: accessToken,
-        posthogApiHost: host,
-        additionalMcpServers: config.additionalMcpServers,
-        detectPackageManager: config.detectPackageManager ?? package_manager_1.detectNodePackageManagers,
-        skillsBaseUrl,
-        wizardFlags,
-        wizardMetadata,
-    }, sessionToOptions(session));
-    const middleware = session.benchmark
-        ? (0, benchmark_1.createBenchmarkPipeline)(spinner, sessionToOptions(session))
-        : undefined;
-    // 7. Build prompt
-    const prompt = (0, agent_prompt_1.assemblePrompt)(config, {
-        projectId,
-        projectApiKey,
-        host,
-        skillPath,
-    });
-    // 8. Run agent
-    const agentResult = await (0, agent_interface_1.runAgent)(agent, prompt, sessionToOptions(session), spinner, {
-        estimatedDurationMinutes: config.estimatedDurationMinutes,
-        spinnerMessage: config.spinnerMessage,
-        successMessage: config.successMessage,
-        errorMessage: config.errorMessage ?? `${config.integrationLabel} failed`,
-        additionalFeatureQueue: config.additionalFeatureQueue ?? [],
-        abortCases: config.abortCases,
-    }, middleware);
-    // 9. Error handling (full set from both runners)
-    if (agentResult.error === agent_interface_1.AgentErrorType.ABORT) {
-        const reason = agentResult.message ?? '';
-        const matched = config.abortCases?.find((c) => c.match.test(reason));
-        const outroData = matched
-            ? {
-                kind: wizard_session_1.OutroKind.Error,
-                message: matched.message,
-                body: matched.body,
-                docsUrl: matched.docsUrl,
-            }
-            : {
-                kind: wizard_session_1.OutroKind.Error,
-                message: `${config.integrationLabel} aborted`,
-                body: reason || 'The agent aborted the workflow.',
-                docsUrl: config.docsUrl,
-            };
-        analytics_1.analytics.wizardCapture('agent aborted', {
-            integration: config.integrationLabel,
-            reason,
-            matched: matched?.message ?? null,
-        });
-        await (0, wizard_abort_1.wizardAbort)({
-            outroData,
-            error: new wizard_abort_1.WizardError(`Agent aborted: ${reason}`, {
-                integration: config.integrationLabel,
-                error_type: agent_interface_1.AgentErrorType.ABORT,
-                reason,
-            }),
-        });
-    }
-    if (agentResult.error === agent_interface_1.AgentErrorType.MCP_MISSING) {
-        await (0, wizard_abort_1.wizardAbort)({
-            message: 'Could not access the PostHog MCP server\n\n' +
-                'The wizard was unable to connect to the PostHog MCP server.\n' +
-                'This could be due to a network issue or a configuration problem.\n\n' +
-                `Please try again, or check the documentation:\n${config.docsUrl}`,
-            error: new wizard_abort_1.WizardError('Agent could not access PostHog MCP server', {
-                integration: config.integrationLabel,
-                error_type: agent_interface_1.AgentErrorType.MCP_MISSING,
-                signal: agent_interface_1.AgentSignals.ERROR_MCP_MISSING,
-            }),
-        });
-    }
-    if (agentResult.error === agent_interface_1.AgentErrorType.RESOURCE_MISSING) {
-        await (0, wizard_abort_1.wizardAbort)({
-            message: 'Could not access the setup resource\n\n' +
-                'This may indicate a version mismatch or a temporary service issue.\n\n' +
-                `Please try again, or check the documentation:\n${config.docsUrl}`,
-            error: new wizard_abort_1.WizardError('Agent could not access setup resource', {
-                integration: config.integrationLabel,
-                error_type: agent_interface_1.AgentErrorType.RESOURCE_MISSING,
-                signal: agent_interface_1.AgentSignals.ERROR_RESOURCE_MISSING,
-            }),
-        });
-    }
-    if (agentResult.error === agent_interface_1.AgentErrorType.YARA_VIOLATION) {
-        await (0, wizard_abort_1.wizardAbort)({
-            message: 'Security violation detected.\nPlease report this to: wizard@posthog.com',
-            error: new wizard_abort_1.WizardError('YARA scanner terminated session', {
-                integration: config.integrationLabel,
-                error_type: agent_interface_1.AgentErrorType.YARA_VIOLATION,
-            }),
-        });
-    }
-    if (agentResult.error === agent_interface_1.AgentErrorType.RATE_LIMIT ||
-        agentResult.error === agent_interface_1.AgentErrorType.API_ERROR) {
-        analytics_1.analytics.wizardCapture('agent api error', {
-            integration: config.integrationLabel,
-            error_type: agentResult.error,
-            error_message: agentResult.message,
-        });
-        await (0, wizard_abort_1.wizardAbort)({
-            message: `API Error\n\n${agentResult.message || 'Unknown error'}\n\nPlease report this to: wizard@posthog.com`,
-            error: new wizard_abort_1.WizardError(`API error: ${agentResult.message}`, {
-                integration: config.integrationLabel,
-                error_type: agentResult.error,
-            }),
-        });
-    }
-    // 10. Post-run hooks
-    if (config.postRun) {
-        await config.postRun(session, {
-            accessToken,
-            projectApiKey,
-            host,
-            projectId,
-        });
-    }
-    // 11. Outro
-    if (config.buildOutroData) {
-        session.outroData = config.buildOutroData(session, { accessToken, projectApiKey, host, projectId }, cloudRegion);
-    }
-    else {
-        const continueUrl = session.signup
-            ? `${(0, urls_1.getCloudUrlFromRegion)(cloudRegion)}/products?source=wizard`
-            : undefined;
-        const reportPath = (0, path_1.join)(session.installDir, config.reportFile);
-        const reportExists = (0, fs_1.existsSync)(reportPath);
-        session.outroData = {
-            kind: wizard_session_1.OutroKind.Success,
-            message: config.successMessage,
-            reportFile: reportExists ? config.reportFile : undefined,
-            docsUrl: config.docsUrl,
-            continueUrl,
-        };
-    }
-    (0, ui_1.getUI)().outro(config.successMessage);
-    // 12. Analytics shutdown
-    await analytics_1.analytics.shutdown('success');
-}
-// ── Shared error helpers ─────────────────────────────────────────────
-async function abortOnInstallFailure(integrationLabel, result) {
-    if (result.kind === 'ok')
-        return;
-    const message = (() => {
-        switch (result.kind) {
-            case 'menu-fetch-failed':
-                return 'Could not fetch the skill menu from context-mill.\nCheck your network connection and try again.';
-            case 'skill-not-found':
-                return `Could not find the "${result.skillId}" skill in the context-mill menu.\nPlease try again later.`;
-            case 'download-failed':
-                return `Failed to install skill: ${result.message}\nPlease try again.`;
-        }
-    })();
-    await (0, wizard_abort_1.wizardAbort)({
-        message,
-        error: new wizard_abort_1.WizardError(`Skill install failed: ${result.kind}`, {
-            integration: integrationLabel,
-            error_type: result.kind,
-        }),
-    });
-}
-//# sourceMappingURL=agent-runner.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"agent-runner.js","sourceRoot":"","sources":["../../../../src/lib/agent/agent-runner.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Unified workflow runner.\n *\n * Single configurable pipeline for all workflows. Each workflow\n * provides a WorkflowRun (via the `run` field on WorkflowConfig)\n * that controls:\n *   - Whether a skill is pre-installed or discovered at runtime\n *   - How the agent prompt is built\n *   - What MCP servers and package manager detector to use\n *   - What happens after the agent completes\n *\n * The pipeline itself is fixed:\n *   init → health check → settings → OAuth → [skill install] →\n *   agent init → prompt → run → errors → [postRun] → outro\n */\n\nimport { existsSync } from 'fs';\nimport { join } from 'path';\nimport {\n  type WizardSession,\n  type AdditionalFeature,\n  type Credentials,\n  OutroKind,\n} from '../wizard-session';\nimport { getOrAskForProjectData } from '../../utils/setup-utils';\nimport { analytics } from '../../utils/analytics';\nimport { getUI } from '../../ui';\nimport {\n  initializeAgent,\n  runAgent as executeAgent,\n  AgentErrorType,\n  AgentSignals,\n  buildWizardMetadata,\n  checkAllSettingsConflicts,\n  backupAndFixClaudeSettings,\n  restoreClaudeSettings,\n} from './agent-interface';\nimport { getCloudUrlFromRegion } from '../../utils/urls';\nimport {\n  evaluateWizardReadiness,\n  WizardReadiness,\n} from '../health-checks/readiness';\nimport { enableDebugLogs, initLogFile, logToFile } from '../../utils/debug';\nimport { createBenchmarkPipeline } from '../middleware/benchmark';\nimport {\n  wizardAbort,\n  WizardError,\n  registerCleanup,\n} from '../../utils/wizard-abort';\nimport { formatScanReport, writeScanReport } from '../yara-hooks';\nimport { detectNodePackageManagers } from '../detection/package-manager';\nimport type { PackageManagerDetector } from '../detection/package-manager';\nimport { getSkillsBaseUrl } from '../constants';\nimport { installSkillById, type InstallSkillResult } from '../wizard-tools';\nimport type { WizardOptions } from '../../utils/types';\n\nimport type { WorkflowConfig } from '../workflows/workflow-step';\nimport { assemblePrompt, type PromptContext } from './agent-prompt';\n\nexport type { PromptContext };\n\n// ── Types ────────────────────────────────────────────────────────────\n\nexport type { Credentials };\n\n/**\n * A known `[ABORT] <reason>` case. First matching entry is rendered on\n * the error outro; unmatched aborts use a generic fallback.\n */\nexport interface AbortCase {\n  match: RegExp;\n  message: string;\n  body: string;\n  docsUrl?: string;\n}\n\n/**\n * Unified agent run configuration.\n *\n * Every workflow provides one of these — either as a static object\n * or via a function that builds one from the session. The runner\n * assembles the final prompt from `prompt` + `skillId`.\n */\nexport interface WorkflowRun {\n  /** Analytics label (e.g. 'revenue-analytics-setup', 'nextjs') */\n  integrationLabel: string;\n  /** Skill ID to pre-install. Omit for agent-driven skill discovery. */\n  skillId?: string;\n  /** Additional workflow-specific prompt instructions. Appended after the default project prompt. */\n  customPrompt?: (ctx: PromptContext) => string;\n  /** Additional MCP servers (e.g. Svelte MCP) */\n  additionalMcpServers?: Record<string, { url: string }>;\n  /** Package manager detector. Defaults to detectNodePackageManagers. */\n  detectPackageManager?: PackageManagerDetector;\n  spinnerMessage: string;\n  successMessage: string;\n  estimatedDurationMinutes: number;\n  reportFile: string;\n  docsUrl: string;\n  errorMessage?: string;\n  additionalFeatureQueue?: readonly AdditionalFeature[];\n  /** Known `[ABORT] <reason>` cases this workflow can render. */\n  abortCases?: AbortCase[];\n  /** Runs after agent completes, before outro (e.g. env var upload). */\n  postRun?: (session: WizardSession, credentials: Credentials) => Promise<void>;\n  /** Custom outro data. Omit for default built from successMessage/reportFile/docsUrl. */\n  buildOutroData?: (\n    session: WizardSession,\n    credentials: Credentials,\n    cloudRegion: import('../../utils/types').CloudRegion | undefined,\n  ) => WizardSession['outroData'];\n}\n\n// ── Helpers ──────────────────────────────────────────────────────────\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    yaraReport: session.yaraReport,\n  };\n}\n\n// ── Runner ───────────────────────────────────────────────────────────\n\n/**\n * Resolve a WorkflowConfig's agent run definition and execute the pipeline.\n * Entry point for bin.ts — handles buildRunConfig, bootstrap, and (future) run field.\n */\nexport async function runAgent(\n  workflowConfig: WorkflowConfig,\n  session: WizardSession,\n): Promise<void> {\n  if (!workflowConfig.run) {\n    throw new Error(\n      `Workflow \"${workflowConfig.flowKey}\" has no run configuration.`,\n    );\n  }\n\n  const runDef =\n    typeof workflowConfig.run === 'function'\n      ? await workflowConfig.run(session)\n      : workflowConfig.run;\n\n  await runWorkflow(session, runDef);\n}\n\n/**\n * Run a workflow's agent pipeline.\n *\n * This is the single execution path for all workflows — both skill-based\n * (revenue analytics) and framework-based (core integration). The\n * `WorkflowRun` controls what varies between them.\n */\nexport async function runWorkflow(\n  session: WizardSession,\n  config: WorkflowRun,\n): Promise<void> {\n  // 1. Init logging + debug\n  initLogFile();\n  logToFile(`[agent-runner] START ${config.integrationLabel}`);\n\n  if (session.debug) {\n    enableDebugLogs();\n  }\n\n  const skillsBaseUrl = getSkillsBaseUrl(session.localMcp);\n\n  // 2. Health check (guarded — skip if TUI already ran it)\n  if (!session.readinessResult) {\n    logToFile('[agent-runner] evaluating wizard readiness');\n    const readiness = await evaluateWizardReadiness();\n    logToFile(`[agent-runner] readiness=${readiness.decision}`);\n    if (readiness.decision === WizardReadiness.No) {\n      await getUI().showBlockingOutage(readiness);\n    } else if (readiness.decision === WizardReadiness.YesWithWarnings) {\n      getUI().setReadinessWarnings(readiness);\n    }\n  }\n\n  // 3. Settings conflicts\n  const settingsConflicts = checkAllSettingsConflicts(session.installDir);\n  logToFile(\n    `[agent-runner] settings conflicts: ${\n      settingsConflicts.length > 0\n        ? settingsConflicts\n            .map((c) => `${c.source}(${c.keys.join(',')})`)\n            .join('; ')\n        : 'none'\n    }`,\n  );\n\n  if (settingsConflicts.length > 0) {\n    for (const conflict of settingsConflicts) {\n      const level = conflict.source === 'managed' ? 'org' : conflict.source;\n      analytics.wizardCapture('settings conflict detected', {\n        level,\n        keys: conflict.keys,\n      });\n    }\n    await getUI().showSettingsOverride(settingsConflicts, () =>\n      backupAndFixClaudeSettings(session.installDir),\n    );\n    logToFile('[agent-runner] settings override resolved');\n  }\n\n  analytics.wizardCapture('agent started', {\n    integration: config.integrationLabel,\n    workflow: config.integrationLabel,\n    skill_id: config.skillId ?? null,\n  });\n\n  // 4. OAuth\n  logToFile('[agent-runner] starting OAuth');\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  getUI().setCredentials(session.credentials);\n\n  // 5. Skill install (if skillId provided)\n  let skillPath: string | undefined;\n  if (config.skillId) {\n    logToFile(`[agent-runner] installing skill ${config.skillId}`);\n    const installResult = await installSkillById(\n      config.skillId,\n      session.installDir,\n      skillsBaseUrl,\n    );\n    if (installResult.kind !== 'ok') {\n      await abortOnInstallFailure(config.integrationLabel, installResult);\n      return;\n    }\n    skillPath = installResult.path;\n    logToFile(`[agent-runner] skill installed at ${skillPath}`);\n  }\n\n  // 6. Initialize agent\n  const spinner = getUI().spinner();\n  const wizardFlags = await analytics.getAllFlagsForWizard();\n  const wizardMetadata = buildWizardMetadata(wizardFlags);\n\n  const mcpUrl = session.localMcp\n    ? 'http://localhost:8787/mcp'\n    : process.env.MCP_URL ||\n      (cloudRegion === 'eu'\n        ? 'https://mcp-eu.posthog.com/mcp'\n        : 'https://mcp.posthog.com/mcp');\n\n  const restoreSettings = () => restoreClaudeSettings(session.installDir);\n  getUI().onEnterScreen('outro', restoreSettings);\n\n  if (session.yaraReport) {\n    registerCleanup(() => {\n      const reportPath = writeScanReport();\n      if (reportPath) {\n        const summary = formatScanReport();\n        getUI().log.info(`YARA scan report: ${reportPath}${summary ?? ''}`);\n      }\n    });\n  }\n\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.additionalMcpServers,\n      detectPackageManager:\n        config.detectPackageManager ?? detectNodePackageManagers,\n      skillsBaseUrl,\n      wizardFlags,\n      wizardMetadata,\n    },\n    sessionToOptions(session),\n  );\n\n  const middleware = session.benchmark\n    ? createBenchmarkPipeline(spinner, sessionToOptions(session))\n    : undefined;\n\n  // 7. Build prompt\n  const prompt = assemblePrompt(config, {\n    projectId,\n    projectApiKey,\n    host,\n    skillPath,\n  });\n\n  // 8. Run agent\n  const agentResult = await executeAgent(\n    agent,\n    prompt,\n    sessionToOptions(session),\n    spinner,\n    {\n      estimatedDurationMinutes: config.estimatedDurationMinutes,\n      spinnerMessage: config.spinnerMessage,\n      successMessage: config.successMessage,\n      errorMessage: config.errorMessage ?? `${config.integrationLabel} failed`,\n      additionalFeatureQueue: config.additionalFeatureQueue ?? [],\n      abortCases: config.abortCases,\n    },\n    middleware,\n  );\n\n  // 9. Error handling (full set from both runners)\n  if (agentResult.error === AgentErrorType.ABORT) {\n    const reason = agentResult.message ?? '';\n    const matched = config.abortCases?.find((c) => c.match.test(reason));\n    const outroData: WizardSession['outroData'] = matched\n      ? {\n          kind: OutroKind.Error,\n          message: matched.message,\n          body: matched.body,\n          docsUrl: matched.docsUrl,\n        }\n      : {\n          kind: OutroKind.Error,\n          message: `${config.integrationLabel} aborted`,\n          body: reason || 'The agent aborted the workflow.',\n          docsUrl: config.docsUrl,\n        };\n    analytics.wizardCapture('agent aborted', {\n      integration: config.integrationLabel,\n      reason,\n      matched: matched?.message ?? null,\n    });\n    await wizardAbort({\n      outroData,\n      error: new WizardError(`Agent aborted: ${reason}`, {\n        integration: config.integrationLabel,\n        error_type: AgentErrorType.ABORT,\n        reason,\n      }),\n    });\n  }\n\n  if (agentResult.error === AgentErrorType.MCP_MISSING) {\n    await wizardAbort({\n      message:\n        'Could not access the PostHog MCP server\\n\\n' +\n        'The wizard was unable to connect to the PostHog MCP server.\\n' +\n        'This could be due to a network issue or a configuration problem.\\n\\n' +\n        `Please try again, or check the documentation:\\n${config.docsUrl}`,\n      error: new WizardError('Agent could not access PostHog MCP server', {\n        integration: config.integrationLabel,\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:\n        'Could not access the setup resource\\n\\n' +\n        'This may indicate a version mismatch or a temporary service issue.\\n\\n' +\n        `Please try again, or check the documentation:\\n${config.docsUrl}`,\n      error: new WizardError('Agent could not access setup resource', {\n        integration: config.integrationLabel,\n        error_type: AgentErrorType.RESOURCE_MISSING,\n        signal: AgentSignals.ERROR_RESOURCE_MISSING,\n      }),\n    });\n  }\n\n  if (agentResult.error === AgentErrorType.YARA_VIOLATION) {\n    await wizardAbort({\n      message:\n        'Security violation detected.\\nPlease report this to: wizard@posthog.com',\n      error: new WizardError('YARA scanner terminated session', {\n        integration: config.integrationLabel,\n        error_type: AgentErrorType.YARA_VIOLATION,\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.integrationLabel,\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 to: wizard@posthog.com`,\n      error: new WizardError(`API error: ${agentResult.message}`, {\n        integration: config.integrationLabel,\n        error_type: agentResult.error,\n      }),\n    });\n  }\n\n  // 10. Post-run hooks\n  if (config.postRun) {\n    await config.postRun(session, {\n      accessToken,\n      projectApiKey,\n      host,\n      projectId,\n    });\n  }\n\n  // 11. Outro\n  if (config.buildOutroData) {\n    session.outroData = config.buildOutroData(\n      session,\n      { accessToken, projectApiKey, host, projectId },\n      cloudRegion,\n    );\n  } else {\n    const continueUrl = session.signup\n      ? `${getCloudUrlFromRegion(cloudRegion)}/products?source=wizard`\n      : undefined;\n\n    const reportPath = join(session.installDir, config.reportFile);\n    const reportExists = existsSync(reportPath);\n\n    session.outroData = {\n      kind: OutroKind.Success,\n      message: config.successMessage,\n      reportFile: reportExists ? config.reportFile : undefined,\n      docsUrl: config.docsUrl,\n      continueUrl,\n    };\n  }\n\n  getUI().outro(config.successMessage);\n\n  // 12. Analytics shutdown\n  await analytics.shutdown('success');\n}\n\n// ── Shared error helpers ─────────────────────────────────────────────\n\nasync function abortOnInstallFailure(\n  integrationLabel: string,\n  result: InstallSkillResult,\n): Promise<void> {\n  if (result.kind === 'ok') return;\n\n  const message = (() => {\n    switch (result.kind) {\n      case 'menu-fetch-failed':\n        return 'Could not fetch the skill menu from context-mill.\\nCheck your network connection and try again.';\n      case 'skill-not-found':\n        return `Could not find the \"${result.skillId}\" skill in the context-mill menu.\\nPlease try again later.`;\n      case 'download-failed':\n        return `Failed to install skill: ${result.message}\\nPlease try again.`;\n    }\n  })();\n\n  await wizardAbort({\n    message,\n    error: new WizardError(`Skill install failed: ${result.kind}`, {\n      integration: integrationLabel,\n      error_type: result.kind,\n    }),\n  });\n}\n"]}

package/dist/src/lib/agent/commandments.d.ts

@@ -1 +0,0 @@
-export declare function getWizardCommandments(): string;

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

@@ -1,26 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getWizardCommandments = getWizardCommandments;
-/**
- * Wizard-wide commandments that are always appended as a system prompt.
- *
- * Keep this as a simple string so it can be inlined into the compiled bundle
- * without extra files, copying, or runtime I/O.
- */
-const WIZARD_COMMANDMENTS = [
-    'Never hallucinate a PostHog project token, host, or any other secret. Always use the real values that have been configured for this project (for example via environment variables).',
-    '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.',
-    '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.',
-    '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.',
-    '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.',
-    '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.',
-    'After reading the integration skill, use the TodoWrite tool to track your progress. Create a todo list at the describing the high-level areas of work, mark each as in_progress when you begin it, and completed when done. Describe high-level tasks from the workflow ("inserting event tracking code", etc), not specific files or lines. For each new stage of the integration, create additional todos if necessary. Create a final "wrapping up" step and mark it completed when the integration is complete.',
-    'Do not assume "PostHog provider" or "PostHogProvider" in todo labels, status messages, or code. Only use a provider if the skill workflow explicitly requires one for the specific framework.',
-    'If you see a [YARA WARNING] or [YARA VIOLATION] message, handle it silently. Fix the issue (revert the write, avoid the flagged pattern) without mentioning security warnings or YARA to the user. These are internal guardrails, not user-facing alerts. Never show scary security language to the user.',
-].join('\n');
-function getWizardCommandments() {
-    return WIZARD_COMMANDMENTS;
-}
-//# sourceMappingURL=commandments.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"commandments.js","sourceRoot":"","sources":["../../../../src/lib/agent/commandments.ts"],"names":[],"mappings":";;AA8BA,sDAEC;AAhCD;;;;;GAKG;AACH,MAAM,mBAAmB,GAAG;IAC1B,sLAAsL;IAEtL,4OAA4O;IAE5O,4LAA4L;IAE5L,oLAAoL;IAEpL,uMAAuM;IAEvM,gVAAgV;IAEhV,gNAAgN;IAEhN,+DAA+D;IAE/D,qfAAqf;IAErf,+LAA+L;IAE/L,2SAA2S;CAC5S,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 project token, 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  'After reading the integration skill, use the TodoWrite tool to track your progress. Create a todo list at the describing the high-level areas of work, mark each as in_progress when you begin it, and completed when done. Describe high-level tasks from the workflow (\"inserting event tracking code\", etc), not specific files or lines. For each new stage of the integration, create additional todos if necessary. Create a final \"wrapping up\" step and mark it completed when the integration is complete.',\n\n  'Do not assume \"PostHog provider\" or \"PostHogProvider\" in todo labels, status messages, or code. Only use a provider if the skill workflow explicitly requires one for the specific framework.',\n\n  'If you see a [YARA WARNING] or [YARA VIOLATION] message, handle it silently. Fix the issue (revert the write, avoid the flagged pattern) without mentioning security warnings or YARA to the user. These are internal guardrails, not user-facing alerts. Never show scary security language to the user.',\n].join('\\n');\n\nexport function getWizardCommandments(): string {\n  return WIZARD_COMMANDMENTS;\n}\n"]}

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

@@ -1,75 +0,0 @@
-import { z } from 'zod';
-export declare const ApiUserSchema: z.ZodObject<{
-    distinct_id: z.ZodString;
-    organizations: z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        id: string;
-    }, {
-        id: string;
-    }>, "many">;
-    team: z.ZodObject<{
-        id: z.ZodNumber;
-        organization: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        id: number;
-        organization: string;
-    }, {
-        id: number;
-        organization: string;
-    }>;
-    organization: z.ZodObject<{
-        id: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        id: string;
-    }, {
-        id: string;
-    }>;
-}, "strip", z.ZodTypeAny, {
-    team: {
-        id: number;
-        organization: string;
-    };
-    distinct_id: string;
-    organizations: {
-        id: string;
-    }[];
-    organization: {
-        id: string;
-    };
-}, {
-    team: {
-        id: number;
-        organization: string;
-    };
-    distinct_id: string;
-    organizations: {
-        id: string;
-    }[];
-    organization: {
-        id: string;
-    };
-}>;
-export declare const ApiProjectSchema: z.ZodObject<{
-    id: z.ZodNumber;
-    uuid: z.ZodString;
-    organization: z.ZodString;
-    api_token: z.ZodString;
-    name: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    uuid: string;
-    name: string;
-    id: number;
-    organization: string;
-    api_token: string;
-}, {
-    uuid: string;
-    name: string;
-    id: number;
-    organization: string;
-    api_token: string;
-}>;
-export type ApiUser = z.infer<typeof ApiUserSchema>;
-export type ApiProject = z.infer<typeof ApiProjectSchema>;
-export declare function fetchUserData(accessToken: string, baseUrl: string): Promise<ApiUser>;
-export declare function fetchProjectData(accessToken: string, projectId: number, baseUrl: string): Promise<ApiProject>;

package/dist/src/lib/api.js

@@ -1,105 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ApiProjectSchema = exports.ApiUserSchema = void 0;
-exports.fetchUserData = fetchUserData;
-exports.fetchProjectData = fetchProjectData;
-const axios_1 = __importDefault(require("axios"));
-const zod_1 = require("zod");
-const analytics_1 = require("../utils/analytics");
-const constants_1 = require("./constants");
-exports.ApiUserSchema = zod_1.z.object({
-    distinct_id: zod_1.z.string(),
-    organizations: zod_1.z.array(zod_1.z.object({
-        id: zod_1.z.string().uuid(),
-    })),
-    team: zod_1.z.object({
-        id: zod_1.z.number(),
-        organization: zod_1.z.string().uuid(),
-    }),
-    organization: zod_1.z.object({
-        id: zod_1.z.string().uuid(),
-    }),
-});
-exports.ApiProjectSchema = zod_1.z.object({
-    id: zod_1.z.number(),
-    uuid: zod_1.z.string().uuid(),
-    organization: zod_1.z.string().uuid(),
-    api_token: zod_1.z.string(),
-    name: zod_1.z.string(),
-});
-class ApiError extends Error {
-    statusCode;
-    endpoint;
-    constructor(message, statusCode, endpoint) {
-        super(message);
-        this.statusCode = statusCode;
-        this.endpoint = endpoint;
-        this.name = 'ApiError';
-    }
-}
-async function fetchUserData(accessToken, baseUrl) {
-    try {
-        const response = await axios_1.default.get(`${baseUrl}/api/users/@me/`, {
-            headers: {
-                Authorization: `Bearer ${accessToken}`,
-                'User-Agent': constants_1.WIZARD_USER_AGENT,
-            },
-        });
-        return exports.ApiUserSchema.parse(response.data);
-    }
-    catch (error) {
-        const apiError = handleApiError(error, 'fetch user data');
-        analytics_1.analytics.captureException(apiError, {
-            endpoint: '/api/users/@me/',
-            baseUrl,
-        });
-        throw apiError;
-    }
-}
-async function fetchProjectData(accessToken, projectId, baseUrl) {
-    try {
-        const response = await axios_1.default.get(`${baseUrl}/api/projects/${projectId}/`, {
-            headers: {
-                Authorization: `Bearer ${accessToken}`,
-                'User-Agent': constants_1.WIZARD_USER_AGENT,
-            },
-        });
-        return exports.ApiProjectSchema.parse(response.data);
-    }
-    catch (error) {
-        const apiError = handleApiError(error, 'fetch project data');
-        analytics_1.analytics.captureException(apiError, {
-            endpoint: `/api/projects/${projectId}/`,
-            baseUrl,
-            projectId,
-        });
-        throw apiError;
-    }
-}
-function handleApiError(error, operation) {
-    if (axios_1.default.isAxiosError(error)) {
-        const axiosError = error;
-        const status = axiosError.response?.status;
-        const detail = axiosError.response?.data?.detail;
-        const endpoint = axiosError.config?.url;
-        if (status === 401) {
-            return new ApiError(`Authentication failed while trying to ${operation}`, status, endpoint);
-        }
-        if (status === 403) {
-            return new ApiError(`Access denied while trying to ${operation}`, status, endpoint);
-        }
-        if (status === 404) {
-            return new ApiError(`Resource not found while trying to ${operation}`, status, endpoint);
-        }
-        const message = detail || `Failed to ${operation}`;
-        return new ApiError(message, status, endpoint);
-    }
-    if (error instanceof zod_1.z.ZodError) {
-        return new ApiError(`Invalid response format while trying to ${operation}`);
-    }
-    return new ApiError(`Unexpected error while trying to ${operation}: ${error instanceof Error ? error.message : 'Unknown error'}`);
-}
-//# sourceMappingURL=api.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../src/lib/api.ts"],"names":[],"mappings":"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","sourcesContent":["import axios, { AxiosError } from 'axios';\nimport { z } from 'zod';\nimport { analytics } from '../utils/analytics';\nimport { WIZARD_USER_AGENT } from './constants';\n\nexport const ApiUserSchema = z.object({\n  distinct_id: z.string(),\n  organizations: z.array(\n    z.object({\n      id: z.string().uuid(),\n    }),\n  ),\n  team: z.object({\n    id: z.number(),\n    organization: z.string().uuid(),\n  }),\n  organization: z.object({\n    id: z.string().uuid(),\n  }),\n});\n\nexport const ApiProjectSchema = z.object({\n  id: z.number(),\n  uuid: z.string().uuid(),\n  organization: z.string().uuid(),\n  api_token: z.string(),\n  name: z.string(),\n});\n\nexport type ApiUser = z.infer<typeof ApiUserSchema>;\nexport type ApiProject = z.infer<typeof ApiProjectSchema>;\n\nclass ApiError extends Error {\n  constructor(\n    message: string,\n    public readonly statusCode?: number,\n    public readonly endpoint?: string,\n  ) {\n    super(message);\n    this.name = 'ApiError';\n  }\n}\n\nexport async function fetchUserData(\n  accessToken: string,\n  baseUrl: string,\n): Promise<ApiUser> {\n  try {\n    const response = await axios.get(`${baseUrl}/api/users/@me/`, {\n      headers: {\n        Authorization: `Bearer ${accessToken}`,\n        'User-Agent': WIZARD_USER_AGENT,\n      },\n    });\n\n    return ApiUserSchema.parse(response.data);\n  } catch (error) {\n    const apiError = handleApiError(error, 'fetch user data');\n    analytics.captureException(apiError, {\n      endpoint: '/api/users/@me/',\n      baseUrl,\n    });\n    throw apiError;\n  }\n}\n\nexport async function fetchProjectData(\n  accessToken: string,\n  projectId: number,\n  baseUrl: string,\n): Promise<ApiProject> {\n  try {\n    const response = await axios.get(`${baseUrl}/api/projects/${projectId}/`, {\n      headers: {\n        Authorization: `Bearer ${accessToken}`,\n        'User-Agent': WIZARD_USER_AGENT,\n      },\n    });\n\n    return ApiProjectSchema.parse(response.data);\n  } catch (error) {\n    const apiError = handleApiError(error, 'fetch project data');\n    analytics.captureException(apiError, {\n      endpoint: `/api/projects/${projectId}/`,\n      baseUrl,\n      projectId,\n    });\n    throw apiError;\n  }\n}\n\nfunction handleApiError(error: unknown, operation: string): ApiError {\n  if (axios.isAxiosError(error)) {\n    const axiosError = error as AxiosError<{ detail?: string }>;\n    const status = axiosError.response?.status;\n    const detail = axiosError.response?.data?.detail;\n    const endpoint = axiosError.config?.url;\n\n    if (status === 401) {\n      return new ApiError(\n        `Authentication failed while trying to ${operation}`,\n        status,\n        endpoint,\n      );\n    }\n\n    if (status === 403) {\n      return new ApiError(\n        `Access denied while trying to ${operation}`,\n        status,\n        endpoint,\n      );\n    }\n\n    if (status === 404) {\n      return new ApiError(\n        `Resource not found while trying to ${operation}`,\n        status,\n        endpoint,\n      );\n    }\n\n    const message = detail || `Failed to ${operation}`;\n    return new ApiError(message, status, endpoint);\n  }\n\n  if (error instanceof z.ZodError) {\n    return new ApiError(`Invalid response format while trying to ${operation}`);\n  }\n\n  return new ApiError(\n    `Unexpected error while trying to ${operation}: ${\n      error instanceof Error ? error.message : 'Unknown error'\n    }`,\n  );\n}\n"]}

package/dist/src/lib/cloudflare-detection.d.ts

@@ -1,14 +0,0 @@
-/**
- * Detect whether the project targets Cloudflare Workers.
- *
- * Checks for:
- * 1. wrangler.toml / wrangler.jsonc / wrangler.json in project root
- * 2. Cloudflare adapter packages in dependencies (@react-router/cloudflare,
- *    @astrojs/cloudflare, @sveltejs/adapter-cloudflare, etc.)
- */
-export declare function detectCloudflareTarget(installDir: string): Promise<boolean>;
-/**
- * Fetch the Cloudflare Workers reference from the skills server.
- * Returns the markdown content, or null on failure.
- */
-export declare function fetchCloudflareReference(skillsBaseUrl: string): Promise<string | null>;