5.0 KiB
M11.2: Primitive lives and persistent control
2026-10-09. Server-side continuation of M11.1 at 93e1ab0.
ADR-0100 is accepted in
direction: the maintainer authorized recommendations and implementation choices
for later review. This plan does not close 11.2.
Contract review
Reviewed PROJECT_VISION, ENGINEERING_CONSTITUTION, SYSTEM_OVERVIEW, SIMULATION_ARCHITECTURE, PERSISTENCE_ARCHITECTURE, REGION_DURABILITY, REPRODUCTION_MODEL, ENERGY_MODEL and ADRs 0062, 0091, 0092, 0098 and 0099. Inspected founder, development/metabolism, lineage/archive, host, checkpoint, batch and account-control headers and lineage-region/account-control tests.
closure_is_required in lineage_region_tests correctly rejects an extra living
organism outside the two fixture bindings. Migration 0011 / ADR-0092 permits
duplicate no-effect publications; biological effects need the losing checkpoint
rejected in full. ADR-0100 proposes explicit contract replacements for gameplay.
ADR-0099's full-grown founder analysis is an assumption, not funded creation.
Delivery segments
Validate each segment, record evidence/limits in VALIDATION.md, then commit and push its scoped changes. Gate completion needs all applicable rows; library tests alone are not a durability proof.
| Segment | Modules | Acceptance |
|---|---|---|
| 11.2a: contract and funded creation | Biology budget helpers if needed; server lifecycle; accounting callers; docs/tests | Settle funding, growth/reserve, placement and ADR-0100; equal old/new-account starts; atomic source/body/reserve/heat/provenance; insufficient channels, allocation, placement and overflow leave state unchanged |
| 11.2b: recoverable cellular state | Cellular state owner; codecs; persistence profile; lineage closure | New profile/history declaration; exact timers/reservations/retries; hostile bounds/versions/bindings refused; old profile goldens unchanged; no synthetic actors adopted as wildlife |
| 11.2c: durable ownership | Migration/adapters; account control; publication; host | Real PostgreSQL concurrent spawn/takeover, stale generations/leases, exact/changed retries; one nonterminal life across regions; losing candidate never publishes inventory; uncertain commit reconciliation; no runtime-role bypass |
| 11.2d: server integration | Session/host; versioned protocol; headless probe; process tests | Explicit spawn; reconnect to existing life; route to owner; no marker as organism; no offline progress; kills before/after transaction and final answer; same result after restart; network callers/codecs updated |
11.3-11.7 add the biological action loop and complete death/logout behavior. This plan adds no renderer, UI, deployment or dependency.
Fault and equivalence matrix
- New and historical accounts get identical biological starts for identical rule and habitat inputs; historical identities may differ.
- Competing requests in one/two regions publish at most one nonterminal life. Different accounts cannot overdraw the same finite source.
- Exact retry resolves once; changed content conflicts; retry of an old successful spawn after its death returns the old result, never a new life.
- Failed allocation/funding/placement spends nothing and publishes no ancestry. Allocation gaps are allowed; identity reuse is not.
- Kill before upload, before transaction, after commit and after final answer. Recover only the committed cut and exact result.
- Race refresh/takeover with publication; stale control cannot publish a body or replace life ownership.
- Missing body/archive/source debit/provenance/binding prevents readiness.
- Timers/reserves remain exact across restart/offline intervals; terminal history remains terminal, never resurrected by recreating a session.
- Run under NDEBUG, verify channel conservation and canonical round trips.
Validation lanes
Use README commands/presets: Windows debug/release and affected network/QUIC; Linux debug/release, ASan+UBSan, clang-tidy and format-check; real PostgreSQL migration/ownership and process-kill checks when those segments exist. Run network presets whenever a replicated type changes. Record unavailable environments. Local checks do not close ADR-0097's reference-worker qualification.
Progress
- 11.2a: funded in-memory creation, committed as
69101a7. - 11.2b: creation-state codec, committed as
48684d3. Published checkpoint profile registration is still required with 11.2c-2; this codec alone is not durability. - 11.2c-1: schema v15 reservations/identity allocation and durable refusals. These spend nothing and do not publish an organism. Focused PostgreSQL tests and the full migration/process, backup/restore, upgrade and privilege regressions pass.
- 11.2c-1 adapter: typed C++ reserve/refuse API, full unsigned identity range and uncertain-response reconciliation validated in Release and ASan+UBSan.
- 11.2c-2 and 11.2d remain: atomic funded checkpoint publication, reconciliation, host/session integration and crash-boundary qualification.
No deployed world has been provisioned or changed by this work.