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
+21 -8
View File
@@ -1,10 +1,14 @@
# ADR-0084: Engineering UI toolkit and ownership boundary
## Status
Proposed, 2026-10-02. User authorized evaluating/adopting a maintained framework.
Preferred candidate: Dear ImGui for the engineering client only. Adoption requires
an exact source pin, licence inventory and Windows/Linux compatibility probe in
M9.8a. No dependency has been added by this ADR. Final player UI remains undecided.
Accepted for the isolated M9.8a engineering UI probe, 2026-10-02. User delegated
UI selection. Dear ImGui 1.92.9b, MIT, upstream commit
`f1cc2ae15e53a861a874c3034aae6798fde194ab`; archive SHA-256
`21d8a0a565e85dce943e375db00812c2f3f0ab21f3f0f7964e364a63422d7f99`.
Published 2026-07-31; upstream latest-release API and tag checked 2026-10-02.
Checksum is locally measured over the upstream HTTPS archive, not an independent
signature. The pin is in tools/imgui-pin.cmake. Broader application integration
follows the probe. Final player UI remains undecided.
## Context
M9.4/M9.5 intentionally used rectangles and unlabelled gauges. M9.8 now requires
@@ -12,7 +16,7 @@ readable text, a launcher, dialogs, dismissible notifications, click selection a
control rebinding. The existing client uses SDL3 and SDL_Renderer. The headless
libraries and immutable biological views must remain toolkit-independent.
## Decision proposed
## Decision
Use Dear ImGui's upstream SDL3 platform and SDL_Renderer3 rendering adapters behind
the private native client boundary. Implement owned application state for toasts,
selection, dialogs and action bindings; do not equate toolkit widget state with
@@ -57,12 +61,21 @@ segment, not inferred from this high-level comparison.
## Consequences
Revisits ADR-0081's scoped decision to defer ImGui once labelled engineering UI is
needed. M9.8a must change this status to accepted only with the pin and probe evidence.
needed. M9.8a records the pin and executed probe evidence in VALIDATION.md.
M9.8 delivery is tracked in ../engineering/M9_8_DELIVERY_PLAN.md.
## Primary-source evidence reviewed 2026-10-02
- https://github.com/ocornut/imgui/blob/master/docs/BACKENDS.md — upstream SDL3 and SDL_Renderer3 adapters; platform/render separation.
- https://github.com/ocornut/imgui/blob/master/LICENSE.txt — MIT licence; pin-time notice audit still required.
- https://github.com/ocornut/imgui/blob/master/LICENSE.txt — MIT licence; notice inventory in third_party/imgui/README.md.
- https://github.com/ocornut/imgui/blob/master/docs/FAQ.md — input capture guidance and integration responsibilities.
- https://github.com/ocornut/imgui/releases — release/maintenance evidence; no version selected here.
- https://github.com/ocornut/imgui/releases — release/maintenance evidence; v1.92.9b selected above.
- https://mikke89.github.io/RmlUiDoc/pages/cpp_manual/integrating.html — context and rendering integration requirements for the alternative.
The probe compiles core, draw, tables, widgets and the SDL3/SDL_Renderer3 backends;
no demo, docking, multi-viewport, FreeType or external font dependency is introduced.
Use the embedded ProggyClean bitmap font explicitly for the probe. Retain LICENSE.txt,
docs/FONTS.md, imgui_draw.cpp and the stb headers' embedded notices at
packaging. The bundled ProggyForever data also carries notices in imgui_draw.cpp;
include the source notice inventory even when that font is not selected.
Normal headless/client configuration does not require ImGui until explicitly enabled.
+1 -1
View File
@@ -96,4 +96,4 @@ design. No unadopted candidate is a link dependency of the proof.
- [ADR-0082: Dev session transport](0082-dev-session-transport.md) - TLS 1.3-only Mbed TLS 4.1.1 LTS (pinned, compiled-down), dev-only HMAC grants, versioned bounded protocol v1 and session admission for M9.
- [ADR-0083: Dev region sessions](0083-dev-region-sessions.md) - session server in evo-server, durable no-effect intentions on synthetic carriers, empty organism presentation, reconnect with fresh baselines, loopback-only drill-time dev deployment.
- [ADR-0084: Engineering UI toolkit](0084-engineering-ui-toolkit.md) - proposed Dear ImGui boundary; adoption waits for the exact pin and compatibility probe.
- [ADR-0084: Engineering UI toolkit](0084-engineering-ui-toolkit.md) - accepted for the isolated M9.8a Dear ImGui 1.92.9b compatibility probe; application UI follows.