sillyspec 3.22.7 → 3.22.9

package/package.json

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

package/src/run.js

@@ -6,6 +6,7 @@
  */
 import { basename, join, resolve, dirname, relative, isAbsolute } from 'path'
 import { existsSync, readdirSync, mkdirSync, writeFileSync, appendFileSync, readFileSync, rmSync, statSync } from 'fs'
+import { randomBytes } from 'crypto'
 import { createRequire } from 'module'
 const require = createRequire(import.meta.url)
 import { ProgressManager } from './progress.js'
@@ -776,6 +777,16 @@ async function outputStep(stageName, stepIndex, steps, cwd, changeName, dbProjec
       platformDirectives.push(`workspace_id: ${platformOpts.workspaceId}`)
     }
     promptText = platformDirectives.join('\n') + '\n\n' + promptText
+  } else {
+    // 常规模式（无平台 specRoot）：占位符替换为 cwd/.sillyspec 下对应路径
+    // 让用 {SPEC_ROOT}/{DOCS_ROOT} 等占位符的 prompt（如 quick/scan）在常规模式也写到正确位置
+    const projectName = dbProjectName || basename(cwd)
+    const specSillyspec = join(cwd, '.sillyspec')
+    promptText = promptText.replace(/\{SPEC_ROOT\}/g, specSillyspec)
+    promptText = promptText.replace(/\{DOCS_ROOT\}/g, join(specSillyspec, 'docs', projectName))
+    promptText = promptText.replace(/\{PROJECTS_ROOT\}/g, join(specSillyspec, 'projects'))
+    promptText = promptText.replace(/\{WORKFLOWS_ROOT\}/g, join(specSillyspec, 'workflows'))
+    promptText = promptText.replace(/\{KNOWLEDGE_ROOT\}/g, join(specSillyspec, 'knowledge'))
   }
 
   // 注入 scanProfile 硬约束指令
@@ -1466,7 +1477,7 @@ export async function runCommand(args, cwd, specDir = null) {
           process.exit(1)
         }
         const date = new Date().toISOString().slice(0, 10)
-        const autoName = `${date}-new-change`
+        const autoName = `${date}-new-change-${randomBytes(4).toString('hex')}`
         console.log(`🔄 自动创建变更：${autoName}`)
         console.log(`  提示：可以用 --change <名称> 指定自定义变更名`)
         console.log(`  或事后重命名：sillyspec change-rename ${autoName} <新名称>`)
@@ -1571,6 +1582,25 @@ export async function runCommand(args, cwd, specDir = null) {
     }
   }
 
+  // quick 启动（非 --done）：reset steps + 生成 quickRunId，避免多会话共享 progress.default.quick
+  // 继承并行会话的 step1（会话 B 复用会话 A 的 ql，本会话改动无 ql 记录）。C-实用方案：
+  // 每次 quick 启动 reset steps（逻辑隔离，本会话从 step1 重跑建独立 ql）+ 写 current-quick-run-id。
+  if (stageName === 'quick' && !isDone && !isStatus && !isSkip && !isReset && !isReopen) {
+    const qStage = progress.stages?.quick
+    if (qStage?.steps?.length) {
+      qStage.steps = qStage.steps.map(s => ({ ...s, status: 'pending', completedAt: null }))
+      qStage.status = 'in-progress'
+    }
+    try {
+      const now = new Date()
+      const pad = (n) => String(n).padStart(2, '0')
+      const quickRunId = `quick-${now.getFullYear()}-${pad(now.getMonth()+1)}-${pad(now.getDate())}-${pad(now.getHours())}${pad(now.getMinutes())}${pad(now.getSeconds())}`
+      const runtimeRoot = platformOpts.runtimeRoot || join(specRoot, '.runtime')
+      mkdirSync(runtimeRoot, { recursive: true })
+      writeFileSync(join(runtimeRoot, 'current-quick-run-id'), quickRunId)
+    } catch {}
+  }
+
   // 确保步骤已初始化
   const changed = await ensureStageSteps(progress, stageName, cwd, specRoot)
   if (changed && effectiveChange) {
@@ -2336,6 +2366,48 @@ async function continueStep(pm, progress, stageName, cwd, answer, options = {})
         console.warn(`🔗 Worktree: check failed — ${e.message}`);
       }
     }
