openalmanac 0.3.6 → 0.4.1

package/dist/setup/permissions.js

@@ -0,0 +1,52 @@
+import { MCP_TOOL_GROUPS, toClaudePermissionName } from "../tool-registry.js";
+import { CLAUDE_DIR, SETTINGS_JSON, ensureDir, readJson, writeJson } from "./config-files.js";
+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"],
+    },
+];
+export const TOOL_GROUPS = [
+    ...MCP_TOOL_GROUPS.map(mcpGroupToPermissionGroup),
+    ...CLAUDE_BUILTIN_TOOL_GROUPS,
+];
+export 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 ────────────────────────────────────── */

package/dist/{setup.d.ts → setup/reddit.d.ts}

@@ -1,2 +1 @@
-export declare function runSetup(): Promise<void>;
 export declare function runRedditSetup(): Promise<void>;

package/dist/setup/reddit.js

@@ -0,0 +1,69 @@
+import { cpSync, existsSync, mkdirSync } from "fs";
+import { homedir } from "os";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+import { performLogin } from "../login-core.js";
+import { SUPPORTED_CLIENTS } from "./clients.js";
+import { TOOL_GROUPS, configurePermissions } from "./permissions.js";
+import { printRedditResult, runAgentSelect, runLoginStep, runToolSelect } from "./tui.js";
+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 *)",
+];
+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);
+}

package/dist/setup/tui.d.ts

@@ -0,0 +1,7 @@
+import type { LoginStepResult, SetupClient, SetupMode } from "./types.js";
+export declare function runClientSelect(clients: SetupClient[], mode?: SetupMode): Promise<SetupClient[]>;
+export declare function runAgentSelect(mode?: SetupMode): Promise<string>;
+export declare function runLoginStep(agent: string, mcpChanged: boolean, toolCount: number | null, mode?: SetupMode): Promise<LoginStepResult>;
+export declare function runToolSelect(clientsLabel: string, mcpChanged: boolean, mode?: SetupMode): Promise<string[]>;
+export declare function printResult(clientsLabel: string, loginResult: LoginStepResult, configured: string[], alreadyConfigured: string[], toolCount: number): void;
+export declare function printRedditResult(agent: string, loginResult: LoginStepResult, mcpChanged: boolean, toolCount: number): void;

package/dist/setup/tui.js

@@ -0,0 +1,496 @@
+import { performLogin } from "../login-core.js";
+import { getAuthStatus } from "../auth.js";
+import { EXAMPLE_PROMPT } from "../onboarding-copy.js";
+import { SUPPORTED_CLIENTS } from "./clients.js";
+import { TOOL_GROUPS } from "./permissions.js";
+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");
+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("");
+}
+export 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);
+    });
+}
+export async function runAgentSelect(mode = "default") {
+    const [client] = await runClientSelect([SUPPORTED_CLIENTS["claude-code"]], mode);
+    return client.name;
+}
+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);
+    });
+}
+export 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;
+        }
+    }
+}
+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("");
+}
+export 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 ──────────────────────────────────────────────── */
+export 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`,
+            `Ask ${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}`,
+        ];
+    }
+    const formattedClients = clientsLabel.split(", ").join(" / ");
+    const projectHint = clientsLabel.includes("Claude Desktop") ? "" : " in this project";
+    return [
+        `Open ${WHITE_BOLD}${formattedClients}${RST}${projectHint}`,
+        `Ask ${exampleLine}`,
+    ];
+}
+/* ── Entry point ────────────────────────────────────────────────── */
+export 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 ────────────────────────────────────────── */

package/dist/setup/types.d.ts

@@ -0,0 +1,43 @@
+export interface ToolGroup {
+    name: string;
+    description: string;
+    tools: string[];
+}
+export type SetupMode = "default" | "reddit";
+export type ClientId = "claude-code" | "claude-desktop" | "codex" | "cursor" | "opencode" | "windsurf";
+export interface SetupOptions {
+    all: boolean;
+    clients: ClientId[];
+    dryRun: boolean;
+    print: boolean;
+    yes: boolean;
+}
+export interface SetupClient {
+    id: ClientId;
+    name: string;
+    detect: () => boolean;
+    configure: (mode: ConfigureMode) => ClientConfigureResult;
+    supportsPermissions?: boolean;
+    selectionLabel?: string;
+}
+export interface ClientConfigureResult {
+    changed: boolean;
+    snippets: ConfigSnippet[];
+}
+export interface ConfigSnippet {
+    path: string;
+    content: string;
+}
+export type ConfigureMode = "apply" | "dry-run" | "print";
+export interface SetupRunSummary {
+    configured: string[];
+    alreadyConfigured: string[];
+}
+export type LoginStepResult = {
+    status: "already";
+    name: string;
+} | {
+    status: "done";
+} | {
+    status: "skipped";
+};

package/dist/setup/types.js

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