merge 단계가 게이트마다 job 하나(행렬 14개)라서 PR마다 checkout, setup-node, `pnpm install`을 14번 하고 브라우저 설치를 2번 한다. Gitea runner는 소유자 기계 한 대다. 사례(Vite 등)는 설치를 job당 한 번으로 묶는다(design-docs repo-structure/03-ci.md 3.5절). 고른 방법(03-ci.md 7.3절 F1, 소유자 승인 2026-11-07): - job 종류 `gate-sequence`를 더한다. job 하나가 게이트 여럿을 차례로 돈다. 게이트마다 `FE-GATE-NNN / <이름>` 단계이고 `if: !cancelled()`라 앞 게이트가 실패해도 다음 게이트가 돈다(행렬의 fail-fast: false와 같다). - merge job 셋: `merge_static`(001·002·003·010·011·012, 소스를 읽고 빌드하는 검사), `merge_test`(004·005·006·007·013·020, 시험), `merge_browser`(008·009, 브라우저 설치). release 단계는 셋을 모두 기다린다. 게이트 id·명령·증거·승격 공식은 그대로다. - 증거 업로드는 job마다 하나(`merge-static-<run>` 등)다. 버린 것: 행렬을 두고 `pnpm install`만 캐시하는 방법. runner 한 대에서는 job 수만큼 checkout과 준비가 남는다. 게이트를 job 하나에 모두 넣는 방법은 브라우저 설치를 모든 게이트가 기다린다. 위험: 한 job 안의 게이트가 같은 작업 공간을 쓴다. 앞 게이트의 산출물이 뒤 게이트에 남는다. desktop의 merge 단계 실행(게이트를 한 checkout에서 차례로 도는 것)과 같은 조건이라 그 결과로 확인했다. 실제 Gitea runner의 `!cancelled()` 해석은 Actions를 켠 뒤 확인한다. 검증(desktop): check:ci, check:types, CI 시험 4파일 통과. 합치기 전후 merge 단계 게이트별 결과 비교는 PR 본문에 적는다. Refs: design-docs repo-structure/03-ci.md 3.5·7.3·7.4절, README.md 3.3절
46 lines
1.4 KiB
TypeScript
46 lines
1.4 KiB
TypeScript
import { z } from "zod";
|
|
|
|
export const ciContractReportSchema = z
|
|
.object({
|
|
schemaVersion: z.literal(2),
|
|
nodeVersion: z.string().regex(/^\d+\.\d+\.\d+$/u),
|
|
gateCount: z.literal(27),
|
|
commandDefinitionCount: z.number().int().positive(),
|
|
commandReferenceCount: z.number().int().positive(),
|
|
artifactCount: z.number().int().positive(),
|
|
jobCount: z.literal(12),
|
|
workflowSha256: z.string().regex(/^[a-f0-9]{64}$/u),
|
|
durationStatus: z.string().min(1),
|
|
negativeFixtures: z.array(
|
|
z
|
|
.object({
|
|
readiness: z.enum([
|
|
"MERGE_READY",
|
|
"RELEASE_READY",
|
|
"PROD_PROMOTION_READY",
|
|
"FIELD_SLO_READY",
|
|
"DOCUMENTATION_READY",
|
|
]),
|
|
failedGate: z.string().regex(/^FE-GATE-\d{3}$/u),
|
|
passed: z.boolean(),
|
|
})
|
|
.strict(),
|
|
),
|
|
failures: z.array(z.string()),
|
|
passed: z.boolean(),
|
|
})
|
|
.strict()
|
|
.superRefine((report, context) => {
|
|
const fail = (path: PropertyKey[], message: string) =>
|
|
context.addIssue({ code: "custom", path, message });
|
|
if ((report.passed === true) !== (report.failures.length === 0)) {
|
|
fail(["passed"], "passed must agree with failures");
|
|
}
|
|
if (
|
|
report.negativeFixtures.length !== 5 ||
|
|
report.negativeFixtures.some((fixture) => !fixture.passed)
|
|
) {
|
|
fail(["negativeFixtures"], "every readiness negative fixture must pass");
|
|
}
|
|
});
|