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.
|
||||
|
||||
|
||||
@@ -106,8 +106,8 @@ scoped change before starting the next segment.
|
||||
|
||||
- 11.3a contract direction: ADR-0101 selects finite 1 mm cellular food patches;
|
||||
ADR-0102 defines bounded non-wrapping movement and footprint contact. The
|
||||
complete living-set checkpoint, perception contract and server profile remain
|
||||
open.
|
||||
complete living-set checkpoint and server profile remain open; ADR-0103 now
|
||||
defines the perception trial contract.
|
||||
- 11.3b-1: pure phenotype-derived movement proposal and square-footprint contact
|
||||
helper are implemented and locally tested. Session inputs, server state,
|
||||
replication and durable movement publication remain open.
|
||||
@@ -127,6 +127,9 @@ scoped change before starting the next segment.
|
||||
affordable movement and one targeted contact intake into a detached candidate.
|
||||
Shared-stock contention, starvation/death closure, owner commit and checkpoint
|
||||
recovery remain open; this helper is not yet a multi-life tick.
|
||||
- 11.3b-3: ADR-0105 and the v6 codec define cellular intention bytes for movement
|
||||
and an optional food-patch target. Server admission, durable simulation and
|
||||
client presentation are still open.
|
||||
|
||||
## Exit boundary
|
||||
|
||||
|
||||
@@ -5931,3 +5931,21 @@ Executed locally: warning-as-error MSVC Debug and Release `NDEBUG` compile/run,
|
||||
focused cellular CTest, clang-format 19.1.5, clang-tidy 19.1.5 with MSVC
|
||||
`/std:c++latest`, and `git diff --check`. CI and integration with durable
|
||||
intent/outcome publication remain pending.
|
||||
|
||||
## 2026-10-10 — M11.3b-3 cellular intention v6 codec (CI pending)
|
||||
|
||||
ADR-0105 and `schemas/network/session-v6-cellular-intention.md` define a strict
|
||||
fixed-size datagram carrying only session/epoch, sequence/tick, movement intent
|
||||
and an optional intake patch address. V1-v5 encodings remain unchanged. Decode
|
||||
rejects noncanonical absent targets and reserved bytes. The codec intentionally
|
||||
does not admit this message in `RegionSessions`; that server path is not yet
|
||||
implemented.
|
||||
|
||||
Executed locally: warning-as-error MSVC 19.44 Release compile/run, CTest
|
||||
`cellular-intention-protocol-v6` (1/1 passed), compile-only MSVC check for the
|
||||
existing `network_control.cpp` regression case, clang-format 19.1.5 on changed
|
||||
ranges, clang-tidy 19.1.5 with MSVC `/std:c++latest`, and `git diff --check`.
|
||||
The CMake/Ninja build of `evo-network-tests` remained idle for about 90 seconds
|
||||
(cmake 0.02 CPU seconds, ninja 0.09, no `cl`/`link` child), so I interrupted it;
|
||||
the full M10 network suite and server admission/QUIC integration remain pending.
|
||||
Linux network CI has not yet qualified this version.
|
||||
|
||||
Reference in New Issue
Block a user