speccore 8.3.121 → 8.3.126

package/dist/core/code-scanner.js

@@ -1,4 +1,37 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildCodeIndex = buildCodeIndex;
 exports.findRelevantCode = findRelevantCode;
@@ -7,6 +40,7 @@ exports.loadCodeIndex = loadCodeIndex;
 exports.checkCodeIndexFreshness = checkCodeIndexFreshness;
 exports.isIndexStale = isIndexStale;
 exports.loadFullIndex = loadFullIndex;
+exports.resolveIterationScope = resolveIterationScope;
 /**
  * code-scanner — 智能源码发现 + 范围控制 + 多端识别
  *
@@ -20,9 +54,12 @@ exports.loadFullIndex = loadFullIndex;
 const fs_extra_1 = require("fs-extra");
 const path_1 = require("path");
 const child_process_1 = require("child_process");
+const logger_1 = require("../utils/logger");
 const knowledge_graph_1 = require("./knowledge-graph");
 const reverse_sync_1 = require("./reverse-sync");
 const spec_paths_1 = require("./spec-paths");
+// v8.3.125+: 同义词扩展，补充 SEMANTIC_MAP 覆盖范围
+const synonyms_1 = require("../utils/synonyms");
 // ── 端名缓存（v6.48.0+）：从 CONSTITUTION.md 加载，优先于通用模式匹配 ──
 let _constitutionPlatforms = null;
 async function getConstitutionPlatforms() {
@@ -233,22 +270,83 @@ taskId) {
     const filesToSearch = scopeDirs.length > 0
         ? index.files.filter(f => scopeDirs.some(dir => f.path.startsWith(dir)))
         : index.files;
-    // ── P0: 加载知识图谱关联 ──
-    let kgBoostedFiles = new Set();
+    // ── P0: 深度知识图谱关联 + Spec 内容引导 ──
+    // v8.3.122+: 不再只获取 depends_on 任务ID，而是深度利用知识图谱的全部关联信息
     let kgTaskIds = new Set();
+    let specKeywords = []; // 从 spec 文件提取的技术关键词（高权重）
+    let kgSourceFilePaths = new Set(); // 知识图谱中的 source-file 实体路径
+    let kgCodeEntities = new Set(); // business_module 的 codeEntities
     if (iteration) {
-        const kg = await (0, knowledge_graph_1.loadKnowledgeGraph)(process.cwd());
+        const kg = await (0, knowledge_graph_1.loadFreshKnowledgeGraph)(process.cwd(), iteration);
         if (kg && taskId) {
-            // 1. 当前任务直接关联
+            // 1. 当前任务直接关联 + 依赖任务
             kgTaskIds.add(taskId);
-            // 2. 依赖任务也纳入
             for (const rel of kg.relations) {
                 if (rel.from === taskId && rel.type === 'depends_on') {
                     kgTaskIds.add(rel.to);
                 }
             }
+            // v8.3.122+: 深度利用知识图谱 — 获取完整任务上下文
+            const fullContext = (0, knowledge_graph_1.getFullTaskContext)(kg, taskId);
+            // 2. 从 relatedSpecs 读取内容，提取精准技术关键词
+            for (const spec of fullContext.relatedSpecs) {
+                if (spec.file && await (0, fs_extra_1.pathExists)(spec.file)) {
+                    try {
+                        const specContent = await (0, fs_extra_1.readFile)(spec.file, 'utf-8');
+                        const techKws = extractTechnicalKeywords(specContent);
+                        specKeywords.push(...techKws);
+                        logger_1.logger.debug(`   📄 Spec ${spec.file} 提取 ${techKws.length} 个技术关键词`);
+                    }
+                    catch { /* 读取失败不阻断 */ }
+                }
+            }
+            // 3. 从知识图谱 source-file 实体中查找关联文件
+            const demandKws = extractKeywords(requirements);
+            for (const entity of Object.values(kg.entities)) {
+                if (entity.type === 'source-file' && entity.file) {
+                    // 3a. 通过平台匹配：任务的平台与该 source-file 的 endpoint 一致
+                    const taskPlatforms = fullContext.siblingSubtasks
+                        .map(st => st.platform)
+                        .filter(Boolean);
+                    if (entity.endpoint && taskPlatforms.includes(entity.endpoint)) {
+                        kgSourceFilePaths.add(entity.file);
+                    }
+                    // 3b. 通过语义标签匹配：semanticTags 与需求关键词匹配
+                    if (entity.semanticTags && entity.semanticTags.length > 0) {
+                        for (const tag of entity.semanticTags) {
+                            const tagLower = tag.toLowerCase();
+                            if (demandKws.some(kw => tagLower.includes(kw.toLowerCase()) || kw.toLowerCase().includes(tagLower))) {
+                                kgSourceFilePaths.add(entity.file);
+                            }
+                        }
+                    }
+                    // 3c. 通过 exports 匹配：导出的类/函数名出现在 spec 关键词中
+                    if (entity.exports && specKeywords.length > 0) {
+                        for (const exp of entity.exports) {
+                            const expLower = exp.toLowerCase();
+                            if (specKeywords.some(kw => expLower.includes(kw.toLowerCase()) || kw.toLowerCase().includes(expLower))) {
+                                kgSourceFilePaths.add(entity.file);
+                            }
+                        }
+                    }
+                }
+                // 4. 从 business_module 实体获取 codeEntities
+                if (entity.type === 'business_module' && entity.codeEntities) {
+                    const moduleName = (entity.businessModule || entity.title || '').toLowerCase();
+                    if (demandKws.some(kw => moduleName.includes(kw.toLowerCase()) || kw.toLowerCase().includes(moduleName))) {
+                        for (const ce of entity.codeEntities) {
+                            kgCodeEntities.add(ce);
+                        }
+                    }
+                }
+            }
         }
     }
