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

docs(runtime): close J3.4 and plan J3.5

Browse source
This commit is contained in:
Erik 2026-07-26 06:09:28 +02:00
parent 5ef8b5371d
commit d3e96ff912
13 changed files with 562 additions and 58 deletions
Download patch file Download diff file Expand all files Collapse all files

36
docs/plans/2026-07-25-modern-runtime-slice-j3.md
View file

@ -1,6 +1,6 @@
# Modern runtime Slice J3 — canonical identity, properties, and object table
**Status:** ACTIVE
**Status:** ACTIVE — J3.1–J3.4 COMPLETE; J3.5 NEXT
**Parent:** `2026-07-25-modern-runtime-slice-j.md`, J3
**Production base:** `9496c01b`
**J2 production commit:** `75930787741db40a83eab8663e4464dce8d687ba`
@ -13,20 +13,22 @@
| J3.1 accepted-wire owners | complete | `f7442d13e9ae7d5b077ffecb1f8a10899ad46edd`; 110 Runtime tests and complete Release parity remain green after J3.2 |
| J3.2 canonical Runtime entity directory | complete | `f46ddb5cdb1e145752bea49aeb1d62bfe71284d3`; 8,441 Release tests / 5 skips and `logs/connected-world-gate-20260725-200749/report.json` pass |
| J3.3 App projection store | complete | `420e5eea70fd2c29cf9c8614e6298a1f84d64045` + `e937cc36df39cf6ea1eaba2f9c0243d1929da702`; 8,444 Release tests / 5 skips and `logs/connected-world-gate-20260725-221008/report.json` pass |
| J3.4 canonical object-table ownership | next | [`2026-07-25-modern-runtime-slice-j3-object-table.md`](2026-07-25-modern-runtime-slice-j3-object-table.md): move the existing `ClientObjectTable` into the Runtime entity/object lifetime group while App remains a synchronous borrower |
| J3.4 canonical object-table ownership | complete | `5ef8b5371d8990f0380acd939e71cd711289d429`; 118 Runtime tests, 3,762 App tests / 3 skips, 8,453 complete Release tests / 5 skips, and `logs/connected-world-gate-20260726-055713/report.json` pass |
| J3.5 ordered deltas and borrowed views | next | [`2026-07-26-modern-runtime-slice-j3-delta-stream.md`](2026-07-26-modern-runtime-slice-j3-delta-stream.md): one committed Runtime entity/object stream and direct borrowed views for graphical and no-window hosts |
J3.3 passes the Release solution build, 3,761 App tests with three skips, and
8,444 complete tests with five expected skips. Its final exact-binary
seven-checkpoint connected lifecycle/reconnect route also passes with graceful
exits, zero render-shadow mismatches, and zero pending deltas. Runtime is now
the sole GUID/incarnation/local-ID authority; every materialized App sidecar,
presentation workset, and live spatial visibility edge uses the exact
`RuntimeEntityKey`. It adds no frame queue, backend dependency, allocation-order
change, or gameplay behavior change. The exact rollback for J3.3 is:
J3.4 passes the Release solution build, 118 Runtime tests, 3,762 App tests with
three skips, and 8,453 complete tests with five expected skips. Its exact-
binary seven-checkpoint connected lifecycle/reconnect route also passes with
graceful exits, zero render-shadow mismatches, and zero pending deltas. Runtime
now owns one entity/object lifetime root containing both the sole
GUID/incarnation/local-ID authority and the sole live `ClientObjectTable`.
Graphical presentation and UI borrow those exact instances. Authoritative
delete removes retained object information; dormant/offscreen pruning does
not. No frame queue, backend dependency, allocation-order change, or gameplay
behavior change was added. The exact rollback for J3.4 is:
```text
git revert e937cc36df39cf6ea1eaba2f9c0243d1929da702
git revert 420e5eea70fd2c29cf9c8614e6298a1f84d64045
git revert 5ef8b5371d8990f0380acd939e71cd711289d429
```
## 1. Objective
@ -222,6 +224,9 @@ move rollback, stack response, GUID reuse, and session-clear traces match.
### J3.5 — ordered deltas and borrowed views
**Detailed execution plan:**
[`2026-07-26-modern-runtime-slice-j3-delta-stream.md`](2026-07-26-modern-runtime-slice-j3-delta-stream.md).
- Publish one monotonic per-session Runtime entity/object delta stream.
- Make J1 `IGameRuntimeView.Entities` and inventory snapshots read the Runtime
owners directly rather than App adapters.
@ -294,12 +299,13 @@ failure; record and revert only the exact failing J3 commit.
J3 sub-slices are independently reversible:
```text
git revert 5ef8b5371d8990f0380acd939e71cd711289d429
git revert e937cc36df39cf6ea1eaba2f9c0243d1929da702
git revert 420e5eea70fd2c29cf9c8614e6298a1f84d64045
git revert f46ddb5cdb1e145752bea49aeb1d62bfe71284d3
git revert f7442d13e9ae7d5b077ffecb1f8a10899ad46edd
```
Revert J3.3's exact-spatial correction before its main projection-store
commit. Revert J3.3 before J3.2, and J3.2 before J3.1, when rolling back more
than one sub-slice.
Revert J3.4 before J3.3. Revert J3.3's exact-spatial correction before its
main projection-store commit. Revert J3.3 before J3.2, and J3.2 before J3.1,
when rolling back more than one sub-slice.