Files
aevolution/docs/engineering/M12_OWNED_POPULATION_INTERVALS.md
T
dingo 0a8962b57e
Foundation / checks (deploy) (push) Successful in 5s
Foundation / checks (ecs) (push) Successful in 2m28s
Foundation / checks (tsan) (push) Failing after 18m22s
Foundation / checks (network) (push) Successful in 20m38s
Foundation / checks (client) (push) Failing after 21m6s
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 46m54s
Foundation / checks (checks) (push) Canceled after 47m3s
M12.4: retain and settle owned population intervals
2026-10-17 17:31:05 -04:00

65 lines
4.0 KiB
Markdown

# M12.4b owned unattended population intervals
ADR-0143 and schema 45 add one durable admitted interval per population region.
The source commit/digest and exact begin/end ticks identify it; immutable admission
and settlement journals retain its history. A bounded pending pointer makes work
lookup independent of accumulated history. Publication settles that exact interval
atomically with its checkpoint. An aborting transaction leaves it pending.
The optional worker collects at least 20 due ticks (one second), services at most
64 unchanged 50 ms steps, and consumes debt only from a confirmed head. The final
short u64 remainder cannot wrap or wait forever. A recovered pending interval runs
with zero newly due time; it does not consume or delay fresh wall-time accounting.
Admission uncertainty retains the same source/end request and pauses readiness.
Checkpoint uncertainty retains its complete prepared bytes. Neither a timeout,
duplicate request nor new lease may resample work, skip its prefix or reopen it.
The host reports `evo_region_ecological_pending_ticks` (0..64), separately from
local tick debt and checkpoint age. Fresh unadmitted wall time remains paused
during outage/uncertainty. This does not introduce whole-world catch-up.
## Suspension and retained compatibility
Inspection of ADR-0128 and the cellular kernel found an important restriction:
frozen intentions stop controlled biology, but lingering cells remain vulnerable
for 200 ticks. New population entry and interval preparation therefore require
every controlled cell fully suspended. Linger/death stays on the existing raw
cellular path, which records account endings before population entry. This changes
operational admission, not immunity, movement, funding, biology versions or goldens.
Existing profile-5 envelopes and recorded frozen/lingering traces retain their
meaning. Recovery verifies them and allows reverse materialization; new biological
publication from such an unsafe source is refused. Either profile's recovery now
reconciles retained owned corpses, including a legacy post-commit/pre-ending crash.
The portable general population model and its active-player qualification remain
unchanged; the durable unattended profile has the stricter admission contract.
## Evidence and limits
The private PostgreSQL fixture uses funded reserved founders and descendants. It
publishes the real 201-tick raw suspension prefix before new profile entry. Tests
cover duplicate/conflicting/oversized admissions, partial settlement refusal,
conversion/profile-exit refusal while pending, a replacement epoch retaining the
same interval, exact settlement, old retry without reopening work, and revoked
private publisher access. Publisher SIGKILLs before transaction/after commit/after
pipe ACK also verify whether the interval remains pending or settled.
An actual owning host is drained/recreated with pending work. It restores the
same head, refuses early materialization, services the recorded interval with
zero new due ticks, and then permits player operations. Lease-row contention
causes a real admission timeout; readiness and biology stay paused until the
identical request reconciles, then its exact reference trajectory publishes.
The 65-tick local request is capped at 64; a 19-tick routine window waits.
Fixed-clock tests check recovered-prefix accounting, bounded retry without fresh
debt, overflow/refusal and metrics shape/cardinality. Legacy trace replay and new
active/lingering-source refusal are separate contract checks. Executed compiler,
sanitizer and database results are recorded in [VALIDATION](VALIDATION.md).
This closes the scoped interval-admission/recovery segment. Biological cross-region
escrow, delayed boundary coupling and stock-in-transit audits remain M12.4 work.
No probe inventory stands in for biological stock. Deployment-host costs, mixed
controlled/cohort publication, environmental coupling, integrated history/global
extinction and actual multi-day/product qualification remain open. Production
entry stays disabled by default; no live region or World0 was changed.