agentic-flow-kit 0.7.0 → 0.9.0

package/src/gates.test.mjs

@@ -0,0 +1,126 @@
+#!/usr/bin/env node
+// 三个可选门禁：临时 git 仓库里暂存违规 / 干净文件，断言退出码。
+import { spawnSync } from 'node:child_process';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const git = process.platform === 'win32' ? 'git.exe' : 'git';
+let pass = 0;
+let fail = 0;
+const check = (name, cond, detail = '') => {
+  if (cond) { pass++; console.log(`PASS  ${name}`); }
+  else { fail++; console.log(`FAIL  ${name}${detail ? `\n      ${detail}` : ''}`); }
+};
+
+function repo() {
+  const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'fk-gate-'));
+  spawnSync(git, ['init', '-q'], { cwd: dir });
+  spawnSync(git, ['config', 'user.email', 't@t'], { cwd: dir });
+  spawnSync(git, ['config', 'user.name', 't'], { cwd: dir });
+  return dir;
+}
+function stage(dir, rel, text) {
+  const abs = path.join(dir, rel);
+  fs.mkdirSync(path.dirname(abs), { recursive: true });
+  fs.writeFileSync(abs, text);
+  spawnSync(git, ['add', '--', rel], { cwd: dir });
+}
+function run(script, dir, env = {}) {
+  return spawnSync(process.execPath, [path.join(ROOT, script)], {
+    cwd: dir, encoding: 'utf8', env: { ...process.env, ...env },
+  });
+}
+
+{
+  const dir = repo();
+  stage(dir, 'src/app.mjs', "import { x } from '../tests/helper.mjs';\n");
+  const bad = run('modules/gates/node-layer/check-node-layer.mjs', dir);
+  check('node-layer 引用 tests → exit 1', bad.status === 1 && bad.stderr.includes('src/app.mjs'), bad.stderr);
+  fs.rmSync(dir, { recursive: true, force: true });
+}
+{
+  const dir = repo();
+  stage(dir, 'src/app.mjs', "import { x } from './util.mjs';\n");
+  const ok = run('modules/gates/node-layer/check-node-layer.mjs', dir);
+  check('node-layer 只引 src 内文件 → exit 0', ok.status === 0, ok.stderr);
+  fs.rmSync(dir, { recursive: true, force: true });
+}
+{
+  const dir = repo();
+  stage(dir, 'src/app.mjs', "import { x } from '../tests/helper.mjs';\n");
+  fs.writeFileSync(path.join(dir, 'src/app.mjs'), "import { x } from './util.mjs';\n");
+  const bad = run('modules/gates/node-layer/check-node-layer.mjs', dir);
+  check('node-layer 暂存违规、工作区已改回 → exit 1', bad.status === 1 && bad.stderr.includes('src/app.mjs'), bad.stderr);
+  fs.rmSync(dir, { recursive: true, force: true });
+}
+{
+  const dir = repo();
+  stage(dir, 'src/app.mjs', "import { x } from './util.mjs';\n");
+  fs.writeFileSync(path.join(dir, 'src/app.mjs'), "import { x } from '../tests/helper.mjs';\n");
+  const ok = run('modules/gates/node-layer/check-node-layer.mjs', dir);
+  check('node-layer 暂存干净、工作区违规 → exit 0', ok.status === 0, ok.stderr);
+  fs.rmSync(dir, { recursive: true, force: true });
+}
+{
+  const dir = repo();
+  stage(dir, 'pkg/mod.py', 'from tests.unit import helper\n');
+  const bad = run('modules/gates/py-import/check-py-import.mjs', dir);
+  check('py-import 业务文件 import tests → exit 1', bad.status === 1 && bad.stderr.includes('pkg/mod.py'), bad.stderr);
+  fs.rmSync(dir, { recursive: true, force: true });
+}
+{
+  const dir = repo();
+  stage(dir, 'tests/test_mod.py', 'from tests.unit import helper\n');
+  const ok = run('modules/gates/py-import/check-py-import.mjs', dir);
+  check('py-import 测试目录自身 → exit 0', ok.status === 0, ok.stderr);
+  fs.rmSync(dir, { recursive: true, force: true });
+}
+{
+  const dir = repo();
+  stage(dir, 'pkg/mod.py', 'from tests.unit import helper\n');
+  fs.writeFileSync(path.join(dir, 'pkg/mod.py'), 'import pkg.local\n');
+  const bad = run('modules/gates/py-import/check-py-import.mjs', dir);
+  check('py-import 暂存违规、工作区已改回 → exit 1', bad.status === 1 && bad.stderr.includes('pkg/mod.py'), bad.stderr);
+  fs.rmSync(dir, { recursive: true, force: true });
+}
+{
+  const dir = repo();
+  stage(dir, 'pkg/mod.py', 'import pkg.local\n');
+  fs.writeFileSync(path.join(dir, 'pkg/mod.py'), 'from tests.unit import helper\n');
+  const ok = run('modules/gates/py-import/check-py-import.mjs', dir);
+  check('py-import 暂存干净、工作区违规 → exit 0', ok.status === 0, ok.stderr);
+  fs.rmSync(dir, { recursive: true, force: true });
+}
+{
+  const dir = repo();
+  const body = 'before\n<!-- GENERATED:BEGIN -->\nsecret\n<!-- GENERATED:END -->\nafter\n';
+  stage(dir, 'doc.md', body);
+  spawnSync(git, ['-c', 'user.email=t@t', '-c', 'user.name=t', 'commit', '-qm', 'base'], { cwd: dir });
+  const next = body.replace('secret', 'edited');
+  stage(dir, 'doc.md', next);
+  const bad = run('modules/gates/generated-readonly/check-generated.mjs', dir);
+  check('generated 区被改 → exit 1', bad.status === 1 && bad.stderr.includes('GENERATED'), bad.stderr);
+  const allowed = run('modules/gates/generated-readonly/check-generated.mjs', dir, { FLOW_KIT_ALLOW_GENERATED: '1' });
+  check('FLOW_KIT_ALLOW_GENERATED=1 → exit 0', allowed.status === 0, allowed.stderr);
+  fs.writeFileSync(path.join(dir, 'doc.md'), 'before\nafter\n');
+  const still = run('modules/gates/generated-readonly/check-generated.mjs', dir);
+  check('generated 暂存改区、工作区删掉标记 → exit 1', still.status === 1 && still.stderr.includes('GENERATED'), still.stderr);
+  fs.rmSync(dir, { recursive: true, force: true });
+}
+{
+  const dir = repo();
+  const body = 'before\n<!-- GENERATED:BEGIN -->\nsecret\n<!-- GENERATED:END -->\nafter\n';
+  stage(dir, 'doc.md', body);
+  spawnSync(git, ['-c', 'user.email=t@t', '-c', 'user.name=t', 'commit', '-qm', 'base'], { cwd: dir });
+  stage(dir, 'doc.md', body.replace('before', 'before2'));
+  fs.writeFileSync(path.join(dir, 'doc.md'), body.replace('secret', 'edited'));
+  const ok = run('modules/gates/generated-readonly/check-generated.mjs', dir);
+  check('generated 暂存改区外、工作区改区内 → exit 0', ok.status === 0, ok.stderr);
+  fs.rmSync(dir, { recursive: true, force: true });
+}
+
+console.log(`\n合计: PASS ${pass} / FAIL ${fail}`);
+process.exit(fail ? 1 : 0);

