fathom-mcp 0.3.1 → 0.4.1

package/CHANGELOG.md

@@ -1,11 +1,12 @@
 # Changelog
 
-## 0.3.1 (2026-02-26)
+## 0.4.0 (2026-02-26)
 
-- **Agent type registration** — init wizard sends primary agent type when registering workspace with server
-- **Terminal bypass_permissions** — respects per-workspace session settings instead of always forcing bypass
+- **Breaking:** removed `architecture` field everywhere — `agents` array is the only field
+- Cleaned up all backward compatibility shims across config, server, API, and frontend
+- Renamed `_get_architecture` → `_get_agent` in persistent session manager
 
-## 0.2.0 (2026-02-26)
+## 0.3.0 (2026-02-26)
 
 Multi-agent support.
 
@@ -14,9 +15,10 @@ Multi-agent support.
 - **Per-agent config writers** — `.mcp.json`, `.codex/config.toml`, `.gemini/settings.json`, `opencode.json`
 - **Agent instructions boilerplate** — `fathom-agents.md` template for memory discipline, vault conventions, cross-workspace communication
 - **Conditional hooks** — hook setup only for Claude Code (other agents don't support hooks)
-- **`agents` array** replaces legacy `architecture` string in `.fathom.json` — backward compatible
+- **`agents` array** in `.fathom.json` — workspace config stores which agents are configured
 - **Server-side agent dispatch** — persistent sessions launch the correct agent CLI per workspace
-- **Status command** — now shows configured agents per workspace
+- **Agent type registration** — init wizard sends primary agent type when registering workspace
+- **Status command** — shows configured agents per workspace
 
 ## 0.1.0 (2026-02-25)
 

package/README.md

@@ -100,10 +100,6 @@ npx fathom-mcp status        # Check server connection + workspace status
 2. `.fathom.json` (walked up from cwd to filesystem root)
 3. Built-in defaults
 
-### Backward compatibility
-
-The `agents` array replaces the legacy `architecture` string field. Old configs with `architecture: "claude-code"` are automatically migrated to `agents: ["claude-code"]` at read time.
-
 ## Hooks (Claude Code only)
 
 Hooks are only available in Claude Code and are configured in `.claude/settings.local.json`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fathom-mcp",
-  "version": "0.3.1",
+  "version": "0.4.1",
   "description": "MCP server for Fathom — vault operations, search, rooms, and cross-workspace communication",
   "type": "module",
   "bin": {

package/src/cli.js

@@ -14,7 +14,7 @@ import path from "path";
 import readline from "readline";
 import { fileURLToPath } from "url";
 
-import { resolveConfig, writeConfig, findConfigFile } from "./config.js";
+import { resolveConfig, writeConfig } from "./config.js";
 import { createClient } from "./server-client.js";
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
@@ -253,7 +253,8 @@ async function runInit() {
     const agent = AGENTS[key];
     const isDetected = detected.includes(key);
     const mark = isDetected ? "✓" : " ";
-    const hint = isDetected ? ` (${key === "windsurf" ? "~/.codeium/windsurf/ found" : `.${key === "claude-code" ? "claude" : key === "vscode" ? "vscode" : key}/ found`})` : "";
+    const markers = { "claude-code": ".claude/", "codex": ".codex/", "gemini": ".gemini/", "opencode": "opencode.json" };
+    const hint = isDetected ? ` (${markers[key] || key} found)` : "";
     console.log(`    ${mark} ${agent.name}${hint}`);
   }
 
@@ -472,7 +473,7 @@ async function runStatus() {
         } else {
           const agentLabel = profile.agents?.length > 0
             ? ` [${profile.agents.join(", ")}]`
-            : profile.architecture ? ` [${profile.architecture}]` : "";
+            : "";
           const runStatus = profile.running ? "running" : "stopped";
           console.log(`    ${name}: ${runStatus}${agentLabel}`);
         }

package/src/config.js

@@ -68,11 +68,8 @@ export function resolveConfig(startDir = process.cwd()) {
     if (config.server) result.server = config.server;
     if (config.apiKey) result.apiKey = config.apiKey;
     if (config.description) result.description = config.description;
-    // Backward compat: migrate legacy `architecture` string to `agents` array
     if (config.agents && Array.isArray(config.agents)) {
       result.agents = config.agents;
-    } else if (config.architecture) {
-      result.agents = [config.architecture];
     }
     if (config.hooks) {
       result.hooks = { ...result.hooks, ...config.hooks };

package/src/index.js

@@ -270,7 +270,7 @@ const tools = [
   {
     name: "fathom_send",
     description:
-      "Send a message to another workspace's Claude instance — for cross-workspace coordination, " +
+      "Send a message to another workspace's agent instance — for cross-workspace coordination, " +
       "sharing findings, or requesting action. Use fathom_workspaces first to discover valid " +
       "targets. The target agent sees: 'Message from workspace ({from}): {message}'",
     inputSchema: {
@@ -424,14 +424,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       result = await client.listWorkspaces();
       break;
     case "fathom_send":
-      // Send is implemented server-side (it manages tmux sessions)
-      result = await client.request?.("POST", `/api/room/${encodeURIComponent("__dm__")}`, {
-        body: { message: `Message from workspace (${config.workspace}): ${args.message}`, sender: config.workspace },
-      });
-      // For now, fall back to error until server implements /api/send
-      if (!result || result.error) {
-        result = { error: "fathom_send requires a running fathom-server with session management. This feature is being migrated." };
-      }
+      result = await client.sendToWorkspace(args.workspace, args.message, config.workspace);
       break;
     default:
       result = { error: `Unknown tool: ${name}` };
@@ -456,7 +449,7 @@ async function main() {
     client.registerWorkspace(config.workspace, config._projectDir, {
       vault: config._rawVault,
       description: config.description,
-      architecture: config.architecture,
+      agents: config.agents,
     }).catch(() => {});
   }
 

package/src/server-client.js

@@ -98,20 +98,26 @@ export function createClient(config) {
     });
   }
 
+  // --- Direct messaging -------------------------------------------------------
+
+  async function sendToWorkspace(target, message, from) {
+    return request("POST", `/api/send/${encodeURIComponent(target)}`, {
+      body: { message, from: from || workspace },
+    });
+  }
+
   // --- Workspaces ------------------------------------------------------------
 
   async function listWorkspaces() {
     return request("GET", "/api/workspaces/profiles");
   }
 
-  async function registerWorkspace(name, projectPath, { vault, description, agents, architecture, type } = {}) {
+  async function registerWorkspace(name, projectPath, { vault, description, agents, type } = {}) {
     const body = { name, path: projectPath };
     if (vault) body.vault = vault;
     if (description) body.description = description;
     if (agents && agents.length > 0) body.agents = agents;
     if (type) body.type = type;
-    // Legacy fallback
-    if (architecture && !agents?.length) body.architecture = architecture;
     return request("POST", "/api/workspaces", { body });
   }
 
@@ -164,6 +170,7 @@ export function createClient(config) {
     roomRead,
     roomList,
     roomDescribe,
+    sendToWorkspace,
     listWorkspaces,
     registerWorkspace,
     notifyAccess,