openalmanac 0.2.16 → 0.2.18

package/dist/cli.js

@@ -1,8 +1,15 @@
 #!/usr/bin/env node
 import { createServer } from "./server.js";
 import { runLogin, runLogout } from "./login.js";
+import { runSetup } from "./setup.js";
 const command = process.argv[2];
-if (command === "login") {
+if (command === "setup") {
+    runSetup().catch((e) => {
+        console.error(e instanceof Error ? e.message : e);
+        process.exit(1);
+    });
+}
+else if (command === "login") {
     runLogin().catch((e) => {
         console.error(e instanceof Error ? e.message : e);
         process.exit(1);

package/dist/setup.d.ts

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

package/dist/setup.js

@@ -0,0 +1,231 @@
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+const TOOL_GROUPS = [
+    {
+        name: "Search & Read",
+        description: "search articles, pull, view status",
+        tools: [
+            "mcp__almanac__search_articles",
+            "mcp__almanac__pull",
+            "mcp__almanac__status",
+            "mcp__almanac__requested_articles",
+        ],
+    },
+    {
+        name: "Research",
+        description: "web search, read pages, find images",
+        tools: [
+            "mcp__almanac__search_web",
+            "mcp__almanac__read_webpage",
+            "mcp__almanac__search_images",
+            "mcp__almanac__view_image",
+        ],
+    },
+    {
+        name: "Write & Publish",
+        description: "create articles, push edits, stubs",
+        tools: [
+            "mcp__almanac__new",
+            "mcp__almanac__push",
+            "mcp__almanac__create_stub",
+        ],
+    },
+    {
+        name: "Auth",
+        description: "login and logout",
+        tools: ["mcp__almanac__login", "mcp__almanac__logout"],
+    },
+    {
+        name: "Community",
+        description: "communities, posts, article linking",
+        tools: [
+            "mcp__almanac__search_communities",
+            "mcp__almanac__create_community",
+            "mcp__almanac__create_post",
+            "mcp__almanac__link_article",
+        ],
+    },
+    {
+        name: "People",
+        description: "search people profiles",
+        tools: ["mcp__almanac__search_people"],
+    },
+    {
+        name: "Local Files",
+        description: "read & edit articles in ~/.openalmanac",
+        tools: [
+            "Read(~/.openalmanac/**)",
+            "Write(~/.openalmanac/**)",
+            "Edit(~/.openalmanac/**)",
+        ],
+    },
+];
+/* ── ANSI helpers ───────────────────────────────────────────────── */
+const RST = "\x1b[0m";
+const BOLD = "\x1b[1m";
+const DIM = "\x1b[2m";
+const GREEN = "\x1b[32m";
+const CYAN = "\x1b[36m";
+const RED = "\x1b[31m";
+const YELLOW = "\x1b[33m";
+const MAGENTA = "\x1b[35m";
+const WHITE_BOLD = "\x1b[1;37m";
+/* ── File helpers ───────────────────────────────────────────────── */
+const CLAUDE_DIR = join(homedir(), ".claude");
+const MCP_JSON = join(CLAUDE_DIR, "mcp.json");
+const SETTINGS_JSON = join(CLAUDE_DIR, "settings.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 ───────────────────────────────────────── */
+function configureMcp() {
+    ensureDir(CLAUDE_DIR);
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const cfg = readJson(MCP_JSON);
+    if (!cfg.mcpServers)
+        cfg.mcpServers = {};
+    const cur = cfg.mcpServers.almanac;
+    if (cur?.command === "npx" &&
+        JSON.stringify(cur.args) === JSON.stringify(["-y", "openalmanac"])) {
+        return false; // already set
+    }
+    cfg.mcpServers.almanac = { command: "npx", args: ["-y", "openalmanac"] };
+    writeJson(MCP_JSON, cfg);
+    return true;
+}
+/* ── 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;
+}
+/* ── TUI ────────────────────────────────────────────────────────── */
+const MAX_NAME = Math.max(...TOOL_GROUPS.map((g) => g.name.length));
+function render(selected, cursor, mcpLine) {
+    process.stdout.write("\x1b[2J\x1b[H"); // clear + home
+    const w = (s) => process.stdout.write(s + "\n");
+    w("");
+    w(`  ${WHITE_BOLD}OpenAlmanac${RST} — Claude Code Setup`);
+    w(`  ${DIM}${"─".repeat(36)}${RST}`);
+    w("");
+    w(`  ${mcpLine}`);
+    w("");
+    w(`  Allow all tools for a ${WHITE_BOLD}seamless${RST} writing experience?`);
+    w(`  ${DIM}Deselect any you'd rather approve manually.${RST}`);
+    w("");
+    for (let i = 0; i < TOOL_GROUPS.length; i++) {
+        const arrow = i === cursor ? `${CYAN}❯${RST}` : " ";
+        const check = selected[i] ? `${GREEN}✓${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(`  ${arrow} [${check}] ${name} ${desc}`);
+    }
+    w("");
+    w(`  ${GREEN}${BOLD}[enter]${RST} confirm  ${CYAN}${BOLD}[space]${RST} toggle  ${CYAN}${BOLD}[↑↓]${RST} move  ${CYAN}${BOLD}[a]${RST} all  ${CYAN}${BOLD}[q]${RST} quit`);
+    w("");
+}
+function runTui(mcpLine) {
+    return new Promise((resolve) => {
+        const selected = TOOL_GROUPS.map(() => true); // all on by default
+        let cursor = 0;
+        render(selected, cursor, mcpLine);
+        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) => {
+            // Ctrl-C / q → cancel
+            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;
+            }
+            render(selected, cursor, mcpLine);
+        };
+        process.stdin.on("data", onData);
+    });
+}
+/* ── Result screen ──────────────────────────────────────────────── */
+function printResult(mcpChanged, toolCount) {
+    process.stdout.write("\x1b[2J\x1b[H");
+    console.log("");
+    console.log(`  ${WHITE_BOLD}OpenAlmanac${RST} — Claude Code Setup`);
+    console.log(`  ${DIM}${"─".repeat(36)}${RST}`);
+    console.log("");
+    console.log(`  ${GREEN}✓${RST} MCP server ${mcpChanged ? "added to" : "already in"} ${DIM}~/.claude/mcp.json${RST}`);
+    console.log(`  ${GREEN}✓${RST} ${CYAN}${toolCount}${RST} tool${toolCount !== 1 ? "s" : ""} allowed in ${DIM}~/.claude/settings.json${RST}`);
+    console.log("");
+    console.log(`  ${YELLOW}Restart Claude Code${RST} to apply changes.`);
+    console.log(`  Then try: ${MAGENTA}"Write an article about quantum computing"${RST}`);
+    console.log("");
+}
+/* ── Entry point ────────────────────────────────────────────────── */
+export async function runSetup() {
+    const skipTui = process.argv.includes("--yes") || process.argv.includes("-y");
+    const interactive = process.stdin.isTTY && !skipTui;
+    const mcpChanged = configureMcp();
+    const mcpLine = `${GREEN}✓${RST} MCP server ${mcpChanged ? "added" : "already configured"}`;
+    let tools;
+    if (interactive) {
+        tools = await runTui(mcpLine);
+    }
+    else {
+        tools = TOOL_GROUPS.flatMap((g) => g.tools);
+    }
+    const count = configurePermissions(tools);
+    printResult(mcpChanged, count);
+}

package/dist/tools/research.js

@@ -87,15 +87,20 @@ export function registerResearchTools(server) {
         description: "View an image to verify it's suitable for an article. Use after search_images to inspect candidate images " +
             "before including them. Returns the image so you can see what it actually shows and write an accurate caption.",
         parameters: z.object({
-            url: z.string().describe("Image URL to view (use image_url or thumbnail_url from search_images results)"),
+            url: z.string().url().describe("Image URL to view (use image_url or thumbnail_url from search_images results)"),
         }),
         async execute({ url }) {
-            return {
-                content: [
-                    await imageContent({ url }),
-                    { type: "text", text: `Image URL: ${url}` },
-                ],
-            };
+            try {
+                return {
+                    content: [
+                        await imageContent({ url }),
+                        { type: "text", text: `Image URL: ${url}` },
+                    ],
+                };
+            }
+            catch {
+                return `Failed to fetch image from ${url}. The URL may be invalid, inaccessible, or not an image.`;
+            }
         },
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openalmanac",
-  "version": "0.2.16",
+  "version": "0.2.18",
   "description": "OpenAlmanac — pull, edit, and push articles to the open knowledge base",
   "type": "module",
   "bin": {