문제
.gitea/workflows/quality-gates.yml은 workflow 전체 env에
VITE_BUILD_ID=gitea-<run>-<attempt>와 VITE_COMMIT_SHA를 넣는다. Vite는 이
값을 import.meta.env로 번들에 넣는다. 그래서 CI와 같은 env로 돌리면:
- vitest: 앱을 local-build fixture release로 조립하는 테스트가
CONFIG_BUILD_MISMATCH로 실패한다(runtime-application,
boot-unexpected-failure, runtime-composition-service-worker-telemetry,
reference-production-vertical, 생성 기능 페이지 테스트). FE-GATE-005·006·
007과 제거 드릴(FE-GATE-020)이 떨어진다.
- capability e2e: dev server는 public/config.json(BUILD_ID local-build)을
내주는데 번들은 gitea-1-1이라, 페이지마다 rolling-release 불일치로 한 번
다시 불러오고 그다음 실패 화면이 된다. page.evaluate가 "Execution context
was destroyed"로 30건 실패한다(FE-GATE-008).
깨끗한 clone에서 merge 단계 14개를 CI env로 돌려(리뷰 조치 X4) 찾았다.
로컬에서는 이 값이 없어서 늘 통과한다. 1103/11-06과 같은 원인이다.
고른 방법
- vitest.config.ts가 npm scope 변수를 지우는 것과 같은 자리에서
VITE_BUILD_ID·VITE_COMMIT_SHA를 지운다. 테스트는 로컬 빌드 식별값으로
시작한다.
- dev server를 띄우는 Playwright 설정(capabilities, dev)은 webServer env로
VITE_BUILD_ID=local-build, VITE_COMMIT_SHA=local을 준다. 그 dev server가
내주는 config.json과 같은 값이다.
- build·preview를 쓰는 e2e·visual은 바꾸지 않았다. 빌드가 같은 값으로
config.json을 만들므로 맞는다.
- 버린 대안: 테스트마다 기대값을 env에서 읽기(11-06 방식). 같은 모양의
fixture가 여러 파일에 있고, 다음 테스트가 또 같은 실수를 한다.
위험·한계
- vitest 안에서 CI 빌드 식별값을 읽는 것을 검사하려는 테스트는 값을 직접
넣어야 한다(지금은 없다).
- CI=true와 러너 이미지 조건은 재현하지 않았다.
검증
- VITE_BUILD_ID=gitea-1-1, VITE_COMMIT_SHA=<HEAD>로: test:unit 2,878,
test:component 270, test:integration 189, test:reference-feature 97,
test:recipes 77 통과. browser-files capability spec chromium 3건 통과
(수정 전 3건 실패, env 없으면 통과).
Refs: docs/reviews/2026-11-03-maturity-review/README.md 13절 11-06