docs(runtime): close J3.3 and hand off J3.4

Record exact projection-store ownership, automated and connected evidence, rollback chain, and the executor-ready canonical object-table plan. Reconcile milestones, roadmap, architecture, divergence pointers, AGENTS/CLAUDE, and durable handoff state.

Co-authored-by: Codex <codex@openai.com>
This commit is contained in:
Erik 2026-07-25 22:29:34 +02:00
parent e937cc36df
commit d9bf4c4960
15 changed files with 757 additions and 114 deletions

View file

@ -4,7 +4,7 @@ This page is the entry point for project documentation. It distinguishes
current sources of truth from implementation history so an old plan or issue
banner cannot silently override the current program state.
## Current snapshot — 2026-07-24
## Current snapshot — 2026-07-25
- **Milestone state:** M3, “Cast a spell,” landed 2026-07-21. M4, “Live in the
world,” is active.
@ -14,38 +14,32 @@ banner cannot silently override the current program state.
[`plans/2026-07-23-world-interaction-completion.md`](plans/2026-07-23-world-interaction-completion.md).
The eight-slice `GameWindow` decomposition and its connected visual matrix
are complete.
- **Current active engineering program:** Slices AE of
- **Current active engineering program:** Slices AI and J0J3.3 of
[`plans/2026-07-24-modern-runtime-architecture.md`](plans/2026-07-24-modern-runtime-architecture.md)
are complete. Production world-mesh streaming consumes the validated
prepared package, typed residency is bounded/accounted, and streaming now
has typed admission plus immediate old-generation quiescence, metered
retirement, and retained cursor-budgeted publication across render, physics,
statics, building registries, collision/reflood, and EnvCells. The canonical
reveal generation now owns an exact destination reservation across every
typed budget dimension; incomplete destinations remain in portal space and
receive retail's centered wait cue instead of forced early reveal. E6's
deterministic/resource gates and capped, uncapped, and dense-Arwic
physical-local routes pass. Slices FL, including the F/G and J approval
gates, were explicitly authorized 2026-07-24; Slice F is active.
Their post-E evidence, ownership map, shadow-comparison design, cutover
sequence, and acceptance matrix are implementation-ready in the
[F/G render-scene plan](plans/2026-07-24-modern-runtime-slices-f-g-render-scene.md).
See also the [Slice E streaming report](research/2026-07-24-slice-e-cost-budgeted-streaming-report.md).
are complete. Production uses prepared world/collision packages, typed
residence, retained render-scene/delta submission, bounded frame owners, and
flat-authoritative collision without parsed-graph production residency.
Runtime owns canonical session/transport and the sole live-entity
GUID/incarnation/local-ID directory. App materialized projections,
presentation worksets, and spatial visibility carry exact
`RuntimeEntityKey`. J3.4 canonical object-table ownership is next in
[`plans/2026-07-25-modern-runtime-slice-j3-object-table.md`](plans/2026-07-25-modern-runtime-slice-j3-object-table.md).
- **Completed gates:** R6 locomotion/collision/projectile/teleport/radar and
the final two-client portal-out/materialization observer comparison (`#218`).
- **Separate visual verification:** the shared-alpha lifestone/particle result
in `#225`; its connected resource-lifetime and performance routes pass.
- **Carried behavior debt:** `#153` (far teleport onto an unstreamed edge),
`#116` (two narrowed slide-response cases), and divergence rows TS-50/TS-51.
- **Active engineering track:** render ECS/MP3 is executing from the
implementation-ready F/G plan, followed by the approved Linux/headless
automation slices. The pre-F/G runtime rollback anchor is `e7d9d6fa`.
- **Active engineering track:** complete Slice J's coherent Runtime lifetime
groups, then build the approved Linux/headless multi-session host in Slice K.
J3.3's exact rollback is `git revert e937cc36` followed by
`git revert 420e5eea`.
- **Divergence audit:** 178 active rows — IA 17, AD 37, AP 85, TS 34,
and UN 5 — plus the retained retired TS-37 history note.
- **Latest automated baseline:** Release build succeeds; 8,164 tests pass and
five are intentionally skipped. The capped, uncapped, and dense-Arwic
physical prepared-asset routes all completed their portal/input/lifetime
assertions and disconnected gracefully.
- **Latest automated baseline:** Release build succeeds; 8,444 tests pass and
five are intentionally skipped. The exact J3.3 connected lifecycle/reconnect
gate completed two sessions and seven checkpoints with graceful zero-code
exits, zero failures, zero render-shadow mismatches, and zero pending deltas.
## Sources of truth