speccore 8.3.20 → 8.3.21

package/dist/commands/iteration/split.js

@@ -164,35 +164,10 @@ async function detectPlatforms(iterationDir, specified) {
     const platforms = await (0, spec_paths_1.parsePlatformList)();
     if (platforms.length > 0)
         return platforms;
-    // 2. 回退：扫描 020-specs/ 子目录（仅旧结构下有效）
-    // v8.3.17+: 新结构下 020-specs/ 子目录是功能模块名，不能当成端名扫描
+    // v8.3.21+: 020-specs/ 按功能模块组织，不再扫描子目录猜测端名
     const specsDir = (0, path_1.join)(iterationDir, '020-specs');
     if (await (0, fs_extra_1.pathExists)(specsDir)) {
-        const isLegacy = await (0, spec_paths_1.isLegacySpecDir)(specsDir);
-        if (isLegacy) {
-            // 旧结构：子目录是端名，可以扫描
-            const entries = await (0, fs_extra_1.readdir)(specsDir, { withFileTypes: true });
-            // 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);
-            // 二次过滤：用 normalizeScopePlatforms 排除任何残留的非标准端名
-            if (rawPlatforms.length > 0) {
-                const standardPlatforms = await (0, spec_paths_1.parsePlatformList)();
-                if (standardPlatforms.length > 0) {
-                    return normalizeScopePlatforms(rawPlatforms, standardPlatforms);
-                }
-                return rawPlatforms;
-            }
-        }
-        // 新结构：跳过扫描，提示用户配置端列表
-        logger_1.logger.warn(`⚠️ CONSTITUTION.md 中未找到「端列表」，且 020-specs/ 为新结构（按功能模块组织）`);
+        logger_1.logger.warn(`⚠️ CONSTITUTION.md 中未找到「端列表」`);
         logger_1.logger.warn(`   请先在 CONSTITUTION.md 中配置端列表，否则无法正确拆分任务`);
     }
     return ['web']; // 默认
@@ -234,28 +209,25 @@ async function preSplitGate(iterationDir) {
         isSkeleton: reqIsSkeleton,
         level: 'warn',
     });
