openalmanac 0.2.26 → 0.2.28

package/dist/auth.js

@@ -88,6 +88,9 @@ export async function request(method, path, options = {}) {
     }
     const resp = await fetch(url, init);
     if (!resp.ok) {
+        if (resp.status === 401 || resp.status === 403) {
+            throw new Error(`Authentication failed (${resp.status}). Your API key may be invalid or expired. Run 'login' to re-authenticate.`);
+        }
         const text = await resp.text();
         throw new Error(`${resp.status} ${resp.statusText}: ${text}`);
     }

package/dist/browser.js

@@ -1,13 +1,14 @@
-import { execSync } from "node:child_process";
+import { execFileSync } from "node:child_process";
 import { platform } from "node:os";
 export function openBrowser(url) {
     const cmd = platform() === "darwin"
-        ? `open "${url}"`
+        ? "open"
         : platform() === "win32"
-            ? `start "" "${url}"`
-            : `xdg-open "${url}"`;
+            ? "start"
+            : "xdg-open";
     try {
-        execSync(cmd, { stdio: "ignore" });
+        const args = platform() === "win32" ? ["", url] : [url];
+        execFileSync(cmd, args, { stdio: "ignore" });
         return true;
     }
     catch {

package/dist/server.js

@@ -1,3 +1,6 @@
+import { readFileSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
 import { FastMCP } from "fastmcp";
 import { registerAuthTools } from "./tools/auth.js";
 import { registerArticleTools } from "./tools/articles.js";
@@ -5,6 +8,8 @@ import { registerResearchTools } from "./tools/research.js";
 import { registerCommunityTools } from "./tools/communities.js";
 import { registerPeopleTools } from "./tools/people.js";
 import { getApiKey } from "./auth.js";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, "..", "package.json"), "utf-8"));
 export function createServer() {
     if (!getApiKey()) {
         console.error(`
@@ -24,7 +29,7 @@ export function createServer() {
     }
     const server = new FastMCP({
         name: "OpenAlmanac",
-        version: "0.1.0",
+        version: pkg.version,
         instructions: [
             "OpenAlmanac is an open knowledge base — a Wikipedia anyone can read from and write to through an API. Articles are markdown files with YAML frontmatter and [N] citation markers mapped to sources.",
             "",

package/dist/setup.js

@@ -127,7 +127,8 @@ 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");
+const CLAUDE_JSON = join(homedir(), ".claude.json"); // Claude Desktop
+const CLAUDE_CODE_MCP = join(CLAUDE_DIR, "mcp.json"); // Claude Code
 const SETTINGS_JSON = join(CLAUDE_DIR, "settings.json");
 function ensureDir(dir) {
     if (!existsSync(dir))
@@ -145,19 +146,35 @@ 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"] };
+function isAlmanacCurrent(server) {
+    return (server?.command === "npx" &&
+        JSON.stringify(server.args) === JSON.stringify(ALMANAC_MCP_ENTRY.args));
+}
 function configureMcp() {
+    let changed = false;
+    // Claude Desktop — ~/.claude.json
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const desktop = readJson(CLAUDE_JSON);
+    if (!desktop.mcpServers)
+        desktop.mcpServers = {};
+    if (!isAlmanacCurrent(desktop.mcpServers.almanac)) {
+        desktop.mcpServers.almanac = ALMANAC_MCP_ENTRY;
+        writeJson(CLAUDE_JSON, desktop);
+        changed = true;
+    }
+    // Claude Code — ~/.claude/mcp.json
+    ensureDir(CLAUDE_DIR);
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const cfg = readJson(CLAUDE_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
+    const code = readJson(CLAUDE_CODE_MCP);
+    if (!code.mcpServers)
+        code.mcpServers = {};
+    if (!isAlmanacCurrent(code.mcpServers.almanac)) {
+        code.mcpServers.almanac = ALMANAC_MCP_ENTRY;
+        writeJson(CLAUDE_CODE_MCP, code);
+        changed = true;
     }
-    cfg.mcpServers.almanac = { command: "npx", args: ["-y", "openalmanac"] };
-    writeJson(CLAUDE_JSON, cfg);
-    return true;
+    return changed;
 }
 /* ── Step 2 — Permissions ──────────────────────────────────────── */
 function configurePermissions(tools) {
@@ -492,7 +509,7 @@ function printResult(agent, loginResult, mcpChanged, toolCount) {
     stepDone(`${BLUE}Setup complete${RST}`);
     w("");
     // Next steps box
-    const innerW = 52;
+    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}`;

package/dist/tools/articles.js

@@ -218,7 +218,7 @@ export function registerArticleTools(server) {
                 ? "\n\nThis is a STUB article — a placeholder that hasn't been fully written yet. " +
                     "Fill in the content body with a complete article, then push to publish."
                 : "";
-            return `Pulled "${title}" to ${filePath}\n${wordCount} words, ${frontmatter.sources?.length ?? 0} sources.${stubNote}\n\n${WRITING_GUIDE}`;
+            return `Downloaded "${title}" to ${filePath}\n${wordCount} words, ${frontmatter.sources?.length ?? 0} sources.${stubNote}\n\n${WRITING_GUIDE}`;
         },
     });
     server.addTool({

package/dist/validate.js

@@ -47,14 +47,18 @@ export function validateArticle(raw) {
             if (!s.title || typeof s.title !== "string") {
                 errors.push({ field: `sources[${i}].title`, message: "Title is required" });
             }
-            if (!s.accessed_date || typeof s.accessed_date !== "string") {
+            const accessedDate = s.accessed_date;
+            if (!accessedDate) {
                 errors.push({ field: `sources[${i}].accessed_date`, message: "Accessed date is required" });
             }
-            else if (!DATE_RE.test(s.accessed_date)) {
-                errors.push({
-                    field: `sources[${i}].accessed_date`,
-                    message: "Must be YYYY-MM-DD format",
-                });
+            else if (accessedDate instanceof Date) {
+                // YAML parsed it as a Date object — valid
+            }
+            else if (typeof accessedDate === "string" && !DATE_RE.test(accessedDate)) {
+                errors.push({ field: `sources[${i}].accessed_date`, message: "Must be YYYY-MM-DD format" });
+            }
+            else if (typeof accessedDate !== "string" && !(accessedDate instanceof Date)) {
+                errors.push({ field: `sources[${i}].accessed_date`, message: "Must be YYYY-MM-DD format" });
             }
         }
     }

package/package.json

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