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>
79 lines
4.5 KiB
Markdown
79 lines
4.5 KiB
Markdown
# Genome, development and phenotype
|
|
|
|
Status: locked separation and evolutionary intent; recommended schema; mutation
|
|
and morphology are experiments. No biology is implemented in the M0 proof.
|
|
|
|
```mermaid
|
|
flowchart LR
|
|
G[Immutable developmental genome] --> D[Versioned development]
|
|
E[Environment / resources / growth history] --> D
|
|
D --> P[Phenotype revision]
|
|
P --> C[Physical and biological components]
|
|
C --> S[Simulation]
|
|
S --> H[Reproduction / survival / history]
|
|
```
|
|
|
|
Genomes encode evolvable developmental capabilities, not literal DNA or an
|
|
Animal/Plant/Fungus inheritance hierarchy. Classification is derived. Capability
|
|
is distinct from realized structure: permitted armor still requires material and
|
|
energy. Reconstructible phenotype caches require retained developmental inputs,
|
|
including growth and damage history. Fitness is an outcome, not a power score.
|
|
|
|
| Proposed genome field | Invariant |
|
|
|---|---|
|
|
| genome_id | Immutable world-scoped identity, distinct from runtime entity ID |
|
|
| schema and development-rule versions | Explicit interpretation and migration boundaries |
|
|
| parents | Zero only for documented founder; one initially; possible multiple parents later |
|
|
| origin_event_id | Explains founder, mutation or reproduction origin |
|
|
| capabilities and parameters | Canonical typed records with units, ranges and prerequisites |
|
|
| content_digest | Integrity/deduplication aid; never merges distinct historical origins |
|
|
|
|
Founder admission is a world event with inventory debited from a documented
|
|
environmental or external genesis budget. Genome v0.1 covers energy conversion,
|
|
membrane, movement, ingestion, reproduction, target size and tolerances only.
|
|
|
|
| Contract | Required behavior |
|
|
|---|---|
|
|
| ValidateGenome | Reject unknown required capability, invalid range/dependency and cyclic development |
|
|
| PlanDevelopment | Return bounded construction plan and resource requirements from genome/growth/environment |
|
|
| ApplyDevelopment | Reserve resources; commit phenotype revision and matching transfers, or make no change |
|
|
| DerivePhenotype | Produce dimensioned mass, geometry, maintenance and enabled component descriptions |
|
|
| GenerateMutationCandidates | Genome + bounded recorded context + explicit stream/version → canonical candidates |
|
|
| SelectMutation | Revalidate candidate, organism/genome revision and current context before immutable successor |
|
|
|
|
A displayed candidate does not reserve resources. Changed context must reject or
|
|
revalidate; never silently substitute a different mutation. Thicker membrane first
|
|
changes thickness/composition; development derives construction mass,
|
|
permeability/protection, movement and thermal consequences. Omitted physics is a
|
|
documented model limitation, not an unrelated percentage modifier.
|
|
|
|
## Candidate-generation experiment
|
|
|
|
Propose a constrained catalog of mutation operators over capability/parameter
|
|
records. Filter by prerequisites, sort stable operator IDs, then sample bounded
|
|
integer weights from recorded genome/context. This is an internal rule catalog,
|
|
not a visible linear progression tree. Environment-conditioned offerings are a
|
|
game-design proposal, not a claim that biological mutation anticipates needs.
|
|
|
|
Record seed, organism, eligible event index, context digest, rules and stream ID.
|
|
Unrelated entity additions cannot change candidates. No wall clock, std::hash or
|
|
implementation-defined distribution enters sampling. Store bounded context
|
|
statistics; retries cannot obtain free rerolls. Candidate count, context window,
|
|
costs, inherited/acquired expression, NPC mutation and recombination remain open
|
|
before M3 mutation acceptance. No implementation silently settles these rules.
|
|
|
|
## Later morphology and history
|
|
|
|
Evaluate typed body graphs with tissue/segment/organ nodes and distinct attachment,
|
|
joint, vascular, neural and developmental edges. Independent consumers derive
|
|
meshes, collisions, mass, maintenance and locomotion. Validate work/graph bounds,
|
|
structural connectivity and resource feasibility. Development dependencies are
|
|
acyclic or explicitly bounded; vascular cycles can be valid. Mesh validity alone
|
|
does not prove biological viability. Intelligence remains one costly strategy.
|
|
|
|
Keep extinct genomes and ancestry indefinitely. Rule migrations preserve original
|
|
records/provenance and are tested on cloned worlds. Unknown required capabilities
|
|
fail closed. Tests cover canonical round trips, prerequisites, resource-limited
|
|
development, deterministic candidates, stream independence, retry stability,
|
|
bounded graph expansion, ancestry-preserving migration and material tradeoffs.
|