@posthog/wizard 2.9.1 → 2.10.1

package/dist/src/lib/safe-tools.js

@@ -1,215 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LINTING_TOOLS = void 0;
-exports.LINTING_TOOLS = [
-    // All (general purpose)
-    'codespell',
-    'cspell',
-    'git-diff-check',
-    'gitleaks',
-    'trufflehog',
-    // Amazon States Language
-    'asl-validator',
-    // Ansible
-    'ansible-lint',
-    // Apex, Java
-    'pmd',
-    // Astro, CSS, GraphQL, GritQL, HTML, JavaScript, JSON, JSONC, JSON5, JSX, TSX, Svelte, TypeScript, Vue
-    'biome',
-    // AWS CloudFormation templates
-    'cfn-lint',
-    'cfnlint',
-    // AWS CloudFormation, Azure ARM, Dockerfile, Helm, Kubernetes, Security, Terraform
-    'checkov',
-    // AWS CloudFormation, Azure ARM, Dockerfile, Kubernetes, Secrets, Security, Terraform, Vulnerabilities
-    'trivy',
-    // Azure Resource Manager (ARM)
-    'test-aztemplate',
-    // Bash / Shell
-    'shellcheck',
-    'shfmt',
-    // Bazel, Starlark
-    'buildifier',
-    // C, C++
-    'cpplint',
-    'clang-format',
-    'clang-tidy',
-    'cmake-format',
-    'iwyu',
-    'pragma-once',
-    // C#, Dotnet (.NET)
-    'dotnet-format',
-    // CircleCI Config
-    'circleci',
-    // Clojure
-    'clj-kondo',
-    // CoffeeScript
-    'coffeelint',
-    // Commit messages
-    'commitlint',
-    // Copy/paste detection
-    'jscpd',
-    // CSS, SCSS, Sass
-    'stylelint',
-    // CSS, GraphQL, HTML, JavaScript, JSON, JSONC, JSON5, JSX, TSX, Markdown, TypeScript, Vue, YAML
-    'prettier',
-    // Cue
-    'cue-fmt',
-    // Dart
-    'dart',
-    // Dockerfile / Docker
-    'hadolint',
-    // Dotenv
-    'dotenv-linter',
-    // EditorConfig
-    'editorconfig-checker',
-    // GitHub Actions
-    'actionlint',
-    'zizmor',
-    // Go
-    'gofmt',
-    'gofumpt',
-    'goimports',
-    'gokart',
-    'golangci-lint',
-    'golines',
-    // Go, Java, JavaScript, JSON, Python, Ruby, TypeScript, YAML
-    'semgrep',
-    // GoReleaser
-    'goreleaser',
-    // GraphQL
-    'graphql-schema-linter',
-    // Groovy
-    'npm-groovy-lint',
-    // HAML
-    'haml-lint',
-    // HTML
-    'htmlhint',
-    // HTML Templates
-    'djlint',
-    // Java
-    'checkstyle',
-    'google-java-format',
-    // JavaScript, JSON, TypeScript
-    'eslint',
-    // Next.js
-    'next lint',
-    // JavaScript, JSON, Markdown, TypeScript
-    'deno',
-    // JavaScript, TypeScript
-    'rome',
-    // JSON, JSONC, JSON5
-    'eslint-plugin-jsonc',
-    'eslint-plugin-json',
-    // JSX, TSX
-    'eslint-plugin-jsx-a11y',
-    'eslint-plugin-react',
-    // Jupyter Notebook
-    'nbqa',
-    // Kotlin
-    'detekt',
-    'ktlint',
-    // Kubernetes
-    'kubeconform',
-    'kube-linter',
-    // LaTeX
-    'chktex',
-    // Lua
-    'luacheck',
-    'stylua',
-    // Markdown
-    'markdownlint',
-    'markdownlint-cli2',
-    'markdown-link-check',
-    'markdown-table-prettify',
-    'remark-lint',
-    // Natural language / Prose
-    'textlint',
-    'vale',
-    // Nix
-    'nixpkgs-fmt',
-    // OpenAPI
-    'spectral',
-    // package.json
-    'sort-package-json',
-    // Perl
-    'perlcritic',
-    'perltidy',
-    // PHP
-    'php-cs-fixer',
-    'phpcs',
-    'phpstan',
-    'psalm',
-    // PNG
-    'oxipng',
-    // PowerShell
-    'psscriptanalyzer',
-    // Prisma
-    'prisma',
-    // Protocol Buffers (Protobuf)
-    'protolint',
-    'buf',
-    // Python
-    'pylint',
-    'flake8',
-    'isort',
-    'ruff',
-    'black',
-    'autopep8',
-    'bandit',
-    'mypy',
-    'pyright',
-    'sourcery',
-    'yapf',
-    // R
-    'lintr',
-    // Rego
-    'opa',
-    'regal',
-    // Ruby
-    'rubocop',
-    'brakeman',
-    'rufo',
-    'standardrb',
-    // Rust
-    'clippy',
-    'rustfmt',
-    // Scala
-    'scalafmt',
-    // Security, Vulnerabilities
-    'osv-scanner',
-    // Security, Terraform
-    'terrascan',
-    'tfsec',
-    // Snakemake
-    'snakemake --lint',
-    'snakefmt',
-    // SQL
-    'sqlfluff',
-    'sql-formatter',
-    'sqlfmt',
-    'squawk',
-    // SVG
-    'svgo',
-    // Swift
-    'stringslint',
-    'swiftformat',
-    'swiftlint',
-    // Terraform
-    'tflint',
-    'terraform',
-    'tofu',
-    // Terragrunt
-    'terragrunt',
-    // Textproto
-    'txtpbfmt',
-    // TOML
-    'taplo',
-    // Vue
-    'eslint-plugin-vue',
-    // XML
-    'xmllint',
-    // YAML
-    'yamllint',
-];
-//# sourceMappingURL=safe-tools.js.map

