@posthog/wizard 1.15.0 → 1.16.1

package/dist/src/__tests__/run.test.js

@@ -5,6 +5,7 @@ const nextjs_wizard_1 = require("../nextjs/nextjs-wizard");
 const analytics_1 = require("../utils/analytics");
 const constants_1 = require("../lib/constants");
 jest.mock('../nextjs/nextjs-wizard');
+jest.mock('../nextjs/nextjs-wizard-agent');
 jest.mock('../utils/analytics');
 jest.mock('../utils/clack');
 const mockRunNextjsWizard = nextjs_wizard_1.runNextjsWizard;

package/dist/src/__tests__/run.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"run.test.js","sourceRoot":"","sources":["../../../src/__tests__/run.test.ts"],"names":[],"mappings":";;AAAA,gCAAmC;AACnC,2DAA0D;AAC1D,kDAA+C;AAC/C,gDAA+C;AAE/C,IAAI,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;AACrC,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;AAChC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;AAE5B,MAAM,mBAAmB,GAAG,+BAE3B,CAAC;AACF,MAAM,aAAa,GAAG,qBAA0C,CAAC;AAEjE,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,UAAU,CAAC,GAAG,EAAE;QACd,IAAI,CAAC,aAAa,EAAE,CAAC;QAErB,aAAa,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QACjC,aAAa,CAAC,gBAAgB,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QAC3C,aAAa,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAEhE,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE;YAClD,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,eAAe,EAAE,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;QAC/E,MAAM,SAAS,GAAG,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;QAC7C,MAAM,QAAQ,GAAG;YACf,WAAW,EAAE,uBAAW,CAAC,MAAM;YAC/B,KAAK,EAAE,IAAI;YACX,YAAY,EAAE,KAAK;SACpB,CAAC;QAEF,mBAAmB,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAEjD,MAAM,MAAM,CAAC,IAAA,eAAS,EAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;QAEzE,MAAM,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC,oBAAoB,CAAC,SAAS,EAAE;YACrE,WAAW,EAAE,uBAAW,CAAC,MAAM;YAC/B,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;SACpC,CAAC,CAAC;QAEH,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,QAAQ,GAAG,EAAE,WAAW,EAAE,uBAAW,CAAC,MAAM,EAAE,CAAC;QAErD,mBAAmB,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAEjD,MAAM,IAAA,eAAS,EAAC,QAAQ,CAAC,CAAC;QAE1B,MAAM,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QAC9D,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IACxD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { runWizard } from '../run';\nimport { runNextjsWizard } from '../nextjs/nextjs-wizard';\nimport { analytics } from '../utils/analytics';\nimport { Integration } from '../lib/constants';\n\njest.mock('../nextjs/nextjs-wizard');\njest.mock('../utils/analytics');\njest.mock('../utils/clack');\n\nconst mockRunNextjsWizard = runNextjsWizard as jest.MockedFunction<\n  typeof runNextjsWizard\n>;\nconst mockAnalytics = analytics as jest.Mocked<typeof analytics>;\n\ndescribe('runWizard error handling', () => {\n  beforeEach(() => {\n    jest.clearAllMocks();\n\n    mockAnalytics.setTag = jest.fn();\n    mockAnalytics.captureException = jest.fn();\n    mockAnalytics.shutdown = jest.fn().mockResolvedValue(undefined);\n\n    jest.spyOn(process, 'exit').mockImplementation(() => {\n      throw new Error('process.exit called');\n    });\n  });\n\n  afterEach(() => {\n    jest.restoreAllMocks();\n  });\n\n  it('should capture exception and shutdown analytics on wizard error', async () => {\n    const testError = new Error('Wizard failed');\n    const testArgs = {\n      integration: Integration.nextjs,\n      debug: true,\n      forceInstall: false,\n    };\n\n    mockRunNextjsWizard.mockRejectedValue(testError);\n\n    await expect(runWizard(testArgs)).rejects.toThrow('process.exit called');\n\n    expect(mockAnalytics.captureException).toHaveBeenCalledWith(testError, {\n      integration: Integration.nextjs,\n      arguments: JSON.stringify(testArgs),\n    });\n\n    expect(mockAnalytics.shutdown).toHaveBeenCalledWith('error');\n  });\n\n  it('should not call captureException when wizard succeeds', async () => {\n    const testArgs = { integration: Integration.nextjs };\n\n    mockRunNextjsWizard.mockResolvedValue(undefined);\n\n    await runWizard(testArgs);\n\n    expect(mockAnalytics.captureException).not.toHaveBeenCalled();\n    expect(mockAnalytics.shutdown).not.toHaveBeenCalled();\n  });\n});\n"]}
+{"version":3,"file":"run.test.js","sourceRoot":"","sources":["../../../src/__tests__/run.test.ts"],"names":[],"mappings":";;AAAA,gCAAmC;AACnC,2DAA0D;AAC1D,kDAA+C;AAC/C,gDAA+C;AAE/C,IAAI,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;AACrC,IAAI,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;AAC3C,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;AAChC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;AAE5B,MAAM,mBAAmB,GAAG,+BAE3B,CAAC;AACF,MAAM,aAAa,GAAG,qBAA0C,CAAC;AAEjE,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,UAAU,CAAC,GAAG,EAAE;QACd,IAAI,CAAC,aAAa,EAAE,CAAC;QAErB,aAAa,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QACjC,aAAa,CAAC,gBAAgB,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC;QAC3C,aAAa,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAEhE,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE;YAClD,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,eAAe,EAAE,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;QAC/E,MAAM,SAAS,GAAG,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;QAC7C,MAAM,QAAQ,GAAG;YACf,WAAW,EAAE,uBAAW,CAAC,MAAM;YAC/B,KAAK,EAAE,IAAI;YACX,YAAY,EAAE,KAAK;SACpB,CAAC;QAEF,mBAAmB,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAEjD,MAAM,MAAM,CAAC,IAAA,eAAS,EAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAC;QAEzE,MAAM,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC,oBAAoB,CAAC,SAAS,EAAE;YACrE,WAAW,EAAE,uBAAW,CAAC,MAAM;YAC/B,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;SACpC,CAAC,CAAC;QAEH,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,QAAQ,GAAG,EAAE,WAAW,EAAE,uBAAW,CAAC,MAAM,EAAE,CAAC;QAErD,mBAAmB,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAEjD,MAAM,IAAA,eAAS,EAAC,QAAQ,CAAC,CAAC;QAE1B,MAAM,CAAC,aAAa,CAAC,gBAAgB,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QAC9D,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IACxD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC","sourcesContent":["import { runWizard } from '../run';\nimport { runNextjsWizard } from '../nextjs/nextjs-wizard';\nimport { analytics } from '../utils/analytics';\nimport { Integration } from '../lib/constants';\n\njest.mock('../nextjs/nextjs-wizard');\njest.mock('../nextjs/nextjs-wizard-agent');\njest.mock('../utils/analytics');\njest.mock('../utils/clack');\n\nconst mockRunNextjsWizard = runNextjsWizard as jest.MockedFunction<\n  typeof runNextjsWizard\n>;\nconst mockAnalytics = analytics as jest.Mocked<typeof analytics>;\n\ndescribe('runWizard error handling', () => {\n  beforeEach(() => {\n    jest.clearAllMocks();\n\n    mockAnalytics.setTag = jest.fn();\n    mockAnalytics.captureException = jest.fn();\n    mockAnalytics.shutdown = jest.fn().mockResolvedValue(undefined);\n\n    jest.spyOn(process, 'exit').mockImplementation(() => {\n      throw new Error('process.exit called');\n    });\n  });\n\n  afterEach(() => {\n    jest.restoreAllMocks();\n  });\n\n  it('should capture exception and shutdown analytics on wizard error', async () => {\n    const testError = new Error('Wizard failed');\n    const testArgs = {\n      integration: Integration.nextjs,\n      debug: true,\n      forceInstall: false,\n    };\n\n    mockRunNextjsWizard.mockRejectedValue(testError);\n\n    await expect(runWizard(testArgs)).rejects.toThrow('process.exit called');\n\n    expect(mockAnalytics.captureException).toHaveBeenCalledWith(testError, {\n      integration: Integration.nextjs,\n      arguments: JSON.stringify(testArgs),\n    });\n\n    expect(mockAnalytics.shutdown).toHaveBeenCalledWith('error');\n  });\n\n  it('should not call captureException when wizard succeeds', async () => {\n    const testArgs = { integration: Integration.nextjs };\n\n    mockRunNextjsWizard.mockResolvedValue(undefined);\n\n    await runWizard(testArgs);\n\n    expect(mockAnalytics.captureException).not.toHaveBeenCalled();\n    expect(mockAnalytics.shutdown).not.toHaveBeenCalled();\n  });\n});\n"]}

package/dist/src/lib/agent-interface.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Shared agent interface for PostHog wizards
+ * Provides common agent initialization and event handling
+ */
+import { Agent } from '@posthog/agent';
+import clack from '../utils/clack';
+import type { WizardOptions } from '../utils/types';
+export type AgentConfig = {
+    workingDirectory: string;
+    posthogMcpUrl: string;
+    posthogApiKey: string;
+    debug?: boolean;
+};
+/**
+ * Initialize a PostHog Agent instance with the provided configuration
+ */
+export declare function initializeAgent(config: AgentConfig, options: WizardOptions, spinner: ReturnType<typeof clack.spinner>): Agent;
+/**
+ * Execute an agent with the provided prompt and options
+ * Handles the full lifecycle: spinner, execution, error handling
+ */
+export declare function runAgent(agent: Agent, prompt: string, options: WizardOptions, spinner: ReturnType<typeof clack.spinner>, config?: {
+    estimatedDurationMinutes?: number;
+    spinnerMessage?: string;
+    successMessage?: string;
+    errorMessage?: string;
+}): Promise<void>;

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

