Bound engineering UI state and session events for M9.8b

This commit is contained in:
dingo
2026-10-02 08:22:25 -04:00
parent 22c7c341ce
commit a6e8094f57
20 changed files with 327 additions and 19 deletions
+22
View File
@@ -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.
+2 -1
View File
@@ -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
+35 -2
View File
@@ -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.