docs: reconcile project state and refresh README
Some checks failed
Headless portability / portable-headless (ubuntu-latest) (push) Has been cancelled
Headless portability / portable-headless (windows-latest) (push) Has been cancelled
Headless portability / linux-graphical (push) Has been cancelled

This commit is contained in:
Erik 2026-07-27 12:53:31 +02:00
parent 97a095d628
commit f6275f4501
12 changed files with 432 additions and 295 deletions

View file

@ -2,33 +2,24 @@
**Date:** 2026-07-24
**Status:** Slices AI and J0J5 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 FL were
explicitly approved 2026-07-24. Slice J0J1 established the enforced Runtime
boundary and borrowed contract seam; J2 moved canonical session/transport
lifetime and ordered inbound routing; J3.1J3.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 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 closed canonical
gameplay-state ownership at `89e6b207`. J5 movement, physics, interaction,
and combat ownership closed at `cdee7a4b` 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`), projectile simulation (`2aee3356`),
and the combined simulation ledger/Runtime-only closeout moved to Runtime.
J6 completed at `18d17d8b`: Runtime owns world environment, canonical reveal
generation/readiness, exact F751/Position destination correlation, and the
generation/cell-scoped graphical-host acknowledgement suffix. J7 completed
at `ce41efb9` with its automated gates and the user's 2026-07-27
physical-display acceptance. J8 and Slice J closed at `a9a822f2`: graphical
and direct hosts share one `GameRuntime`, one retryable generation-reset
transaction, and one canonical gameplay-owner graph. Slice K is active; K0
established the tested Windows/Linux headless boundary at `aada8a37`.
**Status:** Slices AK are complete. Slice L is deferred at its L1
implementation checkpoint by user direction on 2026-07-27.
Flat-authoritative collision, zero-allocation resolve scratch, parsed-graph
removal, prepared content, typed residency, retained render-scene submission,
and bounded frame owners are production paths. Slice J closed at `a9a822f2`:
graphical and direct hosts share one presentation-independent `GameRuntime`,
one retryable generation-reset transaction, and one canonical session/entity/
object/gameplay/movement/physics/projectile/environment/transit owner graph.
Slice K closed through `776482da`: the Windows/Linux no-window host, shared
immutable content, deterministic bot API/scheduler, 1/5/10/30-session
isolation, two-hour simulated endurance, connected portal/movement parity,
resource ceilings, graceful reconnect/logout, and zero-debt teardown pass.
Slice L0 landed at `66f114b2`; L1's immutable Win32/X11/Wayland selection,
packaged GLFW 3.4 preference, atomic capability record, active modern-GL
probes, and safe terminal reporting landed at `11501d52`. Native Windows AMD
passes. WSLg correctly rejects its missing mandatory bindless-texture
capability. Physical-Linux validation and L2L6 are parked; resume at the
supported AMD/NVIDIA L1 gate.
**Scope:** Reconcile and sequence the existing Modern Pipeline (`MP`) and
Linux/headless (`LH`) tracks using the 2026-07-24 connected performance audit.
@ -1065,6 +1056,9 @@ host-parity tests after each move.
### Slice K — Linux headless and multi-session host
**Status:** complete through `776482da`; closeout is
[`2026-07-26-modern-runtime-slice-k.md`](2026-07-26-modern-runtime-slice-k.md).
**Prepared execution plan:**
[`2026-07-26-modern-runtime-slice-k.md`](2026-07-26-modern-runtime-slice-k.md).
Implementation began after Slice J's no-window closeout at `a9a822f2`.
@ -1100,9 +1094,14 @@ per-session incremental memory given a numeric ceiling at gate time.
### Slice L — Linux graphical host and evidence-gated GPU work
**Status:** deferred 2026-07-27. L0 is complete at `66f114b2`; the L1
implementation checkpoint is `11501d52`. Physical supported-driver validation
and L2L6 remain pending.
**Prepared execution plan:**
[`2026-07-26-modern-runtime-slice-l.md`](2026-07-26-modern-runtime-slice-l.md).
Implementation begins after Slice K closes.
Implementation began after Slice K closed and is parked at the recorded L1
gate.
**Purpose:** Finish platform portability and only then pursue remaining GPU
opportunities.
@ -1309,10 +1308,20 @@ at every stable checkpoint. J7 completed at `ce41efb9`, and the user accepted
its exact post-cutover visual matrix on 2026-07-27. J8 closed Slice J at
`a9a822f2`; 395 Runtime tests, 3,731 App tests / 3 skips, 8,696 complete-
solution tests / 5 skips, lifecycle/reconnect, and canonical nine-stop gates
pass. Slice K is the current execution point.
K0 completed at `aada8a37`: the no-App Windows/Ubuntu closure, strict
no-connect validator, dependency/assembly guards, Release build, 8,708-test /
5-skip complete suite, and local Ubuntu gates pass. K1 is active.
pass. Slice K closed through `776482da`. K0 established the no-App
Windows/Ubuntu dependency and loaded-assembly boundary; K1 added portable
paths/config/credentials and the direct Runtime host; K2 added the
deterministic scheduler and complete bot command/event API; K3 added shared
immutable content plus multi-session isolation and connected observer parity;
K4 added committed resource ceilings, 1/5/10/30-root and two-hour simulated
endurance gates, and the ten-minute two-account native-Linux connected soak.
That final process logged both accounts out through ACE and converged every
Runtime/content ledger. Slice L0 then completed at `66f114b2`, and L1's
implementation checkpoint landed at `11501d52`. App passes 3,763 / 3 skips
and the complete Release suite passes 8,826 / 5 skips. Native Windows passes
the packaged graphical/audio smoke; WSLg X11/Wayland correctly emit the
actionable mandatory-bindless rejection with zero terminal ownership. Further
Linux graphical work is deferred at the physical supported-driver L1 gate.
Evidence:
[`../research/2026-07-25-slice-g5-production-profile.md`](../research/2026-07-25-slice-g5-production-profile.md)
and
@ -1338,7 +1347,15 @@ and
and
[`../research/2026-07-26-slice-j5-7-simulation-ownership-closeout.md`](../research/2026-07-26-slice-j5-7-simulation-ownership-closeout.md)
and
[`2026-07-25-modern-runtime-slice-j.md`](2026-07-25-modern-runtime-slice-j.md).
[`2026-07-25-modern-runtime-slice-j.md`](2026-07-25-modern-runtime-slice-j.md)
and
[`../research/2026-07-27-slice-k4-resource-telemetry-checkpoint.md`](../research/2026-07-27-slice-k4-resource-telemetry-checkpoint.md)
and
[`2026-07-26-modern-runtime-slice-k.md`](2026-07-26-modern-runtime-slice-k.md)
and
[`../research/2026-07-27-slice-l0-platform-services.md`](../research/2026-07-27-slice-l0-platform-services.md)
and
[`../research/2026-07-27-slice-l1-graphical-capability-checkpoint.md`](../research/2026-07-27-slice-l1-graphical-capability-checkpoint.md).
The intended order is therefore:
@ -1352,9 +1369,9 @@ 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 J5)
-> Linux/headless/multi-session (K)
-> evidence-gated GPU jobs (L)
-> presentation-independent runtime (J — COMPLETE)
-> Linux/headless/multi-session (K — COMPLETE)
-> Linux graphical / GPU evidence (L — DEFERRED at L1)
```
This order improves the current graphical client first while laying clean