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

docs(runtime): close projectile ownership

Browse source
This commit is contained in:
Erik 2026-07-26 15:27:50 +02:00
parent 2aee33569f
commit c30a3efeb0
11 changed files with 263 additions and 35 deletions
Download patch file Download diff file Expand all files Collapse all files

11
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 canonical entity/object lifetime and J4 gameplay-state ownership are closed at `89e6b207`; J5.1 canonical selection/combat/target-mode ownership is closed at `b298f99f`, J5.2 interaction transactions at `f5f7b417`, J5.3 combat/magic intent at `20df9d15`, J5.4 local movement/outbound cadence at `aa3f4a60`, and J5.5 per-session physics/remote simulation at `7e6033d0`. J5.6 projectile runtime 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.1 canonical selection/combat/target-mode ownership is closed at `b298f99f`, J5.2 interaction transactions at `f5f7b417`, J5.3 combat/magic intent at `20df9d15`, J5.4 local movement/outbound cadence at `aa3f4a60`, J5.5 per-session physics/remote simulation at `7e6033d0`, and J5.6 projectile simulation at `2aee3356`. J5.7 cleanup and closeout 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.
---
@ -1764,7 +1764,14 @@ port in any phase — no separate listing here.
> App publishes prepared collision and projects committed snapshots. Its 314
> Runtime tests, 3,718 App tests / 3 skips, 8,588-test / 5-skip complete
> Release suite, exact-binary lifecycle/reconnect gate, and canonical
> nine-stop collision/movement route pass. J5.6 projectile runtime is active.
> nine-stop collision/movement route pass. J5.6 is complete at `2aee3356`:
> Runtime owns the canonical projectile component/workset,
> prediction/correction state, and unchanged retail projectile simulation
> while App resolves immutable DAT shape data and projects committed frames.
> Its 317 Runtime tests, 3,718 App tests / 3 skips, 47 focused Core projectile
> tests, 8,591-test / 5-skip complete Release suite, exact arrow/bolt/spell
> evidence, lifecycle/reconnect gate, and canonical nine-stop route pass.
> J5.7 cleanup and closeout 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

@ -239,7 +239,13 @@ residency is `0/0/0` at every stable checkpoint and teardown converges. Slice I
commits; App publishes prepared collision and projects committed snapshots.
Its 314 Runtime tests, 3,718 App tests / 3 skips, 8,588 full Release tests /
5 skips, exact-binary lifecycle/reconnect route, and canonical nine-stop
collision/movement route pass. J5.6 projectile ownership is active under
collision/movement route pass. J5.6 completed at `2aee3356`: Runtime owns
the canonical projectile component/workset, prediction/correction state,
and unchanged retail projectile simulation while App resolves immutable DAT
shape inputs and projects committed frames. Its 317 Runtime tests, 3,718
App tests / 3 skips, 47 focused Core projectile tests, 8,591 full Release
tests / 5 skips, exact arrow/bolt/spell evidence, lifecycle/reconnect route,
and canonical nine-stop route pass. J5.7 cleanup and closeout 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).
@ -271,6 +277,8 @@ Slice-J5.4 closeout evidence is
[`../research/2026-07-26-slice-j5-4-local-movement-ownership.md`](../research/2026-07-26-slice-j5-4-local-movement-ownership.md).
Slice-J5.5 closeout evidence is
[`../research/2026-07-26-slice-j5-5-physics-remote-ownership.md`](../research/2026-07-26-slice-j5-5-physics-remote-ownership.md).
Slice-J5.6 closeout evidence is
[`../research/2026-07-26-slice-j5-6-projectile-ownership.md`](../research/2026-07-26-slice-j5-6-projectile-ownership.md).
The historical exact G4 visual rollback remains
`git revert ef1d263337997bb030eadb7b8e71d73dc659907a`.

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

@ -2,7 +2,7 @@
**Date:** 2026-07-24
**Status:** Slices A–I, J0–J4, and J5.1–J5.5 are complete. Flat-authoritative collision, zero-
**Status:** Slices A–I, J0–J4, and J5.1–J5.6 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
@ -16,10 +16,11 @@ 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 closed canonical
gameplay-state ownership at `89e6b207`. J5 movement, physics, interaction,
and combat ownership is active at J5.6 after canonical action state
and combat ownership is active at J5.7 after canonical action state
(`b298f99f`), interaction transactions (`f5f7b417`), and combat/magic intent
(`20df9d15`), local movement/outbound cadence (`aa3f4a60`), and per-session
physics/remote simulation (`7e6033d0`) moved to Runtime.
physics/remote simulation (`7e6033d0`), and projectile simulation
(`2aee3356`) moved to Runtime.
**Scope:** Reconcile and sequence the existing Modern Pipeline (`MP`) and
Linux/headless (`LH`) tracks using the 2026-07-24 connected performance audit.
@ -1277,7 +1278,7 @@ 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. J5.1–J5.5 are complete; J5.6 projectile runtime is active.
point. J5.1–J5.6 are complete; J5.7 cleanup and closeout is active.
Evidence:
[`../research/2026-07-25-slice-g5-production-profile.md`](../research/2026-07-25-slice-g5-production-profile.md)
and
@ -1297,6 +1298,8 @@ and
and
[`../research/2026-07-26-slice-j3-6-lifetime-closeout.md`](../research/2026-07-26-slice-j3-6-lifetime-closeout.md)
and
[`../research/2026-07-26-slice-j5-6-projectile-ownership.md`](../research/2026-07-26-slice-j5-6-projectile-ownership.md)
and
[`2026-07-25-modern-runtime-slice-j.md`](2026-07-25-modern-runtime-slice-j.md).
The intended order is therefore:

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

