soloforge 1.1.38 → 1.1.40

package/dist/engine/context_engine/views/change_impact.d.ts

@@ -0,0 +1,34 @@
+/**
+ * change_impact 视图 — 变更影响分析。
+ *
+ * 给定变更文件列表，按四级层级（direct / indirect / test / config）
+ * 分析变更波及范围，计算风险评分并推荐需执行的测试。
+ *
+ * P1 实现：基于 grep 模式搜索 import 引用链与配置关联。
+ */
+import type { ContextView } from "../view_registry.js";
+/** 影响层级 */
+export interface ImpactLayer {
+    /** 层级类型 */
+    layer: "direct" | "indirect" | "test" | "config";
+    /** 该层级受影响的文件列表 */
+    files: string[];
+    /** 层级描述 */
+    description: string;
+}
+/** change_impact 视图结果数据 */
+export interface ChangeImpactData {
+    /** 输入的变更文件列表 */
+    changedFiles: string[];
+    /** 四级影响层级 */
+    impactLayers: ImpactLayer[];
+    /** 风险评分 0-100，基于影响广度 */
+    riskScore: number;
+    /** 推荐执行的测试文件 */
+    recommendedTests: string[];
+}
+/**
+ * change_impact 视图：分析变更文件的四级影响范围与风险评分。
+ */
+export declare const changeImpactView: ContextView;
+//# sourceMappingURL=change_impact.d.ts.map

package/dist/engine/context_engine/views/change_impact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change_impact.d.ts","sourceRoot":"","sources":["../../../../src/engine/context_engine/views/change_impact.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAwB,MAAM,qBAAqB,CAAC;AAK7E,WAAW;AACX,MAAM,WAAW,WAAW;IAC1B,WAAW;IACX,KAAK,EAAE,QAAQ,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,CAAC;IACjD,kBAAkB;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW;IACX,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,2BAA2B;AAC3B,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa;IACb,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB;IAChB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AA+ND;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,WA8F9B,CAAC"}

package/dist/engine/context_engine/views/change_impact.js

