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
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:
@@ -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
|
||||
|
||||
@@ -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.
|
||||
|
||||
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user