@@ -0,0 +1,161 @@
+"use strict";
+/**
+ * Shared agent interface for PostHog wizards
+ * Provides common agent initialization and event handling
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initializeAgent = initializeAgent;
+exports.runAgent = runAgent;
+// @ts-ignore - posthog-agent is ESM, wizard is CommonJS. Works at runtime via local link.
+const agent_1 = require("@posthog/agent");
+const clack_1 = __importDefault(require("../utils/clack"));
+const debug_1 = require("../utils/debug");
+const analytics_1 = require("../utils/analytics");
+const constants_1 = require("./constants");
+// TODO: Remove these if/when posthog/agent exports an enum for events
+const EventType = {
+    RAW_SDK_EVENT: 'raw_sdk_event',
+    TOKEN: 'token',
+    TOOL_CALL: 'tool_call',
+    TOOL_RESULT: 'tool_result',
+    ERROR: 'error',
+    DONE: 'done',
+};
+/**
+ * Initialize a PostHog Agent instance with the provided configuration
+ */
+function initializeAgent(config, options, spinner) {
+    clack_1.default.log.step('Initializing PostHog agent...');
+    try {
+        const agentConfig = {
+            workingDirectory: config.workingDirectory,
+            posthogMcpUrl: config.posthogMcpUrl,
+            posthogApiKey: config.posthogApiKey,
+            onEvent: (event) => {
+                handleAgentEvent(event, options, spinner);
+            },
+            debug: config.debug ?? false,
+        };
+        if (options.debug) {
+            (0, debug_1.debug)('Agent config:', {
+                workingDirectory: agentConfig.workingDirectory,
+                posthogMcpUrl: agentConfig.posthogMcpUrl,
+                posthogApiKeyPresent: !!agentConfig.posthogApiKey,
+            });
+        }
+        const agent = new agent_1.Agent(agentConfig);
+        clack_1.default.log.success("Agent initialized. Let's get cooking!");
+        return agent;
+    }
+    catch (error) {
+        clack_1.default.log.error(`Failed to initialize agent: ${error.message}`);
+        (0, debug_1.debug)('Agent initialization error:', error);
+        throw error;
+    }
+}
+/**
+ * Handle agent events and provide user feedback
+ * This function processes events from the agent SDK and provides appropriate
+ * user feedback through the CLI spinner and logging
+ */
+function handleAgentEvent(event, options, spinner) {
+    if (options.debug) {
+        (0, debug_1.debug)(`Event type: ${event.type}`, JSON.stringify(event, null, 2));
+    }
+    // Only show [STATUS] events to the user - everything else goes to debug log
+    switch (event.type) {
+        case EventType.RAW_SDK_EVENT:
+            if (event.sdkMessage?.type === 'assistant') {
+                const message = event.sdkMessage.message;
+                if (message?.content && Array.isArray(message.content)) {
+                    const textContent = message.content
+                        .filter((block) => block.type === 'text')
+                        .map((block) => block.text)
+                        .join('\n');
+                    // Check if the text contains a [STATUS] marker
+                    const statusMatch = textContent.match(/^.*\[STATUS\]\s*(.+?)$/m);
+                    if (statusMatch) {
+                        // Stop spinner, log the status step, restart spinner
+                        // This creates the progress list as the agent proceeds
+                        spinner.stop(statusMatch[1].trim());
+                        spinner.start('Integrating PostHog...');
+                    }
+                }
+            }
+            break;
+        case EventType.TOKEN:
+            if (options.debug) {
+                (0, debug_1.debug)(event.content);
+            }
+            break;
+        case EventType.TOOL_CALL:
+            if (options.debug) {
+                (0, debug_1.debug)(`Tool: ${event.toolName}`);
+                (0, debug_1.debug)('  Args:', JSON.stringify(event.args, null, 2));
+            }
+            break;
+        case EventType.TOOL_RESULT:
+            if (options.debug) {
+                (0, debug_1.debug)(`✅ ${event.toolName} completed`);
+                const resultStr = typeof event.result === 'string'
+                    ? event.result
+                    : JSON.stringify(event.result, null, 2);
+                const truncated = resultStr.length > 500
+                    ? `${resultStr.substring(0, 500)}...`
+                    : resultStr;
+                (0, debug_1.debug)('  Result:', truncated);
+            }
+            break;
+        case EventType.ERROR:
+            // Always show errors to user
+            clack_1.default.log.error(`Error: ${event.message}`);
+            if (options.debug && event.error) {
+                (0, debug_1.debug)('Error details:', event.error);
+            }
+            if (event.error instanceof Error) {
+                analytics_1.analytics.captureException(event.error, {
+                    event_type: event.type,
+                    message: event.message,
+                });
+            }
+            break;
+        case EventType.DONE:
+            if (event.durationMs) {
+                if (options.debug) {
+                    (0, debug_1.debug)(`Completed in ${Math.round(event.durationMs / 1000)}s`);
+                }
+                analytics_1.analytics.capture(constants_1.WIZARD_INTERACTION_EVENT_NAME, {
+                    action: 'agent integration completed',
+                    duration_ms: event.durationMs,
+                    duration_seconds: Math.round(event.durationMs / 1000),
+                });
+            }
+            break;
+    }
+}
+/**
+ * Execute an agent with the provided prompt and options
+ * Handles the full lifecycle: spinner, execution, error handling
+ */
+async function runAgent(agent, prompt, options, spinner, config) {
+    const { estimatedDurationMinutes = 8, spinnerMessage = 'Customizing your PostHog setup...', successMessage = 'PostHog integration complete', errorMessage = 'Integration failed', } = config ?? {};
+    clack_1.default.log.step(`This whole process should take about ${estimatedDurationMinutes} minutes including error checking and fixes.\n\nGrab some coffee!`);
+    spinner.start(spinnerMessage);
+    try {
+        await agent.run(prompt, {
+            repositoryPath: options.installDir,
+            permissionMode: agent_1.PermissionMode.ACCEPT_EDITS,
+        });
+        spinner.stop(successMessage);
+    }
+    catch (error) {
+        spinner.stop(errorMessage);
+        clack_1.default.log.error(`Error: ${error.message}`);
+        (0, debug_1.debug)('Full error:', error);
+        throw error;
+    }
+}
+//# sourceMappingURL=agent-interface.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-interface.js","sourceRoot":"","sources":["../../../src/lib/agent-interface.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Shared agent interface for PostHog wizards\n * Provides common agent initialization and event handling\n */\n\n// @ts-ignore - posthog-agent is ESM, wizard is CommonJS. Works at runtime via local link.\nimport { Agent, PermissionMode, type AgentEvent } from '@posthog/agent';\nimport clack from '../utils/clack';\nimport { debug } from '../utils/debug';\nimport type { WizardOptions } from '../utils/types';\nimport { analytics } from '../utils/analytics';\nimport { WIZARD_INTERACTION_EVENT_NAME } from './constants';\n\n// TODO: Remove these if/when posthog/agent exports an enum for events\nconst EventType = {\n  RAW_SDK_EVENT: 'raw_sdk_event',\n  TOKEN: 'token',\n  TOOL_CALL: 'tool_call',\n  TOOL_RESULT: 'tool_result',\n  ERROR: 'error',\n  DONE: 'done',\n} as const;\n\nexport type AgentConfig = {\n  workingDirectory: string;\n  posthogMcpUrl: string;\n  posthogApiKey: string;\n  debug?: boolean;\n};\n\n/**\n * Initialize a PostHog Agent instance with the provided configuration\n */\nexport function initializeAgent(\n  config: AgentConfig,\n  options: WizardOptions,\n  spinner: ReturnType<typeof clack.spinner>,\n): Agent {\n  clack.log.step('Initializing PostHog agent...');\n\n  try {\n    const agentConfig = {\n      workingDirectory: config.workingDirectory,\n      posthogMcpUrl: config.posthogMcpUrl,\n      posthogApiKey: config.posthogApiKey,\n      onEvent: (event: AgentEvent) => {\n        handleAgentEvent(event, options, spinner);\n      },\n      debug: config.debug ?? false,\n    };\n\n    if (options.debug) {\n      debug('Agent config:', {\n        workingDirectory: agentConfig.workingDirectory,\n        posthogMcpUrl: agentConfig.posthogMcpUrl,\n        posthogApiKeyPresent: !!agentConfig.posthogApiKey,\n      });\n    }\n\n    const agent = new Agent(agentConfig);\n    clack.log.success(\"Agent initialized. Let's get cooking!\");\n    return agent;\n  } catch (error) {\n    clack.log.error(`Failed to initialize agent: ${(error as Error).message}`);\n    debug('Agent initialization error:', error);\n    throw error;\n  }\n}\n\n/**\n * Handle agent events and provide user feedback\n * This function processes events from the agent SDK and provides appropriate\n * user feedback through the CLI spinner and logging\n */\nfunction handleAgentEvent(\n  event: AgentEvent,\n  options: WizardOptions,\n  spinner: ReturnType<typeof clack.spinner>,\n): void {\n  if (options.debug) {\n    debug(`Event type: ${event.type}`, JSON.stringify(event, null, 2));\n  }\n\n  // Only show [STATUS] events to the user - everything else goes to debug log\n  switch (event.type) {\n    case EventType.RAW_SDK_EVENT:\n      if (event.sdkMessage?.type === 'assistant') {\n        const message = event.sdkMessage.message;\n        if (message?.content && Array.isArray(message.content)) {\n          const textContent = message.content\n            .filter((block: any) => block.type === 'text')\n            .map((block: any) => block.text)\n            .join('\\n');\n\n          // Check if the text contains a [STATUS] marker\n          const statusMatch = textContent.match(/^.*\\[STATUS\\]\\s*(.+?)$/m);\n          if (statusMatch) {\n            // Stop spinner, log the status step, restart spinner\n            // This creates the progress list as the agent proceeds\n            spinner.stop(statusMatch[1].trim());\n            spinner.start('Integrating PostHog...');\n          }\n        }\n      }\n      break;\n\n    case EventType.TOKEN:\n      if (options.debug) {\n        debug(event.content);\n      }\n      break;\n\n    case EventType.TOOL_CALL:\n      if (options.debug) {\n        debug(`Tool: ${event.toolName}`);\n        debug('  Args:', JSON.stringify(event.args, null, 2));\n      }\n      break;\n\n    case EventType.TOOL_RESULT:\n      if (options.debug) {\n        debug(`✅ ${event.toolName} completed`);\n        const resultStr: string =\n          typeof event.result === 'string'\n            ? event.result\n            : JSON.stringify(event.result, null, 2);\n        const truncated =\n          resultStr.length > 500\n            ? `${resultStr.substring(0, 500)}...`\n            : resultStr;\n        debug('  Result:', truncated);\n      }\n      break;\n\n    case EventType.ERROR:\n      // Always show errors to user\n      clack.log.error(`Error: ${event.message}`);\n      if (options.debug && event.error) {\n        debug('Error details:', event.error);\n      }\n      if (event.error instanceof Error) {\n        analytics.captureException(event.error, {\n          event_type: event.type,\n          message: event.message,\n        });\n      }\n      break;\n\n    case EventType.DONE:\n      if (event.durationMs) {\n        if (options.debug) {\n          debug(`Completed in ${Math.round(event.durationMs / 1000)}s`);\n        }\n        analytics.capture(WIZARD_INTERACTION_EVENT_NAME, {\n          action: 'agent integration completed',\n          duration_ms: event.durationMs,\n          duration_seconds: Math.round(event.durationMs / 1000),\n        });\n      }\n      break;\n  }\n}\n\n/**\n * Execute an agent with the provided prompt and options\n * Handles the full lifecycle: spinner, execution, error handling\n */\nexport async function runAgent(\n  agent: Agent,\n  prompt: string,\n  options: WizardOptions,\n  spinner: ReturnType<typeof clack.spinner>,\n  config?: {\n    estimatedDurationMinutes?: number;\n    spinnerMessage?: string;\n    successMessage?: string;\n    errorMessage?: string;\n  },\n): Promise<void> {\n  const {\n    estimatedDurationMinutes = 8,\n    spinnerMessage = 'Customizing your PostHog setup...',\n    successMessage = 'PostHog integration complete',\n    errorMessage = 'Integration failed',\n  } = config ?? {};\n\n  clack.log.step(\n    `This whole process should take about ${estimatedDurationMinutes} minutes including error checking and fixes.\\n\\nGrab some coffee!`,\n  );\n\n  spinner.start(spinnerMessage);\n\n  try {\n    await agent.run(prompt, {\n      repositoryPath: options.installDir,\n      permissionMode: PermissionMode.ACCEPT_EDITS,\n    });\n    spinner.stop(successMessage);\n  } catch (error) {\n    spinner.stop(errorMessage);\n    clack.log.error(`Error: ${(error as Error).message}`);\n    debug('Full error:', error);\n    throw error;\n  }\n}\n"]}

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

@@ -5,6 +5,13 @@ export declare enum Integration {
     reactNative = "react-native",
     astro = "astro"
 }
