Files
aevolution/docs/engineering/M12_OWNED_POPULATION_INTERVALS.md
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

4.0 KiB

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.

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.