@fanchao8609/agent_brain_sync 0.4.0 → 0.5.1

package/package.json

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

package/src/install.js

@@ -262,6 +262,7 @@ const server = async ({ client, directory }) => {
   // 本会话是否真改过文件 (由 tool.execute.after 观测)
   let wroteFiles = false
   let nudged = false
+  let idleSeen = false
 
   async function logHook(evt) {
     try {
@@ -317,11 +318,16 @@ const server = async ({ client, directory }) => {
         return
       }
       if (type !== "session.idle") return // idle = 每轮结束, 不记日志(太吵), 只做收尾判定
+      const cwd = directory || process.cwd()
+      const brain = await findBrain(cwd)
+      // 可观测性: 首次 idle 无条件留一行痕(否则无法区分“事件没触发”与“被守卫拦下”)
+      if (!idleSeen) {
+        idleSeen = true
+        await logHook(\`session.idle:seen cwd=\${cwd} brain=\${brain || 'none'}\`)
+      }
       if (nudged || !wroteFiles) return
       const sessionID = event.properties && event.properties.sessionID
       if (!sessionID) return
-      const cwd = directory || process.cwd()
-      const brain = await findBrain(cwd)
       if (!brain) return // 无图谱=不在这项目沉淀, 不打扰
       if (await loggedToday(brain)) return // 今天已收尾过
       nudged = true
@@ -438,10 +444,18 @@ export default function absPiHook(pi: ExtensionAPI): void {
 
   // 收尾注入: 每个会话最多一次, 避免反复打扰。
   let teardownNudged = false
+  let agentEndSeen = false
   pi.on("agent_end", async (event: any, ctx: any) => {
     if (teardownNudged) return
     const cwd = (ctx && ctx.cwd) || process.cwd()
     const brain = await findBrain(cwd)
+    // 可观测性: 本会话首次 agent_end 无条件留一行痕。
+    // 没有它就无法区分三种状态: ①事件没触发 ②触发了但被守卫拦下 ③真注入了。
+    if (!agentEndSeen) {
+      agentEndSeen = true
+      // 带上 cwd 与命中的 brain —— 否则事后无法解释“为何这条 nudge 会出现”
+      await logHook(\`agent_end:seen cwd=\${cwd} brain=\${brain || 'none'}\`).catch(() => {})
+    }
     if (!brain) return // 无图谱=不在这项目沉淀, 不打扰
     if (!hasWriteWork(event?.messages ? collectToolResults(event.messages) : [])) return
     if (await loggedToday(brain)) return // 今天已收尾过