# CI 품질 게이트 구성 `config/ci/gates.json`은 모든 게이트를 담은 실행 가능한 registry이고, workflow 모델은 이것 하나뿐이다. `.gitea/workflows/quality-gates.yml`은 이 엄격한 v2 계약에서 생성한다. 따로 설정을 정하는 정본이 아니다. registry를 고치고 `corepack pnpm generate:ci-workflow`를 돌린 뒤, 생성된 바이트를 함께 커밋한다. `corepack pnpm check:ci-workflow`는 빠졌거나, 낡았거나, CRLF이거나, 그 밖에 바이트가 다른 출력을 거절한다. `corepack pnpm check:ci`는 산출물 schema 검사, 타입이 있는 계약 검사기, 이 workflow drift 검사를 돈다. merge 단계는 job 셋(`merge_static`, `merge_test`, `merge_browser`)으로 돌고 job마다 설치를 한 번 한다. 게이트마다 ID 이름의 step이 하나씩 있고, 실패한 게이트가 다음 게이트를 건너뛰게 하지 않는다. merge job 셋만 의존성 캐시를 쓴다(권하는 안으로 정함 2026-11-13, 총괄). setup-node 앞에서 Node toolcache, corepack이 받은 pnpm, pnpm store와 메타데이터 캐시를 `.nvmrc`와 `pnpm-lock.yaml` 해시 키로 복원한다. 저장은 main run만 한다. 캐시 항목은 다음 run이 믿는 입력이다. pnpm은 같은 lockfile의 공급망 검증 기록이 캐시에 있으면 검증을 다시 하지 않는다. 그래서 브랜치 run은 복원만 한다. frozen install은 캐시가 맞든 없든 늘 돈다. 항목이 없거나 깨지면 pnpm이 모자란 패키지만 내려받고 node_modules는 같다. FE-GATE-013의 시스템 컨테이너도 같은 store와 메타데이터 캐시를 받는다. 캐시 폴더는 checkout 밖, checkout과 같은 파일시스템에 둔다(`scripts/ci/dependency-cache-root.sh`). 다른 파일시스템이면 pnpm이 node_modules를 복사해, 캐시가 맞아도 설치가 빨라지지 않는다. 고른 폴더, 견준 장치 번호, job 시작 때의 부하를 job 로그에 한 줄 남긴다. release·promotion·provider job은 공급망 증거를 만들므로 매번 새로 설치한다. 이 규칙은 `scripts/contracts/ci-gates.ts`의 `DEPENDENCY_CACHE`와 계약 검사가 지킨다. runner의 캐시 저장소는 짝 백엔드와 함께 쓰고 크기 상한이 있다(platform-core `infrastructure/ci/gitea-runner/config.yaml`). 검사기 자신의 음성 fixture와 gating 검사는 branch에 push한 뒤 main 단계(`main_gate`, FE-GATE-029)에서 돈다. 선택 runtime 제거 드릴 셋(FE-GATE-030)도 main 단계에서 돈다. PR runner 시간 약 30분 가운데 7분쯤이라 merge에서 뺐고, 실패하면 main이 빨강이 되어 다음 PR이 고친다(권하는 안으로 정함 2026-11-12, 총괄). release와 production 게이트는 matrix check로 남는다. 실패를 무시하는(soft-fail) 연결은 없다. 같은 PR이나 같은 브랜치에 새 push가 오면 workflow `concurrency`가 앞 run을 취소한다. Gitea는 앞 run의 대기 중인 job은 언제나, 돌고 있는 job은 `cancel-in-progress`가 참일 때 취소한다. 수동 실행(`workflow_dispatch`)은 ref와 stage마다 group이 따로이고 돌고 있는 run을 취소하지 않는다. 검증과 승격 사이의 release run이 다음 수동 실행에 끊기지 않게 하려는 것이다. ## 기준선 갱신과 새 프로젝트 시작 시 초기화할 기준선 게이트·명령·산출물 수와 게이트 모양 해시를 따로 기록하던 기준선 파일은 2026-11-08에 지웠다(소유자 결정, design-docs `repo-structure/README.md` 3.3절). 계약의 모양은 `scripts/contracts/ci-gates.ts`의 의미 검사(게이트·job·stage 소유와 순서)가 지킨다. 게이트·명령·산출물을 바꾼 뒤에는 `corepack pnpm generate:ci-workflow`와 `corepack pnpm check:ci`를 돌리고 생성된 workflow를 함께 커밋한다. 제거 검증 (`test:*-removal`)은 줄인 계약을 그대로 불러 canonical `check:ci`를 돌린다 (`scripts/lib/removal-fixture.ts`의 `pruneRemovalFixtureCiContract`). `check:ci:gating`(main 단계 FE-GATE-029)은 `tests/` 아래 테스트 파일(`tests/fixtures` 제외)이 모두 CI 게이트 명령에서 실행되는지 확인한다. 게이트 명령이 닿는 package script의 Vitest 경로와 Playwright 설정의 `testDir`를 모아 비교한다(`scripts/lib/ungated-tests.ts`). `run-scale-profile.ts `를 부르는 명령은 그 tier의 Vitest 경로로 센다. 게이트가 돌리지 않는 테스트는 `config/ci/ungated-tests.json`에 이유와 함께 적어야 한다. 게이트가 이미 돌리는 파일을 이 목록에 남겨 두면 실패한다. package script도 같은 방식으로 확인한다(`scripts/lib/ungated-scripts.ts`). `check:*`·`verify:*`·`test:*`·`drill:*`·`review:*`·`scan:*` 스크립트는 게이트 명령에서 package script 그래프로 닿거나, 게이트가 이미 돌리는 Vitest 경로만 다시 돌려야 한다. 둘 다 아니면 `config/ci/ungated-scripts.json`에 이유와 함께 적는다. 게이트가 닿는 스크립트를 이 목록에 남겨 두면 실패한다. 두 목록에 남은 항목과 이유는 각 파일에 있다. 규모 테스트는 이렇게 나뉜다(리뷰 0925/11-03, `scripts/scale/run-scale-profile.ts`). - `check:scale:pr`은 merge gate `FE-GATE-005`에서 돈다. 개수·상한·증가 모양만 검사하므로 CPU가 달라도 결과가 같다. S0~S2 조합 증가 검사가 여기 있다. S0/S1만 재면 모든 workload가 noise floor 아래라 이차 누적을 놓친다. 조합 timing은 산출물(`artifacts/scale/pr/composition-s0-s2.json`)에 기록만 한다. - `main`·`nightly`·`release` tier는 CI에서 돌지 않는다. 이 tier들은 `baseline-regression`을 포함한다. 이 단계는 `config/scale/benchmark-baseline.json`을 기록한 CPU 모델에서만 timing을 비교하고, 다른 CPU에서는 `incomplete`로 끝난다. 이 tier에만 있는 테스트는 `ungated-tests.json`에, tier를 실행하는 `check:scale:*` 스크립트는 `ungated-scripts.json`에 이유와 함께 남아 있다. 템플릿을 복사해 새 프로젝트를 시작하면 아래 기준선은 템플릿의 값이다. 샘플을 지우거나 구조를 바꾸면 프로젝트 값으로 다시 찍는다. | 기준선 | 파일 | 갱신 방법 | 검사 위치 | |---|---|---|---| | registry 스냅샷과 승인 | `config/contracts/registry-baseline.json`, `registry-baseline.approval.json` | `update:registry-baseline` (`REGISTRY_BASELINE_OWNER`·`_REASON` 필수). 기준선을 새로 찍지 않고 breaking 변경을 유지하려면 `config/contracts/registry-change-evidence.json`에 항목을 추가(`changeId`, 그 변경 뒤 값 `after`(삭제는 생략, 값은 JSON 그대로이고 키·원시값 배열 순서는 상관없다), `versionBump`·`migration`·`compatibilityWindow`·`rollback`·`owner`). 같은 칸을 다시 바꾸면 `after`가 달라 새 항목이 필요하다. 지금 diff의 breaking 변경과 changeId가 맞지 않는 항목이 있으면 게이트가 그 항목을 나열하며 실패한다. `update:registry-baseline`은 새 기준선이 설명하는 항목을 모두 지운다(지운 항목은 git 이력에 남는다) | `scripts/check-registries.ts`의 baseline 비교 | | 커버리지 모듈 수 하한 | `config/testing/risk-coverage.json`의 `repositoryBaseline` | 직접 수정. 지운 production 모듈 수만큼 줄인다(`scripts/test-sample-removal.ts`가 같은 계산을 한다) | `scripts/lib/risk-coverage.ts` "repository module baseline" | | 기능 끄기 설정 | `config/runtime/.json`의 `FEATURE_OVERRIDES` | 직접 수정. 지운 기능의 키를 뺀다(`scripts/test-sample-removal.ts`가 같은 일을 한다) | 실패하는 검사는 없다. 남은 키는 아무것도 끄지 않고, `check:release-admission`(FE-GATE-027)이 `release admission warning: FEATURE_OVERRIDES. … the override does nothing`을, 부팅이 진단 `feature.override.unknown`(warn)을 남긴다(리뷰 0925/09-09) | | 의존성 목록 | `config/security/dependency-baseline.json`, `dependency-baseline.approval.json` | `update:dependency-baseline` (`DEPENDENCY_BASELINE_OWNER`·`_REASON` 필수) | `scripts/generate-supply-chain.ts` | 계약을 불러올 때, runner가 실행 callback에 들어가기 전에 등록된 명령 항목을 모두 검증한다. 기준은 정본인 루트 package script 그래프와 lifecycle/install 정책이다. 그래서 다른 cwd/workspace의 script로 넘기는 호출, 인자에 따라 동작이 바뀌는 dispatcher, 효과 없는 lifecycle 억제는 사전 검사(preflight)에서 실패한다. 나중의 `check:ci` 명령이 돌지 않는 경우에도 그렇다. npm에서는 이 루트 전용 경계가 명시적 `run`/`run-script` 대상이나 암묵적 `test`/`start`/`stop`/`restart` 대상 뒤의 옵션도 해석한다. `--workspace`, `-w`, `--workspaces`, `--prefix`는 다른 manifest 범위를 가리키므로 실행 전에 거절한다. 처음 나오는 글자 그대로의 `--`가 npm 옵션 해석을 끝낸다. 그 뒤 token은 일반 script 인자다. pnpm과 Yarn은 다르다. 고른 script 이름 뒤의 옵션은 그 script로 넘어간다. cwd/workspace 선택자는 package manager가 script를 고르기 전에 소비하는 위치에 있을 때만 거절한다. npm 그래프는 명시적 `run`/`run-script` 의존과 암묵적 `start`/`stop`/`restart`/`test` 의존마다, 그 앞뒤에 있는 루트 manifest의 `pre