fathom-mcp 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -1,6 +1,12 @@
 # Changelog
 
-## 0.2.0 (2026-02-26)
+## 0.4.0 (2026-02-26)
+
+- **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.3.0 (2026-02-26)
 
 Multi-agent support.
 
@@ -9,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.0",
+  "version": "0.4.0",
   "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}`);
   }
 
@@ -410,6 +411,7 @@ async function runInit() {
         vault,
         description,
         agents: selectedAgents,
+        type: selectedAgents[0] || "local",
       });
       if (regResult.ok) {
         console.log(`  ✓ Registered workspace "${workspace}" with server`);
@@ -471,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

@@ -456,7 +456,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

@@ -104,13 +104,12 @@ export function createClient(config) {
     return request("GET", "/api/workspaces/profiles");
   }
 
-  async function registerWorkspace(name, projectPath, { vault, description, agents, architecture } = {}) {
+  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;
-    // Legacy fallback
-    if (architecture && !agents?.length) body.architecture = architecture;
+    if (type) body.type = type;
     return request("POST", "/api/workspaces", { body });
   }