agentic-flow-kit 1.0.2 → 1.1.1

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.2",
+  "version": "1.1.1",
   "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/scripts/check-loop.mjs

@@ -117,7 +117,8 @@ import { laneOfEntry } from './stage-gates.mjs';
 import { MARK_RE, approvedTraceHit } from './stage-gates.mjs';
 
 const SCRIPT_DIR = path.dirname(fileURLToPath(import.meta.url));
-const GIT = process.platform === 'win32' ? 'git.exe' : 'git';
+// CHECK_LOOP_GIT：测试注入钩子（指向不存在/不可执行路径可稳定触发 spawn 异常）；未设置时与原行为逐字节一致（2026-10-05-gitout-fail-open）
+const GIT = process.env.CHECK_LOOP_GIT || (process.platform === 'win32' ? 'git.exe' : 'git');
 
 function takeOpts() {
   const args = process.argv.slice(2);
@@ -210,19 +211,52 @@ const inSet = (v, arr) => arr.includes(v);
 const stOkDoc = (st) => inSet(st, ENUMS['doc.status.confirmed']);
 
 // git 调用（参数数组形式不走 shell——Windows cmd 不认单引号；git.exe 显式解析沿 doctor 先例）
+// 基础设施异常与业务失败分流（2026-10-05-gitout-fail-open）：spawn 异常响亮出账（进程级去重恰一条，
+// 沿检查 16 装户「载入失败响亮出账」先例）+ 瞬时类错误码单次重试；「非 git 仓」（status≠0）仍是
+// 合法装户语义、静默走降级。intentional-simple: 重试后仍异常继续走原降级/拦截语义（连续瞬时异常
+// 残余面小且有账可查）；升级路径 = 探测门（:720/:796）改三态拆分
+let gitInfraWarned = false;
+function warnGitInfra(args, code) {
+  if (gitInfraWarned) return;
+  gitInfraWarned = true;
+  console.error(`check-loop: git 探测异常 ${args[0]}（${code}）——按非 git 仓降级，检查面可能收窄`);
+}
+const GIT_TRANSIENT = new Set(['EAGAIN', 'EPERM', 'EMFILE', 'EINTR']);
+function spawnGit(args) {
+  const opts = { cwd: ROOT, encoding: 'utf8', maxBuffer: 32 * 1024 * 1024 };
+  let r = spawnSync(GIT, args, opts);
+  if (r.error) {
+    // 出账在重试终败后（与 linesOf 对称——瞬时重试恢复成功不打扰）；非瞬时类直接出账
+    if (GIT_TRANSIENT.has(r.error.code)) r = spawnSync(GIT, args, opts);
+    if (r.error) warnGitInfra(args, r.error.code || r.error.message);
+  }
+  return r;
+}
 function gitOut(args, { ok = () => true } = {}) {
-  const r = spawnSync(GIT, args,
-    { cwd: ROOT, encoding: 'utf8', maxBuffer: 32 * 1024 * 1024 });
+  const r = spawnGit(args);
   if (r.error || r.status !== 0 || !ok(r)) return null;
   return r.stdout || '';
 }
 
 // ---- frontmatter 受限子集读取（fm_get 语义：首行 --- 进入、下一 --- 闭合、键在行首、首个命中、值两侧去空白）----
+// fs 读取同走 fail-loud（2026-10-05-gitout-fail-open 实现期诊断追加，与 spawnGit 同一故障类）：
+// readFileSync 瞬时异常（宿主资源压力 EMFILE/共享冲突类）重试一次，仍失败响亮出账（进程级去重）
+// 后按 null 降级——调用方按空文档跳过该件，但异常本身不再静默
+let fsReadWarned = false;
 const fileLinesCache = new Map();
 function linesOf(file) {
   if (!fileLinesCache.has(file)) {
-    try { fileLinesCache.set(file, fs.readFileSync(file, 'utf8').split(/\r?\n/)); }
-    catch { fileLinesCache.set(file, null); }
+    let lines = null;
+    try {
+      lines = fs.readFileSync(file, 'utf8').split(/\r?\n/);
+    } catch (e) {
+      try { lines = fs.readFileSync(file, 'utf8').split(/\r?\n/); } catch { lines = null; }
+      if (!lines && !fsReadWarned) {
+        fsReadWarned = true;
+        console.error(`check-loop: 文档读取异常 ${path.basename(file)}（${e.code || e.message}）——按空文档降级，检查面可能收窄`);
+      }
+    }
+    fileLinesCache.set(file, lines);
   }
   return fileLinesCache.get(file);
 }
@@ -504,7 +538,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}`);
     }
@@ -578,7 +612,9 @@ function verifyEvidenceTruth(evidenceStr, planBase, root) {
   if (!shaMatch || /^\d+$/.test(shaMatch[1])) return { ok: true, type: 'text' };
 
   const sha = shaMatch[1];
-  const revParse = spawnSync(GIT, ['rev-parse', sha], { cwd: ROOT, encoding: 'utf8' });
+  // 直连走 spawnGit（与 gitOut 同一 loud+retry 通道，注释互引）：spawn 异常不再被静默算作业务失败；
+  // 重试后仍异常按下方 status!==0 判定（fail-closed 保持——本地核验不了就按伪造拦）
+  const revParse = spawnGit(['rev-parse', sha]);
   if (revParse.status !== 0) {
     // 区分本地伪造与外部仓库引用：
     // 剔除 SHA 与泛指词后仍有其他内容（如项目名、路径描述）→ 视为外部仓库引用，不硬拦（本地无法核验他仓哈希）；
@@ -607,7 +643,7 @@ function verifyEvidenceTruth(evidenceStr, planBase, root) {
     }
   }
 
-  const show = spawnSync(GIT, ['show', '--name-only', sha], { cwd: ROOT, encoding: 'utf8' });
+  const show = spawnGit(['show', '--name-only', sha]);
   if (show.status !== 0) return { ok: false, type: 'error', msg: `无法读取提交 ${sha} 的文件列表` };
   
   const changedFiles = show.stdout.split(/\r?\n/).filter(Boolean);
@@ -617,7 +653,7 @@ function verifyEvidenceTruth(evidenceStr, planBase, root) {
     // 过程证据（2026-10-03 check-evidence-process）：执行器驱动的提交可作验收证据——提交信息带
     // 「pipeline-run <runId>」标记（docsCommit 四种格式共有段，runId 严格形态 日期8-时间4-主题-尾；
     // 与 run 事件流同源，git 历史留痕可对质）。只救 irrelevant：forged（SHA 不存在）在前已判，其余判据不动。
-    const subj = spawnSync(GIT, ['log', '-1', '--format=%s', sha], { cwd: ROOT, encoding: 'utf8' });
+    const subj = spawnGit(['log', '-1', '--format=%s', sha]);
     if (subj.status === 0 && /pipeline-run [0-9]{8}-[0-9]{4}-[A-Za-z0-9-]+/.test(subj.stdout)) {
       return { ok: true, type: 'process' };
     }

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

@@ -68,9 +68,12 @@ ${refs ? '     - 是 → ../intents/2026-09-12-ghost.md\n' : ' - 否 → 理由:
 `;
 
 // run：默认 CHECK_LOOP_ROOT 注入（fixture 模式）；{git:true} 时 cwd 注入（真 git 模式，测 tracked 过滤）；
