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

docs(runtime): close canonical entity object lifetime

Browse source
This commit is contained in:
Erik 2026-07-26 07:35:42 +02:00
parent 119b7c1151
commit 77c013998b
11 changed files with 249 additions and 43 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,6 +1,6 @@
# acdream — strategic roadmap
**Status:** Living document. Updated 2026-07-24. **M3 landed; M4 is active.** 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. All eight slices of the behavior-preserving ownership campaign in [`docs/architecture/code-structure.md`](../architecture/code-structure.md), their automated closeout, and the user's connected visual matrix are complete. Issue #225's lifestone/particle alpha comparison remains a separate rendering visual gate.
**Status:** Living document. Updated 2026-07-26. **M3 landed; M4 is active.** 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. All eight slices of the behavior-preserving ownership campaign in [`docs/architecture/code-structure.md`](../architecture/code-structure.md), their automated closeout, and the user's connected visual matrix are complete. Modern Runtime J3's canonical entity/object lifetime is also closed; J4 gameplay-state lifetime groups are active. 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.
---
@ -1705,7 +1705,13 @@ port in any phase — no separate listing here.
> Its 134 Runtime tests, 3,765 App tests / 3 skips, 8,472-test / 5-skip
> complete Release suite, and exact-binary seven-checkpoint gate pass with
> graceful exits, zero failures, zero render-shadow mismatches, and zero
> pending deltas. J3.6 adversarial lifetime and zero-owner closeout is active.
> pending deltas. J3.6 is complete at `119b7c11`: the exact canonical
> entity/object owner now survives callback failure and re-entrancy, retains
> every incomplete teardown suffix, and converges the complete reset/disposal
> ledger to zero. Its 146 Runtime tests, 3,765 App tests / 3 skips, 8,484-test
> / 5-skip complete Release suite, exact lifecycle/reconnect gate, and
> canonical nine-stop route pass. J4 gameplay-state lifetime groups are
> active.
> The historical exact cutover
> rollback remains
> `git revert ef1d263337997bb030eadb7b8e71d73dc659907a`. Slice H is complete:

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

@ -181,9 +181,15 @@ residency is `0/0/0` at every stable checkpoint and teardown converges. Slice I
graphical and no-window hosts. Its 134 Runtime tests, 3,765 App tests / 3
skips, 8,472 full Release tests / 5 skips, and exact-binary
seven-checkpoint connected gate pass with graceful exits, zero failures,
zero render-shadow mismatches, and zero pending deltas. J3.6 adversarial
failure and zero-owner closeout is active under
[`2026-07-26-modern-runtime-slice-j3-hardening.md`](2026-07-26-modern-runtime-slice-j3-hardening.md).
zero render-shadow mismatches, and zero pending deltas. J3.6 is complete at
`119b7c11`: exact teardown receipts precede fallible callbacks, re-entrant
observers retain one monotonic synchronous stream, accepted-channel
versions prevent displaced callbacks, and reset/direct disposal converge
the complete owner ledger to zero. Its 146 Runtime tests, 3,765 App tests /
3 skips, 8,484 full Release tests / 5 skips, exact lifecycle/reconnect gate,
and canonical nine-stop route pass. J4 gameplay-state lifetime groups are
active under
[`2026-07-25-modern-runtime-slice-j.md`](2026-07-25-modern-runtime-slice-j.md).
Slice-I closeout evidence is
[`../research/2026-07-25-slice-i7-closeout.md`](../research/2026-07-25-slice-i7-closeout.md).
Slice-J2 closeout evidence is
@ -196,6 +202,8 @@ Slice-J3.4 closeout evidence is
[`../research/2026-07-26-slice-j3-4-canonical-object-lifetime.md`](../research/2026-07-26-slice-j3-4-canonical-object-lifetime.md).
Slice-J3.5 closeout evidence is
[`../research/2026-07-26-slice-j3-5-canonical-delta-stream.md`](../research/2026-07-26-slice-j3-5-canonical-delta-stream.md).
Slice-J3.6 closeout evidence is
[`../research/2026-07-26-slice-j3-6-lifetime-closeout.md`](../research/2026-07-26-slice-j3-6-lifetime-closeout.md).
The historical exact G4 visual rollback remains
`git revert ef1d263337997bb030eadb7b8e71d73dc659907a`.

