@fanchao8609/agent_brain_sync 1.7.2 → 1.7.4

package/package.json

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

package/skill/SKILL.md

@@ -158,6 +158,12 @@ monorepo 若多个子包各自独立交付，可各建一份 `.brain/`。`abs st
    - 还没做完 → `abs todo note <id> --note "接到哪/改到哪个文件"` 补断点（别空手续接）。
    滞留没清完就不算接上了状态——这是「任务做完没进 Done」的根治动作。
 3. **读命中页**：按关键词在 index 定位 → 读对应 concepts/entities 全文。
+   > ⚠️ **绝不通读 `.brain/`**。它是一个不断长大的知识图谱，当前仓库 29 页就约 11 万 token
+   > （单页最大 16KB）—— 全读会把窗口直接塞满。正确姿势：
+   > - 要状态 → `abs load`｜要主题 → `abs query <词>`（只回命中几页）
+   > - 要某页 → 只读那一页；页太长则只取相关小节
+   > - 需要汇总多页/多命令时，用 context-mode 的 `ctx_execute` 类工具在沙箱里处理后
+   >   **只打印结论**，别把原始文件内容拉进上下文。
 4. **续 todo**：默认续 todo 分支 → 把顶部未完成项当当前任务开做。
 5. **登记新任务**：有明确新任务而 todo 没有 → `abs todo add <id> --note 做什么` 登记
    再动工。不登记，会话一切断就丢。

package/src/store.js

@@ -4,7 +4,7 @@ import { promises as fs } from 'node:fs';
 import { join, resolve, dirname } from 'node:path';
 import { requireBrain, brainPath, absLogDir, BRAIN_DIR } from './index.js';
 import { requireUser, atTag, getUser } from './userconfig.js';
-import { addTask, upsertTask, boardText, readTodo, ensureTodo, todoTemplate, today, localStamp, setBreakpoint, moveBlocked, insertDoneGrouped, idOfTaskLine, archiveDoneInText, renderArchivePage, renderArchiveBody, DONE_KINDS, withDoneKind, doneKindOf, collapseDone } from './todo.js';
+import { addTask, upsertTask, boardText, readTodo, ensureTodo, todoTemplate, today, localStamp, setBreakpoint, moveBlocked, insertDoneGrouped, idOfTaskLine, archiveDoneInText, renderArchivePage, renderArchiveBody, DONE_KINDS, withDoneKind, doneKindOf, doneDateOf, collapseDone } from './todo.js';
 import { editFile, SKIP } from './lock.js';
 import { appendWrapup, strandedFor } from './wrapup.js';
 
@@ -825,6 +825,19 @@ export async function cmdLint({ dir }) {
         `逐条补 \`--as 落地|否决|仅方案\`（新条目：abs todo done <id> --as …）`,
       );
     }
+    // 完成日期同理必须由工具盖：手写 [x] 时人会抄语义部分（结语）而漏掉机械部分（日期）。
+    // 后果不只是排版不齐 —— 无日期行归入 `### （未标日期）` 尾组，而归档靠日期判天数，
+    // 故这些行**永远无法被 abs todo archive 迁出**（todo.js:300 保守跳过）。
+    // 即：漏一个日期 = 一条永久钉住 Done 区、拖大 load 输出的行。
+    // 两处在同一处校验（同一份契约的两半），别只查一半给假信心。
+    const noDate = doneBody.filter((l) => /^\s*- \[x\]/.test(l) && !doneDateOf(l));
+    if (noDate.length) {
+      const sample = (noDate[0].match(/- \[x\] (\S+)/) || [, '?'])[1];
+      issues.push(
+        `DONE-NO-DATE: Done 区 ${noDate.length} 条缺 \`(完成 YYYY-MM-DD)\`（如 ${sample}）。` +
+        `手写的 [x] 不会自动盖日期 —— 补上后重跑；新条目一律走 \`abs todo done <id>\`。`,
+      );
+    }
   }
 
   const n = issues.length;