@fanchao8609/agent_brain_sync 1.17.2 → 1.19.0

package/src/todo/tasks.js

@@ -4,7 +4,7 @@ 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, localStamp, extractId, extractNote, extractAuthor, isLegacyAuthorTag, claimOf } from './common.js';
+import { today, localStamp, extractId, extractNote, extractAuthor, isLegacyAuthorTag, claimOf, parseChild, renderChild } from './common.js';
 import { todoTemplate, normalizeTodo, stateOfTaskLine, stripStateMark } from './structure.js';
 import { TASK_STATES } from './spec.js';
 import { collapseDone, groupDoneSection } from './archive.js';
@@ -45,7 +45,9 @@ export function setStateMark(text, id, state) {
   const cur = lines[idx];
   if (stateOfTaskLine(cur) === state) return { text, changed: [] };
   const raw = stripStateMark(cur);          // 先剥旧标记，再补新的
-  lines[idx] = raw.replace(/^(- \[[ x]\] )/, `$1[${state}] `);
+  // 前缀两种形态都要能接回（`- [ ]` 与断点任务 `↳ [ ]`），并保留原缩进 ——
+  // 原正则写死 `^(- \[[ x]\] )`，断点任务上补不回标记（2026-10-16 实测：state 报成功但盘上没变）。
+  lines[idx] = raw.replace(/^(\s*(?:-\s*\[[ x]\]|↳\s*\[[ x]\])\s*)/, `$1[${state}] `);
   return { text: lines.join('\n'), changed: [`${id} 状态 → ${state}`] };
 }
 
@@ -67,9 +69,13 @@ function insertTask(orig, section, text) {
   if (idx === -1) {
     lines.push('', header, `- [ ] ${text}`);
   } else {
-    // 在该分区标题后、下一个分区标题前插入
+    // 在该分区标题后、下一个分区标题前插入。
+    // ★ 插入点要**跳过尾部空行**：分区末尾本来就有个排版空行（`## Done` 前的那个），
+    //   若插到它后面，新任务与前面的内容之间就隔了个空行 —— 每建一条多一个空行，
+    //   而闸门明写「条目之间不允许空行」（实测：建 4 条就有 3 个空行）。
     let insertAt = idx + 1;
     while (insertAt < lines.length && !lines[insertAt].startsWith('## ')) insertAt++;
+    while (insertAt > idx + 1 && !lines[insertAt - 1].trim()) insertAt--;
     lines.splice(insertAt, 0, `- [ ] ${text}`);
   }
   return lines.join('\n');
@@ -115,17 +121,19 @@ export async function upsertTask(brainRoot, { section, text, session = '' }) {
     : { file: p, text, updated: false };
 }
 
-/** 从任务文本提取幂等键（行首 id，如 TASK-1 / T-2 / fix-hook）。 */
+/** 从任务文本提取幂等键（行首 id，如 TASK-1 / T-2 / fix-hook）。
+ *  两种前缀都认：`- [ ] `（普通任务）与 `↳ [ ] `（断点任务）。缩进不影响取 id。 */
 
 export function idOfTaskLine(line) {
-  if (!line || !line.startsWith('- [ ]')) return null;
+  if (!line) return null;
   // 两区制下行首可带状态标记（`- [ ] [进行中] <id> …`）—— 必须先剥掉再取 id，
   // 否则 id 会被读成 "[进行中]"，findTaskLine 全等比对永远落空（2026-09-13 实测）。
-  const m = line.match(/^- \[ \] (?:\[[^\]]+\] )?(\S+)/);
+  // 前缀允许缩进（`  - [ ]` / `  ↳ [ ]`）—— 断点任务天然带缩进。
+  const m = line.match(/^\s*(?:-\s*\[ \]|↳\s*\[ \])\s*(?:\[[^\]]+\]\s*)?(\S+)/);
   return m ? m[1].replace(/\u200b/g, '') : null;
 }
 