package/src/init.mjs

@@ -77,6 +77,10 @@ export function hasAgentsSkeleton(text) {
   return String(text || '').includes(SKELETON_MARKER);
 }
 // mergeAgents：原内容在上（尾部空白折叠），空行分隔，含标记的完整骨架在下
+export function menuMark(i) {
+  return String(i + 1);
+}
+
 export function mergeAgents(existing, incoming) {
   const head = String(existing || '').replace(/\s+$/, '');
   const tail = String(incoming || '').trim();
@@ -90,7 +94,7 @@ async function interactive() {
   const hostNames = Object.keys(HOSTS);
   const stackNames = Object.keys(STACKS);
   const stackLabel = (n) => (n === 'node' ? 'node（ts/js）' : n);
-  const menu = (names) => '  ' + names.map((n, i) => dim(`${'①②③④⑤⑥'[i]} ${stackLabel(n)}`)).join(dim('   '));
+  const menu = (names) => '  ' + names.map((n, i) => dim(`${menuMark(i)} ${stackLabel(n)}`)).join(dim('   '));
 
   console.log(bold(cyan('▶ flow-kit init')) + dim(' · AI 闭环工作流 + wiki 知识层脚手架'));
   console.log(dim('  安装到当前目录：.agents/ · .githooks/ · workflow/ · wiki/ · AGENTS.md（已存在的文件保守跳过；AGENTS.md 无工作流骨架时文末追加补齐）'));
@@ -311,6 +315,9 @@ export async function init(args, pkgRoot) {
   fs.writeFileSync(kitPath, `${JSON.stringify({
     kit: 'agentic-flow-kit',
     version: pkg.version,
+    policyVersion: 2,
+    // 新装默认只跑硬规则。缺省（旧台账无此字段）在 check-loop 里仍是全量，避免升级后卫生检查突然消失。
+    audit: false,
     createdAt: new Date().toISOString(),
     options: { hosts, stack: opt.stack, boardPort: String(opt.boardPort) },
     managed,

package/src/init.test.mjs

@@ -4,7 +4,8 @@
 // 断言：①ts/js 别名归一 node；②序号/名称/混输/全角逗号/空白分隔解析正确（去重保序）；
 //       ③非法输入返回 null（就地重问信号）；④空输入回默认（EOF/直接回车安全回退）；⑥装户面含 runner/workflows。
 // 用法：node src/init.test.mjs
-import { normalizeStack, parseChoices, hasAgentsSkeleton, mergeAgents } from './init.mjs';
+import { normalizeStack, parseChoices, hasAgentsSkeleton, mergeAgents, menuMark } from './init.mjs';
+import { HOSTS as HOST_REG } from './profiles.mjs';
 import { renderTree, scriptTrusted, listTree } from './render.mjs';
 import { sha256 } from './render.mjs';
 import fs from 'node:fs';
@@ -38,6 +39,11 @@ check('栈别名 ts + map 归一 → node', eq(parseChoices('ts', STACKS, 'none'
 
 // ---- ③ 非法输入 → null（就地重问） ----
 check('越界序号 9 → null', parseChoices('9', HOSTS, 'zcode') === null);
+{
+  const realHosts = Object.keys(HOST_REG);
+  const n = String(realHosts.length);
+  check('菜单号覆盖全部宿主，序号 7 选中最后一项', menuMark(realHosts.length - 1) === n && eq(parseChoices(n, realHosts, 'zcode'), [realHosts[realHosts.length - 1]]));
+}
 check('未知名称 bad → null', parseChoices('zcode,bad', HOSTS, 'zcode') === null);
 check('栈别名未传 map 不归一（ts → null）', parseChoices('ts', STACKS, 'none') === null);
 

package/src/profiles.mjs

@@ -2,13 +2,19 @@
 // stack 决定门禁配置三处：commit-check 的条件构建（builds）与质量检测（checks，秒级确定性
 // 检查——lint/类型/vet；测试不放提交门，关单在 test.md 阶段门）、settings.json 的自检验
 // 命令权限（allow）、AGENTS.md「项目适配区」命令预填；不改工作流流程本身。
-// checks.when = 配置文件存在才启用（如 tsconfig.json / go.mod / ruff.toml）——没有对应
-// 配置的项目自动跳过，不 fail-closed 误拦。none = 不配置（项目日后自填）。
+// checks.when / builds.when = 条件才启用。文件路径或尾部 * 通配表示配置文件存在；
+// pkg:scripts.build 表示 package.json 里该脚本为非空字符串。没有对应配置的项目自动跳过，
+// 不 fail-closed 误拦。none = 不配置（项目日后自填）。
 export const HOSTS = {
   zcode: { dir: '.zcode', localOnly: true },
   opencode: { dir: '.opencode', localOnly: false, commandPrefix: 'wf-' },
   trae: { dir: '.trae', localOnly: false, commandPrefix: 'wf-' },
   omp: { dir: '.omp', localOnly: true },
+  // 2026-09-29 店面：序号仍把 zcode 放第一（交互菜单 1–4 不变）。claude / cursor 的 commands 由宿主自动加载；
+  // codex 自动读仓库根 AGENTS.md 与 .codex/skills/，commands 与 agents 是同形薄转发，供显式引用。
+  claude: { dir: '.claude', localOnly: false, commandPrefix: 'wf-' },
+  cursor: { dir: '.cursor', localOnly: false, commandPrefix: 'wf-' },
+  codex: { dir: '.codex', localOnly: false, commandPrefix: 'wf-' },
 };
 // commandPrefix = 该宿主的命令层薄适配文件名（= 宿主命令名）统一前缀，2026-09-28 opencode-cmd-wf-prefix
 // 与 trae 对齐后单源：命令名不再裸占宿主顶层命名空间（撞宿主内置/第三方命令无从规避）；缺该字段的宿主
@@ -33,7 +39,7 @@ export const STACKS = {
     build: 'npm run build',
     test: 'npm test',
     typecheck: 'npx tsc --noEmit（或 npm run typecheck）',
-    builds: [{ name: 'build', command: 'npm run build', ext: ['.ts', '.tsx', '.vue', '.js', '.jsx', '.mjs', '.cjs'] }],
+    builds: [{ name: 'build', command: 'npm run build', ext: ['.ts', '.tsx', '.vue', '.js', '.jsx', '.mjs', '.cjs'], when: ['pkg:scripts.build'] }],
     checks: [
       { name: 'typecheck', command: 'npx tsc --noEmit', ext: ['.ts', '.tsx'], when: ['tsconfig.json'] },
       { name: 'lint', command: 'npx eslint .', ext: ['.ts', '.tsx', '.js', '.jsx', '.vue'], when: ESLINT_CONFIGS },
@@ -44,7 +50,7 @@ export const STACKS = {
     build: '（Python 无统一构建命令，按项目填）',
     test: 'python -m pytest',
     typecheck: '（可选：mypy）',
-    builds: [{ name: 'tests', command: 'python -m pytest', ext: ['.py'] }],
+    builds: [],
     checks: [{ name: 'lint', command: 'ruff check .', ext: ['.py'], when: ['ruff.toml', '.ruff.toml'] }],
     allow: ['python -m pytest', 'pytest', 'ruff check'],
   },

package/src/run-tests.mjs

@@ -12,6 +12,9 @@ const nodeSuites = [
   'src/sync.test.mjs',
   'src/init.test.mjs',
   'src/pack.test.mjs',
+  'src/gates.test.mjs',
+  'src/fresh-init.test.mjs',
+  'src/stack-profile.test.mjs',
   // 宿主门禁模块回归（2026-09-27 host-gates-p1：dotnet-ca BRE 豁免/fail-closed + trae 强推 token 化）
   'src/gate-dotnet-ca.test.mjs',
   'src/trae-hooks.test.mjs',

package/src/stack-profile.test.mjs

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+// 栈提交门契约：node 的构建只在 package.json scripts.build 为非空字符串时跑；
+// python 的提交门不再带 pytest；flow-kit --help 的门禁列表等于 modules/gates 目录。
+// 集成段用临时 git 仓跑真实 init，再对装出的 commit-check.cjs 暂存一个源文件。
+import { spawnSync } from 'node:child_process';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { HELP } from './cli.mjs';
+import { commitCheckConfig, settingsJson } from './profiles.mjs';
+
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
+const git = process.platform === 'win32' ? 'git.exe' : 'git';
+let pass = 0;
+let fail = 0;
+const check = (name, cond, detail = '') => {
+  if (cond) { pass++; console.log(`PASS  ${name}`); }
+  else { fail++; console.log(`FAIL  ${name}${detail ? `\n      ${detail}` : ''}`); }
+};
+
+const gates = fs.readdirSync(path.join(ROOT, 'modules', 'gates'), { withFileTypes: true })
+  .filter((d) => d.isDirectory())
+  .map((d) => d.name)
+  .sort();
+const gateList = gates.join(' | ');
+check('help 当前列表等于 modules/gates 目录', HELP.includes(`当前：${gateList}`), gateList);
+check('help 含四套已发布门禁',
+  ['dotnet-ca', 'generated-readonly', 'node-layer', 'py-import'].every((n) => HELP.includes(n)));
+check('help 不再把当前门禁写成只有 dotnet-ca',
+  !HELP.includes('当前：dotnet-ca；') && !HELP.includes('当前：dotnet-ca）'));
+
+const nodeCfg = JSON.parse(commitCheckConfig('node'));
+check('node 构建命令带 pkg:scripts.build',
+  nodeCfg.builds.some((b) => b.command === 'npm run build' && Array.isArray(b.when) && b.when.includes('pkg:scripts.build')));
+const pyText = commitCheckConfig('python');
+const pyCfg = JSON.parse(pyText);
+check('python builds 为空', Array.isArray(pyCfg.builds) && pyCfg.builds.length === 0, pyText);
+check('python 提交门配置不含 pytest', !pyText.includes('pytest'), pyText);
+check('python 质量检查仍是 ruff',
+  pyCfg.checks.some((c) => String(c.command).includes('ruff') && (c.when || []).includes('ruff.toml')));
+check('python 的 test 阶段权限仍允许 pytest', settingsJson('python').includes('pytest'));
+
+const dirs = [];
+function initStack(stack, port) {
+  const dir = fs.mkdtempSync(path.join(os.tmpdir(), `fk-stack-${stack}-`));
+  dirs.push(dir);
+  spawnSync(git, ['init', '-q'], { cwd: dir });
+  const r = spawnSync(process.execPath, [
+    path.join(ROOT, 'bin', 'flow-kit.mjs'), 'init',
+    '--stack', stack, '--hosts', 'claude', '--board-port', String(port), '--dir', dir,
+  ], { encoding: 'utf8', timeout: 180000 });
+  return { dir, status: r.status, out: `${r.stdout || ''}${r.stderr || ''}` };
+}
+
+function runCommitCheck(dir, rel, content) {
+  fs.writeFileSync(path.join(dir, rel), content);
+  spawnSync(git, ['add', '--', rel], { cwd: dir });
+  const r = spawnSync(process.execPath, [path.join(dir, '.agents', 'hooks', 'commit-check.cjs')], {
+    cwd: dir, encoding: 'utf8', timeout: 60000,
+  });
+  return { status: r.status, out: `${r.stdout || ''}${r.stderr || ''}` };
+}
+
+const nodeInit = initStack('node', 8942);
+check('init --stack node 退出 0', nodeInit.status === 0, `exit=${nodeInit.status}\n${nodeInit.out.split('\n').slice(-25).join('\n')}`);
+if (nodeInit.status === 0) {
+  const installed = fs.readFileSync(path.join(nodeInit.dir, '.agents', 'hooks', 'commit-check.config.json'), 'utf8');
+  check('装出的 node 配置含 pkg:scripts.build', installed.includes('pkg:scripts.build'), installed);
+  const hook = runCommitCheck(nodeInit.dir, 'a.js', 'console.log(1)\n');
+  check('无 scripts.build 时暂存 js：SKIP 且退出 0',
+    hook.status === 0 && hook.out.includes('SKIP') && hook.out.includes('pkg:scripts.build') && !hook.out.includes('BLOCK:'),
+    hook.out);
+}
+
+const pyInit = initStack('python', 8943);
+check('init --stack python 退出 0', pyInit.status === 0, `exit=${pyInit.status}\n${pyInit.out.split('\n').slice(-25).join('\n')}`);
+if (pyInit.status === 0) {
+  const installed = fs.readFileSync(path.join(pyInit.dir, '.agents', 'hooks', 'commit-check.config.json'), 'utf8');
+  check('装出的 python 配置不含 pytest', !installed.includes('pytest'), installed);
+  const hook = runCommitCheck(pyInit.dir, 'a.py', 'x = 1\n');
+  check('暂存 py：不跑 pytest 且退出 0',
+    hook.status === 0 && !hook.out.includes('pytest') && hook.out.includes('COMMIT_CHECK_OK'),
+    hook.out);
+}
+
+for (const dir of dirs) fs.rmSync(dir, { recursive: true, force: true });
+console.log(`\n合计: PASS ${pass} / FAIL ${fail}`);
+process.exit(fail ? 1 : 0);

package/src/sync-hosts.mjs

@@ -1,8 +1,9 @@
 // flow-kit sync-hosts：跨宿主适配层正文段漂移检查 + 单向同步（B-b 方案，2026-09-25）
 // 目的：改权威源（templates/_agents/{commands,roles}/*.md）正文要同步到 N 份薄适配
 // （modules/hosts/<h>/{agents,commands}/*.md）的对应正文段；薄适配 frontmatter 保留宿主特化字段
-// （trae commands 加 name: wf-X、opencode/zcode/omp 各自原描述），不在同步范围。
+// （commands 层 trae 侧另有 name: wf-X，opencode/zcode/omp 各自原描述），不在同步范围。
 // B-b 语义：sha 比对与 apply 只动正文段，frontmatter 双方各自维护。
+// 映射单源在 profiles.mjs#HOSTS.commandPrefix（命令层薄适配文件名前缀；2026-09-28 opencode 对齐 trae 的 wf- 前缀）。
 // 算法：diffHosts 抽为 pure function（authorityRoot + adaptersRoot 两个根）；
 //       sync-hosts CLI 在 pkgRoot 跑（包源视角）；doctor §7.x 在 target 跑（装户视角）——同源逻辑。
 import fs from 'node:fs';
@@ -41,14 +42,17 @@ function listMd(dir) {
   return fs.readdirSync(dir).filter((f) => f.endsWith('.md'));
 }
 
-// pairsFor：权威源文件 → 薄适配 rel 列表（与 sync-hosts 早版同映射；trae commands 加 wf- 前缀）
+// pairsFor：权威源文件 → 薄适配 rel 列表（映射单源见 profiles.mjs#HOSTS.commandPrefix）
+//   commands 权威源 → 带 commandPrefix 的宿主各一份（<dir>/commands/<prefix><name>.md）
+//   roles    权威源 → 全部宿主 agents 各一份
 function pairsFor(authRel) {
   const out = [];
   const norm = authRel.split(path.sep).join('/');
   if (norm.startsWith('commands/') && norm.endsWith('.md')) {
     const name = norm.slice('commands/'.length, -'.md'.length);
-    out.push({ adapterRel: `opencode/commands/${name}.md` });
-    out.push({ adapterRel: `trae/commands/wf-${name}.md` });
+    for (const [h, v] of Object.entries(HOSTS)) {
+      if (v.commandPrefix) out.push({ adapterRel: `${h}/commands/${v.commandPrefix}${name}.md` });
+    }
   } else if (norm.startsWith('roles/') && norm.endsWith('.md')) {
     const name = norm.slice('roles/'.length, -'.md'.length);
     for (const h of Object.keys(HOSTS)) out.push({ adapterRel: `${h}/agents/${name}.md` });
@@ -104,8 +108,10 @@ export function diffHosts({ authorityRoot, adaptersRoot }) {
         const adapterRel = `${h}/${sub}/${f}`;
         if (adapterSeen.has(adapterRel)) continue;
         let authGuess;
-        if (h === 'trae' && sub === 'commands' && f.startsWith('wf-')) {
-          authGuess = `commands/${f.slice('wf-'.length)}`;
+        const prefix = HOSTS[h] && HOSTS[h].commandPrefix;
+        if (sub === 'commands' && prefix && f.startsWith(prefix)) {
+          // 命令层薄适配带宿主 commandPrefix（2026-09-28：opencode 对齐 trae 后两宿主同口径）
+          authGuess = `commands/${f.slice(prefix.length)}`;
         } else if (sub === 'agents') {
           authGuess = `roles/${f}`;
         } else {

package/src/sync-hosts.test.mjs

@@ -10,6 +10,7 @@ import path from 'node:path';
 import os from 'node:os';
 import { spawnSync } from 'node:child_process';
 import { fileURLToPath, pathToFileURL } from 'node:url';
+import { diffHosts } from './sync-hosts.mjs';
 
 const SRC_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)));
 
@@ -31,12 +32,12 @@ function mkFixture() {
     `---\ndescription: Test 阶段\nstage: Test\n---\n\n# Test · v1\n\n权威源正文 test v1\n`);
   W(path.join(root, 'templates/_agents/roles/implementer.md'),
     `---\ndescription: Implementer 角色契约\n---\n\n# Implementer · v1\n\n权威源正文 implementer v1\n`);
-  // 薄适配：commands 权威源 → opencode + trae（trae 加 wf- 前缀 + name）
-  W(path.join(root, 'modules/hosts/opencode/commands/build.md'),
+  // 薄适配：commands 权威源 → opencode + trae（两宿主同为 wf- 前缀；trae 另有 name 字段）
+  W(path.join(root, 'modules/hosts/opencode/commands/wf-build.md'),
     `---\ndescription: Build · opencode 风格\n---\n\n# Build · v1\n\n权威源正文 build v1\n`);
   W(path.join(root, 'modules/hosts/trae/commands/wf-build.md'),
     `---\nname: wf-build\ndescription: Build · trae 风格\n---\n\n# Build · v1\n\n权威源正文 build v1\n`);
-  W(path.join(root, 'modules/hosts/opencode/commands/test.md'),
+  W(path.join(root, 'modules/hosts/opencode/commands/wf-test.md'),
     `---\ndescription: Test · opencode 风格\n---\n\n# Test · v1\n\n权威源正文 test v1\n`);
   W(path.join(root, 'modules/hosts/trae/commands/wf-test.md'),
     `---\nname: wf-test\ndescription: Test · trae 风格\n---\n\n# Test · v1\n\n权威源正文 test v1\n`);
@@ -49,8 +50,18 @@ function mkFixture() {
     `---\nname: implementer\ndescription: opencode 英文风格\n---\n\n# Implementer · v1\n\n权威源正文 implementer v1\n`);
   W(path.join(root, 'modules/hosts/trae/agents/implementer.md'),
     `---\nname: implementer\ndescription: trae 英文风格\n---\n\n# Implementer · v1\n\n权威源正文 implementer v1\n`);
-  // 孤儿薄适配：权威源无对应文件
+  for (const h of ['claude', 'cursor', 'codex']) {
+    for (const cmd of ['build', 'test']) {
+      const title = cmd === 'build' ? 'Build' : 'Test';
+      W(path.join(root, 'modules/hosts', h, 'commands', `wf-${cmd}.md`),
+        `---\ndescription: ${title} · ${h}\n---\n\n# ${title} · v1\n\n权威源正文 ${cmd} v1\n`);
+    }
+    W(path.join(root, 'modules/hosts', h, 'agents/implementer.md'),
+      `---\nname: implementer\ndescription: ${h}\n---\n\n# Implementer · v1\n\n权威源正文 implementer v1\n`);
+  }
+  // 孤儿薄适配：权威源无对应文件（两种形态——带 wf- 前缀与不带前缀）
   W(path.join(root, 'modules/hosts/opencode/commands/orphan.md'), '# orphan\n');
+  W(path.join(root, 'modules/hosts/opencode/commands/wf-legacy.md'), '# legacy\n');
   return root;
 }
 
@@ -69,7 +80,7 @@ syncHosts(process.argv.slice(2), root);
   const fx = mkFixture();
   const r = runSyncHosts(fx, ['--diff']);
   const out = r.stdout + r.stderr;
-  check('S1 全对齐：正文对齐 8 对（2 commands×2 适配 + 1 role×4 宿主）', /正文对齐：\s*8\s*对/.test(out), out);
+  check('S1 全对齐：正文对齐 17 对（2 commands×5 适配 + 1 role×7 宿主）', /正文对齐：\s*17\s*对/.test(out), out);
   check('S1 全对齐：报告无漂移', /无漂移/.test(out), out);
   check('S1 全对齐：exit 0', r.status === 0, `status=${r.status}`);
 }
@@ -83,10 +94,10 @@ syncHosts(process.argv.slice(2), root);
     `---\ndescription: Test 阶段\nstage: Test\n---\n\n# Test · v2\n\n权威源正文 test v2\n`);
   const r = runSyncHosts(fx, ['--diff']);
   const out = r.stdout + r.stderr;
-  check('S2 权威源改了 → 正文漂移 4（build×2 + test×2）', /正文段漂移（4/.test(out), out);
-  check('S2 列出 opencode/commands/build.md', out.includes('commands/build.md → opencode/commands/build.md'), out);
+  check('S2 权威源改了 → 正文漂移 10（build×5 + test×5）', /正文段漂移（10/.test(out), out);
+  check('S2 列出 opencode/commands/wf-build.md（opencode wf- 前缀映射）', out.includes('commands/build.md → opencode/commands/wf-build.md'), out);
   check('S2 列出 trae/commands/wf-build.md（trae wf- 前缀映射）', out.includes('commands/build.md → trae/commands/wf-build.md'), out);
-  check('S2 正文对齐 = 4（1 role × 4 宿主 implementer 未改）', /正文对齐：\s*4\s*对/.test(out), out);
+  check('S2 正文对齐 = 7（1 role × 7 宿主 implementer 未改）', /正文对齐：\s*7\s*对/.test(out), out);
   check('S2 exit 0（diff 模式不阻断）', r.status === 0);
 }
 
@@ -97,10 +108,10 @@ syncHosts(process.argv.slice(2), root);
     `---\ndescription: Build 阶段\nstage: Build\n---\n\n# Build · v2\n\n权威源正文 build v2\n`);
   const r = runSyncHosts(fx, ['--apply']);
   const out = r.stdout + r.stderr;
-  check('S3 apply：报告同步 2 份（opencode + trae）', /按权威源正文覆盖薄适配正文段\s*2\s*份/.test(out), out);
-  check('S3 apply：opencode 正文已同步到 v2', R(path.join(fx, 'modules/hosts/opencode/commands/build.md')).includes('权威源正文 build v2'));
+  check('S3 apply：报告同步 5 份（带 commandPrefix 的宿主）', /按权威源正文覆盖薄适配正文段\s*5\s*份/.test(out), out);
+  check('S3 apply：opencode 正文已同步到 v2', R(path.join(fx, 'modules/hosts/opencode/commands/wf-build.md')).includes('权威源正文 build v2'));
   check('S3 apply：trae 正文已同步到 v2', R(path.join(fx, 'modules/hosts/trae/commands/wf-build.md')).includes('权威源正文 build v2'));
-  check('S3 apply：opencode frontmatter 保留（仍无 name 字段）', !R(path.join(fx, 'modules/hosts/opencode/commands/build.md')).match(/^name:/m));
+  check('S3 apply：opencode frontmatter 保留（仍无 name 字段——前缀由文件名承载）', !R(path.join(fx, 'modules/hosts/opencode/commands/wf-build.md')).match(/^name:/m));
   check('S3 apply：trae frontmatter 保留（仍含 name: wf-build）', R(path.join(fx, 'modules/hosts/trae/commands/wf-build.md')).match(/^name:\s*wf-build/m) !== null);
   check('S3 apply：权威源不动', R(path.join(fx, 'templates/_agents/commands/build.md')).includes('权威源正文 build v2'));
   check('S3 apply：再次 diff 应显示对齐 8', true); // 二次扫描由 sync-hosts 内部做
@@ -114,7 +125,7 @@ syncHosts(process.argv.slice(2), root);
     `---\nname: wf-build\ndescription: trae 自定义描述\n---\n\n# Build · v1\n\n权威源正文 build v1\n`);
   const r = runSyncHosts(fx, ['--diff']);
   const out = r.stdout + r.stderr;
