sillyspec 3.32.1 → 3.32.3

package/src/knowledge-match.js

@@ -62,7 +62,7 @@ function isDecisionRoute(entry) {
 }
 
 const DECISION_HEADER_RE = /^##\s+(D-\d+@v\d+)\s*(.*)$/
-const DECISION_FIELD_RE = /^(状态|文件|理由|否决理由|复潮条件)\s*[：:]\s*(.*)$/
+const DECISION_FIELD_RE = /^(状态|文件|理由|否决理由|复潮条件|supersedes)\s*[：:]\s*(.*)$/
 // 「锚点：」单独标签精确匹配读入（仿 docs-check.js parseDecisionEntries 先例）——绝不并入
 // DECISION_FIELD_RE：其 else-if 链末尾的 reason 回填（else if (!cur.reason)）会把锚点值
 // 误吞进 reason（Grill X-002 隐性回归）。
@@ -87,15 +87,19 @@ const ANCHOR_FILE_TOKEN_RE = /[\w./-]+\.(?:mjs|cjs|jsx|tsx|js|ts|py|go|java|rs)/
  * 锚点值 → 代码文件路径集（条目无「文件：」字段时的兜底命中源）。
  * 真实先例：D-905 形态「锚点：src/quicklog.js:493」→ 提取 src/quicklog.js
  * （token 字符类不含 : 故止于行号前，再防御性剥 :line/:line-line/:符号 后缀）。
- * 「未记录」/无路径形态 token → []。
+ * 「未记录」/无路径形态 token → []。导出供 knowledge-graph.js 采集 anchors 边复用。
  */
