YORR

분모는 `include: ['src/**/*.{ts,tsx}']` 로 설계했다 — v8 커버리지는 테스트가 실제로 import 한 파일만 센다. 그래서 어떤 테스트도 한 번도 불러오지 않은 소스 파일은 분자에서 빠지는 대신 분모에서도 함께 빠진다. 실행되지 않은 코드가 성적을 깎지 않는 대신, 그 파일이 실제로 안전한지는 이 숫자가 보증하지 않는다.

`World.ts` 의 렌더 루프는 `performance.now()` 로 실제 프레임 간격을 재고, 그 값이 accumulator 반복 횟수와 clamp 분기를 좌우한다. 그래서 이 파일 하나의 branches 커버리지가 실행할 때마다 71.71%에서 84.84% 사이를 오간다 — 코드가 바뀌지 않아도 측정값이 흔들린다.

흔들림의 원인을 특정한 방법은 같은 테스트를 두 번 실행해 비교하는 것이었다 — 전역 branches 가 한 번은 90.48%, 다른 한 번은 91.43%로 나왔다. 코드가 아니라 시계가 흔들림의 원인이라는 뜻이다.

먼저 검토한 대안은 파일별 glob 하한을 따로 거는 것이었다. 그러나 그 방식은 전역 분모에서 해당 파일을 빼주지 않는다는 것을 확인하고 기각했다 — 흔들리는 파일 하나 때문에 전역 하한이 계속 실패하는 구조는 그대로 남는다.

선택한 조치는 이 파일을 측정에서만 제외하는 것이다. 검증에서 빼는 것이 아니다 — `World.ts` 를 다루는 테스트 48개는 그대로 돌며 물리 거동을 계속 검증한다. 빠지는 것은 흔들리는 숫자뿐이다.

근본 해결책은 `World.ts` 가 시간을 인자로 주입받고, 테스트가 그 자리에 가짜 시계를 넣는 것이다. 이것은 렌더 루프 자체를 고치는 일이라 3.5주 안에 끝내지 못했고, 별도 작업으로 유예했다.

두 벌 사이의 어긋남을 막는 것은 `contract.ts` 다. 와이어 계약이 바뀌면 두 하네스가 같은 파일을 참조하고 있으므로 테스트 인프라 쪽이 먼저 깨진다.

실행 대상은 Playwright 프로젝트 4종이다 — mobile-chrome(Pixel 7) · mobile-safari(iPhone 15) · mobile-320 · desktop-chrome.

`narrow-width.spec.ts` 는 스크린샷을 비교하지 않는다. 요소의 실제 위치와 크기를 읽어 넘침을 판정하고, 넘친 요소의 이름을 짚어 보고한다.

도메인 사이의 의존이 한 방향으로만 흐르는지는 `dpdm --circular`(`npm run check:cycles`)로 기계 검사한다.