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

docs(runtime): record reveal ownership gate

Browse source
This commit is contained in:
Erik 2026-07-26 17:26:50 +02:00
parent acb845d812
commit 38b3773cb9
9 changed files with 191 additions and 25 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-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`, J5.6 projectile simulation at `2aee3356`, and J5.7 combined simulation closeout at `cdee7a4b`. J6.1 world-environment ownership is closed at `902076c0`; J6.2 canonical reveal generation and typed destination readiness 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`, J5.6 projectile simulation at `2aee3356`, and J5.7 combined simulation closeout at `cdee7a4b`. J6.1 world-environment ownership is closed at `902076c0`; J6.2 canonical reveal generation and typed destination readiness is closed at `a6860d55` plus `acb845d8`; J6.3 teleport packet/destination correlation 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.
---
@ -1781,7 +1781,13 @@ port in any phase — no separate listing here.
> synchronized world clock, weather, selected day group, and AdminEnvirons
> state; its 332 Runtime tests, 3,718 App tests / 3 skips, 8,611-test / 5-skip
> complete Release suite, and exact-binary lifecycle/reconnect route pass.
> J6.2 canonical reveal generation and typed destination readiness is active.
> J6.2 completed at `a6860d55` plus `acb845d8`: Runtime owns the sole
> reveal generation, destination/readiness latch, materialization,
> simulation-availability, viewport, completion, cancellation, and wait-cue
> state. Its 349 Runtime tests, 3,716 App tests / 3 skips, 8,626-test / 5-skip
> complete Release suite, and exact-binary lifecycle/reconnect route pass with
> zero reveal invariants. J6.3 teleport packet/destination correlation is
> active.
> The historical exact cutover
> rollback remains
> `git revert ef1d263337997bb030eadb7b8e71d73dc659907a`. Slice H is complete:

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

@ -256,7 +256,12 @@ residency is `0/0/0` at every stable checkpoint and teardown converges. Slice I
AdminEnvirons state; App projects immutable DAT-backed sky presentation.
Its 332 Runtime tests, 3,718 App tests / 3 skips, 8,611 complete Release
tests / 5 skips, and exact-binary lifecycle/reconnect route pass. J6.2
canonical reveal generation and typed destination readiness is active under
completed at `a6860d55` plus `acb845d8`: Runtime owns the sole reveal
generation, destination/readiness latch, materialization, availability,
viewport, completion, cancellation, and wait-cue state; App's lifecycle
mirror is deleted. Its 349 Runtime tests, 3,716 App tests / 3 skips, 8,626
complete Release tests / 5 skips, and exact-binary lifecycle/reconnect route
pass with zero reveal invariants. J6.3 transit correlation 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).

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

@ -354,11 +354,13 @@ graphical feel gates remain unchanged.
### J6 — world, portal, environment, and projection handshake
**J6.0–J6.1 complete; J6.2 active 2026-07-26.** The instance-scoped Runtime
environment owner landed at `902076c0`; exact day-group, Release, full-suite,
and connected lifecycle/reconnect gates pass. Detailed owner inventory, retail
ordering, host-acknowledgement contract, execution ledger, adversarial matrix,
and current evidence:
**J6.0–J6.2 complete; J6.3 active 2026-07-26.** The instance-scoped Runtime
environment owner landed at `902076c0`. The canonical reveal generation and
typed readiness owner landed at `a6860d55` plus `acb845d8`; App's duplicate
lifecycle owner is deleted and the exact connected lifecycle/reconnect gate
passes with zero reveal invariants. Detailed owner inventory, retail ordering,
host-acknowledgement contract, execution ledger, adversarial matrix, and
current evidence:
[`2026-07-26-modern-runtime-slice-j6.md`](2026-07-26-modern-runtime-slice-j6.md).
- Move authoritative teleport/session cell identity, world clock, weather

30
docs/plans/2026-07-26-modern-runtime-slice-j6.md
View file

@ -1,6 +1,6 @@
# Modern runtime Slice J6 — world, transit, and host handshake
**Status:** J6.0–J6.1 COMPLETE; J6.2 ACTIVE
**Status:** J6.0–J6.2 COMPLETE; J6.3 ACTIVE
**Parent:** `2026-07-25-modern-runtime-slice-j.md`, J6
**Authorization:** the user approved Slices F–L, including gameplay-owner
moves, on 2026-07-24
@ -221,6 +221,9 @@ and exited gracefully with code zero. Evidence:
### J6.2 — canonical reveal generation and typed readiness
**Complete 2026-07-26 at `a6860d55` plus connected correction
`acb845d8`.**
- Add `RuntimeWorldTransitState`, immutable readiness acknowledgement, and
direct `IRuntimePortalView`.
- Move lifecycle telemetry and generation state from App to Runtime.
@ -235,6 +238,24 @@ and exited gracefully with code zero. Evidence:
Gate: login, portal, supersession, stale acknowledgement, callback failure,
session reset, and exact two-release-edge fixtures pass.
Result: Runtime owns the sole monotonic reveal generation, destination,
typed readiness latch, materialization/simulation edge, viewport observation,
completion, cancellation, wait cue, and portal materialization count. App's
former lifecycle owner is deleted; `WorldRevealCoordinator` is a graphical
host adapter and `WorldGenerationAvailabilityState` is a read-only Runtime
projection. The first connected run correctly exposed that post-acceptance
render-readiness samples may regress while the accepted atomic edge must
remain latched; `acb845d8` ignores those later samples without mutating
Runtime truth or reporting false invariant failures.
Runtime tests pass 349/349, App tests pass 3,716/3 skips, and the complete
Release suite passes 8,626/5 skips. Exact-binary report
`logs/connected-world-gate-20260726-171724/report.json` records six capped
checkpoints and one uncapped fresh-process reconnect, graceful code-zero exits,
zero failures, zero reveal invariant failures, and only the expected
world-edge warning. Evidence:
[`../research/2026-07-26-slice-j6-2-reveal-ownership.md`](../research/2026-07-26-slice-j6-2-reveal-ownership.md).
### J6.3 — canonical F751/Position transit and placement handshake
- Move `TeleportTransitCoordinator` state into the Runtime transit owner.
@ -324,6 +345,13 @@ J6.1 exact rollback:
git revert 902076c0a42079596a8a273e9be402776cabf4b0
```
J6.2 exact rollback, newest first:
```text
git revert acb845d812574206da1693fb379fec8a6f175fcb
git revert a6860d5563ae845a2cbb916abacf2b4aee515cdb
```
Documentation-only research/plan commits are not behavior rollback points.
No workaround, timer, forced-ready path, duplicated owner, or alternate
headless behavior is permitted.