feat(lifecycle): qualify portable maturing wildlife transfers
Foundation / checks (ecs) (push) Successful in 2m26s
Foundation / checks (deploy) (push) Successful in 4m12s
Foundation / checks (network) (push) Successful in 20m57s
Foundation / checks (client) (push) Successful in 22m9s
Foundation / checks (tsan) (push) Successful in 28m49s
Foundation / checks (postgres) (push) Successful in 1h5m2s
Foundation / checks (checks) (push) Successful in 1h17m42s
Foundation / postgres-tools (push) Successful in 1m10s
Foundation / server-image (push) Successful in 3m51s
Foundation / image (push) Successful in 4m54s

This commit is contained in:
dingo
2026-10-19 09:09:15 -04:00
parent 274f62cb89
commit 5e168d67c3
22 changed files with 412 additions and 41 deletions
+16
View File
@@ -1,5 +1,21 @@
# Project status and next steps
## Portable transfer of maturing wildlife - 2026-10-19
[ADR-0160](adr/0160-portable-maturing-wildlife-transfer.md) qualifies exact
portable rules-9 transfer and distinct trace 2 for raw/cohort owners. Real
juveniles grow before and after transfer while life fields remain exact at the
no-tick boundary. Mixed rules and cross-rule replay fail. Trace 1 retains rules 8;
durable adapters and SQL continue to refuse trace 2/bundle 11.
Native Release passes **81/81**, GCC transfer/restart **2/2**, ASan/UBSan **2/2**,
private Release/ASan matrices (**22/63 s**), analysis and formatting. Seven old
trace/result/continuation artifacts retain exact bytes. The DEV session window
is refreshed in the same commit and future pushes must refresh it; offline
rendered policy and all 46 policy self-tests pass. See
[validation](engineering/VALIDATION.md). Durable rules-9 migration and remaining
ecology/soak/product gates remain open.
## Census of funded maturing owners - 2026-10-19
[ADR-0159](adr/0159-maturing-cellular-census.md) admits rules-9/owner-7 retained
@@ -0,0 +1,54 @@
# ADR-0160: Portable transfer of funded maturing wildlife
## Status and scope
Accepted for the scoped M12 portable maturation-transfer prerequisite, 2026-10-19.
Extends ADR-0144/0157/0159. No new biological rule, SQL schema, durable migration
admission, automatic route, live upgrade or production enablement.
## Decision
Allow exact no-tick transfer candidates between owner-7 cuts with equal rules 9,
using the same complete group, eligibility, placement, history, identity, stock
and boundary-flow checks as rules 8. Raw and population envelope 2 use the same
biological operation. Preserve realized growth, body, reserve, damage, mutation
state, coordinates and every other life field exactly. Neither endpoint matures
at the transfer cut. Subsequent destination ticks apply their retained rules and
environment; source nonresident history never owns or grows a second copy.
Reject mixed rules 8/9 before deriving either result, even at otherwise equal
cuts. The existing format-upgrade API remains rules 8 only; moving a rules-9
owner does not repeat an upgrade or create another source of biological rules.
Add portable migration trace 2, magic `AEVMIG02`, version 2. Keep the same bounded
layout, request/endpoint/member/inventory fields, reserved zero, checksum and size
limit as trace 1. Version 2 means equal rules-9/owner-7 inputs; version 1 retains
equal rules-8/owner-7 inputs and its exact bytes. Population inputs use envelope 2.
Record selects the version from the supported predecessor rule. Replay requires
that exact version/rule pair in addition to the trusted request and complete
rederived candidates. Unknown versions, mixed magic/version and cross-rule trace
replay fail. No checksum or embedded request grants authority.
The durable adapter remains bundle 10/trace 1 only, including explicit portable
trace-version refusal. A later gate must admit bundle 11/trace 2 through source
freeze, destination staging, atomic paired publication and complete recovery,
including registered pending-handoff census evidence. Portable support alone
must not silently expand those SQL or activation contracts.
## Alternatives, costs and qualification
Reusing trace 1 would change a retained rule contract. Copying or re-deriving adult
bodies would change actual biomass. Treating transfer as a tick would progress
frozen life. A separate migration algorithm risks representation drift. Retain
one operation, require equal biological rules and distinguish replay evidence.
The additional version adds a small dispatch branch and a second qualification
matrix without increasing allocation bounds or dependencies.
Require real player-origin buds, growth before/after transfer, exact life equality
at the cut, raw/cohort equivalence, source nonresident/census exclusion, combined
channel conservation, repeated return trips, collision/capacity/eligibility
refusal, canonical codec attacks, old bytes, cross-rule refusal and independent
process replay/continuation. Run Release, ASan/UBSan, analysis and affected private
durable regressions. This does not qualify sustainable generations, linked
geometry/environmental budgets, cross-host partitions, actual days or M12 product
readiness.
@@ -4,8 +4,11 @@ ADR-0158/schema 53 admits the explicit same-profile bundle-10 -> 11 maturation
upgrade through the existing immutable version journal and lease/head fence.
Recovery rederives the complete retained transformation; raw trace 3 and population
batch 2 keep their layouts. Profile changes preserve the tuple. No new genesis,
automatic upgrade or default change. Biological migration for rules 9 remains
unsupported. [ADR-0159](../adr/0159-maturing-cellular-census.md) admits its exact
automatic upgrade or default change. Durable biological migration for rules 9
remains unsupported. [ADR-0160](../adr/0160-portable-maturing-wildlife-transfer.md)
adds portable equal-rules-9 transfer candidates and separately identified trace 2;
the durable adapter still admits only bundle 10/trace 1.
[ADR-0159](../adr/0159-maturing-cellular-census.md) admits its exact
retained stocks to census projection 1 and the existing verified history and
registered snapshot readers. Mixed rules-8/rules-9 regional cuts fail the complete
query. Unavailable evidence cannot become zero life. See
@@ -42,7 +42,13 @@ need an explicit versioned maturation contract and ecological qualification.
ADR-0157 subsequently supplies opt-in portable rules-9 maturation with a funded
multi-generation family proof. These transfer contracts and durable bundle 10
remain rules 8; they refuse rules-9 migration until separately qualified.
originally remained rules 8. ADR-0160 subsequently qualifies portable owner-7
transfers between equal rules-9 cuts with distinct trace 2. It preserves every
realized growth/body/reserve field without a tick and rejects mixed rules.
Real juveniles grow before and after transfer with finite declared destination
food; raw/cohort biology and recorded continuation agree. Rules-8 trace 1 retains
its bytes and meaning. Durable bundle-11/trace-2 admission, pending freeze/staging,
atomic paired publication and complete recovery remain a separate gate.
This is not the durable escrow gate. No prepared candidate may become an active
destination owner before a future fenced transaction commits both heads and
+8
View File
@@ -124,6 +124,14 @@ checked. Mixed rules 8/9, unavailable objects/builds and stale grants refuse the
complete query. No new SQL schema, redundant census journal or biological rule.
This does not close viable-store reconciliation, extinction or M12 ecology gates.
ADR-0160 qualifies portable transfer between equal rules-9/owner-7 cuts and
separately identified migration trace 2. No transfer tick, growth reset or stock
re-derivation is introduced; real pre/post-transfer growth, exact raw/cohort
biology, replay/process continuation and refusal matrices are checked. Trace 1
retains rules 8. The durable adapter still rejects trace 2/bundle 11: explicit
freeze/stage/paired publication/recovery and registered pending-handoff census
qualification are required before rules-9 durable migration is supported.
M12.6a's [regional census projection](../../schemas/ecology/regional-cellular-census-v1.md)
independently implements local current-genome and descendant-closure queries.
It keeps suspended stock and retained zero-carrier ancestry, separates exact cohort
+64
View File
@@ -1,5 +1,69 @@
# Validation report
## 2026-10-19 - Portable transfer of maturing wildlife
[ADR-0160](../adr/0160-portable-maturing-wildlife-transfer.md) admits exact
portable transfer between equal rules-9/owner-7 cuts, raw or population envelope
2. Migration trace 2 has distinct magic/version and the existing bounded layout.
Trace 1 retains rules 8. Durable metadata/retry adapters explicitly refuse trace
2; SQL schema 53 and bundle-10 migration admission remain unchanged.
Executed locally:
- MSVC default Release full CTest **81/81 passed, 22.13 s**, with NDEBUG.
- GCC 14 Release migration contract/process restart **2/2 passed, 3.29 s**.
- Clang 19 ASan/UBSan migration contract/process restart **2/2 passed, 87.00 s**,
without sanitizer reports.
- The complete affected private PostgreSQL population/history/migration fault
matrix passed **exit 0, 22 s** (19 s population). The same ASan/UBSan matrix
passed **exit 0, 63 s** (60 s population), without reports.
- clang-tidy 19 passed on cellular lives, transfer, trace and durable migration
sources and both affected tests. Repository clang-format 19 and
`git diff --check` passed.
- Seven retained rules-8 restart artifacts from the preceding native run match
byte-for-byte: raw/cohort trace 1, both complete output pairs and the continued
population snapshot. No old golden or numbered SQL migration changed.
Rules-9 repeats the raw transfer/census/conservation matrix, 100 return trips,
imported death/decay, body-overlap refusal, whole-group capacity refusal and the
complete raw/cohort codec/replay matrix. Every transferred life field remains
equal at the no-tick cut. Cross-rule replay, mixed magic/version, unknown version,
malformed bounds, altered members/material and incompatible trusted requests
fail. Fresh processes restore/replay both rule versions in both representations,
then reproduce the exact recorded 64-tick destination continuation.
A separate real-bud fixture verifies funded growth before transfer, exact
raw/cohort candidate biology, and further funded growth after transfer. Finite
destination food is declared in its opening fixture; no reserve/body credit or
reusable boundary-flow stock is granted. Complete combined per-channel stock
closes and destination growth retains the unchanged transfer ledger. Mixed rules
in either raw direction and in cohorts fail; vulnerable controlled life remains
ineligible. Rules-9 cannot repeat the old format-upgrade API.
Private raw/cohort durable tests additionally submit canonical trace 2 to retry
freeze/stage, direct staging and SQL source preparation. C++ refuses it before
publication; SQL independently returns 22023 before duplicate lookup. Existing
rules-8 freeze/stage/commit and rules-9 census regressions continue to pass.
The initial new codec-tampering fixture triggered GCC's optimized bounds warning;
using checked vector access resolved it before the complete qualification above.
Per maintainer instruction, the DEV route's `REGION_SESSION_WINDOW` is refreshed
in this same scoped commit, with a unique UTC activation and a four-hour absolute
expiry. Rendered deployment policy passes **75 objects / 74 files, 138 rendered
objects / 17 overlays, 0 failures**. The working agreement now requires a refresh
before every push. Deployment-policy self-tests pass **46 cases, 0 failures**,
including rejection of overlong windows; the final fresh window also passes the
rendered policy check. This is desired Git configuration, not a live connectivity or
Argo application observation.
The full backup/DR, TLS relay and SQL privilege/checksum suite was not repeated;
no SQL, durable publication layout or transport algorithm changed. Temporary
private Unix-socket databases were used; no live database, deployment or World0
operation occurred. TSan was not rerun because shared-memory scheduling did not
change. Durable rules-9 migration, linked environmental resources/geometry,
autonomous generations, target-host costs, actual days and product gates remain
open; this portable prerequisite does not complete M12.
## 2026-10-19 - Census of funded maturing owners
[ADR-0159](../adr/0159-maturing-cellular-census.md) admits rules 9/owner 7,