@fanchao8609/agent_brain_sync 1.1.0 → 1.2.1

package/bin/abs.js

@@ -2,7 +2,7 @@
 // bin/abs.js — abs CLI 入口。
 // abs <cmd> [args]
 // 命令: init / board / status / load / task / install / uninstall / help
-import { cmdInit, cmdBoard, cmdStatus, cmdLoad, cmdTask, cmdLog, cmdQuery, cmdLint, cmdNote, cmdShow, cmdRepair, cmdWrapup } from '../src/store.js';
+import { cmdInit, cmdBoard, cmdStatus, cmdLoad, cmdTask, cmdLog, cmdQuery, cmdLint, cmdNote, cmdShow, cmdRepair, cmdWrapup, cmdTeardownCheck } from '../src/store.js';
 import { runInstall, runUninstall, installSummary } from '../src/install.js';
 import { readFileSync } from 'node:fs';
 import { join, dirname, resolve } from 'node:path';
@@ -69,6 +69,7 @@ function parseArgv(args) {
     else if (a === '--id') { o.id = args[++i]; }
     else if (a === '--section') { o.section = args[++i]; }
     else if (a === '--note') { o.note = args[++i]; }
+    else if (a === '--payload') { o.payload = args[++i]; }
     else if (a === '--yes') { o.yes = true; }
     else if (a === '--repair') { o.repair = true; }
     else if (a === '--no-mcp') { o.mcp = false; }
@@ -155,6 +156,11 @@ async function main() {
         console.log(await cmdWrapup({ dir: opts.dir }));
         break;
       }
+      // Stop hook 用: 判定是否注入收尾指令。stdout 给 shell (`push:<json>` / `{}`), 无额外输出。
+      case 'teardown-check': {
+        process.stdout.write((await cmdTeardownCheck({ dir: opts.dir, payload: opts.payload })) + '\n');
+        break;
+      }
       case 'update':  await cmdUpdate({ yes: opts.yes }); break;
       case '--version': case '-v': case 'version': console.log(pkgVersion()); break;
       case 'help': case undefined: case '--help': console.log(usage); break;

package/hooks/event.sh

@@ -15,6 +15,18 @@ EVENT="__EVENT__"
 
 PAYLOAD=$(cat 2>/dev/null | head -c 500)
 
+# ── Stop 收尾注入 (CC/Co​dex 的"主动推") ─────────────────────────────────
+# 守卫同 pi 插件四条件: ①本会话真改过文件 ②本项目有 .brain ③log.md 今日无条目 ④每会话一次。
+# 判定在 CLI 里做(cmdTeardownCheck)，这里只解析结果。
+# 关键: 回宿主的 decision:block 必须走 stdout 同步输出，所以判定要在前台算完，不能放后台子 shell。
+BAIL='{}'
+if [ "$EVENT" = "Stop" ]; then
+  TEARDOWN=$("$NODE_BIN" "$ABS_BIN" teardown-check --payload "$PAYLOAD" 2>/dev/null)
+  case "$TEARDOWN" in
+    push:*) BAIL=$(printf '%s' "$TEARDOWN" | sed 's/^push://') ;;
+  esac
+fi
+
 # 后台执行，hook 立即返回——宿主热路径零阻塞。
 (
   # 幂等: 同一 payload 指纹在 60s 内只落一行 (防重复触发)。
@@ -36,10 +48,29 @@ PAYLOAD=$(cat 2>/dev/null | head -c 500)
   SESSION_ID=$(printf '%s' "$PAYLOAD" | sed -n 's/.*"session_id":"\([^"]*\)".*/\1/p' | head -1)
   LOG_DIR="${ABS_LOG_DIR:-$HOME/.abs/log}"
   mkdir -p "$LOG_DIR" 2>/dev/null
+
+  # 日志轮转: hooks.log 是 append-only 热路径, 无上限会无限长。
+  # 用 wc -c 判大小(/bin/sh 无 GNU stat -c); 超限就轮转一份 .1 并截断。
+  # 阈值可经 ABS_LOG_MAX_BYTES 覆盖; 只要一份历史(.1), 不做多层——排查靠近期痕迹, 旧的不值当留。
+  ABS_LOG_MAX="${ABS_LOG_MAX_BYTES:-1048576}"   # 1 MiB
+  LOGF="$LOG_DIR/hooks.log"
+  if [ -f "$LOGF" ]; then
+    SZ=$(wc -c < "$LOGF" 2>/dev/null | tr -d ' ')
+    case "$SZ" in ''|*[!0-9]*) SZ=0 ;; esac
+    if [ "$SZ" -gt "$ABS_LOG_MAX" ] 2>/dev/null; then
+      mv -f "$LOGF" "$LOGF.1" 2>/dev/null || : > "$LOGF"
+      printf '[%s] logrotate hooks.log (%s bytes -> .1)\n' "$(date '+%Y-%m-%d %H:%M:%S')" "$SZ" >> "$LOGF" 2>/dev/null || true
+    fi
+  fi
   {
     printf '[%s] %s %s\n' "$(date '+%Y-%m-%d %H:%M:%S')" "$EVENT" "$SHORT"
   } >> "$LOG_DIR/hooks.log" 2>/dev/null || true
 
