@fanchao8609/agent_brain_sync 1.13.0 → 1.13.2

package/bin/abs.js

@@ -521,7 +521,7 @@ async function main() {
       }
       case 'lint': {
         rejectExtra(opts._, 'abs lint');
-        console.log(await cmdLint({ dir: opts.dir }));
+        console.log(await cmdLint({ dir: opts.dir, all: opts.all }));
         break;
       }
       // 内部命令（hook 专用，不出现在 help）：Stop 时机械快照未完成任务

package/package.json

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

package/src/lint.js

@@ -145,7 +145,7 @@ async function checkRootFiles(vault) {
           `TODO-BREAKPOINT-BLOAT: ${BRAIN_DIR}/${file}:${i + 1} (断点 ${bp.length} 字 > ${LINT_BREAKPOINT_MAX}；` +
           `断点只写「改到哪个文件哪一步」，报告迁 sessions/ 或 sources/)`,
         );
-      } else if (bp.split(/[。！？；!?;]+|\s*[\u2460-\u2473]\s*/).map((x) => x.trim()).filter(Boolean).length > 2) {
+      } else if (bp.split(/[。！？!?]+|\s*[\u2460-\u2473]\s*/).map((x) => x.trim()).filter(Boolean).length > 2) {
         issues.push(
           `TODO-BREAKPOINT-PROSE: ${BRAIN_DIR}/${file}:${i + 1} (断点写了多句 = 报告体；` +
           `todo 只放待办，长文迁 sessions/ 或 sources/)`,
@@ -170,11 +170,20 @@ function checkPage(pg, names, linkedNames, inbound) {
         `引用请用 [[${id}]] 或改回文件名)`);
     }
   }
