# 게이트 무엇을 돌릴지는 **언제인지**로 정한다. 작업 중에는 바뀐 테스트 파일만, 커밋 전에는 검사 몇 개(package script, 2절 표), 통합 때는 몇 개를 더, merge 가능을 말할 때는 merge 단계 전부를 CI와 같은 env로 돌린다. 어디서 어떻게 돌리는지는 [../operate.md](../operate.md) 4.1절이다. ```text 작업 중 바뀐 테스트 파일 하나 (2절) 커밋 전 검사(package script) (2절) 묶음 끝·통합 + 검사 더 (2절) merge 판정 scripts/verify.sh merge (stage 전부, CI env) (3절) 리뷰 시작 merge 단계 + documentation 단계 (3절) ``` 게이트 ID·단계·명령의 정본은 `config/ci/gates.json`이고 설명은 `docs/operations/ci-quality-gates.md`다. 이 문서는 그 목록을 다시 적지 않는다. ## 1. 진입점 `scripts/verify.sh` ```text scripts/verify.sh <단계> [대상…] [--on here|<호스트>] [--log <이름>] [--dry-run] ``` | 단계 | 하는 일 | 기본 위치 | | --- | --- | --- | | `docs` | 작업 매뉴얼 검사(`scripts/check-work-docs.py`)와 장부 형식 | 여기(노트북) | | `hooks` | repo 훅·검사기·장부 시험(`python3 -m unittest discover -s scripts/tests`) | 여기 | | `gate …` | 게이트마다 `corepack pnpm ci:gate `, CI env로 | desktop | | `parts ` | 그 게이트의 명령(`commandIds`)을 하나씩 끝까지. 음성 fixture(`expect: fail`)는 정해진 종료 코드면 통과 | desktop | | `script <이름>… [-- 인자…]` | package script를 하나씩(예: `verify:documentation`). `--` 뒤 인자는 script가 하나일 때만 넘긴다(예: `scripts/verify.sh script test:sample-removal -- --feature=`) | desktop | | `exec -- <명령…>` | 명령 하나. 한 테스트 파일(`node scripts/run-vitest.ts run <파일>`)이나 package script가 아닌 node 스크립트 | desktop | | stage id | `config/ci/gates.json` `stages`의 그 단계 `gateIds` 전부 | desktop | - stage id는 계약 파일에서 읽는다. 단계가 바뀌면 스크립트를 고치지 않아도 따라간다. `--dry-run`은 돌릴 명령만 보인다. - 게이트·stage는 실패가 있어도 끝까지 돌고 게이트마다 `<이름> rc= <초>s` 한 줄을 남긴다. 하나라도 실패하면 rc=1이다. 종료 코드 2는 사용법, 4는 원격 준비 실패다. - 잘못된 단계·게이트 ID는 desktop에 보내기 전에 노트북에서 거절한다. - desktop에서 바뀐 파일(생성 명령, 기준선 다시 쓰기의 결과)은 로그 폴더의 `changes.patch`에 남는다. `--apply-back`을 주면 그 패치를 노트북 작업 트리에 얹는다. 예: `scripts/verify.sh script create:feature --apply-back -- --with-create`. - `VERIFY_SNAPSHOT=1`을 주면 `artifacts`·`dist`·`test-results`를 로그 폴더의 `snapshot/`에 복사한다. 리뷰어가 함께 읽는 사본이다. - 환경 변수로 바꿀 수 있는 것(호스트, 원격 checkout, 기준 ref, 잠금, 로그 폴더, node 경로)은 스크립트 머리 주석에 있다. 복사한 프로젝트는 [../operate.md](../operate.md) 4.1절과 이 값만 자기 환경으로 바꾼다. ## 2. 언제 무엇을 - 패키지 스크립트는 `corepack pnpm