-  check('S4 frontmatter 差异不计正文段漂移', /正文对齐：\s*8\s*对/.test(out) && /无漂移/.test(out), out);
+  check('S4 frontmatter 差异不计正文段漂移', /正文对齐：\s*17\s*对/.test(out) && /无漂移/.test(out), out);
 }
 
 // ============ 场景 5：薄适配正文手改 → drift 列出，apply 覆盖（不污染权威源）============
@@ -136,12 +147,12 @@ syncHosts(process.argv.slice(2), root);
 // ============ 场景 6：薄适配文件不存在 → authorityMissing 列出，apply 不创建 ============
 {
   const fx = mkFixture();
-  fs.rmSync(path.join(fx, 'modules/hosts/opencode/commands/build.md'));
+  fs.rmSync(path.join(fx, 'modules/hosts/opencode/commands/wf-build.md'));
   const r = runSyncHosts(fx, ['--diff']);
   const out = r.stdout + r.stderr;
-  check('S6 薄适配缺失 → authorityMissing 列', /权威源声明但薄适配缺失（/.test(out) && out.includes('opencode/commands/build.md'), out);
+  check('S6 薄适配缺失 → authorityMissing 列', /权威源声明但薄适配缺失（/.test(out) && out.includes('opencode/commands/wf-build.md'), out);
   const r2 = runSyncHosts(fx, ['--apply']);
-  check('S6 apply 不自动创建薄适配（仍缺失）', !fs.existsSync(path.join(fx, 'modules/hosts/opencode/commands/build.md')));
+  check('S6 apply 不自动创建薄适配（仍缺失）', !fs.existsSync(path.join(fx, 'modules/hosts/opencode/commands/wf-build.md')));
 }
 
 // ============ 场景 7：--json 机器可读输出 ============
