Skip to content

Commit 20a1d30

Browse files
ryansolidClaude via Cursorcursoragent
committed
chore(size): Rolldown ledger for store key-precision at the held-fold gate (#3688)
Re-measured under the Rolldown harness against `next` @ b10c824 after the rebase (the esbuild-era ledger edits were dropped in the rebase): + createStore 16,707 -> 16,708 B (+1 B; +118 B minified), hydrating + every store 30,584 -> 30,622 B (+38 B), base page 44,929 -> 44,919 B (-10 B), live page 49,066 -> 49,057 B (-9 B); every cap unchanged, no Size-Exception. Regenerates docs/RULES-INDEX.md (A29 gains the #3688 test citation). Co-authored-by: Claude via Cursor <[email protected]> Co-authored-by: Cursor <[email protected]>
1 parent 19440e0 commit 20a1d30

2 files changed

Lines changed: 26 additions & 1 deletion

File tree

‎packages/signals/docs/RULES-INDEX.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -73,7 +73,7 @@ Status legend: **live** stated and standing · **ruled** carries an explicit rul
7373
| A26 | ruled | `docs/SPEC-ASYNC-SEMANTICS.md:67` | core.ts×1 scheduler.ts×1 store.ts×1 | action-await-contract.test.ts×2 posture-store-parity.test.ts×2 visibility-oracle-store.states.ts×2 visibility-oracle.states.ts×1 visibility-oracle.test.ts×1 | [ruled 2026-07-17] An ambient transaction window is one flush; parking is flush-driven — (**ruled 2026-07-17**, #2913; **enforcement hardened 2026-08-31**, #3141 — parking is flush-driven, and a trans… |
7474
| A27 | ruled | `docs/SPEC-ASYNC-SEMANTICS.md:245` | — | loading-value.test.ts×2 visibility-oracle.states.ts×18 visibility-oracle.test.ts×1 | [ruled 2026-08-10] The commit-#0 loading window is loading-class and verdict-quiet — (**ruled 2026-08-10**) **The commit-#0 loading window is loading-class and verdict-quiet.** A node born committed v… |
7575
| A28 | ruled, mechanism landed | `docs/SPEC-ASYNC-SEMANTICS.md:51` | constants.ts×2 core.ts×20 optimistic.ts×2 scheduler.ts×3 types.ts×1 verdict.ts×6 optimistic.ts×3 store.ts×1 | createOptimistic.test.ts×5 held-derivation-not-a-proposal-3612.test.ts×1 latest-held-till-flush.test.ts×1 optimistic-store-layer-scope.test.ts×1 posture-store-parity.test.ts×5 question-scoped-pending.test.ts×3 snapshot-derived-store-rows.test.ts×1 createOptimisticStore.test.ts×10 optimistic-draft-visibility-3665.test.ts×5 optimistic-list-mutation-matrix.harness.ts×1 optimistic-list-mutation-matrix.test.ts×2 shallow.test.ts×1 woken-transaction-adopts-staged-bump.test.ts×1 treeshake.test.ts×2 visibility-oracle-store.states.ts×8 visibility-oracle.states.ts×8 | [ruled, mechanism landed 2026-09-15] A write becomes visible at flush — to every channel — (**ruled 2026-09-08**; supersedes the #2922 mid-tick pull) **A write becomes visible at flush — to every chan… |
76-
| A29 | amended | `docs/SPEC-ASYNC-SEMANTICS.md:75` | boundaries.ts×1 action.ts×1 async.ts×1 constants.ts×1 core.ts×8 effect.ts×1 optimistic.ts×1 scheduler.ts×2 signals.ts×1 store.ts×5 | body-end-supersession-visibility.test.ts×1 born-held.test.ts×3 boundary-not-born-held-3540.test.ts×4 direct-commit-readers-posture.test.ts×1 held-conditional-memo.test.ts×1 held-frame-dependencies.test.ts×2 held-truth-lane-only.test.ts×3 latest-held-till-flush.test.ts×2 posture-store-parity.test.ts×6 optimistic-untracked-reads-f3-f5.test.ts×1 treeshake.test.ts×3 visibility-oracle-store.states.ts×5 visibility-oracle-store.test.ts×1 visibility-oracle.states.ts×7 visibility-oracle.test.ts×1 write-proposals-3494.test.ts×1 | [ruled, amended in place 2026-09-13 (#3408)] A tracked read served a live transaction's staged value enters that transaction — A tracked computation served a node's staged `_pendingValue` — a value a … |
76+
| A29 | amended | `docs/SPEC-ASYNC-SEMANTICS.md:75` | boundaries.ts×1 action.ts×1 async.ts×1 constants.ts×1 core.ts×8 effect.ts×1 optimistic.ts×1 scheduler.ts×2 signals.ts×1 store.ts×5 | body-end-supersession-visibility.test.ts×1 born-held.test.ts×3 boundary-not-born-held-3540.test.ts×4 direct-commit-readers-posture.test.ts×1 held-conditional-memo.test.ts×1 held-frame-dependencies.test.ts×2 held-truth-lane-only.test.ts×3 latest-held-till-flush.test.ts×2 posture-store-parity.test.ts×6 optimistic-untracked-reads-f3-f5.test.ts×1 store-unchanged-read-independent-write-3688.test.ts×1 treeshake.test.ts×3 visibility-oracle-store.states.ts×5 visibility-oracle-store.test.ts×1 visibility-oracle.states.ts×7 visibility-oracle.test.ts×1 write-proposals-3494.test.ts×1 | [ruled, amended in place 2026-09-13 (#3408)] A tracked read served a live transaction's staged value enters that transaction — A tracked computation served a node's staged `_pendingValue` — a value a … |
7777
| A30 | ruled | `docs/SPEC-ASYNC-SEMANTICS.md:207` | async.ts×3 attribution.ts×1 constants.ts×1 core.ts×3 effect.ts×1 scheduler.ts×5 | async-landing-deps-3461.test.ts×3 held-conditional-effect.test.ts×1 held-conditional-memo.test.ts×1 held-frame-dependencies.test.ts×2 ispending-in-boundary-on-3528.test.ts×1 lane-frame-deferred-run-3662.test.ts×1 lane-frame-held-lane-3662.test.ts×1 posture-born-held-and-observation.test.ts×1 treeshake.test.ts×2 write-proposals-3494.test.ts×2 zombie-rerun-after-commit-3546.test.ts×2 | [ruled 2026-09-13 (#3410)] A memo's dependencies are the committed frame's until the frame is replaced — A pass that _staged_ its value has not replaced the committed frame, so the committed value sti… |
7878
| A31 | live | `docs/SPEC-ASYNC-SEMANTICS.md:83` | core.ts×2 | ispending-combined-atomic-3442.test.ts×1 | [live 2026-09-14 (#3442)] A memo computes under its own lane posture, never its puller's — A memo's value is one shared slot every reader sees, so its pass runs under the lane posture the memo itself … |
7979
| A32 | ruled | `docs/SPEC-ASYNC-SEMANTICS.md:91` | core.ts×1 store.ts×1 | visibility-oracle-store.states.ts×8 visibility-oracle-store.test.ts×1 visibility-oracle.states.ts×9 visibility-oracle.test.ts×1 | [ruled 2026-09-14] Children-forbidden readers see the frame, not the graph — `createTrackedEffect` and `onSettled` callbacks are effect-phase code that runs after the frame is decided. They read the f… |

‎scripts/size/scenarios.js‎

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -806,6 +806,16 @@ module.exports = [
806806
// on committed deletes. A 400-key keyed record churning 100 keys per
807807
// commit goes from 4.7 ms to 0.22 ms per step. All in the store module;
808808
// core floor 0 B.
809+
// Store key-precision at the held-fold gate (#3688, 2026-09-28): cap
810+
// unchanged at 16.71 KB, measured at 16,708 B against `next` @
811+
// b10c8249d's 16,707 (+1 B; +118 B minified). `readSource` takes the key
812+
// and `pendingBackingVisible` consults `wk` (the trap's write/delete
813+
// record for the batch), so a get/has/descriptor read of a key the fold
814+
// never touched is served committed with no transaction entry — a memo
815+
// reading `store.stable` beside an unrelated signal no longer holds that
816+
// signal's write with someone else's action. Container-wide reads
817+
// (ownKeys, $TRACK, deep) still hold. On the store read path, paid by
818+
// every store user; core floor 0 B.
809819
limit: "16.71 KB",
810820
alias
811821
},
@@ -1835,6 +1845,10 @@ module.exports = [
18351845
// measured at 30,584 B against `next` @ fe1eb684f's 30,630 (-46 B; +38 B
18361846
// minified). Same `lazy()` change as the no-stores hydrating note; brotli
18371847
// layout over the larger bundle turns the +38 B minified into a saving here.
1848+
// Store key-precision at the held-fold gate (#3688, 2026-09-28): cap
1849+
// unchanged at 30.63 KB, measured at 30,622 B against `next` @
1850+
// b10c8249d's 30,584 (+38 B; +119 B minified). Same change as the
1851+
// `+ createStore` note (+1 B there); brotli layout over the larger bundle.
18381852
limit: "30.63 KB",
18391853
alias
18401854
},
@@ -2826,6 +2840,12 @@ module.exports = [
28262840
// so its body is labeled for STRICT_READ_UNTRACKED; the hydrating scenario
28272841
// carries the same change at +50 B. Accepted by the maintainer. The cap
28282842
// is frozen again at 44.93 KB.
2843+
// Store key-precision at the held-fold gate (#3688, 2026-09-28): cap
2844+
// unchanged at 44.93 KB, measured at 44,919 B against `next` @
2845+
// b10c8249d's 44,929 (-10 B; +119 B minified). Same store change as the
2846+
// `+ createStore` note, reaching this page through the frames client's
2847+
// container-trace materializer; brotli layout turns the +119 B minified
2848+
// into a saving here. Not ratcheted.
28292849
limit: floorCaps["page: base server components (hydrating + dynamic + frames + sf reference)"],
28302850
alias: pageAlias
28312851
},
@@ -2865,6 +2885,11 @@ module.exports = [
28652885
// the same `lazy()` change as the base page's note (+39 B there); brotli
28662886
// layout amplifies it on this page. Accepted by the maintainer. The cap
28672887
// is frozen again at 49.07 KB.
2888+
// Store key-precision at the held-fold gate (#3688, 2026-09-28): cap
2889+
// unchanged at 49.07 KB, measured at 49,057 B against `next` @
2890+
// b10c8249d's 49,066 (-9 B; +119 B minified). The same store change as
2891+
// the base page's note (-10 B there); brotli layout absorbs it on this
2892+
// page too. Not ratcheted.
28682893
limit: floorCaps["page: live server components (base + live/GET + action + isPending/latest)"],
28692894
alias: pageAlias
28702895
}

0 commit comments

Comments
 (0)