Files
aevolution/docs/adr/DEPENDENCY_EVALUATION.md
T
dingoandClaude Opus 5.5 8fbe093cc8 Implement M9.6 narrow secure dev-session protocol
Add protocol v1: versioned, bounded frames (Hello, Welcome, Intent,
IntentResult, environment/organism views, Close) carrying session, epoch
and commit watermark, with an explicit little-endian canonical codec, a
header-first FrameReader, seeded mutation tests and a libFuzzer target.
SessionAdmission enforces world/region scope, grant lifetime and skew,
single-use grants, one session per subject, epoch, replay, tick window
and per-session rate.

Dev identity is a 108-byte HMAC-SHA256 grant (PSA) that cannot be
created or verified outside the dev environment. Transport security is
TLS 1.3 only via pinned Mbed TLS 4.1.1 LTS with TLS 1.2, DTLS, tickets
and PSK compiled out, AEAD suites, ECDHE groups and a pinned dev CA.
Opt-in EVO_BUILD_NETWORK, new network CI suite. Sockets and region
integration follow in M9.7. ADR-0082 records the decision.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 18:53:55 -04:00

2.9 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)
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.