agentic-flow-kit 1.0.1 → 1.1.0

package/README.md

@@ -54,7 +54,7 @@ npx agentic-flow-kit add-gate dotnet-ca
 | 选项 | 说明 |
 |------|------|
 | `--stack` | `dotnet` / `node` / `python` / `go` / `none`（默认 none）——**门禁配置三处**：commit-check 条件编译检查（暂存对应扩展名时 commit 前自动构建）+ **质量检测**（`checks`：lint / 类型检查 / vet 等秒级确定性检查，存在对应配置文件（tsconfig / eslint / ruff / go.mod 等）才启用，没有则自动跳过；测试不放提交门——关单在 test.md 阶段门）、settings.json 自检验命令权限、AGENTS.md「项目适配区」命令预填 |
-| `--hosts` | `zcode` / `opencode` / `trae` / `omp` / `claude` / `cursor` / `codex` 逗号多选（默认 zcode）。zcode/omp 为本地配置，自动进 .gitignore。Claude Code 加载 `.claude/commands` 与 `.claude/agents`；Cursor 加载 `.cursor/commands`；Codex 读仓库根 `AGENTS.md` 与 `.codex/skills/`，`.codex/commands` 是同形薄转发 |
+| `--hosts` | `zcode` / `opencode` / `trae` / `omp` / `claude` / `cursor` / `codex` 逗号多选（默认 zcode）。七个宿主一律入库（2026-10-05 起 zcode/omp 撤销 localOnly——换宿主不丢文件、CI 克隆面与本仓一致）；zcode 的会话级液态草稿（`.zcode/drafts/`、`.zcode/plans/`）是本机态、不该入库——init 不再自动写这条规则，请自行加进 `.gitignore`（本仓实例见根 `.gitignore`）。Claude Code 加载 `.claude/commands` 与 `.claude/agents`；Cursor 加载 `.cursor/commands`；Codex 读仓库根 `AGENTS.md` 与 `.codex/skills/`，`.codex/commands` 是同形薄转发 |
 | `--board-port` | workflow 看板端口（默认 8933） |
 | `--dir` | 目标项目根（默认当前目录） |
 | `--force` | 覆盖已存在的同名文件（默认保守跳过） |

package/package.json

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

package/src/add-host.mjs

@@ -1,6 +1,6 @@
 // flow-kit add-host <宿主>：init 后补装宿主适配层。
 // 渲染 modules/hosts/<h> → HOSTS[h].dir → managed 台账按 rel 去重补记 → options.hosts 补记
-// → localOnly 宿主（zcode/omp）.gitignore 追加 → doctor
+// → localOnly 宿主（2026-10-05 起暂无命中，见 profiles.mjs#HOSTS.localOnly）.gitignore 追加 → doctor
 import fs from 'node:fs';
 import path from 'node:path';
 import { renderTree } from './render.mjs';
