erik/acdream
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1

perf(streaming): reserve destination reveal capacity

Browse source 
Join destination scheduling to the canonical reveal generation, protect its share across every typed frame-budget dimension, and prevent stale work from clearing a replacement reservation. Remove forced incomplete materialization and project retail's centered portal wait cue while the authored tunnel remains active.

Tests: Release build clean; 91 focused reservation/reveal tests; full solution 8,158 passed, 5 skipped.

Co-authored-by: Codex <noreply@openai.com>
This commit is contained in:
Erik 2026-07-24 19:39:23 +02:00
parent 98f1ac8934
commit 2ff8f844b0
33 changed files with 870 additions and 230 deletions
Download patch file Download diff file Expand all files Collapse all files

11
docs/plans/2026-04-11-roadmap.md
View file

@ -1613,11 +1613,14 @@ port in any phase — no separate listing here.
> generation unavailable at the hard reveal edge and freezes its world
> simulation/audio while full-window and shared-origin teardown advance through
> metered resident, entity, and owner-stage cursors with exact retry receipts.
> E4 now retains the exact accepted queue head and cursor-budgets render,
> E4 retains the exact accepted queue head and cursor-budgets render,
> physics, static, building-registry, EnvCell, collision, and reflood
> publication before one observer-atomic spatial swap. E5 destination
> reservation/reveal joining is next. F/G and J retain their explicit approval
> gates.
> publication before one observer-atomic spatial swap. E5 now joins the
> canonical reveal generation to an exact destination reservation, protects
> its share across all typed budget dimensions, removes forced incomplete
> materialization, and presents retail's centered five-second portal wait cue.
> E6 deterministic pressure and physical-local closeout is next. F/G and J
> retain their explicit approval gates.
**Spec:** `docs/superpowers/specs/2026-07-05-modern-pipeline-design.md` (the
umbrella design — read it first). **Goal:** smoothness first (no frame over

10
docs/plans/2026-05-12-milestones.md
View file

@ -93,13 +93,17 @@ The separately authorized modern-runtime performance program has completed
Slices A–D: corrected measurement, prepared-package bake/dedup, package-only
production streaming, and typed unified residency. Its physical capped,
uncapped, and dense connected gates pass without a visual-quality change.
Slice E0–E4 now define and enforce typed completion admission through explicit
Slice E0–E5 now define and enforce typed completion admission through explicit
stable priority queues, publish an immediate generation-scoped old-world
quiesce at login/portal boundaries, and advance full-window/recenter teardown
through exact metered retirement cursors. Render, physics, static, building,
and EnvCell publication now resume from retained exact cursors under the same
frame budget. E5 destination reservation and reveal-generation joining is
next. Slices F/G remain behind their explicit ECS approval gate, and Slice J
frame budget. The reveal coordinator now owns the exact destination
generation/cell/radius reservation across every budget dimension; portal
transit never force-reveals incomplete content and surfaces retail's centered
wait cue after five seconds. E6 deterministic pressure and physical-local
closeout is next. Slices F/G remain behind their explicit ECS approval gate,
and Slice J
remains behind its gameplay-owner approval gate.
Slice 1's 18-cell favorite-spell overflow bar is user-accepted. Slice 2's

12
docs/plans/2026-07-24-modern-runtime-architecture.md
View file

@ -2,7 +2,7 @@
**Date:** 2026-07-24
**Status:** Slices A–D complete. Slice E is active (E0–E4 complete).
**Status:** Slices A–D complete. Slice E is active (E0–E5 complete; E6 gates next).
**Scope:** Reconcile and sequence the existing Modern Pipeline (`MP`) and
Linux/headless (`LH`) tracks using the 2026-07-24 connected performance audit.
@ -729,9 +729,13 @@ checkpoint retained staged or retiring bytes. Evidence:
**Checkpoint 2026-07-24:** E0 fixed the retail/adaptation contract and current
owner inventory. E1 landed the validated work profile, deterministic meter and
completion charge model. E2 cut execution over to stable priority FIFOs. E3
added immediate generation quiescence and cursored retirement. E4 now advances
render/physics/static publication from retained exact receipts; E5 destination
reservation and reveal-generation joining is next.
added immediate generation quiescence and cursored retirement. E4 advances
render/physics/static publication from retained exact receipts. E5 replaced
mutable priority-radius state with the reveal coordinator's exact
generation-scoped destination reservation, protected its share across every
typed budget dimension, removed forced early materialization, and added
retail's centered five-second portal wait cue. E6 deterministic pressure and
physical-local closeout is next.
**Purpose:** Remove update-thread portal transactions.

31
docs/plans/2026-07-24-modern-runtime-slice-e-cost-budgeted-streaming.md
View file

@ -1,6 +1,6 @@
# Modern Runtime Slice E — Cost-budgeted streaming and retirement
**Status:** active — E0/E1/E2/E3/E4 complete; E5 destination reservation next
**Status:** active — E0/E1/E2/E3/E4/E5 complete; E6 gates and closeout next
**Program:** `docs/plans/2026-07-24-modern-runtime-architecture.md`
**Baseline:** Slice D closeout commit `66690805`
**Behavior contract:** no visual-quality or retail-behavior reduction
@ -356,6 +356,35 @@ performance and visual evidence remains an E6 gate.
five seconds.
- Remove the last count-only execution/bypass paths.
**Complete 2026-07-24.** `WorldRevealCoordinator` now owns one exact
generation/cell/radius reservation from login or portal begin through complete
or cancel. `StreamingController` no longer exposes a mutable priority
landblock/radius pair: accepted work records the reveal generation that
classified it, stale completion cannot consume a replacement generation's
reserved lane, and stale teardown cannot clear the replacement reservation.
The frame meter records destination and non-destination use independently and,
while a reveal is active, protects the configured destination share across
wall time, completion admissions, adopted CPU bytes, entity operations,
requested GPU bytes, and GL-retirement admissions. Destination work still
uses the same global ceilings and the existing first-indivisible-operation
progress diagnostic; it does not regain a budget bypass.
The former ten-second forced materialization path is deleted. An incomplete
destination remains in the authored portal scene until the canonical render,
composite, and collision predicate is true. After five seconds the retained
gameplay UI displays retail's centered
`"In Portal Space - Please Wait..."` notice and lifecycle telemetry records the
cue once; the tunnel continues its DAT animation and repeats the notice on the
retail camera-rotation cadence. Login completion now ends its reveal
reservation/quiescence at the same auto-entry edge that exposes the ready
world.
Validation: 91 focused reservation/reveal/teleport/UI tests passed; the
complete App suite passed 3,674 / 3 skipped; the complete Release solution
passed 8,158 / 5 skipped; Release solution build green with zero warnings.
The physical-local routes and final performance/resource assertions remain
E6, not E5.
### E6 — Gates and closeout
- Deterministic pressure, reentrancy, failure, cancellation, stale-generation,