speccore 5.70.0 → 5.74.0

package/dist/core/code-scanner.d.ts

@@ -1,12 +1,63 @@
+export interface CodeFile {
+    path: string;
+    language: string;
+    exports: string[];
+    apis: string[];
+    imports: string[];
+    lastModified: number;
+    lines: number;
+    endpoint: string;
+    module: string;
+}
+export interface EndpointInfo {
+    name: string;
+    rootPath: string;
+    techStack: string;
+    entryFile: string;
+    fileCount: number;
+    frameworks: string[];
+}
+export interface ModuleInfo {
+    name: string;
+    path: string;
+    endpoint: string;
+    fileCount: number;
+    coreFiles: string[];
+    exports: string[];
+    dependencies: string[];
+}
+export interface GitCorrelation {
+    files: string[];
+    count: number;
+    pattern: string;
+}
+export interface CodeIndex {
+    updatedAt: string;
+    files: CodeFile[];
+    endpoints: EndpointInfo[];
+    modules: ModuleInfo[];
+    correlations: GitCorrelation[];
+    gitStats: {
+        totalCommits: number;
+        analyzedCommits: number;
+    };
+}
 /**
  * 扫描项目目录，构建代码索引
  * scope: 扫描范围 ("src/:backend/**" 表示只扫 backend 下的 src)
  */
-export declare function buildCodeIndex(scope?: string): Promise<number>;
 /**
- * 根据需求内容查找匹配的源码文件
+ * 全量扫描构建代码索引
  */
