@fanchao8609/agent_brain_sync 0.4.0 → 0.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fanchao8609/agent_brain_sync",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "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,6 +318,11 @@ const server = async ({ client, directory }) => {
         return
       }
       if (type !== "session.idle") return // idle = 每轮结束, 不记日志(太吵), 只做收尾判定
+      // 可观测性: 首次 idle 无条件留一行痕(否则无法区分“事件没触发”与“被守卫拦下”)
+      if (!idleSeen) {
+        idleSeen = true
+        await logHook("session.idle:seen")
+      }
       if (nudged || !wroteFiles) return
       const sessionID = event.properties && event.properties.sessionID
       if (!sessionID) return
@@ -438,9 +444,16 @@ 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()
+    // 可观测性: 本会话首次 agent_end 无条件留一行痕。
+    // 没有它就无法区分三种状态: ①事件没触发 ②触发了但被守卫拦下 ③真注入了。
+    if (!agentEndSeen) {
+      agentEndSeen = true
+      await logHook("agent_end:seen").catch(() => {})
+    }
     const brain = await findBrain(cwd)
     if (!brain) return // 无图谱=不在这项目沉淀, 不打扰
     if (!hasWriteWork(event?.messages ? collectToolResults(event.messages) : [])) return