You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit e5b6cf2
Browse filesBrowse the repository at this point in the historyBrowse files
committed
S1 floor split: seat.ts keeps the plain rows; seated and verdict rows move to the lane engine (seatRows)
Ruling 2 (clause (c) not relaxed): the engine-less bundle carries the
plain rows only (U, F, L, D; A as D). The rows of a seated pass (lane
work, a hold's verdict reader) and of a verdict reader live in lanes.ts
(seatRows -> seatedRows), installed through seatRowsHook (was
laneReadHook); slot() dispatches on passLane / CONFIG_OVERRIDE /
CONFIG_VERDICT. The engine's rows decide their own arms in table order
(D6/V1 stale-served, V2/V3, D7', F1 D-29, D8, V4, the seam watch W) and
come to plainRows for the rest. postureOf is the floor's ladder;
seatPosture the shadow's.
Behaviour-neutral: signals/solid/web zero shadow classes; generator 2k x
3 seeds zero classes, ASYNC_GEN_DIFF the same two closed next bugs as
M3b. Core floor 20,721 / 7,842 (+813 / +427 vs base; seat.js 1,690 ->
1,116): still above base — stopped for the budget call (design doc
sec. 4.7 has the per-module numbers).
Co-authored-by: Claude via Cursor <[email protected]>
Co-authored-by: Cursor <[email protected]>
The reader seat's table is split by engine: `seat.ts` keeps the plain rows (a pass in no seat reading a node that is no lane's), and the rows of a seated pass and of a verdict reader move to the lane engine (`seatRows`), installed through the hook that carried the lane rows. A build without the lane engine retains neither.
Copy file name to clipboardExpand all lines: packages/signals/docs/RULES-INDEX.md
+10-10Lines changed: 10 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -29,7 +29,7 @@ Status legend: **live** stated and standing · **ruled** carries an explicit rul
29
29
| INV | 11 | 4 | 7 | 4 |
30
30
| RUL | 13 | 3 | 6 | 6 |
31
31
| R (CS) | 59 | 15 | 16 | 32 |
32
-
| R (OL) | 37 |4| 1 |32|
32
+
| R (OL) | 37 |3| 1 |33|
33
33
| R (OS) | 46 | 0 | 0 | 46 |
34
34
| R (PJ) | 37 | 2 | 5 | 32 |
35
35
| R (RS) | 38 | 0 | 2 | 36 |
@@ -45,7 +45,7 @@ Status legend: **live** stated and standing · **ruled** carries an explicit rul
45
45
46
46
| id | status | defined | cited in src | cited in tests | statement (at definition) |
47
47
|---|---|---|---|---|---|
48
-
| A1 | ruled |`docs/SPEC-ASYNC-SEMANTICS.md:321`| lanes.ts×2 seat.ts×1 | onCleanup.test.ts×2 transitionEntanglement.test.ts×4 |[ruled 2026-07-06] Effect error interception is compute-phase only — `EffectBundle.error` intercepts compute-phase errors only; effect-phase throws escalate to the nearest error boundary (halt if none… |
48
+
| A1 | ruled |`docs/SPEC-ASYNC-SEMANTICS.md:321`| lanes.ts×3 seat.ts×1 | onCleanup.test.ts×2 transitionEntanglement.test.ts×4 |[ruled 2026-07-06] Effect error interception is compute-phase only — `EffectBundle.error` intercepts compute-phase errors only; effect-phase throws escalate to the nearest error boundary (halt if none… |
49
49
| A2 | ruled |`docs/SPEC-ASYNC-SEMANTICS.md:329`| — | onCleanup.test.ts×2 |[ruled] Unhandled compute-phase errors in user effects are logged and skipped — Compute-phase errors in _user_ effects without a handler are logged and the run is skipped; the system keeps running. |
50
50
| A3 | ruled |`docs/SPEC-ASYNC-SEMANTICS.md:337`| async.ts×1 core.ts×2 | derived-write-then-derivation-3733.test.ts×5 equals-comparator-errors.test.ts×1 |[ruled] Comparator throws are compute-phase errors — Errors thrown by a user `equals` comparator behave exactly like compute-phase errors (boundary-containable; loud halt without a boundary). |
51
51
| A4 | ruled |`docs/SPEC-ASYNC-SEMANTICS.md:345`| — | derived-write-then-derivation-3733.test.ts×1 equals-comparator-errors.test.ts×1 |[ruled] A custom `equals` never sees `undefined` prev on first commit — A custom `equals` is never invoked with `undefined` previous value on a node's first commit. |
@@ -54,7 +54,7 @@ Status legend: **live** stated and standing · **ruled** carries an explicit rul
54
54
| A7 | amended |`docs/SPEC-ASYNC-SEMANTICS.md:167`| truth.ts×1 | fuzz-findings-l2.test.ts×1 latest-uninitialized-over-latest-4362.test.ts×2 spec-async-semantics.test.ts×2 visibility-oracle-store.states.ts×1 visibility-oracle.states.ts×1 visibility-oracle.test.ts×1 |[ruled, amended in place] Resolved async never reads `[false, undefined]` — After an async memo resolves, `[isPending(x), latest(x)]` is `[false, resolvedValue]` — never `[false, undefined]`. **Amende… |
55
55
| A8 | amended |`docs/SPEC-ASYNC-SEMANTICS.md:175`| — | create-deferred-3710.test.ts×1 createMemo.test.ts×1 visibility-oracle-store.states.ts×1 visibility-oracle.states.ts×2 |[ruled, amended in place 2026-07-07]`isPending(() => latest(x))` follows `x`'s own async only — verdicts are per-channel — (**re-ruled 2026-07-07c** — was "tracks the transition the same as `isPendin… |
56
56
| A9 | amended |`docs/SPEC-ASYNC-SEMANTICS.md:183`| projection.ts×1 target.ts×1 | spec-async-semantics.test.ts×3 visibility-oracle-store.states.ts×4 visibility-oracle-store.test.ts×1 |[ruled, amended in place 2026-07-07] Store leaves behind a firewall report the firewall's new-question refetch — `isPending` on a store leaf behind a firewall reports the firewall's refetch like any a… |
57
-
| A10 | ruled |`docs/SPEC-ASYNC-SEMANTICS.md:191`| async.ts×1 core.ts×1 lanes.ts×1 scheduler.ts×1 seat.ts×1 verdict.ts×3 | boundary-not-born-held-3540.test.ts×1 createMemo.test.ts×1 error-staged-recovery.test.ts×1 fuzz-findings-l2.test.ts×1 ispending-memo-unstamped-hold-3457.test.ts×2 latest-isPending-consistency.test.ts×3 latest-uninitialized-over-latest-4362.test.ts×1 verdict-contract.test.ts×2 verdict-memo-flight-no-reask.test.ts×1 |[ruled]`[isPending(x), x()]` is atomic within one scope — `[isPending(x), x()]` read in one scope is atomic: a reader that observed the fresh value must not see `pending === true` for it. |
57
+
| A10 | ruled |`docs/SPEC-ASYNC-SEMANTICS.md:191`| async.ts×1 core.ts×1 lanes.ts×2 scheduler.ts×1 verdict.ts×3 | boundary-not-born-held-3540.test.ts×1 createMemo.test.ts×1 error-staged-recovery.test.ts×1 fuzz-findings-l2.test.ts×1 ispending-memo-unstamped-hold-3457.test.ts×2 latest-isPending-consistency.test.ts×3 latest-uninitialized-over-latest-4362.test.ts×1 verdict-contract.test.ts×2 verdict-memo-flight-no-reask.test.ts×1 |[ruled]`[isPending(x), x()]` is atomic within one scope — `[isPending(x), x()]` read in one scope is atomic: a reader that observed the fresh value must not see `pending === true` for it. |
58
58
| A11 | ruled |`docs/SPEC-ASYNC-SEMANTICS.md:103`| — | latest-isPending-consistency.test.ts×1 loading-fallback-in-flush-3540.test.ts×2 visibility-oracle-store.states.ts×2 visibility-oracle.states.ts×1 |[ruled] Sync derivations of held sources are visible through `latest()`/`isPending()` — Sync derivations of transition-held sources are visible through `latest()`/`isPending()` (held sync recompute is… |
59
59
| A12 | amended |`docs/SPEC-ASYNC-SEMANTICS.md:199`| — | createOptimistic.test.ts×2 spec-async-semantics.test.ts×1 |[ruled, amended in place] Resting optimistic nodes report pending like a plain memo — A resting optimistic node reports pending via exactly the causes a plain async memo does (A19) — a reverting optim… |
60
60
| A13 | ruled |`docs/SPEC-ASYNC-SEMANTICS.md:207`| — | spec-async-semantics.test.ts×7 |[ruled 2026-07-06 (promoted from B1)] Resting optimistic ≡ plain async memo at every checkpoint — (was B1) A resting optimistic node (no active override) is observationally identical to a plain async … |
@@ -76,17 +76,17 @@ Status legend: **live** stated and standing · **ruled** carries an explicit rul
76
76
| A29 | amended | `docs/SPEC-ASYNC-SEMANTICS.md:119` | boundaries.ts×1 action.ts×1 constants.ts×1 core.ts×8 effect.ts×1 lanes.ts×1 scheduler.ts×4 seat.ts×1 signals.ts×1 store.ts×1 | adoption-unchanged-key-read-3706.test.ts×9 body-end-supersession-visibility.test.ts×1 born-held.test.ts×3 boundary-not-born-held-3540.test.ts×4 createProjection.draft-lifetime-3585.test.ts×1 direct-commit-readers-posture.test.ts×1 fuzz-findings-l2.test.ts×6 held-branch-verdict-reader-4010.test.ts×1 held-conditional-memo.test.ts×1 held-frame-dependencies.test.ts×2 held-truth-lane-only.test.ts×3 l2-contract.test.ts×1 latest-held-till-flush.test.ts×2 loading-fallback-in-flush-3540.test.ts×6 loading-on-frame-following-3540.test.ts×1 mount-over-foreign-hold-3761.test.ts×1 optimistic-mount-nested-memo-3835.test.ts×1 optimistic-read-lane-not-transaction-3698.test.ts×3 posture-born-held-and-observation.test.ts×1 posture-store-parity.test.ts×6 derived-presence-async-3726.test.ts×3 optimistic-untracked-reads-f3-f5.test.ts×1 store-unchanged-read-independent-write-3688.test.ts×1 tick-scoped-pass-transaction.test.ts×2 treeshake.test.ts×3 verdict-mount-first-pass-3851.test.ts×2 verdict-mount-loading-flush-loop.test.ts×2 visibility-oracle-store.states.ts×5 visibility-oracle-store.test.ts×1 visibility-oracle.states.ts×9 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 … |
77
77
| A30 | ruled |`docs/SPEC-ASYNC-SEMANTICS.md:259`| async.ts×3 attribution.ts×1 constants.ts×1 core.ts×1 effect.ts×1 lanes.ts×1 scheduler.ts×5 projection.ts×1 | async-landing-deps-3461.test.ts×3 fuzz-findings-l2.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 projection-peek-loop-4342.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… |
78
78
| A31 | live |`docs/SPEC-ASYNC-SEMANTICS.md:133`| boundaries.ts×1 lanes.ts×1 seat.ts×1 verdict.ts×1 | fuzz-findings-l2.test.ts×6 ispending-combined-atomic-3442.test.ts×1 unowned-memo-ispending-reader-4366.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 … |
79
-
| A32 | ruled |`docs/SPEC-ASYNC-SEMANTICS.md:141`| lanes.ts×1 seat.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… |
79
+
| A32 | ruled |`docs/SPEC-ASYNC-SEMANTICS.md:141`| lanes.ts×2 seat.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… |
80
80
| A33 | ruled |`docs/SPEC-ASYNC-SEMANTICS.md:275`| boundaries.ts×1 scheduler.ts×2 | async-chain-supersession.test.ts×2 boundary-not-born-held-3540.test.ts×2 create-deferred-3710.test.ts×1 fuzz-findings-l2.test.ts×4 ispending-in-boundary-on-3528.test.ts×2 loading-reset-collects-forwarded-3459.test.ts×3 |[ruled 2026-09-12 (#3375)] A fallback-caught flight holds no transaction; a Loading reset moves the hold onto the boundary — A `<Loading>` boundary showing its fallback is the display of everything un… |
81
81
| A34 | ruled |`docs/SPEC-ASYNC-SEMANTICS.md:285`| constants.ts×1 core.ts×6 lanes.ts×2 scheduler.ts×2 store.ts×6 | a34-writes-then-derivations.test.ts×2 continuation-sibling-reader-4146.test.ts×1 createMemo.test.ts×1 derived-write-then-derivation-3733.test.ts×1 finalize-reentry.test.ts×2 fuzz-findings-l2.test.ts×5 held-derivation-not-a-proposal-3612.test.ts×6 optimistic-guess-over-held-slot.test.ts×2 optimistic-list-mutation-matrix.test.ts×1 unchanged-presence-no-hold-3743.test.ts×3 woken-transaction-adopts-staged-bump.test.ts×1 transition-corpse-revival.test.ts×1 treeshake.test.ts×2 visibility-oracle.states.ts×2 write-proposals-3494.test.ts×5 |[ruled 2026-09-16 (#3494)] A write is a proposal: one on a held node entangles its tick; one that nets to the committed value is none — A write proposes a value for a node. **Held, both are suggestion… |
82
82
## V — fixed violations
83
83
84
84
| id | status | defined | cited in src | cited in tests | statement (at definition) |
| V4 | fixed |`docs/SPEC-ASYNC-SEMANTICS.md:503`| seat.ts×2| spec-async-semantics.test.ts×5 | - **V4 (violated the old A20's three-form algebra) — FIXED, then the rule it |
| V4 | fixed |`docs/SPEC-ASYNC-SEMANTICS.md:503`|lanes.ts×3 seat.ts×1| spec-async-semantics.test.ts×5 | - **V4 (violated the old A20's three-form algebra) — FIXED, then the rule it |
90
90
| V5 | live |`docs/SPEC-ASYNC-SEMANTICS.md:515`| scheduler.ts×1 | spec-async-semantics.test.ts×3 | - **V5 (A17 corollary — found and fixed with the revert-target elimination, |
91
91
## B — tier B
92
92
@@ -208,9 +208,9 @@ Status legend: **live** stated and standing · **ruled** carries an explicit rul
208
208
| OL-R2 | superseded |`docs/rules-mining/optimistic-lanes.md:15`| — | — |~~An optimistic write is synchronously visible to direct reads before any flush — inside the action body, outside it, and outside any reactive context.~~**Superseded 2026-09-10 by A28(5)** (SPEC-ASYN… |
209
209
| OL-R3 | live |`docs/rules-mining/optimistic-lanes.md:19`| — | — | The setter's updater receives the current _visible_ (optimistic-if-overridden) value, never the committed value; a plain setter on the underlying source during a transition composes on the transition'… |
210
210
| OL-R4 | live |`docs/rules-mining/optimistic-lanes.md:23`| seat.ts×1 | — | Multiple optimistic writes before settle compose sequentially (each updater sees the prior override; last write wins). |
211
-
| OL-R5 | live |`docs/rules-mining/optimistic-lanes.md:27`| lanes.ts×2 scheduler.ts×2 seat.ts×1 types.ts×1 | — | An optimistic write **outside any action** reverts at the next flush; subscribers observe the optimistic value and then the reverted value within that single flush (effect log `[1, 2, 1]` after one `f… |
211
+
| OL-R5 | live |`docs/rules-mining/optimistic-lanes.md:27`| lanes.ts×3 scheduler.ts×2 types.ts×1 | — | An optimistic write **outside any action** reverts at the next flush; subscribers observe the optimistic value and then the reverted value within that single flush (effect log `[1, 2, 1]` after one `f… |
212
212
| OL-R6 | live |`docs/rules-mining/optimistic-lanes.md:32`| — | — | An optimistic write inside an `action` holds for the entire action window and reverts when the action's transition completes; each intermediate write during a multi-yield action is observable in order… |
213
-
| OL-R7 | live |`docs/rules-mining/optimistic-lanes.md:36`|seat.ts×1| — | Computed-form `createOptimistic(fn)` with no overrides is a transparent passthrough of its (possibly async) source: promise resolutions, re-fired promises, and async-iterable yields all propagate; ove… |
213
+
| OL-R7 | live |`docs/rules-mining/optimistic-lanes.md:36`|—| — | Computed-form `createOptimistic(fn)` with no overrides is a transparent passthrough of its (possibly async) source: promise resolutions, re-fired promises, and async-iterable yields all propagate; ove… |
214
214
| OL-R8 | live |`docs/rules-mining/optimistic-lanes.md:40`| — | — | Reset-on-settle targets the source's **newly computed value at settle time**, not the pre-write value: a wrong optimistic guess is auto-corrected to the real result; a correct guess settles silently (… |
215
215
| OL-R9 | live |`docs/rules-mining/optimistic-lanes.md:44`| — | — | Regular signals written in the same action are held (transition semantics) while optimistic writes display immediately; downstream memos and chained optimistic computeds see optimistic values and reve… |
216
216
| OL-R10 | live |`docs/rules-mining/optimistic-lanes.md:48`| — | — |`refresh()` of an optimistic accessor inside an action clears the override when the refetch settles; calling `refresh()` while the upstream source is still pending must not throw. |
0 commit comments