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