-// opts.args 追加 CLI 参数（--hardening 等加固门场景用，2026-09-30 hybrid-governance-explore-hardening）
+// opts.args 追加 CLI 参数（--hardening 等加固门场景用，2026-09-30 hybrid-governance-explore-hardening）；
+// opts.env 增量覆盖子进程 env（CHECK_LOOP_GIT 替身注入用，2026-10-05-gitout-fail-open）
 const run = (root, opts = {}) => spawnSync(process.execPath, [CHECK_LOOP, ...(opts.args || [])], {
-  ...(opts.git ? { cwd: root } : { cwd: ROOT_CWD, env: { ...process.env, CHECK_LOOP_ROOT: root } }),
+  ...(opts.git
+    ? { cwd: root, ...(opts.env ? { env: { ...process.env, ...opts.env } } : {}) }
+    : { cwd: ROOT_CWD, env: { ...process.env, ...(opts.env || {}), CHECK_LOOP_ROOT: root } }),
   encoding: 'utf8',
 });
 const ROOT_CWD = process.cwd();
@@ -83,13 +86,32 @@ const expectOk = (desc, root) => {
   const r = run(root);
   check(desc, r.status === 0, `exit=${r.status}\n${outOf(r)}`);
 };
+// 夹具 git 调用防瞬时失败（2026-10-05-gitout-fail-open 夹具侧加固）：宿主/CI 资源压力下 spawnSync 可能
+// 瞬时 `r.error`，git 侧也可能瞬时 status≠0（如 index.lock 争用）——对夹具 setup 调用（init/add/commit/
+// rev-parse）两者都永不合法：重试一次，持续失败抛错响亮失败。绝不静默产出空 sha / 缺提交的假夹具
+// （那会让证据场景拿到「无裁决」的错误结果——CI run 37252874044 flake 的实际根因侧，诊断详见同名 incident）
+function gitRetry(args, root) {
+  const opts = { cwd: root, encoding: 'utf8' };
+  let r = spawnSync(GIT, args, opts);
+  if (r.error || r.status !== 0) {
+    r = spawnSync(GIT, args, opts);
+    if (r.error || r.status !== 0) {
+      throw new Error(`fixture git 瞬时失败（重试后仍 ${r.error ? (r.error.code || r.error.message) : `exit ${r.status}`}）: git ${args.join(' ')}\n${(r.stderr || '').slice(0, 300)}`);
+    }
+  }
+  return r;
+}
+const shortSha = (root, args = ['rev-parse', '--short', 'HEAD']) => {
+  const out = gitRetry(args, root).stdout.trim();
+  if (!out) throw new Error(`fixture git 空输出（假夹具防线）: git ${args.join(' ')}`);
+  return out;
+};
 const gitInit = (root) => {
-  spawnSync(process.platform === 'win32' ? 'git.exe' : 'git', ['init', '-q'], { cwd: root });
+  gitRetry(['init', '-q'], root);
 };
 const gitCommitAll = (root, msg) => {
-  const G = process.platform === 'win32' ? 'git.exe' : 'git';
-  spawnSync(G, ['add', '-A'], { cwd: root });
-  spawnSync(G, ['-c', 'user.email=t@t', '-c', 'user.name=t', 'commit', '-qm', msg], { cwd: root });
+  gitRetry(['add', '-A'], root);
+  gitRetry(['-c', 'user.email=t@t', '-c', 'user.name=t', 'commit', '-qm', msg], root);
 };
 const rmfix = (root) => fs.rmSync(root, { recursive: true, force: true });
 // writeLedger：fixture 台账辅助（检查 15 配对用；行 schema 同 confirm-doc.mjs appendLedger）