-/** 定位 id 对应的未完成任务行下标；附属断点行（↳ 开头）不算任务行。
+/** 定位 id 对应的未完成任务行下标；真正的附属断点行（`↳ 断点:`）不算任务行。
  *  全等比对，不用 includes（否则 T1 会误命中 T11）。 */
 
 export function findTaskLine(lines, id) {
@@ -134,25 +142,73 @@ export function findTaskLine(lines, id) {
   return lines.findIndex((l) => idOfTaskLine(l) === want);
 }
 
-/** 实时断点: 在 id 任务行下原位补/换 `↳ 断点:` 附属行（不挪任务位置）。 */
+/** 子项行解析：从 `idx+1` 起扫连续的缩进行（子项），返回它们的下标。
+ * 遇到非子项（下一个顶层任务 / 空行 / 分区标题）就停。 */
+function childRange(lines, idx) {
+  const out = [];
+  for (let i = idx + 1; i < lines.length; i++) {
+    const line = lines[i];
+    if (!line.trim()) break;              // 空行 = 子项块结束
+    const child = parseChild(line);
+    if (child && child.indent > 0) { out.push(i); continue; }
+    break;                                 // 另一个顶层任务行 / 标题
+  }
+  return out;
+}
 
+/** 追加/更新一条子项（标准 md：缩进 2 空格 + `- [ ]`）。
+ *
+ * 语义（2026-10-16 用户定）：子项就是 todo 的嵌套子任务 —— 可多条、可各自勾选。
+ * `abs todo note <id> "…"` **追加**一条（不再覆盖）—— 用户原话「不限，写多少算多少」。
+ * 仍保留幂等：与最后一条完全同文就不重复追加（防手滑重复调）。
+ * 旧的 `↳ 断点:` 存量行不动（parseChild 认得，继续显示）；新写一律用标准 md。 */
 export async function setBreakpoint(brainRoot, { id, text }) {
   const p = await ensureTodo(brainRoot);
-  const bp = `  ↳ 断点: ${text}`;
+  let added = false;
   const res = await editFile(p, (orig) => {
     const lines = orig.split('\n');
     const idx = findTaskLine(lines, id);
     if (idx === -1) return SKIP;
-    if (lines[idx + 1] && lines[idx + 1].trimStart().startsWith('↳ 断点:')) {
-      lines[idx + 1] = bp; // 幂等: 更新原附属行
-    } else {
-      lines.splice(idx + 1, 0, bp);
-    }
+    const kids = childRange(lines, idx);
+    const last = kids.length ? parseChild(lines[kids[kids.length - 1]]) : null;
+    if (last && last.text === String(text).trim()) return SKIP; // 幂等：同文不重复追加
+    lines.splice(idx + 1 + kids.length, 0, renderChild(text));
+    added = true;
+    return { text: lines.join('\n'), ok: true };
+  });
+  if (res === SKIP) {
+    return added
+      ? { ok: true, msg: `✓ 子项已追加 → ${id}` }
+      : { ok: false, msg: `[NO_MATCH] 未找到含 "${id}" 的未完成任务行（或子项已存在）` };
+  }
+  return { ok: true, msg: `✓ 子项已追加 → ${id}\n  ${renderChild(text)}` };
+}
+
+/** 勾/取消勾子项：`- [ ] …` ↔ `- [x] …`。
+ *
+ * 定位：子项没有自己的 id（身份 = 「某任务的第 N 条子项」），故按 n 定位（1-based）。
+ * n 缺省 = 勾最后一条（最常用的「刚写的这条做完了」）。
+ * 旧格式 `↳ 断点:` 也能勾 —— 勾一下就地升级成标准 md 形态。 */
+export async function setBreakpointDone(brainRoot, { id, n, done = true }) {
+  const p = await ensureTodo(brainRoot);
+  let picked = null;
+  const res = await editFile(p, (orig) => {
+    const lines = orig.split('\n');
+    const idx = findTaskLine(lines, id);
+    if (idx === -1) return SKIP;
+    const kids = childRange(lines, idx);
+    if (!kids.length) return SKIP;
+    const target = n ? kids[n - 1] : kids[kids.length - 1];
+    if (target === undefined) return SKIP;
+    const child = parseChild(lines[target]);
+    picked = child;
+    lines[target] = renderChild(child.text, { done });
     return { text: lines.join('\n'), ok: true };
   });
-  return res === SKIP
-    ? { ok: false, msg: `[NO_MATCH] 未找到含 "${id}" 的未完成任务行` }
-    : { ok: true, msg: `✓ 断点已落 → ${id}\n  ${bp.trim()}` };
+  if (res === SKIP || !picked) {
+    return { ok: false, msg: `[NO_MATCH] "${id}" 下没有第 ${n || '(最后)'} 条子项（或任务不存在）` };
+  }
+  return { ok: true, msg: `✓ 子项 ${done ? '已勾' : '已取消勾'} → ${id}\n  ${renderChild(picked.text, { done })}` };
 }
 
 // ---------- 任务随手记（memo）----------

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, isAllowedTodoLine, todoSectionOf } from './common.js';
+import { sigOfLine, REPORT_MARKERS, sentenceCount, isTaskLine, isAllowedTodoLine, todoSectionOf, parseChild } from './common.js';
 
 export function checkFileShape(file, text, { lintMode = false } = {}) {
   const issues = [];
@@ -162,6 +162,29 @@ export function assertTodoContent(text, prevSig = null) {
     const l = lines[i];
     const lineNo = i + 1;
     if (l.startsWith('## ')) continue;
+    // 子项行要比任务行先判：标准 md 下子项（缩进的 `- [ ]`）**也是任务行**，
+    // 若让任务行分支先 continue，子项就只受 TASK_LINE_MAX(400) 管，
+    // BREAKPOINT_MAX(200) 的闸门永远走不到（实测：300 字子项静默写入）。
+    const kidEarly = parseChild(l);
+    if (kidEarly && kidEarly.indent > 0) {
+      if (isLegacy(l)) continue; // 存量：不阻写入（lint 报）
+      const kbody = kidEarly.text;
+      if (kbody.length > BREAKPOINT_MAX) {
+        throw new Error(
+          `✗ 子项太长（第 ${lineNo} 行 ${kbody.length} 字 > ${BREAKPOINT_MAX}）—— 子项只写「改到哪个文件哪一步」。\n` +
+          `  写不下的内容请分流：实施报告/验证数据 → abs log；经验与坑 → abs note；长设计 → .brain/sources/ 页。\n` +
+          `  原文开头: ${kbody.slice(0, 60)}...`,
+        );
+      }
+      if (REPORT_MARKERS.some((re) => re.test(kbody)) || sentenceCount(kbody) > 2) {
+        throw new Error(
+          `✗ 子项里像是塞了报告/清单（第 ${lineNo} 行）—— 子项是一句话（最多两句），不是文档。\n` +
+          `  todo 只能加 todo：要做的拆成任务，做完的写 abs log，经验写 abs note。\n` +
+          `  原文开头: ${kbody.slice(0, 60)}...`,
+        );
+      }
+      continue;
+    }
     // 任务行
     if (isTaskLine(l)) {
       if (l.length > TASK_LINE_MAX && !isLegacy(l)) {
@@ -173,10 +196,11 @@ export function assertTodoContent(text, prevSig = null) {
       }
       continue;
     }
-    // 断点附属行
-    if (l.trimStart().startsWith('↳ 断点:')) {
+    // 断点附属行（新旧格式用同一个解析器 —— 格式知识只有 common.js 一个真源）
+    const bp = parseChild(l);
+    if (bp) {
       if (isLegacy(l)) continue; // 存量超长断点：不阻写入（lint 报）
-      const body = l.trimStart().slice('↳ 断点:'.length).trim();
+      const body = bp.text;
       if (body.length > BREAKPOINT_MAX) {
         throw new Error(
           `✗ 断点太长（第 ${lineNo} 行 ${body.length} 字 > ${BREAKPOINT_MAX}）—— 断点只写「改到哪个文件哪一步」。\n` +

package/src/todo.js

@@ -2,9 +2,9 @@
 // 保留这一层是为了对外接口稳定：store.js / lint.js / note.js / wrapup.js / 测试的
 // import 路径与名字都不用改。
 
-export { TODO_MAX_LINES, LOG_MAX_LINES, INDEX_MAX_LINES, today, localStamp, SEC, extractId, extractNote, extractAuthor, isLegacyAuthorTag, claimOf, sessionOf } from './todo/common.js';
+export { TODO_MAX_LINES, LOG_MAX_LINES, INDEX_MAX_LINES, today, localStamp, SEC, extractId, extractNote, extractAuthor, isLegacyAuthorTag, claimOf, sessionOf, parseChild, renderChild } from './todo/common.js';
 export { LEGACY_SECTION_RENAMES, TODO_SECTIONS, TODO_SUBSECTIONS, isAllowedTodoSub, INDEX_SECTIONS, INDEX_LINK_SECTIONS, LOG_KINDS, H1_TO_FILE, ENTRY_SHAPES, TASK_STATES, RETIRED_SECTIONS, BREAKPOINT_MAX, TASK_LINE_MAX, DONE_KINDS, ARCHIVE_SECTION } from './todo/spec.js';
-export { todoTemplate, rebuildStructure, dropRetiredSections, enforceBrainFormat, normalizeTodo, ensureStateMark, stateOfTaskLine, stripStateMark } from './todo/structure.js';
+export { todoTemplate, rebuildStructure, dropRetiredSections, enforceBrainFormat, normalizeTodo, ensureStateMark, stateOfTaskLine, stripStateMark, checkTaskBox } 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, setMemo, readMemo, boardText } from './todo/tasks.js';
+export { readTodo, ensureTodo, setStateMark, addTask, upsertTask, idOfTaskLine, findTaskLine, setBreakpoint, setBreakpointDone, setMemo, readMemo, boardText } from './todo/tasks.js';

package/src/wrapup.js

@@ -8,7 +8,7 @@
 import { promises as fs } from 'node:fs';
 import { join } from 'node:path';
 import { absLogDir } from './index.js';
-import { readTodo, localStamp } from './todo.js';
+import { readTodo, localStamp, parseChild } from './todo.js';
 
 export function wrapupLogPath() {
   return join(absLogDir(), 'wrapup.log');
@@ -62,7 +62,15 @@ export function extractOpenTasks(todoText) {
         const bp = [];
         while (i + 1 < lines.length && /^\s*↳/.test(lines[i + 1])) {
           i++;
-          bp.push(lines[i].trim().replace(/^↳\s*(断点|卡点)?[:：]?\s*/, ''));
+          // 断点快照带上勾选标记（`[ ] 内容` / `[x] 内容`）—— 快照是给人看的，
+          // 不保留勾选就分不清「当时已完成」与「还没做」（2026-10-16 断点可勾后必需）。
+          const parsed = parseChild(lines[i]);
+          if (parsed) {
+            bp.push(`${parsed.done ? '[x]' : '[ ]'} ${parsed.text}`);
+          } else {
+            // 非断点的 ↳ 行（如 `↳ [ ] 子任务`）仍照旧剥前缀
+            bp.push(lines[i].trim().replace(/^↳\s*(断点|卡点)?[:：]?\s*/, ''));
+          }
         }
         out.push({ body: taskBody, bp });
       }
@@ -77,12 +85,13 @@ function isPlaceholderBody(body) {
   return /^(待办任务|无|（无）|None|null)$/.test(body) || /^待办任务/.test(body);
 }
 
-/** 序列化一个快照块：首行时间戳+归属，后随未完成任务（主体+断点）。 */
+/** 序列化一个快照块：首行时间戳+归属，后随未完成任务（主体+断点）。
+ * 断点 bp 元素已自带勾选前缀（`[ ] 内容` / `[x] 内容`，见 extractOpenTasks）。 */
 function blockText(root, tasks) {
   const head = `[${localStamp()}] wrapup proj=${root}`;
   if (!tasks.length) return head; // 无滞留，仍记一行「干净结束」
   const rows = tasks.map((t) => {
-    const bps = t.bp.map((b) => `      ↳ 断点: ${b}`);
+    const bps = t.bp.map((b) => (b.startsWith('[') ? `      ↳ ${b}` : `      ↳ 断点: ${b}`));
     return `  - [ ] ${t.body}${bps.length ? '\n' + bps.join('\n') : ''}`;
   });
   return [head, ...rows].join('\n');
@@ -112,7 +121,11 @@ export function parseWrapup(text) {
     }
     const bm = line.match(/^\s*↳/);
     if (bm && cur.tasks.length) {
-      cur.tasks[cur.tasks.length - 1].bp.push(line.trim().replace(/^↳\s*(断点|卡点)?[:：]?\s*/, ''));
+      // 回读时统一成 `[ ] 内容` / `[x] 内容` 形态（新写的就是这个；旧快照无勾 → 当未勾）
+      const parsed = parseChild(line);
+      cur.tasks[cur.tasks.length - 1].bp.push(parsed
+        ? `${parsed.done ? '[x]' : '[ ]'} ${parsed.text}`
+        : line.trim().replace(/^↳\s*(断点|卡点)?[:：]?\s*/, ''));
     }
   }
   return byProj;