scripts/check-*.ts 30개(6,351줄)가 게이트 명령의 상당수를 차지한다. 각각을 ESLint 규칙, dependency-cruiser 규칙, vitest 시험으로 옮길 수 있는지 판정 표로 남긴다(design-docs repo-structure/03-ci.md 7.3절 F3). 코드는 바꾸지 않는다. 판정: 시험 8, 일부 이전 9, 스크립트 유지 11, ESLint 규칙 1, 지움 1 (정리 3단계). 위험이 낮고 효과가 큰 후보 5개와, 옮길 때 같이 고칠 증거 계약·drill 목록을 적었다. 위험: 줄 번호는 판정 시점 `ad3a071f` 기준이다. 판정 중에 찾은 가짜 검사 2개(`check-design-system.ts`, `check-diagnostics.ts`의 fixture 표식 검사)는 고치지 않았다. 검증: 문서만. 스크립트를 읽어 판정했고 실행하지 않았다. Refs: design-docs repo-structure/03-ci.md 7.3절 F3
93 lines
34 KiB
Markdown
93 lines
34 KiB
Markdown
# check-*.ts 이전 판정 (F3)
|
|
|
|
- 작성일: 2026-11-08, 기준 커밋 `ad3a071f`(정리 2단계 끝)
|
|
- 정본 설계: design-docs `repo-structure/03-ci.md` 7.3절 F3. 이 문서는 판정만 남긴다. 코드는 바꾸지 않았다.
|
|
- 상태: 판정 표. 옮기는 작업은 이 표를 근거로 따로 한다.
|
|
- 판정 뒤 바뀐 것(2026-11-08): check-optional-recipe-types.ts는 정리 3단계에서 지웠다. `*:fixture` 자기 시험 명령은 merge 게이트에서 main 단계 FE-GATE-029로 옮겼고, CI 계약 기준선 파일은 지웠다. 아래 표의 게이트 칸은 판정 시점(`ad3a071f`) 값이다.
|
|
|
|
대상: `scripts/check-*.ts` 30개, 6,351줄. 코드를 읽고 판정했다. pnpm·tsc·테스트는 돌리지 않았다.
|
|
줄 번호는 모두 `git show ad3a071f:<파일>` 기준이다.
|
|
|
|
## 요약
|
|
|
|
**판정별 개수**
|
|
|
|
- ESLint 규칙: 1개 (check-realtime-boundaries)
|
|
- dependency-cruiser 규칙: 단독으로 옮길 스크립트 0개. 다만 다른 스크립트 안의 import 검사 일부를 옮길 수 있다(design-system, optional-recipes).
|
|
- 테스트: 8개 (adapter-inventory, browser-file-storage-boundaries, optional-recipe-fixtures, realtime-boundary-fixtures, registry-compatibility-fixtures, request-fanout, security-fixtures, supply-chain-fixtures). 합계 1,135줄.
|
|
- 일부 이전: 9개 (app-build-input, architecture, browser-security, design-system, diagnostics, i18n, optional-recipes, registries, test-evidence). 이 중 diagnostics와 i18n은 나눠서 전부 옮길 수 있어 스크립트를 지울 수 있다.
|
|
- 스크립트 유지: 11개 (backend-contract-drift, bundle, ci-contract, compatibility, frozen-lockfile-fixture, release-admission, remediation-ledger, risk-coverage, supply-chain-provider-fixtures, system-test-prerequisites, v8-coverage-counter-semantics)
|
|
- 삭제함(정리 3단계): 1개 (optional-recipe-types)
|
|
|
|
**위험이 낮고 효과가 큰 후보 5개**
|
|
|
|
1. **check-request-fanout**: 같은 검사가 `tests/architecture/request-fanout.test.ts:11-24`에 이미 있고, fixture 확인은 테스트 쪽이 더 엄격하다. CLI(`:157-185`), package script, gate 명령 1개만 지우면 된다. 증거 artifact가 없다.
|
|
2. **check-app-build-input 기본 모드**: 더 강한 같은 검사가 `tests/architecture/app-build-input.test.ts:87-92`에 이미 있다. FE-GATE-010의 `check-app-build-input` 명령만 지우고 `:bundle`은 남긴다.
|
|
3. **check-browser-file-storage-boundaries**: 이미 있는 ESLint 규칙을 검증하는 207줄짜리 메타 테스트다. `pnpm exec eslint`를 약 19번 띄우는데, vitest에서 ESLint API로 옮기면 프로세스 하나로 끝난다. 증거 artifact가 없다.
|
|
4. **check-realtime-boundaries + check-realtime-boundary-fixtures + lib**(합계 219줄): 소스 정규식 검사라 ESLint 로컬 규칙과 fixture 테스트로 옮기기 좋다. 대신 증거 1개(FE-GATE-010)와 실시간 삭제 드릴(FE-GATE-020)을 함께 고쳐야 한다.
|
|
5. **check-supply-chain-fixtures, check-registry-compatibility-fixtures**(217줄): 메모리 안의 값으로 lib 함수만 부르므로 unit test로 그대로 옮길 수 있다. 코드 쪽 위험은 거의 없다. 대신 증거 2개(FE-GATE-013·010)의 계약이 바뀌므로 contract-baseline 재승인이 필요하다.
|
|
|
|
덤으로 할 수 있는 작은 정리가 둘 있다. check-i18n의 카탈로그 비교는 이미 `tests/unit/i18n-contract.test.ts:27-38`과 겹친다. check-diagnostics의 `console.` 검사는 ESLint 기본 규칙 `no-console`로 바로 바꿀 수 있다(지금 src에 console 사용 0건).
|
|
|
|
**옮기기 전에 알아둘 공통 제약**
|
|
|
|
- **"dependency-cruiser 규칙"의 실제 범위**: 이 말은 `.dependency-cruiser.json`에 forbidden 규칙을 추가한다는 뜻이다. 실제 dependency-cruiser는 돌지 않는다. `check-architecture.ts`의 자체 Babel 그래프가 이 파일을 규칙 파일로 읽는다(`check-architecture.ts:103-106`). 지원하는 것은 forbidden(from/to path, circular)뿐이다. `allowed`·`required`를 넣으면 바로 throw한다(`:93-99`). 그래서 "이 파일은 반드시 X를 import해야 한다" 같은 검사는 이 경로로 옮길 수 없다.
|
|
- **이미 막히는 import**: 설치되지 않은 패키지 import와 src 밖으로 나가는 상대 import는 check:architecture가 이미 unresolved로 실패시킨다(`check-architecture.ts:250,310,508`).
|
|
- **증거 artifact 계약**: gates.json에 `command-generated` 증거로 등록된 파일을 만드는 스크립트를 지우면, `run-ci-gate.ts:198-205`가 "freshly produced 아님"으로 게이트를 실패시킨다. 그래서 다음을 같이 고쳐야 한다.
|
|
- gates.json의 `artifacts`·`artifactSchemas`·`evidenceArtifactIds`
|
|
- `scripts/contracts/ci-gates.ts:209-240`의 스키마 id 목록
|
|
- `scripts/contracts/release-artifacts.ts`의 스키마
|
|
- 생성 workflow와 ci-workflow-generation 스냅샷
|
|
- CI 계약 기준선(승인자·사유). 2026-11-08에 지웠다
|
|
- **실패를 보고하는 게이트가 바뀐다**: `tests/unit`은 test:unit과 test:coverage(FE-GATE-005)에서 돈다. `tests/architecture`는 test:coverage에서만 돈다(package.json:51,82). 따라서 FE-GATE-010·013에 있던 확인을 테스트로 옮기면 그 게이트 로그에서 빠지고 FE-GATE-005로 간다.
|
|
- **ESLint 설정**: flat config는 같은 규칙 이름의 옵션을 합치지 않고 덮어쓴다(`eslint.config.ts:909-910` 주석). 새 금지 규칙을 레이어별 `no-restricted-*` 옵션에 끼워 넣으면 서로 덮어쓴다. `build-env/*`, `browser-data-boundary/*`처럼 로컬 규칙 이름으로 따로 둔다. 또 금지 fixture는 ignores(`:500-511`)에 걸린다. 테스트에서는 `new ESLint({ ignore: false })`를 쓰거나 `lintText(source, { filePath })`에 가상 경로를 줘서 돌린다.
|
|
- **script 이름을 부르는 곳**: 삭제 드릴과 스케일 검증이 package script를 이름으로 부른다. 옮길 때 이 목록도 같이 고친다.
|
|
- `test-sample-removal.ts:475-482`
|
|
- `test-realtime-runtime-removal.ts:39-40,95-97`
|
|
- `test-browser-file-storage-runtime-removal.ts:55,145`
|
|
- `test-optional-recipe-removal.ts:47-48`
|
|
- `verify-extreme-scale.ts:28-31`
|
|
|
|
## 판정표
|
|
|
|
| 스크립트 | 줄 | 게이트·script | 검사 내용 | 판정 | 근거 | 위치 | 크기 |
|
|
|---|---|---|---|---|---|---|---|
|
|
| check-adapter-inventory.ts | 259 | `check:adapter-inventory` → FE-GATE-010 | 다섯 가지를 확인한다: ① `git ls-files src/adapters`와 INVENTORY.md 표·합계가 같은지 ② SW 에셋 생성기가 공용 확장자 표를 쓰는지 ③ node_modules를 symlink로 직접 잇지 않는지 ④ 지정한 4개 파일이 `platform/abortable-operation.ts`를 import하는지 ⑤ 손으로 짠 abort 리스너 파일이 13개 이하인지 | 테스트 | git ls-files·git grep과 저장소 파일만 읽는다. 빌드와 증거 artifact가 없어 vitest로 그대로 옮길 수 있다. ④는 required 규칙이어서 `.dependency-cruiser.json`으로는 못 옮긴다(엔진이 거부). 잃는 것: 실패 위치가 FE-GATE-010에서 FE-GATE-005로 바뀐다. 주석 두 곳이 이 스크립트 이름을 가리키므로 같이 고친다. | check-adapter-inventory.ts:24,58-74,77-94,100-126,139-189,215-237; check-architecture.ts:93-99; src/adapters/platform/index.ts:5; .dependency-cruiser.json:266; gates.json:410 | 작음 |
|
|
| check-app-build-input.ts | 143 | `check:app-build-input` → FE-GATE-010<br>`check:app-build-input:bundle`(`--require-bundle`) → FE-GATE-012 | 생성된 feature·context 인덱스가 현재 앱이 소유한 feature·context만 가져오는지 본다. `--require-bundle`이면 빌드 모듈 목록에 다른 앱의 feature가 섞였는지도 본다 | 일부 이전 | 기본 모드: `tests/architecture/app-build-input.test.ts:87-92`가 같은 함수로 이미 검사한다. 생성된 import가 소유 목록과 같은지까지 보므로 더 강하다. FE-GATE-010 명령만 지우면 된다. `--require-bundle`: 빌드 산출물(`artifacts/quality/vite-module-inventory.json`)이 필요해 스크립트로 남긴다. 증거 artifact 없음. 고칠 곳: ungated-scripts.test.ts:57, verify-extreme-scale.ts:28 | check-app-build-input.ts:85-108,121-130; tests/architecture/app-build-input.test.ts:87-92; package.json:149-150; gates.json:313,430 | 작음 |
|
|
| check-architecture.ts | 1188 | `check:architecture` → FE-GATE-010 | src import 그래프를 직접 만들어 `.dependency-cruiser.json`의 forbidden 규칙, 순환, 해석 안 되는 import를 검사한다. 이 밖에 그래프 엔진 자기검사(fixture 그래프 7개), JS 파일 금지, 레이어별 ESLint fixture 검사를 한다 | 일부 이전 (우선순위 낮음) | 그래프와 규칙 판정은 남긴다. 이 파일이 곧 이 repo의 "dependency-cruiser"다. 진짜 dependency-cruiser는 TS 7을 못 읽어서 쓰지 않는다. 엔진 자기검사(runGraphFixtureChecks 약 290줄), JS 금지 정책, lint fixture는 결정적이라 테스트로 옮길 수는 있다. 걸리는 점 두 가지: 그래프 함수가 export되지 않아 lib로 먼저 빼야 한다. 그리고 `dependency-report.json`(FE-GATE-010 증거)의 `fixtureChecks`·`typeScriptOnlySourcePolicy` 필드가 빠져 스키마가 바뀐다. 줄어드는 양에 비해 손이 많이 간다 | check-architecture.ts:93-99,103-106,135-136,205-218,754,1046; gates.json:303,1175 | 큼 |
|
|
| check-backend-contract-drift.ts | 198 | `check:backend-contract-drift` (게이트 없음, 일부러 제외) | 옆에 있는 백엔드 checkout을 본다. 고정 커밋 문서와 발췌표·답변표가 같은지, 고정 커밋 이후 문서와 scaffold 파일이 바뀌었는지 확인한다 | 스크립트 유지 | 다른 저장소 checkout과 git(rev-parse, show, diff)이 필요하다. 비교하지 못하면 exit 2를 낸다. CI는 이 저장소만 checkout하므로 게이트에서 돌 수 없다. 답변표와 발췌표 비교는 이미 test:unit(backend-contract-pin.test.ts)에 있다 | check-backend-contract-drift.ts:72-90,106-123,152-180; config/ci/ungated-scripts.json:5-6 | — |
|
|
| check-browser-file-storage-boundaries.ts | 207 | `check:browser-file-storage-boundaries` → FE-GATE-010 | 브라우저 저장소·파일 API ESLint 규칙이 허용 fixture는 통과시키는지 본다. 금지 fixture와 다른 어댑터 경로에 놓인 코드(가상 경로 14개)는 막는지도 본다 | 테스트 | 규칙 자체는 이미 eslint.config.ts에 있다. 이 파일은 그 규칙의 메타 테스트다. 지금은 `pnpm exec eslint`를 약 19번 따로 띄운다. vitest에서 ESLint API(`lintFiles`, `lintText({ filePath })`)를 쓰면 같은 판정을 프로세스 하나로 할 수 있다. 증거 artifact가 없고 `npm_execpath` 의존도 사라진다. 고칠 곳: 삭제 드릴이 이 스크립트 대신 테스트 파일을 지우도록 바꾼다 | check-browser-file-storage-boundaries.ts:15-45,47-60,102-171; eslint.config.ts:416-418,940-962; test-browser-file-storage-runtime-removal.ts:55,145; gates.json:354 | 작음 |
|
|
| check-browser-security.ts | 49 | `check:browser-security` → FE-GATE-013 | 보안 ESLint 규칙(eval, dangerouslySetInnerHTML, script 생성)이 허용 fixture는 통과시키고 금지 fixture는 실패시키는지 본다. dist에 `.map` 파일이 없는지도 본다 | 일부 이전 | ESLint fixture 부분은 vitest(ESLint API)로 옮긴다. 지금은 금지 폴더 전체를 한 번 lint해서 실패하는지만 본다. 그래서 4개 파일 중 하나만 걸려도 통과한다. 테스트로 옮기면서 파일별로 확인하면 더 단단해진다. dist `.map` 검사는 빌드 결과가 필요해 남는다. 다만 같은 검사가 check-test-evidence(FE-GATE-008)와 verify-hosting-headers에 이미 있으므로 여기서는 지우거나 한 곳으로 모은다. 증거 artifact 없음 | check-browser-security.ts:20-38; check-test-evidence.ts:442-447; verify-hosting-headers.ts:82; gates.json:470 | 작음 |
|
|
| check-bundle.ts | 159 | `check:bundle` → FE-GATE-012 | 빌드된 dist의 초기 JS·지연 chunk gzip 크기와 파일 수가 예산 안인지 본다. manifest와 산출물 목록이 맞는지, 예산 검사 자체가 초과 값을 실패시키는지도 본다 | 스크립트 유지 | `dist/.vite/manifest.json`과 `artifacts/performance/bundle.json`(빌드 산출물)을 읽는다. bundle.json은 FE-GATE-012 증거다. release-candidate·local-release-evidence·workflow도 이 파일을 읽는다. 안에 있는 예산 자기검사 3개는 unit test로 뺄 수 있다. 그러면 bundle.json의 `fixtures` 필드가 빠져 스키마가 바뀐다 | check-bundle.ts:29-43,67-109,126-130; gates.json:425,1350 | — |
|
|
| check-ci-contract.ts | 199 | `check:ci`(check:artifact-schemas·check:ci-workflow와 함께) → FE-GATE-010 | gates.json·package.json·workflow가 서로 맞는지 본다. 모든 테스트 파일과 검증 script가 게이트에 걸렸는지, 승격 공식이 한 게이트만 실패해도 막는지, 생성 workflow가 커밋본과 같은지도 본다 | 스크립트 유지 | 저장소 파일만 읽으므로 기술적으로는 테스트가 가능하다. 하지만 CI 계약의 뿌리다. 자기가 쓰는 ci-contract.json을 FE-GATE-010이 반드시 게시해야 한다고 스스로 검사한다. ci-workflow-generation.test.ts:1607이 이 스크립트를 직접 실행하고, 삭제 드릴도 check:ci를 부른다. 옮기면 증거 계약을 다시 짜야 해서 얻는 것이 없다 | check-ci-contract.ts:85-120,127-133,190-194; gates.json:585,1698; test-sample-removal.ts:482 | — |
|
|
| check-compatibility.ts | 87 | `verify:compatibility`(`--update-baseline` 갱신 모드 있음) → FE-GATE-014 | runtime config 스키마 변경 분류 fixture가 기대값과 같은지 본다. 현재 스키마가 커밋된 baseline보다 breaking이 아닌지도 본다 | 스크립트 유지 | 계산은 결정적이다. 하지만 FE-GATE-014의 유일한 명령이고 compatibility.json이 유일한 증거다(release_gate, 승격 공식에 포함). 옮기면 게이트가 빈다. baseline 비교는 이미 compatibility.test.ts:94-109가 "none"으로 더 엄격하게 한다. `--update-baseline` 갱신 도구 역할도 한다 | check-compatibility.ts:29-33,38-51,53-71; tests/unit/compatibility.test.ts:94-109; gates.json:475,1479,2006-2016 | — |
|
|
| check-design-system.ts | 183 | `check:design-system` → FE-GATE-010<br>`check:design-system:fixture`(`--fixture`, 실패 기대) → FE-GATE-010 | 토큰 CSS를 본다: 필수·다크 토큰, 정의 안 된 `var()`, hue 혼합, 포커스 대비, 읽히지 않는 토큰, 폰트, forced-colors. src TS에서는 react-aria·radix 직접 import와 원시 색값(#hex, `oklch(`, `rgb(`)을 찾는다 | 일부 이전 | 부분별로 나눈다: ① headless vendor import → `.dependency-cruiser.json` forbidden 규칙(외부 패키지 규칙 선례 `:326`). 지금은 설치도 안 된 패키지라 import하면 check:architecture가 이미 막는다 ② 원시 색값 → ESLint 로컬 규칙. 문자열 리터럴을 검사하고 `tokens/`는 뺀다. 주석에서 생기던 오탐이 사라진다 ③ CSS 검사 → vitest. ESLint는 CSS를 못 본다. design-system-rules.test.ts가 이미 규칙 함수와 이 스크립트 실행을 테스트한다 ④ 툴팁 검사 → 버린다. fixture에만 있는 표식 문자열을 찾는 가짜 검사라 잃는 게 없다. 잃는 것: design-system.json·-fixture.json 증거, 실패 기대 명령. 삭제 드릴 test-sample-removal.ts:476 | check-design-system.ts:34-119,139-149,150-155,168-175; .dependency-cruiser.json:326; gates.json:318,323,1184,1193 | 중간 |
|
|
| check-diagnostics.ts | 142 | `check:diagnostics` → FE-GATE-010<br>`check:diagnostics:fixture`(`--fixture`, 실패 기대) → FE-GATE-010 | 진단 context 키마다 카디널리티가 있는지, telemetry 속성에 request 카디널리티가 없는지 본다. 이벤트마다 생산자 파일에 이벤트 이름이 있는지, src에 `console.`이 없는지, `record()`·`emit()` 호출에 민감한 키가 없는지도 본다 | 일부 이전 (나누면 스크립트 삭제 가능) | 부분별로 나눈다: ① `console.` → ESLint 기본 `no-console`(src 전체). 지금 src의 console 사용은 0건 ② 민감 키 → ESLint 로컬 규칙(호출 인자 객체의 키와 문자열 검사). 지금 정규식은 호출 텍스트 700자 안에 그 단어가 어디든 있으면 걸리므로 판정이 조금 달라진다 ③ 레지스트리·생산자 검사 → unit test. src/contracts 상수 import와 고정 파일 읽기뿐이다 ④ `UNKNOWN_DIAGNOSTIC_EVENT` 검사 → 버린다. fixture 표식만 찾는 가짜 검사다. 고칠 곳: registry-governance.json:522(이 파일을 TELEMETRY_REGISTRY 소비자로 등록), second-api-feature-registries.test.ts:204-209(이 파일을 복사), verify-extreme-scale.ts:31. 잃는 것: diagnostics.json·-fixture.json 증거 | check-diagnostics.ts:54-90,95-108,109-114,126-133; config/contracts/registry-governance.json:522; gates.json:342,347,1220,1229 | 중간 |
|
|
| check-frozen-lockfile-fixture.ts | 39 | `check:frozen-lockfile:fixture` → FE-GATE-001 | package.json을 바꾼 임시 폴더에서 `pnpm install --frozen-lockfile`이 실제로 실패하는지 본다 | 스크립트 유지 | pnpm 자식 프로세스와 임시 폴더로 도구 동작을 확인하는 검사다. vitest에 넣어도 같은 spawn이라 줄어드는 게 없다. 오히려 lockfile 게이트(FE-GATE-001)에서 빠진다. 증거는 runner 로그뿐이다 | check-frozen-lockfile-fixture.ts:6-30; gates.json:11 | — |
|
|
| check-i18n.ts | 180 | `check:i18n` → FE-GATE-010<br>`check:i18n:fixture`(`--fixture`, 실패 기대) → FE-GATE-010 | 언어별 메시지 카탈로그의 키와 자리표시자가 ko-KR과 같은지 본다. 화면 코드가 `{error.message}`처럼 백엔드 메시지를 그대로 그리는지도 본다. fixture 모드는 ESLint 화면 문구 규칙도 fixture에 돌려 금지 파일마다 걸리는지 확인한다 | 일부 이전 (나누면 스크립트 삭제 가능) | 부분별로 나눈다: ① 카탈로그 비교 → 지운다. i18n-contract.test.ts:27-38에 이미 있다 ② 백엔드 메시지 출력 → ESLint `no-restricted-syntax`. 화면 문구 블록(eslint.config.ts:911)에 넣고 `.ts`도 포함하게 한다. 스크립트 주석(`:54-61`)은 selector로 못 가린다고 하지만, 지금 정규식도 변수 이름(failure·error·response·backend)과 `.message`만 본다(`:12-13`). selector로 같은 판정이 된다 ③ fixture 검사 → vitest에서 ESLint API(`ignore: false`). 잃는 것: i18n.json·-fixture.json 증거, 실패 기대 명령. 삭제 드릴 test-sample-removal.ts:475 | check-i18n.ts:12-13,31-52,54-61,103-111,113-172; tests/unit/i18n-contract.test.ts:27-38; eslint.config.ts:464-474,909-925; gates.json:330,335,1202,1211 | 중간 |
|
|
| check-optional-recipe-fixtures.ts | 211 | `check:optional-recipe-fixtures` → FE-GATE-010 | 선택 레시피 검사기 자체가 금지 사례 11개를 잡는지 본다: 카탈로그 변조, vendor import, 자격증명 누출, 서버 상태 복제, 레시피 import, 런타임 조합, 번들 표식, 모듈 목록, 예산 1바이트 초과 등 | 테스트 | 전부 lib 함수(validateRecipeCatalog, scanOptionalRecipeSources, scanProductionBundle, measureOptionalRecipeBundle)를 fixture에 돌리는 자기검사다. unit test 모양 그대로다. 지금 이 lib 전용 unit test는 없다. 예산 사례는 레시피마다 vite build를 돌려 느리다. 그 사례만 느린 테스트로 나누거나 스크립트에 남긴다. 잃는 것: optional-recipe-fixtures.json 증거 | check-optional-recipe-fixtures.ts:43-57,59-113,118-187,194-199; gates.json:374,1257 | 중간 |
|
|
| check-optional-recipe-types.ts | 62 | check:types:recipes(지움) → FE-GATE-003(check:types 안에서도 실행) | recipes/에 TS 파일이 있으면 `tsconfig.recipes.json`으로 tsc를 돌린다 | 삭제 예정(PR A) | tsconfig.test.json으로 합쳐지면서 지워진다. 판정 대상이 아니다 | check-optional-recipe-types.ts:8-21; package.json:29,33; gates.json:26 | — |
|
|
| check-optional-recipes.ts | 271 | `check:optional-recipes:source` → FE-GATE-010<br>`check:optional-recipes`(`--require-dist`) → FE-GATE-012 | 다섯 가지를 본다: ① 레시피 카탈로그의 JSON Schema와 규칙 ② 참조 런타임 소스가 있는지 ③ 레시피별 번들 예산(vite build) ④ src 소스 규칙 5개(레시피 import, 선택 안 된 런타임 조합, vendor 직접 import, 자격증명 누출, 서버 상태 복제) ⑤ dist에 선택 안 된 레시피 코드가 없는지 | 일부 이전 | import 규칙만 `.dependency-cruiser.json` forbidden 규칙으로 옮긴다: vendor 직접 import는 관측 vendor 규칙(`:326`)처럼 to 경로로 막고, bootstrap·installed-feature-*에서 참조 런타임 어댑터를 import하는 것도 막는다. src에서 recipes/로 가는 import는 check:architecture가 "src 밖" unresolved로 이미 막는다. 정규식 일부는 남는다: `new URL` 같은 문자열 경로는 그래프가 못 보기 때문이다. 자격증명·서버 상태 정규식은 의미가 느슨해 ESLint로 옮기면 판정이 바뀐다 → 유지를 권한다. 카탈로그, vite build 예산, dist 검사는 빌드가 필요해 유지한다. optional-recipes.json은 FE-GATE-010·012 증거로 그대로 남는다. 삭제 드릴 test-optional-recipe-removal.ts:47-48 | scripts/lib/optional-recipes.ts:241-338,341; check-optional-recipes.ts:53-70,100-128; check-architecture.ts:508; gates.json:369,435,1247 | 중간 |
|
|
| check-realtime-boundaries.ts | 43 (+lib 130) | `check:realtime-boundaries` → FE-GATE-010 (`--source-root`·`--artifact`로 fixture에도 쓴다) | realtime·web-push 어댑터 밖에서 다음이 없는지 본다: WebSocket·EventSource·Notification 생성, `requestPermission`, `showNotification`, `pushManager` 호출, `Reflect.get` 우회. presentation에 `setInterval`이 없는지도 본다 | ESLint 규칙 | lib는 소스 텍스트 정규식 검사뿐이라 AST 규칙에 잘 맞는다. lib 주석(`:4-6`)도 "그래프가 못 보는 네이티브 호출"을 맡는다고 하는데, ESLint는 이것을 본다. 로컬 규칙 하나로 만든다: files는 `src/**`, ignores는 두 어댑터 폴더, presentation에는 `setInterval` 금지. 주석과 문자열에서 생기던 오탐도 사라진다. 잃는 것: realtime-boundaries.json 증거(FE-GATE-010). 실시간 삭제 드릴(FE-GATE-020)은 이 스크립트 2개와 lib를 지우는 방식이라, ESLint 블록을 지우는 방식으로 바꿔야 한다 | scripts/lib/realtime-boundaries.ts:4-6,17-29,54-92; check-realtime-boundaries.ts:12-25; test-realtime-runtime-removal.ts:39-40,95-97; gates.json:359,1238 | 중간 |
|
|
| check-realtime-boundary-fixtures.ts | 46 | `check:realtime-boundaries:fixture` → FE-GATE-010 | 위 검사를 자식 프로세스로 돌려, 허용 fixture는 통과하고 금지 fixture는 규칙 2개로 실패하는지 본다 | 테스트 | 위 스크립트가 ESLint로 가면 이 파일은 vitest에서 ESLint API(또는 RuleTester)로 fixture를 lint하는 테스트가 된다. 위 스크립트를 그대로 두더라도 `scanRealtimeBoundaries`를 직접 부르는 unit test로 바로 옮길 수 있다. 증거 artifact 없음(`.tmp`에 쓴다) | check-realtime-boundary-fixtures.ts:3-11,18-28,34-46; gates.json:364 | 작음 |
|
|
| check-registries.ts | 777 | `check:registries` → FE-GATE-010<br>`--governance`·`--approval` fixture 3개(baseline·registry·routes, 실패 기대) → FE-GATE-010<br>`update:registry-baseline`(`--no-baseline`) | 레지스트리 모듈을 import해 필수 필드, 타입, 유일성, 참조, 소비자 토큰, 고아 행을 본다. baseline 승인 digest와 breaking 증거를 확인하고 스냅샷을 기록한다. application·presentation·domain에서 fetch·localStorage·`import.meta.env`·`"/api/"`를 직접 쓰는지도 본다 | 일부 이전 | 직접 사용 검사(`:666-690`)만 ESLint로 옮긴다. fetch·localStorage는 이미 레이어별 `no-restricted-globals`와 겹친다. `import.meta.env` 읽기와 `"/api/"` 문자열은 로컬 규칙으로 추가한다. governance fixture는 sourceDirectories가 비어 있어 이 변경의 영향을 받지 않는다. 나머지는 유지한다: registries.json 스냅샷은 update:registry-baseline의 입력이자 FE-GATE-010 증거이고, 실패 기대 fixture 명령 3개가 진단 문구로 걸려 있다 | check-registries.ts:666-690,700-735,763-770; eslint.config.ts:629-697; package.json:105-110; gates.json:379,389,396,403,1266 | 작음 (ESLint 부분) |
|
|
| check-registry-compatibility-fixtures.ts | 66 | `check:registries:compatibility-fixtures` → FE-GATE-010 | 레지스트리 스냅샷 diff 분류 fixture가 맞는지 본다. breaking 변경에 증거가 없으면 실패하는지, 변조된 baseline digest를 거부하는지도 본다 | 테스트 | JSON fixture 하나를 읽어 lib 함수만 부른다. 파일 시스템 작업이나 빌드가 없다. registry-compatibility.test.ts가 lib는 이미 테스트하지만 이 fixture 파일은 읽지 않는다 → 그 테스트에 케이스를 추가한다. package script는 쓰지도 않는 인덱스 생성기를 먼저 돈다. 잃는 것: registry-compatibility-fixtures.json 증거(FE-GATE-010, 다른 소비자 없음) | check-registry-compatibility-fixtures.ts:11-52,54-59; package.json:107; gates.json:384,1275 | 작음 |
|
|
| check-release-admission.ts | 199 | `check:release-admission` → FE-GATE-027<br>운영자용 `--config`·`--original` 모드 | 빌드된 `dist/config.json`이 RELEASE_TARGET(과 APP_PROFILE) 환경에 맞는지 본다. 수정본은 비상 스위치 말고 빌드 필드를 바꾸지 않았는지 본다 | 스크립트 유지 | 입력이 빌드 산출물과 환경 변수이고, 운영자가 직접 쓰는 CLI다. deployment-admission.json은 FE-GATE-027 증거이고 workflow도 읽는다. 판정 로직은 이미 src/contracts/deployment-admission.ts와 그 unit test에 있다 | check-release-admission.ts:35-37,72-94,98-120,161-181; gates.json:590,1707 | — |
|
|
| check-remediation-ledger.ts | 165 | `check:remediation-ledger` (게이트 없음, 일부러 제외) | 재검토 처분 JSON과 원장 문서의 판정 칸이 같은지 본다. 증거 파일이 있고 finding id를 언급하는지, 열린 항목이 있을 때 "모두 FIXED" 문장이 없는지, file-transfer 예산 숫자가 같은지도 본다 | 스크립트 유지 | 저장소 파일만 읽어 테스트로 옮기기는 쉽다. 그러나 ungated-scripts.json:21-22가 "손으로 돌리는 이력 기록이고 merge를 막으면 안 된다"며 일부러 게이트에서 뺐다. tests/unit에 넣으면 그 결정과 반대로 merge를 막게 된다. 더 필요 없다면 삭제는 따로 판단한다 | check-remediation-ledger.ts:29-42,66-120,139-152; config/ci/ungated-scripts.json:21-22 | — |
|
|
| check-request-fanout.ts | 185 | `check:request-fanout`(같은 명령에서 `--fixture`도 실행) → FE-GATE-010 | src/features·src/application에서 루프나 map·forEach 콜백 안에서 fetch나 transport를 호출하는지(N+1) 본다. `// fanout-reviewed:` 주석은 예외로 허용한다 | 테스트 (이미 있음) | `tests/architecture/request-fanout.test.ts:11-24`가 같은 전체 검사를 이미 한다. fixture 검사는 테스트 쪽이 더 엄격하다(금지 파일마다 걸리는지, 정확히 3개인지). CLI(`:157-185`), package script, gate 명령만 지우고 스캐너는 lib로 옮기면 된다. 증거 artifact 없음. Babel AST 순회라 ESLint 로컬 규칙으로도 옮길 수 있다(에디터 경고가 생기지만 크기 중간). 주의: tests/architecture는 test:coverage(FE-GATE-005)에서만 돈다. 고칠 곳: ungated-scripts.test.ts:57, feature-scaffold-drill.test.ts:32, verify-extreme-scale.ts:29 | check-request-fanout.ts:80-125,157-185; tests/architecture/request-fanout.test.ts:11-24; package.json:82,148; gates.json:308 | 작음 |
|
|
| check-risk-coverage.ts | 78 | `test:coverage` 마지막 단계 → FE-GATE-005<br>`check:coverage:fixture`(`--summary` fixture, 실패 기대) → FE-GATE-005 | 커버리지 결과가 위험 정책(config/testing/risk-coverage.json)의 모듈별 기준을 넘는지 본다 | 스크립트 유지 | 입력이 coverage 실행 결과(`artifacts/tests/coverage/coverage-summary.json`)라 테스트 실행 뒤에만 돌 수 있다. risk-coverage.json·-fixture.json이 FE-GATE-005 증거다. 판정 로직은 lib와 unit test에 이미 있다 | check-risk-coverage.ts:35-46,60-70; package.json:82-83; gates.json:205,210,944,953 | — |
|
|
| check-security-fixtures.ts | 10 (+lib 170) | `check:security:fixtures` → FE-GATE-013 | 비밀값 스캐너 CLI가 금지 fixture에서 정확히 3건으로 실패하는지 본다. include 경로가 맞지 않으면 artifact 없이 실패하는지도 본다 | 테스트 | lib가 이미 의존성 주입을 받고, 실패 경로 unit test도 있다. 실제 CLI 실행도 vitest에서 같은 spawn으로 하면 된다. 증거 artifact 없음(임시 폴더에 쓴다). 잃는 것: 이 확인이 보안 게이트(FE-GATE-013) 로그에서 빠지고 FE-GATE-005로 간다. supply-chain.test.ts:458-483이 "FE-GATE-013이 이 script를 돈다"를 검사하므로 같이 고친다 | scripts/lib/security-fixture-check.ts:30-49,85-118,120-170; tests/unit/supply-chain.test.ts:417,458-483; gates.json:465 | 작음 |
|
|
| check-supply-chain-fixtures.ts | 151 | `check:supply-chain:fixtures` → FE-GATE-013 | 공급망 lib가 다음 9가지를 거부하는지 본다: 의존성 diff, 무결성 값, 자기 승인, 금지 라이선스, 만료된 예외, SBOM·provenance 불일치, 정렬, baseline 변조, 스캐너 증거 오류 | 테스트 | 메모리 안의 값으로 lib 함수만 부른다. 파일 읽기와 빌드가 없어 unit test로 그대로 옮길 수 있다. package script는 쓰지도 않는 인덱스 생성기를 먼저 돈다. 잃는 것: supply-chain-fixtures.json(FE-GATE-013 증거, 다른 소비자 없음) → 증거 계약이 바뀐다 | check-supply-chain-fixtures.ts:15-140,141-146; package.json:93; gates.json:455,1455 | 작음 |
|
|
| check-supply-chain-provider-fixtures.ts | 417 | `check:supply-chain:provider-fixtures` → FE-GATE-013 | 저장소를 임시 폴더로 복사해 release candidate를 실제로 빌드하고, 묶고, 서명한다. 그 뒤 정확한 5개 파일 승격 검증과 서명 검증이 제대로 동작하는지 본다 | 스크립트 유지 | 저장소 복사, `pnpm build:release-candidate`, tar, git, 키 생성이 모두 필요한 끝단 검사다. supply-chain-provider-fixtures.json이 FE-GATE-013 증거다 | check-supply-chain-provider-fixtures.ts:50-64,66-80,101; gates.json:460,1464 | — |
|
|
| check-system-test-prerequisites.ts | 154 | `test:system` 첫 단계 → FE-GATE-013 | 호스트에 bwrap·systemctl·tar가 있는지, cgroup v2와 systemd 버스가 동작하는지, 비특권 user namespace가 허용되는지 본다 | 스크립트 유지 | 실제 호스트를 확인하는 사전 점검이다. 판정 로직은 이미 의존성 주입 방식으로 unit test(system-test-prerequisites.test.ts)가 있다. workflow와 gates.json도 이 파일을 이름으로 참조한다 | check-system-test-prerequisites.ts:55-97,146-154; package.json:53; gates.json:232 | — |
|
|
| check-test-evidence.ts | 471 | `check:test-evidence:browser`(`--skip-scenario-executions`) → FE-GATE-008<br>`check:test-evidence:fixture`(`--source-root`, 실패 기대) → FE-GATE-008<br>`check:http-scenario-evidence`(+`:fixture`) → run-http-scenario-evidence.ts를 거쳐 FE-GATE-007<br>`check:test-evidence`·`:source`는 로컬용 | 소스 쪽: tests/의 `.only`, 기한 없는 `.skip`, 화면 전체 mask, 정책의 필수 토큰, playwright 설정 토큰과 forbidOnly, e2e가 strict fixture를 쓰는지, visual baseline 4개 이상. 실행 결과 쪽: HTTP 시나리오 실행 영수증이 카탈로그와 같은지, results.xml과 dist 산출물이 있는지, dist에 `.map`이 없는지 | 일부 이전 | 소스만 보는 부분(`:280-311`, `:326-340`, `:366-418`)은 unit test로 옮긴다. `.only`와 mask는 ESLint로도 되지만, fixture 트리에 `.fixture`·`.txt` 파일이 있어 ESLint가 읽지 못한다 → 테스트가 맞다. 영수증, results.xml, dist 검사(`:420-447`)는 실행·빌드 산출물이 필요해 남는다. 잃는 것: test-evidence.json의 일부 사실과 실패 항목(스키마·증거 변경). 삭제 드릴의 check:test-evidence:source 호출(test-sample-removal.ts:481)도 고쳐야 한다. 모드가 많아 손이 많이 간다 | check-test-evidence.ts:130-278,280-311,326-340,345-360,366-418,420-447; gates.json:272,277,1115,1124 | 큼 |
|
|
| check-v8-coverage-counter-semantics.ts | 12 (+lib 294) | `check:v8-coverage-counter-semantics` → `test:coverage` 첫 단계, FE-GATE-005 | 임시 폴더에서 vitest coverage를 돌려, import만 있는 모듈의 V8 카운터가 0/0으로 나오는지 본다(위험 커버리지 판정의 전제) | 스크립트 유지 | vitest를 자식 프로세스로 돌려 도구 동작을 확인하는 점검이다. coverage 실행 직전에 돌아야 의미가 있다. lib에는 unit test가 이미 있다 | scripts/lib/v8-coverage-counter-semantics.ts:186-205; package.json:81-82; gates.json:205 | — |
|
|
|
|
## 조사 중 확인한 것 (판정과 별개)
|
|
|
|
- **가짜 검사 2개**: `check-design-system.ts:150-155`와 `check-diagnostics.ts:109-114`는 fixture 파일에만 들어 있는 표식 문자열(`TOOLTIP_ONLY_REQUIRED_INFORMATION`, `UNKNOWN_DIAGNOSTIC_EVENT`)을 찾아 실패를 만든다. 실제 규칙은 검사하지 않는다.
|
|
- **dist `.map` 검사 중복**: 같은 검사가 세 곳에 있다(`check-browser-security.ts:35-36`, `check-test-evidence.ts:442-447`, `verify-hosting-headers.ts:82`).
|
|
- **약한 fixture 확인**: `check-browser-security.ts:27-38`은 금지 fixture 폴더 전체가 한 번 실패하는지만 본다. 그래서 4개 파일 중 하나만 걸려도 통과한다.
|
|
- **불필요한 생성기 실행**: `check:supply-chain:fixtures`와 `check:registries:compatibility-fixtures`는 쓰지도 않는 인덱스 생성기를 먼저 돈다(package.json:93,107).
|
|
- **생성기 없이 읽는 스크립트**: 반대로 `check:app-build-input`은 생성기를 돌리지 않고 `src/.generated`를 읽는다(package.json:149). 그래서 앞 단계가 남긴 인덱스에 기대고, 혼자 돌리면 오래된 인덱스를 볼 수 있다. CI에서는 FE-GATE-010의 check:architecture가 먼저 생성해 줘서 문제가 드러나지 않는다.
|