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

perf(rendering): retire production entity partition

Browse source 
Route production meshes and attached particles from the exact retained PView frame ranges, while keeping the former WorldEntity partition only for standalone tests and explicit diagnostic/oracle probes. Copy retained source/count facts before arena release so world diagnostics no longer require the old partition. Record the accepted G4 visual gate and open the exact G5 production matrix.

Co-authored-by: OpenAI Codex <codex@openai.com>
This commit is contained in:
Erik 2026-07-25 10:50:57 +02:00
parent 14b48cf553
commit 10ccce3f2d
11 changed files with 452 additions and 125 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1639,9 +1639,13 @@ port in any phase — no separate listing here.
> comparisons have zero mismatches. The first retained-path visual gate exposed
> independent portal scheduling/private-view/ACE-revisit ownership regressions.
> Their correction passed visually while the draw cutover was temporarily
> reverted, which proves the correction but not the retained source.
> `20f9fadb` reapplies the cutover over those fixes; its connected portal/revisit
> re-gate is pending before G5 old-path deletion and production-only profiling.
> 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
> longer builds `InteriorEntityPartition`; mesh and attached-particle ownership
> come from the retained frame product. The exact production-only
> performance/lifecycle matrix remains.
> The historical exact cutover
> rollback remains
> `git revert ef1d263337997bb030eadb7b8e71d73dc659907a`. Slice H is complete:

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

@ -108,11 +108,13 @@ publication, retirement, upload, warmup, or resource backlog. Capped/uncapped
CPU p99 is 34.7%/30.4% below Slice A and maximum frame allocation is
84.7%/82.2% lower. The user explicitly approved Slices F–L, including both
the F/G ECS and Slice J gameplay-owner gates, on 2026-07-24. Slice F and
G0–G4 are implemented and G4's automated gate has zero mismatches. The portal
scheduling/private-viewport/ACE-revisit correction passed visually while the
retained draw cutover was temporarily reverted, so `20f9fadb` reapplies the
cutover over those fixes for the pending connected retained-path re-gate. G5
deletion and production-only profiling remain gated on that pass. Slice H is
G0–G4 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

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

@ -2,8 +2,9 @@
**Date:** 2026-07-24
**Status:** Slices A–E complete. Slices F–L explicitly approved 2026-07-24;
Slice F is active.
**Status:** Slices A–F and H are complete; G0–G4 and I0 are complete. Slices
F–L were explicitly approved 2026-07-24; G5 production-matrix closeout is
active.
**Scope:** Reconcile and sequence the existing Modern Pipeline (`MP`) and
Linux/headless (`LH`) tracks using the 2026-07-24 connected performance audit.

16
docs/plans/2026-07-24-modern-runtime-slices-f-g-render-scene.md
View file

@ -2,8 +2,8 @@
**Date:** 2026-07-24
**Status:** approved 2026-07-24; Slice F complete, G4 retained-path re-gate
active, G5 prepared but not unblocked
**Status:** approved 2026-07-24; Slice F and G4 complete, G5 retained-route
cleanup active
**Program:** `docs/plans/2026-07-24-modern-runtime-architecture.md`
@ -28,8 +28,8 @@ retail-faithful gameplay
| G1 — scene-query replacement | complete | Exact `e346f8bb` passed capped and uncapped nine-stop routes plus uncapped dense Arwic: 29,392 + 29,025 + 1,522 same-frame candidate comparisons, zero mismatches, equal counts/digests at every checkpoint, exact binary/source identity, and graceful shutdown. Evidence: `docs/research/2026-07-25-slice-g1-scene-query-candidate-gate.md`. |
| 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 | re-gate active | 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. The portal correction was visually accepted while the cutover was temporarily reverted by `2c848d41`; that proves the correction but cannot accept the retained draw source. Commit `20f9fadb` reapplies the cutover over the correction and is the current connected visual re-gate. Evidence: `docs/research/2026-07-25-slice-g4-production-cutover-automated-gate.md` and `docs/research/2026-07-25-portal-regression-closeout.md`. |
| G5 | prepared | Old-route deletion and the production-only reference matrix remain blocked only on the connected `20f9fadb` retained-path re-gate. An allocation-free retained-route particle-owner selector and steady RDP sample are prepared without changing the running gate binary. |
| 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. |
The exact pre-F/G runtime rollback anchor remains `e7d9d6fa`. F0 is
non-drawing diagnostic infrastructure and therefore is not a visual-cutover
@ -653,9 +653,11 @@ correction is recorded in
`docs/research/2026-07-25-portal-regression-closeout.md`. The user's subsequent
pass occurred while exact cutover `ef1d2633` was temporarily reverted by
`2c848d41`, so it proves those corrections but not the retained draw source.
`20f9fadb` reapplies the cutover over the accepted corrections. G4 acceptance,
old-route deletion, and the G5 production-only matrix remain gated on the
connected retained-path recheck.
`20f9fadb` reapplies the cutover over the accepted corrections. The user
accepted that connected retained path on 2026-07-25, including stable objects
and paperdoll through travel, distant interaction, and the corrected `/ls` and
spell-recall materialization. G4 is complete. G5 removes the old production
partition route and runs the production-only matrix.
### G5 — Physical performance and lifecycle gate

3
docs/plans/2026-07-25-modern-runtime-slice-i.md
View file

@ -1,7 +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; accepted G5 closeout now precedes I1
four-mover allocation baselines fixed; active G5 production-matrix closeout
precedes I1
**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

27
docs/research/2026-07-25-slice-g5-production-profile.md
View file

@ -2,10 +2,13 @@
## Status
Work in progress. The retained-scene cutover is running at `20f9fadb`, but G5
old-route deletion remains blocked on its connected portal/revisit visual
re-gate. This note records production-only evidence gathered without enabling
the referee or lifecycle automation.
Work in progress. The retained-scene connected visual re-gate passed on
2026-07-25. Normal production now consumes retained frame-product ranges for
both mesh submission and attached-particle ownership and does not build
`InteriorEntityPartition`. The legacy partition is retained only for
standalone tests and explicitly enabled diagnostic/oracle probes. This note
records production-only evidence gathered without enabling the referee or
lifecycle automation; the exact post-removal route matrix is still pending.
## First steady RDP sample
@ -36,8 +39,14 @@ mandatory after the visual re-gate.
`RenderFrameRouteOwnerSelector` derives attached particle owner IDs from the
exact retained PView route ranges. It supports exact-route replace/union and
all-range exclusion without allocation after warmup. This removes the final
particle-routing reason for normal production to build
`InteriorEntityPartition`; it is not wired into the running visual-gate binary.
Four focused tests and the 3,821-pass / 3-skip App Release suite are green
through an isolated output path.
all-range exclusion without allocation after warmup. It now supplies the
landscape-static, outside-dynamic, look-in, cell-static, and dynamic-last
particle passes. `RetailPViewRenderer` builds the former partition only when
the retained frame product is unavailable in a standalone test or when an
explicit legacy comparison/probe is enabled. The production frame result
copies retained source and route counts before releasing its arena, so
diagnostics do not require the partition either.
The focused route suite, 3,825 App tests / 3 skips, Release solution build,
and 8,334 complete-solution tests / 5 skips are green. The production-only
reference matrix below remains the G5 closeout gate.