@posthog/wizard 2.9.0 → 2.10.0

package/dist/src/lib/workflows/__tests__/workflow-registry.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/src/lib/workflows/__tests__/workflow-registry.test.js

@@ -1,32 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const workflow_registry_js_1 = require("../workflow-registry.js");
-describe('WORKFLOW_REGISTRY', () => {
-    it('every entry has unique flowKey, description, and non-empty steps', () => {
-        const flowKeys = workflow_registry_js_1.WORKFLOW_REGISTRY.map((c) => c.flowKey);
-        expect(new Set(flowKeys).size).toBe(flowKeys.length);
-        for (const config of workflow_registry_js_1.WORKFLOW_REGISTRY) {
-            expect(config.description).toBeTruthy();
-            expect(config.steps.length).toBeGreaterThan(0);
-        }
-    });
-});
-describe('getWorkflowConfig', () => {
-    it('finds known configs by flowKey and returns undefined for unknown', () => {
-        expect((0, workflow_registry_js_1.getWorkflowConfig)('posthog-integration')?.flowKey).toBe('posthog-integration');
-        expect((0, workflow_registry_js_1.getWorkflowConfig)('revenue-analytics-setup')?.command).toBe('revenue');
-        expect((0, workflow_registry_js_1.getWorkflowConfig)('nonexistent')).toBeUndefined();
-    });
-});
-describe('getSubcommandWorkflows', () => {
-    it('returns only workflows that have a CLI command', () => {
-        const subcommands = (0, workflow_registry_js_1.getSubcommandWorkflows)();
-        const commands = subcommands.map((c) => c.command);
-        expect(commands).toContain('integrate');
-        expect(commands).toContain('revenue');
-        for (const config of subcommands) {
-            expect(config.command).toBeTruthy();
-        }
-    });
-});
-//# sourceMappingURL=workflow-registry.test.js.map

package/dist/src/lib/workflows/__tests__/workflow-registry.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"workflow-registry.test.js","sourceRoot":"","sources":["../../../../../src/lib/workflows/__tests__/workflow-registry.test.ts"],"names":[],"mappings":";;AAAA,kEAIiC;AAEjC,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,MAAM,QAAQ,GAAG,wCAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACzD,MAAM,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAErD,KAAK,MAAM,MAAM,IAAI,wCAAiB,EAAE,CAAC;YACvC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,UAAU,EAAE,CAAC;YACxC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QACjD,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,MAAM,CAAC,IAAA,wCAAiB,EAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,CAC5D,qBAAqB,CACtB,CAAC;QACF,MAAM,CAAC,IAAA,wCAAiB,EAAC,yBAAyB,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,CAChE,SAAS,CACV,CAAC;QACF,MAAM,CAAC,IAAA,wCAAiB,EAAC,aAAa,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IAC3D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,wBAAwB,EAAE,GAAG,EAAE;IACtC,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,WAAW,GAAG,IAAA,6CAAsB,GAAE,CAAC;QAC7C,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAEnD,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QACxC,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACtC,KAAK,MAAM,MAAM,IAAI,WAAW,EAAE,CAAC;YACjC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,CAAC;QACtC,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import {\n  WORKFLOW_REGISTRY,\n  getWorkflowConfig,\n  getSubcommandWorkflows,\n} from '../workflow-registry.js';\n\ndescribe('WORKFLOW_REGISTRY', () => {\n  it('every entry has unique flowKey, description, and non-empty steps', () => {\n    const flowKeys = WORKFLOW_REGISTRY.map((c) => c.flowKey);\n    expect(new Set(flowKeys).size).toBe(flowKeys.length);\n\n    for (const config of WORKFLOW_REGISTRY) {\n      expect(config.description).toBeTruthy();\n      expect(config.steps.length).toBeGreaterThan(0);\n    }\n  });\n});\n\ndescribe('getWorkflowConfig', () => {\n  it('finds known configs by flowKey and returns undefined for unknown', () => {\n    expect(getWorkflowConfig('posthog-integration')?.flowKey).toBe(\n      'posthog-integration',\n    );\n    expect(getWorkflowConfig('revenue-analytics-setup')?.command).toBe(\n      'revenue',\n    );\n    expect(getWorkflowConfig('nonexistent')).toBeUndefined();\n  });\n});\n\ndescribe('getSubcommandWorkflows', () => {\n  it('returns only workflows that have a CLI command', () => {\n    const subcommands = getSubcommandWorkflows();\n    const commands = subcommands.map((c) => c.command);\n\n    expect(commands).toContain('integrate');\n    expect(commands).toContain('revenue');\n    for (const config of subcommands) {\n      expect(config.command).toBeTruthy();\n    }\n  });\n});\n"]}

package/dist/src/lib/workflows/__tests__/workflow-step.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/src/lib/workflows/__tests__/workflow-step.test.js

