sillyspec 3.32.2 → 3.32.4

package/src/index.js

@@ -246,7 +246,7 @@ async function main() {
 
   // E22：重路径统一加载（轻路径 --version/help 已早退，未付此税）。
   const { ProgressManager, resolvePlatformSpecDir, resolvePlatformOpts } = await import('./progress.js');
-  const { didYouMean, assertSafeChangeName, assertDatedChangeName, resolveSpecDir, detectWorktreeSpecDrift, detectCwdInsideWorktree, ancestorSpecDirs } = await import('./run/shared.js');
+  const { didYouMean, assertSafeChangeName, assertDatedChangeName, resolveSpecDir, detectWorktreeSpecDrift, detectCwdInsideWorktree, ancestorSpecDirs, resolveUninitCwdGate } = await import('./run/shared.js');
 
   // 解析全局选项
   let json = false;
@@ -354,7 +354,9 @@ async function main() {
     return baseDir
   }
 
-  const dir = targetDir;
+  // let：下方未初始化目录硬拦命中祖先链时重锚定到 spec 根（治裸 join(dir,'.sillyspec')
+  // 调用点如 review status rsSpecBase 的子目录漂移；resolveEffectiveDir 系本就上溯，变为无操作）
+  let dir = targetDir;
 
   if (command === 'init' && !existsSync(dir)) {
     const { mkdirSync } = await import('fs');
@@ -388,6 +390,33 @@ async function main() {
     }
   }
 
+  // ── 未初始化目录硬拦（坑：agent 在未初始化/错误目录跑非 init 命令，fail-soft 散点报错不说
+  //    正确 cwd——实测 status 在未初始化目录提示可开变更、flow start 到 local.yaml 才报错、
+  //    knowledge 只报参数错，agent 多轮试错）──
+  //    判定与豁免清单收敛在 run/shared.js resolveUninitCwdGate（单一真相源，测试直测）；
+  //    平台 pointer/接管声明/显式 --spec-dir/平台 flag 由其判 skip（平台项目不受本门误拦）。
+  //    未初始化目录无 ground truth——文案只给锚点（git root）与三条出路，不断言唯一正确 cwd。
+  const uninitGate = resolveUninitCwdGate(command, {
+    dir,
+    specDir,
+    // --spec-root 同为平台显式意图（平台模式首扫 run scan --spec-root 在无 pointer 的新目录
+    // 合法运行，spec 恒在仓外）——与 --workspace-id/--runtime-root 一并越过本门
+    platformFlags: platformWorkspaceId || platformRuntimeRoot || filteredArgs.includes('--spec-root'),
+  });
+  if (uninitGate.verdict === 'block') {
+    console.error(`\n❌ 当前目录未初始化（${dir}）：${uninitGate.gitRoot
+      ? `已上溯祖先链至 git root（${uninitGate.gitRoot}）`
+      : '已上溯祖先链（当前不在 git 仓内）'}未找到 .sillyspec，平台指针亦无。`);
+    console.error('   非 init/scan 类命令需要已初始化的项目根。');
+    console.error('   修复：① cd 回项目根（含 .sillyspec 的目录）再跑；② 新项目先 sillyspec init（棕地项目 sillyspec scan）；③ 或 --spec-dir <路径> 显式指定 .sillyspec 位置。');
+    console.error('   查询/诊断类命令（status/doctor/progress/next/knowledge 等）不受此拦。');
+    process.exit(2);
+  }
+  if (uninitGate.verdict === 'pass' && uninitGate.anchor && resolve(dir) !== uninitGate.anchor) {
+    console.log(`ℹ️ cwd 在子目录（${dir}），已锚定到项目根：${uninitGate.anchor}（spec 解析与产物落点以项目根为准）`);
+    dir = uninitGate.anchor;
+  }
+
   switch (command) {
     case 'init':
       await (await import('./init.js')).cmdInit(dir, { tool, tools: toolValues.length > 0 ? toolValues : null, interactive, specDir, noSkills, forceCards, platformOpts: (platformWorkspaceId || platformRuntimeRoot) ? { workspaceId: platformWorkspaceId, runtimeRoot: platformRuntimeRoot } : null });
@@ -1334,7 +1363,7 @@ task done 四合一（r5l 方案1）：review write（落 review.json+自动勾
         process.exit(2);
       }
       assertSafeChangeName(vpChange, '--change 变更名');
-      const { runVerifyProbes, renderVerifyProbesReport, generateVerifyResultSkeleton, resolveVerifyProbesSpecBase, writeVerifyFacts, formatPlatformPathNote, backupVerifyResult, refreshProbeSections } = await import('./verify-probes.js');
+      const { runVerifyProbes, renderVerifyProbesReport, generateVerifyResultSkeleton, resolveVerifyProbesSpecBase, writeVerifyFacts, formatPlatformPathNote, backupVerifyResult, refreshProbeSections, applySkeletonPreservingHuman } = await import('./verify-probes.js');
       // spec 根统一走漂移锚定（坑 worktree-spec-artifact-misplace）：在 worktree 内跑时锚回主仓，
       // 探针读取与 --init 骨架都落主仓——与 plan/execute/verify/archive 的 command.js 守卫同口径。
       // resolvePlatformSpecDir 仍先调（保留平台接管 fail-closed 检查副作用），但仅 pointer 存在时
@@ -1429,21 +1458,29 @@ task done 四合一（r5l 方案1）：review write（落 review.json+自动勾
             await mirrorInitArtifact(vpReportPath, 'verify-result.md', vpInjected);
             console.log(`\n📄 存量旧格式 verify-result.md 已补注入探针预填段: ${vpReportPath}（正文其余未动；补注后按新预填段如实核对结论）${vpPlatformNote}`);
           } else if (vpForce) {
-            // quick-B：--force 覆盖重生成全骨架（含接口矩阵等 CLI 预填段）——手填内容会重置。
+            // quick-B：--force 覆盖重生成全骨架（含接口矩阵等 CLI 预填段）。
             // 2026-10-06-verify-friction-fix：覆盖前自动备份（postmortem 实证 38 格手填复核成果
             // 被清后只能靠对话记录重建——「从 git 或备份找回」的话术备份此前并不存在）；备份
             // 失败时醒目提示手动复制再重跑（fail-soft 但不静默）。
+            // 2026-10-09-verify-papercuts ②：语义升级——机器段全量重刷 + 人工面按段携载
+            // （applySkeletonPreservingHuman：结论槽/移交项表/矩阵已填行不再被 wipe），备份
+            // 保留为兜底通道。
             const { resolveRuntimeRoot: vpForceRTR } = await import('./run/shared.js');
             const vpBackupPath = backupVerifyResult({ mdPath: vpReportPath, runtimeRoot: vpForceRTR({}, vpSpecBase), changeName: vpChange });
             const vpSkeleton = generateVerifyResultSkeleton(vpResult);
-            writeFileSync(vpReportPath, vpSkeleton);
-            await mirrorInitArtifact(vpReportPath, 'verify-result.md', vpSkeleton);
+            const vpOldText = readFileSync(vpReportPath, 'utf8');
+            const vpApplied = applySkeletonPreservingHuman(vpOldText, vpSkeleton);
+            writeFileSync(vpReportPath, vpApplied.text);
+            await mirrorInitArtifact(vpReportPath, 'verify-result.md', vpApplied.text);
             if (vpBackupPath) {
-              console.log(`\n🗄️  --force 覆盖前已自动备份: ${vpBackupPath}（手填内容被重置时从这里找回回填）`);
+              console.log(`\n🗄️  --force 覆盖前已自动备份: ${vpBackupPath}（携载语义之外的极端形态从这里找回）`);
             } else {
               console.error(`\n⚠️ 自动备份失败——若 verify-result.md 含手填内容，请立即手动复制保存后重跑本命令。`);
             }
-            console.log(`\n📄 --force 已重生成 verify-result.md 骨架: ${vpReportPath}（探针与预填段已刷新；⚠️ 手填的结论/移交项等已被重置——需保留的内容从上方备份找回后回填）${vpPlatformNote}`);
+            const vpCarriedNote = vpApplied.carriedSections.length > 0
+              ? `已填人工面按段携载保留：${vpApplied.carriedSections.join('、')}（携载表格行 ${vpApplied.carriedRows}）——与机器段新渲染不符的携载内容由 gate 一致性抽查把关`
+              : `未发现已填人工面（全文占位形态——行为与旧版全量重置一致）`;
+            console.log(`\n📄 --force 已重生成 verify-result.md 骨架: ${vpReportPath}（探针与预填段已刷新；${vpCarriedNote}）${vpPlatformNote}`);
           } else {
             console.log(`\nℹ️  verify-result.md 已存在，不覆盖: ${vpReportPath}${vpPlatformNote}（预填段过期需刷新时用 --init --force）`);
           }
