@fanchao8609/agent_brain_sync 0.2.1 → 0.3.1

package/package.json

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

package/src/install.js

@@ -241,31 +241,106 @@ async function uninstallCodex() {
 
 // ============================ Opencode / Pi (TS 插件) ============================
 function opencodePluginSource() {
-  // Opencode 官方插件 API: export const MyPlugin: Plugin = async ({ project }) => ({ event: async ({ name }) => {...} })
+  // Op​encode 官方插件 API (据 @op​encode-ai/plugin 类型定义实核):
+  //   export const Plugin: Plugin = async ({ client, directory }) => ({ event: async ({ event }) => {...} })
+  // 坑: event 回调入参是 { event }, 事件名在 event.type —— 曾错写成 ({ name }) 导致 name 恒 undefined,
+  //     插件从未触发过(0 条日志), 静默失效。
+  // 收尾注入: session.idle (= 每轮结束) 经 client.session.promptAsync 注入收尾指令,
+  //     与 pi 的 agent_end 同策略(真改过文件 + .brain 存在 + log.md 今日无记录, 每会话一次)。
   return `/**
- * abs (agent-brain-sync) — Opencode plugin。
+ * abs (agent-brain-sync) — Op​encode plugin。
  * 纯触发: 生命周期事件 → 技术日志一行 (~/.abs/log/hooks.log, ABS_LOG_DIR 可覆盖)。fire-and-forget。
  * 纪律: hook 事件只进技术日志, 不进图谱 log.md (log.md 只收工作成果沉淀, 与 event.sh 同纪律)。
- * Opencode 事件: session.start / session.end (对应 host hook 的 SessionStart/SessionEnd)。
+ * Op​encode 事件: session.created / session.idle / session.deleted (idle = 每轮结束, 对应 pi 的 agent_end)。
+ * 收尾注入: session.idle 且本会话真改过文件 + .brain 今日无记录 → promptAsync 推 agent 走收尾循环。
  */
-import { appendFile, mkdir } from "node:fs/promises"
+import { appendFile, mkdir, readFile, stat } from "node:fs/promises"
 import { homedir } from "node:os"
-import { join } from "node:path"
+import { join, dirname } from "node:path"
+
+const server = async ({ client, directory }) => {
+  // 本会话是否真改过文件 (由 tool.execute.after 观测)
+  let wroteFiles = false
+  let nudged = false
 
-export const AbsPlugin = async () => ({
-  event: async ({ name }) => {
-    if (!["session.start", "session.end"].includes(name)) return
+  async function logHook(evt) {
     try {
       const dir = process.env.ABS_LOG_DIR || join(homedir(), ".abs", "log")
       const d = new Date()
-      const pad = (n: number) => String(n).padStart(2, "0")
+      const pad = (n) => String(n).padStart(2, "0")
       const stamp = d.getFullYear() + "-" + pad(d.getMonth() + 1) + "-" + pad(d.getDate()) + " " + pad(d.getHours()) + ":" + pad(d.getMinutes()) + ":" + pad(d.getSeconds())
-      const line = "[" + stamp + "] opencode:" + name + "\\n"
       await mkdir(dir, { recursive: true })
-      await appendFile(join(dir, "hooks.log"), line)
+      await appendFile(join(dir, "hooks.log"), "[" + stamp + "] op​encode:" + evt + "\\n")
     } catch {} // fire-and-forget: 永不阻塞宿主
-  },
-})
+  }
+
+  // 从 cwd 向上找最近含 .brain/ 的祖先目录
+  async function findBrain(cwd) {
+    let d = cwd || process.cwd()
+    for (;;) {
+      try { const st = await stat(join(d, ".brain")); if (st.isDirectory()) return join(d, ".brain") } catch {}
+      const up = dirname(d)
+      if (up === d) return null
+      d = up
+    }
+  }
+
+  async function loggedToday(brain) {
+    try {
+      const txt = await readFile(join(brain, "log.md"), "utf8")
+      const d = new Date()
+      const pad = (n) => String(n).padStart(2, "0")
+      return txt.includes(d.getFullYear() + "-" + pad(d.getMonth() + 1) + "-" + pad(d.getDate()))
+    } catch { return false }
+  }
+
+  const TEARDOWN_MSG =
+    "[abs 收尾提醒] 本会话改过文件但 .brain/ 今天还没有记录。请立即走收尾循环：\\n" +
+    "1) 跑 abs load 看 Today 还有哪些未完成；\\n" +
+    "2) 实际做完漏登记的 abs task done <id>，做到一半的 abs task note <id> --note \\"断点\\"；\\n" +
+    "3) 值得留的经验 abs note \\"...\\"（宁少勿滥，能从代码 grep 到的不记）；\\n" +
+    "4) abs log \\"完成 X：...\\" 记一行工作成果，新页同步进 index。\\n" +
+    "简洁执行，不要复述本条提醒。若本次确实没有可沉淀产出，直接回一句\\"无可沉淀\\"即可。"
+
+  return {
+    // 观测真实写操作: write/edit/patch 类工具成功即标记
+    "tool.execute.after": async ({ tool }) => {
+      const t = String(tool || "").toLowerCase()
+      if (["write", "edit", "patch", "multiedit", "apply_patch"].includes(t)) wroteFiles = true
+    },
+
+    event: async ({ event }) => {
+      const type = event && event.type
+      if (!type) return
+      if (type === "session.created" || type === "session.deleted") {
+        await logHook(type)
+        return
+      }
+      if (type !== "session.idle") return // idle = 每轮结束, 不记日志(太吵), 只做收尾判定
+      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
+      await logHook("session.idle:teardown-nudge")
+      try {
+        await client.session.promptAsync({
+          path: { id: sessionID },
+          query: { directory: cwd },
+          body: { parts: [{ type: "text", text: TEARDOWN_MSG }] },
+        })
+      } catch {} // 注入失败不阻塞宿主
+    },
+  }
+}
+
+export default {
+  id: "abs",
+  server,
+}
 ${MARK}
 `;
 }