agentic-flow-kit 1.7.16 → 1.8.0

package/templates/_agents/scripts/pipeline-run.test.mjs

@@ -47,7 +47,7 @@ console.log('✅ intent 草稿：' + out);
 fs.writeFileSync(out, body);
 console.log('✅ spec 草稿：' + out);
 `);
-  fake('fill-plan.mjs', FILL_HEAD + `const body = '---\\n状态: draft\\n级别: ' + (lv === 'L0' ? 'L1' : lv) + '\\n模块: pipeline\\n---\\n# PLAN — ' + t + '\\n\\n## 改动方案\\n\\n- src/app.mjs：实现功能\\n\\n## 约束与风险\\n\\n- 风险低\\n\\n## 任务拆解\\n\\n1. 实现\\n\\n## 执行顺序\\n\\n1\\n\\n## 验证计划\\n\\n- 静态门：npm test\\n\\n## 确认与复核\\n- 待\\n';
+  fake('fill-plan.mjs', FILL_HEAD + `const body = '---\\n状态: draft\\n级别: ' + lv + '\\n模块: pipeline\\n---\\n# PLAN — ' + t + '\\n\\n## 改动方案\\n\\n- src/app.mjs：实现功能\\n\\n## 约束与风险\\n\\n- 风险低\\n\\n## 任务拆解\\n\\n1. 实现\\n\\n## 执行顺序\\n\\n1\\n\\n## 验证计划\\n\\n- 静态门：npm test\\n\\n## 确认与复核\\n- 待\\n';
 fs.writeFileSync(out, body);
 console.log('✅ plan 草稿：' + out);
 `);
@@ -289,22 +289,13 @@ test('修复环 cap 3 → 超限 gate-fail exit 2', () => {
   assert.match(out(p), /修复环超限/);
 });
 
