docs(architecture): close GameWindow render slice
Record the clean Release, lifecycle, soak, and framebuffer gates for Slice 7, advance the structural program to Slice 8, and preserve the observed process-residency diagnostic gap as issue 232 rather than weakening its leak threshold.\n\nCo-authored-by: Codex <codex@openai.com>
This commit is contained in:
Erik
parent
9d7df1bfc5
commit
96f8bfcfa8
8 changed files with 176 additions and 64 deletions
|
|
@ -1,6 +1,6 @@
|
|||
# acdream — strategic roadmap
|
||||
|
||||
**Status:** Living document. Updated 2026-07-22. **M3 landed; M4 is next after the active `GameWindow` structural prerequisite.** M3's retail casting/UI, R6 locomotion/collision/projectile/teleport/radar rebaseline, deterministic fresh-login/portal world lifecycle, and final two-client portal observer flow are user-gated. The current program is the behavior-preserving ownership campaign in [`docs/architecture/code-structure.md`](../architecture/code-structure.md); Slices 1–6 are complete and Slice 7 draw-frame orchestration is active. New M4 quest/emote/character-creation feature bodies wait until that campaign is complete. Issue #225's lifestone/particle alpha comparison remains a separate rendering visual gate.
|
||||
**Status:** Living document. Updated 2026-07-22. **M3 landed; M4 is next after the active `GameWindow` structural prerequisite.** M3's retail casting/UI, R6 locomotion/collision/projectile/teleport/radar rebaseline, deterministic fresh-login/portal world lifecycle, and final two-client portal observer flow are user-gated. The current program is the behavior-preserving ownership campaign in [`docs/architecture/code-structure.md`](../architecture/code-structure.md); Slices 1–7 are complete and final Slice 8 composition/shutdown cleanup is active. New M4 quest/emote/character-creation feature bodies wait until that campaign is complete. Issue #225's lifestone/particle alpha comparison remains a separate rendering visual gate.
|
||||
**Purpose:** One source of truth for where the project is and where it's going. Every observed defect or missing feature has a named phase that owns it; when something looks wrong in-game, look here to find the phase that'll address it. Implementation details live in per-phase specs under `docs/superpowers/specs/`, not in this file.
|
||||
|
||||
---
|
||||
|
|
@ -68,7 +68,18 @@ passes 7,182 tests / 5 skips; the 314-second lifecycle/reconnect gate and
|
|||
394-second synchronized nine-stop resource soak pass with graceful exits and
|
||||
stable owner counts. The completed ledger is
|
||||
[`2026-07-21-gamewindow-slice-6-update-frame-orchestration.md`](2026-07-21-gamewindow-slice-6-update-frame-orchestration.md).
|
||||
Slice 7 `RenderFrameOrchestrator` extraction is now active.
|
||||
Slice 7 render-frame orchestration is complete. `GameWindow.OnRender` now
|
||||
supplies one immutable frame input to focused resource, world-scene,
|
||||
private-presentation, and diagnostic owners. Exact world/PView/alpha/portal/
|
||||
paperdoll/retained-UI/ImGui/screenshot/GPU-close order and failure recovery are
|
||||
pinned by tests. `GameWindow` is 4,666 raw lines / 196 fields / 70 methods,
|
||||
11,057 lines (70.3%) below the campaign baseline. The Release suite passes
|
||||
7,341 tests / 5 skips; the 315.6-second lifecycle/reconnect gate and 395.2-
|
||||
second synchronized soak pass with graceful exits, and the six stable PNG
|
||||
checkpoints preserve Slice 6 presentation. Issue #232 tracks the coarse
|
||||
process-residency gate's diagnostic blind spot; no tolerance was loosened.
|
||||
|
||||
Final Slice 8 composition/shutdown cleanup is now active.
|
||||
|
||||
This is a behavior-preserving structural program. Severe regressions still get
|
||||
root-cause fixes in separate commits; ordinary feature work resumes with M4
|
||||
|
|
|
|||
|
|
@ -32,7 +32,16 @@ suite passes 7,182 tests / 5 skips; the 314-second capped/reconnect lifecycle
|
|||
gate and synchronized 394-second nine-destination resource soak both pass with
|
||||
graceful exits and stable owner counts. The completed Slice 6 ledger is
|
||||
[`2026-07-21-gamewindow-slice-6-update-frame-orchestration.md`](2026-07-21-gamewindow-slice-6-update-frame-orchestration.md).
|
||||
Slice 7 draw-frame orchestration is active.
|
||||
Slice 7 draw-frame orchestration is complete. `GameWindow.OnRender` is one
|
||||
typed frame handoff; resource, world-scene, private-presentation, and
|
||||
diagnostic owners preserve the accepted draw/failure graph. `GameWindow` is
|
||||
4,666 raw lines / 196 fields / 70 methods, down 11,057 lines (70.3%) from the
|
||||
campaign baseline. The full Release suite passes 7,341 tests / 5 skips; the
|
||||
315.6-second capped/reconnect lifecycle gate and 395.2-second synchronized
|
||||
nine-destination soak pass with graceful exits, and six stable PNG checkpoints
|
||||
preserve Slice 6 presentation. Final Slice 8 composition/shutdown cleanup is
|
||||
active. Issue #232 tracks process-residency variance in the soak without
|
||||
loosening its leak threshold.
|
||||
|
||||
Carried:
|
||||
#153 far-teleport residual, #116 slide-response, the remaining R6 ownership cleanup plus
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
# GameWindow Slice 7 — render-frame orchestration
|
||||
|
||||
**Status:** Active 2026-07-22.
|
||||
**Status:** Complete 2026-07-22.
|
||||
**Parent program:** [`docs/architecture/code-structure.md`](../architecture/code-structure.md), Slice 7.
|
||||
**Baseline:** `9512404e`; `GameWindow.cs` is 7,026 raw lines, 241 fields, and
|
||||
108 methods. The Release suite passes 7,182 tests / 5 fixture or environment
|
||||
|
|
@ -30,7 +30,7 @@ port, or resource-lifetime redesign.
|
|||
PView/fallback world branches, particles, debug world draw, and completion.
|
||||
- [x] G — compose `RenderFrameOrchestrator`, cut `GameWindow.OnRender` to one
|
||||
handoff, and delete obsolete frame bodies, fields, helpers, and callbacks.
|
||||
- [ ] H — corrected-diff reviews, full Release suite, connected lifecycle and
|
||||
- [x] H — corrected-diff reviews, full Release suite, connected lifecycle and
|
||||
soak gates, framebuffer comparison, documentation, memory, and metrics.
|
||||
|
||||
Every checked checkpoint is one bisectable architectural commit. A checkpoint
|
||||
|
|
@ -517,6 +517,22 @@ After three clean corrected-diff reviews:
|
|||
8. audit architecture, divergence pointers, roadmap, milestones, issues,
|
||||
`AGENTS.md`, `CLAUDE.md`, and durable memory.
|
||||
|
||||
Completed 2026-07-22. The 315.6-second lifecycle/reconnect gate passed at
|
||||
`9d7df1bf` with six valid PNG checkpoints, code-zero graceful capped exit, and
|
||||
fresh-process uncapped reconnect. Side-by-side comparison with the Slice 6
|
||||
artifacts preserved world geometry, UI/paperdoll layering, private viewports,
|
||||
and depth/presentation; only live weather, particle timing, authoritative
|
||||
vitals, and small scripted camera-settling differences changed. The unchanged
|
||||
nine-stop gate then passed in 395.2 seconds with nine materializations, all
|
||||
Caul/Holtburg movement exercises, code-zero graceful shutdown, update p95 at
|
||||
or below 0.8 ms, and same-location Caul plateau deltas of +85.7 MiB working set
|
||||
and +59.3 MiB private memory. Two immediately preceding identical-binary runs
|
||||
crossed the coarse process-residency limit while every other deterministic
|
||||
lifecycle, timing, and shutdown check passed; #232 records the need to add
|
||||
canonical managed/GPU/cache owner snapshots to that gate instead of weakening
|
||||
its leak threshold. Release build and the complete suite remain green at 7,341
|
||||
passed / 5 skipped. Slice 7 is closed with no new retail divergence.
|
||||
|
||||
The accepted baseline at docs-only commit `9512404e` is behavior-equivalent to
|
||||
production cutover `e91f3102`: 7,182 passed / 5 skipped, 314.195-second
|
||||
lifecycle/reconnect, and 393.581-second soak. Exact counters are recorded in
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue