Files
clean-architecture-frontend…/scripts/contracts
DongHyeonka 9f8b2c1ce5
frontend-quality-gates / merge / static checks (pull_request) Successful in 1m20s
frontend-quality-gates / merge / tests (pull_request) Failing after 10m12s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 5m38s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Skipped
frontend-quality-gates / external-vulnerability-provider (pull_request) Skipped
frontend-quality-gates / external-provenance-provider (pull_request) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Skipped
frontend-quality-gates / deploy-promoted-release (pull_request) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Skipped
frontend-quality-gates / main / self-tests and removal drills (pull_request) Skipped
ci(gates): PR run이 경로표로 바뀐 범위의 merge 게이트만 돈다
PR run은 무엇을 바꿨든 merge 게이트 14개를 전부 돈다. 문서만 고친 PR도
scaffold 드릴(FE-GATE-020, run 241 tests job 15:58 중 약 8.5분)과 브라우저
게이트를 돈다. 소유자가 「PR은 바뀐 범위만, 문서만이면 문서 검사, 공용
파일이면 전체, 건너뛴 검사는 로그에, 경로표는 계약 시험으로」를
정했다(2026-11-13, design-docs ci/manual.md 4절, 계획 FE-2).

config/ci/pr-gate-selection.json이 경로표다. global 파일(config/,
scripts/, .gitea/, 도구 설정, lockfile 등)이나 어느 줄에도 안 걸리는
파일이 하나라도 바뀌면 전부 돈다. 아니면 파일마다 rules를 위에서부터
보고, 처음 맞는 줄의 게이트를 always(001·002·003·010)에 더한다.
- 문서(docs/**, **/*.md, .claude/**)는 FE-GATE-005까지 돈다.
- 접근성 기록은 009·020까지, recipes는 007·012까지 돈다.
- scaffold 드릴 입력(src/features 등)은 앱 게이트와 020을 돈다.
- 그 밖의 src·tests는 020을 뺀 앱 게이트를 돈다.
scripts/lib/pr-gate-selection.ts가 판정한다. run-ci-gate.ts는
CI_PR_BASE_REF(pull_request run에서만 base 브랜치, 나머지는 빈 값)가
있을 때만 판정을 부른다. 안 도는 게이트는 `건너뜀: <ID> — <이유>`를
찍고 게이트 로그도 그 한 줄로 남긴 뒤 성공으로 끝난다. diff는 base와의
merge base에서 잰다. checkout이 얕아 처음 한 번 history를 받는다. 받지
못하거나 diff를 못 읽으면 이유를 찍고 전부 돈다. merge job 셋의 env
바인딩은 계약(expectedEnvironmentBindings)과 gates.json에 두고 workflow를
다시 만들었다.

버린 대안:
- workflow on.paths·job if:로 건너뛰기: 필수 검사가 보고 없이 남는다
  (매뉴얼 4.4절).
- 고르는 job을 따로 두기: needs job이 줄 끝으로 간다.
- vitest --changed: coverage 문턱이 전체 실행을 전제한다.
- 맞는 줄을 모두 합치기: src 아래 AGENTS.md 같은 문서가 앱 게이트 전부를
  불렀다.

위험·한계:
- 경로표가 놓친 실패는 main push가 잡는다. main은 늘 전부 돈다.
- scaffold 줄은 드릴 스크립트가 이름으로 부르는 src·tests 경로를 손으로
  옮긴 것이다. 계약 시험이 그 이름들이 scaffold 줄에 걸리는지 본다.
- 공개 repo라 checkout의 origin에서 인증 없이 fetch한다. 비공개로 바뀌면
  fetch가 실패하고 전부 돈다(로그에 이유).

검증(desktop): pr-gate-selection 시험(표가 merge 게이트 전부를 덮음, 추적
파일 1631개 전부가 줄에 걸림, scaffold 드릴 이름 범위, 문서만·접근성·
앱·scaffold·전역·모르는 파일·빈 diff 선택, 건너뜀 문구 형식, 실제 git
얕은 clone에서 merge base diff, fetch 실패면 전부)을 3회 통과했다.
test-timeout-declarations 통과. 자식 프로세스 시험 둘의 timeout은 잰 값
48 ms·291 ms다. check:ci-workflow, check:types:node·test, eslint 통과.
scripts/verify.sh merge(CI=true, main 950ea11a 위, 트리 e031a8a5): 14개
전부 rc=0(008 282초, 020 404초). gate FE-GATE-029 rc=0.
2026-11-14 00:26:20 +09:00
..