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

4.5 KiB

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.

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.