Files
aevolution/docs/adr/DEPENDENCY_EVALUATION.md
dingoandClaude Opus 5.5 3c421cd0cf
Foundation / checks (deploy) (push) Successful in 5s
Foundation / checks (ecs) (push) Successful in 2m28s
Foundation / checks (network) (push) Successful in 8m16s
Foundation / checks (client) (push) Successful in 12m14s
Foundation / checks (tsan) (push) Successful in 7m50s
Foundation / checks (checks) (push) Successful in 31m45s
Foundation / postgres-tools (push) Canceled after 0s
Foundation / server-image (push) Canceled after 0s
Foundation / image (push) Canceled after 0s
Foundation / checks (postgres) (push) Canceled after 25m13s
Select and pin the M10.2 QUIC transport (msquic with OpenSSL)
ADR-0090 records the maintainer's selection of msquic 2.6.2 with OpenSSL 3.5.9 LTS
built from pinned, checksum-verified sources on Windows and Linux (plus the
xdp-for-windows headers msquic needs on Windows), the trust, threading and
channel model, and the known gap that OpenSSL's verifier also trusts its default
paths. Adds the opt-in quic preset, explicit preparation, and a loopback smoke
test (datagram, stream, untrusted CA and wrong name refused) passing on MSVC and
GCC. windows-check picks up newly installed Perl/NASM and pins cl.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-03 15:07:16 -04:00

3.5 KiB

Dependency evaluation

Initial primary-source evidence is linked in ADRs. No third-party runtime library is adopted by the proof. Recheck exact release/transitive licenses at adoption. Maintenance statements are shortlist evidence, not measured suitability.

Candidate Maintenance / portability / agent review Performance, size and complexity hypothesis License / disposition
CMake Published presets/CTest; native Windows/Linux; explicit graph Build tool, no runtime footprint BSD-3-Clause tool; adopted
vcpkg / Conan2 Documented baselines/locks; CMake+MSVC fit vs Python profiles Measure cold/warm/offline/cache correctness MIT tools; vcpkg proposed
Catch2 / Google Benchmark Upstream fixtures/releases/build docs; explicit familiar APIs More test compile time/size; no game runtime dependency BSL-1.0 / Apache-2.0; gate before M2
EnTT / Flecs Production/query docs; templates vs C/C++ DSL diagnostics Measure sparse/dense/churn/memory/build cost; no winner yet MIT; M1 experiment
Protobuf / FlatBuffers / Cap'n Proto Documented codegen/schema runtimes; generated API pins needed Allocation vs direct access, payload size/time and codegen work BSD-3-Clause / Apache-2.0 / MIT; deferred
spdlog Maintained sink/build APIs; owned adapter Async queues/format allocations/flush and binary cost MIT plus fmt obligations; deferred
libpqxx / libpq C++ RAII transactions vs C ownership; official DB docs Batch throughput/latency; never tick-path I/O BSD-3-Clause / PostgreSQL License; libpqxx proposed
NATS JetStream Upstream streams/consumer docs; C-client boundary Service RAM/disk/fan-out must justify broker Audit server/client release licenses; proposed
prometheus-cpp / Otel C++ Client vs broad SDK; upstream stability docs Export overhead/cardinality/size/failure measurement MIT / Apache-2.0; deferred
mp-units Modern dimensional APIs; test compiler diagnostics Compile time/binary footprint and conversion clarity MIT; deferred
Mbed TLS 4.1 LTS Supported to March 2029; CMake build without Perl/Python from release tarballs; PSA crypto API ~2.7 MB static archives (MSVC Release); TLS 1.2/DTLS/PSK/tickets compiled out Apache-2.0 OR GPL-2.0-or-later (Apache taken); adopted for M9 dev session only (ADR-0082)
msquic 2.6.2 + OpenSSL 3.5.9 LTS Microsoft, monthly releases (2.6.1 2026-08, 2.6.2 2026-09); OpenSSL 3.5 LTS; Windows and Linux from pinned source; Perl+NASM on Windows ~6.8 MB libmsquic.so with static TLS 1.3-only OpenSSL (Linux GCC Release); +~5 min clean build MIT / Apache-2.0; adopted for M10 transport (ADR-0090)
kustomize 5.8.1 kubernetes-sigs releases (5.8.0 2025-11, 5.8.1 2026-02, 5.8.2 2026-09); Linux x86_64 binary, checksum-verified CI-only tool, renders overlays for the policy check Apache-2.0; adopted for deploy policy (ADR-0088)
SplitMix64 algorithm Author's published fixed transition; explicit state Small constant work, 8-byte state; noncryptographic Reference attribution in ADR0007; proof only

Every experiment records version/hash, compiler/OS, representative workload, cold/warm build time, release binary size, allocations, peak/resident memory, median/tail runtime and failure behavior. Require both supported OS/compiler builds and sanitizers. Reject speed gains that obscure ownership/determinism, lose maintenance support or expand security/operations beyond demonstrated value. Neither library popularity nor a paper grants a license for the game itself.