Files
aevolution/schemas/ecology/registered-world-census-coverage-v1.md
dingo 27ec5729bf
Foundation / checks (deploy) (push) Successful in 5s
Foundation / checks (ecs) (push) Successful in 2m26s
Foundation / checks (network) (push) Successful in 21m1s
Foundation / checks (client) (push) Successful in 22m9s
Foundation / checks (tsan) (push) Successful in 24m36s
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 33m38s
Foundation / checks (checks) (push) Canceled after 33m49s
M12.7: reconcile pending migration evidence in census snapshots
2026-10-18 21:14:53 -04:00

3.1 KiB

Registered-world cellular census coverage v1

Semantic backend contract under ADR-0154, not a wire or biological codec. API: load_registered_cellular_census_snapshot; SQL schema 50.

The durable source of required regions is the existing authority registry, evolution.region_leases. The new least-privilege read function load_world_region_catalog_v1(world) returns ascending region/frame pairs for one nonzero world. It reads at most 65 rows using the existing world/region key. There is no new table or parallel enrollment write. Missing table/function access is an error, not permission to fall back to a caller-declared subset.

All registered rows count, including released/expired holders, inactive or empty regions, unsupported profiles and regions lacking a usable committed head. No checkpoint, profile, activity or living-count filter may hide a required owner. Integral numeric IDs are normalized without narrowing the unsigned 64-bit domain.

Inside the snapshot adapter's owned short read-only repeatable-read transaction:

  1. Read the registry before selecting heads. Empty means unknown world coverage. A 65th row means the world exceeds this query's 64-region work bound. Both cases fail; neither is an empty/partial census or a game-world size restriction.
  2. Require exactly one supplied store/grant resource for every registered region, with matching frame. Supplied resources remain strictly ordered/nonzero and must live through the call. Missing, extra, duplicate or foreign resources fail.
  3. Select every registered head and require its recorded frame to match the catalog. Read all metadata from the same database snapshot. Missing heads fail.
  4. Finish the metadata transaction, then fully replay each exact immutable cut and run the unchanged common-boundary/genome/resident census-set checks.
  5. Return the captured catalog, exact head/manifest pairs and scoped census only if all steps succeed. Failures return no partial evidence or zero filling.

Committed enrollment after catalog selection belongs to the next snapshot; uncommitted enrollment is invisible. The result covers the registered set of its selected database view, not the latest state at return. Atomic paired migrations cannot straddle that view. Existing fences during replay retain their meaning; genesis-only recovery has no fenced transition to check. Results grant no live authority, including when a registered holder is released or expired.

The caller-declared API remains available with its previous scoped semantics. Schema 51 additionally binds registered results to a database history domain captured in the same view. Schema 52 also binds pending migration evidence to that view and fully verifies retained capsules/ghosts without adding ghost stock. Registered coverage alone adds no viable-reserve or outside-store reconciliation, durable accepted extinction record, client endpoint or permission. A consistent registered-region cut alone cannot accept terminal world extinction. Missing, stale or unsupported ecological evidence stays unknown.