@posthog/wizard 1.36.1 → 2.0.0

package/dist/src/ui/tui/screens/SettingsOverrideScreen.d.ts

@@ -0,0 +1,10 @@
+/**
+ * SettingsOverrideScreen — Modal when .claude/settings.json contains env overrides
+ * that block the Wizard from reaching the PostHog LLM Gateway.
+ */
+import type { WizardStore } from '../store.js';
+interface SettingsOverrideScreenProps {
+    store: WizardStore;
+}
+export declare const SettingsOverrideScreen: ({ store, }: SettingsOverrideScreenProps) => import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/src/ui/tui/screens/SettingsOverrideScreen.js

@@ -0,0 +1,24 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+/**
+ * SettingsOverrideScreen — Modal when .claude/settings.json contains env overrides
+ * that block the Wizard from reaching the PostHog LLM Gateway.
+ */
+import { Box, Text } from 'ink';
+import { useState, useSyncExternalStore } from 'react';
+import { ConfirmationInput } from '../primitives/index.js';
+import { Icons } from '../styles.js';
+export const SettingsOverrideScreen = ({ store, }) => {
+    useSyncExternalStore((cb) => store.subscribe(cb), () => store.getSnapshot());
+    const [feedback, setFeedback] = useState(null);
+    const keys = store.session.settingsOverrideKeys;
+    if (!keys || keys.length === 0) {
+        return null;
+    }
+    return (_jsx(Box, { flexDirection: "column", flexGrow: 1, alignItems: "center", justifyContent: "center", children: _jsxs(Box, { flexDirection: "column", borderStyle: "round", borderColor: "red", paddingX: 3, paddingY: 1, width: 64, children: [_jsx(Box, { justifyContent: "center", marginBottom: 1, children: _jsxs(Text, { color: "red", bold: true, children: [Icons.warning, " Settings Conflict"] }) }), _jsxs(Text, { children: ["Your project's ", _jsx(Text, { bold: true, children: ".claude/settings.json" }), " sets:"] }), _jsx(Box, { flexDirection: "column", marginY: 1, paddingLeft: 2, children: keys.map((key) => (_jsxs(Text, { children: [Icons.bullet, ' ', _jsx(Text, { color: "yellow", bold: true, children: key })] }, key))) }), _jsx(Text, { dimColor: true, children: "These overrides prevent the Wizard from reaching the PostHog LLM Gateway. We can back up the file and continue." }), feedback && (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: "yellow", children: [Icons.warning, " ", feedback] }) })), _jsx(Box, { marginY: 1, children: _jsx(Text, { dimColor: true, children: '─'.repeat(56) }) }), _jsx(ConfirmationInput, { message: "Back up to .wizard-backup and continue?", confirmLabel: "Backup & continue [Enter]", cancelLabel: "Exit [Esc]", onConfirm: () => {
+                        const ok = store.backupAndFixSettingsOverride();
+                        if (!ok) {
+                            setFeedback('Could not back up the settings file.');
+                        }
+                    }, onCancel: () => process.exit(1) })] }) }));
+};
+//# sourceMappingURL=SettingsOverrideScreen.js.map

