7.2 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-2a: bounded creation-batch codec and detached funded replay. Empty batches preserve all biology. Host/manifest chain authorization remains required.
- 11.2c-2b: portable primitive checkpoint profile 3, history profile 2, complete payload closure and bounded birth traces. SQL admission remains disabled until guarded publication atomically binds bodies and reservations.
- 11.2c-2c: schema v16 guarded primitive publication atomically validates control, reservations and birth bindings with the checkpoint head. Exact retries converge, conflicting evidence and stale control refuse, and runtime can read immutable life bindings. Full PostgreSQL migrations, process, recovery, backup/restore, host-loss, upgrade and privilege checks pass.
- 11.2c-2d: C++ object-store publication, verified predecessor replay, exact-byte retry and profile-3 recovery adapter with SQL life-binding reconciliation. Full PostgreSQL/process/recovery and upgrade qualification passes.
- 11.2d-1: versioned v5 new-life request/receipt/outcome/query wire codec, keeping v4 the default and rejecting v5 at the current server until negotiation and life handling are implemented. Network and QUIC suites pass; targeted manual compile and link were needed because the normal Ninja build invocation idles. Host admission and durable execution are a separate slice.
- 11.2d-2 implementation: schema v17 records an immutable
existing_liferefusal for each conflicting request, offers an authenticated world/account/ request query, and cancels unpublished reservations atomically when control changes region/epoch. Published bindings remain unchanged; v5 now distinguishesexisting_lifeandcancelledfrom query-onlypending/unknown. Typed adapter, migration, codec and PostgreSQL tests/docs are updated. Validation is pending: the affected C++ files were compiled directly with MSVC and the updated network and QUIC suites passed (2/2 and 5/5). PostgreSQL 18.6 is unavailable here, so migration and adapter integration tests remain unrun. Host work remains paused until database validation passes. - Remaining 11.2d after 11.2d-2 validation: primitive-capable region host, server admission/execution, crash-boundary qualification and readiness integration. The generic two-profile host still cannot serve profile 3.
No deployed world has been provisioned or changed by this work.