soloforge 1.1.38 → 1.1.42

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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"}

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

@@ -0,0 +1,45 @@
+/**
+ * dependency_graph 视图 — 依赖图分析。
+ *
+ * 给定目标文件列表，构建模块间依赖的有向图，
+ * 使用 DFS 检测循环依赖，并输出拓扑排序。
+ *
+ * P1 实现：基于 grep 模式解析 import/require，DFS 环检测。
+ */
+import type { ContextView } from "../view_registry.js";
+/** 依赖图中的节点 */
+export interface DepNode {
+    /** 文件绝对路径（规范化后） */
+    path: string;
+    /** 模块名（文件名去掉扩展名，index 取父目录名） */
+    module: string;
+    /** 入度（被其他节点引用的次数） */
+    inDegree: number;
+    /** 出度（引用其他节点的次数） */
+    outDegree: number;
+}
+/** 依赖图中的边 */
+export interface DepEdge {
+    /** 引用方文件路径 */
+    from: string;
+    /** 被引用方文件路径 */
+    to: string;
+    /** 引用类型 */
+    importType: "import" | "require" | "dynamic";
+}
+/** dependency_graph 视图结果数据 */
+export interface DependencyGraphData {
+    /** 图中所有节点 */
+    nodes: DepNode[];
+    /** 图中所有边 */
+    edges: DepEdge[];
+    /** 检测到的循环依赖（每个循环为路径数组） */
+    cycles: string[][];
+    /** 拓扑排序结果（仅 DAG 部分有效） */
+    topologicalOrder: string[];
+}
+/**
+ * dependency_graph 视图：构建模块依赖图，检测循环依赖并输出拓扑排序。
+ */
+export declare const dependencyGraphView: ContextView;
+//# sourceMappingURL=dependency_graph.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dependency_graph.d.ts","sourceRoot":"","sources":["../../../../src/engine/context_engine/views/dependency_graph.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAwB,MAAM,qBAAqB,CAAC;AAK7E,cAAc;AACd,MAAM,WAAW,OAAO;IACtB,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,aAAa;AACb,MAAM,WAAW,OAAO;IACtB,cAAc;IACd,IAAI,EAAE,MAAM,CAAC;IACb,eAAe;IACf,EAAE,EAAE,MAAM,CAAC;IACX,WAAW;IACX,UAAU,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;CAC9C;AAED,8BAA8B;AAC9B,MAAM,WAAW,mBAAmB;IAClC,aAAa;IACb,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,YAAY;IACZ,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,0BAA0B;IAC1B,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;IACnB,yBAAyB;IACzB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AA2VD;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,WAsDjC,CAAC"}