문제 FE-GATE-005의 증거 검사(scripts/lib/ci-artifact-validator.ts)는 coverage-summary.json 항목마다 lines·statements·functions·branches만 허용하는 .strict() schema를 쓴다. istanbul-lib-coverage 3.2.2는 빈 summary에 branchesTrue를 항상 넣으므로 total에 그 키가 있다. 그래서 테스트가 모두 통과해도 증거 단계에서 게이트가 실패한다. 같은 파일을 읽는 risk-coverage 게이트는 이 키를 허용해 두 검사기가 갈라져 있었다. 고른 방법 - 키 목록을 scripts/lib/coverage-summary-metrics.ts 한 곳에 두고 두 검사기가 같이 쓴다. 평가하는 네 지표와, 보고기가 더할 수 있는 선택 지표(branchesTrue)를 나눴다. 선택 지표도 counter 형식(pct 정확성 포함)은 그대로 검사한다. - 버린 대안: validator schema에만 branchesTrue를 더하기. 지금 고장의 원인(두 목록)이 그대로 남는다. 상수를 risk-coverage.ts에서 export하기. validator가 @babel/eslint-parser까지 읽게 된다. 위험·한계 - 다른 미지의 키는 여전히 거절한다(의도). 보고기를 올리면 새 키가 생길 수 있다. - ci:gate FE-GATE-005 전체는 이 커밋에서 돌리지 않았다. 검증 - RED: 새 tests/unit/coverage-summary-artifact.test.ts 3건 중 2건 실패 (Unrecognized key: "branchesTrue"). - 수정 뒤 coverage-summary-artifact·risk-coverage·risk-coverage-files 44건 통과. check:types 통과, 바꾼 파일 eslint 통과. Refs: docs/reviews/2026-11-03-maturity-review/README.md 12-09
67 lines
2.7 KiB
TypeScript
67 lines
2.7 KiB
TypeScript
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<void> {
|
|
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);
|
|
});
|
|
});
|