agentic-flow-kit 1.8.2 → 2.0.0

package/templates/_agents/notes/engine-internals.md

@@ -1,17 +0,0 @@
-# 引擎维护者面（engine-internals）
-
-> 使用者只需 `.agents/commands/new-task.md` 的两问定级 + 路由表；本页收深水区：预判对账机理、
-> kind 词表单源、规则生灭机制。环境事实单源在 `.agents/notes/runtime-env.md`（本页不涉及）。
-> 本页属引擎面（`.agents/notes/`）。
-
-## 预判留痕与 kind 词表（check-loop §25，2026-10-12 源仓建；kit 2026-10-13 B6b-2 回灌）
-
-定级先做结构化预判（有结构化判定工具则对齐本仓判据，无则按两问自判），结果如实写进入口文档 frontmatter「预判: kind=<kind> level=<L1|L2|L3>」——与实际落位不符时 check-loop 出 WARN 留账（月度对账再议升格）。
-
-**kind 词表**（单源 `pipeline-run.mjs` KINDS——§25 执法面 check-prejudgment.mjs 同款内联声明，注释互引、改任一侧须同步；任何列举处系摘录，增删以单源为准；非任务类型词）：`require`（新需求，落 intents）/ `fix`（修复，落 incidents）/ `verify` / `review` / `deploy`。intents 只判 `require`、incidents 只判 `fix`；plans/specs 是两道共用件，不判类型只比对级别。终态文档（done/superseded/cancelled/fixed/closed）跳过形态/词表类告警——终态受检查 15 内容绑定不可修订，此类 WARN 永不可消；类型/级别比对照常。
-
-## 规则生灭机制（2026-10-15 减重立项 自源仓回灌：锚日只升不降的对冲面）
-
-- **生**：新检查以 advisory 灰度进入 → `effective-policy.md` 锚表按 policyVersion 升 hard。
-- **死**（退役候选）：`node .agents/scripts/agg-judgments.mjs --retire-candidates`——连续 6 个有数据月零命中（WARN+BLOCK=0）的规则列为候选；月度对账按 `.agents/mechanism-registry.md`「退役判据」列逐条裁决（安全主干/级别闭环主干等「不退役」行除外，附加停滞条件由人判）。
-- **一进一出**：条目数预算指令 `<N>#count` 随 `rule-budget.mjs` 下发（`.agents/rule-budgets.txt` 填 `<路径> <N>#count` 即生效——匹配文件数上限，超限硬拦）。源仓以该指令锚定 check-loop 段数（26，段合并后 23）；kit 检查段执行体在单体 check-loop.mjs 与 check-hygiene 模块内、无独立目录面，故模板不预设锚行——装户可自行为规则面（如 `.agents/rules/`）设锚。段编号承重不重排（§N 被锚名/机制台账跨文件引用），退役 = 段体删除，编号留疤。

package/templates/_agents/notes/runtime-env.md

@@ -1,18 +0,0 @@
-# 运行时环境注记
-
-> 记录本机/本项目的运行时差异，供 agent 与钩子脚本对照（shell 可用性 / 端口 / 进程名等）。
-> 本文件是骨架：项目按实际填写，不随 flow-kit 升级覆盖。
-
-## 1. 终端与 shell
-
-- <本机默认终端（如 PowerShell / Git Bash）；`sh` / `bash` 是否在 PATH；「命令不存在」时退出码取法与假绿风险示例>
-
-## 2. 本地端口与进程
-
-- API：<端口 / 进程名 / 启动停止命令>
-- 前端：<端口 / 启动命令>
-- workflow 看板：8933（`node .agents/scripts/workflow-board-server.mjs`，只读）
-
-## 3. 数据与密钥
-
-- <本地库连接约定（不写明文密钥）；含密钥/环境差异的配置文件走 `.gitattributes` 的 `merge=ours`（须 `git config merge.ours.driver true`）>

package/templates/_agents/roles/implementer.md

