Add owner-filtered cellular perception protocol
Foundation / checks (deploy) (push) Successful in 5s
Foundation / checks (checks) (push) Failing after 39s
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 (ecs) (push) Canceled after 1m48s
Foundation / checks (network) (push) Canceled after 1m18s
Foundation / checks (client) (push) Canceled after 1m58s

This commit is contained in:
dingo
2026-10-11 01:06:05 -04:00
parent 10b042309e
commit 5419a579e8
7 changed files with 209 additions and 10 deletions
@@ -0,0 +1,52 @@
# ADR-0115: Owner-filtered cellular perception protocol v8
## Status
Accepted M11.3e engineering direction under the maintainer's standing
authorization to proceed with recommendations and revisit decisions after
implementation. It adds no biological or gameplay rule; it carries the exact
view already specified by ADR-0103.
## Context
The profile-4 owner can derive a canonical list of nearby patch addresses and
stocks for one life. The current cellular session replicates organism snapshots
to every session with spatial interest, so it cannot carry that private list
without leaking one player's sensor view to another. No existing client session
negotiates a cellular-aware protocol that receives this view.
## Decision
- Add protocol v8 while keeping v1-v7 byte layouts and admission behavior
unchanged. V8 retains the reliable cellular action and final-outcome behavior
of v7, and adds one bounded server-to-client `CellularPerception` stream
message.
- The server derives the view from the authenticated account's current live
life and the existing ADR-0103 perception function. It routes the result only
to that account's current v8 session. The message omits account identity and
patch provenance; it contains the simulation tick, life identity, and the
canonical address-ordered list of exact visible patch inventories.
- A zero life identity with an empty patch list clears the client's previous
view. Nonzero life identity and tick are required for an active view. Duplicate
or out-of-order addresses, more than 256 patches, invalid lengths, and v8-only
messages on earlier versions are refused.
- This message communicates the existing sensor result; it does not let the
client set position, range, intake or authoritative inventory. Movement and
feeding remain reliable v8 actions resolved by the server.
## Alternatives considered
- **Include food in shared spatial snapshots:** rejected because session interest
is not the same as the controlled life, and one player's sensor range must not
disclose stock to another account.
- **Add perception to v7:** rejected because its frozen behavior is already
deployed and adding a new required view could break existing v7 clients.
- **Send the full microhabitat:** rejected by ADR-0103; it reveals unseen stock.
## Consequences
V8 clients receive bounded exact local resource information on the reliable
stream. The server must resolve the owner-life binding for each send and tests
must prove that another account cannot receive the message. Until client input
and presentation are wired, v8 alone does not make the cellular stage
playable.
+1
View File
@@ -15,6 +15,7 @@
- [ADR-0112: Durable cellular action input records](0112-cellular-action-ledger-records.md) - specifies canonical retry bytes, persisted result identity and the isolated profile-4 publisher needed before v7 admission.
- [ADR-0113: Cellular replay trace](0113-cellular-replay-trace.md) - specifies bounded per-tick life intentions for deterministic profile-4 replay and durable action reconciliation.
- [ADR-0114: First player life in cellular profile 4](0114-cellular-first-life-publication.md) - accepted M11.3 engineering direction: preserve empty genesis and add an allocator-backed, durable profile-4 birth operation so the 11.3e probe can start through the normal player path.
- [ADR-0115: Owner-filtered cellular perception protocol v8](0115-cellular-owner-perception-v8.md) - carries the existing exact sensor view only to its authenticated owner without changing v1-v7 behavior.
- [ADR-0058: Region durability contract](0058-region-durability-contract.md) - accepted M7.1 full checkpoint batches and explicit state closure; storage implementation follows.
+5
View File
@@ -353,6 +353,11 @@ scoped change before starting the next segment.
with the Linux/PostgreSQL CMake preset or run against a region. Exact patch
perception and the engineering-client controls/view are still required for
the exploratory 11.3e playtest.
- 11.3e-1: ADR-0115 defines a frozen v8 stream message for the existing
owner-filtered ADR-0103 patch view. The codec accepts a bounded canonical
address-ordered inventory list and keeps v1-v7 layouts unchanged. The server
still needs to route each view to its authenticated owner; the client needs
cellular input and presentation before the hands-on probe.
## Exit boundary