package/dist/src/ui/tui/screens/SettingsOverrideScreen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SettingsOverrideScreen.js","sourceRoot":"","sources":["../../../../../src/ui/tui/screens/SettingsOverrideScreen.tsx"],"names":[],"mappings":";AAAA;;;GAGG;AAEH,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAEvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAMrC,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,EACrC,KAAK,GACuB,EAAE,EAAE;IAChC,oBAAoB,CAClB,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,EAC3B,GAAG,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAC1B,CAAC;IAEF,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAgB,IAAI,CAAC,CAAC;IAC9D,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,oBAAoB,CAAC;IAEhD,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CACL,KAAC,GAAG,IACF,aAAa,EAAC,QAAQ,EACtB,QAAQ,EAAE,CAAC,EACX,UAAU,EAAC,QAAQ,EACnB,cAAc,EAAC,QAAQ,YAEvB,MAAC,GAAG,IACF,aAAa,EAAC,QAAQ,EACtB,WAAW,EAAC,OAAO,EACnB,WAAW,EAAC,KAAK,EACjB,QAAQ,EAAE,CAAC,EACX,QAAQ,EAAE,CAAC,EACX,KAAK,EAAE,EAAE,aAET,KAAC,GAAG,IAAC,cAAc,EAAC,QAAQ,EAAC,YAAY,EAAE,CAAC,YAC1C,MAAC,IAAI,IAAC,KAAK,EAAC,KAAK,EAAC,IAAI,mBACnB,KAAK,CAAC,OAAO,0BACT,GACH,EAEN,MAAC,IAAI,kCACiB,KAAC,IAAI,IAAC,IAAI,4CAA6B,cACtD,EACP,KAAC,GAAG,IAAC,aAAa,EAAC,QAAQ,EAAC,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,YACnD,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CACjB,MAAC,IAAI,eACF,KAAK,CAAC,MAAM,EAAE,GAAG,EAClB,KAAC,IAAI,IAAC,KAAK,EAAC,QAAQ,EAAC,IAAI,kBACtB,GAAG,GACC,KAJE,GAAG,CAKP,CACR,CAAC,GACE,EACN,KAAC,IAAI,IAAC,QAAQ,sIAGP,EAEN,QAAQ,IAAI,CACX,KAAC,GAAG,IAAC,SAAS,EAAE,CAAC,YACf,MAAC,IAAI,IAAC,KAAK,EAAC,QAAQ,aACjB,KAAK,CAAC,OAAO,OAAG,QAAQ,IACpB,GACH,CACP,EAED,KAAC,GAAG,IAAC,OAAO,EAAE,CAAC,YACb,KAAC,IAAI,IAAC,QAAQ,kBAAE,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAQ,GAClC,EAEN,KAAC,iBAAiB,IAChB,OAAO,EAAC,yCAAyC,EACjD,YAAY,EAAC,2BAA2B,EACxC,WAAW,EAAC,YAAY,EACxB,SAAS,EAAE,GAAG,EAAE;wBACd,MAAM,EAAE,GAAG,KAAK,CAAC,4BAA4B,EAAE,CAAC;wBAChD,IAAI,CAAC,EAAE,EAAE,CAAC;4BACR,WAAW,CAAC,sCAAsC,CAAC,CAAC;wBACtD,CAAC;oBACH,CAAC,EACD,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,GAC/B,IACE,GACF,CACP,CAAC;AACJ,CAAC,CAAC","sourcesContent":["/**\n * SettingsOverrideScreen — Modal when .claude/settings.json contains env overrides\n * that block the Wizard from reaching the PostHog LLM Gateway.\n */\n\nimport { Box, Text } from 'ink';\nimport { useState, useSyncExternalStore } from 'react';\nimport type { WizardStore } from '../store.js';\nimport { ConfirmationInput } from '../primitives/index.js';\nimport { Icons } from '../styles.js';\n\ninterface SettingsOverrideScreenProps {\n  store: WizardStore;\n}\n\nexport const SettingsOverrideScreen = ({\n  store,\n}: SettingsOverrideScreenProps) => {\n  useSyncExternalStore(\n    (cb) => store.subscribe(cb),\n    () => store.getSnapshot(),\n  );\n\n  const [feedback, setFeedback] = useState<string | null>(null);\n  const keys = store.session.settingsOverrideKeys;\n\n  if (!keys || keys.length === 0) {\n    return null;\n  }\n\n  return (\n    <Box\n      flexDirection=\"column\"\n      flexGrow={1}\n      alignItems=\"center\"\n      justifyContent=\"center\"\n    >\n      <Box\n        flexDirection=\"column\"\n        borderStyle=\"round\"\n        borderColor=\"red\"\n        paddingX={3}\n        paddingY={1}\n        width={64}\n      >\n        <Box justifyContent=\"center\" marginBottom={1}>\n          <Text color=\"red\" bold>\n            {Icons.warning} Settings Conflict\n          </Text>\n        </Box>\n\n        <Text>\n          Your project&apos;s <Text bold>.claude/settings.json</Text> sets:\n        </Text>\n        <Box flexDirection=\"column\" marginY={1} paddingLeft={2}>\n          {keys.map((key) => (\n            <Text key={key}>\n              {Icons.bullet}{' '}\n              <Text color=\"yellow\" bold>\n                {key}\n              </Text>\n            </Text>\n          ))}\n        </Box>\n        <Text dimColor>\n          These overrides prevent the Wizard from reaching the PostHog LLM\n          Gateway. We can back up the file and continue.\n        </Text>\n\n        {feedback && (\n          <Box marginTop={1}>\n            <Text color=\"yellow\">\n              {Icons.warning} {feedback}\n            </Text>\n          </Box>\n        )}\n\n        <Box marginY={1}>\n          <Text dimColor>{'─'.repeat(56)}</Text>\n        </Box>\n\n        <ConfirmationInput\n          message=\"Back up to .wizard-backup and continue?\"\n          confirmLabel=\"Backup & continue [Enter]\"\n          cancelLabel=\"Exit [Esc]\"\n          onConfirm={() => {\n            const ok = store.backupAndFixSettingsOverride();\n            if (!ok) {\n              setFeedback('Could not back up the settings file.');\n            }\n          }}\n          onCancel={() => process.exit(1)}\n        />\n      </Box>\n    </Box>\n  );\n};\n"]}

