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
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:
@@ -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.
|
||||
@@ -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.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user