feat(scale): precache 상한을 기능 모양 기록에 재고 R9-D7 후보 ID를 태그로 적는다 #44

Merged
donghyeon.kang merged 6 commits from donghyeon.kang/fix/r9-precache-bound-diagnostics AGit into main 2026-11-13 08:28:36 +00:00
Owner

무엇을, 왜

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-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/.
  • 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
## 무엇을, 왜 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
donghyeon.kang added 5 commits 2026-11-13 03:29:23 +00:00
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
docs(decisions): R9-D7의 release 후보 ID를 릴리스 태그로 적는다
frontend-quality-gates / merge / static checks (pull_request) Successful in 2m11s
frontend-quality-gates / merge / tests (pull_request) Failing after 20m19s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 6m7s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / main / self-tests and removal drills (pull_request) Skipped
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Skipped
frontend-quality-gates / external-vulnerability-provider (pull_request) Skipped
frontend-quality-gates / external-provenance-provider (pull_request) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Skipped
frontend-quality-gates / deploy-promoted-release (pull_request) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Skipped
1814b61075
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
donghyeon.kang added 1 commit 2026-11-13 06:56:24 +00:00
Merge remote-tracking branch 'origin/main' into fix/r9-precache-bound-diagnostics
frontend-quality-gates / merge / static checks (pull_request) Successful in 1m44s
frontend-quality-gates / merge / tests (pull_request) Successful in 17m15s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 6m19s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / main / self-tests and removal drills (pull_request) Skipped
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Skipped
frontend-quality-gates / external-vulnerability-provider (pull_request) Skipped
frontend-quality-gates / external-provenance-provider (pull_request) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Skipped
frontend-quality-gates / deploy-promoted-release (pull_request) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Skipped
865fc2fd35
donghyeon.kang merged commit 2ea2c66d51 into main 2026-11-13 08:28:36 +00:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: donghyeon.kang/clean-architecture-frontend-template#44