+export declare enum FeatureFlagDefinition {
+    NextV2 = "wizard-next-v2"
+}
+export declare enum WizardVariant {
+    Legacy = "legacy",
+    Agent = "agent"
+}
 export declare function getIntegrationDescription(type: string): string;
 type IntegrationChoice = {
     name: string;
@@ -27,4 +34,5 @@ export declare const POSTHOG_US_CLIENT_ID = "c4Rdw8DIxgtQfA80IiSnGKlNX8QN00cFWF0
 export declare const POSTHOG_EU_CLIENT_ID = "bx2C5sZRN03TkdjraCcetvQFPGH6N2Y9vRLkcKEy";
 export declare const POSTHOG_DEV_CLIENT_ID = "DC5uRLVbGI02YQ82grxgnK6Qn12SXWpCqdPb60oZ";
 export declare const OAUTH_PORT = 8239;
+export declare const WIZARD_INTERACTION_EVENT_NAME = "wizard interaction";
 export {};

package/dist/src/lib/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OAUTH_PORT = exports.POSTHOG_DEV_CLIENT_ID = exports.POSTHOG_EU_CLIENT_ID = exports.POSTHOG_US_CLIENT_ID = exports.DUMMY_PROJECT_API_KEY = exports.ANALYTICS_HOST_URL = exports.ANALYTICS_POSTHOG_PUBLIC_PROJECT_WRITE_KEY = exports.DEFAULT_HOST_URL = exports.ISSUES_URL = exports.DEFAULT_URL = exports.DEBUG = exports.IS_DEV = exports.Integration = void 0;
+exports.WIZARD_INTERACTION_EVENT_NAME = exports.OAUTH_PORT = exports.POSTHOG_DEV_CLIENT_ID = exports.POSTHOG_EU_CLIENT_ID = exports.POSTHOG_US_CLIENT_ID = exports.DUMMY_PROJECT_API_KEY = exports.ANALYTICS_HOST_URL = exports.ANALYTICS_POSTHOG_PUBLIC_PROJECT_WRITE_KEY = exports.DEFAULT_HOST_URL = exports.ISSUES_URL = exports.DEFAULT_URL = exports.DEBUG = exports.IS_DEV = exports.WizardVariant = exports.FeatureFlagDefinition = exports.Integration = void 0;
 exports.getIntegrationDescription = getIntegrationDescription;
 exports.getIntegrationChoices = getIntegrationChoices;
 var Integration;
@@ -11,6 +11,15 @@ var Integration;
     Integration["reactNative"] = "react-native";
     Integration["astro"] = "astro";
 })(Integration || (exports.Integration = Integration = {}));