+  case "$BAIL" in
+    '{}') ;;
+    *) printf '[%s] %s teardown-nudge 注入收尾指令\n' "$(date '+%Y-%m-%d %H:%M:%S')" "$EVENT" >> "$LOG_DIR/hooks.log" 2>/dev/null || true ;;
+  esac
+
   # Stop 专用: 低噪声 wrap-up 提醒 (独立文件, 不进 per-event hooks.log, 不碰图谱 todo/log.md)。
   # 纯机械信号——"一个会话结束了"; 是否真有滞留任务/经验由 agent 自觉判断, hook 不替做。
   if [ "$EVENT" = "Stop" ]; then
@@ -54,5 +85,5 @@ PAYLOAD=$(cat 2>/dev/null | head -c 500)
 ) &
 
 # Claude Code 等宿主要求 stdout 以 { 开头才不告警。
-printf '{}\n'
+printf '%s\n' "$BAIL"
 exit 0

package/package.json

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

package/src/install.js

@@ -286,12 +286,16 @@ const server = async ({ client, directory }) => {
     }
   }
 
+  // 判定"今天是否收尾过": 必须匹配 log.md 的条目头 '## [YYYY-MM-DD HH:MM]'。
+  // 坑: 曾用裸日期 substring(includes('2026-09-10')), 结果正文/任务行里任何一处
+  //     提到今天就能把 nudge 永久压掉(误判为已收尾), 守卫形同虚设。
   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()))
+      const today = d.getFullYear() + "-" + pad(d.getMonth() + 1) + "-" + pad(d.getDate())
+      return new RegExp("^## \\\\[" + today + " \\\\d{2}:\\\\d{2}\\\\]", "m").test(txt)
     } catch { return false }
   }
 
