speccore 8.3.219 → 8.3.221

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":"AAwKA,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;AA+ID,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2pCzF"}
+{"version":3,"file":"split.d.ts","sourceRoot":"","sources":["../../../src/commands/iteration/split.ts"],"names":[],"mappings":"AAwKA,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;AAmKD,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2pCzF"}

package/dist/commands/iteration/split.js

@@ -198,7 +198,9 @@ async function detectPlatforms(iterationDir, specified) {
 async function preSplitGate(iterationDir) {
     const items = [];
     const specDir = (0, path_1.join)(iterationDir, '020-specs');
-    // 检查全局 FUNCTION_MAP.md（阻塞级）
+    // 检查全局 FUNCTION_MAP.md（警告级）
+    // v8.3.220+: 降级为 warn——功能单元的权威来源是 010-requirements/features/ 目录（doc2spec --split 产出），
+    // FUNCTION_MAP 仅作「功能×端映射」参考。split 的 prompt 构建已有多级回退（FUNCTION_MAP → ANALYSIS.md → features/）。
     const funcMapPath = (0, path_1.join)(specDir, spec_paths_1.GLOBAL_SPECS_DIR, 'FUNCTION_MAP.md');
     const funcMapExists = await (0, fs_extra_1.pathExists)(funcMapPath);
     let funcMapIsSkeleton = false;
@@ -209,13 +211,13 @@ async function preSplitGate(iterationDir) {
     items.push({
         path: funcMapPath,
         name: 'FUNCTION_MAP.md',
-        purpose: '列出本迭代所有功能模块及涉及端，是 split 拆分的唯一依据',
-        impact: '缺失或不完整时，split 不知道要拆哪些任务，可能拆出不完整或错误的任务',
+        purpose: '功能单元×端映射参考（权威来源为 010-requirements/features/ 目录）',
+        impact: '缺失或不完整时仅作提示，split 以 features/ 目录为准拆分，不影响任务生成',
         exists: funcMapExists,
         isSkeleton: funcMapIsSkeleton,
-        level: 'block',
+        level: 'warn',
     });
-    // 检查全局 REQUIREMENT.md（警告级）
+    // 检查全局 REQUIREMENT.md（阻塞级——taskify 的核心需求上下文，骨架则无法拆分）
     const reqPath = (0, path_1.join)(specDir, spec_paths_1.GLOBAL_SPECS_DIR, 'REQUIREMENT.md');
     const reqExists = await (0, fs_extra_1.pathExists)(reqPath);
     let reqIsSkeleton = false;
@@ -226,11 +228,28 @@ async function preSplitGate(iterationDir) {
     items.push({
         path: reqPath,
         name: 'REQUIREMENT.md',
-        purpose: '本迭代的完整需求规格，包含功能模块清单和验收标准',
-        impact: '缺失时，AI 拆分缺少需求上下文，可能遗漏功能点或拆分粒度过粗',
+        purpose: '本迭代的完整需求规格，包含功能模块清单和验收标准（taskify 拆分任务的核心依据）',
+        impact: '缺失或仍为骨架时，AI 拆分缺少需求上下文，会拆出无意义任务（如把「写作要求」当功能模块）',
         exists: reqExists,
         isSkeleton: reqIsSkeleton,
-        level: 'warn',
+        level: 'block',
+    });
+    // v8.3.221+: 检查全局 ANALYSIS.md（阻塞级——功能分析，骨架说明 analyze 未落盘）
+    const analysisGatePath = (0, path_1.join)(specDir, spec_paths_1.GLOBAL_SPECS_DIR, 'ANALYSIS.md');
+    const analysisGateExists = await (0, fs_extra_1.pathExists)(analysisGatePath);
+    let analysisGateIsSkeleton = false;
+    if (analysisGateExists) {
+        const ac = await (0, fs_extra_1.readFile)(analysisGatePath, 'utf-8');
+        analysisGateIsSkeleton = ac.includes('<!-- SPEC-SKELETON -->') || ac.trim().length < 100;
+    }
+    items.push({
+        path: analysisGatePath,
+        name: 'ANALYSIS.md',
+        purpose: '需求功能分析（功能点清单 F-xx），taskify 拆分任务的输入之一',
+        impact: '仍为骨架说明 analyze 阶段未落盘，拆分会遗漏功能点',
+        exists: analysisGateExists,
+        isSkeleton: analysisGateIsSkeleton,
+        level: 'block',
     });
     // 检查功能模块级文档（警告级）
     const features = await (0, spec_paths_1.parseFeatureList)(iterationDir);
@@ -2242,7 +2261,7 @@ ${relatedTasks.length > 0 ? relatedTasks.join('\n') : '> 暂无关联任务（sp
 
 ## 跨端关联
 
-> 来自 FUNCTION_MAP.md
+> 来自 FUNCTION_MAP.md（功能×端映射参考）
 
 | 属性 | 值 |
 |:---|:---|
@@ -3256,7 +3275,7 @@ subagent, contextType) {
     p += `4. \`020-specs/overview/REQUIREMENT.md\` — 黄金需求文档\n`;
     p += `5. \`020-specs/overview/TECH.md\` — 全局技术方案\n`;
     p += `6. \`020-specs/overview/ANALYSIS.md\` — 功能分析\n`;
-    p += `7. \`020-specs/overview/FUNCTION_MAP.md\` — 功能单元与端的映射（拆分核心依据）\n`;
+    p += `7. \`020-specs/overview/FUNCTION_MAP.md\` — 功能单元与端的映射（参考，权威来源为 010-requirements/features/ 目录）\n`;
     if (await (0, fs_extra_1.pathExists)((0, path_1.join)(iterationDir || '', '020-specs', 'overview', 'INTERACTION_MAP.md'))) {
         p += `8. \`020-specs/overview/INTERACTION_MAP.md\` — 跨端交互时序\n`;
     }
@@ -3271,7 +3290,7 @@ subagent, contextType) {
     }
     p += `\n`;
     p += `> 📖 **读取策略**：\n`;
-    p += `> - 先 Read FUNCTION_MAP.md 了解功能单元划分和涉及端\n`;
+    p += `> - 先 Read 010-requirements/features/ 目录了解功能单元划分（权威来源），FUNCTION_MAP.md 作功能×端映射参考\n`;
     p += `> - 按功能单元逐个处理，每次只 Read 当前单元相关的文档\n`;
     p += `> - reqContent 从 REQUIREMENT.md 和对应功能模块的需求文档提取\n`;
     p += `> - techContent 从 TECH.md 和对应功能模块的技术规格提取\n`;
@@ -3313,9 +3332,9 @@ subagent, contextType) {
                     funcUnitsInjected = true;
                 }
             }
-            // v7.5.0+: FUNCTION_MAP.md 不存在时，从 ANALYSIS.md 提取功能单元清单
+            // v7.5.0+: FUNCTION_MAP.md 不存在或为空时，从 ANALYSIS.md 提取功能单元清单
             if (!funcUnitsInjected) {
-                const analysisPath = (0, path_1.join)(iterationDir, '020-specs', 'ANALYSIS.md');
+                const analysisPath = (0, path_1.join)(iterationDir, '020-specs', spec_paths_1.GLOBAL_SPECS_DIR, 'ANALYSIS.md');
                 if (await (0, fs_extra_1.pathExists)(analysisPath)) {
                     const analysisContent = await (0, fs_extra_1.readFile)(analysisPath, 'utf-8');
                     const analysisUnits = parseAnalysisFunctionalUnits(analysisContent, standardPlatforms);
@@ -3335,6 +3354,24 @@ subagent, contextType) {
                         p += `- 不允许将不同端的功能单元合并到同一个任务\n\n`;
                     }
                 }
+                // v8.3.220+: FUNCTION_MAP 和 ANALYSIS 都为空/骨架时，回退到 features/ 目录（功能单元权威来源）
+                if (!funcUnitsInjected) {
+                    const featureDirs = await (0, spec_paths_1.parseFeatureList)(iterationDir);
+                    if (featureDirs.length > 0) {
+                        p += `## 🧩 功能单元清单（CLI 从 010-requirements/features/ 目录提取，v8.3.220+）\n\n`;
+                        p += `> 以下是从 features/ 目录读取的 **全部功能单元**（权威来源）。\n`;
+                        p += `> ⚠️ **你必须为每个功能单元创建至少 1 个任务，不允许遗漏任何功能单元。**\n\n`;
+                        p += `| 功能单元 |\n`;
+                        p += `|:---|\n`;
+                        for (const fn of featureDirs) {
+                            p += `| ${fn} |\n`;
+                        }
+                        p += `\n**拆分要求**：\n`;
+                        p += `- 每个功能单元必须在某个任务的 \`functionalUnit\` 字段中被引用\n`;
+                        p += `- 涉及端从 CONSTITUTION.md 端列表判断，或从 features/{单元}/.meta/source 读取\n\n`;
+                        funcUnitsInjected = true;
+                    }
+                }
             }
         }
         catch { }
@@ -4249,7 +4286,7 @@ async function tryModuleDrivenSplit(iteration, iterationDir, options) {
         }
         // 2.5 v7.5.0+: 回退：从 ANALYSIS.md 提取功能单元清单（按端分节的 F-xx 表格）
         if (!modulePlatformsParsed) {
-            const analysisPath = (0, path_1.join)(iterationDir, '020-specs', 'ANALYSIS.md');
+            const analysisPath = (0, path_1.join)(iterationDir, '020-specs', spec_paths_1.GLOBAL_SPECS_DIR, 'ANALYSIS.md');
             if (await (0, fs_extra_1.pathExists)(analysisPath)) {
                 try {
                     const content = await (0, fs_extra_1.readFile)(analysisPath, 'utf-8');