2.6 KiB
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
CellularPerceptionstream 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.