Files
aevolution/docs/adr/0120-cellular-mutation-eligibility-trial.md
T
dingo d652291126
Foundation / checks (deploy) (push) Successful in 6s
Foundation / checks (ecs) (push) Successful in 1m56s
Foundation / checks (postgres) (push) Canceled after 0s
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 (network) (push) Canceled after 5m28s
Foundation / checks (checks) (push) Canceled after 7m39s
Foundation / checks (client) (push) Canceled after 7m39s
Persist fed mutation offers in cellular v2
2026-10-11 04:51:55 -04:00

4.6 KiB

ADR-0120: Cellular mutation eligibility trial

Status

Accepted for the first M11.4 implementation (2026-10-11). The threshold and candidate count are versioned trial values for early playtesting, not balance sign-off. Review them with the exploratory check and again in 11.9.

Context

ADR-0098 requires mutation eligibility to come from fed surplus retained during a life, with seeded M3 candidates, stable retries and stale-selection refusal. ADR-0118 defines the exact funded transition. The current cellular tick records successful patch uptake after charging maintenance and movement, but the life checkpoint does not retain an earned surplus counter or an offer identity. Without those fields, opening reserve could be mistaken for feeding and recovery could create a free reroll.

Decision

  • Credit only energy successfully acquired from a provisioned environmental food patch by a living cell and retained in that same tick's reserve. Do not credit its opening reserve, energy merely held, movement, external grants or energy returned by another owner. One committed tick credits its intake once; publication retry cannot credit it again. Corpse/predation intake is outside this M11.4 trial and needs an explicit rule before it can earn credit.
  • Start with one mutation event per 60 seconds of the life's current per-second maintenance cost in credited energy. Derive the threshold from the current genome, growth and environment using checked integer arithmetic. Carry any remainder. If several events are earned while an offer is open, retain them as earned credit; issue at most one offer at a time. This starting interval is a tunable, versioned trial value.
  • An offer asks the M3 generator for three candidates; it may return fewer when the genome has fewer eligible operators. An empty result does not consume the accumulated credit or event index. Its context records the life, parent genome identity/digest, event index, offer tick, seed/stream, candidate count, growth and recorded environment. Event indices advance only when an earned event becomes an offer. The generator order is canonical, never a ranking. Re-reading or retrying the same offer regenerates identical bytes.
  • Identify an offer by (life_id, event_index, offer_tick). A selection names that identity and is revalidated against the stored parent and context. A wrong or consumed offer identity, changed genome or changed recorded context is stale. Advancing ordinary simulation ticks alone does not expire an open offer; the offer tick is an identity component the client must echo, not a 50 ms decision deadline. A stale or declined offer earns no replacement; a later offer needs new retained feeding credit.
  • Store the fed-energy remainder, event index and complete outstanding offer context in profile-4 v2. They are life state and restore exactly. The no-tick v1-to-v2 migration initializes all credit and event indices to zero and has no outstanding offer. Offer selection and genome publication remain in the later atomic path; 11.4b does not publish a chosen mutation.

Alternatives

  • Use total reserve as eligibility: rejected because an opening founder balance would earn mutation without feeding.
  • Reroll whenever context changes or a player asks: rejected because it rewards movement through contexts or repeated requests with unearned draws.
  • Expire an offer after one simulation tick: rejected because a 50 ms decision window would not leave a practical opportunity to read and choose.
  • Rank or filter to only affordable candidates: rejected because that hides the actual tradeoffs and would change the seeded candidate set. Funding failure remains visible and atomic under ADR-0118.

Benefits and costs

The checkpoint can prove that offers were earned by feeding, retries reproduce the same offer, and choices remain readable across several live ticks. This adds per-life durable state, a profile migration and explicit stale-offer handling. The 60-second threshold may feel too frequent or too slow; the early M11 check and repeated-life evidence must guide a versioned adjustment.

Consequences

Implement the accounting in the authoritative cellular owner, store it in the v2 checkpoint, expose only the owner's offer through the session boundary, and test exact retry, stale identity/context, credit carry, no opening-reserve credit, checkpoint restore and NDEBUG. The durable mutation selection and its genome/archive/resource publication remain a later segment. No ranked score, class tree, NPC mutation or automatic reroll is introduced.