@@ -51,7 +51,8 @@ export function addHost(args, pkgRoot) {
   if (!already) kit.options.hosts = [...(kit.options.hosts || []), host];
   fs.writeFileSync(kitPath, `${JSON.stringify(kit, null, 2)}\n`);
 
-  // localOnly 宿主进 .gitignore（缺才补）
+  // localOnly 宿主进 .gitignore（缺才补）。2026-10-05 起七个宿主一律 localOnly:false，该分支暂无宿主命中；
+  // 保留是为了未来重开「本机专属宿主」档位时不必改结构——判定单源在 profiles.mjs#HOSTS.localOnly。
   if (HOSTS[host].localOnly) {
     const giPath = path.join(target, '.gitignore');
     const line = `${HOSTS[host].dir}/`;

package/src/cli.mjs

@@ -46,7 +46,7 @@ init 选项（全部可选，均有默认值）：
                        条件编译检查（builds）与质量检测（checks：lint/类型/vet 等秒级确定性检查，
                        有对应配置文件才启用）、settings.json 自检验命令权限（allow）、
                        AGENTS.md「项目适配区」命令预填
-  --hosts <宿主列表>   逗号分隔：zcode,opencode,trae,omp,claude,cursor,codex（默认 zcode；zcode/omp 为本地配置，自动进 .gitignore）
+  --hosts <宿主列表>   逗号分隔：zcode,opencode,trae,omp,claude,cursor,codex（默认 zcode；七个宿主一律入库，不自动进 .gitignore）
   --board-port <端口>  workflow 看板端口（默认 8933）
   --dir <目录>         目标项目根（默认当前目录）
   --force              覆盖已存在的同名文件（默认保守跳过）

package/src/init.mjs

@@ -242,7 +242,8 @@ export async function init(args, pkgRoot) {
     ownedGenerated.push({ rel, sha256: sha256(Buffer.from(content, 'utf8')) });
   }
 
-  // 4) .gitignore 追加（缺哪条补哪条）
+  // 4) .gitignore 追加（缺哪条补哪条）。2026-10-05 起七个宿主一律 localOnly:false，
+  // 宿主目录不再自动进 .gitignore——实际只补 .agents/cache/ 这条运行时缓存。
   const giPath = path.join(target, '.gitignore');
   const giNeed = ['.agents/cache/', ...(hosts.filter((h) => HOSTS[h].localOnly).map((h) => `${HOSTS[h].dir}/`))];
   let giText = fs.existsSync(giPath) ? fs.readFileSync(giPath, 'utf8') : '';

package/src/profiles.mjs

@@ -6,10 +6,14 @@
 // pkg:scripts.build 表示 package.json 里该脚本为非空字符串。没有对应配置的项目自动跳过，
 // 不 fail-closed 误拦。none = 不配置（项目日后自填）。
 export const HOSTS = {
-  zcode: { dir: '.zcode', localOnly: true },
+  // 2026-10-05 宿主本地化撤销：zcode / omp 原 localOnly:true（init 与 add-host 会把 .zcode/、.omp/
+  // 整目录写进装户 .gitignore）。改为 false 后七个宿主一律入库，换宿主不丢文件、CI 克隆面与本仓一致。
+  // 代价是 zcode 的会话级液态草稿（.zcode/drafts/、.zcode/plans/）改由装户自己加 .gitignore 规则；
+  // 本仓 .gitignore 净效果保留这两行草稿规则（实例见根 .gitignore），.zcode/agents/*.md 保持 tracked（2026-09-27 gate-coverage 独立复核确立）。
+  zcode: { dir: '.zcode', localOnly: false },
   opencode: { dir: '.opencode', localOnly: false, commandPrefix: 'wf-' },
   trae: { dir: '.trae', localOnly: false, commandPrefix: 'wf-' },
-  omp: { dir: '.omp', localOnly: true },
+  omp: { dir: '.omp', localOnly: false },
   // 2026-09-29 店面：序号仍把 zcode 放第一（交互菜单 1–4 不变）。claude / cursor 的 commands 由宿主自动加载；
   // codex 自动读仓库根 AGENTS.md 与 .codex/skills/，commands 与 agents 是同形薄转发，供显式引用。
   claude: { dir: '.claude', localOnly: false, commandPrefix: 'wf-' },

package/src/sync.test.mjs

@@ -18,6 +18,8 @@ function check(name, cond, detail = '') {
 }
 const W = (p, content) => { fs.mkdirSync(path.dirname(p), { recursive: true }); fs.writeFileSync(p, content); };
 const R = (p) => fs.readFileSync(p, 'utf8');
+// 可选读：装户端在无 localOnly 宿主时不再创建 .gitignore，断言「不追加」须容忍文件不存在
+const ROpt = (p) => (fs.existsSync(p) ? fs.readFileSync(p, 'utf8') : '');
 
 // ---- fixture 包根（v2 形态：chg/host 变更、new 新增、gone 已删）----
 function mkFixture() {
@@ -162,7 +164,7 @@ else if (cmd === 'add-gate') addGate(rest, root);
   const kit = JSON.parse(R(path.join(t, '.agents/kit.json')));
   check('S7 managed 台账补记（项目根相对路径）', kit.managed.some((f) => f.rel === '.zcode/h.txt'), JSON.stringify(kit.managed));
   check('S7 options.hosts 补记', Array.isArray(kit.options.hosts) && kit.options.hosts.includes('zcode'));
-  check('S7 localOnly 宿主进 .gitignore', R(path.join(t, '.gitignore')).includes('.zcode/'));
+  check('S7 宿主目录不再进 .gitignore（localOnly 已撤销，zcode 与其余宿主同策）', !ROpt(path.join(t, '.gitignore')).includes('.zcode/'), ROpt(path.join(t, '.gitignore')));
   const r2 = runCmd('add-host', fx, t, ['zcode']);
   check('S7 重复装未 --force → 报错退出', r2.status === 1 && (r2.stderr || '').includes('--force'), r2.stderr);
 }

package/templates/AGENTS.md

@@ -26,7 +26,7 @@
 - `.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`。装户五条硬规则（配对、验收、确认留痕、敏感信息、双源台账）与 `audit` 档见 `workflow/README.md`「硬规则」。
-- 提交遵循 Conventional Commits 中文（feat / fix / docs / style / refactor / perf）；L1+ 入口文档 / spec / plan 随代码同一提交；确认（approved）后立即 `docs(*)` 单独提交留痕。
+- 提交遵循 Conventional Commits 中文（feat / fix / docs / style / refactor / perf）。L1+ 三段式闭环链：`docs(*)` approved 留痕 → 代码 → 关单 `docs(*)`，相邻提交即同一闭环（2026-10-04 修订）。
 - **确认门（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

@@ -54,6 +54,24 @@
   #q { background: var(--card); border: 1px solid var(--border); color: var(--text); border-radius: 3px; padding: 6px 10px; font: 12px/1.4 var(--mono); width: 200px; transition: border-color .15s ease-out; }
   #q::placeholder { color: var(--faint); }
   #q:focus { outline: none; border-color: var(--border-strong); }
+  .viewbtn { background: var(--card); border: 1px solid var(--border); color: var(--muted); border-radius: 3px; padding: 6px 10px; font: 12px/1.4 var(--mono); cursor: pointer; transition: border-color .15s ease-out, color .15s ease-out, background .15s ease-out; }
+  .viewbtn:hover { border-color: var(--border-strong); color: var(--text); }
+  .viewbtn.on { background: var(--text); color: var(--bg); border-color: var(--text); }
+
+  /* 执行器视图：run 卡片列（2026-10-04 board-run-panel） */
+  #runs-view { display: flex; flex-direction: column; height: calc(100vh - 58px); overflow-y: auto; padding: 14px 22px 28px; gap: 10px; }
+  .run-card { background: var(--card); border: 1px solid var(--border); border-left: 3px solid var(--border-strong); border-radius: 4px; padding: 12px 14px; cursor: pointer; transition: background .15s ease-out, border-color .15s ease-out, transform .15s ease-out, box-shadow .15s ease-out; }
+  .run-card:hover { background: var(--card-hover); border-color: var(--border-strong); transform: translateY(-1px); box-shadow: var(--shadow-1); }
+  .run-card .row { display: flex; align-items: center; flex-wrap: wrap; gap: 6px; margin-bottom: 7px; }
+  .run-card .title { font-size: 13px; line-height: 1.6; }
+  .run-bar { font: 12px/1.6 var(--mono); color: var(--muted); white-space: nowrap; overflow: hidden; text-overflow: ellipsis; margin-top: 4px; }
+  .run-bar b { color: var(--text); font-weight: 600; }
+  .stopchip { font: 500 10px/1 var(--mono); border-radius: 2px; padding: 2px 5px; }
+  .stopchip.work-order { color: var(--intent); border: 1px solid var(--intent); }
+  .stopchip.await-confirm { color: var(--warn); border: 1px solid var(--warn); }
+  .stopchip.gate-fail { color: var(--bad); border: 1px solid var(--bad); }
+  .stopchip.done { color: var(--ok); border: 1px solid var(--ok); }
+  .stopchip.aborted { color: var(--muted); border: 1px solid var(--border-strong); }
 
   /* ---- 看板：去列盒子，发丝竖线分栏的编辑式构图 ---- */
   #board { display: flex; overflow-x: auto; height: calc(100vh - 58px); }
@@ -162,9 +180,11 @@
   <span class="chip" id="c-plans"></span><span class="chip" id="c-specs"></span>
   <span class="chip" id="c-alerts" style="display:none"></span>
   <input id="q" placeholder="过滤 标题 / slug / 文件…" spellcheck="false">
+  <button id="view-runs" class="viewbtn" title="pipeline-run 执行器事件流">执行器</button>
   <span id="sse"><i></i><span>连接断开</span></span>
 </header>
 <div id="board"></div>
+<div id="runs-view" style="display:none"></div>
 
 <div id="drawer">
   <div id="d-head">
@@ -176,6 +196,8 @@
   <div id="d-tabs">
     <button data-tab="doc" class="on">文档</button>
     <button data-tab="hist">修改历史</button>
+    <button data-tab="timeline" class="run-tab" style="display:none">时间线</button>
+    <button data-tab="workorder" class="run-tab" style="display:none">工单</button>
   </div>
   <div id="d-body"></div>
 </div>
@@ -198,6 +220,10 @@ let TAB = 'doc';
 let retryTimer = null;     // /api/board 失败后的重试定时器
 let ROOT = '';             // 仓库根（/api/board 返回，内链 vscode 协议用）
 let Q = '';                // 搜索过滤关键字
+let RUNS = [];            // 最近一次 /api/runs 的 run 卡片
+let RUN_CURRENT = null;    // 抽屉当前打开的 run
+let VIEW = 'board';        // 当前视图：board | runs
+let RUN_TAB = 'timeline';  // run 抽屉当前 tab：timeline | workorder
 
 const $ = (s) => document.querySelector(s);
 const esc = (s) => s.replace(/[&<>"]/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;' }[c]));
@@ -343,7 +369,11 @@ function renderDrawer() {
   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]} · ${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));
+  document.querySelectorAll('#d-tabs button').forEach((b) => {
+    const isRunTab = b.classList.contains('run-tab');
+    b.style.display = isRunTab ? 'none' : '';
+    b.classList.toggle('on', b.dataset.tab === TAB);
+  });
   if (TAB === 'doc') loadDoc(); else loadHist();
 }
 
@@ -383,6 +413,159 @@ async function loadHist() {
     : '<div class="none">暂无提交记录（文件尚未 commit；git 历史只包含已提交的修改）</div>';
 }
 
+// ================= 执行器视图（2026-10-04 board-run-panel） =================
+// 只读 pipeline-runs/ 事件流（机器事实），不读 orchestration-runs.jsonl（自报态）。
+const STOP_LABEL = {
+  'work-order': '工单', 'await-confirm': '等待确认', 'gate-fail': '门拒绝', done: '完成', aborted: '已放弃',
+};
+const EVENT_DESC = {
+  'run-created': '创建 run', 'work-order': '下发工单', triage: '定级', gate: '门执行',
+  confirm: '确认', commit: '提交', stop: '停机', done: '完成', abort: '放弃',
+};
+
+async function refreshRuns() {
+  let data;
+  try {
+    const resp = await fetch('/api/runs');
+    if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
+    data = await resp.json();
+  } catch (e) {
+    return false;
+  }
+  RUNS = data.cards || []; // 键名 cards 对齐 /api/runs 载荷（intent 2026-10-04-board-run-panel 验收#1）
+  const q = Q.trim().toLowerCase();
+  const list = RUNS.filter((r) => !q || (r.runId + ' ' + r.requirement + ' ' + r.stage).toLowerCase().includes(q));
+  const html = list.length
+    ? list.map((r) => {
+        const stop = STOP_LABEL[r.stopType] || esc(r.stopType || '');
+        const stopCls = r.stopType || '';
+        const bar = r.stageBar || '';
+        return `<div class="run-card" data-run="${esc(r.runId)}">` +
+          `<div class="row">` +
+          `<span class="type" style="background:var(--spec)">RUN</span>` +
+          `<span class="lv">${esc(r.triage?.level || '')}</span>` +
+          `<span class="stopchip ${esc(stopCls)}">${esc(stop)}</span>` +
+          `<span class="date">${esc(r.updatedAt?.slice(0, 16).replace('T', ' ') || '')}</span>` +
+          `</div>` +
+          `<div class="title">${esc(r.requirement || r.runId)}</div>` +
+          `<div class="run-bar">${esc(r.runId)} · <b>${esc(r.stage || '')}</b>${r.eventCount ? ` · ${r.eventCount} 事件` : ''}</div>` +
+          (bar ? `<div class="run-bar">${esc(bar)}</div>` : '') +
+          `</div>`;
+      }).join('')
+    : '<div class="empty">暂无 run</div>';
+  $('#runs-view').innerHTML = `<h2 style="font:600 11px/1 var(--mono);letter-spacing:.12em;color:var(--muted);padding:4px 0 10px;">执行器 · ${RUNS.length} runs</h2>` + html;
+  return true;
+}
+
+// —— run 抽屉：时间线 + 工单/确认详情 ——
+function runEventHtml(run) {
+  const evs = run.events || [];
+  if (!evs.length) return '<div class="none">暂无事件</div>';
+  return `<div class="tl">${evs.map((e) => {
+    const t = EVENT_DESC[e.type] || e.type;
+    const sub = e.type === 'gate'
+      ? `${esc(e.cmd || '')} · exit ${e.exit}${e.ms != null ? ` · ${e.ms}ms` : ''}`
+      : e.type === 'commit'
+        ? `${esc(e.subject || '')} · ${esc(e.sha || '')}`
+        : e.type === 'work-order'
+          ? `${esc(e.kind || '')} 工单 #${e.id}`
+          : e.type === 'stop'
+            ? `${esc(e.stopType || '')}${e.stage ? ' · ' + esc(e.stage) : ''}${e.workOrderId != null ? ' · 工单 #' + e.workOrderId : ''}`
+            : e.type === 'confirm'
+              ? `${esc(e.doc || '')} → ${esc(e.to || '')}${e.source ? ' · ' + esc(e.source) : ''}`
+              : e.type === 'abort'
+                ? `→ ${esc(e.to || '')}`
+                : e.type === 'triage'
+                  ? `${esc(e.kind || '')} · ${esc(e.level || '')} · ${esc(e.module || '')}`
+                  : '';
+    return `<div class="tl-item"><div class="tl-sub">${esc(t)}</div>` +
+      (sub ? `<div class="tl-meta">${sub}</div>` : '') +
+      `<div class="tl-meta">${esc((e.t || '').slice(0, 19).replace('T', ' '))}</div></div>`;
+  }).join('')}</div>`;
+}
+
+function loadRunTimeline() {
+  if (!RUN_CURRENT) return;
+  $('#d-body').innerHTML = runEventHtml(RUN_CURRENT);
+}
+
+function loadRunWorkOrder() {
+  if (!RUN_CURRENT) return;
+  const w = RUN_CURRENT.workOrder;
+  if (w) {
+    $('#d-body').innerHTML =
+      `<div class="md"><h2>工单 #${w.id} · ${esc(w.kind)}</h2>` +
+      `<p><b>${esc(w.title || '')}</b></p>` +
+      `<p>目标：${esc(w.goal || '')}</p>` +
+      (w.instructions?.length ? `<ul>${w.instructions.map((s) => `<li>${esc(s)}</li>`).join('')}</ul>` : '') +
+      (w.context?.kbHits?.length ? `<p>查重命中：</p><ul>${w.context.kbHits.slice(0, 6).map((s) => `<li>${esc(s)}</li>`).join('')}</ul>` : '') +
+      (w.context?.stderrTail ? `<pre><code>${esc(w.context.stderrTail)}</code></pre>` : '') +
+      (w.constraints?.length ? `<p>约束：</p><ul>${w.constraints.map((s) => `<li>${esc(s)}</li>`).join('')}</ul>` : '') +
+      (w.acceptance?.length ? `<p>验收：</p><ul>${w.acceptance.map((s) => `<li>${esc(s)}</li>`).join('')}</ul>` : '') +
+      `</div>`;
+    return;
+  }
+  // 停机在确认门：渲染确认门要点（intent 2026-10-04-board-run-panel 目标节「工单详情 + 确认门要点」）
+  const c = RUN_CURRENT.awaitConfirm;
+  if (c) {
+    $('#d-body').innerHTML =
+      `<div class="md"><h2>等待确认</h2>` +
+      `<p>文档：<code>${esc(c.doc || '')}</code></p>` +
+      `<p>确认门要点：${esc(c.points || '')}</p>` +
+      `<p>${c.ledger ? '将经 confirm-doc 代录入台账（对话内明确确认后逐份代录，台账记原话）。' : '对话级确认，记 run 事件不进台账。'}</p>` +
+      `</div>`;
+    return;
+  }
+  $('#d-body').innerHTML = '<div class="none">当前无工单（已停机在非工单点或已完成）</div>';
+}
+
+function renderRunDrawer() {
+  if (!RUN_CURRENT) return;
+  $('#d-badges').innerHTML =
+    `<span class="type" style="background:var(--spec)">RUN</span>` +
+    (RUN_CURRENT.triage?.level ? `<span class="lv">${esc(RUN_CURRENT.triage.level)}</span>` : '') +
+    ` <span class="chip">${esc(RUN_CURRENT.stopType || '')}</span>` +
+    ` <span class="chip">${esc(RUN_CURRENT.stage || '')}</span>`;
+  $('#d-title').textContent = RUN_CURRENT.requirement || RUN_CURRENT.runId;
+  $('#d-related').innerHTML = `<a class="runid">${esc(RUN_CURRENT.runId)}</a>`;
+  // run 抽屉：显示时间线/工单 tab，隐藏文档/历史 tab
+  document.querySelectorAll('#d-tabs button').forEach((b) => {
+    const isRunTab = b.classList.contains('run-tab');
+    b.style.display = isRunTab ? '' : 'none';
+    b.classList.toggle('on', b.dataset.tab === RUN_TAB);
+  });
+  if (RUN_TAB === 'timeline') loadRunTimeline(); else loadRunWorkOrder();
+}
+
+async function openRun(runId) {
+  RUN_CURRENT = null;
+  $('#drawer').classList.add('open');
+  $('#d-title').textContent = '加载中…';
+  $('#d-body').innerHTML = '<div class="none">加载中…</div>';
+  try {
+    const resp = await fetch(`/api/run?file=${encodeURIComponent(runId + '.json')}`);
+    if (!resp.ok) throw new Error(`HTTP ${resp.status}`);
+    const data = await resp.json();
+    RUN_CURRENT = data.run || null;
+    if (!RUN_CURRENT) throw new Error('run 为空');
+    RUN_TAB = 'timeline';
+    renderRunDrawer();
+  } catch (e) {
+    $('#d-title').textContent = '加载失败';
+    $('#d-body').innerHTML = `<div class="none">无法加载 run：${esc(e.message)}</div>`;
+  }
+}
+
+function switchView(v) {
+  VIEW = v;
+  const isRuns = v === 'runs';
+  $('#board').style.display = isRuns ? 'none' : '';
+  $('#runs-view').style.display = isRuns ? '' : 'none';
+  $('#view-runs').classList.toggle('on', isRuns);
+  $('#q').placeholder = isRuns ? '过滤 runId / 需求 / 阶段…' : '过滤 标题 / slug / 文件…';
+  if (isRuns) refreshRuns(); else refreshBoard();
+}
+
 function openCard(card) { CURRENT = card; TAB = 'doc'; $('#drawer').classList.add('open'); renderDrawer(); }
 
 // —— toast 反馈 ——
