Switch the engineering client to M10 sessions (M10.5c)
Foundation / checks (checks) (push) Successful in 32m47s
Foundation / checks (client) (push) Failing after 10m1s
Foundation / checks (deploy) (push) Successful in 5s
Foundation / checks (ecs) (push) Successful in 1m53s
Foundation / checks (network) (push) Successful in 11m18s
Foundation / checks (postgres) (push) Successful in 40m20s
Foundation / checks (tsan) (push) Successful in 7m46s
Foundation / postgres-tools (push) Skipped
Foundation / image (push) Skipped
Foundation / server-image (push) Skipped

evo-client's remote mode now runs over RegionSessionClient (QUIC, session
v2): snapshot-fed environment and organism views, the camera following the
server's view until the user moves it and then driving the interest, intention
records with a simulated state, and reconnects with the next grant of a bundle.
The launcher reads 160-byte M10 grants and defaults to the dev route.

- quic::resolve_ipv4 shared by the client and evo-session-probe
- evo-session-probe grants: owner-only bundles of 1-64 grants
- evo-server --m10-max-grant-lifetime (dev only, 60..3600 s)
- presets client-network/client-package build QUIC; msquic links the CRT
  fully static; msquic.dll and msquic/OpenSSL licences in the Windows package
- client-remote-session test against a loopback region
- ADR-0093/0091/0086 amendments, M10_CLIENT_SESSIONS guide, validation

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
dingo
2026-10-06 11:57:07 -04:00
co-authored by Claude Opus 5.5
parent 33e91458e7
commit 1819ebc0ab
35 changed files with 1119 additions and 270 deletions
+7 -6
View File
@@ -8,21 +8,22 @@ Contract: [client architecture](../architecture/CLIENT_ARCHITECTURE.md), ADR-007
Camera/input: [contracts and limits](CAMERA_INPUT.md), ADR-0079.
Environment: [presentation and encodings](ENVIRONMENT_RENDERING.md), ADR-0080.
Organisms/inspector: [encodings and budget](ORGANISM_RENDERING.md), ADR-0081.
Remote dev region: [operations](../networking/DEV_SESSION_OPERATIONS.md), ADR-0083.
Remote dev region: [M10 client sessions](../networking/M10_CLIENT_SESSIONS.md), ADR-0093
(the M9.7 path, ADR-0083, is no longer used by the client).
Engineering panels and launcher: [UI state](CLIENT_UI_STATE.md), ADR-0084.
Without arguments a launcher opens. **Local fixture** is labelled as an in-memory
stand-in, never as a server or ecosystem. **Connect** (preset `client-network`)
reads the endpoint, server name, dev CA file and grant bundle file when pressed;
stand-in, never as a server or ecosystem. **Connect** (preset `client-network`, with QUIC)
reads the endpoint, server name, dev CA file and M10 grant bundle file when pressed;
nothing is saved and no path, certificate or grant byte is shown or logged. Errors
use fixed wording. A connection with no Welcome after three failed attempts
(refused, TLS failure or timeout) or a refused grant fails with Retry/Cancel.
`--fixture` or `--connect HOST:PORT --server-name NAME --ca FILE --grants FILE`
skip the launcher (an unreadable file then exits 1). While running, a banner names
the mode (LOCAL FIXTURE or DEV REGION with its phase); Disconnect asks for
confirmation. The Session panel shows session/epoch, server tick, durable
watermark, grants left and the last ten intentions with their outcome (sent,
admitted, rejected, durable, not committed, unknown). That list is the record;
confirmation. The Session panel shows session/epoch, server tick, simulated
watermark, grants left, the snapshot, interest and snapshot bytes, and the last ten
intentions with their outcome (sent, admitted, rejected, simulated, unknown; M10.5c). That list is the record;
short notifications expire and can be dismissed.
## Build and run
+9 -7
View File
@@ -1,9 +1,10 @@
# Windows client package (M9.8e)
Decision: [ADR-0086](../adr/0086-windows-client-package.md). Windows development host
only; requires Visual Studio 2022 C++ tools and prepared SDL, Dear ImGui and Mbed TLS
sources (`cmake -P tools/prepare-sdl3.cmake`, `prepare-imgui.cmake`,
`prepare-mbedtls.cmake`).
only; requires Visual Studio 2022 C++ tools and prepared SDL, Dear ImGui, Mbed TLS and
msquic sources (`cmake -P tools/prepare-sdl3.cmake`, `prepare-imgui.cmake`,
`prepare-mbedtls.cmake`, `prepare-msquic.cmake`), plus Strawberry Perl and NASM for
msquic's OpenSSL build (ADR-0090).
## Build a package
@@ -13,15 +14,15 @@ powershell -NoProfile -ExecutionPolicy Bypass -File tools\client\package-windows
It refuses uncommitted tracked changes (`-AllowDirty` packages them with a `-dirty`
identity), configures `client-package` with `EVO_BUILD_IDENTITY=g<12 hex>`, builds,
runs the client/network CTest suite, stages the allowlisted files and writes
runs the client/network/quic-session CTest suite, stages the allowlisted files and writes
`build/packages/evo-client-windows-x64-<identity>.zip` and `.zip.sha256`. The staged
folder stays next to the ZIP. `-Clean` deletes `build/client-package` first; the
build log is `build/client-package.log` (+ `.err`).
Package content (exact): `evo-client.exe`, `SDL3.dll`, `README.txt`,
Package content (exact): `evo-client.exe`, `SDL3.dll`, `msquic.dll`, `README.txt`,
`BUILD-INFO.txt`, `THIRD-PARTY-NOTICES.txt`, `SHA256SUMS.txt` and `LICENSES/`
(SDL3, its HIDAPI, yuv2rgb, stb_image and Khronos notices, Apache-2.0, Mbed TLS,
Dear ImGui with fonts and stb notices). The tester README template is
Dear ImGui with fonts and stb notices, msquic, OpenSSL). The tester README template is
`tools/client/README-package.txt`; the notice index is
`tools/client/THIRD-PARTY-NOTICES.txt`. No credentials, grant bundles, CA files or
settings are ever packaged; dev CA and grants are issued to testers separately.
@@ -34,7 +35,8 @@ powershell -NoProfile -ExecutionPolicy Bypass -File tools\client\package-selftes
```
Verification works without Visual Studio (copy `tools/client` with the ZIP): digest,
exact content and SHA256SUMS, PE imports limited to system DLLs plus `SDL3.dll`,
exact content and SHA256SUMS, PE imports of all three images limited to system DLLs plus
`SDL3.dll` and `msquic.dll` (no C runtime DLLs),
credential and profile-path scan, then the extracted client runs with only the
Windows system directories on PATH. `-Interactive` opens a real window for 3 s.
The self-test proves each guard refuses its defect.
+73
View File
@@ -4406,3 +4406,76 @@ tests; clang-tidy 19 on sessions, client, replication, bridge, probe and tests;
checked). The repository format check fails only on `include/evo/server/session_window.hpp`
(already on main, not part of this change).
Not done: the GUI client (10.5c); deployment of v2 (the dev server still runs v1).
## 2026-10-06 — M10.5c engineering client on M10 sessions (ADR-0093, ADR-0091, ADR-0086)
Implemented the client's remote mode over `RegionSessionClient`
(`apps/evo-client/remote_session.hpp`):
- snapshot-fed views;
- the camera follows the default view, then drives the interest;
- intention record states, including `simulated`;
- reconnect with the bundle's next grant, with a growing pause.
Supporting changes:
- the launcher reads 160-byte grants, takes `authority_path`, and defaults to the dev route;
- `quic::resolve_ipv4`;
- `evo-session-probe grants`;
- evo-server `--m10-max-grant-lifetime` (dev only);
- presets `client-network` and `client-package` with QUIC;
- msquic with a fully static CRT;
- `msquic.dll` and the msquic and OpenSSL licences in the Windows package;
- `CL=/Brepro` and `SOURCE_DATE_EPOCH` for the package's OpenSSL build.
New test `client-remote-session` (labels client and quic-session) runs against a loopback
region:
- launcher flow and the 225-cell default view;
- following, then the camera interest (144 cells clipped);
- admitted then simulated intentions;
- an epoch change: unknown outcomes, stale views, reconnect with the next grant and the
views restored;
- client-side numbering across sessions;
- superseded, wrong region, an exhausted bundle, and an unresolvable endpoint.
The process test now runs evo-server with `--m10-max-grant-lifetime 900` and the probe with
a 900 s grant.
Found during development:
- test cells requesting water without moisture (the client refused the snapshot and closed);
- a budget-cut first snapshot skewed a one-time recentre, so the camera now follows until
the user moves it;
- session sequences collided in the outcome record, so the record now numbers entries
itself;
- msquic's default partial-static CRT imported the UCRT forwarders;
- a clang-tidy optional-access finding.
Executed:
- **Linux GCC 14**
- preset `client-network` (with QUIC): CTest 14/14; `client-remote-session` passed 5 times
in a row;
- preset `quic`: 4/4;
- `postgres-check.sh` with EVO_BUILD_QUIC: 20 suites, including the region m10 session
integration.
- **Linux Clang 19:** clang-tidy 19 on the client app, remote test, host lookup, probe,
launcher and UI-model test; clang-format 19 on the changed files.
- **Windows MSVC 19.44** (binaries rebuilt, timestamps checked):
- preset `client-network`: 12/12;
- preset `quic`: 4/4.
- **Windows package:**
- `package-windows.ps1`: client-package CTest 12/12;
- `verify-windows-package.ps1` passed;
- `package-selftest.ps1`: 10 refusals, including the missing `msquic.dll` and the
dynamic-runtime image;
- `msquic.dll` imports only advapi32, bcrypt, crypt32, iphlpapi, kernel32, ncrypt, ntdll,
user32, winmm and ws2_32;
- two `-Clean` builds gave identical ZIPs (sha256 `aaabc228…312cb2`, identity
`g33e91458e7ee-dirty`), the same as the earlier incremental build.
- `evo-session-probe grants`, checked by hand:
- 8 grants, 1280 bytes, mode 0600;
- refuses an existing file, a lifetime under 60 s, a count over 64 and connect flags;
- `--serial` respected.
Not done:
- a GUI run against evolution-dev (the dev server still runs session v1 and the flag is
not in the dev manifest);
- ASan of the client remote test (msquic under sanitizers is still open);
- a clean-VM package run.