speccore 8.3.238 → 8.3.240

package/dist/commands/iteration/split.js

@@ -665,7 +665,20 @@ async function iterationSplitCommand(options) {
                         priority: task.priority || 'medium',
                     };
                     section._owner = task.owner || '未分配';
-                    section._taskType = (task.type && ['feature', 'bugfix', 'refactor', 'research', 'security', 'performance'].includes(task.type)) ? task.type : 'feature';
+                    // v8.3.239+: 任务类型收敛为 4 种（与 task-paths.ts TASK_TYPES 对齐）——
+                    // security 按 feature 交付（安全加固是完整交付，威胁分析归入 TECH.md 安全章节），
+                    // performance 按 refactor 执行（性能优化本质是重构）
+                    const rawType = task.type;
+                    let taskType = (rawType && ['feature', 'bugfix', 'refactor', 'research'].includes(rawType)) ? rawType : 'feature';
+                    if (rawType === 'security') {
+                        taskType = 'feature';
+                        logger_1.logger.info(`   🔒 任务「${task.name}」类型 security 收敛为 feature（安全加固按完整交付）`);
+                    }
+                    if (rawType === 'performance') {
+                        taskType = 'refactor';
+                        logger_1.logger.info(`   ⚡ 任务「${task.name}」类型 performance 收敛为 refactor（性能优化按重构执行）`);
+                    }
+                    section._taskType = taskType;
                     // 保存 topic slug，用于生成任务目录名（v8.3.77+: 多层提取）
                     section._topic = extractTopic(task);
                     // 保存 AI 生成的实际内容（用于写入 REQ.md / TECH.md）
@@ -1900,7 +1913,9 @@ ${sectionDevExtract}
         }
     }
     if (section.content.match(/数据库|数据表|表结构|DDL|ALTER|建表|索引/)) {
-        const schemaMaterial = extractRelevantSection(specContents['TECH.md'] || '', section.name, 'DDL 建表 表结构 索引 CREATE TABLE');
+        // v8.3.239+: 三层匹配提取 DDL（兼容 {feature}/overview/TECH.md 嵌套键，旧扁平键取不到 DDL）
+        const bestTechMatch = findBestSpecMatch(specContents, section.name, undefined, 'TECH.md');
+        const schemaMaterial = extractRelevantSection((bestTechMatch && bestTechMatch.score >= 20 ? specContents[bestTechMatch.key] : specContents['TECH.md']) || '', section.name, 'DDL 建表 表结构 索引 CREATE TABLE');
         await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, '00-specs', 'SCHEMA.md'), generateSchemaTemplate(section, schemaMaterial));
     }
     await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, '00-specs', 'CHANGELOG.md'), `# ${section.name} - 变更记录
@@ -1910,7 +1925,9 @@ ${sectionDevExtract}
 | ${today} | v1.0 | 初始创建 | CLI |
 `);
     // API_CONTRACT.yaml 统一放 _shared/
