docs(runtime): record J7 root cutover gates

Capture the exact production rollback, complete automated evidence, connected route results, and the still-active physical-display acceptance without declaring J7 closed early.

Co-authored-by: OpenAI Codex <codex@openai.com>
This commit is contained in:
Erik 2026-07-26 19:29:18 +02:00
parent ce41efb9e5
commit b8c90c1959
3 changed files with 172 additions and 1 deletions

View file

@ -384,6 +384,17 @@ mid-portal disconnect traces match; the graphical screenshots remain accepted.
### J7 — one `GameRuntime` composition root
J7.1 completed at `96ddd165`; J7.2/J7.3 completed at
`ce41efb9e5938f79a7580476b949d172f52a1e69`. Production now owns one
`GameRuntime`, App borrows its children, and shutdown is one ordered root
transaction. All focused, complete Release, exact-binary lifecycle/reconnect,
and canonical nine-stop automated gates pass. The physical-display visual gate
is active; J7 remains open until the user accepts radar, paperdoll,
Use/approach, combat facing, and both recall paths. Detailed evidence:
[`2026-07-26-modern-runtime-slice-j7.md`](2026-07-26-modern-runtime-slice-j7.md)
and
[`../research/2026-07-26-slice-j7-game-runtime-root-cutover.md`](../research/2026-07-26-slice-j7-game-runtime-root-cutover.md).
- Compose all moved lifetime groups into one instance-scoped `GameRuntime`.
- Make `GameWindow`/App own exactly one Runtime instance plus presentation
adapters.
@ -395,6 +406,12 @@ mid-portal disconnect traces match; the graphical screenshots remain accepted.
Gate: graphical connected lifecycle/resource routes pass with no mirrored
state, no extra update latency, and no performance regression.
Exact J7.2/J7.3 rollback:
```text
git revert ce41efb9e5938f79a7580476b949d172f52a1e69
```
### J8 — no-window integration and Slice J closeout
- Build a transport/content test host that constructs Runtime directly.

View file

@ -1,6 +1,6 @@
# Modern runtime Slice J7 — one `GameRuntime` composition root
**Status:** ACTIVE
**Status:** AUTOMATED GATES COMPLETE — PHYSICAL-DISPLAY VISUAL GATE ACTIVE
**Parent:** `2026-07-25-modern-runtime-slice-j.md`, J7
**Authorization:** the user approved Slices FL, including the J gameplay-owner
gates, on 2026-07-24
@ -106,6 +106,9 @@ construction path until J7.2 performs the isolated cutover.
### J7.2 — production composition cutover
**Complete 2026-07-26 at
`ce41efb9e5938f79a7580476b949d172f52a1e69`.**
- Construct one root in `GameWindow`.
- Make `UpdateFrameClock` borrow the root clock.
- Make `WorldEnvironmentController` and `WorldGenerationAvailabilityState`
@ -122,8 +125,19 @@ construction path until J7.2 performs the isolated cutover.
Gate: App composition/failure-injection tests prove one exact root and no
partial publication or borrowed-owner disposal.
Result: production `GameWindow` constructs and stores one `GameRuntime`.
Every App composition record receives that root and borrows its session,
clock, environment, transit, identity, gameplay, entity, and movement
children. The former App view/event reconstructions are deleted. Source guards
prove that no production App site constructs an independent Runtime child.
### J7.3 — one shutdown transaction
**Complete 2026-07-26 in the same coherent production cutover
`ce41efb9e5938f79a7580476b949d172f52a1e69`.** J7.2 and J7.3 are one
bisectable ownership change because publishing the root without replacing the
old child-by-child shutdown would create two incompatible lifetime graphs.
- Replace individual Runtime roots in `GameWindowShutdownRoots` with
`GameRuntime`.
- Quiesce its session at the existing ingress barrier.
@ -135,8 +149,18 @@ partial publication or borrowed-owner disposal.
Gate: every shutdown fault point converges on retry; no subscriber, route,
entity, physics, gameplay, transit, or session debt remains.
Result: ingress quiesces the root session, App retires every graphical
borrower, and only then releases the graphical host lease and disposes the
root. Construction rollback and shutdown-fault tests prove the borrowed root
is never disposed by App rollback and that the terminal root ledger converges
without route, publication, entity, physics, gameplay, transit, session, or
host-lease debt.
### J7.4 — validation and closeout
**Automated portion complete 2026-07-26; physical-display visual acceptance
is active.**
- Focused Runtime and App tests.
- Release solution build.
- Complete Release suite.
@ -147,6 +171,33 @@ entity, physics, gameplay, transit, or session debt remains.
- Update architecture, code structure, milestone, roadmap, parent/umbrella
plans, AGENTS/CLAUDE, divergence ledger, and durable memory.
Automated evidence:
- 383 focused Runtime tests pass.
- 3,717 App tests pass / 3 skip.
- Release solution build passes.
- 8,661 complete Release tests pass / 5 skip.
- Exact-binary lifecycle/reconnect report
`logs/connected-world-gate-20260726-190919/report.json` passes at the exact
production SHA. The capped process crosses six checkpoints in 242.324
seconds; the fresh uncapped reconnect completes in 61.332 seconds. Both exit
gracefully. All seven checkpoints retain zero host projections, pending host
acknowledgements, live teardowns, and landblock retirements.
- Exact-binary canonical route
`logs/connected-r6-soak-20260726-191605.report.json` passes all nine
destinations, movement, jump, combat, portal, revisit, and graceful-exit
gates. Against the J5.7 canonical baseline, median turn CPU/GPU/update p95
improves from 22.9/9.7/2.3 ms to 16.4/1.3/0.7 ms; turn allocation p50
improves from 5,812.9 to 75.1 KiB. Median stationary CPU/GPU/update p95
improves from 21.4/7.0/1.3 ms to 15.2/1.1/0.6 ms. Peak working set falls
from 2,326.8 to 1,953.2 MiB while peak private bytes remain effectively flat
at 1,732.1 MiB.
- Captured physical-display login, facility-hub, Holtburg-after-dungeon, and
reconnect frames are intact. The live user gate covers radar, paperdoll,
near/distant Use, combat facing, `/ls`, spell recall, portal tunnel, and
portal exit before J7 is declared closed.
- No AC behavior changed and the divergence audit found no new row to add.
## 5. Adversarial matrix
- construction failure after every child owner;
@ -178,5 +229,11 @@ J7.1 exact rollback:
git revert 96ddd16539e670a5ce9b1f86677530e3fbc3f635
```
J7.2/J7.3 exact rollback:
```text
git revert ce41efb9e5938f79a7580476b949d172f52a1e69
```
No compatibility owner, service locator, asynchronous command queue, timeout,
forced-ready path, or alternate headless behavior is permitted.