Files
aevolution/schemas/network/m10-budgets-v1.md
T
dingoandClaude Opus 5.5 9f9a93d4c8
Foundation / checks (client) (push) Successful in 14s
Foundation / checks (checks) (push) Successful in 16s
Foundation / checks (deploy) (push) Successful in 15s
Foundation / checks (network) (push) Successful in 18s
Foundation / checks (postgres) (push) Successful in 1m34s
Foundation / checks (ecs) (push) Successful in 1m53s
Foundation / checks (tsan) (push) Successful in 5m44s
Foundation / server-image (push) Successful in 1m0s
Foundation / postgres-tools (push) Successful in 1m38s
Foundation / image (push) Successful in 2m34s
M10.9d: watermark coalescing, budgets v2, evo-load action ids
- IntentLimits::watermark_coalesce (evo-server: every 4, coalesce 4); ADR-0092 amendment.
- m10 load-report splits poll/replicate and commit-tick/other-tick maxima.
- Budgets v2: work p95 <= 25 ms over all ticks, commit ticks <= 50 ms (ADR-0097);
  moving the commit off the tick is a recorded follow-up.
- evo-load: time-based action ids, duplicate_actions, receipts before outcomes;
  drill ramps at 500 ms and judges by v2.
- Refresh the dev session window.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-08 18:00:41 -04:00

3.4 KiB

M10 timing and workload budgets, version 1

Superseded by m10-budgets-v2.md (2026-10-08): per-tick region work is bounded at p95, with commit ticks bounded separately. Kept for history.

Normative table for ADR-0089. "Ratified" values were decided by the maintainer (2026-10-03); "budget" values are engineering limits derived from them and from the M10.1 traces and change only with measurements and an ADR-0089 amendment. Version 1 applies to all M10 segments; a change bumps the version and lists affected tests. None of these values is a biological or game rule. Exception to note: genome v1 and metabolism express rates per tick, so the tick quantum currently fixes biological rates in real time; changing it requires a versioned rules migration (ADR-0089).

Item Value Kind Enforced/tested in
Authoritative tick quantum 50,000 us (20 Hz) ratified checkpoints (tick_microseconds), region host
Commit flush 1,000 ms ratified region host flush_interval
Final outcome delivery p95 <= 1.5 s after admission (dev/stage, nominal network) ratified 10.4, 10.9
Responsiveness (input -> first reflecting snapshot) LAN p95 <= 150 ms; 100 ms RTT p95 <= 250 ms ratified 10.6, 10.9
Reference hardware server: one RKE2 worker (8 vCPU, 31.3 GiB) per region host; client: low-spec VM (M9.8g) ratified 10.9
Input scheduling window server_tick + 1 ..= server_tick + 8 ticks budget 10.4 admission
Client input lead ceil((rtt/2 + jitter)/50 ms) + 1, clamped 2..8 ticks budget 10.4, 10.6
Late input rejected, never rewound budget 10.4
Snapshot cadence (in interest) every tick budget 10.5
Baselines retained server <= 4 per session, each <= 40 ticks old; client <= 2 budget 10.5
Intention sequence u64 per session, from 1, strictly increasing, no wrap budget 10.4
Tick, baseline id u64, no wrap budget 10.4, 10.5
Realtime packet sequence serial-number arithmetic >= 16 bits, window < half space budget 10.2
Session id / epoch u64 server-assigned, bound to connection; epoch on every message; stale closes budget 10.3, 10.4
Intentions per session 1 per tick (8 per 8-tick window, every attempt counted) budget 10.4
Unresolved intentions per session 256 budget 10.4
Realtime datagram payload <= 1,200 bytes budget 10.2
Reliable frame <= 64 KiB budget 10.2
Replication per session <= 16 KiB per tick budget 10.5
Client event queue 1,024 events budget client session
Heartbeat / liveness / handshake 1 s / 5 s / 5 s budget 10.2, 10.7
Sessions per region >= 20 required, 32 default budget 10.9
Per-tick region work p99 <= 25 ms on the reference worker budget 10.9 (measured: evo_m10_tick_work_*, ADR-0097)
Session handling <= 0.5 ms per session per tick budget 10.9 (measured: evo_m10_session_work_*, ADR-0097)
Host input queue 64 inputs, 64 KiB budget region host
Overload response shed interest, refuse new sessions before tick debt budget 10.9a load governor: refuse at p95 >= 15 ms or debt >= 2, shed at p95 >= 20 ms or debt >= 4, relax below 10 ms after 5 s (ADR-0097; provisional until 10.9d)

Determinism: authoritative state is exact given the checkpoint and committed per-tick inputs; timing, delivery, prediction, interpolation and presentation are tolerant (ADR-0089).