package/dist/src/lib/safe-tools.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"safe-tools.js","sourceRoot":"","sources":["../../../src/lib/safe-tools.ts"],"names":[],"mappings":"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","sourcesContent":["export const LINTING_TOOLS: string[] = [\n  // All (general purpose)\n  'codespell',\n  'cspell',\n  'git-diff-check',\n  'gitleaks',\n  'trufflehog',\n\n  // Amazon States Language\n  'asl-validator',\n\n  // Ansible\n  'ansible-lint',\n\n  // Apex, Java\n  'pmd',\n\n  // Astro, CSS, GraphQL, GritQL, HTML, JavaScript, JSON, JSONC, JSON5, JSX, TSX, Svelte, TypeScript, Vue\n  'biome',\n\n  // AWS CloudFormation templates\n  'cfn-lint',\n  'cfnlint',\n\n  // AWS CloudFormation, Azure ARM, Dockerfile, Helm, Kubernetes, Security, Terraform\n  'checkov',\n\n  // AWS CloudFormation, Azure ARM, Dockerfile, Kubernetes, Secrets, Security, Terraform, Vulnerabilities\n  'trivy',\n\n  // Azure Resource Manager (ARM)\n  'test-aztemplate',\n\n  // Bash / Shell\n  'shellcheck',\n  'shfmt',\n\n  // Bazel, Starlark\n  'buildifier',\n\n  // C, C++\n  'cpplint',\n  'clang-format',\n  'clang-tidy',\n  'cmake-format',\n  'iwyu',\n  'pragma-once',\n\n  // C#, Dotnet (.NET)\n  'dotnet-format',\n\n  // CircleCI Config\n  'circleci',\n\n  // Clojure\n  'clj-kondo',\n\n  // CoffeeScript\n  'coffeelint',\n\n  // Commit messages\n  'commitlint',\n\n  // Copy/paste detection\n  'jscpd',\n\n  // CSS, SCSS, Sass\n  'stylelint',\n\n  // CSS, GraphQL, HTML, JavaScript, JSON, JSONC, JSON5, JSX, TSX, Markdown, TypeScript, Vue, YAML\n  'prettier',\n\n  // Cue\n  'cue-fmt',\n\n  // Dart\n  'dart',\n\n  // Dockerfile / Docker\n  'hadolint',\n\n  // Dotenv\n  'dotenv-linter',\n\n  // EditorConfig\n  'editorconfig-checker',\n\n  // GitHub Actions\n  'actionlint',\n  'zizmor',\n\n  // Go\n  'gofmt',\n  'gofumpt',\n  'goimports',\n  'gokart',\n  'golangci-lint',\n  'golines',\n\n  // Go, Java, JavaScript, JSON, Python, Ruby, TypeScript, YAML\n  'semgrep',\n\n  // GoReleaser\n  'goreleaser',\n\n  // GraphQL\n  'graphql-schema-linter',\n\n  // Groovy\n  'npm-groovy-lint',\n\n  // HAML\n  'haml-lint',\n\n  // HTML\n  'htmlhint',\n\n  // HTML Templates\n  'djlint',\n\n  // Java\n  'checkstyle',\n  'google-java-format',\n\n  // JavaScript, JSON, TypeScript\n  'eslint',\n\n  // Next.js\n  'next lint',\n\n  // JavaScript, JSON, Markdown, TypeScript\n  'deno',\n\n  // JavaScript, TypeScript\n  'rome',\n\n  // JSON, JSONC, JSON5\n  'eslint-plugin-jsonc',\n  'eslint-plugin-json',\n\n  // JSX, TSX\n  'eslint-plugin-jsx-a11y',\n  'eslint-plugin-react',\n\n  // Jupyter Notebook\n  'nbqa',\n\n  // Kotlin\n  'detekt',\n  'ktlint',\n\n  // Kubernetes\n  'kubeconform',\n  'kube-linter',\n\n  // LaTeX\n  'chktex',\n\n  // Lua\n  'luacheck',\n  'stylua',\n\n  // Markdown\n  'markdownlint',\n  'markdownlint-cli2',\n  'markdown-link-check',\n  'markdown-table-prettify',\n  'remark-lint',\n\n  // Natural language / Prose\n  'textlint',\n  'vale',\n\n  // Nix\n  'nixpkgs-fmt',\n\n  // OpenAPI\n  'spectral',\n\n  // package.json\n  'sort-package-json',\n\n  // Perl\n  'perlcritic',\n  'perltidy',\n\n  // PHP\n  'php-cs-fixer',\n  'phpcs',\n  'phpstan',\n  'psalm',\n\n  // PNG\n  'oxipng',\n\n  // PowerShell\n  'psscriptanalyzer',\n\n  // Prisma\n  'prisma',\n\n  // Protocol Buffers (Protobuf)\n  'protolint',\n  'buf',\n\n  // Python\n  'pylint',\n  'flake8',\n  'isort',\n  'ruff',\n  'black',\n  'autopep8',\n  'bandit',\n  'mypy',\n  'pyright',\n  'sourcery',\n  'yapf',\n\n  // R\n  'lintr',\n\n  // Rego\n  'opa',\n  'regal',\n\n  // Ruby\n  'rubocop',\n  'brakeman',\n  'rufo',\n  'standardrb',\n\n  // Rust\n  'clippy',\n  'rustfmt',\n\n  // Scala\n  'scalafmt',\n\n  // Security, Vulnerabilities\n  'osv-scanner',\n\n  // Security, Terraform\n  'terrascan',\n  'tfsec',\n\n  // Snakemake\n  'snakemake --lint',\n  'snakefmt',\n\n  // SQL\n  'sqlfluff',\n  'sql-formatter',\n  'sqlfmt',\n  'squawk',\n\n  // SVG\n  'svgo',\n\n  // Swift\n  'stringslint',\n  'swiftformat',\n  'swiftlint',\n\n  // Terraform\n  'tflint',\n  'terraform',\n  'tofu',\n\n  // Terragrunt\n  'terragrunt',\n\n  // Textproto\n  'txtpbfmt',\n\n  // TOML\n  'taplo',\n\n  // Vue\n  'eslint-plugin-vue',\n\n  // XML\n  'xmllint',\n\n  // YAML\n  'yamllint',\n] as const;\n\nexport type LintingTool = (typeof LINTING_TOOLS)[number];\n"]}