@@ -445,20 +628,35 @@ document.addEventListener('click', (e) => {
   if (hash) navigator.clipboard.writeText(hash.dataset.h)
     .then(() => toast('已复制 ' + hash.dataset.h.slice(0, 9)))
     .catch(() => toast('复制失败'));
+  // 执行器 run 卡片 → 开抽屉（时间线）
+  const runCard = e.target.closest('.run-card');
+  if (runCard) {
+    const hit = RUNS.find((r) => r.runId === runCard.dataset.run);
+    if (hit) openRun(hit.runId);
+    return;
+  }
 });
 $('#d-close').onclick = () => { $('#drawer').classList.remove('open'); };
 document.addEventListener('keydown', (e) => { if (e.key === 'Escape') $('#drawer').classList.remove('open'); });
-document.querySelectorAll('#d-tabs button').forEach((b) => b.onclick = () => { TAB = b.dataset.tab; renderDrawer(); });
+// 抽屉 tab：run 抽屉（时间线/工单）与文档抽屉（文档/历史）分开处理
+document.querySelectorAll('#d-tabs button').forEach((b) => b.onclick = () => {
+  if (b.classList.contains('run-tab') && RUN_CURRENT) { RUN_TAB = b.dataset.tab; renderRunDrawer(); }
+  else if (!b.classList.contains('run-tab')) { TAB = b.dataset.tab; renderDrawer(); }
+});
+$('#view-runs').onclick = () => switchView(VIEW === 'runs' ? 'board' : 'runs');
 
 // SSE：服务端 fs.watch 防抖后推送 changed → 看板与打开中的抽屉自动刷新
 const sse = new EventSource('/api/events');