@@ -0,0 +1,288 @@
+/**
+ * change_impact 视图 — 变更影响分析。
+ *
+ * 给定变更文件列表，按四级层级（direct / indirect / test / config）
+ * 分析变更波及范围，计算风险评分并推荐需执行的测试。
+ *
+ * P1 实现：基于 grep 模式搜索 import 引用链与配置关联。
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { execFileSync } from "node:child_process";
+import { debugLog } from "../../core/logger.js";
+// ── 辅助函数 ──
+/** 判断文件路径是否为测试文件 */
+function isTestFile(filePath) {
+    return /(?:test|spec|__tests__)[./]/i.test(filePath);
+}
+/** 判断文件路径是否为配置文件 */
+function isConfigFile(filePath) {
+    return /\.(json|yaml|yml|toml|env|ini|conf|config)[./]/i.test(filePath) ||
+        /(?:config|\.rc)\b/i.test(filePath);
+}
+/** 从文件路径提取模块标识符（不含扩展名） */
+function extractModuleId(filePath) {
+    const base = path.basename(filePath, path.extname(filePath));
+    // index 文件取父目录名作为模块标识
+    if (base === "index") {
+        return path.basename(path.dirname(filePath));
+    }
+    return base;
+}
+/** 规范化路径为 POSIX 格式的相对路径 */
+function toRelative(root, absPath) {
+    return path.relative(root, absPath).replace(/\\/g, "/");
+}
+/** 规范化路径（去除 ./ 前缀，统一分隔符） */
+function normalizePath(p) {
+    return p.replace(/\\/g, "/").replace(/^\.\//, "");
+}
+/**
+ * 使用 grep 搜索引用指定模块名的文件。
+ * includeTests 为 true 时搜索测试文件，为 false 时搜索源文件。
+ */
+function grepByPattern(root, moduleName, excludes, includeTests = false) {
+    const includeFlags = includeTests
+        ? ["--include=*.test.ts", "--include=*.test.tsx", "--include=*.spec.ts", "--include=*.spec.tsx", "--include=*.ts"]
+        : ["--include=*.ts", "--include=*.tsx", "--include=*.js", "--include=*.jsx"];
+    try {
+        const result = execFileSync("grep", ["-rl", ...includeFlags, "-e", moduleName, root], { encoding: "utf-8", timeout: 10000, maxBuffer: 10 * 1024 * 1024 });
+        return result
+            .split("\n")
+            .map((line) => line.trim())
+            .filter(Boolean)
+            .filter((f) => !excludes.some((exc) => f.endsWith(exc)));
+    }
+    catch {
+        // grep 返回非零表示无匹配
+        return [];
+    }
+}
+/**
+ * 在配置目录中搜索引用指定模块名的配置文件。
+ */
+function grepConfigRefs(root, moduleName) {
+    const configDirs = ["config", "configs", ".config", "templates"]
+        .map((d) => path.join(root, d))
+        .filter((d) => fs.existsSync(d));
+    if (configDirs.length === 0)
+        return [];
+    const matches = [];
+    for (const dir of configDirs) {
+        try {
+            const result = execFileSync("grep", ["-rl", "--include=*.json", "--include=*.yaml", "--include=*.yml", "--include=*.toml", "--include=*.ts", "-e", moduleName, dir], { encoding: "utf-8", timeout: 5000, maxBuffer: 5 * 1024 * 1024 });
+            matches.push(...result.split("\n").map((l) => l.trim()).filter(Boolean));
+        }
+        catch {
+            // 无匹配则跳过
+        }
+    }
+    return [...new Set(matches)];
+}
+// ── 核心分析 ──
+/**
+ * 分析单个变更文件的影响层级。
+ * 逐层搜索直接引用 → 间接引用 → 关联测试 → 关联配置。
+ */
+function analyzeChange(root, changedRelPath) {
+    const normalizedTarget = normalizePath(changedRelPath);
+    const fullPath = path.isAbsolute(normalizedTarget)
+        ? normalizedTarget
+        : path.join(root, normalizedTarget);
+    if (!fs.existsSync(fullPath)) {
+        return {
+            layers: [
+                { layer: "direct", files: [], description: `变更文件 ${normalizedTarget} 不存在，跳过分析` },
+                { layer: "indirect", files: [], description: "无间接影响" },
+                { layer: "test", files: [], description: "无关联测试" },
+                { layer: "config", files: [], description: "无关联配置" },
+            ],
+            tests: [],
+        };
+    }
+    const relPath = toRelative(root, fullPath);
+    const moduleId = extractModuleId(normalizedTarget);
+    const seen = new Set([relPath]);
+    const directFiles = [];
+    const indirectFiles = [];
+    const testFiles = [];
+    const configFiles = [];
+    // ── Layer 1: 直接引用者 ──
+    if (moduleId) {
+        const importers = grepByPattern(root, moduleId, [relPath]);
+        for (const imp of importers) {
+            const rel = toRelative(root, imp);
+            if (seen.has(rel))
+                continue;
+            seen.add(rel);
+            if (isTestFile(rel))
+                testFiles.push(rel);
+            else if (isConfigFile(rel))
+                configFiles.push(rel);
+            else
+                directFiles.push(rel);
+        }
+    }
+    // ── Layer 2: 间接引用者（引用了 Layer 1 文件的文件） ──
+    for (const directFile of directFiles) {
+        const refModuleId = extractModuleId(directFile);
+        if (!refModuleId)
+            continue;
+        const transitive = grepByPattern(root, refModuleId, [directFile]);
+        for (const t of transitive) {
+            const rel = toRelative(root, t);
+            if (seen.has(rel))
+                continue;
+            seen.add(rel);
+            if (isTestFile(rel))
+                testFiles.push(rel);
+            else if (isConfigFile(rel))
+                configFiles.push(rel);
+            else
+                indirectFiles.push(rel);
+        }
+    }
+    // ── Layer 3: 关联测试文件 ──
+    if (moduleId) {
+        const foundTests = grepByPattern(root, moduleId, [], true);
+        for (const tf of foundTests) {
+            const rel = toRelative(root, tf);
+            if (!seen.has(rel)) {
+                seen.add(rel);
+                testFiles.push(rel);
+            }
+        }
+    }
+    // ── Layer 4: 关联配置文件 ──
+    if (moduleId) {
+        const foundConfigs = grepConfigRefs(root, moduleId);
+        for (const cf of foundConfigs) {
+            const rel = toRelative(root, cf);
+            if (!seen.has(rel)) {
+                seen.add(rel);
+                configFiles.push(rel);
+            }
+        }
+    }
+    return {
+        layers: [
+            { layer: "direct", files: [...new Set(directFiles)], description: `直接引用 ${relPath} 的 ${directFiles.length} 个文件` },
+            { layer: "indirect", files: [...new Set(indirectFiles)], description: `间接引用的 ${indirectFiles.length} 个文件` },
+            { layer: "test", files: [...new Set(testFiles)], description: `关联的 ${testFiles.length} 个测试文件` },
+            { layer: "config", files: [...new Set(configFiles)], description: `关联的 ${configFiles.length} 个配置文件` },
+        ],
+        tests: [...new Set(testFiles)],
+    };
+}
+/**
+ * 计算风险评分（0-100）。
+ * 基于受影响文件总数、层级覆盖度和测试覆盖度。
+ */
+function calculateRiskScore(layers) {
+    let score = 0;
+    // 基础分：每个受影响文件贡献分数，上限 40
+    const totalImpacted = layers.reduce((sum, l) => sum + l.files.length, 0);
+    score += Math.min(totalImpacted * 3, 40);
+    // 层级覆盖度：活跃层级越多风险越高
+    const activeLayers = layers.filter((l) => l.files.length > 0).length;
+    score += activeLayers * 10;
+    // 配置影响加分：配置关联风险较高
+    const configLayer = layers.find((l) => l.layer === "config");
+    if (configLayer && configLayer.files.length > 0) {
+        score += 10 + configLayer.files.length * 5;
+    }
+    // 测试覆盖扣分：有测试可降低风险
+    const testLayer = layers.find((l) => l.layer === "test");
+    if (testLayer && testLayer.files.length > 0) {
+        score -= Math.min(testLayer.files.length * 3, 15);
+    }
+    return Math.max(0, Math.min(100, score));
+}
+// ── 视图实现 ──
+/**
+ * change_impact 视图：分析变更文件的四级影响范围与风险评分。
+ */
+export const changeImpactView = {
+    name: "change_impact",
+    capabilities: ["git", "grep"],
+    async analyze(root, params) {
+        const targets = params.targets ?? [];
+        const evidence = [];
+        debugLog(`change_impact: 分析 ${targets.length} 个变更文件的影响范围`);
+        // 汇总所有变更文件的影响
+        const allFiles = new Map([
+            ["direct", new Set()],
+            ["indirect", new Set()],
+            ["test", new Set()],
+            ["config", new Set()],
+        ]);
+        const allRecommendedTests = new Set();
+        for (const target of targets) {
+            const { layers, tests } = analyzeChange(root, target);
+            for (const layer of layers) {
+                for (const file of layer.files) {
+                    allFiles.get(layer.layer).add(file);
+                }
+            }
+            for (const test of tests) {
+                allRecommendedTests.add(test);
+            }
+        }
+        // 构建影响层级结果
+        const impactLayers = [
+            { layer: "direct", files: [...allFiles.get("direct")], description: `直接引用变更文件的 ${allFiles.get("direct").size} 个模块` },
+            { layer: "indirect", files: [...allFiles.get("indirect")], description: `间接依赖的 ${allFiles.get("indirect").size} 个模块` },
+            { layer: "test", files: [...allFiles.get("test")], description: `需执行的 ${allFiles.get("test").size} 个测试文件` },
+            { layer: "config", files: [...allFiles.get("config")], description: `关联的 ${allFiles.get("config").size} 个配置文件` },
+        ];
+        const riskScore = calculateRiskScore(impactLayers);
+        const recommendedTests = [...allRecommendedTests];
+        const data = { changedFiles: targets, impactLayers, riskScore, recommendedTests };
+        // 证据：直接引用
+        if (allFiles.get("direct").size > 0) {
+            evidence.push({
+                type: "grep_match",
+                verify_command: `grep -rl "${targets[0] ?? ""}" --include="*.ts" .`,
+                source: `共 ${allFiles.get("direct").size} 个直接引用`,
+            });
+        }
+        // 证据：测试覆盖
+        if (recommendedTests.length > 0) {
+            evidence.push({
+                type: "grep_match",
+                verify_command: `grep -rl --include="*.test.ts" --include="*.spec.ts" "${targets[0] ?? ""}" .`,
+                source: `共 ${recommendedTests.length} 个推荐测试`,
+            });
+        }
+        // 证据：配置关联
+        if (allFiles.get("config").size > 0) {
+            evidence.push({
+                type: "grep_match",
+                verify_command: `grep -rl --include="*.json" --include="*.yaml" "${targets[0] ?? ""}" config/`,
+                source: `共 ${allFiles.get("config").size} 个关联配置`,
+            });
+        }
+        // 证据：风险评分
+        evidence.push({
+            type: "grep_match",
+            verify_command: `git diff --name-only`,
+            source: `风险评分 ${riskScore}/100，基于 ${targets.length} 个变更文件`,
+        });
+        // 摘要
+        const totalImpacted = impactLayers.reduce((sum, l) => sum + l.files.length, 0);
+        const riskLabel = riskScore >= 70 ? "高" : riskScore >= 40 ? "中" : "低";
+        return {
+            view: "change_impact",
+            summary: `分析了 ${targets.length} 个变更文件: ` +
+                `影响 ${totalImpacted} 个文件（直接 ${allFiles.get("direct").size}, ` +
+                `间接 ${allFiles.get("indirect").size}, ` +
+                `测试 ${allFiles.get("test").size}, ` +
+                `配置 ${allFiles.get("config").size}）` +
+                ` | 风险评分 ${riskScore}/100（${riskLabel}）` +
+                ` | 推荐 ${recommendedTests.length} 个测试`,
+            data: data,
+            evidence,
+        };
+    },
+};
+//# sourceMappingURL=change_impact.js.map

package/dist/engine/context_engine/views/change_impact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"change_impact.js","sourceRoot":"","sources":["../../../../src/engine/context_engine/views/change_impact.ts"],"names":[],"mappings":"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"}

