Skip to content

Commit 490a387

Browse files
ryansolidClaude via Cursorcursoragent
committed
seat(S1 M2): the slot table is read's decision; old deciders become the oracle
`read` (fast path + `readSlow`), `verdictValue` (`windowSlot`) and the lane dispatch (`laneSlot` via `laneReadHook`) serve the table's slot and fire the mechanisms its raise names (`applyMarks`; `laneApply`/`verdictApply` for the engines' bits). The old deciders — `frameRead`, `readerSeesCommitted`, `serve`, `throwShown`, `laneRead`, `enterLane`, `verdictRead`, `watchVerdict`, `provisionalVerdict`, `pendingVerdict`, `observeFlight`, the old `verdictValue` — leave the build; a pure port (`seat-oracle.ts`, __TEST__ only) is the shadow's oracle, compared slot and mark by mark on every read, fast path included. Packed result: slot in the low five bits, raise above — a row with no raise is a literal; row ids (`ROW && setRow`) fold out of prod. Verdict rows and lane-seat state gate on `verdictApplyHook`/`laneReadHook` and fold out of engine-less builds. Snapshot serve inline in its guard. Differential: zero classes on signals/solid/web and the generator 2k x seeds 7/3289/91501 (known #4426-#4428); ASYNC_GEN_DIFF vs next: zero screen differences. Size vs next @ 5e68925: floors +570 B min / +331 B br; + isPending/latest +1,977 / +987; frames/server unchanged — clause (c) is M5's, after the pass-side swap and the deletions. Co-authored-by: Claude via Cursor <[email protected]> Co-authored-by: Cursor <[email protected]>
1 parent 8eaa313 commit 490a387

9 files changed

Lines changed: 2043 additions & 1774 deletions

File tree

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
---
2+
"@solidjs/signals": patch
3+
---
4+
5+
Reader seat (S1 M2): the slot table is now `read`'s decision. `read`, `verdictValue` and the lane dispatch are served from the table's slot and fire the mechanisms its raise names (`applyMarks`); the old deciders (`frameRead`, `readerSeesCommitted`, `serve`, `throwShown`, `laneRead`, `enterLane`, `verdictRead`, `watchVerdict`, `provisionalVerdict`, `pendingVerdict`, `observeFlight`) are deleted from the build and kept only as the `__TEST__` oracle the shadow compares against. The packed result carries the slot in its low bits so a row with no raise is a literal; the verdict and lane-seat rows fold out of a build without those engines. No behaviour change: the differential (suites + generator 2k × 3 seeds) is clean and every generator screen matches `next`.

‎documentation/plans/reader-seat-rebuild.md‎

