agentic-flow-kit 1.4.0 → 1.5.0

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

@@ -0,0 +1,63 @@
+// pipeline-run-run.mjs — run 存储层（2026-10-08 engine-quality-batch，L2 自 pipeline-run.mjs 拆出）
+// ctxEnv / moduleList / runFileOf / loadRun / saveRun / emit / latestRunId / newRunId + 时间工具（nowIso/today/pad）——
+// run 文件（.agents/cache/pipeline-runs/<id>.json）原子读写与事件流；run schema 零变化。
+// 测试注入契约原样：PIPELINE_RUN_ROOT / PIPELINE_RUN_BIN / PIPELINE_RUN_GIT_BIN（ctxEnv）与
+// PIPELINE_RUN_TODAY（today——时钟依赖消除锚，spec §测试注入契约）。
+import fs from 'node:fs';
+import path from 'node:path';
+
+export const nowIso = () => new Date().toISOString();
+export const today = () => process.env.PIPELINE_RUN_TODAY || nowIso().slice(0, 10);
+export const pad = (n) => String(n).padStart(2, '0');
+
+// ── 环境解析（测试注入点） ─────────────────────────────────────────────
+export function ctxEnv(overrideRoot) {
+  const root = path.resolve(overrideRoot || process.env.PIPELINE_RUN_ROOT || process.cwd());
+  const bin = path.resolve(process.env.PIPELINE_RUN_BIN || path.join(root, '.agents', 'scripts'));
+  const gitPrefix = (process.env.PIPELINE_RUN_GIT_BIN || 'git').split(/\s+/).filter(Boolean);
+  return { root, bin, gitPrefix, runsDir: path.join(root, '.agents', 'cache', 'pipeline-runs') };
+}
+
+export function moduleList(ctx) {
+  try {
+    return fs.readFileSync(path.join(ctx.root, '.agents', 'workflow-modules.txt'), 'utf8')
+      .split(/\r?\n/).map((l) => l.trim()).filter((l) => l && !l.startsWith('#'));
+  } catch { return ['backend', 'frontend', 'ui', 'infra', 'integration', 'pipeline', 'wiki']; } // 夹具缺表时的回退默认（warning 由调用方打）
+}
+
+// ── run 文件（原子写；事件 append-only） ──────────────────────────────
+export function runFileOf(ctx, runId) { return path.join(ctx.runsDir, `${runId}.json`); }
+
+export function loadRun(ctx, runId) {
+  const f = runFileOf(ctx, runId);
+  if (!fs.existsSync(f)) return null;
+  try { return JSON.parse(fs.readFileSync(f, 'utf8')); } catch { return null; }
+}
+
+export function saveRun(ctx, run) {
+  fs.mkdirSync(ctx.runsDir, { recursive: true });
+  run.updatedAt = nowIso();
+  const f = runFileOf(ctx, run.runId);
+  const tmp = f + '.tmp';
+  fs.writeFileSync(tmp, JSON.stringify(run, null, 2) + '\n');
+  fs.renameSync(tmp, f);
+}
+
+export function emit(run, ev) { run.events.push({ t: nowIso(), ...ev }); }
+
+export function latestRunId(ctx) {
+  if (!fs.existsSync(ctx.runsDir)) return null;
+  const ids = fs.readdirSync(ctx.runsDir).filter((f) => f.endsWith('.json')).map((f) => f.slice(0, -5)).sort();
+  for (let i = ids.length - 1; i >= 0; i--) {
+    const r = loadRun(ctx, ids[i]);
+    if (r && !['done', 'aborted'].includes(r.stopType)) return ids[i];
+  }
+  return ids[ids.length - 1] || null;
+}
+
+export function newRunId(requirement) {
+  const d = new Date();
+  const ascii = (requirement.toLowerCase().match(/[a-z0-9]{2,}/g) || []).slice(0, 3).join('-') || 'task';
+  const rand = Math.random().toString(36).slice(2, 6);
+  return `${d.getFullYear()}${pad(d.getMonth() + 1)}${pad(d.getDate())}-${pad(d.getHours())}${pad(d.getMinutes())}-${ascii}-${rand}`;
+}

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

@@ -19,9 +19,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { spawnSync } from 'node:child_process';
-import { fileURLToPath } from 'node:url';
 
-const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
 const KINDS = ['require', 'fix', 'verify', 'review', 'deploy'];
 const LEVELS = ['L0', 'L1', 'L2', 'L3'];
 const TERMINAL = ['done', 'superseded', 'cancelled', 'closed'];
