SW를 켜면 빌드가 dist/assets/의 해시 파일을 모두 precache하고, 개수가 SERVICE_WORKER_BOUNDS.assets(256)를 넘으면 멈춘다.
실패 문구는 「Static asset count exceeds its bound.」뿐이라 몇 개가 넘었는지, 어느 값을 봐야 하는지 말하지 않았다.
규모 기록도 SW를 켜면 이 상한이 먼저 올 수 있다는 것도, 그것이 기능 몇 개인지도 적지 않았다.
R9-D7 세부(1112/05-01)
FE-GATE-028이 대조할 「release 후보 ID」를 릴리스 태그로 정한 것을 결정 색인에 적는다.
처음 생각한 후보 release manifest의 releaseId는 FE-GATE-028(release_gate) 때 후보가 아직 없고, run마다 달라 쓸 수 없다(w2-fe-2 지적).
고른 방법과 버린 대안
두 실패 문구가 잰 개수·바이트와 상한, 상한이 있는 곳을 말한다.
SW가 precache할 파일의 판정을 generate-service-worker-assets.ts의 함수 하나로 뺀다. collectStaticAssets와 새 countPrecachedAssets가 같이 쓴다.
기능 모양 측정이 초기 JavaScript를 재는 같은 빌드 넷에서 그 수를 센다. --initial-baseline --write가 serviceWorkerPrecache(assets, firstFeatureAssets, perFeatureAssets, perContextAssets)를 기록에 쓰고, feature-shape-growth.test.ts가 unit 실행마다 빌드와 정확히 대조한다.
기록의 축 설명은 상한 안에 기능이 몇 개 들어가는지 계산하는 법을 적고, 숫자는 옮기지 않는다.
측정 결과(desktop): 템플릿 24개, 첫 기능 +14, 기능 하나당 +12, context 하나당 +0. 상한 256이면 기능 19개 안팎에서 닿는다. 리뷰가 어림한 25개보다 이르다.
SW를 켠 빌드를 따로 더 재기: unit 시험이 빌드 둘을 더 돈다. 등록 코드 파일 몇 개 차이는 축 설명에 적었다.
상한이나 precache 범위 바꾸기: SW 계약이라 소유자 결정이다.
후보 ID로 manifest releaseId·이전 run의 후보를 쓰기: 빌드 식별 계약이나 job 그래프가 바뀐다.
정한 기본값
R9-D7의 후보 ID는 릴리스 태그로 정했다. 권하는 안으로 정함(2026-11-13, r9-fe·w2-fe-2). 원 발견이 권한 「예: 태그 ref」를 따랐다.
위험과 영향
기능 템플릿이 lazy 파일 수를 바꾸면 unit 시험이 기록과 달라져 실패한다. 그때 측정 스크립트로 기록을 다시 쓴다(초기 JavaScript와 같은 방식).
상한 자체는 바꾸지 않았다. SW를 켠 제품은 기능 19개 안팎에서 빌드가 멈출 수 있다. 문구가 이제 그것을 말한다.
다운스트림: SW를 켠 제품은 기록의 serviceWorkerPrecache로 자기 기능 수가 상한에 얼마나 가까운지 계산한다(round9 CHANGELOG에 적는다).
FE-GATE-028은 R9-D7대로 태그 run에서만 통과하게 된다(검사·workflow 변경은 각 담당 PR).
검증
desktop, CI env, scripts/verify.sh(flock).
RED:
문구: service-worker-asset-bounds.test.ts의 문구 시험 둘이 고치기 전 문구에서 실패했다.
축: 판정 함수·기록 대조·기록 차이 문구 시험 셋이 고치기 전 코드에서 실패했다(함수가 없음).
측정: node scripts/scale/measure-feature-shape-growth.ts --initial-baseline --write로 기록을 썼다. 같은 실행에서 관련 시험 21 passed.
merge 단계(기준 main ee47480c, 트리 6e836c95 = head 트리):
FE-GATE-001007·009013·020 모두 rc=0. 013은 이제 system container 안에서 돌아 desktop에서도 rc=0이다.
FE-GATE-008은 첫 실행에서 rc=1이었다. Firefox에서 / 첫 화면 시험 둘이 실패했는데, 화면 기록상 홈 라우트 lazy 청크가 5초 넘게 「로딩 중」에 머물렀다. 이 PR의 변경(스크립트·시험·기록·문서)과 무관하고, 다른 트리에서도 나왔다. 다시 실행에서는 e2e 183 passed였다. 대신 브라우저 capability 시험 opfs-runtime.spec.ts:338(05-01, Firefox) 1건이 실패했다. 이것도 이 PR이 닿지 않는 기존 시험이다(같은 파일의 이른 return 결함 1112/03-02가 round9 그룹 C 몫). 두 실행의 다른 부분(e2e 나머지, browser capability 나머지 69, storybook, visual)은 통과했다. 세 번째 desktop 실행 결과는 이 PR 댓글로 더한다. 로그 /tmp/claude-gates/r9prb-merge/, /tmp/claude-gates/r9prb-008b/.
## 무엇을, 왜
round9 수정 묶음 둘을 한 PR로 낸다. runner가 하나라 PR 수를 줄인다.
1. **Service Worker precache 상한(1112/06-02)**
- SW를 켜면 빌드가 `dist/assets/`의 해시 파일을 모두 precache하고, 개수가 `SERVICE_WORKER_BOUNDS.assets`(256)를 넘으면 멈춘다.
- 실패 문구는 「Static asset count exceeds its bound.」뿐이라 몇 개가 넘었는지, 어느 값을 봐야 하는지 말하지 않았다.
- 규모 기록도 SW를 켜면 이 상한이 먼저 올 수 있다는 것도, 그것이 기능 몇 개인지도 적지 않았다.
2. **R9-D7 세부(1112/05-01)**
- FE-GATE-028이 대조할 「release 후보 ID」를 릴리스 태그로 정한 것을 결정 색인에 적는다.
- 처음 생각한 후보 release manifest의 `releaseId`는 FE-GATE-028(`release_gate`) 때 후보가 아직 없고, run마다 달라 쓸 수 없다(w2-fe-2 지적).
## 고른 방법과 버린 대안
- 두 실패 문구가 잰 개수·바이트와 상한, 상한이 있는 곳을 말한다.
- SW가 precache할 파일의 판정을 `generate-service-worker-assets.ts`의 함수 하나로 뺀다. `collectStaticAssets`와 새 `countPrecachedAssets`가 같이 쓴다.
- 기능 모양 측정이 초기 JavaScript를 재는 같은 빌드 넷에서 그 수를 센다. `--initial-baseline --write`가 `serviceWorkerPrecache`(`assets`, `firstFeatureAssets`, `perFeatureAssets`, `perContextAssets`)를 기록에 쓰고, `feature-shape-growth.test.ts`가 unit 실행마다 빌드와 정확히 대조한다.
- 기록의 축 설명은 상한 안에 기능이 몇 개 들어가는지 계산하는 법을 적고, 숫자는 옮기지 않는다.
- 측정 결과(desktop): 템플릿 24개, 첫 기능 +14, 기능 하나당 +12, context 하나당 +0. 상한 256이면 기능 19개 안팎에서 닿는다. 리뷰가 어림한 25개보다 이르다.
- R9-D7 세부: release 단계 env `RELEASE_TAG`(`refs/tags/v*` run의 `ref_name`)를 기록의 Release ID와 대조하고, 비면 실패한다. 검사는 round9 그룹 A5가, workflow(`release_gate` env와 `requiresEnvironment`)는 w2-fe-2가 맞춘다.
- 버린 안:
- SW를 켠 빌드를 따로 더 재기: unit 시험이 빌드 둘을 더 돈다. 등록 코드 파일 몇 개 차이는 축 설명에 적었다.
- 상한이나 precache 범위 바꾸기: SW 계약이라 소유자 결정이다.
- 후보 ID로 manifest `releaseId`·이전 run의 후보를 쓰기: 빌드 식별 계약이나 job 그래프가 바뀐다.
## 정한 기본값
- R9-D7의 후보 ID는 릴리스 태그로 정했다. 권하는 안으로 정함(2026-11-13, r9-fe·w2-fe-2). 원 발견이 권한 「예: 태그 ref」를 따랐다.
## 위험과 영향
- 기능 템플릿이 lazy 파일 수를 바꾸면 unit 시험이 기록과 달라져 실패한다. 그때 측정 스크립트로 기록을 다시 쓴다(초기 JavaScript와 같은 방식).
- 상한 자체는 바꾸지 않았다. SW를 켠 제품은 기능 19개 안팎에서 빌드가 멈출 수 있다. 문구가 이제 그것을 말한다.
- 다운스트림: SW를 켠 제품은 기록의 `serviceWorkerPrecache`로 자기 기능 수가 상한에 얼마나 가까운지 계산한다(round9 CHANGELOG에 적는다).
- FE-GATE-028은 R9-D7대로 태그 run에서만 통과하게 된다(검사·workflow 변경은 각 담당 PR).
## 검증
desktop, CI env, `scripts/verify.sh`(flock).
- RED:
- 문구: `service-worker-asset-bounds.test.ts`의 문구 시험 둘이 고치기 전 문구에서 실패했다.
- 축: 판정 함수·기록 대조·기록 차이 문구 시험 셋이 고치기 전 코드에서 실패했다(함수가 없음).
- 측정: `node scripts/scale/measure-feature-shape-growth.ts --initial-baseline --write`로 기록을 썼다. 같은 실행에서 관련 시험 21 passed.
- merge 단계(기준 main `ee47480c`, 트리 `6e836c95` = head 트리):
- FE-GATE-001~007·009~013·020 모두 rc=0. 013은 이제 system container 안에서 돌아 desktop에서도 rc=0이다.
- FE-GATE-008은 첫 실행에서 rc=1이었다. Firefox에서 `/` 첫 화면 시험 둘이 실패했는데, 화면 기록상 홈 라우트 lazy 청크가 5초 넘게 「로딩 중」에 머물렀다. 이 PR의 변경(스크립트·시험·기록·문서)과 무관하고, 다른 트리에서도 나왔다. 다시 실행에서는 e2e 183 passed였다. 대신 브라우저 capability 시험 `opfs-runtime.spec.ts:338`(05-01, Firefox) 1건이 실패했다. 이것도 이 PR이 닿지 않는 기존 시험이다(같은 파일의 이른 return 결함 1112/03-02가 round9 그룹 C 몫). 두 실행의 다른 부분(e2e 나머지, browser capability 나머지 69, storybook, visual)은 통과했다. 세 번째 desktop 실행 결과는 이 PR 댓글로 더한다. 로그 `/tmp/claude-gates/r9prb-merge/`, `/tmp/claude-gates/r9prb-008b/`.
- documentation(FE-GATE-017): rc=0.
## 리뷰어가 볼 곳
- `scripts/generate-service-worker-assets.ts`의 `precachedContentType`, `countPrecachedAssets`.
- `scripts/scale/measure-feature-shape-growth.ts`의 `measureFeatureShapeCosts`, `precacheRecordDrift`.
- `docs/work/reference/decisions.md`의 R9-D7 행.
## 관련
- 발견: `docs/reviews/2026-11-round9-06-performance-build.md` PF-02(1112/06-02), `2026-11-round9-05-accessibility.md` A11Y-01(1112/05-01)
- Refs: 1112/06-02, 1112/05-01
Service Worker를 켜면 빌드가 dist/assets/의 해시된 파일을 모두 precache
목록에 넣고, 개수가 SERVICE_WORKER_BOUNDS.assets(256)를 넘으면 멈춘다.
생성 기능은 기능마다 lazy 청크를 약 아홉 더하므로 기능 25개 안팎에서
닿는다. 실패 문구는 "Static asset count exceeds its bound."뿐이라 몇 개가
넘었는지, 어느 값을 봐야 하는지 말하지 않는다. 규모 기록의 summary는
초기 JS budget과 typecheck 메모리만 한계로 적는다.
고른 방법: 두 실패 문구가 잰 개수·바이트와 상한, 상한이 있는 곳을 말한다.
feature-shape-ceilings.json summary에 SW를 켰을 때 precache 상한이 먼저 올
수 있고 기능 수로는 재지 않았다고 적는다. 버린 대안: 측정 스크립트에 SW
축을 더하기(SW를 켠 빌드를 기능 수마다 다시 재야 한다. 상한을 바꿀지와
함께 정할 일이다).
위험·한계: 상한 자체와 precache 범위(lazy 청크를 받을 때 캐시)는 SW
계약이라 바꾸지 않았다. 기능 수로 잰 SW 한계는 여전히 없다.
검증: tests/unit/service-worker-asset-bounds.test.ts 둘이 고치기 전 문구에서
실패하고 고친 뒤 통과한다(desktop, PR 본문).
Refs: 1112/06-02
앞 커밋은 precache 상한 실패 문구만 고쳤다. 1112/06-02 완료 기준의 둘째
「기록에 SW 축과 그 기능 수가 있고, 측정이 그 값을 다시 쓴다」가 남았다(확인
리뷰). 기록은 SW를 켜면 상한이 먼저 올 수 있다고만 적고 몇 개에서인지는
없었다.
고른 방법: SW가 precache할 파일의 판정을 generate-service-worker-assets.ts의
함수 하나로 빼고(collectStaticAssets와 새 countPrecachedAssets가 같이 쓴다),
기능 모양 측정이 초기 JavaScript를 재는 같은 빌드 넷에서 그 수를 센다.
`--initial-baseline --write`가 serviceWorkerPrecache(assets, firstFeatureAssets,
perFeatureAssets, perContextAssets)를 기록에 쓰고, unit 시험이 매번 빌드와
정확히 대조한다. 기록의 축 설명은 상한에서 몇 개가 들어가는지 계산하는 법을
적고 숫자는 옮기지 않는다. 버린 대안: SW를 켠 빌드를 따로 더 재기(unit 시험이
빌드 둘을 더 돈다. 등록 코드 파일 몇 개 차이는 축 설명에 적었다).
측정 결과(desktop, 이 커밋의 기록): 템플릿 24개, 첫 기능 +14, 기능 하나당
+12, context 하나당 +0. 상한 256이면 기능 19개 안팎에서 닿는다. 상한과
precache 범위는 Service Worker 계약이라 바꾸지 않았다.
위험·한계: 기능 템플릿이 lazy 파일을 늘리면 unit 시험이 기록과 달라져
실패한다. 그때 측정 스크립트로 기록을 다시 쓴다(초기 JavaScript와 같은 방식).
검증: 새 시험(판정 함수, 기록 대조, 기록 차이 문구)이 고치기 전 코드에서
실패하고, 측정으로 쓴 기록에서 통과한다(desktop, PR 본문).
Refs: 1112/06-02
FE-GATE-028이 대조할 후보 ID를 정했다. 처음 생각한 후보 release manifest의
releaseId는 FE-GATE-028(release_gate) 때 후보가 아직 없고 run마다 달라 쓸 수
없다(w2-fe-2 지적). 원 발견의 권하는 방향대로 릴리스 태그를 release 단계 env
RELEASE_TAG로 받고, 비면 실패한다. 검사는 그룹 A5, workflow는 w2-fe-2가 맞춘다.
Refs: 1112/05-01
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
무엇을, 왜
round9 수정 묶음 둘을 한 PR로 낸다. runner가 하나라 PR 수를 줄인다.
dist/assets/의 해시 파일을 모두 precache하고, 개수가SERVICE_WORKER_BOUNDS.assets(256)를 넘으면 멈춘다.releaseId는 FE-GATE-028(release_gate) 때 후보가 아직 없고, run마다 달라 쓸 수 없다(w2-fe-2 지적).고른 방법과 버린 대안
generate-service-worker-assets.ts의 함수 하나로 뺀다.collectStaticAssets와 새countPrecachedAssets가 같이 쓴다.--initial-baseline --write가serviceWorkerPrecache(assets,firstFeatureAssets,perFeatureAssets,perContextAssets)를 기록에 쓰고,feature-shape-growth.test.ts가 unit 실행마다 빌드와 정확히 대조한다.RELEASE_TAG(refs/tags/v*run의ref_name)를 기록의 Release ID와 대조하고, 비면 실패한다. 검사는 round9 그룹 A5가, workflow(release_gateenv와requiresEnvironment)는 w2-fe-2가 맞춘다.releaseId·이전 run의 후보를 쓰기: 빌드 식별 계약이나 job 그래프가 바뀐다.정한 기본값
위험과 영향
serviceWorkerPrecache로 자기 기능 수가 상한에 얼마나 가까운지 계산한다(round9 CHANGELOG에 적는다).검증
desktop, CI env,
scripts/verify.sh(flock).service-worker-asset-bounds.test.ts의 문구 시험 둘이 고치기 전 문구에서 실패했다.node scripts/scale/measure-feature-shape-growth.ts --initial-baseline --write로 기록을 썼다. 같은 실행에서 관련 시험 21 passed.ee47480c, 트리6e836c95= head 트리):007·009013·020 모두 rc=0. 013은 이제 system container 안에서 돌아 desktop에서도 rc=0이다./첫 화면 시험 둘이 실패했는데, 화면 기록상 홈 라우트 lazy 청크가 5초 넘게 「로딩 중」에 머물렀다. 이 PR의 변경(스크립트·시험·기록·문서)과 무관하고, 다른 트리에서도 나왔다. 다시 실행에서는 e2e 183 passed였다. 대신 브라우저 capability 시험opfs-runtime.spec.ts:338(05-01, Firefox) 1건이 실패했다. 이것도 이 PR이 닿지 않는 기존 시험이다(같은 파일의 이른 return 결함 1112/03-02가 round9 그룹 C 몫). 두 실행의 다른 부분(e2e 나머지, browser capability 나머지 69, storybook, visual)은 통과했다. 세 번째 desktop 실행 결과는 이 PR 댓글로 더한다. 로그/tmp/claude-gates/r9prb-merge/,/tmp/claude-gates/r9prb-008b/.리뷰어가 볼 곳
scripts/generate-service-worker-assets.ts의precachedContentType,countPrecachedAssets.scripts/scale/measure-feature-shape-growth.ts의measureFeatureShapeCosts,precacheRecordDrift.docs/work/reference/decisions.md의 R9-D7 행.관련
docs/reviews/2026-11-round9-06-performance-build.mdPF-02(1112/06-02),2026-11-round9-05-accessibility.mdA11Y-01(1112/05-01)