sillyspec 3.24.0 → 3.24.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sillyspec",
-  "version": "3.24.0",
+  "version": "3.24.2",
   "description": "SillySpec CLI — 流程状态机，让 AI 严格按步骤来",
   "icon": "logo.jpg",
   "homepage": "https://sillyspec.ppdmq.top/",

package/src/run.js

@@ -607,7 +607,7 @@ async function getStageSteps(stageName, cwd, progress, specDir = null) {
 /**
  * 确保阶段的 steps 已初始化到 progress
  */
-async function ensureStageSteps(progress, stageName, cwd, specDir = null) {
+export async function ensureStageSteps(progress, stageName, cwd, specDir = null) {
   if (!progress.stages) progress.stages = {}
 
   const steps = await getStageSteps(stageName, cwd, progress, specDir)
@@ -628,7 +628,15 @@ async function ensureStageSteps(progress, stageName, cwd, specDir = null) {
     const oldSteps = progress.stages[stageName].steps
     progress.stages[stageName].steps = steps.map(s => {
       const old = oldSteps.find(step => step.name === s.name)
-      if (old) return old
+      if (old) return old  // 精确名命中 → 保留旧状态
+      // migratedFrom：新步骤是合并/重命名来的（如 brainstorm 13→8 折叠）。
+      // 吸收的旧步骤全部 completed → 新步骤标 completed，避免 completed 丢失导致 currentIdx 回跳。
+      if (Array.isArray(s.migratedFrom) && s.migratedFrom.length > 0) {
+        const migrated = oldSteps.filter(step => s.migratedFrom.includes(step.name))
+        if (migrated.length > 0 && migrated.every(step => step.status === 'completed')) {
+          return { name: s.name, status: 'completed', migratedFrom: true }
+        }
+      }
       return { name: s.name, status: 'pending' }
     })
     return true
@@ -916,7 +924,8 @@ async function outputStep(stageName, stepIndex, steps, cwd, changeName, dbProjec
   if (stageName === 'execute' && promptText.includes('{EXECUTE_RUN_ID}')) {
     let runId = ''
     const execSpecBase = platformOpts?.specRoot || join(cwd, '.sillyspec')
-    const runIdFile = join(execSpecBase, '.runtime', `current-execute-run-id-${changeName}`)
+    const runtimeRoot = platformOpts?.runtimeRoot || join(execSpecBase, '.runtime')
+    const runIdFile = join(runtimeRoot, `current-execute-run-id-${changeName}`)
     try {
       if (existsSync(runIdFile)) {
         runId = readFileSync(runIdFile, 'utf8').trim()
@@ -925,6 +934,8 @@ async function outputStep(stageName, stepIndex, steps, cwd, changeName, dbProjec
     if (!runId) {
       const { generateExecuteRunId } = await import('./task-review.js')
       runId = generateExecuteRunId()
+      // 落盘（与启动站点一致），保证 agent 收到的 ID == gate/checkbox 读取的 ID
+      try { mkdirSync(runtimeRoot, { recursive: true }); writeFileSync(runIdFile, runId + '\n') } catch {}
     }
     promptText = promptText.replace(/\{EXECUTE_RUN_ID\}/g, runId)
   }
@@ -1609,13 +1620,31 @@ export async function runCommand(args, cwd, specDir = null) {
     if (autoChange) {
       progress = await pm.initChange(cwd, autoChange)
     } else if (isAuxiliary) {
-      // 辅助阶段（scan/explore/quick/doctor/status）自动使用默认变更名
-      const autoName = changeName || resolveChangeNameAuto(cwd, specRoot) || 'default'
+      let autoName = changeName || resolveChangeNameAuto(cwd, specRoot) || 'default'
+      // archive 特例：归档后变更从活跃列表排除（listChanges WHERE status='active'），
+      // 不带 --change 回退 default 会读错变更。无活跃变更时取最新归档变更，读其现有 progress。
+      if (stageName === 'archive' && autoName === 'default') {
+        try {
+          const archiveDir = join(specBase, 'changes', 'archive')
+          if (existsSync(archiveDir)) {
+            const latest = readdirSync(archiveDir)
+              .filter(d => /^\d{4}-\d{2}-\d{2}-.+/.test(d))
+              .sort()
+              .pop()
+            if (latest) {
+              autoName = latest.replace(/^\d{4}-\d{2}-\d{2}-/, '')
+              progress = await pm.read(cwd, autoName)
+            }
+          }
+        } catch {}
+      }
       changeName = autoName
-      progress = await pm.initChange(cwd, autoName)
-      // initChange 可能因 project 表为空返回 null
       if (!progress) {
-        progress = { currentStage: stageName, stages: {}, lastActive: new Date().toLocaleString('zh-CN', { hour12: false }), project: '' }
+        progress = await pm.initChange(cwd, autoName)
+        // initChange 可能因 project 表为空返回 null
+        if (!progress) {
+          progress = { currentStage: stageName, stages: {}, lastActive: new Date().toLocaleString('zh-CN', { hour12: false }), project: '' }
+        }
       }
     } else {
       // brainstorm 作为流程入口，自动生成变更名并初始化
@@ -3547,6 +3576,8 @@ async function completeStep(pm, progress, stageName, cwd, outputText, inputText
             if (!executeRunId) {
               const { generateExecuteRunId } = await import('./task-review.js')
               executeRunId = generateExecuteRunId()
+              // 落盘（marker 缺失时 fallback 生成后写盘，保证后续 checkbox/gate 读到同一 ID）
+              try { mkdirSync(runtimeRoot, { recursive: true }); writeFileSync(runIdFile, executeRunId + '\n') } catch {}
             }
 
             // git 真实性校验目录：worktree 存在则用 worktree（base/head commit 在其中），否则主仓库

package/src/stage-contract.js

@@ -56,6 +56,20 @@ export function validateChangeExists(specBase, stageName, changeName) {
   if (!changeName || !STAGES_REQUIRE_EXISTING_CHANGE.has(stageName)) return null
   if (/^quick-[0-9a-f]{8}$/.test(changeName)) return null
   if (existsSync(join(specBase, 'changes', changeName))) return null
+
+  // archive 特例：step4 --confirm 已把变更从 changes/<name>/ 移到 changes/archive/<date>-<name>/。
+  // step5（更新路线图/提交）--change <name> 不应因 changes/<name>/ 已移走而被前置校验误拦。
+  // 精确匹配归档目录名（YYYY-MM-DD-<changeName>），避免后缀子串误匹配（auth ≠ deep-auth）。
+  if (stageName === 'archive') {
+    const archiveRoot = join(specBase, 'changes', 'archive')
+    if (existsSync(archiveRoot)) {
+      const archived = readdirSync(archiveRoot).find(d => {
+        const m = d.match(/^\d{4}-\d{2}-\d{2}-(.+)$/)
+        return m && m[1] === changeName
+      })
+      if (archived) return null
+    }
+  }
   return {
     changeName,
     specBase,

package/src/stage-review.js

@@ -134,7 +134,7 @@ export function verifyStageReviewDocHash(review, searchDirs) {
     const actual = computeDocHash(abs)
     if (actual === null) continue
     // 找到主文档，比对 hash
-    if (review.docHash !== actual) {
+    if (review.docHash.toLowerCase() !== actual.toLowerCase()) {
       errors.push(`docHash 与主审查文档 ${primaryRel} 的实际内容不匹配 — review.json 疑似伪造（未真正读取文档）`)
       return { ok: false, errors, warnings }
     }

package/src/stages/brainstorm.js

@@ -30,14 +30,14 @@ export const definition = {
 
 ### 操作
 1. 读取 CODEBASE-OVERVIEW.md + 共享规范 + 子项目上下文
-2. 加载项目信息：\`cat .sillyspec/projects/*.yaml 2>/dev/null\`
-3. 加载本地配置：\`cat .sillyspec/local.yaml 2>/dev/null\`
-4. 棕地项目：读取 .sillyspec/docs/<project>/scan/ 下的 STRUCTURE.md、CONVENTIONS.md、ARCHITECTURE.md
-5. **加载模块索引**：读取 \`.sillyspec/docs/<project>/modules/_module-map.yaml\`（如存在）
+2. 加载项目信息：\`cat {SPEC_ROOT}/projects/*.yaml 2>/dev/null\`
+3. 加载本地配置：\`cat {SPEC_ROOT}/local.yaml 2>/dev/null\`
+4. 棕地项目：读取 {SPEC_ROOT}/docs/<project>/scan/ 下的 STRUCTURE.md、CONVENTIONS.md、ARCHITECTURE.md
+5. **加载模块索引**：读取 \`{SPEC_ROOT}/docs/<project>/modules/_module-map.yaml\`（如存在）
    - 这一步是高频操作，_module-map.yaml 回答"哪个文件属于哪个模块、模块之间怎么依赖"
    - 用 tags/aliases 字段做需求关键词→模块的粗匹配
    - 用 entrypoints 字段快速了解模块对外能力
-6. 查看进行中的变更：\`ls .sillyspec/changes/ | grep -v archive\`
+6. 查看进行中的变更：\`ls {SPEC_ROOT}/changes/ | grep -v archive\`
    - 有相关同名变更 → 提示用户，避免重复
 7. 检查全局模板：\`ls ~/.sillyspec/templates/\`
    - 有匹配模板 → 询问是否基于模板
@@ -71,6 +71,7 @@ export const definition = {
     },
     {
       name: '对话式探索与需求澄清',
+      migratedFrom: ['协作与复用检查', '原型/设计图分析', '需求范围评估', '对话式探索', '需求澄清 Grill'],
       conditionalWait: true,
       repeatableWait: true,
       maxWaitRounds: 8,
@@ -132,9 +133,9 @@ export const definition = {
 - 代码冲突：用户描述与现有代码/scan/module 文档不一致
 
 **能通过代码或文档确认的不要问用户，先读取**：
-- \`.sillyspec/docs/<project>/scan/ARCHITECTURE.md\`
-- \`.sillyspec/docs/<project>/scan/CONVENTIONS.md\`
-- \`.sillyspec/docs/<project>/modules/_module-map.yaml\`
+- \`{SPEC_ROOT}/docs/<project>/scan/ARCHITECTURE.md\`
+- \`{SPEC_ROOT}/docs/<project>/scan/CONVENTIONS.md\`
+- \`{SPEC_ROOT}/docs/<project>/modules/_module-map.yaml\`
 - 相关源码文件
 
 **给每个未解决歧义分级**：
@@ -211,6 +212,7 @@ export const definition = {
     },
     {
       name: '分段展示设计',
+      migratedFrom: ['HTML 原型生成'],
       requiresWait: true,
       waitReason: '等待用户确认设计方案',
       waitOptions: ['确认', '需要修改', '推翻重来'],
@@ -228,7 +230,7 @@ export const definition = {
 - 适合：有 UI 组件/布局/交互流程/状态转换/架构图
 - 不适合：纯后端逻辑/配置修改/无可视化意义
 如果适合，生成一个独立的 HTML 文件（内联 CSS + JS），保存到：
-\`.sillyspec/changes/<change-name>/prototype-<名称>.html\`
+\`{SPEC_ROOT}/changes/<change-name>/prototype-<名称>.html\`
 - 单文件，浏览器直接打开
 - 展示关键布局结构和交互流程
 - 不需要完整功能，重点是让用户确认设计方向
@@ -309,16 +311,16 @@ design.md 第一行标题必须用中文：# 设计文档（Design）— <变更
 12. **自审**（AI 对自身设计的校验）
 
 ### 操作
-1. 确认变更目录存在：\`mkdir -p .sillyspec/changes/<change-name>\`（Windows 用 \`mkdir .sillyspec\\changes\\<变更名>\` 或 PowerShell \`New-Item -ItemType Directory -Force -Path .sillyspec/changes/<change-name>\`）
+1. 确认变更目录存在：\`mkdir -p {SPEC_ROOT}/changes/<change-name>\`（Windows 用 \`mkdir {SPEC_ROOT}/changes\\<变更名>\` 或 PowerShell \`New-Item -ItemType Directory -Force -Path {SPEC_ROOT}/changes/<change-name>\`）
    - 变更名格式必须为 \`YYYY-MM-DD-<简短描述>\`（如 \`2026-05-13-user-auth\`）
-2. 将确认的设计写入 \`.sillyspec/changes/<change-name>/design.md\`
-3. 如果对话探索或方案讨论产生了实现相关决策，写入 \`.sillyspec/changes/<change-name>/decisions.md\`：
+2. 将确认的设计写入 \`{SPEC_ROOT}/changes/<change-name>/design.md\`
+3. 如果对话探索或方案讨论产生了实现相关决策，写入 \`{SPEC_ROOT}/changes/<change-name>/decisions.md\`：
    - decisions.md 是本次变更的决策台账，不是长期术语表
    - 只记录有实现/验收影响的决策，闲聊和低风险偏好不记录
    - 每条记录必须有稳定版本 ID：D-001@v1、D-002@v1 ...
    - 若后续 Design Grill 修正该决策，新记录使用 D-001@v2，并写明 supersedes: D-001@v1
    - 每条记录必须包含：type、status、source、question、answer、normalized_requirement、impacts、evidence、priority
-   - 长期术语只在 archive/scan 时再提升到 \`.sillyspec/docs/<project>/glossary.md\`
+   - 长期术语只在 archive/scan 时再提升到 \`{SPEC_ROOT}/docs/<project>/glossary.md\`
 4. 格式自检（只查章节齐全；语义一致性/可行性/YAGNI 不在本步查，交给下一步 Design Grill 独立审查）：
    - design.md 含全部必填章节（背景/设计目标/非目标/总体方案/文件变更清单/接口定义/风险登记）
    - 如存在 decisions.md，design.md 是否引用所有当前版本 D-xxx@vN
@@ -358,12 +360,12 @@ tier: {REVIEW_TIER}（{REVIEW_TIER_REASON}）
 3. 即使跳过，也要输出"Design Grill skipped"和原因，不能静默跳过。
 
 ### 输入材料
-1. 必须读取完整 \`.sillyspec/changes/<change-name>/design.md\`
+1. 必须读取完整 \`{SPEC_ROOT}/changes/<change-name>/design.md\`
 2. 读取 proposal.md、requirements.md、tasks.md、decisions.md（如存在）
 3. 读取 scan/module docs：
-   - \`.sillyspec/docs/<project>/scan/ARCHITECTURE.md\`
-   - \`.sillyspec/docs/<project>/scan/CONVENTIONS.md\`
-   - \`.sillyspec/docs/<project>/modules/_module-map.yaml\`
+   - \`{SPEC_ROOT}/docs/<project>/scan/ARCHITECTURE.md\`
+   - \`{SPEC_ROOT}/docs/<project>/scan/CONVENTIONS.md\`
+   - \`{SPEC_ROOT}/docs/<project>/modules/_module-map.yaml\`
    - 命中的模块文档
 4. 按 design.md 文件变更清单读取相关源码、测试、配置、schema 或样例数据；矛盾经常藏在设计与外部约束交叉处，素材宁可多读，不要只读摘要。
 
@@ -453,9 +455,9 @@ status: passed | needs-user-input | blocked | skipped
 1. 展示 design.md 摘要 + **规模评估结果（small/large + 一句依据）** 给用户
 2. 暂停等待用户选择：✅ 确认 / ✏️ 修改 / ❌ 推翻重来
 3. 确认后，**按规模生成规范文件**：
-   - **scale=large**：在 \`.sillyspec/changes/<change-name>/\` 下生成完整四件套（design.md / decisions.md 可选 / proposal.md / requirements.md / tasks.md），实现路径 → \`sillyspec run plan --change <变更名>\`
+   - **scale=large**：在 \`{SPEC_ROOT}/changes/<change-name>/\` 下生成完整四件套（design.md / decisions.md 可选 / proposal.md / requirements.md / tasks.md），实现路径 → \`sillyspec run plan --change <变更名>\`
    - **scale=small**：只生成/补全 design.md（proposal/requirements/tasks 对 quick 无用，不生成），实现路径 → \`sillyspec run quick --linked-changes <变更名>\`
-   - 两种规模都执行 \`git add .sillyspec/\` — 暂存规范文件（不要 commit）
+   - 两种规模都执行 \`git add .sillyspec/\` — 暂存规范文件（不要 commit，由用户通过统一提交工具处理）。**平台模式跳过 git add**（specRoot 不在 sourceRoot 的 git repo 内）
 
 所有规范文件头部必须包含 YAML frontmatter：
 \`\`\`yaml
@@ -538,13 +540,13 @@ Then 期望结果
 ### 后续变更包处理
 如果 MASTER.md 中规划了后续变更包（拆分后的子阶段），**必须同时为每个后续包创建独立变更目录**：
 1. 读取 MASTER.md 中的变更包列表（包名 + 边界描述）
-2. 为每个后续包创建目录：\`mkdir -p .sillyspec/changes/<后续包名>\`
+2. 为每个后续包创建目录：\`mkdir -p {SPEC_ROOT}/changes/<后续包名>\`
 3. 每个目录生成骨架文件：
    - \`proposal.md\`：从 MASTER.md 中提取该包的动机和边界
    - \`design.md\`：从 MASTER.md 中提取该包的职责描述（标记为「待设计 - 本包 design 在该包进入 brainstorm 时完善」）
    - \`requirements.md\`：从 MASTER.md 中提取该包的需求范围（标记为「待完善」）
    - \`tasks.md\`：创建空任务列表，标记为「待 plan 阶段展开」
-4. \`git add .sillyspec/\` — 暂存所有新增文件（不要 commit）
+4. \`git add .sillyspec/\` — 暂存所有新增文件（不要 commit，由用户通过统一提交工具处理）。**平台模式跳过 git add**（specRoot 不在 sourceRoot 的 git repo 内）
 5. 后续变更包的骨架文件同样必须包含 \`author: <git-user>\` 和 \`created_at: <now-datetime>\`
 
 ### 铁律 — 必须等待用户最终确认

package/src/stages/plan.js

@@ -94,7 +94,7 @@ const stepClassify = {
    - 如果发现 superseded 决策，只引用最新版本，不引用旧版本
 5. 读取 CONVENTIONS.md、ARCHITECTURE.md、STACK.md
 6. 读取 local.yaml 获取构建/测试命令
-7. 读取 \`.sillyspec/docs/<project>/modules/_module-map.yaml\`（不存在则跳过）
+7. 读取 \`{SPEC_ROOT}/docs/<project>/modules/_module-map.yaml\`（不存在则跳过）
    - 根据 design.md 的文件变更清单匹配模块
    - 读取匹配到的模块文档
    - 利用模块依赖关系辅助分析（depends_on / used_by）
@@ -314,7 +314,7 @@ full 计划的约束：
 2. 读取 design.md 获取文件变更清单
 3. 读取上一步的 plan_level 分类结果
 4. 按对应级别模板生成内容
-5. 保存到变更目录下的 plan.md（路径格式：\`.sillyspec/changes/<change-name>/plan.md\`，其中 <change-name> 是变更目录名，直接使用，不加子目录。正确路径示例：\`.sillyspec/changes/2026-05-28-agent-log-streaming/plan.md\`）
+5. 保存到变更目录下的 plan.md（路径格式：\`{SPEC_ROOT}/changes/<change-name>/plan.md\`，其中 <change-name> 是变更目录名，直接使用，不加子目录。正确路径示例：\`{SPEC_ROOT}/changes/2026-05-28-agent-log-streaming/plan.md\`）
 **plan_level 为 none 时生成最小 plan.md（占位），不生成完整蓝图。**
 
 ---
@@ -384,16 +384,16 @@ tier: {REVIEW_TIER}（{REVIEW_TIER_REASON}）
  * 每个 task 生成 20~40 行紧凑可执行卡片
  */
 export function buildCoordinatorStep(changeDir, taskNames) {
-  const taskList = taskNames.map((name, i) => {
-    const num = String(i + 1).padStart(2, '0')
-    return `- task-${num}: ${name}`
+  const taskList = taskNames.map(t => {
+    const num = t.num
+    return `- task-${num}: ${t.name}`
   }).join('\n')
 
-  const subagentPrompts = taskNames.map((name, i) => {
-    const num = String(i + 1).padStart(2, '0')
+  const subagentPrompts = taskNames.map(t => {
+    const num = t.num
     return `\`\`\`
 任务编号：task-${num}
-任务名称：${name}
+任务名称：${t.name}
 文件路径：${changeDir}/tasks/task-${num}.md
 当前时间：<now-datetime>（frontmatter 的 created_at 使用此值）
 当前用户：<git-user>（frontmatter 的 author 使用此值）
@@ -405,7 +405,7 @@ export function buildCoordinatorStep(changeDir, taskNames) {
 
 ---
 id: task-${num}
-title: ${name}
+title: ${t.name}
 title_zh: <任务中文标题>
 author: <git-user>
 created_at: <now-datetime>
@@ -551,13 +551,14 @@ function parseTaskCount(planContent) {
  * 从 plan.md 解析任务名列表
  */
 function parseTaskNames(planContent) {
-  const names = []
+  // 返回 [{name, num}]：保留 plan.md 原始编号，避免 buildCoordinatorStep 按 i+1 重编号与 execute 原始编号错位
+  const tasks = []
   const lines = planContent.split('\n')
   for (const line of lines) {
-    const m = line.match(/^[-*]\s*\[[ x]\]\s*task-\d+:\s*(.+)/i)
-    if (m) names.push(m[1].trim())
+    const m = line.match(/^[-*]\s*\[[ x]\]\s*task-(\d+):\s*(.+)/i)
+    if (m) tasks.push({ num: String(m[1]).padStart(2, '0'), name: m[2].trim() })
   }
-  return names
+  return tasks
 }
 
 /**

package/src/task-review.js

@@ -337,9 +337,22 @@ export function verifyReviewGitEvidence(review, gitDir) {
   }
 
   const emptyDiff = diffFiles.length === 0
+  // emptyDiff 回退：子代理可能未 commit，base..head 无 commit diff 但 working-tree 有改动。
+  // 对齐 checkExecuteCodeEvidence（stage-contract.js 同时查 working-tree）语义，避免误判零改动伪造。
+  let workingTreeChanged = false
+  if (emptyDiff) {
+    try {
+      const wtStatus = runGit(gitDir, ['status', '--porcelain'])
+      workingTreeChanged = !!wtStatus && wtStatus.trim().length > 0
+    } catch {}
+    if (workingTreeChanged) {
+      warnings.push(`base..head 无 commit diff（${review.base.slice(0, 8)}..${review.head.slice(0, 8)}），但 working-tree 有未提交改动 —— 按有效改动处理，不判零改动伪造`)
+    }
+  }
+  const effectiveEmptyDiff = emptyDiff && !workingTreeChanged
 
   // changedFiles 交叉比对：完全不相交 = review 描述的改动与实际 diff 无关
-  if (!emptyDiff && Array.isArray(review.changedFiles) && review.changedFiles.length > 0) {
+  if (!effectiveEmptyDiff && Array.isArray(review.changedFiles) && review.changedFiles.length > 0) {
     const normalize = (p) => String(p).replace(/^\.\//, '')
     const diffSet = new Set(diffFiles.map(normalize))
     const hasOverlap = review.changedFiles.some(f => {
@@ -352,7 +365,7 @@ export function verifyReviewGitEvidence(review, gitDir) {
     }
   }
 
-  return { ok: errors.length === 0, emptyDiff, errors, warnings, unavailable: false }
+  return { ok: errors.length === 0, emptyDiff: effectiveEmptyDiff, errors, warnings, unavailable: false }
 }
 
 /**

package/src/worktree-apply.js

@@ -343,20 +343,15 @@ export function applyWorktree(changeName, { cwd, checkOnly = false, merge = fals
  * @returns {object} result（merged=true 表示走了 merge 降级）
  */
 function applyByMerge(result, changeName, projectRoot, wm) {
+  const meta = wm.getMeta(changeName);
+  const changedFiles = result.changedFiles || [];
+  // 用 meta.branch（native-worktree 模式分支名可能不是 sillyspec/<change>），不硬编码。
+  const branch = meta.branch || `sillyspec/${changeName}`;
+
   try {
-    git(projectRoot, `merge --no-ff sillyspec/${changeName}`);
-    result.merged = true;
-    result.ok = true;
-    try { result.mergeSummary = git(projectRoot, `log --oneline -1`); } catch {}
-    // 成功后自动 cleanup（与 patch 路径步骤 8 一致；分支已合并，删除安全）
-    try {
-      wm.cleanup(changeName);
-    } catch (cleanupErr) {
-      result.warnings = result.warnings || [];
-      result.warnings.push(`cleanup 失败（不影响 merge 结果）: ${cleanupErr.message}`);
-    }
+    git(projectRoot, `merge --no-ff ${branch}`);
   } catch (e) {
-    // merge 冲突：先取冲突文件列表，再 abort 回滚（避免半成品合并）
+    // merge 冲突：取冲突文件列表 + abort 回滚（不 cleanup，保留 worktree）
     let conflictFiles = [];
     try {
       const cf = gitQuiet(projectRoot, `diff --name-only --diff-filter=U`);
@@ -364,10 +359,35 @@ function applyByMerge(result, changeName, projectRoot, wm) {
     } catch {}
     try { gitQuiet(projectRoot, `merge --abort`); } catch {}
     result.errors.push(
-      `git merge sillyspec/${changeName} 冲突，请手动解决。冲突文件：\n` +
+      `git merge ${branch} 冲突，请手动解决。冲突文件：\n` +
       (conflictFiles.length ? `  ${conflictFiles.join('\n  ')}\n` : `  (未能获取冲突文件列表)\n`) +
       `已执行 git merge --abort 回滚到合并前状态。`
     );
+    return result;
+  }
+
+  // 落地校验：merge 报成功（exit 0）不代表交付物真进 main——
+  // 分支可能只含 baseline checkpoint（子代理改动未 commit），merge 产生空内容合并，文件零落地。
+  // 逐个确认 changedFiles 在 main HEAD 存在。任一缺失 → 不 cleanup（fail-open：保留 worktree 唯一副本）。
+  result.merged = true;
+  const notLanded = changedFiles.filter(f => gitQuiet(projectRoot, `cat-file -e HEAD:${f}`) === null);
+  if (notLanded.length > 0) {
+    result.ok = false;
+    result.errors.push(
+      `git merge ${branch} 报成功，但 ${notLanded.length}/${changedFiles.length} 个交付文件未出现在 main HEAD` +
+      `（分支可能只含 baseline checkpoint，子代理改动未 commit）。worktree 已保留（未 cleanup），` +
+      `请用 git cherry-pick 或手动 cp 落地：\n  ${notLanded.join('\n  ')}`
+    );
+    return result;
+  }
+
+  result.ok = true;
+  try { result.mergeSummary = git(projectRoot, `log --oneline -1`); } catch {}
+  try {
+    wm.cleanup(changeName);
+  } catch (cleanupErr) {
+    result.warnings = result.warnings || [];
+    result.warnings.push(`cleanup 失败（不影响 merge 结果）: ${cleanupErr.message}`);
   }
   return result;
 }