Files
aevolution/docs/adr/0106-cellular-contested-patch-arbitration.md
dingo b5e831f385
Foundation / checks (deploy) (push) Successful in 6s
Foundation / checks (ecs) (push) Successful in 1m55s
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 1m26s
Foundation / checks (client) (push) Canceled after 3m33s
Foundation / checks (checks) (push) Canceled after 3m38s
Resolve cellular patch contention per tick
2026-10-10 21:51:38 -04:00

46 lines
2.1 KiB
Markdown

# ADR-0106: Cellular contested patch arbitration trial
## Status
Accepted for the M11.3 exploratory slice (2026-10-10). The arbitration order
is explicit and reviewable with the 11.3e playtest evidence; it is not a claim
of long-term balance.
## Context
ADR-0101 makes each cellular patch finite. ADR-0104 orders one life's maintenance,
movement and intake, but a shared patch can receive claims from multiple lives in
the same tick. Resolving each life against the original patch would duplicate
stock. Network arrival order is nondeterministic and cannot decide the biological
result.
## Decision
- Resolve a region's life proposals in ascending stable world life identity,
independent of input, session and connection order.
- Each valid claimant receives its per-channel intake limit from the patch stock
remaining after earlier identities. An exhausted channel transfers zero; other
channels remain independent.
- Produce one detached region candidate with the final patch stocks and every
life result. If any life cannot produce its tick candidate, refuse the entire
result; the caller publishes no partial tick.
- This trial does not define death/corpse closure, cell-to-cell contact, engulfment
or durable publication. Those remain later 11.3c/11.3d work.
## Alternatives considered
- **Connection or arrival order:** rejected because it is nondeterministic and
gives transport timing biological effect.
- **Proportional allocation:** deferred; it changes the meaning of the existing
per-life intake cap and needs a different conservation/fairness trial.
- **Seeded rotation:** deferred until playtest evidence shows fixed identity order
causes a meaningful fairness problem. It would add state or a new deterministic
arbitration rule.
## Consequences
The first implementation provides a bounded deterministic shared-patch candidate
and verifies channel conservation. Ascending identity can favour older lives under
repeated scarcity; 11.3e records whether that is understandable and acceptable.
Changing the order requires updating this decision and deterministic replay evidence.