Skip to content

Commit 7718526

Browse files
docs(plans): reader-seat rebuild §7 — the six two-readings items ruled / chosen 2026-10-28
Co-authored-by: Cursor <[email protected]>
1 parent 4c6a2ee commit 7718526

1 file changed

Lines changed: 53 additions & 2 deletions

File tree

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

Lines changed: 53 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -423,8 +423,13 @@ a table gap or to a two-readings item (§7); no issue was filed.
423423
## 7. Blocked / two readings
424424

425425
Recorded as they arise, with both readings and the screen each produces.
426-
Nothing is ruled here. Each names the mismatch class it leaves in the
427-
differential (PR body table) so the swap can be gated on a ruling.
426+
All six are closed as of 2026-10-28: three ruled by the maintainer
427+
(today's behaviour — the rules as they stand — over the brief's reading:
428+
F-vlane, F-leaf, F-ahead-posture) and three left to the agent as
429+
implementation choices with no screen change in the differential (F-mount,
430+
F-vworld, F-transitive); each item ends with its ruling or choice. Each
431+
still names the mismatch class it leaves in the differential (PR body
432+
table) so the residue can be read against it.
428433

429434
- **F-vlane — verdict lanes as node sets.** Today a pass that probed
430435
stages into the hold's _verdict lane_ (`CONFIG_OVERRIDE` node whose
@@ -444,6 +449,23 @@ differential (PR body table) so the swap can be gated on a ruling.
444449
classes. Needs a ruling on how posture persists across passes without a
445450
node set (sticky `CONFIG_VERDICT` until a pass completes without
446451
probing? the swap marking the output `CONFIG_VERDICT`?).
452+
**Ruled 2026-10-28 (maintainer):** reading A — today's behaviour. The
453+
rule is the posture, not the membership: a pass that asked is the hold's
454+
verdict reader on every re-run until it completes a pass that asked
455+
nothing, so a `Loading` fallback that went up beside the held frame
456+
stays up beside it until the landing rather than travelling with the
457+
write's frame (#3540, #4337; `tests/loading-on-latest-fallback-4337.test.ts`,
458+
`tests/loading-fallback-in-flush-3540.test.ts`), and today's verdict-lane
459+
membership is only the mechanism that happens to carry it. The general
460+
paragraph for D-25 is **not yet written**: as drafted it listed the
461+
#3884 pending re-pass among re-runs whose plain read of the held node is
462+
the screen's, which D-25's standing clause ("a pass that re-runs it
463+
while its fetch is in flight reads plainly — following the change it is
464+
fetching for — even if an earlier pass of it called `isPending` or
465+
`latest`", #3884) and `tests/superseded-transition-verdicts-3884.test.ts`
466+
contradict — the hold's own work reads its own staging, whatever its
467+
seat. Until the paragraph is re-drafted around that clause, D-25 as it
468+
stands is where the rule lives.
447469
- **F-leaf — a leaf's children.** INV-seat-1 keeps a leaf at world S;
448470
the brief inherits `{world, lane, ahead}` from the running creator.
449471
Today a render effect that read a born node (`L4`: `joinPass`) or the
@@ -457,6 +479,16 @@ differential (PR body table) so the swap can be gated on a ruling.
457479
`boundary-output-frame-reader`, `loading-fallback-in-flush-3540`,
458480
`fuzz-findings-l2`. Classes: `B1 inherited world (old creator JOINED,
459481
new < H)`, `B2 born held (old true, new false; world 0 …)`.
482+
**Ruled 2026-10-28 (maintainer):** reading A — today's behaviour. Now
483+
D-27 "A joined pass's children are the hold's" (promoted from A29
484+
ruling A, with a dated note under A29): a pass — a render effect
485+
included — that read a node with no screen to fall back to joins the
486+
hold, and a node it creates during that pass is born held; its value
487+
commits with the frame and a mainline reader of it waits. Consequence
488+
for §3.3: INV-seat-1 ("a leaf never raises its world") must admit the
489+
born-node read — a leaf that read one is in the hold's world and its
490+
children inherit it; a leaf that read only committed values still
491+
raises nothing.
460492
- **F-mount — who is the creator.** The brief: the running creator pass
461493
is `context` while it recomputes, never the owner. Today's display-ahead
462494
mount (`laneRoot`/`mount`) is module state — any pass running when the
@@ -469,6 +501,10 @@ new < H)`, `B2 born held (old true, new false; world 0 …)`.
469501
creator = `creatorPass(context)`. The shadow uses B, searching the seat
470502
stack for it. Classes: `B1 ahead (old true, new false; creator running
471503
false)`.
504+
**Choice 2026-10-28 (agent, no screen change in the differential):**
505+
reading A — creator = the running pass (seat stack top), for both
506+
ahead-ness and world inheritance. The owner-based `creatorPass(context)`
507+
path and its stale-JOINED-flag hazard retire with the swap.
472508
- **F-ahead-posture — ahead by posture without a lane.** The brief: ahead
473509
= creator display-ahead (verdict posture or in a lane). Today `mount`
474510
comes only from `passLane`/`laneRoot`, so a mount made by a verdict
@@ -478,6 +514,13 @@ false)`.
478514
creator running true, creator memo:value|children|effect)` — ×29 in
479515
web, ×1,276 in the generator at 2k/seed; downstream B2 differences are
480516
rare (`world 0, ahead true … rows L1,L1`).
517+
**Ruled 2026-10-28 (maintainer):** today; no rule change. D-27 as
518+
clarified 2026-10-28 already rules it: a mount gated by a display-ahead
519+
read is a mainline mount, its plain reads are the screen's, and it is
520+
not "ahead" by its creator's verdict posture — only lane work's children
521+
live in the lane. The seat's ahead bit comes from a lane, never from a
522+
verdict posture alone; the brief's "verdict posture or in a lane" is
523+
the brief's reading, not the rule.
481524
- **F-vworld — do verdict reads move the world?** The table gives the
482525
verdict rows marks (`AH`, `W`, `ST`) and no raise, except `Vp2`/`V1'`;
483526
today a verdict read of a staged or held node also sets
@@ -488,6 +531,11 @@ creator running true, creator memo:value|children|effect)` — ×29 in
488531
`world after the read (old 1|2, new 0; Vl|Vp|V posture)` with equal
489532
slots, plus `D5 (E, old 2)` — today joins the hold before throwing a
490533
held node's error.
534+
**Choice 2026-10-28 (agent, no screen change in the differential):**
535+
verdict reads leave marks (`AH`/`W`/`ST`) and do not raise the reader's
536+
world. Today's one exception — the join before re-throwing a held
537+
node's error (`D5`) — is kept until the `D5` residue (an errored node in
538+
flight, 101 instances at 50k, §4.2) is traced.
491539
- **F-transitive — how far does the world inherit?** The brief inherits
492540
the world from the running creator, which inherited its own:
493541
transitive. Today's born-held arm checks one level
@@ -499,3 +547,6 @@ creator running true, creator memo:value|children|effect)` — ×29 in
499547
B (brief; A29 read transitively): born held. Classes: `B2 born held
500548
(old false, new true; world 2, ahead false, mount false … rows
501549
∅|L0|D0|L1)`.
550+
**Choice 2026-10-28 (agent, no screen change in the differential):**
551+
whichever the seat stack makes simpler, with the shadow continuing to
552+
prove equal slots (301 instances at 2k, no slot difference found).

0 commit comments

Comments
 (0)