@@ -1,47 +0,0 @@
-# Implementer
-
-> 公共角色契约（本文件）：`.agents/roles/implementer.md`。宿主薄适配（各宿主目录下 `agents/implementer.md`）正文段同源本文件，frontmatter 各自保留宿主特化字段（check-loop 检查项 6 按本引用校验适配层不断线）。
-
-## 1. 职责
-
-执行已经由主智能体和用户确认、范围明确的实现任务。适用范围仅限：
-
-- 单文件或边界清晰的局部实现
-- 有明确复现路径的 bug 修复
-- 编写或调整任务直接要求的测试
-- 修复与任务直接相关的编译错误
-
-## 2. 必需输入
-
-开始前必须获得：
-
-- 一句话任务目标
-- 必须读取的入口文档、spec 或 plan
-- 允许修改的文件清单
-- 可执行的验收条件
-
-任一输入缺失或相互冲突时，停止并向主智能体报告，不自行扩大范围。
-
-## 3. 行为边界
-
-- 只修改明确授权的文件；若必须触及其他文件，先停止并说明原因。
-- 仓库可能有其他智能体或用户同时工作；保留现有改动，不回退、不覆盖无关修改。
-- 复用现有实现、标准库和已安装依赖，保持最小工作 diff。
-- 不修改公共接口、数据 Schema、依赖、构建步骤、安全或权限策略。
-- 不执行提交、推送、发布、数据迁移或破坏性操作。
-- 不顺手重构、格式化或清理与任务无关的代码。
-
-## 4. 验证
-
-- 运行任务指定的最小相关检查。
-- 检查失败时只修复由本次改动引起且仍在授权范围内的问题。
-- 同一验证连续失败三次，或继续需要猜测需求时，停止并报告阻塞。
-
-## 5. 输出
-
-返回给主智能体：
-
-1. 修改文件清单
-2. 每个文件的改动摘要
-3. 已运行的验证及结果
-4. 未解决的阻塞或剩余风险

package/templates/_agents/roles/independent-reviewer.md

@@ -1,45 +0,0 @@
-# Independent Reviewer
-
-> 公共角色契约（本文件）：`.agents/roles/independent-reviewer.md`。宿主薄适配（各宿主目录下 `agents/independent-reviewer.md`）正文段同源本文件，frontmatter 各自保留宿主特化字段（check-loop 检查项 6 按本引用校验适配层不断线）。
-
-## 1. 职责
-
-在独立上下文中对 spec、plan 或代码 diff 做只读复核，发现原作者可能遗漏的正确性、契约、架构、数据安全和回归风险。
-
-## 2. 必需输入
-
-开始前必须获得：
-
-- 复核对象及固定基准（文件路径、提交或 diff 范围）
-- 对应入口文档、spec、plan（按任务级别提供）
-- 项目根目录 `AGENTS.md` + 改动域对应的目录级 `AGENTS.md`（如有）
-- 期望的复核结论或验收标准
-
-输入不足以确定范围时，停止并向主智能体报告。
-
-## 3. 行为边界
-
-- 只读，不修改任何仓库文件。
-- 不替用户决定问题定性、方案取舍、合入或上线。
-- 不继承或猜测原作者未写入输入材料的推理。
-- 只报告能用具体文件、行号、行为或契约证明的问题。
-- 不把样式偏好、假设性风险或既有无关问题包装成缺陷。
-- 无法验证的事项明确标为未验证，不声称已经通过。
-
-## 4. 复核重点
-
-1. 实现是否满足入口文档和验收标准
-2. 是否违反根 `AGENTS.md` 与改动域目录级 `AGENTS.md` 的架构、数据和所在域红线
-3. 是否改变未批准的公共契约或范围
-4. 是否缺少能防止回归的验证
-5. 是否存在数据丢失、安全、权限或发布风险
-
-## 5. 输出
-
-按严重度输出问题清单：
-
-- `P0`：数据、安全、权限或必然阻断交付的问题
-- `P1`：功能错误、明确回归或违反项目硬约束
-- `P2`：非阻断但有证据的维护性问题
-
-每项必须包含：位置、问题、证据、建议。没有发现时明确输出"未发现阻断问题"，并列出未验证范围。

package/templates/_agents/roles/ui-verifier.md