package/dist/src/lib/skill-install.d.ts

@@ -1,10 +0,0 @@
-/**
- * Check if command is a PostHog skill installation from MCP.
- * We control the MCP server, so we only need to verify:
- * 1. It installs to .claude/skills/
- * 2. It downloads from our GitHub releases or localhost (dev)
- *
- * Extracted to its own module to avoid a circular dependency
- * between agent-interface.ts and yara-hooks.ts.
- */
-export declare function isSkillInstallCommand(command: string): boolean;

package/dist/src/lib/skill-install.js

@@ -1,23 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isSkillInstallCommand = isSkillInstallCommand;
-/**
- * Check if command is a PostHog skill installation from MCP.
- * We control the MCP server, so we only need to verify:
- * 1. It installs to .claude/skills/
- * 2. It downloads from our GitHub releases or localhost (dev)
- *
- * Extracted to its own module to avoid a circular dependency
- * between agent-interface.ts and yara-hooks.ts.
- */
-function isSkillInstallCommand(command) {
-    if (!command.startsWith('mkdir -p .claude/skills/'))
-        return false;
-    const urlMatch = command.match(/curl -sL ['"]([^'"]+)['"]/);
-    if (!urlMatch)
-        return false;
-    const url = urlMatch[1];
-    return (url.startsWith('https://github.com/PostHog/context-mill/releases/') ||
-        /^http:\/\/localhost:\d+\//.test(url));
-}
-//# sourceMappingURL=skill-install.js.map

package/dist/src/lib/skill-install.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"skill-install.js","sourceRoot":"","sources":["../../../src/lib/skill-install.ts"],"names":[],"mappings":";;AASA,sDAWC;AApBD;;;;;;;;GAQG;AACH,SAAgB,qBAAqB,CAAC,OAAe;IACnD,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,0BAA0B,CAAC;QAAE,OAAO,KAAK,CAAC;IAElE,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC5D,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE5B,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IACxB,OAAO,CACL,GAAG,CAAC,UAAU,CAAC,mDAAmD,CAAC;QACnE,2BAA2B,CAAC,IAAI,CAAC,GAAG,CAAC,CACtC,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Check if command is a PostHog skill installation from MCP.\n * We control the MCP server, so we only need to verify:\n * 1. It installs to .claude/skills/\n * 2. It downloads from our GitHub releases or localhost (dev)\n *\n * Extracted to its own module to avoid a circular dependency\n * between agent-interface.ts and yara-hooks.ts.\n */\nexport function isSkillInstallCommand(command: string): boolean {\n  if (!command.startsWith('mkdir -p .claude/skills/')) return false;\n\n  const urlMatch = command.match(/curl -sL ['\"]([^'\"]+)['\"]/);\n  if (!urlMatch) return false;\n\n  const url = urlMatch[1];\n  return (\n    url.startsWith('https://github.com/PostHog/context-mill/releases/') ||\n    /^http:\\/\\/localhost:\\d+\\//.test(url)\n  );\n}\n"]}

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