23
docs/plans/2026-07-24-modern-runtime-architecture.md
View file

@ -2,15 +2,16 @@
**Date:** 2026-07-24
**Status:** Slices A–I and J0–J3.5 are complete. Flat-authoritative collision, zero-
**Status:** Slices A–I and J0–J3 are complete. Flat-authoritative collision, zero-
allocation resolve scratch, parsed-graph removal, connected correctness/
lifetime acceptance, and Slice-I closeout landed 2026-07-25. Slices F–L were
explicitly approved 2026-07-24. Slice J0–J1 established the enforced Runtime
boundary and borrowed contract seam; J2 moved canonical session/transport
lifetime and ordered inbound routing; J3.1–J3.5 moved canonical entity identity
lifetime and ordered inbound routing; J3.1–J3.6 moved canonical entity identity
and object-table lifetime to Runtime, exact graphical projection identity to
App, and one ordered canonical entity/object stream plus direct views to all
hosts. J3.6 adversarial lifetime closeout is the active execution point.
hosts and closed the failure-safe owner ledger. J4 gameplay-state lifetime
groups are the active execution point.
**Scope:** Reconcile and sequence the existing Modern Pipeline (`MP`) and
Linux/headless (`LH`) tracks using the 2026-07-24 connected performance audit.
@ -1251,16 +1252,20 @@ gameplay before removing every production parsed collision graph. Slice I7
passes 8,413 Release tests / 5 skips plus both exact-binary connected routes;
every stable checkpoint reports zero retained parsed collision graphs. J1 is
complete with borrowed contracts, and J2 owns canonical session/transport
lifetime plus ordered inbound routing in Runtime. J3.1–J3.5 are complete:
lifetime plus ordered inbound routing in Runtime. J3.1–J3.6 are complete:
Runtime owns the only entity GUID/incarnation/local-ID directory, and App's
materialized sidecars plus spatial/presentation worksets carry exact
`RuntimeEntityKey`. One `RuntimeEntityObjectLifetime` also owns the exact live
`ClientObjectTable`; App is a synchronous borrower. Exact `ce3ac310` adds the
one per-generation canonical entity/object delta stream, issues Runtime
identity before App hydration, and gives graphical/no-window hosts the same
direct borrowed views. Its 8,472-test / 5-skip Release suite and exact-binary
seven-checkpoint connected route pass. J3.6 adversarial failure and zero-owner
closeout is the current execution point.
direct borrowed views. J3.6 at `119b7c11` retains exact teardown receipts
before fallible callbacks, serializes re-entrant observation within the
committing call, protects every accepted channel by mutation version, and
requires reset/direct disposal to converge the complete ownership ledger to
zero. Its 8,484-test / 5-skip Release suite, exact-binary lifecycle/reconnect
gate, and canonical nine-stop route pass. J4 gameplay-state lifetime groups
are the current execution point.
Evidence:
[`../research/2026-07-25-slice-g5-production-profile.md`](../research/2026-07-25-slice-g5-production-profile.md)
and
@ -1278,6 +1283,8 @@ and
and
[`../research/2026-07-26-slice-j3-5-canonical-delta-stream.md`](../research/2026-07-26-slice-j3-5-canonical-delta-stream.md)
and
[`../research/2026-07-26-slice-j3-6-lifetime-closeout.md`](../research/2026-07-26-slice-j3-6-lifetime-closeout.md)
and
[`2026-07-25-modern-runtime-slice-j.md`](2026-07-25-modern-runtime-slice-j.md).
The intended order is therefore:
@ -1292,7 +1299,7 @@ honest metrics + committed baselines (A — exit criteria block C)
-> delta GPU submission (G)
-> residual frame cleanup (H-a, H-b, H-c)
-> flat collision assets (I — COMPLETE)
-> presentation-independent runtime (J — CURRENT at J3.6)
-> presentation-independent runtime (J — CURRENT at J4)
-> Linux/headless/multi-session (K)
-> evidence-gated GPU jobs (L)
```

35
docs/plans/2026-07-25-modern-runtime-slice-j.md
View file

@ -1,7 +1,6 @@
# Modern runtime Slice J — presentation-independent runtime
**Status:** J0–J2 COMPLETE; J3.1–J3.5 COMPLETE; J3.6 adversarial lifetime
hardening and zero-owner closeout are active
**Status:** J0–J3 COMPLETE; J4 gameplay-state lifetime groups are active
**Parent:** `2026-07-24-modern-runtime-architecture.md`, Slice J
**Authorization:** the user approved Slices F–L, including the otherwise-frozen
Slice J gameplay-owner moves, on 2026-07-24
@ -183,20 +182,21 @@ git revert 75930787741db40a83eab8663e4464dce8d687ba
**Detailed execution plan:**
[`2026-07-25-modern-runtime-slice-j3.md`](2026-07-25-modern-runtime-slice-j3.md).
**Current checkpoint:** J3.1–J3.5 are complete. Runtime owns accepted entity
**Completed 2026-07-26.** Runtime owns accepted entity
wire state and the only canonical identity/incarnation/local-ID directory.
App's `LiveEntityProjectionStore` and every materialized presentation/spatial
workset are keyed by exact `RuntimeEntityKey`; the temporary GUID-shaped
compatibility view is deleted. `RuntimeEntityObjectLifetime` now owns the
exact entity directory and live `ClientObjectTable`; App, routing, interaction,
and UI borrow both. Exact J3.5 binary `ce3ac310` now publishes one committed
and UI borrow both. Exact J3.5 binary `ce3ac310` publishes one committed
per-generation Runtime entity/object delta stream, issues identity before App
hydration, and supplies direct allocation-free views to graphical and
no-window hosts. App reconstructs neither entity nor inventory state/events.
Its 8,472 Release tests / 5 skips and exact seven-checkpoint connected gate at
`logs/connected-world-gate-20260726-064324/report.json` pass. J3.6 now
failure-injects the complete lifetime and proves every reset/disposal owner
converges to zero.
J3.6 at `119b7c11` makes every canonical commit, callback, teardown receipt,
reset, and direct disposal failure-safe and proves the full owner ledger
converges to zero. Its 8,484 Release tests / 5 skips, exact seven-checkpoint
lifecycle/reconnect gate, and canonical nine-stop route pass. Evidence:
[`../research/2026-07-26-slice-j3-6-lifetime-closeout.md`](../research/2026-07-26-slice-j3-6-lifetime-closeout.md).
- Strip renderer, particle, Wb, and streaming components from the canonical
record into an App projection store keyed only by local identity/incarnation.
@ -213,6 +213,8 @@ match current traces; App has no server-GUID ownership.
### J4 — chat, inventory, magic, and gameplay-state services
**Active 2026-07-26.**
- Move canonical chat history/channel state, inventory transactions, spell and
component state, enchantments, vitals, skills/attributes, and gameplay
cooldown state by coherent owner groups.
@ -224,6 +226,23 @@ match current traces; App has no server-GUID ownership.
Gate: deterministic command/response traces and graphical ViewModel revisions
match; no Runtime type references UI abstractions.
Detailed execution begins with a source-ownership inventory. Move one coherent
lifetime group at a time in this order:
1. chat history/channel/command state;
2. inventory transaction and gameplay item-use state that is not already
canonical in `RuntimeEntityObjectLifetime`;
3. learned spells, formulas/components, enchantments, and cast/cooldown state;
4. vitals, skills, attributes, advancement, and target/combat gameplay state;
5. plugin/bot borrowed views and typed commands over those same owners;
6. delete every replaced App owner/adapter, then run the combined no-window,
graphical parity, teardown, Release, lifecycle/reconnect, and nine-stop
gates.
Panel trees, text layout, icons, 3-D paperdolls, status bars, and animation/VFX
remain App presentation. The inventory object collection already moved in J3;
J4 must borrow it rather than create another inventory model.
### J5 — movement, physics, interaction, and combat group
- Move presentation-free movement interpretation, authoritative/predicted

17
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 — J3.1–J3.5 COMPLETE; J3.6 ACTIVE
**Status:** COMPLETE 2026-07-26
**Parent:** `2026-07-25-modern-runtime-slice-j.md`, J3
**Production base:** `9496c01b`
**J2 production commit:** `75930787741db40a83eab8663e4464dce8d687ba`
@ -15,7 +15,7 @@
| 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 | 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 | complete | `ce3ac310d92722ffb637e81cb1957458874dd220`; 134 Runtime tests, 3,765 App tests / 3 skips, 8,472 complete Release tests / 5 skips, and `logs/connected-world-gate-20260726-064324/report.json` pass |
| J3.6 adversarial hardening and closeout | active | [`2026-07-26-modern-runtime-slice-j3-hardening.md`](2026-07-26-modern-runtime-slice-j3-hardening.md): failure-inject every lifetime boundary and prove zero owners after reset/disposal |
| J3.6 adversarial hardening and closeout | complete | `119b7c115107245546180b2f5cb3cb44c7d5476a`; 146 Runtime tests, 3,765 App tests / 3 skips, 8,484 complete Release tests / 5 skips, exact lifecycle/reconnect gate, and canonical nine-stop route pass |
J3.5 passes the Release solution build, 134 Runtime tests, 3,765 App tests with
three skips, and 8,472 complete tests with five expected skips. Its exact-
@ -31,6 +31,16 @@ gameplay behavior change was added. The exact rollback for J3.5 is:
git revert ce3ac310d92722ffb637e81cb1957458874dd220
```
J3.6 closes the group under callback failure, re-entrancy, retained teardown,
reset, GUID reuse, and direct disposal. Its complete owner ledger converges to
zero and both exact-binary connected routes pass. Evidence:
[`../research/2026-07-26-slice-j3-6-lifetime-closeout.md`](../research/2026-07-26-slice-j3-6-lifetime-closeout.md).
The exact rollback for J3.6 is:
```text
git revert 119b7c115107245546180b2f5cb3cb44c7d5476a
```
## 1. Objective
Move the one canonical server-object identity/incarnation owner, accepted
@ -307,6 +317,7 @@ git revert f46ddb5cdb1e145752bea49aeb1d62bfe71284d3
git revert f7442d13e9ae7d5b077ffecb1f8a10899ad46edd
```
Revert J3.5 before J3.4. Revert J3.4 before J3.3. Revert J3.3's exact-spatial
Revert J3.6 before J3.5. Revert J3.5 before J3.4. 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.

26
docs/plans/2026-07-26-modern-runtime-slice-j3-hardening.md
View file

@ -1,6 +1,6 @@
# Modern runtime J3.6 — adversarial lifetime hardening and closeout
**Status:** READY
**Status:** COMPLETE 2026-07-26 at `119b7c115107245546180b2f5cb3cb44c7d5476a`
**Parent:** `2026-07-25-modern-runtime-slice-j3.md`
**Required production base:** `ce3ac310d92722ffb637e81cb1957458874dd220`
**Prior closeout:** `../research/2026-07-26-slice-j3-5-canonical-delta-stream.md`
@ -10,8 +10,10 @@
Close the canonical entity/object lifetime group under failure, re-entrancy,
reset, and disposal before J4 moves another gameplay owner.
This slice adds no feature, queue, retry timer, renderer fallback, or gameplay
behavior. It proves that Runtime's canonical identity/object owner and App's
This slice adds no feature, cross-frame/background queue, retry timer,
renderer fallback, or gameplay behavior. Its synchronous re-entrant dispatch
drain preserves one observer-visible sequence within the committing call. It
proves that Runtime's canonical identity/object owner and App's
exact-key graphical projection either complete each transaction or retain one
explicitly retryable suffix, and that every terminal path converges to zero.
@ -179,18 +181,26 @@ J3 is complete only when:
## Rollback
J3.5 remains independently reversible:
J3.6 is independently reversible:
```text
git revert ce3ac310d92722ffb637e81cb1957458874dd220
git revert 119b7c115107245546180b2f5cb3cb44c7d5476a
```
Record J3.6's exact production commit before its connected gates. Never revert
J3.4 or J3.3 to mask a J3.6 failure.
J3.5 remains independently reversible with
`git revert ce3ac310d92722ffb637e81cb1957458874dd220`. Never revert J3.4
or J3.3 to mask a later failure.
## Closeout evidence
The complete failure matrix, zero-owner ledger, 8,484-test Release result,
exact-binary lifecycle/reconnect gate, canonical nine-stop route, divergence
audit, and rollback are recorded in
`../research/2026-07-26-slice-j3-6-lifetime-closeout.md`.
## Next boundary
After J3.6 closes J3, execute J4 from
J3 is closed. Execute J4 from
`docs/plans/2026-07-25-modern-runtime-slice-j.md`: move the remaining
presentation-independent gameplay-state owners in coherent lifetime groups,
with direct/graphical parity and zero-mirror deletion after every group.