@posthog/wizard 2.9.1 → 2.10.0

package/dist/src/lib/detection/package-manager.js

@@ -1,183 +0,0 @@
-"use strict";
-/**
- * Cross-ecosystem package manager detection.
- *
- * Provides a common interface (PackageManagerDetector) that each FrameworkConfig
- * implements, plus shared helpers for Node.js, Python, PHP, and Swift ecosystems.
- * The MCP tool in wizard-tools.ts delegates to whatever detector the
- * current framework supplies.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.detectNodePackageManagers = detectNodePackageManagers;
-exports.detectPythonPackageManagers = detectPythonPackageManagers;
-exports.composerPackageManager = composerPackageManager;
-exports.swiftPackageManager = swiftPackageManager;
-exports.bundlerPackageManager = bundlerPackageManager;
-exports.gradlePackageManager = gradlePackageManager;
-const package_manager_1 = require("../../utils/package-manager");
-const utils_1 = require("../../frameworks/python/utils");
-// ---------------------------------------------------------------------------
-// Node.js helper
-// ---------------------------------------------------------------------------
-function serializeNodePM(pm) {
-    return {
-        name: pm.name,
-        label: pm.label,
-        installCommand: pm.installCommand,
-        runCommand: pm.runScriptCommand,
-    };
-}
-/**
- * Detect Node.js package managers via lockfiles.
- * Wraps the existing detectAllPackageManagers() from utils/package-manager.ts.
- */
-function detectNodePackageManagers(installDir) {
-    const detected = (0, package_manager_1.detectAllPackageManagers)({ installDir }).map(serializeNodePM);
-    if (detected.length === 0) {
-        return Promise.resolve({
-            detected: [],
-            primary: null,
-            recommendation: 'No lockfile found. Default to npm (npm add, npm run).',
-        });
-    }
-    const primary = detected[0];
-    return Promise.resolve({
-        detected,
-        primary,
-        recommendation: detected.length === 1
-            ? `Use ${primary.label} (${primary.installCommand}).`
-            : `Multiple package managers detected. Prefer ${primary.label} (${primary.installCommand}).`,
-    });
-}
-// ---------------------------------------------------------------------------
-// Python helper
-// ---------------------------------------------------------------------------
-const PYTHON_PM_INFO = {
-    [utils_1.PythonPackageManager.UV]: {
-        name: 'uv',
-        label: 'uv',
-        installCommand: 'uv add',
-        runCommand: 'uv run',
-    },
-    [utils_1.PythonPackageManager.POETRY]: {
-        name: 'poetry',
-        label: 'Poetry',
-        installCommand: 'poetry add',
-        runCommand: 'poetry run',
-    },
-    [utils_1.PythonPackageManager.PDM]: {
-        name: 'pdm',
-        label: 'PDM',
-        installCommand: 'pdm add',
-        runCommand: 'pdm run',
-    },
-    [utils_1.PythonPackageManager.HATCH]: {
-        name: 'hatch',
-        label: 'Hatch',
-        installCommand: 'hatch add',
-        runCommand: 'hatch run',
-    },
-    [utils_1.PythonPackageManager.RYE]: {
-        name: 'rye',
-        label: 'Rye',
-        installCommand: 'rye add',
-        runCommand: 'rye run',
-    },
-    [utils_1.PythonPackageManager.PIPENV]: {
-        name: 'pipenv',
-        label: 'Pipenv',
-        installCommand: 'pipenv install',
-        runCommand: 'pipenv run',
-    },
-    [utils_1.PythonPackageManager.CONDA]: {
-        name: 'conda',
-        label: 'Conda',
-        installCommand: 'conda install',
-        runCommand: 'conda run',
-    },
-    [utils_1.PythonPackageManager.PIP]: {
-        name: 'pip',
-        label: 'pip',
-        installCommand: 'pip install',
-    },
-    [utils_1.PythonPackageManager.UNKNOWN]: {
-        name: 'pip',
-        label: 'pip (default)',
-        installCommand: 'pip install',
-    },
-};
-/**
- * Detect Python package managers via lockfiles and config files.
- * Wraps the existing detectPackageManager() from python/utils.ts.
- */
-async function detectPythonPackageManagers(installDir) {
-    const pm = await (0, utils_1.detectPackageManager)({ installDir });
-    const info = PYTHON_PM_INFO[pm];
-    return {
-        detected: [info],
-        primary: info,
-        recommendation: `Use ${info.label} (${info.installCommand}).`,
-    };
-}
-// ---------------------------------------------------------------------------
-// PHP (Composer) helper
-// ---------------------------------------------------------------------------
-const COMPOSER = {
-    name: 'composer',
-    label: 'Composer',
-    installCommand: 'composer require',
-};
-function composerPackageManager() {
-    return Promise.resolve({
-        detected: [COMPOSER],
-        primary: COMPOSER,
-        recommendation: 'Use Composer (composer require).',
-    });
-}
-// ---------------------------------------------------------------------------
-// Swift (SPM) helper
-// ---------------------------------------------------------------------------
-const SPM = {
-    name: 'spm',
-    label: 'Swift Package Manager',
-    installCommand: 'swift package add-dependency',
-};
-function swiftPackageManager() {
-    return Promise.resolve({
-        detected: [SPM],
-        primary: SPM,
-        recommendation: 'Use Swift Package Manager. Add the dependency to Package.swift or via Xcode.',
-    });
-}
-// ---------------------------------------------------------------------------
-// Ruby (Bundler) helper
-// ---------------------------------------------------------------------------
-const BUNDLER = {
-    name: 'bundler',
-    label: 'Bundler',
-    installCommand: 'bundle add',
-    runCommand: 'bundle exec',
-};
-function bundlerPackageManager() {
-    return Promise.resolve({
-        detected: [BUNDLER],
-        primary: BUNDLER,
-        recommendation: 'Use Bundler (bundle add). Run commands with bundle exec.',
-    });
-}
-// ---------------------------------------------------------------------------
-// Android (Gradle) helper
-// ---------------------------------------------------------------------------
-const GRADLE = {
-    name: 'gradle',
-    label: 'Gradle',
-    installCommand: 'implementation',
-};
-function gradlePackageManager() {
-    return Promise.resolve({
-        detected: [GRADLE],
-        primary: GRADLE,
-        recommendation: 'Add dependencies to build.gradle(.kts) using implementation().',
-    });
-}
-//# sourceMappingURL=package-manager.js.map