package/dist/src/ui/tui/screens/SetupScreen.d.ts

@@ -0,0 +1,13 @@
+/**
+ * SetupScreen — Generic framework disambiguation.
+ *
+ * Iterates unresolved setup questions from the FrameworkConfig
+ * and renders a PickerMenu for each. If all questions are auto-resolved,
+ * this screen is skipped entirely (the router skips it via its show() predicate).
+ */
+import type { WizardStore } from '../store.js';
+interface SetupScreenProps {
+    store: WizardStore;
+}
+export declare const SetupScreen: ({ store }: SetupScreenProps) => import("react/jsx-runtime").JSX.Element | null;
+export {};

package/dist/src/ui/tui/screens/SetupScreen.js

@@ -0,0 +1,74 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * SetupScreen — Generic framework disambiguation.
+ *
+ * Iterates unresolved setup questions from the FrameworkConfig
+ * and renders a PickerMenu for each. If all questions are auto-resolved,
+ * this screen is skipped entirely (the router skips it via its show() predicate).
+ */
+import { Box, Text } from 'ink';
+import { useState, useEffect } from 'react';
+import { useSyncExternalStore } from 'react';
+import { PickerMenu } from '../primitives/index.js';
+import { Colors } from '../styles.js';
+export const SetupScreen = ({ store }) => {
+    useSyncExternalStore((cb) => store.subscribe(cb), () => store.getSnapshot());
+    const config = store.session.frameworkConfig;
+    const questions = config?.metadata.setup?.questions ?? [];
+    // Track which question index we're currently showing
+    const [currentIndex, setCurrentIndex] = useState(0);
+    const [resolving, setResolving] = useState(true);
+    // On mount, run auto-detection for all questions
+    useEffect(() => {
+        void (async () => {
+            for (const q of questions) {
+                // Skip if already resolved (e.g. by CLI arg)
+                if (q.key in store.session.frameworkContext)
+                    continue;
+                try {
+                    const detected = await q.detect({
+                        installDir: store.session.installDir,
+                    });
+                    if (detected !== null) {
+                        store.setFrameworkContext(q.key, detected);
+                    }
+                }
+                catch {
+                    // Detection failed — will ask the user
+                }
+            }
+            setResolving(false);
+            // If all resolved, the router's isComplete predicate will
+            // resolve past this screen on the next render cycle.
+        })();
+    }, []);
+    if (resolving) {
+        return (_jsx(Box, { flexDirection: "column", flexGrow: 1, children: _jsx(Text, { dimColor: true, children: "Detecting project configuration..." }) }));
+    }
+    // Get unresolved questions
+    const unresolved = questions.filter((q) => !(q.key in store.session.frameworkContext));
+    if (unresolved.length === 0) {
+        // All resolved — should have already advanced
+        return null;
+    }
+    const question = unresolved[currentIndex] ?? unresolved[0];
+    if (!question)
+        return null;
+    return (_jsxs(Box, { flexDirection: "column", flexGrow: 1, children: [_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsx(Text, { bold: true, color: Colors.accent, children: "Project Setup" }), config && (_jsxs(Text, { dimColor: true, children: ["Configuring ", config.metadata.name, " integration"] }))] }), _jsx(PickerMenu, { message: question.message, options: question.options.map((o) => ({
+                    label: o.label,
+                    value: o.value,
+                    hint: o.hint,
+                })), onSelect: (value) => {
+                    const selected = Array.isArray(value) ? value[0] : value;
+                    store.setFrameworkContext(question.key, selected);
+                    // Check if more unresolved questions remain
+                    const remaining = unresolved.filter((q) => q.key !== question.key &&
+                        !(q.key in store.session.frameworkContext));
+                    if (remaining.length > 0) {
+                        setCurrentIndex((i) => i + 1);
+                    }
+                    // When no remaining questions, setFrameworkContext already
+                    // triggered emitChange — router resolves past this screen.
+                } })] }));
+};
+//# sourceMappingURL=SetupScreen.js.map

