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

docs(headless): close K3 connected gates

Browse source
This commit is contained in:
Erik 2026-07-27 10:28:53 +02:00
parent 3f3401257c
commit 827a039760
7 changed files with 183 additions and 44 deletions
Download patch file Download diff file Expand all files Collapse all files

42
docs/plans/2026-07-26-modern-runtime-slice-k.md
View file

@ -1,6 +1,6 @@
# Modern runtime Slice K — Linux headless and multi-session host
**Status:** K0–K2 COMPLETE; K3 AUTOMATED CHECKPOINT COMPLETE, CONNECTED GATE ACTIVE 2026-07-27
**Status:** K0–K3 COMPLETE; K4 ACTIVE 2026-07-27
**Parent:** `2026-07-24-modern-runtime-architecture.md`, Slice K
**Authorization:** the user approved Slices F–L on 2026-07-24
**Purpose:** run efficient automated clients on Linux without a display, GPU,
@ -171,11 +171,14 @@ Support non-interactive providers suitable for local automation:
- standard-input secret stream;
- credential file with an explicit user-only-permission check on Linux.
Do not accept a plaintext password directly on the command line because process
lists expose it. `ToString`, validation errors, logs, checkpoints, crash
reports, and metrics contain only redacted credential IDs. Secrets are cleared
from retained buffers when the session is disposed where the BCL representation
allows it.
The user additionally requires an explicit `-user`/`-password` (and long-form
alias) launch override for local single-session automation. It is accepted only
for `run` with exactly one configured session and intentionally carries the
ordinary process-list exposure of command-line arguments. Configuration-based
multi-session production continues to use the providers above. `ToString`,
validation errors, logs, checkpoints, crash reports, and metrics never echo the
password, and the session wraps the value in the same disposable credential
owner used by provider-based launch.
## 6. Bot surface
@ -293,7 +296,7 @@ not busy-loop.
### K3 — shared immutable content and isolation
**Automated checkpoint complete at `12b500d3`, `9569dadb`, and `b6547ff3`.**
**Complete at `12b500d3`, `9569dadb`, `b6547ff3`, and `3f340125`.**
The process opens the exact DAT/pak/magic/terrain sources once, shares a
bounded immutable flat-collision cache, and gives each session its own
Runtime/physics/cache/movement/collision-neighborhood graph. The direct
@ -301,8 +304,26 @@ accepted-state route now hydrates local-player movement and terrain, EnvCell,
building, stab, and procedural-scenery collision without loading presentation.
The 1/5/10-session same-GUID/portal/reconnect gate and policy-fault quarantine
pass. Runtime passes 412 tests, Headless 42, App 3,722/3 skips, and the complete
Release solution 8,758/5 skips. The remaining K3 work is the visible-terminal
Windows connected gate plus the matching Linux/WSL production gate. Evidence:
Release solution 8,758/5 skips.
The connected closeout adds explicit portal-route and long-lived observer
policies as consumers of the same `IGameRuntimeView` /
`IGameRuntimeCommands` seam used by graphical automation. It also aligns the
direct host with retail position routing: ordinary accepted position echoes no
longer re-run teleport placement or stop local motion, `ForcePosition` uses
`BlipPlayer` semantics plus an immediate position acknowledgement, and a real
teleport performs exactly one destination placement. High-volume collision
snap diagnostics are now explicitly opt-in.
The visible Windows production terminal passed connect, collision hydration,
lifestone recall, graceful reconnect, second-generation materialization, and
terminal teardown. The native Linux/WSL executable then passed direct CLI
launch, exact Aerlinthe/Caul/Rynthid/lifestone routing, external `teleallto`
portal generations, and a retail-client observer gate. The user saw the
headless character turn and run smoothly without rubberbanding; three accepted
external portal generations completed before ACE confirmed graceful logout.
The final Release gate passes 412 Runtime tests, 47 Headless tests, 3,722 App
tests / 3 skips, and 8,764 complete-solution tests / 5 skips. Evidence:
`docs/research/2026-07-27-slice-k3-shared-content-isolation-checkpoint.md`.
- Introduce a process content owner with leases and exact last-user disposal.
@ -402,9 +423,10 @@ git revert 38e83640d907ee3e0819f3b38ca117ca60914d6b
git revert 7e8acb74dd20931d5ba88430fd100cd074a32e4d
```
K3 automated-checkpoint rollback, newest first:
K3 rollback, newest first:
```text
git revert 3f3401257c83bdd9f557eb577ba08cf2e5ec9a06
git revert b6547ff38c375328417855200f41c8af6436f246
git revert 9569dadb578b299b24e30aec85eee86ec0c2b3fb
git revert 12b500d38362e8aae0a23a4f9712b86367006f76