sillyspec 3.17.1 → 3.17.3

package/package.json

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

package/src/init.js

@@ -1,4 +1,4 @@
-import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, statSync } from 'fs';
+import { existsSync, mkdirSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync } from 'fs';
 import { join, resolve, dirname, basename } from 'path';
 import { fileURLToPath } from 'url';
 import { checkbox, confirm, input } from '@inquirer/prompts';
@@ -108,6 +108,14 @@ async function doInstall(projectDir, tools, subprojects = [], specDir = null) {
   // projectDir: 源码项目根目录（用于工具检测、指令注入、.gitignore）
   const spec = specDir || join(projectDir, '.sillyspec');
 
+  // 外部 specDir 时清理旧版本残留的 cwd/.sillyspec/（防止源码污染）
+  const legacyDir = join(projectDir, '.sillyspec');
+  if (specDir && existsSync(legacyDir)) {
+    try { rmSync(legacyDir, { recursive: true, force: true }) } catch {}
+    if (!existsSync(legacyDir)) console.log('🧹 已清理旧版本残留的源码 .sillyspec/ 目录');
+    else console.error('⚠️ 清理残留 .sillyspec/ 失败');
+  }
+
   // 创建基础目录
   // spec/projects/    → 项目注册表
   // spec/docs/<name>/ → 统一文档中心

package/src/run.js

@@ -5,7 +5,7 @@
  * 支持多变更并行：每个变更状态存储在 sillyspec.db 中。
  */
 import { basename, join, resolve } from 'path'
-import { existsSync, readdirSync, mkdirSync, writeFileSync, appendFileSync, readFileSync, statSync } from 'fs'
+import { existsSync, readdirSync, mkdirSync, writeFileSync, appendFileSync, readFileSync, rmSync, statSync } from 'fs'
 import { ProgressManager } from './progress.js'
 
 /**
@@ -139,7 +139,9 @@ async function auditQuickCompletion(cwd, guard, options = {}) {
   return result
 }
 
-async function triggerSync(cwd, changeName) {
+async function triggerSync(cwd, changeName, platformOpts = {}) {
+  // 平台模式（SillyHub）走自己的回传链路，不走 CLI 内置 sync
+  if (platformOpts?.specRoot || platformOpts?.runtimeRoot) return
   try {
     if (changeName && !existsSync(join(cwd, '.sillyspec', 'changes', changeName))) return
     const syncMod = await import('./sync.js')
@@ -154,12 +156,13 @@ async function triggerSync(cwd, changeName) {
  * 审批检查辅助函数：execute 阶段启动前检查
  * @returns {{ status: string, reason?: string } | null}
  */
-async function checkApproval(cwd, changeName) {
+async function checkApproval(cwd, changeName, platformOpts = {}) {
+  // 平台模式不需要 CLI 内置审批检查
+  if (platformOpts?.specRoot || platformOpts?.runtimeRoot) return null
   try {
     const syncMod = await import('./sync.js')
     return await syncMod.checkApproval(changeName, cwd)
   } catch (e) {
-    // sync.js 不存在或检查失败，静默跳过
     return null
   }
 }
@@ -474,20 +477,13 @@ export async function runCommand(args, cwd, specDir = null) {
   // 跨 --done 生命周期：从 metadata 文件恢复 platformOpts
   // 首次 scan 时写入，所有后续调用（包括 run、--done、--skip）都读取
   // 优先在 specDir 下查找，否则回退到 cwd/.sillyspec/.runtime/
-  const specRoot = platformOpts.specRoot || resolveSpecDir(cwd)
-  // platform-scan.json 搜索策略（多路径兼容）：
-  // 平台模式首次 scan 写入 specRoot/.runtime/，但后续 --done 可能不带 --spec-root
-  // 需要在多个候选位置搜索
-  const candidatePaths = []
-  if (platformOpts.specRoot) {
-    candidatePaths.push(join(platformOpts.specRoot, '.runtime', 'platform-scan.json'))
-  }
-  if (resolvedSpecDir) {
-    candidatePaths.push(join(resolve(resolvedSpecDir), '.runtime', 'platform-scan.json'))
-  }
-  candidatePaths.push(join(specRoot, '.runtime', 'platform-scan.json')) // cwd/.sillyspec/.runtime/
-
-  let platformOptsFile = candidatePaths.find(p => existsSync(p)) || candidatePaths[0]
+  let specRoot = platformOpts.specRoot || resolveSpecDir(cwd)
+  // 平台参数恢复策略：
+  // 1. 优先检查 cwd/.sillyspec-platform.json（轻量指针文件，不污染 .sillyspec 结构）
+  // 2. 然后检查 specRoot/.runtime/platform-scan.json（首次 scan 写入）
+  const platformPointer = join(cwd, '.sillyspec-platform.json')
+  const platformScanFile = join(specRoot, '.runtime', 'platform-scan.json')
+  let platformOptsFile = existsSync(platformPointer) ? platformPointer : platformScanFile
   let platformFileExists = existsSync(platformOptsFile)
   // 如果命令行没传 spec-root，尝试从持久化文件恢复
   if (!platformOpts.specRoot && !platformOpts.runtimeRoot) {
@@ -506,6 +502,8 @@ export async function runCommand(args, cwd, specDir = null) {
           console.error('   解决：重新运行首次 scan 并传入 --spec-root')
           process.exit(1)
         }
+        // 恢复成功：更新 specRoot（初始值可能是 cwd/.sillyspec，恢复后应为真实 specDir）
+        specRoot = platformOpts.specRoot || specRoot
       } catch (e) {
         console.error(`❌ 平台模式参数文件读取失败: ${platformOptsFile}`)
         console.error(`   错误: ${e.message}`)
@@ -528,10 +526,9 @@ export async function runCommand(args, cwd, specDir = null) {
         scanRunId: platformOpts.scanRunId,
         savedAt: new Date().toISOString(),
       }, null, 2) + '\n')
-      // 恢复指针：在 cwd/.sillyspec/.runtime/ 也写一份，供后续 --done（不带 --spec-root）找到
-      const cwdRuntimeDir = join(cwd, '.sillyspec', '.runtime')
-      mkdirSync(cwdRuntimeDir, { recursive: true })
-      writeFileSync(join(cwdRuntimeDir, 'platform-scan.json'), JSON.stringify({
+      // 恢复指针：在 cwd 下写 .sillyspec-platform.json（不在 .sillyspec 内，不污染源码结构）
+      // 供后续 --done（不带 --spec-root）找到 specDir
+      writeFileSync(join(cwd, '.sillyspec-platform.json'), JSON.stringify({
         specRoot: platformOpts.specRoot,
         runtimeRoot: platformOpts.runtimeRoot,
         workspaceId: platformOpts.workspaceId,
@@ -543,6 +540,18 @@ export async function runCommand(args, cwd, specDir = null) {
     }
   }
 
+  // 统一规范基路径：平台模式用 specRoot，本地模式用 cwd/.sillyspec
+  // runCommand 后续所有 .sillyspec/ 操作必须用 specBase
+  const specBase = platformOpts.specRoot || join(cwd, '.sillyspec')
+
+  // 平台模式：清理旧版本残留的 cwd/.sillyspec/（防止源码污染）
+  if (platformOpts.specRoot) {
+    const legacyDir = join(cwd, '.sillyspec')
+    if (existsSync(legacyDir)) {
+      try { rmSync(legacyDir, { recursive: true, force: true }) } catch {}
+    }
+  }
+
   // 解析 --output
   let outputText = null
   const outputIdx = flags.indexOf('--output')
@@ -654,7 +663,7 @@ export async function runCommand(args, cwd, specDir = null) {
   const changed = await ensureStageSteps(progress, stageName, cwd, specRoot)
   if (changed && effectiveChange) {
     await pm._write(cwd, progress, effectiveChange)
-    triggerSync(cwd, effectiveChange)
+    triggerSync(cwd, effectiveChange, platformOpts)
     progress = await pm.read(cwd, effectiveChange) || progress
   }
 
@@ -704,7 +713,7 @@ async function runStage(pm, progress, stageName, cwd, changeName, skipApproval =
 
   // execute 阶段启动前检查审批
   if (stageName === 'execute' && !skipApproval) {
-    const approval = await checkApproval(cwd, changeName)
+    const approval = await checkApproval(cwd, changeName, platformOpts)
     if (approval) {
       if (approval.status === 'rejected') {
         console.error(`❌ 变更 ${changeName} 的执行已被拒绝：${approval.reason || '无原因'}`)
@@ -721,7 +730,7 @@ async function runStage(pm, progress, stageName, cwd, changeName, skipApproval =
   if (autoDetectChange(progress, cwd)) {
     progress.lastActive = new Date().toLocaleString('zh-CN', { hour12: false })
     await pm._write(cwd, progress, changeName)
-    triggerSync(cwd, changeName)
+    triggerSync(cwd, changeName, platformOpts)
   }
 
   const stageData = progress.stages[stageName]
@@ -735,7 +744,7 @@ async function runStage(pm, progress, stageName, cwd, changeName, skipApproval =
     progress.currentStage = stageName
     progress.lastActive = new Date().toLocaleString('zh-CN',{hour12:false})
     await pm._write(cwd, progress, changeName)
-    triggerSync(cwd, changeName)
+    triggerSync(cwd, changeName, platformOpts)
   }
 
   const steps = stageData.steps
@@ -751,7 +760,7 @@ async function runStage(pm, progress, stageName, cwd, changeName, skipApproval =
     stageData.startedAt = new Date().toLocaleString('zh-CN', { hour12: false })
     stageData.completedAt = null
     await pm._write(cwd, progress, changeName)
-    triggerSync(cwd, changeName)
+    triggerSync(cwd, changeName, platformOpts)
     currentIdx = 0
     console.log(`🔄 ${stageName} 阶段已自动重置，重新开始。\n`)
   }
@@ -777,7 +786,7 @@ async function runStage(pm, progress, stageName, cwd, changeName, skipApproval =
         startedAt: new Date().toISOString(),
       }
       // 写入 quick-guard.json 供 worktree-guard hook 读取
-      const guardFile = join(cwd, '.sillyspec', '.runtime', 'quick-guard.json')
+      const guardFile = join(specBase, '.runtime', 'quick-guard.json')
       writeFileSync(guardFile, JSON.stringify(progress.quickGuard, null, 2))
       const parts = [`${baselineFiles.length} 个已有脏文件`]
       if (allowedFiles.length > 0) parts.push(`${allowedFiles.length} 个 allowedFiles`)
@@ -802,8 +811,8 @@ async function runStage(pm, progress, stageName, cwd, changeName, skipApproval =
   }
 }
 
-function validateMetadata(cwd, stageName) {
-  const changesDir = join(cwd, '.sillyspec', 'changes')
+function validateMetadata(cwd, stageName, specBase) {
+  const changesDir = join(specBase, 'changes')
   if (!existsSync(changesDir)) return
 
   const cutoff = Date.now() - 10 * 60 * 1000
@@ -837,11 +846,11 @@ function validateMetadata(cwd, stageName) {
  * 验证关键文件是否存在于正确的变更目录下
  * 防止 AI 将文件写到错误的路径
  */
-function validateFileLocations(cwd, stageName, progress, changeName) {
+function validateFileLocations(cwd, stageName, progress, changeName, specBase) {
   const effectiveChange = changeName || progress.currentChange
   if (!effectiveChange) return
 
-  const changeDir = join(cwd, '.sillyspec', 'changes', effectiveChange)
+  const changeDir = join(specBase, 'changes', effectiveChange)
   if (!existsSync(changeDir)) return
 
   // 每个阶段完成后预期存在的文件
@@ -867,7 +876,7 @@ function validateFileLocations(cwd, stageName, progress, changeName) {
     console.log(`  变更目录：${changeDir.replace(cwd + '/', '')}/`)
     for (const f of missing) {
       // 检查是否写到了错误的位置
-      const wrongPath = join(cwd, '.sillyspec', 'changes', 'change', effectiveChange, f)
+      const wrongPath = join(specBase, 'changes', 'change', effectiveChange, f)
       if (existsSync(wrongPath)) {
         console.log(`  ❌ ${f} — 不存在，但发现了错误路径：${wrongPath.replace(cwd + '/', '')}`)
         console.log(`     提示：应该写入 ${changeDir.replace(cwd + '/', '')}/${f}`)
@@ -887,7 +896,7 @@ async function archiveChangeDirectory(pm, cwd, progress) {
     console.error('❌ 归档失败：未找到当前变更名（currentChange）')
     process.exit(1)
   }
-  const changesDir = join(cwd, '.sillyspec', 'changes')
+  const changesDir = join(specBase, 'changes')
   const archiveDir = join(changesDir, 'archive')
   const srcDir = join(changesDir, archiveChangeName)
   const date = new Date().toISOString().slice(0, 10)
@@ -915,6 +924,7 @@ async function archiveChangeDirectory(pm, cwd, progress) {
 
 async function completeStep(pm, progress, stageName, cwd, outputText, inputText = null, options = {}) {
   const { printNext = true, confirm = false, changeName, platformOpts = {} } = options
+  const specBase = platformOpts.specRoot || join(cwd, '.sillyspec')
   const stageData = progress.stages[stageName]
   if (!stageData || !stageData.steps) {
     console.error(`❌ 阶段 ${stageName} 未初始化`)
@@ -938,7 +948,7 @@ async function completeStep(pm, progress, stageName, cwd, outputText, inputText
       // 平台模式：artifact 写入 runtime-root，否则写 .sillyspec/.runtime/artifacts
       const artifactBase = platformOpts?.runtimeRoot
         ? join(platformOpts.runtimeRoot, 'scan-runs', platformOpts.scanRunId || 'unknown')
-        : join(cwd, '.sillyspec', '.runtime', 'artifacts')
+        : join(specBase, '.runtime', 'artifacts')
       mkdirSync(artifactBase, { recursive: true })
       const ts = new Date().toISOString().slice(0,19).replace(/[-T:]/g, '')
       writeFileSync(join(artifactBase, `${changeName || 'unknown'}-${stageName}-step${currentIdx + 1}-${ts}.txt`), outputText)
@@ -1010,16 +1020,33 @@ async function completeStep(pm, progress, stageName, cwd, outputText, inputText
     // 解析项目列表：从 step 2 输出提取，或回退读取 projects/*.yaml
     let projectNames = []
     if (outputText) {
-      // 匹配 "1. project-name" 格式
-      const matches = outputText.match(/^\s*\d+\.\s+(\S+)/gm)
-      if (matches) {
-        projectNames = matches.map(m => m.replace(/^\s*\d+\.\s+/, '').replace(/[—\-:].*$/, '').trim())
+      // 匹配方式 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())
+      }
+      // 匹配方式 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)
+        }
+      }
+      // 匹配方式 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) {
       // 回退：读取所有已注册项目
       console.warn('⚠️ 未能从 step 2 输出解析项目列表，回退扫描所有注册项目')
-      const projectsDir = join(cwd, '.sillyspec', 'projects')
+      const projectsDir = join(specBase, 'projects')
       if (existsSync(projectsDir)) {
         projectNames = readdirSync(projectsDir)
           .filter(f => f.endsWith('.yaml'))
@@ -1031,8 +1058,8 @@ async function completeStep(pm, progress, stageName, cwd, outputText, inputText
     }
 
     // 保存到 runtime 供后续使用 + 防重复展开
-    const scanStatePath = join(cwd, '.sillyspec', '.runtime', 'scan-projects.json')
-    mkdirSync(join(cwd, '.sillyspec', '.runtime'), { recursive: true })
+    const scanStatePath = join(specBase, '.runtime', 'scan-projects.json')
+    mkdirSync(join(specBase, '.runtime'), { recursive: true })
     let scanState = { projects: projectNames, expanded: false }
     if (existsSync(scanStatePath)) {
       try { scanState = JSON.parse(readFileSync(scanStatePath, 'utf8')) } catch {}
@@ -1051,14 +1078,14 @@ async function completeStep(pm, progress, stageName, cwd, outputText, inputText
       let insertPos = insertBase
       for (const pName of projectNames) {
         // 读取项目配置获取 projectRoot
-        const projYaml = join(cwd, '.sillyspec', 'projects', `${pName}.yaml`)
+        const projYaml = join(specBase, 'projects', `${pName}.yaml`)
         let projectRoot = '.'
         if (existsSync(projYaml)) {
           const yamlContent = readFileSync(projYaml, 'utf8')
           const pathMatch = yamlContent.match(/^path:\s*(.+)/m)
           if (pathMatch) projectRoot = pathMatch[1].trim()
         }
-        const docOutputDir = `.sillyspec/docs/${pName}`
+        const docOutputDir = platformOpts.specRoot ? `${specBase}/docs/${pName}` : `.sillyspec/docs/${pName}`
         const contextPrefix = `\n---\n## 当前项目\n- **项目名**: ${pName}\n- **项目路径**: ${projectRoot}\n- **文档输出**: ${docOutputDir}\n\n⚠️ 本步骤只处理上面这个项目，不要处理其他项目。\n---\n\n`
 
         for (const ppStep of perProjectSteps) {
@@ -1094,11 +1121,11 @@ async function completeStep(pm, progress, stageName, cwd, outputText, inputText
     stageData.completedAt = new Date().toLocaleString('zh-CN',{hour12:false})
     progress.lastActive = new Date().toLocaleString('zh-CN',{hour12:false})
     await pm._write(cwd, progress, changeName)
-    triggerSync(cwd, changeName)
+    triggerSync(cwd, changeName, platformOpts)
 
     // Append to user-inputs.md
     if (outputText) {
-      const inputsPath = join(cwd, '.sillyspec', '.runtime', 'user-inputs.md')
+      const inputsPath = join(specBase, '.runtime', 'user-inputs.md')
       const entry = `\n## ${new Date().toLocaleString('zh-CN',{hour12:false})} | ${changeName || '?'} | ${stageName}: ${steps[currentIdx].name}\n${inputText ? "- 输入：" + inputText + "\n" : ""}- 输出：${outputText}\n`
       appendFileSync(inputsPath, entry)
     }
@@ -1109,7 +1136,7 @@ async function completeStep(pm, progress, stageName, cwd, outputText, inputText
         const { mkdirSync, writeFileSync } = await import('fs')
         const { join } = await import('path')
         const { execSync } = await import('child_process')
-        const manifestDir = join(platformOpts.specRoot, '.sillyspec')
+        const manifestDir = platformOpts.specRoot
         mkdirSync(manifestDir, { recursive: true })
         let sourceCommit = null
         try {
@@ -1130,7 +1157,7 @@ async function completeStep(pm, progress, stageName, cwd, outputText, inputText
         }
         // 清理平台参数临时文件
         const { unlinkSync } = await import('fs')
-        const platformOptsFile = join(specRoot, '.runtime', 'platform-scan.json')
+        const platformOptsFile = join(manifestDir, '.runtime', 'platform-scan.json')
         try { unlinkSync(platformOptsFile) } catch {}
 
         // CLI 层 post-check（替代旧的简单检查）
@@ -1176,10 +1203,10 @@ async function completeStep(pm, progress, stageName, cwd, outputText, inputText
       printScanPostCheckResult(postResult)
     }
 
-    validateMetadata(cwd, stageName)
+    validateMetadata(cwd, stageName, specBase)
 
     // 验证关键文件是否在正确的变更目录下
-    validateFileLocations(cwd, stageName, progress, changeName)
+    validateFileLocations(cwd, stageName, progress, changeName, specBase)
 
     // 辅助阶段完成后重置步骤
     const stageDef = stageRegistry[stageName]
@@ -1251,7 +1278,7 @@ async function completeStep(pm, progress, stageName, cwd, outputText, inputText
     // 清理 quick-guard.json
     try {
       const { unlinkSync } = await import('fs')
-      const guardFile = join(cwd, '.sillyspec', '.runtime', 'quick-guard.json')
+      const guardFile = join(specBase, '.runtime', 'quick-guard.json')
       unlinkSync(guardFile)
     } catch {}
     if (review.status === 'blocked') {
@@ -1272,11 +1299,11 @@ async function completeStep(pm, progress, stageName, cwd, outputText, inputText
 
   progress.lastActive = new Date().toLocaleString('zh-CN',{hour12:false})
   await pm._write(cwd, progress, changeName)
-  triggerSync(cwd, changeName)
+  triggerSync(cwd, changeName, platformOpts)
 
   // Append to user-inputs.md
   if (outputText) {
-    const inputsPath = join(cwd, '.sillyspec', '.runtime', 'user-inputs.md')
+    const inputsPath = join(specBase, '.runtime', 'user-inputs.md')
     const entry = `\n## ${new Date().toLocaleString('zh-CN',{hour12:false})} | ${changeName || '?'} | ${stageName}: ${steps[currentIdx].name}\n${inputText ? "- 输入：" + inputText + "\n" : ""}- 输出：${outputText}\n`
     appendFileSync(inputsPath, entry)
   }
@@ -1302,7 +1329,7 @@ async function completeStep(pm, progress, stageName, cwd, outputText, inputText
           projectsToCheck = [currentProjectName]
         } else {
           // 兼容旧模式（未展开）：检查所有项目
-          const projectsDir = join(cwd, '.sillyspec', 'projects')
+          const projectsDir = join(specBase, 'projects')
           const projectFiles = existsSync(projectsDir)
             ? readdirSync(projectsDir).filter(f => f.endsWith('.yaml'))
             : []
@@ -1392,7 +1419,7 @@ async function skipStep(pm, progress, stageName, cwd, changeName) {
   steps[currentIdx].skippedAt = new Date().toLocaleString('zh-CN',{hour12:false})
   progress.lastActive = new Date().toLocaleString('zh-CN',{hour12:false})
   await pm._write(cwd, progress, changeName)
-  triggerSync(cwd, changeName)
+  triggerSync(cwd, changeName, platformOpts)
 
   console.log(`⏭️ Step ${currentIdx + 1}/${steps.length} 已跳过：${steps[currentIdx].name}`)
 
@@ -1455,7 +1482,7 @@ async function resetStage(pm, progress, stageName, cwd, changeName) {
   }
   progress.lastActive = new Date().toLocaleString('zh-CN',{hour12:false})
   await pm._write(cwd, progress, changeName)
-  triggerSync(cwd, changeName)
+  triggerSync(cwd, changeName, platformOpts)
   console.log(`🔄 ${stageName} 阶段已重置`)
 }
 
@@ -1481,7 +1508,7 @@ async function runAutoMode(pm, progress, cwd, flags, changeName) {
     const changed = await ensureStageSteps(progress, stage, cwd)
     if (stageChanged || changed) {
       await pm._write(cwd, progress, changeName)
-      triggerSync(cwd, changeName)
+      triggerSync(cwd, changeName, platformOpts)
     }
     progress = await pm.read(cwd, changeName)
     return progress
@@ -1532,7 +1559,7 @@ async function runAutoMode(pm, progress, cwd, flags, changeName) {
     }
     // execute 阶段启动前检查审批
     if (currentStage === 'execute' && !skipApproval) {
-      const approval = await checkApproval(cwd, changeName)
+      const approval = await checkApproval(cwd, changeName, platformOpts)
       if (approval) {
         if (approval.status === 'rejected') {
           console.error(`❌ 变更 ${changeName} 的执行已被拒绝：${approval.reason || '无原因'}`)
@@ -1562,7 +1589,7 @@ async function runAutoMode(pm, progress, cwd, flags, changeName) {
     const defSteps = await getStageSteps(currentStage, cwd, progress)
     // execute 阶段启动前检查审批
     if (currentStage === 'execute' && !skipApproval) {
-      const approval = await checkApproval(cwd, changeName)
+      const approval = await checkApproval(cwd, changeName, platformOpts)
       if (approval) {
         if (approval.status === 'rejected') {
           console.error(`❌ 变更 ${changeName} 的执行已被拒绝：${approval.reason || '无原因'}`)
@@ -1595,7 +1622,7 @@ async function runAutoMode(pm, progress, cwd, flags, changeName) {
   progress.lastActive = new Date().toLocaleString('zh-CN',{hour12:false})
   await ensureStageSteps(progress, next, cwd)
   await pm._write(cwd, progress, changeName)
-  triggerSync(cwd, changeName)
+  triggerSync(cwd, changeName, platformOpts)
   progress = await pm.read(cwd, changeName)
 
   console.log(`\n${currentStage} complete. Auto advanced to ${next}.`)
@@ -1604,7 +1631,7 @@ async function runAutoMode(pm, progress, cwd, flags, changeName) {
   if (firstPending !== -1) {
     // execute 阶段启动前检查审批
     if (next === 'execute' && !skipApproval) {
-      const approval = await checkApproval(cwd, changeName)
+      const approval = await checkApproval(cwd, changeName, platformOpts)
       if (approval) {
         if (approval.status === 'rejected') {
           console.error(`❌ 变更 ${changeName} 的执行已被拒绝：${approval.reason || '无原因'}`)

package/test/platform-recovery.test.mjs

@@ -60,19 +60,39 @@ console.log('\n=== Test 1: platform-scan.json 写入位置 ===')
   run(`node "${binCLI}" --dir "${cwd}" --spec-dir "${sd}" run scan --spec-root "${sd}" --runtime-root "${sd}/runtime" --workspace-id ws1 --scan-run-id sr1`)
 
   const inSpecDir = join(sd, '.runtime', 'platform-scan.json')
-  const inCwd = join(cwd, '.sillyspec', '.runtime', 'platform-scan.json')
+  const pointerFile = join(cwd, '.sillyspec-platform.json')
   assert(existsSync(inSpecDir), `platform-scan.json 在 specDir/.runtime/`)
-  assert(existsSync(inCwd), `恢复指针也写入 cwd/.sillyspec/.runtime/`)
+  assert(existsSync(pointerFile), `恢复指针在 cwd/.sillyspec-platform.json（不在 .sillyspec 内）`)
 
   const content = JSON.parse(readFileSync(inSpecDir, 'utf8'))
   assert(content.specRoot === sd, `specRoot 指向 specDir`)
   assert(content.workspaceId === 'ws1', `workspaceId 保存正确`)
   assert(content.scanRunId === 'sr1', `scanRunId 保存正确`)
+  // 关键：cwd/.sillyspec/ 不应被创建
+  assert(!existsSync(join(cwd, '.sillyspec')), `cwd/.sillyspec/ 未被创建（源码零污染）`)
   clean(cwd, sd)
 }
 
-// ── Test 2: --done 不带 --spec-root 时恢复 ──
-console.log('\n=== Test 2: --done 恢复平台参数 ===')
+// ── Test 2: 残留清理：旧版本创建的 cwd/.sillyspec 会被自动删除 ──
+console.log('\n=== Test 2: 旧版本残留清理 ===')
+{
+  const cwd = setup('t2'), sd = spec('t2')
+  // 模拟旧版本创建的残留
+  mkdirSync(join(cwd, '.sillyspec', '.runtime'), { recursive: true })
+  writeFileSync(join(cwd, '.sillyspec', '.runtime', 'old.db'), 'x')
+  mkdirSync(join(cwd, '.sillyspec', 'changes'), { recursive: true })
+  assert(existsSync(join(cwd, '.sillyspec')), `残留存在`)
+  // init 时应清理
+  run(`node "${binCLI}" init "${cwd}" --spec-dir "${sd}"`)
+  assert(!existsSync(join(cwd, '.sillyspec')), `init 清理了 cwd/.sillyspec/`)
+  // run 时也不应再创建
+  run(`node "${binCLI}" --dir "${cwd}" --spec-dir "${sd}" run scan --spec-root "${sd}" --runtime-root "${sd}/runtime" --workspace-id ws --scan-run-id sr 2>&1`)
+  assert(!existsSync(join(cwd, '.sillyspec')), `run 后 cwd/.sillyspec/ 仍不存在`)
+  clean(cwd, sd)
+}
+
+// ── Test 3: --done 不带 --spec-root 时恢复 ──
+console.log('\n=== Test 3: --done 恢复平台参数 ===')
 {
   const cwd = setup('t2'), sd = spec('t2')
   run(`node "${binCLI}" init "${cwd}" --spec-dir "${sd}"`)
@@ -87,7 +107,7 @@ console.log('\n=== Test 2: --done 恢复平台参数 ===')
 // ── Test 3-6: stage-contract 路径（通过 runValidators） ──
 const { runValidators } = await import(pathToFileURL(join(root, 'src', 'stage-contract.js')).href)
 
-console.log('\n=== Test 3: specDir 有文档 → 校验通过 ===')
+console.log('\n=== Test 5: specDir 有文档 → 校验通过 ===')
 {
   const cwd = setup('t3'), sd = spec('t3')
   const proj = basename(cwd)
@@ -98,7 +118,7 @@ console.log('\n=== Test 3: specDir 有文档 → 校验通过 ===')
   clean(cwd, sd)
 }
 
-console.log('\n=== Test 4: specDir 缺文档 → 校验失败，路径不含 .sillyspec ===')
+console.log('\n=== Test 5: specDir 缺文档 → 校验失败，路径不含 .sillyspec ===')
 {
   const cwd = setup('t4'), sd = spec('t4')
   const proj = basename(cwd)
@@ -112,7 +132,7 @@ console.log('\n=== Test 4: specDir 缺文档 → 校验失败，路径不含 .si
   clean(cwd, sd)
 }
 
-console.log('\n=== Test 5: 非平台模式有文档 → 校验通过 ===')
+console.log('\n=== Test 7: 非平台模式有文档 → 校验通过 ===')
 {
   const cwd = setup('t5')
   const proj = basename(cwd)
@@ -122,7 +142,7 @@ console.log('\n=== Test 5: 非平台模式有文档 → 校验通过 ===')
   clean(cwd)
 }
 
-console.log('\n=== Test 6: 非平台模式缺文档 → 路径含 .sillyspec ===')
+console.log('\n=== Test 7: 非平台模式缺文档 → 路径含 .sillyspec ===')
 {
   const cwd = setup('t6')
   const proj = basename(cwd)