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

docs(runtime): close gameplay-state ownership

Browse source 
Record J4.5 canonical shortcut and spellbook command ownership, combined failure and graphical/headless parity evidence, the 8,544-test Release gate, exact-binary lifecycle and nine-stop acceptance, rollback instructions, and the J5 boundary.

Co-authored-by: Codex <noreply@openai.com>
This commit is contained in:
Erik 2026-07-26 10:17:39 +02:00
parent 89e6b207f8
commit 2c67a2c3ba
11 changed files with 209 additions and 22 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,6 +1,6 @@
# acdream — strategic roadmap
**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 plus J4.1 communication/social, J4.2 inventory-transaction, J4.3 magic/player-sheet, and J4.4 character projection/typed-command ownership are closed; J4.5 combined closeout is active. 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 canonical entity/object lifetime and J4 gameplay-state ownership are closed at `89e6b207`; J5 movement/physics/interaction/combat ownership is 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.
---
@ -1731,8 +1731,14 @@ port in any phase — no separate listing here.
> character, and social views, and routes graphical/no-window state commands
> through one synchronous generation-gated seam. Its 169 Runtime tests, 3,777
> App tests / 3 skips, 8,534-test / 5-skip complete Release suite, and
> exact-binary seven-checkpoint lifecycle/reconnect gate pass. J4.5 combined
> failure, parity, teardown, connected, and nine-stop closeout is active.
> exact-binary seven-checkpoint lifecycle/reconnect gate pass. J4.5 is
> complete at `89e6b207`: the one Runtime shortcut manager and exact
> inventory/character command owners serve graphical and no-window paths,
> item-use UI cannot construct a second transaction gate, and the combined
> failure-safe ledger converges. Its 175 Runtime tests, 3,780 App tests / 3
> skips, 8,544-test / 5-skip complete Release suite, exact-binary
> lifecycle/reconnect gate, and canonical nine-stop route pass. J5
> movement/physics/interaction/combat ownership is active.
> The historical exact cutover
> rollback remains
> `git revert ef1d263337997bb030eadb7b8e71d73dc659907a`. Slice H is complete:

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

@ -207,7 +207,13 @@ residency is `0/0/0` at every stable checkpoint and teardown converges. Slice I
UI/future no-window state commands through one synchronous generation-gated
seam. Its 169 Runtime tests, 3,777 App tests / 3 skips, 8,534 full Release
tests / 5 skips, and exact-binary seven-checkpoint lifecycle/reconnect route
pass. J4.5 combined closeout is active under
pass. J4.5 completed at `89e6b207`: Runtime owns the one shortcut manager,
graphical/no-window command effects converge on the exact inventory and
character owners, item-use UI cannot create a second transaction gate, and
the combined failure-safe ownership ledger converges. Its 175 Runtime
tests, 3,780 App tests / 3 skips, 8,544 full Release tests / 5 skips,
exact-binary lifecycle/reconnect gate, and canonical nine-stop route pass.
J5 movement/physics/interaction/combat ownership is 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).
@ -227,6 +233,8 @@ Slice-J4.3 closeout evidence is
[`../research/2026-07-26-slice-j4-3-character-state.md`](../research/2026-07-26-slice-j4-3-character-state.md).
Slice-J4.4 closeout evidence is
[`../research/2026-07-26-slice-j4-4-character-projections.md`](../research/2026-07-26-slice-j4-4-character-projections.md).
Slice-J4.5 closeout evidence is
[`../research/2026-07-26-slice-j4-5-gameplay-state-closeout.md`](../research/2026-07-26-slice-j4-5-gameplay-state-closeout.md).
The historical exact G4 visual rollback remains
`git revert ef1d263337997bb030eadb7b8e71d73dc659907a`.

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

