Files
aevolution/docs/biology/ECOLOGY_MODEL.md
T
dingoandClaude Opus 5 eaf58f2b85 Drive the energy cycle with measured ecosystem episodes
Close M2 with a deterministic driver that owns one community and one
seeded stream, holds no inventory and emits only the terminal, feeding
and reproduction intents the earlier increments already accept. No
simulation contract changed to make the cycle run unattended.

Two limits shaped the design. Identities are never reused and slots are
capped, so one community supports a bounded number of consumer lifetimes
and is not a population. No maintenance cost exists, so a consumer that
is never eaten never dies, and inventing a starvation rule here would
settle a question ENERGY_MODEL leaves open inside a measurement harness.
The harness therefore measures many bounded episodes, taking mortality
from predation and from a configured lifespan delivered as an ADR-0027
host terminal fact. Lifespan bounds an episode; it is not senescence.

The driver must never submit a batch the community rejects, so it probes
a discarded copy each tick to size bites against the state feeding will
actually see, claims each target for one feeder, and excludes a bitten
consumer from acting. A rejected tick is reported as a driver defect
rather than absorbed as ecology.

Across 64 seeds the suite steps tick by tick, requiring exact conserved
totals at every tick and an identical report on replay, and covers both
mortality paths, slot exhaustion, tick-limit termination, lineage
attribution, episode independence and configuration rejection.
evo-sim --ecosystem reports seeded ensembles: 3,000 episodes advanced
1,093,007 ticks, all reaching extinction, with deaths reconciling exactly
against founders plus births. That demonstrates arithmetic and turnover,
not ecological plausibility; strategy constants are chosen inputs.

Native Release, clang-tidy analysis, ASan and format checks pass 11/11;
golden d61ad5bf0c928c76 is unchanged. Linux CI has not run yet.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-22 17:38:34 -04:00

6.4 KiB

Ecology and simulation fidelity

Locked: scalable tiers and independent persistent descendants. Contracts below are recommended; population math, lineage/species classifications are experiments.

Tier Owned state
1 active Identified individuals, position, phenotype, reserve, lifecycle and interactions
2 local Genome/cohort, counts, demographic distributions, matter/composition/reserve
3 regional Genome/lineage density distributions, inventories and environmental coupling

No inventory is spendable in two tiers. Representatives are either debited cohort shares or read-only noninteractive visuals. Never average distinct genomes into one genome. Controlled organisms cannot collapse into progressing populations; offline state is separate. Carry uncertainty and approximation error explicitly.

flowchart LR
  I[Individuals] -->|freeze / reserve| T[Conversion transaction]
  T -->|commit inventory| P[Population]
  P <-->|conservative allocation| E[Regional ecology]
  P -->|reserve feasible share| T
  T -->|install identities| I
  S[Suspended inventory] --- A[World accounting]
  T --> A
  P --> A
  I --> A

PopulationRecord proposes habitat/genome/lineage identity, representation version, owner epoch, last simulated tick, demographic bins, count semantics, material/ element inventory, reserve, spatial support, uncertainty and conversion sequence. Preserve reproductive state or exclude it until conversion is valid. Expected fractional density differs from an available individual; integer materialization uses a seeded rule/residual and remains bounded by funded biomass/energy.

Contract Invariant
PlanCollapse Reject controlled/suspended/dead/unsettled members; group compatible states and total exact inventory
CommitCollapse Remove active spending rights and install cohort once under current epoch
AdvancePopulation Bounded flux proposals over a declared interval and environment view
PlanMaterialize Reserve feasible count, composition, reserve and demographics
CommitMaterialize Debit cohort/install active identities while retaining provenance
TransferPopulation Source escrow, idempotent destination credit and durable settlement

Prefer local deterministic transactions. At a tick boundary freeze the old representation, reserve under conversion ID/epoch, validate conservation and destination, commit source removal/destination installation recoverably, then expose. Recovery replays the committed sample, never samples again. A timeout cannot release remote reservations. Cross-worker bus delivery is not exactly-once authority. Count escrow in global totals.

Keep IDs in initial fixtures. Later statistical representation needs an ADR for retained individuals versus cohort representatives; never invent precise parentage from statistical ancestry. Adversarial conversion cannot select only healthy/high energy members or reset age/injury/fertility/incubation. Unsupported states stay explicit until a valid conversion exists.

Population math and timing experiments

N_next = N + births - deaths + immigration - emigration.

B_next = B + assimilated_growth + immigrant_biomass - mortality_biomass - predation_biomass - emigrant_biomass.

Births redistribute funded investment, not independently created biomass. Predation changes counts and transfers biomass once; death returns detritus. Compare bounded flux, seeded stochastic cohort and deterministic expected-density models. Reject/subdivide unstable intervals; never hide negative populations with clamps. Operational capacity limits backpressure rather than ecologically cull. Shared bounded perception/intention controllers are the initial AI proposal; evolving behavior/learning and universal species definitions remain open.

Advance whole declared intervals and record last committed tick. One owner integrates each interval; late transfers are not new production. Expose catch-up backlog/freshness. Whole-world outage wall-time catch-up is an explicit later policy, while offline controlled biology remains frozen either way. Exact seeded repeatability does not imply exact fidelity to individual ecology: compare matched ensembles and publish population/biomass/diversity error envelopes.

Extinction and acceptance

Distinguish no active observation, ecological absence and terminal extinction. Require a globally reconciled watermark covering active individuals, cohorts, eggs/spores, in-flight transfers and every viable store. Suspended members make absence differ from recoverable viability: extinction stays provisional until policy acceptance. Rounding a density to zero cannot declare irreversible extinction. Preserve genome/ancestry/origin/extinction evidence permanently; census series may be summarized at declared resolution. Clones have isolated IDs/event destinations and cannot publish into World0.

M4: collapse 100 funded compatible individuals, simulate 10,000 ticks, materialize feasible representatives. Test conservation including flux/residual/escrow, genome identity, deterministic replay, crashes at every conversion boundary, interval uniqueness, mixed-genome diversity, repeated conversion attacks, extreme rates, late migrations/censuses and suspended viability. Compare explicit individuals: passing conservation alone is insufficient ecological evidence.

Implemented M2.6 episode boundary

ADR-0029 measures bounded episodes of the synthetic community. It settles none of the contracts above. There is no tier, no cohort, no conversion transaction, no representative materialization and no habitat. Every process stays an identified individual for its whole life.

Extinction here is the narrow, local statement that an episode has no living consumer, recorded with the tick it happened. It is not the globally reconciled watermark this document requires: there are no suspended members, eggs, spores, in-flight transfers or other viable stores to reconcile, and no policy acceptance. Surviving lineage counts come from retained parent references, not from species classification, and lineages differ only by founder strategy because no genome exists yet.

The shared bounded controller proposal is exercised only as a measurement driver. It has no perception, no learning and no evolving behavior, and its constants are inputs rather than results. Population math, cohort collapse and resolution equivalence remain M4 work.