import { mkdir, mkdtemp, rm, writeFile } from "node:fs/promises"; import { tmpdir } from "node:os"; import path from "node:path"; import { afterEach, describe, expect, it } from "vitest"; import { loadCiGateContract } from "../../scripts/contracts/ci-gates.ts"; import { validateCiArtifact } from "../../scripts/lib/ci-artifact-validator.ts"; const SUMMARY_PATH = "artifacts/tests/coverage/coverage-summary.json"; const roots: string[] = []; afterEach(async () => { await Promise.all(roots.splice(0).map((root) => rm(root, { recursive: true, force: true }))); }); const counter = (total: number, covered = total) => ({ total, covered, skipped: 0, pct: total === 0 ? 100 : Math.floor((covered / total) * 10_000) / 100, }); const metrics = { lines: counter(4), statements: counter(4), functions: counter(1), branches: counter(2), }; async function validateSummary(summary: unknown): Promise { const contract = await loadCiGateContract(process.cwd()); const artifact = contract.artifacts.find((entry) => entry.path === SUMMARY_PATH); const schema = contract.artifactSchemas.find((entry) => entry.id === artifact?.schemaId); if (!artifact || !schema) throw new Error(`the CI contract no longer declares ${SUMMARY_PATH}`); const root = await mkdtemp(path.join(tmpdir(), "coverage-summary-artifact-")); roots.push(root); await mkdir(path.join(root, path.dirname(SUMMARY_PATH)), { recursive: true }); await writeFile(path.join(root, SUMMARY_PATH), `${JSON.stringify(summary)}\n`); await validateCiArtifact({ root, artifact, schema }); } // 1103/12-09. istanbul-lib-coverage 3.2.2 puts `branchesTrue` in every blank // summary, so the json-summary total always carries it. The CI evidence check // refused the key that the risk-coverage gate reading the same file accepts, // and FE-GATE-005 failed after every test had passed. describe("coverage summary evidence (1103/12-09)", () => { it("accepts the summary the coverage reporter writes, with branchesTrue", async () => { await expect(validateSummary({ total: { ...metrics, branchesTrue: counter(0) }, "src/a.ts": metrics, })).resolves.toBeUndefined(); }); it("accepts a summary without branchesTrue", async () => { await expect(validateSummary({ total: metrics, "src/a.ts": metrics })) .resolves.toBeUndefined(); }); it("still validates branchesTrue as a counter and refuses other keys", async () => { await expect(validateSummary({ total: { ...metrics, branchesTrue: { ...counter(0), pct: 0 } }, })).rejects.toThrow(/pct/u); await expect(validateSummary({ total: { ...metrics, branchesFalse: counter(0) } })) .rejects.toThrow(/branchesFalse/u); }); });