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
6 Commits
Author SHA1 Message Date
DongHyeonka 865fc2fd35 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
2026-11-13 15:04:13 +09:00
DongHyeonka 1814b61075 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
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
2026-11-13 08:45:12 +09:00
DongHyeonka 2db31e6456 Merge remote-tracking branch 'origin/main' into fix/r9-precache-bound-diagnostics 2026-11-13 08:45:12 +09:00
DongHyeonka c98f56a916 Merge branch 'fix/r9-abort-telemetry' into fix/r9-precache-bound-diagnostics 2026-11-13 04:44:09 +09:00
DongHyeonka 9012da0e9f feat(scale): 기능 모양 기록에 Service Worker precache 축을 측정으로 더한다
앞 커밋은 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
2026-11-13 04:08:34 +09:00
DongHyeonka 57090f307e fix(service-worker): precache 상한 실패가 잰 값과 상한을 말한다
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
2026-11-13 04:08:27 +09:00