@@ -1 +0,0 @@
-export declare const VERSION = "2.9.1";

package/dist/src/lib/version.js

@@ -1,6 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.VERSION = void 0;
-// Auto-generated by scripts/generate-version.js — do not edit
-exports.VERSION = '2.9.1';
-//# sourceMappingURL=version.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../src/lib/version.ts"],"names":[],"mappings":";;;AAAA,8DAA8D;AACjD,QAAA,OAAO,GAAG,OAAO,CAAC","sourcesContent":["// Auto-generated by scripts/generate-version.js — do not edit\nexport const VERSION = '2.9.1';\n"]}

package/dist/src/lib/wizard-session.d.ts

@@ -1,146 +0,0 @@
-/**
- * WizardSession — single source of truth for every decision the wizard needs.
- *
- * Populated in layers:
- *   CLI args / env vars  →  populate fields directly
- *   Auto-detection       →  framework, typescript, package manager
- *   TUI screens          →  region, framework disambiguation, etc.
- *   OAuth                →  credentials
- *
- * Business logic reads from the session. Never calls a prompt.
- */
-import type { Integration } from './constants';
-import type { FrameworkConfig } from './framework-config';
-import type { WizardReadinessResult } from './health-checks/readiness';
-import type { SettingsConflict } from './agent/agent-interface';
-export interface Credentials {
-    accessToken: string;
-    projectApiKey: string;
-    host: string;
-    projectId: number;
-}
-export type CloudRegion = 'us' | 'eu';
-/** Lifecycle phase of the main work (agent run, MCP install, etc.) */
-export declare enum RunPhase {
-    /** Still gathering input (intro, setup screens) */
-    Idle = "idle",
-    /** Main work is in progress */
-    Running = "running",
-    /** Main work finished successfully */
-    Completed = "completed",
-    /** Main work finished with an error */
-    Error = "error"
-}
-/** Features discovered by the feature-discovery subagent */
-export declare enum DiscoveredFeature {
-    Stripe = "stripe",
-    LLM = "llm"
-}
-/** Additional features the agent can integrate after the main setup */
-export declare enum AdditionalFeature {
-    LLM = "llm"
-}
-/** Human-readable labels for additional features (used in TUI progress) */
-export declare const ADDITIONAL_FEATURE_LABELS: Record<AdditionalFeature, string>;
-/** Agent prompts for each additional feature, injected via the stop hook */
-export declare const ADDITIONAL_FEATURE_PROMPTS: Record<AdditionalFeature, string>;
-/** Outcome of the MCP server installation step */
-export declare enum McpOutcome {
-    NoClients = "no_clients",
-    Skipped = "skipped",
-    Installed = "installed",
-    Failed = "failed"
-}
-/** Outcome kind for the outro screen */
-export declare enum OutroKind {
-    Success = "success",
-    Error = "error",
-    Cancel = "cancel"
-}
-export interface OutroData {
-    kind: OutroKind;
-    /** Main headline (green check for Success, red X for Error, etc.) */
-    message?: string;
-    /** Free-form body text shown under the headline. Use \n for paragraph breaks. */
-    body?: string;
-    /** Success-only: bulleted list of "what the agent did" */
-    changes?: string[];
-    docsUrl?: string;
-    continueUrl?: string;
-    /** Report file the agent wrote (e.g. "posthog-setup-report.md") */
-    reportFile?: string;
-}
-export interface WizardSession {
-    debug: boolean;
-    forceInstall: boolean;
-    installDir: string;
-    ci: boolean;
-    signup: boolean;
-    localMcp: boolean;
-    mcpFeatures?: string[];
-    apiKey?: string;
-    email?: string;
-    region?: CloudRegion;
-    menu: boolean;
-    benchmark: boolean;
-    yaraReport: boolean;
-    projectId?: number;
-    setupConfirmed: boolean;
-    integration: Integration | null;
-    frameworkContext: Record<string, unknown>;
-    typescript: boolean;
-    /** Human-readable label for the detected framework variant (e.g., "Django with Wagtail CMS") */
-    detectedFrameworkLabel: string | null;
-    /** True once framework detection has run (whether it found something or not) */
-    detectionComplete: boolean;
-    /** Set when the detected framework version is too old for the wizard */
-    unsupportedVersion: {
-        current: string;
-        minimum: string;
-        docsUrl: string;
-    } | null;
-    credentials: Credentials | null;
-    runPhase: RunPhase;
-    loginUrl: string | null;
-    discoveredFeatures: DiscoveredFeature[];
-    llmOptIn: boolean;
-    mcpComplete: boolean;
-    mcpOutcome: McpOutcome | null;
-    mcpInstalledClients: string[];
-    skillsComplete: boolean;
-    outroDismissed: boolean;
-    readinessResult: WizardReadinessResult | null;
-    outageDismissed: boolean;
-    settingsOverrideKeys: string[] | null;
-    settingsConflicts: SettingsConflict[] | null;
-    portConflictProcess: {
-        command: string;
-        pid: string;
-        user: string;
-    } | null;
-    outroData: OutroData | null;
-    additionalFeatureQueue: AdditionalFeature[];
-    workflowLabel: string | null;
-    skillId: string | null;
-    frameworkConfig: FrameworkConfig | null;
-}
-/**
- * Build a WizardSession from CLI args, pre-populating whatever is known.
- */
-export declare function buildSession(args: {
-    debug?: boolean;
-    forceInstall?: boolean;
-    installDir?: string;
-    ci?: boolean;
-    signup?: boolean;
-    localMcp?: boolean;
-    mcpFeatures?: string[];
-    apiKey?: string;
-    email?: string;
-    region?: CloudRegion;
-    menu?: boolean;
-    integration?: Integration;
-    benchmark?: boolean;
-    yaraReport?: boolean;
-    projectId?: string;
-}): WizardSession;