package/dist/src/ui/tui/screens/SetupScreen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SetupScreen.js","sourceRoot":"","sources":["../../../../../src/ui/tui/screens/SetupScreen.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * SetupScreen — Generic framework disambiguation.\n *\n * Iterates unresolved setup questions from the FrameworkConfig\n * and renders a PickerMenu for each. If all questions are auto-resolved,\n * this screen is skipped entirely (the router skips it via its show() predicate).\n */\n\nimport { Box, Text } from 'ink';\nimport { useState, useEffect } from 'react';\nimport { useSyncExternalStore } from 'react';\nimport type { WizardStore } from '../store.js';\nimport { PickerMenu } from '../primitives/index.js';\nimport { Colors } from '../styles.js';\nimport type { SetupQuestion } from '../../../lib/framework-config.js';\n\ninterface SetupScreenProps {\n  store: WizardStore;\n}\n\nexport const SetupScreen = ({ store }: SetupScreenProps) => {\n  useSyncExternalStore(\n    (cb) => store.subscribe(cb),\n    () => store.getSnapshot(),\n  );\n\n  const config = store.session.frameworkConfig;\n  const questions = config?.metadata.setup?.questions ?? [];\n\n  // Track which question index we're currently showing\n  const [currentIndex, setCurrentIndex] = useState(0);\n  const [resolving, setResolving] = useState(true);\n\n  // On mount, run auto-detection for all questions\n  useEffect(() => {\n    void (async () => {\n      for (const q of questions) {\n        // Skip if already resolved (e.g. by CLI arg)\n        if (q.key in store.session.frameworkContext) continue;\n\n        try {\n          const detected = await q.detect({\n            installDir: store.session.installDir,\n          });\n          if (detected !== null) {\n            store.setFrameworkContext(q.key, detected);\n          }\n        } catch {\n          // Detection failed — will ask the user\n        }\n      }\n      setResolving(false);\n\n      // If all resolved, the router's isComplete predicate will\n      // resolve past this screen on the next render cycle.\n    })();\n  }, []);\n\n  if (resolving) {\n    return (\n      <Box flexDirection=\"column\" flexGrow={1}>\n        <Text dimColor>Detecting project configuration...</Text>\n      </Box>\n    );\n  }\n\n  // Get unresolved questions\n  const unresolved = questions.filter(\n    (q: SetupQuestion) => !(q.key in store.session.frameworkContext),\n  );\n\n  if (unresolved.length === 0) {\n    // All resolved — should have already advanced\n    return null;\n  }\n\n  const question = unresolved[currentIndex] ?? unresolved[0];\n  if (!question) return null;\n\n  return (\n    <Box flexDirection=\"column\" flexGrow={1}>\n      <Box flexDirection=\"column\" marginBottom={1}>\n        <Text bold color={Colors.accent}>\n          Project Setup\n        </Text>\n        {config && (\n          <Text dimColor>Configuring {config.metadata.name} integration</Text>\n        )}\n      </Box>\n\n      <PickerMenu<string>\n        message={question.message}\n        options={question.options.map((o) => ({\n          label: o.label,\n          value: o.value,\n          hint: o.hint,\n        }))}\n        onSelect={(value) => {\n          const selected = Array.isArray(value) ? value[0] : value;\n          store.setFrameworkContext(question.key, selected);\n\n          // Check if more unresolved questions remain\n          const remaining = unresolved.filter(\n            (q: SetupQuestion) =>\n              q.key !== question.key &&\n              !(q.key in store.session.frameworkContext),\n          );\n\n          if (remaining.length > 0) {\n            setCurrentIndex((i) => i + 1);\n          }\n          // When no remaining questions, setFrameworkContext already\n          // triggered emitChange — router resolves past this screen.\n        }}\n      />\n    </Box>\n  );\n};\n"]}

package/dist/src/ui/tui/services/mcp-installer.d.ts

@@ -0,0 +1,21 @@
+/**
+ * McpInstaller — service layer between McpScreen and MCP business logic.
+ *
+ * Decouples the screen from step internals. Testable, swappable,
+ * no dynamic imports in React components.
+ */
+export interface McpClientInfo {
+    name: string;
+}
+export interface McpInstaller {
+    /** Detect which MCP-capable editors are available on this machine. */
+    detectClients(): Promise<McpClientInfo[]>;
+    /** Install the PostHog MCP server to the given clients. Returns names of successfully installed clients. */
+    install(clientNames: string[]): Promise<string[]>;
+    /** Remove the PostHog MCP server from all installed clients. Returns names of removed clients. */
+    remove(): Promise<string[]>;
+}
+/**
+ * Production McpInstaller backed by real MCP client detection and installation.
+ */
+export declare function createMcpInstaller(): McpInstaller;

package/dist/src/ui/tui/services/mcp-installer.js

@@ -0,0 +1,58 @@
+/**
+ * McpInstaller — service layer between McpScreen and MCP business logic.
+ *
+ * Decouples the screen from step internals. Testable, swappable,
+ * no dynamic imports in React components.
+ */
+import { getSupportedClients, removeMCPServer, getInstalledClients, } from '../../../steps/add-mcp-server-to-clients/index.js';
+import { ALL_FEATURE_VALUES } from '../../../steps/add-mcp-server-to-clients/defaults.js';
+import { logToFile } from '../../../utils/debug.js';
+/**
+ * Production McpInstaller backed by real MCP client detection and installation.
+ */
+export function createMcpInstaller() {
+    // Cache the raw MCPClient objects so install() can reference them by name
+    let cachedClients = [];
+    return {
+        async detectClients() {
+            const supported = await getSupportedClients();
+            cachedClients = supported.map((c) => ({ name: c.name, raw: c }));
+            return supported.map((c) => ({ name: c.name }));
+        },
+        async install(clientNames) {
+            const features = [...ALL_FEATURE_VALUES];
+            const toInstall = cachedClients
+                .filter((c) => clientNames.includes(c.name))
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                .map((c) => c.raw);
+            if (toInstall.length === 0) {
+                logToFile(`[McpInstaller] No clients matched. clientNames=${JSON.stringify(clientNames)}, cached=${JSON.stringify(cachedClients.map((c) => c.name))}`);
+                return [];
+            }
+            const installed = [];
+            for (const client of toInstall) {
+                try {
+                    const result = await client.addServer(undefined, features, false);
+                    if (result?.success) {
+                        installed.push(client.name);
+                    }
+                    else {
+                        logToFile(`[McpInstaller] addServer returned success=false for ${client.name}`);
+                    }
+                }
+                catch (err) {
+                    logToFile(`[McpInstaller] addServer threw for ${client.name}: ${err instanceof Error ? err.message : String(err)}`);
+                }
+            }
+            return installed;
+        },
+        async remove() {
+            const installed = await getInstalledClients();
+            if (installed.length === 0)
+                return [];
+            await removeMCPServer(installed);
+            return installed.map((c) => c.name);
+        },
+    };
+}
+//# sourceMappingURL=mcp-installer.js.map

package/dist/src/ui/tui/services/mcp-installer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-installer.js","sourceRoot":"","sources":["../../../../../src/ui/tui/services/mcp-installer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,mBAAmB,GACpB,MAAM,mDAAmD,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sDAAsD,CAAC;AAC1F,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAiBpD;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,0EAA0E;IAC1E,IAAI,aAAa,GAA0C,EAAE,CAAC;IAE9D,OAAO;QACL,KAAK,CAAC,aAAa;YACjB,MAAM,SAAS,GAAG,MAAM,mBAAmB,EAAE,CAAC;YAC9C,aAAa,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YACjE,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAClD,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,WAAqB;YACjC,MAAM,QAAQ,GAAG,CAAC,GAAG,kBAAkB,CAAC,CAAC;YACzC,MAAM,SAAS,GAAG,aAAa;iBAC5B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBAC5C,8DAA8D;iBAC7D,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAU,CAAC,CAAC;YAE5B,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3B,SAAS,CACP,kDAAkD,IAAI,CAAC,SAAS,CAC9D,WAAW,CACZ,YAAY,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAChE,CAAC;gBACF,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,MAAM,SAAS,GAAa,EAAE,CAAC;YAC/B,KAAK,MAAM,MAAM,IAAI,SAAS,EAAE,CAAC;gBAC/B,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;oBAClE,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;wBACpB,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,IAAc,CAAC,CAAC;oBACxC,CAAC;yBAAM,CAAC;wBACN,SAAS,CACP,uDAAuD,MAAM,CAAC,IAAI,EAAE,CACrE,CAAC;oBACJ,CAAC;gBACH,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,SAAS,CACP,sCAAsC,MAAM,CAAC,IAAI,KAC/C,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CACjD,EAAE,CACH,CAAC;gBACJ,CAAC;YACH,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,KAAK,CAAC,MAAM;YACV,MAAM,SAAS,GAAG,MAAM,mBAAmB,EAAE,CAAC;YAC9C,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;YACtC,MAAM,eAAe,CAAC,SAAS,CAAC,CAAC;YACjC,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACtC,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["/**\n * McpInstaller — service layer between McpScreen and MCP business logic.\n *\n * Decouples the screen from step internals. Testable, swappable,\n * no dynamic imports in React components.\n */\n\nimport {\n  getSupportedClients,\n  removeMCPServer,\n  getInstalledClients,\n} from '../../../steps/add-mcp-server-to-clients/index.js';\nimport { ALL_FEATURE_VALUES } from '../../../steps/add-mcp-server-to-clients/defaults.js';\nimport { logToFile } from '../../../utils/debug.js';\n\nexport interface McpClientInfo {\n  name: string;\n}\n\nexport interface McpInstaller {\n  /** Detect which MCP-capable editors are available on this machine. */\n  detectClients(): Promise<McpClientInfo[]>;\n\n  /** Install the PostHog MCP server to the given clients. Returns names of successfully installed clients. */\n  install(clientNames: string[]): Promise<string[]>;\n\n  /** Remove the PostHog MCP server from all installed clients. Returns names of removed clients. */\n  remove(): Promise<string[]>;\n}\n\n/**\n * Production McpInstaller backed by real MCP client detection and installation.\n */\nexport function createMcpInstaller(): McpInstaller {\n  // Cache the raw MCPClient objects so install() can reference them by name\n  let cachedClients: Array<{ name: string; raw: unknown }> = [];\n\n  return {\n    async detectClients(): Promise<McpClientInfo[]> {\n      const supported = await getSupportedClients();\n      cachedClients = supported.map((c) => ({ name: c.name, raw: c }));\n      return supported.map((c) => ({ name: c.name }));\n    },\n\n    async install(clientNames: string[]): Promise<string[]> {\n      const features = [...ALL_FEATURE_VALUES];\n      const toInstall = cachedClients\n        .filter((c) => clientNames.includes(c.name))\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        .map((c) => c.raw as any);\n\n      if (toInstall.length === 0) {\n        logToFile(\n          `[McpInstaller] No clients matched. clientNames=${JSON.stringify(\n            clientNames,\n          )}, cached=${JSON.stringify(cachedClients.map((c) => c.name))}`,\n        );\n        return [];\n      }\n\n      const installed: string[] = [];\n      for (const client of toInstall) {\n        try {\n          const result = await client.addServer(undefined, features, false);\n          if (result?.success) {\n            installed.push(client.name as string);\n          } else {\n            logToFile(\n              `[McpInstaller] addServer returned success=false for ${client.name}`,\n            );\n          }\n        } catch (err) {\n          logToFile(\n            `[McpInstaller] addServer threw for ${client.name}: ${\n              err instanceof Error ? err.message : String(err)\n            }`,\n          );\n        }\n      }\n      return installed;\n    },\n\n    async remove(): Promise<string[]> {\n      const installed = await getInstalledClients();\n      if (installed.length === 0) return [];\n      await removeMCPServer(installed);\n      return installed.map((c) => c.name);\n    },\n  };\n}\n"]}

