Files
aevolution/docs/adr/0117-cellular-owner-tick-diagnostics-v9.md
T
dingo fe03a0f8e4
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
Define cellular owner diagnostics v9
2026-10-11 01:52:33 -04:00

3.2 KiB

ADR-0117: Owner-only cellular tick diagnostics protocol v9

Status

Accepted M11.3 engineering direction under the maintainer's standing authorization to proceed with recommendations and revisit decisions after implementation. It adds no gameplay or biological rule.

Context

ADR-0115 freezes v8 as the owner-filtered exact nearby patch view. Its playtest UI shows stock but not the controlled cell's reserve or why movement/intake failed, so players cannot judge the visible cost of steering and feeding. Those observations already exist in the authoritative one-tick result. The M11.3 probe needs them before mutation work expands.

Decision

  • Add session protocol v9 as an additive version. Keep v1-v8 byte layouts and behavior unchanged; v9 retains all v8 actions and owner-filtered perception.
  • Add the controlled live cell's exact current reserve by energy and four matter channels. Include the latest committed one-tick maintenance and movement cost, whether movement was absent, moved, blocked or unaffordable, and the existing intake result (not requested, acquired, missing patch or out of contact).
  • Send these fields only to the authenticated account that owns that life. Continue hiding provenance and patches outside the existing ADR-0103 sensor view. A cleared zero-life view has no diagnostics.
  • These diagnostics are a transient presentation of an already committed tick. They are not checkpointed, do not affect simulation hashes, costs, admission, or tick resolution, and are not a new biological rule. Immediately after recovery, current reserve is available while tick effects remain explicitly unavailable until the next committed tick.
  • Reject invalid enum values, nonzero reserved bytes, impossible status combinations, diagnostics on a zero-life view, and missing diagnostics on a live v9 view. V8 messages remain exactly their frozen layout.

Alternatives considered

  • Change v8 in place: rejected because v8 has a frozen fixed layout.
  • Show a client-estimated cost: rejected because server rules and reserves are authoritative, and a client estimate could misstate a refusal or intake result.
  • Persist diagnostics: rejected because replay already derives them from the committed predecessor and intention; presentation detail need not expand durable state or simulation-version compatibility.

Benefits

The exploratory player can distinguish upkeep from motion, see remaining reserve, and understand whether feeding succeeded, without exposing more of the world or changing biological outcomes.

Costs

The owner-filtered wire contract and UI gain fields. Session protocol v9 needs parallel compatibility and privacy coverage, while v8 remains supported.

Risks

A stale UI view remains stale after a session loss, so the client must keep the existing stale-view signal visible. The latest tick report is not a substitute for repeated playtest observations.

Consequences

Protocol v9, server report projection, client presentation, bounded codec tests and owner-isolation tests are required before the M11.3 cellular probe is considered ready. A later rule change remains subject to its own ADR and simulation-version review.