M11.2a: fund equal primitive lives from finite spawn pools
Foundation / checks (deploy) (push) Successful in 5s
Foundation / checks (ecs) (push) Successful in 2m44s
Foundation / checks (postgres) (push) Canceled after 0s
Foundation / checks (tsan) (push) Canceled after 0s
Foundation / postgres-tools (push) Canceled after 0s
Foundation / server-image (push) Canceled after 0s
Foundation / image (push) Canceled after 0s
Foundation / checks (network) (push) Canceled after 13s
Foundation / checks (checks) (push) Canceled after 3m9s
Foundation / checks (client) (push) Canceled after 3m8s

This commit is contained in:
dingo
2026-10-09 18:27:55 -04:00
parent 7ee1c68a82
commit 69101a74c2
11 changed files with 533 additions and 20 deletions
+6 -3
View File
@@ -35,10 +35,13 @@ the maintainer chose directional rounding):
11.1 is complete.
- **Next:** 11.2, primitive lives and persistent control. Server side only; client UI
parts of 11.x are deferred to the maintainer. Its
[delivery plan](engineering/M11_2_DELIVERY_PLAN.md) and proposed
[delivery plan](engineering/M11_2_DELIVERY_PLAN.md) and accepted
[ADR-0100](adr/0100-primitive-lives-and-persistent-control.md) identify the new
checkpoint and atomic biological publication contracts needed. Founder funding
remains a maintainer decision; implementation has not started.
checkpoint and atomic biological publication contracts needed. The maintainer
authorized finite spawn funding and implementation choices for later review.
11.2a adds in-memory funded creation: full-grown primitive founders, equal
energy-only reserves, conserved pool/body/heat and exact successful retries.
Durable recovery, world-wide binding and session integration remain.
Open from M10 (BACKLOG):
- the maintainer's native-client observation, moved to the later 2k drill;
@@ -2,10 +2,11 @@
## Status
Proposed for M11.2, 2026-10-09, following M11.1 commit `93e1ab0`.
Server side only; client UI remains deferred to the maintainer. No implementation
or gameplay rule is accepted by this proposal. Founder funding needs a maintainer
decision; ADR-0099 explicitly leaves it to 11.2.
Accepted direction for M11.2, 2026-10-09, following M11.1 commit `93e1ab0`.
The maintainer authorized the recommendations and subsequent implementation
choices, with review after the fact and a commit/push between subsections.
Server side only; client UI remains deferred. Implementation progress and limits
are recorded below; acceptance of the design does not claim completed durability.
## Context and architectural conflicts
@@ -25,7 +26,7 @@ Per AGENTS.md, implementation must not expand through conflicting contracts.
The proposed resolution is a new cellular profile and an atomic publication
contract for biological actions. Existing fixture/probe contracts remain intact.
## Proposed decision
## Decision
### Identity and control
@@ -44,27 +45,34 @@ World-scoped identities need durable allocation and exhaustion checks. Independe
region-local counters cannot guarantee uniqueness. Failed reservations may leave
gaps but never reuse issued identities or publish unfunded organisms.
### Starting body and funding: pending gameplay decision
### Starting body and funding
Recommendation, not an accepted rule:
Accepted for founder-life rules 1; numerical choices are tunable and versioned:
- Every account starts with the same fully grown, undamaged primitive founder.
- Derive body composition and construction energy from development version 2;
do not duplicate biological constants in SQL or server code.
- Give every founder the same versioned reserve. Specify its amount and recheck
the first-bud target before implementation; "small reserve" is not a rule.
- Give every founder 30 seconds of full-speed demand as energy only: 7,824,000 pJ
with development 2. No spare matter. Phosphorus still binds the first bud at
300, 600 and 901 seconds for the analyzed feeding shares; energy does not buy
missing phosphorus.
- Transfer body material, construction energy and reserve from an explicit finite
spawn inventory. Construction energy goes to heat, not usable reserve.
Allocation, placement or funding failure spends nothing.
- Retain source and creation-event provenance. No automatic replenishment or
account-age/ancestry bonus is implied.
Alternatives are local habitat withdrawal or an explicit external input per life.
Rejected for this version: local habitat withdrawal or external input per life.
External input must appear in the conservation equation, never as a transfer from
an empty source. These choices determine whether depletion blocks entry and
whether repeated lives inject resources. Starting growth, reserve, placement and
any replenishment must be recorded as rules/tunables, not inferred from fixtures.
Choosing a funding source alone does not select those other values.
Placement uses a bounded, lexicographically ordered list of server-provisioned
habitat sites in region/frame-local integer micrometres. Select the first free
site; validate that 20 um founder squares do not overlap. This is an explicit
initial nursery configuration, not a planet generation or organism movement rule.
The pool has explicit provisioning provenance and no automatic refill. Each
region owns a disjoint pool; inter-region funding is not implied.
### Atomic publication and retries
@@ -151,6 +159,23 @@ separate from the proven probe experiment.
## Consequences
Settle funding and this profile/publication resolution before enabling spawning.
Only enable network spawning after the profile/publication integration is proven.
The [delivery plan](../engineering/M11_2_DELIVERY_PLAN.md) lists acceptance evidence.
No golden, simulation version, schema or deployed world changes in this proposal.
Existing goldens, simulation versions, schemas and deployed worlds are unchanged.
## 11.2a: Funded creation
`biology::primitive_endowment` derives the full body, energy-only reserve and
435,200 pJ construction price. `server::PrimitiveLives` owns the finite pool,
heat, body/reserve pairs, genome archive, births and request/origin bindings.
It is a portable server orchestration target, independent of transport/database
and outside `evo::simulation`. A detached candidate is swapped only after every
fallible operation succeeds, including ledger and archive admission.
Capacity is 256 retained lives and provisioned sites (engineering bound). Exact
successful retries return the original allocation before checking capacity or
funding. Another action for the same living account is refused. The host supplies
world-allocated identities, never the client. This layer checks local collisions;
world-wide allocation and authorization are enforced in 11.2c/d. Refusals here
are in-memory errors, not durable action outcomes. There are no live ticks or
death/logout transitions yet, so this subsection is not deployable gameplay.
+1 -1
View File
@@ -1,6 +1,6 @@
# Architecture decision records
- [ADR-0100: Primitive lives and persistent control](0100-primitive-lives-and-persistent-control.md) - proposed M11.2 cellular checkpoint and atomic spawn publication; founder funding pending maintainer decision. No implementation yet.
- [ADR-0100: Primitive lives and persistent control](0100-primitive-lives-and-persistent-control.md) - accepted M11.2 direction: finite spawn pools, equal full-grown founders, new cellular checkpoint and atomic life publication. 11.2a adds in-memory funded creation; durability/integration follow.
- [ADR-0058: Region durability contract](0058-region-durability-contract.md) - accepted M7.1 full checkpoint batches and explicit state closure; storage implementation follows.
+3 -2
View File
@@ -1,8 +1,9 @@
# M11.2: Primitive lives and persistent control
2026-10-09. Server-side continuation of M11.1 at `93e1ab0`.
[ADR-0100](../adr/0100-primitive-lives-and-persistent-control.md) is proposed.
This plan does not close 11.2 or settle unaccepted game rules.
[ADR-0100](../adr/0100-primitive-lives-and-persistent-control.md) is accepted in
direction: the maintainer authorized recommendations and implementation choices
for later review. This plan does not close 11.2.
## Contract review
+23
View File
@@ -5477,3 +5477,26 @@ in the delivery plan. No C++/SQL/wire code changed; builds, CTest, clang-format,
clang-tidy and sanitizers were not run for this documentation-only change.
No environment limitation was encountered during these documentation checks.
No deployment, world mutation or provisioning was performed.
## 2026-10-09 — M11.2a funded primitive creation
Implemented portable server lifecycle orchestration and the biology-derived
founder endowment (ADR-0100). Tests independently check composition, reserve and
heat, account equivalence, successful retries at exhausted capacity/funding,
per-channel shortage rollback, identity conflicts, invalid/overlapping sites,
empty funding and u64 channel bounds. No durable spawn or session integration
is claimed yet. No existing golden or wire layout changed.
Executed:
- Linux GCC 14 debug: 62/62 CTest checks; final test-literal revision rechecked.
- Linux Clang 19 ASan+UBSan: 62/62.
- Windows MSVC release (NDEBUG): 62/62.
- clang-tidy 19 on changed sources/tests: clean after correcting a widened test
multiplication; Clang also caught a signed initializer-list conversion, fixed.
- Repository format-check and `git diff --check`: passed. The formatter first
found a pre-existing mixed newline in session_window.hpp; normalization is
semantically empty and produces no Git content diff.
Environment: the sandboxed Windows Ninja build stalled before compiler execution;
the same release preset succeeded outside the sandbox. WSL required escalated
access. No reference-worker load qualification or deployment was performed.