Files
aevolution/docs/adr/0179-cellular-gameplay-revamp.md
dingoandClaude Opus 5.5 4bc5d5eee7
Foundation / checks (checks) (push) Successful in 5s
Foundation / checks (client) (push) Successful in 5s
Foundation / checks (ecs) (push) Successful in 4s
Foundation / checks (postgres) (push) Successful in 5s
Foundation / checks (network) (push) Successful in 5s
Foundation / checks (tsan) (push) Successful in 5s
Foundation / checks (deploy) (push) Successful in 4m29s
Foundation / postgres-tools (push) Successful in 24s
Foundation / server-image (push) Successful in 4m33s
Foundation / image (push) Successful in 4m59s
feat(cellular): session v14, bundle 15 and rules-13 wildlife
Session v14 carries the rules-13 revamp: a body block in the owner's view
(members, emergence threshold, exclusions, Emerge open, payable energy,
mass and the 20 traits), become, emerge and channel exclusions on actions,
become on mutation choices, catalog offers (id, chance, cost) and the
emerged ending. Older sessions never see a v14 field. The client shows
Stay / Become offspring offers named from the shared catalog, continuing
as a bud, the organism and its Emerge button, kept channels, the body and
the emerged end screen.

Bundle 15 (rules 13 on owner format 11) is durable: schema 60 admits it
raw-only, stores become as bit 15 of the choice's operator, widens the
action input and mutation results, and publishes the 14 -> 15 revamp
profile migration. evo-world-clone opens cellular-v10 (cellular-v9 plus the
revamp upgrade from --revamp-tuning), resumable and recoverable.

Wildlife counts reserve matter as energy, waits for the bud fee, grows
organisms one short of emerging, and hunts by the region step's rules-13
engulf test. The play summary adds organisms, offers and the spent pool.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-26 07:31:32 -04:00

5.0 KiB

ADR-0179: Cellular gameplay revamp

Status and scope

Accepted product direction, 2026-10-22, from the maintainer's decisions in chat. Implementation pending; see the build plan. New rules (13) only: historical rules, checkpoints, tests and running worlds keep their meanings. Every number is a trial value in the Git tuning file. DEV-only; no World0 operation.

Context

Playtests of rules 11-12 showed that reproduction had no purpose for the player and that mutations were uniform draws over 32 generic operators unrelated to play. The maintainer reviewed the cellular drafts (movement, feeding, energy and photosynthesis, defense, the 150-entry mutation catalog) and settled each gameplay system in turn.

Decision

The system plans are the decision. In summary:

  • Mutations (plan): a named catalog of 49 with a pro and a con each. Per-cell affinity scores, raised and lowered by behaviour triggers, inherited and never drifting, set each mutation's chance of appearing in an offer between a 0.001% floor and a 70% cap. Three distinct options per offer by a seeded draw that honors those chances. Per-mutation tunable cost, reclaimed by the region as random bubbles.
  • Reproduction (plan): on-demand buds with a stay-or-become choice; accepting a mutation splits the cell, both halves carry the mutation in their heritable plan, only the offspring expresses it, and the player chooses which cell to continue as. Litter gives up to 10 offspring per bud. Adhesion forms a multicellular organism (one genome, one reserve) whose goal is emergence.
  • Feeding and energy (plan): per-channel collection rates; reserve matter stands in for energy at a worse rate; burned matter goes to a region spent pool that drips back as bubbles; reserve matter counts toward mass for movement.
  • Predation and defense (plan): instant engulfment for everyone, with engulf capacity and membrane points; a kill's remainder is split between bubbles and the spent pool. Armor and live capture are postponed.
  • Body and maintenance (plan): size, density, a heritable body recipe, upkeep efficiency above an essential floor, growth speed and bud share.
  • Postponed: temperature, sensing, multicellular mutations, damage, draft groups 071-150.

Conflicts with locked requirements (resolved 2026-10-23)

The project vision is the product authority. The maintainer settled both conflicts:

  1. Whole-organism mutations: accepted. The vision's structural-inheritance rule now applies to single cells. A multicellular organism, one body grown from many cells, expresses an accepted mutation as a whole, funded from its shared reserve (PROJECT_VISION.md amended).
  2. Emergence before the 3D world: accepted. Emerge records the organism's matter as an export from the region and ends the cellular life with an "emerged" outcome; the player then starts a fresh life. This lets the full cellular loop be played several times before work on the 3D space.

Durable form (2026-10-26)

  • Bundle 15 {13, 11, 2, 1, 1, 7, 6, 2, 1}: rules 13 on owner format 11, development 7, founder 6, raw trace 4. Schema 60 admits it raw-only, as bundle 14 is: the manifest, births and profile-migration parsers normalize it to bundle 14; a bundle-15 trace selection's byte 34 is its become flag; mutation results 0-6 (an organism's applied, life died, insufficient funding, declined, split applied, split refused); the action input's become, emerge and exclusion bits.
  • Opening cellular-v10. cellular-v9 followed by the durable 14 -> 15 revamp upgrade, with --revamp-tuning FILE (the Git revamp tuning file); resumable and idempotent at bundle 15. Recovery re-derives the target from the source and the rules it declares.
  • Session v14. See schemas/network/session-v14-cellular-revamp.md.

Alternatives

  • Keep the generic operator catalog and add weights (ADR-0135's rules-7 proposal): rejected; operators carried no pro or con and no behaviour link.
  • Burning matter into energy through bound chemical potential (feeding draft): rejected as a new hidden resource; matter instead stands in for energy, so no energy is created.
  • Colonies of separate cells (ADR-0135 rules 8-9): replaced by one organism with one genome and one reserve.

Consequences

  • Benefits: reproduction drives evolution; mutations follow play; more variation between lives; a defined path toward emergence.
  • Costs: genome schema 7 with many new fields, a new owner format, session protocol and client screens; 49 triggers' counters per cell.
  • Risks: matter-as-energy may make starvation rare; the energy-kept rule cuts founder income to 40% unless bubble energy is retuned; one deploy at the end of the build.