-function anchorFilePaths(anchor) {
+export function anchorFilePaths(anchor) {
   const a = String(anchor || '').trim().replace(/\\/g, '/')
   if (!a || a === '未记录') return []
   const out = new Set()
   for (const token of a.match(ANCHOR_FILE_TOKEN_RE) || []) {
-    const p = token.replace(/:(?:\d+(?:-\d+)?|[A-Za-z_$][A-Za-z0-9_$]*)$/, '')
-    if (p) out.add(p)
+    // 前导斜杠剥除（2026-10-09-graph-docrefs-noise）：repo:// URL 被正则吃成 //sillyhub/... 碎片，
+    // 剥后 sillyhub/ 顶级由图侧按跨仓口径处理；纯数字/裸扩展段丢弃（解析噪声）
+    const p = token
+      .replace(/:(?:\d+(?:-\d+)?|[A-Za-z_$][A-Za-z0-9_$]*)$/, '')
+      .replace(/^\/+/, '')
+    if (p && !/^\d+$/.test(p)) out.add(p)
   }
   return [...out]
 }
@@ -129,7 +133,7 @@ function parseDecisionFile(filePath, file) {
     const h = line.match(DECISION_HEADER_RE)
     if (h) {
       flush()
-      cur = { file, id: h[1], title: h[2].trim(), status: '', reason: '', revisitWhen: '', files: [], anchor: '', change: '' }
+      cur = { file, id: h[1], title: h[2].trim(), status: '', reason: '', revisitWhen: '', files: [], anchor: '', change: '', supersedesText: '' }
       continue
     }
     if (!cur) continue
@@ -145,6 +149,7 @@ function parseDecisionFile(filePath, file) {
     const value = f[2].trim()
     if (f[1] === '状态') cur.status = value.toLowerCase()
     else if (f[1] === '文件') cur.files = splitDecisionFiles(value)
+    else if (f[1] === 'supersedes') cur.supersedesText = value
     else if (f[1] === '否决理由') cur.reason = value
     else if (f[1] === '复潮条件') cur.revisitWhen = value
     else if (!cur.reason) cur.reason = value // 理由：仅作 implemented（或否决理由缺失）时的回填

package/src/knowledge-vector.js

@@ -1,8 +1,9 @@
 /**
  * knowledge-vector.js — 平台向量召回层（CLI 侧，2026-09-29-knowledge-vector-recall）
  *
- * 检索三层：路由 tag 命中 →（零命中）平台向量召回（本模块，已连接平台时）→ 本地词片
- * 复现窗口（knowledge-match.js fallbackByQueryShingles）→ 空。
+ * 检索四层（2026-10-08-knowledge-graph 起）：路由 tag 命中 →（零命中）平台向量召回（本模块，
+ * 已连接平台时）→ scope 遍历召回（knowledge-graph.js，scopeFiles 在场时）→ 本地词片复现窗口
+ * （knowledge-match.js fallbackByQueryShingles）→ 空。
  *
  * 原则（用户裁决 2026-09-29）：平台只做语义召回——返回「哪个文件哪个条目」的候选
  * （spec_path＋anchor＋score）；条目 status/deathPath/回显资格等全部策略面在本地解析
@@ -143,8 +144,11 @@ function buildResultFromPlatform(indexDir, pvResults) {
 
 /**
  * 异步三层检索入口（四消费方使用：flow 注入段／complete 门／prompt {DECISION_HITS}／
- * knowledge search CLI）：路由 → 平台向量（已连接且开关开）→ 本地词片 → 空。
+ * knowledge search CLI）：路由 → 平台向量（已连接且开关开）→ scope 遍历 → 本地词片 → 空。
  * opts.cwd = 仓根（平台配置与 local.yaml 定位用）；缺省由 indexDir 上推两级。
+ * opts.scopeFiles（2026-10-08-knowledge-graph，FR-04 承接 FR-cli-entry-234）：变更触碰文件集
+ * ——机器算的图查询键（D-004：flow 注入段传 touched、complete 门传 decisions.md 锚点提取）。
+ * 缺省/空数组 → 遍历层整体跳过，行为与不携带该参数的旧行为逐字段一致（回归钉死）。
  */
 export async function matchKnowledgeHybrid(indexDir, taskContext, opts = {}) {
   const r = matchByRouting(indexDir, taskContext)
@@ -155,6 +159,16 @@ export async function matchKnowledgeHybrid(indexDir, taskContext, opts = {}) {
     const built = pv ? buildResultFromPlatform(indexDir, pv.results) : null
     if (built) return built
   }
+  // scope 遍历层（第三层）：只在 scope 非空且向量零命中后接管；fail-soft（图构建异常静默降级词片）
+  const scopeFiles = Array.isArray(opts.scopeFiles) ? opts.scopeFiles.filter(Boolean) : []
+  if (scopeFiles.length > 0) {
+    try {
+      const { buildKnowledgeGraph, scopeRecall, buildScopeRecallResult } = await import('./knowledge-graph.js')
+      const specRoot = String(indexDir).replace(/[\\/]knowledge[\\/]?$/, '')
+      const built = buildScopeRecallResult(scopeRecall(buildKnowledgeGraph(specRoot), scopeFiles))
+      if (built) return built
+    } catch { /* 图构建 fail-soft——降级词片层 */ }
+  }
   const fb = fallbackByQueryShingles(indexDir, taskContext)
   return fb || r
 }

package/src/module-impact.js

@@ -155,7 +155,9 @@ export function syncModuleDocSidecars({ cwd, changeName, note, specDir = null })
     const cardPath = join(modulesDir, `${mod}.md`)
     try {
       const card = readFileSync(cardPath, 'utf8')
-      const stamped = card.replace(/^updated_at:.*$/m, `updated_at: ${new Date().toISOString().slice(0, 19) + '+08:00'}`)
+      // 全量 ISO（机器可比时间戳，scan-postcheck 同字段同口径）——旧式 UTC 数字拼硬编码
+      // '+08:00' 的瞬间恒早真实时刻 8h（数字取 UTC、偏移写死，机器无关地错）
+      const stamped = card.replace(/^updated_at:.*$/m, `updated_at: ${new Date().toISOString()}`)
       if (stamped !== card) writeFileSync(cardPath, stamped)
     } catch { /* 卡不存在——sidecar 照写，卡内容留给 agent */ }
     synced.push(proj ? `${proj}/${mod}` : mod)

package/src/progress/stage-machine.js

@@ -369,12 +369,19 @@ export class StageMachine {
       if (!(isProgress || f.startsWith('spec-sync-conflict-')) || !f.endsWith('.json')) continue;
       let change = f.replace(/^spec-sync-conflict-|^sync-conflict-/, '').replace(/\.json$/, '');
       let createdAt = null;
+      let kind = null;
       try {
         const cf = JSON.parse(readFileSync(join(runtimeDir, f), 'utf8'));
         change = cf.change || change;
         createdAt = cf.created_at || null;
+        kind = typeof cf.kind === 'string' ? cf.kind : null;
       } catch { /* 损坏文件按文件名兜底，不崩 */ }
-      conflicts.push({ change, created_at: createdAt, type: isProgress ? 'progress' : 'spec-tree' });
+      // 2026-10-09-tombstone-conflict-root-fix FR-01：kind='tombstone' 优先透传
+      // （归因记账新形态——daemon 摘要/前端据此区分墓碑冲突与版本冲突）；文件名
+      // 前缀判定保留兜底（旧格式/损坏文件）。
+      const type = kind === 'tombstone' ? 'tombstone'
+        : isProgress ? 'progress' : 'spec-tree';
+      conflicts.push({ change, created_at: createdAt, type });
     }
     return conflicts;
   }

package/src/run/code-face-key.js

@@ -0,0 +1,84 @@
+/**
+ * code-face-key.js — 代码面口径单点（2026-10-09-verify-reuse-friction FR-03 / D-002@v1）。
+ *
+ * 问题：两类复用指纹（green-cache 的 computeGateFingerprint / 质量扫描的
+ * computeQualityScanFingerprint）原先以 git HEAD 为「代码态」分量——收口窗口内任何提交
+ * （哪怕纯文档的声明修正）都换 HEAD → 缓存必 miss（2026-10-09 multi-agent-platform
+ * tombstone 取证：13:35-14:10 五笔提交每笔击穿，2-3 轮 ×3.5min 重测纯浪费）。
+ *
+ * 修复：HEAD 分量替换为「代码树内容键」——`git ls-tree -r -z HEAD` 条目按既有非代码
+ * 路径口径（.sillyspec/、docs/、*.md——与 filterCodePorcelain 同源判据）过滤后哈希。
+ * ls-tree 条目自带 git 对象哈希（内容寻址）：纯文档提交不进过滤集 → 键不变 → 缓存存活；
+ * 代码提交必进/必变 → 键变 → 必失配。整树 oid（HEAD^{tree}）作快路径：oid 与上次相同
+ * → 直接沿用上次键（纯缓存优化，语义不变——oid 相同 ⇔ 整树逐字节相同）。
+ *
+ * 红线合规：非代码判据是**路径口径**（沿既有单点），不是语言/框架/扩展名枚举；
+ * ls-tree 是 git 对象枚举，与语言无关。-z（NUL 分隔）输出不加引号不转义——非 ASCII
+ * 路径的 endsWith 判据不被尾部引号击穿（独立审查指出的 quotepath 边界）。
+ *
+ * fail-open：git 不可用/任何异常 → null（调用方按 miss 处理，多跑一轮不误复用——
+ * 与两指纹既有的 git 不可用语义同向）。
+ */
+import { execFileSync } from 'node:child_process';
+import { createHash } from 'node:crypto';
+
+function safeGit(cwd, args) {
+  try {
+    return execFileSync('git', args, { cwd, encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'], timeout: 60000, windowsHide: true });
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * 非代码路径判据（口径单点）：.sillyspec/、docs/ 与 *.md——verify 窗口内的合法产出
+ * （规范文档/声明修正）不算代码面。green-cache.filterCodePorcelain 与质量扫描
+ * porcelainCodeLines 均消费本判据，不再各自实现。
+ */
+export function isNonCodePath(p) {
+  return p.startsWith('.sillyspec/') || p.startsWith('docs/') || /\.md$/i.test(p);
+}
+
+/**
+ * porcelain 行过滤为「代码面」（原 green-cache.js 实现迁入，语义不变）：
+ * rename 行「old -> new」两侧任一是文档面即整行剔除（防 rename 伪装穿透）；排序保序。
+ */
+export function filterCodePorcelain(porcelain) {
+  return String(porcelain || '')
+    .split(/\r?\n/)
+    .filter((line) => {
+      if (!line.trim()) return false;
+      const raw = line.slice(3).trim();
+      if (!raw) return false;
+      const parts = raw.split(' -> ').map((p) => p.replace(/^"|"$/g, ''));
+      return !parts.every((p) => isNonCodePath(p));
+    })
+    .sort();
+}
+
+/** 整树 oid 快路径缓存：cwd → { treeOid, key }（模块级；进程短命令生命周期内有效） */
+const treeKeyMemo = new Map();
+
+/**
+ * 代码树内容键：`git ls-tree -r -z HEAD` 条目（mode type oid\tpath）过滤非代码路径后
+ * 对逐条目原文（含 git 对象哈希——内容寻址）做 sha256。
+ * @returns {string|null} git 不可用/无 HEAD → null（调用方 fail-open miss）
+ */
+export function computeCodeTreeKey({ cwd }) {
+  const treeOid = safeGit(cwd, ['rev-parse', 'HEAD^{tree}']);
+  if (treeOid === null) return null;
+  const oid = treeOid.trim();
+  const memo = treeKeyMemo.get(cwd);
+  if (memo && memo.treeOid === oid) return memo.key;
+  const out = safeGit(cwd, ['ls-tree', '-r', '-z', 'HEAD']);
+  if (out === null) return null;
+  const entries = String(out).split('\0').filter((e) => {
+    if (!e) return false;
+    const tab = e.indexOf('\t');
+    if (tab === -1) return false;
+    return !isNonCodePath(e.slice(tab + 1));
+  });
+  const key = createHash('sha256').update(entries.join('\n')).digest('hex');
+  treeKeyMemo.set(cwd, { treeOid: oid, key });
+  return key;
+}

package/src/run/complete.js

@@ -479,10 +479,23 @@ export async function completeStep(pm, progress, stageName, cwd, outputText, inp
         _kgQuery = _kgQuery.slice(0, 4000)
         if (_kgQuery.trim()) {
           const { matchKnowledgeHybrid } = await import('../knowledge-vector.js')
-          const km = await matchKnowledgeHybrid(join(specBase, 'knowledge'), _kgQuery, { cwd })
+          const { scopeFromDecisionsMd } = await import('../knowledge-graph.js')
+          // scope 键=机器算（D-004 需求期入口）：decisions.md「锚点：」字段路径提取——方案步的
+          // 结构化声明面，不解析自由文本。词面零命中时沿强边保底防复潮（FR-04）。
+          const km = await matchKnowledgeHybrid(join(specBase, 'knowledge'), _kgQuery, { cwd, scopeFiles: scopeFromDecisionsMd(_dm) })
           // 零分不弹（2026-09-28-knowledge-gate-denoise）：score 零且非死路的 rejected 与查询零主题
           // 重叠——空标题条目靠状态蹭进回显是行为实测三例的噪音源；死路条目不受限（防复潮先验）。
           const _hits = (km.decisionHits || []).filter((h) => h.deathPath || (h.status === 'rejected' && h.score > 0))
+          // impact 防复潮可达集（2026-10-09-brainstorm-impact-antirevival）：锚点+模块域双结构键
+          // → graphImpact 闭包内 rejected/死路保底进场——方案步锚点常空（confirmed 才必填），
+          // 模块域是生成规范文件步硬校验的在场键；viaImpact 条目绕过 score 门槛（结构可达即
+          // 防复潮先验，与死路同待遇）。图构建 fail-soft（失败不阻断门）。
+          try {
+            const { buildKnowledgeGraph, impactFromDecisionsMd } = await import('../knowledge-graph.js')
+            const _viaImpact = impactFromDecisionsMd(buildKnowledgeGraph(specBase), _dm)
+              .filter((h) => !_hits.some((x) => x.file === h.file && x.id === h.id && (x.change || '') === (h.change || '')))
+            _hits.push(..._viaImpact)
+          } catch { /* 图构建/键解析 fail-soft——词面命中面不受影响 */ }
           // 已回应不重弹：decisions.md 正文已含「命中 id＋域文件名」共现（小白鼠回应形态
           // 「unmapped.md D-001@v1」）→ 视为已甄别过，静默；同轮查询串仍含其词面属预期。
           const _answered = _dm
@@ -500,7 +513,8 @@ export async function completeStep(pm, progress, stageName, cwd, outputText, inp
               const _note = h.status === 'rejected'
                 ? ` 否决理由：${h.reason || '（未记录）'}`
                 : h.deathPath ? ` ⚰️死路注记：${deathPathNote(h.reason)}` : ''
-              console.warn(`   - ${h.id} ${h.title}（${h.file}）status=${h.status || '?'}${_note}`)
+              const _via = h.viaImpact ? ` 🧭impact 可达（键：${h.impactKey}）` : ''
+              console.warn(`   - ${h.id} ${h.title}（${h.file}）status=${h.status || '?'}${_note}${_via}`)
             }
             for (const e of _entries.slice(0, 3)) {
               const _base = e.anchor ? `${e.file}#${e.anchor}` : e.file
@@ -1112,7 +1126,8 @@ async function printExecuteScopeAudit({ cwd, changeName, specBase, platformOpts,
     snap.closedBy = 'execute --done'
     // 沉淀资产面投影（2026-10-07-unify-close-trace）：files/totals = 主仓实改行（planned+
     // unplanned；untouched 0/0 是声明不是改动、crossRepo 行 patch 不在主仓——均不入）。
-    // 经共用 writeCloseTraceArtifacts 与 thin flow done 同一处写四件（sha256 双套同锚）；
+    // 经共用 writeCloseTraceArtifacts 与 thin flow done 同一处单套写两件（2026-10-09-
+    // close-trace-single-set：对账面并入 change-patch.json 的 scopeAudit 子对象）；
     // 投影口径抽 flow-parity.projectTraceFaceRows 纯函数（排除路径有单测钉住）。
     const face = projectTraceFaceRows(snap.rows)
     const closeTrace = writeCloseTraceArtifacts({
@@ -1129,7 +1144,7 @@ async function printExecuteScopeAudit({ cwd, changeName, specBase, platformOpts,
         note: 'execute --done 时点冻结（沉淀资产面：主仓实改行投影——thin flow done 对等；治理工件目录与其后 verify/archive 演进不在内）',
       },
     })
-    console.log(`   📦 范围快照 + 沉淀资产双轨落盘（scope-audit.json${closeTrace.patchStatus === 'ok' ? ' + scope-audit.patch' : ''} + change-patch.json${closeTrace.patchStatus === 'ok' ? ' + change.patch' : ''}${closeTrace.patchStatus === 'ok' ? '——收尾时点冻结，sha256 同锚' : '——patch 采集失败已留痕'}）`)
+    console.log(`   📦 范围快照落盘（单套）：change-patch.json${closeTrace.patchStatus === 'ok' ? ' + change.patch' : ''}（对账面并入 scopeAudit 子对象${closeTrace.patchStatus === 'ok' ? '，收尾时点冻结 sha256 已锚' : '——patch 采集失败已留痕'}）`)
   } catch (e) {
     console.warn(`   ⚠️ 范围对账快照写入失败（不阻断，verify 漂移对比将按无快照降级）：${e && e.message ? String(e.message).split('\n')[0] : e}`)
   }
@@ -1147,13 +1162,21 @@ async function printVerifyScopeDrift({ cwd, changeName, specBase, platformOpts,
     return
   }
   let snapshot = null
-  // 快照读取链（quick-359a48f1）：变更目录（审计级，execute --done 落）→ .runtime（存量兼容）
+  // 快照读取链（2026-10-09-close-trace-single-set）：change-patch.json.scopeAudit（单套
+  // 新形态）→ 旧 scope-audit.json（存量归档）→ .runtime/scope-audit-<change>.json（更早
+  // 存量兼容）——scopeAuditPathSet 只吃 rows，子对象与旧顶级形态同构直用
   try {
-    snapshot = JSON.parse(readFileSync(join(specBase, 'changes', changeName, 'scope-audit.json'), 'utf8'))
-  } catch {
+    const merged = JSON.parse(readFileSync(join(specBase, 'changes', changeName, 'change-patch.json'), 'utf8'))
+    if (merged && typeof merged.scopeAudit === 'object' && merged.scopeAudit) snapshot = merged.scopeAudit
+  } catch { /* 新形态缺失 → 旧名兜底 */ }
+  if (!snapshot) {
     try {
-      snapshot = JSON.parse(readFileSync(join(resolveRuntimeRoot(platformOpts, specBase), `scope-audit-${changeName}.json`), 'utf8'))
-    } catch { /* 快照缺失/损坏 → 跳过对比只打当前 totals */ }
+      snapshot = JSON.parse(readFileSync(join(specBase, 'changes', changeName, 'scope-audit.json'), 'utf8'))
+    } catch {
+      try {
+        snapshot = JSON.parse(readFileSync(join(resolveRuntimeRoot(platformOpts, specBase), `scope-audit-${changeName}.json`), 'utf8'))
+      } catch { /* 快照缺失/损坏 → 跳过对比只打当前 totals */ }
+    }
   }
   if (!snapshot || snapshot.ok !== true) {
     console.log(`   ${scopeLine}（无 execute 时点快照可对比——完整表跑 sillyspec scope-audit --change ${changeName}）`)

package/src/run/gate-snapshot.js

@@ -41,6 +41,25 @@ function git(cwd, args) {
   return execFileSync('git', args, { cwd, encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'], timeout: 60000, windowsHide: true }).trim()
 }
 
+/**
+ * 快照回退主仓的可见性 + 摩擦记账（2026-10-09-verify-reuse-friction FR-02）。
+ * 2026-10-09 取证：快照创建慢性失败静默回退主仓口径——apply 前实测的是「无变更代码」的
+ * HEAD 且绿结论可被 --done 复用消费（正确性风险），全程零可见零记账，只能靠 .runtime 考古
+ * 发现。本 helper 统一两处调用点（gates.js verify 实测门 / verify-quality-scan.js noAI 动作）
+ * 的告警块与 gate_snapshot_fallback 摩擦事件；记账 best-effort 不影响门禁。
+ */
+export async function reportGateSnapshotFallback({ cwd, changeName, platformOpts = null, where, reason }) {
+  console.warn(`⚠️ [gate-snapshot-fallback] ${where}：隔离快照创建失败——实测回退主仓口径。`)
+  console.warn(`   影响并行 WIP 可能混入判定；apply 前主仓 HEAD 可能不含本变更代码——实测结论须按主仓口径解读，收口前确认变更代码已落主仓。`)
+  console.warn(`   原因：${reason}`)
+  console.warn(`   排查：git worktree 可用性（.git/worktrees 可写）与变更文件集非空；确要主仓口径显式设 SILLYSPEC_VERIFY_GATE_SNAPSHOT_OFF=1（口径切换会使复用指纹失配一次后收敛）。`)
+  try {
+    const { recordFrictionEvent } = await import('../friction-tally.js')
+    await recordFrictionEvent({ cwd, platformOpts, changeName, type: 'gate_snapshot_fallback', detail: `${where}: ${String(reason).slice(0, 160)}` })
+  } catch { /* 记账失败不影响门禁 */ }
+}
+
+
 /** worktree 注册是否仍登记该 root（跨平台路径归一 + win32 大小写不敏感） */
 function worktreeListContains(cwd, snapshotRoot) {
   const out = git(cwd, ['worktree', 'list', '--porcelain'])

package/src/run/gates.js

@@ -872,6 +872,78 @@ export async function runStageCompletionGates({ stageName, cwd, changeName, plat
     }
   }
 
+  // 前移（2026-10-09-verify-reuse-friction FR-05）：reconcileRuntimeRoot 提升为函数级——探针一致性/draft 门等后续消费方与对账门同源口径
+  const reconcileRuntimeRoot = resolveRuntimeRoot(platformOpts, specBase)
+  if (stageName === 'verify' && changeName) {
+    // ── 纯事实门前移（2026-10-09-verify-reuse-friction FR-05 / D-004@v1）：required-evidence
+    //    与 target_files 对账门只依赖 git/文档事实（存在×mtime×diff 交集 / git 三源差集），
+    //    与实测结果零数据依赖——移到实测门（test/lint）之前并入文档面收集（R16 聚合一次全列）。
+    //    2026-10-09 取证：target_files 声明缺失时每处偏差先付 3.5 分钟实测再被拦（14:00-14:10
+    //    每轮先测后拦）；前移后秒级失败零测试执行。依赖实测结果的门（PASS 封顶/parity/超时
+    //    降档）位置不动。
+    // ── required-evidence 对账（2026-09-08-ir-verify-facts FR-03：v2 起 cannot_verify 不闭环阻断）──
+    // verify-required-evidence.json 由退役前的 execute Task Review Gate 写入
+    // （2026-09-26-task-review-retire 起停写；在场则消费=历史变更兼容读，缺席=无 cannot_verify 任务）。
+    // v2 槽优先分类核验（FR-02）：blocked = missing 无豁免或 satisfied 核验不过 → 阻断 verify 完成
+    // （此前 advisory 只查「提及」——死链不闭环）；无槽存量 md 降级 legacy 子串对账（warning 不阻断）。
+    const { runVerifyRequiredEvidenceCheck, printVerifyRequiredEvidenceCheck, trackVerifyResultRegression } = await import('../verify-postcheck.js')
+    const evidenceCheck = runVerifyRequiredEvidenceCheck({ cwd, specBase, changeName, verifyStartAt: verifyStartAtIso })
+    printVerifyRequiredEvidenceCheck(evidenceCheck)
+    // verify-result.md 内容回退检测（2026-09-10 用户反馈③：报告被平台同步覆盖回旧版一次，
+    // 只能靠人眼发现重写）：高水位指纹（hash+mtime）检出「内容变且 mtime 回退」→ ⚠️ 告警。
+    // 纯 advisory——真回退也由 agent 决定重写，CLI 只保证可见。
+    try {
+      const vr = trackVerifyResultRegression(specBase, changeName, join(specBase, 'changes', changeName, 'verify-result.md'))
+      if (vr.regressed) {
+        console.warn(`\n⚠️ verify-result.md 疑被覆盖回旧版（内容变化 + mtime 回退至 ${new Date(vr.prevMtime).toLocaleString('zh-CN')} 之前）——平台/daemon 按服务端旧版本回写的指纹。`)
+        console.warn(`   若你刚重写过请忽略本行（下次读取刷新高水位）；否则当前盘上可能是旧内容，需对照记忆/git 重新补写。`)
+      }
+    } catch { /* 检测失败静默（advisory） */ }
+    if (evidenceCheck.status === 'blocked') {
+      console.error(`\n❌ verify 阶段被阻断：cannot_verify 证据账未闭环（${evidenceCheck.summary}）。`)
+      for (const d of (evidenceCheck.detailed || [])) {
+        console.error(`   - ${d.task} [${d.status}${d.exempt ? '/豁免' : ''}] ${d.reason}`)
+        for (const v of (d.verification || [])) {
+          if (v && v.reason) console.error(`     · ${v.path || '(无路径)'} [${v.pathClass || '?'}] ${v.reason}（filesExist=${v.filesExist} mtimeOk=${v.mtimeOk} diffHit=${v.diffHit}）`)
+        }
+      }
+      console.error(`   修复：在 verify-result.md「## 证据账（cannot_verify 任务）」槽段逐 task 一行——`)
+      console.error(`   - task-NN: satisfied | verifiedFiles: <精确路径>（CLI 核验：代码类 存在×mtime×diff 交集；日志/文档类豁免 diff）`)
+      console.error(`   - 确实无法验证 → 填 missing 并加（豁免：<一句话理由>）后缀；部分满足 → partial + 已核验路径`)
+      docGateFailures.push({ type: 'gate_rollback', detail: 'verify-contract', label: `cannot_verify 证据账未闭环（${evidenceCheck.summary}）` })
+    }
+    // ── target_files 声明 ↔ 实际改动 对账（task-05 / ir-stage-p3a：②ERROR 阻断 / ③WARNING 放行）──
+    // 「计划落空」（task 卡声明没做）此前全盲区：review.json changedFiles 是 agent 手写不能当
+    // 事实源，execute 的 scope creep 只有 symbol-impact 试图抓。reconcileTargetFiles 用 git 三源
+    // 口径亲自取 actual，与 plan 阶段 task 卡 target_files 声明做三类差集：②类（声明未做）在场
+    // 即阻断——verify 的语义是「按计划交付且客观核验」，声明没做不能盖章归档；③类（做了没
+    // 声明=scope creep）启发式噪音面大（并行 WIP 剔除后仍可能有工具产物），WARNING 放行留审计；
+    // skipped/degraded（无 task 卡 / 全无声明 / git 不可用）降级不误红（存量变更零红门禁）。
+    // 阻断形态照 runVerifyTestCheck 先例：逐条列 task + path + 修复提示 + rollbackCompletionAndReturn。
+    const { reconcileTargetFiles, isStrictChange } = await import('../verify-postcheck.js')
+    const reconcileCheck = reconcileTargetFiles({
+      cwd, specBase, changeName,
+      // runtimeRoot 口径与上方 parity 对账同源（B3 apply-pathspec 兜底源在此根下；平台模式下
+      // specBase 与 .runtime 分离，不传会读不到兜底清单 → 假降级）
+      runtimeRoot: reconcileRuntimeRoot,
+      // IR 严格档（2026-09-07-ir-hardening D-003@v1）：主仓卡全零声明 → strictViolation → ERROR
+      strictMode: isStrictChange({ pm, cwd, changeName }),
+    })
+    const reconcileEnvelope = buildReconcileTargetFilesEnvelope(reconcileCheck)
+    const reconcileBlocked = printReconcileTargetFilesCheck(reconcileCheck, reconcileEnvelope)
+    // 跨仓 per-repo 对账明细渲染（坑 cross-repo-reconcile-blindness，2026-09-15 复盘兑现 D-004
+    // 分期）：reconcileTargetFiles 的 crossRepo 字段（advisory 不阻断）——各仓 对上/②缺/③多
+    // 逐仓一行 + ②缺明细（跨仓声明落空是该去对应仓干活的信号，但不翻主仓状态——锚点窗口
+    // 脆弱期会假信号）。无跨仓卡时 crossRepo 为空数组零输出。
+    printCrossRepoReconcile(reconcileCheck.crossRepo)
+    // 结果落盘（design Wave 2 承诺：对齐 .runtime/verify-runs/<ts>/ 先例）——五状态全落（含
+    // 放行态），fail-soft 不影响 gate 判定；②类阻断回执同样留档供平台/审计消费
+    writeReconcileRunResult({ runtimeRoot: reconcileRuntimeRoot, changeName, envelope: reconcileEnvelope, result: reconcileCheck })
+    if (reconcileBlocked) {
+      writeVerifyGatePointer({ runtimeRoot: reconcileRuntimeRoot, changeName, blocked: true, note: 'target_files ②类（missing_declared）阻断' })
+      docGateFailures.push({ type: 'gate_rollback', detail: 'verify-contract', label: 'target_files 对账阻断（②类「声明未做」——计划落空，明细见上）' })
+    }
+  }
   // ── 收集模式检查点 A（verify）：纯文档门全清后才进入实测门（test/lint/parity/probe 保持
   //    fail-fast 不变）。brainstorm/plan/execute 不走本检查点（其实测面为空，检查点 B 收口）。──
   if (stageName === 'verify' && docGateFailures.length > 0) {
@@ -926,8 +998,19 @@ export async function runStageCompletionGates({ stageName, cwd, changeName, plat
         verifyGateSnap = await createVerifyGateSnapshot({ cwd, changeName, specBase, platformOpts })
         if (verifyGateSnap) {
           console.log(`🧪 Verify 实测隔离快照（根：${verifyGateSnap.snapshotRoot}）：HEAD + 本变更 ${verifyGateSnap.changeFileCount} 个文件${verifyGateSnap.sourceRoot ? '（overlay 自 worktree——本变更分支内容定向跑）' : ''}（并行会话脏文件不参与门判定）`)
+        } else {
+          // FR-02（2026-10-09-verify-reuse-friction）：null 回退与异常回退同等可见 + 记账
+          try {
+            const { reportGateSnapshotFallback } = await import('./gate-snapshot.js')
+            if (typeof reportGateSnapshotFallback === 'function') await reportGateSnapshotFallback({ cwd, changeName, platformOpts, where: 'verify --done 实测门', reason: 'createVerifyGateSnapshot 返回 null（变更文件集为空 / 快照基建不可用）' })
+          } catch { /* 报告失败不改变回退行为（含测试 mock 模块缺导出的形态） */ }
         }
-      } catch { /* 快照链路异常 → 主仓现行为 */ }
+      } catch (e) {
+        try {
+          const { reportGateSnapshotFallback } = await import('./gate-snapshot.js')
+          if (typeof reportGateSnapshotFallback === 'function') await reportGateSnapshotFallback({ cwd, changeName, platformOpts, where: 'verify --done 实测门', reason: e && e.message ? e.message : String(e) })
+        } catch { /* 报告失败不改变回退行为（含测试 mock 模块缺导出的形态） */ }
+      }
     }
     const gateCwd = verifyGateSnap ? verifyGateSnap.snapshotRoot : cwd
     const gateSpecBase = verifyGateSnap ? join(verifyGateSnap.snapshotRoot, '.sillyspec') : specBase
@@ -970,6 +1053,20 @@ export async function runStageCompletionGates({ stageName, cwd, changeName, plat
       gateFingerprint = computeGateFingerprint({ cwd, specBase })
       if (gateFingerprint) greenHit = lookupGreenCache({ runtimeRoot: resolveRuntimeRoot(platformOpts, specBase), scope: changeName, kind: 'test', fingerprint: gateFingerprint })
     } catch { /* fail-open：缓存链异常回退真跑 */ }
+    // ── 复用观测（2026-10-09-verify-reuse-friction FR-04）：真跑轮随 test-result.json 落
+    //    fingerprint/reuse_decision；复用命中轮落 reuse-decisions-<change>.jsonl——取证直读，
+    //    不再依赖 stdout 考古（tombstone 取证只能靠 sqlite 会话记录的教训）。──
+    let _obsQualityScanFp = null
+    try {
+      const { computeQualityScanFingerprint } = await import('./verify-quality-scan.js')
+      _obsQualityScanFp = computeQualityScanFingerprint({ cwd, specBase })
+    } catch { /* 观测 best-effort */ }
+    const _obsFingerprint = { gate: gateFingerprint, quality_scan: _obsQualityScanFp }
+    const _obsJournal = (layer, hit, reason) => {
+      import('../verify-postcheck.js').then(({ appendReuseDecision }) =>
+        appendReuseDecision({ specBase, changeName, decision: { layer, hit, reason, fingerprint: _obsFingerprint } }))
+        .catch(() => { /* 观测失败不阻断 */ })
+    }
     if (ledgerReuse) {
       testCheck = {
         status: 'passed',
@@ -980,10 +1077,12 @@ export async function runStageCompletionGates({ stageName, cwd, changeName, plat
       }
       console.log(`\n♻️ Verify 测试对账：P2 账本复用（三键全等，免重跑；实测于 ${ledgerReuse.result.ranAt}）`)
       printVerifyTestCheck(testCheck)
+      _obsJournal('ledger', true, null)
     } else if (reusableScan && reusableScan.testResult) {
       testCheck = reusableScan.testResult
       console.log(`\n♻️ Verify 测试对账：复用 noAI 质量扫描步的实测结果（代码指纹匹配，免重跑；实测于 ${reusableScan.ranAt || '本变更 verify 期间'}${testCheck.resultPath ? `，台账 ${testCheck.resultPath}` : ''}）`)
       printVerifyTestCheck(testCheck)
+      _obsJournal('quality-scan', true, null)
     } else if (greenHit) {
       testCheck = {
         status: 'passed',
@@ -992,8 +1091,9 @@ export async function runStageCompletionGates({ stageName, cwd, changeName, plat
         exitCode: 0, durationMs: 0, outputTail: null,
         resultPath: null, strategy: null, cached: true,
       }
-      console.log(`\n♻️ Verify 测试对账：green-cache 同指纹复用（HEAD+代码脏面+local.yaml 全等，近期真跑绿——P2 账本未命中时的第二层免重跑；SILLYSPEC_GREEN_CACHE_OFF=1 可关闭）`)
+      console.log(`\n♻️ Verify 测试对账：green-cache 同指纹复用（代码树键+代码脏面+local.yaml 全等，近期真跑绿——P2 账本未命中时的第二层免重跑；SILLYSPEC_GREEN_CACHE_OFF=1 可关闭）`)
       printVerifyTestCheck(testCheck)
+      _obsJournal('green-cache', true, null)
     } else {
       // 测试实测是同步 execSync，长套件可跑 2~10min 且中途无输出——先预告避免 agent 误判卡死
       console.log(`\n⏳ Verify 测试对账：CLI 亲自执行 local.yaml 的 commands.test（同步，耗时可能较长，请等待…）`)
@@ -1007,7 +1107,12 @@ export async function runStageCompletionGates({ stageName, cwd, changeName, plat
         const { resolveVerifyChangedFiles } = await import('../verify-postcheck.js')
         _restrict = resolveVerifyChangedFiles(cwd, changeName, null, { includeWorkingTree: true, specBase: gateSpecBase })
       } catch { /* 解析异常走全量（restrictFiles 不传） */ }
-      testCheck = runVerifyTestCheck({ cwd: gateCwd, specBase: gateSpecBase, changeName, ctx, ...(Array.isArray(_restrict) && _restrict.length > 0 ? { restrictFiles: _restrict } : {}) })
+      const _missReason = [
+        `账本: ${traceHasActiveRows ? '停用（active trace 行——fail-closed 护栏）' : '未命中/不可用'}`,
+        `质量扫描: ${reusableScan ? '命中（上层未消费）' : '指纹失配/无记录'}`,
+        `green-cache: ${greenHit ? '命中（上层未消费）' : '指纹失配/过期/无记录'}`,
+      ].join('；')
+      testCheck = runVerifyTestCheck({ cwd: gateCwd, specBase: gateSpecBase, changeName, ctx, observability: { fingerprint: _obsFingerprint, reuse_decision: { layer: 'real-run', hit: false, reason: _missReason } }, ...(Array.isArray(_restrict) && _restrict.length > 0 ? { restrictFiles: _restrict } : {}) })
       printVerifyTestCheck(testCheck)
       // 自动绑定补全（full-autopilot-parity，R21 thin 迁移）：测试已跑、test-result.json 已落盘，
       // verify --done 收口时从测试结果自动补全 requirements.md 的空绑定槽——与 thin 同逻辑（逐行扫描）。
@@ -1231,69 +1336,6 @@ export async function runStageCompletionGates({ stageName, cwd, changeName, plat
     const { runVerifyDeletionCheck, printVerifyDeletionCheck } = await import('../verify-postcheck.js')
     const deletionCheck = runVerifyDeletionCheck({ cwd, specBase, changeName })
     printVerifyDeletionCheck(deletionCheck)
-    // ── required-evidence 对账（2026-09-08-ir-verify-facts FR-03：v2 起 cannot_verify 不闭环阻断）──
-    // verify-required-evidence.json 由退役前的 execute Task Review Gate 写入
-    // （2026-09-26-task-review-retire 起停写；在场则消费=历史变更兼容读，缺席=无 cannot_verify 任务）。
-    // v2 槽优先分类核验（FR-02）：blocked = missing 无豁免或 satisfied 核验不过 → 阻断 verify 完成
-    // （此前 advisory 只查「提及」——死链不闭环）；无槽存量 md 降级 legacy 子串对账（warning 不阻断）。
-    const { runVerifyRequiredEvidenceCheck, printVerifyRequiredEvidenceCheck, trackVerifyResultRegression } = await import('../verify-postcheck.js')
-    const evidenceCheck = runVerifyRequiredEvidenceCheck({ cwd, specBase, changeName, verifyStartAt: verifyStartAtIso })
-    printVerifyRequiredEvidenceCheck(evidenceCheck)
-    // verify-result.md 内容回退检测（2026-09-10 用户反馈③：报告被平台同步覆盖回旧版一次，
-    // 只能靠人眼发现重写）：高水位指纹（hash+mtime）检出「内容变且 mtime 回退」→ ⚠️ 告警。
-    // 纯 advisory——真回退也由 agent 决定重写，CLI 只保证可见。
-    try {
-      const vr = trackVerifyResultRegression(specBase, changeName, join(specBase, 'changes', changeName, 'verify-result.md'))
-      if (vr.regressed) {
-        console.warn(`\n⚠️ verify-result.md 疑被覆盖回旧版（内容变化 + mtime 回退至 ${new Date(vr.prevMtime).toLocaleString('zh-CN')} 之前）——平台/daemon 按服务端旧版本回写的指纹。`)
-        console.warn(`   若你刚重写过请忽略本行（下次读取刷新高水位）；否则当前盘上可能是旧内容，需对照记忆/git 重新补写。`)
-      }
-    } catch { /* 检测失败静默（advisory） */ }
-    if (evidenceCheck.status === 'blocked') {
-      console.error(`\n❌ verify 阶段被阻断：cannot_verify 证据账未闭环（${evidenceCheck.summary}）。`)
-      for (const d of (evidenceCheck.detailed || [])) {
-        console.error(`   - ${d.task} [${d.status}${d.exempt ? '/豁免' : ''}] ${d.reason}`)
-        for (const v of (d.verification || [])) {
-          if (v && v.reason) console.error(`     · ${v.path || '(无路径)'} [${v.pathClass || '?'}] ${v.reason}（filesExist=${v.filesExist} mtimeOk=${v.mtimeOk} diffHit=${v.diffHit}）`)
-        }
-      }
-      console.error(`   修复：在 verify-result.md「## 证据账（cannot_verify 任务）」槽段逐 task 一行——`)
-      console.error(`   - task-NN: satisfied | verifiedFiles: <精确路径>（CLI 核验：代码类 存在×mtime×diff 交集；日志/文档类豁免 diff）`)
-      console.error(`   - 确实无法验证 → 填 missing 并加（豁免：<一句话理由>）后缀；部分满足 → partial + 已核验路径`)
-      return await rollbackCompletionAndReturn(pm, progress, stageData, steps, currentIdx, cwd, changeName, platformOpts, { type: 'gate_rollback', detail: 'verify-contract' })
-    }
-    // ── target_files 声明 ↔ 实际改动 对账（task-05 / ir-stage-p3a：②ERROR 阻断 / ③WARNING 放行）──
-    // 「计划落空」（task 卡声明没做）此前全盲区：review.json changedFiles 是 agent 手写不能当
-    // 事实源，execute 的 scope creep 只有 symbol-impact 试图抓。reconcileTargetFiles 用 git 三源
-    // 口径亲自取 actual，与 plan 阶段 task 卡 target_files 声明做三类差集：②类（声明未做）在场
-    // 即阻断——verify 的语义是「按计划交付且客观核验」，声明没做不能盖章归档；③类（做了没
-    // 声明=scope creep）启发式噪音面大（并行 WIP 剔除后仍可能有工具产物），WARNING 放行留审计；
-    // skipped/degraded（无 task 卡 / 全无声明 / git 不可用）降级不误红（存量变更零红门禁）。
-    // 阻断形态照 runVerifyTestCheck 先例：逐条列 task + path + 修复提示 + rollbackCompletionAndReturn。
-    const { reconcileTargetFiles, isStrictChange } = await import('../verify-postcheck.js')
-    const reconcileRuntimeRoot = resolveRuntimeRoot(platformOpts, specBase)
-    const reconcileCheck = reconcileTargetFiles({
-      cwd, specBase, changeName,
-      // runtimeRoot 口径与上方 parity 对账同源（B3 apply-pathspec 兜底源在此根下；平台模式下
-      // specBase 与 .runtime 分离，不传会读不到兜底清单 → 假降级）
-      runtimeRoot: reconcileRuntimeRoot,
-      // IR 严格档（2026-09-07-ir-hardening D-003@v1）：主仓卡全零声明 → strictViolation → ERROR
-      strictMode: isStrictChange({ pm, cwd, changeName }),
-    })
-    const reconcileEnvelope = buildReconcileTargetFilesEnvelope(reconcileCheck)
-    const reconcileBlocked = printReconcileTargetFilesCheck(reconcileCheck, reconcileEnvelope)
-    // 跨仓 per-repo 对账明细渲染（坑 cross-repo-reconcile-blindness，2026-09-15 复盘兑现 D-004
-    // 分期）：reconcileTargetFiles 的 crossRepo 字段（advisory 不阻断）——各仓 对上/②缺/③多
-    // 逐仓一行 + ②缺明细（跨仓声明落空是该去对应仓干活的信号，但不翻主仓状态——锚点窗口
-    // 脆弱期会假信号）。无跨仓卡时 crossRepo 为空数组零输出。
-    printCrossRepoReconcile(reconcileCheck.crossRepo)
-    // 结果落盘（design Wave 2 承诺：对齐 .runtime/verify-runs/<ts>/ 先例）——五状态全落（含
-    // 放行态），fail-soft 不影响 gate 判定；②类阻断回执同样留档供平台/审计消费
-    writeReconcileRunResult({ runtimeRoot: reconcileRuntimeRoot, changeName, envelope: reconcileEnvelope, result: reconcileCheck })
-    if (reconcileBlocked) {
-      writeVerifyGatePointer({ runtimeRoot: reconcileRuntimeRoot, changeName, blocked: true, note: 'target_files ②类（missing_declared）阻断' })
-      return await rollbackCompletionAndReturn(pm, progress, stageData, steps, currentIdx, cwd, changeName, platformOpts, { type: 'gate_rollback', detail: 'verify-contract' })
-    }
     // ── verify-result.md 探针预填段一致性抽查（task-03 / ir-stage-p3b D-002@v1 方案A）──
     // 「#### 探针 N」机械预填段（verify-probes --init 生成）长在 agent 可编辑的正文里，其防篡改
     // 基准是正文锚点而非 verify-facts.json（删底稿绕不过防护）。checkProbeConsistency 重跑只读
@@ -1302,7 +1344,7 @@ export async function runStageCompletionGates({ stageName, cwd, changeName, plat
     // skipped（存量旧格式报告/无 changeName）/degraded（重跑异常 fail-soft）→ 放行提示。
     // 接线形态照上方 P3a reconcile 先例：envelope + print（ERROR 时 console.error 逐条 mismatch +
     // supportedFixes）+ verify-runs 落盘 + rollbackCompletionAndReturn。
-    const { checkProbeConsistency } = await import('../verify-postcheck.js')
+    const { checkProbeConsistency, isStrictChange } = await import('../verify-postcheck.js')
     const probeCheck = checkProbeConsistency({
       // 四参与 reconcile 同源取值：cwd/specBase/changeName 原样透传；runtimeRoot 复用上方
       // reconcileRuntimeRoot（resolveRuntimeRoot(platformOpts, specBase)）——checkProbeConsistency

package/src/run/green-cache.js

@@ -39,36 +39,28 @@ function safeGit(cwd, args) {
 
 /**
  * porcelain 行过滤为「代码面」：剔 .sillyspec/、docs/ 与 *.md（含 rename 两侧任一命中）。
- * 纯函数（口径单点，watcher dirtyCode / quality-scan 同源判据）；排序保序（同输入同输出）。
+ * 实现已迁 code-face-key.js（口径单点，2026-10-09-verify-reuse-friction FR-03）——此处
+ * re-export 保持既有 import 路径兼容。
  */
-export function filterCodePorcelain(porcelain) {
-  return String(porcelain || '')
-    .split(/\r?\n/)
-    .filter((line) => {
-      if (!line.trim()) return false;
-      const raw = line.slice(3).trim();
-      if (!raw) return false;
-      // rename 行「old -> new」两侧任一是文档面即整行剔除（防 rename 伪装穿透）
-      const parts = raw.split(' -> ').map((p) => p.replace(/^"|"$/g, ''));
-      return !parts.every((p) => p.startsWith('.sillyspec/') || p.startsWith('docs/') || /\.md$/i.test(p));
-    })
-    .sort();
-}
+export { filterCodePorcelain } from './code-face-key.js';
+import { filterCodePorcelain, computeCodeTreeKey } from './code-face-key.js';
 
 /**
- * 计算门禁绿缓存指纹：HEAD + 代码脏面 + local.yaml 内容。
+ * 计算门禁绿缓存指纹：代码树内容键 + 代码脏面 + local.yaml 内容。
+ * 2026-10-09-verify-reuse-friction（D-002@v1）：HEAD 分量替换为代码树内容键（ls-tree
+ * 过滤哈希）——纯文档提交不再击穿缓存，代码提交必击穿；整树 oid 快路径见 code-face-key。
  * git 不可用（非仓目录）返回 null → 调用方按 miss 处理。
  */
 export function computeGateFingerprint({ cwd, specBase }) {
-  const head = safeGit(cwd, ['rev-parse', 'HEAD']);
-  if (head === null) return null;
+  const treeKey = computeCodeTreeKey({ cwd });
+  if (treeKey === null) return null;
   const porcelain = safeGit(cwd, ['status', '--porcelain']) ?? '';
   let localYaml = '';
   try {
     const yamlPath = join(specBase, 'local.yaml');
     if (existsSync(yamlPath)) localYaml = readFileSync(yamlPath, 'utf8');
-  } catch { /* 读不到按空——指纹仍含 HEAD+脏面，miss 风险方向安全 */ }
-  return sha1([head.trim(), filterCodePorcelain(porcelain).join('\n'), localYaml].join('\u0000'));
+  } catch { /* 读不到按空——指纹仍含树键+脏面，miss 风险方向安全 */ }
+  return sha1([treeKey, filterCodePorcelain(porcelain).join('\n'), localYaml].join('\u0000'));
 }
 
 function greenCacheFile({ runtimeRoot, scope, kind }) {