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

refactor(rendering): prepare retained particle routing

Browse source 
Derive attached particle owners from the exact retained PView route stream with a zero-allocation warm path. Correct G4 gate provenance, record the current production-only RDP sample, and keep G5 old-route deletion explicitly blocked until the reapplied retained cutover passes its connected visual gate.
This commit is contained in:
Erik 2026-07-25 08:45:18 +02:00
parent 20f9fadb12
commit c730632075
7 changed files with 374 additions and 20 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1632,10 +1632,13 @@ port in any phase — no separate listing here.
> shadow referee, production cutover, and acceptance matrix. The user
> explicitly approved Slices F–L, including the F/G and J gates, on
> 2026-07-24. Slice F and G0–G4 are implemented; 46,599 automated G4
> comparisons have zero mismatches. The 2026-07-25 connected visual gate
> accepted the retained scene after independent portal scheduling/private-view/
> ACE-revisit ownership regressions were corrected; G5 old-path deletion and
> production-only profiling are now active. The historical exact cutover
> 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.
> The historical exact cutover
> rollback remains
> `git revert ef1d263337997bb030eadb7b8e71d73dc659907a`. Slice H is complete:
> retained UI/frame work, exact bounded light selection, and

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

@ -108,10 +108,11 @@ 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; G4's automated gate has zero mismatches and its
2026-07-25 connected visual gate passes after the portal scheduling/private
viewport/ACE revisit regression correction. G5 deletion and production-only
profiling are active. Slice H is
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
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

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

@ -2,7 +2,8 @@
**Date:** 2026-07-24
**Status:** approved 2026-07-24; Slice F and G4 complete, G5 active
**Status:** approved 2026-07-24; Slice F complete, G4 retained-path re-gate
active, G5 prepared but not unblocked
**Program:** `docs/plans/2026-07-24-modern-runtime-architecture.md`
@ -27,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 | 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. The 2026-07-25 connected visual pass accepted the retained scene after its independent portal scheduling/ownership regressions were corrected. Evidence: `docs/research/2026-07-25-slice-g4-production-cutover-automated-gate.md` and `docs/research/2026-07-25-portal-regression-closeout.md`. |
| G5 | active | The accepted visual gate unblocks production-only performance/lifecycle closeout and old-route deletion. |
| 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. |
The exact pre-F/G runtime rollback anchor remains `e7d9d6fa`. F0 is
non-drawing diagnostic infrastructure and therefore is not a visual-cutover
@ -646,12 +647,15 @@ the scene journal was empty, source and binary hashes matched, and every
process closed gracefully. The gate corrected whole-retained-world composite
warmup discovery by sourcing the exact published 3×3 destination neighborhood;
that correction is draw-path independent. Fixed-camera artifacts are captured.
The user completed the connected visual gate on 2026-07-25. The retained scene
itself remained exact; the pass exposed independent portal scheduling, private
viewport ownership, and ACE revisit-liveness defects. Their root-cause
The first connected retained-path gate exposed independent portal scheduling,
private-viewport ownership, and ACE revisit-liveness defects. Their root-cause
correction is recorded in
`docs/research/2026-07-25-portal-regression-closeout.md`. G4 is accepted and
old-route deletion plus G5 production-only profiling are unblocked.
`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.
### G5 — Physical performance and lifecycle gate