@@ -1,54 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const workflow_step_js_1 = require("../workflow-step.js");
-describe('workflowToFlowEntries', () => {
-    it('filters out headless steps and keeps only screen-bearing ones', () => {
-        const workflow = [
-            { id: 'detect', label: 'Detecting' }, // headless
-            { id: 'intro', label: 'Welcome', screen: 'intro' },
-            { id: 'check', label: 'Checking' }, // headless
-            { id: 'run', label: 'Running', screen: 'run' },
-            { id: 'outro', label: 'Outro', screen: 'outro' },
-        ];
-        const entries = (0, workflow_step_js_1.workflowToFlowEntries)(workflow);
-        expect(entries.map((e) => e.screen)).toEqual(['intro', 'run', 'outro']);
-    });
-    it('falls back isComplete to gate, preferring explicit isComplete', () => {
-        const gateFn = jest.fn();
-        const isCompleteFn = jest.fn();
-        const workflow = [
-            { id: 'a', label: 'A', screen: 'a', gate: gateFn },
-            {
-                id: 'b',
-                label: 'B',
-                screen: 'b',
-                isComplete: isCompleteFn,
-                gate: gateFn,
-            },
-            { id: 'c', label: 'C', screen: 'c' },
-        ];
-        const entries = (0, workflow_step_js_1.workflowToFlowEntries)(workflow);
-        expect(entries[0].isComplete).toBe(gateFn); // fallback
-        expect(entries[1].isComplete).toBe(isCompleteFn); // explicit wins
-        expect(entries[2].isComplete).toBeUndefined(); // neither set
-    });
-    it('strips internal step fields — router only sees screen/show/isComplete', () => {
-        const workflow = [
-            {
-                id: 'intro',
-                label: 'Welcome',
-                screen: 'intro',
-                gate: () => true,
-                onInit: jest.fn(),
-                onReady: jest.fn(),
-            },
-        ];
-        const entry = (0, workflow_step_js_1.workflowToFlowEntries)(workflow)[0];
-        expect(entry).not.toHaveProperty('id');
-        expect(entry).not.toHaveProperty('label');
-        expect(entry).not.toHaveProperty('gate');
-        expect(entry).not.toHaveProperty('onInit');
-        expect(entry).not.toHaveProperty('onReady');
-    });
-});
-//# sourceMappingURL=workflow-step.test.js.map

package/dist/src/lib/workflows/__tests__/workflow-step.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"workflow-step.test.js","sourceRoot":"","sources":["../../../../../src/lib/workflows/__tests__/workflow-step.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { workflowToFlowEntries, type WorkflowStep } from '../workflow-step.js';\n\ndescribe('workflowToFlowEntries', () => {\n  it('filters out headless steps and keeps only screen-bearing ones', () => {\n    const workflow: WorkflowStep[] = [\n      { id: 'detect', label: 'Detecting' }, // headless\n      { id: 'intro', label: 'Welcome', screen: 'intro' },\n      { id: 'check', label: 'Checking' }, // headless\n      { id: 'run', label: 'Running', screen: 'run' },\n      { id: 'outro', label: 'Outro', screen: 'outro' },\n    ];\n\n    const entries = workflowToFlowEntries(workflow);\n    expect(entries.map((e) => e.screen)).toEqual(['intro', 'run', 'outro']);\n  });\n\n  it('falls back isComplete to gate, preferring explicit isComplete', () => {\n    const gateFn = jest.fn();\n    const isCompleteFn = jest.fn();\n\n    const workflow: WorkflowStep[] = [\n      { id: 'a', label: 'A', screen: 'a', gate: gateFn },\n      {\n        id: 'b',\n        label: 'B',\n        screen: 'b',\n        isComplete: isCompleteFn,\n        gate: gateFn,\n      },\n      { id: 'c', label: 'C', screen: 'c' },\n    ];\n\n    const entries = workflowToFlowEntries(workflow);\n\n    expect(entries[0].isComplete).toBe(gateFn); // fallback\n    expect(entries[1].isComplete).toBe(isCompleteFn); // explicit wins\n    expect(entries[2].isComplete).toBeUndefined(); // neither set\n  });\n\n  it('strips internal step fields — router only sees screen/show/isComplete', () => {\n    const workflow: WorkflowStep[] = [\n      {\n        id: 'intro',\n        label: 'Welcome',\n        screen: 'intro',\n        gate: () => true,\n        onInit: jest.fn(),\n        onReady: jest.fn(),\n      },\n    ];\n\n    const entry = workflowToFlowEntries(workflow)[0];\n    expect(entry).not.toHaveProperty('id');\n    expect(entry).not.toHaveProperty('label');\n    expect(entry).not.toHaveProperty('gate');\n    expect(entry).not.toHaveProperty('onInit');\n    expect(entry).not.toHaveProperty('onReady');\n  });\n});\n"]}

package/dist/src/lib/workflows/agent-skill/index.d.ts

@@ -1,44 +0,0 @@
-/**
- * Generic agent skill workflow factory.
- *
- * Creates a WorkflowConfig for any context-mill skill. Provide a
- * skill ID and basic UI config — the factory handles the rest.
- *
- * Usage:
- *   createSkillWorkflow({
- *     skillId: 'error-tracking-setup',
- *     command: 'errors',
- *     flowKey: 'error-tracking',
- *     description: 'Set up PostHog error tracking',
- *     integrationLabel: 'error-tracking',
- *     successMessage: 'Error tracking configured!',
- *     reportFile: 'posthog-error-tracking-report.md',
- *     docsUrl: 'https://posthog.com/docs/error-tracking',
- *     spinnerMessage: 'Setting up error tracking...',
- *     estimatedDurationMinutes: 5,
- *   })
- */
-import type { WorkflowConfig } from '../workflow-step.js';
-export interface SkillWorkflowOptions {
-    /** Context-mill skill ID to install */
-    skillId: string;
-    /** CLI subcommand name */
-    command: string;
-    /** Unique flow key — must match a Flow enum entry */
-    flowKey: string;
-    /** CLI description shown in --help */
-    description: string;
-    /** Analytics integration label */
-    integrationLabel: string;
-    /** Custom prompt instruction. Appended after default project prompt. */
-    customPrompt?: string;
-    successMessage: string;
-    reportFile: string;
-    docsUrl: string;
-    spinnerMessage: string;
-    estimatedDurationMinutes: number;
-    /** Other workflow flowKeys that must be satisfied first */
-    requires?: string[];
-}
-export declare function createSkillWorkflow(opts: SkillWorkflowOptions): WorkflowConfig;
-export { AGENT_SKILL_STEPS } from './steps.js';

