문제: 초기 JS가 예산을 넘으면 check:bundle은 "Bundle budget or manifest integrity failed: " 한 줄만 쓰고 콜론 뒤가 비어 있었다. 측정값과 한도는 artifacts/performance/bundle.json에만 있어 예산 실패인지 manifest 무결성 실패인지, 몇 바이트 넘었는지 알 수 없었다. 또 초기 JS 파일 수에는 상한이 없어 08-08처럼 파일을 16개에서 25개로 늘리는 변경도 모든 게이트를 통과했다. 템플릿은 HTTP/2를 전제로 초기 청크를 나눠 두었는데, 파일 수를 늘리는 결정이 어디에도 드러나지 않았다. 고른 방법: 예산 실패와 무결성 실패를 다른 문장으로 쓴다. 예산 실패는 넘은 한도마다 측정값·한도·초과량을 한 줄로 쓴다 (describeBundleBudgetFailures). config/performance/budgets.json에 initialJsFiles(지금 25)를 두고 check:bundle이 entry를 포함한 초기 파일 수를 센다. bundle.json 스키마는 측정값·한도·결과와 자가 검사 fixture를 하나씩 더 가진다. 두 변경은 같은 함수와 스키마를 고치므로 한 커밋에 넣었다. 버린 대안: 파일 수를 문서에만 적기. 08-08이 그 상태에서 파일을 늘렸다. 위험·한계: 초기 파일을 하나라도 늘리는 변경은 이제 budgets.json을 같이 고쳐야 통과한다. 그것이 목적이다. HTTP/2 확인 자체는 이 커밋에 없다 (13-02에서 probe에 넣는다). 검증: tests/unit/check-bundle-output.test.ts가 손으로 만든 빌드 출력에 check-bundle.ts를 돌려 통과·초기 바이트 초과·lazy 초과·파일 수 초과· 무결성 실패의 출력을 본다(고치기 전 4건 실패). bundle-artifact-contract, performance-budgets 통과. 실제 빌드에서 check:bundle PASS(25 / 25 files). Refs: docs/reviews/2026-11-03-maturity-review/15-performance.md 15-03, 15-05
88 lines
3.3 KiB
TypeScript
88 lines
3.3 KiB
TypeScript
import { readFile } from "node:fs/promises";
|
|
|
|
import { describe, expect, it } from "vitest";
|
|
|
|
import {
|
|
bundleOutputInventoryArtifactSchema,
|
|
bundlePerformanceArtifactSchema,
|
|
} from "../../scripts/contracts/release-artifacts.ts";
|
|
|
|
const sha256 = "a".repeat(64);
|
|
|
|
const inventory = {
|
|
schemaVersion: 1,
|
|
generatedAt: "2026-08-02T00:00:00.000Z",
|
|
context: {
|
|
nodeVersion: "v24.14.0",
|
|
packageManager: "pnpm@11.17.0",
|
|
runnerImage: "fixture@sha256:abc",
|
|
},
|
|
outputs: [
|
|
{ path: "dist/assets/entry.js", bytes: 100, gzipBytes: 50, sha256 },
|
|
{ path: "dist/assets/lazy.js", bytes: 80, gzipBytes: 40, sha256 },
|
|
{ path: "dist/index.html", bytes: 20, gzipBytes: 15, sha256 },
|
|
],
|
|
} as const;
|
|
|
|
const completed = {
|
|
...inventory,
|
|
measurements: {
|
|
initialJsGzipBytes: 50,
|
|
initialJsFiles: 1,
|
|
lazyChunks: [{ path: "assets/lazy.js", gzipBytes: 40 }],
|
|
},
|
|
classification: {
|
|
initialFiles: ["assets/entry.js"],
|
|
lazyFiles: ["assets/lazy.js"],
|
|
missingImports: [],
|
|
},
|
|
missingOutputs: [],
|
|
thresholds: { initialJsGzipBytes: 60, initialJsFiles: 1, lazyChunkGzipBytes: 45 },
|
|
results: {
|
|
initialPassed: true,
|
|
initialFilesPassed: true,
|
|
lazyResults: [
|
|
{ path: "assets/lazy.js", gzipBytes: 40, threshold: 45, passed: true },
|
|
],
|
|
passed: true,
|
|
},
|
|
fixtures: [
|
|
{ name: "initial-js-over-budget", passed: true },
|
|
{ name: "lazy-chunk-over-budget", passed: true },
|
|
{ name: "initial-files-over-budget", passed: true },
|
|
],
|
|
passed: true,
|
|
} as const;
|
|
|
|
describe("bundle artifact contracts", () => {
|
|
it("separates the raw output inventory from final budget evidence", () => {
|
|
expect(bundleOutputInventoryArtifactSchema.parse(inventory)).toEqual(inventory);
|
|
expect(() => bundleOutputInventoryArtifactSchema.parse(completed)).toThrow();
|
|
expect(bundlePerformanceArtifactSchema.parse(completed)).toEqual(completed);
|
|
expect(() => bundlePerformanceArtifactSchema.parse(inventory)).toThrow();
|
|
});
|
|
|
|
it.each([
|
|
["initial total", { measurements: { ...completed.measurements, initialJsGzipBytes: 49 } }],
|
|
["lazy classification", { classification: { ...completed.classification, lazyFiles: [] } }],
|
|
["missing output", { missingOutputs: ["assets/missing.js"], passed: true }],
|
|
["threshold result", { results: { ...completed.results, initialPassed: false } }],
|
|
["initial file count", { measurements: { ...completed.measurements, initialJsFiles: 2 } }],
|
|
["initial file result", { results: { ...completed.results, initialFilesPassed: false } }],
|
|
["lazy result", { results: { ...completed.results, lazyResults: [] } }],
|
|
["fixture identity", { fixtures: [{ name: "other", passed: true }, completed.fixtures[1], completed.fixtures[2]] }],
|
|
["overall result", { passed: false }],
|
|
] as const)("rejects inconsistent %s evidence", (_name, mutation) => {
|
|
expect(() =>
|
|
bundlePerformanceArtifactSchema.parse({ ...completed, ...mutation })
|
|
).toThrow();
|
|
});
|
|
|
|
it("publishes final evidence only through the validated atomic writer", async () => {
|
|
const source = await readFile("scripts/check-bundle.ts", "utf8");
|
|
expect(source).toContain("bundleOutputInventoryArtifactSchema.parse");
|
|
expect(source).toContain("writeValidatedJsonArtifact");
|
|
expect(source).not.toMatch(/\bwriteFile\s*\(/u);
|
|
});
|
|
});
|