aws-runtime-bridge 1.9.52 → 1.9.56

package/package/aws-client-agent-mcp/dist/mcp-server.d.ts

@@ -54,8 +54,6 @@ export declare class McpServer {
      * 仅缓存 claim 成功的 URI，在 lease 到期前不再调 server。
      */
     private claimedCache;
-    /** syncClaimStatusFromServer 互斥锁，防止后台定时器与 poll 路径并发执行 (v1.21.0) */
-    private syncClaimMutex;
     /** profile 是否已同步（防止 activelySyncProfile 与 profileHandler 双重同步） */
     private profileSynced;
     /**
@@ -253,7 +251,8 @@ export declare class McpServer {
     private mergeSearchResults;
     /**
      * 列出短期类型记忆。
-     * 主流程：只允许 recently_memory/agent_memory/project_memory，由 MemoryStore 阻止 session_context 的全量列出。
+     * 主流程：只允许 recently_memory/agent_memory，拒绝 project_memory（永久记忆仅通过 search 检索）。
+     * MemoryStore.listByType 内部仍允许 project_memory 供文件变更检测使用，但 MCP 层面不暴露给 Agent。
      */
     private handleListMemories;
     /**
@@ -395,20 +394,12 @@ export declare class McpServer {
      * 构建 Memory 文件变更检测通知。
      * Memory 增强功能 (v1.6.0)
      *
-     * 检测流程：
-     * 0. 同步 Server 的 claim 状态到本地，清理过期 claim
+     * 检测流程（所有数据均从服务端读取，不降级到本地）：
      * 1. 检查本 Agent 标记为 updating 但未处理的 Memory
      * 2. 检查短期记忆、近期记忆绑定的文件是否变更
      * 3. 检查永久记忆的文件变更，先走 Server 原子 claim，再标记本地
      */
     private buildMemoryFileChangeNotification;
-    /**
-     * Step 0: 同步 Server 的 claim 状态到本地 roleMemoryStore (v1.21.0)。
-     * 查询 Server 上当前 agent 持有的 updating 记忆 URI 列表，
-     * 本地中标记为 updating 但 Server 不持有的 → 重置为 normal。
-     * 处理场景：agent crash 后重启，Server 租约已过期被清理，但本地 JSON 仍卡在 updating。
-     */
-    private syncClaimStatusFromServer;
     /**
      * 检查指定 URI 是否在 claim 去重缓存内 (v1.21.0)。
      * 在 lease 有效期内不再重复 claim。

package/package/aws-client-agent-mcp/dist/mcp-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"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"}

package/package/aws-client-agent-mcp/dist/mcp-server.js

@@ -87,8 +87,6 @@ export class McpServer {
      * 仅缓存 claim 成功的 URI，在 lease 到期前不再调 server。
      */
     claimedCache = new Map();
-    /** syncClaimStatusFromServer 互斥锁，防止后台定时器与 poll 路径并发执行 (v1.21.0) */
-    syncClaimMutex = Promise.resolve();
     /** profile 是否已同步（防止 activelySyncProfile 与 profileHandler 双重同步） */
     profileSynced = false;
     /**
@@ -228,15 +226,15 @@ export class McpServer {
      *   xxx   → ./xxx (裸路径视为当前工作区相对)
      */
     normalizeBoundFilePath(filePath) {
-        const trimmed = String(filePath || "").trim();
+        const trimmed = String(filePath || "").trim().replace(/\\/g, "/");
         if (!trimmed)
             return trimmed;
         // 去掉 @/ 前缀（@ 视为工作区根路径）
         const noAt = trimmed.startsWith("@/") ? trimmed.substring(1) : trimmed;
         if (noAt.startsWith("./"))
             return noAt;
-        // /xxx 和 xxx 都统一成 ./xxx
-        return `./${noAt.replace(/^\//, "")}`;
+        // /xxx 和 xxx 都统一成 ./xxx（与 Java normalizeBoundFilePath 保持一致，处理多前导斜杠）
+        return `./${noAt.replace(/^\/+/, "")}`;
     }
     /**
      * 规范化绑定的文件路径数组。
@@ -409,10 +407,10 @@ export class McpServer {
                 if (reportableResult !== null) {
                     // 正常结果：上报 toolResult + thinking（工具调用完成，回到思考状态）
                     statusReporter.reportToolResult(reportableResult);
-                    statusReporter.reportThinking();
                 }
-                // 委托消息（reportableResult === null）：跳过 reportToolResult 和 reportThinking
-                // ACode runtime 会重新 poll_message，工具调用未真正结束，保持"调用MCP"状态
+                // 委托消息（reportableResult === null）：跳过 reportToolResult（避免委托通知泄露到时间线），
+                // 但仍调用 reportThinking（工具调用已完成，Agent 回到思考状态等待 ACode runtime 重新 poll）
+                statusReporter.reportThinking();
             }
             return result;
         }
@@ -647,32 +645,45 @@ export class McpServer {
             return await this.memoryStore.readMemory(input);
         }
         if (input.memory_type) {
-            const localStore = this.getMemoryStoreForType(input.memory_type);
-            const localRecord = await localStore.readMemory(input);
-            if (localRecord) {
-                return localRecord;
-            }
-            // project_memory 跨实例可见性：本地未命中时回退服务端角色级 scope，
-            // 使兄弟实例创建的记忆也能被读取（文件变更通知后 agent 需 read_memory）。
+            // project_memory：服务端为权威源（claim/租约/memory_status 均在服务端维护），
+            // 本地 roleMemoryStore 仅作服务端不可用时的离线降级副本。
+            // 之前本地优先会导致 read_memory 读到过时的 memory_status='normal'，
+            // 而服务端 DB 已是 'updating'（文件变更 claim 只写服务端），状态脱节。
             if (input.memory_type === "project_memory") {
-                return await this.memoryStore.readMemory(input);
+                try {
+                    const serverRecord = await this.memoryStore.readMemory(input);
+                    if (serverRecord) {
+                        return serverRecord;
+                    }
+                }
+                catch {
+                    // 服务端不可用，降级到本地
+                }
+                return await this.roleMemoryStore.readMemory(input);
             }
-            return null;
+            // recently_memory / agent_memory：实例级，走服务端
+            return await this.memoryStore.readMemory(input);
         }
-        const longTermRecord = await this.roleMemoryStore.readMemory({
-            ...input,
-            memory_type: "project_memory",
-        });
-        if (longTermRecord) {
-            return longTermRecord;
+        // 未指定 memory_type：优先查服务端 project_memory（权威源），
+        // 降级本地 roleMemoryStore（离线未同步记录），最后查服务端实例级记忆。
+        try {
+            const serverLongTerm = await this.memoryStore.readMemory({
+                ...input,
+                memory_type: "project_memory",
+            });
+            if (serverLongTerm) {
+                return serverLongTerm;
+            }
         }
-        // 本地角色级未命中，回退服务端角色级 project_memory（兄弟实例创建的记忆）
-        const serverLongTerm = await this.memoryStore.readMemory({
+        catch {
+            // 服务端不可用，降级到本地
+        }
+        const localLongTerm = await this.roleMemoryStore.readMemory({
             ...input,
             memory_type: "project_memory",
         });
-        if (serverLongTerm) {
-            return serverLongTerm;
+        if (localLongTerm) {
+            return localLongTerm;
         }
         return await this.memoryStore.readMemory(input);
     }
@@ -685,32 +696,39 @@ export class McpServer {
             return { store: this.memoryStore, memory_type: input.memory_type };
         }
         if (input.memory_type) {
-            const localStore = this.getMemoryStoreForType(input.memory_type);
-            // project_memory 跨实例：本地有则用本地，否则用服务端角色级 scope
-            // （兄弟实例创建的记忆仅在服务端可见，需路由到 server 才能 update/delete）
+            // project_memory：服务端为权威源（claim/memory_status/租约均在服务端维护），
+            // mutation 必须走服务端，否则本地写入与服务端状态脱节。
+            // 本地 roleMemoryStore 仅在“本地存在离线记录但服务端没有”时降级（未同步的离线编辑）；
+            // 新建（两者均无）必须落到服务端，避免 create 写入本地导致服务端统计/可见性脱节。
             if (input.memory_type === "project_memory") {
-                const localRecord = await localStore.readMemory(input);
+                const serverRecord = await this.memoryStore.readMemory(input).catch(() => null);
+                if (serverRecord) {
+                    return { store: this.memoryStore, memory_type: "project_memory" };
+                }
+                const localRecord = await this.roleMemoryStore.readMemory(input).catch(() => null);
                 if (localRecord) {
-                    return { store: localStore, memory_type: "project_memory" };
+                    return { store: this.roleMemoryStore, memory_type: "project_memory" };
                 }
                 return { store: this.memoryStore, memory_type: "project_memory" };
             }
-            return { store: localStore, memory_type: input.memory_type };
+            // recently_memory / agent_memory：实例级，走服务端
+            return { store: this.memoryStore, memory_type: input.memory_type };
         }
-        const longTermRecord = await this.roleMemoryStore.readMemory({
+        // 未指定 memory_type：优先查服务端 project_memory（权威源），
+        // 降级本地 roleMemoryStore（离线未同步记录），最后回退服务端实例级。
+        const serverLongTerm = await this.memoryStore.readMemory({
             uri: input.uri,
             memory_type: "project_memory",
-        });
-        if (longTermRecord) {
-            return { store: this.roleMemoryStore, memory_type: "project_memory" };
+        }).catch(() => null);
+        if (serverLongTerm) {
+            return { store: this.memoryStore, memory_type: "project_memory" };
         }
-        // 回退服务端角色级 project_memory（兄弟实例创建的记忆）
-        const serverLongTerm = await this.memoryStore.readMemory({
+        const localLongTerm = await this.roleMemoryStore.readMemory({
             uri: input.uri,
             memory_type: "project_memory",
         });
-        if (serverLongTerm) {
-            return { store: this.memoryStore, memory_type: "project_memory" };
+        if (localLongTerm) {
+            return { store: this.roleMemoryStore, memory_type: "project_memory" };
         }
         return { store: this.memoryStore };
     }
@@ -792,7 +810,9 @@ export class McpServer {
         if (name === "search_memory") {
             sanitized.queryProvided =
                 typeof args.query === "string" && args.query.length > 0;
-            sanitized.keyword_mode = args.keyword_mode;
+            if (args.keyword_mode !== undefined) {
+                sanitized.keyword_mode = args.keyword_mode;
+            }
         }
         return sanitized;
     }
@@ -864,8 +884,9 @@ export class McpServer {
             last_check_time: lastCheckTime,
         };
         const created = await this.getMemoryStoreForType(input.memory_type).createMemory(input);
-        await this.reportCombinedMemoryStats();
-        // Dual-write permanent memory to server
+        // Dual-write permanent memory to server BEFORE reporting stats,
+        // 确保 reportCombinedMemoryStats 上报时 server 端已包含 project_memory 记录，
+        // 避免 Dashboard 统计与本地写入脱节。
         if (input.memory_type === "project_memory") {
             try {
                 await this.memoryStore.createMemory(input);
@@ -874,6 +895,7 @@ export class McpServer {
                 logger.warn("[McpServer] Failed to sync permanent memory to server:", e);
             }
         }
+        await this.reportCombinedMemoryStats();
         // v1.13.0: recently_memory 过期判定、agent_memory 过期/回忆状态由服务端 memory_status 字段管理，
         // 无需 TS 侧本地缓存。服务端默认按类型填充正确状态（recently_memory='normal', agent_memory='normal'）。
         return this.toMemoryWriteResult(created);
@@ -923,7 +945,17 @@ export class McpServer {
             uri: input.uri,
             memory_type: target.memory_type ?? input.memory_type,
         });
-        // 当显式传入新 bound_files 时验证文件是否存在
+        // 当记忆已绑定文件或处于更新中状态时，要求显式指定 bound_files 并校验文件存在性。
+        // 这确保文件被删除后，Agent 必须更新 bound_files 列表（移除已删除文件）才能完成更新，
+        // 避免已删除文件路径作为"僵尸绑定"长期保留。
+        const hasExistingBoundFiles = !!existingForMd5?.bound_files && existingForMd5.bound_files.length > 0;
+        const isUpdatingState = existingForMd5?.memory_status === "updating";
+        if ((hasExistingBoundFiles || isUpdatingState) &&
+            input.bound_files === undefined) {
+            throw new Error("此记忆已绑定文件或处于更新中状态，更新时必须指定 bound_files 列表。" +
+                "请提供 bound_files 参数（如需移除已删除的文件，请更新列表仅保留当前存在的文件）。");
+        }
+        // 校验 bound_files 中所有文件是否存在：不存在的文件会导致更新失败
         if (input.bound_files !== undefined) {
             await this.validateBoundFilesExist(input.bound_files);
         }
@@ -946,9 +978,9 @@ export class McpServer {
             file_md5_map: fileMd5Map,
             last_check_time: lastCheckTime,
         });
-        await this.reportCombinedMemoryStats();
         // Dual-write permanent memory update to server（同步 MD5 map 避免服务端重复检测）
-        // 当 target.store 已是服务端（兄弟实例创建的记忆回退场景）时跳过，避免重复写
+        // 当 target.store 已是服务端（兄弟实例创建的记忆回退场景）时跳过，避免重复写。
+        // 必须在 reportCombinedMemoryStats 之前完成，确保上报时 server 端统计已同步。
         if (target.memory_type === "project_memory" && target.store !== this.memoryStore) {
             try {
                 await this.memoryStore.updateMemory({
@@ -962,6 +994,7 @@ export class McpServer {
                 logger.warn("[McpServer] Failed to sync permanent memory update to server:", e);
             }
         }
+        await this.reportCombinedMemoryStats();
         // v1.13.0: agent_memory 过期与回忆状态由服务端 memory_status 字段管理。
         // v1.21.0: 如果是 project_memory 且之前是 updating 状态，释放 Server claim
         if (target.memory_type === 'project_memory' && existingForMd5?.memory_status === 'updating') {
@@ -995,11 +1028,11 @@ export class McpServer {
             memory_type: effectiveType,
         });
         if (deleted) {
-            await this.reportCombinedMemoryStats();
             // v1.13.0: 服务端 deleteMemory 内部已处理相关清理逻辑，
             // TS 侧无需任何本地元数据清理。
             // Dual-write permanent memory delete to server
-            // 当 target.store 已是服务端时跳过，避免重复删除
+            // 当 target.store 已是服务端时跳过，避免重复删除。
+            // 必须在 reportCombinedMemoryStats 之前完成，确保上报时 server 端统计已同步。
             if (effectiveType === "project_memory" && target.store !== this.memoryStore) {
                 try {
                     await this.memoryStore.deleteMemory({ uri: input.uri, memory_type: "project_memory" });
@@ -1008,6 +1041,7 @@ export class McpServer {
                     logger.warn("[McpServer] Failed to sync permanent memory delete to server:", e);
                 }
             }
+            await this.reportCombinedMemoryStats();
         }
         return { deleted };
     }
@@ -1102,10 +1136,15 @@ export class McpServer {
     }
     /**
      * 列出短期类型记忆。
-     * 主流程：只允许 recently_memory/agent_memory/project_memory，由 MemoryStore 阻止 session_context 的全量列出。
+     * 主流程：只允许 recently_memory/agent_memory，拒绝 project_memory（永久记忆仅通过 search 检索）。
+     * MemoryStore.listByType 内部仍允许 project_memory 供文件变更检测使用，但 MCP 层面不暴露给 Agent。
      */
     async handleListMemories(args) {
-        return await this.memoryStore.listByType(this.getRequiredString(args, "memory_type"));
+        const memoryType = this.getRequiredString(args, "memory_type");
+        if (memoryType === "project_memory" || memoryType === "session_context") {
+            throw new Error(`Invalid memory_type: ${memoryType}`);
+        }
+        return await this.memoryStore.listByType(memoryType);
     }
     /**
      * 获取本地记忆容量统计。
@@ -1354,11 +1393,17 @@ export class McpServer {
     async handleAbandonMemoryUpdate(args) {
         const uri = this.getRequiredString(args, "uri");
         const memoryType = this.getOptionalMemoryType(args);
+        // 关闭更新前先读取记忆，校验已绑定文件的存在性。
+        // 若存在已删除的文件，放弃更新将失败——Agent 需先通过 update_memory 修正 bound_files 列表
+        // （移除不存在的文件）后，由 update_memory 自动释放 claim。
+        const record = await this.memoryStore.readMemory({ uri, memory_type: memoryType });
+        if (record?.bound_files && record.bound_files.length > 0) {
+            await this.validateBoundFilesExist(record.bound_files);
+        }
         // 调 Server release API 释放 claim
         await this.memoryStore.releaseMemoryClaim(uri);
         // 同时清除本地 roleMemoryStore 的 updating 状态（如果是 project_memory）
         // 兄弟实例创建的记忆本地不存在时静默跳过，服务端 release 才是权威操作
-        const record = await this.memoryStore.readMemory({ uri, memory_type: memoryType });
         if (record?.memory_type === 'project_memory') {
             try {
                 await this.roleMemoryStore.updateMemory({
@@ -1839,8 +1884,7 @@ export class McpServer {
      * 构建 Memory 文件变更检测通知。
      * Memory 增强功能 (v1.6.0)
      *
-     * 检测流程：
-     * 0. 同步 Server 的 claim 状态到本地，清理过期 claim
+     * 检测流程（所有数据均从服务端读取，不降级到本地）：
      * 1. 检查本 Agent 标记为 updating 但未处理的 Memory
      * 2. 检查短期记忆、近期记忆绑定的文件是否变更
      * 3. 检查永久记忆的文件变更，先走 Server 原子 claim，再标记本地
@@ -1858,10 +1902,10 @@ export class McpServer {
                 logger.info('[McpServer] 文件变更检测跳过: agentId 为空');
                 return null;
             }
-            // Step 0: 同步 Server 的 claim 状态到本地 roleMemoryStore（可选，失败降级）。
-            // 清理那些 Server 上已释放（租约过期或被清理）但本地仍标记为 updating 的记录。
-            // Server API 不可用时降级，依赖本地状态，不影响检测流程。
-            await this.syncClaimStatusFromServer(agentId).catch(e => logger.info("[McpServer] Step 0 同步 claim 状态失败（降级）:", e));
+            // ★ 所有检查均从服务端读取（memory_status/claim/租约/file_md5_map 均以服务端 DB 为权威源）。
+            //   原Step 0 syncClaimStatusFromServer 读本地 roleMemoryStore 清理本地过时 claim，
+            //   服务端权威后本地 updating 状态不再被任何决策路径读取，该同步已无意义，移除。
+            //   服务端不可用时直接 catch 返回 null（下方 catch），不降级到本地。
             // 步骤1: 检查是否有 pending 的 updating memories（服务端角色级永久记忆），
             // 同时检测绑定文件是否再次变更（用户可能在 Agent 处理前又改了文件）
             // 数据源切换：从服务端角色级 scope 读取（同角色所有实例共享），
@@ -1880,6 +1924,7 @@ export class McpServer {
                         const memory = updatingMemories.find(m => m.id === change.memoryId);
                         if (memory) {
                             // MD5 回写到服务端角色级 scope（显式传 memory_status:updating 防止 auto-release）
+                            // bound_files 同步回写：checkMemoriesFileChanges 可能已修剪掉消失的文件路径（消除悬空引用）
                             await this.memoryStore.updateMemory({
                                 uri: memory.uri,
                                 memory_type: 'project_memory',
@@ -1887,6 +1932,7 @@ export class McpServer {
                                 updating_agent_id: agentId,
                                 file_md5_map: memory.file_md5_map,
                                 last_check_time: memory.last_check_time,
+                                bound_files: memory.bound_files,
                             });
                         }
                     }
@@ -1959,7 +2005,7 @@ export class McpServer {
             logger.info(`[McpServer] 文件变更检测 Step2: recently=${recentlyMemoryMemories.length}, agent=${agentMemoryMemories.length}, ` +
                 `有绑定文件=${listableWithFiles.length}/${listableMemories.length}。` +
                 `详情: ${listableMemories.map(m => `${m.uri}(bound=${m.bound_files?.length ?? 0},md5=${Object.keys(m.file_md5_map ?? {}).length})`).join('; ') || '无 memory'}`);
-            // 用本地 MD5 缓存补全 listable 记忆（服务端可能不持久化 file_md5_map 字段）
+            // 用本地 MD5 缓存补全 listable 记录（服务端可能不持久化 file_md5_map 字段）
             for (const m of listableMemories) {
                 if (!m.file_md5_map) {
                     const cached = this.listableMd5Cache.get(m.id);
@@ -1968,6 +2014,14 @@ export class McpServer {
                     }
                 }
             }
+            // 捕获检测前的 md5 map 快照，用于检测 checkMemoriesFileChanges 是否修复了键缺失
+            // （路径规范化不一致导致 bound_files 与 file_md5_map 键不匹配时的静默修正）
+            const listableMd5Snapshots = new Map();
+            for (const m of listableMemories) {
+                if (m.bound_files && m.bound_files.length > 0) {
+                    listableMd5Snapshots.set(m.id, JSON.stringify(m.file_md5_map ?? {}));
+                }
+            }
             const listableChanges = await this.checkMemoriesFileChanges(listableMemories);
             const newListableChanges = listableChanges.filter(c => {
                 const memory = listableMemories.find(m => m.id === c.memoryId);
@@ -1982,6 +2036,36 @@ export class McpServer {
             });
             logger.info(`[McpServer] 文件变更检测 Step2: 检测到变更=${listableChanges.length}, 去重后=${newListableChanges.length}` +
                 (listableChanges.length > 0 ? ` 变更项: ${listableChanges.map(c => `${c.memoryUri}(${c.changedFiles.join(',')})`).join('; ')}` : ''));
+            // 回写被修复的 md5 map（键缺失修正）到服务端，避免后续轮次因键不匹配反复误判。
+            // 仅回写未发生真实变更的 memory（发生变更的已在下方 claim/通知流程中处理）。
+            const repairedListableMemories = listableMemories.filter(m => {
+                if (!m.bound_files || m.bound_files.length === 0)
+                    return false;
+                if (listableChanges.some(c => c.memoryId === m.id))
+                    return false;
+                const before = listableMd5Snapshots.get(m.id);
+                const after = JSON.stringify(m.file_md5_map ?? {});
+                return before !== after;
+            });
+            if (repairedListableMemories.length > 0) {
+                logger.info(`[McpServer] 文件变更检测 Step2: 回写 ${repairedListableMemories.length} 个 listable memory 的修正 MD5 map`);
+                for (const m of repairedListableMemories) {
+                    try {
+                        await this.memoryStore.updateMemory({
+                            uri: m.uri,
+                            memory_type: m.memory_type,
+                            file_md5_map: m.file_md5_map,
+                            last_check_time: m.last_check_time,
+                        });
+                        if (m.file_md5_map) {
+                            this.listableMd5Cache.set(m.id, m.file_md5_map);
+                        }
+                    }
+                    catch (e) {
+                        logger.info(`[McpServer] 回写 listable MD5 map 失败: ${m.uri}`, e);
+                    }
+                }
+            }
             if (newListableChanges.length > 0) {
                 for (const c of newListableChanges) {
                     const memory = listableMemories.find(m => m.id === c.memoryId);
@@ -2017,12 +2101,24 @@ export class McpServer {
             logger.info(`[McpServer] 文件变更检测 Step3: project_memory 总数=${permanentList.length}, ` +
                 `有绑定文件=${permanentTotalWithFiles.length}, 待检测(过滤updating/claimed后)=${permanentMemoriesWithFiles.length}。` +
                 `被过滤原因: ${permanentTotalWithFiles.length - permanentMemoriesWithFiles.length} 项(memory_status=updating 或 isClaimCached)`);
+            // 捕获检测前的 md5 map 快照，用于检测 checkMemoriesFileChanges 是否修复了无基线/键缺失
+            const permanentMd5Snapshots = new Map();
+            for (const m of permanentMemoriesWithFiles) {
+                permanentMd5Snapshots.set(m.id, JSON.stringify(m.file_md5_map ?? {}));
+            }
             const permanentChanges = await this.checkMemoriesFileChanges(permanentMemoriesWithFiles);
-            // 回写无基线 memory 的新 MD5 到服务端（修复前创建的旧数据补基线）
-            const baselineUpdatedMemories = permanentMemoriesWithFiles.filter(m => m.file_md5_map && Object.keys(m.file_md5_map).length > 0
-                && !permanentChanges.some(c => c.memoryId === m.id));
+            // 回写被修复的 md5 map（无基线建基线或键缺失修正）到服务端。
+            // 通过快照对比精确识别被修正的 memory，避免每轮回写所有未变更记录。
+            const baselineUpdatedMemories = permanentMemoriesWithFiles.filter(m => {
+                if (permanentChanges.some(c => c.memoryId === m.id))
+                    return false;
+                const before = permanentMd5Snapshots.get(m.id);
+                const after = JSON.stringify(m.file_md5_map ?? {});
+                return before !== after
+                    && m.file_md5_map && Object.keys(m.file_md5_map).length > 0;
+            });
             if (baselineUpdatedMemories.length > 0) {
-                logger.info(`[McpServer] 文件变更检测 Step3: 回写 ${baselineUpdatedMemories.length} 个无基线 memory 的 MD5 基线到服务端`);
+                logger.info(`[McpServer] 文件变更检测 Step3: 回写 ${baselineUpdatedMemories.length} 个 memory 的修正 MD5 map 到服务端（无基线/键缺失修复）`);
                 for (const m of baselineUpdatedMemories) {
                     try {
                         await this.memoryStore.updateMemory({
@@ -2064,6 +2160,7 @@ export class McpServer {
                         if (memory) {
                             // claim 状态由 batchClaimUpdate 在服务端原子写入；此处仅回写新 MD5 基线到服务端角色级 scope，
                             // 显式传 memory_status:updating/updating_agent_id 防止 Java updateMemory auto-release 误释放 claim。
+                            // bound_files 同步回写：checkMemoriesFileChanges 可能已修剪掉消失的文件路径（消除悬空引用）
                             await this.memoryStore.updateMemory({
                                 uri: memory.uri,
                                 memory_type: 'project_memory',
@@ -2071,6 +2168,7 @@ export class McpServer {
                                 updating_agent_id: agentId,
                                 file_md5_map: memory.file_md5_map,
                                 last_check_time: memory.last_check_time,
+                                bound_files: memory.bound_files,
                             });
                             // 加入去重缓存（lease 有效期内不再重复 claim）
                             this.claimedCache.set(memory.uri, Date.now() + McpServer.LEASE_DURATION_MINUTES * 60 * 1000);
@@ -2107,46 +2205,6 @@ export class McpServer {
             return null;
         }
     }
-    /**
-     * Step 0: 同步 Server 的 claim 状态到本地 roleMemoryStore (v1.21.0)。
-     * 查询 Server 上当前 agent 持有的 updating 记忆 URI 列表，
-     * 本地中标记为 updating 但 Server 不持有的 → 重置为 normal。
-     * 处理场景：agent crash 后重启，Server 租约已过期被清理，但本地 JSON 仍卡在 updating。
-     */
-    async syncClaimStatusFromServer(agentId) {
-        // 互斥锁：防止后台定时器与 poll 路径并发执行导致 TOCTOU
-        const previous = this.syncClaimMutex;
-        let release;
-        this.syncClaimMutex = new Promise((resolve) => { release = resolve; });
-        await previous;
-        try {
-            // 从 Server 查询当前 agent 持有的 claimed URIs
-            const serverClaimedUris = await this.memoryStore.getMyClaimedUris();
-            const serverClaimedSet = new Set(serverClaimedUris);
-            // 读取本地 roleMemoryStore 中所有 project_memory
-            const localMemories = await this.roleMemoryStore.listByType('project_memory');
-            const staleLocalClaims = localMemories.filter(m => m.memory_status === 'updating'
-                && m.updating_agent_id === agentId
-                && !serverClaimedSet.has(m.uri));
-            if (staleLocalClaims.length > 0) {
-                logger.info(`[McpServer] Step 0: 清理 ${staleLocalClaims.length} 条本地过期 claim（Server 已释放）`);
-                for (const m of staleLocalClaims) {
-                    await this.roleMemoryStore.updateMemory({
-                        uri: m.uri,
-                        memory_type: 'project_memory',
-                    });
-                    // 不传 memory_status → MemoryStore 默认重置为 normal
-                }
-            }
-        }
-        catch (e) {
-            // Server 不可用时降级，依赖本地状态
-            logger.warn('[McpServer] Step 0: 同步 claim 状态失败（降级）: %s', e instanceof Error ? e.message : String(e));
-        }
-        finally {
-            release();
-        }
-    }
     /**
      * 检查指定 URI 是否在 claim 去重缓存内 (v1.21.0)。
      * 在 lease 有效期内不再重复 claim。
@@ -2177,6 +2235,8 @@ export class McpServer {
                 const oldMd5Map = memory.file_md5_map || {};
                 const workspacePath = process.env.AWS_WORKSPACE_PATH || process.cwd();
                 const hasNoBaseline = Object.keys(oldMd5Map).length === 0;
+                // 标记本轮是否修复了单文件基线（键缺失/空值），用于回写修正后的 map 但不计入变更
+                let baselineRepaired = false;
                 for (const filePath of memory.bound_files) {
                     try {
                         const currentMd5 = await this.calculateFileMd5(filePath);
@@ -2184,28 +2244,39 @@ export class McpServer {
                             // 文件不存在或无法读取
                             const resolvedPath = path.resolve(workspacePath, filePath);
                             logger.info(`[McpServer] MD5 计算返回 null: ${filePath} -> ${resolvedPath} (workspace=${workspacePath})`);
-                            if (!hasNoBaseline) {
-                                // 已有基线但文件读不到 → 视为变更（文件被删除/移动）
+                            const oldMd5ForMissing = oldMd5Map[filePath];
+                            if (oldMd5ForMissing) {
+                                // 该文件曾有基线，现在读不到 -> 视为变更（文件被删除/移动）
                                 changedFiles.push(`${filePath} (文件不存在或无法访问)`);
+                                // 收口：文件已消失，从 bound_files 移除该路径，消除悬空引用。
+                                // 否则 listByFile/findByBoundFile 会持续命中无效记录，且文件恢复后因基线已清而变更检测失效。
+                                // bound_files 修剪结果由调用方在变更回写分支同步持久化（见 buildMemoryFileChangeNotification）。
+                                if (memory.bound_files) {
+                                    memory.bound_files = memory.bound_files.filter(f => f !== filePath);
+                                }
                             }
+                            // 无该文件基线时静默跳过，避免对未知状态误报
                             continue;
                         }
                         newMd5Map[filePath] = currentMd5;
                         const oldMd5 = oldMd5Map[filePath];
-                        if (!oldMd5 || oldMd5 !== currentMd5) {
-                            if (hasNoBaseline) {
-                                // 无基线（修复前创建的旧数据或新建未计算 MD5）：静默建立基线，不视为变更
-                                logger.info(`[McpServer] 建立基线: ${filePath} new=${currentMd5} (workspace=${workspacePath}, memory=${memory.uri})`);
-                            }
-                            else {
-                                logger.info(`[McpServer] 文件变更: ${filePath} old=${oldMd5} new=${currentMd5} (workspace=${workspacePath})`);
-                                changedFiles.push(filePath);
-                            }
+                        if (!oldMd5) {
+                            // 该文件无可用基线（键缺失或空值）。常见原因：
+                            //   1) 新增到 bound_files 的文件尚未建基线；
+                            //   2) 历史 TS/Java 路径规范化不一致（如 Windows 反斜杠）导致键不匹配。
+                            // 静默建立基线，不视为变更，避免 md5 实际未变却误报需要更新。
+                            baselineRepaired = true;
+                            logger.info(`[McpServer] 建立单文件基线: ${filePath} new=${currentMd5} (workspace=${workspacePath}, memory=${memory.uri})`);
+                        }
+                        else if (oldMd5 !== currentMd5) {
+                            logger.info(`[McpServer] 文件变更: ${filePath} old=${oldMd5} new=${currentMd5} (workspace=${workspacePath})`);
+                            changedFiles.push(filePath);
                         }
                     }
                     catch (error) {
                         logger.info(`[McpServer] 计算文件 MD5 失败: ${filePath}`, error);
-                        if (!hasNoBaseline) {
+                        const oldMd5ForError = oldMd5Map[filePath];
+                        if (oldMd5ForError) {
                             changedFiles.push(`${filePath} (MD5计算失败)`);
                         }
                     }
@@ -2216,6 +2287,12 @@ export class McpServer {
                     memory.last_check_time = new Date().toISOString();
                     continue; // 不 push 到 changes
                 }
+                // 键缺失修复：map 非空但部分文件缺少基线（路径规范化不一致或新增文件）。
+                // 回写修正后的 map 供调用方持久化，但不计入变更，避免误报。
+                if (baselineRepaired && Object.keys(newMd5Map).length > 0) {
+                    memory.file_md5_map = newMd5Map;
+                    memory.last_check_time = new Date().toISOString();
+                }
                 if (changedFiles.length > 0) {
                     changes.push({
                         memoryId: memory.id,