agentic-flow-kit 1.1.5 → 1.1.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-flow-kit",
-  "version": "1.1.5",
+  "version": "1.1.7",
   "description": "AI-Native 闭环工作流 + wiki 知识层脚手架——flow-kit init 一条命令为新项目装好 .agents 工作流引擎（阶段命令/角色契约/门禁钩子/kb 检索/看板/规则面预算）+ workflow 文档闭环 + wiki 知识库，装完自包含、零运行时依赖",
   "type": "module",
   "scripts": {

package/templates/_agents/scripts/check-loop.mjs

@@ -382,12 +382,17 @@ for (const plan of docFiles('plans')) {
   // 样例引用豁免（2026-10-02 caliber-convergence 假阳性消除，先例=检查 18 行尾归一）：命中位于行内代码
   // （反引号包裹）或围栏代码块内 = 引用样例而非未填占位符，不报；正文裸占位符照报——真占位符均为
   // 裸文本（模板正文无反引号包裹），检测面不缩。
+  // 日期显示格式豁免（2026-10-06 check2-datetime-literal-exempt）：`YYYY-MM-DD HH:mm(:ss)` 是功能
+  // 自实现的显示格式描述（文档叙述「匹配时间列显示为 YYYY-MM-DD HH:mm」属常态——cancel-export
+  // intent/plan 实证 2 条 advisory、2026-10-06 loop-audit intent 现场复现），非未填占位——行内剔除
+  // 后再判；真占位（`日期: YYYY-MM-DD`，无时间后缀）不含该形态仍拦。只豁免实证形态，变体（斜杠日期
+  // /十二小时制等）出现假阳性再扩。
   const stripSamples = (lines) => {
     let inFence = false;
     return lines.map((line) => {
       if (/^\s*(```|~~~)/.test(line)) { inFence = !inFence; return ''; }
       if (inFence) return '';
-      return line.replace(/`[^`]*`/g, '');
+      return line.replace(/`[^`]*`/g, '').replace(/YYYY-MM-DD\s+HH:mm(:ss)?/g, '');
     });
   };
   const groups = new Map(); // file -> [ "行号:内容" ]（首现序）
@@ -515,7 +520,12 @@ for (const inc of docFiles('incidents')) {
 {
   const cmdFiles = () => (readdirOrNull(path.join(ROOT, '.agents', 'commands')) || [])
     .filter((f) => f.endsWith('.md')).map((f) => `.agents/commands/${f}`);
-  const textOf = (rel) => linesOf(path.join(ROOT, rel)) || [];
+  // existsSync 守卫（2026-10-06-check19-entry-enoent 同类）：AGENTS.md 等可合法缺失（调用方按空数组
+  // 判定本就预期缺失态），fail-loud fs 读下按缺省跳过、不再响亮出账；其余调用方路径另有上游守卫
+  const textOf = (rel) => {
+    const p = path.join(ROOT, rel);
+    return fs.existsSync(p) ? (linesOf(p) || []) : [];
+  };
   for (const role of ['implementer', 'independent-reviewer', 'ui-verifier']) {
     const rolePath = `.agents/roles/${role}.md`;
     if (!fs.existsSync(path.join(ROOT, rolePath))) {
@@ -567,7 +577,10 @@ for (const inc of docFiles('incidents')) {
 // --- 6. 阶段索引同步 [warning] ---
 for (const cmd of ['plan', 'design', 'build', 'test', 'deploy', 'maintain', 'review']) {
   for (const doc of ['AGENTS.md', '.agents/commands/new-task.md']) {
-    const text = linesOf(path.join(ROOT, doc));
+    // existsSync 守卫（2026-10-06-check19-entry-enoent 同类）：两文件可合法缺失（下方 text 判空本就
+    // 预期缺失态），fail-loud fs 读下按空跳过、不再响亮出账
+    const docPath = path.join(ROOT, doc);
+    const text = fs.existsSync(docPath) ? linesOf(docPath) : null;
     if (text && !text.some((l) => l.includes(`.agents/commands/${cmd}.md`))) {
       warnings.push(`- [WARN 阶段索引漂移] ${doc} 缺 ${cmd} 指令索引(两处阶段表须同步维护)`);
     }
@@ -1204,7 +1217,12 @@ runCheck16({ ROOT, ENUMS, docFiles, fmGet, inSet, isTracked, linesOf, readdirOrN
       // 协作道豁免（2026-09-30 hybrid-governance-risk-lanes）：入口 L0/L1 的审批顺序倒置（如 plan 先于
       // intent approved——「动手后确认」）是异步审计泳道语义，非流程违规；入口文件缺失（纯台账历史行 /
       // incident 侧）不豁免，维持既有判据。
-      const ilvlB = fmGet(path.join(ROOT, WF, 'intents', `${base}.md`), '级别');
+      // existsSync 守卫（2026-10-06-check19-entry-enoent）：incident 闭环主题无同名 intent，「读空判级」
+      // 惯用法（缺文件→级别空→不豁免，判定面不变）在 fail-loud fs 读（2026-10-05-gitout-fail-open）下
+      // 每次推送响亮出账 N 条 ENOENT 噪声——守卫跳过读取，语义与上注释一致；同款先例 entryConfirmed19
+      // 与下方 spec 读取。
+      const iabsB = path.join(ROOT, WF, 'intents', `${base}.md`);
+      const ilvlB = fs.existsSync(iabsB) ? fmGet(iabsB, '级别') : '';
       if (ilvlB === 'L0' || ilvlB === 'L1') continue;
       const earliest = seq.map((k) => rec[k]).sort()[0];
       if (!(earliest.slice(0, 10) >= since)) continue;

package/templates/_agents/scripts/check-loop.test.mjs

@@ -813,6 +813,28 @@ check('检查2 plan 真实未填占位（日期: YYYY-MM-DD）→ 仍报模板
   r2.status === 0 && outOf(r2).includes('模板未填'), `exit=${r2.status}\n${outOf(r2)}`);
 rmfix(T);
 }
+// ---- 场景 45c:检查 2——日期显示格式字面量豁免；纯占位仍报（2026-10-06 check2-datetime-literal-exempt）----
+// 日期取 2026-09-26（< 确认门 v1 锚 2026-09-27，豁免检查 15 存量面——沿 5x 块先例），避免 hard 干扰本断言
+{
+const T = mkfix();
+w(T, 'workflow/intents/2026-09-26-dt1.md', INTENT('dt1', '状态: done\n级别: L1\n日期: 2026-09-26',
+  '\n匹配时间列格式简化为 YYYY-MM-DD HH:mm；同款括号形态（YYYY-MM-DD HH:mm）与秒级 YYYY-MM-DD HH:mm:ss 均为格式描述。\n'));
+w(T, 'workflow/plans/2026-09-26-dt1.md', PLAN('dt1', '状态: done\n级别: L1'));
+const r1 = run(T);
+check('检查2 裸写 YYYY-MM-DD HH:mm(:ss) 显示格式描述 → 不报模板未填',
+  r1.status === 0 && !outOf(r1).includes('模板未填'), `exit=${r1.status}\n${outOf(r1)}`);
+rmfix(T);
+}
+{
+const T = mkfix();
+w(T, 'workflow/intents/2026-09-26-dt2.md', INTENT('dt2', '状态: done\n级别: L1\n日期: 2026-09-26',
+  '\n匹配时间列格式简化为 YYYY-MM-DD HH:mm（合法格式描述）；另有真占位 日期: YYYY-MM-DD 在同文档。\n'));
+w(T, 'workflow/plans/2026-09-26-dt2.md', PLAN('dt2', '状态: done\n级别: L1', '\n- 日期: YYYY-MM-DD\n'));
+const r2 = run(T);
+check('检查2 同文档混真占位（无时间后缀）→ 格式描述豁免不吞真占位，仍报',
+  r2.status === 0 && outOf(r2).includes('模板未填'), `exit=${r2.status}\n${outOf(r2)}`);
+rmfix(T);
+}
 // ---- 场景 46:检查 6——薄适配正文含 .agents/roles/<role>.md 引用 → 不报 Adapter 断线 ----
 {
   const T = mkfix();
@@ -2614,5 +2636,31 @@ w(T, 'workflow/intents/2026-09-12-deep.md', INTENT('deep', '状态: draft\n级
   rmfix(T);
 }
 
+// ---- 场景:检查 19 判据 B——台账 approved 行在、入口 intent 缺件（incident 闭环主题）→ 无 ENOENT 出账，顺序判定不放松（2026-10-06-check19-entry-enoent）----
+{
+  const ledgerRows = (specTs, planTs) => [
+    { doc: 'workflow/specs/2026-10-06-noent.md', stage: 'approved', ts: specTs },
+    { doc: 'workflow/plans/2026-10-06-noent.md', stage: 'approved', ts: planTs },
+  ];
+  // ① 顺序合规（specs 先于 plans）：exit 0，且裸 fixture 全程无「文档读取异常（ENOENT）」出账——
+  //    修复前「读空判级」惯用法在 fail-loud fs 读下对缺件主题每次响亮出账（实仓 12 条/推送）；
+  //    同类读空点（AGENTS.md / new-task.md，检查 6）一并被裸 fixture 钉住
+  const T = mkfix();
+  w(T, '.agents/kit.json', JSON.stringify({ policyVersion: 2 }));
+  writeLedger(T, ledgerRows('2026-10-06T10:00:00Z', '2026-10-06T11:00:00Z'));
+  let r = run(T);
+  check('检查 19 判据 B:入口 intent 缺件 → 无 ENOENT 噪声且 exit 0',
+    r.status === 0 && !outOf(r).includes('文档读取异常'), `exit=${r.status}\n${outOf(r)}`);
+  rmfix(T);
+  // ② 顺序倒置（plans 先于 specs）：入口缺件不豁免，照报「审批顺序倒置」——守卫不放松判定
+  const T2 = mkfix();
+  w(T2, '.agents/kit.json', JSON.stringify({ policyVersion: 2 }));
+  writeLedger(T2, ledgerRows('2026-10-06T11:00:00Z', '2026-10-06T10:00:00Z'));
+  r = run(T2);
+  check('检查 19 判据 B:入口 intent 缺件 → 顺序倒置照报（守卫不放松判定）',
+    r.status === 0 && outOf(r).includes('审批顺序倒置'), `exit=${r.status}\n${outOf(r)}`);
+  rmfix(T2);
+}
+
 console.log(`\n合计: PASS ${pass} / FAIL ${fail}`);
 process.exit(fail ? 1 : 0);