import { describe, expect, test } from "bun:test";
import { parseAuditReport } from "@bbbug/shared/audit_report";
import {
addIssue, doneScene, initReport, recountSummary, setConstructed, setCoverage, setRecipe, setRoute, setScene,
} from "@bbbug/shared/audit_report_edit";
import { extractUiTexts, uiWaitLoop } from "@bbbug/shared/ui_wait";
/**
* audit-report 命令的小块修改,和平台解析器是同一份契约:每一步改完都必须还能被 parseAuditReport 读对。
* 起因见 shared/src/audit_report_edit.ts 头注释(00889383 写报告 122 次、34 分钟,还改坏过表格)。
*/
describe("audit-report:小块修改 ↔ 解析器", () => {
let md = initReport({ title: "走查", langs: ["en", "de"] });
md = setScene(md, "A 场景", "待走", "还没走");
md = setScene(md, "B 场景", "待走", "还没走");
const r1 = addIssue(md, { page: "s3-dm/01-inbox", title: "收件箱", surface: "面 3 · DM", sev: "P1", cat: "热区", langs: ["en", "de"], text: "「…」只有 24pt。" });
md = r1.md;
const r2 = addIssue(md, { page: "s3-dm/01-inbox", sev: "P2", cat: "布局", langs: ["en"], text: "头像上距 < 左距。" });
md = r2.md;
md = setCoverage(md, "s3-dm/02-chat", "en", "ok");
md = setCoverage(md, "s3-dm/02-chat", "ja", "missing"); // 新语言列
md = doneScene(md, "A 场景").md;
md = setConstructed(md, "s3-dm/01-inbox", "断网", "hooks/x.js");
md = setRoute(md, "s3-dm/01-inbox", "收件箱", "旧路");
md = setRoute(md, "s3-dm/01-inbox", "收件箱", "新路"); // 同键覆盖
md = setRecipe(md, "断网态", "svc wifi disable");
md = recountSummary(md);
const r = parseAuditReport(md)!;
test("问题编号接着这一页往下排,覆盖格自动 ⚠", () => {
expect([r1.n, r2.n]).toEqual([1, 2]);
const p = r.pages.find((x) => x.id === "s3-dm/01-inbox")!;
expect(p.title).toBe("收件箱");
expect(p.surface).toBe("面 3 · DM");
expect(p.issues.map((i) => `${i.n}${i.sev}${i.cat}`)).toEqual(["1P1热区", "2P2布局"]);
expect(p.coverage).toEqual(["issue", "issue", "missing"]);
});
test("覆盖矩阵:新页面补行、新语言补列", () => {
expect(r.langs).toEqual(["en", "de", "ja"]);
expect(r.pages.find((x) => x.id === "s3-dm/02-chat")!.coverage).toEqual(["ok", "missing", "missing"]);
});
test("第 3 节:done 删行,不留「已覆盖」", () => {
expect(r.blocked.map((b) => `${b.scope}:${b.cause}`)).toEqual(["B 场景:pending"]);
});
test("第 5、6 节:同键覆盖不重复", () => {
expect(r.constructed).toEqual([{ page: "s3-dm/01-inbox", how: "断网", script: "hooks/x.js" }]);
expect(r.routes).toEqual([{ page: "s3-dm/01-inbox", title: "收件箱", how: "新路" }]);
expect(r.recipes).toEqual([{ scene: "断网态", how: "svc wifi disable" }]);
});
test("summary 按第 4 节数,保留 agent 写的结论段", () => {
const withNote = md.replace("## 2. 覆盖矩阵", "### 一句话结论\n\n热区问题最多。\n\n## 2. 覆盖矩阵");
const again = recountSummary(withNote);
expect(again).toContain("| P1 | 1 | 2 |");
expect(again).toContain("| 热区 | 1 | 2 |");
expect(again).toContain("热区问题最多。");
expect(again.match(/### 按严重度/g)).toHaveLength(1);
});
test("表格里的竖线被转义,不会把一格拆成两格", () => {
const m = addIssue(md, { page: "s3-dm/03-x", sev: "P3", cat: "布局", langs: ["en"], text: "A | B 挤在一起" }).md;
// 以前只断言「含 A」:转义的竖线被解析器劈开后,现象只剩「A \\」也能过。现在要原样回来。
expect(parseAuditReport(m)!.pages.find((x) => x.id === "s3-dm/03-x")!.issues[0].text).toBe("A | B 挤在一起");
});
});
/** 复现条件 / 原因:九列新表头;往写到一半、还是七列表头的老页面里追加时并进「细节」,不错位。 */
describe("audit-report:复现条件与原因", () => {
const base = initReport({ title: "走查", langs: ["en"] });
test("新表九列,两格原样读回", () => {
const md = addIssue(base, {
page: "s1-profile/12-find-friends", sev: "P1", cat: "布局", langs: ["en"], text: "推荐理由被挤成竖排。",
repro: "昵称和 handle 都很短的推荐账号", cause: "这一列跟着昵称 / handle 的宽度走", detail: "16×51", code: "—",
}).md;
expect(md).toContain("| # | 严重度 | 类别 | 语言 | 现象 | 复现条件 | 原因 | 细节 | 代码位置 |");
const i = parseAuditReport(md)!.pages[0].issues[0];
expect(i).toMatchObject({ repro: "昵称和 handle 都很短的推荐账号", cause: "这一列跟着昵称 / handle 的宽度走", detail: "16×51", code: "—" });
});
test("没写的两格是 —,读回来是空", () => {
const i = parseAuditReport(addIssue(base, { page: "s1-a/01-b", sev: "P3", cat: "热区", langs: ["en"], text: "小。" }).md)!.pages[0].issues[0];
expect(i.repro).toBeUndefined();
expect(i.cause).toBeUndefined();
});
test("七列老表头的页面:追加的行跟着老表头走,复现条件和原因并进细节", () => {
const old = `${base.replace("## 4. 逐页问题与截图\n", `## 4. 逐页问题与截图
### 面 1 · Profile
#### \`s1-a/01-b\` · 页
| # | 严重度 | 类别 | 语言 | 现象 | 细节 | 代码位置 |
|---|---|---|---|---|---|---|
| 1 | P2 | 热区 | en | 老问题。 | 老取证 | — |
`)}`;
const md = addIssue(old, { page: "s1-a/01-b", sev: "P2", cat: "布局", langs: ["en"], text: "新问题。", repro: "R", cause: "C", detail: "D" }).md;
const [a, b] = parseAuditReport(md)!.pages.find((p) => p.id === "s1-a/01-b")!.issues;
expect(a).toMatchObject({ n: 1, text: "老问题。", detail: "老取证", code: "—" });
expect(b).toMatchObject({ n: 2, text: "新问题。", detail: "复现条件:R;原因:C;D", code: "—" });
expect(b.repro).toBeUndefined();
});
test("按表头名取值:列序不同也读得对", () => {
// 覆盖矩阵为空的报告解析器整份不认,先补一行。
const md = setCoverage(base, "s1-a/01-b", "en", "issue").replace("## 4. 逐页问题与截图\n", `## 4. 逐页问题与截图
#### \`s1-a/01-b\` · 页
| # | 严重度 | 类别 | 语言 | 现象 | 细节 | 原因 | 复现条件 | 代码位置 |
|---|---|---|---|---|---|---|---|---|
| 1 | P2 | 热区 | en | 现。 | 细。 | 因。 | 复。 | a.m:1 |
`);
expect(parseAuditReport(md)!.pages[0].issues[0]).toMatchObject({ text: "现。", detail: "细。", cause: "因。", repro: "复。", code: "a.m:1" });
});
});
describe("wait-for --ui-text 的核心", () => {
test("两种结构树都取得出文案", () => {
expect(extractUiTexts('')).toEqual(["Inbox", "More options"]);
expect(extractUiTexts('@1 UILabel "Inbox" (1,1 2x2)\n@2 UIButton "Friends" #btn (1,1 2x2)')).toEqual(["Inbox", "Friends"]);
});
test("出现即返回;等不到时带上当前屏幕文案;--ui-gone 等消失", async () => {
let t = 0;
const clock = { now: () => t, sleep: async (ms: number) => { t += ms; } };
const seq = ["", ""];
let i = 0;
const hit = await uiWaitLoop({ probe: async () => seq[Math.min(i++, 1)], pattern: /inbox/i, timeoutMs: 30_000, ...clock });
expect(hit.ok).toBe(true);
expect(hit.hit).toBe("Inbox");
const miss = await uiWaitLoop({ probe: async () => seq[0], pattern: /Settings/, timeoutMs: 3000, ...clock });
expect(miss.ok).toBe(false);
expect(miss.lastTexts).toEqual(["Loading"]);
i = 0;
const gone = await uiWaitLoop({ probe: async () => seq[Math.min(i++, 1)], pattern: /Loading/, gone: true, timeoutMs: 30_000, ...clock });
expect(gone.ok).toBe(true);
const none = await uiWaitLoop({ probe: async () => null, pattern: /x/, timeoutMs: 2000, ...clock });
expect(none.error).toBeDefined();
});
});