Files
aevolution/schemas/cellular-inheritance-upgrade.md
T
dingo a898a35e1b
Foundation / checks (ecs) (push) Successful in 2m26s
Foundation / checks (deploy) (push) Successful in 4m57s
Foundation / checks (network) (push) Successful in 20m53s
Foundation / checks (client) (push) Successful in 22m12s
Foundation / checks (tsan) (push) Successful in 39m45s
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 45m41s
Foundation / checks (checks) (push) Canceled after 45m43s
feat(lifecycle): preserve inherited plans in exact populations
2026-10-19 15:19:43 -04:00

3.7 KiB

Portable retained-plan checkpoint upgrade

Authority: ADR-0167. Bundle 12 is exactly {rules=10,envelope=8,habitat=2,coordinate=1,genome=1,development=4,founder=3,archive=2,mutation_state=1}. It is raw profile 4/history 4 only, with the unchanged 360-byte manifest and 50,000-microsecond quantum. Owner 8 stores the additional plan references/history; raw trace 4 records its subsequent biological steps. Legacy trace defaults and version tuples remain.

Only a supported, structurally valid, non-genesis raw bundle-11 predecessor at positive tick may derive a bundle-12 candidate. Require nonzero predecessor digest, a distinct nonzero commit, next sequence without wrap, a same-frame nonzero holder/epoch and valid build/payload bindings. The result preserves world, region, frame, profile, history, quantum and biological tick. Its exact predecessor reference is retained and batch evidence is empty. No skipped prerequisite, downgrade, repeated upgrade or bundle-12 genesis exists.

The payload operation fully restores the source under its declared manifest and uses the detached owner-7/rules-9 -> owner-8/rules-10 upgrade. Preserve all expressed bodies/genomes, inventories, growth/damage, position, habitat, heat, nursery, source provenance, archive revisions/births/deaths, boundary flows, presence and standing offers. Initialize local living/corpse offspring plans to their current expressed genome and retain no invented plan selections. The complete target must restore canonically under the result tuple. Ordinary successors retain bundle 12; biological continuation requires trace 4.

These functions are portable and storage-free. They validate structure, owner identity/tick and canonical biology, but do not compute or verify SHA-256 values, contact a database, reserve identities or grant authority. The I/O caller must independently verify both manifest and object digest bindings before relying on the result. supported() describes reader support only. Legacy revision-bundle helpers remain the trace-3 admission set and exclude bundle 12.

No population envelope maps to bundle 12. Profile transitions, population successors/restore, census and migration remain unsupported for this owner in the portable upgrade segment. Missing or unsupported projections cannot establish zero life or extinction. ADR-0169 subsequently adds explicit raw census projection 2, including verified history and registered capture. It separates plan references from expressed resident stock; population and migration support remain separate. ADR-0171 subsequently qualifies portable population envelope/batch 3 and projection-2 cohort counts. It adds no checkpoint tuple mapping or durable population admission. The portable candidate functions perform no durable publication.

ADR-0168 adds schema 55 and migrate_cellular_inheritance_profile as the separate durable adapter. It admits only this exact raw pair through the existing fenced atomic evidence/result/head transaction, retains both complete manifests and payloads, and rederives the complete target during recovery. Pending intervals/handoffs and unbound mutation choices refuse the upgrade. Subsequent biological batches require trace 4 and mutation outcomes 1 (life died), 3 (declined) or 4 (plan applied); legacy result meanings remain versioned. Exact retry bytes/receipts, ambiguous publication and stale-writer fencing use the existing contracts. No worker or DEV/default opening selects bundle 12 automatically.