Qualify pinned Dear ImGui toolkit for M9.8a

This commit is contained in:
dingo
2026-10-02 07:53:17 -04:00
parent 4d6a2b6d83
commit 22c7c341ce
16 changed files with 293 additions and 20 deletions
+7 -5
View File
@@ -1,7 +1,7 @@
# M9.8 delivery plan
Status: planned; user choices recorded 2026-10-02. No implementation or deployment
is claimed by this document. See ADR-0084 for the proposed UI toolkit boundary.
Status: M9.8a isolated toolkit probe complete, 2026-10-02; remaining segments planned.
No application UI or deployment completion is claimed. See ADR-0084 for the toolkit boundary.
## Confirmed scope
@@ -21,7 +21,8 @@ is claimed by this document. See ADR-0084 for the proposed UI toolkit boundary.
qualification can complete independently; M9's live-deployment evidence remains open.
- Cluster uses MetalLB and nginx. User reports 172.10.1.160 reachable from the
development machine, with deployment through existing Gitea/GitOps machinery.
Whether this address belongs to a node or the ingress service is unconfirmed.
This is the RKE2 control-plane address, not a confirmed MetalLB service address.
Testing is internal from the development machine for now.
- Available DNS names: sys, void, srs, cloud, assets under aeternalisgames.com.
No assignment or route is implemented. Proposed dev session name: void; proposed
future download name: assets. DNS existence is not evidence of service reachability.
@@ -56,10 +57,11 @@ All selected biological data remains a read-only presentation copy.
## Infrastructure and packaging decisions still needed
- Windows runner label/toolchain availability. Do not silently route a Windows
- No Windows runner exists yet (confirmed 2026-10-02). Local builds are the initial path. Do not silently route a Windows
package job to the existing Linux runner or assume an untested cross-compile.
The packaging script can run on the existing Windows development host meanwhile.
- Exact role of 172.10.1.160, nginx implementation/configuration, exposed TCP port,
- Confirmed control plane: 172.10.1.160. Still needed for direct service routing:
nginx implementation/configuration, exposed TCP port,
source restrictions and certificate name. The protocol is TLS/TCP, not HTTP;
a standard HTTP Ingress rule does not implement it. Port-forward remains supported.
- VM specification and whether graphics acceleration is available. Hardware-specific
+35
View File
@@ -3602,3 +3602,38 @@ in M9_8_DELIVERY_PLAN.md. ADR-0084 proposes the UI boundary and comparison; no l
version or dependency was adopted. Reviewed upstream toolkit documentation, checked
repository-relative links and git diff --check. Documentation only: no code tests,
package build, runner execution, endpoint verification or deployment performed.
## 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
measured archive checksum, maintenance and notice evidence are in ADR-0084 and
third_party/imgui/README.md. No upstream code modified. Embedded bitmap font used;
no extra font dependency. Source preparation is explicit, with hash verification.
Executed: Windows MSVC Release probe CTest 2/2; Linux GCC14 Release 2/2;
Clang19 ASan/UBSan 2/2 (including instrumented toolkit sources); real X11 software
renderer probes under Xvfb in Release and sanitizer builds. Three full SDL/UI
initialize/render/shutdown cycles per successful invocation. A synthetic press and
release activates a real widget exactly once; geometry bounds and pixel readback
are checked under NDEBUG. Invalid explicit renderer fails. This is synthetic input
and render evidence, not physical keyboard/DPI/accessibility acceptance.
clang-tidy19 on owned probe: no owned diagnostics; clang-format19 and CI selector
fixtures passed, including a new toolkit-pin selection case. Fresh headless configure
with client/network/probes off passed without evaluating SDL/ImGui dependencies.
An initial const mismatch with upstream's mutable draw API was corrected. Initial
static analysis used a GCC database with unsupported module flags; rerun against the
Clang database passed. Edited shell scripts were normalized to LF before selector
fixtures ran successfully.
Artifact observations: Windows Release probe EXE 398336 bytes, SDL3.dll 1998848;
Linux Release executable 1098464 bytes. These are probe totals, not a final client
package size or an incremental apples-to-apples benchmark. No minimum hardware,
frame-rate or accessibility claim yet. Low-spec VM pending; live cluster drill is
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.