package/dist/engine/context_engine/views/coverage_gap.d.ts

@@ -0,0 +1,45 @@
+/**
+ * coverage_gap 视图 — 测试覆盖率缺口分析。
+ *
+ * 给定目标源码目录或文件列表，扫描每个源文件的导出符号，
+ * 检测是否存在对应的测试文件，并 grep 测试文件中是否覆盖了
+ * 各导出符号，最终生成覆盖率缺口报告。
+ *
+ * P1 实现：基于 grep 模式的导出符号匹配与测试文件检测。
+ */
+import type { ContextView } from "../view_registry.js";
+/** 单个源文件的覆盖率信息 */
+export interface CoverageItem {
+    /** 源文件相对路径 */
+    sourcePath: string;
+    /** 对应测试文件路径（约定 src/X.ts → tests/X.test.ts），无测试则为 null */
+    testPath: string | null;
+    /** 是否存在单元测试文件 */
+    hasUnitTests: boolean;
+    /** 是否存在集成测试文件 */
+    hasIntegrationTests: boolean;
+    /** 导出符号总数 */
+    exportedSymbols: number;
+    /** 已被测试覆盖的符号数 */
+    testedSymbols: number;
+}
+/** coverage_gap 视图结果数据 */
+export interface CoverageGapData {
+    /** 逐文件覆盖率明细 */
+    items: CoverageItem[];
+    /** 分析的源文件总数 */
+    totalSources: number;
+    /** 有对应测试文件的源文件数 */
+    covered: number;
+    /** 无测试文件的源文件数 */
+    uncovered: number;
+    /** 文件级覆盖率百分比（0-100） */
+    coveragePercent: number;
+    /** 缺口描述列表（人类可读） */
+    gaps: string[];
+}
+/**
+ * coverage_gap 视图：分析目标源码目录/文件的测试覆盖率缺口。
+ */
+export declare const coverageGapView: ContextView;
+//# sourceMappingURL=coverage_gap.d.ts.map

