soloforge 1.0.0

package/dist/engine/team_awareness.js

@@ -0,0 +1,121 @@
+export async function getTeamStatus(input) {
+    const { projectPath, gitOps, knowledgeIndex } = input;
+    const since = input.since ?? defaultSince();
+    const result = {
+        activity_feed: [],
+        member_workloads: [],
+        recent_knowledge: [],
+        stale_branches: [],
+        summary: "",
+    };
+    // 1. Activity feed
+    try {
+        const log = await gitOps.getLog(projectPath, { since, maxCount: 50 });
+        result.activity_feed = log.map((entry) => ({
+            author: entry.author,
+            date: entry.date,
+            message: entry.message,
+            short_hash: entry.shortHash,
+            files_changed: 0, // not available from log alone
+        }));
+    }
+    catch (e) {
+        console.debug("[soloforge]", e);
+    }
+    // 2. Member workloads
+    try {
+        const shortlog = await gitOps.getShortlog(projectPath, since);
+        for (const { author, count } of shortlog) {
+            try {
+                const authorLog = await gitOps.getLog(projectPath, { author, since, maxCount: 20 });
+                const activeFiles = extractFilesFromMessages(authorLog.map((e) => e.message));
+                result.member_workloads.push({
+                    author,
+                    commit_count: count,
+                    active_files: activeFiles,
+                    last_active: authorLog.length > 0 ? authorLog[0].date : "",
+                });
+            }
+            catch (e) {
+                console.debug("[soloforge]", e);
+            }
+        }
+    }
+    catch (e) {
+        console.debug("[soloforge]", e);
+    }
+    // 3. Stale branches
+    // TODO: getLog has no branch/ref parameter, so we cannot query per-branch log.
+    // The `path` filter treats branch.name as a file path, which is incorrect.
+    // A proper fix requires adding a `ref` option to GitOperations.getLog
+    // or using `git log <branch> -1 --format=%aI` directly.
+    try {
+        const branches = await gitOps.listBranches(projectPath);
+        for (const branch of branches) {
+            if (branch.isCurrent)
+                continue;
+            try {
+                const branchLog = await gitOps.getLog(projectPath, { maxCount: 1, path: branch.name });
+                if (branchLog.length > 0) {
+                    const lastDate = new Date(branchLog[0].date);
+                    const daysSince = (Date.now() - lastDate.getTime()) / (1000 * 60 * 60 * 24);
+                    if (daysSince > 30) {
+                        result.stale_branches.push({
+                            name: branch.name,
+                            last_commit_date: branchLog[0].date,
+                        });
+                    }
+                }
+            }
+            catch (e) {
+                console.debug("[soloforge]", e);
+            }
+        }
+    }
+    catch (e) {
+        console.debug("[soloforge]", e);
+    }
+    // 4. Recent knowledge updates
+    if (knowledgeIndex) {
+        try {
+            const allEntries = knowledgeIndex.getAllEntries();
+            const sinceDate = new Date(since);
+            const combined = [...allEntries.global, ...allEntries.project];
+            result.recent_knowledge = combined
+                .filter((e) => e.status === "active" && new Date(e.updated_at) >= sinceDate)
+                .map((e) => ({ name: e.name, type: e.type, updated: e.updated_at }));
+        }
+        catch (e) {
+            console.debug("[soloforge]", e);
+        }
+    }
+    // 5. Summary
+    const parts = [];
+    if (result.member_workloads.length > 0) {
+        parts.push(`${result.member_workloads.length} 名活跃成员`);
+    }
+    if (result.stale_branches.length > 0) {
+        parts.push(`${result.stale_branches.length} 个过期分支`);
+    }
+    if (result.recent_knowledge.length > 0) {
+        parts.push(`${result.recent_knowledge.length} 条知识更新`);
+    }
+    result.summary = parts.length > 0 ? parts.join("，") : "暂无团队活动";
+    return result;
+}
+function defaultSince() {
+    const d = new Date();
+    d.setDate(d.getDate() - 7);
+    return d.toISOString().split("T")[0];
+}
+function extractFilesFromMessages(messages) {
+    const files = new Set();
+    for (const msg of messages) {
+        const matches = msg.matchAll(/[\w/.-]+\.(java|ts|tsx|js|jsx|py|go|rs)/g);
+        for (const m of matches) {
+            files.add(m[0]);
+        }
+    }
+    return [...files].slice(0, 10);
+}
+//# sourceMappingURL=team_awareness.js.map