package/dist/src/lib/detection/package-manager.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"package-manager.js","sourceRoot":"","sources":["../../../../src/lib/detection/package-manager.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Cross-ecosystem package manager detection.\n *\n * Provides a common interface (PackageManagerDetector) that each FrameworkConfig\n * implements, plus shared helpers for Node.js, Python, PHP, and Swift ecosystems.\n * The MCP tool in wizard-tools.ts delegates to whatever detector the\n * current framework supplies.\n */\n\nimport {\n  detectAllPackageManagers,\n  type PackageManager,\n} from '../../utils/package-manager';\nimport {\n  detectPackageManager as detectPythonPM,\n  PythonPackageManager,\n} from '../../frameworks/python/utils';\n\n// ---------------------------------------------------------------------------\n// Common types\n// ---------------------------------------------------------------------------\n\n/** Structured package manager info the agent can act on */\nexport interface DetectedPackageManager {\n  name: string;\n  label: string;\n  installCommand: string;\n  runCommand?: string;\n}\n\n/** Result returned by every detector */\nexport interface PackageManagerInfo {\n  detected: DetectedPackageManager[];\n  primary: DetectedPackageManager | null;\n  recommendation: string;\n}\n\n/** Signature each framework implements */\nexport type PackageManagerDetector = (\n  installDir: string,\n) => Promise<PackageManagerInfo>;\n\n// ---------------------------------------------------------------------------\n// Node.js helper\n// ---------------------------------------------------------------------------\n\nfunction serializeNodePM(pm: PackageManager): DetectedPackageManager {\n  return {\n    name: pm.name,\n    label: pm.label,\n    installCommand: pm.installCommand,\n    runCommand: pm.runScriptCommand,\n  };\n}\n\n/**\n * Detect Node.js package managers via lockfiles.\n * Wraps the existing detectAllPackageManagers() from utils/package-manager.ts.\n */\nexport function detectNodePackageManagers(\n  installDir: string,\n): Promise<PackageManagerInfo> {\n  const detected = detectAllPackageManagers({ installDir }).map(\n    serializeNodePM,\n  );\n\n  if (detected.length === 0) {\n    return Promise.resolve({\n      detected: [],\n      primary: null,\n      recommendation: 'No lockfile found. Default to npm (npm add, npm run).',\n    });\n  }\n\n  const primary = detected[0];\n  return Promise.resolve({\n    detected,\n    primary,\n    recommendation:\n      detected.length === 1\n        ? `Use ${primary.label} (${primary.installCommand}).`\n        : `Multiple package managers detected. Prefer ${primary.label} (${primary.installCommand}).`,\n  });\n}\n\n// ---------------------------------------------------------------------------\n// Python helper\n// ---------------------------------------------------------------------------\n\nconst PYTHON_PM_INFO: Record<PythonPackageManager, DetectedPackageManager> = {\n  [PythonPackageManager.UV]: {\n    name: 'uv',\n    label: 'uv',\n    installCommand: 'uv add',\n    runCommand: 'uv run',\n  },\n  [PythonPackageManager.POETRY]: {\n    name: 'poetry',\n    label: 'Poetry',\n    installCommand: 'poetry add',\n    runCommand: 'poetry run',\n  },\n  [PythonPackageManager.PDM]: {\n    name: 'pdm',\n    label: 'PDM',\n    installCommand: 'pdm add',\n    runCommand: 'pdm run',\n  },\n  [PythonPackageManager.HATCH]: {\n    name: 'hatch',\n    label: 'Hatch',\n    installCommand: 'hatch add',\n    runCommand: 'hatch run',\n  },\n  [PythonPackageManager.RYE]: {\n    name: 'rye',\n    label: 'Rye',\n    installCommand: 'rye add',\n    runCommand: 'rye run',\n  },\n  [PythonPackageManager.PIPENV]: {\n    name: 'pipenv',\n    label: 'Pipenv',\n    installCommand: 'pipenv install',\n    runCommand: 'pipenv run',\n  },\n  [PythonPackageManager.CONDA]: {\n    name: 'conda',\n    label: 'Conda',\n    installCommand: 'conda install',\n    runCommand: 'conda run',\n  },\n  [PythonPackageManager.PIP]: {\n    name: 'pip',\n    label: 'pip',\n    installCommand: 'pip install',\n  },\n  [PythonPackageManager.UNKNOWN]: {\n    name: 'pip',\n    label: 'pip (default)',\n    installCommand: 'pip install',\n  },\n};\n\n/**\n * Detect Python package managers via lockfiles and config files.\n * Wraps the existing detectPackageManager() from python/utils.ts.\n */\nexport async function detectPythonPackageManagers(\n  installDir: string,\n): Promise<PackageManagerInfo> {\n  const pm = await detectPythonPM({ installDir } as any);\n  const info = PYTHON_PM_INFO[pm];\n\n  return {\n    detected: [info],\n    primary: info,\n    recommendation: `Use ${info.label} (${info.installCommand}).`,\n  };\n}\n\n// ---------------------------------------------------------------------------\n// PHP (Composer) helper\n// ---------------------------------------------------------------------------\n\nconst COMPOSER: DetectedPackageManager = {\n  name: 'composer',\n  label: 'Composer',\n  installCommand: 'composer require',\n};\n\nexport function composerPackageManager(): Promise<PackageManagerInfo> {\n  return Promise.resolve({\n    detected: [COMPOSER],\n    primary: COMPOSER,\n    recommendation: 'Use Composer (composer require).',\n  });\n}\n\n// ---------------------------------------------------------------------------\n// Swift (SPM) helper\n// ---------------------------------------------------------------------------\n\nconst SPM: DetectedPackageManager = {\n  name: 'spm',\n  label: 'Swift Package Manager',\n  installCommand: 'swift package add-dependency',\n};\n\nexport function swiftPackageManager(): Promise<PackageManagerInfo> {\n  return Promise.resolve({\n    detected: [SPM],\n    primary: SPM,\n    recommendation:\n      'Use Swift Package Manager. Add the dependency to Package.swift or via Xcode.',\n  });\n}\n\n// ---------------------------------------------------------------------------\n// Ruby (Bundler) helper\n// ---------------------------------------------------------------------------\n\nconst BUNDLER: DetectedPackageManager = {\n  name: 'bundler',\n  label: 'Bundler',\n  installCommand: 'bundle add',\n  runCommand: 'bundle exec',\n};\n\nexport function bundlerPackageManager(): Promise<PackageManagerInfo> {\n  return Promise.resolve({\n    detected: [BUNDLER],\n    primary: BUNDLER,\n    recommendation: 'Use Bundler (bundle add). Run commands with bundle exec.',\n  });\n}\n\n// ---------------------------------------------------------------------------\n// Android (Gradle) helper\n// ---------------------------------------------------------------------------\n\nconst GRADLE: DetectedPackageManager = {\n  name: 'gradle',\n  label: 'Gradle',\n  installCommand: 'implementation',\n};\n\nexport function gradlePackageManager(): Promise<PackageManagerInfo> {\n  return Promise.resolve({\n    detected: [GRADLE],\n    primary: GRADLE,\n    recommendation:\n      'Add dependencies to build.gradle(.kts) using implementation().',\n  });\n}\n"]}