@@ -152,7 +163,7 @@ syncHosts(process.argv.slice(2), root);
   let parsed = null;
   try { parsed = JSON.parse(out); } catch {}
   check('S7 --json 输出可解析', parsed && typeof parsed === 'object' && Array.isArray(parsed.drift));
-  check('S7 --json 含 inSync = 8', parsed && parsed.inSync === 8, parsed ? JSON.stringify(parsed) : 'null');
+  check('S7 --json 含 inSync = 17', parsed && parsed.inSync === 17, parsed ? JSON.stringify({ inSync: parsed && parsed.inSync, missing: parsed && parsed.authorityMissing }) : 'null');
 }
 
 // ============ 场景 8：孤儿薄适配（权威源无对应文件）→ adapterOrphans 列，apply 不删 ============
@@ -162,8 +173,20 @@ syncHosts(process.argv.slice(2), root);
   const r = runSyncHosts(fx, ['--diff']);
   const out = r.stdout + r.stderr;
   check('S8 孤儿薄适配 → adapterOrphans 列', /孤儿薄适配（/.test(out) && out.includes('opencode/commands/orphan.md'), out);
+  check('S8 opencode 孤儿带 wf- 前缀 → 反推权威源去掉前缀', out.includes('opencode/commands/wf-legacy.md（推测权威源：commands/legacy.md）'), out);
+  check('S8 opencode 孤儿不带前缀 → 原样反推 commands/<file>', out.includes('opencode/commands/orphan.md（推测权威源：commands/orphan.md）'), out);
   const r2 = runSyncHosts(fx, ['--apply']);