@ -14,8 +14,9 @@ hosts and closed the failure-safe owner ledger. J4.1 moved communication and
social ownership into Runtime at `c9d25ade`; J4.2 moved inventory transaction
ownership into Runtime at `011efbea`; J4.3 moved the coupled magic/player-sheet
owner into Runtime at `d02a12ce`; J4.4 moved character settings/projections
and the shared typed state-command seam at `dcb61efb`; J4.5 combined closeout
is the active execution point.
and the shared typed state-command seam at `dcb61efb`; J4.5 closed canonical
gameplay-state ownership at `89e6b207`. J5 movement, physics, interaction,
and combat ownership is 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.
@ -1268,8 +1269,12 @@ 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.
gate, and canonical nine-stop route pass. J4 is complete at `89e6b207`: the
single Runtime shortcut/spellbook/inventory owners, graphical/no-window
command parity, failure-safe combined ledger, 8,544-test Release suite,
exact-binary lifecycle/reconnect gate, and canonical nine-stop route pass.
J5 movement/physics/interaction/combat ownership is the current execution
point.
Evidence:
[`../research/2026-07-25-slice-g5-production-profile.md`](../research/2026-07-25-slice-g5-production-profile.md)
and
@ -1303,7 +1308,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 J4)
-> presentation-independent runtime (J — CURRENT at J5)
-> Linux/headless/multi-session (K)
-> evidence-gated GPU jobs (L)
```

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

@ -1,6 +1,6 @@
# Modern runtime Slice J — presentation-independent runtime
**Status:** J0–J3 COMPLETE; J4.1–J4.4 COMPLETE; J4.5 combined closeout active
**Status:** J0–J4 COMPLETE; J5 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
@ -213,7 +213,7 @@ match current traces; App has no server-GUID ownership.
### J4 — chat, inventory, magic, and gameplay-state services
**Active 2026-07-26.**
**Completed 2026-07-26.**
**Detailed execution plan:**
[`2026-07-26-modern-runtime-slice-j4.md`](2026-07-26-modern-runtime-slice-j4.md).
@ -249,8 +249,14 @@ Runtime owns character options and server run/jump projections, exposes exact
borrowed J4 gameplay views, and routes retained UI plus future no-window hosts
through one synchronous generation-gated state-command seam. Its 169 Runtime
tests, 3,777 App tests / 3 skips, 8,534 complete Release tests / 5 skips, and
exact-binary seven-checkpoint lifecycle/reconnect gate pass. J4.5 combined
failure, parity, teardown, connected, and nine-stop closeout is active.
exact-binary seven-checkpoint lifecycle/reconnect gate pass. J4.5 completed at
`89e6b207`: Runtime owns the one shortcut manager, graphical command effects
flow through the exact Runtime inventory/character owners, the item-use UI
cannot construct a second transaction gate, and the combined failure-safe
ownership ledger converges. Its 175 Runtime tests, 3,780 App tests / 3 skips,
8,544 complete Release tests / 5 skips, exact-binary lifecycle/reconnect gate,
and canonical nine-stop route pass. Evidence:
[`../research/2026-07-26-slice-j4-5-gameplay-state-closeout.md`](../research/2026-07-26-slice-j4-5-gameplay-state-closeout.md).
Detailed execution begins with a source-ownership inventory. Move one coherent
lifetime group at a time in this order:
@ -271,6 +277,10 @@ J4 must borrow it rather than create another inventory model.
### J5 — movement, physics, interaction, and combat group
**Active 2026-07-26.** Detailed execution begins with a source/owner inventory
and a named-retail ordering matrix. Each coherent move must preserve the
accepted connected interaction, facing, projectile, and collision behavior.
- Move presentation-free movement interpretation, authoritative/predicted
physics state, selection identity, approach/use transactions, combat intent,
projectiles, and outbound movement cadence.

22
docs/plans/2026-07-26-modern-runtime-slice-j4.md
View file

@ -1,6 +1,6 @@
# Modern runtime Slice J4 — gameplay-state lifetime groups
**Status:** J4.1–J4.4 COMPLETE; J4.5 ACTIVE
**Status:** COMPLETE
**Parent:** `2026-07-25-modern-runtime-slice-j.md`, J4
**Production base:** `77c013998b902724d66e487589a4ea18538e1ea6`
**Authorization:** the user approved Slices F–L, including Slice J gameplay
@ -25,7 +25,7 @@ ordering and its existing retail-derived algorithms.
| J4.2 inventory transactions | complete | `011efbeaa72509b35ea7f4a442e50a2377ae1ea4`; 157 Runtime tests, 3,770 App tests / 3 skips, 8,515 complete Release tests / 5 skips, and `logs/connected-world-gate-20260726-082057/report.json` pass |
| J4.3 magic/player sheet | complete | `d02a12ceac54d035797b4c58f2fc2f0ccad9a4d6`; 162 Runtime tests, 3,772 App tests / 3 skips, 8,522 complete Release tests / 5 skips, and `logs/connected-world-gate-20260726-083921/report.json` pass |
| J4.4 character projections | complete | `dcb61efb5af6c12bd619369e28cf11bacc37bc73`; 169 Runtime tests, 3,777 App tests / 3 skips, 8,534 complete Release tests / 5 skips, and `logs/connected-world-gate-20260726-091340/report.json` pass |
| J4.5 combined cleanup | active | combined failure, no-window, connected, and nine-stop closeout |
| J4.5 combined cleanup | complete | `89e6b207f81946b40c38c8dc6597817ad99fc6e0`; 175 Runtime tests, 3,780 App tests / 3 skips, 8,544 complete Release tests / 5 skips, exact-binary lifecycle/reconnect and nine-stop gates |
## Current ownership inventory
@ -165,6 +165,8 @@ is recorded in
### J4.5 — combined cleanup and closeout
**Completed 2026-07-26 at `89e6b207`.**
- Delete temporary App owner fields, reset branches, reconstructed runtime
views/events, and compatibility adapters replaced by J4.
- Prove graphical UI and no-window hosts observe the same owner instances,
@ -184,6 +186,16 @@ Run:
8. canonical nine-stop route;
9. documentation, divergence, dependency, and source-ownership audit.
Result: the Runtime inventory graph now owns the one retail 18-slot shortcut
manager, retained toolbar/spell controllers apply command effects through the
canonical Runtime owner, and `ItemInteractionController` can no longer create a
second inventory transaction/busy owner. Exact retail local/send ordering is
pinned for shortcuts, favorites, filters, and desired components. Graphical
and direct no-window command effects match, while a combined failure-safe
ledger proves every J4 owner and subscription converges after reset or terminal
disposal. Exact evidence is recorded in
[`../research/2026-07-26-slice-j4-5-gameplay-state-closeout.md`](../research/2026-07-26-slice-j4-5-gameplay-state-closeout.md).
## Acceptance
J4 is complete only when:
@ -232,3 +244,9 @@ J4.4 is independently reversible with:
```text
git revert dcb61efb5af6c12bd619369e28cf11bacc37bc73
```
J4.5 is independently reversible with:
```text
git revert 89e6b207f81946b40c38c8dc6597817ad99fc6e0
```