sillyspec 3.29.5 → 3.30.0

package/src/run/stage.js

@@ -17,14 +17,12 @@
  *   - 'child_process'（execSync）裸模块名不变
  */
 import { join, dirname } from 'node:path'
-import { existsSync, readdirSync, readFileSync, mkdirSync } from 'node:fs'
+import { existsSync, readdirSync, readFileSync, mkdirSync, rmSync, unlinkSync } from 'node:fs'
 import { writeAtomicSync } from '../fs-atomic.js'
-import { resolveSpecDir, resolveChangeDir, resolveRuntimeRoot, resolveQuickSessionsDir, triggerSync, safeGit, parsePorcelainPath, formatWaitOptions, checkApproval, getStageSteps, warnApprovalUnknown, predictProtectedQuickFiles, mergeQuickBoundaryFiles, detectEmptyShellQuickSessions } from './shared.js'
+import { resolveSpecDir, resolveChangeDir, resolveRuntimeRoot, resolveQuickSessionsDir, triggerSync, safeGit, formatWaitOptions, checkApproval, getStageSteps, warnApprovalUnknown, predictProtectedQuickFiles, mergeQuickBoundaryFiles, readStageBurst, STAGE_BURST_STAGES, readStageWall, STAGE_WALL_STAGES } from './shared.js'
 import { computeScanProfile, applyScanProfileSteps, executeScanPreflight, executeScanPostcheck, executeScanDetectProjects, executeScanResumeCheck, executeScanFinalize } from './scan-profile.js'
 import { executeProgressConfirm } from './progress-confirm.js'
 import { outputStep, collectStageWaitHistory } from './prompt.js'
-import { allocateQuicklogEntry, deriveTitleFromLinkedChange, sanitizeDesc } from '../quicklog.js'
-import { createHash } from 'node:crypto'
 import { checkTransition } from '../stage-contract.js'
 import { AUXILIARY_STAGES } from '../constants.js'
 import { completeStageGates } from './gates.js'
@@ -45,6 +43,37 @@ export async function runStage(pm, progress, stageName, cwd, changeName, skipApp
     }
   }
 