-  check('S8 apply 不删孤儿薄适配', fs.existsSync(path.join(fx, 'modules/hosts/opencode/commands/orphan.md')));
+  check('S8 apply 不删孤儿薄适配', fs.existsSync(path.join(fx, 'modules/hosts/opencode/commands/orphan.md')) && fs.existsSync(path.join(fx, 'modules/hosts/opencode/commands/wf-legacy.md')));
+}
+
+{
+  const pkg = path.resolve(SRC_ROOT, '..');
+  const r = diffHosts({
+    authorityRoot: path.join(pkg, 'templates', '_agents'),
+    adaptersRoot: path.join(pkg, 'modules', 'hosts'),
+  });
+  const sample = r.authorityMissing.slice(0, 3).map((x) => x.adapterRel).concat(r.drift.slice(0, 3).map((x) => x.adapterRel)).join('、');
+  check('实仓薄适配无缺失无正文漂移', r.authorityMissing.length === 0 && r.drift.length === 0, `missing=${r.authorityMissing.length} drift=${r.drift.length} ${sample}`);
 }
 
 console.log(`\n合计: PASS ${pass} / FAIL ${failCount}`);

package/templates/AGENTS.md

@@ -11,7 +11,7 @@
 
 1. **新需求 / 功能**：先立 `workflow/intents/` intent（复制 `_TEMPLATE.md`），对话内与用户确认后开工。
 2. **修复类任务**：先查 `workflow/incidents/` 同类历史；L1 以上立 incident（修复中即 intent 等价入口，L2/L3 与 spec/plan 同名配对）。