-    if (apiLines.length > 0) {
+    // v8.3.239+: 全局契约是单一真相源——已写入时不再覆盖（保留 rate limit/幂等性/版本策略），
+    // section 提取版仅作兜底（全局契约不存在时）
+    if (apiLines.length > 0 && !(await (0, fs_extra_1.pathExists)((0, path_1.join)(taskDir, '_shared', 'API_CONTRACT.yaml')))) {
         // 从 section 内容提取每个 API 的请求/响应字段
         const sectionContent = section.content || '';
         const apiFieldMap = {};
@@ -1951,12 +1968,31 @@ ${sectionDevExtract}
     }
     // ── 4. 子任务目录（按任务类型差异化） ──
     // 预加载执行产出模板材料（每个子任务都需要）
-    const testMaterial = extractRelevantSection(specContents['TEST.md'] || '', section.name);
-    const reviewMaterial = extractRelevantSection(specContents['REVIEW.md'] || '', section.name);
-    const deployMaterial = extractRelevantSection(specContents['DEPLOY.md'] || '', section.name);
-    const riskMaterial = extractRelevantSection(specContents['RISK.md'] || '', section.name);
-    const depsMaterial = extractRelevantSection(specContents['DEPS.md'] || '', section.name);
-    const monitorMaterial = extractRelevantSection(specContents['MONITOR.md'] || '', section.name);
+    // v8.3.239+: 材料提取统一走三层匹配——兼容 overview/ 扁平键与 {feature}/overview/ 嵌套键
+    // （新结构下 RISK/DEPS/MONITOR 在功能模块目录，旧结构下在 overview/ 平铺）
+    const extractMaterial = (docName) => {
+        const best = findBestSpecMatch(specContents, section.name, undefined, docName);
+        if (best && best.score >= 20) {
+            return extractRelevantSection(specContents[best.key], section.name);
+        }
+        return extractRelevantSection(specContents[docName] || '', section.name);
+    };
+    const testMaterial = extractMaterial('TEST.md');
+    // v8.3.239+: 分析层 9 份名单无 REVIEW/DEPLOY，提取恒空 → 不再提取，走内容感知模板
+    // （generateReviewChecklist/generateDeployChecklist 保留 material 参数，未来补提取源即可恢复）
+    const riskMaterial = extractMaterial('RISK.md');
+    const depsMaterial = extractMaterial('DEPS.md');
+    const monitorMaterial = extractMaterial('MONITOR.md');
+    // v8.3.239+: 子任务文档按类型裁剪——bugfix 轻量（修缺陷无需部署/监控/前端设计），
+    // refactor 中等（保留风险与组件树，跳过路由/样式/部署/监控），feature 全套
+    const docSet = {
+        hasRisk: taskType !== 'bugfix',
+        hasMonitor: taskType === 'feature',
+        hasDeploy: taskType === 'feature',
+        hasFeDesign: taskType === 'feature', // ROUTES/STATE/STYLE_GUIDE
+        hasComponentTree: taskType !== 'bugfix', // feature/refactor 前端影响面
+        hasAdr: taskType !== 'bugfix',
+    };
     // ── 4a. research 类型：不创建平台/子任务目录，直接产出调研文档 ──
     if (isResearch) {
         await (0, fs_extra_1.writeFile)((0, path_1.join)(taskDir, 'RESEARCH.md'), `# ${section.name} — 调研报告
@@ -2098,11 +2134,10 @@ ${isBk ? apiList : pageList}
 | :--- | :--- | :--- | :--- |
 | TASK.md | ✅ | ./TASK.md | 本文件 |
 | TEST.md | ⏳ | ./TEST.md | ${isBk ? '单元测试 + 接口测试' : 'UI 测试 + 组件测试'} |
-| RISK.md | ⏳ | ./RISK.md | 风险评估 |
-| REVIEW.md | ⏳ | ./REVIEW.md | 评审清单 |
-| DEPLOY.md | ⏳ | ./DEPLOY.md | 部署检查 |
-| ERROR_CODES.md | ⏳ | ./ERROR_CODES.md | 错误码定义 |
-> ⚠️ 代码输出位置：AI 生成的代码写入 CONSTITUTION.md/PROJECT.yaml 中声明的「源码路径」，
+${docSet.hasRisk ? '| RISK.md | ⏳ | ./RISK.md | 风险评估 |\n' : ''}| DEPS.md | ⏳ | ./DEPS.md | 依赖清单 |
+${docSet.hasMonitor ? '| MONITOR.md | ⏳ | ./MONITOR.md | 监控指标 |\n' : ''}| REVIEW.md | ⏳ | ./REVIEW.md | 评审清单 |
+${docSet.hasDeploy ? '| DEPLOY.md | ⏳ | ./DEPLOY.md | 部署检查 |\n' : ''}| ERROR_CODES.md | ⏳ | ./ERROR_CODES.md | 错误码定义 |
+${!isBk && docSet.hasComponentTree ? '| COMPONENT_TREE.md | ⏳ | ./COMPONENT_TREE.md | 组件树 |\n' : ''}${!isBk && docSet.hasFeDesign ? '| ROUTES.md | ⏳ | ./ROUTES.md | 路由设计 |\n| STATE.md | ⏳ | ./STATE.md | 状态管理 |\n| STYLE_GUIDE.md | ⏳ | ./STYLE_GUIDE.md | 样式规范 |\n' : ''}> ⚠️ 代码输出位置：AI 生成的代码写入 CONSTITUTION.md/PROJECT.yaml 中声明的「源码路径」,
 > 不写入迭代目录。子任务目录只存放规格文档。
 
 ## 变更履历
@@ -2110,14 +2145,18 @@ ${isBk ? apiList : pageList}
 | :--- | :--- | :--- |
 | ${today} | 创建子任务 | CLI |
 `);
-            // 前端设计文档（仅非 backend 端）
-            if (!isBk) {
+            // 前端设计文档（仅非 backend 端，按任务类型裁剪：bugfix 跳过，refactor 仅组件树）
+            if (!isBk && docSet.hasComponentTree) {
                 const feContent = extractTaskTechContent(specContents, section, platformName);
                 await (0, fs_extra_1.writeFile)((0, path_1.join)(subtaskDir, 'COMPONENT_TREE.md'), generateComponentTree(section, platformName, feContent));
-                await (0, fs_extra_1.writeFile)((0, path_1.join)(subtaskDir, 'ROUTES.md'), generateRoutesDoc(section, platformName, feContent));
-                await (0, fs_extra_1.writeFile)((0, path_1.join)(subtaskDir, 'STATE.md'), generateStateDoc(section, platformName, feContent));
-                await (0, fs_extra_1.writeFile)((0, path_1.join)(subtaskDir, 'STYLE_GUIDE.md'), generateStyleGuide(section, platformName, feContent));
-                // v8.3.60+: 自动生成 VERIFY_SPEC.yaml（从源码路由扫描）
+                if (docSet.hasFeDesign) {
+                    await (0, fs_extra_1.writeFile)((0, path_1.join)(subtaskDir, 'ROUTES.md'), generateRoutesDoc(section, platformName, feContent));
+                    await (0, fs_extra_1.writeFile)((0, path_1.join)(subtaskDir, 'STATE.md'), generateStateDoc(section, platformName, feContent));
+                    await (0, fs_extra_1.writeFile)((0, path_1.join)(subtaskDir, 'STYLE_GUIDE.md'), generateStyleGuide(section, platformName, feContent));
+                }
+            }
+            // v8.3.60+: 自动生成 VERIFY_SPEC.yaml（从源码路由扫描，所有前端端均生成）
+            if (!isBk) {
                 try {
                     const projectConfig = await (0, unified_config_1.loadProjectConfig)();
                     const platformConfig = projectConfig.platforms.find(p => p.name === platformName);
@@ -2144,21 +2183,26 @@ ${isBk ? apiList : pageList}
                     // 静默失败：源码不可用或扫描失败时不阻断 split 流程
                 }
             }
-            // 执行产出文档
+            // 执行产出文档（按任务类型裁剪：bugfix 无 RISK/MONITOR/DEPLOY，refactor 无 MONITOR/DEPLOY）
             await (0, fs_extra_1.writeFile)((0, path_1.join)(subtaskDir, 'TEST.md'), generateTestOutline(section, testMaterial));
-            await (0, fs_extra_1.writeFile)((0, path_1.join)(subtaskDir, 'REVIEW.md'), generateReviewChecklist(section, reviewMaterial));
-            await (0, fs_extra_1.writeFile)((0, path_1.join)(subtaskDir, 'DEPLOY.md'), generateDeployChecklist(section, deployMaterial));
+            await (0, fs_extra_1.writeFile)((0, path_1.join)(subtaskDir, 'REVIEW.md'), generateReviewChecklist(section));
+            if (docSet.hasDeploy)
+                await (0, fs_extra_1.writeFile)((0, path_1.join)(subtaskDir, 'DEPLOY.md'), generateDeployChecklist(section));
             await (0, fs_extra_1.writeFile)((0, path_1.join)(subtaskDir, 'ERROR_CODES.md'), generateErrorCodes(section));
-            await (0, fs_extra_1.writeFile)((0, path_1.join)(subtaskDir, 'RISK.md'), generateRiskTemplate(section, riskMaterial));
+            if (docSet.hasRisk)
+                await (0, fs_extra_1.writeFile)((0, path_1.join)(subtaskDir, 'RISK.md'), generateRiskTemplate(section, riskMaterial));
             await (0, fs_extra_1.writeFile)((0, path_1.join)(subtaskDir, 'DEPS.md'), generateDepsTemplate(section, depsMaterial));
-            await (0, fs_extra_1.writeFile)((0, path_1.join)(subtaskDir, 'MONITOR.md'), generateMonitorTemplate(section, monitorMaterial));
+            if (docSet.hasMonitor)
+                await (0, fs_extra_1.writeFile)((0, path_1.join)(subtaskDir, 'MONITOR.md'), generateMonitorTemplate(section, monitorMaterial));
             // v8.0.0+: 预创建 REQ.md 和 TECH.md 骨架文件
             // AI 用 Write 覆盖这些文件，不再自行创建路径（消除路径错误）
             await (0, fs_extra_1.writeFile)((0, path_1.join)(subtaskDir, 'REQ.md'), `${spec_skeleton_1.SKELETON_MARKER}\n# ${section.name} — ${platformLabel}\n\n> 本文件由 CLI 预创建，请用 Write 工具覆盖为专业需求规格。\n\n## 功能描述\n<!-- AI-FILL: 本端的需求描述 -->\n\n## 验收标准\n<!-- AI-FILL: Given/When/Then 格式 -->\n\n## 业务规则\n<!-- AI-FILL -->\n\n## 边界条件\n<!-- AI-FILL -->\n\n## 异常场景\n<!-- AI-FILL -->\n`);
             await (0, fs_extra_1.writeFile)((0, path_1.join)(subtaskDir, 'TECH.md'), `${spec_skeleton_1.SKELETON_MARKER}\n# ${section.name} — ${platformLabel} 技术方案\n\n> 本文件由 CLI 预创建，请用 Write 工具覆盖为专业技术方案。\n\n## 接口定义\n<!-- AI-FILL: 请求/响应结构体 -->\n\n## 数据模型\n<!-- AI-FILL: 字段/类型/约束 -->\n\n## 核心逻辑\n<!-- AI-FILL -->\n\n## 依赖说明\n<!-- AI-FILL -->\n`);
-            const adr = generateAdr(section);
-            if (adr) {
-                await (0, fs_extra_1.writeFile)((0, path_1.join)(subtaskDir, 'ADR.md'), adr);
+            if (docSet.hasAdr) {
+                const adr = generateAdr(section);
+                if (adr) {
+                    await (0, fs_extra_1.writeFile)((0, path_1.join)(subtaskDir, 'ADR.md'), adr);
+                }
             }
         };
         // ── 所有端平铺：{端名}/{子任务}/ （v6.49.2+ 统一架构）──
@@ -2213,14 +2257,17 @@ ${isBk ? apiList : pageList}
 - REQ.md → ../../../00-specs/REQ.md
 - TECH.md → ../../../00-specs/TECH.md
 `);
-        // 自动补充的后端也需要执行产出文档
+        // 自动补充的后端也需要执行产出文档（按任务类型裁剪）
         await (0, fs_extra_1.writeFile)((0, path_1.join)(autoSubtaskDir, 'TEST.md'), generateTestOutline(section, testMaterial));
-        await (0, fs_extra_1.writeFile)((0, path_1.join)(autoSubtaskDir, 'REVIEW.md'), generateReviewChecklist(section, reviewMaterial));
-        await (0, fs_extra_1.writeFile)((0, path_1.join)(autoSubtaskDir, 'DEPLOY.md'), generateDeployChecklist(section, deployMaterial));
+        await (0, fs_extra_1.writeFile)((0, path_1.join)(autoSubtaskDir, 'REVIEW.md'), generateReviewChecklist(section));
+        if (docSet.hasDeploy)
+            await (0, fs_extra_1.writeFile)((0, path_1.join)(autoSubtaskDir, 'DEPLOY.md'), generateDeployChecklist(section));
         await (0, fs_extra_1.writeFile)((0, path_1.join)(autoSubtaskDir, 'ERROR_CODES.md'), generateErrorCodes(section));
-        await (0, fs_extra_1.writeFile)((0, path_1.join)(autoSubtaskDir, 'RISK.md'), generateRiskTemplate(section, riskMaterial));
+        if (docSet.hasRisk)
+            await (0, fs_extra_1.writeFile)((0, path_1.join)(autoSubtaskDir, 'RISK.md'), generateRiskTemplate(section, riskMaterial));
         await (0, fs_extra_1.writeFile)((0, path_1.join)(autoSubtaskDir, 'DEPS.md'), generateDepsTemplate(section, depsMaterial));
-        await (0, fs_extra_1.writeFile)((0, path_1.join)(autoSubtaskDir, 'MONITOR.md'), generateMonitorTemplate(section, monitorMaterial));
+        if (docSet.hasMonitor)
+            await (0, fs_extra_1.writeFile)((0, path_1.join)(autoSubtaskDir, 'MONITOR.md'), generateMonitorTemplate(section, monitorMaterial));
         taskPlatforms.push(fallbackBackend);
         subtaskIdMap.set(fallbackBackend, `${taskId}-${fallbackBackend}-auto`);
     }
@@ -2236,7 +2283,7 @@ ${isBk ? apiList : pageList}
         ? `020-specs/${sourceFile}`
         : `020-specs/${taskType === 'feature' ? 'features' : taskType === 'bugfix' ? 'bugs' : taskType === 'refactor' ? 'refactors' : 'research'}/${topic}.md`;
     // 任务类型中文标签
-    const typeLabels = { feature: '功能开发', bugfix: '缺陷修复', refactor: '重构优化', research: '技术调研', security: '安全修复', performance: '性能优化' };
+    const typeLabels = { feature: '功能开发', bugfix: '缺陷修复', refactor: '重构优化', research: '技术调研' };
     const typeLabel = typeLabels[taskType] || taskType;
     // 收集同迭代的其它任务（用于关联关系）
     const relatedTasks = allSections
@@ -2322,8 +2369,8 @@ async function updateProjectGraph(iterationDir, sections) {
  * 根据需求内容自动生成测试用例框架
  */
 function generateTestOutline(section, material) {
-    // v6.79.0+: 降低阈值，让更多 analyze 内容被使用
-    if (material && material.trim().length > 10) {
+    // v8.3.239+: 阈值统一 200 字符，低质量提取片段不再替换内容感知模板
+    if (material && material.trim().length > 200) {
         return `# ${section.name} — 测试用例\n\n> 来源: analyze → TEST.md（自动提取）\n\n${material.trim()}\n`;
     }
     const name = section.name;
@@ -2394,7 +2441,8 @@ function extractApiRowsFromContent(content) {
  * 根据需求内容自动生成代码审查清单
  */
 function generateReviewChecklist(section, material) {
-    if (material && material.trim().length > 10) {
+    // v8.3.239+: 阈值统一 200 字符（分析层暂无 REVIEW 提取源，material 恒空，走内容感知模板）
+    if (material && material.trim().length > 200) {
         return `# ${section.name} — Code Review Checklist\n\n> 来源: analyze → REVIEW.md（自动提取）\n\n${material.trim()}\n`;
     }
     const name = section.name;
@@ -2592,7 +2640,7 @@ async function generateImpactGraph(iterationDir, sections, platforms) {
 }
 function generateSchemaTemplate(section, material) {
     const name = section.name;
-    if (material && material.trim().length > 30) {
+    if (material && material.trim().length > 200) {
         return `# ${name} — Database Schema\n\n> 来源: analyze → TECH.md（自动提取）\n\n${material.trim()}\n`;
     }
     return `# ${name} — Database Schema
@@ -2633,7 +2681,8 @@ function generateSchemaTemplate(section, material) {
 `;
 }
 function generateDeployChecklist(section, material) {
-    if (material && material.trim().length > 10) {
+    // v8.3.239+: 阈值统一 200 字符（分析层暂无 DEPLOY 提取源，material 恒空，走内容感知模板）
+    if (material && material.trim().length > 200) {
         return `# ${section.name} — 部署检查清单\n\n> 来源: analyze → DEPLOY.md（自动提取）\n\n${material.trim()}\n`;
     }
     const name = section.name;
@@ -2642,7 +2691,7 @@ function generateDeployChecklist(section, material) {
 
 ## Pre-Deploy
 
-- [ ] All tests pass (\`speccore lifecycle --task=${name} --check\`)
+- [ ] All tests pass (\`speccore verify\`)
 - [ ] Code review approved (REVIEW.md all checked)
 - [ ] PR merged to main
 - [ ] CI/CD pipeline green
@@ -2869,21 +2918,21 @@ function generateAcceptanceCriteria(section) {
 }
 // 风险评估
 function generateRiskTemplate(section, material) {
-    if (material && material.trim().length > 30) {
+    if (material && material.trim().length > 200) {
         return `# ${section.name} — 风险评估\n\n> 来源: analyze → RISK.md（自动提取）\n\n${material.trim()}\n`;
     }
     return `# ${section.name} — 风险评估\n\n> split | ${new Date().toISOString().split('T')[0]}\n\n## 风险矩阵\n\n| 风险 | 可能 | 影响 | 缓解 |\n| :--- | :--- | :--- | :--- |\n| 兼容性 | 中 | 高 | 版本号+测试 |\n| 性能 | 低 | 中 | 压测+索引 |\n| 依赖故障 | 低 | 高 | 降级方案 |\n\n## 回滚\n\n1. 触发: 线上错误率 > 1%\n2. 步骤: git revert → 重部署\n3. 验证: 冒烟测试 + 监控\n`;
 }
 // 依赖清单
 function generateDepsTemplate(section, material) {
-    if (material && material.trim().length > 30) {
+    if (material && material.trim().length > 200) {
         return `# ${section.name} — 依赖清单\n\n> 来源: analyze → DEPS.md（自动提取）\n\n${material.trim()}\n`;
     }
     return `# ${section.name} — 依赖清单\n\n## 上游依赖\n\n| 服务 | 版本 | 用途 | SLA |\n| :--- | :--- | :--- | :--- |\n| _待补充_ | — | — | — |\n\n## 下游影响\n\n| 服务 | 影响 | 通知 |\n| :--- | :--- | :--- |\n| _待补充_ | — | — |\n`;
 }
 // 监控指标
 function generateMonitorTemplate(section, material) {
-    if (material && material.trim().length > 30) {
+    if (material && material.trim().length > 200) {
         return `# ${section.name} — 监控\n\n> 来源: analyze → MONITOR.md（自动提取）\n\n${material.trim()}\n`;
     }
     return `# ${section.name} — 监控\n\n## 关键指标\n\n| 指标 | 阈值 | 级别 |\n| :--- | :--- | :--- |\n| 成功率 | <99.9% | P1 |\n| P99延迟 | >1000ms | P2 |\n| 错误率 | >0.1% | P0 |\n\n## 关键日志\n\n- 请求入口 (traceId)\n- 业务异常 (上下文)\n- 外部调用 (耗时)\n`;
@@ -3146,7 +3195,7 @@ function extractTaskDevGuideContent(specContents, section, taskPlatforms) {
 }
 // 前端专属：组件树
 function generateComponentTree(section, platform, material) {
-    if (material && material.trim().length > 30) {
+    if (material && material.trim().length > 200) {
         return `# ${section.name} — 组件树 (${platform})\n\n> 来源: analyze → TECH.md（自动提取）\n\n${material.trim()}\n`;
     }
     return `# ${section.name} — 组件树 (${platform})
@@ -3169,7 +3218,7 @@ function generateComponentTree(section, platform, material) {
 }
 // 前端专属：路由
 function generateRoutesDoc(section, platform, material) {
-    if (material && material.trim().length > 30) {
+    if (material && material.trim().length > 200) {
         return `# ${section.name} — 路由设计 (${platform})\n\n> 来源: analyze → TECH.md（自动提取）\n\n${material.trim()}\n`;
     }
     return `# ${section.name} — 路由设计 (${platform})
@@ -3187,7 +3236,7 @@ function generateRoutesDoc(section, platform, material) {
 }
 // 前端专属：状态管理
 function generateStateDoc(section, platform, material) {
-    if (material && material.trim().length > 30) {
+    if (material && material.trim().length > 200) {
         return `# ${section.name} — 状态管理 (${platform})\n\n> 来源: analyze → TECH.md（自动提取）\n\n${material.trim()}\n`;
     }
     return `# ${section.name} — 状态管理 (${platform})
@@ -3210,7 +3259,7 @@ function generateStateDoc(section, platform, material) {
 }
 // 前端专属：样式规范
 function generateStyleGuide(section, platform, material) {
-    if (material && material.trim().length > 30) {
+    if (material && material.trim().length > 200) {
         return `# ${section.name} — 样式规范 (${platform})\n\n> 来源: analyze → TECH.md（自动提取）\n\n${material.trim()}\n`;
     }
     const isH5 = platform.includes('h5') || platform.includes('mobile');