package/dist/src/lib/workflows/agent-skill/index.js

@@ -1,47 +0,0 @@
-"use strict";
-/**
- * Generic agent skill workflow factory.
- *
- * Creates a WorkflowConfig for any context-mill skill. Provide a
- * skill ID and basic UI config — the factory handles the rest.
- *
- * Usage:
- *   createSkillWorkflow({
- *     skillId: 'error-tracking-setup',
- *     command: 'errors',
- *     flowKey: 'error-tracking',
- *     description: 'Set up PostHog error tracking',
- *     integrationLabel: 'error-tracking',
- *     successMessage: 'Error tracking configured!',
- *     reportFile: 'posthog-error-tracking-report.md',
- *     docsUrl: 'https://posthog.com/docs/error-tracking',
- *     spinnerMessage: 'Setting up error tracking...',
- *     estimatedDurationMinutes: 5,
- *   })
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AGENT_SKILL_STEPS = void 0;
-exports.createSkillWorkflow = createSkillWorkflow;
-const steps_js_1 = require("./steps.js");
-function createSkillWorkflow(opts) {
-    return {
-        command: opts.command,
-        description: opts.description,
-        flowKey: opts.flowKey,
-        steps: steps_js_1.AGENT_SKILL_STEPS,
-        run: {
-            skillId: opts.skillId,
-            integrationLabel: opts.integrationLabel,
-            customPrompt: opts.customPrompt ? () => opts.customPrompt : undefined,
-            successMessage: opts.successMessage,
-            reportFile: opts.reportFile,
-            docsUrl: opts.docsUrl,
-            spinnerMessage: opts.spinnerMessage,
-            estimatedDurationMinutes: opts.estimatedDurationMinutes,
-        },
-        requires: opts.requires,
-    };
-}
-var steps_js_2 = require("./steps.js");
-Object.defineProperty(exports, "AGENT_SKILL_STEPS", { enumerable: true, get: function () { return steps_js_2.AGENT_SKILL_STEPS; } });
-//# sourceMappingURL=index.js.map

package/dist/src/lib/workflows/agent-skill/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/lib/workflows/agent-skill/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;;AA2BH,kDAoBC;AA5CD,yCAA+C;AAwB/C,SAAgB,mBAAmB,CACjC,IAA0B;IAE1B,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,KAAK,EAAE,4BAAiB;QACxB,GAAG,EAAE;YACH,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,YAAa,CAAC,CAAC,CAAC,SAAS;YACtE,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,wBAAwB,EAAE,IAAI,CAAC,wBAAwB;SACxD;QACD,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACxB,CAAC;AACJ,CAAC;AAED,uCAA+C;AAAtC,6GAAA,iBAAiB,OAAA","sourcesContent":["/**\n * Generic agent skill workflow factory.\n *\n * Creates a WorkflowConfig for any context-mill skill. Provide a\n * skill ID and basic UI config — the factory handles the rest.\n *\n * Usage:\n *   createSkillWorkflow({\n *     skillId: 'error-tracking-setup',\n *     command: 'errors',\n *     flowKey: 'error-tracking',\n *     description: 'Set up PostHog error tracking',\n *     integrationLabel: 'error-tracking',\n *     successMessage: 'Error tracking configured!',\n *     reportFile: 'posthog-error-tracking-report.md',\n *     docsUrl: 'https://posthog.com/docs/error-tracking',\n *     spinnerMessage: 'Setting up error tracking...',\n *     estimatedDurationMinutes: 5,\n *   })\n */\n\nimport type { WorkflowConfig } from '../workflow-step.js';\nimport { AGENT_SKILL_STEPS } from './steps.js';\n\nexport interface SkillWorkflowOptions {\n  /** Context-mill skill ID to install */\n  skillId: string;\n  /** CLI subcommand name */\n  command: string;\n  /** Unique flow key — must match a Flow enum entry */\n  flowKey: string;\n  /** CLI description shown in --help */\n  description: string;\n  /** Analytics integration label */\n  integrationLabel: string;\n  /** Custom prompt instruction. Appended after default project prompt. */\n  customPrompt?: string;\n  successMessage: string;\n  reportFile: string;\n  docsUrl: string;\n  spinnerMessage: string;\n  estimatedDurationMinutes: number;\n  /** Other workflow flowKeys that must be satisfied first */\n  requires?: string[];\n}\n\nexport function createSkillWorkflow(\n  opts: SkillWorkflowOptions,\n): WorkflowConfig {\n  return {\n    command: opts.command,\n    description: opts.description,\n    flowKey: opts.flowKey,\n    steps: AGENT_SKILL_STEPS,\n    run: {\n      skillId: opts.skillId,\n      integrationLabel: opts.integrationLabel,\n      customPrompt: opts.customPrompt ? () => opts.customPrompt! : undefined,\n      successMessage: opts.successMessage,\n      reportFile: opts.reportFile,\n      docsUrl: opts.docsUrl,\n      spinnerMessage: opts.spinnerMessage,\n      estimatedDurationMinutes: opts.estimatedDurationMinutes,\n    },\n    requires: opts.requires,\n  };\n}\n\nexport { AGENT_SKILL_STEPS } from './steps.js';\n"]}

package/dist/src/lib/workflows/agent-skill/steps.d.ts

@@ -1,8 +0,0 @@
-/**
- * Generic agent skill step list.
- *
- * Minimal flow: intro → auth → run → outro.
- * No detection, no setup, no MCP, no skills screen.
- */
-import type { Workflow } from '../workflow-step.js';
-export declare const AGENT_SKILL_STEPS: Workflow;