package/dist/src/lib/wizard-session.js

@@ -1,116 +0,0 @@
-"use strict";
-/**
- * WizardSession — single source of truth for every decision the wizard needs.
- *
- * Populated in layers:
- *   CLI args / env vars  →  populate fields directly
- *   Auto-detection       →  framework, typescript, package manager
- *   TUI screens          →  region, framework disambiguation, etc.
- *   OAuth                →  credentials
- *
- * Business logic reads from the session. Never calls a prompt.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.OutroKind = exports.McpOutcome = exports.ADDITIONAL_FEATURE_PROMPTS = exports.ADDITIONAL_FEATURE_LABELS = exports.AdditionalFeature = exports.DiscoveredFeature = exports.RunPhase = void 0;
-exports.buildSession = buildSession;
-function parseProjectIdArg(value) {
-    if (value === undefined || value === '')
-        return undefined;
-    const n = Number(value);
-    return Number.isInteger(n) && n > 0 ? n : undefined;
-}
-/** Lifecycle phase of the main work (agent run, MCP install, etc.) */
-var RunPhase;
-(function (RunPhase) {
-    /** Still gathering input (intro, setup screens) */
-    RunPhase["Idle"] = "idle";
-    /** Main work is in progress */
-    RunPhase["Running"] = "running";
-    /** Main work finished successfully */
-    RunPhase["Completed"] = "completed";
-    /** Main work finished with an error */
-    RunPhase["Error"] = "error";
-})(RunPhase || (exports.RunPhase = RunPhase = {}));
-/** Features discovered by the feature-discovery subagent */
-var DiscoveredFeature;
-(function (DiscoveredFeature) {
-    DiscoveredFeature["Stripe"] = "stripe";
-    DiscoveredFeature["LLM"] = "llm";
-})(DiscoveredFeature || (exports.DiscoveredFeature = DiscoveredFeature = {}));
-/** Additional features the agent can integrate after the main setup */
-var AdditionalFeature;
-(function (AdditionalFeature) {
-    AdditionalFeature["LLM"] = "llm";
-})(AdditionalFeature || (exports.AdditionalFeature = AdditionalFeature = {}));
-/** Human-readable labels for additional features (used in TUI progress) */
-exports.ADDITIONAL_FEATURE_LABELS = {
-    [AdditionalFeature.LLM]: 'LLM analytics',
-};
-/** Agent prompts for each additional feature, injected via the stop hook */
-exports.ADDITIONAL_FEATURE_PROMPTS = {
-    [AdditionalFeature.LLM]: `Now integrate LLM analytics with PostHog. Use the PostHog MCP server to find the appropriate LLM analytics skill, install it, and follow its workflow. PostHog basics are already installed. Update the setup report markdown file when complete with additions from this task. `,
-};
-/** Outcome of the MCP server installation step */
-var McpOutcome;
-(function (McpOutcome) {
-    McpOutcome["NoClients"] = "no_clients";
-    McpOutcome["Skipped"] = "skipped";
-    McpOutcome["Installed"] = "installed";
-    McpOutcome["Failed"] = "failed";
-})(McpOutcome || (exports.McpOutcome = McpOutcome = {}));
-/** Outcome kind for the outro screen */
-var OutroKind;
-(function (OutroKind) {
-    OutroKind["Success"] = "success";
-    OutroKind["Error"] = "error";
-    OutroKind["Cancel"] = "cancel";
-})(OutroKind || (exports.OutroKind = OutroKind = {}));
-/**
- * Build a WizardSession from CLI args, pre-populating whatever is known.
- */
-function buildSession(args) {
-    return {
-        debug: args.debug ?? false,
-        forceInstall: args.forceInstall ?? false,
-        installDir: args.installDir ?? process.cwd(),
-        ci: args.ci ?? false,
-        signup: args.signup ?? false,
-        localMcp: args.localMcp ?? false,
-        mcpFeatures: args.mcpFeatures,
-        apiKey: args.apiKey,
-        email: args.email,
-        region: args.region,
-        menu: args.menu ?? false,
-        benchmark: args.benchmark ?? false,
-        yaraReport: args.yaraReport ?? false,
-        projectId: parseProjectIdArg(args.projectId),
-        setupConfirmed: false,
-        integration: args.integration ?? null,
-        frameworkContext: {},
-        typescript: false,
-        detectedFrameworkLabel: null,
-        detectionComplete: false,
-        unsupportedVersion: null,
-        runPhase: RunPhase.Idle,
-        discoveredFeatures: [],
-        llmOptIn: false,
-        mcpComplete: false,
-        mcpOutcome: null,
-        mcpInstalledClients: [],
-        skillsComplete: false,
-        outroDismissed: false,
-        loginUrl: null,
-        credentials: null,
-        readinessResult: null,
-        outageDismissed: false,
-        settingsOverrideKeys: null,
-        settingsConflicts: null,
-        portConflictProcess: null,
-        outroData: null,
-        additionalFeatureQueue: [],
-        workflowLabel: null,
-        skillId: null,
-        frameworkConfig: null,
-    };
-}
-//# sourceMappingURL=wizard-session.js.map