+    // 去重并限制 spec 关键词数量
+    specKeywords = [...new Set(specKeywords)].slice(0, 50);
+    if (specKeywords.length > 0) {
+        logger_1.logger.debug(`   🔑 Spec 技术关键词: ${specKeywords.slice(0, 10).join(', ')}${specKeywords.length > 10 ? '...' : ''}`);
+    }
     // ── P0: 扫描 @spec 注释，找到关联的代码文件 ──
     let specAnnotatedFiles = new Map(); // filePath -> score boost
     if (taskId) {
@@ -283,6 +381,17 @@ taskId) {
         if (specBoost) {
             score += specBoost;
         }
+        // v8.3.122+: 知识图谱 source-file 实体直接关联（平台/语义标签/exports 匹配）
+        if (kgSourceFilePaths.has(f.path)) {
+            score += 40;
+        }
+        // v8.3.122+: 知识图谱 business_module codeEntities 关联
+        for (const ce of kgCodeEntities) {
+            if (f.path.includes(ce) || (0, path_1.basename)(f.path).replace(/\.[^.]+$/, '') === ce) {
+                score += 35;
+                break;
+            }
+        }
         // 文件名匹配（精确 + 模糊）
         for (const kw of keywords) {
             if (f.path.toLowerCase().includes(kw.toLowerCase())) {
@@ -300,6 +409,26 @@ taskId) {
                 }
             }
         }
+        // v8.3.122+: Spec 技术关键词高权重匹配（从 TECH.md/REQ.md 等提取的精准关键词）
+        for (const kw of specKeywords) {
+            const kwLower = kw.toLowerCase();
+            // 文件名匹配（权重 +25，比普通关键词 +10 更高）
+            if (f.path.toLowerCase().includes(kwLower)) {
+                score += 25;
+            }
+            // 导出名匹配
+            for (const exp of f.exports) {
+                if (exp.toLowerCase().includes(kwLower) || kwLower.includes(exp.toLowerCase())) {
+                    score += 20;
+                }
+            }
+            // API 路径匹配
+            for (const api of f.apis) {
+                if (api.toLowerCase().includes(kwLower) || kwLower.includes(api.toLowerCase())) {
+                    score += 22;
+                }
+            }
+        }
         // API 匹配
         for (const api of f.apis) {
             if (requirements.includes(api))
@@ -397,6 +526,59 @@ taskId) {
         if (bonus)
             s.score += bonus;
     }
