diff --git a/config/recipes/frontend-capability-recipes.json b/config/recipes/frontend-capability-recipes.json index 352d35bb..51de02e7 100644 --- a/config/recipes/frontend-capability-recipes.json +++ b/config/recipes/frontend-capability-recipes.json @@ -67,7 +67,7 @@ "lifecycleMethods": ["close-or-dispose", "unsubscribe", "cancel-via-AbortSignal", "bounded-poll-lease", "revoke-push-association"], "owner": "project-owner-required", "securityPrivacy": ["Validate every event envelope and closed transport frame before application effects.", "Bind stream state to the current opaque scope generation and advance checkpoints only after committed effects or authoritative recovery.", "Use fixed same-origin endpoints and an exact WebSocket subprotocol; never place credentials, cursors, subscription material or scope bindings in URLs or telemetry.", "Treat Web Push as a notification hint, fence registration and revocation with one durable compare-and-swap control record, and allow only registry-owned notification and route intents.", "Keep every queue, parser, reconnect, poll, notification and storage operation bounded and abortable."], - "bundleBudgetGzipBytes": 40900, + "bundleBudgetGzipBytes": 42200, "fallback": "Bounded polling or explicitly stale UI.", "removal": ["Disable admission and close active readers, sockets, poll leases and worker handlers.", "Revoke and purge only the owned Web Push association and notification state.", "Remove composition, registries, adapters and any selected vendor dependency.", "Run realtime boundary, runtime-removal and production-bundle gates."], "serverStatePolicy": "query-cache-owned" @@ -109,7 +109,7 @@ "lifecycleMethods": ["close", "cancel-via-AbortSignal", "enforce-bounded-lifecycle-batch", "prune-expired-receipts", "reconcile", "enforcePolicies-with-composition-authority"], "owner": "project-owner-required", "securityPrivacy": ["Classify every persisted field and binary namespace.", "Encrypting in the same client is not a credential protection boundary.", "Keep database schema and record codec versions separate.", "Derive the physical IndexedDB name only from registry-issued authority, namespace and partition tokens; readable namespace, business and account IDs are forbidden.", "Persist and revalidate an immutable scope plus full BrowserStoragePolicy binding during upgrade, post-open and maintenance; missing or mismatched existing bindings fail closed.", "Use the actual IndexedDB wire split: StoredRecord contains only key, codecVersion, revision and payload; writtenAtEpochMs, synchronization, measuredBytes and eligibleAtEpochMs belong to the retention sidecar, while idempotency receipts and governance binding/budget use separate stores.", "Include every store registered in lifecycleMetadataStores in bounded full-partition purge while retaining immutable governance identity.", "Measure conservative logical bytes through the codec and atomically enforce dataset usedBytes plus receiptCount with record, lifecycle and migration writes.", "Enforce TTL before sweep visibility, delete UNTIL_SYNCED only after explicit confirmation, and require a composition-authorized short-lived proof for every deleting IndexedDB lifecycle batch.", "Bound idempotency receipt retention to 31 days and configured count to the implementation ceiling of 1000000; bound migration to old-writer-drained batches no larger than 500 rows or 30000ms.", "Bind OPFS readable and physical scopes in both directions and use only /ca-frontend-opfs-v1/authorities//// for physical dataset layout.", "For OPFS LOGOUT, UNTIL_SYNCED and ACCOUNT_DELETION maintenance, composition must provide both requestMaintenanceAuthority and consumeMaintenanceAuthority; issue a fresh proof bound to the exact frozen reason, scope and policy for at most five minutes, then atomically consume it to reject replay.", "Never expose an OPFS authority proof through the application request, persistence, diagnostics or telemetry.", "Never place user file names or identifiers in OPFS paths or diagnostics."], - "bundleBudgetGzipBytes": 36900, + "bundleBudgetGzipBytes": 38500, "fallback": "Read-only or online-only query path; OPFS may degrade to a size-capped IndexedDB Blob only when the product policy approves it.", "removal": ["Stop writes and background migration.", "Reconcile or export unsynced data, then purge only governance-bound owned partitions and OPFS namespaces through authorized bounded lifecycle operations.", "Close all database, channel, worker and file handles.", "Remove repository composition and dependency."], "serverStatePolicy": "reference-or-command-only" @@ -146,7 +146,7 @@ "lifecycleMethods": ["unregister", "rollback", "delete-owned-caches"], "owner": "project-owner-required", "securityPrivacy": ["Cache only explicit same-origin public GET representations.", "Never cache authenticated, cookie-dependent, private, no-store, opaque or personal responses.", "Bind candidate cache names to release identity and a canonical manifest digest that includes normalized expectedContentType, exact request identity, expected byte length and integrity digest.", "Reject a response whose normalized Content-Type differs from manifest expectedContentType even when body integrity matches.", "Derive cleanup retention only from the verified active pointer and composition retainedPreviousReleaseCount; cleanup callers cannot submit cache names, release registry IDs or any retain set.", "Read active-pointer and release-marker control JSON through a strict UTF-8 stream capped at exactly 2 MiB (2097152 bytes), cancel on overflow and fail closed before parsing oversized metadata.", "Keep exact query and Vary semantics; ignoreSearch and ignoreVary are forbidden.", "Fail closed on malformed update metadata or integrity mismatch."], - "bundleBudgetGzipBytes": 10000, + "bundleBudgetGzipBytes": 10100, "fallback": "Normal network application with hosting cache headers.", "removal": ["Deploy an unregister migration.", "Delete only parsed, owned cache namespaces after old controlled clients drain.", "Remove worker registration, cache metadata and manifest."], "serverStatePolicy": "network-cache-policy-only" @@ -195,7 +195,7 @@ "lifecycleMethods": ["release-file-ref", "release-or-dispose-preview-leases", "cancel-via-AbortSignal", "reconcile-or-explicitly-abort-upload", "close-checkpoint-store", "dispose-capability-and-image-runtime", "dispose-browser-file-runtime-on-logout-or-account-switch"], "owner": "project-owner-required", "securityPrivacy": ["Treat file name, extension, MIME and lastModified as untrusted metadata.", "Resolve only exact composition-issued file and image policy object identities; callers cannot raise byte, candidate, pixel, quality, format, lifetime or origin ceilings.", "Use opaque file references and verification receipts bound to an inspected immutable file snapshot and the exact registered profile; reject replay through another profile even when an inspection rule ID matches.", "Treat presigned URLs as bearer capabilities; bind exact method, resource or upload part, offset, length, media type, checksum, origin, path, query, headers and expiry in an in-memory identity vault.", "Use credentials omit, redirect error, no-referrer and no-store for direct data-plane fetch; never persist or observe URL, query, signed header, capability, file name or raw backend message, and never emit digest, raw ETag or receipt values to diagnostics or telemetry.", "A strict account-partitioned upload checkpoint may persist only the protocol-defined SHA-256 file fingerprint, per-part checksum and bounded opaque non-authorizing part receipt token required for server reconciliation; no bearer token or raw signed capability is allowed.", "Persist only strict non-authorizing upload checkpoints and reconcile them with server-authoritative status and re-hashed local parts before completion.", "Require a synchronous server-issued browser-managed download capability whose receipt exactly equals the caller's branded capability receipt and whose resource, media type, safe extension, maximum bytes, optional digest and expiry all match before handoff.", "Expose File, OPFS, Cache and transfer byte streams only as chunk-level closed Results; stop after the first failure, cancel native readers and never throw a raw native exception across the port.", "Accept Image CDN assets only through immutable allowlisted or signature-verified descriptors and registered preset identities; reject active formats, arbitrary transforms, pixel/decode-budget overflow and unsafe cache policy.", "Upload completion remains QUARANTINED until backend scan and promotion; client capability checks are not an authorization boundary.", "Active content preview requires isolation or download-only treatment."], - "bundleBudgetGzipBytes": 56100, + "bundleBudgetGzipBytes": 57800, "fallback": "Accessible native file input, same-origin authorized server upload/download and a single bounded server-selected image rendition; generated artifacts above the buffer budget move to server-side generation.", "removal": ["Stop new capability and upload-session issuance, then cancel active reads and transfers.", "Reconcile or explicitly abort active multipart sessions and let backend TTL cleanup remove ambiguous orphans.", "Remove non-secret checkpoints according to account and retention policy.", "Release file references, revoke preview object-URL leases and dispose file, capability and image runtimes.", "Remove transfer/image feature facades and composition, then prove browser-transfer sources are absent from the production module inventory."], "serverStatePolicy": "query-cache-metadata-only" diff --git a/docs/architecture/decisions/VD-28-realtime-events-web-push-and-bounded-polling.md b/docs/architecture/decisions/VD-28-realtime-events-web-push-and-bounded-polling.md index 117a1d83..402365a4 100644 --- a/docs/architecture/decisions/VD-28-realtime-events-web-push-and-bounded-polling.md +++ b/docs/architecture/decisions/VD-28-realtime-events-web-push-and-bounded-polling.md @@ -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초다. diff --git a/docs/architecture/optional-adapter-recipes.md b/docs/architecture/optional-adapter-recipes.md index eeeff3f0..4281ddba 100644 --- a/docs/architecture/optional-adapter-recipes.md +++ b/docs/architecture/optional-adapter-recipes.md @@ -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. 어느 경계에 두는가 diff --git a/docs/architecture/realtime-events-web-push-and-bounded-polling.md b/docs/architecture/realtime-events-web-push-and-bounded-polling.md index dd6ed831..fd1db869 100644 --- a/docs/architecture/realtime-events-web-push-and-bounded-polling.md +++ b/docs/architecture/realtime-events-web-push-and-bounded-polling.md @@ -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이어야 한다. diff --git a/docs/operations/adapter-remediation-ledger.md b/docs/operations/adapter-remediation-ledger.md index 1bc49b0f..36691b56 100644 --- a/docs/operations/adapter-remediation-ledger.md +++ b/docs/operations/adapter-remediation-ledger.md @@ -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 |