@fanchao8609/agent_brain_sync 1.17.0 → 1.17.1

package/README.md

@@ -105,7 +105,8 @@ abs load                       # 开机读状态（Rules + 图谱计数 + 看板
 abs todo                       # 看板 Todo / Done（行首带状态标记）
 
 abs todo add     TASK-1 --note "要做什么"
-abs todo note    TASK-1 --note "改到 X 文件 L40"   # 实时断点
+abs todo note    TASK-1 --note "改到 X 文件 L40"   # 实时断点（一句话，上看板）
+abs todo memo    TASK-1 "随手记一段（可多句，不上看板）"   # 任务笔记 → sessions/；无参=查看
 abs todo state   TASK-1 --note "进行中|讨论中|滞留中"   # 改行首状态标记
 abs todo done    TASK-1
 

package/bin/abs.js

@@ -310,6 +310,7 @@ const subUsage = {
     '  abs todo add <id> [--note "做什么"] [--section 讨论中|滞留中|搁置]',
     '  abs todo rename <旧id> --note "<新id>"   改任务 id（起错名/不可读时）',
     '  abs todo note <id> --note "断点/进度"',
+    '  abs todo memo <id> "随手记（可多句）"  任务笔记 → sessions/，不上看板；无文字=查看',
     '  abs todo state <id> --note 进行中|讨论中|滞留中|搁置',
     '  abs todo done <id> [--as 落地|否决|仅方案] [结语文字]',
     '  abs todo archive [--keep-days N] [--dry-run]',
@@ -373,6 +374,7 @@ const TODO_ACTIONS = {
   add: 'start',
   start: 'start', // add 的别名(老习惯保留)
   note: 'note',
+  memo: 'memo', // 任务随手记：多句/追加/不占看板（无文字时=查看）
   state: 'state', // 改行首状态标记：进行中|讨论中|滞留中|搁置（原地，不搬区）
   rename: 'rename', // 改任务 id：人工起错名、或旧 id 不可读时用
   done: 'done',
@@ -467,7 +469,7 @@ async function main() {
         if (!action) {
           throw new Error(
             `✗ 未知子命令 "${sub}"\n` +
-            `  可用: add / start / note / state / done / archive\n` +
+            `  可用: add / start / note / memo / state / done / archive\n` +
             `  看板: abs todo（不带参数）\n` +
             `  登记任务: abs todo add <id> --note "做什么"`,
           );
@@ -475,13 +477,21 @@ async function main() {
         // done 的结语：--note "结语" 或位置参数（`abs todo done X 验证: 全绿`）都收。
         // 坑(2026-09-16 实测): --help 里写了 [结语文字] 但实现只读 --note，
         // 位置参数被 rejectExtra 当多余参数拒掉 —— 文档与实现不一致。
+        // memo 同：随手记常是多句带空格，位置参数收全段比 --note 顺手。
         const isDone = action === 'done';
+        const isMemo = action === 'memo';
         const usage = `abs todo ${sub} <id>${isDone ? ' [--as 落地|否决|仅方案] [--note "结语"]' : ' --note "…"'}`;
         if (isDone) {
           const note = opts.note || (rest2.length ? rest2.join(' ') : undefined);
           console.log(await cmdTask({ dir: opts.dir, action, id, section: opts.section, note, as: opts.as, session: opts.session }));
           break;
         }
+        if (isMemo) {
+          // 无文字 = 查看该任务所有随手记
+          const note = opts.note || (rest2.length ? rest2.join(' ') : undefined);
+          console.log(await cmdTask({ dir: opts.dir, action, id, note, session: opts.session }));
+          break;
+        }
         rejectExtra(rest2, usage);
         if (!id) throw new Error(`✗ 缺 <id>\n  用法: ${usage}`);
         console.log(await cmdTask({ dir: opts.dir, action, id, section: opts.section, note: opts.note, as: opts.as, session: opts.session }));

package/bin/mcp.js

@@ -112,12 +112,12 @@ tool(
 
 tool(
   'abs_task',
-  '任务实时落盘（幂等键 = id）。start 登记进 Todo / note 补断点(改到哪文件哪行) / state 改状态 / done 完成归位 Done（done 时 note=结语文字，as=结语类型：落地|否决|仅方案）。必填: cwd, action, id。多会话并行时，start/add 带上 session（值见 system prompt 的 [会话] 段）以标记「这条任务谁在做」。',
+  '任务实时落盘（幂等键 = id）。start 登记进 Todo / note 补断点(改到哪文件哪行) / memo 任务随手记（多句/追加/不上看板）/ state 改状态 / done 完成归位 Done（done 时 note=结语文字，as=结语类型：落地|否决|仅方案）。必填: cwd, action, id。多会话并行时，start/add 带上 session（值见 system prompt 的 [会话] 段）以标记「这条任务谁在做」。',
   {
-    action: z.enum(['add', 'start', 'done', 'note', 'state']),
+    action: z.enum(['add', 'start', 'done', 'note', 'memo', 'state']),
     id: z.string().describe('任务幂等键，如 TASK-xxx 或子任务名'),
     cwd: z.string().describe('项目根目录（.brain/ 所在处）'),
-    note: z.string().optional().describe('add/start=做什么; note=断点(文件/到哪步); state=进行中|讨论中|滞留中|搁置（搁置=用户改方向/不做了；滞留中=还要做只是卡住）; done=结语文字'),
+    note: z.string().optional().describe('add/start=做什么; note=断点(文件/到哪步，一句话); memo=随手记（可多句、不定长，追加式；不传=查看已有笔记）; state=进行中|讨论中|滞留中|搁置（搁置=用户改方向/不做了；滞留中=还要做只是卡住）; done=结语文字'),
     as: z.enum(['落地', '否决', '仅方案']).optional().describe('仅 done：结语类型。默认 落地。做了又撤/评估后不做用 否决，只设计过用 仅方案 —— 别让假【落地】污染看板'),
     // 会话 id：多会话并行时标记「这条任务是谁在做」。
     // 值取自 system prompt 里的 `[会话] 本会话 id = xxx`（hook 注入），由模型原样回传。

package/package.json

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

package/skill/abs-agent-brain-sync/SKILL.md

@@ -21,7 +21,7 @@ description: "USE FOR abs / agent-brain-sync 跨会话记忆与任务续接。
 
 ```bash
 abs load                          # 开机读状态；abs query <词> 检索；abs resolve <页名> 反查路径
-abs todo add <id> --note "做什么"   # 登记（note 补断点 / state 改标记 / done 完成）；abs log "完成 X" 记成果
+abs todo add <id> --note "做什么"   # 登记（note 补断点 / memo 随手记 / state 改标记 / done 完成）；abs log "完成 X" 记成果
 abs note "经验" [--tags a,b]       # 暂存经验；abs concept <slug> --title "…" 建概念页骨架
 abs rule [add "一句话"]           # 读写 ## Rules；abs lint 体检；abs todo archive 归档；abs init 建图谱
 ```
@@ -109,10 +109,35 @@ abs rule [add "一句话"]           # 读写 ## Rules；abs lint 体检；abs t
 | 认领新任务 / 聊出一个话题 | `start` + note 做什么 | Todo `[进行中]` |
 | 只在讨论、还没动手 | `state` + note 讨论中 | 原地改标记 |
 | 卡住了/等人等数据 | `state` + note 滞留中 | 原地改标记 |
-| 被打断/干到一半 | `note` + 改到哪个文件/到哪步 | 原地 ↳断点 |
+| 被打断/干到一半 | `note` + 改到哪个文件/到哪步 | 原地 ↳断点（**一句话**） |
+| 干活中想随手记一段（多句/发现/取舍/测试数据） | **`memo`** + 原文 | `sessions/log-<日期>-<id>.md`，**不上看板** |
 | 子任务做完 | `done` + note 结语 + as 落地\|否决\|仅方案 | Done（别让假【落地】污染看板） |
 | 总结出经验/坑/规律 | 改用 `abs_note` text + tags | sources/ |
 
+**四个落点的分工（选错就会被闸门拒，或被 lint 报）：**
+
+| 想记什么 | 入口 | 形态 | 上看板？ |
+|---|---|---|---|
+| 下一步做什么、卡在哪 | `note` | 一句话，**覆盖式**（旧值就该被替换） | 是 |
+| 过程随手记：发现、取舍、测试数据、为什么这么做 | `memo` | 可多句、不定长，**追加式**（旧值不能丢） | **否** |
+| 提炼过的经验/坑 | `abs_note` | 一句话结论 → sources/ 待提炼 | 否 |
+| 一轮干完的成果流水 | `abs log` | 正式流水行（要带 kind） | 否 |
+
+**为什么要有 `memo`（2026-10-11 用户实报「大量乱七八糟的总结都扔 todo 了」）：**
+断点写不下（设计上就只能一句话，用户明确要求保持），`abs log` 对「随手记一句」太重
+（要起 kind、进 log.md）。结果是干活途中想记一段时**没地方放**，就顺手塞 `todo.md`。
+实测 `.agents/.brain/todo.md` 被塞进 10 行实施报告，而 `abs lint` 报 0 问题；
+更早一次清理时发现「原内容只存在 todo.md，删任务时差点永久丢失」。
+
+现在 `todo.md` 的 Todo 区有**白名单闸门**：只能有任务行（`- [ ]`）、断点行（`↳ 断点:`）、
+空行、标题。其余一律拒写并报错。所以别再试着往里写总结了 —— **走 `memo`**。
+
+```bash
+abs todo memo <id> "第一句：根因是判据极性。第二句：改成白名单就不漏了。"   # 记（可多句）
+abs todo memo <id>                                                    # 查看
+```
+任务 `done` 后笔记文件留在 `sessions/`（随当日归档），不会丢。
+
 **硬规则（开工前触发器，别被状态表漏掉）：**
 
 1. **开工前先登记** —— 认领任何要动文件/跑命令的任务，**第一步是 `abs_task` action=start**，然后才读第一个文件。名字想不到就先起粗糙的（`fix-hook-nudge`）—— 名字可事后改，**未登记的开工补不回来**。

package/src/lint.js

@@ -5,6 +5,7 @@ import { join } from 'node:path';
 import { requireBrain, brainPath, BRAIN_DIR } from './index.js';
 import { readRules, idOfPage, statusOfPage, supersededByOf, clip, RULE_BODY_MAX } from './store.js';
 import { doneKindOf, doneDateOf, checkFileShape, TODO_MAX_LINES, LOG_MAX_LINES, INDEX_MAX_LINES } from './todo.js';
+import { isAllowedTodoLine, todoSectionOf } from './todo/common.js';
 
 // ---------- 图谱遍历 ----------
 
@@ -135,6 +136,13 @@ async function checkRootFiles(vault) {
     if (file !== 'todo.md') continue;
     for (let i = 0; i < lines.length; i++) {
       const l = lines[i];
+      // 裸文本行（与闸门 isAllowedTodoLine 同源，2026-10-11）：Todo 区只能有任务行/断点/空行/标题。
+      if (todoSectionOf(lines, i) === 'Todo' && !isAllowedTodoLine(l)) {
+        issues.push(
+          `TODO-STRAY-PROSE: ${BRAIN_DIR}/${file}:${i + 1} (Todo 区里的裸文本，不是任务行也不是断点；` +
+          `总结/报告/清单请分流：流水 → abs log，经验 → abs note，长设计 → sources/)`,
+        );
+      }
       if (!l.trimStart().startsWith('↳ 断点:')) continue;
       const bp = l.trimStart().slice('↳ 断点:'.length).trim();
       if (bp.length > LINT_BREAKPOINT_MAX) {
@@ -203,7 +211,12 @@ function checkPage(pg, names, linkedNames, inbound) {
   if (pg.dir === 'concepts' && !hasTail(pg.body)) {
     issues.push(`NO-TAIL: ${pg.rel}（无「做完怎么确认」；尾巴写清跑什么/看什么/按什么判据，别只有头）`);
   }
-  if (pg.dir !== 'sources' && !pg.indexed) {
+  // 「任务随手记」（abs todo memo）不登记 index：它是**某任务的过程草稿**，
+  // 数量随任务数增长且生命周期短（任务完就没人看），登记会把 index 冲垮 ——
+  // 而 index 的契约是「可扫描的图谱导航」。与 sources/ 同理豁免（都是「暂存待处理」）。
+  // 判据用 tag 而非文件名：文件名规则将来可能调，tag 是语义标记。
+  const isTaskMemo = pg.dir === 'sessions' && /task-memo/.test(pg.frontmatter);
+  if (pg.dir !== 'sources' && !isTaskMemo && !pg.indexed) {
     issues.push(`INDEX-MISSING: ${pg.rel} not listed as [[${pg.slug}]] in index.md`);
   }
   return issues;

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 } from './index.js';
 import { requireUser, atTag, getUser, placeholderWarn } from './userconfig.js';
-import { stripStateMark, ensureStateMark, stateOfTaskLine, TODO_MAX_LINES, upsertTask, boardText, readTodo, todoTemplate, today, localStamp, setBreakpoint, setStateMark, TASK_STATES, insertDoneGrouped, idOfTaskLine, archiveDoneInText, upsertArchiveSection, DONE_KINDS, withDoneKind, collapseDone, SEC, rebuildStructure, enforceBrainFormat, sessionOf } from './todo.js';
+import { stripStateMark, ensureStateMark, stateOfTaskLine, TODO_MAX_LINES, upsertTask, boardText, readTodo, todoTemplate, today, localStamp, setBreakpoint, setMemo, readMemo, setStateMark, TASK_STATES, insertDoneGrouped, idOfTaskLine, archiveDoneInText, upsertArchiveSection, DONE_KINDS, withDoneKind, collapseDone, SEC, rebuildStructure, enforceBrainFormat, sessionOf } from './todo.js';
 import { setFormatGate, editFile, SKIP } from './lock.js';
 import { appendWrapup, strandedFor } from './wrapup.js';
 import { keywords, recentFiles, topicStrength } from './relevant.js';
@@ -929,6 +929,16 @@ export async function cmdTask({ dir, action, id, section, note, as, session }) {
     const r = await setBreakpoint(root, { id, text: note });
     return r.msg;
   }
+  if (action === 'memo') {
+    // 任务随手记：多句/不定长/可追加，不占看板。无 note 时 = 查看已有笔记。
+    if (!id) return '用法: abs todo memo <id> "随手记（可多句）"  |  abs todo memo <id>（查看）';
+    if (!note) {
+      const body = await readMemo(root, id);
+      return body || `（${id} 没有随手记）`;
+    }
+    const r = await setMemo(root, { id, text: note });
+    return r.msg;
+  }
   if (action === 'done') {
     // 找到匹配 id 的行，勾选并归位 Done（简化：若行在某 section 则标记完成）
     // --as 结语：落地(默认) / 否决 / 仅方案 —— 让 [x] 可被信任（见 todo.js DONE_KINDS）

package/src/todo/common.js

@@ -52,6 +52,17 @@ export function sigOfLine(l) {
   return String(l).replace(/\s+/g, ' ').trim().slice(0, 120);
 }
 
+/** 一行落在 todo.md 的哪个分区（`## Todo` / `## Done`）。
+ *  返回 'Todo' | 'Done' | null。用于「按区判」—— Done/Archived 区的行不该按
+ *  Todo 区的白名单判（日期分组、归档链接都是合法内容）。 */
+export function todoSectionOf(lines, i) {
+  for (let k = i; k >= 0; k--) {
+    const m = String(lines[k]).match(/^##\s+(\S.*)$/);
+    if (m) return m[1].trim();
+  }
+  return null;
+}
+
 /** 把一份文本里所有「违规行」的签名收成集合（供存量/新增比对）。
  *  只有三个根文件用得上；非目标文件直接返回空集。
  *  ★ 空行特殊：签名取「上下两行拼接」不可靠 —— 插入一行就会让空行的
@@ -96,6 +107,24 @@ export function isChildLine(l) {
   return /^\s*↳/.test(l);
 }
 
+/** Todo 分区里「合法行」以外的东西 = 裸文本（总结/报告/清单）。
+ *  为什么补这个判据（2026-10-11，同一个坑第三次复发）：
+ *  闸门原来只认 `- [ ]` 任务行与 `↳ 断点:` 行，**其余行直接跳过**（无 else 分支）。
+ *  于是把总结写成「紧跟任务行的裸文本行」就三层全部放行：闸门不看、形状规则不管、
+ *  lint 只查断点行 —— 实测 .agents/.brain/todo.md 被塞进 10 行实施报告而 lint 报 0 问题。
+ *  前面的修法都挂在「行的形态」上（先修超长断点、再修多句断点），换个形态就绕过。
+ *  改成白名单：Todo 区里除了任务行/断点/空行/标题，别的都是非法。
+ *  只在 `## Todo` 区生效 —— Done/Archived 区有日期分组与归档链接，判据不同。
+ *  返回 false 才叫非法。 */
+export function isAllowedTodoLine(l) {
+  const t = l.trim();
+  if (!t) return true;                        // 空行
+  if (/^#{1,3}\s/.test(t)) return true;       // `## Todo` / `### …` 标题
+  if (isTaskLine(l)) return true;             // 任务行
+  if (isChildLine(l)) return true;            // ↳ 断点附属行
+  return false;
+}
+
 /** 把 Done 区文本（bodyLines，不含 `## Done` 标题）解析成任务单元 [{ date, lines:[main,...children] }]。
  * 剥 `### 日期` 分组标题与空行；任务行下紧跟的 ↳ 行并入该单元。 */
 

package/src/todo/tasks.js

@@ -1,9 +1,10 @@
 // src/todo/tasks.js — 任务读写入口：读、加、改状态、断点、看板。
 
 import { promises as fs } from 'node:fs';
+import { join } from 'node:path';
 import { brainPath } from '../index.js';
 import { editFile, SKIP } from '../lock.js';
-import { today, extractId, extractNote, extractAuthor, isLegacyAuthorTag, claimOf } from './common.js';
+import { today, localStamp, extractId, extractNote, extractAuthor, isLegacyAuthorTag, claimOf } from './common.js';
 import { todoTemplate, normalizeTodo, stateOfTaskLine, stripStateMark } from './structure.js';
 import { TASK_STATES } from './spec.js';
 import { collapseDone, groupDoneSection } from './archive.js';
@@ -154,6 +155,76 @@ export async function setBreakpoint(brainRoot, { id, text }) {
     : { ok: true, msg: `✓ 断点已落 → ${id}\n  ${bp.trim()}` };
 }
 
+// ---------- 任务随手记（memo）----------
+/** 任务进行中的随手记：多句、不定长、可追加，**不占看板**。
+ *
+ * 为何需要它（2026-10-11，用户定）：断点只该一句话（用户明确要求保持），
+ * 而 `abs log` 要起 kind、进 log.md，对「随手记一句」太重；`abs note` 只管
+ * 经验/坑且落 sources/。于是任务干到一半想记「现在做到哪、发现了什么」时
+ * **没有轻档位**，AI 就顺手塞进 todo.md —— 实测 .agents/.brain/todo.md 被塞进
+ * 10 行实施报告，而清理时发现「原内容只存在 todo.md，删任务时差点永久丢失」。
+ * 堵（白名单闸门）只治标：不给出路，下次还会换个写法再塞。本命令就是那条出路。
+ *
+ * 落点选 sessions/（不是新目录）：那里已有目录遍历/frontmatter/归档机制，
+ * lint 的豁免判据也是现成的（两条契约都已核实）：
+ *   · `archive` tag  → SESSIONS-SPLIT / SESSIONS-NAMING 豁免（它们只算无 archive 的）
+ *   · `log-` 前缀   → ORPHAN-PAGE 豁免（sessions 里非 log- 开头要求有链接）
+ * 所以文件名取 `log-<日期>-<id>.md`，两个条件同时满足，**不改 lint 任何契约**。
+ *
+ * 追加式（不是覆盖）：每次调用多一条带时间戳的条目，与断点的语义有意不同 ——
+ * 断点是「现在到哪了」（旧值就该被替换），memo 是「过程流水」（旧值不能丢）。 */
+export async function setMemo(brainRoot, { id, text, at }) {
+  const stamp = at || localStamp();
+  const dir = brainPath(brainRoot, 'sessions');
+  const file = join(dir, `log-${today()}-${id}.md`);
+  const rel = `sessions/log-${today()}-${id}.md`;
+  const line = `- ${stamp} ${text}`;
+  const head = [
+    '---',
+    'tags: [archive, task-memo]', // archive → 豁免一天一文件；task-memo → 标明用途
+    `id: log-${today()}-${id}`,
+    `updated: ${today()}`,
+    '---',
+    '',
+    `# 任务随手记：${id}`,
+    '',
+    `━━ ${id} 的过程笔记（不上看板；任务结束后随 sessions 留存）`,
+    '',
+  ].join('\n');
+  await fs.mkdir(dir, { recursive: true });
+  // 全程走 editFile 的锁：同一任务的并发 memo 不能丢条目（append 是 read-modify-write）。
+  // 初次创建也走它 —— editFile 对「文件尚不存在」已经处理（current=null），
+  // 自己再写一份 tmp+rename 分支反而绕过锁，首次并发两个 memo 会互相覆盖。
+  await editFile(file, (cur) => {
+    if (cur === null) return { text: `${head}${line}\n` };
+    const t = cur.replace(/\n+$/, '');
+    const next = /^updated:\s*.+$/m.test(t) ? t.replace(/^updated:\s*.+$/m, `updated: ${today()}`) : t;
+    return { text: `${next}\n${line}\n` };
+  });
+  return { ok: true, msg: `✓ 随手记 → ${rel}\n  ${line}` };
+}
+
+/** 读回某任务的随手记（无则空）。供 CLI/MCP 查看与 done 时提醒。
+ *  按**完整文件名后缀**匹配而不是 id 后缀：`endsWith('-${id}.md')` 会让
+ *  `t-1` 误命中 `task-t-1`（同族坑见 idOfTaskLine 的全等比对注释）。
+ *  文件名形如 `log-<日期>-<id>.md`，所以匹配 `-<id>.md` 时必须确认 id 是**最后一段**。 */
+export async function readMemo(brainRoot, id) {
+  const dir = brainPath(brainRoot, 'sessions');
+  const files = await fs.readdir(dir).catch(() => []);
+  const want = String(id).replace(/\u200b/g, '');
+  const hit = files.filter((f) => {
+    const m = f.match(/^log-\d{4}-\d{2}-\d{2}-(.+)\.md$/);
+    return m && m[1] === want;
+  }).sort();
+  if (!hit.length) return '';
+  const parts = [];
+  for (const f of hit) {
+    const body = await fs.readFile(join(dir, f), 'utf8').catch(() => '');
+    parts.push(body.trim());
+  }
+  return parts.join('\n\n');
+}
+
 // ---------- 看板输出 ----------
 
 export async function boardText(brainRoot, textOverride, { full = false } = {}) {

package/src/todo/validate.js

@@ -1,7 +1,7 @@
 // src/todo/validate.js — 条目级闸门：形状校验、长度限制、空行检查。
 
 import { TODO_SECTIONS, isAllowedTodoSub, INDEX_SECTIONS, ENTRY_SHAPES, indexLinkSectionNeeds, BREAKPOINT_MAX, TASK_LINE_MAX } from './spec.js';
-import { sigOfLine, REPORT_MARKERS, sentenceCount, isTaskLine } from './common.js';
+import { sigOfLine, REPORT_MARKERS, sentenceCount, isTaskLine, isAllowedTodoLine, todoSectionOf } from './common.js';
 
 export function checkFileShape(file, text, { lintMode = false } = {}) {
   const issues = [];
@@ -193,6 +193,18 @@ export function assertTodoContent(text, prevSig = null) {
       }
       continue;
     }
+    // 裸文本行（2026-10-11）：Todo 区里既不是任务行也不是断点的行 = 总结/报告/清单。
+    // 前面的修法都挂在「行的形态」上（超长断点、多句断点），把总结写成裸文本行就全部绕过
+    // ——同一个坑第三次复发。改成白名单后，换形态也落回这里。
+    // 按区判：Todo 区才管；Done/Archived 区有日期分组与归档链接，判据不同。
+    // 存量行（prevSig）放行，交给 lint 报 —— 否则老库直接被锁死写不进去。
+    if (todoSectionOf(lines, i) === 'Todo' && !isAllowedTodoLine(l) && !isLegacy(l)) {
+      throw new Error(
+        `✗ todo 的 Todo 区不允许裸文本（第 ${lineNo} 行）—— 这里只放任务行（- [ ] …）与断点行（↳ 断点: …）。\n` +
+        `  「总结/实施报告/清单」请分流：流水与测试数据 → abs log；经验与坑 → abs note；长设计与方案 → .brain/sources/ 页。\n` +
+        `  原文开头: ${l.trim().slice(0, 60)}...`,
+      );
+    }
   }
   return true;
 }

package/src/todo.js

@@ -7,4 +7,4 @@ export { LEGACY_SECTION_RENAMES, TODO_SECTIONS, TODO_SUBSECTIONS, isAllowedTodoS
 export { todoTemplate, rebuildStructure, dropRetiredSections, enforceBrainFormat, normalizeTodo, ensureStateMark, stateOfTaskLine, stripStateMark } from './todo/structure.js';
 export { checkFileShape, violationSignatures, assertNoStrayBlank, assertTodoContent } from './todo/validate.js';
 export { doneDateOf, doneKindOf, withDoneKind, collapseDone, archiveDoneInText, renderArchiveBody, upsertArchiveSection, groupDoneSection, insertDoneGrouped } from './todo/archive.js';
-export { readTodo, ensureTodo, setStateMark, addTask, upsertTask, idOfTaskLine, findTaskLine, setBreakpoint, boardText } from './todo/tasks.js';
+export { readTodo, ensureTodo, setStateMark, addTask, upsertTask, idOfTaskLine, findTaskLine, setBreakpoint, setMemo, readMemo, boardText } from './todo/tasks.js';