agentic-flow-kit 0.8.0 → 0.9.0

package/templates/_agents/scripts/fill-intent.test.mjs

@@ -36,12 +36,12 @@ function check(name, cond, detail = '') {
   check('S3 非法 level 抛错', threw);
 }
 
-// ---- 场景 4：7 节正文齐 ----
+// ---- 场景 4：9 节正文齐 ----
 {
   const { body } = renderIntent({ topic: 't', module: 'pipeline', level: 'L1' });
-  const expectedSections = ['背景与问题', '目标', '非目标', '约束', '影响面', '触达红线', '验收标准', '确认与复核'];
+  const expectedSections = ['背景与问题', '历史教训/防复发', '目标', '非目标', '约束', '影响面', '触达红线', '验收标准', '确认与复核'];
   for (const s of expectedSections) check('S4 含节 ## ' + s, body.includes('## ' + s));
-  check('S4 共 8 节标题', (body.match(/^##\s/gm) || []).length === 8);
+  check('S4 共 9 节标题', (body.match(/^##\s/gm) || []).length === 9);
 }
 
 // ---- 场景 5：备注字段透传 ----
@@ -69,5 +69,14 @@ function check(name, cond, detail = '') {
   check('S7 缺 topic 仍可渲染（透传设计）', typeof r.body === 'string' && r.body.includes('INTENT — undefined'));
 }
 
+// ---- 场景 8：risk_level 风险泳道字段（混合治理，= 级别，全枚举落 frontmatter）----
+{
+  for (const level of ['L0', 'L1', 'L2', 'L3']) {
+    const { body } = renderIntent({ topic: 't', module: 'pipeline', level });
+    const fm = body.match(/^---([\s\S]*?)---/)[1];
+    check('S8 risk_level=' + level + ' 写入 frontmatter', new RegExp('^risk_level:\\s*' + level + '$', 'm').test(fm));
+  }
+}
+
 console.log('\n合计: PASS ' + pass + ' / FAIL ' + failCount);
 process.exit(failCount ? 1 : 0);

package/templates/_agents/scripts/fill-plan.mjs

@@ -1,22 +1,26 @@
-// flow-kit fill-plan：起草 plan 草稿（L1 极简 2 节 / L2-L3 完整 4 节）
-// 用法：node .agents/scripts/fill-plan.mjs --level L1 --topic "test" --output /tmp/x.md
-// L1：改动面（必填）+ 验证方式（必填）
-// L2/L3：改动面 + 任务拆解 + 执行顺序 + 验证方式
+// flow-kit fill-plan：起草 plan 草稿（L1 Quick-Plan 三节 / L2-L3 完整 4 节）
+// 用法：node .agents/scripts/fill-plan.mjs --level L1 --topic "test" --output /tmp/x.md [--root <仓库根>]
+// L1：改动方案 + 约束与风险 + 验证计划（Quick-Plan 必填三节）
+// L2/L3：改动方案 + 任务拆解 + 执行顺序 + 验证计划
+// 起草门（2026-09-30 stage-gate-machine）：output 落于工作区（路径含 workflow 段）时，须同主题入口已确认，
+// 且入口级别（取入口 frontmatter，非 --level）为 L2/L3 时同名 spec 已确认；未过 → 拒绝生成（exit 2）。
 import fs from 'node:fs';
 import path from 'node:path';
 import { ENUMS } from './workflow-enums.mjs';
+import { draftGateFor, resolveWorkspace } from './stage-gates.mjs';
 
 const TODAY = new Date().toISOString().slice(0, 10);
 const LEVELS = ENUMS['level.all']; // 级别词表单源（.agents/workflow-enums.txt）
 
 function parseArgs(argv) {
-  const out = { topic: null, level: 'L1', output: null };
+  const out = { topic: null, level: 'L1', output: null, root: null };
   for (let i = 0; i < argv.length; i++) {
     const a = argv[i];
     const next = () => { const v = argv[++i]; if (v === undefined) return null; return v; };
     if (a === '--topic') out.topic = next();
     else if (a === '--level') out.level = next();
     else if (a === '--output') out.output = next();
+    else if (a === '--root') out.root = next();
   }
   return out;
 }
@@ -24,22 +28,23 @@ function parseArgs(argv) {
 function fail(msg) { console.error('❌ ' + msg); process.exit(1); }
 
 const L1_SECTIONS = [
-  { title: '改动面（L1 极简形态主节；L2/L3 可作任务拆解的汇总或删本节）', hint: '- <文件/组件>：<做什么；判据细节直接写进条目，如「L771 message.success 改『更新成功』>' },
-  { title: '验证方式', hint: '- 静态门：项目构建命令（+ 项目测试命令，测试项目就绪后）\n- 前端：cd frontend && npm run build（vue-tsc）\n- UI：.agents/commands/test.md（涉及页面改动必走，headless Chrome 实测）\n- L2 追加：<契约 / 规则面比对：编码结果抽样 / 接口契约断言 / 口径对账>\n- L3 追加：<含 schema 变更：备份 + 回滚 SQL 就绪后执行；仅运行时 / 管线：回退上一 release tag + 配置开关预案>' },
+  { title: '改动方案', hint: '- <文件/组件>：<做什么；判据细节直接写进条目，如「L771 message.success 改『更新成功』」>' },
+  { title: '约束与风险', hint: '- 约束：<对照 AGENTS.md 红线，说明如何满足；不许动什么>\n- 风险：<潜在影响 / 破坏性风险>' },
+  { title: '验证计划', hint: '- 静态门：项目构建命令（+ 项目测试命令，测试项目就绪后）\n- 前端：cd frontend && npm run build（vue-tsc）\n- UI：.agents/commands/test.md（涉及页面改动必走，headless Chrome 实测）\n- L2 追加：<契约 / 规则面比对：编码结果抽样 / 接口契约断言 / 口径对账>\n- L3 追加：<含 schema 变更：备份 + 回滚 SQL 就绪后执行；仅运行时 / 管线：回退上一 release tag + 配置开关预案>' },
 ];
 
 const FULL_SECTIONS = [
   L1_SECTIONS[0],
   { title: '任务拆解（L2/L3 必填；L1 仅多文件多步骤时用，单任务微改动删本节）', hint: '1. <任务>\n   - 判据：<怎样算完成；尽量对应一个测试或可复现操作>\n   - 风险：低 / 中 / 高（<原因>）\n2. <任务>\n   - 判据：…\n   - 风险：…' },
   { title: '执行顺序（L2/L3 必填；L1 单文件微改动删本节）', hint: '<1 → 2 → 3；标注依赖关系>' },
-  L1_SECTIONS[1],
+  L1_SECTIONS[2],
 ];
 
 export function renderPlan({ topic, level = 'L1', date = TODAY }) {
   if (!LEVELS.includes(level)) throw new Error('level 不在枚举 ' + LEVELS.join('|') + '：' + level);
   const sections = level === 'L1' ? L1_SECTIONS : FULL_SECTIONS;
   const fm = '---\n状态: draft\n级别: ' + level + '\n模块: pipeline\n---\n';
-  let body = '# PLAN — ' + topic + '\n\n<!-- 与 intents/ 或 incidents/ 下同名入口文档配对；L2/L3 必须先有 ../specs/ 同名 spec 确认通过；AI 起草、用户对话内确认后开工 -->\n<!-- frontmatter 受限子集（2026-09-13）：状态∈draft/approved/done/superseded/cancelled；级别∈L0/L1/L2/L3；正文不再写状态/级别行 -->\n<!-- L1 极简形态（2026-09-13 瘦身，L1 默认）：单/少文件微改动只填「改动面」+「验证方式」两节——改动面逐条列改哪个文件做什么（判据细节直接写进条目），验证一行静态门 + 按需 UI 实测；任务拆解/执行顺序仅 L1 多文件多步骤时保留 -->\n\n对应入口：../intents/YYYY-MM-DD-<主题>.md 或 ../incidents/YYYY-MM-DD-<主题>.md（保留实际一项）\n对应 spec：../specs/YYYY-MM-DD-<主题>.md（L1 可省略）\n\n';
+  let body = '# PLAN — ' + topic + '\n\n<!-- 与 intents/ 或 incidents/ 下同名入口文档配对；L2/L3 必须先有 ../specs/ 同名 spec 确认通过；AI 起草、用户对话内确认后开工 -->\n<!-- frontmatter 受限子集（2026-09-13）：状态∈draft/approved/done/superseded/cancelled；级别∈L0/L1/L2/L3；正文不再写状态/级别行 -->\n<!-- L1 快车道 (Quick-Plan)（2026-09-30 更新）：合并 Spec 与 Plan 核心。必填三节：[改动方案, 约束与风险, 验证计划]。仅多文件多步骤时保留任务拆解/执行顺序 -->\n\n对应入口：../intents/YYYY-MM-DD-<主题>.md 或 ../incidents/YYYY-MM-DD-<主题>.md（保留实际一项）\n对应 spec：../specs/YYYY-MM-DD-<主题>.md（L1 走快车道则省略）\n\n';
   for (const { title, hint } of sections) {
     body += '## ' + title + '\n\n' + hint + '\n\n';
   }
@@ -50,11 +55,22 @@ export function renderPlan({ topic, level = 'L1', date = TODAY }) {
 const isMain = process.argv[1] && process.argv[1].endsWith('fill-plan.mjs');
 if (isMain) {
   const a = parseArgs(process.argv.slice(2));
-  if (!a.topic || !a.output) fail('必填：--topic / --output；选填：--level（默认 L1）');
+  if (!a.topic || !a.output) fail('必填：--topic / --output；选填：--level（默认 L1）/ --root');
   if (!LEVELS.includes(a.level)) fail('level 必须在 ' + LEVELS.join('|') + '：' + a.level);
+  const ws = resolveWorkspace(a.output, a.root);
+  if (ws) {
+    const gate = draftGateFor('plan', ws.root, ws.base);
+    if (!gate.ok) {
+      console.error('❌ 起草门未过（stage-gates）：' + gate.reason);
+      console.error('   ' + gate.hint + '——本份未生成（确认前置后重跑本命令）');
+      process.exit(2);
+    }
+  } else {
+    console.error('ℹ️  未定位到工作区（output 路径不含 workflow/ 段）——按仓外草稿处理，跳过起草门前置校验');
+  }
   const { body } = renderPlan(a);
   fs.mkdirSync(path.dirname(a.output), { recursive: true });
   fs.writeFileSync(a.output, body);
-  console.log('✅ 已生成 plan 草稿：' + a.output + '（状态 draft / 级别 ' + a.level + ' / ' + (a.level === 'L1' ? '极简 2 节' : '完整 4 节') + '）');
+  console.log('✅ 已生成 plan 草稿：' + a.output + '（状态 draft / 级别 ' + a.level + ' / ' + (a.level === 'L1' ? 'Quick-Plan 三节' : '完整 4 节') + '）');
 }
 export default renderPlan;

package/templates/_agents/scripts/fill-plan.test.mjs

@@ -1,4 +1,9 @@
-// fill-plan.test.mjs — fill-plan 工具测试（2026-09-25 doc-fill-tools）
+// fill-plan.test.mjs — fill-plan 工具测试（2026-09-25 doc-fill-tools；2026-09-30 stage-gate-machine 补起草门场景）
+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';
 import { renderPlan } from './fill-plan.mjs';
 
 let pass = 0, failCount = 0;
@@ -7,31 +12,33 @@ function check(name, cond, detail = '') {
   else { failCount++; console.log('FAIL ' + name + (detail ? '——' + detail : '')); }
 }
 
-// ---- 场景 1：L1 极简 2 节 ----
+// ---- 场景 1：L1 Quick-Plan 三节 ----
 {
   const { body } = renderPlan({ topic: 't', level: 'L1' });
   const sections = body.match(/^##\s.+$/gm) || [];
-  check('S1 L1 含节 ## 改动面', body.includes('## 改动面'));
-  check('S1 L1 含节 ## 验证方式', body.includes('## 验证方式'));
-  check('S1 L1 共 3 节（改动面 + 验证方式 + 确认与复核）', sections.length === 3, '实际 ' + sections.length + ' 节');
+  check('S1 L1 含节 ## 改动方案', body.includes('## 改动方案'));
+  check('S1 L1 含节 ## 约束与风险', body.includes('## 约束与风险'));
+  check('S1 L1 含节 ## 验证计划', body.includes('## 验证计划'));
+  check('S1 L1 共 4 节（Quick-Plan 三节 + 确认与复核）', sections.length === 4, '实际 ' + sections.length + ' 节');
 }
 
 // ---- 场景 2：L2 完整 4 节 ----
 {
   const { body } = renderPlan({ topic: 't', level: 'L2' });
   const sections = body.match(/^##\s.+$/gm) || [];
-  check('S2 L2 含节 ## 改动面', body.includes('## 改动面'));
+  check('S2 L2 含节 ## 改动方案', body.includes('## 改动方案'));
   check('S2 L2 含节 ## 任务拆解', body.includes('## 任务拆解'));
   check('S2 L2 含节 ## 执行顺序', body.includes('## 执行顺序'));
-  check('S2 L2 含节 ## 验证方式', body.includes('## 验证方式'));
+  check('S2 L2 含节 ## 验证计划', body.includes('## 验证计划'));
   check('S2 L2 共 5 节（4 节 + 确认与复核）', sections.length === 5, '实际 ' + sections.length + ' 节');
 }
 
 // ---- 场景 3：L3 与 L2 同结构 ----
 {
   const { body } = renderPlan({ topic: 't', level: 'L3' });
-  check('S3 L3 含节 ## 改动面', body.includes('## 改动面'));
+  check('S3 L3 含节 ## 改动方案', body.includes('## 改动方案'));
   check('S3 L3 含节 ## 任务拆解', body.includes('## 任务拆解'));
+  check('S3 L3 含节 ## 验证计划', body.includes('## 验证计划'));
 }
 
 // ---- 场景 4：非法 level 抛错 ----
@@ -63,5 +70,138 @@ function check(name, cond, detail = '') {
   check('S7 含「对应 spec」段（L1 可省略）', body.includes('对应 spec：'));
 }
 
+// ---- 场景 8-13：起草门（2026-09-30 stage-gate-machine）——入口已确认；L2/L3 另须 spec 已确认 ----
+const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
+const CLI = path.join(SCRIPT_DIR, 'fill-plan.mjs');
+const mkws = (files = {}) => {
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'fill-plan-gate-'));
+  fs.mkdirSync(path.join(root, 'workflow', 'plans'), { recursive: true });
+  for (const [rel, body] of Object.entries(files)) {
+    fs.mkdirSync(path.dirname(path.join(root, rel)), { recursive: true });
+    fs.writeFileSync(path.join(root, rel), body);
+  }
+  return root;
+};
+const runTool = (root, base, level) => spawnSync(process.execPath,
+  [CLI, '--topic', base, '--level', level, '--output', path.join(root, 'workflow', 'plans', `${base}.md`)],
+  { cwd: root, encoding: 'utf8' });
+{
+  const root = mkws();
+  const r = runTool(root, '2026-09-30-none', 'L1');
+  check('S8 起草门：无同名入口 → exit 2 且零文件产出',
+    r.status === 2 && /起草门未过/.test(r.stderr) && !fs.existsSync(path.join(root, 'workflow', 'plans', '2026-09-30-none.md')),
+    JSON.stringify({ status: r.status, stderr: r.stderr }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+{
+  const root = mkws({ 'workflow/intents/2026-09-30-l1.md': '---\n状态: approved\n级别: L1\n日期: 2026-01-01\n---\n# I\n' });
+  const r = runTool(root, '2026-09-30-l1', 'L1');
+  const f = path.join(root, 'workflow', 'plans', '2026-09-30-l1.md');
+  check('S9 起草门：L1 入口 approved（存量口径）→ 放行生成',
+    r.status === 0 && fs.existsSync(f) && fs.readFileSync(f, 'utf8').includes('状态: draft'),
+    JSON.stringify({ status: r.status, stderr: r.stderr }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+{
+  // S10（2026-09-30 hybrid-governance-explore-hardening 更新）：draft 且 L2 → 仍拒（防御道维持入口确认
+  // 前置）；原 L1 draft 夹具转入 S10b（探索泳道放行）
+  const root = mkws({ 'workflow/intents/2026-09-30-draft.md': '---\n状态: draft\n级别: L2\n日期: 2026-09-30\n---\n# I\n' });
+  const r = runTool(root, '2026-09-30-draft', 'L1');
+  check('S10 起草门：入口 draft 且 L2 → exit 2 + 提示状态（防御道不变）',
+    r.status === 2 && /状态「draft」/.test(r.stderr),
+    JSON.stringify({ status: r.status, stderr: r.stderr }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+{
+  // S10b 探索泳道（2026-09-30 hybrid-governance-explore-hardening）：L0/L1 draft intent → 放行 plan 起草
+  // （「先起草后确认」；收口由 check-loop --hardening 加固门兜底）
+  const root = mkws({ 'workflow/intents/2026-09-30-exp.md': '---\n状态: draft\n级别: L1\nrisk_level: L1\n日期: 2026-09-30\n---\n# I\n' });
+  const r = runTool(root, '2026-09-30-exp', 'L1');
+  const f = path.join(root, 'workflow', 'plans', '2026-09-30-exp.md');
+  check('S10b 探索泳道：L1 入口 draft → 放行生成（先起草后确认）',
+    r.status === 0 && fs.existsSync(f) && fs.readFileSync(f, 'utf8').includes('状态: draft'),
+    JSON.stringify({ status: r.status, stderr: r.stderr }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+{
+  // S10c 探索泳道回落：级别缺失、risk_level=L0 → 放行（risk_level 兜底判道）
+  const root = mkws({ 'workflow/intents/2026-09-30-exp0.md': '---\n状态: draft\nrisk_level: L0\n日期: 2026-09-30\n---\n# I\n' });
+  const r = runTool(root, '2026-09-30-exp0', 'L1');
+  check('S10c 探索泳道回落：级别缺失 + risk_level L0 → 放行',
+    r.status === 0 && fs.existsSync(path.join(root, 'workflow', 'plans', '2026-09-30-exp0.md')),
+    JSON.stringify({ status: r.status, stderr: r.stderr }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+{
+  // S10d 探索泳道边界：级别 L2 合法时 risk_level L0 不回落 → 仍拒（fail-closed 就严）
+  const root = mkws({ 'workflow/intents/2026-09-30-expd.md': '---\n状态: draft\n级别: L2\nrisk_level: L0\n日期: 2026-09-30\n---\n# I\n' });
+  const r = runTool(root, '2026-09-30-expd', 'L1');
+  check('S10d 探索泳道边界：级别 L2（risk_level L0 不回落）→ 仍拒',
+    r.status === 2 && /状态「draft」/.test(r.stderr),
+    JSON.stringify({ status: r.status, stderr: r.stderr }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+{
+  // 门禁后入口（日期 ≥ 生效日）须有台账行——夹具补 confirmed 行，才触达「缺 spec」分支
+  const root = mkws({ 'workflow/intents/2026-09-30-l2.md': `---\n状态: approved\n级别: L2\n日期: 2026-09-30\n确认指纹: ${'7'.repeat(16)}\n---\n# I\n` });
+  fs.mkdirSync(path.join(root, '.agents'), { recursive: true });
+  fs.writeFileSync(path.join(root, '.agents', 'confirmations.jsonl'), JSON.stringify({ ts: '2026-09-30T05:00:00.000Z', doc: 'workflow/intents/2026-09-30-l2.md', stage: 'approved', fingerprint: '7'.repeat(64), prev: 'draft', source: 'chat-delegated', batch: 'l2', seq: 1, of: 1 }) + '\n');
+  const r = runTool(root, '2026-09-30-l2', 'L2');
+  check('S11 起草门：L2 入口已确认但缺同名 spec → exit 2 + 缺 spec 提示',
+    r.status === 2 && /缺同名 spec/.test(r.stderr),
+    JSON.stringify({ status: r.status, stderr: r.stderr }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+{
+  const root = mkws({
+    'workflow/intents/2026-09-30-l2b.md': '---\n状态: approved\n级别: L2\n日期: 2026-01-01\n---\n# I\n',
+    'workflow/specs/2026-09-30-l2b.md': '---\n状态: approved\n级别: L2\n日期: 2026-01-01\n---\n# S\n',
+  });
+  const r = runTool(root, '2026-09-30-l2b', 'L2');
+  const f = path.join(root, 'workflow', 'plans', '2026-09-30-l2b.md');
+  check('S12 起草门：L2 入口 + spec 均已确认（存量口径）→ 放行生成',
+    r.status === 0 && fs.existsSync(f),
+    JSON.stringify({ status: r.status, stderr: r.stderr }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+{
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'fill-plan-scratch-'));
+  const out = path.join(root, 'x.md');
+  const r = spawnSync(process.execPath, [CLI, '--topic', 'x', '--output', out], { cwd: root, encoding: 'utf8' });
+  check('S13 起草门：仓外草稿（无 workflow 段）→ 不拦 + 提示',
+    r.status === 0 && fs.existsSync(out) && /仓外草稿/.test(r.stderr),
+    JSON.stringify({ status: r.status, stderr: r.stderr }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+
+{
+  // 场景 14：级别取入口 frontmatter（非 --level）——**门禁后入口 + 台账行**（早日期会走存量短路，
+  // 绕过级别取值逻辑；第三轮复核 P2-2 订正夹具）
+  const root = mkws({
+    'workflow/intents/2026-09-30-lv.md': `---\n状态: approved\n级别: L2\n日期: 2026-09-30\n确认指纹: ${'a'.repeat(16)}\n---\n# I\n`,
+    'workflow/specs/2026-09-30-lv.md': `---\n状态: approved\n级别: L2\n日期: 2026-09-30\n确认指纹: ${'b'.repeat(16)}\n---\n# S\n`,
+  });
+  fs.mkdirSync(path.join(root, '.agents'), { recursive: true });
+  const led = (doc, fp) => JSON.stringify({ ts: '2026-09-30T06:00:00.000Z', doc, stage: 'approved', fingerprint: fp, prev: 'draft', source: 'chat-delegated', batch: 'lv', seq: 1, of: 1 }) + '\n';
+  fs.writeFileSync(path.join(root, '.agents', 'confirmations.jsonl'),
+    led('workflow/intents/2026-09-30-lv.md', 'a'.repeat(64)) + led('workflow/specs/2026-09-30-lv.md', 'b'.repeat(64)));
+  const r = runTool(root, '2026-09-30-lv', 'L1');
+  check('S14 级别取入口 frontmatter：入口 L2（台账行）+ spec 确认 → 传 --level L1 仍放行（不弱化前置）',
+    r.status === 0,
+    JSON.stringify({ status: r.status, stderr: r.stderr }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+{
+  // 场景 15：入口 L1（门禁后 + 台账行）+ 传 --level L2 → 免 spec 档（级别以入口为准）
+  const root = mkws({ 'workflow/intents/2026-09-30-lv2.md': `---\n状态: approved\n级别: L1\n日期: 2026-09-30\n确认指纹: ${'c'.repeat(16)}\n---\n# I\n` });
+  fs.mkdirSync(path.join(root, '.agents'), { recursive: true });
+  fs.writeFileSync(path.join(root, '.agents', 'confirmations.jsonl'), JSON.stringify({ ts: '2026-09-30T06:10:00.000Z', doc: 'workflow/intents/2026-09-30-lv2.md', stage: 'approved', fingerprint: 'c'.repeat(64), prev: 'draft', source: 'chat-delegated', batch: 'lv2', seq: 1, of: 1 }) + '\n');
+  const r = runTool(root, '2026-09-30-lv2', 'L2');
+  check('S15 级别取入口 frontmatter：入口 L1 → 传 --level L2 不索要 spec、放行',
+    r.status === 0,
+    JSON.stringify({ status: r.status, stderr: r.stderr }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+
 console.log('\n合计: PASS ' + pass + ' / FAIL ' + failCount);
 process.exit(failCount ? 1 : 0);

package/templates/_agents/scripts/fill-spec.mjs

@@ -1,20 +1,24 @@
 // flow-kit fill-spec：起草 spec 草稿（功能行为 / 数据流 / 系统改动 / 约束遵守映射 / 风险评估 共 5 节）
-// 用法：node .agents/scripts/fill-spec.mjs --topic "test" --output /tmp/x.md
+// 用法：node .agents/scripts/fill-spec.mjs --topic "test" --output /tmp/x.md [--root <仓库根>]
+// 起草门（2026-09-30 stage-gate-machine）：output 落于工作区（路径含 workflow 段）时，须同主题入口已确认
+// （判定口径见 stage-gates.mjs）；未过 → 拒绝生成（exit 2）；仓外草稿（无 workflow 段）不校验。
 import fs from 'node:fs';
 import path from 'node:path';
 import { ENUMS } from './workflow-enums.mjs';
+import { draftGateFor, resolveWorkspace } from './stage-gates.mjs';
 
 const TODAY = new Date().toISOString().slice(0, 10);
 const LEVELS = ENUMS['level.all']; // 级别词表单源（.agents/workflow-enums.txt）
 
 function parseArgs(argv) {
-  const out = { topic: null, level: 'L2', output: null };
+  const out = { topic: null, level: 'L2', output: null, root: null };
   for (let i = 0; i < argv.length; i++) {
     const a = argv[i];
     const next = () => { const v = argv[++i]; if (v === undefined) return null; return v; };
     if (a === '--topic') out.topic = next();
     else if (a === '--level') out.level = next();
     else if (a === '--output') out.output = next();
+    else if (a === '--root') out.root = next();
   }
   return out;
 }
@@ -43,8 +47,19 @@ export function renderSpec({ topic, level = 'L2', date = TODAY }) {
 const isMain = import.meta.url === `file:///${process.argv[1]}` || process.argv[1]?.endsWith('fill-spec.mjs');
 if (isMain) {
   const a = parseArgs(process.argv.slice(2));
-  if (!a.topic || !a.output) fail('必填：--topic / --output；选填：--level（默认 L2）');
+  if (!a.topic || !a.output) fail('必填：--topic / --output；选填：--level（默认 L2）/ --root');
   if (!LEVELS.includes(a.level)) fail(`level 必须在 ${LEVELS.join('|')}：${a.level}`);
+  const ws = resolveWorkspace(a.output, a.root);
+  if (ws) {
+    const gate = draftGateFor('spec', ws.root, ws.base);
+    if (!gate.ok) {
+      console.error(`❌ 起草门未过（stage-gates）：${gate.reason}`);
+      console.error(`   ${gate.hint}——本份未生成（确认入口后重跑本命令）`);
+      process.exit(2);
+    }
+  } else {
+    console.error('ℹ️  未定位到工作区（output 路径不含 workflow/ 段）——按仓外草稿处理，跳过起草门前置校验');
+  }
   const { body } = renderSpec(a);
   fs.mkdirSync(path.dirname(a.output), { recursive: true });
   fs.writeFileSync(a.output, body);

package/templates/_agents/scripts/fill-spec.test.mjs

@@ -1,4 +1,9 @@
-// fill-spec.test.mjs — fill-spec 工具测试（2026-09-25 doc-fill-tools）
+// fill-spec.test.mjs — fill-spec 工具测试（2026-09-25 doc-fill-tools；2026-09-30 stage-gate-machine 补起草门场景）
+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';
 import { renderSpec } from './fill-spec.mjs';
 
 let pass = 0, failCount = 0;
@@ -57,5 +62,197 @@ function check(name, cond, detail = '') {
   check('S7 L3 节确认与复核含独立复核提示', body.includes('L3 必须独立复核'));
 }
 
+// ---- 场景 8-13：起草门（2026-09-30 stage-gate-machine）——output 落于工作区时须同主题入口已确认 ----
+const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
+const CLI = path.join(SCRIPT_DIR, 'fill-spec.mjs');
+const mkws = ({ entryFile = null, entryBody = null } = {}) => {
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'fill-spec-gate-'));
+  fs.mkdirSync(path.join(root, 'workflow', 'specs'), { recursive: true });
+  if (entryFile) {
+    fs.mkdirSync(path.join(root, 'workflow', entryFile.split('/')[0]), { recursive: true });
+    fs.writeFileSync(path.join(root, 'workflow', entryFile), entryBody);
+  }
+  return root;
+};
+const runTool = (root, base) => spawnSync(process.execPath,
+  [CLI, '--topic', base, '--output', path.join(root, 'workflow', 'specs', `${base}.md`)],
+  { cwd: root, encoding: 'utf8' });
+{
+  const root = mkws();
+  const r = runTool(root, '2026-09-30-none');
+  check('S8 起草门：无同名入口 → exit 2 且零文件产出',
+    r.status === 2 && /起草门未过/.test(r.stderr) && !fs.existsSync(path.join(root, 'workflow', 'specs', '2026-09-30-none.md')),
+    JSON.stringify({ status: r.status, stderr: r.stderr }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+{
+  const root = mkws({ entryFile: 'intents/2026-09-30-draft.md', entryBody: '---\n状态: draft\n级别: L2\n日期: 2026-09-30\n---\n# I\n' });
+  const r = runTool(root, '2026-09-30-draft');
+  check('S9 起草门：入口 draft → exit 2 + 提示状态',
+    r.status === 2 && /状态「draft」/.test(r.stderr),
+    JSON.stringify({ status: r.status, stderr: r.stderr }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+{
+  // S9b 探索泳道（2026-09-30 hybrid-governance-explore-hardening）：L0/L1 draft intent → 放行 spec 起草
+  // （「先起草后确认」；L2/L3 防御道维持入口确认前置——S9 照旧）
+  const root = mkws({ entryFile: 'intents/2026-09-30-exp.md', entryBody: '---\n状态: draft\n级别: L1\nrisk_level: L1\n日期: 2026-09-30\n---\n# I\n' });
+  const r = runTool(root, '2026-09-30-exp');
+  const f = path.join(root, 'workflow', 'specs', '2026-09-30-exp.md');
+  check('S9b 探索泳道：L1 入口 draft → 放行 spec 起草（先起草后确认）',
+    r.status === 0 && fs.existsSync(f) && fs.readFileSync(f, 'utf8').includes('状态: draft'),
+    JSON.stringify({ status: r.status, stderr: r.stderr }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+{
+  const root = mkws({ entryFile: 'intents/2026-09-30-ok.md', entryBody: '---\n状态: approved\n级别: L1\n日期: 2026-01-01\n---\n# I\n' });
+  const r = runTool(root, '2026-09-30-ok');
+  const f = path.join(root, 'workflow', 'specs', '2026-09-30-ok.md');
+  check('S10 起草门：入口 approved（存量口径）→ 放行生成',
+    r.status === 0 && fs.existsSync(f) && fs.readFileSync(f, 'utf8').includes('状态: draft'),
+    JSON.stringify({ status: r.status, stderr: r.stderr }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+{
+  const root = mkws({ entryFile: 'incidents/2026-09-30-inc.md', entryBody: '---\n状态: open\n级别: L2\n---\n# I\n\n## 时间线\n- 用户确认：过目\n' });
+  const r = runTool(root, '2026-09-30-inc');
+  check('S11 起草门：incident 入口（open + 用户确认留痕）→ 放行',
+    r.status === 0,
+    JSON.stringify({ status: r.status, stderr: r.stderr }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+{
+  const root = mkws({ entryFile: 'incidents/2026-09-30-inc2.md', entryBody: '---\n状态: open\n级别: L2\n---\n# I\n' });
+  const r = runTool(root, '2026-09-30-inc2');
+  check('S12 起草门：incident 缺「用户确认」留痕 → exit 2',
+    r.status === 2 && /未过目确认/.test(r.stderr),
+    JSON.stringify({ status: r.status, stderr: r.stderr }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+{
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'fill-spec-scratch-'));
+  const out = path.join(root, 'x.md');
+  const r = spawnSync(process.execPath, [CLI, '--topic', 'x', '--output', out], { cwd: root, encoding: 'utf8' });
+  check('S13 起草门：仓外草稿（无 workflow 段）→ 不拦 + 提示',
+    r.status === 0 && fs.existsSync(out) && /仓外草稿/.test(r.stderr),
+    JSON.stringify({ status: r.status, stderr: r.stderr }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+
+{
+  // 场景 14：入口 approved 但无台账行且日期 ≥ confirmDocsEffective → 拒（防手改状态冒充；复核 P2-4③）
+  const root = mkws({ entryFile: 'intents/2026-09-30-fake.md', entryBody: '---\n状态: approved\n级别: L1\n日期: 2026-09-30\n---\n# I\n' });
+  const r = runTool(root, '2026-09-30-fake');
+  check('S14 起草门：入口 approved 但无台账行（日期 ≥ 生效日）→ exit 2',
+    r.status === 2 && /无确认台账行/.test(r.stderr),
+    JSON.stringify({ status: r.status, stderr: r.stderr }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+
+{
+  // N1（2026-09-30 增量复核）：存量入口短路优先于级别校验——`流程: legacy` + 无级别 → 放行（不锁死）
+  const root = mkws({ entryFile: 'intents/2026-09-30-leg.md', entryBody: '---\n状态: approved\n日期: 2026-01-01\n流程: legacy\n---\n# I（存量、无级别）\n' });
+  const r = runTool(root, '2026-09-30-leg');
+  check('S15 存量短路：legacy 入口缺级别 → 放行（不被 fail-closed 锁死）',
+    r.status === 0 && fs.existsSync(path.join(root, 'workflow', 'specs', '2026-09-30-leg.md')),
+    JSON.stringify({ status: r.status, stderr: r.stderr }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+{
+  // 对照：门禁后入口（日期 ≥ 生效日）+ **台账行**（第三轮复核 P1-2 订正：原夹具无台账行，
+  // 被上游「无确认台账行」拦下，从未进入级别校验——假绿）→ 须停在「缺合法级别」分支
+  const root = mkws({ entryFile: 'intents/2026-09-30-nolev.md', entryBody: `---\n状态: approved\n日期: 2026-09-30\n确认指纹: ${'d'.repeat(16)}\n---\n# I（门禁后、无级别）\n` });
+  fs.mkdirSync(path.join(root, '.agents'), { recursive: true });
+  fs.writeFileSync(path.join(root, '.agents', 'confirmations.jsonl'), JSON.stringify({ ts: '2026-09-30T07:00:00.000Z', doc: 'workflow/intents/2026-09-30-nolev.md', stage: 'approved', fingerprint: 'd'.repeat(64), prev: 'draft', source: 'chat-delegated', batch: 'nl', seq: 1, of: 1 }) + '\n');
+  const r = runTool(root, '2026-09-30-nolev');
+  check('S16 门禁后入口缺级别 → 拒，且理由为「缺合法级别」（断言理由 + 零产出，防上游分支/无关失败冒充）',
+    r.status === 2 && /缺合法「级别」字段/.test(r.stderr) && !fs.existsSync(path.join(root, 'workflow', 'specs', '2026-09-30-nolev.md')),
+    JSON.stringify({ status: r.status, stderr: r.stderr }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+{
+  // N2 回归（第三轮复核 P1-1）：模板时间线样例行必须真实可解析——照抄模板即应通过 incident 留痕判定
+  const tpl = fs.readFileSync(path.join(SCRIPT_DIR, '..', '..', 'workflow', 'incidents', '_TEMPLATE.md'), 'utf8');
+  const sample = tpl.split(/\r?\n/).find((l) => /^\s*[-*].*用户确认/.test(l)) || '';
+  const root = mkws({ entryFile: 'incidents/2026-09-30-tpl.md', entryBody: `---\n状态: open\n级别: L1\n---\n# I\n\n## 时间线\n${sample}\n` });
+  const r = runTool(root, '2026-09-30-tpl');
+  check('S18 模板样例可解析：照抄 _TEMPLATE.md 时间线样例行 → incident 入口放行',
+    r.status === 0 && sample !== '',
+    JSON.stringify({ status: r.status, sample, stderr: r.stderr }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+
+{
+  // 负例（第三轮复核 P1-1 放宽前缀后实证的假阳性）：叙述句即便带标准日期前缀也不算过目留痕
+  const variants = ['- 2026-09-30 用户确认了方案（叙述）', '- 用户确认书已归档', '- <日期> 用户确认过细节'];
+  const results = variants.map((line) => {
+    const root = mkws({ entryFile: 'incidents/2026-09-30-neg.md', entryBody: `---\n状态: open\n级别: L1\n---\n# I\n\n## 时间线\n${line}\n` });
+    const r = runTool(root, '2026-09-30-neg');
+    fs.rmSync(root, { recursive: true, force: true });
+    return { line, status: r.status, stderr: r.stderr };
+  });
+  check('S19 负例：叙述句（含日期前缀）不算过目留痕 → 仍拒',
+    results.every((x) => x.status === 2 && /未过目确认/.test(x.stderr)),
+    JSON.stringify(results));
+}
+{
+  // 正面对照：既通过门、又产出文件——防「无关失败误绿」
+  const tpl = fs.readFileSync(path.join(SCRIPT_DIR, '..', '..', 'workflow', 'incidents', '_TEMPLATE.md'), 'utf8');
+  const sample = tpl.split(/\r?\n/).find((l) => /^\s*[-*].*用户确认/.test(l)) || '';
+  const root = mkws({ entryFile: 'incidents/2026-09-30-tpl2.md', entryBody: `---\n状态: open\n级别: L1\n---\n# I\n\n## 时间线\n${sample}\n` });
+  const r = runTool(root, '2026-09-30-tpl2');
+  const out = path.join(root, 'workflow', 'specs', '2026-09-30-tpl2.md');
+  check('S20 模板样例可解析（正面对照：exit 0 且产出 draft 文件）',
+    r.status === 0 && sample !== '' && fs.existsSync(out) && fs.readFileSync(out, 'utf8').includes('状态: draft'),
+    JSON.stringify({ status: r.status, sample, exists: fs.existsSync(out), stderr: r.stderr }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+{
+  // N1 存量短路（spec 档）——plan 门本体由 fill-plan.test / confirm-doc.test 覆盖
+  const root = mkws({ entryFile: 'intents/2026-09-30-legp.md', entryBody: '---\n状态: approved\n日期: 2026-01-01\n流程: legacy\n---\n# I（存量、无级别）\n' });
+  const r = runTool(root, '2026-09-30-legp');
+  check('S17 存量短路（spec 档）：legacy 入口无级别 → 放行生成',
+    r.status === 0 && fs.existsSync(path.join(root, 'workflow', 'specs', '2026-09-30-legp.md')),
+    JSON.stringify({ status: r.status, stderr: r.stderr }));
+  fs.rmSync(root, { recursive: true, force: true });
+}
+
+// ---- 形态矩阵（2026-09-30 四/五轮复核收敛）：8 正例 + 5 负例一次性钉死 ----
+// 每轮补丁式改正则都只修一半（放宽前缀 → 叙述句假阳性；加词边界 → 加粗围栏假阴性），故穷举形态：
+// 任何后续正则改动若破坏任一正例或放行任一负例，本矩阵立即翻红。
+{
+  const POSITIVE = [
+    '- 用户确认：草稿过目通过',
+    '- **用户确认**：草稿过目通过',
+    '- 2026-09-30 用户确认：草稿过目通过',
+    '- <日期> 用户确认：草稿过目通过',
+    '- 2026-09-30 **用户确认**：草稿过目通过',
+    '- <日期> **用户确认**：草稿过目通过',
+    '- 用户确认',
+    '- **用户确认**',
+  ];
+  const NEGATIVE = [
+    '- 2026-09-30 用户确认了方案（叙述）',
+    '- 用户确认书已归档',
+    '- <日期> 用户确认过细节',
+    '- 用户确认。',
+    '- 待用户确认：稍后处理',
+  ];
+  const run = (line) => {
+    const root = mkws({ entryFile: 'incidents/2026-09-30-mx.md', entryBody: `---\n状态: open\n级别: L1\n---\n# I\n\n## 时间线\n${line}\n` });
+    const r = runTool(root, '2026-09-30-mx');
+    fs.rmSync(root, { recursive: true, force: true });
+    return r.status;
+  };
+  const posBad = POSITIVE.filter((l) => run(l) !== 0);
+  const negBad = NEGATIVE.filter((l) => run(l) !== 2);
+  check('S21 形态矩阵·正例全放行（8 形态，含词前/词后加粗围栏）[须与 S22 负例配对——单条不承重]',
+    posBad.length === 0,
+    JSON.stringify({ failedLines: posBad }));
+  check('S22 形态矩阵·负例全拒绝（5 形态，叙述/无冒号/待办前缀）[须与 S21 正例配对——单条不承重]',
+    negBad.length === 0,
+    JSON.stringify({ failedLines: negBad }));
+}
+
 console.log('\n合计: PASS ' + pass + ' / FAIL ' + failCount);
 process.exit(failCount ? 1 : 0);

package/templates/_agents/scripts/gate-checklist.mjs

@@ -61,7 +61,7 @@ const PAIRS = [
   { doctor: '3', cl: null, note: 'git 仓库与钩子——装户体检独有' },
   { doctor: '4', cl: null, note: 'kit.json managed 台账——装户体检独有' },
   { doctor: '4.5', cl: null, note: '台账覆盖率——装户体检独有（盘上有 managed 类文件未登记，2026-09-26 managed-ledger-adopt）' },
-  { doctor: '6.5', cl: null, note: 'delegations 台账结构——装户体检独有' },
+  { doctor: '6.5', cl: null, note: 'delegations 台账结构 + 快照新鲜度——装户体检独有' },
   { doctor: '6.6', cl: null, note: 'owned 漂移——装户体检独有' },
   { doctor: '6.7', cl: null, note: '跨宿主薄适配——装户体检独有' },
   { doctor: '6.8', cl: null, note: 'workflows 编排脚本 lint——装户体检独有' },
@@ -81,6 +81,9 @@ const PAIRS = [
   { doctor: '7', cl: '14', note: '经 §7 整体运行覆盖' },
   { doctor: '7', cl: '15', note: '经 §7 整体运行覆盖' },
   { doctor: '7', cl: '16', note: '经 §7 整体运行覆盖（量化断言指标签名对账，2026-09-28 claim-exceeds-fix）' },
+  { doctor: '7', cl: '17', note: '经 §7 整体运行覆盖（发版提交树上仍未收口的 intent/spec/plan）' },
+  { doctor: '7', cl: '18', note: '经 §7 整体运行覆盖（委派台账对账）' },
+  { doctor: '7', cl: '19', note: '经 §7 整体运行覆盖（逐阶段审计——起草先于入口确认 / 台账审批顺序倒置）' },
 ];
 
 // gateChecklist：按登记表对照两侧检查项（pure function；pairs 可注入供测试）

package/templates/_agents/scripts/gen-workflow-index.mjs

@@ -177,8 +177,12 @@ function previewDiff(before, after) {
   if (added.length > 10) console.log(`    + …（其余 ${added.length - 10} 行略）`);
 }
 
+// 行尾归一比较（2026-09-30：fresh clone 检出 CRLF、生成段恒 LF——直接字符串相等会在克隆环境假阳性
+// 「漂移」（doctor §6 与 check-loop 检查 11 均经 --check 判定）；仅内容差异才算漂移）
+const normEol = (s) => String(s).replace(/\r\n/g, '\n');
+
 if (CHECK) {
-  if (out === existing) {
+  if (normEol(out) === normEol(existing)) {
     console.log(`✅ workflow/INDEX.md 与磁盘一致（${summary}）`);
     process.exit(0);
   }
@@ -189,7 +193,7 @@ if (CHECK) {
 
 if (DRY) {
   console.log(`🔎 --dry-run：未写盘（${summary}）`);
-  if (out === existing) console.log('• workflow/INDEX.md：无变化');
+  if (normEol(out) === normEol(existing)) console.log('• workflow/INDEX.md：无变化');
   else previewDiff(existing, out);
 } else {
   fs.writeFileSync(INDEX_P, out, 'utf8');

package/templates/_agents/scripts/gen-workflow-index.test.mjs

@@ -85,6 +85,18 @@ const run = (root, args = []) => spawnSync(process.execPath, [GEN, ...args], { c
   fs.rmSync(root, { recursive: true, force: true });
 }
 
+// ---- 场景 2b：CRLF 检出形态（fresh clone）--check 不误报（2026-09-30 行尾归一）----
+{
+  const root = mkfix();
+  run(root);
+  const ip = path.join(root, 'workflow', 'INDEX.md');
+  fs.writeFileSync(ip, fs.readFileSync(ip, 'utf8').replace(/\r\n/g, '\n').replace(/\n/g, '\r\n'), 'utf8');
+  const crlf = run(root, ['--check']);
+  check('场景 2b：INDEX 为 CRLF 检出形态 → --check exit 0（行尾归一，不假阳性）',
+    crlf.status === 0, `exit=${crlf.status}\n${crlf.stdout}${crlf.stderr}`);
+  fs.rmSync(root, { recursive: true, force: true });
+}
+
 // ---- 场景 3：缺 `模块:` 容忍显示 —（不报错、不阻断）----
 {
   const root = mkfix();