@ -311,7 +311,13 @@ scratch/shadow/collision/body/host/remote/workset graph; App publishes
prepared collision and projects committed snapshots. Its 314 Runtime tests,
3,718 App tests / 3 skips, 8,588 complete Release tests / 5 skips,
exact-binary lifecycle/reconnect gate, and canonical nine-stop collision/
movement route pass. J5.6 projectile runtime is next. Evidence:
movement route pass. J5.6 completed at `2aee3356`: Runtime owns the canonical
projectile component, exact-key workset, prediction/correction state, and
retail projectile simulation; App resolves immutable DAT shape data and
projects committed frames only. Its 317 Runtime tests, 3,718 App tests / 3
skips, 47 focused Core projectile tests, 8,591 complete Release tests / 5
skips, exact arrow/bolt/spell evidence, lifecycle/reconnect gate, and canonical
nine-stop route pass. J5.7 ownership cleanup and closeout is active. Evidence:
[`../research/2026-07-26-slice-j5-1-canonical-action-state.md`](../research/2026-07-26-slice-j5-1-canonical-action-state.md)
and
[`../research/2026-07-26-slice-j5-2-interaction-transactions.md`](../research/2026-07-26-slice-j5-2-interaction-transactions.md)
@ -320,7 +326,9 @@ and
and
[`../research/2026-07-26-slice-j5-4-local-movement-ownership.md`](../research/2026-07-26-slice-j5-4-local-movement-ownership.md)
and
[`../research/2026-07-26-slice-j5-5-physics-remote-ownership.md`](../research/2026-07-26-slice-j5-5-physics-remote-ownership.md).
[`../research/2026-07-26-slice-j5-5-physics-remote-ownership.md`](../research/2026-07-26-slice-j5-5-physics-remote-ownership.md)
and
[`../research/2026-07-26-slice-j5-6-projectile-ownership.md`](../research/2026-07-26-slice-j5-6-projectile-ownership.md).
- Move presentation-free movement interpretation, authoritative/predicted
physics state, selection identity, approach/use transactions, combat intent,

12
docs/plans/2026-07-26-modern-runtime-slice-j5.md
View file

@ -1,6 +1,6 @@
# Modern runtime Slice J5 — movement, physics, interaction, and combat
**Status:** ACTIVE — J5.1–J5.5 complete; J5.6 next
**Status:** ACTIVE — J5.1–J5.6 complete; J5.7 next
**Parent:** `2026-07-25-modern-runtime-slice-j.md`, J5
**Production base:** `2c67a2c3`
**Authorization:** the user approved Slices F–L, including the Slice J
@ -90,8 +90,8 @@ commands to Runtime. The camera may not write the player heading directly.
| J5.3 combat and magic intent | complete | `20df9d155db50706a42420d60a9b15861cf4bfe7`; exact Runtime attack/mode/target/cast owners; 223 Runtime tests, 3,754 App tests / 3 skips, 8,566 complete Release tests / 5 skips, exact-binary connected lifecycle/reconnect pass |
| J5.4 local movement and outbound cadence | complete | `aa3f4a60f87f2cbebc3d8ecd5e33d779b7fb13c1`; one Runtime movement/controller/cadence owner; 303 Runtime tests, 3,716 App tests / 3 skips, 8,575 complete Release tests / 5 skips, exact-binary lifecycle/reconnect and nine-stop movement gates pass |
| J5.5 per-session physics and remote simulation | complete | `7e6033d0adcd0b572c20e89dd275746fb442d52f`; one Runtime engine/cache/scratch/shadow/body/host/remote/workset owner; 314 Runtime tests, 3,718 App tests / 3 skips, 8,588 complete Release tests / 5 skips, exact-binary lifecycle/reconnect and nine-stop collision/movement gates pass |
| J5.6 projectile runtime | active | canonical component/simulation plus App projection acknowledgements |
| J5.7 combined cleanup and closeout | pending | no mirrors, no-window parity, teardown, connected and visual gates |
| J5.6 projectile runtime | complete | `2aee33569f0268d7bc0f4f52437dfa0b405432a4`; one Runtime projectile component/workset/simulation/correction owner; 317 Runtime tests, 3,718 App tests / 3 skips, 47 focused Core projectile tests, 8,591 complete Release tests / 5 skips, exact arrow/bolt/spell evidence, lifecycle/reconnect pass, and nine-stop route pass |
| J5.7 combined cleanup and closeout | active | no mirrors, one ownership ledger, no-window parity, teardown, connected and visual gates |
## J5.1 — canonical action state
@ -481,6 +481,12 @@ J5.5 rollback:
git revert 7e6033d0adcd0b572c20e89dd275746fb442d52f
```
J5.6 rollback:
```text
git revert 2aee33569f0268d7bc0f4f52437dfa0b405432a4
```
## Acceptance
J5 is complete only when: