Commit Graph
11 Commits
Author SHA1 Message Date
DongHyeonka 4cef2a2716 fix(cache-storage): 읽히지 않는 active pointer를 activation 옵션으로 덮어쓴다
문제: control cache의 active pointer entry는 있는데 저장된 본문이 다시
쓰기 전까지 계속 읽히지 않으면(blob 손실 등) Cache Storage 관리가 모두
멈춘다. readActivePointer는 이 실패를 UNAVAILABLE/RETRY(또는
NOT_READABLE/REOPEN)로 돌려주고 CORRUPT_DATA로 보지 않는다. activation은
CORRUPT_DATA 밖의 pointer 실패에서 멈추고, cleanup·inspect·조회도 같은
실패에서 멈춘다. pointer를 쓰는 곳은 activation 하나라서 RETRY를
지켜도 돌아오지 않는다. 돌아오는 길은 adapter 밖에서 control cache를
지우는 것뿐이다. 리뷰 실험 02-R1 X3이 이것을 보였다.

고른 방법: activateRelease에 선택 옵션 replaceUnreadablePointer를 둔다.
true면 이전 pointer를 읽지 못한 이유와 상관없이, 손상 pointer와 같은
0929/02-01 경로로 검증된 후보를 rollback 목록 없이 덮어쓴다. 기본값은
지금처럼 멈춤이라 "일시 오류 하나로 rollback 목록을 잃지 않는다"는
보존 조건이 지켜진다. 포트 주석, 설계 문서 8.3절, 운영 문서에 언제
쓰는지와 rollback 목록을 잃는다는 것을 적었다.
버린 대안: (가) 문서에 "control cache를 지우고 다시 activate"만 적기.
제품이 adapter 밖 코드로 소유 cache 이름을 알고 지워야 하고, 그동안
조회가 pointer 없음으로 바뀐다. (다) 연속 N회 실패를 손상으로 보기.
실패 횟수를 저장해야 하고, 긴 일시 오류에서도 rollback 목록을 잃는다.

위험·한계: 옵션을 켜면 일시 오류에서도 rollback 목록을 잃고, 다음
cleanup이 새 활성 release 밖의 owned release cache를 모두 지운다. 그래서
기본값으로 두지 않았다. 일시와 지속을 가르는 판단은 운영자 몫이다.
포트에 선택 칸이 하나 늘었다. 호출부·구현부 모두 호환이라 breaking이
아니다. CHANGELOG [계약] 행은 CHANGELOG 담당에게 남긴다.
1105/02-02의 남은 부분(release marker 본문이 계속 읽히지 않으면 stage가
marker를 다시 쓰지 않는다)은 이 변경으로 풀리지 않는다. marker는 release
cache 안의 entry라 stage 경로를 바꿔야 한다. 범위 밖으로 둔다.
service-worker-pwa 레시피 번들(여유 306 B)에 수십 B가 더해진다.
실제 브라우저에서 pointer 본문 읽기 실패가 지속되는지는 확인하지
못했다(리뷰 5절 미검증과 같다).

검증: desktop batch에서 확인.
node scripts/run-vitest.ts run tests/unit/public-response-cache-repair.test.ts
RED(이 커밋의 테스트 + 부모 src): "replaces a pointer whose body stays
unreadable when the activation asks to (1106/02-01)"가 옵션을 준
activation에서 실패한다. 부모는 옵션을 모르므로 UNAVAILABLE/RETRY를
돌려주고 pointer를 다시 쓰지 않는다. 그 앞의 멈춤 단언(X3와 같은
결과)은 부모에서도 통과한다. 일시 오류 테스트 "still stops activation
when the pointer read fails transiently"는 바뀌지 않았고 통과해야 한다.

Refs: 1106/02-01
2026-11-06 05:21:06 +09:00
DongHyeonka f2a4f32a91 docs(cache-storage): inspect의 verified 뜻과 비용을 port에 적고 판정 불가를 고정한다
문제: `PublicResponseCacheAdminPort.inspect()`의 port 계약은 비용·취소·
판정 불가를 적지 않는다. `verified: false`가 "손상"인지 "읽지 못함"인지
알 수 없고, inspect가 모든 후보의 모든 entry를 다시 읽는다는 것도 port만
보고는 모른다. 판정 불가를 `verified: true`로 바꾸는 변이 M05가 cache 테스트
59건을 모두 통과한다(0929/02-02).

고른 방법:
- port 주석에 적는다. `releaseCandidates`는 entry를 모두 다시 읽어 채우므로
  비용이 cache 수 × entry 수에 비례하고 cursor·deadline·signal이 없다.
  `verified`는 모든 entry를 읽어 manifest와 맞을 때만 `true`이고, 없거나
  다를 때와 읽지 못했을 때(본문 읽기·조회 실패) 모두 `false`다. 둘을 가르는
  것은 activation이고, 같은 manifest로 다시 stage하면 둘 다 다시 쓴다
  (1105/02-02).
- 테스트: 본문을 읽지 못하는 후보와 `cache.match`가 던지는 후보를 inspect가
  `verified: false`로, 성한 후보를 `true`로 보이는지 고정한다. M05를 잡는다.

남긴 것(일부): inspect에 `signal`을 더하거나 판정 불가를 따로 보이는 칸을
더하지 않았다. 둘 다 port 모양을 바꾸고, VD-15 목표 runtime(cursor·deadline)과
같이 정할 일이다. service-worker-pwa 번들 여유(342 B)도 좁다. 결정은 템플릿
소유자 몫이다.

위험·한계: 동작 코드는 바뀌지 않는다(주석과 테스트만).

검증: desktop batch에서 확인
- node scripts/run-vitest.ts run tests/unit/public-response-cache-repair.test.ts
- 변이 M05: `inspect`의 `verified: candidate.kind === "VERIFIED"`를
  `candidate.kind !== "REPAIRABLE"`로 바꾸면 새 테스트가 실패해야 한다.

Refs: 0929/02-02
2026-11-06 02:07:47 +09:00
DongHyeonka 56c0bd053d test(cache-storage): 손상 code 목록의 경계를 code마다 한 행으로 고정한다
문제: 2026-11-03 02-02가 만든 손상 code 목록(`REPAIRABLE_READ_CODES`,
`INTEGRITY_FAILED`·`CORRUPT_DATA`·`POLICY_REJECTED`·`LIMIT_EXCEEDED`)의
경계를 테스트가 고정하지 않는다. 리뷰 배치 02-R1에서 목록에서 하나를
빼거나 `NOT_READABLE`을 더한 변이 5개가 cache 테스트 59건을 모두
통과했다. 지금 테스트는 `TypeError` 하나로 본문 실패를 만들고, stage
재사용 경로의 repair 테스트는 entry가 없는 경우만 본다.

고른 방법: 1105/02-02 묶음에 표 테스트 하나를 둔다. 행은 목록의 code
넷(바이트 변경, 정책 밖 헤더 `cache-control: no-store`, 상한을 넘는
`content-length`, `DataError` 본문)과 목록 밖 본문 실패 둘(`TypeError`,
`NotReadableError`)이다. 행마다 activate가 돌려주는 code와 recovery
(`REHYDRATE`), 다음 stage가 모든 asset을 다시 받는지(fetch 2), 그 뒤
activate 성공을 본다. 손상 넷은 activate에서 `INTEGRITY_FAILED`이고
본문 실패는 원래 code(`UNAVAILABLE`·`NOT_READABLE`)다. 그래서 목록에서
`CORRUPT_DATA`·`POLICY_REJECTED`·`LIMIT_EXCEEDED`를 빼거나 `NOT_READABLE`을
더하면 그 행의 activate code가 바뀌어 실패한다.

위험·한계: 1105/02-02 뒤 stage는 손상과 본문 읽기 실패를 모두 다시 쓴다.
그래서 목록에서 `INTEGRITY_FAILED`를 빼는 변이(F0202-int)는 이제 동등
변이다. 그 code는 목록 밖으로 가도 activate가 같은 `INTEGRITY_FAILED`/
`REHYDRATE`를 돌려주고 stage도 똑같이 다시 쓴다. 리뷰가 걱정한 "바이트가
바뀐 후보를 다시 stage로 고치지 못한다"는 1105/02-02로 막혔고, 그 동작은
이 표의 첫 행이 지킨다. 동작 코드는 바뀌지 않는다(테스트만).

검증: desktop batch에서 확인
- node scripts/run-vitest.ts run tests/unit/public-response-cache-repair.test.ts
- 변이: `public-response-cache-adapter.ts`의 `REPAIRABLE_READ_CODES`에서
  `CORRUPT_DATA`·`POLICY_REJECTED`·`LIMIT_EXCEEDED`를 하나씩 빼고,
  `NOT_READABLE`을 더해 각각 표의 해당 행이 실패하는지 본다.

Refs: 1105/02-04
2026-11-05 22:24:03 +09:00
DongHyeonka 8e9fb1fde6 fix(cache-storage): 다시 stage하면 계속 읽히지 않는 캐시 본문을 다시 쓴다
문제: 2026-11-03 02-02 수정 뒤 저장된 본문을 읽지 못하면(`UNAVAILABLE`·
`NOT_READABLE`) 손상이 아니라 "모름"이다. stage 재사용 경로는 "모름"이면
실패를 돌려주고 다시 받지 않는다. 그래서 다시 쓰기 전까지 계속 읽히지 않는
entry(blob 손실 등)는 다시 stage해도 고쳐지지 않는다(리뷰 실험 E-1).
- 새 후보: activate가 `RETRY`를 안내하는데 다시 해도 같다. cleanup으로
  후보를 지운 뒤에야 풀린다.
- rollback 대상: cleanup도 지우지 않아 되돌릴 길이 없다.
- 서비스 중 release: 그 asset 조회가 계속 `UNAVAILABLE`이다.
수정 전 판정에서는 같은 상태가 다시 stage 한 번으로 풀렸다.

고른 방법(리뷰 대안 (나)):
- 판정에 `UNREADABLE`(entry는 있는데 본문 읽기가 실패)을 따로 둔다.
  `UNKNOWN`은 중단(`ABORTED`)과 `cache.match` 자체의 실패만 뜻한다.
- stage 재사용 경로는 `REPAIRABLE`처럼 `UNREADABLE`도 모든 asset을 다시
  받아 같은 cache에 덮어쓴다. 덮어쓰는 것은 digest로 검증한 같은
  바이트이고 cache를 지우지 않으므로 서비스 중인 release를 해치지 않는다
  (STO-RR-04가 막는 것은 삭제다).
- activation은 지금처럼 본문 읽기 실패를 손상으로 보고하지 않고 code를
  그대로 둔다. recovery만 `REHYDRATE`(같은 manifest로 다시 stage)로 바꾼다.
- 조회는 그대로 `UNAVAILABLE`/`RETRY`다.
- `cache.match`가 던지는 경우는 리뷰가 제안한 "중단 제외 UNKNOWN 전부"에서
  뺐다. Cache Storage 자체가 응답하지 않을 때 모든 asset을 다시 받는 것은
  고치는 것이 없고, 2026-11-01 02-03 테스트가 그 경우의 실패 보고를 고정한다.

버린 대안:
- (가) 문서에 "cleanup 뒤 다시 stage"만 적기: rollback 대상은 못 고친다.
- (다) 실패한 entry만 다시 받기: 비용은 가장 작지만 stage 경로를 entry
  단위로 나눠야 한다.

위험·한계:
- 일시적인 본문 읽기 오류에도 다시 stage하면 모든 asset을 다시 받는다
  (수정 전과 같은 비용).