package/dist/src/lib/framework-config.d.ts

@@ -1,175 +0,0 @@
-import type { Integration } from './constants';
-import type { WizardOptions } from '../utils/types';
-import type { PackageManagerDetector } from './detection/package-manager';
-/**
- * A setup question that the SetupScreen renders for framework disambiguation.
- * If detect() returns a value, the question is auto-resolved and not shown.
- */
-export interface SetupQuestion {
-    /** Stored in session.frameworkContext[key] */
-    key: string;
-    /** Displayed to user, e.g. "Which router are you using?" */
-    message: string;
-    /** Picker options */
-    options: Array<{
-        label: string;
-        value: string;
-        hint?: string;
-    }>;
-    /** Auto-detect; null = ask the user */
-    detect: (options: Pick<WizardOptions, 'installDir'>) => Promise<string | null>;
-}
-/**
- * Configuration interface for framework-specific agent integrations.
- * Each framework exports a FrameworkConfig that the universal runner uses.
- *
- * The TContext generic represents the framework-specific context gathered
- * before the agent runs (e.g., router type for Next.js, project type for Django).
- * The runner threads this opaquely — all framework-specific logic stays inside the config.
- */
-export interface FrameworkConfig<TContext extends Record<string, unknown> = Record<string, unknown>> {
-    metadata: FrameworkMetadata<TContext>;
-    detection: FrameworkDetection;
-    environment: EnvironmentConfig;
-    analytics: AnalyticsConfig<TContext>;
-    prompts: PromptConfig<TContext>;
-    ui: UIConfig<TContext>;
-}
-/**
- * Basic framework information and documentation
- */
-export interface FrameworkMetadata<TContext extends Record<string, unknown> = Record<string, unknown>> {
-    /** Display name (e.g., "Next.js", "React") */
-    name: string;
-    /** Integration type from constants */
-    integration: Integration;
-    /** URL to framework-specific PostHog docs */
-    docsUrl: string;
-    /**
-     * Optional URL to docs for users with unsupported framework versions.
-     * If not provided, defaults to docsUrl.
-     */
-    unsupportedVersionDocsUrl?: string;
-    /** If true, shows a beta notice before running the wizard. */
-    beta?: boolean;
-    /** Optional notice shown before the agent runs (e.g., "Close Xcode before proceeding"). */
-    preRunNotice?: string;
-    /**
-     * Optional function to gather framework-specific context before agent runs.
-     * For Next.js: detects router type
-     * For React Native: detects Expo vs bare
-     */
-    gatherContext?: (options: WizardOptions) => Promise<TContext>;
-    /** Optional additional MCP servers for this framework (e.g., Svelte MCP). */
-    additionalMcpServers?: Record<string, {
-        url: string;
-    }>;
-    /**
-     * Setup questions for framework disambiguation.
-     * The SetupScreen iterates unresolved questions and renders a PickerMenu for each.
-     * If all questions are auto-resolved (or none defined), the screen is skipped.
-     */
-    setup?: {
-        questions: SetupQuestion[];
-    };
-}
-/**
- * Framework detection and version handling
- */
-export interface FrameworkDetection {
-    /** Package name to check in package.json (e.g., "next", "react") */
-    packageName: string;
-    /** Human-readable name for error messages (e.g., "Next.js") */
-    packageDisplayName: string;
-    /** Extract version from package.json */
-    getVersion: (packageJson: unknown) => string | undefined;
-    /** Optional: Convert version to analytics bucket (e.g., "15.x") */
-    getVersionBucket?: (version: string) => string;
-    /**
-     * Whether this framework uses package.json (Node.js/JavaScript).
-     * If false, skips package.json checks (for Python, Go, etc.)
-     * Defaults to true if not specified.
-     */
-    usesPackageJson?: boolean;
-    /** Minimum supported version. If set, runner checks before proceeding. */
-    minimumVersion?: string;
-    /** Get the currently installed version. Called by runner for version check. */
-    getInstalledVersion?: (options: WizardOptions) => Promise<string | undefined>;
-    /** Detect whether this framework is present in the project. */
-    detect: (options: Pick<WizardOptions, 'installDir'>) => Promise<boolean>;
-    /** Detect the project's package manager(s). Used by the in-process MCP tool. */
-    detectPackageManager: PackageManagerDetector;
-}
-/**
- * Environment variable configuration
- */
-export interface EnvironmentConfig {
-    /** Whether to upload env vars to hosting providers post-agent */
-    uploadToHosting: boolean;
-    /**
-     * Build the environment variables object for this framework.
-     * Returns the exact variable names and values to upload to hosting providers.
-     */
-    getEnvVars: (apiKey: string, host: string) => Record<string, string>;
-}
-/**
- * Analytics configuration
- */
-export interface AnalyticsConfig<TContext extends Record<string, unknown> = Record<string, unknown>> {
-    /** Generate tags from context (e.g., { 'nextjs-version': '15.x', 'router': 'app' }) */
-    getTags: (context: TContext) => Record<string, string>;
-    /** Optional: Additional event properties */
-    getEventProperties?: (context: TContext) => Record<string, string>;
-}
-/**
- * Default package installation instruction used when frameworks don't
- * provide their own. Frameworks with specific needs (e.g., Swift SPM,
- * Composer) override this in their config.
- */
-export declare const DEFAULT_PACKAGE_INSTALLATION = "Use the detect_package_manager tool to determine the package manager. Do not manually edit package.json; the package manager handles it automatically.";
-export declare const PYTHON_PACKAGE_INSTALLATION = "Use the detect_package_manager tool to determine the package manager. If the detected tool manages dependencies directly (e.g. uv add, poetry add), use it \u2014 it will update the manifest automatically. If using pip, you must also add the dependency to requirements.txt or the appropriate manifest file.";
-/**
- * Prompt configuration
- */
-export interface PromptConfig<TContext extends Record<string, unknown> = Record<string, unknown>> {
-    /**
-     * Optional: Additional context lines to append to base prompt
-     * For Next.js: "- Router: app"
-     * For React Native: "- Platform: Expo"
-     */
-    getAdditionalContextLines?: (context: TContext) => string[];
-    /**
-     * How to detect the project type for this framework.
-     * Included in the agent prompt as project context.
-     * e.g., "Look for package.json and lockfiles" or "Look for requirements.txt and manage.py"
-     */
-    projectTypeDetection: string;
-    /**
-     * How to install packages for this framework.
-     * Included in the agent prompt as project context.
-     * Defaults to DEFAULT_PACKAGE_INSTALLATION. Only override if the framework
-     * has specific installation guidance (e.g., Swift SPM, Composer).
-     */
-    packageInstallation?: string;
-}
-/**
- * UI messaging configuration
- */
-export interface UIConfig<TContext extends Record<string, unknown> = Record<string, unknown>> {
-    /** Success message when agent completes */
-    successMessage: string;
-    /** Estimated time for agent to complete (in minutes) */
-    estimatedDurationMinutes: number;
-    /** Generate "What the agent did" bullets from context */
-    getOutroChanges: (context: TContext) => string[];
-    /** Generate "Next steps" bullets from context */
-    getOutroNextSteps: (context: TContext) => string[];
-}
-/**
- * Generate welcome message from framework name
- */
-export declare function getWelcomeMessage(frameworkName: string): string;
-/**
- * Shared spinner message for all frameworks
- */
-export declare const SPINNER_MESSAGE = "Writing your PostHog setup with events, error capture and more...";