-3. **级别判断**（就高不就低）：实现级（页面 / 交互 / 样式）→ L1；改「规则 / 契约」→ L2；改「数据与运行时结构」（schema / 迁移 SQL / DI 链 / 认证与中间件管线）→ L3。细则见 `.agents/commands/new-task.md`。
+3. **级别判断与风险泳道**（就高不就低）：L0 例行；L1 实现级；L2 规则/契约；L3 数据与运行时结构。L0/L1 协作道（轻确认+异步审计）；L2/L3 防御道（同步确认门：spec/plan 确认后方可动手，L3 加独立复核）。见 `.agents/commands/new-task.md`。
 
 ### 阶段路由
 
@@ -23,11 +23,11 @@
 
 ### 门禁与提交
 
-- `.githooks/`（经 `core.hooksPath` 挂载，本地 clone 后执行 `git config core.hooksPath .githooks`）：pre-commit（闭环配对 / wiki 台账 / 规则面预算 / 敏感信息扫描与条件构建）、pre-push（闭环断档扫描）、commit-msg、post-commit、pre-merge-commit。
+- `.githooks/`（经 `core.hooksPath` 挂载，本地 clone 后执行 `git config core.hooksPath .githooks`）：pre-commit（闭环配对 / 泳道完整性 / wiki 台账 / 规则面预算 / 双源一致性 / managed 台账快检 / 敏感信息扫描与条件构建）、pre-push（闭环断档扫描）、commit-msg、post-commit、pre-merge-commit。
 - **`git commit` / `git merge` / `git push` 三处一律禁 `--no-verify`**——被拦说明产出不合规，按提示修完原路重试。
