sillyspec 3.17.12 → 3.17.14

package/package.json

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

package/src/run.js

@@ -1073,9 +1073,7 @@ export async function runCommand(args, cwd, specDir = null) {
   }
 
   const isAuxiliary = auxiliaryStages.includes(stageName)
-  // scan 元数据追踪（供 postcheck 使用）
-  let _scanProjectListParsed = undefined // undefined=未到达step2, true=解析成功, false=解析失败
-  let _scanManifestWritten = undefined // undefined=未尝试, true=成功, false=失败
+  // scan 元数据追踪（存储在 stageData.scanMeta 中，completeStep 通过 progress 访问）
 
   const pm = new ProgressManager({ specDir: specRoot })
   let progress = await pm.read(cwd, changeName)
@@ -1725,37 +1723,42 @@ async function completeStep(pm, progress, stageName, cwd, outputText, inputText
   if (stageName === 'scan' && steps[currentIdx]?.name === '构建扫描项目列表') {
     // 解析项目列表：从 step 2 输出提取，或回退读取 projects/*.yaml
     let projectNames = []
+    // 项目名清洗：只保留 ASCII 字母/数字/横线/下划线/点，过滤中文和特殊字符
+    const sanitizeProjectName = (name) => {
+      const clean = name.replace(/[^a-zA-Z0-9_\-.]/g, '').trim()
+      return clean || null
+    }
     if (outputText) {
       // 匹配方式 1: "1. project-name" 编号列表
       const numbered = outputText.match(/^\s*\d+\.\s+(\S+)/gm)
       if (numbered) {
-        projectNames = numbered.map(m => m.replace(/^\s*\d+\.\s+/, '').replace(/[—\-:].*$/, '').trim())
-        if (projectNames.length > 0) { _scanProjectListParsed = true; stageData.scanMeta = stageData.scanMeta || {}; stageData.scanMeta.projectListParsed = true; }
+        const raw = numbered.map(m => m.replace(/^\s*\d+\.\s+/, '').replace(/[—\-:].*$/, '').trim())
+        projectNames = raw.map(sanitizeProjectName).filter(Boolean)
+        if (projectNames.length > 0) { stageData.scanMeta = stageData.scanMeta || {}; stageData.scanMeta.projectListParsed = true; }
       }
       // 匹配方式 2: 括号枚举 "子项目frontend/order-service/user-service" 或 "项目: a, b, c"
       if (projectNames.length === 0) {
         const parenMatch = outputText.match(/(?:子项目|项目)[\s:：]*(\S+(?:[\/、,，]+\S+)*)/)
         if (parenMatch) {
-          projectNames = parenMatch[1]
-            .split(/[\/、,，]+/)
-            .map(s => s.trim())
-            .filter(Boolean)
-          if (projectNames.length > 0) { _scanProjectListParsed = true; stageData.scanMeta = stageData.scanMeta || {}; stageData.scanMeta.projectListParsed = true; }
+          const raw = parenMatch[1].split(/[\/、,，]+/).map(s => s.trim()).filter(Boolean)
+          projectNames = raw.map(sanitizeProjectName).filter(Boolean)
+          if (projectNames.length > 0) { stageData.scanMeta = stageData.scanMeta || {}; stageData.scanMeta.projectListParsed = true; }
         }
       }
       // 匹配方式 3: 结构化 YAML block "scan_projects:\n  - id: name"
       if (projectNames.length === 0) {
         const yamlMatch = outputText.match(/scan_projects:\s*\n((?:\s+-\s+id:\s+\S+\s*\n?)+)/)
         if (yamlMatch) {
-          projectNames = [...yamlMatch[1].matchAll(/-\s+id:\s*(\S+)/g)].map(m => m[1])
-          if (projectNames.length > 0) { _scanProjectListParsed = true; stageData.scanMeta = stageData.scanMeta || {}; stageData.scanMeta.projectListParsed = true; }
+          const raw = [...yamlMatch[1].matchAll(/-\s+id:\s*(\S+)/g)].map(m => m[1])
+          projectNames = raw.map(sanitizeProjectName).filter(Boolean)
+          if (projectNames.length > 0) { stageData.scanMeta = stageData.scanMeta || {}; stageData.scanMeta.projectListParsed = true; }
         }
       }
     }
     if (projectNames.length === 0) {
       // 回退：读取所有已注册项目
       console.warn('⚠️ 未能从 step 2 输出解析项目列表，回退扫描所有注册项目')
-      _scanProjectListParsed = false; stageData.scanMeta = stageData.scanMeta || {}; stageData.scanMeta.projectListParsed = false;
+      stageData.scanMeta = stageData.scanMeta || {}; stageData.scanMeta.projectListParsed = false;
       const projectsDir = join(specBase, 'projects')
       if (existsSync(projectsDir)) {
         projectNames = readdirSync(projectsDir)
@@ -1859,6 +1862,18 @@ async function completeStep(pm, progress, stageName, cwd, outputText, inputText
       if (steps[wsIdx].waitReason) console.log(`   原因：${steps[wsIdx].waitReason}`)
       return { stageCompleted: false, currentIdx, nextPendingIdx: -1 }
     }
+    // quick 阶段完成前强制检查 quicklog 是否创建
+    if (stageName === 'quick') {
+      const quicklogDir = join(specBase, '.sillyspec', 'quicklog')
+      const hasQuicklog = existsSync(quicklogDir) && readdirSync(quicklogDir).some(f => f.endsWith('.md') && f.startsWith('QUICKLOG'))
+      if (!hasQuicklog) {
+        console.error(`\n❌ quick 阶段完成校验失败：未检测到 QUICKLOG 记录文件。`)
+        console.error(`   step 2 要求创建 quicklog 记录，但文件不存在。`) 
+        console.error(`   请先创建 quicklog 记录再 --done，或使用 --skip-approval 跳过此校验。`)
+        return { stageCompleted: false, currentIdx, nextPendingIdx: -1 }
+      }
+    }
+
     stageData.status = 'completed'
     stageData.completedAt = new Date().toLocaleString('zh-CN',{hour12:false})
     progress.lastActive = new Date().toLocaleString('zh-CN',{hour12:false})
@@ -1875,7 +1890,7 @@ async function completeStep(pm, progress, stageName, cwd, outputText, inputText
     // 平台模式：scan 完成后生成 manifest.json + post-check
     if (stageName === 'scan' && (platformOpts.specRoot || platformOpts.runtimeRoot)) {
       try {
-        _scanManifestWritten = false; stageData.scanMeta = stageData.scanMeta || {}; stageData.scanMeta.manifestWritten = false; // 默认失败
+        stageData.scanMeta = stageData.scanMeta || {}; stageData.scanMeta.manifestWritten = false; // 默认失败
         const { mkdirSync, writeFileSync } = await import('fs')
         const { join } = await import('path')
         const { execSync } = await import('child_process')
@@ -1896,7 +1911,7 @@ async function completeStep(pm, progress, stageName, cwd, outputText, inputText
         const manifestPath = join(manifestDir, 'manifest.json')
         writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + '\n')
         console.log(`📄 manifest.json 已写入: ${manifestPath}`)
-        _scanManifestWritten = true; stageData.scanMeta = stageData.scanMeta || {}; stageData.scanMeta.manifestWritten = true;
+        stageData.scanMeta = stageData.scanMeta || {}; stageData.scanMeta.manifestWritten = true;
         if (!sourceCommit) {
           console.log(`⚠️  source_commit 无法获取（可能非 git 目录），已设为 null`)
         }

package/src/stages/scan.js

@@ -462,6 +462,11 @@ step1 → step2 → step3
 9. 检查 7 份文档 header 是否包含 author 和 created_at
 10. 检查 local.yaml 中 commands 是否在 package.json scripts 中真实存在，不存在的必须标记 unavailable
 
+### ⛔ API 错误处理
+- 遇到 API Error 529（服务过载）或 rate_limit 时，**停止当前操作并报告**，不要自动重试
+- 遇到 tool_use_error 时，记录错误信息并跳过该文件/操作，继续处理下一项
+- 如果连续 3 次操作失败，输出失败摘要并停止
+
 ### ⛔ 最终状态判定
 如果出现以下**任意**情况，最终状态**不能**写"全部通过"，只能写 \`completed_with_warnings\` 或 \`failed_post_check\`：
 - 源码目录下存在 docs（路径合规检查失败）