Bound engineering UI state and session events for M9.8b
This commit is contained in:
@@ -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