package/dist/src/lib/wizard-session.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"wizard-session.js","sourceRoot":"","sources":["../../../src/lib/wizard-session.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * WizardSession — single source of truth for every decision the wizard needs.\n *\n * Populated in layers:\n *   CLI args / env vars  →  populate fields directly\n *   Auto-detection       →  framework, typescript, package manager\n *   TUI screens          →  region, framework disambiguation, etc.\n *   OAuth                →  credentials\n *\n * Business logic reads from the session. Never calls a prompt.\n */\n\nimport type { Integration } from './constants';\nimport type { FrameworkConfig } from './framework-config';\nimport type { WizardReadinessResult } from './health-checks/readiness';\nimport type { SettingsConflict } from './agent/agent-interface';\n\nexport interface Credentials {\n  accessToken: string;\n  projectApiKey: string;\n  host: string;\n  projectId: number;\n}\n\nfunction parseProjectIdArg(value: string | undefined): number | undefined {\n  if (value === undefined || value === '') return undefined;\n  const n = Number(value);\n  return Number.isInteger(n) && n > 0 ? n : undefined;\n}\n\nexport type CloudRegion = 'us' | 'eu';\n\n/** Lifecycle phase of the main work (agent run, MCP install, etc.) */\nexport enum RunPhase {\n  /** Still gathering input (intro, setup screens) */\n  Idle = 'idle',\n  /** Main work is in progress */\n  Running = 'running',\n  /** Main work finished successfully */\n  Completed = 'completed',\n  /** Main work finished with an error */\n  Error = 'error',\n}\n\n/** Features discovered by the feature-discovery subagent */\nexport enum DiscoveredFeature {\n  Stripe = 'stripe',\n  LLM = 'llm',\n}\n\n/** Additional features the agent can integrate after the main setup */\nexport enum AdditionalFeature {\n  LLM = 'llm',\n}\n\n/** Human-readable labels for additional features (used in TUI progress) */\nexport const ADDITIONAL_FEATURE_LABELS: Record<AdditionalFeature, string> = {\n  [AdditionalFeature.LLM]: 'LLM analytics',\n};\n\n/** Agent prompts for each additional feature, injected via the stop hook */\nexport const ADDITIONAL_FEATURE_PROMPTS: Record<AdditionalFeature, string> = {\n  [AdditionalFeature.LLM]: `Now integrate LLM analytics with PostHog. Use the PostHog MCP server to find the appropriate LLM analytics skill, install it, and follow its workflow. PostHog basics are already installed. Update the setup report markdown file when complete with additions from this task. `,\n};\n\n/** Outcome of the MCP server installation step */\nexport enum McpOutcome {\n  NoClients = 'no_clients',\n  Skipped = 'skipped',\n  Installed = 'installed',\n  Failed = 'failed',\n}\n\n/** Outcome kind for the outro screen */\nexport enum OutroKind {\n  Success = 'success',\n  Error = 'error',\n  Cancel = 'cancel',\n}\n\nexport interface OutroData {\n  kind: OutroKind;\n  /** Main headline (green check for Success, red X for Error, etc.) */\n  message?: string;\n  /** Free-form body text shown under the headline. Use \\n for paragraph breaks. */\n  body?: string;\n  /** Success-only: bulleted list of \"what the agent did\" */\n  changes?: string[];\n  docsUrl?: string;\n  continueUrl?: string;\n  /** Report file the agent wrote (e.g. \"posthog-setup-report.md\") */\n  reportFile?: string;\n}\n\nexport interface WizardSession {\n  // From CLI args\n  debug: boolean;\n  forceInstall: boolean;\n  installDir: string;\n  ci: boolean;\n  signup: boolean;\n  localMcp: boolean;\n  mcpFeatures?: string[];\n  apiKey?: string;\n  email?: string;\n  region?: CloudRegion;\n  menu: boolean;\n  benchmark: boolean;\n  yaraReport: boolean;\n  projectId?: number;\n\n  // From detection + screens\n  setupConfirmed: boolean;\n  integration: Integration | null;\n  frameworkContext: Record<string, unknown>;\n  typescript: boolean;\n\n  /** Human-readable label for the detected framework variant (e.g., \"Django with Wagtail CMS\") */\n  detectedFrameworkLabel: string | null;\n\n  /** True once framework detection has run (whether it found something or not) */\n  detectionComplete: boolean;\n\n  /** Set when the detected framework version is too old for the wizard */\n  unsupportedVersion: {\n    current: string;\n    minimum: string;\n    docsUrl: string;\n  } | null;\n\n  // From OAuth\n  credentials: Credentials | null;\n\n  // Lifecycle\n  runPhase: RunPhase;\n  loginUrl: string | null;\n\n  // Feature discovery\n  discoveredFeatures: DiscoveredFeature[];\n  llmOptIn: boolean;\n\n  // Screen completion\n  mcpComplete: boolean;\n  mcpOutcome: McpOutcome | null;\n  mcpInstalledClients: string[];\n  skillsComplete: boolean;\n  outroDismissed: boolean;\n\n  // Runtime\n  readinessResult: WizardReadinessResult | null;\n  outageDismissed: boolean;\n  settingsOverrideKeys: string[] | null;\n  settingsConflicts: SettingsConflict[] | null;\n  portConflictProcess: { command: string; pid: string; user: string } | null;\n  outroData: OutroData | null;\n\n  // Additional features queue (drained via stop hook after main integration)\n  additionalFeatureQueue: AdditionalFeature[];\n\n  // Workflow metadata (set by runWizard in bin.ts)\n  workflowLabel: string | null;\n  skillId: string | null;\n\n  // Resolved framework config (set after integration is known)\n  frameworkConfig: FrameworkConfig | null;\n}\n\n/**\n * Build a WizardSession from CLI args, pre-populating whatever is known.\n */\nexport function buildSession(args: {\n  debug?: boolean;\n  forceInstall?: boolean;\n  installDir?: string;\n  ci?: boolean;\n  signup?: boolean;\n  localMcp?: boolean;\n  mcpFeatures?: string[];\n  apiKey?: string;\n  email?: string;\n  region?: CloudRegion;\n  menu?: boolean;\n  integration?: Integration;\n  benchmark?: boolean;\n  yaraReport?: boolean;\n  projectId?: string;\n}): WizardSession {\n  return {\n    debug: args.debug ?? false,\n    forceInstall: args.forceInstall ?? false,\n    installDir: args.installDir ?? process.cwd(),\n    ci: args.ci ?? false,\n    signup: args.signup ?? false,\n    localMcp: args.localMcp ?? false,\n    mcpFeatures: args.mcpFeatures,\n    apiKey: args.apiKey,\n    email: args.email,\n    region: args.region,\n    menu: args.menu ?? false,\n    benchmark: args.benchmark ?? false,\n    yaraReport: args.yaraReport ?? false,\n    projectId: parseProjectIdArg(args.projectId),\n\n    setupConfirmed: false,\n    integration: args.integration ?? null,\n    frameworkContext: {},\n    typescript: false,\n    detectedFrameworkLabel: null,\n    detectionComplete: false,\n    unsupportedVersion: null,\n\n    runPhase: RunPhase.Idle,\n    discoveredFeatures: [],\n    llmOptIn: false,\n    mcpComplete: false,\n    mcpOutcome: null,\n    mcpInstalledClients: [],\n    skillsComplete: false,\n    outroDismissed: false,\n    loginUrl: null,\n    credentials: null,\n    readinessResult: null,\n    outageDismissed: false,\n    settingsOverrideKeys: null,\n    settingsConflicts: null,\n    portConflictProcess: null,\n    outroData: null,\n    additionalFeatureQueue: [],\n    workflowLabel: null,\n    skillId: null,\n    frameworkConfig: null,\n  };\n}\n"]}

