speccore 6.40.1 → 6.41.0

package/dist/core/analyze-engine.js

@@ -30,6 +30,7 @@ const git_integration_1 = require("./git-integration");
 const rag_engine_1 = require("./rag-engine");
 const knowledge_graph_1 = require("./knowledge-graph");
 const quality_audit_1 = require("./quality-audit");
+const spec_paths_1 = require("./spec-paths");
 // ================================================================
 // 主入口
 // ================================================================
@@ -1172,7 +1173,7 @@ async function writePerPlatform(iterDir, report, filename) {
             .map(e => e.name);
         if (features.length === 0)
             return;
-        // 平台列表从 CONSTITUTION 获取，默认四端
+        // 平台列表从 CONSTITUTION 获取（不再硬编码默认值）
         const platforms = await detectPlatformsFromConstitution();
         for (const platform of platforms) {
             const platformDir = (0, path_1.join)(specsBase, platform);
@@ -1626,14 +1627,65 @@ async function supplementAnalysis(input) {
 }
 /** 已检测到的后端平台列表（从 CONSTITUTION.md 解析） */
 let _detectedBackendPlatforms = [];
-/** 从 CONSTITUTION.md 提取平台列表（支持中文端名 + 工程名映射） */
+/** 从 CONSTITUTION.md 动态提取的端名映射（技术栈标题解析） */
+let _dynamicPlatformAliases = {};
+/**
+ * 从 CONSTITUTION.md 技术栈章节标题提取端名信息。
+ * 匹配模式: ### 中文端名 (English Name)
+ * 例如: ### 后台管理端 (Admin Dashboard) → { chinese: '后台管理端', english: 'Admin Dashboard' }
+ */
+function parseTechStackHeaders(content) {
+    const results = [];
+    const lines = content.split('\n');
+    for (const line of lines) {
+        // 匹配: ### 后台管理端 (Admin Dashboard) 或 ### H5 移动端 (Mobile H5)
+        const match = line.match(/^###\s+(.+?)\s*\(([^)]+)\)/);
+        if (match) {
+            results.push({
+                chinese: match[1].trim(),
+                english: match[2].trim(),
+                fullTitle: line.trim(),
+            });
+        }
+    }
+    return results;
+}
+/**
+ * 将技术栈标题解析结果合并到动态别名映射中。
+ * 这样 inferPlatformFromPathOrContent 也能使用 CONSTITUTION.md 定义的端名。
+ */
+function buildDynamicAliasesFromTechStack(techStackEntries) {
+    const aliases = {};
+    for (const entry of techStackEntries) {
+        const normalized = normalizeToStandardPlatform(entry.chinese) || normalizeToStandardPlatform(entry.english);
+        if (!normalized)
+            continue;
+        if (!aliases[normalized]) {
+            aliases[normalized] = [];
+        }
+        // 添加中文名、英文名、全标题作为别名
+        const newAliases = [entry.chinese, entry.english, entry.fullTitle];
+        for (const a of newAliases) {
+            const lower = a.toLowerCase();
+            if (!aliases[normalized].includes(lower)) {
+                aliases[normalized].push(lower);
+            }
+        }
+    }
+    return aliases;
+}
+/** 从 CONSTITUTION.md 提取平台列表（两层确定性匹配）
+ *  Layer 1: 表格「对应需求端」列（用户显式声明）
+ *  Layer 2: 技术栈章节标题 ### 中文端名 (English Name)
+ *  ⚠️ 不再提供硬编码默认值 — 端列表应由 AI 根据项目实际情况判断
+ */
 async function detectPlatformsFromConstitution() {
     try {
         const constitutionPath = (0, path_1.join)(process.cwd(), '.speccore', 'CONSTITUTION.md');
         if (require('fs').existsSync(constitutionPath)) {
             const content = require('fs').readFileSync(constitutionPath, 'utf-8');
             const lines = content.split('\n');
-            // 1. 先尝试从表头定位「对应需求端」和「工程名」列的索引
+            // ── Layer 1: 表格「对应需求端」列 ──
             let headerRowIndex = -1;
             let headerCells = [];
             for (let i = 0; i < lines.length; i++) {
@@ -1649,22 +1701,29 @@ async function detectPlatformsFromConstitution() {
                 const platforms = [];
                 const backendPlatforms = [];
                 const seen = new Set();
-                // 解析数据行（跳过头部和分隔线）
                 for (let i = headerRowIndex + 2; i < lines.length; i++) {
                     const line = lines[i].trim();
-                    if (!line.startsWith('|') || line.match(/^\|[\s:-]+/))
+                    // 分隔行跳过（如 | :--- | :--- |）
+                    if (line.match(/^\|[\s:-]+/))
+                        continue;
+                    // 空行跳过（表格内可能有空行）
+                    if (line === '')
                         continue;
+                    // 非表格行 → 当前表格结束，终止读取
+                    if (!line.startsWith('|'))
+                        break;
                     const cells = line.split('|').map((c) => c.trim()).filter(Boolean);
                     const projectName = cells[0] || '';
                     const platformChinese = cells[5] || cells[cells.length - 1] || '';
+                    // 跳过空值和占位符（如「待填写」）
                     if (!platformChinese || !projectName)
                         continue;
-                    // 归一化：中文端名 → 标准端名
+                    if (/待填写|待补充|TODO|TBD|N\/A/i.test(platformChinese))
+                        continue;
                     const normalized = normalizeToStandardPlatform(platformChinese);
                     if (normalized && !seen.has(normalized)) {
                         seen.add(normalized);
                         platforms.push(normalized);
-                        // 判断前后端：从工程名或中文端名推断
                         const isBackend = /service|server|api|backend|后台|服务|后端/i.test(projectName) ||
                             /后台|服务|后端/.test(platformChinese);
                         if (isBackend) {
@@ -1674,18 +1733,52 @@ async function detectPlatformsFromConstitution() {
                 }
                 if (platforms.length > 0) {
                     _detectedBackendPlatforms = backendPlatforms;
+                    // Layer 1 成功：也解析技术栈标题来构建动态别名
+                    const techStackEntries = parseTechStackHeaders(content);
+                    if (techStackEntries.length > 0) {
+                        _dynamicPlatformAliases = buildDynamicAliasesFromTechStack(techStackEntries);
+                    }
+                    return platforms;
+                }
+            }
+            // ── Layer 2: 技术栈章节标题 ### 中文端名 (English Name) ──
+            const techStackEntries = parseTechStackHeaders(content);
+            if (techStackEntries.length > 0) {
+                const platforms = [];
+                const backendPlatforms = [];
+                const seen = new Set();
+                for (const entry of techStackEntries) {
+                    const normalized = normalizeToStandardPlatform(entry.chinese) || normalizeToStandardPlatform(entry.english);
+                    if (!normalized || seen.has(normalized))
+                        continue;
+                    seen.add(normalized);
+                    platforms.push(normalized);
+                    // 判断前后端
+                    const isBackend = /service|server|api|backend|后台|服务|后端/i.test(entry.chinese + ' ' + entry.english);
+                    if (isBackend) {
+                        backendPlatforms.push(normalized);
+                    }
+                }
+                if (platforms.length > 0) {
+                    _detectedBackendPlatforms = backendPlatforms;
+                    _dynamicPlatformAliases = buildDynamicAliasesFromTechStack(techStackEntries);
+                    logger_1.logger.info(`   📋 从技术栈标题检测到 ${platforms.length} 个端: ${platforms.join(', ')}`);
                     return platforms;
                 }
             }
-            // 2. 回退：简单正则匹配（兼容旧格式）
+            // Layer 2.5: 简单正则匹配（兼容旧格式）
             const match = content.match(/对应需求端[|｜]\s*([a-z,\s]+)/i);
             if (match) {
-                return match[1].split(/[,，]/).map((s) => s.trim()).filter(Boolean);
+                const result = match[1].split(/[,，]/).map((s) => s.trim()).filter(Boolean);
+                if (result.length > 0)
+                    return result;
             }
         }
     }
     catch { }
-    return ['app', 'h5', 'miniapp', 'admin']; // 默认四端
+    // ⚠️ 不再硬编码默认端列表 — 端列表应由 AI 根据 CONSTITUTION.md + 需求文档判断
+    // 如果 Layer 1 和 Layer 2 都无法检测到端，返回空数组，由 AI 在 prompt 中自行发现
+    return [];
 }
 /**
  * 将中文端名/工程名归一化为标准端名
@@ -1693,11 +1786,28 @@ async function detectPlatformsFromConstitution() {
  */
 function normalizeToStandardPlatform(name) {
     const nameLower = name.toLowerCase().trim();
+    // 【v6.40.2 修复】两阶段最长匹配策略：
+    // Phase 1: 精确匹配（name === alias），最长优先
+    // Phase 2: 包含匹配（name.includes(alias) 或 alias.includes(name)），最长优先
+    // 避免「后台服务端」被短别名「后台」先匹配到 admin
+    // 避免「移动端」被更长别名「移动端app」误匹配到 app
+    const allPairs = [];
     for (const [standardName, aliases] of Object.entries(PLATFORM_ALIAS_MAP)) {
         for (const alias of aliases) {
-            if (nameLower === alias || nameLower.includes(alias) || alias.includes(nameLower)) {
-                return standardName;
-            }
+            allPairs.push({ alias: alias.toLowerCase(), platform: standardName });
+        }
+    }
+    allPairs.sort((a, b) => b.alias.length - a.alias.length);
+    // Phase 1: 精确匹配
+    for (const pair of allPairs) {
+        if (nameLower === pair.alias) {
+            return pair.platform;
+        }
+    }
+    // Phase 2: 包含匹配
+    for (const pair of allPairs) {
+        if (nameLower.includes(pair.alias) || pair.alias.includes(nameLower)) {
+            return pair.platform;
         }
     }
     // 无法映射时，返回清理后的原始值
@@ -1749,7 +1859,12 @@ async function generateSpecsFromRequirements(reqPaths, iteration, specDir) {
     if (unclassifiedFiles.length > 0) {
         logger_1.logger.info('');
         logger_1.logger.info(`   ❓ 发现 ${unclassifiedFiles.length} 个文档无法自动识别所属端`);
-        logger_1.logger.info(`   💡 可用端列表: ${platforms.join(', ')}`);
+        if (platforms.length > 0) {
+            logger_1.logger.info(`   💡 可用端列表: ${platforms.join(', ')}`);
+        }
+        else {
+            logger_1.logger.info(`   💡 CONSTITUTION.md 未检测到端列表，将由 AI 根据需求文档内容判断`);
+        }
         logger_1.logger.info('');
         for (const file of unclassifiedFiles) {
             const fileName = file.path.split(/[/\\]/).pop() || file.path;
@@ -1850,15 +1965,19 @@ async function generateSpecsFromRequirements(reqPaths, iteration, specDir) {
             await (0, fs_extra_1.writeFile)((0, path_1.join)(platformDir, 'UI_SPEC.md'), uiContent);
         }
     }
-    // 4. 写入全局文件（覆盖空模板，不覆盖已有实质内容的文件）
+    // 4. 写入全局文件到 global/ 子目录（v6.41.0+ 新路径）
     let withContent = 0;
     let skipped = 0;
-    await (0, fs_extra_1.ensureDir)(specDir);
+    const globalDir = (0, path_1.join)(specDir, spec_paths_1.GLOBAL_SPECS_DIR);
+    await (0, fs_extra_1.ensureDir)(globalDir);
     for (const f of files) {
-        const filePath = (0, path_1.join)(specDir, f.filename);
-        // 如果文件已存在且有实质内容（>50 非模板字符），跳过
-        if (await (0, fs_extra_1.pathExists)(filePath)) {
-            const existing = await (0, fs_extra_1.readFile)(filePath, 'utf-8');
+        // 写入路径：始终使用 global/ 子目录
+        const filePath = (0, path_1.join)(globalDir, f.filename);
+        // 覆盖检查：优先检查新路径，回退检查旧路径（根目录）
+        const existingPath = await (0, fs_extra_1.pathExists)(filePath) ? filePath :
+            await (0, fs_extra_1.pathExists)((0, path_1.join)(specDir, f.filename)) ? (0, path_1.join)(specDir, f.filename) : null;
+        if (existingPath) {
+            const existing = await (0, fs_extra_1.readFile)(existingPath, 'utf-8');
             const meaningful = stripTemplateNoise(existing);
             if (meaningful.length > 50) {
                 skipped++;
@@ -2684,17 +2803,28 @@ function inferPlatformFromPathOrContent(filePath, content, platforms) {
             return platform;
         }
     }
-    // 【新增】2. 语义映射匹配：尝试将内容中的中文端名映射到标准端名
+    // 2. 语义映射匹配：硬编码 PLATFORM_ALIAS_MAP + CONSTITUTION.md 动态别名
     const firstLines = content.split('\n').slice(0, 50).join('\n');
-    for (const [standardPlatform, aliases] of Object.entries(PLATFORM_ALIAS_MAP)) {
-        // 只检查这个标准端名是否在 platforms 列表中
+    // 合并硬编码映射和 CONSTITUTION.md 动态提取的别名
+    const mergedAliases = { ...PLATFORM_ALIAS_MAP };
+    for (const [platform, aliases] of Object.entries(_dynamicPlatformAliases)) {
+        if (!mergedAliases[platform]) {
+            mergedAliases[platform] = [];
+        }
+        for (const a of aliases) {
+            if (!mergedAliases[platform].includes(a)) {
+                mergedAliases[platform].push(a);
+            }
+        }
+    }
+    for (const [standardPlatform, aliases] of Object.entries(mergedAliases)) {
         if (!platforms.includes(standardPlatform))
             continue;
-        // 检查是否有别名出现在内容中
         for (const alias of aliases) {
             const aliasPattern = new RegExp(alias, 'i');
             if (aliasPattern.test(firstLines)) {
-                logger_1.logger.info(`   🔄 语义映射: "${alias}" → "${standardPlatform}"`);
+                const source = PLATFORM_ALIAS_MAP[standardPlatform]?.includes(alias) ? '静态映射' : 'CONSTITUTION动态';
+                logger_1.logger.info(`   🔄 语义映射(${source}): "${alias}" → "${standardPlatform}"`);
                 return standardPlatform;
             }
         }