Files
aevolution/docs/biology/REPRODUCTION_MODEL.md
T
dingo dc7c0e1fa1
Foundation / checks (tsan) (push) Canceled after 0s
Foundation / postgres-tools (push) Canceled after 0s
Foundation / server-image (push) Canceled after 0s
Foundation / image (push) Canceled after 0s
Foundation / checks (checks) (push) Canceled after 1m13s
Foundation / checks (client) (push) Canceled after 1m14s
Foundation / checks (postgres) (push) Canceled after 1m7s
Foundation / checks (deploy) (push) Canceled after 1m13s
Foundation / checks (ecs) (push) Canceled after 1m13s
Foundation / checks (network) (push) Canceled after 1m14s
feat(ecology): distinguish inherited plans in verified census
2026-10-19 15:06:47 -04:00

10 KiB

Reproduction, life ownership and permadeath

Accepted target gameplay: inheritance and succession

ADR-0163 records the maintainer's 2026-10-19 decision. Structural mutations alter the heritable offspring plan while the existing parent retains its expressed body. At birth the player sees the offspring outcome and chooses to stay as the parent or permanently continue as the child. The other organism becomes independent wildlife. A relinquished parent retains its established behavior and the plan that produced that child, including continued reproduction of that form.

There is no switch back, later rescue into the old parent or resurrection. A fresh life after death is primitive; voluntary succession while both organisms are living is a different event. Each organism keeps its own identity, inventory, development, ancestry and terminal death. Only the currently controlled organism freezes on logout; independent parents and siblings continue living normally.

Portable expressed/heritable state is now implemented below. Bounded NPC behavior and a durable birth/control choice must be implemented before this behavior is offered. Choice timing and pause policy remain explicit implementation decisions. The M11 decisions and diagram below describe the old baseline, not a prohibition on the accepted target behavior.

Implemented portable offspring funding

ADR-0164 implements fund_offspring and offspring_cost in the biology budding API. The expressed parent supplies reproductive eligibility and its own investment; a distinct inherited genome supplies the child's body, largest feasible birth growth and starting demand. Every elemental channel and energy close exactly. The parent is not rebuilt. Changed schema/development laws and conflicting same-ID genomes refuse. Two share-funded children cannot manufacture the parent's invested matter.

Tests cover changed anatomy and demand, sterile children, exact cost/shortages, twins and retained archive identities. Existing same-genome helpers delegate to this operation with identical parent/child inputs. Current live rules still produce exact-copy buds.

Implemented portable retained plans

ADR-0165 adds opt-in owner format 8/rules 10. Expressed genome IDs keep describing existing tissue. Earned mutation choices in this mode edit a separate offspring plan, without rebuilding the parent or charging for unconstructed tissue. Physical construction is funded at birth. Subsequent offspring use that plan until another selection changes it; earlier children keep their original form. Save/reload retains plan selections and dead-parent history, and logout freezes the controlled parent's biology.

This scoped mode edits inherited plans only. The future operator catalog still needs to distinguish traits that can also change during an existing life. Population and migration still refuse the new owner. Trace 4 supplies portable replay and inherited-offer action matching; old traces refuse this owner. Bundle 12 supplies its raw checkpoint and exact retained-source upgrade. ADR-0168/schema 55 now admits explicit fenced raw upgrades, durable plan selections/births and full recovery. Census projection 2 separates living plan references from expressed bodies/reserves and retains dead plan records as history. A plan reference owns no stock and promises no funded offspring or survival. The birth-time control choice, persistent NPC behavior and UI remain unimplemented; default/DEV rules do not opt into this owner.

Historical M11 baseline and open strategies

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.