Define cellular intention session protocol v6
Foundation / checks (deploy) (push) Successful in 5s
Foundation / checks (ecs) (push) Successful in 1m54s
Foundation / checks (client) (push) Failing after 4m23s
Foundation / checks (network) (push) Failing after 3m5s
Foundation / postgres-tools (push) Canceled after 0s
Foundation / server-image (push) Canceled after 0s
Foundation / image (push) Canceled after 0s
Foundation / checks (tsan) (push) Canceled after 11s
Foundation / checks (postgres) (push) Canceled after 57s
Foundation / checks (checks) (push) Canceled after 5m23s

This commit is contained in:
dingo
2026-10-10 21:29:59 -04:00
parent 1ccc0ce476
commit ae0a3cdae5
10 changed files with 245 additions and 11 deletions
@@ -0,0 +1,45 @@
# ADR-0105: Cellular session intention protocol v6
## Status
Accepted wire-contract direction for M11.3 (2026-10-10). The codec is being
implemented first; server admission and durable resolution remain separate gates.
## Context
The deployed session wire versions 1–4 are frozen, and v5 adds only reliable
primitive-life creation/query messages. In primitive v5 mode the current server
rejects movement datagrams, probe actions and M10 interest. M11.3 needs a client
to request bounded movement and choose one nearby food patch without claiming
position, speed, energy or inventory.
## Decision
- Add session protocol v6 while preserving the exact v1–v5 encodings. V6 retains
the existing session, control epoch, movement vector, sequence and scheduled
tick fields, and adds an optional target patch address in micrometres.
- The v6 `CellularIntention` is a fixed 48-byte little-endian datagram payload.
The strict layout and canonical absent-target form are in
[session-v6-cellular-intention](../../schemas/network/session-v6-cellular-intention.md).
- The target is an intention only. The server checks authenticated session and
epoch, tick and sequence window, movement norm, patch alignment and visibility;
it resolves position and contact, then derives any costs or acquired stock.
- A cellular client must negotiate v6 explicitly. The current session server
remains unchanged until it has a cellular handler; the codec alone does not
authorize gameplay.
## Alternatives considered
- **Reuse the M10 marker intention:** rejected because its simulation path moves
a non-biological probe at a fixed speed and has no energy, habitat or life.
- **Send a position or inventory delta:** rejected because it would let the
client claim authoritative state.
- **Change v5 in place:** rejected because v5 life creation is an existing
versioned contract and must retain its exact bytes and primitive-only scope.
## Consequences
V6 provides a bounded, explicit wire value for the next server integration. It
does not implement admission, durable tick publication, a life view, client UI
or cross-region owner routing; M11.3 remains incomplete until those pieces work
end to end.
+1
View File
@@ -5,6 +5,7 @@
- [ADR-0102: Bounded cellular space and locomotion trial](0102-cellular-spatial-trial.md) - accepted M11.3 trial direction for finite 2D region bounds, phenotype-limited movement and organism contact; tunable arena dimensions are not world geometry.
- [ADR-0103: Cellular resource perception trial](0103-cellular-perception-trial.md) - accepted M11.3 exploratory direction for a 5 mm footprint-based sensor range and exact nearby patch stock; provenance and out-of-range stock remain hidden.
- [ADR-0104: Cellular single-life tick order trial](0104-cellular-single-life-tick-order.md) - accepted M11.3 order for maintenance, funded movement and one contact-gated intake proposal; shared-stock contention and durable publication remain open.
- [ADR-0105: Cellular session intention protocol v6](0105-cellular-session-intention-v6.md) - accepted M11.3 wire direction for movement plus an optional food-patch target; v1-v5 remain frozen and v6 server admission is still to be implemented.
- [ADR-0058: Region durability contract](0058-region-durability-contract.md) - accepted M7.1 full checkpoint batches and explicit state closure; storage implementation follows.