package/dist/engine/team_awareness.js.map

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

package/dist/engine/test_generator.d.ts

@@ -0,0 +1,9 @@
+import type { TestGenGuide, ProjectConfig } from "../types.js";
+/**
+ * Generate test generation guides for changed files.
+ *
+ * Pure rule-based — zero AI dependencies.
+ * Maps file types to test strategies and produces actionable guides.
+ */
+export declare function generateTestGuide(changedFiles: string[], knowledgePatterns: string[], _config: ProjectConfig): TestGenGuide[];
+//# sourceMappingURL=test_generator.d.ts.map

package/dist/engine/test_generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test_generator.d.ts","sourceRoot":"","sources":["../../src/engine/test_generator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAgB,aAAa,EAAE,MAAM,aAAa,CAAC;AA2L7E;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,EAAE,EACtB,iBAAiB,EAAE,MAAM,EAAE,EAC3B,OAAO,EAAE,aAAa,GACrB,YAAY,EAAE,CA+BhB"}

package/dist/engine/test_generator.js

@@ -0,0 +1,241 @@
+import path from "node:path";
+const FILE_TEST_MAP = [
+    {
+        pattern: /Controller\.java$/,
+        test_type: "integration",
+        fixture: "@SpringBootTest + MockMvc",
+        mock: "@MockBean Service 层依赖",
+    },
+    {
+        pattern: /Service\.java$/,
+        test_type: "unit",
+        fixture: "@ExtendWith(MockitoExtension)",
+        mock: "@Mock Mapper/Repository 层依赖",
+    },
+    {
+        pattern: /Mapper\.java$|Repository\.java$/,
+        test_type: "integration",
+        fixture: "@MybatisTest / @DataJpaTest",
+        mock: "测试数据库或 H2 内存库",
+    },
+    {
+        pattern: /api\/|route/,
+        test_type: "e2e",
+        fixture: "supertest(app)",
+        mock: "数据库和外部服务模拟",
+    },
+    {
+        pattern: /\.tsx?$/,
+        test_type: "unit",
+        fixture: "render() + fireEvent()",
+        mock: "jest.mock() 模拟外部依赖",
+    },
+];
+// ────────────────────────────────────────────
+// Default scenarios per test type
+// ────────────────────────────────────────────
+const DEFAULT_SCENARIOS = {
+    unit: [
+        {
+            name: "正常输入返回预期结果",
+            given: "输入合法的参数",
+            when: "调用被测函数/方法",
+            then: "返回值符合预期",
+            priority: "high",
+        },
+        {
+            name: "空值/null 输入正确处理",
+            given: "输入为 null / undefined / 空字符串",
+            when: "调用被测函数/方法",
+            then: "抛出异常或返回安全的默认值",
+            priority: "high",
+        },
+        {
+            name: "边界条件处理",
+            given: "输入处于边界值 (如 0, MAX_VALUE, 空数组)",
+            when: "调用被测函数/方法",
+            then: "返回值符合边界约定",
+            priority: "medium",
+        },
+    ],
+    integration: [
+        {
+            name: "完整请求链路返回正确状态码",
+            given: "发起一个完整的 HTTP 请求",
+            when: "请求经过 Controller → Service → Mapper/Repository",
+            then: "返回正确的状态码和响应体",
+            priority: "high",
+        },
+        {
+            name: "数据持久化后可正确查询",
+            given: "通过接口写入一条数据",
+            when: "查询相同条件",
+            then: "能正确检索到写入的数据",
+            priority: "high",
+        },
+        {
+            name: "异常输入返回适当错误码",
+            given: "发送格式错误或非法参数的请求",
+            when: "请求经过各层处理",
+            then: "返回 400/422 等适当的错误状态码和错误信息",
+            priority: "medium",
+        },
+    ],
+    e2e: [
+        {
+            name: "用户完整操作流程畅通",
+            given: "用户处于初始状态",
+            when: "执行完整的用户操作链路",
+            then: "最终状态符合预期",
+            priority: "high",
+        },
+        {
+            name: "错误状态正确展示",
+            given: "用户触发一个错误场景",
+            when: "页面渲染错误响应",
+            then: "错误信息正确展示且不影响其他功能",
+            priority: "medium",
+        },
+    ],
+};
+const KNOWLEDGE_SCENARIOS = [
+    {
+        keywords: ["并发", "concurrent", "thread", "lock", "mutex", "race"],
+        scenario: {
+            name: "并发场景下数据一致性",
+            given: "多个请求同时操作同一资源",
+            when: "并发执行",
+            then: "数据保持一致性，无脏写",
+            priority: "high",
+        },
+    },
+    {
+        keywords: ["权限", "permission", "auth", "rbac", "role"],
+        scenario: {
+            name: "权限校验正确拦截非法访问",
+            given: "用户无对应操作权限",
+            when: "尝试访问受限资源",
+            then: "返回 403 或抛出权限异常",
+            priority: "high",
+        },
+    },
+    {
+        keywords: ["缓存", "cache", "redis", "expire", "ttl"],
+        scenario: {
+            name: "缓存命中与未命中行为一致",
+            given: "同一请求首次和后续调用",
+            when: "缓存从空到有再到过期",
+            then: "业务结果一致",
+            priority: "medium",
+        },
+    },
+    {
+        keywords: ["分页", "pagination", "page", "limit", "offset"],
+        scenario: {
+            name: "分页参数边界验证",
+            given: "传入 page=0, page=-1, limit=0 等非法分页参数",
+            when: "执行分页查询",
+            then: "返回合理结果或参数校验错误",
+            priority: "medium",
+        },
+    },
+    {
+        keywords: ["文件上传", "upload", "multipart", "attachment"],
+        scenario: {
+            name: "文件大小和格式校验",
+            given: "上传超大文件或非法格式文件",
+            when: "执行上传操作",
+            then: "返回明确的校验错误信息",
+            priority: "high",
+        },
+    },
+    {
+        keywords: ["事务", "transaction", "rollback", "commit"],
+        scenario: {
+            name: "事务回滚后数据恢复原状",
+            given: "操作执行过程中发生异常",
+            when: "事务触发回滚",
+            then: "所有变更被正确撤销",
+            priority: "high",
+        },
+    },
+];
+/**
+ * Generate test generation guides for changed files.
+ *
+ * Pure rule-based — zero AI dependencies.
+ * Maps file types to test strategies and produces actionable guides.
+ */
+export function generateTestGuide(changedFiles, knowledgePatterns, _config) {
+    const guides = [];
+    for (const file of changedFiles) {
+        // Match against FILE_TEST_MAP
+        const mapping = matchFileTestMapping(file);
+        if (!mapping) {
+            continue;
+        }
+        // Determine test file suggestion
+        const testFileSuggestion = suggestTestFilePath(file, mapping.test_type);
+        // Base scenarios for this test type
+        const scenarios = structuredClone(DEFAULT_SCENARIOS[mapping.test_type]);
+        // Add knowledge-driven scenarios if keywords match
+        const extraScenarios = matchKnowledgeScenarios(file, knowledgePatterns);
+        scenarios.push(...extraScenarios);
+        guides.push({
+            source_file: file,
+            test_type: mapping.test_type,
+            test_file_suggestion: testFileSuggestion,
+            scenarios,
+            fixtures_needed: [mapping.fixture],
+            mock_points: [mapping.mock],
+        });
+    }
+    return guides;
+}
+// ────────────────────────────────────────────
+// Internal helpers
+// ────────────────────────────────────────────
+function matchFileTestMapping(filePath) {
+    for (const mapping of FILE_TEST_MAP) {
+        if (mapping.pattern.test(filePath)) {
+            return mapping;
+        }
+    }
+    return null;
+}
+function suggestTestFilePath(sourceFile, testType) {
+    const ext = path.extname(sourceFile);
+    const base = sourceFile.slice(0, -ext.length);
+    if (ext === ".java") {
+        // Java convention: ClassName → ClassNameTest, src/main/java → src/test/java
+        const dir = path.dirname(sourceFile);
+        const fileName = path.basename(sourceFile, ext);
+        const testDir = dir
+            .replace(/(^|\/)src\/main\/java(\/|$)/, "$1src/test/java$2")
+            .replace(/(^|\/)src\/main\/kotlin(\/|$)/, "$1src/test/kotlin$2");
+        return path.join(testDir, `${fileName}Test.java`);
+    }
+    // TypeScript / JavaScript: *.ts → *.test.ts, *.tsx → *.test.tsx
+    const testExt = `.test${ext}`;
+    return `${base}${testExt}`;
+}
+function matchKnowledgeScenarios(file, knowledgePatterns) {
+    const matched = [];
+    const seenNames = new Set();
+    // Build a combined search text from file path + knowledge patterns
+    const searchText = (file + " " + knowledgePatterns.join(" ")).toLowerCase();
+    for (const entry of KNOWLEDGE_SCENARIOS) {
+        if (seenNames.has(entry.scenario.name)) {
+            continue;
+        }
+        for (const keyword of entry.keywords) {
+            if (searchText.includes(keyword.toLowerCase())) {
+                matched.push(structuredClone(entry.scenario));
+                seenNames.add(entry.scenario.name);
+                break;
+            }
+        }
+    }
+    return matched;
+}
+//# sourceMappingURL=test_generator.js.map

