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

58 lines
3.7 KiB
Markdown

# Portable retained-plan checkpoint upgrade
Authority: [ADR-0167](../docs/adr/0167-retained-plan-checkpoint-upgrade.md).
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](cellular-lives-v8.md) stores the additional
plan references/history; [raw trace 4](cellular-region-batch-v4.md) 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](ecology/regional-cellular-census-v2.md), including verified
history and registered capture. It separates plan references from expressed
resident stock; population and migration support remain separate.
[ADR-0171](../docs/adr/0171-retained-plan-exact-populations.md) 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](../docs/adr/0168-durable-retained-plan-admission.md) 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.