Files
aevolution/docs/engineering/M11_2_DELIVERY_PLAN.md
T
dingo c6df1f4e30
Foundation / checks (deploy) (push) Successful in 5s
Foundation / checks (ecs) (push) Successful in 2m0s
Foundation / checks (client) (push) Successful in 12m15s
Foundation / checks (network) (push) Successful in 13m46s
Foundation / checks (tsan) (push) Successful in 8m9s
Foundation / checks (checks) (push) Successful in 33m12s
Foundation / checks (postgres) (push) Successful in 46m13s
Foundation / postgres-tools (push) Successful in 48s
Foundation / image (push) Successful in 2m45s
Foundation / server-image (push) Successful in 4m27s
Add typed primitive life reservation adapter and reconciliation tests
2026-10-09 22:00:49 -04:00

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.