Files
aevolution/docs/architecture/OPEN_QUESTIONS.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

4.6 KiB

Design decision register

All recommendations below are reviewable, not silent product decisions. Owner means the engineering/design role accountable at the gate, not an assigned person. ADR indexes distinguish scoped proof choices from production proposals.

# Open question Current position / experiment Owner; gate
1 Tick frequency 20Hz proof only; measure latency, CPU, stiff biology Simulation/network; before M7/M10
2 Fixed/variable boundaries Fixed authoritative ticks, host wall-clock pacing; ecology integer multiples Simulation; M1
3 ECS Bounded component store proof; compare EnTT/Flecs realistic iteration Engine; M1
4 Dependency manager Evaluate vcpkg manifest vs Conan; no runtime dependency for proof Build; first dependency
5 Units library Minimal explicit integer wrappers now; evaluate dimensional library before biology Simulation; M2
6 Determinism Exact integer proof; physics separately scoped Simulation; each system ADR
7 Mutation generation Seeded context-conditioned candidates with validated prerequisites Biology/design; M3/M11
8 Genome representation Immutable versioned developmental capabilities, not DNA Biology; M3
9 Developmental body Typed body graph proposal Biology/engine; M13
10 Heredity/reproductive mutation Preserve ancestry, define mutation budget and costs Biology/design; M3/M11
11 NPC mutation Undecided; no silent autonomous divergence Biology/design; M12
12 Species/speciation Derived classifications; no class mechanics Biology/design; M12
13 Lineage extinction Need world-wide no-living/no-viable-reserve evidence Ecology; M4/M12
14 Offline state Park without any progression; disconnect fairness unresolved Design/security; before player persistence
15 Multicellular transition Physiological and ecological criteria unresolved Design/biology; M14
16 Population abstraction Conservative cohort ledger + distributions, ensemble validation Ecology; M4
17 Region dimensions Benchmark against interest, entities and migration overhead Engine/platform; M7
18 Planet coordinates Hierarchical global address + local coordinates proposal World; M5/M13
19 Spherical voxels Prototype cubed sphere versus alternatives; no fixed topology yet World; M13
20 Voxel LOD Sparse procedural base, aggregate fields, active chunks World; M5/M13
21 Surface meshing Marching Cubes / Surface Nets / Dual Contouring comparison Render/world; M13
22 Hydrology Conserved regional reservoirs/flux before full flow physics World; M6/later R&D
23 Atmosphere Aggregate mass and species budgets; no global CFD promise Ecology/world; M12
24 Cross-region ownership Fenced leases + explicit handoff state machine Distributed systems; M7/M10
25 Reliability layer Evaluate secure datagram/reliable transports before bespoke reliability Network/security; M10
26 Serialization Local bounded binary proof; production schemas undecided Engine/platform; M7/M10
27 Snapshot/events Snapshot + deterministic replay batches + durable semantic history Persistence; M7
28 Recovery Committed contiguous replay range and unique epoch Persistence; M7/M8
29 Cross-version migration Clone, migrate, accelerated comparison, approved world barrier Simulation/platform; M7+
30 Steam identity Provider subject → internal account boundary Backend/security; before Steam
31 Friend recognition Separate social channel, no player/NPC labels Design; M11
32 Anti-cheat Authoritative outcomes plus authenticated bounded intentions Security; M10
33 AI behavior Shared intention interface; bounded deterministic controller Simulation; M2/M11
34 Evolvable behavior Undecided; intelligence not mandatory Biology/design; M12/R&D
35 Morphology limits Development graph validates material, attachment and capability Biology/design; M13
36 Procedural animation Isolated locomotion prototypes; no authored animation dependence Engine; M13
37 Retention Permanent genome ancestry; tiered replay/snapshots/backups Platform/design; M7/M8
38 DR objectives Propose measurable RPO/RTO, validate on actual storage/off-host target Platform; before World0

Additional blockers: actual host inventory, domain/TLS, registry and Git provider, storage class/backup destination, resource budgets, project licensing and World0 promotion approvers. None blocks a local dependency-free simulation proof.