+    // v8.3.122+: 反向 Import 传播 — 如果 A 被命中，A 所 import 的公共模块 C 也加分
+    // 解决需求文档不提"拦截器/通用方法/缓存"但代码实际依赖这些模块的问题
+    const SHARED_DIRS = ['shared', 'common', 'utils', 'lib', 'helpers', 'interceptors', 'middleware', 'core', 'base', 'config', 'constants', 'types', 'decorators', 'filters', 'guards', 'pipes'];
+    const isSharedFile = (path) => SHARED_DIRS.some(dir => path.toLowerCase().includes(`/${dir}/`));
+    const reverseImportBonus = new Map();
+    for (const s of scored) {
+        const matchedFile = s.file;
+        for (const imp of matchedFile.imports) {
+            const importedBase = imp.replace(/^\.\.?\//, '').replace(/\.[^.]+$/, '');
+            for (const other of filesToSearch) {
+                if (other.path === matchedFile.path)
+                    continue;
+                const otherBase = (0, path_1.basename)(other.path).replace(/\.[^.]+$/, '');
+                const otherDirBase = (0, path_1.basename)((0, path_1.dirname)(other.path));
+                if (otherBase === importedBase || otherDirBase === importedBase || other.path.includes(imp.replace(/^\.\.?\//, ''))) {
+                    const bonus = isSharedFile(other.path) ? 15 : 5;
+                    reverseImportBonus.set(other.path, (reverseImportBonus.get(other.path) || 0) + bonus);
+                }
+            }
+        }
+    }
+    for (const s of scored) {
+        const bonus = reverseImportBonus.get(s.file.path);
+        if (bonus)
+            s.score += bonus;
+    }
+    // v8.3.122+: 高被引用公共模块主动发现 — shared/common/utils 下被 3+ 模块引用的文件自动入榜
+    const referenceCount = new Map();
+    const sharedCandidates = filesToSearch.filter(f => isSharedFile(f.path));
+    for (const f of filesToSearch) {
+        for (const imp of f.imports) {
+            const impBase = imp.replace(/^\.\.?\//, '').replace(/\.[^.]+$/, '');
+            const impDirBase = impBase.includes('/') ? (0, path_1.basename)(impBase) : impBase;
+            for (const sc of sharedCandidates) {
+                const scBase = (0, path_1.basename)(sc.path).replace(/\.[^.]+$/, '');
+                const scDirBase = (0, path_1.basename)((0, path_1.dirname)(sc.path));
+                if (scBase === impBase || scBase === impDirBase || scDirBase === impBase || sc.path.includes(imp.replace(/^\.\.?\//, ''))) {
+                    referenceCount.set(sc.path, (referenceCount.get(sc.path) || 0) + 1);
+                }
+            }
+        }
+    }
+    for (const [path, count] of referenceCount) {
+        if (count >= 3) {
+            const alreadyScored = scored.some(s => s.file.path === path);
+            if (!alreadyScored) {
+                const fileObj = filesToSearch.find(f => f.path === path);
+                if (fileObj) {
+                    scored.push({ file: fileObj, score: 10 + Math.min(count, 10) });
+                }
+            }
+        }
+    }
     // P2: 模块邻近度 — 同模块文件加分
     const moduleBonus = new Map();
     const scoredModules = new Set(scored.map(s => `${s.file.endpoint}:${s.file.module}`));
@@ -487,12 +669,16 @@ async function loadContractApiPaths() {
 }
 /**
  * 读取匹配到的源码文件内容（用于分析注入）
+ * v8.3.122+: 移除 matches.slice(0, 5) 硬限制，改为按 maxBytes 动态控制，
+ * 让 analyze 传入的 limit 和 maxBytes 真正生效。
  */
-async function readRelevantSource(matches, maxBytes = 50000 // 最多读 50KB
+async function readRelevantSource(matches, maxBytes = 50000, // 最多读 50KB
+maxFiles // 最多读多少个文件（不传则不限制，由 maxBytes 控制）
 ) {
     const result = {};
     let totalBytes = 0;
-    for (const m of matches.slice(0, 5)) {
+    const filesToRead = maxFiles ? matches.slice(0, maxFiles) : matches;
+    for (const m of filesToRead) {
         if (totalBytes >= maxBytes)
             break;
         try {
@@ -653,6 +839,10 @@ function expandKeywords(keywords) {
             }
         }
     }
+    // v8.3.125+: 补充 SYNONYM_GROUPS 扩展（覆盖更多中英文同义词，如 "登录" ↔ "auth"）
+    for (const syn of (0, synonyms_1.expandSynonyms)(keywords)) {
+        expanded.add(syn);
+    }
     return [...expanded];
 }
 function extractKeywords(text) {
@@ -675,14 +865,126 @@ function extractKeywords(text) {
     return expanded.slice(0, 30);
 }
 /**
- * 检查索引是否过期 (超过 1 小时)
+ * 从 Spec/Markdown 内容中提取技术关键词（类名、接口名、API路径、表名等）
+ * v8.3.122+: 用于增强 findRelevantCode 的代码匹配精准度
+ */
+function extractTechnicalKeywords(content) {
+    const keywords = [];
+    // 1. 类名/接口名/类型别名（代码块内外都找）
+    const classMatches = content.match(/(?:class|interface|type|enum)\s+([A-Z][a-zA-Z0-9_]*)/g) || [];
+    for (const m of classMatches) {
+        const name = m.replace(/^(class|interface|type|enum)\s+/, '').trim();
+        if (name && name.length >= 2)
+            keywords.push(name);
+    }
+    // 2. 函数名（从代码块中提取 export function xxx）
+    const funcMatches = content.match(/(?:export\s+)?(?:function|const|let|var)\s+([a-zA-Z_][a-zA-Z0-9_]*)\s*[=:]/g) || [];
+    for (const m of funcMatches) {
+        const name = m.replace(/^(?:export\s+)?(?:function|const|let|var)\s+/, '').replace(/\s*[=:]$/, '').trim();
+        if (name && name.length >= 2 && !['if', 'for', 'while', 'return', 'await', 'async'].includes(name)) {
+            keywords.push(name);
+        }
+    }
+    // 3. API 路径（/api/xxx, /v1/xxx）
+    const apiMatches = content.match(/['"]\s*(\/[\w/{}.-]+)\s*['"]/g) || [];
+    for (const m of apiMatches) {
+        const path = m.replace(/['"]/g, '').trim();
+        if (path.startsWith('/') && path.length > 2) {
+            keywords.push(path);
+            // 也提取路径中的段
+            const segments = path.split('/').filter(s => s.length >= 2 && !s.match(/^\{.*\}$/));
+            keywords.push(...segments);
+        }
+    }
+    // 4. 数据库表名（从 schema 描述中提取）
+    const tableMatches = content.match(/(?:表名|table|TABLE)[:\s]+[`']?([a-zA-Z_][a-zA-Z0-9_]*)[`']?/g) || [];
+    for (const m of tableMatches) {
+        const name = m.replace(/(?:表名|table|TABLE)[:\s]+/, '').replace(/[`']/g, '').trim();
+        if (name)
+            keywords.push(name);
+    }
+    // 5. 组件名（前端 <XxxComponent />, <Xxx />）
+    const componentMatches = content.match(/<([A-Z][a-zA-Z0-9]*(?:Component|Page|View|Card|Modal|Form)?)\s*\/?>/g) || [];
+    for (const m of componentMatches) {
+        const name = m.replace(/[<\s/>]/g, '');
+        if (name && name.length >= 2)
+            keywords.push(name);
+    }
+    // 6. 驼峰命名/下划线命名的复合词（通常是有意义的标识符）
+    const identifierMatches = content.match(/\b[a-z][a-zA-Z0-9]*[A-Z][a-zA-Z0-9]*\b/g) || [];
+    for (const m of identifierMatches) {
+        if (m.length >= 4)
+            keywords.push(m);
+    }
+    return [...new Set(keywords)].slice(0, 50);
+}
+/**
+ * 检查索引是否过期
+ * v8.3.125+: 基于实际文件 mtime 判断 + 24h 强制刷新（捕获新增文件）
  */
-async function isIndexStale() {
+async function isIndexStale(scope) {
     const index = await loadIndex();
     if (!index)
         return true;
+    // 24 小时强制刷新（捕获新增文件）
     const age = Date.now() - new Date(index.updatedAt).getTime();
-    return age > 3600000; // 1 hour
+    if (age > 86400000)
+        return true;
+    // 检查已有文件是否被修改或删除（最多检查 300 个，避免大量 stat）
+    const checkLimit = Math.min(index.files.length, 300);
+    for (let i = 0; i < checkLimit; i++) {
+        const file = index.files[i];
+        try {
+            const fullPath = (0, path_1.join)(process.cwd(), file.path);
+            if (!(await (0, fs_extra_1.pathExists)(fullPath)))
+                return true;
+            const st = await (0, fs_extra_1.stat)(fullPath);
+            if (st.mtimeMs > file.lastModified + 1000)
+                return true;
+        }
+        catch {
+            return true;
+        }
+    }
+    // 采样检查是否有新增文件：对比 scope 下文件数
+    const dirs = scope ? scope.split(',').map(s => s.trim()) : DEFAULT_SCOPE;
+    for (const dir of dirs.slice(0, 3)) {
+        if (!(await (0, fs_extra_1.pathExists)(dir)))
+            continue;
+        try {
+            let count = 0;
+            await quickCountSourceFiles(dir, 0, (n) => { count = n; });
+            const indexedCount = index.files.filter(f => f.path.startsWith(dir.replace(/\/$/, ''))).length;
+            if (count > indexedCount + 5)
+                return true;
+        }
+        catch { /* 跳过 */ }
+    }
+    return false;
+}
+/** 快速统计目录下源码文件数（不深入解析） */
+async function quickCountSourceFiles(dir, depth, cb) {
+    try {
+        const entries = await (0, fs_extra_1.readdir)(dir, { withFileTypes: true });
+        let count = 0;
+        for (const e of entries) {
+            if (e.name.startsWith('.') && e.name !== '.env')
+                continue;
+            if (['node_modules', 'dist', 'build', 'target', '__pycache__', 'outputs', '.speccore', 'templates', 'docs', 'tests', 'examples'].includes(e.name))
+                continue;
+            if (e.isDirectory() && depth < 4) {
+                await quickCountSourceFiles((0, path_1.join)(dir, e.name), depth + 1, (n) => { count += n; });
+            }
+            else if (e.isFile()) {
+                const ext = e.name.split('.').pop() || '';
+                if (['ts', 'tsx', 'js', 'jsx', 'py', 'java', 'go', 'rs', 'vue', 'sql', 'yaml', 'yml'].includes(ext)) {
+                    count++;
+                }
+            }
+        }
+        cb(count);
+    }
+    catch { /* 跳过 */ }
 }
 /**
  * 加载完整索引（含端、模块、联动）
@@ -690,6 +992,70 @@ async function isIndexStale() {
 async function loadFullIndex() {
     return loadIndex();
 }
+/**
+ * v8.3.125+: 根据迭代名解析涉及的源码路径 scope
+ * 读取 PLATFORMS.md / 020-specs/ 子目录推断端名，匹配 CONSTITUTION.md 中的源码路径
+ */
+async function resolveIterationScope(iteration) {
+    if (!iteration)
+        return undefined;
+    try {
+        const { getIterationDir } = await Promise.resolve().then(() => __importStar(require('../core/context')));
+        const { logger: log } = await Promise.resolve().then(() => __importStar(require('../utils/logger')));
+        const iterDir = await getIterationDir(iteration);
+        if (!(await (0, fs_extra_1.pathExists)(iterDir)))
+            return undefined;
+        // 读取 CONSTITUTION.md 获取源码路径
+        const constitutionPath = (0, path_1.join)(process.cwd(), '.speccore', 'CONSTITUTION.md');
+        let sourcePaths = ['src'];
+        if (await (0, fs_extra_1.pathExists)(constitutionPath)) {
+            const content = await (0, fs_extra_1.readFile)(constitutionPath, 'utf-8');
+            const match = content.match(/源码路径[\s\S]*?\n\s*-\s*`?([^`\n]+)`?/g);
+            if (match) {
+                sourcePaths = match.map(m => m.replace(/.*-\s*`?/, '').replace(/`?$/, '').trim()).filter(Boolean);
+            }
+        }
+        if (sourcePaths.length <= 1)
+            return undefined;
+        // 1. 尝试从 PLATFORMS.md 读取端列表
+        let platformNames = [];
+        const platformsPath = (0, path_1.join)(iterDir, '020-specs', 'PLATFORMS.md');
+        if (await (0, fs_extra_1.pathExists)(platformsPath)) {
+            const pContent = await (0, fs_extra_1.readFile)(platformsPath, 'utf-8');
+            const pMatch = pContent.match(/-\s*(\w+)/g);
+            if (pMatch)
+                platformNames = pMatch.map(m => m.replace(/^-\s*/, '').trim().toLowerCase());
+        }
+        // 2. fallback：从 020-specs/ 子目录推断端名
+        if (platformNames.length === 0) {
+            const specsDir = (0, path_1.join)(iterDir, '020-specs');
+            if (await (0, fs_extra_1.pathExists)(specsDir)) {
+                const entries = await (0, fs_extra_1.readdir)(specsDir, { withFileTypes: true });
+                platformNames = entries
+                    .filter(e => e.isDirectory() && e.name !== 'overview' && e.name !== 'requirements')
+                    .map(e => e.name.toLowerCase());
+            }
+        }
+        // 3. 筛选 sourcePaths
+        if (platformNames.length > 0) {
+            const matched = sourcePaths.filter(sp => {
+                const lower = sp.toLowerCase();
+                return platformNames.some(pn => lower.includes(pn));
+            });
+            // 保留 shared/common/lib 等公共路径
+            const sharedPaths = sourcePaths.filter(sp => /shared|common|lib|utils|pkg/.test(sp.toLowerCase()));
+            const combined = [...new Set([...matched, ...sharedPaths])];
+            if (combined.length > 0) {
+                log?.info?.(`   📂 代码索引按端筛选: ${combined.join(', ')}（涉及端: ${platformNames.join(', ')}）`);
+                return combined.join(',');
+            }
+        }
+    }
+    catch {
+        // 筛选失败不阻断
+    }
+    return undefined;
+}
 // ── 端识别 ──
 async function detectEndpoint(filePath) {
     const normalized = filePath.replace(/\\/g, '/').toLowerCase();