speccore 8.3.3 → 8.3.5

package/dist/commands/iteration/split.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"split.d.ts","sourceRoot":"","sources":["../../../src/commands/iteration/split.ts"],"names":[],"mappings":"AAsIA,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAuBD,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+xBzF"}
+{"version":3,"file":"split.d.ts","sourceRoot":"","sources":["../../../src/commands/iteration/split.ts"],"names":[],"mappings":"AAuIA,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAoCD,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+0BzF"}

package/dist/commands/iteration/split.js

@@ -51,6 +51,7 @@ const questions_1 = require("../../core/questions");
 const pipeline_engine_1 = require("../../core/pipeline-engine");
 const code_scanner_1 = require("../../core/code-scanner");
 const knowledge_graph_1 = require("../../core/knowledge-graph");
+const git_integration_1 = require("../../core/git-integration");
 /**
  * 将 AI 返回的 scope 简写映射到 CONSTITUTION.md 标准端名
  * v6.69.3+: 解决中文简写（如 "后端"、"admin"）导致目录名错误的问题
@@ -162,16 +163,28 @@ async function detectPlatforms(iterationDir, specified) {
     const platforms = await (0, spec_paths_1.parsePlatformList)();
     if (platforms.length > 0)
         return platforms;
-    // 2. 回退：扫描 020-specs/ 子目录（排除 global/ 等非端目录）
+    // 2. 回退：扫描 020-specs/ 子目录（排除 global/ 等非端目录 + 常见 AI 简写垃圾目录）
     const specsDir = (0, path_1.join)(iterationDir, '020-specs');
     if (await (0, fs_extra_1.pathExists)(specsDir)) {
         const entries = await (0, fs_extra_1.readdir)(specsDir, { withFileTypes: true });
-        const knownNonPlatformDirs = new Set(['sources', 'assets', 'prototypes', 'converted', 'features', 'bugs', 'refactors', 'research', 'staging', 'platforms', 'snapshots', spec_paths_1.GLOBAL_SPECS_DIR]);
-        const platforms = entries
+        // v8.3.4+: 增加常见 AI 简写过滤，避免 api/web 等错误目录被当成端名
+        const knownNonPlatformDirs = new Set([
+            'sources', 'assets', 'prototypes', 'converted', 'features', 'bugs', 'refactors', 'research',
+            'staging', 'platforms', 'snapshots', 'overview', 'global', spec_paths_1.GLOBAL_SPECS_DIR,
+            // 常见 AI 简写垃圾目录（必须从标准端名映射，不能直接用）
+            'api', 'web', 'backend', 'frontend', 'server', 'mobile', 'admin', 'h5', 'pc', 'app',
+        ]);
+        const rawPlatforms = entries
             .filter((e) => e.isDirectory() && !e.name.startsWith('_') && !e.name.startsWith('.') && !knownNonPlatformDirs.has(e.name))
             .map((e) => e.name);
-        if (platforms.length > 0)
-            return platforms;
+        // 二次过滤：用 normalizeScopePlatforms 排除任何残留的非标准端名
+        if (rawPlatforms.length > 0) {
+            const standardPlatforms = await (0, spec_paths_1.parsePlatformList)();
+            if (standardPlatforms.length > 0) {
+                return normalizeScopePlatforms(rawPlatforms, standardPlatforms);
+            }
+            return rawPlatforms;
+        }
     }
     return ['web']; // 默认
 }
@@ -278,15 +291,15 @@ async function iterationSplitCommand(options) {
             return;
         }
         // 非 Pipeline 模式的 Response 处理
-        const iterDir = (0, path_1.join)('Iteration-' + iter, '030-tasks');
+        // v8.3.4+ 修复：使用 getIterationDir 解析正确路径，避免 Iteration- 前缀重复
+        const iterDirFull = await (0, context_1.getIterationDir)(iter);
+        const iterDir = (0, path_1.join)(iterDirFull, '030-tasks');
         await (0, fs_extra_1.ensureDir)(iterDir);
         const backups = [];
         // 尝试解析 AI 返回的 JSON Task 列表
         try {
             const tasks = JSON.parse(options.response);
             if (Array.isArray(tasks)) {
-                // 获取迭代根目录（createTaskFromSection 需要迭代根路径）
-                const iterDirFull = await (0, context_1.getIterationDir)(iter);
                 const allPlatforms = await detectPlatforms(iterDirFull);
                 const sections = [];
                 for (let i = 0; i < tasks.length; i++) {
@@ -351,6 +364,57 @@ async function iterationSplitCommand(options) {
                         section._scopePlatforms = taskScopePlatforms;
                     sections.push(section);
                 }
+                // v8.3.4+: 校验所有任务的 scope 是否只含标准端名
+                const invalidScopes = [];
+                for (const sec of sections) {
+                    const scopes = sec._scopePlatforms || [];
+                    for (const s of scopes) {
+                        if (!allPlatforms.includes(s))
+                            invalidScopes.push(`任务 "${sec.name}" 的 scope "${s}"`);
+                    }
+                }
+                if (invalidScopes.length > 0) {
+                    logger_1.logger.error(`❌ 发现 ${invalidScopes.length} 个非标准端名，拆分被拒绝：`);
+                    for (const msg of invalidScopes)
+                        logger_1.logger.error(`   ${msg}`);
+                    logger_1.logger.error(`   标准端名: ${allPlatforms.join(', ')}`);
+                    logger_1.logger.info(`   💡 请告诉 AI：scope 必须使用 CONSTITUTION.md 标准端名，禁止 api/web/backend 等简写`);
+                    return;
+                }
+                // v8.3.4+: 功能点覆盖校验 — 对比 FUNCTION_MAP.md 检查是否有遗漏
+                const funcMapPath = (0, path_1.join)(iterDirFull, '020-specs', spec_paths_1.GLOBAL_SPECS_DIR, 'FUNCTION_MAP.md');
+                if (await (0, fs_extra_1.pathExists)(funcMapPath)) {
+                    try {
+                        const fmContent = await (0, fs_extra_1.readFile)(funcMapPath, 'utf-8');
+                        const funcUnits = parseFunctionMap(fmContent, allPlatforms);
+                        if (funcUnits.length > 0) {
+                            const aiUnits = new Set();
+                            for (const t of tasks) {
+                                const unit = t.functionalUnit || t.name;
+                                if (unit)
+                                    aiUnits.add(unit.trim());
+                            }
+                            const missingUnits = [];
+                            for (const u of funcUnits) {
+                                // 模糊匹配：如果 AI 任务中没有功能单元名包含或被包含于 FUNCTION_MAP 中的名称
+                                const matched = [...aiUnits].some(aiu => aiu.toLowerCase().includes(u.name.toLowerCase()) ||
+                                    u.name.toLowerCase().includes(aiu.toLowerCase()));
+                                if (!matched)
+                                    missingUnits.push(u.name);
+                            }
+                            if (missingUnits.length > 0) {
+                                logger_1.logger.warn(`\n   ⚠️  功能点覆盖警告：${missingUnits.length} 个功能单元可能被遗漏`);
+                                for (const mu of missingUnits.slice(0, 5))
+                                    logger_1.logger.warn(`      📌 ${mu}`);
+                                if (missingUnits.length > 5)
+                                    logger_1.logger.warn(`      ... 还有 ${missingUnits.length - 5} 个`);
+                                logger_1.logger.warn(`   💡 建议检查：这些功能点是否已合并到其他任务中？`);
+                                logger_1.logger.warn(`   💡 如确需补充，重新执行 split 并告诉 AI："补充以下功能点: ${missingUnits.slice(0, 3).join(', ')}"`);
+                            }
+                        }
+                    }
+                    catch { }
+                }
                 // 检测已有任务 + 冲突处理
                 const existingTasks = await detectExistingTasks(iterDirFull);
                 if (existingTasks.length > 0 && !options.force) {
@@ -1029,9 +1093,50 @@ function filterTemplateNoise(sections) {
         return true;
     });
 }
+// v8.3.4+: 从迭代目录路径提取迭代名（如 Iteration-011-meeting-upgrade → 011-meeting-upgrade）
+function extractIterationName(iterationDir) {
+    const base = iterationDir.split('/').pop() || '';
+    return base.replace(/^Iteration-/, '');
+}
+/** 生成带实际配置值的 git-config 内容 */
+function buildGitConfigContent(config, platformLabel, taskType) {
+    const branchType = taskType === 'bugfix' ? 'bugfix' : taskType === 'refactor' ? 'refactor' : taskType === 'research' ? 'research' : 'feature';
+    const exampleName = 'example-task';
+    const exampleHash = 'a1b2';
+    const prefix = config.branchPrefix ? `${config.branchPrefix}-` : '';
+    return `# 子任务级 Git 配置（${platformLabel}）
+# 以下配置覆盖迭代级 PROJECT_GRAPH.md，未配置项自动继承上一级。
+# 当前值已从迭代级/全局级配置自动填充，可直接使用或按需修改。
+
+# === 当前生效配置 ===
+源分支: ${config.defaultBranch}
+分支前缀: ${config.branchPrefix || '(空)'}
+分支格式: ${config.branchFormat}
+自动拉取: ${config.autoPull ? 'true' : 'false'}
+远程名称: ${config.remoteName}
+
+# === 保护分支（禁止直接推送）===
+${config.protectedBranches.map(b => `- ${b}`).join('\n')}
+
+# === 分支命名示例 ===
+# 当前任务类型: ${branchType}
+# 命名格式: ${config.branchFormat}
+# 示例分支: ${branchType}/${prefix}${exampleName}-${exampleHash}
+# （{hash4} 为自动生成的 4 位随机字符）
+
+# === 自定义配置区 ===
+# 如需覆盖上述值，取消下方注释并修改：
+# 源分支: ${config.defaultBranch}
+# 分支前缀: 
+# 分支格式: {type}/{prefix}{name}-{hash4}
+# 自动拉取: false
+# 远程名称: origin
+`;
+}
 async function createTaskFromSection(iterationDir, taskId, section, allPlatforms, taskType = 'feature', allSections) {
     // taskId 已含 slug（nextTaskId 返回 Task-NNN-slug），直接用
     const taskDir = (0, path_1.join)(iterationDir, '030-tasks', taskType, taskId);
+    const iterationName = extractIterationName(iterationDir);
     // 确定任务涉及的端：优先使用 AI 标注的 _scopePlatforms，否则从 020-specs/{端}/TECH.md 是否存在且有内容来推断
     let taskPlatforms;
     if (section._scopePlatforms && section._scopePlatforms.length > 0) {
@@ -1364,17 +1469,9 @@ ${section.content}
             // src/ + tests/ 目录（AI 执行时代码输出位置）
             await (0, fs_extra_1.ensureDir)((0, path_1.join)(subtaskDir, 'src'));
             await (0, fs_extra_1.ensureDir)((0, path_1.join)(subtaskDir, 'tests'));
-            // git-config
-            await (0, fs_extra_1.writeFile)((0, path_1.join)(subtaskDir, '.meta', 'git-config'), `# 子任务级 Git 配置（${platformLabel}）
-# 以下配置覆盖迭代级 PROJECT_GRAPH.md，未配置项自动继承上一级。
-# 修改时去掉注释符 #，填入具体值即可。
-
-# 源分支: 继承迭代配置
-# 分支前缀: 继承迭代配置
-# 分支格式: 继承迭代配置
-# 自动拉取: 继承迭代配置
-# 远程名称: 继承迭代配置
-`);
+            // v8.3.4+: git-config 自动填充 — 读取迭代级/全局级实际配置值写入
+            const gitConfig = (0, git_integration_1.loadGitConfig)(iterationName);
+            await (0, fs_extra_1.writeFile)((0, path_1.join)(subtaskDir, '.meta', 'git-config'), buildGitConfigContent(gitConfig, platformLabel, section.type));
             // v6.70.0+: 从 section 提取接口/页面清单用于 TASK.md
             const apiLines = section.content.split('\n').filter(l => l.includes('| GET') || l.includes('| POST') || l.includes('| PUT') || l.includes('| DELETE') || l.includes('| PATCH'));
             const apiList = apiLines.length > 0
@@ -1536,9 +1633,9 @@ ${isBk ? apiList : pageList}
         // 功能单元标识（v6.49.2+）
         const featureName = section.functionalUnit || section.name || '未分类';
         await (0, fs_extra_1.writeFile)((0, path_1.join)(autoSubtaskDir, '.meta', 'feature'), featureName);
-        await (0, fs_extra_1.writeFile)((0, path_1.join)(autoSubtaskDir, '.meta', 'git-config'), `# 子任务级 Git 配置（后端）
-# 以下配置覆盖迭代级 PROJECT_GRAPH.md，未配置项自动继承上一级。
-`);
+        // v8.3.4+: git-config 自动填充
+        const gitConfig = (0, git_integration_1.loadGitConfig)(iterationName);
+        await (0, fs_extra_1.writeFile)((0, path_1.join)(autoSubtaskDir, '.meta', 'git-config'), buildGitConfigContent(gitConfig, '后端', section.type));
         await (0, fs_extra_1.writeFile)((0, path_1.join)(autoSubtaskDir, 'TASK.md'), `# ${section.name} — ${fallbackBackend}（自动补充）
 
 ## 子任务信息
@@ -2261,7 +2358,8 @@ async function loadSpecContents(iterationDir) {
     }
     // 2. 读取各端子目录文档（如 admin/TECH.md、h5/TECH.md 等）
     const entries = await (0, fs_extra_1.readdir)(specDir, { withFileTypes: true });
-    const knownNonPlatformDirs = new Set(['sources', 'assets', 'prototypes', 'converted', 'features', 'bugs', 'refactors', 'research', 'staging', 'platforms', 'snapshots', spec_paths_1.GLOBAL_SPECS_DIR]);
+    // v8.3.4+: 增加 overview 过滤，防止 analyze 全局文档目录被误当成端目录
+    const knownNonPlatformDirs = new Set(['sources', 'assets', 'prototypes', 'converted', 'features', 'bugs', 'refactors', 'research', 'staging', 'platforms', 'snapshots', 'overview', 'global', spec_paths_1.GLOBAL_SPECS_DIR]);
     for (const e of entries) {
         if (e.isDirectory() && !e.name.startsWith('_') && !e.name.startsWith('.') && !knownNonPlatformDirs.has(e.name)) {
             const platform = e.name;
@@ -2710,6 +2808,12 @@ async function buildSplitPrompt(iteration, constitutionContent, reqContent, spec
     p += `> 同一模块/领域的任务填相同的值，用于粒度校验和任务分组\n`;
     p += `> **topic** 必须是英文短横线格式（如 \`user-authentication\`、\`product-crud\`），用于生成任务目录名 Task-NNN-{topic}\n`;
     p += `> **sourceFile** 必须填写：该任务对应的 020-specs 源文档路径（如 \`bugs/login-timeout.md\`、\`features/user-auth.md\`、\`refactors/db-pool.md\`），用于在 CONTEXT.md 中生成来源追溯\n`;
+    p += `> **scope 强制约束（违反则拆分无效）**：\n`;
+    p += `>   - scope 数组中的每个值必须是上面「项目端列表」中的标准端名之一\n`;
+    p += `>   - ⛔ 禁止出现 api、web、backend、frontend、server、admin、h5、mobile、pc、app 等非标准名称\n`;
+    p += `>   - ⛔ 禁止出现中文端名（如"后端"、"前端"、"移动端"）\n`;
+    p += `>   - 每个任务按 scope 中的端创建子任务目录，目录名 = 标准端名\n`;
+    p += `>   - 如果 scope 含非标准端名，整个 JSON 视为不合格，必须重新生成\n`;
     p += `> **reqContent 质量要求（必填，禁止模板化）**：\n`;
     p += `>   - 必须是**具体的、可执行的需求描述**，不是"待补充"或"参考全局文档"\n`;
     p += `>   - 包含：业务规则（含边界条件）、数据模型（字段/类型/约束）、接口清单（方法/路径/参数/响应）\n`;
@@ -2721,6 +2825,13 @@ async function buildSplitPrompt(iteration, constitutionContent, reqContent, spec
     p += `>   - 从 020-specs/overview/TECH.md 和对应端 TECH.md 中提取本任务相关的技术细节\n`;
     p += `>   - 直接写入 00-specs/TECH.md，执行时 AI 据此直接开发\n`;
     p += `> **质量红线**：如果 reqContent/techContent 只有标题和占位符（如 "<!-- AI-FILL -->"），视为不合格，必须重新生成\n\n`;
+    // v8.3.4+: 强制约束专节（类似 analyze Phase 2）
+    p += `### ⛔ 强制约束（违反则拆分无效）\n\n`;
+    p += `- **禁止跳过任何功能模块** — 即使某个模块信息不足，也必须基于已有信息拆分并填充 reqContent/techContent，标注「基于现有信息推断」而非留空\n`;
+    p += `- **禁止输出空内容** — reqContent、techContent、devGuideContent 每个字段长度必须 ≥200 字符，不允许写「待补充」「TODO」「参考全局文档」\n`;
+    p += `- **禁止省略字段** — JSON 中必须包含 reqContent、techContent、devGuideContent 三个字段，缺一不可\n`;
+    p += `- **内容必须从 analyze 产物提取** — reqContent 从 REQUIREMENT.md 提取，techContent 从 TECH.md 提取，devGuideContent 从 DEV_GUIDE.md 提取\n`;
+    p += `- **如果 token 不足**：优先保证 reqContent 完整，其次是 techContent，最后是 devGuideContent\n\n`;
     p += `### ⚠️ 拆分规则（重要）\n\n`;
     p += `- **按功能单元拆分，不按技术层拆分**：每个任务必须对应一个业务功能（如「预订管理」「签到」「审批」），不要按技术层分组（如「后端改进」「前端修复」）\n`;
     p += `- ❌ 错误示例：Task-129-backend-improve、Task-130-admin-fix（按技术层分组）\n`;
@@ -2754,7 +2865,7 @@ async function buildSplitPrompt(iteration, constitutionContent, reqContent, spec
 - 你的判断
 - 建议后续动作\`
 `;
-    p += `3. **遇阻断就跳过** — 如果某个功能模块信息不足无法拆分，跳过它并在疑问清单中记录\n`;
+    p += `3. **禁止跳过任何模块** — 即使某个功能模块信息不足，也必须基于已有信息拆分并填充内容，宁可标注「基于现有信息推断：需要补充 xxx」也不许留空或省略\n`;
     p += `4. **输出 JSON** — 直接输出拆分结果的 JSON 数组，不要输出其他内容\n`;
     // 持久指令（用户调整时 AI 可回读此文件）
     p += `\n## 🔄 调整指令（持久有效）\n\n`;