@@ -29,61 +27,13 @@ const FIX_CAP = 3;
 const GIT_NEVER_FLAGS = ['--no-verify', '-n']; // 不变量：任何 git 调用不得携带（防御性断言，正常路径不会拼出）
 
 function fail(msg, code = 1) { console.error('❌ ' + msg); process.exit(code); }
-const nowIso = () => new Date().toISOString();
-const today = () => process.env.PIPELINE_RUN_TODAY || nowIso().slice(0, 10);
-const pad = (n) => String(n).padStart(2, '0');
-
-// ── 环境解析（测试注入点） ─────────────────────────────────────────────
-function ctxEnv(overrideRoot) {
-  const root = path.resolve(overrideRoot || process.env.PIPELINE_RUN_ROOT || process.cwd());
-  const bin = path.resolve(process.env.PIPELINE_RUN_BIN || path.join(root, '.agents', 'scripts'));
-  const gitPrefix = (process.env.PIPELINE_RUN_GIT_BIN || 'git').split(/\s+/).filter(Boolean);
-  return { root, bin, gitPrefix, runsDir: path.join(root, '.agents', 'cache', 'pipeline-runs') };
-}
-
-function moduleList(ctx) {
-  try {
-    return fs.readFileSync(path.join(ctx.root, '.agents', 'workflow-modules.txt'), 'utf8')
-      .split(/\r?\n/).map((l) => l.trim()).filter((l) => l && !l.startsWith('#'));
-  } catch { return ['backend', 'frontend', 'ui', 'infra', 'integration', 'pipeline', 'wiki']; } // 夹具缺表时的回退默认（warning 由调用方打）
-}
 
-// ── run 文件（原子写；事件 append-only） ──────────────────────────────
-function runFileOf(ctx, runId) { return path.join(ctx.runsDir, `${runId}.json`); }
-
-function loadRun(ctx, runId) {
-  const f = runFileOf(ctx, runId);
-  if (!fs.existsSync(f)) return null;
-  try { return JSON.parse(fs.readFileSync(f, 'utf8')); } catch { return null; }
-}
-
-function saveRun(ctx, run) {
-  fs.mkdirSync(ctx.runsDir, { recursive: true });
-  run.updatedAt = nowIso();
-  const f = runFileOf(ctx, run.runId);
-  const tmp = f + '.tmp';
-  fs.writeFileSync(tmp, JSON.stringify(run, null, 2) + '\n');
-  fs.renameSync(tmp, f);
-}
 
