openalmanac 0.4.0 → 0.4.1

package/dist/setup.js

@@ -1,1216 +0,0 @@
-import { readFileSync, writeFileSync, mkdirSync, existsSync, cpSync } from "fs";
-import { homedir } from "os";
-import { join, dirname } from "path";
-import { fileURLToPath } from "url";
-import { spawnSync } from "child_process";
-import { performLogin } from "./login-core.js";
-import { getAuthStatus } from "./auth.js";
-import { MCP_TOOL_GROUPS, toClaudePermissionName, } from "./tool-registry.js";
-import { EXAMPLE_PROMPT } from "./onboarding-copy.js";
-// MCP-side permission groups come from the shared tool registry so adding a
-// new MCP tool can never silently leave it un-grouped — see
-// `src/tool-registry.ts` for the contract and `test/tool-registry.test.ts`
-// for the drift check that enforces it.
-function mcpGroupToPermissionGroup(group) {
-    return {
-        name: group.name,
-        description: group.description,
-        tools: group.tools.map(toClaudePermissionName),
-    };
-}
-// Built-in Claude Code tool groups — not MCP tools, so they stay defined
-// here. The user opts into them in the same TUI checkbox screen.
-const CLAUDE_BUILTIN_TOOL_GROUPS = [
-    {
-        name: "Local Files",
-        description: "read & edit pages in ~/.openalmanac",
-        tools: [
-            "Read(~/.openalmanac/**)",
-            "Write(~/.openalmanac/**)",
-            "Edit(~/.openalmanac/**)",
-        ],
-    },
-    {
-        name: "Web Access",
-        description: "web search & fetch used during research",
-        tools: ["WebSearch", "WebFetch"],
-    },
-];
-const TOOL_GROUPS = [
-    ...MCP_TOOL_GROUPS.map(mcpGroupToPermissionGroup),
-    ...CLAUDE_BUILTIN_TOOL_GROUPS,
-];
-const AGENTS = [
-    { name: "Claude Code", supported: true },
-    { name: "Codex", supported: false },
-    { name: "Cursor", supported: false },
-    { name: "Windsurf", supported: false },
-];
-/* ── ANSI helpers ───────────────────────────────────────────────── */
-const RST = "\x1b[0m";
-const BOLD = "\x1b[1m";
-const DIM = "\x1b[2m";
-const WHITE_BOLD = "\x1b[1;37m";
-const BLUE = "\x1b[38;5;75m"; // blue for accents
-const BLUE_DIM = "\x1b[38;5;69m"; // slightly deeper blue for boxes
-// Interactive TUI accent
-const ACCENT = "\x1b[38;5;252m"; // silver
-const ACCENT_BG = "\x1b[48;5;252m\x1b[38;5;16m"; // badge: silver bg, black text
-// Banner gradient: white → silver
-const GRADIENT = [
-    "\x1b[38;5;255m",
-    "\x1b[38;5;253m",
-    "\x1b[38;5;251m",
-    "\x1b[38;5;249m",
-    "\x1b[38;5;246m",
-    "\x1b[38;5;243m",
-];
-/* ── ASCII banner ───────────────────────────────────────────────── */
-const LOGO_LINES = [
-    " \u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2557     \u2588\u2588\u2588\u2557   \u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2557   \u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2588\u2588\u2588\u2588\u2557",
-    "\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2551     \u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2588\u2588\u2557  \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255d",
-    "\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2551     \u2588\u2588\u2554\u2588\u2588\u2588\u2588\u2554\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2554\u2588\u2588\u2557 \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2551     ",
-    "\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2551     \u2588\u2588\u2551\u255a\u2588\u2588\u2554\u255d\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2551\u255a\u2588\u2588\u2557\u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2551\u2588\u2588\u2551     ",
-    "\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u2588\u2588\u2551 \u255a\u2550\u255d \u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2551 \u255a\u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551\u255a\u2588\u2588\u2588\u2588\u2588\u2588\u2557",
-    "\u255a\u2550\u255d  \u255a\u2550\u255d\u255a\u2550\u2550\u2550\u2550\u2550\u2550\u255d\u255a\u2550\u255d     \u255a\u2550\u255d\u255a\u2550\u255d  \u255a\u2550\u255d\u255a\u2550\u255d  \u255a\u2550\u2550\u2550\u255d\u255a\u2550\u255d  \u255a\u2550\u255d \u255a\u2550\u2550\u2550\u2550\u2550\u255d",
-];
-function printBanner(subtitle = "Write and publish pages with your AI agent") {
-    process.stdout.write("\n");
-    for (let i = 0; i < LOGO_LINES.length; i++) {
-        process.stdout.write(`${GRADIENT[i]}${LOGO_LINES[i]}${RST}\n`);
-    }
-    process.stdout.write(`\n${WHITE_BOLD}  ${subtitle}${RST}\n`);
-}
-function renderHeader(mode = "default") {
-    printBanner(mode === "reddit"
-        ? "Turn any subreddit into a published wiki"
-        : "Write and publish pages with your AI agent");
-}
-function printBadge() {
-    process.stdout.write(`\n   ${ACCENT_BG} almanac ${RST}\n`);
-}
-/* ── Step indicators ────────────────────────────────────────────── */
-const BAR = `  ${DIM}\u2502${RST}`;
-function stepDone(msg) {
-    process.stdout.write(`  ${BLUE}\u25c7${RST}  ${msg}\n`);
-}
-function stepActive(msg) {
-    process.stdout.write(`  ${BLUE}\u25c6${RST}  ${msg}\n`);
-}
-/* ── Helpers ────────────────────────────────────────────────────── */
-// Strip ANSI codes to measure visible length
-const vis = (s) => s.replace(/\x1b\[[0-9;]*m/g, "").length;
-const w = (s) => process.stdout.write(s + "\n");
-/* ── File helpers ───────────────────────────────────────────────── */
-const CLAUDE_DIR = join(homedir(), ".claude");
-const CLAUDE_JSON = join(homedir(), ".claude.json"); // Claude Code user-scoped MCP config
-const CLAUDE_CODE_MCP = join(CLAUDE_DIR, "mcp.json"); // Claude Code local MCP config
-const SETTINGS_JSON = join(CLAUDE_DIR, "settings.json");
-const CODEX_CONFIG = join(homedir(), ".codex", "config.toml");
-const CURSOR_MCP_JSON = join(homedir(), ".cursor", "mcp.json");
-const OPENCODE_DIR = join(homedir(), ".config", "opencode");
-const OPENCODE_JSON = join(OPENCODE_DIR, "opencode.json");
-const OPENCODE_JSONC = join(OPENCODE_DIR, "opencode.jsonc");
-const WINDSURF_MCP_JSON = join(homedir(), ".codeium", "mcp_config.json");
-function ensureDir(dir) {
-    if (!existsSync(dir))
-        mkdirSync(dir, { recursive: true });
-}
-function readJson(path) {
-    try {
-        return JSON.parse(readFileSync(path, "utf-8"));
-    }
-    catch {
-        return {};
-    }
-}
-function writeJson(path, data) {
-    writeFileSync(path, JSON.stringify(data, null, 2) + "\n");
-}
-/* ── Step 1 — MCP server ───────────────────────────────────────── */
-const ALMANAC_MCP_ENTRY = { command: "npx", args: ["-y", "openalmanac@latest"] };
-const SUPPORTED_CLIENT_IDS = [
-    "claude-code",
-    "claude-desktop",
-    "codex",
-    "cursor",
-    "opencode",
-    "windsurf",
-];
-const SUPPORTED_CLIENTS = {
-    "claude-code": {
-        id: "claude-code",
-        name: "Claude Code",
-        selectionLabel: "Claude Code",
-        detect: () => hasCommand("claude") || existsSync(CLAUDE_JSON) || existsSync(CLAUDE_DIR),
-        configure: (mode) => {
-            const snippets = [
-                {
-                    path: CLAUDE_JSON,
-                    content: jsonSnippet({
-                        mcpServers: {
-                            almanac: { ...ALMANAC_MCP_ENTRY },
-                        },
-                    }),
-                },
-                {
-                    path: CLAUDE_CODE_MCP,
-                    content: jsonSnippet({
-                        mcpServers: {
-                            almanac: { ...ALMANAC_MCP_ENTRY },
-                        },
-                    }),
-                },
-            ];
-            const changedPrimary = configureJsonMcpFile(CLAUDE_JSON, mode);
-            const changedSecondary = configureJsonMcpFile(CLAUDE_CODE_MCP, mode);
-            return { changed: changedPrimary || changedSecondary, snippets };
-        },
-        supportsPermissions: true,
-    },
-    "claude-desktop": {
-        id: "claude-desktop",
-        name: "Claude Desktop",
-        selectionLabel: "Claude Desktop",
-        detect: () => {
-            const path = getClaudeDesktopConfigPath();
-            return Boolean(path && (existsSync(path) || isClaudeDesktopInstalled()));
-        },
-        configure: (mode) => {
-            const path = getClaudeDesktopConfigPath();
-            if (!path)
-                return { changed: false, snippets: [] };
-            return {
-                changed: configureJsonMcpFile(path, mode),
-                snippets: [
-                    {
-                        path,
-                        content: jsonSnippet({
-                            mcpServers: {
-                                almanac: { ...ALMANAC_MCP_ENTRY },
-                            },
-                        }),
-                    },
-                ],
-            };
-        },
-    },
-    codex: {
-        id: "codex",
-        name: "Codex",
-        selectionLabel: "Codex",
-        detect: () => hasCommand("codex") || existsSync(CODEX_CONFIG) || existsSync(join(homedir(), ".codex")),
-        configure: (mode) => ({
-            changed: configureCodexToml(CODEX_CONFIG, mode),
-            snippets: [
-                {
-                    path: CODEX_CONFIG,
-                    content: codexSnippet(),
-                },
-            ],
-        }),
-    },
-    cursor: {
-        id: "cursor",
-        name: "Cursor",
-        selectionLabel: "Cursor",
-        detect: () => hasCommand("cursor-agent") ||
-            existsSync(CURSOR_MCP_JSON) ||
-            existsSync(join(homedir(), ".cursor")),
-        configure: (mode) => ({
-            changed: configureJsonMcpFile(CURSOR_MCP_JSON, mode),
-            snippets: [
-                {
-                    path: CURSOR_MCP_JSON,
-                    content: jsonSnippet({
-                        mcpServers: {
-                            almanac: { ...ALMANAC_MCP_ENTRY },
-                        },
-                    }),
-                },
-            ],
-        }),
-    },
-    opencode: {
-        id: "opencode",
-        name: "OpenCode",
-        selectionLabel: "OpenCode",
-        detect: () => hasCommand("opencode") ||
-            existsSync(OPENCODE_JSON) ||
-            existsSync(OPENCODE_JSONC) ||
-            existsSync(OPENCODE_DIR),
-        configure: (mode) => {
-            const path = getOpenCodeConfigPath();
-            return {
-                changed: configureOpenCodeFile(path, mode),
-                snippets: [
-                    {
-                        path,
-                        content: jsonSnippet({
-                            "$schema": "https://opencode.ai/config.json",
-                            mcp: {
-                                almanac: {
-                                    type: "local",
-                                    command: [ALMANAC_MCP_ENTRY.command, ...ALMANAC_MCP_ENTRY.args],
-                                    enabled: true,
-                                },
-                            },
-                        }),
-                    },
-                ],
-            };
-        },
-    },
-    windsurf: {
-        id: "windsurf",
-        name: "Windsurf",
-        selectionLabel: "Windsurf",
-        detect: () => hasCommand("windsurf") ||
-            existsSync(WINDSURF_MCP_JSON) ||
-            existsSync(join(homedir(), ".codeium")),
-        configure: (mode) => ({
-            changed: configureJsonMcpFile(WINDSURF_MCP_JSON, mode),
-            snippets: [
-                {
-                    path: WINDSURF_MCP_JSON,
-                    content: jsonSnippet({
-                        mcpServers: {
-                            almanac: { ...ALMANAC_MCP_ENTRY },
-                        },
-                    }),
-                },
-            ],
-        }),
-    },
-};
-function parseSetupArgs(argv) {
-    const options = {
-        all: false,
-        clients: [],
-        dryRun: false,
-        print: false,
-        yes: false,
-    };
-    for (let i = 0; i < argv.length; i++) {
-        const arg = argv[i];
-        if (arg === "--all") {
-            options.all = true;
-            continue;
-        }
-        if (arg === "--print") {
-            options.print = true;
-            continue;
-        }
-        if (arg === "--dry-run") {
-            options.dryRun = true;
-            continue;
-        }
-        if (arg === "--yes" || arg === "-y") {
-            options.yes = true;
-            continue;
-        }
-        if (arg === "--client") {
-            const value = argv[i + 1];
-            if (!value) {
-                throw new Error("Missing value for --client");
-            }
-            i++;
-            options.clients.push(...parseClientList(value));
-            continue;
-        }
-        if (arg.startsWith("--client=")) {
-            options.clients.push(...parseClientList(arg.slice("--client=".length)));
-            continue;
-        }
-        throw new Error(`Unknown setup flag: ${arg}`);
-    }
-    if (options.all && options.clients.length > 0) {
-        throw new Error("Use either --all or --client, not both");
-    }
-    options.clients = Array.from(new Set(options.clients));
-    return options;
-}
-function parseClientList(value) {
-    return value
-        .split(",")
-        .map((part) => part.trim().toLowerCase())
-        .filter(Boolean)
-        .map((part) => normalizeClientId(part));
-}
-function normalizeClientId(value) {
-    const aliases = {
-        claude: "claude-code",
-        "claude-code": "claude-code",
-        "claude-desktop": "claude-desktop",
-        desktop: "claude-desktop",
-        codex: "codex",
-        cursor: "cursor",
-        opencode: "opencode",
-        windsurf: "windsurf",
-    };
-    const normalized = aliases[value];
-    if (!normalized) {
-        throw new Error(`Unsupported client "${value}". Supported clients: ${SUPPORTED_CLIENT_IDS.join(", ")}`);
-    }
-    return normalized;
-}
-function hasCommand(command) {
-    const checker = process.platform === "win32" ? "where" : "which";
-    const result = spawnSync(checker, [command], { stdio: "ignore" });
-    return result.status === 0;
-}
-function getClaudeDesktopConfigPath() {
-    if (process.platform === "darwin") {
-        return join(homedir(), "Library", "Application Support", "Claude", "claude_desktop_config.json");
-    }
-    if (process.platform === "linux") {
-        return join(homedir(), ".config", "Claude", "claude_desktop_config.json");
-    }
-    if (process.platform === "win32") {
-        const appData = process.env.APPDATA;
-        if (!appData)
-            return null;
-        return join(appData, "Claude", "claude_desktop_config.json");
-    }
-    return null;
-}
-function isClaudeDesktopInstalled() {
-    if (process.platform === "darwin") {
-        return (existsSync("/Applications/Claude.app") ||
-            existsSync(join(homedir(), "Applications", "Claude.app")));
-    }
-    if (process.platform === "linux") {
-        return (existsSync("/usr/share/applications/claude.desktop") ||
-            existsSync(join(homedir(), ".local", "share", "applications", "claude.desktop")) ||
-            existsSync("/opt/Claude/claude"));
-    }
-    if (process.platform === "win32") {
-        const localAppData = process.env.LOCALAPPDATA;
-        const programFiles = process.env.ProgramFiles;
-        return Boolean((localAppData &&
-            existsSync(join(localAppData, "Programs", "Claude", "Claude.exe"))) ||
-            (programFiles && existsSync(join(programFiles, "Claude", "Claude.exe"))));
-    }
-    return false;
-}
-function jsonSnippet(data) {
-    return JSON.stringify(data, null, 2);
-}
-function getOpenCodeConfigPath() {
-    if (existsSync(OPENCODE_JSON))
-        return OPENCODE_JSON;
-    if (existsSync(OPENCODE_JSONC))
-        return OPENCODE_JSONC;
-    return OPENCODE_JSON;
-}
-function codexSnippet() {
-    return [
-        "[mcp_servers.almanac]",
-        `command = ${tomlString(ALMANAC_MCP_ENTRY.command)}`,
-        `args = ${tomlArray(ALMANAC_MCP_ENTRY.args)}`,
-    ].join("\n");
-}
-function isAlmanacCurrent(server) {
-    return (server?.command === "npx" &&
-        JSON.stringify(server.args) === JSON.stringify(ALMANAC_MCP_ENTRY.args));
-}
-function isOpenCodeAlmanacCurrent(entry) {
-    return (entry?.type === "local" &&
-        entry?.enabled === true &&
-        JSON.stringify(entry.command) ===
-            JSON.stringify([ALMANAC_MCP_ENTRY.command, ...ALMANAC_MCP_ENTRY.args]));
-}
-function configureJsonMcpFile(path, mode) {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const json = readJson(path);
-    if (!json.mcpServers)
-        json.mcpServers = {};
-    if (isAlmanacCurrent(json.mcpServers.almanac)) {
-        return false;
-    }
-    if (mode === "apply") {
-        ensureDir(dirname(path));
-        json.mcpServers.almanac = { ...ALMANAC_MCP_ENTRY };
-        writeJson(path, json);
-    }
-    return true;
-}
-function configureCodexToml(path, mode) {
-    const current = readToml(path);
-    const next = upsertCodexServer(current);
-    if (current.trim() === next.trim()) {
-        return false;
-    }
-    if (mode === "apply") {
-        ensureDir(dirname(path));
-        writeFileSync(path, next.endsWith("\n") ? next : next + "\n");
-    }
-    return true;
-}
-function configureOpenCodeFile(path, mode) {
-    const current = readJsonWithComments(path);
-    if (!current.$schema) {
-        current.$schema = "https://opencode.ai/config.json";
-    }
-    const mcp = isRecord(current.mcp) ? current.mcp : {};
-    if (!isRecord(current.mcp)) {
-        current.mcp = mcp;
-    }
-    if (isOpenCodeAlmanacCurrent(mcp.almanac)) {
-        return false;
-    }
-    mcp.almanac = {
-        type: "local",
-        command: [ALMANAC_MCP_ENTRY.command, ...ALMANAC_MCP_ENTRY.args],
-        enabled: true,
-    };
-    if (mode === "apply") {
-        ensureDir(dirname(path));
-        writeJson(path, current);
-    }
-    return true;
-}
-function readToml(path) {
-    try {
-        return readFileSync(path, "utf-8");
-    }
-    catch {
-        return "";
-    }
-}
-function readJsonWithComments(path) {
-    try {
-        const raw = readFileSync(path, "utf-8");
-        const parsed = JSON.parse(stripJsonComments(raw));
-        return isRecord(parsed) ? parsed : {};
-    }
-    catch {
-        return {};
-    }
-}
-function stripJsonComments(input) {
-    let result = "";
-    let inString = false;
-    let inLineComment = false;
-    let inBlockComment = false;
-    let escaped = false;
-    for (let i = 0; i < input.length; i++) {
-        const char = input[i];
-        const next = input[i + 1];
-        if (inLineComment) {
-            if (char === "\n") {
-                inLineComment = false;
-                result += char;
-            }
-            continue;
-        }
-        if (inBlockComment) {
-            if (char === "*" && next === "/") {
-                inBlockComment = false;
-                i++;
-            }
-            continue;
-        }
-        if (inString) {
-            result += char;
-            if (escaped) {
-                escaped = false;
-            }
-            else if (char === "\\") {
-                escaped = true;
-            }
-            else if (char === "\"") {
-                inString = false;
-            }
-            continue;
-        }
-        if (char === "/" && next === "/") {
-            inLineComment = true;
-            i++;
-            continue;
-        }
-        if (char === "/" && next === "*") {
-            inBlockComment = true;
-            i++;
-            continue;
-        }
-        if (char === "\"") {
-            inString = true;
-        }
-        result += char;
-    }
-    return result;
-}
-function isRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function upsertCodexServer(content) {
-    const sectionName = "mcp_servers.almanac";
-    const header = `[${sectionName}]`;
-    const nextBody = [
-        `command = ${tomlString(ALMANAC_MCP_ENTRY.command)}`,
-        `args = ${tomlArray(ALMANAC_MCP_ENTRY.args)}`,
-    ];
-    const lines = content === "" ? [] : content.split(/\r?\n/);
-    const start = lines.findIndex((line) => line.trim() === header);
-    if (start === -1) {
-        const prefix = content.trimEnd();
-        const block = [header, ...nextBody].join("\n");
-        return prefix === "" ? block + "\n" : `${prefix}\n\n${block}\n`;
-    }
-    let end = lines.length;
-    for (let i = start + 1; i < lines.length; i++) {
-        if (/^\s*\[.+\]\s*$/.test(lines[i])) {
-            end = i;
-            break;
-        }
-    }
-    const existingBody = lines.slice(start + 1, end);
-    const preserved = existingBody.filter((line) => {
-        const trimmed = line.trim();
-        return !trimmed.startsWith("command =") && !trimmed.startsWith("args =");
-    });
-    const replacement = [header, ...nextBody, ...preserved];
-    const updated = [...lines.slice(0, start), ...replacement, ...lines.slice(end)];
-    return updated.join("\n").replace(/\n{3,}/g, "\n\n").replace(/\s+$/, "") + "\n";
-}
-function tomlString(value) {
-    return JSON.stringify(value);
-}
-function tomlArray(values) {
-    return `[${values.map((value) => tomlString(value)).join(", ")}]`;
-}
-function detectClients() {
-    return SUPPORTED_CLIENT_IDS.map((id) => SUPPORTED_CLIENTS[id]).filter((client) => client.detect());
-}
-function resolveClients(options) {
-    if (options.clients.length > 0) {
-        return options.clients.map((id) => SUPPORTED_CLIENTS[id]);
-    }
-    const detected = detectClients();
-    if (options.all)
-        return detected;
-    return detected;
-}
-function applyClientSetup(clients, mode) {
-    const configured = [];
-    const alreadyConfigured = [];
-    for (const client of clients) {
-        const result = client.configure(mode);
-        if (result.changed) {
-            configured.push(client.name);
-        }
-        else {
-            alreadyConfigured.push(client.name);
-        }
-    }
-    return { configured, alreadyConfigured };
-}
-function printSetupPlan(clients, options) {
-    const heading = options.dryRun ? "Dry run" : "OpenAlmanac MCP setup";
-    process.stdout.write(`${heading}\n\n`);
-    if (clients.length === 0) {
-        process.stdout.write("No supported clients detected. Use --client <name> to force a target or --print to inspect supported snippets.\n");
-        if (options.print) {
-            process.stdout.write("\nSupported clients:\n");
-            for (const id of SUPPORTED_CLIENT_IDS) {
-                process.stdout.write(`- ${SUPPORTED_CLIENTS[id].name}\n`);
-            }
-        }
-        return;
-    }
-    const mode = options.print ? "print" : "dry-run";
-    for (const client of clients) {
-        const result = client.configure(mode);
-        const status = result.changed
-            ? options.print
-                ? "snippet"
-                : "would configure"
-            : "already configured";
-        process.stdout.write(`- ${client.name}: ${status}\n`);
-        if (options.print) {
-            for (const snippet of result.snippets) {
-                process.stdout.write(`  Path: ${snippet.path}\n`);
-                process.stdout.write(`${indentBlock(snippet.content, "    ")}\n`);
-            }
-        }
-    }
-}
-function indentBlock(content, prefix) {
-    return content
-        .split("\n")
-        .map((line) => `${prefix}${line}`)
-        .join("\n");
-}
-/* ── Step 2 — Permissions ──────────────────────────────────────── */
-function configurePermissions(tools) {
-    ensureDir(CLAUDE_DIR);
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const settings = readJson(SETTINGS_JSON);
-    if (!settings.permissions)
-        settings.permissions = {};
-    if (!Array.isArray(settings.permissions.allow))
-        settings.permissions.allow = [];
-    const existing = new Set(settings.permissions.allow);
-    let added = 0;
-    for (const t of tools) {
-        if (!existing.has(t)) {
-            settings.permissions.allow.push(t);
-            added++;
-        }
-    }
-    if (added > 0)
-        writeJson(SETTINGS_JSON, settings);
-    return tools.length;
-}
-/* ── Client selection screen ────────────────────────────────────── */
-function renderClientSelect(clients, selected, cursor, mode = "default") {
-    process.stdout.write("\x1b[2J\x1b[H");
-    renderHeader(mode);
-    printBadge();
-    w("");
-    stepActive(`Select where to install Almanac`);
-    w(BAR);
-    for (let i = 0; i < clients.length; i++) {
-        const client = clients[i];
-        const arrow = i === cursor ? `${BLUE}\u276f${RST}` : " ";
-        const check = selected[i] ? `${BLUE}\u2713${RST}` : " ";
-        const label = i === cursor ? `${BOLD}${client.selectionLabel ?? client.name}${RST}` : client.selectionLabel ?? client.name;
-        w(`  ${DIM}\u2502${RST}   ${arrow} [${check}] ${label}`);
-    }
-    w(BAR);
-    w(`  ${DIM}\u2502${RST}   ${BLUE}${BOLD}[space]${RST} toggle  ${BLUE}${BOLD}[\u2191\u2193]${RST} move  ${BLUE}${BOLD}[a]${RST} all  ${BLUE}${BOLD}[enter]${RST} confirm  ${DIM}[q] quit${RST}`);
-    w("");
-}
-function runClientSelect(clients, mode = "default") {
-    return new Promise((resolve) => {
-        const selected = clients.map(() => true);
-        let cursor = 0;
-        renderClientSelect(clients, selected, cursor, mode);
-        process.stdin.setRawMode(true);
-        process.stdin.resume();
-        process.stdin.setEncoding("utf-8");
-        const cleanup = () => {
-            process.stdin.removeListener("data", onData);
-            process.stdin.setRawMode(false);
-            process.stdin.pause();
-        };
-        const onData = (key) => {
-            if (key === "\x03" || key === "q") {
-                cleanup();
-                process.stdout.write("\x1b[2J\x1b[H");
-                console.log("\n  Setup cancelled.\n");
-                process.exit(0);
-            }
-            if (key === "\x1b[A" || key === "k") {
-                cursor = (cursor - 1 + clients.length) % clients.length;
-            }
-            else if (key === "\x1b[B" || key === "j") {
-                cursor = (cursor + 1) % clients.length;
-            }
-            else if (key === " ") {
-                selected[cursor] = !selected[cursor];
-            }
-            else if (key === "a") {
-                const all = selected.every(Boolean);
-                selected.fill(!all);
-            }
-            else if (key === "\r" || key === "\n") {
-                cleanup();
-                const chosen = clients.filter((_, index) => selected[index]);
-                if (chosen.length === 0) {
-                    console.log("\n  Select at least one client.\n");
-                    process.exit(1);
-                }
-                resolve(chosen);
-                return;
-            }
-            renderClientSelect(clients, selected, cursor, mode);
-        };
-        process.stdin.on("data", onData);
-    });
-}
-async function runAgentSelect(mode = "default") {
-    const [client] = await runClientSelect([SUPPORTED_CLIENTS["claude-code"]], mode);
-    return client.name;
-}
-/* ── Login step ─────────────────────────────────────────────────── */
-function loginLabel(result) {
-    if (result.status === "already")
-        return `Logged in as ${WHITE_BOLD}${result.name}${RST}`;
-    if (result.status === "done")
-        return `Logged in`;
-    return `Login ${DIM}skipped${RST}`;
-}
-function waitForKey(prompt) {
-    return new Promise((resolve) => {
-        process.stdin.setRawMode(true);
-        process.stdin.resume();
-        process.stdin.setEncoding("utf-8");
-        w(prompt);
-        const onData = (key) => {
-            process.stdin.removeListener("data", onData);
-            process.stdin.setRawMode(false);
-            process.stdin.pause();
-            if (key === "\x03") {
-                process.stdout.write("\x1b[2J\x1b[H");
-                console.log("\n  Setup cancelled.\n");
-                process.exit(0);
-            }
-            resolve(key);
-        };
-        process.stdin.on("data", onData);
-    });
-}
-async function runLoginStep(agent, mcpChanged, toolCount, mode = "default") {
-    const label = agent.includes(",") ? "Clients" : "Agent";
-    const priorSteps = () => {
-        stepDone(`${label} \u2192 ${WHITE_BOLD}${agent}${RST}`);
-        w(BAR);
-        stepDone(`MCP server ${mcpChanged ? "configured" : `${DIM}already configured${RST}`}`);
-        if (toolCount !== null) {
-            w(BAR);
-            stepDone(`${BLUE}${toolCount}${RST} tool${toolCount !== 1 ? "s" : ""} allowed`);
-        }
-        w(BAR);
-    };
-    function renderLoginChoice(name, cursor) {
-        process.stdout.write("\x1b[2J\x1b[H");
-        renderHeader(mode);
-        printBadge();
-        w("");
-        priorSteps();
-        stepActive(`Already logged in as ${WHITE_BOLD}${name}${RST}`);
-        w(BAR);
-        const options = [
-            `Continue as ${BOLD}${name}${RST}`,
-            `Login with a different account`,
-        ];
-        for (let i = 0; i < options.length; i++) {
-            const arrow = i === cursor ? `${BLUE}\u276f${RST}` : " ";
-            const label = i === cursor ? options[i] : `${DIM}${options[i]}${RST}`;
-            w(`  ${DIM}\u2502${RST}   ${arrow} ${label}`);
-        }
-        w(BAR);
-        w(`  ${DIM}\u2502${RST}   ${BLUE}${BOLD}[\u2191\u2193]${RST} move  ${BLUE}${BOLD}[enter]${RST} confirm`);
-        w("");
-    }
-    function runLoginChoice(name) {
-        return new Promise((resolve) => {
-            let cursor = 0;
-            renderLoginChoice(name, cursor);
-            process.stdin.setRawMode(true);
-            process.stdin.resume();
-            process.stdin.setEncoding("utf-8");
-            const cleanup = () => {
-                process.stdin.removeListener("data", onData);
-                process.stdin.setRawMode(false);
-                process.stdin.pause();
-            };
-            const onData = (key) => {
-                if (key === "\x03" || key === "q") {
-                    cleanup();
-                    process.stdout.write("\x1b[2J\x1b[H");
-                    console.log("\n  Setup cancelled.\n");
-                    process.exit(0);
-                }
-                if (key === "\x1b[A" || key === "k")
-                    cursor = cursor === 0 ? 1 : 0;
-                else if (key === "\x1b[B" || key === "j")
-                    cursor = cursor === 0 ? 1 : 0;
-                else if (key === "\r" || key === "\n") {
-                    cleanup();
-                    resolve(cursor === 0); // 0 = keep, 1 = new account
-                    return;
-                }
-                renderLoginChoice(name, cursor);
-            };
-            process.stdin.on("data", onData);
-        });
-    }
-    // Check if already logged in
-    let forceNew = false;
-    const auth = await getAuthStatus();
-    if (auth.loggedIn) {
-        const keepAccount = await runLoginChoice(auth.name);
-        if (keepAccount) {
-            return { status: "already", name: auth.name };
-        }
-        forceNew = true;
-    }
-    // Show prompt before opening browser
-    process.stdout.write("\x1b[2J\x1b[H");
-    renderHeader(mode);
-    printBadge();
-    w("");
-    priorSteps();
-    stepActive(`Login to Almanac`);
-    w(BAR);
-    w(`  ${DIM}\u2502${RST}   This will open ${WHITE_BOLD}almanac${RST} in your browser`);
-    w(`  ${DIM}\u2502${RST}   to connect your account.`);
-    w(BAR);
-    await waitForKey(`  ${DIM}\u2502${RST}   ${BLUE}${BOLD}[enter]${RST} continue`);
-    // Show waiting state with cancel/retry hint
-    const renderWaiting = () => {
-        process.stdout.write("\x1b[2J\x1b[H");
-        renderHeader(mode);
-        printBadge();
-        w("");
-        priorSteps();
-        stepActive(`Waiting for login\u2026  ${DIM}complete in browser${RST}`);
-        w(BAR);
-        w(`  ${DIM}\u2502${RST}   ${BLUE}${BOLD}[r]${RST} retry  ${DIM}[q] cancel setup${RST}`);
-        w("");
-    };
-    // Loop: attempt login, let user retry if it fails/times out
-    // eslint-disable-next-line no-constant-condition
-    while (true) {
-        renderWaiting();
-        // AbortController so we can kill the HTTP server on retry/cancel
-        const controller = new AbortController();
-        // Race login against keypress
-        const loginPromise = performLogin({ signal: controller.signal, forceNew }).then((result) => result.status === "already_logged_in"
-            ? { status: "already", name: result.name }
-            : { status: "done" }, () => ({ status: "skipped" }));
-        let keyOnData = null;
-        const keyPromise = new Promise((resolve) => {
-            process.stdin.setRawMode(true);
-            process.stdin.resume();
-            process.stdin.setEncoding("utf-8");
-            keyOnData = (key) => {
-                process.stdin.removeListener("data", keyOnData);
-                process.stdin.setRawMode(false);
-                process.stdin.pause();
-                resolve(key);
-            };
-            process.stdin.on("data", keyOnData);
-        });
-        const result = await Promise.race([
-            loginPromise.then((r) => ({ type: "login", result: r })),
-            keyPromise.then((k) => ({ type: "key", key: k })),
-        ]);
-        // Clean up stdin listener if login won
-        if (result.type === "login") {
-            if (keyOnData)
-                process.stdin.removeListener("data", keyOnData);
-            try {
-                process.stdin.setRawMode(false);
-            }
-            catch { /* already off */ }
-            process.stdin.pause();
-            return result.result;
-        }
-        // Key won — abort the login HTTP server
-        controller.abort();
-        // Handle keypress
-        if (result.key === "\x03" || result.key === "q") {
-            process.stdout.write("\x1b[2J\x1b[H");
-            console.log("\n  Setup cancelled.\n");
-            process.exit(0);
-        }
-        if (result.key === "r") {
-            // Retry — loop continues
-            continue;
-        }
-    }
-}
-/* ── Tool permissions TUI ───────────────────────────────────────── */
-const MAX_NAME = Math.max(...TOOL_GROUPS.map((g) => g.name.length));
-function renderToolSelect(selected, cursor, clientsLabel, mcpChanged, mode = "default") {
-    process.stdout.write("\x1b[2J\x1b[H");
-    renderHeader(mode);
-    printBadge();
-    w("");
-    stepDone(`Clients \u2192 ${WHITE_BOLD}${clientsLabel}${RST}`);
-    w(BAR);
-    stepDone(`MCP server ${mcpChanged ? "configured" : `${DIM}already configured${RST}`}`);
-    w(BAR);
-    stepActive(`Select Claude Code tool permissions  ${DIM}deselect any you'd rather approve manually${RST}`);
-    w(BAR);
-    for (let i = 0; i < TOOL_GROUPS.length; i++) {
-        const arrow = i === cursor ? `${BLUE}\u276f${RST}` : " ";
-        const check = selected[i] ? `${BLUE}\u2713${RST}` : " ";
-        const pad = TOOL_GROUPS[i].name.padEnd(MAX_NAME + 2);
-        const name = i === cursor ? `${BOLD}${pad}${RST}` : pad;
-        const desc = `${DIM}${TOOL_GROUPS[i].description}${RST}`;
-        w(`  ${DIM}\u2502${RST}   ${arrow} [${check}] ${name} ${desc}`);
-    }
-    w(BAR);
-    w(`  ${DIM}\u2502${RST}   ${BLUE}${BOLD}[space]${RST} toggle  ${BLUE}${BOLD}[\u2191\u2193]${RST} move  ${BLUE}${BOLD}[a]${RST} all  ${BLUE}${BOLD}[enter]${RST} confirm  ${DIM}[q] quit${RST}`);
-    w("");
-}
-function runToolSelect(clientsLabel, mcpChanged, mode = "default") {
-    return new Promise((resolve) => {
-        const selected = TOOL_GROUPS.map(() => true);
-        let cursor = 0;
-        renderToolSelect(selected, cursor, clientsLabel, mcpChanged, mode);
-        process.stdin.setRawMode(true);
-        process.stdin.resume();
-        process.stdin.setEncoding("utf-8");
-        const cleanup = () => {
-            process.stdin.removeListener("data", onData);
-            process.stdin.setRawMode(false);
-            process.stdin.pause();
-        };
-        const onData = (key) => {
-            if (key === "\x03" || key === "q") {
-                cleanup();
-                process.stdout.write("\x1b[2J\x1b[H");
-                console.log("\n  Setup cancelled.\n");
-                process.exit(0);
-            }
-            if (key === "\x1b[A" || key === "k")
-                cursor = (cursor - 1 + TOOL_GROUPS.length) % TOOL_GROUPS.length;
-            else if (key === "\x1b[B" || key === "j")
-                cursor = (cursor + 1) % TOOL_GROUPS.length;
-            else if (key === " ")
-                selected[cursor] = !selected[cursor];
-            else if (key === "a") {
-                const all = selected.every(Boolean);
-                selected.fill(!all);
-            }
-            else if (key === "\r" || key === "\n") {
-                cleanup();
-                const tools = [];
-                for (let i = 0; i < TOOL_GROUPS.length; i++) {
-                    if (selected[i])
-                        tools.push(...TOOL_GROUPS[i].tools);
-                }
-                resolve(tools);
-                return;
-            }
-            renderToolSelect(selected, cursor, clientsLabel, mcpChanged, mode);
-        };
-        process.stdin.on("data", onData);
-    });
-}
-/* ── Result screen ──────────────────────────────────────────────── */
-function printResult(clientsLabel, loginResult, configured, alreadyConfigured, toolCount) {
-    process.stdout.write("\x1b[2J\x1b[H");
-    printBanner();
-    printBadge();
-    w("");
-    stepDone(`Clients \u2192 ${WHITE_BOLD}${clientsLabel}${RST}`);
-    w(BAR);
-    stepDone(`Configured \u2192 ${configured.length > 0 ? configured.join(", ") : `${DIM}none${RST}`}`);
-    w(BAR);
-    stepDone(`Already configured \u2192 ${alreadyConfigured.length > 0 ? alreadyConfigured.join(", ") : `${DIM}none${RST}`}`);
-    w(BAR);
-    if (toolCount > 0) {
-        stepDone(`${BLUE}${toolCount}${RST} tool${toolCount !== 1 ? "s" : ""} allowed in ${DIM}~/.claude/settings.json${RST}`);
-        w(BAR);
-    }
-    stepDone(loginLabel(loginResult));
-    w(BAR);
-    stepDone(`${BLUE}Setup complete${RST}`);
-    w("");
-    // Next steps box
-    const innerW = 62;
-    const row = (content) => {
-        const padding = Math.max(0, innerW - vis(content));
-        return `  ${BLUE_DIM}\u2502${RST}${content}${" ".repeat(padding)}${BLUE_DIM}\u2502${RST}`;
-    };
-    const empty = row("");
-    const nextSteps = getNextSteps(clientsLabel);
-    w(`  ${BLUE_DIM}\u256d${"─".repeat(innerW)}\u256e${RST}`);
-    w(empty);
-    w(row(`  ${WHITE_BOLD}Next steps${RST}`));
-    w(empty);
-    for (let i = 0; i < nextSteps.length; i++) {
-        w(row(`  ${BLUE}${i + 1}.${RST}  ${nextSteps[i]}`));
-    }
-    w(empty);
-    w(`  ${BLUE_DIM}\u2570${"─".repeat(innerW)}\u256f${RST}`);
-    w("");
-}
-function getNextSteps(clientsLabel) {
-    const exampleLine = `${BLUE}"${EXAMPLE_PROMPT}"${RST}`;
-    if (clientsLabel === "Claude Code") {
-        return [
-            `Type ${WHITE_BOLD}claude${RST} to start Claude Code`,
-            `Say ${exampleLine}`,
-        ];
-    }
-    if (clientsLabel === "Codex") {
-        return [
-            `Type ${WHITE_BOLD}codex${RST} to start Codex`,
-            `Ask ${exampleLine}`,
-        ];
-    }
-    if (clientsLabel === "Cursor") {
-        return [
-            `Open ${WHITE_BOLD}Cursor${RST} in your project`,
-            `Ask ${exampleLine}`,
-        ];
-    }
-    if (clientsLabel === "OpenCode") {
-        return [
-            `Type ${WHITE_BOLD}opencode${RST} to start OpenCode`,
-            `Ask ${exampleLine}`,
-        ];
-    }
-    if (clientsLabel === "Windsurf") {
-        return [
-            `Open ${WHITE_BOLD}Windsurf${RST} in your project`,
-            `Ask ${exampleLine}`,
-        ];
-    }
-    if (clientsLabel === "Claude Desktop") {
-        return [
-            `Open ${WHITE_BOLD}Claude Desktop${RST}`,
-            `Ask ${exampleLine}`,
-        ];
-    }
-    return [
-        `Open one of your configured agents in this project`,
-        `Ask ${exampleLine}`,
-    ];
-}
-/* ── Entry point ────────────────────────────────────────────────── */
-export async function runSetup() {
-    const options = parseSetupArgs(process.argv.slice(3));
-    let clients = resolveClients(options);
-    if (options.print || options.dryRun) {
-        printSetupPlan(clients, options);
-        process.exit(0);
-    }
-    if (clients.length === 0) {
-        printSetupPlan(clients, options);
-        process.exit(0);
-    }
-    const skipTui = options.yes;
-    const interactive = process.stdin.isTTY && !skipTui;
-    if (interactive && options.clients.length === 0) {
-        clients = await runClientSelect(clients);
-    }
-    const clientsLabel = clients.map((client) => client.name).join(", ");
-    const setupSummary = applyClientSetup(clients, "apply");
-    const permissionClient = clients.find((client) => client.supportsPermissions);
-    let tools = [];
-    if (permissionClient) {
-        const mcpChanged = setupSummary.configured.includes(permissionClient.name);
-        if (interactive) {
-            tools = await runToolSelect(clientsLabel, mcpChanged);
-        }
-        else {
-            tools = TOOL_GROUPS.flatMap((g) => g.tools);
-        }
-    }
-    const count = tools.length > 0 ? configurePermissions(tools) : 0;
-    const permissionCount = permissionClient ? count : null;
-    let loginResult;
-    if (interactive) {
-        loginResult = await runLoginStep(clientsLabel, setupSummary.configured.length > 0, permissionCount);
-    }
-    else {
-        try {
-            const result = await performLogin();
-            loginResult =
-                result.status === "already_logged_in"
-                    ? { status: "already", name: result.name }
-                    : { status: "done" };
-        }
-        catch {
-            loginResult = { status: "skipped" };
-        }
-    }
-    printResult(clientsLabel, loginResult, setupSummary.configured, setupSummary.alreadyConfigured, count);
-    process.exit(0);
-}
-/* ── Skill installation ────────────────────────────────────────── */
-function getPackageSkillsDir() {
-    const thisFile = fileURLToPath(import.meta.url);
-    // dist/setup.js → package root → skills/
-    return join(dirname(thisFile), "..", "skills");
-}
-function installSkill(skillName) {
-    const src = join(getPackageSkillsDir(), skillName);
-    if (!existsSync(src)) {
-        throw new Error(`Skill "${skillName}" not found in package at ${src}`);
-    }
-    const dest = join(homedir(), ".claude", "skills", skillName);
-    // Always overwrite to ensure latest version
-    mkdirSync(dirname(dest), { recursive: true });
-    cpSync(src, dest, { recursive: true, force: true });
-    return true;
-}
-/* ── Reddit-specific tool groups ───────────────────────────────── */
-const REDDIT_EXTRA_TOOLS = [
-    "Bash(node */ingest.js *)",
-];
-/* ── Reddit result screen ──────────────────────────────────────── */
-function printRedditResult(agent, loginResult, mcpChanged, toolCount) {
-    process.stdout.write("\x1b[2J\x1b[H");
-    renderHeader("reddit");
-    printBadge();
-    w("");
-    stepDone(`Agent \u2192 ${WHITE_BOLD}${agent}${RST}`);
-    w(BAR);
-    stepDone(`MCP server ${mcpChanged ? "configured" : `${DIM}already configured${RST}`}`);
-    w(BAR);
-    stepDone(`${BLUE}${toolCount}${RST} tool${toolCount !== 1 ? "s" : ""} allowed`);
-    w(BAR);
-    stepDone(loginLabel(loginResult));
-    w(BAR);
-    stepDone(`${BLUE}/reddit-wiki${RST} skill installed`);
-    w(BAR);
-    stepDone(`${BLUE}Setup complete${RST}`);
-    w("");
-    // Next steps box
-    const innerW = 62;
-    const row = (content) => {
-        const padding = Math.max(0, innerW - vis(content));
-        return `  ${BLUE_DIM}\u2502${RST}${content}${" ".repeat(padding)}${BLUE_DIM}\u2502${RST}`;
-    };
-    const empty = row("");
-    w(`  ${BLUE_DIM}\u256d${"─".repeat(innerW)}\u256e${RST}`);
-    w(empty);
-    w(row(`  ${WHITE_BOLD}Next steps${RST}`));
-    w(empty);
-    w(row(`  ${BLUE}1.${RST}  Type ${WHITE_BOLD}claude${RST} to start Claude Code`));
-    w(empty);
-    w(`  ${BLUE_DIM}\u2570${"─".repeat(innerW)}\u256f${RST}`);
-    w("");
-}
-/* ── Reddit entry point ────────────────────────────────────────── */
-export async function runRedditSetup() {
-    const skipTui = process.argv.includes("--yes") || process.argv.includes("-y");
-    const interactive = process.stdin.isTTY && !skipTui;
-    let agent = "Claude Code";
-    if (interactive) {
-        agent = await runAgentSelect("reddit");
-    }
-    const claudeSetup = SUPPORTED_CLIENTS["claude-code"].configure("apply");
-    const mcpChanged = claudeSetup.changed;
-    let tools;
-    if (interactive) {
-        tools = await runToolSelect(agent, mcpChanged, "reddit");
-    }
-    else {
-        tools = TOOL_GROUPS.flatMap((g) => g.tools);
-    }
-    // Add reddit-specific tool permissions
-    tools = [...tools, ...REDDIT_EXTRA_TOOLS];
-    const count = configurePermissions(tools);
-    // Login step
-    let loginResult;
-    if (interactive) {
-        loginResult = await runLoginStep(agent, mcpChanged, count, "reddit");
-    }
-    else {
-        try {
-            const result = await performLogin();
-            loginResult =
-                result.status === "already_logged_in"
-                    ? { status: "already", name: result.name }
-                    : { status: "done" };
-        }
-        catch {
-            loginResult = { status: "skipped" };
-        }
-    }
-    // Install the reddit-wiki skill
-    installSkill("reddit-wiki");
-    printRedditResult(agent, loginResult, mcpChanged, count);
-    process.exit(0);
-}