@@ -253,7 +275,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'));
@@ -435,12 +457,12 @@ const mkConfirmedDoc = (root, rel, fmBody) => {
     fs.copyFileSync(path.join(SCRIPT_DIR, '..', 'rule-budgets.txt'), path.join(T, '.agents', 'rule-budgets.txt'));
     gitInit(T);
     w(T, 'AGENTS.md', 'x'.repeat(8000));
-    spawnSync(process.platform === 'win32' ? 'git.exe' : 'git', ['add', 'AGENTS.md'], { cwd: T });
+    gitRetry(['add', 'AGENTS.md'], T);
     let r = spawnSync('sh', ['.agents/scripts/rule-budget.sh', '--staged'], { cwd: T, encoding: 'utf8' });
     check('rule-budget --staged:暂存超限 → exit 1（硬拦路径）',
       r.status === 1 && `${r.stdout}${r.stderr}`.includes('常驻面超限：AGENTS.md'), `${r.stdout}${r.stderr}`);
     w(T, 'AGENTS.md', '# 小体积\n');
-    spawnSync(process.platform === 'win32' ? 'git.exe' : 'git', ['add', 'AGENTS.md'], { cwd: T });
+    gitRetry(['add', 'AGENTS.md'], T);
     r = spawnSync('sh', ['.agents/scripts/rule-budget.sh', '--staged'], { cwd: T, encoding: 'utf8' });
     check('rule-budget --staged:合规 → exit 0（不误拦）', r.status === 0, `${r.stdout}${r.stderr}`);
     rmfix(T);
@@ -582,7 +604,7 @@ const evidenceFixture = (slug, declared, createDeclared) => {
   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);
+  const sha = shortSha(T, ['rev-parse', 'HEAD']).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`);
@@ -620,7 +642,7 @@ const evidenceFixture = (slug, declared, createDeclared) => {
   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();
+  const sha = shortSha(T);
   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);
@@ -672,8 +694,7 @@ const evidenceFixture = (slug, declared, createDeclared) => {
   fs.mkdirSync(path.join(T, 'notes'), { recursive: true });
   w(T, 'notes/other.md', 'x\n');
   gitCommitAll(T, 'docs(x): 演练穿越（pipeline-run 20260926-0900-pe1-abc1）');
-  const G = process.platform === 'win32' ? 'git.exe' : 'git';
-  const sha = spawnSync(G, ['rev-parse', '--short', 'HEAD'], { cwd: T, encoding: 'utf8' }).stdout.trim();
+  const sha = shortSha(T);
   w(T, 'workflow/intents/2026-09-26-pe1.md', INTENT('pe1', '状态: done\n级别: L1\n日期: 2026-09-26', `\n## 验收标准（可测试）\n- [x] 演练穿越（证据:${sha}）\n`));
   expectOk('过程证据:提交信息带执行器标记（改动面外）→ 放行 exit 0', T);
   rmfix(T);
@@ -685,8 +706,7 @@ const evidenceFixture = (slug, declared, createDeclared) => {
   fs.mkdirSync(path.join(T, 'notes'), { recursive: true });
   w(T, 'notes/other.md', 'x\n');
   gitCommitAll(T, 'docs(x): 演练穿越（L0，无标记提交）');
-  const G = process.platform === 'win32' ? 'git.exe' : 'git';
-  const sha = spawnSync(G, ['rev-parse', '--short', 'HEAD'], { cwd: T, encoding: 'utf8' }).stdout.trim();
+  const sha = shortSha(T);
   w(T, 'workflow/intents/2026-09-26-pe2.md', INTENT('pe2', '状态: done\n级别: L1\n日期: 2026-09-26', `\n## 验收标准（可测试）\n- [x] 演练穿越（证据:${sha}）\n`));
   expectHard('过程证据:无标记无关提交 → 仍拦 证据无关', T, '证据无关');
   rmfix(T);
@@ -699,6 +719,41 @@ const evidenceFixture = (slug, declared, createDeclared) => {
   expectHard('过程证据:SHA 不存在 → forged 仍拦（防伪线不放松）', T, '证据伪造');
   rmfix(T);
 }
+// ---- 场景 5v:git 基础设施异常 fail-loud（2026-10-05-gitout-fail-open）----
+// CHECK_LOOP_GIT 指向不存在路径 → spawnSync 跨平台稳定 r.error（ENOENT）→ 响亮出账恰一条（进程去重）
+// + 证据核验降级（exit 语义不变、无业务裁决误报）；正常 git 零出账（防误报负例）
+// 注（L2 复核 P2-2）：出账断言不构成 :581 接入 spawnGit 的独立钉死——探测门与 :581 共用去重 flag，
+// 变异（:581 改回裸 spawnSync）三断言仍绿；:581 接线由代码走读 + CI 覆盖，瞬时重试路径静态替身不可测
+{
+  const T = mkfix();
+  gitInit(T);
+  w(T, 'workflow/plans/2026-09-26-pe4.md', PLAN('pe4', '状态: done\n级别: L1\n模块: material', '\n## 改动方案\n\n- src/app.mjs：实现功能\n'));
+  fs.mkdirSync(path.join(T, 'notes'), { recursive: true });
+  w(T, 'notes/other.md', 'x\n');
+  gitCommitAll(T, 'docs(x): 演练穿越（L0，无标记提交）');
+  const sha = shortSha(T);
+  w(T, 'workflow/intents/2026-09-26-pe4.md', INTENT('pe4', '状态: done\n级别: L1\n日期: 2026-09-26', `\n## 验收标准（可测试）\n- [x] 演练穿越（证据:${sha}）\n`));
+  const r = run(T, { env: { CHECK_LOOP_GIT: 'definitely-not-git-xyz-2026' } });
+  const hits = outOf(r).split('git 探测异常').length - 1;
+  check('git 基础设施异常:响亮出账恰一条（进程去重）', hits === 1, `hits=${hits}\n${outOf(r)}`);
+  check('git 基础设施异常:持续异常仍 fail-closed（伪造拦不放松，防静默降级）', r.status === 1 && outOf(r).includes('证据伪造'), `exit=${r.status}\n${outOf(r)}`);
+  check('git 基础设施异常:基础设施异常不冒充业务裁决（无证据无关误报）', !outOf(r).includes('证据无关'), outOf(r));
+  rmfix(T);
+}
+{
+  const T = mkfix();
+  gitInit(T);
+  w(T, 'workflow/plans/2026-09-26-pe5.md', PLAN('pe5', '状态: done\n级别: L1\n模块: material', '\n## 改动方案\n\n- src/app.mjs：实现功能\n'));
+  fs.mkdirSync(path.join(T, 'notes'), { recursive: true });
+  w(T, 'notes/other.md', 'x\n');
+  gitCommitAll(T, 'docs(x): 演练穿越（L0，无标记提交）');
+  const sha = shortSha(T);
+  w(T, 'workflow/intents/2026-09-26-pe5.md', INTENT('pe5', '状态: done\n级别: L1\n日期: 2026-09-26', `\n## 验收标准（可测试）\n- [x] 演练穿越（证据:${sha}）\n`));
+  const r = run(T);
+  check('git 基础设施异常:正常 git 零出账（防误报负例）', !outOf(r).includes('git 探测异常'), outOf(r));
+  check('git 基础设施异常:正常 git 行为不变（无标记无关提交仍拦证据无关）', r.status === 1 && outOf(r).includes('证据无关'), `exit=${r.status}\n${outOf(r)}`);
+  rmfix(T);
+}
 // ---- 场景 45:检查 2——真未填占位（标题 <主题>，无 .md）→ 仍报模板未填 ----
 {
   const T = mkfix();