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 -3
View File
@@ -13,7 +13,7 @@ Requirements
------------
Windows 10 or 11, x64. No installer and no Visual C++ redistributable is needed:
the client uses the static Microsoft C++ runtime and only Windows system DLLs plus
the bundled SDL3.dll. Minimum hardware is not yet qualified.
the bundled SDL3.dll and msquic.dll. Minimum hardware is not yet qualified.
Running
-------
@@ -21,10 +21,14 @@ Extract the whole folder anywhere and run evo-client.exe. A launcher opens:
* Local fixture - an in-memory stand-in for an environment with static organisms.
It is not a server, not an ecosystem and not authoritative.
* Connect to a dev region - needs an endpoint, the server name, the dev CA file
* Connect to a dev region - needs an endpoint (default: the dev route,
void.aeternalisgames.com:7400, UDP), the server name, the dev CA file
(dev-ca.pem) and a grant bundle file. These are issued separately by the
development team and are never part of this package. Files are read when you
press Connect; nothing is saved. Do not share grant bundles.
press Connect; nothing is saved. Do not share grant bundles: each grant opens one
session, a bundle expires as a whole, and a second client using the same bundle
takes the session over. The view follows the region until you pan; then it
follows the camera (15 x 15 cells around it).
Controls (defaults, rebindable in Controls...): W A S D move, arrow keys pan,
mouse wheel zooms, left click selects, Tab toggles UI capture. Key names refer to
+4
View File
@@ -21,6 +21,10 @@ Mbed TLS (statically linked) Apache-2.0 (chosen from Apache-2.0 OR
GPL-2.0-or-later) LICENSES/MbedTLS.txt,
LICENSES/Apache-2.0.txt
MsQuic (msquic.dll) MIT License LICENSES/msquic.txt
Compiled into msquic.dll:
- OpenSSL (TLS 1.3 provider) Apache-2.0 LICENSES/OpenSSL.txt
Dear ImGui (statically linked) MIT License LICENSES/DearImGui.txt
- Embedded fonts ProggyClean and ProggyForever (MIT)
LICENSES/DearImGui-embedded-fonts.txt,
+13 -6
View File
@@ -12,23 +12,30 @@ $script:PackageFiles = @(
'LICENSES/DearImGui.txt',
'LICENSES/Khronos.txt',
'LICENSES/MbedTLS.txt',
'LICENSES/OpenSSL.txt',
'LICENSES/SDL3-hidapi.txt',
'LICENSES/SDL3-stb_image.txt',
'LICENSES/SDL3-yuv2rgb.txt',
'LICENSES/SDL3.txt',
'LICENSES/msquic.txt',
'README.txt',
'SDL3.dll',
'SHA256SUMS.txt',
'THIRD-PARTY-NOTICES.txt',
'evo-client.exe'
'evo-client.exe',
'msquic.dll'
)
# Imports allowed for the executables: Windows system DLLs and the bundled SDL3.dll.
# The C/C++ runtime is static (no MSVCP/VCRUNTIME/api-ms-win-crt/ucrtbase).
# Imports allowed for the executables: Windows system DLLs and the bundled SDL3.dll and
# msquic.dll (M10.5c). The C/C++ runtime is static (no MSVCP/VCRUNTIME/api-ms-win-crt/
# ucrtbase), in msquic.dll too.
$script:AllowedImports = @(
'advapi32.dll', 'bcrypt.dll', 'gdi32.dll', 'imm32.dll', 'kernel32.dll', 'ole32.dll',
'oleaut32.dll', 'sdl3.dll', 'setupapi.dll', 'shell32.dll', 'user32.dll', 'version.dll',
'winmm.dll', 'ws2_32.dll'
'advapi32.dll', 'bcrypt.dll', 'crypt32.dll', 'gdi32.dll', 'imm32.dll', 'iphlpapi.dll',
'kernel32.dll', 'msquic.dll', 'ncrypt.dll', 'ntdll.dll', 'ole32.dll', 'oleaut32.dll',
'sdl3.dll', 'setupapi.dll', 'shell32.dll', 'user32.dll', 'version.dll', 'winmm.dll',
'ws2_32.dll'
)
# Every shipped image whose imports are checked.
$script:PackageImages = @('evo-client.exe', 'SDL3.dll', 'msquic.dll')
function Get-Sha256([string]$Path) {
(Get-FileHash -Algorithm SHA256 -LiteralPath $Path).Hash.ToLowerInvariant()
+3 -2
View File
@@ -26,13 +26,14 @@ $secrets = { param($p) Assert-NoSecrets $p }
# Baseline: the untouched copy passes every guard.
Assert-PackageContent $Staged
Assert-NoSecrets $Staged
foreach ($binary in @('evo-client.exe', 'SDL3.dll')) { Assert-AllowedImports (Join-Path $Staged $binary) }
foreach ($binary in $script:PackageImages) { Assert-AllowedImports (Join-Path $Staged $binary) }
Expect-Refused 'extra file' { param($p) [IO.File]::WriteAllText((Join-Path $p 'notes.txt'), 'x', $utf8) } $content
Expect-Refused 'missing file' { param($p) Remove-Item -LiteralPath (Join-Path $p 'LICENSES\SDL3.txt') } $content
Expect-Refused 'missing msquic.dll' { param($p) Remove-Item -LiteralPath (Join-Path $p 'msquic.dll') } $content
Expect-Refused 'checksum mismatch' { param($p) [IO.File]::AppendAllText((Join-Path $p 'README.txt'), ' ', $utf8) } $content
Expect-Refused 'credential file type' { param($p) [IO.File]::WriteAllText((Join-Path $p 'dev-ca.pem'), 'x', $utf8) } $secrets
Expect-Refused 'grant bundle file type' { param($p) [IO.File]::WriteAllBytes((Join-Path $p 'client-grants.bin'), [byte[]]::new(108)) } $secrets
Expect-Refused 'grant bundle file type' { param($p) [IO.File]::WriteAllBytes((Join-Path $p 'client-grants.bin'), [byte[]]::new(160)) } $secrets
Expect-Refused 'private key text' {
param($p) [IO.File]::AppendAllText((Join-Path $p 'README.txt'),
"-----BEGIN EC PRIVATE KEY-----`nMHcCAQEEIBbF0p3l9QpKl2+abcdefghijklmnopqrstuvwxyzABCDEFG`n", $utf8) } $secrets
+16 -3
View File
@@ -59,6 +59,10 @@ $build = Join-Path $root 'build\client-package'
if ($Clean -and (Test-Path -LiteralPath $build)) { Remove-Item -LiteralPath $build -Recurse -Force }
$log = Join-Path $root 'build\client-package.log'
New-Item -ItemType Directory -Force (Split-Path -Parent $log) | Out-Null
# msquic builds OpenSSL with nmake, outside CMake's /Brepro (M10.5c): cl.exe also reads
# options from CL, and OpenSSL's build-date string honours SOURCE_DATE_EPOCH (commit time).
$env:CL = '/Brepro'
$env:SOURCE_DATE_EPOCH = "$epoch"
# A separate process (stderr in its own file): Windows PowerShell 5.1 would turn
# harmless native stderr lines into terminating errors here.
$check = Start-Process -FilePath 'powershell.exe' -NoNewWindow -Wait -PassThru `
@@ -68,7 +72,7 @@ $check = Start-Process -FilePath 'powershell.exe' -NoNewWindow -Wait -PassThru `
if ($check.ExitCode -ne 0) { throw "Package build or tests failed; see $log and $log.err" }
$summary = Select-String -LiteralPath $log -Pattern '(\d+)% tests passed, (\d+) tests failed out of (\d+)' | Select-Object -Last 1
if (!$summary -or $summary.Matches[0].Groups[2].Value -ne '0') { throw "No passing test summary in $log" }
$tests = "client-package CTest (labels client|network): $($summary.Matches[0].Groups[3].Value) passed, 0 failed"
$tests = "client-package CTest (labels client|network|quic-session): $($summary.Matches[0].Groups[3].Value) passed, 0 failed"
$exe = Join-Path $build 'evo-client.exe'
$version = (& $exe --version | Out-String).Trim()
@@ -88,10 +92,13 @@ $compiler = $matches[1]
$sdlVersion = Read-Pin 'sdl3-pin.cmake' 'EVO_SDL_VERSION'
$imguiVersion = Read-Pin 'imgui-pin.cmake' 'EVO_IMGUI_VERSION'
$mbedVersion = Read-Pin 'mbedtls-pin.cmake' 'EVO_MBEDTLS_VERSION'
$msquicVersion = Read-Pin 'msquic-pin.cmake' 'EVO_MSQUIC_VERSION'
$opensslVersion = Read-Pin 'msquic-pin.cmake' 'EVO_OPENSSL_VERSION'
$sdl = Join-Path $root "build\external\sdl3\SDL3-$sdlVersion"
$imgui = Join-Path $root "build\external\imgui\imgui-$imguiVersion"
$mbed = Join-Path $root "build\external\mbedtls\mbedtls-$mbedVersion"
foreach ($source in @($sdl, $imgui, $mbed)) {
$msquic = Join-Path $root "build\external\msquic\msquic-$msquicVersion"
foreach ($source in @($sdl, $imgui, $mbed, $msquic)) {
if (!(Test-Path -LiteralPath (Join-Path $source 'evo-verified.sha256'))) { throw "Unverified dependency source: $source" }
}
@@ -102,6 +109,7 @@ $licenses = Join-Path $stage 'LICENSES'
New-Item -ItemType Directory -Force $licenses | Out-Null
Copy-Item -LiteralPath $exe -Destination $stage
Copy-Item -LiteralPath (Join-Path $build 'SDL3.dll') -Destination $stage
Copy-Item -LiteralPath (Join-Path $build 'msquic.dll') -Destination $stage
# Repository templates are re-written with CRLF so checkout line-ending settings
# cannot change the package bytes.
Write-Text (Join-Path $stage 'THIRD-PARTY-NOTICES.txt') ([IO.File]::ReadAllLines((Join-Path $PSScriptRoot 'THIRD-PARTY-NOTICES.txt')))
@@ -127,6 +135,9 @@ Write-Text (Join-Path $licenses 'Khronos.txt') $khronosLines
Write-Text (Join-Path $licenses 'Apache-2.0.txt') (
Get-Block (Join-Path $mbed 'LICENSE') '^\s+Apache License\s*$' 'END OF TERMS AND CONDITIONS')
Copy-Item -LiteralPath (Join-Path $mbed 'LICENSE') -Destination (Join-Path $licenses 'MbedTLS.txt')
# msquic.dll (MIT) with OpenSSL (Apache-2.0) built static inside it (ADR-0090).
Copy-Item -LiteralPath (Join-Path $msquic 'LICENSE') -Destination (Join-Path $licenses 'msquic.txt')
Copy-Item -LiteralPath (Join-Path $msquic 'submodules\openssl\LICENSE.txt') -Destination (Join-Path $licenses 'OpenSSL.txt')
Copy-Item -LiteralPath (Join-Path $imgui 'LICENSE.txt') -Destination (Join-Path $licenses 'DearImGui.txt')
Copy-Item -LiteralPath (Join-Path $imgui 'docs\FONTS.md') -Destination (Join-Path $licenses 'DearImGui-FONTS.md')
$draw = Join-Path $imgui 'imgui_draw.cpp'
@@ -159,6 +170,8 @@ Write-Text (Join-Path $stage 'BUILD-INFO.txt') @(
"sdl3: $sdlVersion sha256=$(& $pin 'sdl3-pin.cmake' 'EVO_SDL_SHA256')",
"dear_imgui: $imguiVersion sha256=$(& $pin 'imgui-pin.cmake' 'EVO_IMGUI_SHA256')",
"mbedtls: $mbedVersion sha256=$(& $pin 'mbedtls-pin.cmake' 'EVO_MBEDTLS_SHA256')",
"msquic: $msquicVersion sha256=$(& $pin 'msquic-pin.cmake' 'EVO_MSQUIC_SHA256')",
"openssl: $opensslVersion sha256=$(& $pin 'msquic-pin.cmake' 'EVO_OPENSSL_SHA256')",
"tests: $tests",
"version_output: $version")
@@ -169,7 +182,7 @@ $sums = foreach ($relative in (Get-RelativeFiles $stage)) {
Assert-PackageContent $stage
Assert-NoSecrets $stage
foreach ($binary in @('evo-client.exe', 'SDL3.dll')) { Assert-AllowedImports (Join-Path $stage $binary) }
foreach ($binary in $script:PackageImages) { Assert-AllowedImports (Join-Path $stage $binary) }
# Deterministic ZIP: sorted entries under one top folder, commit time stamps.
Add-Type -AssemblyName System.IO.Compression
+1 -1
View File
@@ -23,7 +23,7 @@ try {
$folder = $top[0].FullName
Assert-PackageContent $folder
Assert-NoSecrets $folder
foreach ($binary in @('evo-client.exe', 'SDL3.dll')) { Assert-AllowedImports (Join-Path $folder $binary) }
foreach ($binary in $script:PackageImages) { Assert-AllowedImports (Join-Path $folder $binary) }
$identity = ([IO.File]::ReadAllLines((Join-Path $folder 'BUILD-INFO.txt')) | Where-Object { $_ -like 'identity: *' }) -replace '^identity: ', ''
if ($top[0].Name -ne "evo-client-windows-x64-$identity") { throw 'Folder name does not match BUILD-INFO identity' }