Add M10.4a intentions, actions and admission
Foundation / checks (deploy) (push) Successful in 5s
Foundation / checks (ecs) (push) Successful in 1m45s
Foundation / checks (network) (push) Successful in 9m37s
Foundation / checks (client) (push) Successful in 12m14s
Foundation / checks (tsan) (push) Successful in 7m39s
Foundation / checks (checks) (push) Successful in 31m15s
Foundation / postgres-tools (push) Canceled after 0s
Foundation / server-image (push) Canceled after 0s
Foundation / image (push) Canceled after 0s
Foundation / checks (postgres) (push) Canceled after 32m59s
Foundation / checks (deploy) (push) Successful in 5s
Foundation / checks (ecs) (push) Successful in 1m45s
Foundation / checks (network) (push) Successful in 9m37s
Foundation / checks (client) (push) Successful in 12m14s
Foundation / checks (tsan) (push) Successful in 7m39s
Foundation / checks (checks) (push) Successful in 31m15s
Foundation / postgres-tools (push) Canceled after 0s
Foundation / server-image (push) Canceled after 0s
Foundation / image (push) Canceled after 0s
Foundation / checks (postgres) (push) Canceled after 32m59s
Session protocol v1 (not yet deployed, amended in place) gains realtime intentions on datagrams with receipts and a cumulative simulated watermark, and account-scoped actions with stable ids, receipts, final outcomes and queries. IntentAdmission enforces session binding, rate, authority, epoch, vector, sequence, tick window, duplicates and the unresolved bound; RegionSessions and the client carry it over QUIC. Intentions and actions have no biological effect yet. ADR-0092. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
+3
-2
@@ -521,8 +521,9 @@ hardware (10.9). 10.2 split: 10.2a selection, pins and build of msquic/OpenSSL d
|
||||
10.2c loss/head-of-line measurements done (networking/M10_TRANSPORT_MEASUREMENTS.md).
|
||||
10.3 split (ADR-0091): 10.3a account ids, ECDSA grants, identity adapter and region
|
||||
session control done; 10.3b QUIC session login (schemas/network/session-v1.md) done;
|
||||
10.3c durable per-world account control (schema v10) done. Process wiring into
|
||||
evo-server and the client comes with 10.4. 10.4-10.9 planned.
|
||||
10.3c durable per-world account control (schema v10) done. 10.4 split (ADR-0092):
|
||||
10.4a intention/action protocol and admission done; 10.4b durable action records and
|
||||
10.4c evo-server wiring with a headless client follow. 10.5-10.9 planned.
|
||||
|
||||
**Entry:** M9 client/session evidence and M7/M8 dev/stage durability. Read
|
||||
NETWORK_ARCHITECTURE, PERSISTENCE_ARCHITECTURE and ADR-0017. The M9 transport is
|
||||
|
||||
+6
-2
@@ -24,8 +24,12 @@ session login over QUIC (session-v1: Hello, Welcome, Refresh, Close with reasons
|
||||
the region and client side, tested end to end on loopback. M10.3c adds durable per-world
|
||||
account control (schema v10): grant serials survive restarts and apply across regions,
|
||||
cross-region takeover waits out the previous holder, and sessions close when their
|
||||
control is fenced or cannot be renewed. Next: M10.4 intentions and durable outcomes,
|
||||
including wiring M10 sessions into evo-server and the client.
|
||||
control is fenced or cannot be renewed. M10.4a (ADR-0092) adds
|
||||
intentions (datagram receipts and a cumulative simulated watermark) and account-scoped
|
||||
actions with stable ids, receipts and final outcomes to session-v1, with admission
|
||||
(window, rate, sequence, duplicates, unresolved bound) and client support; intentions and
|
||||
actions have no biological effect yet. Next: M10.4b durable action records (migration
|
||||
v11) and M10.4c evo-server wiring.
|
||||
|
||||
## Previous gate - 2026-10-02
|
||||
|
||||
|
||||
@@ -0,0 +1,61 @@
|
||||
# ADR-0092: M10 intentions, actions and durable outcomes
|
||||
|
||||
## Status
|
||||
Accepted for M10.4 (2026-10-03). Decisions confirmed with the maintainer on 2026-10-03:
|
||||
intentions and actions have no biological effect yet (durable no-effect); stable action
|
||||
ids and final outcomes are made durable in PostgreSQL in the same transaction as the
|
||||
checkpoint; 10.4 wires M10 sessions into evo-server with a headless client (the GUI
|
||||
client switches later). Delivery: 10.4a protocol and admission (this text), 10.4b durable
|
||||
action records (migration v11) and host integration, 10.4c evo-server listener, headless
|
||||
client and process kill tests. Each segment amends this ADR.
|
||||
|
||||
## Context
|
||||
ADR-0089 fixed the scheduling window (server_tick + 1 ..= + 8), one intention per tick,
|
||||
per-session u64 sequences, at most 256 unresolved intentions and 1.5 s final outcomes.
|
||||
ADR-0090 put superseding intentions on QUIC DATAGRAMs and reliable actions on the stream.
|
||||
ADR-0091 binds sessions to accounts. No controllable organism or movement rule exists
|
||||
(10.6 movement experiment, M11 organisms), so nothing an intention names can change
|
||||
authoritative state yet. Committed batch traces record host inputs only, not request ids.
|
||||
|
||||
## Decision (10.4a)
|
||||
**Two kinds of client input, three distinct answers.**
|
||||
- *Intentions* (datagram): session, epoch, sequence, tick, bounded move vector; never any
|
||||
state claim (position, energy): the message has no such fields and any extra bytes make
|
||||
it invalid. Answers: an `IntentionReceipt` (admitted = scheduled for its tick, or a
|
||||
refusal) and a cumulative `SimulatedThrough` watermark (every admitted intention up to a
|
||||
sequence whose tick has been simulated in the epoch), repeated every 20 ticks so a lost
|
||||
datagram is covered. Intentions are superseding: there is no per-intention durable record.
|
||||
- *Actions* (stream): a client-chosen action id, unique per account and stable across
|
||||
retries and reconnects, a kind and a tick. Answers: an `ActionReceipt` (scheduled, or a
|
||||
refusal) and a final `ActionOutcome`: `committed_no_effect` with its commit sequence once
|
||||
the commit covering its tick is durable, or `not_committed`. `ActionQuery` resolves an id
|
||||
at any time (`pending`, `unknown`, or the final outcome). The only kind is `probe`.
|
||||
- A receipt is never a final outcome, and the watermark is never durability.
|
||||
|
||||
**Admission** (`IntentAdmission`, transport-neutral, single owner), in order: the message
|
||||
must name the connection's own session; rate (every attempt counts: 8 intentions and 4
|
||||
actions per 8-tick window); authority ready; epoch; vector norm <= 1000 or a known action
|
||||
kind and nonzero id; strictly increasing sequence; tick inside the window and, for
|
||||
intentions, after the previous admitted intention's tick; duplicates (an action id already
|
||||
pending or final for the account is never admitted again: `duplicate`, followed by its
|
||||
outcome when final); at most 256 unresolved intentions plus actions per session.
|
||||
Actions belong to the account: a takeover or reconnect sees the same pending and final
|
||||
actions. The host takes scheduled actions with `carry(tick)` for the batch that simulates
|
||||
that tick and reports durable commits with `committed(end_tick, sequence)`. When the epoch
|
||||
advances, actions never carried are final `not_committed`; carried ones stay pending until
|
||||
their durable record decides them (10.4b). Recent final outcomes (2,048) are kept for
|
||||
duplicates and queries; older ones are resolved from the durable record (10.4b).
|
||||
|
||||
**Protocol.** Session protocol v1 gains message types 6-12 and Welcome gains the server
|
||||
tick (schemas/network/session-v1.md). v1 has never been deployed, so it is amended in
|
||||
place, as ADR-0083 did for M9 v1; after its first deployment, changes need a new version.
|
||||
The action kind is a raw u16 on the wire and validated by admission (an enum narrower than
|
||||
the wire field must never be cast from it).
|
||||
|
||||
## Consequences and limits (10.4a)
|
||||
- Durable resolution of carried actions after a crash, and of final outcomes evicted from
|
||||
memory, needs the v11 records (10.4b). Until then a carried action of a lost epoch
|
||||
answers `pending`.
|
||||
- The simulated watermark says the targeted tick ran while the intention was scheduled;
|
||||
with no movement rule it changed nothing. 10.6 gives intentions an effect.
|
||||
- Nothing is wired into evo-server yet (10.4c); nothing deploys M10 sessions.
|
||||
@@ -98,6 +98,7 @@ design. No unadopted candidate is a link dependency of the proof.
|
||||
|
||||
- [ADR-0084: Engineering UI toolkit](0084-engineering-ui-toolkit.md) - Dear ImGui 1.92.9b pinned (M9.8a) and integrated as the engineering client overlay with toolkit-first input routing (M9.8c).
|
||||
- [ADR-0090: M10 QUIC transport](0090-m10-quic-transport.md) - msquic 2.6.2 with OpenSSL 3.5.9 LTS (TLS 1.3 only) from pinned sources on Windows and Linux; DATAGRAM frames for superseding state, streams for reliable actions; M9 TLS/TCP kept as dev fallback; owned impairment relay; exact CA pinning due in 10.2b.
|
||||
- [ADR-0092: M10 intentions and durable outcomes](0092-m10-intentions-and-durable-outcomes.md) - realtime intentions (datagram receipts and a cumulative simulated watermark) and account-scoped actions with stable ids, receipts and final outcomes (committed_no_effect / not_committed); no biological effect until organisms exist; durable action records in the commit transaction (10.4b).
|
||||
- [ADR-0091: M10 session identity and control](0091-m10-session-identity-and-control.md) - provider-independent 128-bit AccountIds, ECDSA P-256 session grants (regions hold public keys only, signed environment byte), per-account serials where the newest grant wins, takeover of an existing session, in-session refresh, bounded attempt rates; identity adapter and issuer as a library; durable control lease follows (10.3c).
|
||||
- [ADR-0089: M10 timing and budgets](0089-m10-timing-and-budgets.md) - ratified 50 ms tick, 1 s flush with final outcomes p95 <= 1.5 s, responsiveness LAN p95 <= 150 ms / 100 ms RTT <= 250 ms, reference hardware; derived scheduling, sequence, baseline, queue/byte/work budgets and the exact/tolerant determinism contract; records the per-tick biology coupling.
|
||||
- [ADR-0088: Rendered deployment policy](0088-rendered-deployment-policy.md) - the deploy policy check renders every overlay with pinned kustomize v5.8.1 (checksum-verified, explicit preparation) and validates effective objects; unsupported kustomize features refused.
|
||||
|
||||
@@ -9,7 +9,8 @@ pinning (`evo_network_quic`, M10.2b); loss/head-of-line measurements (M10.2c,
|
||||
superseding state on DATAGRAMs and reliable actions on the ordered stream. Session
|
||||
identity and control (ADR-0091, M10.3): ECDSA-signed account-scoped grants
|
||||
([session-grant-v1](../../schemas/network/session-grant-v1.md)), newest grant wins; login over
|
||||
QUIC per [session-v1](../../schemas/network/session-v1.md). The scoped M9 dev session (TLS 1.3, protocol v1, dev-only grants)
|
||||
QUIC per [session-v1](../../schemas/network/session-v1.md). Intentions and actions
|
||||
(ADR-0092): receipt, simulated watermark and final outcome are distinct answers. The scoped M9 dev session (TLS 1.3, protocol v1, dev-only grants)
|
||||
is specified in [DEV_SESSION_PROTOCOL](../networking/DEV_SESSION_PROTOCOL.md) and
|
||||
ADR-0082. M0 has no networking. Steam distribution follows later through
|
||||
an identity-provider adapter; core account IDs are independent of Steam IDs.
|
||||
|
||||
@@ -4203,3 +4203,37 @@ repeated; Clang 19 ASan/UBSan session and network tests; Windows MSVC 19.44 pres
|
||||
build and CTest 4/4 (binary timestamp checked).
|
||||
Not done: evo-server and client integration (10.4), ASan of the PostgreSQL suite,
|
||||
a real two-process cross-region takeover with QUIC clients, cluster migration (no deploy).
|
||||
|
||||
## 2026-10-03 — M10.4a intentions, actions and admission (ADR-0092)
|
||||
|
||||
Implemented session-v1 types 6-12 and Welcome server_tick (codec), `IntentAdmission`
|
||||
(evo_network_protocol), RegionSessions host facts, datagram intentions, actions, queries,
|
||||
carry/committed and outcome delivery, and the client API (intentions, actions, queries,
|
||||
receipts, watermark, outcomes).
|
||||
Unit tests (`evo-network-tests`): round trips of every new message, every truncation and
|
||||
extension refused, an intention with appended state claims refused, invalid statuses and
|
||||
results refused; admission refusals in order (other session, unknown session, stale epoch,
|
||||
vector, replayed sequence, tick in the past, beyond 8 ticks, same tick, rate after 8
|
||||
attempts, not ready); cumulative watermark and its 20-tick repeat; action receipt,
|
||||
pending query, zero id, unknown kind, wire kind 257 (no truncation), duplicate retry keeping
|
||||
the original tick, action rate, carry once, commit to `committed_no_effect`, other
|
||||
account's query, outcome visible to a reconnected session, never admitted twice, unresolved
|
||||
bound across intentions and actions, abandon finalizing only uncarried actions, bounded
|
||||
final outcomes.
|
||||
Loopback QUIC (`evo-quic-session-tests`) with a simulated host: Welcome server tick;
|
||||
intention receipt, outside window, watermark after the tick runs, not ready; action receipt,
|
||||
pending query, carry, durable outcome, duplicate receipt then the same outcome, the outcome
|
||||
from a reconnected session, an uncarried action finalized `not_committed` by an epoch
|
||||
change, intentions in the new epoch; a raw peer appending state claims to an intention
|
||||
datagram is closed with `protocol`.
|
||||
|
||||
Found and fixed during development: an 8-bit `ActionKind` decoded from the u16 wire field
|
||||
would have truncated unknown kinds to known ones (now raw u16 validated by admission);
|
||||
unchecked optional accesses in the client (tidy).
|
||||
|
||||
Executed: Linux GCC 14 preset `quic` CTest 4/4; session tests 10/10 repeated; Clang 19
|
||||
ASan/UBSan session and network tests; clang-tidy 19 on the new and changed sources and
|
||||
tests; format check; Windows MSVC 19.44 preset `quic` build and CTest 4/4 (binaries rebuilt,
|
||||
timestamps checked).
|
||||
Not done: durable action records and crash resolution (10.4b), evo-server wiring and
|
||||
process kill tests (10.4c).
|
||||
|
||||
Reference in New Issue
Block a user