package/dist/engine/test_generator.js.map

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

package/dist/engine/test_quality.d.ts

@@ -0,0 +1,9 @@
+import type { TestQualityReport } from "../types.js";
+/**
+ * Analyze test quality for a given test file.
+ *
+ * Pure rule-based analysis — zero AI dependencies.
+ * Returns a structured report with scored checks and suggestions.
+ */
+export declare function analyzeTestQuality(testContent: string, filename: string): TestQualityReport;
+//# sourceMappingURL=test_quality.d.ts.map

package/dist/engine/test_quality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test_quality.d.ts","sourceRoot":"","sources":["../../src/engine/test_quality.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEvE;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,iBAAiB,CAmDnB"}

package/dist/engine/test_quality.js

@@ -0,0 +1,256 @@
+/**
+ * Analyze test quality for a given test file.
+ *
+ * Pure rule-based analysis — zero AI dependencies.
+ * Returns a structured report with scored checks and suggestions.
+ */
+export function analyzeTestQuality(testContent, filename) {
+    const checks = [];
+    const suggestions = [];
+    // ── 1. assertion_density ──
+    const assertionDensityCheck = checkAssertionDensity(testContent);
+    checks.push(assertionDensityCheck);
+    if (!assertionDensityCheck.passed) {
+        suggestions.push("建议为每个测试函数添加至少一个断言 (expect/assert)");
+    }
+    // ── 2. boundary_coverage ──
+    const boundaryCheck = checkBoundaryCoverage(testContent);
+    checks.push(boundaryCheck);
+    if (!boundaryCheck.passed) {
+        suggestions.push("建议增加边界值测试 (null, undefined, 空值, 极端值等)");
+    }
+    // ── 3. naming ──
+    const namingCheck = checkNaming(testContent);
+    checks.push(namingCheck);
+    if (!namingCheck.passed) {
+        suggestions.push("建议使用更具描述性的测试命名 (should/when/returns/handles/throws)");
+    }
+    // ── 4. duplication ──
+    const duplicationCheck = checkDuplication(testContent);
+    checks.push(duplicationCheck);
+    if (!duplicationCheck.passed) {
+        suggestions.push("建议提取公共断言为辅助函数，减少重复断言");
+    }
+    // ── 5. scenario_coverage ──
+    const scenarioCheck = checkScenarioCoverage();
+    checks.push(scenarioCheck);
+    // ── Score calculation ──
+    let score = 100;
+    for (const check of checks) {
+        if (!check.passed) {
+            score -= 20;
+        }
+    }
+    score = Math.max(0, score);
+    return {
+        file: filename,
+        score,
+        checks,
+        suggestions,
+    };
+}
+// ────────────────────────────────────────────
+// Check implementations
+// ────────────────────────────────────────────
+function checkAssertionDensity(content) {
+    // Count test function occurrences
+    const testFnMatches = content.match(/\b(it|test|@Test)\s*\(/g) ?? [];
+    const testCount = testFnMatches.length;
+    if (testCount === 0) {
+        return {
+            dimension: "assertion_density",
+            passed: false,
+            detail: "未检测到测试函数",
+        };
+    }
+    // Count assertion occurrences
+    const assertMatches = content.match(/\b(expect|assert|assertEquals|assertThat|assertStrictEquals)\s*\(/g) ?? [];
+    // Filter out non-assertion matchers (e.g. expect.any(), expect.arrayContaining(), etc.)
+    const matcherSuffixes = ["any(", "arrayContaining(", "objectContaining(", "stringContaining(", "stringMatching(", "extend(", "anything(", "closeTo(", "assertions("];
+    const assertCount = assertMatches.filter((m) => {
+        // For expect( calls, check what follows the opening paren
+        const expectMatch = m.match(/^expect\s*\($/);
+        if (expectMatch) {
+            // Find the position of this match in content and check what follows
+            const idx = content.indexOf(m);
+            const afterOpen = content.slice(idx + m.length).trimStart();
+            return !matcherSuffixes.some((suffix) => afterOpen.startsWith(suffix));
+        }
+        return true;
+    }).length;
+    const density = assertCount / testCount;
+    if (density >= 1.0) {
+        return {
+            dimension: "assertion_density",
+            passed: true,
+            detail: `断言密度: ${density.toFixed(1)} (${assertCount} 断言 / ${testCount} 测试)`,
+        };
+    }
+    return {
+        dimension: "assertion_density",
+        passed: false,
+        detail: `断言密度不足: ${density.toFixed(1)} (${assertCount} 断言 / ${testCount} 测试, 阈值 >= 1.0)`,
+    };
+}
+function checkBoundaryCoverage(content) {
+    // Only search within expect() contexts to avoid matching in URLs, ports, imports, etc.
+    // Extract all expect(...) blocks (non-greedy, up to closing paren at depth 0)
+    const expectContexts = [];
+    const expectRegex = /\bexpect\s*\(/g;
+    let expectMatch;
+    while ((expectMatch = expectRegex.exec(content)) !== null) {
+        // Skip matchers like expect.any(), expect.arrayContaining(), etc.
+        const afterOpen = content.slice(expectMatch.index + expectMatch[0].length).trimStart();
+        if (/^(any|arrayContaining|objectContaining|stringContaining|stringMatching|extend|anything|closeTo|assertions)\s*\(/.test(afterOpen)) {
+            continue;
+        }
+        // Extract the expect block content (up to the matching closing paren)
+        let depth = 1;
+        let pos = expectMatch.index + expectMatch[0].length;
+        while (pos < content.length && depth > 0) {
+            if (content[pos] === "(")
+                depth++;
+            else if (content[pos] === ")")
+                depth--;
+            pos++;
+        }
+        expectContexts.push(content.slice(expectMatch.index, pos));
+    }
+    // Also search within it()/test() block bodies (after the opening callback)
+    const testBlockRegex = /\b(?:it|test)\s*\(\s*["'`][^"'`]*["'`]\s*,\s*(?:async\s+)?/g;
+    let testMatch;
+    while ((testMatch = testBlockRegex.exec(content)) !== null) {
+        // Extract the block body after the callback start
+        let depth = 0;
+        let pos = testMatch.index + testMatch[0].length;
+        while (pos < content.length && depth >= 0) {
+            if (content[pos] === "{")
+                depth++;
+            else if (content[pos] === "}") {
+                depth--;
+                if (depth === 0) {
+                    pos++;
+                    break;
+                }
+            }
+            pos++;
+        }
+        expectContexts.push(content.slice(testMatch.index, pos));
+    }
+    const searchableText = expectContexts.join("\n");
+    // Skip comment lines and import statements
+    const filteredLines = searchableText
+        .split("\n")
+        .filter((line) => !line.trim().startsWith("//") && !line.trim().startsWith("*") && !line.trimStart().startsWith("import "));
+    const filteredText = filteredLines.join("\n");
+    const boundaryKeywords = [
+        "null", "undefined", '""', "''", "0",
+        "MAX_VALUE", "MIN_VALUE", "MAX_SAFE_INTEGER", "MIN_SAFE_INTEGER",
+        "empty", "blank", "边界", "极端",
+    ];
+    const found = [];
+    for (const keyword of boundaryKeywords) {
+        if (filteredText.includes(keyword)) {
+            found.push(keyword);
+        }
+    }
+    if (found.length > 0) {
+        return {
+            dimension: "boundary_coverage",
+            passed: true,
+            detail: `检测到边界值测试: ${found.join(", ")}`,
+        };
+    }
+    return {
+        dimension: "boundary_coverage",
+        passed: false,
+        detail: "未检测到边界值测试",
+    };
+}
+function checkNaming(content) {
+    // Extract test names from it("...", test("...", patterns
+    const namePattern = /\b(?:it|test)\s*\(\s*["'`]([^"'`]+)["'`]/g;
+    const names = [];
+    let match;
+    while ((match = namePattern.exec(content)) !== null) {
+        names.push(match[1]);
+    }
+    if (names.length === 0) {
+        // No extractable names — neutral pass (cannot evaluate)
+        return {
+            dimension: "naming",
+            passed: true,
+            detail: "未提取到测试名称 (可能使用 describe-only 模式)",
+        };
+    }
+    const descriptiveKeywords = [
+        "should", "when", "returns", "can", "handles", "throws",
+        "shouldn't", "must", "will",
+        "应该", "当", "返回", "处理", "抛出", "正确", "失败",
+    ];
+    let descriptiveCount = 0;
+    for (const name of names) {
+        const lowerName = name.toLowerCase();
+        for (const keyword of descriptiveKeywords) {
+            if (lowerName.includes(keyword.toLowerCase())) {
+                descriptiveCount++;
+                break;
+            }
+        }
+    }
+    const ratio = descriptiveCount / names.length;
+    if (ratio >= 0.5) {
+        return {
+            dimension: "naming",
+            passed: true,
+            detail: `描述性命名比例: ${(ratio * 100).toFixed(0)}% (${descriptiveCount}/${names.length})`,
+        };
+    }
+    return {
+        dimension: "naming",
+        passed: false,
+        detail: `测试命名不够描述性: ${(ratio * 100).toFixed(0)}% (${descriptiveCount}/${names.length})`,
+    };
+}
+function checkDuplication(content) {
+    // Extract expect(...) statements (first 120 chars per line to normalize)
+    const expectPattern = /\bexpect\s*\([^)]*\)/g;
+    const expectCalls = [];
+    let match;
+    while ((match = expectPattern.exec(content)) !== null) {
+        expectCalls.push(match[0].trim());
+    }
+    if (expectCalls.length === 0) {
+        // Nothing to measure — neutral pass
+        return {
+            dimension: "duplication",
+            passed: true,
+            detail: "无断言语句，跳过重复检查",
+        };
+    }
+    // Sort and count duplicates
+    const sorted = [...expectCalls].sort();
+    const unique = new Set(sorted);
+    const duplicateRatio = 1 - unique.size / sorted.length;
+    if (duplicateRatio > 0.3) {
+        const duplicateCount = sorted.length - unique.size;
+        return {
+            dimension: "duplication",
+            passed: false,
+            detail: `存在重复断言: ${duplicateCount}/${sorted.length} 条重复 (${(duplicateRatio * 100).toFixed(0)}%)`,
+        };
+    }
+    return {
+        dimension: "duplication",
+        passed: true,
+        detail: `断言重复率: ${(duplicateRatio * 100).toFixed(0)}%`,
+    };
+}
+function checkScenarioCoverage() {
+    return {
+        dimension: "scenario_coverage",
+        passed: true,
+        detail: "需结合知识模板验收项进行交叉检查",
+    };
+}
+//# sourceMappingURL=test_quality.js.map