+    // 阶段完成后明确下一步（agent 常卡：stageData completed 但不知要 run <下一阶段> 推进 currentStage）
+    const nextStageHint = { brainstorm: 'plan', plan: 'execute', execute: 'verify', verify: 'archive' }[stageName]
+    if (nextStageHint) {
+      console.log(`\n👉 ${stageName} 已完成。下一步：sillyspec run ${nextStageHint}${changeName ? ` --change ${changeName}` : ''}`)
+      if (stageName === 'execute') {
+        console.log(`   ⚠️ 若 worktree 改动还没 apply 到主工作区，先：sillyspec worktree apply ${changeName}`)
+        console.log(`   （apply 不需要先 commit，支持 working tree 未提交改动）`)
+        // plan.md checkbox auto-check：execute 完成 + review.json pass → 自动勾选（治本，比警告可靠）
+        try {
+          const specBaseLc = platformOpts.specRoot || join(cwd, '.sillyspec')
+          const changeDir = join(specBaseLc, 'changes', changeName)
+          const planPath = join(changeDir, 'plan.md')
+          const runtimeRoot = platformOpts.runtimeRoot || join(specBaseLc, '.runtime')
+          const runIdFile = join(runtimeRoot, `current-execute-run-id-${changeName}`)
+          if (existsSync(planPath) && existsSync(runIdFile)) {
+            const executeRunId = readFileSync(runIdFile, 'utf8').trim()
+            const planContent = readFileSync(planPath, 'utf8')
+            const { readReview } = await import('./task-review.js')
+            let checkedCount = 0
+            let skippedCount = 0
+            const updated = planContent.replace(/^(\s*[-*]\s*\[)\s(\]\s*task-\d+)/gim, (match, p1, p2) => {
+              const taskNum = match.match(/task-(\d+)/)[1].padStart(2, '0')
+              const reviewPath = join(runtimeRoot, 'execute-runs', executeRunId, 'tasks', `task-${taskNum}`, 'review.json')
+              const r = readReview(reviewPath)
+              if (r.ok && r.review?.specVerdict !== 'fail' && r.review?.qualityVerdict !== 'fail') {
+                checkedCount++
+                return `${p1}x${p2}`   // 勾选
+              }
+              skippedCount++
+              return match              // 不勾
+            })
+            if (checkedCount > 0) {
+              writeFileSync(planPath, updated)
+              console.log(`   ✅ 自动勾选 ${checkedCount} 个 task checkbox（基于 review.json pass）`)
+            }
+            if (skippedCount > 0) {
+              console.warn(`   ⚠️ ${skippedCount} 个 task 未勾（review.json 缺失/fail）→ archive 会拦。补 review 后重跑 execute --done 触发自动勾`)
+            }
+          }
+        } catch {}
+      }
+    }
     return { stageCompleted: true, currentIdx, nextPendingIdx: -1 }
   }
 

package/src/stages/brainstorm-auto.js