-test('L0 路径：直改 → 提交 → done', () => {
-  const f = buildFixture();
-  prun(f, ['start', '改一处文案']);
-  prun(f, ['next', '--triage', 'kind=require level=L0 module=wiki topic=copy1']);
-  const pw = prun(f, ['next']); // 无 --files：重发工单
-  assert.match(out(pw), /PIPELINE-STOP work-order/);
-  const p = prun(f, ['next', '--files', 'README.md'], { FIXTURE_GIT_STATUS: ' M README.md' });
-  assert.equal(p.status, 0, out(p));
-  assert.match(out(p), /PIPELINE-STOP done/);
-  assert.match(fs.readFileSync(f.gitLog, 'utf8'), /commit -m docs\(wiki\): 改一处文案/);
-});
+// （2026-10-13 L0 退役，自源仓收敛系列 1 回灌：原「L0 路径：直改 → 提交 → done」场景随 direct-edit
+// 分支删除——最低档 L1 走 intent+plan 闭环，无直改通道。）
 
 test('verify-only 短路径直达 done', () => {
   const f = buildFixture();
   prun(f, ['start', '跑下 verify']);
-  const p = prun(f, ['next', '--triage', 'kind=verify level=L0 module=pipeline topic=v1']);
+  const p = prun(f, ['next', '--triage', 'kind=verify level=L1 module=pipeline topic=v1']);
   assert.equal(p.status, 0, out(p));
   assert.match(out(p), /PIPELINE-STOP done/);
   assert.ok(runFile(f, latestId(f)).events.some((e) => e.type === 'gate' && e.cmd.includes('verify.mjs') && e.exit === 0));
@@ -313,7 +304,7 @@ test('verify-only 短路径直达 done', () => {
 test('review-only：工单 → --done 收尾可达（复核 P1-1 回归）', () => {
   const f = buildFixture();
   prun(f, ['start', '评审一下']);
-  const pw = prun(f, ['next', '--triage', 'kind=review level=L0 module=pipeline topic=rv1']);
+  const pw = prun(f, ['next', '--triage', 'kind=review level=L1 module=pipeline topic=rv1']);
   assert.match(out(pw), /PIPELINE-STOP work-order/);
   const pd = prun(f, ['next', '--done']);
   assert.equal(pd.status, 0, out(pd));
@@ -332,7 +323,7 @@ test('deploy 路径：三件 done → prep 工单 → 机器校验 → 授权
   const f = buildFixture();
   seedDeployDocs(f, { intentState: 'done', planState: 'done' });
   prun(f, ['start', '可以上了']);
-  const pw = prun(f, ['next', '--triage', 'kind=deploy level=L0 module=pipeline topic=dep1']);
+  const pw = prun(f, ['next', '--triage', 'kind=deploy level=L1 module=pipeline topic=dep1']);
   assert.equal(pw.status, 0, out(pw));
   assert.match(out(pw), /deploy-prep/);
   assert.match(out(pw), /PIPELINE-STOP work-order/);
@@ -350,7 +341,7 @@ test('deploy 三件缺口 → gate-fail 列缺口 exit 2（P1-2）', () => {
   const f = buildFixture();
   seedDeployDocs(f, { intentState: 'done', planState: 'approved' }); // plan 未关单
   prun(f, ['start', '可以上了']);
-  prun(f, ['next', '--triage', 'kind=deploy level=L0 module=pipeline topic=dep1']);
+  prun(f, ['next', '--triage', 'kind=deploy level=L1 module=pipeline topic=dep1']);
   const p = prun(f, ['next']);
   assert.equal(p.status, 2);
   assert.match(out(p), /须 done/);
@@ -362,7 +353,7 @@ test('deploy 边界：incident closed 但 plan 缺失 → gate-fail（复核 P2-
   fs.writeFileSync(path.join(f.root, 'workflow', 'incidents', '2026-10-02-incd.md'),
     '---\n状态: closed\n发现: 2026-10-02\n模块: pipeline\n---\n# INCIDENT — incd\n\n## 时间线\n\n- x\n\n## 根因\n\nx\n\n## 复盘三件套\n\nx\n');
   prun(f, ['start', '可以上了']);
-  prun(f, ['next', '--triage', 'kind=deploy level=L0 module=pipeline topic=incd']);
+  prun(f, ['next', '--triage', 'kind=deploy level=L1 module=pipeline topic=incd']);
   const p = prun(f, ['next']);
   assert.equal(p.status, 2);
   assert.match(out(p), /plans\/2026-10-02-incd\.md（缺失——须 done）/);
@@ -372,32 +363,26 @@ test('deploy 边界：topic 子串不再误匹配（复核 P2-C 收紧回归）'
   const f = buildFixture();
   seedDeployDocs(f, { intentState: 'done', planState: 'done', topic: 'dep1' });
   prun(f, ['start', '可以上了']);
-  const p = prun(f, ['next', '--triage', 'kind=deploy level=L0 module=pipeline topic=dep']); // 旧版 includes 会误命中 dep1
+  const p = prun(f, ['next', '--triage', 'kind=deploy level=L1 module=pipeline topic=dep']); // 旧版 includes 会误命中 dep1
   assert.equal(p.status, 2);
   assert.match(out(p), /找不到可上线的对象/);
 });
 
 // P2-4 A′：提交命中 managed 面的处理（装户降级 WARN / 包源自愈 sync）
+// （2026-10-13 L0 退役：原用例经 direct-edit 直改通道驱动；该通道随级别退役删除，改由 L1 闭环的
+//   workflow 文档提交（plan-confirm 批次一 docsCommit）驱动同一 managedFaceCheck 判定面。）
 test('P2-4 A′：命中台账件且无 flow-kit → 装户降级 WARN + 台账随提交（复核回归）', () => {
   const f = buildFixture();
-  fs.mkdirSync(path.join(f.root, '.agents', 'notes'), { recursive: true });
-  fs.writeFileSync(path.join(f.root, '.agents', 'notes', 'runtime-env.md'), 'notes\n');
-  fs.writeFileSync(path.join(f.root, '.agents', 'kit.json'), JSON.stringify({ managed: [{ rel: '.agents/notes/runtime-env.md', sha256: 'x' }] }));
-  prun(f, ['start', '改一处文案']);
-  prun(f, ['next', '--triage', 'kind=require level=L0 module=wiki topic=mng1']);
-  editDoc(f, '.agents/notes/runtime-env.md', (t) => t + '\n- 演练追加一行\n');
-  const p = prun(f, ['next', '--files', '.agents/notes/runtime-env.md'], { FIXTURE_GIT_STATUS: ' M .agents/notes/runtime-env.md' });
-  assert.equal(p.status, 0, out(p));
-  assert.match(out(p), /⚠️ 触及 managed 面/);
-  const addLine = fs.readFileSync(f.gitLog, 'utf8').split('\n').find((l) => l.startsWith('add '));
-  assert.equal(addLine, 'add .agents/notes/runtime-env.md', '装户降级只 WARN：add 面不含 kit.json（复核 P2-D 断言改实）');
+  fs.writeFileSync(path.join(f.root, '.agents', 'kit.json'), JSON.stringify({ managed: [{ rel: 'workflow/intents/2026-10-02-mng1.md', sha256: 'x' }] }));
+  driveToImplement(f, 'L1', 'mng1');
+  const run = runFile(f, latestId(f));
+  assert.ok(run.events.some((e) => e.type === 'warn' && /触及 managed 面/.test(e.note)), '装户环境降级 WARN 出账');
+  assert.doesNotMatch(fs.readFileSync(f.gitLog, 'utf8'), /add .*\.agents\/kit\.json/, '装户降级只 WARN：add 面不含 kit.json（复核 P2-D 断言改实）');
 });
 
 test('P2-4 A′：包源环境自动 sync——flow-kit 假件被调 + 产物入提交（复核回归）', () => {
   const f = buildFixture();
-  fs.mkdirSync(path.join(f.root, '.agents', 'notes'), { recursive: true });
-  fs.writeFileSync(path.join(f.root, '.agents', 'notes', 'runtime-env.md'), 'notes\n');
-  fs.writeFileSync(path.join(f.root, '.agents', 'kit.json'), JSON.stringify({ managed: [{ rel: '.agents/notes/runtime-env.md', sha256: 'x' }] }));
+  fs.writeFileSync(path.join(f.root, '.agents', 'kit.json'), JSON.stringify({ managed: [{ rel: 'workflow/intents/2026-10-02-mng2.md', sha256: 'x' }] }));
   fs.mkdirSync(path.join(f.root, 'bin'), { recursive: true });
   const syncLog = path.join(f.root, 'flowkit-sync.log');
   fs.writeFileSync(path.join(f.root, 'bin', 'flow-kit.mjs'), `#!/usr/bin/env node
@@ -408,11 +393,7 @@ const kit = JSON.parse(fs.readFileSync(kp, 'utf8'));
 kit.managed[0].sha256 = 'refreshed';
 fs.writeFileSync(kp, JSON.stringify(kit));
 `);
-  prun(f, ['start', '改一处文案']);
-  prun(f, ['next', '--triage', 'kind=require level=L0 module=wiki topic=mng2']);
-  editDoc(f, '.agents/notes/runtime-env.md', (t) => t + '\n- 演练追加一行\n');
-  const p = prun(f, ['next', '--files', '.agents/notes/runtime-env.md'], { FIXTURE_GIT_STATUS: ' M .agents/notes/runtime-env.md' });
-  assert.equal(p.status, 0, out(p));
+  driveToImplement(f, 'L1', 'mng2');
   assert.match(fs.readFileSync(syncLog, 'utf8'), /sync-called/);
   const run = runFile(f, latestId(f));
   assert.ok(run.events.some((e) => e.type === 'gate' && e.cmd.includes('flow-kit.mjs sync') && e.exit === 0));
@@ -423,11 +404,10 @@ fs.writeFileSync(kp, JSON.stringify(kit));
 test('P2-4 A′：未命中台账面 → 不触发 sync/告警', () => {
   const f = buildFixture();
   fs.writeFileSync(path.join(f.root, '.agents', 'kit.json'), JSON.stringify({ managed: [{ rel: '.agents/notes/runtime-env.md', sha256: 'x' }] }));
-  prun(f, ['start', '改一处文案']);
-  prun(f, ['next', '--triage', 'kind=require level=L0 module=wiki topic=mng3']);
-  const p = prun(f, ['next', '--files', 'README.md'], { FIXTURE_GIT_STATUS: ' M README.md' });
-  assert.equal(p.status, 0, out(p));
-  assert.doesNotMatch(out(p), /managed 面/);
+  driveToImplement(f, 'L1', 'mng3');
+  const run = runFile(f, latestId(f));
+  assert.ok(!run.events.some((e) => e.type === 'warn' && /managed 面/.test(e.note)), '未命中台账面不出告警');
+  assert.ok(!run.events.some((e) => e.type === 'gate' && String(e.cmd).includes('flow-kit.mjs sync')), '未命中台账面不触发 sync');
 });
 
 test('rename 行 old+new 双收录防逃逸（复核 P2-2 回归）', () => {

package/templates/_agents/scripts/policy.mjs

@@ -149,6 +149,34 @@ export const POLICIES = {
   },
 };
 
+// ---- 版本 9–12（2026-10-13 B6b-1，自源仓 policy v9–v12 对齐回灌）----
+// 构造式沿源仓 2026-10-10 收敛系列 6 的 merge 链（基线 + 显式差异）：kit v1–v8 键史原样保留不动，
+// 新版本在 kit v8 之上做超集追加，消除「全量手抄日期键、漏抄即静默改语义」的脆弱点（v2 注释自警同源）。
+// 键名与源仓逐字一致；kit 无源仓 v6–v8 的 check14HardSince / verifyHardSince——那两个键的消费段
+// （检查 14 hard 档 / 凭证 hard 档）kit 仍为恒 advisory 面，未落地不引入。incidentRegrSince 随 B6b-2
+//（§21–26 同批）落地并激活其消费段 §3x 防复发证据门。各锚日期 = kit 落地日口径：
+//   发布当日（2026-10-13）= specVerifSince / attributionSince / convergenceSince（advisory 档沿源仓
+//     convergenceSince「发布当日」先例——当日起、存量不追溯）；
+//   发布次日（2026-10-14）= convergenceHardSince / reviewerSince / incidentRegrSince（沿源仓
+//     check14HardSince「发布次日」先例——当日在途件不追溯、维持 advisory 留痕，锚起新违例才升格）。
+// 缺键（v1–v8）→ 对应消费段整体跳过（存量零噪声）。抄全键仍是铁律。
+const merge = (base, over) => ({ ...base, ...over });
+const V9 = merge(POLICIES[8], {
+  incidentRegrSince: '2026-10-14', // 检查 3x incident 防复发验证证据门生效锚（B6b-2 §3x 消费，hard 档「发布次日」口径——在途 fixed 件不追溯）；v1–v8 无此键 → 该段整体跳过
+  specVerifSince: '2026-10-13',   // 检查 21 spec 验证落地核查生效锚（B6b-2 §21 消费；kit 落地 2026-10-13）；v1–v8 无此键 → 该检查整体跳过
+  attributionSince: '2026-10-13', // 检查 24 incident 归因字段生效锚（B6b-2 §24 消费；kit 落地 2026-10-13）；v1–v8 无此键 → 该检查整体跳过
+});
+const V10 = merge(V9, {
+  convergenceSince: '2026-10-13', // 检查 23 判据级收敛对账生效锚（B6b-2 §23 advisory 档消费；kit 落地 2026-10-13）；v1–v9 无此键 → 该检查整体跳过
+});
+const V11 = merge(V10, {
+  convergenceHardSince: '2026-10-14', // 检查 23 证据无效 hard 锚（B6b-2 §23 hard 档消费；kit 落地 2026-10-14）；v1–v10 无此键 → 维持 warning
+});
+const V12 = merge(V11, {
+  reviewerSince: '2026-10-14',    // 检查 1 独立复核上下文标识生效锚（B6b-2 检查 1 扩展消费；kit 落地 2026-10-14）；v1–v11 无此键 → 该子检查整体跳过
+});
+Object.assign(POLICIES, { 9: V9, 10: V10, 11: V11, 12: V12 });
+
 export function loadKitPolicy(root) {
   let raw = null;
   try {

package/templates/_agents/scripts/resolve-merge-conflicts.mjs

@@ -0,0 +1,110 @@
+#!/usr/bin/env node
+// resolve-merge-conflicts.mjs — 台账与派生生成物合并冲突一键自愈器（2026-10-10；B9 自 Shipyard.Material
+//   回灌——判定面逐字对齐，出处沿革留痕在包源仓 git 历史与 CHANGELOG，装户径不引实例路径）
+// 解决什么：多人并发提同一分支，或单人多 worktree 并行后合并时，派生生成物与 append-only 台账走
+//   git 文本合并产生冲突。第一道防线是 `.gitattributes` 的 `merge=jsonl-union` 驱动（台账类冲突直接
+//   确定性并集，见 git-merge-jsonl.mjs）；本脚本是**兜底**——driver / gitattributes 行漏配退化成文本
+//   冲突、或 INDEX.md 这类生成物仍要人工解时，一键消解派生面，把人留在业务冲突上。
+// 逻辑：
+// 1. 扫描当前 Git 处于 unmerged (UU / AA / DD / AU / UA 等) 状态的文件；
+// 2. 若 workflow/INDEX.md 冲突：checkout --ours 后重新调用 gen-workflow-index.mjs 全量生成并 git add；
+// 3. 若 .agents/ 下 *.jsonl 台账冲突且双方内容都在（UU/AA）：利用 git-merge-jsonl.mjs 合并当前与对方
+//    版本并 git add。判定面按「.agents/ 前缀 + .jsonl 后缀」匹配，**天然含 confirmations.d/ 分片**——
+//    分片是 kit 确认行的默认写入口径（2026-10-13 ledger-shard-default），分片 UU/AA 同走并集；
+//    删除/改删型（DD/AU/UD/UA/DU）不做任何写入——自动并集会复活被删文件或凭空建空文件，仅提示人工裁决；
+// 4. 输出处理清单，退出码 0。
+
+import { execFileSync } from 'node:child_process';
+import fs from 'node:fs';
+import { mergeJsonlLines } from './git-merge-jsonl.mjs';
+
+const git = (args) => {
+  try { return execFileSync('git', args, { encoding: 'utf8' }).trim(); }
+  catch (e) { return ''; }
+};
+
+export function getUnmergedFiles() {
+  const status = git(['status', '--porcelain']);
+  if (!status) return [];
+
+  const unmerged = [];
+  for (const line of status.split(/\r?\n/)) {
+    if (!line) continue;
+    const code = line.slice(0, 2);
+    const file = line.slice(3).trim();
+    // 冲突代码：UU (both modified), AA (both added), DU, UD 等
+    if (/^(UU|AA|DD|AU|UD|UA|DU)/.test(code)) {
+      unmerged.push({ file, code });
+    }
+  }
+  return unmerged;
+}
+
+export function autoResolveConflicts() {
+  const files = getUnmergedFiles();
+  if (files.length === 0) {
+    console.log('[resolve-conflicts] 当前无未解决的合并冲突。');
+    return { resolved: [], remaining: [] };
+  }
+
+  const resolved = [];
+  const remaining = [];
+
+  for (const { file, code } of files) {
+    const normFile = file.replace(/\\/g, '/');
+
+    // 1. workflow/INDEX.md 派生索引冲突：取当前版本为底，重新全量生成
+    if (normFile === 'workflow/INDEX.md') {
+      try {
+        execFileSync('git', ['checkout', '--ours', 'workflow/INDEX.md'], { stdio: 'pipe' });
+        // 调用索引生成器重新渲染
+        execFileSync(process.execPath, ['.agents/scripts/gen-workflow-index.mjs'], { stdio: 'pipe' });
+        execFileSync('git', ['add', 'workflow/INDEX.md'], { stdio: 'pipe' });
+        resolved.push('workflow/INDEX.md (已自动全量重生成)');
+      } catch (err) {
+        remaining.push(`workflow/INDEX.md: 重生成失败 (${err.message})`);
+      }
+      continue;
+    }
+
+    // 2. .agents/ 下 *.jsonl 台账冲突（主台账与 confirmations.d/ 分片同判定面）：仅 UU/AA（双方内容
+    //    都在）取当前版本和对方版本合并去重；删除/改删型（DD/AU/UD/UA/DU）不可并集，自动写入会
+    //    复活被删文件或凭空建空文件
+    if (normFile.startsWith('.agents/') && normFile.endsWith('.jsonl')) {
+      if (!/^(UU|AA)$/.test(code)) {
+        remaining.push(`${file}: 删除/改删型冲突不自动处理，请人工裁决`);
+        continue;
+      }
+      try {
+        const ours = git(['show', `:2:${normFile}`]);
+        const theirs = git(['show', `:3:${normFile}`]);
+        const merged = mergeJsonlLines(ours, theirs);
+        fs.writeFileSync(file, merged, 'utf8');
+        execFileSync('git', ['add', file], { stdio: 'pipe' });
+        resolved.push(`${file} (已自动并集去重)`);
+      } catch (err) {
+        remaining.push(`${file}: 台账合并失败 (${err.message})`);
+      }
+      continue;
+    }
+
+    // 其余业务文件保持冲突，需人工审查
+    remaining.push(file);
+  }
+
+  return { resolved, remaining };
+}
+
+if (process.argv[1] && process.argv[1].endsWith('resolve-merge-conflicts.mjs')) {
+  const { resolved, remaining } = autoResolveConflicts();
+  if (resolved.length > 0) {
+    console.log('[resolve-conflicts] ✅ 已自动消解以下派生/台账冲突：');
+    resolved.forEach((f) => console.log(`  - ${f}`));
+  }
+  if (remaining.length > 0) {
+    console.log('\n[resolve-conflicts] ⚠️ 剩余业务代码冲突需手动介入处理：');
+    remaining.forEach((f) => console.log(`  - ${f}`));
+  } else if (resolved.length > 0) {
+    console.log('\n[resolve-conflicts] 所有台账冲突已全部清零，可继续 git commit 完成合并。');
+  }
+}

package/templates/_agents/scripts/resolve-merge-conflicts.test.mjs

@@ -0,0 +1,87 @@
+// resolve-merge-conflicts.test.mjs — 端到端测试合并冲突自愈器的收窄行为（临时 git 仓库夹具；B9 自 Shipyard.Material 回灌）：
+// UU（双方内容都在）走自动并集并 git add；删除/改删型（UD 等）不自动写入、不 git add，仅提示人工裁决。
+// 夹具说明：git merge 对「双方都删」会静默自动解决（不产生 DD 未合并条目，已实测），
+// 故删除型冲突用 modify/delete 构造（ours 修改 + theirs 删除 → UD），确定性复现未合并条目，
+// 且正是旧 bug 的复活路径（:3: 读取失败 → 吞错为 '' → 误写回 ours 内容并 git add）。
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { spawnSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+
+let pass = 0, fail = 0;
+const check = (name, cond, detail = '') => {
+  if (cond) { pass++; console.log(`PASS  ${name}`); }
+  else { fail++; console.log(`FAIL  ${name}${detail ? ` —— ${detail}` : ''}`); }
+};
+
+const scriptPath = path.join(path.dirname(fileURLToPath(import.meta.url)), 'resolve-merge-conflicts.mjs');
+const tmp = fs.mkdtempSync(path.join(os.tmpdir(), 'resolve-conflicts-test-'));
+
+const git = (...args) => spawnSync('git', args, { cwd: tmp, encoding: 'utf8' });
+const porcelain = () => git('status', '--porcelain').stdout.split(/\r?\n/).filter(Boolean);
+
+try {
+  // 夹具：临时 git 仓库，基线含主台账 + 分片
+  git('init');
+  git('config', 'user.email', 'test@local');
+  git('config', 'user.name', 'test');
+  git('config', 'core.autocrlf', 'false');
+  const ledger = path.join(tmp, '.agents', 'confirmations.jsonl');
+  const shard = path.join(tmp, '.agents', 'confirmations.d', 'shard-x.jsonl');
+  fs.mkdirSync(path.dirname(shard), { recursive: true });
+  fs.writeFileSync(ledger, '{"id":1}\n');
+  fs.writeFileSync(shard, '{"id":2}\n');
+  git('add', '-A');
+  git('commit', '-m', 'base');
+  const defaultBranch = git('rev-parse', '--abbrev-ref', 'HEAD').stdout.trim();
+
+  // side：改主台账（追加 id:3）+ 删分片
+  git('checkout', '-b', 'side');
+  fs.writeFileSync(ledger, '{"id":1}\n{"id":3}\n');
+  fs.rmSync(shard);
+  git('add', '-A');
+  git('commit', '-m', 'side');
+
+  // main：改主台账（追加 id:4，与 side 不同行 → UU）+ 改分片（side 已删 → UD）
+  git('checkout', defaultBranch);
+  fs.writeFileSync(ledger, '{"id":1}\n{"id":4}\n');
+  fs.writeFileSync(shard, '{"id":2}\n{"id":5}\n');
+  git('add', '-A');
+  git('commit', '-m', 'main');
+
+  const merge = git('merge', 'side');
+  const statusConflicted = porcelain();
+  check('S1 夹具产生 UU+UD 冲突（merge 失败且两条未合并条目就位）',
+    merge.status !== 0 &&
+    statusConflicted.includes('UU .agents/confirmations.jsonl') &&
+    statusConflicted.includes('UD .agents/confirmations.d/shard-x.jsonl'),
+    `merge-exit=${merge.status} status=${statusConflicted.join(' | ')}`);
+
+  const shardBefore = fs.readFileSync(shard, 'utf8');
+
+  // 被测 CLI
+  const proc = spawnSync(process.execPath, [scriptPath], { cwd: tmp, encoding: 'utf8' });
+
+  check('S2 CLI exit 0（remaining 非零也 exit 0 的既有契约）', proc.status === 0, `status=${proc.status} stderr=${proc.stderr}`);
+
+  const merged = fs.readFileSync(ledger, 'utf8');
+  check('S3 UU 主台账=双方行并集', merged === '{"id":1}\n{"id":4}\n{"id":3}\n', merged);
+  check('S4 UU 主台账无冲突标记', !merged.includes('<<<<<<<'), merged);
+  const statusAfter = porcelain();
+  const ledgerLine = statusAfter.find((l) => l.endsWith('.agents/confirmations.jsonl'));
+  check('S5 UU 主台账已 git add（不再未合并）', !!ledgerLine && !/^(UU|AA|DD|AU|UD|UA|DU)/.test(ledgerLine), ledgerLine || '(不在 status 中)');
+
+  check('S6 UD 分片未被 git add（仍处未合并态）',
+    statusAfter.includes('UD .agents/confirmations.d/shard-x.jsonl'),
+    statusAfter.join(' | '));
+  check('S7 UD 分片内容未被自动改写', fs.readFileSync(shard, 'utf8') === shardBefore, fs.readFileSync(shard, 'utf8'));
+  check('S8 stdout 提示分片删除/改删型冲突需人工裁决',
+    proc.stdout.includes('.agents/confirmations.d/shard-x.jsonl') && proc.stdout.includes('删除/改删型冲突不自动处理'),
+    proc.stdout);
+} finally {
+  fs.rmSync(tmp, { recursive: true, force: true });
+}
+
+console.log(`\n合计: PASS ${pass} / FAIL ${fail}`);
+process.exit(fail ? 1 : 0);

package/templates/_agents/scripts/rewrite-file.mjs

@@ -0,0 +1,133 @@
+#!/usr/bin/env node
+// rewrite-file.mjs — 按行字面替换 + 响亮失败（2026-10-12 silent-noop-loud-failure）
+// 背景（papercut 2026-10-06 行，留痕在包源仓 git 历史与 CHANGELOG；两次假落账实证）：
+//   `node -e "fs.writeFileSync(p, s.replace(A, B))"` 对 **CRLF 检出文件**用 `\n` 锚串定位时
+//   **静默无操作**，脚本照样打印「落账 OK」——假成功比响亮失败危险得多（台账/文档被以为改了）。
+// 本工具把该形态的三个失效点逐一堵死：
+//   ① 按行处理并保留原行尾（`/\r?\n/` 切分 + 检出 EOL 回写）——不再有「\n 锚串匹配不上 CRLF」这一类
+//   ② 替换数必须与 --expect 相符（默认 1）——0 命中即非零退出，**文件不写**，绝不存在「以为改了」
+//   ③ 写后回读校验（新锚已在、旧锚已零、行数不变、EOL 未变）——全过才打印成功；任一不过即非零退出
+// 另防两类自伤：find === replace（无操作却报成功）与目标文件不存在（fail-loud，不静默建文件）。
+// 原子写：同目录临时文件 + rename——中途崩溃不留半写文件（沿 git-merge-jsonl.mjs / compact-ledgers.mjs 惯例）。
+// 用法：node .agents/scripts/rewrite-file.mjs <文件> --find <字面串> --replace <字面串>
+//         [--expect N] [--allow-multi] [--dry-run] [--root <仓库根>]
+//   --expect N    期望命中数（默认 1）；实际 ≠ N → 非零退出且不写盘
+//   --allow-multi 显式声明允许多命中（等价 --expect 的宽松形态：N ≥ 1 即过，用于批量同串替换）
+//   --dry-run     只打印将发生的替换与校验预览，不写盘
+// 测试：node .agents/scripts/rewrite-file.test.mjs
+// 沿革：2026-10-12 立档（优先级 3：把「静默无操作」改成响亮失败）
+import fs from 'node:fs';
+import path from 'node:path';
+
+const argv = process.argv.slice(2);
+const argOf = (k) => {
+  const i = argv.indexOf(k);
+  return i >= 0 && i + 1 < argv.length ? argv[i + 1] : '';
+};
+const DRY = argv.includes('--dry-run');
+const MULTI = argv.includes('--allow-multi');
+let file = '';
+let find = null;
+let replace = null;
+for (let i = 0; i < argv.length; i++) {
+  const a = argv[i];
+  if (a === '--find') find = argv[++i] ?? null;
+  else if (a === '--replace') replace = argv[++i] ?? null;
+  else if (a === '--expect') { /* 下面统一解析 */ }
+  else if (a === '--root') { /* 仅为与其它脚本口令一致，路径按 cwd 解析 */ i++; }
+  else if (a === '--dry-run' || a === '--allow-multi') { /* 旗标已处理 */ }
+  else if (!a.startsWith('--') && !file) file = a;
+}
+const expectRaw = argOf('--expect');
+
+const USAGE = `用法：node .agents/scripts/rewrite-file.mjs <文件> --find <字面串> --replace <字面串> [--expect N] [--allow-multi] [--dry-run]`;
+const die = (msg) => { console.error(`❌ rewrite-file: ${msg}\n${USAGE}`); process.exit(1); };
+if (argv.includes('--help') || argv.includes('-h')) { console.log(USAGE); process.exit(0); }
+if (!file) die('缺目标文件');
+if (find === null || replace === null) die('--find 与 --replace 必须成对给出');
+if (find === '') die('--find 不能为空串（空串会命中每一行，属误用）');
+if (find === replace) die(`--find 与 --replace 相同（「${find.slice(0, 40)}」）——无操作却会报成功，正是本工具要堵的形态`);
+let expect = 1;
+if (expectRaw !== '') {
+  if (!/^\d+$/.test(expectRaw)) die(`--expect 须为非负整数（现 ${expectRaw}）`);
+  expect = Number(expectRaw);
+}
+if (MULTI && expectRaw !== '') die('--allow-multi 与 --expect 互斥（一个宽松一个严格，同给无法裁决）');
+
+const abs = path.resolve(process.cwd(), file);
+if (!fs.existsSync(abs)) die(`目标文件不存在：${file}（不静默创建新文件——路径写错时应响亮失败）`);
+let raw;
+try { raw = fs.readFileSync(abs, 'utf8'); } catch (err) { die(`读取失败：${file}（${err.message}）`); }
+
+// ---- 按行处理 + EOL 保全 ----
+const crlf = raw.includes('\r\n');
+const eol = crlf ? '\r\n' : '\n';
+const hadTrailingNewline = /\r?\n$/.test(raw);
+const lines = raw.split(/\r?\n/);
+// 末行是「 trailing newline 产生的空串」时不计入可替换行集合（避免把 EOF 空串当一行改）
+const bodyLines = hadTrailingNewline ? lines.slice(0, -1) : lines;
+
+let hits = 0;
+const changedIdx = [];
+const newBody = bodyLines.map((l, i) => {
+  if (!l.includes(find)) return l;
+  const n = l.split(find).length - 1;
+  hits += n;
+  changedIdx.push(i + 1);
+  return l.split(find).join(replace);
+});
+
+if (hits === 0) {
+  console.error(`❌ rewrite-file: 0 命中——未写盘（文件保持原样）`);
+  console.error(`   文件：${file}`);
+  console.error(`   行尾：${crlf ? 'CRLF（仓库 autocrlf 检出态）' : 'LF'}｜总行数：${bodyLines.length}`);
+  console.error(`   锚串（前 80 字符）：${JSON.stringify(find.slice(0, 80))}`);
+  console.error(`   常见成因：① 锚串与文件实际内容不一致（空格/全角/标点）；② 用 \\n 跨行锚串去匹配 CRLF 文件——本工具按行匹配，跨行锚请拆成单行锚或改用 Edit 工具；③ 文件已被前一次改动写过。`);
+  process.exit(1);
+}
+if (MULTI) {
+  if (hits < 1) die('内部不变式违反：hits < 1');
+} else if (hits !== expect) {
+  console.error(`❌ rewrite-file: 命中数 ${hits} ≠ 期望 ${expect}——未写盘（文件保持原样）`);
+  console.error(`   文件：${file}｜命中行号：${changedIdx.join(', ')}`);
+  console.error(`   含义：锚串不是唯一命中——要么目标不唯一（应加 --expect ${hits} 或 --allow-multi 明示），要么文件已被改过。`);
+  process.exit(1);
+}
+
+const out = newBody.join(eol) + (hadTrailingNewline ? eol : '');
+if (newBody.length !== bodyLines.length) die('内部不变式违反：行数发生变化');
+
+if (DRY) {
+  console.log(`[dry-run] ${file}：将替换 ${hits} 处（行 ${changedIdx.join(', ')}），行尾 ${crlf ? 'CRLF' : 'LF'}，未写盘`);
+  process.exit(0);
+}
+
+// ---- 原子写 ----
+const tmp = `${abs}.rewrite-tmp`;
+try {
+  fs.writeFileSync(tmp, out, 'utf8');
+  fs.renameSync(tmp, abs);
+} catch (err) {
+  try { fs.unlinkSync(tmp); } catch { /* tmp 可能尚未创建 */ }
+  die(`写入失败：${file}（${err.message}）——原文件应保持原样，请核对后重试`);
+}
+
+// ---- 写后回读校验（③）：任一不过即非零退出，绝不打印成功 ----
+const problems = [];
+let back;
+try { back = fs.readFileSync(abs, 'utf8'); } catch (err) { die(`回读失败：${file}（${err.message}）——写入结果不可验证，请人工核对`); }
+if (back !== out) problems.push('回读内容与拟写内容不一致（写入被截断或并发改动）');
+if (back.includes(find)) problems.push('旧锚串仍存在于回读内容中（替换不完整）');
+if (replace !== '' && !back.includes(replace)) problems.push('新锚串不在回读内容中');
+const backLines = back.split(/\r?\n/);
+const backBody = hadTrailingNewline ? backLines.slice(0, -1) : backLines;
+if (backBody.length !== bodyLines.length) problems.push(`行数变化：${bodyLines.length} → ${backBody.length}`);
+if (back.includes('\r\n') !== crlf) problems.push(`行尾形态变化：${crlf ? 'CRLF' : 'LF'} → ${back.includes('\r\n') ? 'CRLF' : 'LF'}`);
+if (problems.length) {
+  console.error(`❌ rewrite-file: 写后回读校验未过——${file}`);
+  problems.forEach((p) => console.error(`   - ${p}`));
+  console.error('   现场已保留（不要手改），请核对后用 git 恢复或重新替换');
+  process.exit(1);
+}
+
+console.log(`✅ rewrite-file: ${file} 替换 ${hits} 处（行 ${changedIdx.join(', ')}）｜行尾 ${crlf ? 'CRLF' : 'LF'} 保全｜行数 ${bodyLines.length} 不变｜回读校验通过`);