sillyspec 3.8.5 → 3.8.7

package/src/run.js

@@ -1,640 +0,0 @@
-/**
- * sillyspec run 命令实现
- *
- * CLI 成为流程引擎，AI 变成步骤执行器。
- */
-import { basename, join } from 'path'
-import { existsSync, readdirSync, mkdirSync, writeFileSync, appendFileSync, readFileSync, statSync } from 'fs'
-import { ProgressManager } from './progress.js'
-import { stageRegistry, getNextStage, auxiliaryStages } from './stages/index.js'
-import { buildExecuteSteps } from './stages/execute.js'
-import { buildPlanSteps } from './stages/plan.js'
-
-/**
- * 获取阶段的步骤定义（execute 需要动态构建）
- */
-async function getStageSteps(stageName, cwd, progress) {
-  if (stageName === 'execute') {
-    const changesDir = join(cwd, '.sillyspec', 'changes')
-    let planFile = null
-    // 优先用 currentChange 指定的变更名
-    if (progress.currentChange) {
-      const target = join(changesDir, progress.currentChange, 'plan.md')
-      if (existsSync(target)) planFile = target
-    }
-    // fallback：扫描 changes/ 非 archive 目录下的 plan.md
-    if (!planFile && existsSync(changesDir)) {
-      const candidates = []
-      for (const entry of readdirSync(changesDir, { withFileTypes: true })) {
-        if (!entry.isDirectory() || entry.name === 'archive') continue
-        const p = join(changesDir, entry.name, 'plan.md')
-        if (existsSync(p)) candidates.push({ name: entry.name, path: p })
-      }
-      if (candidates.length === 1) {
-        planFile = candidates[0].path
-      } else if (candidates.length > 1) {
-        console.log('⚠️  检测到多个变更，请选择：')
-        candidates.forEach((c, i) => console.log(`  ${i + 1}. ${c.name}`))
-        const readline = await import('readline')
-        const rl = readline.createInterface({ input: process.stdin, output: process.stdout })
-        const answer = await new Promise(resolve => {
-          rl.question(`\n请输入编号（默认 1）：`, input => {
-            rl.close()
-            const num = parseInt(input) || 1
-            resolve(num >= 1 && num <= candidates.length ? num - 1 : 0)
-          })
-        })
-        planFile = candidates[answer].path
-        console.log(`✅ 已选择：${candidates[answer].name}\n`)
-      }
-    }
-    return buildExecuteSteps(planFile)
-  }
-  if (stageName === 'plan') {
-    const changesDir = join(cwd, '.sillyspec', 'changes')
-    let changeDir = null
-    if (progress.currentChange) {
-      const target = join(changesDir, progress.currentChange)
-      if (existsSync(target)) changeDir = target
-    }
-    if (!changeDir && existsSync(changesDir)) {
-      const entries = readdirSync(changesDir, { withFileTypes: true }).filter(e => e.isDirectory() && e.name !== 'archive')
-      if (entries.length === 1) changeDir = join(changesDir, entries[0].name)
-    }
-    return buildPlanSteps(changeDir)
-  }
-  const def = stageRegistry[stageName]
-  return def ? def.steps : null
-}
-
-/**
- * 确保阶段的 steps 已初始化到 progress.json
- */
-async function ensureStageSteps(progress, stageName, cwd) {
-  if (!progress.stages) progress.stages = {}
-
-  const steps = await getStageSteps(stageName, cwd, progress)
-  if (!steps) return false
-
-  if (!progress.stages[stageName] || !progress.stages[stageName].steps || progress.stages[stageName].steps.length === 0) {
-    progress.stages[stageName] = {
-      status: 'in-progress',
-      startedAt: new Date().toLocaleString('zh-CN',{hour12:false}),
-      completedAt: null,
-      steps: steps.map(s => ({ name: s.name, status: 'pending' }))
-    }
-    return true // 需要写入
-  }
-
-  // 检查步骤数量是否匹配（execute 动态步骤可能变化）
-  if (progress.stages[stageName].steps.length !== steps.length) {
-    // 保留已完成的状态，重新构建步骤列表
-    const oldSteps = progress.stages[stageName].steps
-    progress.stages[stageName].steps = steps.map((s, i) => {
-      const old = oldSteps[i]
-      if (old && old.name === s.name) return old
-      return { name: s.name, status: 'pending' }
-    })
-    return true
-  }
-
-  return false
-}
-
-/**
- * 输出当前步骤的 prompt
- */
-function outputStep(stageName, stepIndex, steps, cwd) {
-  const step = steps[stepIndex]
-  const total = steps.length
-  const projectName = basename(cwd)
-
-  const personas = {
-    brainstorm: `### 🎯 你的角色：资深架构师
-你是一位有 15 年经验的系统架构师。先理解业务本质，再设计技术方案。决策附理由，方案列 trade-off。不确定就说不确定，不猜。`,
-    plan: `### 📋 你的角色：技术项目经理
-你是一位经验丰富的技术项目经理。任务拆解粒度均匀，依赖关系明确。每个任务有完成标准，Wave 间有依赖说明。条理清晰，不做模糊描述。`,
-    execute: `### 💻 你的角色：高级工程师
-你是一位严谨的高级工程师。先读规范再写代码，严格遵循 CONVENTIONS.md 和 plan.md。**你不是设计师，是执行者——按 plan 搬砖，禁止发散思维。** 发现 plan 不合理就停下来反馈，不要自己改方案。代码有清晰职责划分，边界处理完善。少说多做，遇到规范冲突优先问。`,
-    verify: `### 🔍 你的角色：QA 专家
-你是一位吹毛求疵的 QA 专家。假设所有代码都有 bug，用最坏情况测试。关注边界、异常、并发。有问题直说，用证据说话，不写"看起来没问题"。`,
-    quick: `### 💻 你的角色：全栈老兵
-你是一位实战经验丰富的全栈工程师。不纠结架构和流程，理解需求就直接干。不确定的地方先问清楚再动手，先读后写，改完就收。问题排查思路开阔，前端报错不一定是前端问题——可能是后端数据、浏览器兼容、甚至设备硬件。解决方案实用接地气，用户描述有误敢于直接指出。`
-  }
-
-  console.log(`---`)
-  console.log(`stage: ${stageName}`)
-  console.log(`step: ${stepIndex + 1}/${total}`)
-  console.log(`stepName: ${step.name}`)
-  console.log(`project: ${projectName}`)
-  console.log(`---\n`)
-  if (personas[stageName]) {
-    console.log(personas[stageName])
-    console.log('')
-  }
-  console.log(`## Step ${stepIndex + 1}/${total}: ${step.name}\n`)
-  console.log(step.prompt)
-  console.log(`\n### ⚠️ 铁律`)
-  console.log('- **文档是核心资产，代码是文档的产物。** 没有文档就没有代码——文档是 AI 的记忆，是团队协作的基础，是后续维护的唯一依据。任何代码产出必须先有对应的设计/规范文档支撑。')
-  console.log('- 只做本步骤描述的操作，不得自行扩展或跳过')
- console.log('- 不要回头修改已完成的步骤')
-  console.log('- 不要编造不存在的 CLI 子命令')
-  console.log('- 完成后立即执行 --done 命令，不得跳过')
-  console.log('- 文档类型文件（.md/.yaml/.json 等）头部必须包含 author（git 用户名）和 created_at（精确到秒）')
-  console.log('- 执行构建/测试前必须先读 local.yaml，优先使用其中配置的命令、路径和环境变量；未配置时才使用默认值')
-  console.log(`\n### 完成后执行`)
-  console.log(`sillyspec run ${stageName} --done --input "用户原始需求/反馈" --output "你的摘要"`)
-}
-
-/**
- * sillyspec run <stage> 主命令
- */
-export async function runCommand(args, cwd) {
-  // 解析参数
-  const stageName = args[0]
-  const flags = args.slice(1)
-
-  if (!stageName) {
-    console.error('❌ 请指定阶段，例如: sillyspec run brainstorm')
-    console.error(`可选: ${Object.keys(stageRegistry).join(', ')}, auto`)
-    process.exit(1)
-  }
-
-  if (!stageRegistry[stageName] && stageName !== 'auto') {
-    console.error(`❌ 未知阶段: ${stageName}`)
-    console.error(`可选: ${Object.keys(stageRegistry).join(', ')}, auto`)
-    process.exit(1)
-  }
-
-  const isDone = flags.includes('--done')
-  const isSkip = flags.includes('--skip')
-  const isStatus = flags.includes('--status')
-  const isReset = flags.includes('--reset')
-
-  // 解析 --output
-  let outputText = null
-  const outputIdx = flags.indexOf('--output')
-  if (outputIdx !== -1 && flags[outputIdx + 1]) {
-    outputText = flags[outputIdx + 1]
-  }
-
-  // 解析 --input
-  let inputText = null
-  const inputIdx = flags.indexOf('--input')
-  if (inputIdx !== -1 && flags[inputIdx + 1]) {
-    inputText = flags[inputIdx + 1]
-  }
-
-  // 解析 --change <name>
-  let changeName = null
-  const changeIdx = flags.indexOf('--change')
-  if (changeIdx !== -1 && flags[changeIdx + 1]) {
-    changeName = flags[changeIdx + 1]
-  }
-
-  const isAuxiliary = auxiliaryStages.includes(stageName)
-
-  const pm = new ProgressManager()
-  let progress = pm.read(cwd)
-
-  if (!progress) {
-    // 辅助命令可以在没有 progress.json 时工作（比如 scan）
-    if (!isAuxiliary) {
-      console.error('❌ 未找到 progress.json，请先运行 sillyspec init')
-      process.exit(1)
-    }
-    progress = pm.init(cwd)
-  }
-
-  // -- auto 模式：自动推进所有流程阶段
-  if (stageName === 'auto') {
-    return await runAutoMode(pm, progress, cwd, flags)
-  }
-
-  // --change 设置当前变更名
-  if (changeName) {
-    progress.currentChange = changeName
-    progress.lastActive = new Date().toLocaleString('zh-CN', { hour12: false })
-    pm._write(cwd, progress)
-    console.log(`✅ 当前变更设置为：${changeName}`)
-    return
-  }
-
-  // --reset
-  if (isReset) {
-    return await resetStage(pm, progress, stageName, cwd)
-  }
-
-  // 确保步骤已初始化
-  const changed = await ensureStageSteps(progress, stageName, cwd)
-  if (changed) {
-    pm._write(cwd, progress)
-    progress = pm.read(cwd)
-  }
-
-  // --status
-  if (isStatus) {
-    return showStatus(progress, stageName)
-  }
-
-  // --skip
-  if (isSkip) {
-    return await skipStep(pm, progress, stageName, cwd)
-  }
-
-  // --done
-  if (isDone) {
-    return await completeStep(pm, progress, stageName, cwd, outputText, inputText)
-  }
-
-  // 默认：输出当前步骤
-  return await runStage(pm, progress, stageName, cwd)
-}
-
-async function runStage(pm, progress, stageName, cwd) {
-  const stageData = progress.stages[stageName]
-  if (!stageData || !stageData.steps) {
-    console.error(`❌ 阶段 ${stageName} 未初始化`)
-    process.exit(1)
-  }
-
-  const steps = stageData.steps
-  let currentIdx = steps.findIndex(s => s.status !== 'completed' && s.status !== 'skipped')
-
-  if (currentIdx === -1) {
-    // 阶段已完成
-    console.log(`✅ ${stageName} 阶段已完成。`)
-    console.log(`  继续执行将重新开始，可用 --reset 显式重置。\n`)
-    // 自动重置，允许重复执行
-    steps.forEach(s => { s.status = 'pending'; s.completedAt = null; s.output = null; s.startedAt = null })
-    stageData.status = 'in_progress'
-    stageData.completedAt = null
-    pm._write(cwd, progress)
-    currentIdx = 0
-  } else if (currentIdx > 0) {
-    // 有进行中的步骤，提示用户
-    const completed = currentIdx
-    const total = steps.length
-    console.log(`⚠️  ${stageName} 已进行到第 ${currentIdx + 1}/${total} 步（前 ${completed} 步已完成）。`)
-    console.log(`  继续执行将从中断处恢复，用 --reset 可重新开始。\n`)
-  }
-
-  const stageDef = stageRegistry[stageName]
-  const defSteps = await getStageSteps(stageName, cwd, progress)
-  if (defSteps && defSteps[currentIdx]) {
-    outputStep(stageName, currentIdx, defSteps, cwd)
-  }
-}
-
-function validateMetadata(cwd, stageName) {
-  const changesDir = join(cwd, '.sillyspec', 'changes')
-  if (!existsSync(changesDir)) return
-
-  // 找最近 10 分钟内修改的 md/yaml 文件
-  const cutoff = Date.now() - 10 * 60 * 1000
-  const missing = []
-
-  function walk(dir) {
-    for (const entry of readdirSync(dir, { withFileTypes: true })) {
-      const full = join(dir, entry.name)
-      try {
-        if (entry.isDirectory()) { walk(full); continue }
-        if (!/\.(md|yaml|yml)$/.test(entry.name)) continue
-        const mtime = statSync(full).mtimeMs
-        if (mtime < cutoff) continue
-        const content = readFileSync(full, 'utf-8')
-        if (!content.includes('author:') && !content.includes('author：')) missing.push(full)
-        if (!content.includes('created_at:') && !content.includes('created_at：')) missing.push(full)
-      } catch (e) { /* skip unreadable files */ }
-    }
-  }
-
-  walk(changesDir)
-  const unique = [...new Set(missing)]
-  if (unique.length > 0) {
-    console.log(`\n⚠️  以下文件缺少 author 或 created_at 元数据：`)
-    unique.forEach(f => console.log(`  - ${f.replace(cwd + '/', '')}`))
-    console.log('请在文件头部添加 author（git 用户名）和 created_at（精确到秒）')
-  }
-}
-
-async function completeStep(pm, progress, stageName, cwd, outputText, inputText = null) {
-  const stageData = progress.stages[stageName]
-  if (!stageData || !stageData.steps) {
-    console.error(`❌ 阶段 ${stageName} 未初始化`)
-    process.exit(1)
-  }
-
-  const steps = stageData.steps
-  const currentIdx = steps.findIndex(s => s.status === 'pending')
-
-  if (currentIdx === -1) {
-    console.error('没有待完成的步骤')
-    process.exit(1)
-  }
-
-  // 标记完成
-  steps[currentIdx].status = 'completed'
-  steps[currentIdx].completedAt = new Date().toLocaleString('zh-CN',{hour12:false})
-  if (outputText) {
-    const MAX_OUTPUT = 200
-    if (outputText.length > MAX_OUTPUT) {
-      steps[currentIdx].output = outputText.slice(0, MAX_OUTPUT) + '…'
-      // Save full output to artifacts/
-      const artifactsDir = join(cwd, '.sillyspec', '.runtime', 'artifacts')
-      mkdirSync(artifactsDir, { recursive: true })
-      const ts = new Date().toISOString().slice(0,19).replace(/[-T:]/g, '')
-      writeFileSync(join(artifactsDir, `${stageName}-step${currentIdx + 1}-${ts}.txt`), outputText)
-    } else {
-      steps[currentIdx].output = outputText
-    }
-  }
-
-  // 检查是否还有下一步
-  // plan 阶段 Step 4（展开任务）完成后，动态追加 task 蓝图步骤
-  if (stageName === 'plan' && currentIdx === 3 && progress.currentChange) {
-    const planFile = join(cwd, '.sillyspec', 'changes', progress.currentChange, 'plan.md')
-    if (existsSync(planFile)) {
-      const planContent = readFileSync(planFile, 'utf8')
-      const { buildPlanSteps } = await import('./stages/plan.js')
-      const fullSteps = buildPlanSteps(join(cwd, '.sillyspec', 'changes', progress.currentChange), planContent)
-      // fullSteps[0..4] = fixedPrefix, fullSteps[-2..-1] = fixedSuffix
-      // 中间的是 task 蓝图步骤，插入到当前 steps 中
-      // 当前 steps 已有 5 个 fixedPrefix，找到需要插入的 task 步骤
-      const taskSteps = fullSteps.slice(5, -2) // 排除 5 个前缀和 2 个后缀
-      if (taskSteps.length > 0) {
-        // 插入审查一致性 + 保存步骤（后缀）
-        const suffixSteps = fullSteps.slice(-2)
-        for (const ts of taskSteps) {
-          steps.push({ name: ts.name, status: 'pending', prompt: ts.prompt, outputHint: ts.outputHint, optional: false })
-        }
-        for (const ss of suffixSteps) {
-          steps.push({ name: ss.name, status: 'pending', prompt: ss.prompt, outputHint: ss.outputHint, optional: false })
-        }
-        // 重新查找下一步
-      }
-    }
-  }
-
-  const nextPendingIdx = steps.findIndex(s => s.status === 'pending')
-
-  if (nextPendingIdx === -1) {
-    // 全部完成
-    stageData.status = 'completed'
-    stageData.completedAt = new Date().toLocaleString('zh-CN',{hour12:false})
-
-    const next = getNextStage(stageName)
-    if (next) {
-      progress.currentStage = next
-      if (!progress.stages[next]) progress.stages[next] = { status: 'pending', steps: [], startedAt: null, completedAt: null }
-      if (progress.stages[next].status === 'pending' || !progress.stages[next].status) {
-        progress.stages[next].status = 'in-progress'
-        progress.stages[next].startedAt = new Date().toLocaleString('zh-CN',{hour12:false})
-      }
-    }
-
-    progress.lastActive = new Date().toLocaleString('zh-CN',{hour12:false})
-    pm._write(cwd, progress)
-
-    // deriveState 轻量校验
-    try {
-      const { deriveState } = await import('./derive.js')
-      const result = deriveState(cwd, { mode: 'light', fix: true, pm, progress })
-      if (result.fixed > 0) {
-        console.log(`⚠️ 状态修复：${result.fixed} 个步骤已从 artifacts 恢复`)
-      }
-    } catch {}
-
-    // Append to user-inputs.md
-    if (outputText) {
-      const inputsPath = join(cwd, '.sillyspec', '.runtime', 'user-inputs.md')
-      const entry = `\n## ${new Date().toLocaleString('zh-CN',{hour12:false})} | ${stageName}: ${steps[currentIdx].name}\n${inputText ? "- 输入：" + inputText + "\n" : ""}- 输出：${outputText}\n`
-      appendFileSync(inputsPath, entry)
-    }
-
-    // 验证：检查生成的文件是否包含 author 和 created_at
-    validateMetadata(cwd, stageName)
-
-    const total = steps.length
-    console.log(`✅ ${stageName} 阶段已完成（${total}/${total} 步）`)
-    if (next) {
-      console.log(`\n下一步：sillyspec run ${next}`)
-      console.log(`或：/sillyspec:${next}`)
-    }
-    return
-  }
-
-  progress.lastActive = new Date().toLocaleString('zh-CN',{hour12:false})
-  pm._write(cwd, progress)
-
-  // Append to user-inputs.md
-  if (outputText) {
-    const inputsPath = join(cwd, '.sillyspec', '.runtime', 'user-inputs.md')
-    const entry = `\n## ${new Date().toLocaleString('zh-CN',{hour12:false})} | ${stageName}: ${steps[currentIdx].name}\n${inputText ? "- 输入：" + inputText + "\n" : ""}- 输出：${outputText}\n`
-    appendFileSync(inputsPath, entry)
-  }
-
-  const defSteps = await getStageSteps(stageName, cwd, progress)
-  console.log(`✅ Step ${currentIdx + 1}/${steps.length} 完成：${steps[currentIdx].name}\n`)
-  outputStep(stageName, nextPendingIdx, defSteps, cwd)
-}
-
-async function skipStep(pm, progress, stageName, cwd) {
-  const stageData = progress.stages[stageName]
-  if (!stageData || !stageData.steps) {
-    console.error(`❌ 阶段 ${stageName} 未初始化`)
-    process.exit(1)
-  }
-
-  const steps = stageData.steps
-  const currentIdx = steps.findIndex(s => s.status === 'pending')
-
-  if (currentIdx === -1) {
-    console.error('没有待跳过的步骤')
-    process.exit(1)
-  }
-
-  const defSteps = await getStageSteps(stageName, cwd, progress)
-  const stepDef = defSteps ? defSteps[currentIdx] : null
-  if (stepDef && !stepDef.optional) {
-    console.error(`❌ 步骤 "${steps[currentIdx].name}" 不可跳过`)
-    process.exit(1)
-  }
-
-  steps[currentIdx].status = 'skipped'
-  steps[currentIdx].skippedAt = new Date().toLocaleString('zh-CN',{hour12:false})
-  progress.lastActive = new Date().toLocaleString('zh-CN',{hour12:false})
-  pm._write(cwd, progress)
-
-  console.log(`⏭️ Step ${currentIdx + 1}/${steps.length} 已跳过：${steps[currentIdx].name}`)
-
-  // 输出下一步
-  const nextPendingIdx = steps.findIndex(s => s.status === 'pending')
-  if (nextPendingIdx !== -1 && defSteps) {
-    console.log('')
-    outputStep(stageName, nextPendingIdx, defSteps, cwd)
-  }
-}
-
-function showStatus(progress, stageName) {
-  const stageData = progress.stages[stageName]
-  const stageDef = stageRegistry[stageName]
-
-  if (!stageData || !stageData.steps || stageData.steps.length === 0) {
-    console.log(`阶段：${stageName}（${stageDef.title}）`)
-    console.log(`进度：未初始化`)
-    return
-  }
-
-  const steps = stageData.steps
-  const completed = steps.filter(s => s.status === 'completed' || s.status === 'skipped').length
-  const bar = '█'.repeat(completed) + '░'.repeat(steps.length - completed)
-
-  console.log(`阶段：${stageName}（${stageDef.title}）`)
-  console.log(`进度：[${bar}] ${completed}/${steps.length}\n`)
-
-  const firstPending = steps.findIndex(s => s.status === 'pending')
-
-  // 批量进度
-  if (progress.batchProgress) {
-    const bp = progress.batchProgress
-    const total = bp.total || 0
-    const completed = bp.completed || 0
-    const failed = bp.failed || 0
-    const skipped = bp.skipped || 0
-    const barLen = 20
-    const filled = Math.round((completed / Math.max(total, 1)) * barLen)
-    const bar = '█'.repeat(filled) + '░'.repeat(barLen - filled)
-    const parts = []
-    if (failed > 0) parts.push(`${failed} 失败`)
-    if (skipped > 0) parts.push(`${skipped} 跳过`)
-    const suffix = parts.length ? ` (${parts.join(', ')})` : ''
-    console.log(`\n📊 批量进度: ${bar} ${completed}/${total}${suffix}\n`)
-  }
-
-  steps.forEach((step, i) => {
-    const icon = step.status === 'completed' ? '✅' : step.status === 'skipped' ? '⏭️' : '⬜'
-    const isCurrent = step.status === 'pending' && i === firstPending
-    console.log(`${icon} Step ${i + 1}: ${step.name}${isCurrent ? ' ← 当前' : ''}`)
-  })
-}
-
-async function resetStage(pm, progress, stageName, cwd) {
-  const defSteps = await getStageSteps(stageName, cwd, progress)
-  progress.stages[stageName] = {
-    status: 'in-progress',
-    startedAt: new Date().toLocaleString('zh-CN',{hour12:false}),
-    completedAt: null,
-    steps: defSteps ? defSteps.map(s => ({ name: s.name, status: 'pending' })) : []
-  }
-  progress.lastActive = new Date().toLocaleString('zh-CN',{hour12:false})
-  pm._write(cwd, progress)
-  console.log(`🔄 ${stageName} 阶段已重置`)
-}
-
-/**
- * auto 模式：自动推进 brainstorm → plan → execute → verify
- */
-async function runAutoMode(pm, progress, cwd, flags) {
-  const flowStages = ['brainstorm', 'plan', 'execute', 'verify']
-  const isDone = flags.includes('--done')
-  let outputText = null
-  const outputIdx = flags.indexOf('--output')
-  if (outputIdx !== -1 && flags[outputIdx + 1]) outputText = flags[outputIdx + 1]
-  let inputText = null
-  const inputIdx = flags.indexOf('--input')
-  if (inputIdx !== -1 && flags[inputIdx + 1]) inputText = flags[inputIdx + 1]
-
-  if (!isDone) {
-    // 首次启动：显示当前状态和下一步
-    const currentStage = progress.currentStage || flowStages[0]
-    const stageIdx = flowStages.indexOf(currentStage)
-    if (stageIdx === -1) {
-      console.error(`❌ 当前阶段 ${currentStage} 不在 auto 流程中`)
-      console.error(`auto 流程: ${flowStages.join(' → ')}`)
-      process.exit(1)
-    }
-    // 显示进度概览
-    console.log('════════════════════════════════════════')
-    console.log('  🤖 SillySpec Auto Mode')
-    console.log('════════════════════════════════════════')
-    console.log(`  流程: ${flowStages.join(' → ')}`)
-    console.log(`  当前: ${currentStage}`)
-    for (let i = 0; i < flowStages.length; i++) {
-      const s = flowStages[i]
-      const stageData = progress.stages[s]
-      const done = stageData?.status === 'completed'
-      const active = s === currentStage
-      const total = stageData?.steps?.length || '?'
-      const completed = stageData?.steps?.filter(st => st.status === 'completed').length || 0
-      const icon = done ? '✅' : active ? '🔵' : '⬜'
-      console.log(`  ${icon} ${s} (${completed}/${total})`)
-    }
-    console.log('')
-    // 输出当前步骤 prompt
-    const steps = await getStageSteps(currentStage, cwd, progress)
-    if (!steps) {
-      console.error(`❌ 无法获取 ${currentStage} 步骤`)
-      process.exit(1)
-    }
-    const pendingIdx = steps.findIndex(s => s.status === 'pending')
-    if (pendingIdx === -1) {
-      // 阶段已完成，提示进入下一阶段
-      const next = getNextStage(currentStage)
-      if (next) {
-        console.log(`✅ ${currentStage} 已完成，下一步：sillyspec run auto --done --output "${currentStage} 完成"`)
-      } else {
-        console.log('🎉 全部流程已完成！')
-      }
-      return
-    }
-    outputStepPrompt(steps, pendingIdx, currentStage, cwd, progress)
-    return
-  }
-
-  // --done：完成当前步骤，如果阶段完成则自动推进
-  if (!outputText) {
-    console.error('❌ auto --done 需要 --output 参数')
-    process.exit(1)
-  }
-
-  const currentStage = progress.currentStage
-  const stageIdx = flowStages.indexOf(currentStage)
-  if (stageIdx === -1) {
-    console.error(`❌ 当前阶段 ${currentStage} 不在 auto 流程中`)
-    process.exit(1)
-  }
-
-  // 完成当前步骤
-  const completed = await completeStep(pm, progress, currentStage, cwd, outputText, inputText)
-  if (!completed) return
-
-  // 检查阶段是否完成
-  const nextPendingIdx = progress.stages[currentStage]?.steps?.findIndex(s => s.status === 'pending')
-  if (nextPendingIdx === -1) {
-    // 阶段已完成
-    const next = getNextStage(currentStage)
-    if (next) {
-      console.log(`\n✅ ${currentStage} 阶段完成，自动进入 ${next}`)
-      // 输出下一阶段第一步 prompt
-      const nextSteps = await getStageSteps(next, cwd, progress)
-      if (nextSteps) {
-        const firstPending = nextSteps.findIndex(s => s.status === 'pending')
-        if (firstPending !== -1) {
-          outputStepPrompt(nextSteps, firstPending, next, cwd, progress)
-        }
-      }
-    } else {
-      console.log('\n🎉 全部流程已完成！建议运行 /sillyspec:commit 提交改动')
-    }
-  } else {
-    // 阶段内下一步
-    const steps = await getStageSteps(currentStage, cwd, progress)
-    if (steps) {
-      const firstPending = steps.findIndex(s => s.status === 'pending')
-      if (firstPending !== -1) {
-        outputStepPrompt(steps, firstPending, currentStage, cwd, progress)
-      }
-    }
-  }
-}

