Files
aevolution/docs/biology/GENOME_MODEL.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

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.