import { test, expect, describe } from "bun:test"; import { changedLinesByFile, extractMethods, normalizeSymbol, symbolMatches, parseHitSymbols, parseReportedCoverage, reconcile, renderMethodCoverageMarkdown, summarizeMethodCoverage, langOf, } from "@bbbug/shared/method_coverage"; /** * 变更方法对账。 * * 这些用例钉的是**分母**和**状态来源**,不是覆盖率数字本身: * - 分母(diff 到底改了哪些方法)是这个模块唯一有权威的产出,算错它整节都是错的; * - `source` 区分「命中文件」与「报告自述」,混掉两者就等于把模型自述包装成机器证据, * 而那正是这个模块存在的理由。 * 另外两条底线单独钉死:拿不准一律 `unknown`,绝不猜成 `miss`;局部函数不能进表。 */ const KT = `package com.x class CommentActionViewHolder(view: View) { fun enableClick(enable: Boolean) { isEnabled = enable && !forceDisabled if (forceDisabled && enable) { itemView.alpha = FORCE_DISABLED_ALPHA } } override fun onDetachedFromWindow() { permissionLock.release() super.onDetachedFromWindow() } fun withLocal() { fun helper(): String { return "}" } log(helper()) } } `; describe("方法边界解析", () => { test("Kotlin:成员方法各自成段,行区间用花括号配平算出", () => { const spans = extractMethods(KT, "kotlin"); const names = spans.map((s) => s.name).sort(); expect(names).toEqual(["enableClick", "onDetachedFromWindow", "withLocal"]); const enable = spans.find((s) => s.name === "enableClick")!; expect(enable.owner).toBe("CommentActionViewHolder"); expect(enable.startLine).toBe(5); expect(enable.endLine).toBe(10); }); test("局部函数不进表 —— Frida hook 不到它,收进来就是凭空造一条永远未执行的假记录", () => { const spans = extractMethods(KT, "kotlin"); expect(spans.some((s) => s.name === "helper")).toBe(false); }); test("字符串里的花括号不打断配平", () => { const spans = extractMethods(KT, "kotlin"); const withLocal = spans.find((s) => s.name === "withLocal")!; // 方法体里有一个 `return "}"`,配平算错的话 endLine 会停在那一行。 expect(withLocal.endLine).toBeGreaterThan(withLocal.startLine + 3); }); test("Swift 的 func 与 init", () => { const spans = extractMethods(`class A { init(x: Int) { self.x = x } private func doThing() -> Bool { return true } } `, "swift"); expect(spans.map((s) => s.name).sort()).toEqual(["doThing", "init"]); expect(spans[0].owner).toBe("A"); }); test("Java:控制流语句不会被当成方法声明", () => { const spans = extractMethods(`public class B { public void run(int n) { if (n > 0) { step(); } for (int i = 0; i < n; i++) { step(); } } } `, "java"); expect(spans.map((s) => s.name)).toEqual(["run"]); }); test("ObjC:取第一段 selector,与 Frida 的 -[Cls sel:] 对得上", () => { const spans = extractMethods(`@implementation AWEFeedCell - (void)configureWithModel:(id)model extra:(id)extra { self.model = model; } @end `, "objc"); expect(spans[0]).toMatchObject({ owner: "AWEFeedCell", name: "configureWithModel" }); }); test("接口 / 抽象方法没有方法体,不产生区间", () => { const spans = extractMethods(`interface I { fun ping(): String } `, "kotlin"); expect(spans).toEqual([]); }); test("语言判定:不认识的扩展名返回 null,由调用方点名列出", () => { expect(langOf("a/b/C.kt")).toBe("kotlin"); expect(langOf("a/b/C.mm")).toBe("objc"); expect(langOf("a/b/c.xml")).toBeNull(); }); }); describe("diff 改动行归属", () => { const diff = `diff --git a/app/V.kt b/app/V.kt --- a/app/V.kt +++ b/app/V.kt @@ -4,3 +4,4 @@ class V { fun a() { - old() + neu() + more() } `; test("只认改动后的行号,删除行不占位", () => { const m = changedLinesByFile(diff); expect([...m.get("app/V.kt")!].sort((x, y) => x - y)).toEqual([5, 6]); }); test("改名取 b 侧路径", () => { const m = changedLinesByFile(`diff --git a/old/Name.kt b/new/Name.kt --- a/old/Name.kt +++ b/new/Name.kt @@ -1 +1 @@ -a +b `); expect([...m.keys()]).toEqual(["new/Name.kt"]); }); }); describe("符号归一化与命中判定", () => { test("四种写法压成同一个 {owner, name}", () => { expect(normalizeSymbol("com.a.b.Cls.method")).toEqual({ owner: "Cls", name: "method" }); expect(normalizeSymbol("Cls.method(int)")).toEqual({ owner: "Cls", name: "method" }); expect(normalizeSymbol("-[AWEFeedCell configureWithModel:extra:]")).toEqual({ owner: "AWEFeedCell", name: "configureWithModel" }); expect(normalizeSymbol("bareMethod")).toEqual({ owner: "", name: "bareMethod" }); }); test("owner 缺一边就算命中 —— 拿不准偏向沉默,不偏向报警", () => { expect(symbolMatches({ owner: "", name: "f" }, { owner: "Cls", name: "f" })).toBe(true); expect(symbolMatches({ owner: "Cls", name: "f" }, { owner: "", name: "f" })).toBe(true); }); test("两边 owner 都确定且不同才拒绝", () => { expect(symbolMatches({ owner: "Other", name: "f" }, { owner: "Cls", name: "f" })).toBe(false); }); test("命中文件:裸符号行、JSON 行、显式 hit:false 混排", () => { const hits = parseHitSymbols([ "com.x.CommentActionViewHolder.enableClick", '{"symbol":"com.x.Other.ping","hits":3}', '{"symbol":"com.x.Other.never","hit":false}', "", "not json {", ].join("\n")); expect(hits.map((h) => h.name)).toEqual(["enableClick", "ping"]); }); }); describe("报告自述小节", () => { const md = `# FixReport ## 代码覆盖检查 覆盖率 1/2 个方法 - 命中:\`CommentActionViewHolder.enableClick\` - 未执行:\`CommentActionViewHolder.onDetachedFromWindow\` - 没记录到:\`StoryPermissionCache.invalidate\`(attach 失败) ## 验证局限 无 `; test("三态按行内提示词分类", () => { const r = parseReportedCoverage(md); expect(r.absent).toBe(false); expect(r.hit).toEqual(["CommentActionViewHolder.enableClick"]); expect(r.miss).toEqual(["CommentActionViewHolder.onDetachedFromWindow"]); expect(r.unrecorded).toEqual(["StoryPermissionCache.invalidate"]); }); test("没有这一节 → absent(与「有节但空」不同)", () => { expect(parseReportedCoverage("# R\n\n## 验证局限\n无\n").absent).toBe(true); }); test("不读自己写回去的机械对账小节,免得自己跟自己对账", () => { const r = parseReportedCoverage(`## 代码覆盖检查(机械对账) - 命中:\`A.b\` `); expect(r.absent).toBe(true); expect(r.hit).toEqual([]); }); }); describe("对账", () => { const methods = [ { file: "app/V.kt", owner: "CommentActionViewHolder", name: "enableClick", startLine: 5, endLine: 10, changedLines: 2 }, { file: "app/V.kt", owner: "CommentActionViewHolder", name: "onDetachedFromWindow", startLine: 12, endLine: 15, changedLines: 1 }, ]; test("命中文件优先于报告自述,并在 source 上留痕", () => { const c = reconcile({ methods, hits: [{ owner: "CommentActionViewHolder", name: "enableClick" }], reported: { hit: [], miss: ["CommentActionViewHolder.onDetachedFromWindow"], unrecorded: [], absent: false }, unparsedFiles: [], }); expect(c.methods[0]).toMatchObject({ state: "hit", source: "hits-file" }); expect(c.methods[1]).toMatchObject({ state: "miss", source: "report" }); expect(c.percent).toBe(50); expect(c.verdict).toBe("consistent"); }); test("命中文件里没有、报告也没提 → unknown,绝不判 miss", () => { const c = reconcile({ methods, hits: [{ owner: "CommentActionViewHolder", name: "enableClick" }], reported: { hit: [], miss: [], unrecorded: [], absent: false }, unparsedFiles: [], }); expect(c.methods[1]).toMatchObject({ state: "unknown", source: "none" }); expect(c.miss).toBe(0); expect(c.unreported).toEqual(["CommentActionViewHolder.onDetachedFromWindow"]); expect(c.verdict).toBe("mismatch"); }); test("没记录到不进分母", () => { const c = reconcile({ methods, hits: null, reported: { hit: ["CommentActionViewHolder.enableClick"], miss: [], unrecorded: ["CommentActionViewHolder.onDetachedFromWindow"], absent: false, }, unparsedFiles: [], }); expect(c.percent).toBe(100); expect(c.unrecorded).toBe(1); }); test("报告提到、diff 没改的方法单独列出", () => { const c = reconcile({ methods: [methods[0]], hits: null, reported: { hit: ["CommentActionViewHolder.enableClick", "Ghost.method"], miss: [], unrecorded: [], absent: false }, unparsedFiles: [], }); expect(c.reportedOnly).toEqual(["Ghost.method"]); expect(c.verdict).toBe("mismatch"); }); test("既无命中文件也无报告小节 → no-coverage-data", () => { const c = reconcile({ methods, hits: null, reported: { hit: [], miss: [], unrecorded: [], absent: true }, unparsedFiles: [] }); expect(c.verdict).toBe("no-coverage-data"); }); test("一个方法都没解析出来 → unparsed,并点名未解析的文件", () => { const c = reconcile({ methods: [], hits: null, reported: { hit: [], miss: [], unrecorded: [], absent: true }, unparsedFiles: ["res/layout/a.xml"] }); expect(c.verdict).toBe("unparsed"); expect(renderMethodCoverageMarkdown(c)).toContain("res/layout/a.xml"); }); }); describe("产出的那份 markdown", () => { const c = reconcile({ methods: [ { file: "app/V.kt", owner: "CommentActionViewHolder", name: "enableClick", startLine: 5, endLine: 10, changedLines: 2 }, { file: "app/V.kt", owner: "CommentActionViewHolder", name: "onDetachedFromWindow", startLine: 12, endLine: 15, changedLines: 1 }, ], hits: [{ owner: "CommentActionViewHolder", name: "enableClick" }], reported: { hit: [], miss: [], unrecorded: [], absent: false }, unparsedFiles: [], }); test("标题与 Agent 自写的那节不同名 —— 两份都留着,对不上才看得见", () => { expect(renderMethodCoverageMarkdown(c)).toContain("## 代码覆盖检查(机械对账)"); }); test("带文件:行区间 —— 下游按方法切段染色就靠它", () => { expect(renderMethodCoverageMarkdown(c)).toContain("`app/V.kt:5-10`"); }); test("状态来源逐行可见,并写明覆盖率不是门槛", () => { const md = renderMethodCoverageMarkdown(c); expect(md).toContain("命中文件"); expect(md).toContain("不构成验收门槛"); }); test("一行摘要能脱离上下文读懂", () => { expect(summarizeMethodCoverage(c)).toContain("diff 实际改动 2 个方法"); expect(summarizeMethodCoverage(null)).toBe("未做变更方法对账"); }); });