Files
DongHyeonka b824195cdc docs(ci): ungated-scripts.json의 reason을 한국어로 옮긴다
문제: config/ci/ungated-scripts.json의 reason 18개가 영어다. 설정 파일의
사람이 읽는 설명 칸은 한국어로 쓴다(docs/README.md 2절).

고른 방법: 읽는 코드를 먼저 봤다. scripts/lib/ungated-scripts.ts는 빈
문자열만 막고, tests/unit/ungated-scripts.test.ts는 check:feature-index의
reason에 verify:extreme-scale이 들어 있는지만 본다. 그래서 script 이름·
경로·명령·게이트 ID·리뷰 ID는 그대로 두고 문장만 옮겼다. 옮기다 본
verify:extreme-scale의 「24 scripts」는 실제 23개라 숫자 대신
EXTREME_SCALE_GATES를 가리킨다.

위험: 같은 형식의 config/ci/ungated-tests.json reason은 범위 밖이라 영어로
남았다.

검증: diff가 reason 18줄뿐이다(키·순서·항목 수 같음). ungated-scripts
시험과 check:ci:gating은 desktop에서 돌린다.
2026-11-12 09:40:51 +09:00

78 lines
6.5 KiB
JSON

{
"schemaVersion": 1,
"entries": [
{
"script": "check:backend-contract-drift",
"reason": "1103/12-06, 1105/07-01. 짝 백엔드 checkout(--backend, 없으면 메인 checkout 옆)을 config/contracts/backend-contract-pin.json과 비교한다. 옮겨 둔 표 발췌와 답 표를 pin한 문서와 대조하고, pin과 백엔드 HEAD 사이에 문서가 바뀌었는지 본다. CI는 이 repo만 checkout하므로 게이트에는 읽을 백엔드가 없다. checkout이 없으면 이 script는 0이 아니라 2(비교하지 못함)로 끝난다. 게이트가 도는 쪽은 tests/unit/backend-contract-pin.test.ts(test:unit)이고, Envelope 표를 답 표에, 답 표를 발췌에 맞춰 본다. 백엔드를 pull한 뒤와 pin을 옮기기 전에 돌린다(docs/manual/01-add-a-feature.md)."
},
{
"script": "check:feature-index",
"reason": "커밋하지 않는 생성 색인(src/.generated/)이 최신인지 보는 로컬 검사이고, 그 자체가 로컬 실행인 verify:extreme-scale(scripts/verify-extreme-scale.ts)의 첫 단계다. 게이트에 넣어도 얻는 것이 없다. 모든 게이트 script가 먼저 색인을 다시 만든다(generate-product-feature-index.ts)."
},
{
"script": "check:http-scenario-evidence",
"reason": "scripts/run-http-scenario-evidence.ts가 돌린다. 이 runner는 FE-GATE-007의 test:http-scenario-evidence이고, scenario catalog 다음에 이 script를 이름으로 부른다."
},
{
"script": "check:http-scenario-evidence:fixture",
"reason": "scripts/run-http-scenario-evidence.ts(test:http-scenario-evidence, FE-GATE-007)가 돌리는 음성 fixture다. 그 runner는 이 script가 TEST-EVIDENCE-EXECUTION-ID-MISSING으로 실패해야 통과로 본다."
},
{
"script": "check:remediation-ledger",
"reason": "2026-08-14 adapter 재검토의 문장 원장(docs/operations/adapter-remediation-ledger.md)을 테스트 파일 표식과 file-transfer 번들 예산에 대조한다. 지금 계약이 아니라 손으로 돌리는 이력 기록이다. 제품이 선택 recipe인 file-transfer를 지우거나 테스트를 나누다 표식이 있는 테스트가 다른 파일로 옮겨 가면 실패하는데, 둘 다 merge를 막을 일이 아니다. 그런 테스트를 옮기거나 그 예산을 바꾼 뒤에 돌리고, 원장 행이 새 파일을 가리키게 고친다."
},
{
"script": "check:scale:baseline",
"reason": "CI 밖의 scale 단계다(scripts/scale/run-scale-profile.ts). baseline-regression을 포함하는데, 이 검사는 config/scale/benchmark-baseline.json을 기록한 CPU 모델에서만 시간을 비교하고 다른 곳에서는 incomplete로 보고한다(리뷰 11-03). 그 기계에서 돌린다. CPU와 상관없는 pr 단계는 FE-GATE-005에서 돈다."
},
{
"script": "check:scale:main",
"reason": "CI 밖의 scale 단계다(scripts/scale/run-scale-profile.ts). baseline-regression을 포함하는데, 이 검사는 config/scale/benchmark-baseline.json을 기록한 CPU 모델에서만 시간을 비교하고 다른 곳에서는 incomplete로 보고한다(리뷰 11-03). 그 기계에서 돌린다. CPU와 상관없는 pr 단계는 FE-GATE-005에서 돈다."
},
{
"script": "check:scale:nightly",
"reason": "CI 밖의 scale 단계다(scripts/scale/run-scale-profile.ts). baseline-regression을 포함하는데, 이 검사는 config/scale/benchmark-baseline.json을 기록한 CPU 모델에서만 시간을 비교하고 다른 곳에서는 incomplete로 보고한다(리뷰 11-03). 그 기계에서 돌린다. CPU와 상관없는 pr 단계는 FE-GATE-005에서 돈다."
},
{
"script": "check:scale:release",
"reason": "CI 밖의 scale 단계다(scripts/scale/run-scale-profile.ts). baseline-regression을 포함하는데, 이 검사는 config/scale/benchmark-baseline.json을 기록한 CPU 모델에서만 시간을 비교하고 다른 곳에서는 incomplete로 보고한다(리뷰 11-03). 그 기계에서 돌린다. CPU와 상관없는 pr 단계는 FE-GATE-005에서 돈다."
},
{
"script": "check:test-evidence",
"reason": "한 번에 모두 보는 로컬 실행이다. CI는 이것을 나눈다. FE-GATE-008이 브라우저 suite 뒤에 check:test-evidence:browser(--skip-scenario-executions)를 돌리고, scenario 부분은 FE-GATE-007의 test:http-scenario-evidence가 맡는다."
},
{
"script": "check:test-evidence:source",
"reason": "--source-only는 check:test-evidence:browser(FE-GATE-008)의 일부다. 브라우저 결과 없이 로컬에서 빨리 돌릴 때 쓴다."
},
{
"script": "drill:runbooks",
"reason": "다섯 drill을 한 번에 돌리는 로컬 단축 명령이다. CI는 drill마다 drill:runbook으로 따로 production 게이트(FE-GATE-021~FE-GATE-025)를 돌린다."
},
{
"script": "test:all",
"reason": "게이트가 하나씩 돌리는 suite(FE-GATE-004~FE-GATE-007)를 묶은 로컬 명령이다. FE-GATE-020의 제거 검사는 package script 그래프가 아니라 scripts/lib/removal-fixture.ts를 거쳐 자기 fixture 안에서 이것을 돌린다."
},
{
"script": "test:e2e:dev",
"reason": "로컬 디버깅용으로 tests/e2e를 Vite 개발 서버(playwright.dev.config.ts)에 돌린다. FE-GATE-008은 같은 spec을 production 빌드에 돌린다(test:e2e)."
},
{
"script": "test:extreme-scale:focused",
"reason": "verify:extreme-scale의 일부다. 경로는 모두 FE-GATE-005에서 돈다. 예외는 main scale 단계에 속하는 tests/scale/global-local-independence.test.ts다(config/ci/ungated-tests.json 참고)."
},
{
"script": "test:visual:update",
"reason": "visual snapshot을 다시 쓰는 갱신 명령이지 검사가 아니다. FE-GATE-008은 test:visual을 돌린다."
},
{
"script": "verify:extreme-scale",
"reason": "package script 여러 개를 차례로 돌리는 로컬 묶음이다. 목록은 scripts/verify-extreme-scale.ts의 EXTREME_SCALE_GATES다. CPU와 상관없는 부분은 게이트에서 돌고, main·nightly·release scale 단계는 기준 CPU가 필요하다(check:scale:main 참고)."
},
{
"script": "verify:promotion",
"reason": "앞선 run이 보관한 promotion bundle(13-04, --archived)을 그 run의 provider 신뢰 key와 EXPECTED_PROMOTION_* 입력으로 다시 검증한다. CI에서는 promotion job이 같은 bundle을 올리기 전에 scripts/stage-verified-promotion.ts로 검증한다."
}
]
}