package/dist/src/lib/framework-config.js

@@ -1,22 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SPINNER_MESSAGE = exports.PYTHON_PACKAGE_INSTALLATION = exports.DEFAULT_PACKAGE_INSTALLATION = void 0;
-exports.getWelcomeMessage = getWelcomeMessage;
-/**
- * Default package installation instruction used when frameworks don't
- * provide their own. Frameworks with specific needs (e.g., Swift SPM,
- * Composer) override this in their config.
- */
-exports.DEFAULT_PACKAGE_INSTALLATION = 'Use the detect_package_manager tool to determine the package manager. Do not manually edit package.json; the package manager handles it automatically.';
-exports.PYTHON_PACKAGE_INSTALLATION = 'Use the detect_package_manager tool to determine the package manager. If the detected tool manages dependencies directly (e.g. uv add, poetry add), use it — it will update the manifest automatically. If using pip, you must also add the dependency to requirements.txt or the appropriate manifest file.';
-/**
- * Generate welcome message from framework name
- */
-function getWelcomeMessage(frameworkName) {
-    return `PostHog ${frameworkName} wizard (agent-powered)`;
-}
-/**
- * Shared spinner message for all frameworks
- */
-exports.SPINNER_MESSAGE = 'Writing your PostHog setup with events, error capture and more...';
-//# sourceMappingURL=framework-config.js.map

