docs(rendering): close retained-scene G5

Record the exact visual, route, lifecycle, production CPU/GPU/memory, and allocation evidence for retiring the normal InteriorEntityPartition. Reconcile the roadmap, milestones, shared session instructions, and Slice I handoff so the measured transition/query scratch remainder has one owner.

Co-authored-by: OpenAI Codex <codex@openai.com>
This commit is contained in:
Erik 2026-07-25 13:55:38 +02:00
parent 14fbe92b08
commit 2effba5127
8 changed files with 173 additions and 95 deletions

View file

@ -1642,16 +1642,19 @@ port in any phase — no separate listing here.
> reverted. The reapplied retained source subsequently passed the connected
> portal/revisit matrix on 2026-07-25, including stable server objects and
> paperdoll, distant interaction, and correct `/ls` plus spell-recall
> materialization. G4 is complete. G5 cleanup is active: normal production no
> materialization. G4 is complete. G5 is also complete: normal production no
> longer builds `InteriorEntityPartition`; mesh and attached-particle ownership
> come from the retained frame product. The exact production-only
> performance/lifecycle matrix remains.
> come from the retained frame product. The exact lifecycle/reconnect matrix,
> capped/uncapped/dense correctness routes, and ordinary production profile
> pass. The final stable ordinary-production minute sustains 519.7 FPS with
> CPU/GPU p50 1.869/1.096 ms; the measured 22.34 KiB/frame remainder is the
> active Slice-I transition/query-scratch owner.
> The historical exact cutover
> rollback remains
> `git revert ef1d263337997bb030eadb7b8e71d73dc659907a`. Slice H is complete:
> retained UI/frame work, exact bounded light selection, and
> pooled/borrowed/direct network I/O pass 8,292 Release tests / 5 skips and the
> connected lifecycle/reconnect gate. Slice I is active from
> connected lifecycle/reconnect gate. Slice I is active at I1 from
> [its detailed plan](2026-07-25-modern-runtime-slice-i.md).
**Spec:** `docs/superpowers/specs/2026-07-05-modern-pipeline-design.md` (the

View file

@ -110,14 +110,16 @@ CPU p99 is 34.7%/30.4% below Slice A and maximum frame allocation is
the F/G ECS and Slice J gameplay-owner gates, on 2026-07-24. Slice F and
G0G4 are complete: G4's automated gate has zero mismatches and the user
accepted the corrected retained-path portal/revisit matrix on 2026-07-25.
G5 cleanup is active; normal production now routes meshes and attached
particles from the retained frame product without building the old
`InteriorEntityPartition`. Focused route tests, 3,825 App tests / 3 skips,
and 8,334 solution tests / 5 skips pass. The exact production-only
performance/lifecycle matrix remains before G5 closeout. Slice H is
complete: retained UI/frame work, exact bounded light selection, and
pooled/borrowed/direct network I/O pass 8,292 Release tests / 5 skips and the
seven-checkpoint connected lifecycle/reconnect gate. Slice I is active under
G5 is complete. Normal production routes meshes and attached particles from
the retained frame product without building the old
`InteriorEntityPartition`; the user visual matrix, capped/uncapped/dense
correctness routes, exact seven-checkpoint lifecycle/reconnect gate, and
ordinary production profile pass. The final stable production minute sustains
519.7 FPS with CPU/GPU p50 1.869/1.096 ms and 22.34 KiB/frame allocation.
The complete Release gate is 3,826 App tests / 3 skips and 8,335 solution
tests / 5 skips. Slice H is complete: retained UI/frame work, exact bounded
light selection, and pooled/borrowed/direct network I/O pass. Slice I is active
at I1 under
[`2026-07-25-modern-runtime-slice-i.md`](2026-07-25-modern-runtime-slice-i.md).
The historical exact G4 visual rollback remains
`git revert ef1d263337997bb030eadb7b8e71d73dc659907a`.

View file

@ -2,9 +2,8 @@
**Date:** 2026-07-24
**Status:** Slices AF and H are complete; G0G4 and I0 are complete. Slices
FL were explicitly approved 2026-07-24; G5 production-matrix closeout is
active.
**Status:** Slices AH and I0 are complete. Slices FL were explicitly
approved 2026-07-24; Slice I1 is active.
**Scope:** Reconcile and sequence the existing Modern Pipeline (`MP`) and
Linux/headless (`LH`) tracks using the 2026-07-24 connected performance audit.
@ -1184,21 +1183,23 @@ an improvement" carries the same evidence burden as a regression claim.
## 14. Current execution point
Slices AE are complete. Slice E's exact physical-local Release binary
produced uncapped CPU p50/p95/p99 1.216/4.216/5.450 ms and GPU
0.725/2.486/2.666 ms across the nine-stop route. Dense Arwic, with 15,530
entities and 111 animated entities, produced CPU 2.652/4.153/5.736 ms and GPU
1.576/2.504/2.662 ms. Every stable checkpoint converged without pending
publication, retirement, upload, warmup, or resource backlog.
Slices AH are complete. The retained render scene is now the sole production
entity source: G5 removed the old whole-world `InteriorEntityPartition` from
normal mesh and attached-particle routing while preserving it only for
standalone tests and explicit diagnostic/oracle probes. The user accepted the
retained-path visual matrix. Capped/uncapped/dense routes and the exact
seven-checkpoint lifecycle/reconnect gate pass with graceful shutdown.
The dense median already satisfies the provisional 3.33 ms / 300 FPS target.
CPU tail cost remains above GPU cost and the normal draw path still scans and
partitions resident entities, so F/G can improve CPU utilization, scaling, and
tail behavior, but a dramatic average-FPS gain is not promised. The
implementation-ready F/G contract and ownership map are
[`2026-07-24-modern-runtime-slices-f-g-render-scene.md`](2026-07-24-modern-runtime-slices-f-g-render-scene.md).
The §0.1 and §0.3 gates were explicitly lifted 2026-07-24. Slice F is the
current execution point; `e7d9d6fa` is the pre-runtime rollback anchor.
The final ordinary-production minute on exact `14fbe92b` sustained 519.7 FPS:
CPU p50/p95/p99 1.869/2.306/2.484 ms and GPU
1.096/1.108/1.136 ms. Working/private memory was 652.1/928.3 MiB.
Frame-thread allocation is now 22.34 KiB median; allocation-tick evidence and
the four-mover baseline assign that remainder primarily to reset-complete
`Transition` collision/query scratch. I0 has pinned the retail oracle and
fixtures, so I1 is the current execution point. Evidence:
[`../research/2026-07-25-slice-g5-production-profile.md`](../research/2026-07-25-slice-g5-production-profile.md)
and
[`2026-07-25-modern-runtime-slice-i.md`](2026-07-25-modern-runtime-slice-i.md).
The intended order is therefore:
@ -1208,10 +1209,10 @@ honest metrics + committed baselines (A — exit criteria block C)
-> typed residence (D — unify/retune, not rebuild)
-> cost-budgeted streaming (E)
-> [APPROVED 2026-07-24: ECS deferral lifted under §0.1]
-> incremental render scene (F — CURRENT; referee first)
-> incremental render scene (F)
-> delta GPU submission (G)
-> residual frame cleanup (H-a, H-b, H-c)
-> flat collision assets (I — floats; depends only on B)
-> flat collision assets (I — CURRENT at I1)
-> presentation-independent runtime (J — §0.3 authorization)
-> Linux/headless/multi-session (K)
-> evidence-gated GPU jobs (L)

View file

@ -2,8 +2,7 @@
**Date:** 2026-07-24
**Status:** approved 2026-07-24; Slice F and G4 complete, G5 retained-route
cleanup active
**Status:** approved 2026-07-24; Slices F and G complete
**Program:** `docs/plans/2026-07-24-modern-runtime-architecture.md`
@ -29,7 +28,7 @@ retail-faithful gameplay
| G2 — packed dispatcher input | complete | Exact `f9829d5f` passed capped and uncapped nine-stop routes plus dense Arwic. Candidate order, packed input, classified output, and selection each completed 16,879 + 17,282 + 770 comparisons with zero mismatch; journal/rejection counts were zero and shutdown graceful. Evidence: `docs/research/2026-07-25-slice-g2-packed-dispatcher-gate.md`. |
| G3 — retained classification/storage | complete | Exact `6a026c5a` passed capped and uncapped nine-stop routes plus dense Arwic with 17,069 + 16,827 + 757 exact comparisons in every channel, zero mismatch, warm cross-frame reuse, and graceful shutdown. Evidence: `docs/research/2026-07-25-slice-g3-retained-classification-gate.md`. |
| G4 — production cutover | complete | Exact cutover `ef1d263337997bb030eadb7b8e71d73dc659907a` makes the retained frame product the production entity source at the existing five retail PView stages. Exact `03b10183` passed capped/uncapped nine-stop and uncapped dense-Arwic automation with 46,599 total product comparisons and zero mismatch. After the independent portal/private-view/revisit corrections, the user accepted the connected retained-path visual matrix on 2026-07-25: server objects and paperdoll survive travel, distant use works, `/ls` and spell recalls both materialize through the retail purple haze, and neither character pop nor recall tail remains. Evidence: `docs/research/2026-07-25-slice-g4-production-cutover-automated-gate.md` and `docs/research/2026-07-25-portal-regression-closeout.md`. |
| G5 | cleanup active | Normal production no longer builds `InteriorEntityPartition`: mesh and attached-particle ownership now consume the exact retained route ranges. The legacy partition remains only for standalone tests and explicitly enabled diagnostic/oracle probes. Focused route tests, 3,825 App tests / 3 skips, and 8,334 complete-solution tests / 5 skips pass; the exact production-only performance/lifecycle matrix remains. |
| G5 — old-path retirement and production closeout | complete | Exact `10ccce3f` removes `InteriorEntityPartition` from normal production: meshes and attached particles consume retained route ranges, while the legacy partition remains only for standalone tests and explicit diagnostic/oracle probes. Exact `14fbe92b` passes the seven-checkpoint lifecycle/reconnect gate after hardening the optional monitor-refresh boundary. The user visual gate, capped/uncapped/dense correctness routes, ordinary 519.7-FPS production profile, 3,826 App tests / 3 skips, and 8,335 complete-solution tests / 5 skips pass. The measured 22.34 KiB/frame remainder is assigned to Slice I1. Evidence: `docs/research/2026-07-25-slice-g5-production-profile.md`. |
The exact pre-F/G runtime rollback anchor remains `e7d9d6fa`. F0 is
non-drawing diagnostic infrastructure and therefore is not a visual-cutover

View file

@ -1,8 +1,8 @@
# Modern runtime Slice I — flat collision assets and zero-allocation physics
**Status:** I0 COMPLETE — retail oracle, representative graph fixtures, and
four-mover allocation baselines fixed; active G5 production-matrix closeout
precedes I1
four-mover allocation baselines fixed; G5 production closeout complete; I1
active
**Parent:** `2026-07-24-modern-runtime-architecture.md`, Slice I
**Purpose:** remove parsed DAT object graphs and steady collision allocations
without changing one retail collision decision, float, comparison, or traversal