Upgrade cellular client to v10 with readable play and assisted steering

This commit is contained in:
dingo
2026-10-14 19:53:28 -04:00
parent 75b8bbb333
commit 68958a9e54
21 changed files with 1603 additions and 93 deletions
+36
View File
@@ -1,5 +1,41 @@
# M9.8b/c UI state, launcher and event bounds
## Cellular v10 application state
`apps/evo-client/cellular_play.hpp` owns toolkit-independent presentation state:
the current owner life/offer, latest death notice, one outstanding discrete action,
and at most eight completed or unresolved records. It never changes biology.
Receipts are admission only; outcomes settle a request. A refused retry cannot
disprove a lost original reply. Mutation `not_ready` may mean an uncertain durable
reservation, so it remains unresolved. IDs never wrap; stale offers, dead lives,
unfresh sessions and duplicate clicks cannot submit new choices.
Reconnect drops the offer until a fresh owner view, cancels unsent queued actions,
and retains sent requests for reconciliation. Life changes cannot carry a queued
action to the new life. Delayed final replies can update retained unknown records.
New lives receive new birth request IDs; retries of an outstanding birth keep its
ID. Death messages are deduplicated so a retained notice cannot end a later life.
Meaningful engulf/bud diagnostics retain their observed tick and reset on life
change. UI does not infer action success from a receipt, empty view or vanished offer.
`cellular_controls.hpp` selects only stocked patches in observed contact, scales
movement intentions for speed/precision/food assistance, and compares every mutation
cost channel with the displayed reserve. `cellular_scene.hpp` renders each patch
in at most three clipped rectangles; the application reserves that worst-case
budget before drawing organisms. No dependency or simulation rule changes.
The v10 panels consume this state and return actions; the app owns session sends.
Cell/Food/Log tabs and a separate Evolution panel replace the default engineering
panels in cellular mode. A narrow viewport moves evolution to a Life tab. Log can
show the existing engineering panels. The existing platform adapter owns the
palette, rounded geometry, embedded font and input capture. `client-ui-model`,
`client-remote-session` and `client-panels` exercise state, loopback v10 delivery,
production widget clicks, duplicate suppression and bounded layout under NDEBUG.
`evo-client-panel-tests OUTPUT_DIRECTORY` additionally saves actual rendered
review BMPs at 640x480, 960x640 and 1280x800, including the death screen; those use
explicit test presentation values and are not evidence of a live DEV playtest.
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.