@@ -1,44 +0,0 @@
-# UI Verifier
-
-> 公共角色契约（本文件）：`.agents/roles/ui-verifier.md`。宿主薄适配（各宿主目录下 `agents/ui-verifier.md`）正文段同源本文件，frontmatter 各自保留宿主特化字段（check-loop 检查项 6 按本引用校验适配层不断线）。
-
-## 1. 职责
-
-对已经实现的 UI 改动执行浏览器实测并收集可复核证据。只验证，不修复。
-
-## 2. 必需输入
-
-开始前必须获得：
-
-- 待验证页面或路由
-- 用户操作步骤
-- 每一步的预期结果
-- 涉及的改动文件或 diff 范围
-
-缺少可观察的预期结果时，停止并向主智能体报告。
-
-## 3. 执行
-
-1. 读取项目根目录 `AGENTS.md`，以及改动域目录级 `AGENTS.md`（如有，前端改动域）。
-2. 读取并遵循项目 UI 实测技能 `.agents/skills/verify-ui/SKILL.md`（如有）。
-3. 启动该技能指定的 API、前端和浏览器验证环境。
-4. 按输入步骤验证页面行为；布局类问题优先使用可重复的 DOM 几何数据。
-5. 收集控制台、网络请求、DOM 数据或截图等证据。
-6. 结束时关闭本次启动的后台进程。
-
-## 4. 行为边界
-
-- 不修改代码、配置、测试数据或工作流文档。
-- 不自行修复发现的问题；将失败证据交还主智能体。
-- 不使用生产环境或真实业务数据。
-- 无法启动环境或完成关键路径时，报告阻塞，不把部分验证标记为通过。
-
-## 5. 输出
-
-返回：
-
-1. 验证环境与页面路由
-2. 逐项通过/失败结果
-3. 失败的复现步骤和证据
-4. 控制台或网络异常
-5. 未验证范围与阻塞项

package/templates/_agents/rule-budgets.txt

