Files
clean-architecture-frontend…/docs/operations/ci-script-assessment.md
T
donghyeon.kang 3ce77d9e89 docs(ci): check-*.ts를 lint·의존 규칙·시험으로 옮길 수 있는지 판정한다
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
2026-11-08 21:56:38 +09:00

34 KiB

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
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
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
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
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
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
--governance·--approval fixture 3개(baseline·registry·routes, 실패 기대) → FE-GATE-010
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
운영자용 --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
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
check:test-evidence:fixture(--source-root, 실패 기대) → FE-GATE-008
check:http-scenario-evidence(+:fixture) → run-http-scenario-evidence.ts를 거쳐 FE-GATE-007
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가 먼저 생성해 줘서 문제가 드러나지 않는다.