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

187 lines
10 KiB
Markdown

# Reproduction, life ownership and permadeath
## Accepted target gameplay: inheritance and succession
[ADR-0163](../adr/0163-structural-inheritance-and-offspring-succession.md)
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](../adr/0164-distinct-genome-offspring-funding.md) 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](../adr/0165-retained-cellular-offspring-plans.md) 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](../../schemas/cellular-region-batch-v4.md)
supplies portable replay and inherited-offer action matching; old traces refuse
this owner. [Bundle 12](../../schemas/cellular-inheritance-upgrade.md) 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](../../schemas/ecology/regional-cellular-census-v2.md)
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.
```mermaid
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.
```mermaid
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](../adr/0157-funded-cellular-maturation.md) 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](../adr/0028-funded-reproduction.md) 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.