feat(client): add liquid presentation and clearer cellular HUD
Foundation / checks (checks) (push) Successful in 5s
Foundation / checks (client) (push) Successful in 5s
Foundation / checks (ecs) (push) Successful in 4s
Foundation / checks (network) (push) Successful in 4s
Foundation / checks (postgres) (push) Successful in 4s
Foundation / checks (tsan) (push) Successful in 4s
Foundation / checks (deploy) (push) Successful in 4m32s
Foundation / postgres-tools (push) Successful in 26s
Foundation / server-image (push) Successful in 4m11s
Foundation / image (push) Successful in 4m36s

This commit is contained in:
dingo
2026-10-22 09:08:03 -04:00
parent c43a3b0837
commit 8ce609d344
12 changed files with 596 additions and 94 deletions
+11 -1
View File
@@ -88,7 +88,7 @@ provision a region.
Sent/admitted are distinct from committed. A committed engulf/bud intention
does not itself prove biological success; the tick feedback reports its effect.
The dark teal UI uses the existing embedded scalable font. At narrow sizes the
The blue-green UI uses the existing embedded scalable font. At narrow sizes the
Evolution panel becomes the **Life** tab; panels remain within the viewport and
scroll vertically. Existing Ctrl+= / Ctrl+- scaling and rebindable movement apply.
Food patches have a thin contact boundary and a stock marker, with amber for the
@@ -212,3 +212,13 @@ unload behavior and qualification evidence are documented in VALIDATION.md.
Headless defaults keep both `EVO_BUILD_CLIENT` and `EVO_BUILD_CLIENT_PROBE` OFF.
No prepared SDL sources, display or client runtime are needed for `evo-sim` or
server tests. No Kubernetes deployment change belongs to this desktop gate.
## 2026-10-22 liquid presentation
[The native visual refresh](CLIENT_VISUAL_REFRESH.md) adds blue-green optical
texture, flowing current ribbons, nutrient silhouettes, thin pool membranes,
a shared brighter cell palette and colored action buttons. Field notes, Vitals
and Nearby can minimize and restore. Nearby is a camera-centred map of received
observations with a local-axis compass; it never reveals hidden food. Temperature
readouts remain explicitly unavailable until phase 3 and a session contract carry
real body/ambient observations. No simulation or protocol version changes.
+84
View File
@@ -0,0 +1,84 @@
# Cellular liquid presentation refresh
Scope: native client presentation, 2026-10-22, requested by the maintainer using
the screenshots, two recordings and visual references in `Aevolution-Client-SS`.
This is a procedural first pass using the existing SDL3/ImGui renderer, not the
photorealistic lighting of the reference images. No asset or runtime dependency
is added. Headless libraries, biological rules, persistence and wire formats are
unchanged.
## Visual language
- Blue-green liquid illumination replaces the black eyepiece interior. A fixed
caustic mesh gives optical texture; it carries no environmental measurement.
Current ribbons and travelling highlights follow the replicated flow field.
A maximum 30 by 30 sample grid bounds cost even in a tall viewport.
- Nutrients keep their established colors and gain distinct silhouettes: gold
lobes for energy, umber facets for carbon, blue vesicles for nitrogen, rose
rosettes for phosphorus, pale angular fragments for other matter. These are
readable symbols, not asserted chemical structures. At very small sizes they
simplify to solid marks. The legend uses the same shapes.
- Pools have a thin circular membrane on their contact disc, containing those
same nutrient symbols. A zero channel emits no shapes. Entire deposits remain
owned and removed by the server; the client does not consume or split them.
The decorative membrane neither blocks a cell nor changes collision geometry.
- All living cells share cyan membranes, translucent cytoplasm, amber metabolic
organelles and a violet centre. Wall thickness, motility, conversion and green
producer organelles retain their existing phenotype mappings. The viewer's
own cell has only its existing focus ring, not a different biological palette.
Dead cells keep their broken outline; stale scenes freeze cosmetic motion and
dim observed objects.
## Controls and navigation
Buttons share a rounded, bordered treatment with distinct hover, pressed and
disabled states. The action dock uses mint for feeding, blue for engulfing and
violet for budding. Labels and authoritative enable/disable logic remain intact;
color alone does not communicate affordability or success. Existing bindings
remain authoritative; decorative shortcut numbers are not invented.
Field notes, Vitals and Nearby have explicit minus/plus buttons. Collapsing
Vitals retains energy. State lasts for the client session; it is not saved.
The responsive compact layout keeps the dock and map within the viewport.
Nearby is a camera-centred observation map with a fixed six-millimetre radius.
It reads the received food and organism views only, including observations
outside the viewport. Empty space means unknown, not confirmed empty. Rings
denote pools, dots nutrients and triangles cells; the controlled cell has a ring.
The compass labels local +Y/-Y and +X/-X, consistent with the camera. Planetary
north and a global explored-world map have not been defined by this gate.
Disconnected data is explicitly stale. The map is read-only and cannot issue
movement or reveal unobserved resources.
## Temperature contract gap and proposed follow-up
Inspection found an architectural dependency: session v13 has reserves, motion,
currents and observed food, but no body or ambient temperature observations.
[ADR-0178](../adr/0178-durable-liquid-region.md) and phase 3 of the
[region/movement plan](../../Cellular_Region_Movement_Plan.md) explicitly leave
the thermal field and per-cell thermal state pending. A client-only gradient
or body temperature would fabricate game state. Implementation of that affected
feature stops here.
Vitals reserves a `Body -- / Water --` readout with an explanation on hover.
No heat colors, danger thresholds or warmer/colder arrows are emitted.
Proposed resolution, not an accepted protocol or biological rule:
1. Complete phase 3's authoritative body/ambient model and its versioned
persistence/replay contract.
2. Add bounded, perception-filtered body and local ambient temperatures with
units, freshness and availability to a new negotiated session version.
3. Define the spatial sampling distance and visible-neighbour coverage for
warmer/colder guidance. No client extrapolation into hidden regions.
4. Render measured body/water values and a separate thermal overlay. A direction
arrow requires sufficient current samples; equal, missing or stale samples
suppress it. Comfort and harm use observed phenotype limits, not UI constants.
## Validation
The native panel suite exercises multiple sizes, collapse/restore and input
capture alongside existing mutation, affordability and action tests. See
[VALIDATION](VALIDATION.md) for executed builds, screenshots and environmental
limits. The supplied reference art is design input, not a runtime asset or a
claim of achieved photorealism.
+51
View File
@@ -10127,3 +10127,54 @@ changes; CMake/CTest, clang-format, clang-tidy, and sanitizers are not applicabl
to this prose addition and were not run. Design viability and balance remain
unqualified. The AGENTS.md-required pre-push window update is desired Git
configuration only, not a deployment.
## 2026-10-22 - Native liquid UI refresh
Scope: `apps/evo-client` scene/HUD, the private platform theme, and native panel
regressions. See [visual design and the thermal contract gap](CLIENT_VISUAL_REFRESH.md).
No biological, persistence or wire version changed. Existing unrelated drafts and
server work were preserved.
Executed:
- MSVC 19.44 / toolset 14.44, Release with NDEBUG: configured/built `client` and
`client-network` through `tools/windows-check.ps1`. Client CTest 10/10; final
`client-network` CTest 18/18 with local loopback access outside the sandbox.
- Ubuntu/WSL Clang 19: configured from the `client` preset in `build/m12-ui-clang`
with `EVO_ENABLE_TIDY=ON`, built all client preset targets, CTest client label
10/10. Changed production sources and panel tests passed clang-tidy with warnings
as errors. Xvfb/X11 lifecycle executable exited 0.
- `asan` preset in `build/client-asan`, client enabled: rebuilt client, panel and
lifecycle targets; ASan+UBSan panel, lifecycle and smoke CTests 3/3.
- clang-format-19 dry-run with `--Werror` passed for the five changed C++ files.
- Production panel renderer exercised at 640x480, 960x640 and 1280x800: window
bounds, non-overlap with the action dock, minimize/restore with input capture,
and existing hover/mutation/affordability/bud/restart paths. World draw-list
checks verify each nutrient disappears independently at zero and stale food
retains dimmed silhouettes. No golden or simulation version was changed.
- Native BMP review frames (including Evolution and death) were generated in
ignored `build/ui-review/final` and visually inspected. The final fixture cell
was moved clear of HUD panels and its pool stocked to inspect the new shapes;
the panel suite was rerun after that fixture-only adjustment. These images
are local fixtures, not a live DEV session or performance benchmark.
Environmental limits and initial failures:
- Windows tests initially could not save bindings in the sandbox's default temp
directory. Setting TMP and TEMP to `build/ui-review/tmp` resolved both bindings
and control-save checks.
- The sandboxed network run was 13/18: five loopback connection tests could not
establish sessions. The same final production build passed all 18 outside the
sandbox. No production endpoint or World0 was contacted by those checks.
- Physical DPI, GPU rendering, motion comfort, accessibility and low-spec frame
cost still require interactive hardware review. This procedural rendering does
not implement the photographic lighting/blur of the supplied concept images.
- Two local MP4s were reviewed through sampled frame sheets. An imageio-ffmpeg
decoder was installed only in ignored `build/ui-review-tools` for that analysis;
it is not a repository or client dependency.
- Body/ambient readings and thermal direction remain unavailable because session
v13 carries neither. The UI shows dashes and explains the missing observations;
the proposed phase-3 follow-up is documented rather than fabricated client state.
The AGENTS.md-required pre-push session-window refresh is desired Git configuration
only. No deployment, live reachability, World0 mutation or world reset is claimed.