From a82290e057987cf89a55efc6edcdb6d908cdec0e Mon Sep 17 00:00:00 2001 From: dingo Date: Sun, 4 Oct 2026 09:24:38 -0400 Subject: [PATCH] Ratify time-based biology rate direction --- docs/adr/0089-m10-timing-and-budgets.md | 14 ++++++++++---- docs/adr/README.md | 2 +- docs/architecture/OPEN_QUESTIONS.md | 2 +- 3 files changed, 12 insertions(+), 6 deletions(-) diff --git a/docs/adr/0089-m10-timing-and-budgets.md b/docs/adr/0089-m10-timing-and-budgets.md index f9cbd94..ebd1faa 100644 --- a/docs/adr/0089-m10-timing-and-budgets.md +++ b/docs/adr/0089-m10-timing-and-budgets.md @@ -5,7 +5,9 @@ Accepted for M10 (2026-10-03). Ratified by the maintainer: tick quantum, durable target, responsiveness target and reference hardware. The remaining values are engineering budgets derived from those and from the M10.1 traces; later M10 segments may change them only with measurements and an amendment here. None of these values is -a game rule (see "Not game rules"). +a game rule (see "Not game rules"). Biological rate representation was separately +ratified on 2026-10-04: rates will be time-based and converted deterministically at the +simulation tick boundary. M11.1 owns the versioned migration and precision contract. ## Context Open question #1 kept the 50 ms tick as a proof value "before M7/M10". M9 delivered a @@ -80,9 +82,13 @@ limit. Checkpoints record `tick_microseconds` (50,000), but the biological value per tick, so the 50 ms value currently fixes real-time biological rates. Consequently: - M10 must not change the quantum. Any change is a versioned rules/genome migration (convert per-tick to per-time units or rescale), with new goldens and a decision record. -- Ratifying 50 ms here ratifies an engineering budget, not those biological rates. The - per-tick units remain M3/M11 biology decisions (OPEN_QUESTIONS #1, M11.1 rules review), - which should either move to time-based units or explicitly ratify them at 50 ms. +- Ratifying 50 ms here ratifies an engineering budget, not the biological rates. The + maintainer ratified the direction on 2026-10-04: M11.1 expresses rates per unit time + and converts them deterministically at each fixed simulation tick. Existing per-tick + genome and checkpoint data require a versioned migration. M11.1 must define unit + scales, fixed-point precision, remainder/rounding behavior, overflow bounds, and + regression evidence that the 50 ms behavior is preserved within the declared error + budget. No existing biological rate is silently rescaled. ## Alternatives considered - 30 or 40 Hz ticks: smoother but 1.5-2x tick work and bandwidth, re-validation of tick diff --git a/docs/adr/README.md b/docs/adr/README.md index 02418c6..fef9cfb 100644 --- a/docs/adr/README.md +++ b/docs/adr/README.md @@ -100,7 +100,7 @@ design. No unadopted candidate is a link dependency of the proof. - [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-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 exact/tolerant determinism; biological rates will be time-based with deterministic tick conversion and versioned migration in M11.1. - [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. - [ADR-0087: Dev session route](0087-dev-session-route.md) - evolution-dev only: void.aeternalisgames.com:7400 via a dedicated internal MetalLB VIP to the region pod, TLS end to end, CIDR-limited, operator-opened windows enforced by evo-server; committed disabled with fail-closed policy tests. - [ADR-0086: Windows client package](0086-windows-client-package.md) - static-runtime Windows x64 ZIP with explicit allowlist, licence texts, build identity, SHA256 manifest, credential guards and deterministic layout; local packaging until a Windows runner exists. diff --git a/docs/architecture/OPEN_QUESTIONS.md b/docs/architecture/OPEN_QUESTIONS.md index b77e8fc..1de14eb 100644 --- a/docs/architecture/OPEN_QUESTIONS.md +++ b/docs/architecture/OPEN_QUESTIONS.md @@ -6,7 +6,7 @@ person. ADR indexes distinguish scoped proof choices from production proposals. | # | Open question | Current position / experiment | Owner; gate | |---|---|---|---| -| 1 | Tick frequency | 50 ms (20 Hz) ratified as the M10 engineering budget (ADR-0089, traces in M10_TIMING_TRACES). Genome v1/metabolism rates are per tick, so the quantum fixes biological rates: convert to time units or ratify at 50 ms in M11.1 | Biology/design; M11.1 (network budget closed in M10.1) | +| 1 | Tick frequency and biological rate units | 50 ms (20 Hz) remains the ratified M10 engineering tick. Maintainer ratified time-based biological rates on 2026-10-04: M11.1 will convert rates deterministically at each tick and migrate per-tick genome/checkpoint fields with explicit units, precision, remainder/rounding and overflow bounds, plus 50 ms regression evidence (ADR-0089). | Biology/design; M11.1 migration | | 2 | Fixed/variable boundaries | Fixed authoritative ticks, host wall-clock pacing; ecology integer multiples | Simulation; M1 | | 3 | ECS | Row/EnTT4 experiment in ADR-0021; retain bounded rows for proof, production choice awaits richer workloads (Flecs remains an alternative) | Engine; M1 and biological component gate | | 4 | Dependency manager | Evaluate vcpkg manifest vs Conan; no runtime dependency for proof | Build; first dependency |