- 실제 브라우저에서 본문 읽기 실패가 지속되는지, 어떤 오류 이름으로
  오는지는 확인하지 못했다. 테스트는 메모리 fake에 오류를 주입한다.
- service-worker-pwa 번들 여유가 342 B다(FE-GATE-012). 늘어난 코드는
  분기 둘이다.

검증: desktop batch에서 확인
- node scripts/run-vitest.ts run tests/unit/public-response-cache-repair.test.ts
  tests/unit/public-response-cache.test.ts tests/unit/public-response-cache-codec.test.ts
  tests/recipes/browser-file-storage-contracts.test.ts
- corepack pnpm check:optional-recipes (번들 예산)

Refs: 1105/02-02
2026-11-05 22:22:17 +09:00
DongHyeonka 3bfe6a8580 test(cache-storage): 조회가 eviction 판정 전에 캐시 목록을 다시 읽는지 고정한다
문제: 조회는 cache 이름 목록을 pointer보다 먼저 읽는다. 그 사이 다른
탭의 activation이 pointer를 새 캐시로 옮기면 목록에 그 캐시가 없다.
코드는 목록을 한 번 더 읽고서야 STORAGE_EVICTED를 낸다
(1101/02-04 ⑤, N39). 이 재확인을 지워도 테스트가 모두 통과했다. 빠지면
방금 배포한 release의 첫 조회가 "지워졌다"로 끝나고 REHYDRATE로 간다.

고른 방법: 첫 keys()만 배포 전 목록을 돌려주는 저장소로 r2 활성화 뒤
조회한다. adapter는 만들 때 keys를 잡아 두므로 저장소 하위 클래스로
한 번만 낡은 답을 준다.

위험·한계: 테스트만 바꾼다. 1101/02-04의 N38(host storageArea 비교)은
pulse wire 값을 만드는 하네스가 필요해 이번에 하지 않았다.

검증: N39 변이를 넣으면 이 테스트가 STORAGE_EVICTED로 실패하고(cache
단위 3파일 + tests/recipes 71건 중 1건), 되돌리면 같은 파일 14건 통과.
check:types:test, eslint 통과.

Refs: docs/reviews/2026-11-03-maturity-review/02-adapters-browser-files-cache.md 1101/02-04
2026-11-04 21:01:49 +09:00
DongHyeonka 1dfe86a372 test(browser-files): 손상 데이터·로그아웃 경로의 보호 규칙 5개를 고정한다
문제: 2026-11-03 리뷰 변이 중 아래 5개가 관련 unit 파일을 모두
통과했다. 규칙을 고치는 사람은 테스트가 통과해도 손상·로그아웃 보호가
남았는지 알 수 없다.
- L6 cleanupOwned()가 읽을 수 없는 pointer를 "pointer 없음"으로 보고
  지금 서비스 중인 release까지 지운다.
- L7 stage가 손상된 marker를 고치지 않고 실패한다. REHYDRATE 안내가
  기대는 회복 경로다.
- L4 preview가 파일 resolve 뒤 #disposed를 다시 보지 않는다.
- L5 vault resolveFile이 load 뒤 #disposed를 다시 보지 않는다.
- L1 vault dispose()가 File 참조 Map을 비우지 않는다.
L4·L5는 lease registry가 dispose 뒤에도 lease를 내주기 때문에 소비자
쪽 검사가 유일한 방어선이다.

고른 방법: 규칙마다 실패하는 테스트 하나를 더한다. 리뷰가 L5에
제안한 readRange()는 slice 읽기 뒤에 #disposed를 한 번 더 보므로 L5를
잡지 못한다. 그래서 resolve 직후 소스를 돌려주는 openSource()로
고정했다.

위험·한계: 테스트만 바꾼다. 동작 변경 없음.

검증: 5개 변이를 하나씩 넣고 browser-files 단위 5파일 + tests/recipes,
cache 단위 3파일 + tests/recipes를 돌렸다. L1·L4·L5·L6·L7 모두 새
테스트 하나씩이 실패했고(되돌린 뒤 통과), 원래 코드에서 두 파일 34건
통과. check:types:test, 바꾼 파일 eslint 통과.

