@fanchao8609/agent_brain_sync 1.3.0 → 1.3.2

package/bin/mcp.js

@@ -59,8 +59,16 @@ const server = new McpServer({
   version: pkgVersion(),
 });
 
+// 统一注册入口（总是经 withTrace）。
+// 坑: 以前 9 处工具各自直接调 server.tool(...) 而不包 withTrace, 导致 withTrace 定义了
+// 但从未被调用 → mcp.log 永远不生成。可观测性静默缺失(无任何症状), 藏了很久。
+// 现在工具只经本函数注册, 包 trace 这件事无法再被遗漏。
+function tool(name, description, schema, handler) {
+  server.tool(name, description, schema, withTrace(name, handler));
+}
+
 // 工具面（narrow on purpose — 只暴露读/查/记状态，不做深提炼）
-server.tool(
+tool(
   'abs_resolve_project',
   '定位当前项目的 .brain 图谱根（从给定目录向上找最近 .brain/）。多项目隔离的唯一入口。',
   { cwd: z.string().describe('当前工作目录，默认进程 cwd') },
@@ -73,7 +81,7 @@ server.tool(
   }
 );
 
-server.tool(
+tool(
   'abs_board',
   '读取当前项目 todo 看板（含断点/Next-Step）。先 resolve 得到项目，再传其根目录。',
   { cwd: z.string().describe('项目内任意目录') },
@@ -84,7 +92,7 @@ server.tool(
   }
 );
 
-server.tool(
+tool(
   'abs_load',
   '开机读状态：index 路线 + todo 看板 + 最近 log。跨会话续接的入口。',
   { cwd: z.string().describe('项目内任意目录') },
@@ -95,7 +103,7 @@ server.tool(
   }
 );
 
-server.tool(
+tool(
   'abs_task',
   '任务实时落盘（幂等键 = id）。add/start 登记 / note 补断点(改到哪个文件哪行) / blocked 碰壁 / done 完成归位。',
   {
@@ -113,7 +121,7 @@ server.tool(
   }
 );
 
-server.tool(
+tool(
   'abs_status',
   '当前项目 + 图谱概要（各类页数）。',
   { cwd: z.string().describe('项目内任意目录') },
@@ -124,7 +132,7 @@ server.tool(
   }
 );
 
-server.tool(
+tool(
   'abs_query',
   '检索当前项目 .brain/ 知识页（多词 OR）：以前踩过什么坑、哪页记了 X。',
   { cwd: z.string().describe('项目内任意目录'), terms: z.array(z.string()).min(1).describe('检索词') },
@@ -135,7 +143,7 @@ server.tool(
   }
 );
 
-server.tool(
+tool(
   'abs_lint',
   '图谱体检：死链/孤岛/缺 frontmatter/超尺寸/sources 堆积/index 漏列。',
   { cwd: z.string().describe('项目内任意目录') },
@@ -146,7 +154,7 @@ server.tool(
   }
 );
 
-server.tool(
+tool(
   'abs_note',
   '经验实时暂存：把刚踩的坑/技巧/结论一句话落进 sources/（防 context 断了流失）。Teardown 时再提炼进 concepts/。',
   {
@@ -161,7 +169,7 @@ server.tool(
   }
 );
 
-server.tool(
+tool(
   'abs_wrapup',
   '收尾保险：把当前 todo 未完成任务快照到 ~/.abs/log/wrapup.log（下会话 load 时展示滞留对账）。',
   { cwd: z.string().describe('项目内任意目录') },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fanchao8609/agent_brain_sync",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "agent-brain-sync: 跨会话 AI 编码记忆 — hook 纯触发 + CLI/MCP 读写 .brain markdown 图谱, 防并发写保护。",
   "type": "module",
   "license": "MIT",

package/src/install.js

@@ -6,6 +6,7 @@
 //   - OpenCode / Pi: 官方只吃 TS plugin/extension(无 shell-hook 配置) → 初版给出手工指引。
 // 纪律: 幂等(重复安装=更新)、原子写(tmp+rename)、卸载只删自己装的、写入前备份。
 import { promises as fs } from 'node:fs';
+import * as fsSync from 'node:fs';
 import { homedir } from 'node:os';
 import { join, dirname, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -15,6 +16,31 @@ const ABS_DIR = resolve(dirname(fileURLToPath(import.meta.url)), '..');
 const HOOK_TEMPLATE = join(ABS_DIR, 'hooks', 'event.sh');
 const SKILL_SOURCE = join(ABS_DIR, 'skill', 'SKILL.md');
 
+/**
+ * 写进宿主 MCP 配置的 mcp.js 路径。
+ * 坑: 直接用 ABS_DIR 是不稳定的 —— ABS_DIR = "install.js 自己住哪", 从仓库跑
+ * `abs install` 就把仓库路径写进宿主配置。之后若卸载/移动全局包, 该路径直接失效;
+ * 而 Co​dex 分支又"已存在即跳过", 一旦写错永不修正。
+ * 现在优先解析本包的稳定安装位置（全局 node_modules），解析不到才回退 ABS_DIR。
+ */
+function mcpEntryPath() {
+  // 本包名（package.json），用于反查全局安装位置
+  let pkgName = '@fanchao8609/agent_brain_sync';
+  try {
+    pkgName = JSON.parse(fsSync.readFileSync(join(ABS_DIR, 'package.json'), 'utf8')).name || pkgName;
+  } catch { /* 保持默认 */ }
+  const candidates = [
+    // npm 全局根（最常见）
+    join(dirname(process.execPath), '..', 'lib', 'node_modules', pkgName, 'bin', 'mcp.js'),
+    join(process.env.npm_config_prefix || '', 'lib', 'node_modules', pkgName, 'bin', 'mcp.js'),
+  ];
+  for (const c of candidates) {
+    try { if (fsSync.existsSync(c)) return c; } catch { /* 试下一个 */ }
+  }
+  // 回退：仓库/本地安装形态
+  return join(ABS_DIR, 'bin', 'mcp.js');
+}
+
 const MARK = '// abs-managed (agent-brain-sync)'; // TS plugin 标记
 const JSON_MARK_KEY = 'abs-managed';             // JSON 内我们的命名空间
 
@@ -103,7 +129,7 @@ async function installClaudeCode({ withMcp, withSkill, log }) {
     settings.mcpServers = settings.mcpServers || {};
     settings.mcpServers['abs'] = {
       command: process.execPath,
-      args: [join(ABS_DIR, 'bin', 'mcp.js')],
+      args: [mcpEntryPath()],
     };
     await atomicWrite(settingsP, JSON.stringify(settings, null, 2));
     steps.push(`✓ MCP    → settings.json mcpServers.abs (stdio)`);
@@ -183,12 +209,21 @@ async function installCodex({ withMcp, withSkill, log }) {
     let text = '';
     try { text = await fs.readFile(mcpP, 'utf8'); } catch {}
     if (!text.includes('[mcp_servers.abs]')) {
-      const block = `\n[mcp_servers.abs]\ncommand = "${process.execPath}"\nargs = ["${join(ABS_DIR, 'bin', 'mcp.js')}"]\n`;
+      const block = `\n[mcp_servers.abs]\ncommand = "${process.execPath}"\nargs = ["${mcpEntryPath()}"]\n`;
       await backup(mcpP);
       await atomicWrite(mcpP, text.replace(/\s*$/, '') + '\n' + block);
       steps.push(`✓ MCP    → ${mcpP} [mcp_servers.abs]`);
     } else {
-      steps.push(`• MCP    → ${mcpP} 已存在, 跳过`);
+      // 已存在也要校对路径: 旧版可能写入了仓库路径(不稳定) 或全局包已迁移。
+      const want = mcpEntryPath();
+      const re = /(\[mcp_servers\.abs\][^\[]*?args\s*=\s*\[)"[^"]*"(\])/s;
+      if (re.test(text) && !text.includes(`"${want}"`)) {
+        await backup(mcpP);
+        await atomicWrite(mcpP, text.replace(re, `$1"${want}"$2`));
+        steps.push(`✓ MCP    → ${mcpP} 路径已校正 → ${want}`);
+      } else {
+        steps.push(`• MCP    → ${mcpP} 已存在且路径正确, 跳过`);
+      }
     }
   }
   if (withSkill) {
@@ -526,7 +561,7 @@ async function installOpenCode({ withMcp, withSkill, log }) {
     cfg.mcp = cfg.mcp || {};
     cfg.mcp['abs'] = {
       type: 'local',
-      command: [process.execPath, join(ABS_DIR, 'bin', 'mcp.js')],
+      command: [process.execPath, mcpEntryPath()],
     };
     await backup(mcpP);
     await atomicWrite(mcpP, JSON.stringify(cfg, null, 2));