package/dist/src/lib/workflows/agent-skill/steps.js

@@ -1,32 +0,0 @@
-"use strict";
-/**
- * Generic agent skill step list.
- *
- * Minimal flow: intro → auth → run → outro.
- * No detection, no setup, no MCP, no skills screen.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AGENT_SKILL_STEPS = void 0;
-const wizard_session_js_1 = require("../../wizard-session.js");
-exports.AGENT_SKILL_STEPS = [
-    {
-        id: 'auth',
-        label: 'Authentication',
-        screen: 'auth',
-        isComplete: (session) => session.credentials !== null,
-    },
-    {
-        id: 'run',
-        label: 'Running',
-        screen: 'run',
-        isComplete: (session) => session.runPhase === wizard_session_js_1.RunPhase.Completed ||
-            session.runPhase === wizard_session_js_1.RunPhase.Error,
-    },
-    {
-        id: 'outro',
-        label: 'Done',
-        screen: 'outro',
-        isComplete: (session) => session.outroDismissed,
-    },
-];
-//# sourceMappingURL=steps.js.map

package/dist/src/lib/workflows/agent-skill/steps.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"steps.js","sourceRoot":"","sources":["../../../../../src/lib/workflows/agent-skill/steps.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAGH,+DAAmD;AAEtC,QAAA,iBAAiB,GAAa;IACzC;QACE,EAAE,EAAE,MAAM;QACV,KAAK,EAAE,gBAAgB;QACvB,MAAM,EAAE,MAAM;QACd,UAAU,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,KAAK,IAAI;KACtD;IACD;QACE,EAAE,EAAE,KAAK;QACT,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,KAAK;QACb,UAAU,EAAE,CAAC,OAAO,EAAE,EAAE,CACtB,OAAO,CAAC,QAAQ,KAAK,4BAAQ,CAAC,SAAS;YACvC,OAAO,CAAC,QAAQ,KAAK,4BAAQ,CAAC,KAAK;KACtC;IACD;QACE,EAAE,EAAE,OAAO;QACX,KAAK,EAAE,MAAM;QACb,MAAM,EAAE,OAAO;QACf,UAAU,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,cAAc;KAChD;CACF,CAAC","sourcesContent":["/**\n * Generic agent skill step list.\n *\n * Minimal flow: intro → auth → run → outro.\n * No detection, no setup, no MCP, no skills screen.\n */\n\nimport type { Workflow } from '../workflow-step.js';\nimport { RunPhase } from '../../wizard-session.js';\n\nexport const AGENT_SKILL_STEPS: Workflow = [\n  {\n    id: 'auth',\n    label: 'Authentication',\n    screen: 'auth',\n    isComplete: (session) => session.credentials !== null,\n  },\n  {\n    id: 'run',\n    label: 'Running',\n    screen: 'run',\n    isComplete: (session) =>\n      session.runPhase === RunPhase.Completed ||\n      session.runPhase === RunPhase.Error,\n  },\n  {\n    id: 'outro',\n    label: 'Done',\n    screen: 'outro',\n    isComplete: (session) => session.outroDismissed,\n  },\n];\n"]}

package/dist/src/lib/workflows/posthog-integration/detect.d.ts

@@ -1,12 +0,0 @@
-/**
- * Core integration detection step.
- *
- * Runs framework detection, context gathering, version checking,
- * and feature discovery. Writes results to the store via the
- * WorkflowReadyContext so the IntroScreen can display them.
- *
- * This is the same work that bin.ts $0 handler does inline —
- * extracted here so the `integrate` subcommand can reuse it.
- */
-import type { WorkflowReadyContext } from '../workflow-step.js';
-export declare function detectPostHogIntegration(ctx: WorkflowReadyContext): Promise<void>;

package/dist/src/lib/workflows/posthog-integration/detect.js