package/dist/src/lib/framework-config.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"framework-config.js","sourceRoot":"","sources":["../../../src/lib/framework-config.ts"],"names":[],"mappings":";;;AAoNA,8CAEC;AAhED;;;;GAIG;AACU,QAAA,4BAA4B,GACvC,wJAAwJ,CAAC;AAE9I,QAAA,2BAA2B,GACtC,8SAA8S,CAAC;AAkDjT;;GAEG;AACH,SAAgB,iBAAiB,CAAC,aAAqB;IACrD,OAAO,WAAW,aAAa,yBAAyB,CAAC;AAC3D,CAAC;AAED;;GAEG;AACU,QAAA,eAAe,GAC1B,mEAAmE,CAAC","sourcesContent":["import type { Integration } from './constants';\nimport type { WizardOptions } from '../utils/types';\nimport type { PackageManagerDetector } from './detection/package-manager';\n\n/**\n * A setup question that the SetupScreen renders for framework disambiguation.\n * If detect() returns a value, the question is auto-resolved and not shown.\n */\nexport interface SetupQuestion {\n  /** Stored in session.frameworkContext[key] */\n  key: string;\n  /** Displayed to user, e.g. \"Which router are you using?\" */\n  message: string;\n  /** Picker options */\n  options: Array<{ label: string; value: string; hint?: string }>;\n  /** Auto-detect; null = ask the user */\n  detect: (\n    options: Pick<WizardOptions, 'installDir'>,\n  ) => Promise<string | null>;\n}\n\n/**\n * Configuration interface for framework-specific agent integrations.\n * Each framework exports a FrameworkConfig that the universal runner uses.\n *\n * The TContext generic represents the framework-specific context gathered\n * before the agent runs (e.g., router type for Next.js, project type for Django).\n * The runner threads this opaquely — all framework-specific logic stays inside the config.\n */\nexport interface FrameworkConfig<\n  TContext extends Record<string, unknown> = Record<string, unknown>,\n> {\n  metadata: FrameworkMetadata<TContext>;\n  detection: FrameworkDetection;\n  environment: EnvironmentConfig;\n  analytics: AnalyticsConfig<TContext>;\n  prompts: PromptConfig<TContext>;\n  ui: UIConfig<TContext>;\n}\n\n/**\n * Basic framework information and documentation\n */\nexport interface FrameworkMetadata<\n  TContext extends Record<string, unknown> = Record<string, unknown>,\n> {\n  /** Display name (e.g., \"Next.js\", \"React\") */\n  name: string;\n\n  /** Integration type from constants */\n  integration: Integration;\n\n  /** URL to framework-specific PostHog docs */\n  docsUrl: string;\n\n  /**\n   * Optional URL to docs for users with unsupported framework versions.\n   * If not provided, defaults to docsUrl.\n   */\n  unsupportedVersionDocsUrl?: string;\n\n  /** If true, shows a beta notice before running the wizard. */\n  beta?: boolean;\n\n  /** Optional notice shown before the agent runs (e.g., \"Close Xcode before proceeding\"). */\n  preRunNotice?: string;\n\n  /**\n   * Optional function to gather framework-specific context before agent runs.\n   * For Next.js: detects router type\n   * For React Native: detects Expo vs bare\n   */\n  gatherContext?: (options: WizardOptions) => Promise<TContext>;\n\n  /** Optional additional MCP servers for this framework (e.g., Svelte MCP). */\n  additionalMcpServers?: Record<string, { url: string }>;\n\n  /**\n   * Setup questions for framework disambiguation.\n   * The SetupScreen iterates unresolved questions and renders a PickerMenu for each.\n   * If all questions are auto-resolved (or none defined), the screen is skipped.\n   */\n  setup?: {\n    questions: SetupQuestion[];\n  };\n}\n\n/**\n * Framework detection and version handling\n */\nexport interface FrameworkDetection {\n  /** Package name to check in package.json (e.g., \"next\", \"react\") */\n  packageName: string;\n\n  /** Human-readable name for error messages (e.g., \"Next.js\") */\n  packageDisplayName: string;\n\n  /** Extract version from package.json */\n  getVersion: (packageJson: unknown) => string | undefined;\n\n  /** Optional: Convert version to analytics bucket (e.g., \"15.x\") */\n  getVersionBucket?: (version: string) => string;\n\n  /**\n   * Whether this framework uses package.json (Node.js/JavaScript).\n   * If false, skips package.json checks (for Python, Go, etc.)\n   * Defaults to true if not specified.\n   */\n  usesPackageJson?: boolean;\n\n  /** Minimum supported version. If set, runner checks before proceeding. */\n  minimumVersion?: string;\n\n  /** Get the currently installed version. Called by runner for version check. */\n  getInstalledVersion?: (options: WizardOptions) => Promise<string | undefined>;\n\n  /** Detect whether this framework is present in the project. */\n  detect: (options: Pick<WizardOptions, 'installDir'>) => Promise<boolean>;\n\n  /** Detect the project's package manager(s). Used by the in-process MCP tool. */\n  detectPackageManager: PackageManagerDetector;\n}\n\n/**\n * Environment variable configuration\n */\nexport interface EnvironmentConfig {\n  /** Whether to upload env vars to hosting providers post-agent */\n  uploadToHosting: boolean;\n\n  /**\n   * Build the environment variables object for this framework.\n   * Returns the exact variable names and values to upload to hosting providers.\n   */\n  getEnvVars: (apiKey: string, host: string) => Record<string, string>;\n}\n\n/**\n * Analytics configuration\n */\nexport interface AnalyticsConfig<\n  TContext extends Record<string, unknown> = Record<string, unknown>,\n> {\n  /** Generate tags from context (e.g., { 'nextjs-version': '15.x', 'router': 'app' }) */\n  getTags: (context: TContext) => Record<string, string>;\n\n  /** Optional: Additional event properties */\n  getEventProperties?: (context: TContext) => Record<string, string>;\n}\n\n/**\n * Default package installation instruction used when frameworks don't\n * provide their own. Frameworks with specific needs (e.g., Swift SPM,\n * Composer) override this in their config.\n */\nexport const DEFAULT_PACKAGE_INSTALLATION =\n  'Use the detect_package_manager tool to determine the package manager. Do not manually edit package.json; the package manager handles it automatically.';\n\nexport const PYTHON_PACKAGE_INSTALLATION =\n  'Use the detect_package_manager tool to determine the package manager. If the detected tool manages dependencies directly (e.g. uv add, poetry add), use it — it will update the manifest automatically. If using pip, you must also add the dependency to requirements.txt or the appropriate manifest file.';\n\n/**\n * Prompt configuration\n */\nexport interface PromptConfig<\n  TContext extends Record<string, unknown> = Record<string, unknown>,\n> {\n  /**\n   * Optional: Additional context lines to append to base prompt\n   * For Next.js: \"- Router: app\"\n   * For React Native: \"- Platform: Expo\"\n   */\n  getAdditionalContextLines?: (context: TContext) => string[];\n\n  /**\n   * How to detect the project type for this framework.\n   * Included in the agent prompt as project context.\n   * e.g., \"Look for package.json and lockfiles\" or \"Look for requirements.txt and manage.py\"\n   */\n  projectTypeDetection: string;\n\n  /**\n   * How to install packages for this framework.\n   * Included in the agent prompt as project context.\n   * Defaults to DEFAULT_PACKAGE_INSTALLATION. Only override if the framework\n   * has specific installation guidance (e.g., Swift SPM, Composer).\n   */\n  packageInstallation?: string;\n}\n\n/**\n * UI messaging configuration\n */\nexport interface UIConfig<\n  TContext extends Record<string, unknown> = Record<string, unknown>,\n> {\n  /** Success message when agent completes */\n  successMessage: string;\n\n  /** Estimated time for agent to complete (in minutes) */\n  estimatedDurationMinutes: number;\n\n  /** Generate \"What the agent did\" bullets from context */\n  getOutroChanges: (context: TContext) => string[];\n\n  /** Generate \"Next steps\" bullets from context */\n  getOutroNextSteps: (context: TContext) => string[];\n}\n\n/**\n * Generate welcome message from framework name\n */\nexport function getWelcomeMessage(frameworkName: string): string {\n  return `PostHog ${frameworkName} wizard (agent-powered)`;\n}\n\n/**\n * Shared spinner message for all frameworks\n */\nexport const SPINNER_MESSAGE =\n  'Writing your PostHog setup with events, error capture and more...';\n"]}

package/dist/src/lib/health-checks/__tests__/health-checks.test.d.ts

@@ -1,18 +0,0 @@
-/**
- * Tests for health-checks.ts
- *
- * Mock data is modelled on live Statuspage.io v2 API responses.
- * Statuspage docs: https://metastatuspage.com/api
- *
- * status.json  – page-level rollup with indicator (none | minor | major | critical)
- * summary.json – same rollup plus component list; component statuses:
- *   operational | degraded_performance | partial_outage | major_outage | under_maintenance
- *   https://support.atlassian.com/statuspage/docs/show-service-status-with-components
- *
- * LLM Gateway – FastAPI service, GET /_liveness returns {"status":"alive"} (200)
- *   Source: posthog/services/llm-gateway/src/llm_gateway/api/health.py
- *
- * MCP – Cloudflare Worker, GET / returns an HTML landing page (200)
- *   Source: posthog/services/mcp/src/index.ts
- */
-export {};