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.
+5 -2
View File
@@ -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
+18
View File
@@ -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.