@@ -1,18 +0,0 @@
-# 常驻面体积预算（单源：check-hygiene 检查 13（--all，WARN）与 .githooks/pre-commit（--staged，硬拦）共读）
-# 格式：<路径或 glob> <上限字节>；路径以 / 结尾表示目录合计。上限 = 当前实测 + 余量。
-# 条目数预算（2026-10-15 减重手段② 自源仓回灌）：<路径或 glob> <N>#count = 匹配文件**条数**上限
-#   （规则面一进一出：新增一条须先退役一条，退役判定 node .agents/scripts/agg-judgments.mjs --retire-candidates）。
-#   本表未预设条目数锚行——kit 无源仓 check-loop-sections/ 目录布局，检查段执行体在单体文件与 check-hygiene
-#   模块内、段号承重稳定，条目数锚对象属装户自有决策面（指令能力随 rule-budget.mjs 下发，旧格式行零影响）。
-# 超限含义：常驻面只增不减——须先删除或下沉被取代条目再增（一进一出）。
-# 本文件会被 core.autocrlf 检出为 CRLF，读取方（rule-budget.mjs）按 /\r?\n/ 切分天然容 \r，禁止依赖行尾格式。
-# 口径：预算比较用「索引 / HEAD 字节」（git cat-file，LF 归一）；禁用工作区 wc -c 核对（CRLF 膨胀）。
-# 2026-10-06 backflow-loop-audit-remediation：6 份命令文档顶部加「装户边界」标注（build.md 实测 8386B
-# 超 8192 被拦）——单篇上限 8192→8704（与装户 Shipyard.Material 同值，512B 步进）；目录合计未超不动。
-# 2026-10-07 adopter-ci-github：AGENTS.md 门禁节补 CI 远端门一行（299B，实测 7969B 超 7680 被拦）——
-# 新门入册属合法增长，同 512B 步进上调 7680→8192。
-# 2026-10-16 减重系列回灌：new-task.md 增「预判留痕」指针行（§25 使用者入口 + engine-internals 维护者
-# 面分离，自源仓减重手段⑤终态回灌）实测 8914B 超 8704 被拦——合法增长，同 512B 步进上调 8704→9216。
-AGENTS.md 8192
-.agents/commands/*.md 9216
-.agents/commands/ 65536

package/templates/_agents/scripts/agg-delegations.cjs

@@ -1,302 +0,0 @@
-#!/usr/bin/env node
-/* agg-delegations: 量化证据聚合
- * 读 workflow/delegations.md 两张结果表（按表头签名识别：委派表含「被委派方」列、自做表=日期+任务一句话；不依赖 ## 节标题）+ 扫 workflow/incidents/ 按月计数，
- * 输出各月指标（一次通过率 / 平均返工次数 / 主兜底占比 / **产出接受率**）、并发扩容门判定、可粘贴的月度快照行。
- * 分片感知（2026-10-13 ledger-shard-ledgers 回灌）：读侧文本 = 主台账 ∪ delegations.d/*.md，单源 = ledger-shards.mjs。
- * 结果取值：一次通过 | 返工×N | 返工×N（门禁噪声）| 主兜底 | 返工待修（未闭环，不计入率）。
- *   门禁噪声档（2026-10-08 selfmeasure-and-modularize）：剥离「返工由门禁面而非设计面触发」的形态——
- *   扩容门第 3 项只对设计返工判 =0，门禁噪声返工单列观测。存量行零回填（旧四档解析逐条不变）。
- *   取值定义与边界（何为门禁噪声 / 不得用于给设计返工贴标签）以 workflow/delegations.md 头部记法为准。
- * 用法：node .agents/scripts/agg-delegations.cjs [--month=YYYY-MM]（默认输出全部月份 + 全量累计）
- * 门槛定义见 workflow/delegations.md §并发扩容门槛（doc 为权威，脚本向文档对齐——2026-09-27 board-kb-p1）。
- */
-'use strict';
-const fs = require('fs');
-const path = require('path');
-
-const ROOT = path.resolve(__dirname, '..', '..');
-const INCIDENTS = path.join(ROOT, 'workflow', 'incidents');
-
-const argMonth = (process.argv.find((a) => a.startsWith('--month=')) || '').split('=')[1] || null;
-
-function fail(msg) {
-  console.error(`agg-delegations: ${msg}`);
-  process.exit(1);
-}
-
-function parseTableRows(sectionText) {
-  return sectionText
-    .split(/\r?\n/)
-    .filter((l) => /^\|/.test(l.trim()))
-    .map((l) => l.trim().replace(/^\|/, '').replace(/\|$/, '').split('|').map((c) => c.trim()))
-    .filter((cols) => !/^\s*$/.test(cols[0]) && /^\d{4}-\d{2}-\d{2}$/.test(cols[0])); // 只留数据行（首列是日期；表头/分隔行随之滤除）
-}
-
-// parseResult：结果列解析。返回值统一为 { kind, rework, reworkNoise } 两个分量。
-// 三个返工格式（2026-10-08 rework-attribution-split 补第三种）：
-//   返工×N                  → 纯设计返工        { kind:'rework',       rework:N,  reworkNoise:0 }
-//   返工×N（门禁噪声）      → 纯门禁面噪声      { kind:'rework-noise', rework:0,  reworkNoise:N }
-//   返工×N + 门禁噪声×M     → 行内双值（混合）  { kind:'rework-mixed', rework:N,  reworkNoise:M }
-// 动机：存量逐行审计（29 行含返工）证实前两种单值格式**无法表达混合归因**——一行只记一个返工
-// 总数时，「1 次设计 + 1 次噪声」只能整行倒向某一侧。行内双值是作者写入时确定已知的归因事实，
-// 不从返工点数量反推（batch-ledger-audit 结论：判据读写入时事实，不猜）。
-// ⚠️ 顺序约束：新分支须排在两个单值分支之前（`$` 锚定使三者互斥，此处按语义就近声明）。
-function parseResult(raw) {
-  const r = (raw || '').trim();
-  // 行内双值（混合归因）：宽容空格（`返工×1+门禁噪声×1` 亦可解析）
-  const mx = r.match(/^返工×(\d+)\s*\+\s*门禁噪声×(\d+)$/);
-  if (mx) return { kind: 'rework-mixed', rework: parseInt(mx[1], 10), reworkNoise: parseInt(mx[2], 10) };
-  if (/^一次通过$/.test(r)) return { kind: 'pass', rework: 0, reworkNoise: 0 };
-  // 门禁噪声档（2026-10-08 selfmeasure-and-modularize）：剥离「返工由门禁面（预算超限 / 双源漏刷 /
-  // 节名不一致 / 门禁自身误报）触发、而非设计面」的形态。动机：本仓 DASHBOARD 自报质量门连续两月红
-  // （一次通过率 55% / 61%，门槛 ≥90%），根因是两档混列——指标永远红且不指示该改什么。
-  const mn = r.match(/^返工×(\d+)（门禁噪声）$/);
-  if (mn) return { kind: 'rework-noise', rework: 0, reworkNoise: parseInt(mn[1], 10) };
-  const m = r.match(/^返工×(\d+)$/);
-  if (m) return { kind: 'rework', rework: parseInt(m[1], 10), reworkNoise: 0 };
-  if (/^主兜底$/.test(r)) return { kind: 'fallback', rework: 1, reworkNoise: 0 };
-  if (/^返工待修$/.test(r)) return { kind: 'pending', rework: 0, reworkNoise: 0 };
-  return { kind: 'unknown', rework: 0, reworkNoise: 0 };
-}
-
-// parseVerdict：合入结论列解析（2026-10-12 merge-accept-rate）
-// 三档：合入 / 返工后合入 / 未合入；空与未知一律 return null（**不计入接受率分母**——
-// 存量行零回填是硬约定，未记录 ≠ 未合入，混进去会凭空造出一个低接受率）。
-// 判据边界：结论由人工/独立复核写入，机器不判真伪（同 --delegated 信任边界）；
-// 本项是**观测不是门槛**，不进 gateMonth（理由见 workflow/delegations.md 头部）。
-// 与结果列（过程质量）刻意分开：结果列量「跑了几遍」，本列量「人愿不愿意合」——
-// METR 2026-03 实测两者落差约 24 个百分点，混列即被前者盖过后者。
-function parseVerdict(raw) {
-  const v = (raw || '').trim();
-  if (/^合入$/.test(v)) return 'accepted';
-  if (/^返工后合入$/.test(v)) return 'accepted-after-rework';
-  if (/^未合入$/.test(v)) return 'rejected';
-  return null; // 留空 / 未登记取值 = 未记录（不进分母）
-}
-
-// ACCEPT_MIN_SAMPLE：接受率最小样本护栏（样本 <5 不出率，沿 agg 既有护栏口径——
-// 样本过小的比率是噪声不是信号，且一旦进门禁就会产出不可消退的告警）。
-const ACCEPT_MIN_SAMPLE = 5;
-
-// splitTables：按表头签名识别两张结果表——节标题只服务人类阅读，表头才是数据边界
-// （2026-09-24 修复：曾按 `## 委派结果` 节标题定位，节结构漂移时已有记录被静默读成「台账为空」）
-// ⚠️ 互引（2026-10-08 papercuts-cleanup-batch 修 2）：check-loop.mjs delegationResultRows 已对齐本签名
-// 口径（委派表头=含「被委派方」列 / 自做表头=首列「日期」且含「任务一句话」列）——一边改另一边须跟；
-// 差异保留：本函数按「连续 | 行」断表（聚合需分行归属），check-loop 按「## 节」终止收集（对账只需并集）
-function splitTables(text) {
-  const tables = { delegated: [], self: [] };
-  let cur = null;
-  for (const line of text.split(/\r?\n/)) {
-    if (!/^\s*\|/.test(line)) { cur = null; continue; } // 表体边界：连续 | 行；断开即出表
-    const cells = line.trim().replace(/^\|/, '').replace(/\|$/, '').split('|').map((c) => c.trim());
-    if (cells.some((c) => c.startsWith('被委派方'))) { cur = 'delegated'; continue; } // 委派表表头
-    if (cells[0] === '日期' && cells.some((c) => c.startsWith('任务一句话'))) { cur = 'self'; continue; } // 自做表表头（委派表已被上一行截走）
-    if (cur) tables[cur].push(line); // 表体行（含分隔行——parseTableRows 会滤掉）
-  }
-  return tables;
-}
-
-// 分片读侧文本（2026-10-13 ledger-shard-ledgers 回灌）：单源 = ledger-shards.readLedgerText
-// （主台账 ∪ delegations.d/*.md，月序即时间序）。.cjs 不能静态 import .mjs、require(esm) 需
-// Node≥20.19（engines ≥18 不假设）——CLI 入口以 import() 装载后注入此变量再进 main；
-// 库调用方（gen-workflow-dashboard）经 opts.text 显式注入合并文本。两者都缺位 → 回落主台账直读
-// （与旧签名行为一致，不静默造数）。
-let shardReadText = null;
-// readLedger：root 显式参数 + soft 模式（2026-10-08 workflow-dashboard 使能导出，判据单源复用——
-// 仪表盘 require 本函数取行，不重写表解析；缺省 root/无 soft 行为与原签名完全一致，main() 零变化）
-function readLedger(root = ROOT, opts = {}) {
-  const ledger = path.join(root, 'workflow', 'delegations.md');
-  let text;
-  if (typeof opts.text === 'string') {
-    text = opts.text; // 库调用方注入的合并文本（读侧单源 = ledger-shards.readLedgerText）
-  } else if (!fs.existsSync(ledger)) {
-    if (opts.soft) return [];
-    fail(`找不到 ${ledger}`);
-  } else if (shardReadText) {
-    try { text = shardReadText(root, 'delegations'); } // 分片感知读（fail-loud 包装：单分片读失败不静默吞）
-    catch (err) { if (opts.soft) return []; fail(`台账读取失败: ${ledger} (${err.message})`); }
-  } else {
-    text = fs.readFileSync(ledger, 'utf8');
-  }
-  const tables = splitTables(text);
-  const delegated = parseTableRows(tables.delegated.join('\n')).map((c) => ({
-    scope: '委派',
-    date: c[0],
-    actor: c[1],
-    result: c[3] || '',
-    verdict: c[5] || '',
-  }));
-  const selfDone = parseTableRows(tables.self.join('\n')).map((c) => ({
-    scope: '自做',
-    date: c[0],
-    actor: '主智能体',
-    result: c[2] || '',
-    verdict: c[4] || '',
-  }));
-  const rows = delegated.concat(selfDone);
-  // 零数据行时区分「台账真空」与「结构漂移」：有日期开头的数据行却识别不到表 → fail-loud，不再静默「台账为空」
-  if (!rows.length && /^\s*\|\s*\d{4}-\d{2}-\d{2}\s*\|/m.test(text)) {
-    if (opts.soft) return [];
-    fail(`台账结构漂移：${ledger} 存在日期开头的数据行但未识别到结果表（委派表表头须含「被委派方」列，自做表表头须为「日期 | 任务一句话 | 结果 | 备注」——末列「合入结论」可缺省，存量表不要求补）`);
-  }
-  return rows;
-}
-
-function countIncidents() {
-  const byMonth = {};
-  if (!fs.existsSync(INCIDENTS)) return byMonth;
-  for (const f of fs.readdirSync(INCIDENTS)) {
-    const m = f.match(/^(\d{4}-\d{2})-\d{2}.*\.md$/);
-    if (m) byMonth[m[1]] = (byMonth[m[1]] || 0) + 1;
-  }
-  return byMonth;
-}
-
-// 门槛（2026-09-27 board-kb-p1 对齐 workflow/delegations.md §并发扩容门槛声明——doc 为权威）：
-//   月度口径项：一次完成率 ≥90% ｜ 月度**设计**返工次数 = 0（2026-10-08 起门禁噪声返工剥离单列）｜ 无主兜底信号（=0）（旧「平均返工≤0.3 / 兜底≤10%」为宽松分叉，退役）
-//   样本护栏项（脚本侧统计可信度门槛，非口径分叉）：月样本量 ≥20 ｜ 委派样本 ≥5
-//   连续性：扩容需「本月 + 上一自然月」连续两月月度口径全达标（delegations.md「连续两个月」）
-const GATE = { minSample: 20, minPassRate: 0.9, minDelegated: 5 };
-
-function metrics(rows) {
-  // 未知结果（结果列拼错/漏填）单列计数，不混进「待修」——待修=未闭环，未知=记录本身有问题（2026-09-24 口径分离）
-  const kinds = rows.map((r) => parseResult(r.result).kind);
-  const valid = rows.filter((_, i) => kinds[i] !== 'pending' && kinds[i] !== 'unknown');
-  const pending = kinds.filter((k) => k === 'pending').length;
-  const unknown = kinds.filter((k) => k === 'unknown').length;
-  let pass = 0, reworkSum = 0, reworkNoiseSum = 0, fallback = 0;
-  for (const r of valid) {
-    const p = parseResult(r.result);
-    if (p.kind === 'pass') pass += 1;
-    if (p.kind === 'fallback') fallback += 1;
-    // 双列累计：设计返工与门禁噪声返工分列（2026-10-08 selfmeasure-and-modularize 引入分列，
-    // 2026-10-08 rework-attribution-split 加行内混合档）。
-    // 显式列 kind 而非 `reworkSum += p.rework`——否则后续新增 kind 会被静默并入设计返工，
-    // 且混合档的两个分量必须各走各的累加器（只加 rework 会漏掉噪声）。
-    if (p.kind === 'rework' || p.kind === 'rework-mixed') reworkSum += p.rework;
-    if (p.kind === 'rework-noise' || p.kind === 'rework-mixed') reworkNoiseSum += p.reworkNoise;
-  }
-  const delegatedValid = valid.filter((r) => r.scope === '委派');
-  // 接受率（2026-10-12 merge-accept-rate）：分母 = **已记录合入结论**的行数（parseVerdict 非 null），
-  // 分子 = accepted + accepted-after-rework。留空行不计入——存量行零回填，未记录 ≠ 未合入。
-  // 分母不足 ACCEPT_MIN_SAMPLE 时 acceptRate = null（输出 '—'），不给小样本比率。
-  let verdictRecorded = 0, accepted = 0, rejected = 0;
-  for (const r of valid) {
-    const v = parseVerdict(r.verdict);
-    if (!v) continue;
-    verdictRecorded += 1;
-    if (v === 'accepted' || v === 'accepted-after-rework') accepted += 1;
-    if (v === 'rejected') rejected += 1;
-  }
-  const acceptRate = verdictRecorded >= ACCEPT_MIN_SAMPLE ? accepted / verdictRecorded : null;
-  return {
-    total: valid.length,
-    pending,
-    unknown,
-    pass,
-    passRate: valid.length ? pass / valid.length : null,
-    reworkSum,
-    reworkNoiseSum,
-    avgRework: valid.length ? (reworkSum + reworkNoiseSum) / valid.length : null,
-    delegatedValid: delegatedValid.length,
-    fallback,
-    fallbackRate: delegatedValid.length ? fallback / delegatedValid.length : null,
-    verdictRecorded,
-    accepted,
-    rejected,
-    acceptRate,
-  };
-}
-
-// fmtAccept：接受率展示（分母为 0 或未过护栏 → '—' 并注明原因，不打 0%）
-function fmtAccept(m) {
-  if (!m.verdictRecorded) return '—（合入结论零记录）';
-  if (m.acceptRate == null) return `—（样本 ${m.verdictRecorded}/${ACCEPT_MIN_SAMPLE}）`;
-  return `${(m.acceptRate * 100).toFixed(0)}%（${m.accepted}/${m.verdictRecorded}）`;
-}
-
-function fmtRate(x, digits = 0) {
-  return x == null ? '—' : `${(x * 100).toFixed(digits)}%`;
-}
-function fmtNum(x) {
-  return x == null ? '—' : x.toFixed(2);
-}
-
-// gateMonth：单月门槛判定（pure，供测试）——口径项 + 样本护栏项分开列
-function gateMonth(m) {
-  const items = [];
-  items.push({ no: 1, ok: m.total >= GATE.minSample, desc: `样本量 ${m.total}/${GATE.minSample}`, kind: '样本护栏' });
-  items.push({ no: 2, ok: m.passRate != null && m.passRate >= GATE.minPassRate, desc: `一次完成率 ${fmtRate(m.passRate)}≥90%`, kind: '口径' });
-  // 第 3 项判据 2026-10-08 语义变更：只对**设计返工**判 =0；门禁噪声返工单列在描述里（数字仍可见不隐藏，
-  // 但不参与 ok 判定——两类混判是本仓质量门连续两月红的根因）。⚠️ 不可据此给设计返工贴噪声标签洗白指标：
-  // 该取值由作者手写、机器无法判真伪（同 --delegated 信任边界），口径约束见 delegations.md 头部。
-  items.push({ no: 3, ok: m.reworkSum === 0, desc: `月度设计返工 ${m.reworkSum}=0（门禁噪声返工 ${m.reworkNoiseSum || 0} 次已剥离单列）`, kind: '口径' });
-  items.push({ no: 4, ok: m.fallback === 0, desc: `主兜底 ${m.fallback}=0（无主兜底信号）`, kind: '口径' });
-  items.push({ no: 5, ok: m.delegatedValid >= GATE.minDelegated, desc: `委派样本 ${m.delegatedValid}≥5`, kind: '样本护栏' });
-  items.push({ no: 6, ok: null, desc: '门禁不失守（人工对照当月 incident 定性）', kind: '人工' });
-  return { items, monthOk: items.filter((i) => i.ok !== null).every((i) => i.ok) };
-}
-
-// expansionVerdict：连续两个月扩容判定（pure，供测试）——本月与上一自然月 monthOk 均真才「可扩容」；
-// prevMissing = 无上月数据（首月/断档）；items 供未达标项列出
-function expansionVerdict(monthOk, prevOk, prevMissing, items) {
-  if (monthOk && prevOk) return '✅ 连续两月达标（可扩容，待人工确认门6）';
-  if (monthOk && prevMissing) return '⚠️ 本月达标（连续性 1/2——上月无数据）';
-  if (monthOk) return '⚠️ 本月达标（连续性 1/2——上月未达标）';
-  const bad = (items || []).filter((i) => i.ok === false).map((i) => i.no).join('+');
-  return `❌ 未达标（连续性中断）：${bad || '月度口径项未全过'}`;
-}
-
-function main() {
-  const rows = readLedger();
-  const incidents = countIncidents();
-
-  const byMonth = {};
-  for (const r of rows) {
-    const ym = r.date.slice(0, 7);
-    (byMonth[ym] = byMonth[ym] || []).push(r);
-  }
-  const months = Object.keys(byMonth).sort().filter((m) => !argMonth || m === argMonth);
-
-  console.log(`# 量化证据聚合（${argMonth || '全部月份'}） 生成于 ${new Date().toISOString().slice(0, 10)}\n`);
-
-  const snapshotRows = [];
-  const monthResults = new Map(); // ym → { monthOk }（连续两月判定用）
-  for (const ym of months) {
-    const m = metrics(byMonth[ym]);
-    const { items, monthOk } = gateMonth(m);
-    monthResults.set(ym, monthOk);
-    const prevYm = (() => { const [y, mo] = ym.split('-').map(Number); const d = new Date(Date.UTC(y, mo - 2, 1)); return `${d.getUTCFullYear()}-${String(d.getUTCMonth() + 1).padStart(2, '0')}`; })();
-    const verdict = expansionVerdict(monthOk, monthResults.get(prevYm), !months.includes(prevYm), items);
-    console.log(`## ${ym}`);
-    console.log(`  有效任务 ${m.total}（待修 ${m.pending}${m.unknown ? `、未知结果 ${m.unknown}` : ''}）｜一次通过 ${m.pass}（${fmtRate(m.passRate)}）｜设计返工 ${m.reworkSum} 次 / 门禁噪声返工 ${m.reworkNoiseSum} 次（合计返工 ${m.reworkSum + m.reworkNoiseSum}，平均 ${fmtNum(m.avgRework)}）｜主兜底 ${m.fallback}/${m.delegatedValid}（${fmtRate(m.fallbackRate)}）｜产出接受率 ${fmtAccept(m)}｜incident ${incidents[ym] || 0} 起`);
-    console.log(`  接受率说明（观测项，非门槛）：已记录合入结论 ${m.verdictRecorded} 行｜合入 ${m.accepted}｜未合入 ${m.rejected}｜留空未记录行不入分母`);
-    for (const i of items) console.log(`  门${i.no}[${i.kind}] ${i.ok === null ? '[人工]' : i.ok ? '✅' : '❌'} ${i.desc}`);
-    console.log(`  扩容门判定：${verdict}\n`);
-    snapshotRows.push(`| ${ym} | ${m.total} | ${fmtRate(m.passRate)} | ${fmtNum(m.avgRework)} | ${fmtRate(m.fallbackRate)} | ${incidents[ym] || 0} | ${fmtAccept(m)} | ${verdict} | 样本含待修${m.pending}${m.unknown ? `、未知${m.unknown}` : ''} |`);
-  }
-
-  if (!argMonth && rows.length) {
-    const m = metrics(rows);
-    console.log(`## 全量累计`);
-    console.log(`  有效任务 ${m.total}（待修 ${m.pending}${m.unknown ? `、未知结果 ${m.unknown}` : ''}）｜一次通过 ${fmtRate(m.passRate)}｜平均返工 ${fmtNum(m.avgRework)}｜主兜底 ${fmtRate(m.fallbackRate)}｜产出接受率 ${fmtAccept(m)}｜incident 合计 ${Object.values(incidents).reduce((a, b) => a + b, 0)} 起\n`);
-  }
-
-  console.log(`## 可粘贴快照行（粘到 workflow/delegations.md §月度聚合快照）`);
-  for (const r of snapshotRows) console.log(r);
-
-  if (!rows.length) {
-    console.log('\n（台账为空：尚无记录，扩容门自然未通过）');
-  }
-}
-
-// isMain 守卫 + 纯函数导出（board-kb-p1：gateMonth / expansionVerdict 供测试 import，import 不执行 main）
-if (require.main === module) {
-  // 分片读侧装载（2026-10-13 ledger-shard-ledgers）：动态 import 后进 main；装载失败 fail-loud
-  // （指标缺数会喂错扩容门，不静默退化主台账直读）。
-  import('./ledger-shards.mjs')
-    .then((m) => { shardReadText = m.readLedgerText; main(); })
-    .catch((err) => fail(`ledger-shards.mjs 装载失败: ${err.message}`));
-} else {
-  module.exports = { parseResult, parseVerdict, metrics, gateMonth, expansionVerdict, fmtAccept, GATE, ACCEPT_MIN_SAMPLE, readLedger };
-}