+  // ── 阶段墙 hard 门（R16 减负批次 A 相位，2026-09-24；R16-b 实证修正 2026-09-25）──
+  // 拦「前驱刚收口、未执行 handoff 切割、目标阶段首次进入」的硬续形态。三个放行口：
+  // ①sillyspec handoff 已在前驱收口后执行（ledger.handoffAt > ledger.at——handoff 协议要求
+  //   新会话保持同一 SILLYSPEC_SESSION_ID，SESSION_ID 相同不是硬续证据，切割凭证=handoff 动作）；
+  // ②目标阶段已有 stage 数据（reopen/复跑重入——保住 verify FAIL→execute --reopen 修复回路）；
+  // ③--same-session 显式逃生口。fail-open：ledger 缺失/读失败/会话标识缺省 → 放行。
+  if (STAGE_WALL_STAGES.includes(stageName) && changeName && !(quickOpts && quickOpts.sameSession)) {
+    try {
+      if ((await readStageWall(cwd)) === 'hard') {
+        const curSession = process.env.SILLYSPEC_SESSION_ID || ''
+        const wallStageData = progress.stages && progress.stages[stageName]
+        const firstEntry = !wallStageData || !Array.isArray(wallStageData.steps) || wallStageData.steps.length === 0
+        const wallLedgerPath = join(specBase, '.runtime', `stage-session-ledger-${changeName}.json`)
+        if (curSession && firstEntry && existsSync(wallLedgerPath)) {
+          const wallLedger = JSON.parse(readFileSync(wallLedgerPath, 'utf8'))
+          const { isStageWallBlocked } = await import('./shared.js')
+          if (isStageWallBlocked({ ledger: wallLedger, curSession, stageName, stageHasData: !firstEntry })) {
+            console.error(``)
+            console.error(`⛔ 阶段墙（stage.wall=hard）：本变更刚在会话标识 ${curSession} 下收口 ${wallLedger.lastStage}，${stageName} 须在新会话执行。`)
+            console.error(`   单会话历史重放税实测：R15 execute 段均轮 263K 输入（断崖拆会话后回落 120-170K）——${stageName} 的全部输入在盘上（design/plan/tasks/review），新会话零背景可续跑。`)
+            console.error(`   动作：`)
+            console.error(`   1. sillyspec handoff --change ${changeName}   # 生成交接块（即切割凭证，生成后墙自动放行）`)
+            console.error(`   2. 新会话粘贴交接块 → sillyspec run ${stageName} --change ${changeName}`)
+            console.error(`   逃生口：确认要同会话硬续（应急/平台编排）→ 加 --same-session 重跑本命令。`)
+            process.exit(1)
+          }
+        }
+      }
+    } catch { /* fail-open：任何读取/解析失败放行，行为与无墙一致 */ }
+  }
+
   // execute 阶段启动前检查审批
   if (stageName === 'execute' && !skipApproval) {
     const approval = await checkApproval(cwd, changeName, platformOpts)
@@ -335,6 +364,9 @@ export async function runStage(pm, progress, stageName, cwd, changeName, skipApp
   // （D-003@v1：顶层 quickGuard 不跨进程持久化；agent 在 step 间用 `run quick` 取下一步
   // prompt 时每个新进程都进此块，按文件判幂等才不会重复分配 ql-ID / 重复写条目）。
   if (stageName === 'quick') {
+    // quick 通道直接退役（2026-09-25-quick-channel-retire，接替 thin-default-flip 的第 2 步横幅劝导）：
+    // 新会话一律硬拒（见下方 !existingGuard 分支），在途会话（guard.json 存在）照常续跑/--done/--cancel
+    // 收尾——--done/--cancel 不经 runStage，本门只拦「新会话创建」，拒绝发生在任何写入之前（零副作用）。
     // 受保护文件预告打印（坑 quick-protected-late-hint，2026-08-28 用户实证：scan 类文档
     // ARCHITECTURE/CONCERNS 属受保护基线，--files 声明了照样拦、必须 --force-baseline——
     // 设计合理但提示太晚。step1 即预告哪些声明文件会触发拦截，省一轮跑到 --done 才发现的往返）
@@ -353,6 +385,8 @@ export async function runStage(pm, progress, stageName, cwd, changeName, skipApp
       if (existsSync(guardFile)) existingGuard = JSON.parse(readFileSync(guardFile, 'utf8'))
     } catch {}
     if (existingGuard) {
+      // 在途会话提示（每次渲染一行，防 agent 把后续新工作又开成 quick）：本会话收尾不受退役影响
+      console.log(`ℹ️ quick 通道已退役——本会话为升级前在途会话，可继续收尾（--done / --cancel）；新工作走轻量变更 flow start。`)
       // 跨进程重入：复用已分配的 ql-ID，跳过 baseline 重捕与分配（幂等）
       progress.quickGuard = existingGuard
       // 中途追加边界：会话中途发现要改启动声明外的文件，此前 resume 会把 --files 静默丢弃、
@@ -376,167 +410,31 @@ export async function runStage(pm, progress, stageName, cwd, changeName, skipApp
         }
       }
     } else {
-      // baseline 采集用 safeGit（带 -c safe.directory，避免 linked worktree/容器异 uid/Windows 挂载点
-      // 下裸 `git status` 抛错）。safeGit 已消除 safe.directory 类失败；若仍失败（真非 git 目录等），
-      // 不硬阻断 quick 启动（平台模式/非 git 目录仍需渲染 step prompt），但 fail-visible：大声 warn +
-      // baseline 置空。--done 时 auditQuickCompletion 的 safeGit 同样失败 → blocked，故不存在「静默
-      // 完成」路径（multi-agent-review Q3）。
-      const statusResult = safeGit(cwd, ['status', '--porcelain'], { trim: false })
-      if (statusResult.error) {
-        console.warn(`⚠️ quick baseline 采集失败（git status）: ${statusResult.error}`)
-        console.warn(`   baseline 置空；--done 审计将因 git 不可用而阻断（无静默完成路径）。`)
-        console.warn(`   排查：仓库 safe.directory 配置 / 非 git 目录。`)
-      }
+      // quick 通道直接退役（2026-09-25-quick-channel-retire）：新会话硬拒 exit 1——本 else 分支
+      // 原是 ql-ID 分配 / guard 落盘 / QUICKLOG 条目写入发生处，拒绝置于所有写入之前（零副作用）。
+      // 判据与 D-003 幂等判据同源（guard.json 文件存在性），在途会话走上方 existingGuard 分支不受影响。
+      // 注：CLI 进程入口的新会话已被 index.js refuseRetiredQuickFreshStart 预门拦下，本门兜底
+      // 进程内直调 runCommand 的入口（测试/编程调用）与 --change 指向不存在会话的形态。
+      console.error(`❌ quick 通道已退役，无法启动 quick 会话（若带 --change 则该会话不存在或已清理）。`)
+      console.error(`   新工作请走轻量变更：sillyspec flow start --change <名> --input "<动机与背景；随后独立一行『成功标准：』；再每行一条『- <可验证标准>』>"`)
+      console.error(`   升级前进行中的 quick 会话仍可收尾：sillyspec run quick --change <会话ID> 续跑 / --done 收口 / --cancel 取消。`)
+      // 进程内路径幻影残留清理（best-effort）：CLI 入口已被 index.js 预门拦下；进程内直调
+      // runCommand 的新会话形态在 command.js 已生成 sid + owner.json + current-quick-run-id +
+      // DB 活跃进度行。guard 从未落盘——清掉本 sid 的空会话目录、指向本 sid 的共享指针与 DB
+      // 幻影行（防污染 listChanges / 多活跃判定），防 --done fallback 命中幻影。保护：guard.json
+      // 存在（含损坏）绝不清目录/不注销（损坏可手修恢复，拒绝但保数据）；共享指针只在内容
+      // 等于本 sid 时才动，他者会话标记不碰。
       try {
-        const gitStatus = statusResult.value || ''
-        // 记录全部预存脏文件（含 untracked + .sillyspec/ 路径）。quick 会话期间自身写入的元数据
-        // （quicklog/.runtime/modules/_module-map 等）由 auditQuickCompletion 的 isQuickMetadata 精确豁免，
-        // 不需要这里粗放过滤 .sillyspec/——旧过滤致预存 untracked .sillyspec/changes/ 不进 baseline，
-        // 却在 audit 被当「危险(.sillyspec/)+新增」误判永久 blocked（ql-20260713-002-7628 修复）。
-        const baselineFiles = gitStatus
-          .split('\n').filter(Boolean)
-          .map(line => parsePorcelainPath(line))
-          .filter(Boolean)
-        const allowedFiles = quickOpts?.quickFiles || []
-        const allowNew = quickOpts?.isAllowNew || false
-        const allowDelete = quickOpts?.isAllowDelete || false
-        const forceBaseline = quickOpts?.isForceBaseline || false
-        const linkedChanges = Array.isArray(quickOpts?.linkedChanges) ? quickOpts.linkedChanges : []
-        // 受保护文件预告（坑 quick-protected-late-hint）：会话起步（step1）即点破，
-        // 判定与 --done 审计危险门同口径（predictProtectedQuickFiles）
-        const protectedPreview = predictProtectedQuickFiles(allowedFiles, { linkedChanges, forceBaseline })
-        if (protectedPreview.length > 0) warnProtectedQuickFiles(protectedPreview)
-        // 任务描述驱动预检（2026-09-09 刀批，轮次经济学 §3.4）：未预声明 --files 且未带
-        // forceBaseline 时，用当前脏文件 × 任务描述 token 粗匹配猜可能触及的文件，命中
-        // 受保护面即起步点破——省「--done 撞危险门 → 带 --force-baseline 重跑」一整轮。
-        // 启发式 advisory：猜错零代价（误报忽略），猜中省一轮；精确判定仍归 --done 审计。
-        if (protectedPreview.length === 0 && !forceBaseline) {
-          try {
-            const desc = quickOpts?.taskDescription || ''
-            if (desc) {
-              const dirty = String(safeGit(cwd, ['status', '--porcelain', '--untracked-files=all']).value || '')
-                .split('\n').map(l => l.slice(3).trim().split(' -> ').pop() || '')
-                .map(pp => pp.replace(/^"|"$/g, '').replace(/\\/g, '/'))
-                .filter(pp => pp && !pp.startsWith('.sillyspec/'))
-              const tokens = desc.toLowerCase().split(/[\s,，。；;:：/\\]+/).filter(t => t.length >= 3)
-              const guessed = dirty.filter(pp => tokens.some(t => pp.toLowerCase().includes(t) || t.includes(pp.split('/').pop().replace(/[.][a-z]+$/, '').toLowerCase())))
-              const guessedProtected = predictProtectedQuickFiles(guessed, { linkedChanges, forceBaseline })
-              if (guessedProtected.length > 0) {
-                console.warn(`⚠️ 任务描述可能触及受保护文件（启发式预检，精确判定在 --done）：${guessedProtected.slice(0, 3).join('、')}${guessedProtected.length > 3 ? ' …' : ''}`)
-                console.warn('   若确要改它们：重启 quick 带 --force-baseline 预声明，省 --done 被拦重跑一轮；误报忽略即可。')
-              }
-            }
-          } catch { /* 预检 fail-open */ }
-        }
-        // CLI 接管：分配 ql-ID + 写 QUICKLOG「进行中」条目 + 关联 tasks.md（持锁、当天唯一）
-        const gitUser = safeGit(cwd, ['config', 'user.name']).value || 'unknown'
-        // 标题回退：启动 quick 不带 --input 时，从关联变更的 proposal/design 提取语义标题，
-        // 避免 QUICKLOG/tasks.md 落 (quick 任务) 占位（deriveTitleFromLinkedChange 读不到则空→sanitizeDesc 回退占位）。
-        let quickDesc = quickOpts?.taskDescription || ''
-        if (!quickDesc && linkedChanges.length > 0) {
-          quickDesc = deriveTitleFromLinkedChange(specBase, linkedChanges[0])
-        }
-        const { qlId } = await allocateQuicklogEntry(specBase, gitUser, {
-          description: quickDesc,
-          linkedChanges,
-          allowedFiles,
-          // 他者会话 guard 预留让位（坑 ql-id-double-occupancy）：与 guard 落盘同源目录
-          // （Q4 单一解析，平台模式 runtimeRoot 分裂时也对齐）
-          sessionsDir: resolveQuickSessionsDir(platformOpts, specBase),
-        })
-        progress.quickGuard = {
-          sessionId: changeName,
-          // 锚定创建时的 specBase（坑 quick-cwd-drift-splits-specdir）：sessionId 全局复用但
-          // guard 按 specDir 落盘，记下归属让漂移可自证（detectQuickSessionDrift 靠目录定位即可，
-          // 此字段供诊断/未来一致性校验）。
-          specDir: specBase,
-          name_zh: '快速任务守卫',
-          baselineCommit: safeGit(cwd, ['rev-parse', 'HEAD']).value,
-          baselineFiles,
-          allowedFiles,
-          // task-01: 录每个 allowedFile 内容 sha256，供 --done auditQuickCompletion 检测同文件并发
-          // （allowedFile 在 baseline 且当前 hash ≠ 此值 = 我也改了 → 同文件并发 warn）。文件不存在/读失败跳过。
-          allowedFilesHash: Object.fromEntries(allowedFiles.flatMap(f => {
-            try { return [[f, createHash('sha256').update(readFileSync(join(cwd, f))).digest('hex')]] }
-            catch { return [] }
-          })),
-          allowNew,
-          allowDelete,
-          forceBaseline,
-          linkedChanges,
-          // 机器自动关联溯源（坑 quick-single-change-auto-link）：--done 归档闸对仅被自动
-          // 关联（信号命中猜测，非 --linked-changes 显式协作声明）的变更不触发轻量归档
-          linkedChangesAuto: Array.isArray(quickOpts?.linkedChangesAuto) ? quickOpts.linkedChangesAuto : [],
-          quicklogId: qlId,
-          // 刀①（2026-09-08）：启动 --input 的任务描述落 guard——prompt.js 渲染 step1 时据此做
-          // 模块上下文关键词匹配（changeName 是 quick-<hash> 无语义，step.prompt 全文噪音大）
-          taskDescription: quickDesc,
-          startedAt: new Date().toISOString(),
+        if (!existsSync(guardFile) && /^quick-[0-9a-f]{8}$/.test(changeName)) {
+          // 形态门（独立评审 P2 清偿）：清理/注销只对 quick 会话 id 形态执行——防任何把
+          // 真实变更名带进本分支的路径误注销其 DB 行；非 sid 形态只拒绝不清理
+          if (existsSync(sessionGuardDir)) rmSync(sessionGuardDir, { recursive: true, force: true })
+          try { pm.unregisterChange(cwd, changeName) } catch { /* 行不存在等忽略 */ }
         }
-        // 写入 .runtime/quick-sessions/<sessionId>/guard.json 供 worktree-guard hook 读取
-        // （D-002：按 session 存，多会话各自 guard 不互覆盖。runStage 作用域内 sessionId == changeName == quick-<uuid8>，见 §4.4/4.5）
-        mkdirSync(sessionGuardDir, { recursive: true })
-        writeAtomicSync(guardFile, JSON.stringify(progress.quickGuard, null, 2))
-        const parts = [`${baselineFiles.length} 个已有脏文件`]
-        if (allowedFiles.length > 0) parts.push(`${allowedFiles.length} 个 allowedFiles`)
-        if (allowNew) parts.push('允许新增文件')
-        if (allowDelete) parts.push('允许删除文件')
-        console.log(`🛡️ quick 变更边界已记录: ${parts.join(', ')}`)
-        // 归属点名（2026-09-11 用户实证：--done 审计的 allowedFiles 自动推断可漏实改文件，
-        // 被拦后与危险文件混推 --force-baseline。启动未显式 --files 时，把工作区 src/test 前缀
-        // 脏文件点名让用户当场确认归属——预声明即精确边界，免去收尾被拦一轮）。
-        if (allowedFiles.length === 0 && Array.isArray(baselineFiles)) {
-          const declCandidates = baselineFiles
-            .map((p) => String(p).split('\\').join('/'))
-            .filter((p) => p.startsWith('src/') || p.startsWith('test/'))
-          if (declCandidates.length > 0) {
-            console.log(`👀 工作区已有 ${declCandidates.length} 个 src/test 脏文件（本会话如会改到其中部分，建议现在声明边界；并行会话的他者改动勿声明）：`)
-            for (const p of declCandidates.slice(0, 8)) console.log(`   - ${p}`)
-            if (declCandidates.length > 8) console.log(`   … 共 ${declCandidates.length} 个`)
-            console.log(`   声明：sillyspec run quick --files <a.js,b.js> --change ${changeName}（恢复会话追加边界）`)
-          }
-        }
-        console.log(`📝 QUICKLOG 条目已创建: ${qlId}`)
-        // 空壳会话探测（坑 quick-duplicate-empty-shell，2026-09-03 用户实证：一次输出被吞 →
-        // agent 误判失败重跑 → 重复空壳会话，此前只能手工 reset + 删骨架）。新会话起步时点名
-        // 他者「已启动但零步骤完成」的会话 + 给官方清理口 --cancel（QUICKLOG 翻已取消 + 挂载行
-        // 移除）。advisory 不阻断：真在用的并行会话不受影响（有完成步骤即不列）。
-        try {
-          const shells = detectEmptyShellQuickSessions(platformOpts, specBase, changeName, pm, cwd)
-          if (shells.length > 0) {
-            console.warn('')
-            console.warn(`🧹 检测到 ${shells.length} 个疑似空壳 quick 会话（已启动但零步骤完成——常见于输出中断后误重启的残留）：`)
-            for (const s of shells) console.warn(`   - ${s.sessionId}（启动于 ${s.startedAt}）`)
-            console.warn(`   清理：sillyspec run quick --cancel --change <会话ID>；若确在用请忽略本提示。`)
-          }
-        } catch { /* fail-open：探测失败不打扰 quick 启动 */ }
-        // 缺 --input 且关联变更无可提取标题 → 条目落「(quick 任务)」占位标题，平台「快速修复」列表
-        // 默认隐藏进行中占位（task-06 口径），长会话全程不可见、语义标题要到最终 --done 才回填。
-        // 此刻会话刚起步零沉没成本，提示放弃重启带 --input 是最便宜的自愈点。
-        if (!quickDesc) {
-          console.warn('')
-          console.warn('⚠️ 本次 quick 未带 --input：QUICKLOG 条目将以占位标题「(quick 任务)」落盘')
-          console.warn('   平台「快速修复」列表默认隐藏进行中的占位条目，语义标题要到最终 --done 才回填。')
-          console.warn('   长任务建议放弃本会话、带一句话任务描述重启（旧会话 run quick --reset --change <sessionId> 重置）：')
-          console.warn('     sillyspec run quick --input "<一句话任务描述>" [--linked-changes <a,b>] [--files <...>]')
-        }
-        // 回填 DB changes 行的 title + quicklog_id，让 quick-<hex> 可读、DB↔QUICKLOG 可对账。
-        // title 用 quickDesc（任务描述或关联变更标题）经 sanitizeDesc 压一行限长，与 QUICKLOG 条目标题同源。
-        try {
-          pm.updateChangeMeta(cwd, changeName, { title: sanitizeDesc(quickDesc), quicklogId: qlId });
-        } catch { /* 回填失败不阻断 quick 启动 */ }
-        pm._write(cwd, progress, changeName)
-        // ql-20260819-009：起步即推「进行中」占位条目到平台。runStage 前段三处 triggerSync
-        // （autoDetectChange / currentStage 切换 / stale 复位）全在本块之前执行——「进行中」骨架
-        // 此前要等第一次 --done 才上平台，平台快速修复列表存在起步盲窗。此刻骨架已分配 + 进度已
-        // 落盘，补一次 triggerSync 立即推 QUICKLOG（quick-<hex8> 会话自动降级 syncSpecTreeOnly
-        // 只推 spec 树；未连接平台静默跳过、8s 熔断 best-effort，均不阻断 quick 启动）。平台派发
-        // （claim）模式起步同样走 runStage 本块，一处插入全覆盖；guard 已存在的跨进程重入走上方
-        // existingGuard 分支跳过本块，条目已在平台，不重复推。
-        triggerSync(cwd, changeName, platformOpts)
-      } catch (e) {
-        console.warn(`⚠️ baseline 记录失败: ${e.message}`)
-      }
+        const marker = join(resolveRuntimeRoot(platformOpts, specBase), 'current-quick-run-id')
+        if (existsSync(marker) && readFileSync(marker, 'utf8').trim() === changeName) unlinkSync(marker)
+      } catch { /* 清理失败不掩盖拒绝语义 */ }
+      process.exit(1)
     }
   }
 
@@ -572,49 +470,19 @@ export async function runStage(pm, progress, stageName, cwd, changeName, skipApp
 
   const defSteps = await getStageSteps(stageName, cwd, progress, platformOpts?.specRoot || null)
   if (defSteps && defSteps[currentIdx]) {
+    // ── burst 渲染分支（2026-09-22-stage-burst-fold D-002/D-006/D-008，FR-02）──
+    // 白名单主阶段 + readStageBurst 开启时走单趟折叠渲染：noAI 步就地 CLI 执行，AI 步逐个
+    // 调既有 outputStep 一次下发全部剩余说明书（渲染器零改动）。waiting 步在此不可达——
+    // runStage 对任一 waiting 步的硬拦（上方 waiting 检查块 exit(1) 指引 --continue）先于本分支。
+    if (STAGE_BURST_STAGES.includes(stageName) && await readStageBurst(cwd)) {
+      return await renderStageBurst({ stageName, defSteps, cwd, changeName, platformOpts, progress, pm, specBase, scanProfile, stageData })
+    }
     // noAI 步骤自动完成（CLI-only，不需要 Agent 参与）
     if (defSteps[currentIdx].noAI || stageData.steps[currentIdx]?.noAI) {
       const stepName = defSteps[currentIdx].name
       const cliAction = defSteps[currentIdx]._cliAction || stageData.steps[currentIdx]?._cliAction
       console.log(`⚙️ Step ${currentIdx + 1}/${stageData.steps.length}: ${stepName}（CLI 自动执行，无需 Agent）`)
-      if (cliAction === 'scanPreflight') {
-        await executeScanPreflight(cwd, platformOpts, scanProfile)
-      } else if (cliAction === 'scanPostcheck') {
-        await executeScanPostcheck(cwd, platformOpts, scanProfile)
-      } else if (cliAction === 'scanDetectProjects') {
-        await executeScanDetectProjects(cwd, platformOpts)
-      } else if (cliAction === 'scanResumeCheck') {
-        await executeScanResumeCheck(cwd, platformOpts)
-      } else if (cliAction === 'scanFinalize') {
-        await executeScanFinalize(cwd, platformOpts)
-      } else if (cliAction === 'planPostcheck') {
-        await executePlanPostcheck(cwd, platformOpts, progress)
-      } else if (cliAction === 'doctorRunDiagnostics') {
-        // 2026-09-09-doctor-noai FR-01：doctor 阶段折叠——noAI 步跑全量诊断
-        // （八维 + 三新 detector）+ renderDoctorSummary 渲染 + doctor-diagnosis.json 落盘
-        const { runDoctorDiagnostics, renderDoctorSummary, writeDoctorDiagnosis } = await import('../doctor-diagnostics.js')
-        const diag = await runDoctorDiagnostics({ cwd })
-        console.log(renderDoctorSummary(diag))
-        try { writeDoctorDiagnosis(diag, (platformOpts?.specRoot || join(cwd, '.sillyspec'))) } catch { /* 落盘 fail-soft */ }
-      } else if (cliAction === 'progressConfirm') {
-        // 主流程 step1「进度确认」noAI 化（2026-09-07）：brainstorm/execute/verify——
-        // 快照本就 CLI 注入、阶段路由已由 run 落定，省一轮「复述摘要→--done」往返
-        executeProgressConfirm({ stageName, cwd, stageData, changeName, pm })
-      } else if (cliAction === 'verifyRunQualityScan') {
-        // P0-1（noai-ir-roadmap §3）：verify「运行测试和质量扫描」noAI 化——test/lint 实测提前，
-        // 指纹落盘供 --done 复用免重跑（长套件不再跑两遍）；失败 throw 不盖 completed，
-        // 输出 + 并行 WIP 归因提示透传给 agent（前置一/二）。
-        const { executeVerifyQualityScan } = await import('./verify-quality-scan.js')
-        await executeVerifyQualityScan({ cwd, specBase, changeName, platformOpts })
-      } else if (cliAction === 'archiveDistill') {
-        // P0-4 安全变体（noai-ir-roadmap §3）：archive「decision-distill 决策提炼」noAI 化——
-        // 提炼本体是 CLI 纯函数（旧 prompt 即「调函数转述输出」纯中继）；needsWait 裁决收敛到
-        // 「确认归档 --confirm」。全路径不抛（裁决是确认步输入，非本步阻断条件）。
-        const { executeArchiveDistill } = await import('./archive-distill.js')
-        await executeArchiveDistill({ cwd, specBase, changeName })
-      } else {
-        throw new Error(`noAI 步骤 ${stepName} 的未知 _cliAction: ${cliAction}——请在 stage.js 注册对应分支`)
-      }
+      await executeNoAiCliAction({ cliAction, stepName, stageName, cwd, specBase, changeName, platformOpts, progress, pm, scanProfile, stageData })
       stageData.steps[currentIdx].status = 'completed'
       stageData.steps[currentIdx].completedAt = new Date().toLocaleString('zh-CN', { hour12: false })
       pm._write(cwd, progress, changeName)
@@ -624,21 +492,8 @@ export async function runStage(pm, progress, stageName, cwd, changeName, skipApp
         console.log('')
         await outputStep(stageName, nextIdx, defSteps, cwd, changeName, progress.project || null, platformOpts, null, collectStageWaitHistory(progress, stageName))
       } else {
-        // 所有步骤完成
-        stageData.status = 'completed'
-        stageData.completedAt = new Date().toLocaleString('zh-CN', { hour12: false })
-        // 主阶段完成钉 currentStage（troubleshooting #56 根因修复，2026-09-08；与 complete.js 两处同语义）
-        if (!AUXILIARY_STAGES.includes(stageName)) progress.currentStage = stageName
-        // persist _write 移到 completeStageGates 成功之后（task-02 / review-2026-08-09 #2）：gate 异常/失败 → rollback 回 in-progress 落盘，此处未到 _write，DB 不留假 completed。
-        // 阶段完成收尾共享管线（noAI 末步核心修复 S1：plan postcheck independent-tier review verdict=fail /
-        // 平台 scan manifest 此前被绕过）。gate 失败已 rollback 为 in-progress，early-return（不 fall through 到末尾 return）。
-        const _stageGatesResult = await completeStageGates({ stageName, cwd, changeName, platformOpts, specBase, progress, pm, stageData, steps, currentIdx, outputText: null })
-        // task-04 / A5：gate 失败（stageCompleted===false）设进程退出码 1（与 completeStep/continueStep 同语义）。
-        if (_stageGatesResult?.stageCompleted === false) process.exitCode = 1
-        if (_stageGatesResult) return _stageGatesResult
-        // gate 全过：persist completed（task-02 移后；此处无 triggerSync，与同文件 noAI 末步语义一致）。
-        pm._write(cwd, progress, changeName)
-        console.log(`\n✅ ${stageName} 阶段全部完成。`)
+        // 所有步骤完成——收尾管线抽为 finalizeStageAllStepsDone（burst 全 noAI 场景共用，防第二副本）
+        return await finalizeStageAllStepsDone({ stageName, cwd, changeName, platformOpts, specBase, progress, pm, stageData, currentIdx })
       }
       return
     }
@@ -646,6 +501,117 @@ export async function runStage(pm, progress, stageName, cwd, changeName, skipApp
   }
 }
 
+// ── burst 阶段折叠助手族（2026-09-22-stage-burst-fold，D-002/D-006/D-008）──
+// 白名单 STAGE_BURST_STAGES 自 shared.js import（与 command.js --done 分发门共用单一事实源）。
+
+/**
+ * noAI 步 _cliAction 分发（原 runStage noAI 分支 if-链原样抽取，D-008——常规单步路径与
+ * burst 渲染循环共同调用，单一事实源防第三副本；行为零变化：同一 if-链、同一入参语义。
+ * complete.js 的 --done 路径平行副本不动——"不改 completeStep 本体"边界）。
+ */
+async function executeNoAiCliAction({ cliAction, stepName, stageName, cwd, specBase, changeName, platformOpts, progress, pm, scanProfile, stageData }) {
+  if (cliAction === 'scanPreflight') {
+    await executeScanPreflight(cwd, platformOpts, scanProfile)
+  } else if (cliAction === 'scanPostcheck') {
+    await executeScanPostcheck(cwd, platformOpts, scanProfile)
+  } else if (cliAction === 'scanDetectProjects') {
+    await executeScanDetectProjects(cwd, platformOpts)
+  } else if (cliAction === 'scanResumeCheck') {
+    await executeScanResumeCheck(cwd, platformOpts)
+  } else if (cliAction === 'scanFinalize') {
+    await executeScanFinalize(cwd, platformOpts)
+  } else if (cliAction === 'planPostcheck') {
+    await executePlanPostcheck(cwd, platformOpts, progress)
+  } else if (cliAction === 'doctorRunDiagnostics') {
+    // 2026-09-09-doctor-noai FR-01：doctor 阶段折叠——noAI 步跑全量诊断
+    // （八维 + 三新 detector）+ renderDoctorSummary 渲染 + doctor-diagnosis.json 落盘
+    const { runDoctorDiagnostics, renderDoctorSummary, writeDoctorDiagnosis } = await import('../doctor-diagnostics.js')
+    const diag = await runDoctorDiagnostics({ cwd })
+    console.log(renderDoctorSummary(diag))
+    try { writeDoctorDiagnosis(diag, (platformOpts?.specRoot || join(cwd, '.sillyspec'))) } catch { /* 落盘 fail-soft */ }
+  } else if (cliAction === 'progressConfirm') {
+    // 主流程 step1「进度确认」noAI 化（2026-09-07）：brainstorm/execute/verify——
+    // 快照本就 CLI 注入、阶段路由已由 run 落定，省一轮「复述摘要→--done」往返
+    executeProgressConfirm({ stageName, cwd, stageData, changeName, pm })
+  } else if (cliAction === 'verifyRunQualityScan') {
+    // P0-1（noai-ir-roadmap §3）：verify「运行测试和质量扫描」noAI 化——test/lint 实测提前，
+    // 指纹落盘供 --done 复用免重跑（长套件不再跑两遍）；失败 throw 不盖 completed，
+    // 输出 + 并行 WIP 归因提示透传给 agent（前置一/二）。
+    const { executeVerifyQualityScan } = await import('./verify-quality-scan.js')
+    await executeVerifyQualityScan({ cwd, specBase, changeName, platformOpts })
+  } else if (cliAction === 'archiveDistill') {
+    // P0-4 安全变体（noai-ir-roadmap §3）：archive「decision-distill 决策提炼」noAI 化——
+    // 提炼本体是 CLI 纯函数（旧 prompt 即「调函数转述输出」纯中继）；needsWait 裁决收敛到
+    // 「确认归档 --confirm」。全路径不抛（裁决是确认步输入，非本步阻断条件）。
+    const { executeArchiveDistill } = await import('./archive-distill.js')
+    await executeArchiveDistill({ cwd, specBase, changeName })
+  } else {
+    throw new Error(`noAI 步骤 ${stepName} 的未知 _cliAction: ${cliAction}——请在 stage.js 注册对应分支`)
+  }
+}
+
+/**
+ * 阶段全部步骤完成后的收尾管线（原 noAI 末步 :640-653 块原样抽取）——noAI 末步路径与
+ * burst 渲染全 noAI 场景共用。gate 失败 rollback + exitCode 语义逐字保留：
+ * persist _write 移到 completeStageGates 成功之后（gate 异常/失败 → rollback 回 in-progress
+ * 落盘，DB 不留假 completed）；阶段完成收尾共享管线（plan postcheck independent-tier review
+ * verdict=fail / 平台 scan manifest 不被绕过）。
+ */
+async function finalizeStageAllStepsDone({ stageName, cwd, changeName, platformOpts, specBase, progress, pm, stageData, currentIdx }) {
+  stageData.status = 'completed'
+  stageData.completedAt = new Date().toLocaleString('zh-CN', { hour12: false })
+  // 主阶段完成钉 currentStage（troubleshooting #56 根因修复，2026-09-08；与 complete.js 两处同语义）
+  if (!AUXILIARY_STAGES.includes(stageName)) progress.currentStage = stageName
+  const _stageGatesResult = await completeStageGates({ stageName, cwd, changeName, platformOpts, specBase, progress, pm, stageData, steps: stageData.steps, currentIdx, outputText: null })
+  // task-04 / A5：gate 失败（stageCompleted===false）设进程退出码 1（与 completeStep/continueStep 同语义）。
+  if (_stageGatesResult?.stageCompleted === false) process.exitCode = 1
+  if (_stageGatesResult) return _stageGatesResult
+  // gate 全过：persist completed（此处无 triggerSync，与 noAI 末步语义一致）。
+  pm._write(cwd, progress, changeName)
+  console.log(`\n✅ ${stageName} 阶段全部完成。`)
+  return undefined
+}
+
+/**
+ * burst 折叠渲染（D-002，FR-02）：单趟遍历 defSteps——跳过 completed/skipped；noAI 步就地
+ * CLI 执行 + 标完成落库（与单步 noAI 路径同语义）；AI 步逐个调既有 outputStep（渲染器零改动，
+ * 首 AI 步的 persona/护栏注入由 outputStep 的 firstRenderableIdx 机制自然生效）。遍历后：
+ * 无剩余步 → finalizeStageAllStepsDone 收尾（全 noAI 场景）；有剩余 → burst 尾提示。
+ * blocked/stale 步按「非 completed/skipped」正常进说明书（currentIdx 的 stale/blocked 已在
+ * runStage 上方拉回 pending；尾随 stale 步的完成侧拉回归 completeStepBurst 轮首，D-003@v2）。
+ */
+async function renderStageBurst({ stageName, defSteps, cwd, changeName, platformOpts, progress, pm, specBase, scanProfile, stageData }) {
+  let lastNoAiIdx = -1
+  for (let i = 0; i < defSteps.length; i++) {
+    const st = stageData.steps[i]
+    if (st && (st.status === 'completed' || st.status === 'skipped')) continue
+    const isNoAI = defSteps[i]?.noAI || st?.noAI
+    if (isNoAI) {
+      const stepName = defSteps[i].name
+      const cliAction = defSteps[i]._cliAction || st?._cliAction
+      console.log(`⚙️ Step ${i + 1}/${stageData.steps.length}: ${stepName}（burst 就地 CLI 自动执行）`)
+      await executeNoAiCliAction({ cliAction, stepName, stageName, cwd, specBase, changeName, platformOpts, progress, pm, scanProfile, stageData })
+      if (st) {
+        st.status = 'completed'
+        st.completedAt = new Date().toLocaleString('zh-CN', { hour12: false })
+      }
+      pm._write(cwd, progress, changeName)
+      lastNoAiIdx = i
+      continue
+    }
+    await outputStep(stageName, i, defSteps, cwd, changeName, progress.project || null, platformOpts, null, collectStageWaitHistory(progress, stageName))
+  }
+  const remainingIdx = stageData.steps.findIndex(s => s && s.status !== 'completed' && s.status !== 'skipped')
+  if (remainingIdx === -1) {
+    // currentIdx=本轮最后执行的 noAI 步（与单步路径「刚执行步」同语义；尾随 skipped 场景不漂移——
+    // Grill execute 轮 P2-1），防御回退 defSteps.length - 1
+    return await finalizeStageAllStepsDone({ stageName, cwd, changeName, platformOpts, specBase, progress, pm, stageData, currentIdx: lastNoAiIdx !== -1 ? lastNoAiIdx : defSteps.length - 1 })
+  }
+  console.log('')
+  console.log('📦 burst 模式：本阶段全部说明书已一次下发。干完全部步骤后用一次 --done 收口（CLI 内部逐步推进+逐步校验，失败即停在失败步）。')
+  return undefined
+}
+