-function emit(run, ev) { run.events.push({ t: nowIso(), ...ev }); }
-
-function latestRunId(ctx) {
-  if (!fs.existsSync(ctx.runsDir)) return null;
-  const ids = fs.readdirSync(ctx.runsDir).filter((f) => f.endsWith('.json')).map((f) => f.slice(0, -5)).sort();
-  for (let i = ids.length - 1; i >= 0; i--) {
-    const r = loadRun(ctx, ids[i]);
-    if (r && !['done', 'aborted'].includes(r.stopType)) return ids[i];
-  }
-  return ids[ids.length - 1] || null;
-}
-
-function newRunId(requirement) {
-  const d = new Date();
-  const ascii = (requirement.toLowerCase().match(/[a-z0-9]{2,}/g) || []).slice(0, 3).join('-') || 'task';
-  const rand = Math.random().toString(36).slice(2, 6);
-  return `${d.getFullYear()}${pad(d.getMonth() + 1)}${pad(d.getDate())}-${pad(d.getHours())}${pad(d.getMinutes())}-${ascii}-${rand}`;
-}
+import { nowIso, today, ctxEnv, moduleList, loadRun, saveRun, emit, latestRunId, newRunId } from './pipeline-run-run.mjs';
+import { fmGet, placeholdersIn, sectionBody, validateDraftContent, closeoutComplete, summarizeDoc } from './pipeline-run-docs.mjs';
+// 拆分（2026-10-08 engine-quality-batch）：文档纯函数层 / run 存储层迁出本文件（判据注释随函数迁走，
+// 对外导出面经下行 re-export 保持不变——stageBar/parseKV 仍在本文件）；本文件 = CLI 编排层 + 状态机。
+export { placeholdersIn, validateDraftContent, closeoutComplete } from './pipeline-run-docs.mjs';
 
 // ── 门执行（唯一子进程出口；记录真实退出码） ──────────────────────────
 function runNode(ctx, run, script, args) {
@@ -114,78 +64,8 @@ function runGit(ctx, run, args) {
 function readDoc(ctx, rel) {
   try { return fs.readFileSync(path.join(ctx.root, rel), 'utf8'); } catch { return null; }
 }
-function fmGet(text, key) {
-  const m = text.split(/\r?\n/).find((l) => l.startsWith(`${key}:`));
-  return m ? m.slice(key.length + 1).trim() : null;
-}
 function docState(ctx, rel) { const t = readDoc(ctx, rel); return t ? fmGet(t, '状态') : null; }
 
-// 占位符判定（复核 P1-3 收窄，2026-10-02）：先剔除 code span（`…`）与引号串（"…"）——
-// 正文合法的命令语法占位（如 `next --delegated "<原话>"`）几乎总在 code span 内，
-// 模板实占位符（如 <为什么做；写明需求来源…>）从不包 code span；再匹配剩余裸尖括号。
-export function placeholdersIn(text) {
-  const stripped = String(text)
-    .replace(/^```[\s\S]*?^```$/gm, '') // 复核 P2-B：跨行 code fence 整块剔除（围栏内命令示例占位不属模板占位符）
-    .replace(/`[^`\n]*`/g, '')
-    .replace(/"[^"\n]*"/g, '');
-  const hits = [];
-  for (const re of [/<[^>\n]{1,60}>/g, /YYYY-MM-DD 用户/g]) {
-    let m; while ((m = re.exec(stripped))) hits.push(m[0]);
-  }
-  return [...new Set(hits)].slice(0, 5);
-}
-
-function sectionBody(text, title) {
-  const lines = text.split(/\r?\n/);
-  const i = lines.findIndex((l) => l.trim() === `## ${title}` || l.trim() === `## ${title}（L1 微改动无实质内容可删本节，不硬填）` || l.trim().startsWith(`## ${title}`));
-  if (i < 0) return null;
-  const body = [];
-  for (let j = i + 1; j < lines.length; j++) {
-    if (/^##\s/.test(lines[j])) break;
-    body.push(lines[j]);
-  }
-  return body.join('\n').trim();
-}
-
-export function validateDraftContent(text, kind, level) {
-  const problems = [];
-  if (!text) return ['文件不存在或为空'];
-  const state = fmGet(text, '状态');
-  if (!state) problems.push('frontmatter 缺「状态:」行');
-  if (kind !== 'incident' && !fmGet(text, '级别')) problems.push('frontmatter 缺「级别:」行');
-  const ph = placeholdersIn(text);
-  if (ph.length) problems.push(`模板占位符残留：${ph.join('、')}`);
-  const required = {
-    intent: level === 'L1' ? ['背景与问题', '目标', '验收标准'] : ['背景与问题', '历史教训/防复发', '目标', '非目标', '约束', '验收标准'],
-    spec: ['功能行为', '数据流', '系统改动', '约束遵守映射'],
-    plan: level === 'L1' ? ['改动方案', '约束与风险', '验证计划'] : ['改动方案', '任务拆解', '执行顺序', '验证计划'],
-    incident: ['时间线', '根因', '复盘三件套'],
-  }[kind] || [];
-  for (const sec of required) {
-    const b = sectionBody(text, sec);
-    if (b === null) { if (!(level === 'L1' && ['非目标', '约束', '任务拆解', '执行顺序'].includes(sec))) problems.push(`缺节：## ${sec}`); }
-    else if (!b) problems.push(`节为空：## ${sec}`);
-  }
-  return problems;
-}
-
-export function closeoutComplete(text) {
-  const body = sectionBody(text, '验收标准');
-  if (body === null) return { ok: false, problems: ['缺「## 验收标准」节'] };
-  const lines = body.split(/\r?\n/);
-  const open = lines.filter((l) => /^\s*-\s\[\s\]\s/.test(l));
-  // 复核 P2-6：证据冒号后须直接跟内容（非空白、非收括号）——「（证据：）」空值不算过
-  const checkedNoEv = lines.filter((l) => /^\s*-\s\[x\]\s/.test(l) && !/证据[:：][^）\s]/.test(l));
-  const problems = [];
-  if (open.length) problems.push(`未勾验收 ${open.length} 条`);
-  if (checkedNoEv.length) problems.push(`已勾缺证据 ${checkedNoEv.length} 条`);
-  return { ok: problems.length === 0, problems };
-}
-
-function summarizeDoc(text) {
-  const body = text.split(/\r?\n/).filter((l) => l.trim() && !l.startsWith('---') && !/^状态:|^级别:|^日期:|^模块:|^备注:|^risk_level:/.test(l));
-  return body.slice(0, 3).join(' / ').slice(0, 200);
-}
 
 // ── 工单构建 ───────────────────────────────────────────────────────────
 function wo(run, o) {
@@ -211,7 +91,7 @@ function stopConfirm(ctx, run, docRel, points, ledger) {
   printRun(ctx, run);
   process.exit(0);
 }
-function stopGateFail(ctx, run, stage, problems, exitHint) {
+function stopGateFail(ctx, run, stage, problems) {
   run.workOrder = null;
   run.stopType = 'gate-fail';
   run.stage = stage;
@@ -318,11 +198,11 @@ function confirmGate(ctx, run, docRel, quote, to) {
     const tail = (r.stderr || r.stdout).split(/\r?\n/).filter(Boolean).slice(-6).join(' | ');
     return { ok: false, msg: `confirm-doc exit ${r.exit}：${tail}` };
   }
-  emit(run, { type: 'confirm', doc: docRel, to: to || nextConfirmTarget(docState(ctx, docRel), docRel), source: quote ? 'chat-delegated' : 'tty', ...(quote ? { quote } : {}) });
+  emit(run, { type: 'confirm', doc: docRel, to: to || nextConfirmTarget(docState(ctx, docRel)), source: quote ? 'chat-delegated' : 'tty', ...(quote ? { quote } : {}) });
   return { ok: true };
 }
 // 语义上 confirm-doc 自行决定目标态（approved/done/fixed/closed）；事件里记录结果态
-function nextConfirmTarget(curState, docRel) { return curState || 'approved'; }
+function nextConfirmTarget(curState) { return curState || 'approved'; }
 
 // managedFaceCheck（复核 P2-4 修复 A′，2026-10-02 用户拍板）：提交集命中 kit.json 台账面或包源
 // templates/_agents/ 时——包源环境（bin/flow-kit.mjs 可达）自动跑 sync 刷台账并把 kit.json 与 sync

package/templates/_agents/scripts/policy.mjs

@@ -86,7 +86,13 @@ export const POLICIES = {
     stageGateSince: '2026-09-29',
     riskLevelSince: '2026-10-01',
     verifySince: '2026-10-07',
-    verifyDocSince: '2026-10-08', // 凭证按 doc 绑定生效日；v1-v5 无此键 → 两个消费方维持 v5 全局行为
+    // 凭证按 doc 绑定的生效**时刻**（ISO 8601，含 T/Z）；v1-v5 无此键 → 两个消费方维持 v5 全局行为。
+    // 2026-10-09 verifydoc-anchor：值从日期 '2026-10-08' 升级为时刻——本仓 v6 上线当日（本地 17:37 =
+    // 09:37Z）之前 done 的单（selfmeasure 00:22Z / gate-roi-metrics 03:25Z）在日期粒度下被误纳入精确匹配、
+    // 产 3 条不可消退 advisory（它们关单时 --doc 机制尚不存在，无从补证）；升级为时刻后按 done ts 精确比较，
+    // 机制上线前的存量单退回 v5 全局布尔（不误报、不伪造），与检查 15/18 的生效日锚同构。
+    // 消费方：检查 8 的 verifyDocInWindow（done ts ≥ 本值才启用精确匹配）。
+    verifyDocSince: '2026-10-08T09:37:35Z',
   },
 };
 

package/templates/_agents/scripts/source-sync-check.mjs

@@ -112,12 +112,12 @@ function printDiff(result) {
 
 const isMain = process.argv[1] && process.argv[1].endsWith('source-sync-check.mjs');
 if (isMain) {
-  let jsonMode = false, diffMode = false, gateMode = false;
+  let jsonMode = false, gateMode = false;
   let pkgRoot = null, target = null;
   for (let i = 0; i < process.argv.length - 2; i++) {
     const a = process.argv[2 + i];
     if (a === '--json') jsonMode = true;
-    else if (a === '--diff') diffMode = true;
+    else if (a === '--diff') { /* diff 为默认输出模式，无需置位 */ }
     else if (a === '--gate') gateMode = true;
     else if (a === '--pkg-root') pkgRoot = process.argv[2 + i + 1];
     else if (a === '--target') target = process.argv[2 + i + 1];

package/templates/_agents/scripts/source-sync-check.test.mjs

@@ -125,7 +125,7 @@ if (!SRC_ROOT) {
     drift: r.drift.map((d) => ({ rel: d.rel, pkgSha: d.pkgSha.slice(0, 8), tgtSha: d.tgtSha.slice(0, 8) })),
   }, null, 2);
   let parsed = null;
-  try { parsed = JSON.parse(jsonOut); } catch {}
+  try { parsed = JSON.parse(jsonOut); } catch { /* 非 JSON 输出时 parsed 保持 null，S6 判失败路径 */ }
   check('S6 --json 输出可解析', parsed && typeof parsed === 'object' && Array.isArray(parsed.missing));
 }
 

package/templates/_agents/scripts/verify-wiki-consistency.mjs

@@ -125,7 +125,6 @@ for (const line of fs.readFileSync(path.join(WIKI, 'INDEX.md'), 'utf8').split(/\
 }
 
 const diff = (a, b) => [...a].filter((x) => !b.has(x));
-const eq = (a, b) => a.size === b.size && diff(a, b).length === 0;
 
 // ---- 1. 文件级三方比对 ----
 for (const [label, extra] of [

package/templates/_agents/scripts/verify.test.mjs

@@ -162,9 +162,9 @@ const run = (argv, opts = {}) => spawnSync(process.execPath, [VERIFY, ...argv],
   const rootC = mkfix();
   const abs = path.join(rootC, rel);
   const winStyle = rel.split('/').join(path.sep);
-  const rC1 = run(['--test-cmd', `node ${mkCmd(0)}`, '--doc', winStyle], { cwd: rootC, env: { ...process.env, CHECK_LOOP_ROOT: rootC } });
+  run(['--test-cmd', `node ${mkCmd(0)}`, '--doc', winStyle], { cwd: rootC, env: { ...process.env, CHECK_LOOP_ROOT: rootC } });
   const eC1 = readLast(rootC);
-  const rC2 = run(['--test-cmd', `node ${mkCmd(0)}`, '--doc', abs], { cwd: rootC, env: { ...process.env, CHECK_LOOP_ROOT: rootC } });
+  run(['--test-cmd', `node ${mkCmd(0)}`, '--doc', abs], { cwd: rootC, env: { ...process.env, CHECK_LOOP_ROOT: rootC } });
   const eC2 = readLast(rootC);
   check('场景 8③：反斜杠 / posix / 绝对路径三种写法落同一 doc 值（归一是地基）',
     eC1 && eC1.doc === rel && eC2 && eC2.doc === rel, `win=${JSON.stringify(eC1 && eC1.doc)} abs=${JSON.stringify(eC2 && eC2.doc)}`);

package/templates/_agents/scripts/workflow-board-server.test.mjs

@@ -14,7 +14,6 @@ import { spawnSync } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
 import { parseLoopHardBlocks, parseAcceptance, detectAlerts, parseRunFile, runCard, safeRunPath } from './workflow-board-server.mjs';
 import { computeFingerprint } from './confirm-doc.mjs';
-import { stageBar } from './pipeline-run.mjs';
 
 let pass = 0;
 let fail = 0;

package/templates/_agents/scripts/workflow-enums.test.mjs

@@ -2,7 +2,6 @@
 // 判据：① 真实单源文件解析 + 不变量通过 ② 坏数据（坏行/重复键/重复值/缺键/子集破/重叠）fail-loud
 //       ③ 缺文件 fail-loud ④ sh 消费方同口径（sed 可取到全部 8 键）
 // 用法：node templates/_agents/scripts/workflow-enums.test.mjs（npm test 随跑）
-import fs from 'node:fs';
 import path from 'node:path';
 import { execSync } from 'node:child_process';
 import { fileURLToPath } from 'node:url';

package/templates/_agents/scripts-test-exempt.txt

@@ -7,4 +7,7 @@ ensure-board.mjs | 看板启动器（需真实端口/进程环境） | 无（工
 policy.mjs | 库件 | 被 check-loop.test.mjs 直接 import 覆盖
 stage-gates.mjs | 库件 | 被 check-loop.test.mjs 直接 import 覆盖（fill-*/confirm-doc.test 消费其行为）
 verify-wiki-consistency.mjs | wiki 一致性校验工具 | 无（工具豁免，后续批次评估补测）
-wiki-search.mjs | 检索库件 | 无（工具豁免，后续批次评估补测）
+wiki-search.mjs | 检索库件 | 无（工具豁免，后续批次评估补测）
+# 2026-10-08 engine-quality-batch：pipeline-run 三层拆分的库件层——纯函数/存储层由 pipeline-run.test.mjs 全量覆盖（断言零改动全过），单建同名测试属形式主义（plan 偏离留痕 ①）
+pipeline-run-docs.mjs | 库件（文档纯函数层，2026-10-08 engine-quality-batch 拆分） | 由 pipeline-run.test.mjs 全量覆盖（断言零改动 29 组全过）
+pipeline-run-run.mjs | 库件（run 存储层，同上拆分） | 由 pipeline-run.test.mjs 全量覆盖（含 PIPELINE_RUN_* 注入契约场景）