Bound engineering UI state and session events for M9.8b
This commit is contained in:
+3
-1
@@ -455,7 +455,9 @@ terrain meshing or procedural creature animation is required.
|
||||
| 9.8 Validate presentation and package the client | tools/client packaging, tests/client, docs/engineering | 9.1-9.7 | Reproducible native artifact, bounded snapshot/render queues, frame/memory report and documented manual visual checks | Install/run on supported dev platforms; long session, resolution/DPI matrix, headless regression suite | Declaring FUN or multiplayer scalability from a viewer |
|
||||
|
||||
**M9.8a (2026-10-02):** isolated Dear ImGui 1.92.9b probe qualified on Windows/Linux;
|
||||
application UI integration remains next. ADR-0084 is accepted for this probe.
|
||||
M9.8b adds bounded UI state, protected external input capture and bounded session
|
||||
event delivery. Launcher and visible widget integration remain M9.8c. ADR-0084
|
||||
records both scopes.
|
||||
|
||||
**M9.8 planning (2026-10-02):** user-confirmed Windows ZIP, temporary Gitea Actions
|
||||
artifacts, labelled engineering UI/launcher and control rebinding. See the
|
||||
|
||||
+15
-1
@@ -1,6 +1,20 @@
|
||||
# Project status and next steps
|
||||
|
||||
## Current gate — 2026-10-01
|
||||
## Current gate - 2026-10-02
|
||||
|
||||
M9.8a: Dear ImGui 1.92.9b is pinned and qualified in an isolated Windows/Linux
|
||||
SDL3 probe (ADR-0084). M9.8b adds bounded notification/dialog state, protected
|
||||
external input capture and bounded session events with disconnect/drain/reconnect
|
||||
backpressure. Tests and limits are recorded in engineering/VALIDATION.md.
|
||||
|
||||
Next: M9.8c launcher, visible dialogs/toasts, labelled views and click selection.
|
||||
The client still displays the prior rectangle UI. Windows packages will be built
|
||||
locally until a Windows runner exists. Testing is internal; 172.10.1.160 is the
|
||||
RKE2 control-plane address. VM qualification and the cluster restart drill remain
|
||||
outstanding, as agreed. See engineering/M9_8_DELIVERY_PLAN.md.
|
||||
|
||||
## M9.7 delivered scope
|
||||
|
||||
|
||||
M9.7 connects the engineering client to an authoritative dev region
|
||||
([ADR-0083](adr/0083-dev-region-sessions.md),
|
||||
|
||||
@@ -79,3 +79,16 @@ docs/FONTS.md, imgui_draw.cpp and the stb headers' embedded notices at
|
||||
packaging. The bundled ProggyForever data also carries notices in imgui_draw.cpp;
|
||||
include the source notice inventory even when that font is not selected.
|
||||
Normal headless/client configuration does not require ImGui until explicitly enabled.
|
||||
|
||||
|
||||
## M9.8b application state contract
|
||||
Accepted for bounded toolkit-independent state. See
|
||||
[CLIENT_UI_STATE](../engineering/CLIENT_UI_STATE.md): eight notifications with
|
||||
240-byte text and explicit expiry/overflow; one id-matched modal. Input capture
|
||||
requested by an external UI cannot be disabled by the legacy Tab shortcut.
|
||||
Rendering and toolkit focus integration remain M9.8c.
|
||||
|
||||
SessionClient's local event delivery is capped at 1024, reserving room for all 256
|
||||
unresolved intentions plus loss/backpressure events. On backlog it disconnects,
|
||||
marks views stale and waits for the consumer to drain before reconnecting. Earlier
|
||||
queued outcomes are preserved. This changes no wire format or biological rules.
|
||||
|
||||
@@ -77,3 +77,11 @@ Failure tests inject actual SDL events, including foreign window IDs, with no
|
||||
test-only production hooks. Real device failures and physical DPI/input require
|
||||
manual hardware qualification at M9.8. The native client is opt-in and never
|
||||
enters a server container. Headless configuration does not prepare/load SDL.
|
||||
|
||||
|
||||
M9.8b adds [owned UI state](../engineering/CLIENT_UI_STATE.md): bounded notifications
|
||||
and one modal, independent of toolkit/render/simulation types. The native adapter
|
||||
protects externally requested capture from the legacy Tab shortcut. Session event
|
||||
backpressure preserves queued events, disconnects and resolves remaining local
|
||||
uncertainty as unknown, then waits for draining before reconnecting. This is not
|
||||
a durable outcome-history database. The launcher/visible widgets follow in M9.8c.
|
||||
|
||||
@@ -0,0 +1,22 @@
|
||||
# M9.8b UI state and event bounds
|
||||
|
||||
Owned, toolkit-independent state; all calls on the client main thread. No authority
|
||||
or simulation state. Time is explicit monotonic milliseconds supplied by the host.
|
||||
|
||||
Notifications: at most eight, text at most 240 bytes; reject invalid/oversized input,
|
||||
expire by deadline, dismiss by unique id. Overflow evicts oldest and increments a
|
||||
visible saturating counter. Notifications are not durable outcome history.
|
||||
Dialogs: one active modal, title at most 96 bytes and body at most 240; opening a
|
||||
second fails. Close requires the matching id so a stale click cannot close a newer
|
||||
dialog. IDs never wrap. No credentials or grant bytes enter display messages.
|
||||
|
||||
SessionClient keeps at most 1024 queued ClientEvents. At 766 regular events it emits
|
||||
a local backpressure event, disconnects, and has room for loss plus 256 unknown
|
||||
intentions. It preserves all previously queued events and pauses reconnect until
|
||||
take_events drains the queue. This is a local condition, not a protocol change.
|
||||
Unprocessed wire outcomes remain unknown, never assumed failed or committed.
|
||||
|
||||
The native adapter's externally requested capture cannot be disabled by the legacy
|
||||
Tab toggle. Releasing capture drains already queued input before new world actions.
|
||||
Rendering dialogs/toasts and wiring toolkit capture occur with the launcher in
|
||||
M9.8c; these contracts and their tests precede that integration.
|
||||
@@ -1,6 +1,7 @@
|
||||
# M9.8 delivery plan
|
||||
|
||||
Status: M9.8a isolated toolkit probe complete, 2026-10-02; remaining segments planned.
|
||||
Status: M9.8a probe and M9.8b owned state/capture/event bounds complete, 2026-10-02;
|
||||
remaining segments planned.
|
||||
No application UI or deployment completion is claimed. See ADR-0084 for the toolkit boundary.
|
||||
|
||||
## Confirmed scope
|
||||
|
||||
@@ -3566,7 +3566,7 @@ were not rebuilt; equivalent regressions above replace them. The `ci-client` Doc
|
||||
image and Gitea pipeline were not rerun here, and no cluster operation was performed.
|
||||
|
||||
|
||||
## 2026-10-02 — consumed-grant ledger follow-up corrections
|
||||
## 2026-10-02 — consumed-grant ledger follow-up corrections
|
||||
|
||||
Resolved the two c588be2 review findings. Ledger open now acquires a nonblocking
|
||||
exclusive lifetime lock on a stable sibling file before reading or compacting
|
||||
@@ -3604,7 +3604,7 @@ repository-relative links and git diff --check. Documentation only: no code test
|
||||
package build, runner execution, endpoint verification or deployment performed.
|
||||
|
||||
|
||||
## 2026-10-02 — M9.8a pinned engineering UI probe
|
||||
## 2026-10-02 — M9.8a pinned engineering UI probe
|
||||
|
||||
Adopted Dear ImGui 1.92.9b for an isolated SDL3/SDL_Renderer3 compatibility probe;
|
||||
normal client/headless builds do not require it. Exact upstream commit, locally
|
||||
@@ -3637,3 +3637,36 @@ explicitly deferred; control-plane IP is not assumed to be a MetalLB endpoint.
|
||||
Not run: Docker/Gitea image execution, physical GPU/DPI matrix, VM soak, client UI
|
||||
integration/launcher or packaging acceptance. Existing network and headless simulation
|
||||
behavior is unchanged; no simulation version or golden was modified.
|
||||
|
||||
|
||||
## 2026-10-02 — M9.8b owned UI state and bounded session events
|
||||
|
||||
Implemented toolkit-independent UiState: eight expiring/dismissible notices,
|
||||
240-byte messages, an observable eviction count, one id-matched modal and explicit
|
||||
monotonic time. Tests cover 10000-notice bursts, expiry boundary, malformed/oversized
|
||||
messages, stale time, deadline overflow, modal contention and stale close IDs.
|
||||
External native UI capture can no longer be escaped through the legacy Tab toggle.
|
||||
|
||||
SessionClient queues at most 1024 events, reserves loss/unknown capacity, preserves
|
||||
queued results, and disconnects on backlog until take_events drains it. The burst
|
||||
regression accounts for every sent intention as a rejection or unknown, proves no
|
||||
grant burning while paused and confirms reconnect after drain. Backpressure is a
|
||||
local event, not a new wire message or simulation rule. Presets and the selective
|
||||
Docker client targets include the new UI state test executable.
|
||||
|
||||
Executed: Windows MSVC client-network configure/build/CTest 7/7; Linux GCC targeted
|
||||
UI-state/network/native-lifecycle tests 3/3; Clang ASan/UBSan UI-state/network 2/2.
|
||||
Static analysis initially flagged the new test main's escaping exception; added the
|
||||
same process error boundary used by other executables. Windows exposed a timing
|
||||
assumption in the initial one-message-per-sleep burst test; bounded batches replaced
|
||||
that dependency. The explicit-target Windows preset initially omitted the new test
|
||||
binary; fixed its target list and reran all seven tests successfully.
|
||||
|
||||
Visible dialogs/toasts, launcher and toolkit focus routing remain M9.8c. These are
|
||||
owned state and adapter contracts, not a claim of finished UI. No Docker/Gitea run,
|
||||
VM qualification, live cluster test, packaging or deployment was performed.
|
||||
|
||||
Final additional checks: Linux GCC state/network/lifecycle 3/3; Clang ASan/UBSan
|
||||
native lifecycle 1/1; clang-tidy19 on owned state/session implementation,
|
||||
state/network tests and native adapter/lifecycle tests passed with no owned
|
||||
diagnostics. Final changed-file formatting passed.
|
||||
|
||||
Reference in New Issue
Block a user