-- 项目专属门禁挂 `.agents/hooks/local-pre-commit`。
+- 项目专属门禁挂 `.agents/hooks/local-pre-commit`。装户五条硬规则（配对、验收、确认留痕、敏感信息、双源台账）与 `audit` 档见 `workflow/README.md`「硬规则」。
 - 提交遵循 Conventional Commits 中文（feat / fix / docs / style / refactor / perf）；L1+ 入口文档 / spec / plan 随代码同一提交；确认（approved）后立即 `docs(*)` 单独提交留痕。
-- **确认门（2026-09-27 起）**：intent/spec/plan 的 approved/done 与 incident 的 fixed/closed（2026-09-28 起，open→fixed / fixed→closed 两跳、无单跳）唯一入口 = `node .agents/scripts/confirm-doc.mjs <path>`，放弃态走显式 `--to superseded|cancelled`（cancelled 自 draft/approved/open/fixed；superseded 自 approved/done/fixed/closed——四终态同样内容绑定），两形态：① 用户终端亲手运行键入「可以」（TTY，AI 会话内被拒）；② **对话委托代录**——用户在对话内明确确认后，AI 跑 `confirm-doc.mjs <path> --delegated "<用户原话>"` 逐件代录（一次一份，「逐件确认」口径——多份并录被拒），台账如实记 `source: chat-delegated` + 原话供对质，永不伪装 TTY 行（check-loop 15 指纹+台账对账拦截，与 source 无关）。
+- **确认门（2026-09-27 起）**：intent/spec/plan 的 approved/done 与 incident 的 fixed/closed（两跳、无单跳）唯一入口 = `node .agents/scripts/confirm-doc.mjs <path>`，放弃态走显式 `--to superseded|cancelled`（合法前态见脚本提示；四终态同样内容绑定），两形态：① 用户终端亲手运行键入「可以」（TTY，AI 会话内被拒）；② **对话委托代录**——用户在对话内明确确认后，AI 跑 `confirm-doc.mjs <path> --delegated "<用户原话>"` 逐件代录（默认一次一份，多份并录被拒），台账如实记 `source: chat-delegated` + 原话供对质，永不伪装 TTY 行（check-loop 15 指纹+台账对账拦截，与 source 无关）；L0/L1 协作道可 `--batch` 多份一次代录（台账 `brief:true`，15 并录告警豁免；L2/L3 仍逐份）。
 
 ### 检索、看板与量化
 

package/templates/_agents/board/index.html

@@ -232,7 +232,7 @@ const badge = (c) =>
   acceptBadge(c) + alertBadge(c) + ageBadge(c) +
   `<span class="date">${esc(c.date)}</span>`;
 
-// —— 任务族聚合：同 slug 一卡；head 取入口文档（intent 优先、其次 incident），孤儿用首文档 ——
+// —— 任务族聚合：同 slug 一卡（只用于展示；告警配对在服务端按完整文件名）。head 取入口文档（intent 优先、其次 incident），孤儿用首文档 ——
 const TYPE_ORDER = { intents: 0, incidents: 1, plans: 2, specs: 3 };
 const TYPE_ABBR = { intents: 'IN', incidents: 'IC', plans: 'PL', specs: 'SP' };
 const EXPANDED = new Set();   // 展开中的任务 slug（SSE 刷新后保持）
