3.3 KiB
ADR-0161: Durable migration of funded maturing wildlife
Status and scope
Accepted for the scoped M12 durable maturation-transfer gate, 2026-10-19. Extends ADR-0147–0149/0156/0158/0160. No biological rule, route, automatic upgrade, default provisioning, new state table or live deployment is selected.
Decision
Schema 54 admits precisely two migration pairs: equal bundle-10 predecessors with trace 1 (rules 8), or equal bundle-11 predecessors with trace 2 (rules 9). Require matching representations, world/frame/tick/quantum and compatible geometry, plus the existing complete portable biological replay. Mixed bundles, cross-rule traces and unknown versions fail. Existing retained bytes and migration checksums remain exact; no SQL normalization of traces, manifests or digests is used.
Reuse the existing immutable preparation, staging, abort and paired receipt journals and pending pointers. Source preparation retains all stock and freezes its exact head. Destination staging retains verified capsules and a read-only ghost at its exact captured head. Ghosts and nonresident source history own no additional stock. Both roles remain paused across lease expiry/replacement; timeouts do not abort or activate anything. All work/choice/birth guards remain.
The existing paired publisher requires both current fences, retained staging, both exact heads and supported result manifests preserving each predecessor's bundle. Publish both results, the common receipt and pointer settlement in one transaction. Failed second publication rolls back the entire pair. Abort and commit remain exclusive. Exact retries retain complete original bytes even under replacement authority. No no-tick transfer runs maturation or re-derives bodies.
Recovery and registered pending-handoff census verification select biology from the retained bundle/trace pair, replay both complete candidates, bind both result digests and compare full local bytes. Missing or false evidence fails the entire operation/query without zero, partial or old-head fallback. Settled hosts reload and verify their committed head before resuming. Subsequent ordinary raw/cohort ticks continue funded growth under the retained rules and environment.
Alternatives, risks and qualification
A new journal duplicates existing atomic authority. Reusing trace 1 changes a retained biological contract. Publishing endpoints separately or activating a ghost duplicates ownership. Extend the exact allowlist and retain the existing workflow instead. This adds another replay/admission matrix and retained-object cost; it does not remove the shared database's availability requirement.
Require both representations and real player-origin juveniles, complete paired stock/history equality, continued growth, freeze/staging recovery, retry/conflict, pending-work/upgrade refusal, unknown replies, process kills, failed second insert, abort/commit races, stale/replacement owners and registered census capture races. Retain the rules-8 matrix and add rules-9 coverage, version-mismatch SQL refusal and old-history replay. Run Release, sanitizers, analysis and the full private persistence/backup/DR/checksum/privilege qualification. Multi-host network and storage failure, linked environmental budgets, autonomous sustainability, actual elapsed days and product acceptance remain separate M12 gates.