Files
aevolution/docs/biology/CELLULAR_POPULATION.md
T
dingo 5decaa0326
Foundation / checks (deploy) (push) Successful in 5s
Foundation / checks (ecs) (push) Successful in 3m16s
Foundation / postgres-tools (push) Canceled after 0s
Foundation / server-image (push) Canceled after 0s
Foundation / image (push) Canceled after 0s
Foundation / checks (client) (push) Canceled after 13m8s
Foundation / checks (checks) (push) Canceled after 13m12s
Foundation / checks (postgres) (push) Canceled after 13m2s
Foundation / checks (network) (push) Canceled after 13m4s
Foundation / checks (tsan) (push) Canceled after 13m9s
M12.3: persist exact population state and automatic conversion policy
2026-10-17 12:11:10 -04:00

2.9 KiB

Exact cellular local population

ADR-0139 defines the first rules-8 population owner. It owns one biological store and an exclusive representation tag per cohort member; cohort inventory must never be added to current_total again. Untagged living cells are individuals. Views are read-only.

create accepts a non-null rules-8 owner. collapse(genome) tags every eligible zero-account member of that genome, excluding controlled cells. An absent wildlife group or an ineligible wildlife presence rejects the conversion. Repeating collapse returns zero without duplicating anything. materialize removes all tags for that genome; an absent cohort is refused. Neither operation changes the biological snapshot, identities, locations, ages or balances.

advance_tick takes exactly the sorted controlled set and optional controlled mutation selections. It obtains every wildlife intention from the existing controller, merges in life-ID order and uses the same atomic cellular kernel. Failed input validation changes neither biology nor membership. Successful death removes stale ownership tags; funded births begin as individuals. Suspension continues to freeze controlled biology regardless of representation elsewhere.

The model retains exact members and makes no aggregation speedup claim. There is no regional population approximation, process migration or production selector. The existing 256-life ceiling remains; target-host service capacity is separate.

M12.3 adds population envelope 1, detached conversion candidates and an opt-in automatic policy (ADR-0140). The default remains disabled. The policy materializes whole genome groups within 1200 um of any nonsuspended controlled observer, collapses beyond 1800 um of all observers, and retains membership in the intervening band. Biology always advances through the same 50 ms kernel. Policy configuration, sequence, membership and complete biology restore together; loading a checkpoint does not reselect members.

conversion_candidate leaves the predecessor intact and returns the complete exact successor for fenced publication. Successful candidate creation and local checkpoint file writes are not durable production acknowledgements. A dedicated PostgreSQL profile/trace/publication adapter is still required; existing raw cellular profile 4 cannot contain this envelope. The separate-process test demonstrates identical continuation, not power-loss or database-failover safety.

Run evo-cellular-cohorts --verify for the CTest matrix or omit the option for 8192 ticks per case. The executable compares complete canonical state every tick, not just conserved totals. It reports observed conversion/member-tick coverage, events, costs and 16/64/128/256-life active fallback observations. Shared fixture setup is identical to the unchanged rules-8 reference; no alternate test biology or altered golden is used.