Define cellular owner diagnostics v9
Foundation / checks (deploy) (push) Successful in 6s
Foundation / checks (checks) (push) Failing after 40s
Foundation / checks (ecs) (push) Successful in 1m57s
Foundation / checks (postgres) (push) Failing after 53s
Foundation / checks (tsan) (push) Failing after 32s
Foundation / checks (network) (push) Failing after 3m1s
Foundation / checks (client) (push) Failing after 4m26s
Foundation / postgres-tools (push) Skipped
Foundation / server-image (push) Skipped
Foundation / image (push) Skipped

This commit is contained in:
dingo
2026-10-11 01:52:33 -04:00
parent a6a18dd6cd
commit fe03a0f8e4
9 changed files with 313 additions and 42 deletions
@@ -0,0 +1,43 @@
# Session protocol v9 cellular owner diagnostics
ADR-0117 defines v9 as an additive extension of the owner-filtered type 24 view
from [v8](session-v8-cellular-perception.md). Versions 1–8 keep their exact
wire layouts. V9 retains the v8 reliable cellular action and patch-perception
behavior, and adds the owning life's current reserve and latest committed tick
effects. The new fields are diagnostic only and do not affect simulation state.
## Type 24
The 8-byte `EVSN` header uses version 9, type 24 and flags 0. The payload starts
with the v8 `tick u64`, `life_identity u64`, and `patch_count u16`, then a fixed
64-byte diagnostics block, then the v8 48-byte patch records. Tick is nonzero.
An active life has a nonzero identity and diagnostics. A cleared zero-life view
has no patches and an all-zero diagnostics block.
| Payload offset | Size | Field |
|---:|---:|---|
| 0 | 8 | server tick |
| 8 | 8 | life identity; zero clears view |
| 16 | 2 | patch count, at most 256 |
| 18 | 8 | current energy reserve, pJ |
| 26 | 32 | current reserve C, N, P, other, each fg |
| 58 | 8 | latest committed maintenance cost, pJ |
| 66 | 8 | latest committed movement cost, pJ |
| 74 | 1 | movement result: 0 unavailable, 1 no movement requested, 2 moved, 3 blocked, 4 insufficient energy |
| 75 | 1 | intake result: 0 unavailable, 1 not requested, 2 acquired, 3 patch missing, 4 out of contact |
| 76 | 1 | latest tick effects present: 0 or 1 |
| 77 | 5 | reserved, all zero |
| 82 | 48 × count | exact visible patch addresses and inventory, unchanged from v8 |
When the result-present flag is zero, both costs are zero and the movement/intake
results are 0. When present, neither result may be 0. A zero life may not carry
nonzero reserve, cost, status, or result-present fields. The decoder rejects
unknown enum values, invalid result combinations, reserved bits, wrong lengths,
unsorted or duplicate patch addresses, and over-limit patch counts before
publishing a view. The maximum message size is 12,378 bytes including the header.
The server sends the message only to the authenticated account's current v9
session, and only for its currently bound live cell. V8 sessions continue to
receive the byte-identical v8 view without these diagnostics. Tick effects are
transient: after recovery reserve is reported immediately, while effects remain
unavailable until a committed tick has run.