@@ -2172,9 +2209,10 @@ task done 四合一（r5l 方案1）：review write（落 review.json+自动勾
       const fpSpecBase = resolvePlatformSpecDir(dir, specDir) || join(dir, '.sillyspec');
       const fpDir = join(fpSpecBase, 'changes', fpChange);
       mkdirSync(fpDir, { recursive: true });
-      const fpNow = new Date();
-      const fpDate = fpNow.toISOString().slice(0, 10);
-      const fpStamp = fpNow.toISOString().slice(0, 19).replace('T', ' ');
+      // 本地墙钟（datetime.js 坑 taskcard-created-at-utc 同族：frontmatter 人读时间禁
+      // toISOString 写 UTC 裸形状——无时区标记被读取端按本地解析，2026-10-09 平台时间线 born 锚偏 8h 实证）
+      const { nowWallClock } = await import('./datetime.js');
+      const fpStamp = nowWallClock();
       const generated = [];
       const mk = (fname, body) => {
         const p = join(fpDir, fname);
@@ -3373,8 +3411,11 @@ ${generated.length} 个骨架已就绪——逐节把 <!--TODO--> 替换为语
         else if (wtCommitFlags[i] === '--pathspec-from-file' && wtCommitFlags[i + 1]) wtCommitPathspecFile = wtCommitFlags[++i];
       }
       if (!wtCommitChange) {
-        const inferred = String(dir).match(/[\\/]worktrees[\\/]([^\\/]+)/);
-        wtCommitChange = inferred ? inferred[1] : null;
+        // FR-08（2026-10-09-verify-reuse-friction / D-006@v1）：跨仓 <change>--<repoKey>
+        // 注册表校验剥后缀——逻辑单点在 wt-commit.js（导出 inferChangeFromWorktreeCwd
+        // 供三态回归直测，index.js dispatch 不留内联逻辑）
+        const { inferChangeFromWorktreeCwd } = await import('./wt-commit.js')
+        wtCommitChange = await inferChangeFromWorktreeCwd(dir)
       }
       try {
         const { runWtCommit } = await import('./wt-commit.js');

package/src/init.js

@@ -89,9 +89,9 @@ const TOOL_LABELS = {
   opencode: 'OpenCode (通过 INSTRUCTIONS.md)',
 };
 
-// 小段追加工具（gemini/opencode）。codex 不在此列——AGENTS.md 是跨工具通用的标准内容源，
-// codex 与 claude 共用完整模板注入（injectAgentsInstructions）；gemini/opencode 改 @AGENTS.md
-// 指针需先验证两家对 @ 导入语法的支持，留待后续变更。
+// 指令文件工具（gemini/opencode）。codex/claude/zcode 共用 AGENTS.md（跨工具通用标准内容源）；
+// gemini/opencode 写各自指令文件，内容与 AGENTS.md 同源同全文（改 @AGENTS.md 指针需先验证
+// 两家对 @ 导入语法的支持，留待后续变更）。
 const INSTRUCTION_TOOLS = ['gemini', 'opencode'];
 
 const INSTRUCTION_FILE_MAP = {
@@ -99,7 +99,13 @@ const INSTRUCTION_FILE_MAP = {
   opencode: 'INSTRUCTIONS.md',
 };
 
-const INJECTION_CONTENT = `## SillySpec — 规范驱动开发
+// ── 注入指令文件（全量方案，2026-10-10-init-full-injection：完整模板是唯一注入源）──
+
+const AGENTS_TEMPLATE_PATH = join(__dirname, '..', 'templates', 'agents-instruction.md');
+
+// 旧版小段（v≤3.32.3：AGENTS.md 追加态受管块与 injectInstructions 的注入源）。仅作老安装
+// 迁移的精确匹配文本，不再是任何注入源——所有状态一律写完整模板。
+const LEGACY_SMALL_BLOCK = `## SillySpec — 规范驱动开发
 
 在执行开发任务时，遵循以下规范：
 
@@ -113,41 +119,23 @@ const INJECTION_CONTENT = `## SillySpec — 规范驱动开发
 - 各阶段产出文件位于 \`.sillyspec/changes/<变更名>/\` 下
 `;
 
-// ── 注入指令文件 ──
-
-function injectInstructions(tool, projectDir) {
-  const fileName = INSTRUCTION_FILE_MAP[tool];
-  if (!fileName) return;
-  const filePath = join(projectDir, fileName);
-
-  // 文件不存在则创建
-  if (!existsSync(filePath)) {
-    writeFileSync(filePath, INJECTION_CONTENT);
-    return;
+function readInstructionTemplate() {
+  try {
+    return readFileSync(AGENTS_TEMPLATE_PATH, 'utf8');
+  } catch {
+    console.error(`❌ [sillyspec] 未找到 Agent 指引模板：${AGENTS_TEMPLATE_PATH}`);
+    return null;
   }
-
-  // 已存在 SillySpec 标记则跳过
-  const content = readFileSync(filePath, 'utf8');
-  if (content.includes('## SillySpec')) return;
-
-  // 追加到末尾
-  writeFileSync(filePath, content.trimEnd() + '\n\n' + INJECTION_CONTENT);
 }
 
-// ── 注入 AGENTS.md / CLAUDE.md（claude + codex，版本感知幂等）──
-// AGENTS.md 是唯一承载完整指引的内容源（跨工具通用标准）；CLAUDE.md 仅为 @AGENTS.md
-// 导入指针（Claude Code 记忆导入语法）。取代 design: 2026-08-02-init-claude-md 的
-// CLAUDE.md 单文件方案——其 D-004 预留的「marker 方案迁移」即本次变更。
-const AGENTS_TEMPLATE_PATH = join(__dirname, '..', 'templates', 'agents-instruction.md');
-
 /**
- * 移除 codex 老安装的旧版小段（injectInstructions 方案：`## SillySpec` 段，追加在 EOF）。
+ * 移除老安装的旧版小段（v≤3.32.3 方案：`## SillySpec` 段，追加在 EOF 或整文件即小段）。
  * 优先精确匹配旧文本；用户编辑过 / CRLF 漂移导致匹配失败时回退按标题截到 EOF。
- * @param {string} content - AGENTS.md 原文
+ * @param {string} content - 指引文件原文
  * @returns {string} 截除旧段后的内容（已 trimEnd）
  */
-function stripLegacyAgentsBlock(content) {
-  const exact = INJECTION_CONTENT.trimEnd();
+function stripLegacySmallBlock(content) {
+  const exact = LEGACY_SMALL_BLOCK.trimEnd();
   const idx = content.indexOf(exact);
   if (idx >= 0) return content.slice(0, idx).trimEnd();
   const headingIdx = content.indexOf('## SillySpec');
@@ -156,50 +144,49 @@ function stripLegacyAgentsBlock(content) {
 }
 
 /**
- * 为 AGENTS.md 注入完整指引（版本感知幂等，三态四分支 + 旧标记迁移）。
- * - 不存在：写完整模板（templates/agents-instruction.md）+ 顶部版本注释
- * - 存在无标记：追加受管段（INJECTION_CONTENT）+ 版本块标记；
- *   含旧 `## SillySpec` 段（codex 老安装）先截除再追加（marker 迁移，防双段）
+ * 向指引文件注入完整模板（版本感知幂等，三态四分支 + 旧标记迁移）。
+ * AGENTS.md / GEMINI.md / INSTRUCTIONS.md 共用；完整模板（templates/agents-instruction.md）
+ * 是唯一注入源。取代 design: 2026-08-02-init-claude-md 的 CLAUDE.md 单文件方案与
+ * v≤3.32.3 的追加态小段方案（其 D-004 预留的「marker 方案迁移」即彼方案）。
+ * - 不存在：写完整模板 + 顶部版本注释
+ * - 存在无标记：追加受管段（完整模板全文）+ 版本块标记；
+ *   含旧 `## SillySpec` 小段（v≤3.32.3 安装）先截除再追加（marker 迁移，防双段）
  * - 存在同版本标记：跳过（不写文件）
  * - 存在异版本标记：追加态刷新块 / 完整态仅 stderr 提示（保留用户改动）
- * @param {string} projectDir - 源码项目根
+ * @param {string} filePath - 指引文件绝对路径
  */
-export function injectAgentsInstructions(projectDir) {
-  const filePath = join(projectDir, 'AGENTS.md');
+function injectFullInstructions(filePath) {
   const version = getVersion();
+  const template = readInstructionTemplate();
+  if (template === null) return;
+  const fileName = basename(filePath);
   // 完整态顶部注释（新文件首行，轻量、不限制后续编辑）
   const fullHeader = `<!-- SillySpec v${version} — 由 sillyspec init 生成，可自由编辑；重跑 init 同版本不更新 -->`;
-  // 追加态受管段（包版本块标记，明确"勿手动编辑此段"）
-  const appendBlock =
+  // 追加态受管段（包版本块标记，明确"勿手动编辑此段"），内容=完整模板全文
+  const managedBlock =
     `<!-- SillySpec v${version} START — 由 sillyspec init 注入，勿手动编辑此段 -->\n` +
-    INJECTION_CONTENT.trimEnd() +
+    template.trimEnd() +
     `\n<!-- SillySpec END -->`;
 
   // 状态 1：文件不存在 → 写完整模板 + 顶部版本注释
   if (!existsSync(filePath)) {
-    let template = '';
-    try {
-      template = readFileSync(AGENTS_TEMPLATE_PATH, 'utf8');
-    } catch {
-      console.error(`❌ [sillyspec] 未找到 Agent 指引模板：${AGENTS_TEMPLATE_PATH}`);
-      return;
-    }
     writeFileSync(filePath, fullHeader + '\n' + template);
-    console.log(chalk.green(`    ✓ AGENTS.md 已生成（SillySpec v${version}，完整指引）`));
+    console.log(chalk.green(`    ✓ ${fileName} 已生成（SillySpec v${version}，完整指引）`));
     return;
   }
 
   let content = readFileSync(filePath, 'utf8');
 
-  // 无任何 `<!-- SillySpec v` 标记 → 状态 2：追加受管段（原文字节保留）
+  // 无任何 `<!-- SillySpec v` 标记 → 状态 2：追加完整受管段（原文字节保留）
   const markMatch = content.match(/<!-- SillySpec v(\S+)/);
   if (!markMatch) {
     if (content.includes('## SillySpec')) {
-      content = stripLegacyAgentsBlock(content);
-      console.log(chalk.green('    ✓ AGENTS.md 旧版 SillySpec 小段已迁移为新受管段'));
+      content = stripLegacySmallBlock(content);
+      console.log(chalk.green('    ✓ 旧版 SillySpec 小段已迁移为完整受管段'));
     }
-    writeFileSync(filePath, content + '\n\n' + appendBlock + '\n');
-    console.log(chalk.green(`    ✓ AGENTS.md 已追加 SillySpec 受管段（v${version}）`));
+    const body = content.trimEnd() === '' ? managedBlock : content.trimEnd() + '\n\n' + managedBlock;
+    writeFileSync(filePath, body + '\n');
+    console.log(chalk.green(`    ✓ ${fileName} 已追加 SillySpec 完整指引受管段（v${version}）`));
     return;
   }
 
@@ -210,15 +197,25 @@ export function injectAgentsInstructions(projectDir) {
   // 状态 4：异版本（升级）。区分追加态（有 START...END 块）/ 完整态（仅顶部注释）。
   const startBlockRe = /<!-- SillySpec v\S+\s+START[\s\S]*?<!-- SillySpec END -->/;
   if (startBlockRe.test(content)) {
-    // 4a：追加态 → 用当前版本受管段替换该块（块外用户内容字节保留）
-    writeFileSync(filePath, content.replace(startBlockRe, appendBlock));
-    console.log(chalk.green(`    ✓ AGENTS.md 受管段已升级（v${existingVersion} → v${version}）`));
+    // 4a：追加态 → 用当前版本完整受管段替换该块（块外用户内容字节保留）
+    writeFileSync(filePath, content.replace(startBlockRe, managedBlock));
+    console.log(chalk.green(`    ✓ ${fileName} 完整指引受管段已升级（v${existingVersion} → v${version}）`));
   } else {
     // 4b：完整态 → 不覆盖（保留用户改动），仅 stderr 打印升级提示
-    console.error(`⚠️ [sillyspec] SillySpec 升级 v${existingVersion}→v${version}，AGENTS.md 未自动更新（保留你的改动）。如需采用新模板：备份后删除 AGENTS.md 再跑 sillyspec init。`);
+    console.error(`⚠️ [sillyspec] SillySpec 升级 v${existingVersion}→v${version}，${fileName} 未自动更新（保留你的改动）。如需采用新模板：备份后删除 ${fileName} 再跑 sillyspec init。`);
   }
 }
 
+export function injectAgentsInstructions(projectDir) {
+  injectFullInstructions(join(projectDir, 'AGENTS.md'));
+}
+
+export function injectInstructions(tool, projectDir) {
+  const fileName = INSTRUCTION_FILE_MAP[tool];
+  if (!fileName) return;
+  injectFullInstructions(join(projectDir, fileName));
+}
+
 /**
  * 为 Claude Code 写 CLAUDE.md 指针（@AGENTS.md 导入，薄文件）。
  * - 不存在：写指针文件（版本头注释 + @AGENTS.md）
@@ -441,7 +438,7 @@ async function doInstall(projectDir, tools, subprojects = [], specDir = null, op
     }
   }
 
-  // 注入指令文件（gemini/opencode 小段追加，不进 AGENTS.md 注入器）
+  // 注入指令文件（gemini/opencode：与 AGENTS.md 同源同全文，共用全量注入器）
   for (let i = 0; i < tools.length; i++) {
     const toolName = tools[i];
     if (INSTRUCTION_TOOLS.includes(toolName)) {
@@ -449,7 +446,7 @@ async function doInstall(projectDir, tools, subprojects = [], specDir = null, op
     }
   }
 
-  // 注入 AGENTS.md 完整指引（claude/codex/zcode 共用：版本感知幂等三态四分支 + 旧 ## SillySpec 段迁移；
+  // 注入 AGENTS.md 完整指引（claude/codex/zcode 共用：版本感知幂等三态四分支 + 旧 ## SillySpec 小段迁移；
   // zcode 2026-09-21-flow-command-cards FR-05 入面——AGENTS.md 是跨工具通用标准内容源）
   if (tools.includes('claude') || tools.includes('codex') || tools.includes('zcode')) {
     injectAgentsInstructions(projectDir);

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

@@ -1126,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({
@@ -1143,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}`)
   }
@@ -1161,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'])