-sse.addEventListener('changed', () => { refreshBoard().then((ok) => { if (ok) renderDrawer(); }); });
+sse.addEventListener('changed', () => {
+  refreshBoard().then((ok) => { if (ok) renderDrawer(); });
+  if (VIEW === 'runs') refreshRuns();
+});
 sse.addEventListener('watchdead', () => { $('#sse').classList.remove('on'); $('#sse').classList.add('poll'); $('#sse span:last-child').textContent = '监听失效 · 60s 轮询'; });
 sse.onopen = () => { $('#sse').classList.add('on'); $('#sse').classList.remove('poll'); $('#sse span:last-child').textContent = '实时'; };
 sse.onerror = () => { $('#sse').classList.remove('on'); $('#sse span:last-child').textContent = '连接断开，自动重连中'; };
 
 // 60s 兜底轮询：SSE/watch 任何环节失效时数据仍保鲜（正常时多拉一次无害）
-setInterval(() => refreshBoard(), 60000);
+setInterval(() => { refreshBoard(); if (VIEW === 'runs') refreshRuns(); }, 60000);
 
 // 搜索过滤：本地过滤标题/slug/文件，SSE 刷新时保持关键字
 // 击键去抖 400ms（复核 P2-2 rider）：/api/board 服务端有 loop TTL 缓存，去抖进一步避免连发请求排队
