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

30 lines
3.5 KiB
Markdown

# 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.