package/src/stages/archive.js

@@ -1,54 +0,0 @@
-export const definition = {
-  name: 'archive',
-  title: '归档变更',
-  description: '规范沉淀，可追溯',
-  auxiliary: true,
-  steps: [
-    {
-      name: '任务完成度检查',
-      prompt: `检查 tasks.md 中所有 checkbox 是否已勾选。
-
-### 操作
-1. 读取 \`.sillyspec/changes/<change-name>/tasks.md\`
-2. 检查所有 checkbox 是否已勾选
-3. 如有遗漏 → 询问用户是否继续归档
-
-### 输出
-完成度报告`,
-      outputHint: '完成度报告',
-      optional: false
-    },
-    {
-      name: '确认归档',
-      prompt: `展示即将归档的内容，请用户确认。
-
-### 操作
-1. 展示：变更目录名、包含的文件列表、生成总结
-2. 请用户确认是否执行归档
-3. 确认后：将 \`.sillyspec/changes/<change-name>/\` 移动到 \`.sillyspec/changes/archive/YYYY-MM-DD-<change-name>/\`
-4. 确保所有 checkbox 都已勾选
-
-### 输出
-归档确认`,
-      outputHint: '归档确认',
-      optional: false
-    },
-    {
-      name: '更新路线图和提交',
-      prompt: `更新路线图并暂存变更。
-
-### 操作
-1. 如果 \`.sillyspec/ROADMAP.md\` 存在，标记对应 Phase 为已完成
-2. \`git add .sillyspec/\` — **不要 commit**，由用户通过统一提交工具处理
-3. 更新 progress.json：
-   - 清除当前变更信息（归档后不再活跃）
-   - 如果是主变更（有 MASTER.md），标记所有阶段为 ✅，然后清除
-   - 历史记录追加时间 + 归档完成
-
-### 输出
-归档完成确认 + 累积规范统计`,
-      outputHint: '归档完成',
-      optional: false
-    }
-  ]
-}