Refs: docs/reviews/2026-11-03-maturity-review/02-adapters-browser-files-cache.md 02-03
2026-11-04 20:20:11 +09:00
DongHyeonka 7e7614fd48 fix(cache-storage): 손상 pointer에서도 inspect가 상태와 후보를 보여 준다
문제: inspect()는 active pointer 읽기가 실패하면 그 실패를 그대로
돌려준다. 손상 pointer(CORRUPT_DATA)는 조회·cleanup을 막고 다음
activation이 rollback 없이 덮어쓰는 상태인데, 그 상태를 진단할 유일한
관리 API도 같이 멈춘다. 운영자는 어떤 후보가 남았는지, 다음 activation이
무엇을 덮어쓰고 그 뒤 cleanup이 무엇을 지울지 모른 채 배포한다.
PublicCacheInspection에는 pointer 상태를 담을 칸이 없다.

고른 방법: PublicCacheInspection에 activePointer("NONE" | "READABLE" |
"UNREADABLE")를 둔다. pointer 읽기가 CORRUPT_DATA면 UNREADABLE로 적고
activeReleaseRegistryId는 null로 둔 채 후보 목록을 끝까지 채운다. 일시
오류(UNAVAILABLE 등)는 지금처럼 실패로 돌려준다. activation이 이미 쓰는
"CORRUPT_DATA만 손상으로 본다" 규칙과 같다. recipe fake도 같은 칸을
채운다. 리뷰가 함께 적은 inspect 전용 operation 이름은 공유 operation
union을 바꾸는 일이라 이번에 하지 않았다.

위험·한계: 공개 포트 타입에 필수 칸이 하나 는다. 결과를 읽는 쪽은
그대로지만 이 포트를 직접 구현한 쪽은 칸을 채워야 한다([계약]).
repo 안 소비자는 없다. inspect의 signal·판정 불가(0929/02-02)는
그대로다. service-worker-pwa 번들 9,733 → 9,758 / 10,100 gzip B.

검증:
- RED: public-response-cache-repair.test.ts 새 테스트가 activePointer
  없음으로 실패.
- GREEN: 같은 파일 11건 통과(손상 중 inspect ok, UNREADABLE, 후보
  r1·r2 verified, 일시 오류는 UNAVAILABLE). cache 단위 3파일 +
  tests/recipes 63건 통과. check:types, 바꾼 파일 eslint,
  check:optional-recipes:source PASS, verify:documentation 통과.

Refs: docs/reviews/2026-11-03-maturity-review/02-adapters-browser-files-cache.md 02-05
2026-11-04 20:16:38 +09:00
DongHyeonka f19d4c6e9c fix(cache-storage): 활성화가 본문 읽기 일시 오류를 손상으로 보고하지 않는다
문제: verifyReleaseCandidate는 cache.match()가 던질 때만 UNKNOWN으로
본다. 본문 stream 읽기가 끊기면 readAndValidateResponse가
UNAVAILABLE(retry=true)이나 NOT_READABLE을 돌려주는데, 판정이 ABORTED
밖의 실패를 모두 REPAIRABLE로 바꾼다. 그래서 같은 I/O 오류가 조회에서는
UNAVAILABLE/RETRY, 활성화에서는 INTEGRITY_FAILED/REHYDRATE가 된다. stage
재사용 경로는 후보를 고치려고 모든 asset을 네트워크로 다시 받는다.
같은 파일의 타입 주석은 "unreadable candidate"를 UNKNOWN이라고 적는다.

