Foundation / checks (client) (push) Successful in 4s
Foundation / checks (checks) (push) Successful in 4s
Foundation / checks (ecs) (push) Successful in 5s
Foundation / checks (postgres) (push) Successful in 5s
Foundation / checks (network) (push) Successful in 5s
Foundation / checks (tsan) (push) Successful in 5s
Foundation / checks (deploy) (push) Successful in 3m44s
Foundation / postgres-tools (push) Successful in 5s
Foundation / server-image (push) Successful in 5s
Foundation / image (push) Successful in 5s
6.5 KiB
6.5 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 and biological rate units | 50 ms (20 Hz) remains the ratified M10 engineering tick. Maintainer ratified time-based biological rates on 2026-10-04: M11.1 will convert rates deterministically at each tick and migrate per-tick genome/checkpoint fields with explicit units, precision, remainder/rounding and overflow bounds, plus 50 ms regression evidence (ADR-0089). | Biology/design; M11.1 migration |
| 2 | Fixed/variable boundaries | Fixed authoritative ticks, host wall-clock pacing; ecology integer multiples | Simulation; M1 |
| 3 | ECS | Row/EnTT4 experiment in ADR-0021; retain bounded rows for proof, production choice awaits richer workloads (Flecs remains an alternative) | Engine; M1 and biological component gate |
| 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. M11: earned during life, offered from seeded candidates and applied through funded development (ADR-0098); candidate count and the eligibility trigger come in 11.4's contract | 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 | ADR-0163 accepts structural traits expressed in offspring and a one-way birth-time parent/child control choice. NPC parent retains its body, reproductive plan and established behavior. Implementation and per-operator timing pending; exact-copy M11 is the current baseline. Recombination stays open | Biology/design; versioned inheritance/control implementation |
| 11 | NPC mutation | Explicitly deferred in M12.1; retain M11 exact-copy budding, no silent autonomous divergence (ADR-0133) | Biology/design; future funded mutation and ensemble gate |
| 12 | Species/speciation | Optional derived versioned classification; classifier/threshold deferred, no class mechanics (ADR-0133) | Biology/design; M12/future classifier gate |
| 13 | Lineage extinction | ADR-0133 scopes evidence across living, suspended, viable reserves and transfers; incomplete viability is unknown, world reconciliation unimplemented | Ecology; M12.7 |
| 14 | Offline state | M11 (ADR-0098): biology freezes at once on logout or a detected disconnect; the organism lingers in the world, frozen but vulnerable (tunable, 10 s), then suspends durably; resume in place or at the nearest valid spot within a bounded radius, else it stays suspended. How long suspension is retained stays open | 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 | M5.1 bounded local integer contract accepted (ADR-0042); global hierarchy remains proposed | 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 | Deferred explicitly for M11 (ADR-0098); revisit after the 11.9 playtests. No player/NPC labels | Design; after M11.9 |
| 32 | Anti-cheat | Authoritative outcomes plus authenticated bounded intentions | Security; M10 |
| 33 | AI behavior | Shared intention interface; bounded deterministic controller. M11 wildlife uses the same intentions as players, with no special biological rules (ADR-0098) | Simulation; M2/M11 |
| 34 | Evolvable behavior | ADR-0163 requires the relinquished NPC parent to continue established behavior; bounded persistent representation remains to implement. General heritable/evolving behavior and learning remain deferred, intelligence not mandatory (ADR-0133) | Biology/design; retained NPC behavior and later heritable-state 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 | Dev/stage ratified (ADR-0075: worker loss RPO 0, RTO <= 60 s; host loss = explicit rewind to last verified bundle). World0 requires acknowledged outcomes durable in an independent failure domain before ACK; launch blocked until then | 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.