Lines changed: 75 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -346,6 +346,51 @@ in brotli and minified bytes (`+ isPending/latest` 11,026 B brotli /
346346
`observe` differ from the base only in statement braces and import order
347347
left where `__TEST__` blocks were removed (the minifier erases both).
348348

349+
### 4.4 Results (S1 M2 read-side swap, 2026-10-29)
350+
351+
`slot()` is `read`'s decision: `read` (fast path and `readSlow`),
352+
`verdictValue` (`windowSlot`) and the lane dispatch (`laneSlot` through
353+
`laneReadHook`) serve the table's slot and fire the mechanisms its raise
354+
names (`applyMarks` in core.ts; `laneApply` / `verdictApply` for the
355+
engines' bits). The old deciders are the shadow's oracle now
356+
(`seat-oracle.ts`, `__TEST__` only — a pure port of `read`'s old slow
357+
block, `frameRead`, `readerSeesCommitted`, `serve`, `throwShown`,
358+
`laneRead`, `enterLane`, `verdictRead`, `watchVerdict`,
359+
`provisionalVerdict`, `pendingVerdict`, `observeFlight`), compared slot
360+
by slot and mark by mark on every read, the fast path included
361+
(`shadowFast`). Same runs as §4.3:
362+
363+
| run | reads | passes | classes | known |
364+
| --------------------------------------- | --------: | --------: | ------: | ------------------------------ |
365+
| signals suite (393 files, green) | 965,381 | 242,299 | 0 | — |
366+
| solid suite (54 files, green) | 2,388 | 1,546 | 0 | — |
367+
| web suite (188 files, green) | 43,723 | 24,257 | 0 | — |
368+
| generator 2,000 × seed 7, every pair | 856,775 | 856,072 | 0 | #4428 ×11 |
369+
| generator 2,000 × seed 3289, every pair | 1,066,114 | 965,593 | 0 | #4428 ×11, #4426 ×10, #4427 ×9 |
370+
| generator 2,000 × seed 91501 | 8,800,109 | 5,351,433 | 0 | #4428 ×9 |
371+
372+
`ASYNC_GEN_DIFF` against the `next` recording: zero screen differences on
373+
all three seeds; the equivalence-survey findings are line-identical to
374+
M1's.
375+
376+
Bytes (`scripts/size`, prod build, against `next` @ 5e68925cc): the
377+
engine-less floors are **+570 B minified / +331 B brotli** (core floor
378+
20,478 / 7,746 B), `+ isPending/latest` +1,977 / +987 B, the live pages
379+
+2.2–2.5 KB minified; frames and server scenarios unchanged. The packed
380+
result carries the slot in its low five bits so a row with no raise is a
381+
literal and the row ids (`ROW && setRow(…)`) fold out; the verdict rows
382+
and the lane-seat state are gated on `verdictApplyHook` / `laneReadHook`
383+
and fold out of a build without those engines (checked in the minified
384+
core-floor bundle: no verdict or seat arm survives). What remains on the
385+
floors is the table's explicit case analysis against the old inline
386+
deciders (U/F/L/D rows, the held rows, the error block) plus the
387+
slot-then-serve split; the lane/verdict scenarios also carry the new
388+
`laneSlot` beside the mechanisms M3 deletes (`markVerdictReader`,
389+
`provisionalVerdict`'s seating, `route`, the verdict-lane node set,
390+
`holdWork`). The gate's clause (c) — no growth on any floor — is M5's;
391+
the pass-side swap (M3) and the deletions are the lever, and the floors
392+
are re-measured there.
393+
349394
## 5. Swap plan
350395

351396
Three to five PRs, serial, each in its own worktree (brief §4 item 4):
@@ -575,6 +620,36 @@ difference by definition; the shadow compares the owner's flag only when
575620
the owner is the running pass, and the born-held decision at the close
576621
still compares for every pass (zero classes besides #4428 above).
577622

623+
### 6.2 S1 M2 read-side swap (2026-10-29) — rows made exact against the deciders
624+
625+
Making the table the implementation surfaced the arms where a prediction
626+
had been looser than the mechanism; each was settled by the differential
627+
(table vs oracle), not by inspection:
628+
629+
- **L7 · D-26/D-28** — a flight never shown (`never && l._shown`, NR to
630+
the leaf) is not a stale reader of the lane: no LST. Today's `laneRead`
631+
throws before `frameRead`'s mark.
632+
- **V3 · D-22** — the seam watch (W) on a verdict reader's staging read is
633+
only for an effect, lane work, or a `latest()`-only hold; a memo's V3
634+
has Fl alone (today `stagedRead`'s `isEffect` test).
635+
- **V4 · D-23** — the ST/AH/JF0/OBS marks fire only in a flush
636+
(`globalQueue._running`); outside one the screen is served plainly.
637+
- **D6 (leaf in seat) · D-37** — lane work that is a leaf reading a hold's
638+
node that is not its own and not born into: the screen with ST and
639+
SERVED (today's `read` L2 block before the leaf arm).
640+
- **D2 · D-1** — the join of a staged, not pending held node raises H and
641+
Fl both (`stagedRead` after `joinPass`); the staged-error arm raises H
642+
only (the error is thrown).
643+
- **Vl5 (lane arm of `latest`)** — `flying` is `pending && !quietPending`:
644+
a quiet pending (a hold waiting on the node's fetch, D-25) is served the
645+
lane value, not NR.
646+
- **Lane node excluded from the hold rows** — a lane's node
647+
(CONFIG_OVERRIDE) beneath a hold is the lane's; `held` is HELD without
648+
OVERRIDE, as `read`'s L2 block had it.
649+
- **Vl4 (#4429)** — the known entry is generalized: `when` no longer tests
650+
JOINED, so the world of a `latest()` under a joined pass is compared by
651+
the oracle's reading.
652+
578653
## 7. Blocked / two readings
579654

580655
Recorded as they arise, with both readings and the screen each produces.

0 commit comments

Comments
 (0)