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에서 돌린다.
This commit is contained in:
@@ -3,75 +3,75 @@
|
||||
"entries": [
|
||||
{
|
||||
"script": "check:backend-contract-drift",
|
||||
"reason": "1103/12-06, 1105/07-01. Compares the paired backend checkout (--backend, or beside the main checkout) with config/contracts/backend-contract-pin.json: the copied table excerpt and the answer table against the pinned document, and the document between the pin and the backend's HEAD. CI checks out this repository alone, so a gate has no backend to read; with no checkout the script exits 2 (not compared), never 0. The gated half is tests/unit/backend-contract-pin.test.ts (test:unit), which holds the Envelope table to the answer table and the answer table to the excerpt. Run this after pulling the backend and before moving the pin (docs/manual/01-add-a-feature.md)."
|
||||
"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": "Local check that the generated indexes (src/.generated/, not committed) are current, and the first step of verify:extreme-scale (scripts/verify-extreme-scale.ts), itself a local run. A gate gains nothing from it: every gate script regenerates the indexes first (generate-product-feature-index.ts)."
|
||||
"reason": "커밋하지 않는 생성 색인(src/.generated/)이 최신인지 보는 로컬 검사이고, 그 자체가 로컬 실행인 verify:extreme-scale(scripts/verify-extreme-scale.ts)의 첫 단계다. 게이트에 넣어도 얻는 것이 없다. 모든 게이트 script가 먼저 색인을 다시 만든다(generate-product-feature-index.ts)."
|
||||
},
|
||||
{
|
||||
"script": "check:http-scenario-evidence",
|
||||
"reason": "Run by scripts/run-http-scenario-evidence.ts, which is test:http-scenario-evidence in FE-GATE-007; that runner calls it by name after the scenario catalog."
|
||||
"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": "Negative fixture run by scripts/run-http-scenario-evidence.ts (test:http-scenario-evidence, FE-GATE-007), which requires it to fail with TEST-EVIDENCE-EXECUTION-ID-MISSING."
|
||||
"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": "Checks the prose ledger of the 2026-08-14 adapter re-review (docs/operations/adapter-remediation-ledger.md) against test-file markers and the file-transfer bundle budget. It is a history record run by hand, not a current contract: it fails when a product removes the optional file-transfer recipe or when a test split moves a marked test to another file, and neither should block a merge. Run it after moving those tests or changing that budget, and point the ledger rows at the new files."
|
||||
"reason": "2026-08-14 adapter 재검토의 문장 원장(docs/operations/adapter-remediation-ledger.md)을 테스트 파일 표식과 file-transfer 번들 예산에 대조한다. 지금 계약이 아니라 손으로 돌리는 이력 기록이다. 제품이 선택 recipe인 file-transfer를 지우거나 테스트를 나누다 표식이 있는 테스트가 다른 파일로 옮겨 가면 실패하는데, 둘 다 merge를 막을 일이 아니다. 그런 테스트를 옮기거나 그 예산을 바꾼 뒤에 돌리고, 원장 행이 새 파일을 가리키게 고친다."
|
||||
},
|
||||
{
|
||||
"script": "check:scale:baseline",
|
||||
"reason": "Scale tier outside CI (scripts/scale/run-scale-profile.ts): it includes baseline-regression, which compares timings only on the CPU model that recorded config/scale/benchmark-baseline.json and reports incomplete elsewhere (review 11-03). Run it on that machine. The CPU-independent pr tier runs in FE-GATE-005."
|
||||
"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": "Scale tier outside CI (scripts/scale/run-scale-profile.ts): it includes baseline-regression, which compares timings only on the CPU model that recorded config/scale/benchmark-baseline.json and reports incomplete elsewhere (review 11-03). Run it on that machine. The CPU-independent pr tier runs in FE-GATE-005."
|
||||
"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": "Scale tier outside CI (scripts/scale/run-scale-profile.ts): it includes baseline-regression, which compares timings only on the CPU model that recorded config/scale/benchmark-baseline.json and reports incomplete elsewhere (review 11-03). Run it on that machine. The CPU-independent pr tier runs in FE-GATE-005."
|
||||
"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": "Scale tier outside CI (scripts/scale/run-scale-profile.ts): it includes baseline-regression, which compares timings only on the CPU model that recorded config/scale/benchmark-baseline.json and reports incomplete elsewhere (review 11-03). Run it on that machine. The CPU-independent pr tier runs in FE-GATE-005."
|
||||
"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": "Local all-in-one run. CI splits it: check:test-evidence:browser (--skip-scenario-executions) in FE-GATE-008 after the browser suites, and the scenario part through test:http-scenario-evidence in FE-GATE-007."
|
||||
"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 is a subset of check:test-evidence:browser (FE-GATE-008), for a quick local run without browser results."
|
||||
"reason": "--source-only는 check:test-evidence:browser(FE-GATE-008)의 일부다. 브라우저 결과 없이 로컬에서 빨리 돌릴 때 쓴다."
|
||||
},
|
||||
{
|
||||
"script": "drill:runbooks",
|
||||
"reason": "Local shortcut for all five drills. CI runs each drill as its own production gate (FE-GATE-021 to FE-GATE-025) through drill:runbook."
|
||||
"reason": "다섯 drill을 한 번에 돌리는 로컬 단축 명령이다. CI는 drill마다 drill:runbook으로 따로 production 게이트(FE-GATE-021~FE-GATE-025)를 돌린다."
|
||||
},
|
||||
{
|
||||
"script": "test:all",
|
||||
"reason": "Local aggregate of suites the gates run one by one (FE-GATE-004 to FE-GATE-007). The removal checks in FE-GATE-020 run it inside their fixtures through scripts/lib/removal-fixture.ts, not through the package script graph."
|
||||
"reason": "게이트가 하나씩 돌리는 suite(FE-GATE-004~FE-GATE-007)를 묶은 로컬 명령이다. FE-GATE-020의 제거 검사는 package script 그래프가 아니라 scripts/lib/removal-fixture.ts를 거쳐 자기 fixture 안에서 이것을 돌린다."
|
||||
},
|
||||
{
|
||||
"script": "test:e2e:dev",
|
||||
"reason": "Runs tests/e2e against the Vite dev server (playwright.dev.config.ts) for local debugging. FE-GATE-008 runs the same specs against the production build (test:e2e)."
|
||||
"reason": "로컬 디버깅용으로 tests/e2e를 Vite 개발 서버(playwright.dev.config.ts)에 돌린다. FE-GATE-008은 같은 spec을 production 빌드에 돌린다(test:e2e)."
|
||||
},
|
||||
{
|
||||
"script": "test:extreme-scale:focused",
|
||||
"reason": "Part of verify:extreme-scale. All its paths run in FE-GATE-005 except tests/scale/global-local-independence.test.ts, which belongs to the main scale tier (see config/ci/ungated-tests.json)."
|
||||
"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": "Rewrites the visual snapshots; it is an update command, not a check. FE-GATE-008 runs test:visual."
|
||||
"reason": "visual snapshot을 다시 쓰는 갱신 명령이지 검사가 아니다. FE-GATE-008은 test:visual을 돌린다."
|
||||
},
|
||||
{
|
||||
"script": "verify:extreme-scale",
|
||||
"reason": "Local aggregate of 24 scripts (scripts/verify-extreme-scale.ts). Its CPU-independent parts run in gates; the main, nightly and release scale tiers need the baseline CPU (see check:scale:main)."
|
||||
"reason": "package script 여러 개를 차례로 돌리는 로컬 묶음이다. 목록은 scripts/verify-extreme-scale.ts의 EXTREME_SCALE_GATES다. CPU와 상관없는 부분은 게이트에서 돌고, main·nightly·release scale 단계는 기준 CPU가 필요하다(check:scale:main 참고)."
|
||||
},
|
||||
{
|
||||
"script": "verify:promotion",
|
||||
"reason": "Re-verifies a promotion bundle archived by an earlier run (13-04, --archived) with provider trust keys and EXPECTED_PROMOTION_* inputs of that run. In CI the promotion job verifies the same bundle through scripts/stage-verified-promotion.ts before it uploads it."
|
||||
"reason": "앞선 run이 보관한 promotion bundle(13-04, --archived)을 그 run의 provider 신뢰 key와 EXPECTED_PROMOTION_* 입력으로 다시 검증한다. CI에서는 promotion job이 같은 bundle을 올리기 전에 scripts/stage-verified-promotion.ts로 검증한다."
|
||||
}
|
||||
]
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user