sillyspec 3.13.0 → 3.14.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sillyspec",
-  "version": "3.13.0",
+  "version": "3.14.1",
   "description": "SillySpec CLI — 流程状态机，让 AI 严格按步骤来",
   "icon": "logo.jpg",
   "homepage": "https://sillyspec.ppdmq.top/",
@@ -27,6 +27,7 @@
     "@inquirer/prompts": "^7.10.1",
     "chalk": "^5.6.2",
     "chokidar": "^4.0",
+    "js-yaml": "^4.2.0",
     "open": "^10.1",
     "ora": "^9.3.0",
     "sql.js": "^1.14.1",

package/src/index.js

@@ -94,6 +94,7 @@ async function main() {
 
   // 解析全局选项
   let json = false;
+  let saveWorkflowRunFlag = false;
   let targetDir = process.cwd();
   let tool = null;
   let interactive = false;
@@ -102,6 +103,8 @@ async function main() {
   for (let i = 0; i < args.length; i++) {
     if (args[i] === '--json') {
       json = true;
+    } else if (args[i] === '--save') {
+      saveWorkflowRunFlag = true;
     } else if (args[i] === '--dir' && args[i + 1]) {
       targetDir = resolve(args[i + 1]);
       i++;
@@ -485,6 +488,137 @@ SillySpec platform — SillyHub 平台同步
       await pm.renameChange(dir, oldName, newName);
       break;
     }
+    case 'workflow': {
+      const wfSub = filteredArgs[1];
+      if (!wfSub || wfSub === 'help' || wfSub === '--help') {
+        console.log(`
+SillySpec workflow — 工作流管理
+
+用法:
+  sillyspec workflow check <name> [--project <project>] [--json]
+  sillyspec workflow list
+`);
+        break;
+      }
+      if (wfSub === 'list') {
+        const { listWorkflows } = await import('./workflow.js');
+        const names = listWorkflows(dir);
+        if (names.length === 0) {
+          console.log('未找到 workflow 定义（.sillyspec/workflows/*.yaml）');
+        } else {
+          console.log(`可用 workflow：`);
+          for (const name of names) {
+            const { loadWorkflow } = await import('./workflow.js');
+            const wf = loadWorkflow(dir, name);
+            const specVer = wf?.spec_version || wf?.version || '?';
+            const mode = wf?.orchestration?.mode || '?';
+            const roles = wf?.roles?.length || 0;
+            console.log(`  ${name} (spec v${specVer}, ${mode}, ${roles} roles)`);
+          }
+        }
+        break;
+      }
+      if (wfSub === 'check') {
+        const { loadWorkflow, runPostCheck, listWorkflows, saveWorkflowRun } = await import('./workflow.js');
+        const wfName = filteredArgs[2];
+        if (!wfName) {
+          console.error('❌ 请指定 workflow 名称，例如：sillyspec workflow check scan-docs --project sillyspec');
+          process.exit(2);
+        }
+        const wf = loadWorkflow(dir, wfName);
+        if (!wf) {
+          console.error(`❌ 未找到 workflow: ${wfName}`);
+          console.error(`可用 workflow：${listWorkflows(dir).join(', ') || '无'}`);
+          process.exit(2);
+        }
+        // depends_on 校验
+        if (wf._validationErrors && wf._validationErrors.length > 0) {
+          console.error('❌ workflow YAML 校验失败：');
+          for (const err of wf._validationErrors) {
+            console.error(`   ${err}`);
+          }
+          process.exit(2);
+        }
+        // spec_version 校验
+        const specVer = wf.spec_version || wf.version;
+        if (!specVer) {
+          console.error('❌ workflow YAML 缺少 spec_version 字段');
+          process.exit(2);
+        }
+        const SUPPORTED_SPECS = [1];
+        if (!SUPPORTED_SPECS.includes(specVer)) {
+          console.error(`❌ 不支持的 spec_version: ${specVer}（支持: ${SUPPORTED_SPECS.join(', ')}）`);
+          process.exit(2);
+        }
+        // 解析 --project
+        const projectIdx = filteredArgs.indexOf('--project');
+        const project = projectIdx !== -1 && filteredArgs[projectIdx + 1] ? filteredArgs[projectIdx + 1] : null;
+        // 解析 --json（已在顶层解析）
+        const isJson = json;
+        // 解析 --change
+        const changeIdx = filteredArgs.indexOf('--change');
+        const changeName = changeIdx !== -1 && filteredArgs[changeIdx + 1] ? filteredArgs[changeIdx + 1] : null;
+
+        if (!project && wfName !== 'archive-impact') {
+          console.error('❌ 请指定 --project，例如：--project sillyspec');
+          process.exit(2);
+        }
+
+        // 执行检查
+        let resolvedWf = wf;
+        const placeholders = {};
+        if (changeName) placeholders['change-name'] = changeName;
+        // 替换占位符
+        let jsonStr = JSON.stringify(resolvedWf);
+        if (changeName) jsonStr = jsonStr.replace(/<change-name>/g, changeName);
+        resolvedWf = JSON.parse(jsonStr);
+
+        const projectName = project || 'sillyspec';
+        const result = runPostCheck(resolvedWf, dir, projectName, placeholders);
+
+        if (isJson) {
+          console.log(JSON.stringify(result, null, 2));
+        } else {
+          // 带项目维度前缀的输出（从统一结果对象格式化）
+          const lines = [`\n📋 Workflow Post-Check: ${result.workflow} (project: ${result.project})\n`];
+          for (const r of (result.roles || [])) {
+            const icon = r.status === 'pass' ? '✅' : '❌';
+            lines.push(`${icon} [${result.project}] ${r.name} (${r.id})`);
+            const roleFailures = (result.failures || []).filter(f => f.role_id === r.id);
+            for (const f of roleFailures) {
+              lines.push(`   └─ ${f.message}`);
+            }
+          }
+          const wfFailures = (result.workflow_checks || []).filter(c => c.status === 'fail');
+          if (wfFailures.length > 0) {
+            lines.push('');
+            for (const f of wfFailures) {
+              lines.push(`❌ [${result.project}] 全局: ${f.detail}`);
+            }
+          }
+          lines.push('');
+          if (result.status === 'pass') {
+            lines.push('✅ 全部检查通过');
+          } else {
+            lines.push('❌ 存在失败项');
+          }
+          console.log(lines.join('\n'));
+        }
+
+        // exit code: 0=通过, 1=检查失败, 2=参数/YAML错误
+        if (saveWorkflowRunFlag) {
+          const saved = saveWorkflowRun(result, { cwd: dir, source: 'cli' });
+          if (saved) {
+            if (!isJson) console.log(`\n📁 结果已归档：${saved}`);
+          }
+        }
+        process.exit(result.status === 'pass' ? 0 : 1);
+      } else {
+        console.error(`❌ 未知子命令: workflow ${wfSub}`);
+        process.exit(1);
+      }
+      break;
+    }
     case 'modules': {
       const modulesSub = filteredArgs[1];
       if (!modulesSub || modulesSub === 'help' || modulesSub === '--help') {

package/src/init.js

@@ -125,6 +125,22 @@ async function doInstall(projectDir, tools, subprojects = []) {
   const gitkeepPath = join(scanDir, '.gitkeep');
   if (!existsSync(gitkeepPath)) writeFileSync(gitkeepPath, '');
 
+  // 复制 workflow 模板到 .sillyspec/workflows/
+  const workflowsDir = join(projectDir, '.sillyspec', 'workflows');
+  const templatesDir = join(__dirname, '..', 'templates', 'workflows');
+  if (existsSync(templatesDir)) {
+    mkdirSync(workflowsDir, { recursive: true });
+    for (const file of readdirSync(templatesDir)) {
+      if (file.endsWith('.yaml')) {
+        const srcPath = join(templatesDir, file);
+        const dstPath = join(workflowsDir, file);
+        if (!existsSync(dstPath)) {
+          writeFileSync(dstPath, readFileSync(srcPath));
+        }
+      }
+    }
+  }
+
   // 创建 shared/workspace 目录
   mkdirSync(join(projectDir, '.sillyspec', 'shared'), { recursive: true });
   mkdirSync(join(projectDir, '.sillyspec', 'workspace'), { recursive: true });

package/src/run.js

@@ -584,6 +584,88 @@ async function completeStep(pm, progress, stageName, cwd, outputText, inputText
     }
   }
 
+  // scan 阶段 step 2 "构建扫描项目列表" 完成后，按项目展开 perProject 步骤
+  if (stageName === 'scan' && steps[currentIdx]?.name === '构建扫描项目列表') {
+    // 解析项目列表：从 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())
+      }
+    }
+    if (projectNames.length === 0) {
+      // 回退：读取所有已注册项目
+      console.warn('⚠️ 未能从 step 2 输出解析项目列表，回退扫描所有注册项目')
+      const projectsDir = join(cwd, '.sillyspec', 'projects')
+      if (existsSync(projectsDir)) {
+        projectNames = readdirSync(projectsDir)
+          .filter(f => f.endsWith('.yaml'))
+          .map(f => f.replace(/\.yaml$/, ''))
+      }
+    }
+    if (projectNames.length === 0) {
+      projectNames = ['sillyspec'] // 最终兜底
+    }
+
+    // 保存到 runtime 供后续使用 + 防重复展开
+    const scanStatePath = join(cwd, '.sillyspec', '.runtime', 'scan-projects.json')
+    mkdirSync(join(cwd, '.sillyspec', '.runtime'), { recursive: true })
+    let scanState = { projects: projectNames, expanded: false }
+    if (existsSync(scanStatePath)) {
+      try { scanState = JSON.parse(readFileSync(scanStatePath, 'utf8')) } catch {}
+    }
+
+    // 收集当前步骤之后所有 perProject 步骤
+    const stageDef = stageRegistry[stageName]
+    const allSteps = stageDef?.steps || []
+    const perProjectSteps = allSteps.filter(s => s.perProject)
+
+    // 防重复展开：runtime 标记 或 steps 已含项目标识
+    const alreadyExpanded = scanState.expanded || steps.some(s => s.name?.match(/\[.+\]\s*$/))
+    if (!alreadyExpanded && perProjectSteps.length > 0) {
+      // 找到当前步骤（step 2）在动态 steps 中的位置
+      const insertBase = currentIdx + 1
+      let insertPos = insertBase
+      for (const pName of projectNames) {
+        // 读取项目配置获取 projectRoot
+        const projYaml = join(cwd, '.sillyspec', '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 contextPrefix = `\n---\n## 当前项目\n- **项目名**: ${pName}\n- **项目路径**: ${projectRoot}\n- **文档输出**: ${docOutputDir}\n\n⚠️ 本步骤只处理上面这个项目，不要处理其他项目。\n---\n\n`
+
+        for (const ppStep of perProjectSteps) {
+          steps.splice(insertPos, 0, {
+            name: `${ppStep.name} [${pName}]`,
+            project: pName,
+            status: 'pending',
+            prompt: contextPrefix + ppStep.prompt,
+            outputHint: ppStep.outputHint,
+            optional: ppStep.optional
+          })
+          insertPos++
+        }
+      }
+      // 移除原始的 perProject 步骤（未展开的版本）
+      for (let i = steps.length - 1; i >= 0; i--) {
+        if (steps[i].perProject && !steps[i].name?.includes('[')) {
+          steps.splice(i, 1)
+        }
+      }
+      console.log(`  📝 已按项目展开 ${perProjectSteps.length} 个步骤 × ${projectNames.length} 个项目 = ${perProjectSteps.length * projectNames.length} 个项目步骤`)
+      console.log(`  📁 扫描项目：${projectNames.join(', ')}`)
+      // 标记已展开，防止 resume 重复插入
+      scanState.expanded = true
+      writeFileSync(scanStatePath, JSON.stringify(scanState))
+    }
+  }
+
   const nextPendingIdx = steps.findIndex(s => s.status === 'pending')
 
   if (nextPendingIdx === -1) {
@@ -687,6 +769,83 @@ async function completeStep(pm, progress, stageName, cwd, outputText, inputText
 
   const defSteps = await getStageSteps(stageName, cwd, progress)
   console.log(`✅ Step ${currentIdx + 1}/${steps.length} 完成：${steps[currentIdx].name}\n`)
+
+  // Workflow post_check：scan 深度扫描完成后自动检查产物
+  if (stageName === 'scan' && steps[currentIdx]?.name?.includes('深度扫描')) {
+    try {
+      const { loadWorkflow, runPostCheck, formatCheckReport, saveWorkflowRun } = await import('./workflow.js')
+      const wf = loadWorkflow(cwd, 'scan-docs')
+      if (wf) {
+        // 确定当前项目：优先从 step metadata 读取，回退从 display name 提取
+        const currentProjectName = steps[currentIdx].project
+          || (steps[currentIdx].name.match(/\[([^\]]+)\]\s*$/) || [])[1]
+          || null
+
+        // 确定要检查的项目列表
+        let projectsToCheck = []
+        if (currentProjectName) {
+          // 按项目展开模式：只检查当前项目
+          projectsToCheck = [currentProjectName]
+        } else {
+          // 兼容旧模式（未展开）：检查所有项目
+          const projectsDir = join(cwd, '.sillyspec', 'projects')
+          const projectFiles = existsSync(projectsDir)
+            ? readdirSync(projectsDir).filter(f => f.endsWith('.yaml'))
+            : []
+          projectsToCheck = projectFiles.map(f => f.replace(/\.yaml$/, ''))
+        }
+
+        let anyFailed = false
+        for (const pName of projectsToCheck) {
+          const result = runPostCheck(wf, cwd, pName)
+          const report = formatCheckReport(result)
+          console.log(report)
+          if (result.status === 'fail') {
+            anyFailed = true
+            // retry_prompts 由 _checkWorkflow 自动生成
+            for (const rp of (result.retry_prompts || [])) {
+              console.log(`\n🔄 重试提示（项目 ${pName}）：\n`)
+              console.log(rp.prompt)
+            }
+          }
+          const saved = saveWorkflowRun(result, { cwd, source: 'run.js', stage: 'verify', step: steps[currentIdx]?.name })
+          if (saved) console.log(`📁 结果已归档：${saved}`)
+        }
+        if (anyFailed) {
+          console.log(`\n⚠️ 存在检查失败项，请按上面的重试提示修复后再继续。`)
+        }
+      }
+    } catch (e) {
+      console.warn(`⚠️ workflow 检查跳过：${e.message}`)
+    }
+  }
+
+  // Workflow post_check：archive extract-module-impact 完成后检查产物
+  if (stageName === 'archive' && steps[currentIdx]?.name?.includes('extract-module-impact')) {
+    try {
+      const { loadWorkflow, runPostCheck, formatCheckReport, saveWorkflowRun } = await import('./workflow.js')
+      const wf = loadWorkflow(cwd, 'archive-impact')
+      if (wf && changeName) {
+        const raw = JSON.stringify(wf)
+        const resolved = JSON.parse(raw.replace(/<change-name>/g, changeName))
+        const result = runPostCheck(resolved, cwd, 'sillyspec')
+        // 只报告 impact-analyzer 的结果（doc-syncer 是后续步骤）
+        const impactResult = (result.roles || []).find(r => r.id === 'impact-analyzer')
+        if (impactResult) {
+          const icon = impactResult.status === 'pass' ? '✅' : '❌'
+          console.log(`${icon} module-impact.md 检查${impactResult.status === 'pass' ? '通过' : '失败'}`)
+          for (const f of (result.failures || []).filter(f => f.role_id === 'impact-analyzer')) {
+            console.log(`   └─ ${f}`)
+          }
+        }
+        const saved = saveWorkflowRun(result, { cwd, source: 'run.js', stage: 'archive', step: steps[currentIdx]?.name })
+        if (saved) console.log(`📁 结果已归档：${saved}`)
+      }
+    } catch (e) {
+      console.warn(`⚠️ workflow 检查跳过：${e.message}`)
+    }
+  }
+
   if (printNext) {
     await outputStep(stageName, nextPendingIdx, defSteps, cwd, changeName, progress.project || null)
   }

package/src/stages/archive.js

@@ -20,20 +20,21 @@ export const definition = {
     },
     {
       name: 'extract-module-impact',
-      prompt: `分析本次变更影响的模块，生成模块影响记录。
+      prompt: `按照 \`.sillyspec/workflows/archive-impact.yaml\` 中定义的 \`impact-analyzer\` 角色规则，分析本次变更影响的模块。
 
 ### 操作
-1. 读取变更目录下的 proposal.md、design.md、tasks.md
-2. 运行 \`git diff --name-only HEAD~1\`（或 \`git diff --name-only --cached\`）获取真实修改文件列表
-3. 读取 \`.sillyspec/docs/<project>/modules/_module-map.yaml\`
+1. 读取 \`.sillyspec/workflows/archive-impact.yaml\`，了解角色定义和检查规则
+2. 读取变更目录下的 proposal.md、design.md、tasks.md
+3. 运行 \`git diff --name-only HEAD~1\`（或 \`git diff --name-only --cached\`）获取真实修改文件列表
+4. 读取 \`.sillyspec/docs/<project>/modules/_module-map.yaml\`
    - **如果不存在**：提示"建议运行 scan 生成模块映射"，但继续执行。跳到步骤 7 生成只有 unmapped 部分的 module-impact.md
-4. 三重交叉验证：
+5. 三重交叉验证：
    - 声明范围：proposal.md / design.md 中的"变更范围"/"文件变更清单"
    - 任务范围：tasks.md / plan.md 中的任务文件路径
    - 真实变更：git diff 文件列表
    - **以 git diff 为准**（真实 > 声明）
-5. 将 git diff 文件按 \`_module-map.yaml\` 的 paths glob 匹配到模块
-6. 生成模块影响矩阵：
+6. 将 git diff 文件按 \`_module-map.yaml\` 的 paths glob 匹配到模块
+7. 生成模块影响矩阵：
 
 | 模块 | 影响类型 | 相关文件 | 更新内容摘要 | needs_review |
 |------|----------|----------|-------------|-------------|
@@ -41,33 +42,10 @@ export const definition = {
    影响类型：逻辑变更 / 数据结构变更 / 接口变更 / 调用关系变更 / 配置变更 / 新增
    needs_review：如果影响无法完全确定，标记为 true
 
-7. 未匹配到任何模块的文件归入"未匹配文件"表格
-8. 生成 \`.sillyspec/changes/<change-name>/module-impact.md\`，格式：
-
-\`\`\`markdown
-# 模块影响分析
-
-author: <git-user>
-created_at: <now-datetime>
-
-## 变更：<change-name>
-
-## 模块影响矩阵
-| 模块 | 影响类型 | 相关文件 | 更新内容摘要 | needs_review |
-|------|----------|----------|-------------|-------------|
-
-## 未匹配文件
-| 文件路径 | 说明 |
-|----------|------|
-
-## 更新结果
-（sync-module-docs 步骤完成后回填）
-| 目标 | 操作 | 状态 |
-|------|------|------|
-\`\`\`
-
-### 输出
-module-impact.md 路径 + 影响模块数量 + 未匹配文件数量`,
+8. 未匹配到任何模块的文件归入"未匹配文件"表格
+9. 生成 \`.sillyspec/changes/<change-name>/module-impact.md\`
+10. 完成后运行 workflow 检查：
+    \`node -e "import('./src/workflow.js').then(w => { /* 用 loadWorkflow 加载 archive-impact，用 runPostCheck 检查 */ })\``,
       outputHint: 'module-impact.md 路径 + 影响摘要',
       optional: false
     },