Files
clean-architecture-frontend…/tests/unit
DongHyeonka 1b6c9a5c95 test(hosting): 워커를 싣는 빌드의 SW 스크립트 헤더 검사를 고정한다 (0929/06-05)
문제
새 워커와 자기 해제 워커는 페이지 없이 클라이언트를 복구하는 유일한
경로다. edge가 루트 `.js`를 길게 캐시하면 그 TTL 동안 롤백과 비상 해제가
늦어진다. 0929/06-05는 SW 선택이 ACTIVE·REMOVE_REGISTRATION인 구성에서
cache policy에 `service-worker.js`(no-cache, JS MIME) 항목과 live probe
확인을 요구했다.

이미 된 것(629c8f0, 1101/13-04)
- config/hosting/cache-policy.json의 `serviceWorker` 표면: path
  `/service-worker.js`, `no-cache`, `text/javascript`·
  `application/javascript`, `requiredWhen: "service-worker-shipped"`
- verify-hosting-headers.ts는 shipsServiceWorker(ACTIVE,
  REMOVE_REGISTRATION)일 때만 이 표면을 요구하고, live 모드에서는
  probeLiveRelease가 그 경로를 요청해 같은 헤더 검사를 거친다
- 그 커밋은 SW null 트리에서만 돌려 "serviceWorker 헤더 검사는 건너뜀"으로
  기록했다. 워커를 켠 구성에서 이 검사가 실제로 실패하는지는 아무도
  확인하지 않았다.

고른 방법
남은 부분은 완료 기준의 증명이다. service-worker-build-output.test.ts가
이미 만드는 SW ACTIVE 빌드(임시 복사본, 추가 빌드 없음)에서
verify-hosting-headers.ts를 fixture 모드로 돌린다.
- 선언대로의 fixture: 실패 0, UNVERIFIED(rc=3)
- `serviceWorker` Cache-Control을 `public, max-age=31536000, immutable`로
  바꾼 fixture: `serviceWorker cache-control` 하나로 FAIL(rc=1)

버린 대안
- 헤더 검사 루프를 함수로 빼서 단위 테스트: 스크립트 구조를 바꾸고도
  INSTALLED_RUNTIME_CAPABILITIES를 거치는 실제 경로는 증명하지 못한다.
- 산출물 스키마가 워커를 싣는 빌드에 serviceWorker 헤더 결과를 요구:
  정책 파일의 항목은 hosting-probe.test.ts가 이미 고정한다. 같은 것을
  두 곳에서 지키게 된다.

위험·한계
- REMOVE_REGISTRATION 빌드는 따로 돌리지 않았다. 표면 요구 조건은
  ACTIVE와 같은 shipsServiceWorker 한 함수이고, 그 함수의 두 모드는
  hosting-probe.test.ts가 확인한다.
- 실제 CDN·호스트 응답은 확인하지 않았다(live 모드 미실행).

검증
- RED(629c8f0 이전 상태 재현: cache-policy.json에서 serviceWorker 항목을
  지움): node scripts/run-vitest.ts run
  tests/unit/service-worker-build-output.test.ts → 1 failed / 6 passed,
  "expected [] to deeply equal [ 'serviceWorker cache-control' ]"
- GREEN(항목 복원): 같은 파일과 hosting-probe.test.ts 29 passed
- tsc(test) 0, eslint 바뀐 파일 0

Refs: docs/reviews/2026-09-29-maturity-review/06-adapters-service-worker-push.md 06-05
2026-11-03 00:56:00 +09:00
..