Files
aevolution/docs/biology/CELLULAR_POPULATION.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.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 or biological cross-region migration. The existing 256-life ceiling remains; target-host service capacity is separate.

ADR-0171 extends the portable owner to retained-plan rules 10/owner 8 using envelope 3 and population batch 3 (nested raw trace 4). An explicit envelope-2/rules-9 inheritance candidate retains tags, policy and sequence. Each member keeps its complete expressed body and offspring plan; grouping by expressed genome never erases plan differences. Projection 2 observes cohort plan holders separately from owned stock. Durable population mappings/admission and biological migration remain separate work; there is no automatic live upgrade, approximation or compression claim.

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 adapter now uses dedicated profile 5 (ADR-0142), leaving raw profile 4 unchanged. ADR-0143 adds owned bounded unattended intervals. New entry and interval publication require fully suspended controlled cells; active/lingering cells stay on the existing raw path so permanent endings remain correct. Older recorded traces remain verifiable. The selector is opt-in and off by default; see durable populations and owned intervals for evidence and the remaining production qualification.

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.