@fanchao8609/agent_brain_sync 0.2.0 → 0.3.0

package/package.json

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

package/src/install.js

@@ -241,31 +241,101 @@ 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"
 
-export const AbsPlugin = async () => ({
-  event: async ({ name }) => {
-    if (!["session.start", "session.end"].includes(name)) return
+export const AbsPlugin = async ({ client, directory }) => {
+  // 本会话是否真改过文件 (由 tool.execute.after 观测)
+  let wroteFiles = false
+  let nudged = false
+
+  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 {} // 注入失败不阻塞宿主
+    },
+  }
+}
 ${MARK}
 `;
 }

package/src/store.js

@@ -422,6 +422,12 @@ export async function cmdLint({ dir }) {
   const pages = await listPages(vault);
   const names = new Set(pages.map((p) => p.slug));
   const linkedNames = new Set(pages.flatMap((p) => p.links));
+  // index.md 里列的 [[x]] —— 用于反向查死引用（列了但页不存在）
+  let indexLinks = [];
+  try {
+    const idx = await fs.readFile(join(vault, 'index.md'), 'utf8');
+    indexLinks = [...idx.matchAll(/\[\[([^\]|#]+)/g)].map((m) => m[1].trim());
+  } catch { /* 无 index 则不查 */ }
   const issues = [];
 
   for (const pg of pages) {
@@ -447,6 +453,13 @@ export async function cmdLint({ dir }) {
     }
   }
 
+  // index.md 反向检查: 列了 [[x]] 但 x 页不存在 —— 删页/归档 source 后忘了清 index 的残留。
+  // (page→index 的 INDEX-MISSING 已有, 这里补 index→page, 否则死引用静默留在入口文件里)
+  for (const ln of indexLinks) {
+    if (/slug|Name|name|Date|页面名$/.test(ln)) continue; // 模板占位行
+    if (!names.has(ln)) issues.push(`INDEX-DEAD-LINK: index.md -> [[${ln}]] (该页不存在, 删页后忘清 index?)`);
+  }
+
   const nsrc = pages.filter((p) => p.dir === 'sources').length;
   if (nsrc > 10) issues.push(`SOURCES-PILED-UP: sources/ has ${nsrc} files > 10; 提炼归档旧 source`);