고른 방법: 저장된 바이트·헤더에 대한 판정인 INTEGRITY_FAILED·
CORRUPT_DATA·POLICY_REJECTED·LIMIT_EXCEEDED만 REPAIRABLE로 두고, 나머지
(UNAVAILABLE·NOT_READABLE·ABORTED 등)는 UNKNOWN으로 둔다. 활성화와
stage 재사용은 이미 UNKNOWN을 자기 operation으로 rebase해 돌려준다.
리뷰가 적은 최소 개선 방향 그대로다. 거꾸로 "실패 code 목록을 UNKNOWN
쪽에 적는" 방식은 새 code가 생기면 손상으로 떨어지므로 버렸다.

위험·한계: stage 재사용 경로는 본문을 읽지 못하면 이제 repair 대신
실패를 돌려준다. 손상이 아닌 것을 손상으로 고치지 않는다는 STO-RR-04와
같은 방향이다. inspect()가 판정 불가를 verified:false로 합치는 것
(0929/02-02)은 그대로다. service-worker-pwa 번들 9,716 → 9,733 /
10,100 gzip B.

검증:
- RED: public-response-cache-repair.test.ts 새 테스트가 활성화
  INTEGRITY_FAILED/REHYDRATE(기대 UNAVAILABLE/RETRY)로 실패.
- GREEN: 같은 파일 10건 통과. 바이트가 다르면 여전히 INTEGRITY_FAILED
  인지 보는 테스트를 같이 넣었다. cache 단위 3파일 + tests/recipes
  62건 통과. check:types 통과. check:optional-recipes:source PASS.

Refs: docs/reviews/2026-11-03-maturity-review/02-adapters-browser-files-cache.md 02-02
2026-11-04 20:14:34 +09:00
DongHyeonka aedd32841f fix(cache-storage): 정책 변경과 손상 뒤에도 다음 배포가 pointer를 덮어쓴다 (0929/02-01)
문제: active pointer를 읽을 때 rollback 목록 길이를 현재
retainedPreviousReleaseCount와 비교한다. 3에서 1로 줄이는 정상 설정
변경이나 pointer JSON 손상 뒤에는 읽기가 CORRUPT_DATA가 되고, 조회·
활성화·정리·inspect가 모두 여기서 멈춘다. control cache를 지우는 API가
없어 사용자가 사이트 데이터를 지우기 전까지 오프라인 캐시가 꺼진 채로
남고, cleanup이 막혀 배포마다 release cache가 쌓인다. 이번 라운드에도
Node와 실제 Cache API 3엔진에서 재현됐다.

고른 방법(지난 리뷰 4.1절의 (나)+(다)):
- (다) isActivePointer는 목록 길이를 현재 값이 아니라 정책이 허용하는
  최댓값(5, MAX_RETAINED_PREVIOUS_RELEASE_COUNT)과만 비교한다. 정책
  검증과 같은 상수를 쓴다. 다음 activation이 이미 하던 slice로 목록을
  현재 값으로 자른다.
- (나) activateRelease는 이전 pointer 읽기가 CORRUPT_DATA면 없는
  것으로 보고, 전체 재검증을 통과한 후보로 rollback 목록 없이
  덮어쓴다. 일시 오류(UNAVAILABLE 등)는 지금처럼 활성화를 멈춘다.

버린 대안:
- 현상 유지 + "사이트 데이터 삭제" 안내. 운영자가 원인을 알 수 없고
  캐시가 계속 쌓인다.
- control을 지우는 admin API. 포트가 늘고 호출자가 언제 불러야 하는지
  알아야 한다.
- (다)만 적용. 정책 변경은 풀리지만 JSON 손상은 풀리지 않는다.

위험·한계:
- 지키던 성질은 그대로다. 검증한 후보만 활성화하고(재검증은 pointer
  읽기 전에 끝난다), 조회는 manifest digest가 맞는 바이트만 돌려준다.
  읽을 수 있는 pointer가 가리키는 캐시는 cleanup이 지우지 않는다.
  손상 pointer 상태의 조회와 cleanup은 다음 activation까지 여전히
  CORRUPT_DATA다.