package/dist/engine/context_engine/views/coverage_gap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage_gap.d.ts","sourceRoot":"","sources":["../../../../src/engine/context_engine/views/coverage_gap.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAwB,MAAM,qBAAqB,CAAC;AAK7E,kBAAkB;AAClB,MAAM,WAAW,YAAY;IAC3B,cAAc;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,iBAAiB;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,iBAAiB;IACjB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,aAAa;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,0BAA0B;AAC1B,MAAM,WAAW,eAAe;IAC9B,eAAe;IACf,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,eAAe;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,uBAAuB;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAuKD;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,WAoF7B,CAAC"}

package/dist/engine/context_engine/views/coverage_gap.js

@@ -0,0 +1,238 @@
+/**
+ * coverage_gap 视图 — 测试覆盖率缺口分析。
+ *
+ * 给定目标源码目录或文件列表，扫描每个源文件的导出符号，
+ * 检测是否存在对应的测试文件，并 grep 测试文件中是否覆盖了
+ * 各导出符号，最终生成覆盖率缺口报告。
+ *
+ * P1 实现：基于 grep 模式的导出符号匹配与测试文件检测。
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { debugLog } from "../../core/logger.js";
+// ── 辅助函数 ──
+/** 需要跳过的源文件模式 */
+const SKIP_PATTERNS = /(?:index\.ts$|\.d\.ts$|\.types\.ts$|\.test\.ts$|\.spec\.ts$)/;
+/** 判断文件是否应跳过分析 */
+function shouldSkipFile(fileName) {
+    return SKIP_PATTERNS.test(fileName);
+}
+/**
+ * 从源文件内容中提取导出的函数名和类名。
+ * 匹配 export function/export class/export const/export default 等模式。
+ */
+function extractExportedSymbols(fileContent) {
+    const symbols = [];
+    // 匹配 export function / export async function 模式
+    const funcPattern = /export\s+(?:async\s+)?function\s+(\w+)/g;
+    let match;
+    while ((match = funcPattern.exec(fileContent)) !== null) {
+        symbols.push(match[1]);
+    }
+    // 匹配 export class 模式
+    const classPattern = /export\s+class\s+(\w+)/g;
+    while ((match = classPattern.exec(fileContent)) !== null) {
+        symbols.push(match[1]);
+    }
+    // 匹配 export const / export let / export var 模式
+    const constPattern = /export\s+(?:const|let|var)\s+(\w+)/g;
+    while ((match = constPattern.exec(fileContent)) !== null) {
+        symbols.push(match[1]);
+    }
+    // export { xxx } 形式的具名导出
+    const namedPattern = /export\s*\{\s*([^}]+)\s*\}/g;
+    while ((match = namedPattern.exec(fileContent)) !== null) {
+        const names = match[1].split(",").map((s) => s.trim().split(/\s+as\s+/).pop()?.trim());
+        for (const name of names) {
+            if (name)
+                symbols.push(name);
+        }
+    }
+    return [...new Set(symbols)];
+}
+/**
+ * 根据源文件路径推导约定测试文件路径。
+ * 约定：src/X.ts → tests/X.test.ts，src/dir/Y.ts → tests/dir/Y.test.ts。
+ */
+function inferTestPath(sourceRelPath) {
+    // 将 src/ 前缀替换为 tests/，并追加 .test 后缀
+    const normalized = sourceRelPath.replace(/^src\//, "");
+    const baseName = path.basename(normalized, path.extname(normalized));
+    const dirName = path.dirname(normalized);
+    const testFileName = `${baseName}.test.ts`;
+    return dirName === "." ? `tests/${testFileName}` : `tests/${dirName}/${testFileName}`;
+}
+/**
+ * 在测试文件内容中搜索指定符号是否出现。
+ * 简单的字符串包含检查，适用于标识符级别的匹配。
+ */
+function grepSymbolInContent(content, symbol) {
+    // 使用单词边界确保是标识符引用，不是子串匹配
+    const pattern = new RegExp(`\\b${symbol.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\b`);
+    return pattern.test(content);
+}
+/**
+ * 递归扫描目录下的 .ts 源文件（排除跳过模式）。
+ */
+function walkSourceFiles(dirPath) {
+    const results = [];
+    if (!fs.existsSync(dirPath))
+        return results;
+    const entries = fs.readdirSync(dirPath, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dirPath, entry.name);
+        if (entry.isDirectory()) {
+            // 跳过 node_modules 和隐藏目录
+            if (entry.name === "node_modules" || entry.name.startsWith("."))
+                continue;
+            results.push(...walkSourceFiles(fullPath));
+        }
+        else if (entry.isFile() && entry.name.endsWith(".ts") && !shouldSkipFile(entry.name)) {
+            results.push(fullPath);
+        }
+    }
+    return results;
+}
+/** 规范化路径为 POSIX 相对路径 */
+function toRelative(root, absPath) {
+    return path.relative(root, absPath).replace(/\\/g, "/");
+}
+// ── 核心分析 ──
+/**
+ * 分析单个源文件的测试覆盖率。
+ */
+function analyzeCoverageItem(root, sourceAbsPath) {
+    const sourceRel = toRelative(root, sourceAbsPath);
+    const testRel = inferTestPath(sourceRel);
+    const testAbs = path.join(root, testRel);
+    const hasUnitTests = fs.existsSync(testAbs);
+    // 集成测试：检查 tests/integration/ 目录下是否有引用该源文件的测试
+    const integrationDir = path.join(root, "tests", "integration");
+    let hasIntegrationTests = false;
+    if (fs.existsSync(integrationDir)) {
+        try {
+            const integrationFiles = walkSourceFiles(integrationDir);
+            const moduleName = path.basename(sourceAbsPath, ".ts");
+            hasIntegrationTests = integrationFiles.some((f) => {
+                const content = fs.readFileSync(f, "utf-8");
+                return grepSymbolInContent(content, moduleName);
+            });
+        }
+        catch {
+            // 读取失败时视为无集成测试
+            hasIntegrationTests = false;
+        }
+    }
+    // 提取导出符号
+    let exportedSymbols = [];
+    try {
+        const sourceContent = fs.readFileSync(sourceAbsPath, "utf-8");
+        exportedSymbols = extractExportedSymbols(sourceContent);
+    }
+    catch {
+        // 读取失败时视为无导出符号
+        exportedSymbols = [];
+    }
+    // 检查各符号是否被测试覆盖
+    let testedSymbols = 0;
+    if (hasUnitTests) {
+        try {
+            const testContent = fs.readFileSync(testAbs, "utf-8");
+            for (const symbol of exportedSymbols) {
+                if (grepSymbolInContent(testContent, symbol)) {
+                    testedSymbols++;
+                }
+            }
+        }
+        catch {
+            // 测试文件读取失败时不计入覆盖
+        }
+    }
+    return {
+        sourcePath: sourceRel,
+        testPath: hasUnitTests ? testRel : null,
+        hasUnitTests,
+        hasIntegrationTests,
+        exportedSymbols: exportedSymbols.length,
+        testedSymbols,
+    };
+}
+// ── 视图实现 ──
+/**
+ * coverage_gap 视图：分析目标源码目录/文件的测试覆盖率缺口。
+ */
+export const coverageGapView = {
+    name: "coverage_gap",
+    capabilities: ["grep", "coverage"],
+    async analyze(root, params) {
+        const targets = params.targets ?? [];
+        const evidence = [];
+        const gaps = [];
+        debugLog(`coverage_gap: 分析 ${targets.length} 个目标目录/文件的覆盖率缺口`);
+        // 收集所有需要分析的源文件
+        const sourceFiles = [];
+        for (const target of targets) {
+            const targetAbs = path.isAbsolute(target) ? target : path.join(root, target);
+            const stat = fs.statSync(targetAbs);
+            if (stat.isDirectory()) {
+                sourceFiles.push(...walkSourceFiles(targetAbs));
+            }
+            else if (stat.isFile() && target.endsWith(".ts") && !shouldSkipFile(path.basename(target))) {
+                sourceFiles.push(targetAbs);
+            }
+        }
+        // 逐文件分析覆盖率
+        const items = sourceFiles.map((src) => analyzeCoverageItem(root, src));
+        const totalSources = items.length;
+        const covered = items.filter((i) => i.hasUnitTests || i.hasIntegrationTests).length;
+        const uncovered = totalSources - covered;
+        const coveragePercent = totalSources > 0 ? Math.round((covered / totalSources) * 100) : 100;
+        // 收集缺口描述
+        for (const item of items) {
+            if (!item.hasUnitTests && !item.hasIntegrationTests) {
+                gaps.push(`缺少测试文件: ${item.sourcePath}`);
+            }
+            else if (item.exportedSymbols > 0 && item.testedSymbols < item.exportedSymbols) {
+                const untested = item.exportedSymbols - item.testedSymbols;
+                gaps.push(`符号覆盖不足: ${item.sourcePath} (${untested}/${item.exportedSymbols} 未覆盖)`);
+            }
+        }
+        // 证据：无测试文件的源文件
+        const uncoveredItems = items.filter((i) => !i.hasUnitTests && !i.hasIntegrationTests);
+        if (uncoveredItems.length > 0) {
+            evidence.push({
+                type: "grep_match",
+                verify_command: `ls ${uncoveredItems.map((i) => i.sourcePath).join(" ")}`,
+                source: `共 ${uncoveredItems.length} 个源文件无对应测试文件`,
+            });
+        }
+        // 证据：符号级缺口汇总
+        const symbolGapItems = items.filter((i) => i.exportedSymbols > 0 && i.testedSymbols < i.exportedSymbols);
+        if (symbolGapItems.length > 0) {
+            const totalUntested = symbolGapItems.reduce((sum, i) => sum + (i.exportedSymbols - i.testedSymbols), 0);
+            evidence.push({
+                type: "coverage_report",
+                verify_command: `grep -rn "export function\\|export class\\|export const" --include="*.ts" ${targets.join(" ")}`,
+                source: `共 ${totalUntested} 个导出符号未被测试覆盖`,
+            });
+        }
+        const data = {
+            items,
+            totalSources,
+            covered,
+            uncovered,
+            coveragePercent,
+            gaps,
+        };
+        return {
+            view: "coverage_gap",
+            summary: `分析了 ${totalSources} 个源文件: ` +
+                `文件级覆盖率 ${coveragePercent}% (${covered}/${totalSources}), ` +
+                `${uncovered} 个文件缺少测试` +
+                (gaps.length > 0 ? `, ${gaps.length} 个覆盖率缺口` : ""),
+            data: data,
+            evidence,
+        };
+    },
+};
+//# sourceMappingURL=coverage_gap.js.map

package/dist/engine/context_engine/views/coverage_gap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage_gap.js","sourceRoot":"","sources":["../../../../src/engine/context_engine/views/coverage_gap.ts"],"names":[],"mappings":"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"}