Files
aevolution/Cellular_reproduction_plan.md

212 lines
10 KiB
Markdown

# Cellular reproduction plan
Amendment, 2026-10-26: [ADR-0181](docs/adr/0181-cellular-reproduction-safety.md)
adds an opt-in DEV safety revision: controlled-cell split allocation, retained bud
provision and physical offspring separation. Historical declarations retain the
baseline below. All allocation/launch values remain trial tuning.
Status: planning draft, 2026-10-22. Records the maintainer's decisions on the
reproduction revamp. Companion to [Cellular_mutation_plan.md](Cellular_mutation_plan.md).
Where this document conflicts with the earlier drafts or with the unimplemented
proposals in ADR-0135, this document wins. No code, runtime rule or live region is
changed by it.
## 1. Purpose
Today reproduction has no purpose for the player: it costs resources, and the player
watches the offspring swim off, eat and reproduce until it dies.
The goal is one loop:
**gather energy and matter -> evolve and reproduce -> become a multicellular
organism -> break out of the region into the world.**
Reproduction becomes the way a lineage evolves, and the way a multicellular organism
grows.
## 2. Two genomes per cell
Every cell carries two genome references (they already exist from rules 10):
| Genome | Meaning |
| --- | --- |
| **Expressed** | What its own body is built from: its traits, handling, costs. |
| **Heritable plan** | What its offspring are born expressing. |
A newborn starts with both references naming the same genome: it expresses its plan.
## 3. Bud (on demand)
- **Trigger:** the player presses Bud.
- **Requires:** fully grown (`bud_min_growth`), a free spot touching the parent, and
the region below its organism cap.
- **Cost:** the parent's reserve pays the bud's body, the energy to build it and its
starting energy supply, as today. A tunable fee per channel (default 0, with the same
amount-and-scale model as mutation costs) is added on top and reclaimed by the
environment as random bubbles.
- **Offspring:** expresses the parent's heritable plan, so it carries every mutation
held in that plan.
- **Size:** the reproduction capability's share of the parent's body (founder: half),
built from the parent's reserve (body and maintenance plan, section 6).
- **Litter:** a heritable value (founder 0) can give extra offspring per bud, up to a
tunable maximum (trial 10). They share one investment, so each is smaller. See the
mutation plan, section 9.
- **Control:** the player chooses to stay as the parent or become the bud. The cell the
player leaves becomes wildlife. The choice is one way.
This section describes a single cell. A multicellular organism's bud becomes an
internal cell instead (section 6).
## 4. Mutation split
Accepting a mutation divides a single cell. (A multicellular organism expresses an
accepted mutation directly; section 6.)
1. The mutation's cost is paid and reclaimed by the environment (mutation plan,
section 4).
2. The mutation is written into the heritable plan of **both** cells.
3. The cell divides. Body and reserve are split per channel by `split_share` (trial
50%); a rounding remainder stays with the founder. Each half starts at the size its
half of the body covers and regrows by feeding (body and maintenance plan,
section 5).
4. The **offspring expresses the mutation**. The **founder does not**: its body is
unchanged, but its plan now carries the mutation.
5. The player chooses which cell to continue as. The other becomes wildlife. (When the
mutation is Adhesion, the two stay attached instead; section 6.)
The control choice is made in the offer itself: each option has **Stay as founder**
and **Become offspring**. Nothing waits on a decision window after the birth.
| Choice | The player controls | The other cell |
| --- | --- | --- |
| Stay as founder | The unchanged body, with half the resources. Every later bud expresses the mutation. | The mutated offspring becomes wildlife: the player watches how the mutation does. |
| Become offspring | The mutated body, with half the resources, not starting from nothing. | The founder becomes wildlife with an unchanged body; its own buds are mutated. |
Consequences:
- A player who always stays as the founder accumulates mutations in their plan, but
their own body never changes. To live in a mutated body, the player must at some
point become an offspring.
- If a mutation changes how much matter the body needs, the offspring funds the
difference from its half. If it cannot, the split is refused and nothing is spent.
- Both cells inherit the founder's affinity scores.
### When a split is not possible
A split needs a minimum growth (`split_min_growth`, trial: fully grown), a free spot
touching the founder, and the region below its organism cap. If any is missing, the
option shows why and cannot be chosen; the offer stays pending until the split is
possible or the player declines.
## 5. The cell the player leaves
It becomes autonomous wildlife, as today: it feeds, buds from its own heritable plan
and dies. Wildlife earns no mutation offers.
## 6. Becoming multicellular
### The transition
- **Adhesion** is a mutation, offered after a tunable number of on-demand buds (trial
5; mutation splits do not count). A newborn that expresses Adhesion stays attached to
its parent.
- The moment a newborn attaches, the parent and newborn become **one multicellular
organism**. There is no separate colony stage.
- Accepting Adhesion is a mutation split (section 4) whose offspring expresses
Adhesion, so it attaches at once: the organism forms immediately, whichever cell the
player would have kept. The offer shows Accept and Decline only.
- The organism expresses **one genome**: the founder's heritable plan at the moment of
attachment, which now includes Adhesion. Mutations the founder held in its plan
become expressed for the whole organism. Any tissue that change requires is funded
from the combined reserve; if it cannot be funded, the split is refused and nothing
is spent.
- A member can never be detached.
### Life as a multicellular organism
- **One reserve:** every member's reserve combines into the organism's reserve.
- **Mutations affect the whole organism.** Accepting one does not split anything; it is
expressed by the organism directly, paid from the organism's reserve, and changed
tissue is funded from it. The offer shows only Accept or Decline; there is no
Stay / Become choice.
- **Budding adds an internal cell.** The bud's body is built from the organism's
reserve and becomes part of the organism. It counts toward the emergence threshold.
- **The goal changes:** the organism gathers mass and energy to emerge into the world.
- **Region cap:** a multicellular organism counts once toward the region's organism
cap, however many members it has.
- **Mass drives movement and energy.** Every member adds to the organism's mass.
Heavier organisms accelerate and turn more slowly for the same thrust, and movement
energy rises with total mass, reserve matter included. Upkeep rises with body mass
only (feeding and energy plan, section 4). The coefficients are tuned in
playtesting.
### Wildlife organisms
Because Adhesion always forms the organism at once with the player's cell, and an
organism never releases a cell, wildlife cannot currently become multicellular. As a
safeguard, a wildlife organism **cannot emerge**: it stops budding one member short of
the emergence member threshold. Wildlife earns no mutation offers.
### Death
The organism lives and dies as one body.
- **Starvation:** with one reserve, members cannot starve individually. The organism
starves when its reserve cannot pay its maintenance, and the whole organism dies.
- **Engulfment:** a predator engulfs the whole organism or none of it, judged on the
organism's total mass.
- **On death:** every member becomes a corpse and its matter returns to the region as
food, as deaths do today.
This replaces the earlier rule that a dead member is recycled to the colony: with a
combined reserve, a member cannot die on its own.
## 7. Emergence
When the organism reaches the emergence threshold, an **Emerge** button appears. It is
not a mutation and is not drawn in offers. Pressing it leaves the region and enters the
world as ADR-0177 describes: the matter is a recorded export, and the organism arrives
at a world-scaled value at a location chosen near its preferred temperature and
nutrients. Individual or bulk emergence
follows ADR-0177.
The threshold is tunable: member count, total mass and reserve energy.
## 8. Tunables
| Setting | Trial |
| --- | --- |
| `bud_min_growth` | 1000 per thousand (fully grown) |
| `bud_fee` per channel, `bud_fee_scale_percent` | 0, 0 |
| `split_min_growth` | 1000 per thousand |
| `split_share` | 50% |
| Emergence threshold: members, total mass, reserve energy | To be selected in playtesting |
| Wildlife member limit | Emergence member threshold minus 1 |
| Mass coefficients for acceleration, turning, movement and maintenance energy | To be selected in playtesting |
## 9. Open questions
None. Organism size, drag and feeding contact by member count are tuned with the mass
coefficients above.
## 10. Implementation map
| Piece | State today |
| --- | --- |
| Expressed genome and heritable plan per cell | Exists (lives format 8, rules 10-12). |
| Bud funding with a different offspring genome | Exists (`fund_offspring`, ADR-0164). |
| Funding a mutation at the current growth | Exists (`fund_mutation_at_growth`, ADR-0157). |
| Funded regrowth after a split | Exists (funded maturation, rules 9). |
| Choosing parent or child at birth | Accepted direction (ADR-0163); not built. |
| On-demand bud with a control choice and a fee | New. |
| Mutation split: even division of body and reserve | New transition; not the bud bill. |
| Offer options with Stay / Become | New wire and UI. |
| Adhesion and the multicellular transition | New. |
| Multicellular organism: one genome, one reserve, internal buds | New. |
| Mass-scaled handling and energy for the organism | Partial: movement and maintenance energy already scale with a cell's body mass; reserve mass in movement and organism-level handling are new. |
| Wildlife member limit below the emergence threshold | New safeguard. |
| Emergence | Accepted direction (ADR-0177); not built. |
Every new behaviour goes in a new rules version; regions on earlier rules keep their
meaning.