- 덮어쓰면 손상 pointer의 rollback 목록을 잃는다. 원래 읽을 수 없던
  값이다. 덮어쓴 뒤 cleanup이 구버전 탭이 쓰던 캐시를 지울 수 있다.
  그 탭의 조회는 네트워크로 떨어진다. Service Worker drain(VD-15)을
  구현하면 이 규칙을 다시 본다(지난 리뷰 4.1절 7).
- 리뷰가 "가능하면"으로 적은 3엔진 browser spec(E-2)은 추가하지
  않았다. 단위 테스트(MemoryCacheStorage)로만 확인했다.
- service-worker-pwa 레시피 번들 9,665 → 9,716 / 10,000 gzip bytes.

검증:
- RED(수정 전): public-response-cache-repair.test.ts 새 2건 실패.
  retained 3 → 1 뒤 조회가 { ok: false }(기대 ok:true), 잘린 pointer
  뒤 다음 배포의 activate가 { ok: false }.
- GREEN: 같은 파일 8건 통과. 일시 오류 가드 테스트 1건을 함께 넣었다.
  activate가 모든 pointer 실패를 무시하도록 바꾼 변이를 이 테스트가
  잡는다(1건 실패 확인 뒤 되돌림).
- 회귀: public-response-cache 단위 3파일 40건 통과. tsc app·test·
  service-worker·recipes 통과. 바꾼 파일 eslint 통과.
  verify-documentation-readiness PASS_SCOPED. check-optional-recipes
  (source) PASS.

Refs: docs/reviews/2026-09-29-maturity-review/02-adapters-browser-files-cache.md
2026-11-01 23:14:48 +09:00
DongHyeonka 3bb1829cda fix(cache-storage): stage 재검증 실패를 CACHE_STAGE로 기록한다 (02-03)
문제: 이미 stage된 release를 다시 stage하면 후보를 재검증한다.
재검증 함수 verifyReleaseCandidate는 활성화와 같이 쓰는 함수라 실패
Result의 operation을 CACHE_ACTIVATE로 만든다. 활성화 경로는
rebaseFailure로 바꾸지만 stage의 재사용 경로는 그대로 돌려준다.
Cache API가 재검증 중 일시 오류를 내면 stage 결과와 관측이 모두
CACHE_ACTIVATE가 된다. 운영자는 "활성화 실패"로 읽고, error.operation
으로 분기하는 호출자는 잘못된 경로를 탄다.

고른 방법: stage 재사용 경로도 활성화 경로처럼
rebaseFailure(..., "CACHE_STAGE")로 돌려준다. 한 줄이다.

버린 대안: verifyReleaseCandidate가 operation을 인자로 받게 하는 안.
호출부 세 곳(stage, activate, inspect)을 모두 바꾸고, inspect는 실패를
밖으로 내지 않아 이득이 없다. 리뷰가 함께 적은
readAndValidateResponse의 CACHE_STAGE 고정은 두 소비 경로가 이미
rebase하거나 결과를 내보내지 않아 겉으로 드러나는 결함이 없으므로
건드리지 않았다.

위험·한계: 동작(실패를 성공으로 바꾸지 않음, 후보를 지우지 않음)은
그대로다. 바뀌는 것은 실패의 operation 값뿐이다. service-worker-pwa
레시피 번들 9,662 → 9,665 / 10,000 gzip bytes.

검증:
- RED(수정 전): public-response-cache-repair.test.ts 새 1건이
  operation "CACHE_ACTIVATE"(기대 "CACHE_STAGE")로 실패.
- GREEN: public-response-cache 단위 3파일 37건 통과.
- 회귀: tsc app·test·service-worker 통과. 바꾼 파일 eslint 통과.
  check-optional-recipes(source) PASS.

Refs: docs/reviews/2026-11-01-maturity-review/02-adapters-browser-files-cache.md
2026-11-01 23:14:47 +09:00
donghyeon-ka ec7f20e2ee refactor: 프론트엔드 리펙토링 2026-09-18 22:05:42 +09:00