+var FeatureFlagDefinition;
+(function (FeatureFlagDefinition) {
+    FeatureFlagDefinition["NextV2"] = "wizard-next-v2";
+})(FeatureFlagDefinition || (exports.FeatureFlagDefinition = FeatureFlagDefinition = {}));
+var WizardVariant;
+(function (WizardVariant) {
+    WizardVariant["Legacy"] = "legacy";
+    WizardVariant["Agent"] = "agent";
+})(WizardVariant || (exports.WizardVariant = WizardVariant = {}));
 function getIntegrationDescription(type) {
     switch (type) {
         case Integration.nextjs:
@@ -49,4 +58,5 @@ exports.POSTHOG_US_CLIENT_ID = 'c4Rdw8DIxgtQfA80IiSnGKlNX8QN00cFWF00QQhM';
 exports.POSTHOG_EU_CLIENT_ID = 'bx2C5sZRN03TkdjraCcetvQFPGH6N2Y9vRLkcKEy';
 exports.POSTHOG_DEV_CLIENT_ID = 'DC5uRLVbGI02YQ82grxgnK6Qn12SXWpCqdPb60oZ';
 exports.OAUTH_PORT = 8239;
+exports.WIZARD_INTERACTION_EVENT_NAME = 'wizard interaction';
 //# sourceMappingURL=constants.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/lib/constants.ts"],"names":[],"mappings":";;;AAQA,8DAeC;AAOD,sDAKC;AAnCD,IAAY,WAMX;AAND,WAAY,WAAW;IACrB,gCAAiB,CAAA;IACjB,8BAAe,CAAA;IACf,gCAAiB,CAAA;IACjB,2CAA4B,CAAA;IAC5B,8BAAe,CAAA;AACjB,CAAC,EANW,WAAW,2BAAX,WAAW,QAMtB;AAED,SAAgB,yBAAyB,CAAC,IAAY;IACpD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,WAAW,CAAC,MAAM;YACrB,OAAO,SAAS,CAAC;QACnB,KAAK,WAAW,CAAC,KAAK;YACpB,OAAO,OAAO,CAAC;QACjB,KAAK,WAAW,CAAC,WAAW;YAC1B,OAAO,cAAc,CAAC;QACxB,KAAK,WAAW,CAAC,MAAM;YACrB,OAAO,QAAQ,CAAC;QAClB,KAAK,WAAW,CAAC,KAAK;YACpB,OAAO,OAAO,CAAC;QACjB;YACE,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;AACH,CAAC;AAOD,SAAgB,qBAAqB;IACnC,OAAO,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC;QACrD,IAAI,EAAE,yBAAyB,CAAC,IAAI,CAAC;QACrC,KAAK,EAAE,IAAI;KACZ,CAAC,CAAC,CAAC;AACN,CAAC;AAOY,QAAA,MAAM,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,QAAQ,CACpD,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAC3B,CAAC;AAEW,QAAA,KAAK,GAAG,KAAK,CAAC;AAEd,QAAA,WAAW,GAAG,cAAM;IAC/B,CAAC,CAAC,uBAAuB;IACzB,CAAC,CAAC,wBAAwB,CAAC;AAChB,QAAA,UAAU,GAAG,0CAA0C,CAAC;AACxD,QAAA,gBAAgB,GAAG,cAAM;IACpC,CAAC,CAAC,uBAAuB;IACzB,CAAC,CAAC,0BAA0B,CAAC;AAClB,QAAA,0CAA0C,GAAG,gBAAgB,CAAC;AAC9D,QAAA,kBAAkB,GAAG,gCAAgC,CAAC;AACtD,QAAA,qBAAqB,GAAG,gCAAgC,CAAC;AAEzD,QAAA,oBAAoB,GAAG,0CAA0C,CAAC;AAClE,QAAA,oBAAoB,GAAG,0CAA0C,CAAC;AAClE,QAAA,qBAAqB,GAAG,0CAA0C,CAAC;AACnE,QAAA,UAAU,GAAG,IAAI,CAAC","sourcesContent":["export enum Integration {\n  nextjs = 'nextjs',\n  react = 'react',\n  svelte = 'svelte',\n  reactNative = 'react-native',\n  astro = 'astro',\n}\n\nexport function getIntegrationDescription(type: string): string {\n  switch (type) {\n    case Integration.nextjs:\n      return 'Next.js';\n    case Integration.react:\n      return 'React';\n    case Integration.reactNative:\n      return 'React Native';\n    case Integration.svelte:\n      return 'Svelte';\n    case Integration.astro:\n      return 'Astro';\n    default:\n      throw new Error(`Unknown integration ${type}`);\n  }\n}\n\ntype IntegrationChoice = {\n  name: string;\n  value: string;\n};\n\nexport function getIntegrationChoices(): IntegrationChoice[] {\n  return Object.keys(Integration).map((type: string) => ({\n    name: getIntegrationDescription(type),\n    value: type,\n  }));\n}\n\nexport interface Args {\n  debug: boolean;\n  integration: Integration;\n}\n\nexport const IS_DEV = ['test', 'development'].includes(\n  process.env.NODE_ENV ?? '',\n);\n\nexport const DEBUG = false;\n\nexport const DEFAULT_URL = IS_DEV\n  ? 'http://localhost:8010'\n  : 'https://us.posthog.com';\nexport const ISSUES_URL = 'https://github.com/posthog/wizard/issues';\nexport const DEFAULT_HOST_URL = IS_DEV\n  ? 'http://localhost:8010'\n  : 'https://us.i.posthog.com';\nexport const ANALYTICS_POSTHOG_PUBLIC_PROJECT_WRITE_KEY = 'sTMFPsFhdP1Ssg';\nexport const ANALYTICS_HOST_URL = 'https://internal-j.posthog.com';\nexport const DUMMY_PROJECT_API_KEY = '_YOUR_POSTHOG_PROJECT_API_KEY_';\n\nexport const POSTHOG_US_CLIENT_ID = 'c4Rdw8DIxgtQfA80IiSnGKlNX8QN00cFWF00QQhM';\nexport const POSTHOG_EU_CLIENT_ID = 'bx2C5sZRN03TkdjraCcetvQFPGH6N2Y9vRLkcKEy';\nexport const POSTHOG_DEV_CLIENT_ID = 'DC5uRLVbGI02YQ82grxgnK6Qn12SXWpCqdPb60oZ';\nexport const OAUTH_PORT = 8239;\n"]}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/lib/constants.ts"],"names":[],"mappings":";;;AAiBA,8DAeC;AAOD,sDAKC;AA5CD,IAAY,WAMX;AAND,WAAY,WAAW;IACrB,gCAAiB,CAAA;IACjB,8BAAe,CAAA;IACf,gCAAiB,CAAA;IACjB,2CAA4B,CAAA;IAC5B,8BAAe,CAAA;AACjB,CAAC,EANW,WAAW,2BAAX,WAAW,QAMtB;AAED,IAAY,qBAEX;AAFD,WAAY,qBAAqB;IAC/B,kDAAyB,CAAA;AAC3B,CAAC,EAFW,qBAAqB,qCAArB,qBAAqB,QAEhC;AAED,IAAY,aAGX;AAHD,WAAY,aAAa;IACvB,kCAAiB,CAAA;IACjB,gCAAe,CAAA;AACjB,CAAC,EAHW,aAAa,6BAAb,aAAa,QAGxB;AAED,SAAgB,yBAAyB,CAAC,IAAY;IACpD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,WAAW,CAAC,MAAM;YACrB,OAAO,SAAS,CAAC;QACnB,KAAK,WAAW,CAAC,KAAK;YACpB,OAAO,OAAO,CAAC;QACjB,KAAK,WAAW,CAAC,WAAW;YAC1B,OAAO,cAAc,CAAC;QACxB,KAAK,WAAW,CAAC,MAAM;YACrB,OAAO,QAAQ,CAAC;QAClB,KAAK,WAAW,CAAC,KAAK;YACpB,OAAO,OAAO,CAAC;QACjB;YACE,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;AACH,CAAC;AAOD,SAAgB,qBAAqB;IACnC,OAAO,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC;QACrD,IAAI,EAAE,yBAAyB,CAAC,IAAI,CAAC;QACrC,KAAK,EAAE,IAAI;KACZ,CAAC,CAAC,CAAC;AACN,CAAC;AAOY,QAAA,MAAM,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,QAAQ,CACpD,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAC3B,CAAC;AAEW,QAAA,KAAK,GAAG,KAAK,CAAC;AAEd,QAAA,WAAW,GAAG,cAAM;IAC/B,CAAC,CAAC,uBAAuB;IACzB,CAAC,CAAC,wBAAwB,CAAC;AAChB,QAAA,UAAU,GAAG,0CAA0C,CAAC;AACxD,QAAA,gBAAgB,GAAG,cAAM;IACpC,CAAC,CAAC,uBAAuB;IACzB,CAAC,CAAC,0BAA0B,CAAC;AAClB,QAAA,0CAA0C,GAAG,gBAAgB,CAAC;AAC9D,QAAA,kBAAkB,GAAG,gCAAgC,CAAC;AACtD,QAAA,qBAAqB,GAAG,gCAAgC,CAAC;AAEzD,QAAA,oBAAoB,GAAG,0CAA0C,CAAC;AAClE,QAAA,oBAAoB,GAAG,0CAA0C,CAAC;AAClE,QAAA,qBAAqB,GAAG,0CAA0C,CAAC;AACnE,QAAA,UAAU,GAAG,IAAI,CAAC;AAElB,QAAA,6BAA6B,GAAG,oBAAoB,CAAC","sourcesContent":["export enum Integration {\n  nextjs = 'nextjs',\n  react = 'react',\n  svelte = 'svelte',\n  reactNative = 'react-native',\n  astro = 'astro',\n}\n\nexport enum FeatureFlagDefinition {\n  NextV2 = 'wizard-next-v2',\n}\n\nexport enum WizardVariant {\n  Legacy = 'legacy',\n  Agent = 'agent',\n}\n\nexport function getIntegrationDescription(type: string): string {\n  switch (type) {\n    case Integration.nextjs:\n      return 'Next.js';\n    case Integration.react:\n      return 'React';\n    case Integration.reactNative:\n      return 'React Native';\n    case Integration.svelte:\n      return 'Svelte';\n    case Integration.astro:\n      return 'Astro';\n    default:\n      throw new Error(`Unknown integration ${type}`);\n  }\n}\n\ntype IntegrationChoice = {\n  name: string;\n  value: string;\n};\n\nexport function getIntegrationChoices(): IntegrationChoice[] {\n  return Object.keys(Integration).map((type: string) => ({\n    name: getIntegrationDescription(type),\n    value: type,\n  }));\n}\n\nexport interface Args {\n  debug: boolean;\n  integration: Integration;\n}\n\nexport const IS_DEV = ['test', 'development'].includes(\n  process.env.NODE_ENV ?? '',\n);\n\nexport const DEBUG = false;\n\nexport const DEFAULT_URL = IS_DEV\n  ? 'http://localhost:8010'\n  : 'https://us.posthog.com';\nexport const ISSUES_URL = 'https://github.com/posthog/wizard/issues';\nexport const DEFAULT_HOST_URL = IS_DEV\n  ? 'http://localhost:8010'\n  : 'https://us.i.posthog.com';\nexport const ANALYTICS_POSTHOG_PUBLIC_PROJECT_WRITE_KEY = 'sTMFPsFhdP1Ssg';\nexport const ANALYTICS_HOST_URL = 'https://internal-j.posthog.com';\nexport const DUMMY_PROJECT_API_KEY = '_YOUR_POSTHOG_PROJECT_API_KEY_';\n\nexport const POSTHOG_US_CLIENT_ID = 'c4Rdw8DIxgtQfA80IiSnGKlNX8QN00cFWF00QQhM';\nexport const POSTHOG_EU_CLIENT_ID = 'bx2C5sZRN03TkdjraCcetvQFPGH6N2Y9vRLkcKEy';\nexport const POSTHOG_DEV_CLIENT_ID = 'DC5uRLVbGI02YQ82grxgnK6Qn12SXWpCqdPb60oZ';\nexport const OAUTH_PORT = 8239;\n\nexport const WIZARD_INTERACTION_EVENT_NAME = 'wizard interaction';\n"]}

package/dist/src/nextjs/nextjs-wizard-agent.d.ts

@@ -0,0 +1,5 @@
+import type { WizardOptions } from '../utils/types';
+/**
+ * Simplified Next.js wizard that delegates to PostHog MCP's /integrate command
+ */
+export declare function runNextjsWizardAgent(options: WizardOptions): Promise<void>;

package/dist/src/nextjs/nextjs-wizard-agent.js

@@ -0,0 +1,146 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runNextjsWizardAgent = runNextjsWizardAgent;
+/* Simplified Next.js wizard using posthog-agent with PostHog MCP */
+const clack_utils_1 = require("../utils/clack-utils");
+const package_json_1 = require("../utils/package-json");
+const utils_1 = require("./utils");
+const clack_1 = __importDefault(require("../utils/clack"));
+const constants_1 = require("../lib/constants");
+const analytics_1 = require("../utils/analytics");
+const clack_utils_2 = require("../utils/clack-utils");
+const urls_1 = require("../utils/urls");
+const chalk_1 = __importDefault(require("chalk"));
+const steps_1 = require("../steps");
+const debug_1 = require("../utils/debug");
+const agent_interface_1 = require("../lib/agent-interface");
+/**
+ * Simplified Next.js wizard that delegates to PostHog MCP's /integrate command
+ */
+async function runNextjsWizardAgent(options) {
+    if (options.debug) {
+        (0, debug_1.enableDebugLogs)();
+    }
+    (0, clack_utils_1.printWelcome)({
+        wizardName: 'PostHog Next.js wizard (agent-powered)',
+    });
+    clack_1.default.log.info('🧙 The wizard has chosen you to try the next-generation agent integration for Next.js.\n\nStand by for the good stuff, and let me know how it goes:\n\ndanilo@posthog.com');
+    const aiConsent = await (0, clack_utils_1.askForAIConsent)(options);
+    if (!aiConsent) {
+        await (0, clack_utils_1.abort)('This wizard uses an LLM agent to intelligently modify your project. Please view the docs to setup Next.js manually instead: https://posthog.com/docs/libraries/next-js', 0);
+    }
+    const cloudRegion = options.cloudRegion ?? (await (0, clack_utils_2.askForCloudRegion)());
+    const typeScriptDetected = (0, clack_utils_1.isUsingTypeScript)(options);
+    await (0, clack_utils_1.confirmContinueIfNoOrDirtyGitRepo)(options);
+    const packageJson = await (0, clack_utils_1.getPackageDotJson)(options);
+    await (0, clack_utils_1.ensurePackageIsInstalled)(packageJson, 'next', 'Next.js');
+    const nextVersion = (0, package_json_1.getPackageVersion)('next', packageJson);
+    analytics_1.analytics.setTag('nextjs-version', (0, utils_1.getNextJsVersionBucket)(nextVersion));
+    analytics_1.analytics.capture(constants_1.WIZARD_INTERACTION_EVENT_NAME, {
+        action: 'started agent integration',
+    });
+    const { projectApiKey, host, accessToken } = await (0, clack_utils_1.getOrAskForProjectData)({
+        ...options,
+        cloudRegion,
+    });
+    const router = await (0, utils_1.getNextJsRouter)(options);
+    const routerType = router === utils_1.NextJsRouter.APP_ROUTER ? 'app' : 'pages';
+    const spinner = clack_1.default.spinner();
+    const agent = (0, agent_interface_1.initializeAgent)({
+        workingDirectory: options.installDir,
+        posthogMcpUrl: 'https://mcp.posthog.com/mcp',
+        posthogApiKey: accessToken,
+        debug: false,
+    }, options, spinner);
+    const integrationPrompt = buildIntegrationPrompt({
+        framework: 'Next.js',
+        version: nextVersion || 'latest',
+        router: routerType,
+        typescript: typeScriptDetected,
+        projectApiKey,
+        host,
+    });
+    await (0, agent_interface_1.runAgent)(agent, integrationPrompt, options, spinner, {
+        estimatedDurationMinutes: 8,
+        spinnerMessage: 'Writing your PostHog setup with events, error capture and more...',
+        successMessage: 'PostHog integration complete',
+        errorMessage: 'Integration failed',
+    });
+    const { relativeEnvFilePath, addedEnvVariables } = await (0, steps_1.addOrUpdateEnvironmentVariablesStep)({
+        variables: {
+            NEXT_PUBLIC_POSTHOG_KEY: projectApiKey,
+            NEXT_PUBLIC_POSTHOG_HOST: host,
+        },
+        installDir: options.installDir,
+        integration: constants_1.Integration.nextjs,
+    });
+    const uploadedEnvVars = await (0, steps_1.uploadEnvironmentVariablesStep)({
+        NEXT_PUBLIC_POSTHOG_KEY: projectApiKey,
+        NEXT_PUBLIC_POSTHOG_HOST: host,
+    }, {
+        integration: constants_1.Integration.nextjs,
+        options,
+    });
+    await (0, steps_1.addMCPServerToClientsStep)({
+        cloudRegion,
+        integration: constants_1.Integration.nextjs,
+    });
+    const continueUrl = options.signup
+        ? `${(0, urls_1.getCloudUrlFromRegion)(cloudRegion)}/products?source=wizard`
+        : undefined;
+    const changes = [
+        addedEnvVariables
+            ? `Added your Project API key to your ${relativeEnvFilePath} file`
+            : '',
+        uploadedEnvVars.length > 0
+            ? `Uploaded your Project API key to your hosting provider`
+            : '',
+    ].filter(Boolean);
+    const nextSteps = [
+        uploadedEnvVars.length === 0
+            ? `Upload your Project API key to your hosting provider`
+            : '',
+    ].filter(Boolean);
+    const outroMessage = `
+${chalk_1.default.green('Successfully installed PostHog!')}
+
+${chalk_1.default.cyan('What the agent did:')}
+• Analyzed your Next.js project structure (${routerType} router)
+• Created and configured PostHog initializers
+• Integrated PostHog into your application
+${changes.map((change) => `• ${change}`).join('\n')}
+
+${chalk_1.default.yellow('Next steps:')}
+• Start your development server to see PostHog in action
+• Visit your PostHog dashboard to see incoming events
+${nextSteps.map((step) => `• ${step}`).join('\n')}
+
+Learn more about PostHog + Next.js: ${chalk_1.default.cyan('https://posthog.com/docs/libraries/next-js')}
+${continueUrl ? `\nContinue onboarding: ${chalk_1.default.cyan(continueUrl)}\n` : ``}
+${chalk_1.default.dim('Note: This wizard uses an LLM agent to analyze and modify your project. Please review the changes made.')}
+
+${chalk_1.default.dim(`How did this work for you? Drop me a line: danilo@posthog.com`)}`;
+    clack_1.default.outro(outroMessage);
+    await analytics_1.analytics.shutdown('success');
+}
+function buildIntegrationPrompt(context) {
+    return `You have access to the PostHog MCP server which provides an integration resource to integrate PostHog into this ${context.framework} project.
+
+Project context:
+- Framework: ${context.framework} ${context.version}
+- Router: ${context.router}
+- TypeScript: ${context.typescript ? 'Yes' : 'No'}
+- PostHog API Key: ${context.projectApiKey}
+- PostHog Host: ${context.host}
+
+Instructions:
+1. Call the PostHog MCP's resource for setup: posthog://integration/workflow/setup/begin
+2. Follow all instructions provided
+
+The PostHog MCP will provide specific integration code and instructions. Please follow them carefully. Be sure to look for lockfiles to determine the appropriate package manager to use when installing PostHog. Do not manually edit the package.json file.
+`;
+}
+//# sourceMappingURL=nextjs-wizard-agent.js.map

package/dist/src/nextjs/nextjs-wizard-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nextjs-wizard-agent.js","sourceRoot":"","sources":["../../../src/nextjs/nextjs-wizard-agent.ts"],"names":[],"mappings":"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","sourcesContent":["/* Simplified Next.js wizard using posthog-agent with PostHog MCP */\nimport {\n  abort,\n  askForAIConsent,\n  confirmContinueIfNoOrDirtyGitRepo,\n  ensurePackageIsInstalled,\n  getOrAskForProjectData,\n  getPackageDotJson,\n  isUsingTypeScript,\n  printWelcome,\n} from '../utils/clack-utils';\nimport { getPackageVersion } from '../utils/package-json';\nimport { getNextJsRouter, getNextJsVersionBucket, NextJsRouter } from './utils';\nimport clack from '../utils/clack';\nimport { Integration, WIZARD_INTERACTION_EVENT_NAME } from '../lib/constants';\nimport { analytics } from '../utils/analytics';\nimport type { WizardOptions } from '../utils/types';\nimport { askForCloudRegion } from '../utils/clack-utils';\nimport { getCloudUrlFromRegion } from '../utils/urls';\nimport chalk from 'chalk';\nimport {\n  addOrUpdateEnvironmentVariablesStep,\n  addMCPServerToClientsStep,\n  uploadEnvironmentVariablesStep,\n} from '../steps';\nimport { enableDebugLogs } from '../utils/debug';\nimport { initializeAgent, runAgent } from '../lib/agent-interface';\n\n/**\n * Simplified Next.js wizard that delegates to PostHog MCP's /integrate command\n */\nexport async function runNextjsWizardAgent(\n  options: WizardOptions,\n): Promise<void> {\n  if (options.debug) {\n    enableDebugLogs();\n  }\n\n  printWelcome({\n    wizardName: 'PostHog Next.js wizard (agent-powered)',\n  });\n\n  clack.log.info(\n    '🧙 The wizard has chosen you to try the next-generation agent integration for Next.js.\\n\\nStand by for the good stuff, and let me know how it goes:\\n\\ndanilo@posthog.com',\n  );\n\n  const aiConsent = await askForAIConsent(options);\n\n  if (!aiConsent) {\n    await abort(\n      'This wizard uses an LLM agent to intelligently modify your project. Please view the docs to setup Next.js manually instead: https://posthog.com/docs/libraries/next-js',\n      0,\n    );\n  }\n\n  const cloudRegion = options.cloudRegion ?? (await askForCloudRegion());\n  const typeScriptDetected = isUsingTypeScript(options);\n\n  await confirmContinueIfNoOrDirtyGitRepo(options);\n\n  const packageJson = await getPackageDotJson(options);\n  await ensurePackageIsInstalled(packageJson, 'next', 'Next.js');\n\n  const nextVersion = getPackageVersion('next', packageJson);\n  analytics.setTag('nextjs-version', getNextJsVersionBucket(nextVersion));\n\n  analytics.capture(WIZARD_INTERACTION_EVENT_NAME, {\n    action: 'started agent integration',\n  });\n\n  const { projectApiKey, host, accessToken } = await getOrAskForProjectData({\n    ...options,\n    cloudRegion,\n  });\n\n  const router = await getNextJsRouter(options);\n  const routerType = router === NextJsRouter.APP_ROUTER ? 'app' : 'pages';\n\n  const spinner = clack.spinner();\n\n  const agent = initializeAgent(\n    {\n      workingDirectory: options.installDir,\n      posthogMcpUrl: 'https://mcp.posthog.com/mcp',\n      posthogApiKey: accessToken,\n      debug: false,\n    },\n    options,\n    spinner,\n  );\n\n  const integrationPrompt = buildIntegrationPrompt({\n    framework: 'Next.js',\n    version: nextVersion || 'latest',\n    router: routerType,\n    typescript: typeScriptDetected,\n    projectApiKey,\n    host,\n  });\n\n  await runAgent(agent, integrationPrompt, options, spinner, {\n    estimatedDurationMinutes: 8,\n    spinnerMessage:\n      'Writing your PostHog setup with events, error capture and more...',\n    successMessage: 'PostHog integration complete',\n    errorMessage: 'Integration failed',\n  });\n\n  const { relativeEnvFilePath, addedEnvVariables } =\n    await addOrUpdateEnvironmentVariablesStep({\n      variables: {\n        NEXT_PUBLIC_POSTHOG_KEY: projectApiKey,\n        NEXT_PUBLIC_POSTHOG_HOST: host,\n      },\n      installDir: options.installDir,\n      integration: Integration.nextjs,\n    });\n\n  const uploadedEnvVars = await uploadEnvironmentVariablesStep(\n    {\n      NEXT_PUBLIC_POSTHOG_KEY: projectApiKey,\n      NEXT_PUBLIC_POSTHOG_HOST: host,\n    },\n    {\n      integration: Integration.nextjs,\n      options,\n    },\n  );\n\n  await addMCPServerToClientsStep({\n    cloudRegion,\n    integration: Integration.nextjs,\n  });\n\n  const continueUrl = options.signup\n    ? `${getCloudUrlFromRegion(cloudRegion)}/products?source=wizard`\n    : undefined;\n\n  const changes = [\n    addedEnvVariables\n      ? `Added your Project API key to your ${relativeEnvFilePath} file`\n      : '',\n    uploadedEnvVars.length > 0\n      ? `Uploaded your Project API key to your hosting provider`\n      : '',\n  ].filter(Boolean);\n\n  const nextSteps = [\n    uploadedEnvVars.length === 0\n      ? `Upload your Project API key to your hosting provider`\n      : '',\n  ].filter(Boolean);\n\n  const outroMessage = `\n${chalk.green('Successfully installed PostHog!')}\n\n${chalk.cyan('What the agent did:')}\n• Analyzed your Next.js project structure (${routerType} router)\n• Created and configured PostHog initializers\n• Integrated PostHog into your application\n${changes.map((change) => `• ${change}`).join('\\n')}\n\n${chalk.yellow('Next steps:')}\n• Start your development server to see PostHog in action\n• Visit your PostHog dashboard to see incoming events\n${nextSteps.map((step) => `• ${step}`).join('\\n')}\n\nLearn more about PostHog + Next.js: ${chalk.cyan(\n    'https://posthog.com/docs/libraries/next-js',\n  )}\n${continueUrl ? `\\nContinue onboarding: ${chalk.cyan(continueUrl)}\\n` : ``}\n${chalk.dim(\n  'Note: This wizard uses an LLM agent to analyze and modify your project. Please review the changes made.',\n)}\n\n${chalk.dim(`How did this work for you? Drop me a line: danilo@posthog.com`)}`;\n\n  clack.outro(outroMessage);\n\n  await analytics.shutdown('success');\n}\n\nfunction buildIntegrationPrompt(context: {\n  framework: string;\n  version: string;\n  router: string;\n  typescript: boolean;\n  projectApiKey: string;\n  host: string;\n}): string {\n  return `You have access to the PostHog MCP server which provides an integration resource to integrate PostHog into this ${\n    context.framework\n  } project.\n\nProject context:\n- Framework: ${context.framework} ${context.version}\n- Router: ${context.router}\n- TypeScript: ${context.typescript ? 'Yes' : 'No'}\n- PostHog API Key: ${context.projectApiKey}\n- PostHog Host: ${context.host}\n\nInstructions:\n1. Call the PostHog MCP's resource for setup: posthog://integration/workflow/setup/begin\n2. Follow all instructions provided\n\nThe PostHog MCP will provide specific integration code and instructions. Please follow them carefully. Be sure to look for lockfiles to determine the appropriate package manager to use when installing PostHog. Do not manually edit the package.json file.\n`;\n}\n"]}

package/dist/src/run.js

@@ -1,4 +1,37 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
@@ -6,6 +39,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.runWizard = runWizard;
 const clack_utils_1 = require("./utils/clack-utils");
 const nextjs_wizard_1 = require("./nextjs/nextjs-wizard");
+const nextjs_wizard_agent_1 = require("./nextjs/nextjs-wizard-agent");
 const constants_1 = require("./lib/constants");
 const environment_1 = require("./utils/environment");
 const clack_1 = __importDefault(require("./utils/clack"));
@@ -19,6 +53,8 @@ const astro_wizard_1 = require("./astro/astro-wizard");
 const events_1 = require("events");
 const chalk_1 = __importDefault(require("chalk"));
 const errors_1 = require("./utils/errors");
+const package_json_1 = require("./utils/package-json");
+const semver = __importStar(require("semver"));
 events_1.EventEmitter.defaultMaxListeners = 50;
 async function runWizard(argv) {
     const finalArgs = {
@@ -51,7 +87,7 @@ async function runWizard(argv) {
     try {
         switch (integration) {
             case constants_1.Integration.nextjs:
-                await (0, nextjs_wizard_1.runNextjsWizard)(wizardOptions);
+                await chooseNextjsWizard(wizardOptions);
                 break;
             case constants_1.Integration.react:
                 await (0, react_wizard_1.runReactWizard)(wizardOptions);
@@ -112,4 +148,29 @@ async function getIntegrationForSetup(options) {
     }));
     return integration;
 }
+async function chooseNextjsWizard(options) {
+    try {
+        const packageJson = await (0, clack_utils_1.getPackageDotJson)(options);
+        const nextVersion = (0, package_json_1.getPackageVersion)('next', packageJson);
+        // If Next.js < 15, use legacy wizard
+        if (nextVersion) {
+            const coercedVersion = semver.coerce(nextVersion);
+            if (coercedVersion && semver.lt(coercedVersion, '15.3.0')) {
+                await (0, nextjs_wizard_1.runNextjsWizard)(options);
+                return;
+            }
+        }
+        // Next.js >= 15 - check feature flag to determine which wizard to use
+        const flagValue = await analytics_1.analytics.getFeatureFlag(constants_1.FeatureFlagDefinition.NextV2);
+        if (flagValue === constants_1.WizardVariant.Agent) {
+            await (0, nextjs_wizard_agent_1.runNextjsWizardAgent)(options);
+        }
+        else {
+            await (0, nextjs_wizard_1.runNextjsWizard)(options);
+        }
+    }
+    catch (error) {
+        await (0, nextjs_wizard_1.runNextjsWizard)(options);
+    }
+}
 //# sourceMappingURL=run.js.map

package/dist/src/run.js.map

@@ -1 +1 @@
-{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/run.ts"],"names":[],"mappings":"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","sourcesContent":["import { abortIfCancelled } from './utils/clack-utils';\n\nimport { runNextjsWizard } from './nextjs/nextjs-wizard';\nimport type { CloudRegion, WizardOptions } from './utils/types';\n\nimport { getIntegrationDescription, Integration } from './lib/constants';\nimport { readEnvironment } from './utils/environment';\nimport clack from './utils/clack';\nimport path from 'path';\nimport { INTEGRATION_CONFIG, INTEGRATION_ORDER } from './lib/config';\nimport { runReactWizard } from './react/react-wizard';\nimport { analytics } from './utils/analytics';\nimport { runSvelteWizard } from './svelte/svelte-wizard';\nimport { runReactNativeWizard } from './react-native/react-native-wizard';\nimport { runAstroWizard } from './astro/astro-wizard';\nimport { EventEmitter } from 'events';\nimport chalk from 'chalk';\nimport { RateLimitError } from './utils/errors';\n\nEventEmitter.defaultMaxListeners = 50;\n\ntype Args = {\n  integration?: Integration;\n  debug?: boolean;\n  forceInstall?: boolean;\n  installDir?: string;\n  region?: CloudRegion;\n  default?: boolean;\n  signup?: boolean;\n};\n\nexport async function runWizard(argv: Args) {\n  const finalArgs = {\n    ...argv,\n    ...readEnvironment(),\n  };\n\n  let resolvedInstallDir: string;\n  if (finalArgs.installDir) {\n    if (path.isAbsolute(finalArgs.installDir)) {\n      resolvedInstallDir = finalArgs.installDir;\n    } else {\n      resolvedInstallDir = path.join(process.cwd(), finalArgs.installDir);\n    }\n  } else {\n    resolvedInstallDir = process.cwd();\n  }\n\n  const wizardOptions: WizardOptions = {\n    debug: finalArgs.debug ?? false,\n    forceInstall: finalArgs.forceInstall ?? false,\n    installDir: resolvedInstallDir,\n    cloudRegion: finalArgs.region ?? undefined,\n    default: finalArgs.default ?? false,\n    signup: finalArgs.signup ?? false,\n  };\n\n  clack.intro(`Welcome to the PostHog setup wizard ✨`);\n\n  const integration =\n    finalArgs.integration ?? (await getIntegrationForSetup(wizardOptions));\n\n  analytics.setTag('integration', integration);\n\n  try {\n    switch (integration) {\n      case Integration.nextjs:\n        await runNextjsWizard(wizardOptions);\n        break;\n      case Integration.react:\n        await runReactWizard(wizardOptions);\n        break;\n      case Integration.svelte:\n        await runSvelteWizard(wizardOptions);\n        break;\n      case Integration.reactNative:\n        await runReactNativeWizard(wizardOptions);\n        break;\n      case Integration.astro:\n        await runAstroWizard(wizardOptions);\n        break;\n      default:\n        clack.log.error('No setup wizard selected!');\n    }\n  } catch (error) {\n    analytics.captureException(error as Error, {\n      integration,\n      arguments: JSON.stringify(finalArgs),\n    });\n\n    await analytics.shutdown('error');\n\n    if (error instanceof RateLimitError) {\n      clack.log.error('Wizard usage limit reached. Please try again later.');\n    } else {\n      clack.log.error(\n        `Something went wrong. You can read the documentation at ${chalk.cyan(\n          `${INTEGRATION_CONFIG[integration].docsUrl}`,\n        )} to set up PostHog manually.`,\n      );\n    }\n    process.exit(1);\n  }\n}\n\nasync function detectIntegration(\n  options: Pick<WizardOptions, 'installDir'>,\n): Promise<Integration | undefined> {\n  const integrationConfigs = Object.entries(INTEGRATION_CONFIG).sort(\n    ([a], [b]) =>\n      INTEGRATION_ORDER.indexOf(a as Integration) -\n      INTEGRATION_ORDER.indexOf(b as Integration),\n  );\n\n  for (const [integration, config] of integrationConfigs) {\n    const detected = await config.detect(options);\n    if (detected) {\n      return integration as Integration;\n    }\n  }\n}\n\nasync function getIntegrationForSetup(\n  options: Pick<WizardOptions, 'installDir'>,\n) {\n  const detectedIntegration = await detectIntegration(options);\n\n  if (detectedIntegration) {\n    clack.log.success(\n      `Detected integration: ${getIntegrationDescription(detectedIntegration)}`,\n    );\n    return detectedIntegration;\n  }\n\n  const integration: Integration = await abortIfCancelled(\n    clack.select({\n      message: 'What do you want to set up?',\n      options: [\n        { value: Integration.nextjs, label: 'Next.js' },\n        { value: Integration.astro, label: 'Astro' },\n        { value: Integration.react, label: 'React' },\n        { value: Integration.svelte, label: 'Svelte' },\n        { value: Integration.reactNative, label: 'React Native' },\n      ],\n    }),\n  );\n\n  return integration;\n}\n"]}
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/run.ts"],"names":[],"mappings":"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","sourcesContent":["import { abortIfCancelled, getPackageDotJson } from './utils/clack-utils';\n\nimport { runNextjsWizard } from './nextjs/nextjs-wizard';\nimport { runNextjsWizardAgent } from './nextjs/nextjs-wizard-agent';\nimport type { CloudRegion, WizardOptions } from './utils/types';\n\nimport {\n  getIntegrationDescription,\n  Integration,\n  FeatureFlagDefinition,\n  WizardVariant,\n} from './lib/constants';\nimport { readEnvironment } from './utils/environment';\nimport clack from './utils/clack';\nimport path from 'path';\nimport { INTEGRATION_CONFIG, INTEGRATION_ORDER } from './lib/config';\nimport { runReactWizard } from './react/react-wizard';\nimport { analytics } from './utils/analytics';\nimport { runSvelteWizard } from './svelte/svelte-wizard';\nimport { runReactNativeWizard } from './react-native/react-native-wizard';\nimport { runAstroWizard } from './astro/astro-wizard';\nimport { EventEmitter } from 'events';\nimport chalk from 'chalk';\nimport { RateLimitError } from './utils/errors';\nimport { getPackageVersion } from './utils/package-json';\nimport * as semver from 'semver';\n\nEventEmitter.defaultMaxListeners = 50;\n\ntype Args = {\n  integration?: Integration;\n  debug?: boolean;\n  forceInstall?: boolean;\n  installDir?: string;\n  region?: CloudRegion;\n  default?: boolean;\n  signup?: boolean;\n};\n\nexport async function runWizard(argv: Args) {\n  const finalArgs = {\n    ...argv,\n    ...readEnvironment(),\n  };\n\n  let resolvedInstallDir: string;\n  if (finalArgs.installDir) {\n    if (path.isAbsolute(finalArgs.installDir)) {\n      resolvedInstallDir = finalArgs.installDir;\n    } else {\n      resolvedInstallDir = path.join(process.cwd(), finalArgs.installDir);\n    }\n  } else {\n    resolvedInstallDir = process.cwd();\n  }\n\n  const wizardOptions: WizardOptions = {\n    debug: finalArgs.debug ?? false,\n    forceInstall: finalArgs.forceInstall ?? false,\n    installDir: resolvedInstallDir,\n    cloudRegion: finalArgs.region ?? undefined,\n    default: finalArgs.default ?? false,\n    signup: finalArgs.signup ?? false,\n  };\n\n  clack.intro(`Welcome to the PostHog setup wizard ✨`);\n\n  const integration =\n    finalArgs.integration ?? (await getIntegrationForSetup(wizardOptions));\n\n  analytics.setTag('integration', integration);\n\n  try {\n    switch (integration) {\n      case Integration.nextjs:\n        await chooseNextjsWizard(wizardOptions);\n        break;\n      case Integration.react:\n        await runReactWizard(wizardOptions);\n        break;\n      case Integration.svelte:\n        await runSvelteWizard(wizardOptions);\n        break;\n      case Integration.reactNative:\n        await runReactNativeWizard(wizardOptions);\n        break;\n      case Integration.astro:\n        await runAstroWizard(wizardOptions);\n        break;\n      default:\n        clack.log.error('No setup wizard selected!');\n    }\n  } catch (error) {\n    analytics.captureException(error as Error, {\n      integration,\n      arguments: JSON.stringify(finalArgs),\n    });\n\n    await analytics.shutdown('error');\n\n    if (error instanceof RateLimitError) {\n      clack.log.error('Wizard usage limit reached. Please try again later.');\n    } else {\n      clack.log.error(\n        `Something went wrong. You can read the documentation at ${chalk.cyan(\n          `${INTEGRATION_CONFIG[integration].docsUrl}`,\n        )} to set up PostHog manually.`,\n      );\n    }\n    process.exit(1);\n  }\n}\n\nasync function detectIntegration(\n  options: Pick<WizardOptions, 'installDir'>,\n): Promise<Integration | undefined> {\n  const integrationConfigs = Object.entries(INTEGRATION_CONFIG).sort(\n    ([a], [b]) =>\n      INTEGRATION_ORDER.indexOf(a as Integration) -\n      INTEGRATION_ORDER.indexOf(b as Integration),\n  );\n\n  for (const [integration, config] of integrationConfigs) {\n    const detected = await config.detect(options);\n    if (detected) {\n      return integration as Integration;\n    }\n  }\n}\n\nasync function getIntegrationForSetup(\n  options: Pick<WizardOptions, 'installDir'>,\n) {\n  const detectedIntegration = await detectIntegration(options);\n\n  if (detectedIntegration) {\n    clack.log.success(\n      `Detected integration: ${getIntegrationDescription(detectedIntegration)}`,\n    );\n    return detectedIntegration;\n  }\n\n  const integration: Integration = await abortIfCancelled(\n    clack.select({\n      message: 'What do you want to set up?',\n      options: [\n        { value: Integration.nextjs, label: 'Next.js' },\n        { value: Integration.astro, label: 'Astro' },\n        { value: Integration.react, label: 'React' },\n        { value: Integration.svelte, label: 'Svelte' },\n        { value: Integration.reactNative, label: 'React Native' },\n      ],\n    }),\n  );\n\n  return integration;\n}\n\nasync function chooseNextjsWizard(options: WizardOptions): Promise<void> {\n  try {\n    const packageJson = await getPackageDotJson(options);\n    const nextVersion = getPackageVersion('next', packageJson);\n\n    // If Next.js < 15, use legacy wizard\n    if (nextVersion) {\n      const coercedVersion = semver.coerce(nextVersion);\n      if (coercedVersion && semver.lt(coercedVersion, '15.3.0')) {\n        await runNextjsWizard(options);\n        return;\n      }\n    }\n\n    // Next.js >= 15 - check feature flag to determine which wizard to use\n    const flagValue = await analytics.getFeatureFlag(\n      FeatureFlagDefinition.NextV2,\n    );\n\n    if (flagValue === WizardVariant.Agent) {\n      await runNextjsWizardAgent(options);\n    } else {\n      await runNextjsWizard(options);\n    }\n  } catch (error) {\n    await runNextjsWizard(options);\n  }\n}\n"]}

package/dist/src/utils/__tests__/analytics.test.js

@@ -29,6 +29,7 @@ describe('Analytics', () => {
             analytics.captureException(error, properties);
             expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(error, 'test-uuid', {
                 team: 'growth',
+                $app_name: 'wizard',
                 ...properties,
             });
         });
@@ -39,6 +40,7 @@ describe('Analytics', () => {
             analytics.captureException(error, properties);
             expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(error, 'test-uuid', {
                 team: 'growth',
+                $app_name: 'wizard',
                 testTag: 'testValue',
                 ...properties,
             });
@@ -50,6 +52,7 @@ describe('Analytics', () => {
             analytics.captureException(error);
             expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(error, distinctId, {
                 team: 'growth',
+                $app_name: 'wizard',
             });
         });
         it('should capture exception without properties when not provided', () => {
@@ -57,6 +60,7 @@ describe('Analytics', () => {
             analytics.captureException(error);
             expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(error, 'test-uuid', {
                 team: 'growth',
+                $app_name: 'wizard',
             });
         });
         it('should merge tags with provided properties', () => {
@@ -67,6 +71,7 @@ describe('Analytics', () => {
             analytics.captureException(error, properties);
             expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(error, 'test-uuid', {
                 team: 'growth',
+                $app_name: 'wizard',
                 environment: 'test',
                 version: '1.0.0',
                 integration: 'nextjs',
@@ -80,6 +85,7 @@ describe('Analytics', () => {
             analytics.captureException(error, properties);
             expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(error, 'test-uuid', {
                 team: 'growth',
+                $app_name: 'wizard',
                 integration: 'react',
             });
         });
@@ -88,6 +94,7 @@ describe('Analytics', () => {
             analytics.captureException(error);
             expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(error, 'test-uuid', {
                 team: 'growth',
+                $app_name: 'wizard',
             });
         });
     });
@@ -103,6 +110,7 @@ describe('Analytics', () => {
             });
             expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(error, 'test-uuid', {
                 team: 'growth',
+                $app_name: 'wizard',
                 integration: 'nextjs',
                 forceInstall: true,
                 debug: false,
@@ -118,6 +126,7 @@ describe('Analytics', () => {
             analytics.captureException(error);
             expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(error, distinctId, {
                 team: 'growth',
+                $app_name: 'wizard',
                 integration: 'svelte',
             });
         });

package/dist/src/utils/__tests__/analytics.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"analytics.test.js","sourceRoot":"","sources":["../../../../src/utils/__tests__/analytics.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { Analytics } from '../analytics';\nimport { PostHog } from 'posthog-node';\nimport { v4 as uuidv4 } from 'uuid';\n\njest.mock('posthog-node');\njest.mock('uuid');\n\nconst mockUuidv4 = uuidv4 as jest.MockedFunction<typeof uuidv4>;\nconst MockedPostHog = PostHog as jest.MockedClass<typeof PostHog>;\n\ndescribe('Analytics', () => {\n  let analytics: Analytics;\n  let mockPostHogInstance: jest.Mocked<PostHog>;\n\n  beforeEach(() => {\n    jest.clearAllMocks();\n    mockUuidv4.mockReturnValue('test-uuid' as any);\n\n    mockPostHogInstance = {\n      capture: jest.fn(),\n      captureException: jest.fn(),\n      alias: jest.fn(),\n      shutdown: jest.fn().mockResolvedValue(undefined),\n    } as any;\n\n    MockedPostHog.mockImplementation(() => mockPostHogInstance);\n\n    analytics = new Analytics();\n  });\n\n  describe('captureException', () => {\n    it('should capture exception with error object and properties', () => {\n      const error = new Error('Test error');\n      const properties = { integration: 'nextjs' };\n\n      analytics.captureException(error, properties);\n\n      expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(\n        error,\n        'test-uuid',\n        {\n          team: 'growth',\n          ...properties,\n        },\n      );\n    });\n\n    it('should capture exception with tags included in properties', () => {\n      const error = new Error('Test error');\n      const properties = { integration: 'nextjs' };\n\n      analytics.setTag('testTag', 'testValue');\n      analytics.captureException(error, properties);\n\n      expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(\n        error,\n        'test-uuid',\n        {\n          team: 'growth',\n          testTag: 'testValue',\n          ...properties,\n        },\n      );\n    });\n\n    it('should capture exception with distinct ID when set', () => {\n      const error = new Error('Test error');\n      const distinctId = 'user-123';\n\n      analytics.setDistinctId(distinctId);\n      analytics.captureException(error);\n\n      expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(\n        error,\n        distinctId,\n        {\n          team: 'growth',\n        },\n      );\n    });\n\n    it('should capture exception without properties when not provided', () => {\n      const error = new Error('Test error');\n\n      analytics.captureException(error);\n\n      expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(\n        error,\n        'test-uuid',\n        {\n          team: 'growth',\n        },\n      );\n    });\n\n    it('should merge tags with provided properties', () => {\n      const error = new Error('Test error');\n      const properties = { integration: 'nextjs', step: 'installation' };\n\n      analytics.setTag('environment', 'test');\n      analytics.setTag('version', '1.0.0');\n      analytics.captureException(error, properties);\n\n      expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(\n        error,\n        'test-uuid',\n        {\n          team: 'growth',\n          environment: 'test',\n          version: '1.0.0',\n          integration: 'nextjs',\n          step: 'installation',\n        },\n      );\n    });\n\n    it('should override tags with properties when keys conflict', () => {\n      const error = new Error('Test error');\n      const properties = { integration: 'react' };\n\n      analytics.setTag('integration', 'nextjs');\n      analytics.captureException(error, properties);\n\n      expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(\n        error,\n        'test-uuid',\n        {\n          team: 'growth',\n          integration: 'react',\n        },\n      );\n    });\n\n    it('should always include team:growth property in exceptions', () => {\n      const error = new Error('Test error');\n\n      analytics.captureException(error);\n\n      expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(\n        error,\n        'test-uuid',\n        {\n          team: 'growth',\n        },\n      );\n    });\n  });\n\n  describe('integration with other methods', () => {\n    it('should work correctly with setTag and captureException', () => {\n      const error = new Error('Test error');\n\n      analytics.setTag('integration', 'nextjs');\n      analytics.setTag('forceInstall', true);\n      analytics.setTag('debug', false);\n\n      analytics.captureException(error, {\n        arguments: JSON.stringify({ installDir: '/test' }),\n        step: 'wizard-execution',\n      });\n\n      expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(\n        error,\n        'test-uuid',\n        {\n          team: 'growth',\n          integration: 'nextjs',\n          forceInstall: true,\n          debug: false,\n          arguments: JSON.stringify({ installDir: '/test' }),\n          step: 'wizard-execution',\n        },\n      );\n    });\n\n    it('should work correctly with setDistinctId and captureException', () => {\n      const error = new Error('Test error');\n      const distinctId = 'user-456';\n\n      analytics.setDistinctId(distinctId);\n      analytics.setTag('integration', 'svelte');\n      analytics.captureException(error);\n\n      expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(\n        error,\n        distinctId,\n        {\n          team: 'growth',\n          integration: 'svelte',\n        },\n      );\n    });\n  });\n});\n"]}
+{"version":3,"file":"analytics.test.js","sourceRoot":"","sources":["../../../../src/utils/__tests__/analytics.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { Analytics } from '../analytics';\nimport { PostHog } from 'posthog-node';\nimport { v4 as uuidv4 } from 'uuid';\n\njest.mock('posthog-node');\njest.mock('uuid');\n\nconst mockUuidv4 = uuidv4 as jest.MockedFunction<typeof uuidv4>;\nconst MockedPostHog = PostHog as jest.MockedClass<typeof PostHog>;\n\ndescribe('Analytics', () => {\n  let analytics: Analytics;\n  let mockPostHogInstance: jest.Mocked<PostHog>;\n\n  beforeEach(() => {\n    jest.clearAllMocks();\n    mockUuidv4.mockReturnValue('test-uuid' as any);\n\n    mockPostHogInstance = {\n      capture: jest.fn(),\n      captureException: jest.fn(),\n      alias: jest.fn(),\n      shutdown: jest.fn().mockResolvedValue(undefined),\n    } as any;\n\n    MockedPostHog.mockImplementation(() => mockPostHogInstance);\n\n    analytics = new Analytics();\n  });\n\n  describe('captureException', () => {\n    it('should capture exception with error object and properties', () => {\n      const error = new Error('Test error');\n      const properties = { integration: 'nextjs' };\n\n      analytics.captureException(error, properties);\n\n      expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(\n        error,\n        'test-uuid',\n        {\n          team: 'growth',\n          $app_name: 'wizard',\n          ...properties,\n        },\n      );\n    });\n\n    it('should capture exception with tags included in properties', () => {\n      const error = new Error('Test error');\n      const properties = { integration: 'nextjs' };\n\n      analytics.setTag('testTag', 'testValue');\n      analytics.captureException(error, properties);\n\n      expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(\n        error,\n        'test-uuid',\n        {\n          team: 'growth',\n          $app_name: 'wizard',\n          testTag: 'testValue',\n          ...properties,\n        },\n      );\n    });\n\n    it('should capture exception with distinct ID when set', () => {\n      const error = new Error('Test error');\n      const distinctId = 'user-123';\n\n      analytics.setDistinctId(distinctId);\n      analytics.captureException(error);\n\n      expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(\n        error,\n        distinctId,\n        {\n          team: 'growth',\n          $app_name: 'wizard',\n        },\n      );\n    });\n\n    it('should capture exception without properties when not provided', () => {\n      const error = new Error('Test error');\n\n      analytics.captureException(error);\n\n      expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(\n        error,\n        'test-uuid',\n        {\n          team: 'growth',\n          $app_name: 'wizard',\n        },\n      );\n    });\n\n    it('should merge tags with provided properties', () => {\n      const error = new Error('Test error');\n      const properties = { integration: 'nextjs', step: 'installation' };\n\n      analytics.setTag('environment', 'test');\n      analytics.setTag('version', '1.0.0');\n      analytics.captureException(error, properties);\n\n      expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(\n        error,\n        'test-uuid',\n        {\n          team: 'growth',\n          $app_name: 'wizard',\n          environment: 'test',\n          version: '1.0.0',\n          integration: 'nextjs',\n          step: 'installation',\n        },\n      );\n    });\n\n    it('should override tags with properties when keys conflict', () => {\n      const error = new Error('Test error');\n      const properties = { integration: 'react' };\n\n      analytics.setTag('integration', 'nextjs');\n      analytics.captureException(error, properties);\n\n      expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(\n        error,\n        'test-uuid',\n        {\n          team: 'growth',\n          $app_name: 'wizard',\n          integration: 'react',\n        },\n      );\n    });\n\n    it('should always include team:growth property in exceptions', () => {\n      const error = new Error('Test error');\n\n      analytics.captureException(error);\n\n      expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(\n        error,\n        'test-uuid',\n        {\n          team: 'growth',\n          $app_name: 'wizard',\n        },\n      );\n    });\n  });\n\n  describe('integration with other methods', () => {\n    it('should work correctly with setTag and captureException', () => {\n      const error = new Error('Test error');\n\n      analytics.setTag('integration', 'nextjs');\n      analytics.setTag('forceInstall', true);\n      analytics.setTag('debug', false);\n\n      analytics.captureException(error, {\n        arguments: JSON.stringify({ installDir: '/test' }),\n        step: 'wizard-execution',\n      });\n\n      expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(\n        error,\n        'test-uuid',\n        {\n          team: 'growth',\n          $app_name: 'wizard',\n          integration: 'nextjs',\n          forceInstall: true,\n          debug: false,\n          arguments: JSON.stringify({ installDir: '/test' }),\n          step: 'wizard-execution',\n        },\n      );\n    });\n\n    it('should work correctly with setDistinctId and captureException', () => {\n      const error = new Error('Test error');\n      const distinctId = 'user-456';\n\n      analytics.setDistinctId(distinctId);\n      analytics.setTag('integration', 'svelte');\n      analytics.captureException(error);\n\n      expect(mockPostHogInstance.captureException).toHaveBeenCalledWith(\n        error,\n        distinctId,\n        {\n          team: 'growth',\n          $app_name: 'wizard',\n          integration: 'svelte',\n        },\n      );\n    });\n  });\n});\n"]}

package/dist/src/utils/analytics.d.ts

@@ -3,11 +3,13 @@ export declare class Analytics {
     private tags;
     private distinctId?;
     private anonymousId;
+    private appName;
     constructor();
     setDistinctId(distinctId: string): void;
     setTag(key: string, value: string | boolean | number | null | undefined): void;
     captureException(error: Error, properties?: Record<string, unknown>): void;
     capture(eventName: string, properties?: Record<string, unknown>): void;
+    getFeatureFlag(flagKey: string): Promise<string | boolean | undefined>;
     shutdown(status: 'success' | 'error' | 'cancelled'): Promise<void>;
 }
 export declare const analytics: Analytics;

package/dist/src/utils/analytics.js

@@ -4,11 +4,13 @@ exports.analytics = exports.Analytics = void 0;
 const posthog_node_1 = require("posthog-node");
 const constants_1 = require("../lib/constants");
 const uuid_1 = require("uuid");
+const debug_1 = require("./debug");
 class Analytics {
     client;
     tags = {};
     distinctId;
     anonymousId;
+    appName = 'wizard';
     constructor() {
         this.client = new posthog_node_1.PostHog(constants_1.ANALYTICS_POSTHOG_PUBLIC_PROJECT_WRITE_KEY, {
             host: constants_1.ANALYTICS_HOST_URL,
@@ -16,7 +18,7 @@ class Analytics {
             flushInterval: 0,
             enableExceptionAutocapture: true,
         });
-        this.tags = {};
+        this.tags = { $app_name: this.appName };
         this.anonymousId = (0, uuid_1.v4)();
         this.distinctId = undefined;
     }
@@ -47,6 +49,21 @@ class Analytics {
             },
         });
     }
+    async getFeatureFlag(flagKey) {
+        try {
+            const distinctId = this.distinctId ?? this.anonymousId;
+            return await this.client.getFeatureFlag(flagKey, distinctId, {
+                sendFeatureFlagEvents: true,
+                personProperties: {
+                    $app_name: this.appName,
+                },
+            });
+        }
+        catch (error) {
+            (0, debug_1.debug)('Failed to get feature flag:', flagKey, error);
+            return undefined;
+        }
+    }
     async shutdown(status) {
         if (Object.keys(this.tags).length === 0) {
             return;

package/dist/src/utils/analytics.js.map

@@ -1 +1 @@
-{"version":3,"file":"analytics.js","sourceRoot":"","sources":["../../../src/utils/analytics.ts"],"names":[],"mappings":";;;AAAA,+CAAuC;AACvC,gDAG0B;AAC1B,+BAAoC;AACpC,MAAa,SAAS;IACZ,MAAM,CAAU;IAChB,IAAI,GACV,EAAE,CAAC;IACG,UAAU,CAAU;IACpB,WAAW,CAAS;IAE5B;QACE,IAAI,CAAC,MAAM,GAAG,IAAI,sBAAO,CAAC,sDAA0C,EAAE;YACpE,IAAI,EAAE,8BAAkB;YACxB,OAAO,EAAE,CAAC;YACV,aAAa,EAAE,CAAC;YAChB,0BAA0B,EAAE,IAAI;SACjC,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,GAAG,EAAE,CAAC;QAEf,IAAI,CAAC,WAAW,GAAG,IAAA,SAAM,GAAE,CAAC;QAE5B,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAC9B,CAAC;IAED,aAAa,CAAC,UAAkB;QAC9B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;YAChB,UAAU;YACV,KAAK,EAAE,IAAI,CAAC,WAAW;SACxB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,GAAW,EAAE,KAAmD;QACrE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACzB,CAAC;IAED,gBAAgB,CAAC,KAAY,EAAE,aAAsC,EAAE;QACrE,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,WAAW,EAAE;YACvE,IAAI,EAAE,QAAQ;YACd,GAAG,IAAI,CAAC,IAAI;YACZ,GAAG,UAAU;SACd,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CAAC,SAAiB,EAAE,UAAoC;QAC7D,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;YAClB,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,WAAW;YAC/C,KAAK,EAAE,SAAS;YAChB,UAAU,EAAE;gBACV,GAAG,IAAI,CAAC,IAAI;gBACZ,GAAG,UAAU;aACd;SACF,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAyC;QACtD,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxC,OAAO;QACT,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;YAClB,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,WAAW;YAC/C,KAAK,EAAE,uBAAuB;YAC9B,UAAU,EAAE;gBACV,MAAM;gBACN,IAAI,EAAE,IAAI,CAAC,IAAI;aAChB;SACF,CAAC,CAAC;QAEH,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC/B,CAAC;CACF;AArED,8BAqEC;AAEY,QAAA,SAAS,GAAG,IAAI,SAAS,EAAE,CAAC","sourcesContent":["import { PostHog } from 'posthog-node';\nimport {\n  ANALYTICS_HOST_URL,\n  ANALYTICS_POSTHOG_PUBLIC_PROJECT_WRITE_KEY,\n} from '../lib/constants';\nimport { v4 as uuidv4 } from 'uuid';\nexport class Analytics {\n  private client: PostHog;\n  private tags: Record<string, string | boolean | number | null | undefined> =\n    {};\n  private distinctId?: string;\n  private anonymousId: string;\n\n  constructor() {\n    this.client = new PostHog(ANALYTICS_POSTHOG_PUBLIC_PROJECT_WRITE_KEY, {\n      host: ANALYTICS_HOST_URL,\n      flushAt: 1,\n      flushInterval: 0,\n      enableExceptionAutocapture: true,\n    });\n\n    this.tags = {};\n\n    this.anonymousId = uuidv4();\n\n    this.distinctId = undefined;\n  }\n\n  setDistinctId(distinctId: string) {\n    this.distinctId = distinctId;\n    this.client.alias({\n      distinctId,\n      alias: this.anonymousId,\n    });\n  }\n\n  setTag(key: string, value: string | boolean | number | null | undefined) {\n    this.tags[key] = value;\n  }\n\n  captureException(error: Error, properties: Record<string, unknown> = {}) {\n    this.client.captureException(error, this.distinctId ?? this.anonymousId, {\n      team: 'growth',\n      ...this.tags,\n      ...properties,\n    });\n  }\n\n  capture(eventName: string, properties?: Record<string, unknown>) {\n    this.client.capture({\n      distinctId: this.distinctId ?? this.anonymousId,\n      event: eventName,\n      properties: {\n        ...this.tags,\n        ...properties,\n      },\n    });\n  }\n\n  async shutdown(status: 'success' | 'error' | 'cancelled') {\n    if (Object.keys(this.tags).length === 0) {\n      return;\n    }\n\n    this.client.capture({\n      distinctId: this.distinctId ?? this.anonymousId,\n      event: 'setup wizard finished',\n      properties: {\n        status,\n        tags: this.tags,\n      },\n    });\n\n    await this.client.shutdown();\n  }\n}\n\nexport const analytics = new Analytics();\n"]}
+{"version":3,"file":"analytics.js","sourceRoot":"","sources":["../../../src/utils/analytics.ts"],"names":[],"mappings":";;;AAAA,+CAAuC;AACvC,gDAG0B;AAC1B,+BAAoC;AACpC,mCAAgC;AAChC,MAAa,SAAS;IACZ,MAAM,CAAU;IAChB,IAAI,GACV,EAAE,CAAC;IACG,UAAU,CAAU;IACpB,WAAW,CAAS;IACpB,OAAO,GAAG,QAAQ,CAAC;IAE3B;QACE,IAAI,CAAC,MAAM,GAAG,IAAI,sBAAO,CAAC,sDAA0C,EAAE;YACpE,IAAI,EAAE,8BAAkB;YACxB,OAAO,EAAE,CAAC;YACV,aAAa,EAAE,CAAC;YAChB,0BAA0B,EAAE,IAAI;SACjC,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;QAExC,IAAI,CAAC,WAAW,GAAG,IAAA,SAAM,GAAE,CAAC;QAE5B,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAC9B,CAAC;IAED,aAAa,CAAC,UAAkB;QAC9B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;YAChB,UAAU;YACV,KAAK,EAAE,IAAI,CAAC,WAAW;SACxB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,GAAW,EAAE,KAAmD;QACrE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACzB,CAAC;IAED,gBAAgB,CAAC,KAAY,EAAE,aAAsC,EAAE;QACrE,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,WAAW,EAAE;YACvE,IAAI,EAAE,QAAQ;YACd,GAAG,IAAI,CAAC,IAAI;YACZ,GAAG,UAAU;SACd,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CAAC,SAAiB,EAAE,UAAoC;QAC7D,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;YAClB,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,WAAW;YAC/C,KAAK,EAAE,SAAS;YAChB,UAAU,EAAE;gBACV,GAAG,IAAI,CAAC,IAAI;gBACZ,GAAG,UAAU;aACd;SACF,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,OAAe;QAClC,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,WAAW,CAAC;YACvD,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,UAAU,EAAE;gBAC3D,qBAAqB,EAAE,IAAI;gBAC3B,gBAAgB,EAAE;oBAChB,SAAS,EAAE,IAAI,CAAC,OAAO;iBACxB;aACF,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAA,aAAK,EAAC,6BAA6B,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;YACrD,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAyC;QACtD,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxC,OAAO;QACT,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;YAClB,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,WAAW;YAC/C,KAAK,EAAE,uBAAuB;YAC9B,UAAU,EAAE;gBACV,MAAM;gBACN,IAAI,EAAE,IAAI,CAAC,IAAI;aAChB;SACF,CAAC,CAAC;QAEH,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC/B,CAAC;CACF;AArFD,8BAqFC;AAEY,QAAA,SAAS,GAAG,IAAI,SAAS,EAAE,CAAC","sourcesContent":["import { PostHog } from 'posthog-node';\nimport {\n  ANALYTICS_HOST_URL,\n  ANALYTICS_POSTHOG_PUBLIC_PROJECT_WRITE_KEY,\n} from '../lib/constants';\nimport { v4 as uuidv4 } from 'uuid';\nimport { debug } from './debug';\nexport class Analytics {\n  private client: PostHog;\n  private tags: Record<string, string | boolean | number | null | undefined> =\n    {};\n  private distinctId?: string;\n  private anonymousId: string;\n  private appName = 'wizard';\n\n  constructor() {\n    this.client = new PostHog(ANALYTICS_POSTHOG_PUBLIC_PROJECT_WRITE_KEY, {\n      host: ANALYTICS_HOST_URL,\n      flushAt: 1,\n      flushInterval: 0,\n      enableExceptionAutocapture: true,\n    });\n\n    this.tags = { $app_name: this.appName };\n\n    this.anonymousId = uuidv4();\n\n    this.distinctId = undefined;\n  }\n\n  setDistinctId(distinctId: string) {\n    this.distinctId = distinctId;\n    this.client.alias({\n      distinctId,\n      alias: this.anonymousId,\n    });\n  }\n\n  setTag(key: string, value: string | boolean | number | null | undefined) {\n    this.tags[key] = value;\n  }\n\n  captureException(error: Error, properties: Record<string, unknown> = {}) {\n    this.client.captureException(error, this.distinctId ?? this.anonymousId, {\n      team: 'growth',\n      ...this.tags,\n      ...properties,\n    });\n  }\n\n  capture(eventName: string, properties?: Record<string, unknown>) {\n    this.client.capture({\n      distinctId: this.distinctId ?? this.anonymousId,\n      event: eventName,\n      properties: {\n        ...this.tags,\n        ...properties,\n      },\n    });\n  }\n\n  async getFeatureFlag(flagKey: string): Promise<string | boolean | undefined> {\n    try {\n      const distinctId = this.distinctId ?? this.anonymousId;\n      return await this.client.getFeatureFlag(flagKey, distinctId, {\n        sendFeatureFlagEvents: true,\n        personProperties: {\n          $app_name: this.appName,\n        },\n      });\n    } catch (error) {\n      debug('Failed to get feature flag:', flagKey, error);\n      return undefined;\n    }\n  }\n\n  async shutdown(status: 'success' | 'error' | 'cancelled') {\n    if (Object.keys(this.tags).length === 0) {\n      return;\n    }\n\n    this.client.capture({\n      distinctId: this.distinctId ?? this.anonymousId,\n      event: 'setup wizard finished',\n      properties: {\n        status,\n        tags: this.tags,\n      },\n    });\n\n    await this.client.shutdown();\n  }\n}\n\nexport const analytics = new Analytics();\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@posthog/wizard",
-  "version": "1.15.0",
+  "version": "1.16.1",
   "homepage": "https://github.com/posthog/wizard",
   "repository": "https://github.com/posthog/wizard",
   "description": "The PostHog wizard helps you to configure your project",
@@ -35,6 +35,7 @@
     "@clack/core": "^0.3.4",
     "@clack/prompts": "0.7.0",
     "@langchain/core": "^0.3.40",
+    "@posthog/agent": "1.11.0",
     "axios": "1.7.4",
     "chalk": "^2.4.1",
     "fast-glob": "^3.3.3",
@@ -114,7 +115,10 @@
       "\\.no-jest\\.(jsx?|tsx?)$",
       "/e2e-tests/"
     ],
-    "testEnvironment": "node"
+    "testEnvironment": "node",
+    "moduleNameMapper": {
+      "^@posthog/agent$": "<rootDir>/__mocks__/@posthog/agent.ts"
+    }
   },
   "lint-staged": {
     "*.{js,ts,tsx,jsx}": "pnpm fix"