Files
aevolution/docs/adr/DEPENDENCY_EVALUATION.md
T
dingoandClaude Opus 5 d5b4bd068e Initial commit: architecture docs and headless engineering proof
Aeternalis Evolution, a custom-engine persistent evolutionary MMO.

This first commit establishes the project skeleton:

- Architecture and design docs: project vision, system overview,
  engineering constitution, roadmap, 19 ADRs, and the simulation,
  world, network, persistence and infrastructure architectures.
- Headless engineering proof: deterministic synthetic particles,
  component lifecycle, explicit PRNG streams, canonical snapshots
  and restored execution.
- Build and tooling: CMake 3.28+ / Ninja presets, C++23 feature
  check, clang-format and clang-tidy config, format check script,
  Windows check script, and a Docker build context.
- Tests: unit tests, benchmarks, a snapshot fuzz target and CLI
  integration wiring.

No gameplay, renderer, network service or running deployment yet.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-14 15:44:41 -04:00

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