@@ -319,7 +319,7 @@ async function refreshBoard() {
         `<div class="doc-item" data-file="${esc(d.file)}" title="打开文档">` +
         `<span class="type" style="background:${TYPE_COLOR[d.type]}">${TYPE_LABEL[d.type]}</span>` +
         `<span class="chip">${esc(d.status)}</span>${alertBadge(d)}` +
-        `<span class="doc-title">${esc(d.title)}</span></div>`).join('')}</div></div>`;
+        `<span class="doc-title">${esc(d.date)} · ${esc(d.title)}</span></div>`).join('')}</div></div>`;
   };
   let html = COLS.map((c) => {
     const items = groups[c.key].map((fam) => cardHtml(fam)).join('');
@@ -342,7 +342,7 @@ function renderDrawer() {
   $('#d-title').textContent = CURRENT.title;
   const related = CARDS.filter((c) => c.slug === CURRENT.slug && c.file !== CURRENT.file);
   $('#d-related').innerHTML = related.map((c) =>
-    `<a data-file="${esc(c.file)}">${TYPE_LABEL[c.type]}${c.status !== CURRENT.status ? ' · ' + esc(c.status) : ''}</a>`).join('');
+    `<a data-file="${esc(c.file)}">${TYPE_LABEL[c.type]} · ${esc(c.date)}${c.status !== CURRENT.status ? ' · ' + esc(c.status) : ''}</a>`).join('');
   document.querySelectorAll('#d-tabs button').forEach((b) => b.classList.toggle('on', b.dataset.tab === TAB));
   if (TAB === 'doc') loadDoc(); else loadHist();
 }

package/templates/_agents/commands/build.md

@@ -25,14 +25,13 @@ next: .agents/commands/test.md
 
 ### 起草 plan
 
-1. 确认同名入口文档（approved intent 或已确认的 incident）+ spec（若 L2/L3）均已确认；否则拒绝，回上一阶段
+1. 确认同名入口文档（approved intent 或已确认的 incident）+ spec（若 L2/L3）均已确认；否则回上一阶段（fill/confirm 未过即拒）
 2. 起草 plan:
    - 复制 `workflow/plans/_TEMPLATE.md` → `workflow/plans/YYYY-MM-DD-<主题>.md`(与入口文档同名)
    - L2/L3 按 4 节填写:任务拆解(每个任务有判据) / 风险评估 / 执行顺序 / 遗留项
-   - L1 默认极简两节:改动面(逐条文件+做什么) / 验证方式(一行静态门+按需 UI 实测)；仅多文件多步骤时再加任务拆解/执行顺序
-   - 仍须与入口文档同名落盘
-3. 停下,输出 plan 草稿全文给用户过目,一句"可以"即确认。**逐件确认**:入口文档 / spec / plan 各自的确认点不得并作一次,plan 草稿须全文过目(不接受摘要代替)。**逐件配逐件原话**:`--delegated` 每次传当次实际放行的措辞,不复用同句——复用同句使台账 quote 失去分辨力(事后对质看不出放行的是哪一件),且相邻同 quote 连跑触发 check-loop 15 并录告警(见 workflow/papercuts.md 2026-09-28)
-**确认落态唯一入口**（2026-09-27 起）：用户在终端跑 `node .agents/scripts/confirm-doc.mjs <path>` 键入「可以」（draft→approved / approved→done；对话内明确确认后 AI 可 `--delegated "<原话>"` 代录，台账如实记 source/quote——**逐件调用 + 逐件原话**（一次一份，build.md「逐件确认」口径；多份并录被 confirm-doc 拒绝。--delegated 每次传当次实际放行的措辞，不复用同句——复用同句使台账 quote 失去分辨力，且相邻同 quote 连跑会触发并录告警））。check-loop 15 如实口径：缺记录/指纹不配对 → hard-block 拦截；伪造台账本地不可机器防，留痕供事后对质；done 内容绑定（2026-09-28 起）——关单编辑（勾验/回填）先于 done 确认、confirm-doc 是最后一次写入，此后修订走 superseded 或新 intent。
+   - L1 使用 Quick-Plan 极简三节:改动方案 / 约束与风险(原 Spec 核心) / 验证计划；多文件多步骤时可补任务拆解/执行顺序
+3. 停下,输出 plan 草稿全文给用户过目,一句"可以"即确认。**逐件确认**:入口文档 / spec / plan 各自的确认点不得并作一次,plan 草稿须全文过目(不接受摘要代替)。**逐件配逐件原话**:`--delegated` 每次传当次实际放行的措辞,不复用同句——复用同句使台账 quote 失去分辨力(事后对质看不出放行的是哪一件);原因与根治见 workflow/papercuts.md 2026-09-28
+**确认落态唯一入口**（2026-09-27 起）：用户在终端跑 `node .agents/scripts/confirm-doc.mjs <path>` 键入「可以」（draft→approved / approved→done；对话内明确确认后 AI 可 `--delegated "<原话>"` 代录，台账如实记 source/quote——**逐件调用 + 逐件原话**（一次一份，build.md「逐件确认」口径；多份并录被 confirm-doc 拒绝。--delegated 每次传当次实际放行的措辞，不复用同句——复用同句使台账 quote 失去分辨力））。check-loop 15 如实口径：缺记录/指纹不配对 → hard-block 拦截；伪造台账本地不可机器防，留痕供事后对质；done 内容绑定（2026-09-28 起）——关单编辑（勾验/回填）先于 done 确认、confirm-doc 是最后一次写入，此后修订走 superseded 或新 intent。
 4. 确认后 → plan 状态 draft → approved,并在 plan 内补「确认与复核」节(确认结果 + 日期)。确认环节须在文档留痕:`approved` 是确认的机器可见态,`done` 只在关单出现,禁从 `draft` 直跳 `done`;确认后立即 `docs(workflow)` 单独提交留痕(根 `AGENTS.md` 提交约定;check-loop 检查 14 口径)
 
 ### 进计划模式列改动

package/templates/_agents/commands/design.md

@@ -18,13 +18,13 @@ next: .agents/commands/build.md
 
 # Design · 起 spec
 
-> L2/L3 强制;L1 可省略(直接跳 `next: build.md`)。
+> L2/L3 强制;L1 走快车道(直接跳 `next: build.md` 起草 Quick-Plan)。
 
 ## 执行
 
-1. 确认同名入口文档已批准：新需求为 approved intent，修复为已确认的 incident 草稿；否则拒绝，分别回 `plan.md` / `maintain.md`
+1. 确认同名入口文档已批准：新需求为 approved intent，修复为已确认的 incident 草稿；否则拒绝，分别回 `plan.md` / `maintain.md`（2026-09-30 起机器强制：fill-spec / confirm-doc 对前置未过直接拒绝 exit 2、不落盘不记账）
 2. 级别判断(对照 AGENTS.md 第 3 条):
-   - **L1**(实现级改动,未命中 L2/L3)→ 可省略 spec,直接跳 `next: build.md`
+   - **L1**(实现级改动,未命中 L2/L3)→ 走快车道,省略 spec,直接跳 `next: build.md` 起草 Quick-Plan
    - **L2**(改规则 / 契约:编码权威 / 共享契约 / 既有接口语义 / 全局横切口径,闭集见 `new-task.md` §级别判断)→ 必须有 spec
    - **L3**(数据与运行时结构:schema / 迁移 SQL / DI 链 / 认证与中间件管线)→ 必须有 spec + **新会话独立复核**
 3. 起草 spec:
@@ -51,6 +51,6 @@ next: .agents/commands/build.md
 ## 确认后
 
 - spec 状态 draft → approved
-**确认落态唯一入口**（2026-09-27 起）：用户在终端跑 `node .agents/scripts/confirm-doc.mjs <path>` 键入「可以」（draft→approved / approved→done；对话内明确确认后 AI 可 `--delegated "<原话>"` 代录，台账如实记 source/quote——**逐件调用 + 逐件原话**（一次一份，build.md「逐件确认」口径；多份并录被 confirm-doc 拒绝。--delegated 每次传当次实际放行的措辞，不复用同句——复用同句使台账 quote 失去分辨力，且相邻同 quote 连跑会触发并录告警））。check-loop 15 如实口径：缺记录/指纹不配对 → hard-block 拦截；伪造台账本地不可机器防，留痕供事后对质；done 内容绑定（2026-09-28 起）——关单编辑（勾验/回填）先于 done 确认、confirm-doc 是最后一次写入，此后修订走 superseded 或新 intent。
+**确认落态唯一入口**（2026-09-27 起）：用户在终端跑 `node .agents/scripts/confirm-doc.mjs <path>` 键入「可以」（draft→approved / approved→done；对话内明确确认后 AI 可 `--delegated "<原话>"` 代录，台账如实记 source/quote——**逐件调用 + 逐件原话**（一次一份，build.md「逐件确认」口径；多份并录被 confirm-doc 拒绝。--delegated 每次传当次实际放行的措辞，不复用同句——复用同句使台账 quote 失去分辨力））。check-loop 15 如实口径：缺记录/指纹不配对 → hard-block 拦截；伪造台账本地不可机器防，留痕供事后对质；done 内容绑定（2026-09-28 起）——关单编辑（勾验/回填）先于 done 确认、confirm-doc 是最后一次写入，此后修订走 superseded 或新 intent。
 - 立即 `docs(workflow)` 单独提交留痕(根 `AGENTS.md` 提交约定;check-loop 检查 14 口径)
 - 进 `next: .agents/commands/build.md`