Files
aevolution/docs/biology/REPRODUCTION_MODEL.md
T
dingo a5307c768b
Foundation / checks (deploy) (push) Successful in 5s
Foundation / checks (ecs) (push) Successful in 2m25s
Foundation / checks (network) (push) Successful in 21m0s
Foundation / checks (client) (push) Successful in 22m13s
Foundation / checks (tsan) (push) Successful in 26m35s
Foundation / checks (postgres) (push) Successful in 1h1m27s
Foundation / checks (checks) (push) Successful in 1h14m29s
Foundation / postgres-tools (push) Successful in 1m19s
Foundation / server-image (push) Successful in 3m46s
Foundation / image (push) Successful in 4m57s
feat(lifecycle): add opt-in funded cellular maturation
2026-10-18 21:48:27 -04:00

6.6 KiB

Reproduction, life ownership and permadeath

Locked: irreversible death, independent descendants and no offline progression. Strategy/heredity/logout fairness are proposals requiring explicit acceptance before gameplay. Separate account, controlled organism, genome and lineage IDs. Historical creator references grant neither wildlife ownership nor visual labels.

flowchart TD
  A[Account] -->|current control grant| P[Living organism]
  A --> H[History without biological bonuses]
  P -->|funded reproduction| D[Independent wildlife descendants]
  P -->|permanent death| X[Historical dead organism]
  X --> H
  A -->|new life| N[Primitive founder]

No resurrection, retained power, checkpoint or special corpse-retrieval mechanic. Corpse biomass follows ordinary ecology, not an account recovery entitlement.

Reproduction and death contracts

Proposed intention: Reproduce(action_id, parent_id, expected_revision, strategy, candidate_id?). Server resolves life/control state, prerequisites, costs, environment, offspring allocation and genomic change. Client supplies no authoritative child genome/count/cost. Parent costs, ancestry/genome records, offspring inventory/allocation and event form one recoverable logical operation. Durable acknowledgment requires recoverability; duplicate IDs return prior outcome.

Binary fission proposes one autonomous descendant, with parent continuity/control and splitting still open. Eggs/live birth use bounded young or cohorts with explicit investment/gestation/mortality. Broadcast/spores use funded statistical cohorts; theoretical fecundity never requests unbounded AI allocation. Capacity backpressures, rejects or aggregates; it cannot grant free offspring or silently delete committed lineages. NPC mutation/heredity/juvenile viability remain open.

Alive→Dead is terminal for the organism ID. Remove actions before later phases; transfer inventory to corpse/detritus exactly once. Proposed ordering resolves lethal damage/maintenance before reproduction; changing this needs a decision and fixtures. Descendants receive no arbitrary mortality modifier because a player died: inherited demands/tolerances interact with ecology independently.

Committed death must survive snapshot replay before recovered state is exposed. Unavailable durability withholds final outcome acknowledgment and quarantines pending irreversible changes. A new life follows the same primitive founder rule for every account, with initial matter/energy provenance. No growth/reserve or capability bonus transfers from history.

Offline experiment: suspended inventory

Propose durable suspension outside progressing tiers. Freeze position reference, genome, age/growth, energy/matter, disease, gestation and every biological timer. Inventory stays in global accounting but cannot interact. Wildlife continues.

stateDiagram-v2
  Active --> SuspendPending: logout or detected disconnect / freeze
  SuspendPending --> Suspended: durable ownership transfer
  Suspended --> Active: validated unique resume grant
  Active --> Dead: committed death
  SuspendPending --> Dead: lethal outcome determined before freeze

SuspendPending already has no biological advancement at the authoritative freeze boundary. Servers can react only to detectable disconnects; heartbeat/detection bounds need a logout ADR. Clients cannot backdate freeze time. Resume performs no elapsed-time biology and first replays committed death. Changed habitat, blocked spawn, duplicate login and danger need a policy without free travel/duplication.

Suspension may evade predation or hoard biomass. A combat delay that advances offline biology violates the brief. Evaluate in-session eligibility/admission restrictions without progressing suspended organisms. Indefinite retention and matter disposition also remain open; no proposal is shipped as a settled rule.

Tests: dead IDs never act/resume; death/corpse exactly once; reproduction balanced and atomic despite insufficient nutrients with abundant energy; retries stable; descendants independent of parent death/logout; arbitrarily long suspension preserves every timer; same-tick death/reproduction ordering; huge spore requests; all suspend/resume crash points; changed habitat; unique control grants and death committed after snapshot. Extinction includes suspended viability.

M11 decisions (ADR-0098)

The maintainer accepted these for the first playable loop (2026-10-09):

  • Budding. The parent keeps its life and control, and funds one wildlife bud at its construction rate.
  • Heredity. A bud copies its parent's current genome exactly. Wildlife does not mutate in M11.
  • Mutation. Mutations are earned and applied during life through funded development.
  • Logout. On logout or a detected disconnect, biology freezes at once. The organism lingers frozen but vulnerable, then suspends.
  • Resume. In place, or at the nearest valid spot within a bounded radius; otherwise the life stays suspended.

Fission, eggs, cohorts, spores, NPC mutation, and how long suspension is retained stay open. The values marked tunable are playtest hypotheses, not locked rules.

Portable M12 maturation

The portable M12 ecology prerequisite in ADR-0157 adds opt-in rules-9 funded maturation to the cellular owner and exact cohorts. Genuine buds can spend their own acquired nutrients and energy to reach adulthood, then fund their own buds. The trial cap is 5 realized thousandths per 50 ms active tick, subject to exact channel funding and expansion space; damage is retained. Newborn/offline cells do not advance growth in that tick. Rules 8, DEV defaults and durable admission remain unchanged. A scripted finite-food family proof is not evidence of autonomous sustainable ecology, environmental coupling or actual-days operation.

Implemented M2.5 fixture boundary

ADR-0028 implements funded budding inside the synthetic feeding community only. The parent survives and pays an explicit investment; construction overhead goes to heat and waste; a bounded pre-allocated slot capacity rejects rather than granting free or reduced offspring. Ancestry is a parent reference and an origin tick that survive both deaths.

This settles none of the contracts above. Binary fission continuity, eggs, cohorts, broadcast spores, gestation, strategy selection, mutation candidates, client intentions, control grants, durable acknowledgment and logout treatment remain open. The fixture has no accounts, so a parent reference grants no ownership and no label. Test processes are not wildlife and do not seed a persistent world.