package/dist/src/lib/wizard-tools.d.ts

@@ -1,91 +0,0 @@
-/**
- * Unified in-process MCP server for the PostHog wizard.
- *
- * Provides tools that run locally (secret values never leave the machine):
- * - check_env_keys: Check which env var keys exist in a .env file
- * - set_env_values: Create/update env vars in a .env file
- * - detect_package_manager: Detect the project's package manager(s)
- */
-import type { PackageManagerDetector } from './detection/package-manager';
-export type SkillEntry = {
-    id: string;
-    name: string;
-    downloadUrl: string;
-};
-export interface SkillMenu {
-    categories: Record<string, SkillEntry[]>;
-}
-/**
- * Fetch the skill menu from the skills server.
- * Returns parsed data on success, `null` on failure.
- */
-export declare function fetchSkillMenu(skillsBaseUrl: string): Promise<SkillMenu | null>;
-/**
- * Download and extract a skill.
- * By default installs to `<installDir>/.claude/skills/<id>/`.
- * Pass `skillsRoot` to override the base directory (e.g. `.posthog/skills`).
- */
-export declare function downloadSkill(skillEntry: SkillEntry, installDir: string, skillsRoot?: string): {
-    success: boolean;
-    error?: string;
-};
-/**
- * Structured result for installSkillById.
- * - `ok`: the skill was fetched and extracted; `path` is where it lives
- *   relative to installDir.
- * - `menu-fetch-failed`: couldn't fetch or parse the skill menu.
- * - `skill-not-found`: the menu didn't contain a skill with this id.
- * - `download-failed`: found the skill but download/extract failed;
- *   `message` has the underlying error.
- */
-export type InstallSkillResult = {
-    kind: 'ok';
-    path: string;
-} | {
-    kind: 'menu-fetch-failed';
-} | {
-    kind: 'skill-not-found';
-    skillId: string;
-} | {
-    kind: 'download-failed';
-    message: string;
-};
-/**
- * High-level "install a skill by ID" helper. Fetches the skill menu,
- * finds the skill, downloads and extracts it. Workflows should use this
- * instead of composing fetchSkillMenu + downloadSkill themselves.
- */
-export declare function installSkillById(skillId: string, installDir: string, skillsBaseUrl: string, skillsRoot?: string): Promise<InstallSkillResult>;
-export interface WizardToolsOptions {
-    /** Root directory of the project being analyzed */
-    workingDirectory: string;
-    /** Framework-specific package manager detector */
-    detectPackageManager: PackageManagerDetector;
-    /** Base URL for the skills server (e.g. http://localhost:8765 or GitHub releases URL) */
-    skillsBaseUrl: string;
-}
-/**
- * Resolve filePath relative to workingDirectory, rejecting path traversal.
- */
-export declare function resolveEnvPath(workingDirectory: string, filePath: string): string;
-/**
- * Ensure the given env file basename is covered by .gitignore in the working directory.
- * Creates .gitignore if it doesn't exist; appends the entry if missing.
- */
-export declare function ensureGitignoreCoverage(workingDirectory: string, envFileName: string): void;
-/**
- * Parse a .env file's content and return the set of defined key names.
- */
-export declare function parseEnvKeys(content: string): Set<string>;
-/**
- * Merge key-value pairs into existing .env content.
- * Updates existing keys in-place, appends new keys at the end.
- */
-export declare function mergeEnvValues(content: string, values: Record<string, string>): string;
-/**
- * Create the unified in-process MCP server with all wizard tools.
- * Must be called asynchronously because the SDK is an ESM module loaded via dynamic import.
- */
-export declare function createWizardToolsServer(options: WizardToolsOptions): Promise<any>;
-/** Tool names exposed by the wizard-tools server, for use in allowedTools */
-export declare const WIZARD_TOOL_NAMES: string[];