@@ -303,11 +307,24 @@ const server = async ({ client, directory }) => {
     "4) abs log \\"完成 X：...\\" 记一行工作成果，新页同步进 index。\\n" +
     "简洁执行，不要复述本条提醒。若本次确实没有可沉淀产出，直接回一句\\"无可沉淀\\"即可。"
 
+  // bash 里只跑查询类命令不算改文件 (与 pi 侧 READONLY_CMD 同义, 但生成代码里要写进模板串)
+  const READONLY_CMD = /^\\s*(ls|cat|grep|rg|find|head|tail|wc|git\\s+(status|log|diff|show|branch)|pwd|which|echo|node\\s+-v|npm\\s+(ls|view)|curl)\\b/
+
   return {
-    // 观测真实写操作: write/edit/patch 类工具成功即标记
-    "tool.execute.after": async ({ tool }) => {
+    // 观测真实写操作: write/edit/patch 类工具成功即标记。
+    // 坑: 曾漏掉 bash —— op​encode 里很多修改是经 bash(heredoc/sed) 完成的, 纯 bash 会话
+    //     永远不置位 wroteFiles, 于是收尾提醒静默不发。与 pi 侧 WRITE_TOOLS 保持一致。
+    "tool.execute.after": async ({ tool, args }) => {
       const t = String(tool || "").toLowerCase()
-      if (["write", "edit", "patch", "multiedit", "apply_patch"].includes(t)) wroteFiles = true
+      if (["write", "edit", "patch", "multiedit", "apply_patch"].includes(t)) {
+        wroteFiles = true
+        return
+      }
+      // bash 里只有非只读命令算改文件(ls/cat/git status 之类不算)
+      if (t === "bash") {
+        const cmd = String((args && (args.command || args.cmd)) || "")
+        if (cmd && !READONLY_CMD.test(cmd)) wroteFiles = true
+      }
     },
 
     event: async ({ event }) => {
@@ -428,14 +445,19 @@ async function findBrain(cwd: string): Promise<string | null> {
   }
 }
 
-/** .brain/log.md 今天有记录吗? 有=已收尾, 不再打扰。 */
+/**
+ * .brain/log.md 今天有记录吗? 有=已收尾, 不再打扰。
+ * 必须匹配条目头 '## [YYYY-MM-DD HH:MM]' —— 裸日期 substring 会被正文里任意一处
+ * 今天的日期误命中, 导致"已收尾"误判、nudge 永不触发。
+ */
 async function loggedToday(brain: string): Promise<boolean> {
   try {
     const txt = await readFile(join(brain, "log.md"), "utf8")
     const d = new Date()
     const pad = (n: number) => String(n).padStart(2, "0")
     const today = d.getFullYear() + "-" + pad(d.getMonth() + 1) + "-" + pad(d.getDate())
-    return txt.includes(today)
+    // 注意: 这里是真实 TS, 不是生成代码的模板字符串。用拼接形式避免反斜杠逃逸歧义。
+    return new RegExp("^## \\\\[" + today + " \\\\d{2}:\\\\d{2}\\\\]", "m").test(txt)
   } catch { return false }
 }
 

package/src/store.js

@@ -1,9 +1,10 @@
 // src/store.js — CLI 命令实现：图谱读写层。
 // 命令: init / board / status / load / task / query / lint
 import { promises as fs } from 'node:fs';
-import { join, resolve } from 'node:path';
+import { join, resolve, dirname } from 'node:path';
+import { homedir } from 'node:os';
 import { requireBrain, findBrainRoot, brainPath } from './index.js';
-import { addTask, upsertTask, boardText, readTodo, ensureTodo, todoTemplate, today, localStamp, setBreakpoint, moveBlocked, insertDoneGrouped } from './todo.js';
+import { addTask, upsertTask, boardText, readTodo, ensureTodo, todoTemplate, today, localStamp, setBreakpoint, moveBlocked, insertDoneGrouped, idOfTaskLine } from './todo.js';
 import { editFile, SKIP } from './lock.js';
 import { appendWrapup, strandedFor, wrapupLogPath } from './wrapup.js';
 
@@ -192,6 +193,70 @@ export async function cmdWrapup({ dir }) {
   return appendWrapup(root);
 }
 
+/**
+ * Stop hook 收尾注入判定 —— CC/Co​dex 的"主动推"。
+ * 与 pi 插件四条件一致: ①本会话真改过文件 ②有 .brain ③log.md 今日无条目 ④每会话一次。
+ * 输出给 shell: `push:<json>` = 注入, 其它 = 放行。JSON 走 stdout 回宿主的 decision:block。
+ * 所有异常一律放行(`{}`), 绝不因判定失败而卡住用户会话。
+ */
+export async function cmdTeardownCheck({ dir, payload }) {
+  try {
+    let ev = {};
+    try { ev = JSON.parse(payload || '{}'); } catch { ev = {}; }
+
+    // 条件①: 本会话真改过文件。CC 的 Stop payload 不带工具足迹,
+    // 故以 transcript_path 为准; 取不到就退化为"本项目今日是否已有产物"判断。
+    const transcript = ev.transcript_path || ev.transcriptPath;
+    if (transcript) {
+      const txt = await readIfExists(transcript);
+      const wrote = /"(Write|Edit|MultiEdit|NotebookEdit)"/.test(txt);
+      if (!wrote) return '{}'; // 纯只读会话不打扰
+    }
+
+    // 条件②: 本项目有 .brain
+    const dir0 = dir || ev.cwd || process.cwd();
+    let root;
+    try { root = await requireBrain(dir0); } catch { return '{}'; }
+
+    // 条件③: log.md 今日尚无条目(条目头 '## [YYYY-MM-DD HH:MM]')
+    const logTxt = await readIfExists(brainPath(root, 'log.md'));
+    const stamp = localStamp();            // 'YYYY-MM-DD HH:MM'
+    const day = stamp.slice(0, 10);
+    if (new RegExp('^## \\[' + day + ' \\d{2}:\\d{2}\\]', 'm').test(logTxt)) return '{}';
+
+    // 条件④: 每会话一次。
+    // 双保险, 因为官方 stop_hook_active 有已知
+    // 不传播 bug(claude-code#54360): 同一 turn 内重复 fire 时它仍是 false。
+    // ① 官方契约: stop_hook_active=true = 本次 Stop 已是注入后的产物, 绝不再推(否则死循环)
+    if (ev.stop_hook_active === true) return '{}';
+    // ② 己方节流: 以 session_id 落 mark。缺 id 时退化为按项目+日期节流,
+    //    绝不"无节流"——否则一旦宿主张不到 id, decision:block 就会无限自激。
+    const sid = String(ev.session_id || ev.sessionId || '').replace(/[^\w-]/g, '');
+    const key = sid || 'nosession-' + day + '-' + root.replace(/[^\w]/g, '_');
+    const mark = join(homedir(), '.abs', 'log', `teardown-${key}.mark`);
+    try {
+      await fs.access(mark);
+      return '{}'; // 本会话(或本项目今日)已推过
+    } catch { /* 未推过 */ }
+    await fs.mkdir(dirname(mark), { recursive: true });
+    await fs.writeFile(mark, stamp).catch(() => {});
+
+    const msg = [
+      '[abs 收尾提醒] 本会话改过文件但 .brain/ 今天还没有记录。请立即走收尾循环：',
+      '1) 跑 abs load 看 Today 还有哪些未完成；',
+      '2) 实际做完漏登记的 abs task done <id>，做到一半的 abs task note <id> --note "断点"；',
+      '3) 值得留的经验 abs note "..."（宁少勿滥，能从代码 grep 到的不记）；',
+      '4) abs log "完成 X：..." 记一行工作成果，新页同步进 index。',
+      '简洁执行，不要复述本条提醒。若本次确实没有可沉淀产出，直接回一句"无可沉淀"即可。',
+    ].join('\n');
+
+    // Cl​aude Code Stop hook 契约: {"decision":"block","reason":"..."} = 阻止结束并把 reason 回灌给 agent
+    return 'push:' + JSON.stringify({ decision: 'block', reason: msg });
+  } catch {
+    return '{}'; // 永不阻塞宿主
+  }
+}
+
 async function readIfExists(p) {
   try { return (await fs.readFile(p, 'utf8')).trim(); } catch { return ''; }
 }
@@ -255,9 +320,10 @@ async function markDone(file, id) {
     let changed = false;
     let moved = null;
     const kept = [];
+    const wantId = String(id).replace(/\u200b/g, '');
     for (let i = 0; i < lines.length; i++) {
       const l = lines[i];
-      if (!moved && l.startsWith('- [ ]') && l.includes(id)) {
+      if (!moved && idOfTaskLine(l) === wantId) {
         changed = true;
         const head = l.replace('- [ ]', '- [x]').replace(/\(认领[^)]*\)/, '') + ` (完成 ${today()})`;
         const bp = [];

package/src/todo.js

@@ -215,8 +215,8 @@ export async function upsertTask(brainRoot, { section, text }) {
   const out = await editFile(p, (orig) => {
     const base = normalizeTodo(orig);
     const lines = base.split('\n');
-    // 在所有分区中找含该 id 的未完成任务行（Done 的已完成行不重复动）
-    const idx = lines.findIndex((l) => l.startsWith('- [ ]') && id && l.includes(id));
+    // 在所有分区中找该 id 对应的未完成任务行（Done 的已完成行不重复动）；全等比对
+    const idx = findTaskLine(lines, id);
     if (idx !== -1) {
       // 原位更新：保留断点附属行，只换任务行本体
       const oldNote = extractNote(lines[idx].replace(/^- \[ \] /, ''));
@@ -244,10 +244,25 @@ export function extractNote(text) {
   return i === -1 ? '' : String(text).slice(i + 3).replace(/\s*\(认领[^)]*\)\s*$/, '');
 }
 
-/** 定位含 id 的未完成任务行下标；附属断点行（↳ 开头）不算任务行。 */
+/**
+ * 从任务行取出行首 id token（`- [ ] <id> …` 里的 <id>）。
+ * 坑: 不能用 l.includes(id) 定位任务 —— 那是子串匹配，`T1` 会命中 `T11`（同理
+ * TASK-1/TASK-10、fix-hook/fix-hook-2），导致 upsert 误判"已存在"而原地改写别的任务、
+ * 新任务静默消失。必须取出 id token 做全等比对。
+ * id 里可能混入零宽字符(历史瑕疵)，比对前先剥掉。
+ */
+export function idOfTaskLine(line) {
+  if (!line || !line.startsWith('- [ ]')) return null;
+  const m = line.match(/^- \[ \] (\S+)/);
+  return m ? m[1].replace(/\u200b/g, '') : null;
+}
+
+/** 定位 id 对应的未完成任务行下标；附属断点行（↳ 开头）不算任务行。
+ *  全等比对，不用 includes（否则 T1 会误命中 T11）。 */
 export function findTaskLine(lines, id) {
   if (!id) return -1;
-  return lines.findIndex((l) => l.startsWith('- [ ]') && l.includes(id));
+  const want = String(id).replace(/\u200b/g, '');
+  return lines.findIndex((l) => idOfTaskLine(l) === want);
 }
 
 /** 实时断点: 在 id 任务行下原位补/换 `↳ 断点:` 附属行（不挪任务位置）。 */