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
58 lines
3.7 KiB
Markdown
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.
|