@@ -22,7 +22,7 @@ export const definition = {
 ### 操作
 1. 运行 \`sillyspec progress show\`，确认 currentStage 为 "brainstorm"
 2. 如果未初始化，提示先运行 sillyspec init
-3. **检查变更名称**：如果当前变更名是自动生成的（如 \`2026-06-02-new-change\`），直接重命名为有意义名称，然后运行 \`sillyspec change-rename <旧名> <新名>\`
+3. **检查变更名称**：如果当前变更名是自动生成的（如 \`2026-06-02-new-change-a3f2b7c1\`），直接重命名为有意义名称，然后运行 \`sillyspec change-rename <旧名> <新名>\`
 
 ### 加载上下文
 4. 读取 CODEBASE-OVERVIEW.md + 共享规范 + 子项目上下文

package/src/stages/brainstorm.js

@@ -12,7 +12,7 @@ export const definition = {
 2. 确认 currentStage 为 "brainstorm"
 3. 如果有进行中的 brainstorm，提示选择继续或重新开始
 4. 如果未初始化，提示先运行 sillyspec init
-5. **检查变更名称是否有意义**：如果当前变更名是自动生成的（如 \`2026-06-02-new-change\`），询问用户确认实际变更名，然后运行 \`sillyspec change-rename <旧名> <新名>\` 重命名
+5. **检查变更名称是否有意义**：如果当前变更名是自动生成的（如 \`2026-06-02-new-change-a3f2b7c1\`），询问用户确认实际变更名，然后运行 \`sillyspec change-rename <旧名> <新名>\` 重命名
 
 ### 输出
 当前状态摘要（1-2 句话）

package/src/stages/quick.js

@@ -11,23 +11,23 @@ export const definition = {
 ### 操作
 1. 检查关联变更（\`<linked-changes>\`，逗号分隔的变更名列表；显示「（无）」= 不关联变更），确定记录方式
 2. 理解任务：模糊则问一个问题确认
-3. 加载项目信息：\`cat .sillyspec/projects/*.yaml 2>/dev/null\`（了解项目结构和技术栈）
-4. 加载上下文：\`cat .sillyspec/docs/<project>/scan/CONVENTIONS.md 2>/dev/null\`
-5. 加载本地配置：\`cat .sillyspec/local.yaml 2>/dev/null\`（构建命令、测试命令、环境变量等）
-6. 若有关联变更，加载每个变更的设计文档：\`cat .sillyspec/changes/<c>/design.md 2>/dev/null\`（理解设计意图）
-7. 如有需要，查询知识库：\`cat .sillyspec/knowledge/INDEX.md 2>/dev/null\`
+3. 加载项目信息：\`cat {SPEC_ROOT}/projects/*.yaml 2>/dev/null\`（了解项目结构和技术栈）
+4. 加载上下文：\`cat {SPEC_ROOT}/docs/<project>/scan/CONVENTIONS.md 2>/dev/null\`
+5. 加载本地配置：\`cat {SPEC_ROOT}/local.yaml 2>/dev/null\`（构建命令、测试命令、环境变量等）
+6. 若有关联变更，加载每个变更的设计文档：\`cat {SPEC_ROOT}/changes/<c>/design.md 2>/dev/null\`（理解设计意图）
+7. 如有需要，查询知识库：\`cat {SPEC_ROOT}/knowledge/INDEX.md 2>/dev/null\`
 
 ### 模块文档加载
-8. 读取 \`.sillyspec/docs/<project>/modules/_module-map.yaml\`（不存在则跳过以下步骤）
+8. 读取 \`{SPEC_ROOT}/docs/<project>/modules/_module-map.yaml\`（不存在则跳过以下步骤）
 9. 根据任务描述初步判断可能涉及的模块
-10. 读取匹配到的 \`.sillyspec/docs/<project>/modules/<module>.md\`
+10. 读取匹配到的 \`{SPEC_ROOT}/docs/<project>/modules/<module>.md\`
 
 ### 创建任务记录（⛔ 此步骤不能跳过，没有 quicklog 记录 = 未完成）
 理解完任务后，**必须**立即创建记录文件，再输出任何其他内容：
 
 **A. 始终创建 QUICKLOG（无论是否关联变更）**
 1. 使用预注入的 git 用户名：\`<git-user>\`
-2. 创建/追加 \`.sillyspec/quicklog/QUICKLOG-\`<git-user>\`.md\`，写入：
+2. 创建/追加 \`{SPEC_ROOT}/quicklog/QUICKLOG-\`<git-user>\`.md\`，写入：
    \`\`\`
    ## ql-<YYYYMMDD>-<NNN>-<XXXX> | <now-datetime> | <一句话任务描述>
    状态：进行中
@@ -42,13 +42,13 @@ export const definition = {
 
 **B. 若关联变更（\`<linked-changes>\` 不为「（无）」）**
 3. 解析 \`<linked-changes>\`（逗号分隔的变更名列表，可能有多个 = 一次 quick 同时归属多个变更）
-4. 对**每个**变更 \`<c>\`：在 \`.sillyspec/changes/<c>/tasks.md\` 追加一条未勾选 task：
+4. 对**每个**变更 \`<c>\`：在 \`{SPEC_ROOT}/changes/<c>/tasks.md\` 追加一条未勾选 task：
    \`- [ ] <ql-ID> <一句话任务描述>\`（复用步骤 A 生成的同一个 ql-ID）
-   - 若 \`changes/<c>/\` 目录或 tasks.md 不存在，先 \`mkdir -p .sillyspec/changes/<c>\` 再创建 tasks.md
+   - 若 \`changes/<c>/\` 目录或 tasks.md 不存在，先 \`mkdir -p {SPEC_ROOT}/changes/<c>\` 再创建 tasks.md
    - 同一个 ql-ID 出现在 QUICKLOG 和所有关联变更的 tasks.md 中，便于交叉引用
    - \`<linked-changes>\` 为「（无）」时跳过本步，仅保留 QUICKLOG
 
-这样 Gate 检测到 \`.sillyspec/\` 下有变更，就不会拦截后续的代码修改。
+这样 Gate 检测到 \`{SPEC_ROOT}/\` 下有变更，就不会拦截后续的代码修改。
 
 ### 输出
 quicklog 已创建（必须放在输出的第一行确认）+ 任务理解 + 上下文摘要
@@ -90,14 +90,14 @@ quicklog 已创建（必须放在输出的第一行确认）+ 任务理解 + 上
    - QUICKLOG：找到对应 ql-ID 的条目，将「状态：进行中」改为「状态：已完成」，补充实际改动文件和结果摘要（**始终做**，无论是否关联变更）
    - 关联变更：对 Step 1 在每个 \`changes/<c>/tasks.md\` 写入的 ql-ID task，将其 checkbox 由 \`- [ ]\` 勾选为 \`- [x]\`；若 Step 1 未写入（用户事后才决定关联），则按 Step 1 的格式补写并直接勾选
 4. QUICKLOG 轮转：超过 500 行则重命名为 \`QUICKLOG-<USER>-YYYY-MM-DD.md\`（日期取最后一条记录的日期）。新文件从空开始，ql-ID 需扫描同目录所有 QUICKLOG 文件中当天最大序号 +1
-5. 如果发现项目特有的坑，追加到 \`.sillyspec/knowledge/uncategorized.md\`
+5. 如果发现项目特有的坑，追加到 \`{SPEC_ROOT}/knowledge/uncategorized.md\`
 6. 任务比预期复杂 → 建议用完整流程
 
 ### 模块文档同步
-7. 读取 \`.sillyspec/docs/<project>/modules/_module-map.yaml\`（不存在则跳过以下步骤）
+7. 读取 \`{SPEC_ROOT}/docs/<project>/modules/_module-map.yaml\`（不存在则跳过以下步骤）
 8. 对比本次修改的文件（\`git diff --name-only HEAD\`）与模块映射
 9. 如果命中模块 → 直接同步模块文档：
-   - 读取对应的 \`.sillyspec/docs/<project>/modules/<module>.md\`（如不存在则新建）
+   - 读取对应的 \`{SPEC_ROOT}/docs/<project>/modules/<module>.md\`（如不存在则新建）
    - 根据本次改动内容更新模块文档（正文描述当前状态，底部变更索引追加本次 ql-ID）
    - 变更索引格式：\`- ql-YYYYMMDD-NNN-XXXX | <一句话描述>\`
    - 写入模块文档