-export declare function findRelevantCode(requirements: string, limit?: number): Promise<{
+export declare function buildCodeIndex(scope?: string, incremental?: boolean): Promise<number>;
+/**
+ * 根据需求内容查找匹配的源码文件（解耦设计：从完整索引中按 scope 筛选）
+ *
+ * v2 增强:
+ *   - 端配额：每个 endpoint 最多占 limit 的 40%，保证多端多样性
+ *   - API 契约：加载 API_CONTRACT.yaml，命中契约路径的文件加分
+ */
+export declare function findRelevantCode(requirements: string, limit?: number, scope?: string): Promise<{
     file: string;
     exports: string[];
     apis: string[];
@@ -23,4 +74,8 @@ export declare function readRelevantSource(matches: {
  * 检查索引是否过期 (超过 1 小时)
  */
 export declare function isIndexStale(): Promise<boolean>;
+/**
+ * 加载完整索引（含端、模块、联动）
+ */
+export declare function loadFullIndex(): Promise<CodeIndex | null>;
 //# sourceMappingURL=code-scanner.d.ts.map

package/dist/core/code-scanner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"code-scanner.d.ts","sourceRoot":"","sources":["../../src/core/code-scanner.ts"],"names":[],"mappings":"AA+BA;;;GAGG;AACH,wBAAsB,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBpE;AA2FD;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,YAAY,EAAE,MAAM,EACpB,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAmC/E;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,EAC1C,QAAQ,GAAE,MAAc,GACvB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAsBjC;AAmBD;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC,CAKrD"}
+{"version":3,"file":"code-scanner.d.ts","sourceRoot":"","sources":["../../src/core/code-scanner.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,YAAY,EAAE,cAAc,EAAE,CAAC;IAC/B,QAAQ,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7D;AA8BD;;;GAGG;AACH;;GAEG;AACH,wBAAsB,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,WAAW,GAAE,OAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAoClG;AAqHD;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CACpC,YAAY,EAAE,MAAM,EACpB,KAAK,GAAE,MAAW,EAClB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAsF/E;AAyBD;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,EAC1C,QAAQ,GAAE,MAAc,GACvB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAsBjC;AAmBD;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC,CAKrD;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAE/D"}

package/dist/core/code-scanner.js

@@ -4,54 +4,99 @@ exports.buildCodeIndex = buildCodeIndex;
 exports.findRelevantCode = findRelevantCode;
 exports.readRelevantSource = readRelevantSource;
 exports.isIndexStale = isIndexStale;
+exports.loadFullIndex = loadFullIndex;
 /**
- * code-scanner — 智能源码发现 + 范围控制
+ * code-scanner — 智能源码发现 + 范围控制 + 多端识别
  *
  * 策略:
  *   1. 首次: 扫描项目结构生成索引缓存 (.speccore/cache/code-structure.json)
  *   2. 分析时: 从需求提取关键词 → 匹配源码 → 只读相关文件
- *   3. 增量: 仅读取 .speccore/SETTINGS.md 中配置的目录范围
+ *   3. 增量: 对比 lastModified 只更新变化文件
+ *   4. 多端: 自动识别 frontend/backend/mobile/cli/shared 等端
+ *   5. git 联动: 分析 git log 找出高频共同变更的文件组
  */
 const fs_extra_1 = require("fs-extra");
 const path_1 = require("path");
+const child_process_1 = require("child_process");
 const CACHE_DIR = (0, path_1.join)('.speccore', 'cache');
 const INDEX_PATH = (0, path_1.join)(CACHE_DIR, 'code-structure.json');
 const DEFAULT_SCOPE = ['src/', 'app/', 'lib/', 'pkg/'];
+// ── 端识别规则 ──
+const ENDPOINT_PATTERNS = {
+    frontend: {
+        patterns: ['src/web', 'src/frontend', 'src/client', 'src/ui', 'src/pages', 'src/views', 'src/components', 'web/', 'frontend/', 'app/'],
+        techHints: { 'react': 'React', 'vue': 'Vue', 'angular': 'Angular', 'svelte': 'Svelte', 'next': 'Next.js', 'nuxt': 'Nuxt' },
+    },
+    backend: {
+        patterns: ['src/server', 'src/backend', 'src/api', 'src/routes', 'src/controllers', 'src/services', 'server/', 'backend/', 'api/'],
+        techHints: { 'express': 'Express', 'koa': 'Koa', 'fastify': 'Fastify', 'nestjs': 'NestJS', 'spring': 'Spring', 'gin': 'Gin' },
+    },
+    mobile: {
+        patterns: ['src/mobile', 'src/native', 'src/app', 'ios/', 'android/', 'mobile/'],
+        techHints: { 'react-native': 'React Native', 'flutter': 'Flutter', 'expo': 'Expo' },
+    },
+    cli: {
+        patterns: ['src/cli', 'src/commands', 'src/cmd', 'bin/', 'cli/'],
+        techHints: { 'commander': 'Commander', 'yargs': 'Yargs', 'cobra': 'Cobra', 'click': 'Click' },
+    },
+    shared: {
+        patterns: ['src/shared', 'src/common', 'src/utils', 'src/lib', 'shared/', 'common/', 'lib/'],
+        techHints: {},
+    },
+};
 /**
  * 扫描项目目录，构建代码索引
  * scope: 扫描范围 ("src/:backend/**" 表示只扫 backend 下的 src)
  */
-async function buildCodeIndex(scope) {
+/**
+ * 全量扫描构建代码索引
+ */
+async function buildCodeIndex(scope, incremental = false) {
     await (0, fs_extra_1.ensureDir)(CACHE_DIR);
+    // 增量模式：加载现有索引
+    let existingIndex = null;
+    if (incremental) {
+        existingIndex = await loadIndex();
+    }
     const dirs = scope ? scope.split(',').map(s => s.trim()) : DEFAULT_SCOPE;
-    const files = [];
+    const files = existingIndex ? [...existingIndex.files] : [];
+    const processedPaths = new Set(files.map(f => f.path));
     for (const dir of dirs) {
         if (!(await (0, fs_extra_1.pathExists)(dir)))
             continue;
-        await scanDirectory(dir, dir, files);
+        await scanDirectory(dir, dir, files, processedPaths, incremental);
     }
+    // 多端识别
+    const endpoints = detectEndpoints(files);
+    // 模块分组
+    const modules = groupModules(files, endpoints);
+    // git 变更联动分析
+    const { correlations, gitStats } = await analyzeGitCorrelations(files);
     const index = {
         updatedAt: new Date().toISOString(),
         files,
+        endpoints,
+        modules,
+        correlations,
+        gitStats,
     };
     await (0, fs_extra_1.writeFile)(INDEX_PATH, JSON.stringify(index, null, 2));
     return files.length;
 }
-async function scanDirectory(root, dir, result) {
+async function scanDirectory(root, dir, result, processedPaths, incremental) {
     try {
         const entries = await (0, fs_extra_1.readdir)(dir, { withFileTypes: true });
         for (const entry of entries) {
             const fullPath = (0, path_1.join)(dir, entry.name);
-            // 跳过 node_modules, .git, dist
+            // 跳过 node_modules, .git, dist, outputs 等
             if (entry.name.startsWith('.') && entry.name !== '.env')
                 continue;
-            if (['node_modules', 'dist', 'build', 'target', '__pycache__'].includes(entry.name))
+            if (['node_modules', 'dist', 'build', 'target', '__pycache__', 'outputs', '.speccore', 'templates', 'docs', 'tests', 'examples'].includes(entry.name))
                 continue;
             if (entry.isDirectory()) {
-                // 限制深度: 5层
                 const depth = fullPath.split('/').length - root.split('/').length;
-                if (depth < 5)
-                    await scanDirectory(root, fullPath, result);
+                if (depth < 6)
+                    await scanDirectory(root, fullPath, result, processedPaths, incremental);
             }
             else if (entry.isFile()) {
                 const ext = entry.name.split('.').pop() || '';
@@ -64,19 +109,42 @@ async function scanDirectory(root, dir, result) {
                 if (!lang)
                     continue;
                 try {
-                    const content = await (0, fs_extra_1.readFile)(fullPath, 'utf-8');
                     const st = await (0, fs_extra_1.stat)(fullPath);
-                    // 提取导出
+                    const relPath = (0, path_1.relative)(process.cwd(), fullPath);
+                    // 增量模式：跳过未修改的文件
+                    if (incremental && processedPaths) {
+                        const existing = result.find(f => f.path === relPath);
+                        if (existing && existing.lastModified >= st.mtimeMs)
+                            continue;
+                        // 文件已修改，移除旧记录
+                        if (existing) {
+                            const idx = result.indexOf(existing);
+                            result.splice(idx, 1);
+                        }
+                    }
+                    const content = await (0, fs_extra_1.readFile)(fullPath, 'utf-8');
                     const exports = extractExports(content, lang);
-                    // 提取 API 路径
                     const apis = extractApis(content, lang);
-                    result.push({
-                        path: (0, path_1.relative)(process.cwd(), fullPath),
+                    const imports = extractImports(content, lang);
+                    const lines = content.split('\n').length;
+                    const endpoint = detectEndpoint(relPath);
+                    const module = detectModule(relPath);
+                    const fileEntry = {
+                        path: relPath,
                         language: lang,
                         exports,
                         apis,
+                        imports,
                         lastModified: st.mtimeMs,
-                    });
+                        lines,
+                        endpoint,
+                        module,
+                    };
+                    // 增量模式替换旧记录
+                    if (incremental && processedPaths) {
+                        processedPaths.add(relPath);
+                    }
+                    result.push(fileEntry);
                 }
                 catch {
                     // 跳过二进制/不可读文件
@@ -131,15 +199,27 @@ function extractApis(content, lang) {
     return [...new Set(apis)];
 }
 /**
- * 根据需求内容查找匹配的源码文件
+ * 根据需求内容查找匹配的源码文件（解耦设计：从完整索引中按 scope 筛选）
+ *
+ * v2 增强:
+ *   - 端配额：每个 endpoint 最多占 limit 的 40%，保证多端多样性
+ *   - API 契约：加载 API_CONTRACT.yaml，命中契约路径的文件加分
  */
-async function findRelevantCode(requirements, limit = 10) {
+async function findRelevantCode(requirements, limit = 10, scope // 查询时过滤：如 'src/commands,src/core'
+) {
     const index = await loadIndex();
     if (!index)
         return [];
+    // scope 过滤：只考虑指定目录下的文件
+    const scopeDirs = scope ? scope.split(',').map(s => s.trim()).filter(Boolean) : [];
+    const filesToSearch = scopeDirs.length > 0
+        ? index.files.filter(f => scopeDirs.some(dir => f.path.startsWith(dir)))
+        : index.files;
+    // ── L3: 加载 API 契约路径（用于加分） ──
+    const contractApis = await loadContractApiPaths();
     const keywords = extractKeywords(requirements);
     const scored = [];
-    for (const f of index.files) {
+    for (const f of filesToSearch) {
         let score = 0;
         // 文件名匹配
         for (const kw of keywords) {
@@ -150,6 +230,10 @@ async function findRelevantCode(requirements, limit = 10) {
         for (const api of f.apis) {
             if (requirements.includes(api))
                 score += 20;
+            // L3: 命中 API 契约路径额外加分
+            if (contractApis.some(cp => api.includes(cp) || cp.includes(api))) {
+                score += 15;
+            }
         }
         // 导出匹配
         for (const exp of f.exports) {
@@ -158,19 +242,86 @@ async function findRelevantCode(requirements, limit = 10) {
                     score += 5;
             }
         }
+        // L3: 关键词命中契约中的 API 描述也加分
+        for (const cp of contractApis) {
+            for (const kw of keywords) {
+                if (cp.toLowerCase().includes(kw.toLowerCase()))
+                    score += 3;
+            }
+        }
         if (score > 0)
             scored.push({ file: f, score });
     }
-    return scored
-        .sort((a, b) => b.score - a.score)
-        .slice(0, limit)
-        .map(s => ({
+    // ── L2: 端配额 — 每端最多占 limit 的 40%，保证多端多样性 ──
+    const endpointCap = Math.max(2, Math.ceil(limit * 0.4));
+    const byEndpoint = new Map();
+    for (const s of scored) {
+        const ep = s.file.endpoint || 'common';
+        if (!byEndpoint.has(ep))
+            byEndpoint.set(ep, []);
+        byEndpoint.get(ep).push(s);
+    }
+    // 每端内按分数降序
+    for (const arr of byEndpoint.values()) {
+        arr.sort((a, b) => b.score - a.score);
+    }
+    // 轮询取结果，每端每轮取一个，直到满 limit
+    const result = [];
+    const endpointCounts = new Map();
+    const sortedEndpoints = [...byEndpoint.entries()]
+        .sort((a, b) => (b[1][0]?.score || 0) - (a[1][0]?.score || 0));
+    let filled = 0;
+    while (filled < limit) {
+        let added = false;
+        for (const [ep, items] of sortedEndpoints) {
+            if (filled >= limit)
+                break;
+            const count = endpointCounts.get(ep) || 0;
+            if (count >= endpointCap)
+                continue;
+            const idx = count;
+            if (idx < items.length) {
+                result.push(items[idx]);
+                endpointCounts.set(ep, count + 1);
+                filled++;
+                added = true;
+            }
+        }
+        if (!added)
+            break;
+    }
+    return result.map(s => ({
         file: s.file.path,
         exports: s.file.exports.slice(0, 5),
         apis: s.file.apis,
         score: s.score,
     }));
 }
+// L3: 从项目中的 API_CONTRACT.yaml 文件加载 API 路径
+// 搜索 .speccore/ 和 Iteration-xxx/Task-xxx/_shared/ 下的契约文件
+async function loadContractApiPaths() {
+    const paths = [];
+    try {
+        const { glob } = require('glob');
+        const files = await glob('.speccore/**/API_CONTRACT.yaml');
+        const iterFiles = await glob('Iteration-*/**/API_CONTRACT.yaml');
+        const allFiles = [...files, ...iterFiles];
+        for (const f of allFiles) {
+            if (!await (0, fs_extra_1.pathExists)(f))
+                continue;
+            const content = await (0, fs_extra_1.readFile)(f, 'utf-8');
+            // 提取 YAML 中的路径：  /api/xxx:  格式
+            const matches = content.match(/^\s{2,4}(\/[\w/{}.-]+)\s*:/gm) || [];
+            for (const m of matches) {
+                const p = m.trim().replace(/:$/, '').trim();
+                if (p.startsWith('/') && !paths.includes(p))
+                    paths.push(p);
+            }
+        }
+    }
+    catch { }
+    return paths;
+}
 /**
  * 读取匹配到的源码文件内容（用于分析注入）
  */
@@ -223,4 +374,235 @@ async function isIndexStale() {
     const age = Date.now() - new Date(index.updatedAt).getTime();
     return age > 3600000; // 1 hour
 }
+/**
+ * 加载完整索引（含端、模块、联动）
+ */
+async function loadFullIndex() {
+    return loadIndex();
+}
+// ── 端识别 ──
+function detectEndpoint(filePath) {
+    const normalized = filePath.replace(/\\/g, '/').toLowerCase();
+    for (const [endpoint, config] of Object.entries(ENDPOINT_PATTERNS)) {
+        for (const pattern of config.patterns) {
+            if (normalized.includes(pattern.toLowerCase()))
+                return endpoint;
+        }
+    }
+    return 'common';
+}
+function detectModule(filePath) {
+    const parts = filePath.replace(/\\/g, '/').split('/');
+    // 找到 src/ 之后的第一层目录作为模块名
+    const srcIdx = parts.findIndex(p => ['src', 'app', 'lib', 'pkg'].includes(p));
+    if (srcIdx >= 0 && srcIdx + 1 < parts.length) {
+        return parts[srcIdx + 1];
+    }
+    // 没有 src 则取第一层目录
+    return parts[0] || 'root';
+}
+function detectEndpoints(files) {
+    const endpointMap = new Map();
+    for (const f of files) {
+        const ep = f.endpoint;
+        if (!endpointMap.has(ep))
+            endpointMap.set(ep, []);
+        endpointMap.get(ep).push(f);
+    }
+    const result = [];
+    for (const [name, epFiles] of endpointMap) {
+        if (epFiles.length === 0)
+            continue;
+        // 检测技术栈
+        const frameworks = [];
+        const patterns = ENDPOINT_PATTERNS[name];
+        if (patterns) {
+            for (const [hint, label] of Object.entries(patterns.techHints)) {
+                if (epFiles.some(f => f.imports.some(i => i.includes(hint)) || f.path.includes(hint))) {
+                    frameworks.push(label);
+                }
+            }
+        }
+        // 入口文件猜测
+        const entryCandidates = epFiles.filter(f => f.path.includes('index.') || f.path.includes('main.') || f.path.includes('app.'));
+        const entryFile = entryCandidates.length > 0 ? entryCandidates[0].path : (epFiles[0]?.path || '');
+        // 根路径
+        const paths = epFiles.map(f => f.path.split('/'));
+        const rootParts = [];
+        if (paths.length > 0) {
+            const minLen = Math.min(...paths.map(p => p.length));
+            for (let i = 0; i < minLen - 1; i++) {
+                const vals = new Set(paths.map(p => p[i]));
+                if (vals.size === 1)
+                    rootParts.push(paths[0][i]);
+                else
+                    break;
+            }
+        }
+        const techStack = frameworks.length > 0 ? frameworks.join(' + ') : (epFiles[0]?.language || 'unknown');
+        result.push({
+            name,
+            rootPath: rootParts.join('/') || '.',
+            techStack,
+            entryFile,
+            fileCount: epFiles.length,
+            frameworks,
+        });
+    }
+    return result.sort((a, b) => b.fileCount - a.fileCount);
+}
+// ── 模块分组 ──
+function groupModules(files, endpoints) {
+    const moduleMap = new Map();
+    for (const f of files) {
+        const key = `${f.endpoint}:${f.module}`;
+        if (!moduleMap.has(key))
+            moduleMap.set(key, []);
+        moduleMap.get(key).push(f);
+    }
+    const result = [];
+    for (const [key, modFiles] of moduleMap) {
+        if (modFiles.length === 0)
+            continue;
+        const [endpoint, moduleName] = key.split(':');
+        // 核心文件：按导出数排序 top 3
+        const sorted = [...modFiles].sort((a, b) => b.exports.length - a.exports.length);
+        const coreFiles = sorted.slice(0, 3).map(f => f.path);
+        // 所有导出
+        const allExports = [...new Set(modFiles.flatMap(f => f.exports))].slice(0, 30);
+        // 依赖分析：看 import 指向哪些其他模块
+        const deps = new Set();
+        for (const f of modFiles) {
+            for (const imp of f.imports) {
+                const target = files.find(tf => tf.path.includes(imp.replace(/^\.\.?\//, '')) || imp.includes((0, path_1.basename)(tf.path, '.ts')));
+                if (target && target.module !== moduleName) {
+                    deps.add(target.module);
+                }
+            }
+        }
+        const commonPath = modFiles.map(f => f.path).reduce((a, b) => {
+            const pa = a.split('/'), pb = b.split('/');
+            const common = [];
+            for (let i = 0; i < Math.min(pa.length, pb.length); i++) {
+                if (pa[i] === pb[i])
+                    common.push(pa[i]);
+                else
+                    break;
+            }
+            return common.join('/');
+        });
+        result.push({
+            name: moduleName,
+            path: commonPath || modFiles[0].path,
+            endpoint,
+            fileCount: modFiles.length,
+            coreFiles,
+            exports: allExports,
+            dependencies: [...deps].slice(0, 10),
+        });
+    }
+    return result.sort((a, b) => b.fileCount - a.fileCount);
+}
+// ── git 变更联动分析 ──
+async function analyzeGitCorrelations(files) {
+    const correlations = [];
+    let totalCommits = 0;
+    let analyzedCommits = 0;
+    try {
+        // 取最近 100 次提交的变更文件
+        const gitLog = (0, child_process_1.execSync)('git log --name-only --pretty=format:"---COMMIT---" -100 2>/dev/null', { encoding: 'utf-8', maxBuffer: 10 * 1024 * 1024, timeout: 15000 });
+        // 解析每个 commit 的文件列表
+        const commitFiles = [];
+        let current = [];
+        for (const line of gitLog.split('\n')) {
+            if (line === '---COMMIT---') {
+                if (current.length > 0)
+                    commitFiles.push(current);
+                current = [];
+            }
+            else if (line.trim()) {
+                current.push(line.trim());
+            }
+        }
+        if (current.length > 0)
+            commitFiles.push(current);
+        totalCommits = commitFiles.length;
+        analyzedCommits = Math.min(totalCommits, 100);
+        // 统计文件对共同出现次数
+        const pairCount = new Map();
+        for (const cf of commitFiles) {
+            // 只关注已索引的文件
+            const indexed = cf.filter(f => files.some(idx => idx.path === f));
+            if (indexed.length < 2 || indexed.length > 10)
+                continue;
+            // 按模块分组
+            const modules = [...new Set(indexed.map(f => {
+                    const idx = files.find(fi => fi.path === f);
+                    return idx ? idx.module : '';
+                }))].filter(Boolean);
+            if (modules.length >= 2) {
+                const key = modules.sort().join(' ↔ ');
+                pairCount.set(key, (pairCount.get(key) || 0) + 1);
+            }
+        }
+        // 取 top 10 高频联动
+        const sorted = [...pairCount.entries()]
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 10);
+        for (const [pattern, count] of sorted) {
+            if (count >= 2) {
+                correlations.push({
+                    files: pattern.split(' ↔ '),
+                    count,
+                    pattern: `改 ${pattern.split(' ↔ ')[0]} → ${Math.round(count / analyzedCommits * 100)}% 概率联动 ${pattern.split(' ↔ ')[1]}`,
+                });
+            }
+        }
+    }
+    catch {
+        // git 不可用时跳过
+    }
+    return { correlations, gitStats: { totalCommits, analyzedCommits } };
+}
+// ── 导入提取 ──
+function extractImports(content, lang) {
+    const imports = [];
+    if (lang === 'typescript' || lang === 'javascript') {
+        // import ... from 'xxx'
+        const matches = content.match(/import\s+.*?from\s+['"]([^'"]+)['"]/g) || [];
+        for (const m of matches) {
+            const path = m.match(/['"]([^'"]+)['"]/)?.[1];
+            if (path)
+                imports.push(path);
+        }
+        // require('xxx')
+        const reqMatches = content.match(/require\s*\(\s*['"]([^'"]+)['"]\s*\)/g) || [];
+        for (const m of reqMatches) {
+            const path = m.match(/['"]([^'"]+)['"]/)?.[1];
+            if (path)
+                imports.push(path);
+        }
+    }
+    else if (lang === 'python') {
+        const matches = content.match(/(?:import|from)\s+(\S+)/g) || [];
+        for (const m of matches) {
+            const mod = m.replace(/^(?:import|from)\s+/, '');
+            if (mod)
+                imports.push(mod);
+        }
+    }
+    else if (lang === 'java') {
+        const matches = content.match(/import\s+([\w.]+);/g) || [];
+        for (const m of matches) {
+            imports.push(m.replace('import ', '').replace(';', ''));
+        }
+    }
+    else if (lang === 'go') {
+        const matches = content.match(/"([\w./]+)"/g) || [];
+        for (const m of matches) {
+            imports.push(m.replace(/"/g, ''));
+        }
+    }
+    return [...new Set(imports)].slice(0, 30);
+}
 //# sourceMappingURL=code-scanner.js.map