-    // 检查功能模块级文档（警告级，仅新结构下）
-    const isLegacy = await (0, spec_paths_1.isLegacySpecDir)(specDir);
-    if (!isLegacy) {
-        const features = await (0, spec_paths_1.parseFeatureList)(iterationDir);
-        for (const feature of features) {
-            const featureReqPath = (0, path_1.join)(specDir, feature, 'overview', 'REQUIREMENT.md');
-            const featureReqExists = await (0, fs_extra_1.pathExists)(featureReqPath);
-            let featureReqIsSkeleton = false;
-            if (featureReqExists) {
-                const content = await (0, fs_extra_1.readFile)(featureReqPath, 'utf-8');
-                featureReqIsSkeleton = content.includes('<!-- SPEC-SKELETON -->') || content.trim().length < 100;
-            }
-            items.push({
-                path: featureReqPath,
-                name: `${feature}/overview/REQUIREMENT.md`,
-                purpose: `功能模块「${feature}」的完整需求（合并各端视角）`,
-                impact: `缺失时，execute 阶段 AI 读不到「${feature}」的详细需求，可能实现不完整`,
-                exists: featureReqExists,
-                isSkeleton: featureReqIsSkeleton,
-                level: 'warn',
-            });
-        }
+    // 检查功能模块级文档（警告级）
+    const features = await (0, spec_paths_1.parseFeatureList)(iterationDir);
+    for (const feature of features) {
+        const featureReqPath = (0, path_1.join)(specDir, feature, 'overview', 'REQUIREMENT.md');
+        const featureReqExists = await (0, fs_extra_1.pathExists)(featureReqPath);
+        let featureReqIsSkeleton = false;
+        if (featureReqExists) {
+            const content = await (0, fs_extra_1.readFile)(featureReqPath, 'utf-8');
+            featureReqIsSkeleton = content.includes('<!-- SPEC-SKELETON -->') || content.trim().length < 100;
+        }
+        items.push({
+            path: featureReqPath,
+            name: `${feature}/overview/REQUIREMENT.md`,
+            purpose: `功能模块「${feature}」的完整需求（合并各端视角）`,
+            impact: `缺失时，execute 阶段 AI 读不到「${feature}」的详细需求，可能实现不完整`,
+            exists: featureReqExists,
+            isSkeleton: featureReqIsSkeleton,
+            level: 'warn',
+        });
     }
     const blockers = items.filter(i => i.level === 'block' && (!i.exists || i.isSkeleton));
     const warnings = items.filter(i => i.level === 'warn' && (!i.exists || i.isSkeleton));
@@ -814,77 +786,46 @@ async function iterationSplitCommand(options) {
             }
             // 读取 020-specs/ 全部文件（完整上下文）
             const specDir2 = (0, path_1.join)(iterationDir, '020-specs');
-            // REQUIREMENT.md 优先从 global/ 读取（v6.41.0+），回退根目录
-            const reqPath2 = await (0, spec_paths_1.resolveGlobalSpecPath)(specDir2, 'REQUIREMENT.md') || (0, path_1.join)(iterationDir, '020-specs', 'REQUIREMENT.md');
+            // REQUIREMENT.md 从 overview/ 读取
+            const reqPath2 = (0, path_1.join)(specDir2, spec_paths_1.GLOBAL_SPECS_DIR, 'REQUIREMENT.md');
             let reqContent2 = '';
             if (await (0, fs_extra_1.pathExists)(reqPath2)) {
                 reqContent2 = await (0, fs_extra_1.readFile)(reqPath2, 'utf-8');
             }
             const specContents = [];
-            // 读取全局层文档（优先 global/ 子目录，回退根目录 — v6.41.0+ 向后兼容）
-            for (const f of ['ANALYSIS.md', 'TECH.md', 'RISK.md', 'DEPS.md', 'REVIEW.md', 'MONITOR.md', 'REQUIREMENT.md']) {
-                const resolved = await (0, spec_paths_1.resolveGlobalSpecPath)(specDir2, f);
-                if (resolved) {
-                    const content = await (0, fs_extra_1.readFile)(resolved, 'utf-8');
-                    if (content.trim().length > 50 && !content.trim().match(/^#+\s*待填充|^<!--\s*AI-FILL/m)) {
-                        specContents.push({ name: f, content });
-                    }
-                }
-            }
-            // 根目录下的 TEST.md、UI_SPEC.md（端无关模板/回退）
-            for (const f of ['TEST.md', 'UI_SPEC.md']) {
-                const fp = (0, path_1.join)(specDir2, f);
-                if (await (0, fs_extra_1.pathExists)(fp)) {
+            // v8.3.21+: 读取全局层文档（overview/ 下）
+            const overviewDir = (0, path_1.join)(specDir2, spec_paths_1.GLOBAL_SPECS_DIR);
+            if (await (0, fs_extra_1.pathExists)(overviewDir)) {
+                const overviewFiles = await (0, fs_extra_1.readdir)(overviewDir, { withFileTypes: true });
+                for (const f of overviewFiles) {
+                    if (!f.name.endsWith('.md'))
+                        continue;
+                    const fp = (0, path_1.join)(overviewDir, f.name);
                     const content = await (0, fs_extra_1.readFile)(fp, 'utf-8');
                     if (content.trim().length > 50 && !content.trim().match(/^#+\s*待填充|^<!--\s*AI-FILL/m)) {
-                        specContents.push({ name: f, content });
-                    }
-                }
-            }
-            // 读取各端详情（020-specs/{端}/，兼容旧路径 020-specs/platforms/{端}/）
-            const platformDirs = [];
-            // 新路径：020-specs/{端}/
-            const directPlatformEntries = await (0, fs_extra_1.readdir)(specDir2, { withFileTypes: true });
-            for (const e of directPlatformEntries) {
-                if (e.isDirectory() && !e.name.startsWith('_') && !e.name.startsWith('.')
-                    && !['sources', 'assets', 'prototypes', 'converted', 'features', 'bugs', 'refactors', 'research', 'staging', 'platforms', 'snapshots', spec_paths_1.GLOBAL_SPECS_DIR].includes(e.name)) {
-                    platformDirs.push(e.name);
-                }
-            }
-            // 旧路径回退：020-specs/platforms/{端}/
-            const iterPlatformsDir = (0, path_1.join)(specDir2, 'platforms');
-            if (await (0, fs_extra_1.pathExists)(iterPlatformsDir)) {
-                const platformEntries = await (0, fs_extra_1.readdir)(iterPlatformsDir, { withFileTypes: true });
-                for (const pe of platformEntries) {
-                    if (pe.isDirectory() && !pe.name.startsWith('.') && !platformDirs.includes(pe.name)) {
-                        platformDirs.push(pe.name);
+                        specContents.push({ name: f.name, content });
                     }
                 }
             }
-            // 读取每个端目录下的文件
-            for (const pName of platformDirs) {
-                const pDir = (0, path_1.join)(specDir2, pName);
-                if (!(await (0, fs_extra_1.pathExists)(pDir)))
+            // v8.3.21+: 读取各功能模块下的文档（overview/ + 各端/）
+            const features = await (0, spec_paths_1.parseFeatureList)(iterationDir);
+            for (const feature of features) {
+                const featureDir = (0, path_1.join)(specDir2, feature);
+                if (!await (0, fs_extra_1.pathExists)(featureDir))
                     continue;
-                const pFiles = await (0, fs_extra_1.readdir)(pDir);
-                for (const pf of pFiles.filter((f) => f.endsWith('.md'))) {
-                    const fp = (0, path_1.join)(pDir, pf);
-                    const content = await (0, fs_extra_1.readFile)(fp, 'utf-8');
-                    if (content.trim().length > 50 && !content.trim().match(/^#+\s*\u5f85\u586b\u5145|^<!--\s*AI-FILL/m)) {
-                        specContents.push({ name: `${pName}/${pf}`, content });
-                    }
-                }
-            }
-            // 读取功能模块分析（020-specs/features/）
-            const iterFeaturesDir = (0, path_1.join)(specDir2, 'features');
-            if (await (0, fs_extra_1.pathExists)(iterFeaturesDir)) {
-                const featureEntries = await (0, fs_extra_1.readdir)(iterFeaturesDir, { withFileTypes: true });
-                for (const fe of featureEntries) {
-                    if (!fe.name.startsWith('.') && fe.name.endsWith('.md')) {
-                        const fp = (0, path_1.join)(iterFeaturesDir, fe.name);
+                const entries = await (0, fs_extra_1.readdir)(featureDir, { withFileTypes: true });
+                for (const entry of entries) {
+                    if (!entry.isDirectory() || entry.name.startsWith('.'))
+                        continue;
+                    const subDir = (0, path_1.join)(featureDir, entry.name);
+                    const subFiles = await (0, fs_extra_1.readdir)(subDir, { withFileTypes: true });
+                    for (const sf of subFiles) {
+                        if (!sf.name.endsWith('.md'))
+                            continue;
+                        const fp = (0, path_1.join)(subDir, sf.name);
                         const content = await (0, fs_extra_1.readFile)(fp, 'utf-8');
-                        if (content.trim().length > 50 && !content.trim().match(/^#+\s*\u5f85\u586b\u5145|^<!--\s*AI-FILL/m)) {
-                            specContents.push({ name: `features/${fe.name}`, content });
+                        if (content.trim().length > 50 && !content.trim().match(/^#+\s*待填充|^<!--\s*AI-FILL/m)) {
+                            specContents.push({ name: `${feature}/${entry.name}/${sf.name}`, content });
                         }
                     }
                 }
@@ -900,7 +841,7 @@ async function iterationSplitCommand(options) {
                         continue;
                     const fp = (0, path_1.join)(typeDirPath, te.name);
                     const content = await (0, fs_extra_1.readFile)(fp, 'utf-8');
-                    if (content.trim().length > 50 && !content.trim().match(/^#+\s*\u5f85\u586b\u5145|^<!--\s*AI-FILL/m)) {
+                    if (content.trim().length > 50 && !content.trim().match(/^#+\s*待填充|^<!--\s*AI-FILL/m)) {
                         specContents.push({ name: `${typeDir}/${te.name}`, content });
                     }
                 }
@@ -2506,44 +2447,39 @@ async function loadSpecContents(iterationDir) {
     const specDir = (0, path_1.join)(iterationDir, '020-specs');
     if (!(await (0, fs_extra_1.pathExists)(specDir)))
         return specs;
-    // 1. 读取全局文档（优先 global/ 子目录，回退根目录 — v6.41.0+ 向后兼容）
-    // v8.3.0+: 新增 DEV_GUIDE.md — analyze 生成的开发指南是 split 填充任务级文档的关键输入
-    for (const f of ['REQUIREMENT.md', 'ANALYSIS.md', 'TECH.md', 'DEV_GUIDE.md', 'RISK.md', 'DEPS.md', 'REVIEW.md', 'MONITOR.md']) {
-        const resolved = await (0, spec_paths_1.resolveGlobalSpecPath)(specDir, f);
-        if (resolved) {
-            const content = await (0, fs_extra_1.readFile)(resolved, 'utf-8');
-            if (content.trim().length > 50 && !content.trim().match(/^#+\s*待填充|^<!--\s*AI-FILL/m)) {
-                specs[f] = content;
-            }
-        }
-    }
-    // 根目录下的 TEST.md、UI_SPEC.md（端无关模板/回退）
-    for (const f of ['TEST.md', 'UI_SPEC.md']) {
-        const fp = (0, path_1.join)(specDir, f);
-        if (await (0, fs_extra_1.pathExists)(fp)) {
+    // v8.3.21+: 读取全局文档（overview/ 下）
+    const overviewDir = (0, path_1.join)(specDir, spec_paths_1.GLOBAL_SPECS_DIR);
+    if (await (0, fs_extra_1.pathExists)(overviewDir)) {
+        const overviewFiles = await (0, fs_extra_1.readdir)(overviewDir, { withFileTypes: true });
+        for (const f of overviewFiles) {
+            if (!f.name.endsWith('.md'))
+                continue;
+            const fp = (0, path_1.join)(overviewDir, f.name);
             const content = await (0, fs_extra_1.readFile)(fp, 'utf-8');
             if (content.trim().length > 50 && !content.trim().match(/^#+\s*待填充|^<!--\s*AI-FILL/m)) {
-                specs[f] = content;
+                specs[f.name] = content;
             }
         }
     }
-    // 2. 读取各端子目录文档（如 admin/TECH.md、h5/TECH.md 等）
-    const entries = await (0, fs_extra_1.readdir)(specDir, { withFileTypes: true });
-    // 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;
-            const platformDir = (0, path_1.join)(specDir, platform);
-            // 读取该端下的 TECH.md、TEST.md、UI_SPEC.md、DEV_GUIDE.md
-            for (const f of ['TECH.md', 'TEST.md', 'UI_SPEC.md', 'DEV_GUIDE.md']) {
-                const fp = (0, path_1.join)(platformDir, f);
-                if (await (0, fs_extra_1.pathExists)(fp)) {
-                    const content = await (0, fs_extra_1.readFile)(fp, 'utf-8');
-                    if (content.trim().length > 50 && !content.trim().match(/^#+\s*待填充|^<!--\s*AI-FILL/m)) {
-                        // 用平台前缀区分：admin/TECH.md → 'admin/TECH.md'
-                        specs[`${platform}/${f}`] = content;
-                    }
+    // v8.3.21+: 读取各功能模块下的文档
+    const features = await (0, spec_paths_1.parseFeatureList)(iterationDir);
+    for (const feature of features) {
+        const featureDir = (0, path_1.join)(specDir, feature);
+        if (!await (0, fs_extra_1.pathExists)(featureDir))
+            continue;
+        const entries = await (0, fs_extra_1.readdir)(featureDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory() || entry.name.startsWith('.'))
+                continue;
+            const subDir = (0, path_1.join)(featureDir, entry.name);
+            const subFiles = await (0, fs_extra_1.readdir)(subDir, { withFileTypes: true });
+            for (const sf of subFiles) {
+                if (!sf.name.endsWith('.md'))
+                    continue;
+                const fp = (0, path_1.join)(subDir, sf.name);
+                const content = await (0, fs_extra_1.readFile)(fp, 'utf-8');
+                if (content.trim().length > 50 && !content.trim().match(/^#+\s*待填充|^<!--\s*AI-FILL/m)) {
+                    specs[`${feature}/${entry.name}/${sf.name}`] = content;
                 }
             }
         }