@@ -466,7 +664,7 @@ let qTimer = null;
 $('#q').addEventListener('input', (e) => {
   Q = e.target.value;
   clearTimeout(qTimer);
-  qTimer = setTimeout(refreshBoard, 400);
+  qTimer = setTimeout(() => { if (VIEW === 'runs') refreshRuns(); else refreshBoard(); }, 400);
 });
 
 // 首次入场：列错峰上浮一次（.boot 稍后摘除，SSE / 过滤触发的重渲染不再重播）

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

@@ -504,7 +504,7 @@ for (const inc of docFiles('incidents')) {
       }
     }
     const zc = `.zcode/agents/${role}.md`;
-    if (fs.existsSync(path.join(ROOT, zc))) { // 本地配置不入 git：缺失不告警，存在时校验一致性
+    if (fs.existsSync(path.join(ROOT, zc))) { // .zcode/agents/ 现为入库件（2026-10-05 起宿主一律入库）；缺失只说明宿主未装，不告警，存在时校验一致性
       if (!new RegExp(`^name:\\s*["']?${role}["']?\\s*$`, 'm').test(textOf(zc).join('\n'))) warnings.push(`- [WARN Adapter 无效] ZCode ${role} 的 name 与文件名不一致:${zc}`);
       if (!textOf(zc).some((l) => l.includes(rolePath))) warnings.push(`- [WARN Adapter 断线] ZCode ${role} 未引用公共角色:${rolePath}`);
     }
@@ -596,10 +596,10 @@ function verifyEvidenceTruth(evidenceStr, planBase, root) {
 
   const planLines = linesOf(planPath) || [];
   const declaredFiles = [];
-  // 扫描「改动面」或「任务拆解」节
+  // 扫描「改动面」「任务拆解」或「改动方案」（L1 Quick-Plan 生成器 fill-plan 输出）节
   let inDeclaredSec = false;
   for (const line of planLines) {
-    if (/^##\s+(改动面|任务拆解)/.test(line)) { inDeclaredSec = true; continue; }
+    if (/^##\s+(改动面|任务拆解|改动方案)/.test(line)) { inDeclaredSec = true; continue; }
     if (inDeclaredSec && /^##\s+/.test(line)) { inDeclaredSec = false; continue; }
     if (inDeclaredSec) {
       const fileMatch = line.match(/([a-zA-Z0-9._\/-]+\.[a-zA-Z0-9]+)/);

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

@@ -16,6 +16,9 @@ import { entryConfirmed, MARK_RE, laneOfEntry, laneOfDoc } from './stage-gates.m
 
 const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
 const CHECK_LOOP = path.join(SCRIPT_DIR, 'check-loop.mjs');
+const GIT = process.platform === 'win32' ? 'git.exe' : 'git'; // Windows spawn 不补 .exe 扩展名（gitInit/gitCommitAll/场景 43/44/47 共用）
+// 注意：check-loop.mjs 无 isMain 主守卫，被 import 即全量执行门禁并 process.exit——本套件只能端到端 spawn，
+// 不可从其 import 函数直测（2026-10-04 review-fix-batch 实证；可 import 化记 papercuts 待 L2 重构）
 
 let pass = 0;
 let fail = 0;
@@ -250,7 +253,7 @@ const mkConfirmedDoc = (root, rel, fmBody) => {
   rmfix(T);
 }
 
-// ---- 场景 15:ZCode Adapter 缺失不告警(本地配置不入 git),存在且断线仍告警 ----
+// ---- 场景 15:ZCode Adapter 缺失不告警(宿主未装),存在且断线仍告警 ----
 {
   const T = mkfix();
   w(T, 'workflow/intents/2026-09-12-o.md', INTENT('o', '状态: done\n级别: L1\n日期: 2026-09-12', '\n## 验收标准（可测试）\n- [x] 用例通过（证据:全绿）\n'));
@@ -564,6 +567,65 @@ const mkConfirmedDoc = (root, rel, fmBody) => {
     r.status === 1 && outOf(r).includes('验收缺证据'), `exit=${r.status}\n${outOf(r)}`);
   rmfix(T);
 }
+// evidenceFixture：场景 43/44/47 共用脚手架——git 仓 + L1 done 三件（plan「改动方案」节声明 declared）+
+// intent 证据引用唯一内容提交，返回 { T, sha }。createDeclared=false 时声明【从未存在】的文件（唯一内容
+// 提交必然不触及，判定确定——2026-10-04 实测原「二次提交区分触及/不触及」方案在 npm test 环境偶发失败
+// （git 时序敏感），负例改 ghost 构造）
+const evidenceFixture = (slug, declared, createDeclared) => {
+  const T = mkfix();
+  gitInit(T);
+  if (createDeclared) {
+    fs.mkdirSync(path.join(T, path.dirname(declared)), { recursive: true });
+    w(T, declared, '// fixture\n');
+  }
+  w(T, `workflow/plans/2026-10-04-${slug}.md`, PLAN(slug, '状态: done\n级别: L1', `\n## 改动方案\n- ${declared}：声明文件${createDeclared ? '' : '（实际不存在，证据必不触及）'}\n`));
+  w(T, `workflow/intents/2026-10-04-${slug}.md`, INTENT(slug, '状态: done\n级别: L1\n日期: 2026-10-04',
+    '\n## 验收标准（可测试）\n- [x] 用例通过（证据:commit PLACEHOLDER）\n'));
+  gitCommitAll(T, `feat: ${slug} fixture`);
+  const sha = spawnSync(GIT, ['rev-parse', 'HEAD'], { cwd: T, encoding: 'utf8' }).stdout.trim().slice(0, 7);
+  w(T, `workflow/intents/2026-10-04-${slug}.md`, INTENT(slug, '状态: done\n级别: L1\n日期: 2026-10-04',
+    `\n## 验收标准（可测试）\n- [x] 用例通过（证据:commit ${sha}）\n`));
+  gitCommitAll(T, `docs: ${slug} evidence`);
+  return { T, sha };
+};
+
+// ---- 场景 43:检查 8 证据真相——L1 plan「改动方案」节（fill-plan 输出）+ 证据 SHA 触及声明文件 → 不报「证据无关」（2026-10-04 plan-section-name-evidence 回归）----
+{
+  const { T } = evidenceFixture('ev3', 'src/foo.js', true);
+  const r = run(T);
+  // fixture 不构造确认记录 → done 必触「确认未对账」hard（exit 1 预期）；核心断言是证据面不出现「证据无关」
+  check('L1 plan「改动方案」节 + 证据触及声明文件 → 不报证据无关',
+    !outOf(r).includes('证据无关'), `exit=${r.status}\n${outOf(r)}`);
+  rmfix(T);
+}
+
+// ---- 场景 44:检查 8 证据真相——L1 plan「改动方案」节 + 证据 SHA 不触及声明文件 → 仍报「证据无关」（负例，防过度豁免）----
+{
+  const { T } = evidenceFixture('ev4', 'src/ghost.js', false);
+  const r = run(T);
+  check('L1 plan「改动方案」节 + 证据不触及声明文件 → 仍报证据无关（负例）',
+    outOf(r).includes('证据无关'), `exit=${r.status}\n${outOf(r)}`);
+  rmfix(T);
+}
+
+// ---- 场景 47:检查 8 证据真相——证据 SHA 触及声明文件 → 校验通过 exit 0（2026-10-04 review-fix-batch：
+// 补 spec 2026-10-04-plan-section-name-evidence §49「校验通过（type=sha）」断言强度——场景 43 的 fixture
+// 触「确认未对账」hard 只能间接断言无「证据无关」；本场景沿场景 5x 造法（锚前自报日期豁免存量面）走满
+// type=sha 放行路径：证据为真实 SHA + 声明文件被提交触及 + 提交无执行器标记 → exit 0 只能经 type=sha 达成
+// （text 需无 hex 串 / process 需 runId 标记 / forged·irrelevant 均 exit 1，三条岔路均被构造排除）----
+{
+  const T = mkfix();
+  gitInit(T);
+  w(T, 'workflow/plans/2026-09-26-sh1.md', PLAN('sh1', '状态: done\n级别: L1\n日期: 2026-09-26\n模块: material', '\n## 改动方案\n\n- src/app.mjs：实现功能\n'));
+  fs.mkdirSync(path.join(T, 'src'), { recursive: true });
+  w(T, 'src/app.mjs', '// fixture\n');
+  gitCommitAll(T, 'feat: sh1 实现（无执行器标记）');
+  const sha = spawnSync(GIT, ['rev-parse', '--short', 'HEAD'], { cwd: T, encoding: 'utf8' }).stdout.trim();
+  w(T, 'workflow/intents/2026-09-26-sh1.md', INTENT('sh1', '状态: done\n级别: L1\n日期: 2026-09-26', `\n## 验收标准（可测试）\n- [x] 用例通过（证据:${sha}）\n`));
+  expectOk('证据 SHA 触及声明文件（无执行器标记）→ type=sha 校验通过 exit 0', T);
+  rmfix(T);
+}
+
 // ---- 场景 42:检查 4——fill-{intent,spec,plan}.mjs 花括号展开，三路皆存在 → 不报引用断档 ----
 {
   const T = mkfix();
@@ -577,7 +639,7 @@ const mkConfirmedDoc = (root, rel, fmBody) => {
     r.status === 0 && !outOf(r).includes('引用断档'), `exit=${r.status}\n${outOf(r)}`);
   rmfix(T);
 }
-// ---- 场景 43:检查 4——花括号展开三路皆不存在 → 仍报引用断档（带完整展开式文案）----
+// ---- 场景 45（原 43，2026-10-04 review-fix-batch 改号避让证据真相场景重号；旧号无文档按号引用）:检查 4——花括号展开三路皆不存在 → 仍报引用断档（带完整展开式文案）----
 {
   const T = mkfix();
   w(T, 'AGENTS.md', '# AGENTS\n\n起草先跑 `node .agents/scripts/fill-{alpha,beta,gamma}.mjs` 拿结构化草稿。\n');
@@ -588,7 +650,7 @@ const mkConfirmedDoc = (root, rel, fmBody) => {
     r.status === 0 && /引用断档.*fill-\{alpha,beta,gamma\}\.mjs/.test(outOf(r)), `exit=${r.status}\n${outOf(r)}`);
   rmfix(T);
 }
-// ---- 场景 44:检查 2——<主题> 与 .md 同行 = 命名约定描述 → 不报模板未填 ----
+// ---- 场景 46（原 44，同场景 45 缘由改号）:检查 2——<主题> 与 .md 同行 = 命名约定描述 → 不报模板未填 ----
 {
   const T = mkfix();
   w(T, 'workflow/intents/2026-09-01-nm1.md', INTENT('nm1', '状态: done\n级别: L1\n日期: 2026-09-01',

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

@@ -231,7 +231,7 @@ function stopDone(ctx, run) {
 }
 
 // ── 输出（人类可读 + 机器标记） ────────────────────────────────────────
-function stageBar(run) {
+export function stageBar(run) {
   const s = run.stage;
   const mk = (name, pos) => (pos === 'cur' ? '[●' + name + ']' : pos === 'past' ? '[✓' + name + ']' : '[…' + name + ']');
   const seq = run.triage?.kind === 'verify' ? [['Verify', s === 'verify' || s === 'done']]
@@ -996,4 +996,4 @@ function adoptRun(ctx, a) {
   console.log('  提示：adopt 不推断断点位置——按文档现状人工续走（next 会按 stage 拒绝，请对照事件缺失情况手动接续或另起 run）');
 }
 
-export default { parseKV, validateDraftContent, closeoutComplete, placeholdersIn };
+export default { parseKV, validateDraftContent, closeoutComplete, placeholdersIn, stageBar };

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

@@ -3,18 +3,23 @@
 // 用法：node .agents/scripts/workflow-board-server.mjs [--port 8933]；多项目并行请用 ensure-board.mjs 拉起（自动上探可用端口）
 // 零依赖（node:http/node:fs/node:path/node:url/node:child_process）；只读 workflow/ 与 git，仅绑 127.0.0.1。
 // API：GET /（看板页） /marked.min.js（vendor） /api/board /api/doc?file=<相对路径> /api/history?file=<相对路径> /api/events（SSE）
+//       /api/runs（pipeline-run 执行器 run 卡片列表） /api/run?file=<runId>.json（单 run 事件流）
 // 实时边界：文档内容与状态随落盘实时（fs.watch→SSE 推送）；git 历史仅含已提交记录（git 语义）。
+// 执行器面板（2026-10-04 board-run-panel）：只读 .agents/cache/pipeline-runs/*.json（脚本亲写的机器事实），
+//   不读 orchestration-runs.jsonl（宿主 AI 自报态，非验证态）；纯只读观测层，不启动/推进/中止 run。
 import http from 'node:http';
 import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { execFile, spawnSync } from 'node:child_process';
 import { ENUMS } from './workflow-enums.mjs';
+import { stageBar } from './pipeline-run.mjs';
 
 const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '../..');
 const WORKFLOW = path.join(ROOT, 'workflow');
 const BOARD_DIR = path.join(ROOT, '.agents', 'board');
 const DOC_TYPES = ['intents', 'incidents', 'plans', 'specs'];
+const PIPELINE_RUNS = path.join(ROOT, '.agents', 'cache', 'pipeline-runs');
 
 const portArg = process.argv.indexOf('--port');
 const PORT = portArg > 0 ? Number(process.argv[portArg + 1]) || 8933 : 8933;
@@ -53,6 +58,58 @@ function parseAcceptance(text) {
 }
 export { parseAcceptance };
 
+// ---- 执行器 run 文件解析（2026-10-04 board-run-panel）----
+// 只读 pipeline-runs/ 下的 run JSON（脚本亲写的机器事实，含 gate 真实退出码）。坏 JSON / 缺字段容错返回 null，
+// 由调用方跳过——run 文件写入原子化（临时文件+rename），读瞬间可能撞上 rename 前状态，不 500。
+export function parseRunFile(text) {
+  let j;
+  try {
+    j = JSON.parse(text);
+  } catch {
+    return null;
+  }
+  if (!j || typeof j !== 'object' || typeof j.runId !== 'string' || !j.runId) return null;
+  return j;
+}
+
+// 单 run 卡片（/api/runs 载荷元素）：runId / requirement / stage / stopType / updatedAt / triage / 事件数 / 阶段条
+export function runCard(run) {
+  const events = Array.isArray(run.events) ? run.events : [];
+  return {
+    runId: run.runId,
+    requirement: run.requirement || '',
+    stage: run.stage || '',
+    stopType: run.stopType || '',
+    updatedAt: run.updatedAt || run.createdAt || '',
+    triage: run.triage || null,
+    eventCount: events.length,
+    stageBar: stageBar(run),
+  };
+}
+
+// 扫 pipeline-runs/ 全部 run → 卡片数组，按 updatedAt 倒序（无目录/空目录 → []）
+export function scanRuns() {
+  if (!fs.existsSync(PIPELINE_RUNS) || !fs.statSync(PIPELINE_RUNS).isDirectory()) return [];
+  const cards = [];
+  for (const f of fs.readdirSync(PIPELINE_RUNS)) {
+    if (!f.endsWith('.json')) continue;
+    try {
+      const run = parseRunFile(fs.readFileSync(path.join(PIPELINE_RUNS, f), 'utf8'));
+      if (run) cards.push(runCard(run));
+    } catch {
+      // 读失败（瞬时占用等）跳过，等下次推送
+    }
+  }
+  return cards.sort((a, b) => String(b.updatedAt).localeCompare(String(a.updatedAt)));
+}
+
+// 路径白名单：resolve 后必须仍在 pipeline-runs/ 内且 .json 后缀（export 供测试直测白名单面）
+export function safeRunPath(rel) {
+  const abs = path.resolve(PIPELINE_RUNS, rel);
+  if (!abs.startsWith(PIPELINE_RUNS + path.sep) || !abs.endsWith('.json')) return null;
+  return abs;
+}
+
 // ---- 配对断裂检测：按完整文件名（含日期）聚合同族，异常卡附 alerts ----
 // 与 check-loop 检查 1 的 basename 同一口径。slug（去掉日期）只给界面分组，不参与配对。
 // 规则（看板为预警层、不阻断；枚举读单源 workflow-enums.txt）：
@@ -196,16 +253,22 @@ let debounceTimer = null;
 function broadcast(event) {
   for (const res of sseClients) { if (!res.destroyed) res.write(`event: ${event}\ndata: {}\n\n`); }
 }
-try {
-  const watcher = fs.watch(WORKFLOW, { recursive: true }, () => {
-    clearTimeout(debounceTimer);
-    debounceTimer = setTimeout(() => broadcast('changed'), 500);
-  });
-  // watch 中途失效（目录被动/杀软锁）：显式告知前端降级轮询，避免假实时
-  watcher.on('error', (e) => { console.error('fs.watch 失效，已通知前端降级轮询:', e.message); broadcast('watchdead'); });
-} catch (e) {
-  console.error('fs.watch 初始化失败（前端将走 60s 兜底轮询）:', e.message);
+// 统一监听回调：workflow/ 文档 + pipeline-runs/ 执行器 run 文件任一变化 → 500ms 防抖广播 changed
+function onWatchChange() {
+  clearTimeout(debounceTimer);
+  debounceTimer = setTimeout(() => broadcast('changed'), 500);
 }
+function watchDir(dir) {
+  try {
+    const watcher = fs.watch(dir, { recursive: true }, onWatchChange);
+    watcher.on('error', (e) => { console.error(`fs.watch 失效（${dir}），已通知前端降级轮询:`, e.message); broadcast('watchdead'); });
+  } catch (e) {
+    // 同步失败（典型：目录不存在 ENOENT）与异步 error 同口径广播 watchdead——否则前端徽标滞留「实时」而推送已死
+    console.error(`fs.watch 初始化失败（${dir}，前端将走 60s 兜底轮询）:`, e.message);
+    broadcast('watchdead');
+  }
+}
+watchDir(WORKFLOW);
 // 25s 心跳：防半开连接；顺带清理已断开的 client
 setInterval(() => { for (const res of sseClients) { if (res.destroyed) sseClients.delete(res); else res.write(': ping\n\n'); } }, 25000).unref();
 
@@ -269,6 +332,21 @@ const server = http.createServer(async (req, res) => {
     }
     if (url.pathname === '/api/board') return sendJson(res, 200, await scanBoard());
 
+    // 执行器面板（2026-10-04 board-run-panel）：run 卡片列表 + 单 run 事件流
+    if (url.pathname === '/api/runs') return sendJson(res, 200, { cards: scanRuns() }); // 键名 cards 对齐 intent 2026-10-04-board-run-panel 验收#1
+    if (url.pathname === '/api/run') {
+      const rel = url.searchParams.get('file') || '';
+      const abs = safeRunPath(rel);
+      if (!abs) return sendJson(res, 403, { error: '路径不在 pipeline-runs/ 白名单内' });
+      try {
+        return sendJson(res, 200, { run: parseRunFile(fs.readFileSync(abs, 'utf8')) });
+      } catch (e) {
+        if (e && e.code === 'ENOENT') return sendJson(res, 404, { error: 'run 文件不存在' });
+        console.error(`读 run 失败（${rel}）:`, e.message); // 权限/占用等如实 500 留痕，不并成 404
+        return sendJson(res, 500, { error: `读 run 失败：${e.message}` });
+      }
+    }
+
     if (url.pathname === '/api/doc' || url.pathname === '/api/history') {
       const rel = url.searchParams.get('file') || '';
       const abs = safeDocPath(rel);
@@ -305,7 +383,11 @@ server.on('error', (e) => {
 // isMain 守卫（board-kb-p1）：parseLoopHardBlocks 可被测试 import（import 不 listen）
 const isMain = process.argv[1] && process.argv[1].endsWith('workflow-board-server.mjs');
 if (isMain) {
+  // run 目录缺失（.agents/cache/ 被 gitignore，全新装机无此目录）时 fs.watch 同步抛 ENOENT 且无重试——
+  // 补建空目录启用监听（pipeline-run 首跑本会建；失败不阻启动，由 watchDir catch 兜底广播 watchdead）
+  try { fs.mkdirSync(PIPELINE_RUNS, { recursive: true }); } catch { /* 竞态/权限等交给 watchDir 降级 */ }
+  watchDir(PIPELINE_RUNS); // 执行器 run 文件监听仅在作为服务运行时启动（import 不监听，避免测试进程挂起）
   server.listen(PORT, '127.0.0.1', () => {
-    console.log(`workflow 看板: http://127.0.0.1:${PORT}  （Ctrl+C 停止；只读 workflow/，不写任何文件）`);
+    console.log(`workflow 看板: http://127.0.0.1:${PORT}  （Ctrl+C 停止；只读 workflow/ 与 pipeline-runs/，不写任何文件；run 目录缺失时补建空目录以启用监听）`);
   });
 }

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

@@ -12,8 +12,9 @@ import os from 'node:os';
 import path from 'node:path';
 import { spawnSync } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
-import { parseLoopHardBlocks, parseAcceptance, detectAlerts } from './workflow-board-server.mjs';
+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;
@@ -161,5 +162,41 @@ const CHECK_LOOP = path.join(SCRIPT_DIR, 'check-loop.mjs');
   check('⑥未知状态仍报不在枚举内', has(bogus, '状态不在枚举内'), JSON.stringify(bogus.alerts));
 }
 
+// ---- ⑦执行器面板纯函数（2026-10-04 board-run-panel）----
+{
+  // 真实 run 文件形态（对齐 .agents/cache/pipeline-runs/20261002-1819-runtime-env-md-c2ju.json）
+  const real = {
+    runId: '20261002-1819-runtime-env-md-c2ju',
+    requirement: '在 runtime-env.md 补记 pipeline-run 运行态',
+    stage: 'done',
+    stopType: 'done',
+    triage: { kind: 'require', level: 'L0', module: 'pipeline', topic: 'runtime-note', decidedBy: 'ai' },
+    updatedAt: '2026-10-02T10:19:22.566Z',
+    events: [
+      { t: '2026-10-02T10:19:02.680Z', type: 'run-created', requirement: 'x' },
+      { t: '2026-10-02T10:19:02.682Z', type: 'work-order', id: 1, kind: 'triage' },
+      { t: '2026-10-02T10:19:19.512Z', type: 'gate', cmd: 'git status --porcelain', exit: 0, ms: 58 },
+      { t: '2026-10-02T10:19:22.566Z', type: 'commit', sha: '37b552a', subject: 'docs(pipeline): x' },
+      { t: '2026-10-02T10:19:22.566Z', type: 'done' },
+    ],
+  };
+  check('⑦parseRunFile：真实 run JSON 解析成功', parseRunFile(JSON.stringify(real))?.runId === real.runId);
+  check('⑦parseRunFile：坏 JSON → null', parseRunFile('{oops') === null);
+  check('⑦parseRunFile：非对象/缺 runId → null', parseRunFile('"str"') === null && parseRunFile('{}') === null && parseRunFile('{"a":1}') === null);
+  const card = runCard(real);
+  check('⑦runCard：字段映射齐全', card.runId === real.runId && card.stage === 'done' && card.stopType === 'done' && card.eventCount === 5 && card.requirement === real.requirement);
+  check('⑦runCard：updatedAt 取 updatedAt', card.updatedAt === real.updatedAt);
+  // 阶段条复用 pipeline-run stageBar（done → Plan/Design/Build 全 [✓]，Test 为当前 [●]）
+  check('⑦stageBar：done run 前三个阶段 [✓] 且 Test 为当前', card.stageBar.includes('[✓Plan]') && card.stageBar.includes('[✓Design]') && card.stageBar.includes('[✓Build]') && card.stageBar.includes('[●Test]'));
+  // 空事件容错
+  const empty = runCard({ runId: 'r1', requirement: '', stage: 'triage', stopType: 'work-order', events: null });
+  check('⑦runCard：events 非数组容错为 0', empty.eventCount === 0);
+  // safeRunPath 路径穿越白名单（2026-10-04 review-fix-batch：安全相关函数此前无测试；用例只用平台无关的正向斜杠相对路径）
+  check('⑦safeRunPath：合法 runId.json 通过', typeof safeRunPath('20261002-1819-x-abcd.json') === 'string' && safeRunPath('20261002-1819-x-abcd.json').endsWith('.json'));
+  check('⑦safeRunPath：.. 穿越拒绝', safeRunPath('../../package.json') === null && safeRunPath('a/../../package.json') === null);
+  check('⑦safeRunPath：根相对路径拒绝', safeRunPath('/etc/passwd') === null);
+  check('⑦safeRunPath：非 .json 拒绝', safeRunPath('20261002-1819-x-abcd.md') === null && safeRunPath('20261002-1819-x-abcd') === null);
+}
+
 console.log(`\n合计: PASS ${pass} / FAIL ${fail}`);
 process.exit(fail ? 1 : 0);

package/templates/workflow/plans/_TEMPLATE.md

@@ -6,7 +6,7 @@
 # PLAN — <与入口文档同名主题>
 <!-- 与 intents/ 或 incidents/ 下同名入口文档配对；L2/L3 必须先有 ../specs/ 同名 spec 确认通过；AI 起草、用户对话内确认后开工 -->
 <!-- frontmatter 受限子集（2026-09-13）：状态∈draft/approved/done/superseded/cancelled（严格枚举，附注写备注键）；级别∈L0/L1/L2/L3；正文不再写状态/级别行 -->
-<!-- L1 极简形态（Quick-Plan，与 fill-plan.mjs 单源一致）：单/少文件微改动只填「改动方案」+「约束与风险」+「验证计划」三节——改动方案逐条列改哪个文件做什么（判据细节直接写进条目），验证计划一行静态门 + 按需 UI 实测；任务拆解/执行顺序仅 L1 多文件多步骤时保留 -->
+<!-- L1 极简形态（Quick-Plan，与 fill-plan.mjs 单源一致）：单/少文件微改动只填「改动方案」+「约束与风险」+「验证计划」三节（L1 主节标题模板正文用「改动面」，fill-plan 生成「改动方案」——check-loop 证据校验对 改动面/任务拆解/改动方案 三种节名均识别为声明文件来源）——改动方案逐条列改哪个文件做什么（判据细节直接写进条目），验证计划一行静态门 + 按需 UI 实测；任务拆解/执行顺序仅 L1 多文件多步骤时保留 -->
 
 对应入口：../intents/YYYY-MM-DD-<主题>.md 或 ../incidents/YYYY-MM-DD-<主题>.md（保留实际一项）
 对应 spec：../specs/YYYY-MM-DD-<主题>.md（L1 可省略）