package/dist/src/ui/tui/start-tui.d.ts

@@ -0,0 +1,9 @@
+/**
+ * start-tui.ts — Sets up the Ink TUI renderer and InkUI.
+ */
+import { WizardStore, Flow } from './store.js';
+export declare function startTUI(version: string, flow?: Flow): {
+    unmount: () => void;
+    store: WizardStore;
+    waitForSetup: () => Promise<void>;
+};

package/dist/src/ui/tui/start-tui.js

@@ -0,0 +1,41 @@
+/**
+ * start-tui.ts — Sets up the Ink TUI renderer and InkUI.
+ */
+import { render } from 'ink';
+import { createElement } from 'react';
+import { WizardStore, Flow } from './store.js';
+import { InkUI } from './ink-ui.js';
+import { setUI } from '../index.js';
+import { App } from './App.js';
+// ANSI escape sequences
+const RESET_ATTRS = '\x1b[0m';
+const CLEAR_SCREEN = '\x1b[2J';
+const CURSOR_HOME = '\x1b[H';
+const BG_BLACK = '\x1b[48;2;0;0;0m';
+/** Set background to true black, clear screen, cursor to top-left. */
+const FORCE_DARK = BG_BLACK + CLEAR_SCREEN + CURSOR_HOME;
+export function startTUI(version, flow = Flow.Wizard) {
+    // Force dark background regardless of terminal theme
+    process.stdout.write(FORCE_DARK);
+    const store = new WizardStore(flow);
+    store.version = version;
+    // Swap in the InkUI
+    const inkUI = new InkUI(store);
+    setUI(inkUI);
+    // Render the Ink app
+    const { unmount: inkUnmount } = render(createElement(App, { store }));
+    // Reset terminal on exit
+    const cleanup = () => {
+        process.stdout.write(RESET_ATTRS + CLEAR_SCREEN + CURSOR_HOME);
+    };
+    process.on('exit', cleanup);
+    return {
+        unmount: () => {
+            inkUnmount();
+            cleanup();
+        },
+        store,
+        waitForSetup: () => store.setupComplete,
+    };
+}
+//# sourceMappingURL=start-tui.js.map

