chore(recipes): 레시피 예산을 측정값 + 3%로 정하고 규칙을 적는다 (0929/05-04)
문제: 레시피 번들 예산을 수정마다 100 B씩 올려 왔다. 한도가 늘 직전 측정값이라 예산 초과가 "왜 커졌나"를 묻는 신호가 되지 못했다. 이번 수정 묶음 뒤 offline-indexeddb(37,327 > 36,900)와 realtime(40,902 > 40,900)이 넘었고, file-transfer는 여유가 47 B였다. remediation ledger는 예전 값 56,100을 적지 않아 check:remediation-ledger가 실패하고 있었다. 방법: 리뷰 결정(README 14절 0929/05-04)대로, 측정값 + 3%를 100 B 단위로 올린 값으로 한 번 정한다. 그 뒤 3% 안의 증가는 예산을 고치지 않고, 넘는 증가는 커밋 본문에 이유를 쓰고 같은 규칙으로 다시 정한다. - file-transfer 56,053 → 57,800, offline-indexeddb 37,327 → 38,500, realtime 40,902 → 42,200, service-worker-pwa 9,716 → 10,100 - 규칙·이유·측정 표는 optional-adapter-recipes.md의 예산 절에 둔다. JSON은 주석을 받지 않아서다. - realtime 문서 두 곳은 숫자 대신 정본 위치를 가리킨다. VD-10은 결정 기록이라 그대로 둔다. 버린 대안: 수정마다 100 B 인상(지금 방식), 레시피 예산에서 kernel 제외 (kernel 증가를 놓친다). 위험: 3% 여유 안에서는 회귀가 조용히 쌓인다. 예산 값을 표와 JSON 두 곳에 적으므로, 다음 인상 때 표도 같이 고쳐야 한다(ledger는 check:remediation-ledger가 file-transfer 값을 대조한다). 검증: check:optional-recipes:source PASS(4 budgets), verify:documentation PASS_SCOPED, check:remediation-ledger의 예산 실패 사라짐(TR-02~04 기존 3건은 그대로, 게이트 밖).
This commit is contained in:
@@ -463,7 +463,7 @@ push hint와 worker deadline을 제한한다. 제품 config는 더 작게만 설
|
||||
|
||||
2026-07-28 reference-runtime amendment로, RT-01~RT-04 source 전체를
|
||||
tree-shaking 없이 합성하는 optional-recipe gzip 예산을 40,000 bytes로
|
||||
고정한다(2026-09-27 성숙도 리뷰 반영으로 40,900 bytes로 올림. 근거는 `config/recipes/frontend-capability-recipes.json` 변경 커밋). 이는 production bundle 허용량이 아니며 미선택 production asset의
|
||||
고정한다(지금 값과 정하는 규칙은 `docs/architecture/optional-adapter-recipes.md`의 "Reference runtime bundle budget" 절). 이는 production bundle 허용량이 아니며 미선택 production asset의
|
||||
realtime module 허용량은 계속 0이다. SSE replay-open과 WebSocket
|
||||
`SUBSCRIBED`가 exact recovery checkpoint를 증명하고 common barrier가 확인될
|
||||
때까지 event admission을 막는 readiness gate는 attempt당 최대 30초다.
|
||||
|
||||
@@ -64,12 +64,29 @@ validation, quota, integrity, cleanup 같은 fail-closed guard가 예산에서
|
||||
runtime을 compose하지 않는다. 별도의 production manifest/module-inventory
|
||||
검사는 선택되지 않은 runtime source가 실제 `dist`에 없는지 계속 검증한다.
|
||||
|
||||
2026-07-28 기준 동일 설정의 `offline-indexeddb` 실측은 32,930 gzip bytes였다.
|
||||
기존 8,000 bytes 값은 bundle 측정 없이 선언된 값으로 실제 reference runtime과
|
||||
일치하지 않아 약 9% headroom을 둔 36,000 bytes로 교정했다.
|
||||
`service-worker-pwa` 10,000 bytes와 `file-transfer` 52,000 bytes는 현재 실측을
|
||||
수용하므로 유지한다. 이후 source가 예산을 넘으면 gate를 우회하거나 예산을
|
||||
자동 인상하지 않고, output artifact와 변경 이유를 검토해야 한다.
|
||||
예산 값은 `config/recipes/frontend-capability-recipes.json`이 정본이다. 정하는
|
||||
규칙은 아래와 같다(2026-11-03, 리뷰 결정 0929/05-04).
|
||||
|
||||
- 예산 = 측정값 + 3%를 100 B 단위로 올린 값.
|
||||
- 측정값의 3% 안에서 늘면 예산을 고치지 않는다.
|
||||
- 3%를 넘게 늘면 예산을 올리는 커밋 본문에 늘어난 이유를 적는다. 그때 다시 이
|
||||
규칙으로 정한다.
|
||||
- 이유: 전에는 수정마다 100 B씩 올렸다. 그러면 한도가 늘 직전 측정값이라,
|
||||
예산 초과가 "왜 커졌나"를 묻는 신호가 되지 못하고 수정마다 인상 커밋만 남았다.
|
||||
- 버린 대안: 레시피 예산에서 kernel(`src/adapters/platform/` 등 공유 source)을 빼는
|
||||
것. kernel이 커지는 것을 놓친다.
|
||||
|
||||
2026-11-03 측정(`check:optional-recipes:source`, 기준 `d166aa3`)으로 정한 값:
|
||||
|
||||
| recipe | 측정 gzip B | 예산 gzip B |
|
||||
|---|---:|---:|
|
||||
| `file-transfer` | 56,053 | 57,800 |
|
||||
| `offline-indexeddb` | 37,327 | 38,500 |
|
||||
| `realtime` | 40,902 | 42,200 |
|
||||
| `service-worker-pwa` | 9,716 | 10,100 |
|
||||
|
||||
source가 예산을 넘으면 gate를 우회하지 않는다. output artifact와 늘어난 이유를
|
||||
검토한 뒤 위 규칙으로 올린다.
|
||||
|
||||
## 2. 어느 경계에 두는가
|
||||
|
||||
|
||||
@@ -1806,7 +1806,7 @@ task는 run을 fail-closed로 끝내되 underlying task가 settle할 때까지 l
|
||||
`DRAINING`으로 유지하여 다음 physical connection을 허용하지 않는다.
|
||||
|
||||
미선택 reference source 전체를 tree-shaking 없이 합성하는 optional-recipe
|
||||
측정의 gzip 상한은 40,900 bytes다(2026-09-27 성숙도 리뷰 04-x·06-x 반영 뒤 측정값 40,886을 100바이트 단위로 올림). 이 값은 production bundle 허용량이 아니라
|
||||
측정의 gzip 상한은 `config/recipes/frontend-capability-recipes.json`의 `realtime` 예산이다. 정하는 규칙은 `optional-adapter-recipes.md`의 "Reference runtime bundle budget" 절에 있다. 이 값은 production bundle 허용량이 아니라
|
||||
RT-01~RT-04 reference runtime의 회귀 예산이며, production asset에는 계속
|
||||
미선택 realtime module이 0이어야 한다.
|
||||
|
||||
|
||||
@@ -454,6 +454,11 @@ compensators and physical-work registries — so the budget is reset to **54,600
|
||||
gzip bytes against a measured **53,810**, rather than the failure being carried
|
||||
forward as if it were green.
|
||||
|
||||
The budget has since moved with later fixes. On 2026-11-03 it was set to
|
||||
**57,800** gzip bytes against a measured **56,053** (measured + 3%, rounded up
|
||||
to 100 B). The rule and the current values are in
|
||||
`docs/architecture/optional-adapter-recipes.md`.
|
||||
|
||||
### Regenerated evidence (this commit)
|
||||
|
||||
| Command | Exit | Result |
|
||||
|
||||
Reference in New Issue
Block a user