@@ -1,57 +0,0 @@
-"use strict";
-/**
- * Core integration detection step.
- *
- * Runs framework detection, context gathering, version checking,
- * and feature discovery. Writes results to the store via the
- * WorkflowReadyContext so the IntroScreen can display them.
- *
- * This is the same work that bin.ts $0 handler does inline —
- * extracted here so the `integrate` subcommand can reuse it.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.detectPostHogIntegration = detectPostHogIntegration;
-const registry_js_1 = require("../../registry.js");
-const index_js_1 = require("../../detection/index.js");
-async function detectPostHogIntegration(ctx) {
-    const session = ctx.session;
-    const installDir = session.installDir;
-    const detectedIntegration = await (0, index_js_1.detectFramework)(installDir);
-    if (detectedIntegration) {
-        const config = registry_js_1.FRAMEWORK_REGISTRY[detectedIntegration];
-        const sessionOptions = {
-            installDir,
-            debug: session.debug,
-            forceInstall: session.forceInstall,
-            default: false,
-            signup: session.signup,
-            localMcp: session.localMcp,
-            ci: session.ci,
-            menu: session.menu,
-            benchmark: session.benchmark,
-            yaraReport: session.yaraReport,
-        };
-        // Gather framework-specific context (e.g., router type)
-        const context = await (0, index_js_1.gatherFrameworkContext)(config, sessionOptions);
-        for (const [key, value] of Object.entries(context)) {
-            if (!(key in session.frameworkContext)) {
-                ctx.setFrameworkContext(key, value);
-            }
-        }
-        ctx.setFrameworkConfig(detectedIntegration, config);
-        if (!session.detectedFrameworkLabel) {
-            ctx.setDetectedFramework(config.metadata.name);
-        }
-        // Version check
-        const versionResult = await (0, index_js_1.checkFrameworkVersion)(config, sessionOptions);
-        if (versionResult.supported !== true) {
-            ctx.setUnsupportedVersion(versionResult.supported);
-        }
-    }
-    // Feature discovery
-    for (const feature of (0, index_js_1.discoverFeatures)(installDir)) {
-        ctx.addDiscoveredFeature(feature);
-    }
-    ctx.setDetectionComplete();
-}
-//# sourceMappingURL=detect.js.map

package/dist/src/lib/workflows/posthog-integration/detect.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"detect.js","sourceRoot":"","sources":["../../../../../src/lib/workflows/posthog-integration/detect.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;AAWH,4DAmDC;AA3DD,mDAAuD;AACvD,uDAKkC;AAE3B,KAAK,UAAU,wBAAwB,CAC5C,GAAyB;IAEzB,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;IAC5B,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAEtC,MAAM,mBAAmB,GAAG,MAAM,IAAA,0BAAe,EAAC,UAAU,CAAC,CAAC;IAE9D,IAAI,mBAAmB,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,gCAAkB,CAAC,mBAAmB,CAAC,CAAC;QAEvD,MAAM,cAAc,GAAG;YACrB,UAAU;YACV,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,EAAE,EAAE,OAAO,CAAC,EAAE;YACd,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,UAAU,EAAE,OAAO,CAAC,UAAU;SAC/B,CAAC;QAEF,wDAAwD;QACxD,MAAM,OAAO,GAAG,MAAM,IAAA,iCAAsB,EAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QACrE,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACnD,IAAI,CAAC,CAAC,GAAG,IAAI,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBACvC,GAAG,CAAC,mBAAmB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;QAED,GAAG,CAAC,kBAAkB,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;QAEpD,IAAI,CAAC,OAAO,CAAC,sBAAsB,EAAE,CAAC;YACpC,GAAG,CAAC,oBAAoB,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjD,CAAC;QAED,gBAAgB;QAChB,MAAM,aAAa,GAAG,MAAM,IAAA,gCAAqB,EAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QAC1E,IAAI,aAAa,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;YACrC,GAAG,CAAC,qBAAqB,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,oBAAoB;IACpB,KAAK,MAAM,OAAO,IAAI,IAAA,2BAAgB,EAAC,UAAU,CAAC,EAAE,CAAC;QACnD,GAAG,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAED,GAAG,CAAC,oBAAoB,EAAE,CAAC;AAC7B,CAAC","sourcesContent":["/**\n * Core integration detection step.\n *\n * Runs framework detection, context gathering, version checking,\n * and feature discovery. Writes results to the store via the\n * WorkflowReadyContext so the IntroScreen can display them.\n *\n * This is the same work that bin.ts $0 handler does inline —\n * extracted here so the `integrate` subcommand can reuse it.\n */\n\nimport type { WorkflowReadyContext } from '../workflow-step.js';\nimport { FRAMEWORK_REGISTRY } from '../../registry.js';\nimport {\n  detectFramework,\n  discoverFeatures,\n  gatherFrameworkContext,\n  checkFrameworkVersion,\n} from '../../detection/index.js';\n\nexport async function detectPostHogIntegration(\n  ctx: WorkflowReadyContext,\n): Promise<void> {\n  const session = ctx.session;\n  const installDir = session.installDir;\n\n  const detectedIntegration = await detectFramework(installDir);\n\n  if (detectedIntegration) {\n    const config = FRAMEWORK_REGISTRY[detectedIntegration];\n\n    const sessionOptions = {\n      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      yaraReport: session.yaraReport,\n    };\n\n    // Gather framework-specific context (e.g., router type)\n    const context = await gatherFrameworkContext(config, sessionOptions);\n    for (const [key, value] of Object.entries(context)) {\n      if (!(key in session.frameworkContext)) {\n        ctx.setFrameworkContext(key, value);\n      }\n    }\n\n    ctx.setFrameworkConfig(detectedIntegration, config);\n\n    if (!session.detectedFrameworkLabel) {\n      ctx.setDetectedFramework(config.metadata.name);\n    }\n\n    // Version check\n    const versionResult = await checkFrameworkVersion(config, sessionOptions);\n    if (versionResult.supported !== true) {\n      ctx.setUnsupportedVersion(versionResult.supported);\n    }\n  }\n\n  // Feature discovery\n  for (const feature of discoverFeatures(installDir)) {\n    ctx.addDiscoveredFeature(feature);\n  }\n\n  ctx.setDetectionComplete();\n}\n"]}

package/dist/src/lib/workflows/posthog-integration/index.d.ts

@@ -1,3 +0,0 @@
-import type { WorkflowConfig } from '../workflow-step.js';
-export declare const posthogIntegrationConfig: WorkflowConfig;
-export { POSTHOG_INTEGRATION_WORKFLOW } from './steps.js';

package/dist/src/lib/workflows/posthog-integration/index.js

@@ -1,152 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.POSTHOG_INTEGRATION_WORKFLOW = exports.posthogIntegrationConfig = void 0;
-const wizard_session_js_1 = require("../../wizard-session.js");
-const agent_interface_js_1 = require("../../agent/agent-interface.js");
-const framework_config_js_1 = require("../../framework-config.js");
-const setup_utils_js_1 = require("../../../utils/setup-utils.js");
-const analytics_js_1 = require("../../../utils/analytics.js");
-const constants_js_1 = require("../../constants.js");
-const index_js_1 = require("../../../ui/index.js");
-const urls_js_1 = require("../../../utils/urls.js");
-const steps_js_1 = require("./steps.js");
-exports.posthogIntegrationConfig = {
-    command: 'integrate',
-    description: 'Set up PostHog SDK integration',
-    flowKey: 'posthog-integration',
-    steps: steps_js_1.POSTHOG_INTEGRATION_WORKFLOW,
-    run: async (session) => {
-        const config = session.frameworkConfig;
-        const typeScriptDetected = (0, setup_utils_js_1.isUsingTypeScript)({
-            installDir: session.installDir,
-        });
-        session.typescript = typeScriptDetected;
-        // Read package.json and resolve framework version
-        const usesPackageJson = config.detection.usesPackageJson !== false;
-        let frameworkVersion;
-        if (usesPackageJson) {
-            const packageJson = await (0, setup_utils_js_1.tryGetPackageJson)({
-                installDir: session.installDir,
-            });
-            if (packageJson) {
-                const { hasPackageInstalled } = await import('../../../utils/package-json.js');
-                if (!hasPackageInstalled(config.detection.packageName, packageJson)) {
-                    (0, index_js_1.getUI)().log.warn(`${config.detection.packageDisplayName} does not seem to be installed. Continuing anyway — the agent will handle it.`);
-                }
-                frameworkVersion = config.detection.getVersion(packageJson);
-            }
-            else {
-                (0, index_js_1.getUI)().log.warn('Could not find package.json. Continuing anyway — the agent will handle it.');
-            }
-        }
-        else {
-            frameworkVersion = config.detection.getVersion(null);
-        }
-        // Analytics tags
-        if (frameworkVersion && config.detection.getVersionBucket) {
-            const versionBucket = config.detection.getVersionBucket(frameworkVersion);
-            analytics_js_1.analytics.setTag(`${config.metadata.integration}-version`, versionBucket);
-        }
-        const frameworkContext = session.frameworkContext;
-        const contextTags = config.analytics.getTags(frameworkContext);
-        Object.entries(contextTags).forEach(([key, value]) => {
-            analytics_js_1.analytics.setTag(key, value);
-        });
-        return {
-            integrationLabel: config.metadata.integration,
-            additionalMcpServers: config.metadata.additionalMcpServers,
-            detectPackageManager: config.detection.detectPackageManager,
-            spinnerMessage: framework_config_js_1.SPINNER_MESSAGE,
-            successMessage: config.ui.successMessage,
-            estimatedDurationMinutes: config.ui.estimatedDurationMinutes,
-            reportFile: 'posthog-setup-report.md',
-            docsUrl: config.metadata.docsUrl,
-            errorMessage: 'Integration failed',
-            additionalFeatureQueue: session.additionalFeatureQueue,
-            customPrompt: (ctx) => {
-                const additionalLines = config.prompts.getAdditionalContextLines
-                    ? config.prompts.getAdditionalContextLines(frameworkContext)
-                    : [];
-                const additionalContext = additionalLines.length > 0
-                    ? '\n' + additionalLines.map((line) => `- ${line}`).join('\n')
-                    : '';
-                return `You have access to the PostHog MCP server which provides skills to integrate PostHog into this ${config.metadata.name} project.
-
-Project context:
-- PostHog Project ID: ${ctx.projectId}
-- Framework: ${config.metadata.name} ${frameworkVersion || 'latest'}
-- TypeScript: ${typeScriptDetected ? 'Yes' : 'No'}
-- PostHog public token: ${ctx.projectApiKey}
-- PostHog Host: ${ctx.host}
-- Project type: ${config.prompts.projectTypeDetection}
-- Package installation: ${config.prompts.packageInstallation ?? framework_config_js_1.DEFAULT_PACKAGE_INSTALLATION}${additionalContext}
-
-Instructions (follow these steps IN ORDER - do not skip or reorder):
-
-STEP 1: Call load_skill_menu (from the wizard-tools MCP server) to see available skills.
-   If the tool fails, emit: ${agent_interface_js_1.AgentSignals.ERROR_MCP_MISSING} Could not load skill menu and halt.
-
-   Choose a skill from the \`integration\` category that matches this project's framework. Do NOT pick skills from other categories (llm-analytics, error-tracking, feature-flags, omnibus, etc.) — those are handled separately.
-   If no suitable integration skill is found, emit: ${agent_interface_js_1.AgentSignals.ERROR_RESOURCE_MISSING} Could not find a suitable skill for this project.
-
-STEP 2: Call install_skill (from the wizard-tools MCP server) with the chosen skill ID (e.g., "integration-nextjs-app-router").
-   Do NOT run any shell commands to install skills.
-
-STEP 3: Load the installed skill's SKILL.md file to understand what references are available.
-
-STEP 4: Follow the skill's workflow files in sequence. Look for numbered workflow files in the references (e.g., files with patterns like "1.0-", "1.1-", "1.2-"). Start with the first one and proceed through each step until completion. Each workflow file will tell you what to do and which file comes next. Never directly write PostHog tokens directly to code files; always use environment variables.
-
-STEP 5: Set up environment variables for PostHog using the wizard-tools MCP server (this runs locally — secret values never leave the machine):
-   - Use check_env_keys to see which keys already exist in the project's .env file (e.g. .env.local or .env).
-   - Use set_env_values to create or update the PostHog public token and host, using the appropriate environment variable naming convention for ${config.metadata.name}, which you'll find in example code. The tool will also ensure .gitignore coverage. Don't assume the presence of keys means the value is up to date. Write the correct value each time.
-   - Reference these environment variables in the code files you create instead of hardcoding the public token and host.
-
-Important: Use the detect_package_manager tool (from the wizard-tools MCP server) to determine which package manager the project uses. Do not manually search for lockfiles or config files. Always install packages as a background task. Don't await completion; proceed with other work immediately after starting the installation. You must read a file immediately before attempting to write it, even if you have previously read it; failure to do so will cause a tool failure.
-
-
-`;
-            },
-            postRun: async (sess, credentials) => {
-                const envVars = config.environment.getEnvVars(credentials.projectApiKey, credentials.host);
-                if (config.environment.uploadToHosting) {
-                    const { uploadEnvironmentVariablesStep } = await import('../../../steps/index.js');
-                    const uploadedEnvVars = await uploadEnvironmentVariablesStep(envVars, {
-                        integration: config.metadata.integration,
-                        session: sess,
-                    });
-                    if (uploadedEnvVars.length > 0) {
-                        analytics_js_1.analytics.capture(constants_js_1.WIZARD_INTERACTION_EVENT_NAME, {
-                            action: 'wizard_env_vars_uploaded',
-                            integration: config.metadata.integration,
-                            variable_count: uploadedEnvVars.length,
-                            variable_keys: uploadedEnvVars,
-                        });
-                    }
-                }
-            },
-            buildOutroData: (sess, credentials, cloudRegion) => {
-                const envVars = config.environment.getEnvVars(credentials.projectApiKey, credentials.host);
-                const continueUrl = sess.signup && cloudRegion
-                    ? `${(0, urls_js_1.getCloudUrlFromRegion)(cloudRegion)}/products?source=wizard`
-                    : undefined;
-                const changes = [
-                    ...config.ui.getOutroChanges(frameworkContext),
-                    Object.keys(envVars).length > 0
-                        ? 'Added environment variables to .env file'
-                        : '',
-                ].filter(Boolean);
-                return {
-                    kind: wizard_session_js_1.OutroKind.Success,
-                    message: 'Successfully installed PostHog!',
-                    reportFile: 'posthog-setup-report.md',
-                    changes,
-                    docsUrl: config.metadata.docsUrl,
-                    continueUrl,
-                };
-            },
-        };
-    },
-};
-var steps_js_2 = require("./steps.js");
-Object.defineProperty(exports, "POSTHOG_INTEGRATION_WORKFLOW", { enumerable: true, get: function () { return steps_js_2.POSTHOG_INTEGRATION_WORKFLOW; } });
-//# sourceMappingURL=index.js.map

package/dist/src/lib/workflows/posthog-integration/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/lib/workflows/posthog-integration/index.ts"],"names":[],"mappings":"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","sourcesContent":["import type { WorkflowConfig } from '../workflow-step.js';\nimport type { WorkflowRun } from '../../agent/agent-runner.js';\nimport type { WizardSession } from '../../wizard-session.js';\nimport { OutroKind } from '../../wizard-session.js';\nimport { AgentSignals } from '../../agent/agent-interface.js';\nimport {\n  DEFAULT_PACKAGE_INSTALLATION,\n  SPINNER_MESSAGE,\n} from '../../framework-config.js';\nimport {\n  tryGetPackageJson,\n  isUsingTypeScript,\n} from '../../../utils/setup-utils.js';\nimport { analytics } from '../../../utils/analytics.js';\nimport { WIZARD_INTERACTION_EVENT_NAME } from '../../constants.js';\nimport { getUI } from '../../../ui/index.js';\nimport { getCloudUrlFromRegion } from '../../../utils/urls.js';\nimport { POSTHOG_INTEGRATION_WORKFLOW } from './steps.js';\n\nexport const posthogIntegrationConfig: WorkflowConfig = {\n  command: 'integrate',\n  description: 'Set up PostHog SDK integration',\n  flowKey: 'posthog-integration',\n  steps: POSTHOG_INTEGRATION_WORKFLOW,\n\n  run: async (session: WizardSession): Promise<WorkflowRun> => {\n    const config = session.frameworkConfig!;\n\n    const typeScriptDetected = isUsingTypeScript({\n      installDir: session.installDir,\n    });\n    session.typescript = typeScriptDetected;\n\n    // Read package.json and resolve framework version\n    const usesPackageJson = config.detection.usesPackageJson !== false;\n    let frameworkVersion: string | undefined;\n\n    if (usesPackageJson) {\n      const packageJson = await tryGetPackageJson({\n        installDir: session.installDir,\n      });\n      if (packageJson) {\n        const { hasPackageInstalled } = await import(\n          '../../../utils/package-json.js'\n        );\n        if (!hasPackageInstalled(config.detection.packageName, packageJson)) {\n          getUI().log.warn(\n            `${config.detection.packageDisplayName} does not seem to be installed. Continuing anyway — the agent will handle it.`,\n          );\n        }\n        frameworkVersion = config.detection.getVersion(packageJson);\n      } else {\n        getUI().log.warn(\n          'Could not find package.json. Continuing anyway — the agent will handle it.',\n        );\n      }\n    } else {\n      frameworkVersion = config.detection.getVersion(null);\n    }\n\n    // Analytics tags\n    if (frameworkVersion && config.detection.getVersionBucket) {\n      const versionBucket = config.detection.getVersionBucket(frameworkVersion);\n      analytics.setTag(`${config.metadata.integration}-version`, versionBucket);\n    }\n    const frameworkContext = session.frameworkContext;\n    const contextTags = config.analytics.getTags(frameworkContext);\n    Object.entries(contextTags).forEach(([key, value]) => {\n      analytics.setTag(key, value);\n    });\n\n    return {\n      integrationLabel: config.metadata.integration,\n      additionalMcpServers: config.metadata.additionalMcpServers,\n      detectPackageManager: config.detection.detectPackageManager,\n      spinnerMessage: SPINNER_MESSAGE,\n      successMessage: config.ui.successMessage,\n      estimatedDurationMinutes: config.ui.estimatedDurationMinutes,\n      reportFile: 'posthog-setup-report.md',\n      docsUrl: config.metadata.docsUrl,\n      errorMessage: 'Integration failed',\n      additionalFeatureQueue: session.additionalFeatureQueue,\n\n      customPrompt: (ctx) => {\n        const additionalLines = config.prompts.getAdditionalContextLines\n          ? config.prompts.getAdditionalContextLines(frameworkContext)\n          : [];\n        const additionalContext =\n          additionalLines.length > 0\n            ? '\\n' + additionalLines.map((line) => `- ${line}`).join('\\n')\n            : '';\n\n        return `You have access to the PostHog MCP server which provides skills to integrate PostHog into this ${\n          config.metadata.name\n        } project.\n\nProject context:\n- PostHog Project ID: ${ctx.projectId}\n- Framework: ${config.metadata.name} ${frameworkVersion || 'latest'}\n- TypeScript: ${typeScriptDetected ? 'Yes' : 'No'}\n- PostHog public token: ${ctx.projectApiKey}\n- PostHog Host: ${ctx.host}\n- Project type: ${config.prompts.projectTypeDetection}\n- Package installation: ${\n          config.prompts.packageInstallation ?? DEFAULT_PACKAGE_INSTALLATION\n        }${additionalContext}\n\nInstructions (follow these steps IN ORDER - do not skip or reorder):\n\nSTEP 1: Call load_skill_menu (from the wizard-tools MCP server) to see available skills.\n   If the tool fails, emit: ${\n     AgentSignals.ERROR_MCP_MISSING\n   } Could not load skill menu and halt.\n\n   Choose a skill from the \\`integration\\` category that matches this project's framework. Do NOT pick skills from other categories (llm-analytics, error-tracking, feature-flags, omnibus, etc.) — those are handled separately.\n   If no suitable integration skill is found, emit: ${\n     AgentSignals.ERROR_RESOURCE_MISSING\n   } Could not find a suitable skill for this project.\n\nSTEP 2: Call install_skill (from the wizard-tools MCP server) with the chosen skill ID (e.g., \"integration-nextjs-app-router\").\n   Do NOT run any shell commands to install skills.\n\nSTEP 3: Load the installed skill's SKILL.md file to understand what references are available.\n\nSTEP 4: Follow the skill's workflow files in sequence. Look for numbered workflow files in the references (e.g., files with patterns like \"1.0-\", \"1.1-\", \"1.2-\"). Start with the first one and proceed through each step until completion. Each workflow file will tell you what to do and which file comes next. Never directly write PostHog tokens directly to code files; always use environment variables.\n\nSTEP 5: Set up environment variables for PostHog using the wizard-tools MCP server (this runs locally — secret values never leave the machine):\n   - Use check_env_keys to see which keys already exist in the project's .env file (e.g. .env.local or .env).\n   - Use set_env_values to create or update the PostHog public token and host, using the appropriate environment variable naming convention for ${\n     config.metadata.name\n   }, which you'll find in example code. The tool will also ensure .gitignore coverage. Don't assume the presence of keys means the value is up to date. Write the correct value each time.\n   - Reference these environment variables in the code files you create instead of hardcoding the public token and host.\n\nImportant: Use the detect_package_manager tool (from the wizard-tools MCP server) to determine which package manager the project uses. Do not manually search for lockfiles or config files. Always install packages as a background task. Don't await completion; proceed with other work immediately after starting the installation. You must read a file immediately before attempting to write it, even if you have previously read it; failure to do so will cause a tool failure.\n\n\n`;\n      },\n\n      postRun: async (sess, credentials) => {\n        const envVars = config.environment.getEnvVars(\n          credentials.projectApiKey,\n          credentials.host,\n        );\n        if (config.environment.uploadToHosting) {\n          const { uploadEnvironmentVariablesStep } = await import(\n            '../../../steps/index.js'\n          );\n          const uploadedEnvVars = await uploadEnvironmentVariablesStep(\n            envVars,\n            {\n              integration: config.metadata.integration,\n              session: sess,\n            },\n          );\n          if (uploadedEnvVars.length > 0) {\n            analytics.capture(WIZARD_INTERACTION_EVENT_NAME, {\n              action: 'wizard_env_vars_uploaded',\n              integration: config.metadata.integration,\n              variable_count: uploadedEnvVars.length,\n              variable_keys: uploadedEnvVars,\n            });\n          }\n        }\n      },\n\n      buildOutroData: (sess, credentials, cloudRegion) => {\n        const envVars = config.environment.getEnvVars(\n          credentials.projectApiKey,\n          credentials.host,\n        );\n        const continueUrl =\n          sess.signup && cloudRegion\n            ? `${getCloudUrlFromRegion(cloudRegion)}/products?source=wizard`\n            : undefined;\n\n        const changes = [\n          ...config.ui.getOutroChanges(frameworkContext),\n          Object.keys(envVars).length > 0\n            ? 'Added environment variables to .env file'\n            : '',\n        ].filter(Boolean);\n\n        return {\n          kind: OutroKind.Success as const,\n          message: 'Successfully installed PostHog!',\n          reportFile: 'posthog-setup-report.md',\n          changes,\n          docsUrl: config.metadata.docsUrl,\n          continueUrl,\n        };\n      },\n    };\n  },\n};\n\nexport { POSTHOG_INTEGRATION_WORKFLOW } from './steps.js';\n"]}

package/dist/src/lib/workflows/posthog-integration/steps.d.ts

@@ -1,9 +0,0 @@
-/**
- * PostHog integration workflow — the default wizard flow.
- *
- * Steps define their own gate predicates and onInit callbacks.
- * The store derives gate promises and fires init work from these
- * definitions — no hardcoded per-flow logic in the store.
- */
-import type { Workflow } from '../workflow-step.js';
-export declare const POSTHOG_INTEGRATION_WORKFLOW: Workflow;