-  for (const ln of pg.links) {
-    if (/^<.+>$/.test(ln) || /slug|Name|name|Date|页面名$/.test(ln)) {
-      issues.push(`TEMPLATE-LINK: ${pg.rel} -> [[${ln}]]`);
-    } else if (!names.has(ln)) {
-      issues.push(`DEAD-LINK: ${pg.rel} -> [[${ln}]]`);
+  // 链接检查
+  // ★ sessions/ 豁免 DEAD-LINK（2026-10-05 实测）：会话快照正文是「当时的笔记」，
+  //   里面的 `[[x]]` 常是在**谈这个记号本身**（如「缺 [[作者]] 这个标记」、
+  //   「剥掉 <id>/[[作者]] 记号」），不承担图谱链接职责；而 sessions 是不可改的历史，
+  //   改它就是改历史。→ 对快照报断链是规则错，不是数据脏。
+  //   注：sessions 的链接职责只体现在 `## 关联连接` 段，那段的断链仍值得管，
+  //   但对历史快照而言也已无法修正，故一并豁免。
+  if (pg.dir !== 'sessions') {
+    for (const ln of pg.links) {
+      if (/^<.+>$/.test(ln) || /slug|Name|name|Date|页面名$/.test(ln)) {
+        issues.push(`TEMPLATE-LINK: ${pg.rel} -> [[${ln}]]`);
+      } else if (!names.has(ln)) {
+        issues.push(`DEAD-LINK: ${pg.rel} -> [[${ln}]]`);
+      }
     }
   }
   const isTerminal = pg.dir === 'sources'
@@ -270,6 +279,11 @@ async function checkGraph(root, pages) {
   for (const pg of pages) {
     if (pg.status !== 'draft') continue;
     if (pg.dir === 'sources') continue;
+    // ★ sessions/ 也不参与（2026-10-05 实测误报）：会话快照是**历史事实记录**
+    //   （「那天发生什么」），不存在「是否仍然有效」—— 它永远不该被标 active，
+    //   标了反而是撒谎。对快照报「已 N 天停在 draft」是规则错，不是数据脏。
+    //   同理若未来加别的「存档型」目录（归档页等），也该在此豁免。
+    if (pg.dir === 'sessions') continue;
     let ageMs = 0;
     try { ageMs = Date.now() - (await fs.stat(join(root, pg.rel))).mtimeMs; } catch { continue; }
     if (ageMs > DRAFT_STALE_DAYS * 86400 * 1000) {
@@ -345,7 +359,7 @@ async function readFileOrNull(p) {
 
 // ---------- 入口 ----------
 
-export async function cmdLint({ dir }) {
+export async function cmdLint({ dir, all = false }) {
   let root;
   try {
     root = await requireBrain(dir || process.cwd());
@@ -374,10 +388,44 @@ export async function cmdLint({ dir }) {
   issues.push(...await checkRootFiles(vault));
 
   const n = issues.length;
+  // ★ 同类折叠（2026-10-05）：体检输出必须按问题**类型**折叠计数。
+  //   为什么：给根文件加形状校验后，abs 自带的 log.md 有 102 条历史行缺 `[[作者]]`，
+  //   102 条 LOG-ENTRY 淹没了其它 12 条真问题（DRAFT-STALE/DEAD-LINK/NO-INBOUND）——
+  //   lint 的价值是「让人看见该修的」，被噪声淹没就退化成不可读。
+  //   同族约束：既有 Rule `读取侧输出不得随规模增长`、Done 区已按日期折叠计数。
+  //   形态：同类 > THRESHOLD 时只报「N 条同类 + 前 SAMPLE 条样例」。
+  //   注：全量明细仍可用 `abs lint --all` 拿到（不静默丢信息）。
+  const folded = all ? issues : foldSameKind(issues);
+  const n2 = folded.length;
   return [
-    ...(issues.length ? issues : []),
+    ...folded,
     '',
-    `lint: ${n} problem(s).`,
+    `lint: ${n2} problem(s).${n2 !== n ? ` (共 ${n} 条，同类已折叠；全量: abs lint --all)` : ''}`,
     n === 0 ? '✓ 图谱健康' : '',
   ].filter(Boolean).join('\n');
+}
+
+/** 同类问题折叠：按错误码分组，超过阈值只报计数 + 前几条样例。
+ *  错误码 = 首行的 `CODE:` 前缀（checkPage/checkGraph/checkRootFiles 都是这个形态）。
+ *  保序：按「首次出现顺序」输出，不因折叠打乱阅读节奏。 */
+const FOLD_THRESHOLD = 10;
+const FOLD_SAMPLE = 3;
+export function foldSameKind(issues) {
+  const groups = new Map(); // code -> { items, order }
+  for (const it of issues) {
+    const m = String(it).match(/^([A-Z][A-Z0-9-]+):/);
+    const code = m ? m[1] : '(其它)';
+    if (!groups.has(code)) groups.set(code, { items: [] });
+    groups.get(code).items.push(it);
+  }
+  const out = [];
+  for (const [code, g] of groups) {
+    if (g.items.length <= FOLD_THRESHOLD) {
+      out.push(...g.items);
+    } else {
+      out.push(...g.items.slice(0, FOLD_SAMPLE));
+      out.push(`  … 还有 ${g.items.length - FOLD_SAMPLE} 条同类的 ${code}（共 ${g.items.length} 条）`);
+    }
+  }
+  return out;
 }

package/src/store.js

@@ -11,7 +11,7 @@ import { keywords, pickRelevant, renderRelevant, recentFiles, rankPage, topicStr
 import { impactOf } from './codegraph.js';
 
 // Re-export lint.js symbols so external importers (e.g. bin/mcp.js, bin/abs.js) still work.
-export { cmdLint, listPages, hasTail, PAGE_DIRS } from './lint.js';
+export { cmdLint, listPages, hasTail, PAGE_DIRS, foldSameKind } from './lint.js';
 import { SOURCES_MAX, PAGE_DIRS, listPages } from './lint.js';
 
 // ---------- init: 建 .brain/ 骨架 ----------

package/src/todo.js

@@ -206,7 +206,11 @@ export const ENTRY_SHAPES = {
       test: (l) => {
         if (/^#{1,3}\s/.test(l)) return null; // 标题行（## Done / ### 日期）不是条目
         if (!/^-\s/.test(l)) return null; // 非条目行（如缩进的 ↳ 断点）由下面单独判
-        // Done 区的归档行是 `- [[log-日期]] 完成任务 N 条`，不是任务行
+        // Done 区的归档行：`- [[log-日期]] 完成任务 N 条`。
+        // ★ 历史命名不统一：还有 `[[2026-09-12-todo归档]]` 这种旧写法（实测），
+        //   只认 `log-` 前缀会把它误报为「缺状态标记」。状归档行与任务行的
+        //   区别不是命名而是**形态**：没有 `[ ]`/`[x]` 复选框的 [[链接]] 行。
+        if (/^-\s*\[\[[^\]]+\]\]\s+完成任务/.test(l)) return null;
         if (/^-\s*\[\[log-\d{4}-\d{2}-\d{2}\]\]/.test(l)) return null;
         const m = l.match(/^-\s*\[([ x])\]\s*(.*)$/);
         if (!m) return '应以 `- [ ] ` 或 `- [x] ` 开头';
@@ -504,12 +508,15 @@ const REPORT_MARKERS = [
 ];
 
 /** 数一个断点里有几个「句子」—— 断点是一件事，多句 = 在塞报告。
- *  中文按 。！？；/ 英文按 .!?; 切；带圈编号 ①②③ 也算分隔符。
+ *  分隔符只用**句末标点**（。！？!?）与带圈编号 ①②③。
+ *  ★ 分号（；/;）**不算**分隔符：中文技术写作里它常用来连接同一个意思的两部分
+ *  （「改到哪个文件；同类约束见 xx」），算成两句会误伤正常断点（实测：
+ *  一条正常的「改到哪 + 同类约束 + 待确认」被判 3 句而拒绝写入）。
  *  为什么不用关键词表：关键词命中不稳（「功能/方案」正常描述也会出现），
  *  而「一句还是一段」是结构判据 —— 结构判据才可靠。 */
 function sentenceCount(s) {
   return String(s)
-    .split(/[。！？；!?;]+|\s*[\u2460-\u2473]\s*/)
+    .split(/[。！？!?]+|\s*[\u2460-\u2473]\s*/)
     .map((x) => x.trim())
     .filter(Boolean).length;
 }