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,68 @@
# 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.
+1
View File
@@ -17,6 +17,7 @@
- [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-0116: Cellular life-owner routing](0116-cellular-life-owner-routing.md) - reuses authenticated SessionRedirect with an operator-provisioned per-world region route catalog; owner lookup happens before account-control claim.
- [ADR-0117: Owner-only cellular tick diagnostics protocol v9](0117-cellular-owner-tick-diagnostics-v9.md) - adds the live cell's authoritative reserve and latest committed maintenance, movement and intake result to its owner-filtered view; v1-v8 stay frozen and no gameplay rule changes.
- [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
@@ -388,6 +388,11 @@ scoped change before starting the next segment.
patch-stock changes. This clarifies transport/scheduling failures; the protocol
still does not report per-tick reserve or itemized maintenance/movement costs,
so resource-cost legibility remains an open probe limitation.
- 11.3e-6a: ADR-0117 defines owner-only protocol v9 diagnostics for current
reserve and the latest committed tick's maintenance, movement and intake result.
The v9 codec keeps v8 bytes frozen and rejects malformed status combinations;
standalone MSVC `NDEBUG` protocol tests pass. Server report projection and the
client display remain the next parts of this subsection, with CI still pending.
## Exit boundary
+14
View File
@@ -6598,6 +6598,20 @@ control. GCC 13.2 strict-warning syntax compilation and Visual Studio LLVM
`clang-format` passed; the test binary has not run. CI execution remains
required.
## 2026-10-11 — M11.3e-6a cellular diagnostics protocol v9 (CI pending)
ADR-0117 and `schemas/network/session-v9-cellular-diagnostics.md` define an
additive owner-only report of current reserve and latest committed tick effects.
The v8 message stays byte-identical. The codec rejects malformed enums,
reserved bytes, impossible status combinations and missing live-life diagnostics.
Visual Studio LLVM `clang-format` and `git diff --check` passed. MSVC 19.44
compiled the modified codec and protocol test with `/W4 /WX`, `/DNDEBUG`; the
standalone protocol test executable passed its v6, v7, v8 and v9 checks. The
configured CMake/Ninja build still stalls before compilation at its glob
recheck. The CI network suite remains pending; no server/client integration or
live cellular playtest is claimed for this contract-only slice.
## 2026-10-11 — M11.3e-5 readable cellular action feedback (CI pending)
The cellular client now explains each protocol admission status and durable