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