package/dist/src/ui/tui/start-tui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start-tui.js","sourceRoot":"","sources":["../../../../src/ui/tui/start-tui.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,wBAAwB;AACxB,MAAM,WAAW,GAAG,SAAS,CAAC;AAC9B,MAAM,YAAY,GAAG,SAAS,CAAC;AAC/B,MAAM,WAAW,GAAG,QAAQ,CAAC;AAC7B,MAAM,QAAQ,GAAG,kBAAkB,CAAC;AAEpC,sEAAsE;AACtE,MAAM,UAAU,GAAG,QAAQ,GAAG,YAAY,GAAG,WAAW,CAAC;AAEzD,MAAM,UAAU,QAAQ,CACtB,OAAe,EACf,OAAa,IAAI,CAAC,MAAM;IAMxB,qDAAqD;IACrD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAEjC,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;IACpC,KAAK,CAAC,OAAO,GAAG,OAAO,CAAC;IAExB,oBAAoB;IACpB,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;IAC/B,KAAK,CAAC,KAAK,CAAC,CAAC;IAEb,qBAAqB;IACrB,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IAEtE,yBAAyB;IACzB,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,GAAG,YAAY,GAAG,WAAW,CAAC,CAAC;IACjE,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE5B,OAAO;QACL,OAAO,EAAE,GAAG,EAAE;YACZ,UAAU,EAAE,CAAC;YACb,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,KAAK;QACL,YAAY,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,aAAa;KACxC,CAAC;AACJ,CAAC","sourcesContent":["/**\n * start-tui.ts — Sets up the Ink TUI renderer and InkUI.\n */\n\nimport { render } from 'ink';\nimport { createElement } from 'react';\nimport { WizardStore, Flow } from './store.js';\nimport { InkUI } from './ink-ui.js';\nimport { setUI } from '../index.js';\nimport { App } from './App.js';\n\n// ANSI escape sequences\nconst RESET_ATTRS = '\\x1b[0m';\nconst CLEAR_SCREEN = '\\x1b[2J';\nconst CURSOR_HOME = '\\x1b[H';\nconst BG_BLACK = '\\x1b[48;2;0;0;0m';\n\n/** Set background to true black, clear screen, cursor to top-left. */\nconst FORCE_DARK = BG_BLACK + CLEAR_SCREEN + CURSOR_HOME;\n\nexport function startTUI(\n  version: string,\n  flow: Flow = Flow.Wizard,\n): {\n  unmount: () => void;\n  store: WizardStore;\n  waitForSetup: () => Promise<void>;\n} {\n  // Force dark background regardless of terminal theme\n  process.stdout.write(FORCE_DARK);\n\n  const store = new WizardStore(flow);\n  store.version = version;\n\n  // Swap in the InkUI\n  const inkUI = new InkUI(store);\n  setUI(inkUI);\n\n  // Render the Ink app\n  const { unmount: inkUnmount } = render(createElement(App, { store }));\n\n  // Reset terminal on exit\n  const cleanup = () => {\n    process.stdout.write(RESET_ATTRS + CLEAR_SCREEN + CURSOR_HOME);\n  };\n  process.on('exit', cleanup);\n\n  return {\n    unmount: () => {\n      inkUnmount();\n      cleanup();\n    },\n    store,\n    waitForSetup: () => store.setupComplete,\n  };\n}\n"]}

package/dist/src/ui/tui/store.d.ts

@@ -0,0 +1,132 @@
+/**
+ * WizardStore — Nanostore-backed reactive store for the TUI.
+ * React components subscribe via useSyncExternalStore.
+ *
+ * Navigation is delegated to WizardRouter.
+ * The active screen is derived from session state — not imperatively set.
+ * Overlays (outage, etc.) are the only imperative navigation.
+ *
+ * All session mutations that affect screen resolution go through
+ * explicit setters so emitChange() is always called.
+ */
+import { TaskStatus } from '../wizard-ui.js';
+import { type WizardSession, type OutroData, type DiscoveredFeature, AdditionalFeature, McpOutcome, RunPhase } from '../../lib/wizard-session.js';
+import { WizardRouter, type ScreenName, Screen, Overlay, Flow } from './router.js';
+export { TaskStatus, Screen, Overlay, Flow, RunPhase, McpOutcome };
+export type { ScreenName, OutroData, WizardSession };
+export interface TaskItem {
+    label: string;
+    activeForm?: string;
+    status: TaskStatus;
+    /** Legacy compat */
+    done: boolean;
+}
+export interface PlannedEvent {
+    name: string;
+    description: string;
+}
+export declare class WizardStore {
+    private $session;
+    private $statusMessages;
+    private $statusExpanded;
+    private $tasks;
+    private $eventPlan;
+    private $learnCardBlockIdx;
+    private $learnCardComplete;
+    private $version;
+    /** Last screen seen — used to detect screen transitions for analytics. */
+    private _lastScreen;
+    /** Hooks run when transitioning onto a screen. */
+    private _enterScreenHooks;
+    version: string;
+    /** Navigation router — resolves active screen from session state. */
+    readonly router: WizardRouter;
+    /**
+     * Setup promise — IntroScreen resolves this when the user confirms.
+     * bin.ts awaits it before calling runWizard.
+     */
+    private _resolveSetup;
+    readonly setupComplete: Promise<void>;
+    /** Blocks agent execution until the settings-override overlay is dismissed. */
+    private _resolveSettingsOverride;
+    private _backupAndFixSettings;
+    constructor(flow?: Flow);
+    get session(): WizardSession;
+    set session(value: WizardSession);
+    get statusMessages(): string[];
+    get tasks(): TaskItem[];
+    get eventPlan(): PlannedEvent[];
+    get statusExpanded(): boolean;
+    toggleStatusExpanded(): void;
+    setStatusExpanded(expanded: boolean): void;
+    /** Unblocks bin.ts via the setupComplete promise. */
+    completeSetup(): void;
+    setRunPhase(phase: RunPhase): void;
+    setCredentials(credentials: WizardSession['credentials']): void;
+    setFrameworkConfig(integration: WizardSession['integration'], config: WizardSession['frameworkConfig']): void;
+    setDetectionComplete(): void;
+    setDetectedFramework(label: string): void;
+    setLoginUrl(url: string | null): void;
+    setServiceStatus(status: {
+        description: string;
+        statusPageUrl: string;
+    } | null): void;
+    /**
+     * Push the settings-override overlay and return a promise that blocks
+     * until the user dismisses it via backupAndFixSettingsOverride().
+     */
+    showSettingsOverride(keys: string[], backupAndFix: () => boolean): Promise<void>;
+    /**
+     * Back up .claude/settings.json. Dismisses the overlay on success.
+     */
+    backupAndFixSettingsOverride(): boolean;
+    addDiscoveredFeature(feature: DiscoveredFeature): void;
+    /**
+     * Enable an additional feature: enqueue it for the stop hook
+     * and set any feature-specific session flags.
+     */
+    enableFeature(feature: AdditionalFeature): void;
+    setMcpComplete(outcome?: McpOutcome, installedClients?: string[]): void;
+    setOutroData(data: OutroData): void;
+    setFrameworkContext(key: string, value: unknown): void;
+    /**
+     * The screen that should be rendered right now.
+     * Derived from session state via the router.
+     */
+    get currentScreen(): ScreenName;
+    /** Direction hint for screen transitions. */
+    get lastNavDirection(): 'push' | 'pop' | null;
+    getVersion(): number;
+    /**
+     * Notify React that state has changed.
+     * The router re-resolves the active screen on next render.
+     */
+    emitChange(): void;
+    pushOverlay(overlay: Overlay): void;
+    popOverlay(): void;
+    /**
+     * Register a callback to run when transitioning onto the given screen.
+     * Fires after every transition that lands on this screen.
+     */
+    onEnterScreen(screen: ScreenName, fn: () => void): void;
+    /**
+     * Detect screen transitions, run enter-screen hooks, and fire analytics.
+     * Called at the end of emitChange/pushOverlay/popOverlay.
+     */
+    private _detectTransition;
+    pushStatus(message: string): void;
+    setTasks(tasks: TaskItem[]): void;
+    updateTask(index: number, done: boolean): void;
+    setEventPlan(events: PlannedEvent[]): void;
+    get learnCardBlockIdx(): number;
+    setLearnCardBlockIdx(idx: number): void;
+    get learnCardComplete(): boolean;
+    setLearnCardComplete(): void;
+    syncTodos(todos: Array<{
+        content: string;
+        status: string;
+        activeForm?: string;
+    }>): void;
+    subscribe(callback: () => void): () => void;
+    getSnapshot(): number;
+}