Foundation / checks (client) (push) Successful in 5s
Foundation / checks (checks) (push) Successful in 6s
Foundation / checks (deploy) (push) Successful in 6s
Foundation / checks (ecs) (push) Successful in 5s
Foundation / checks (network) (push) Successful in 4s
Foundation / checks (postgres) (push) Successful in 4s
Foundation / checks (tsan) (push) Successful in 5s
Foundation / postgres-tools (push) Successful in 5m17s
Foundation / image (push) Successful in 6m23s
Foundation / server-image (push) Successful in 8m26s
ADR-0182 section 18. Region 16 refused every birth for an account with "Existing cell is already bound to this account" although no cell in it held the account: a published reservation was never ended, and the only remedy was tools/ops/end-account-life.sql as the database owner. - Account action POST /api/accounts/<uuid>/end-life?request=N. The admin API reads the life's region from the account's lives and refuses while that region's live view lists a cell holding the account (also a bud, split offspring or organism control moved to), a region it cannot view, an incomplete view, an unpublished request or a life no longer open. - Schema 69: admin_end_account_life_v1 (admin role only) ends it at the region's latest commit and appends who and why to admin_life_endings. - The account page shows End life for each published life not ended. - A region refusing a birth because the account holds a cell (life_exists) could never record it: reject_primitive_life accepted reasons 1..3 only. The reservation stayed open and unpublished and refused every later birth. Schema 69 and the C++ wrapper accept existing_life (4). - A region with no ticking cells ignored queued admin commands (such as a spawn) until something else woke it; a queued command now keeps it ticking until applied. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2277 lines
138 KiB
Markdown
2277 lines
138 KiB
Markdown
# Project status and next steps
|
||
|
||
## Ending a stranded life - 2026-10-29
|
||
|
||
The portal's account page can end a published life whose reservation was never ended, which
|
||
refused every new birth ("Existing cell is already bound to this account"). The admin API first
|
||
checks the region's live view for any cell holding the account; schema 69 records who ended it
|
||
and why. A region with no ticking cells now still applies queued admin commands, such as a
|
||
spawn. See [ADR-0182](adr/0182-admin-portal-and-world-tuning.md) section 18.
|
||
|
||
## Larger region ticks for testing - 2026-10-28
|
||
|
||
A region tick may hold up to 4,096 lives (was 256), for testing limits only, and
|
||
`reproduction.organism_cap` accepts up to 4,096; the DEV file keeps 256. Schema 68 raises the
|
||
database's per-tick trace counts and lets one spawn command place 256 wildlife. The region page
|
||
shows the lineage archive's fill, which stops a region at 65,536 births. See
|
||
[ADR-0182](adr/0182-admin-portal-and-world-tuning.md) section 17.
|
||
|
||
## Testing a full region - 2026-10-28
|
||
|
||
The Bud button follows a tuning adoption at once (the region's bud-cost cache was keyed by
|
||
genome only). `reproduction.wildlife_cap` keeps lives above it for players' buds. Two admin
|
||
commands (schema 67): take reserve from a cell, and remove all wildlife; the region map marks
|
||
cells (shift+click, shift+drag) for bulk removal. See
|
||
[ADR-0182](adr/0182-admin-portal-and-world-tuning.md) section 16.
|
||
|
||
## Opening regions from the portal - 2026-10-28
|
||
|
||
The Regions page can open a fresh region in place of the one DEV serves: the admin API
|
||
commits the region switch to `main` as aevolution-bot (through Secret `aevolution-admin`) and
|
||
runs a full Argo sync, and the page follows the sync until the new region is live. See
|
||
[ADR-0182](adr/0182-admin-portal-and-world-tuning.md) section 15.
|
||
|
||
## Guided tuning editor - 2026-10-28
|
||
|
||
The Tuning page is a guided editor: pick a section, edit a setting's value (units and plain
|
||
readings shown), review the changes and apply. Only the changed values are sent and applied to
|
||
the newest revision on the server, which keeps the file's comments and refuses a stale base;
|
||
the whole-file text editor remains as Text mode.
|
||
|
||
## Energy cycle - 2026-10-28
|
||
|
||
Energy now cycles like matter: the heat cells produce (upkeep, motion, growth, feeding and
|
||
predation losses) returns to the spent pool every tick and drips back as bubbles, and a drip at
|
||
the deposit limit joins an existing bubble. Both are optional rules-13 tuning keys
|
||
(`spent.heat_recycle_per_mille`, `spent.drip_absorb`), adoptable live; the DEV revamp file
|
||
turns them on. See [ADR-0182](adr/0182-admin-portal-and-world-tuning.md) section 14.
|
||
|
||
## Admin region page - 2026-10-28
|
||
|
||
The admin portal's region page is reorganized around the map: a KPI strip (tick pace,
|
||
population, deposit capacity, region energy and matter, spent pool, next drip), a map with
|
||
layer toggles, zoom and a scale, and tabs for inspecting cells and deposits, the region's
|
||
resources (where every channel sits, the spent pool and its drip), actions, the running
|
||
tuning and session access. The region view adds complete counts and totals and the drip
|
||
rules; the portal has light and dark themes. See
|
||
[ADR-0182](adr/0182-admin-portal-and-world-tuning.md) section 13.
|
||
|
||
## Live tuning - 2026-10-27
|
||
|
||
The admin portal's Tuning page edits the world's rules-13 tuning (the Git revamp file
|
||
format) and adopts it in every region at a recorded tick, without a new image or region:
|
||
upkeep, burn, feeding, predation, the spent-pool drip, mutation offers and costs,
|
||
reproduction and organisms. Revisions are append-only with author and reason (schema 66);
|
||
the reproduction safety revision stays fixed. See
|
||
[ADR-0182](adr/0182-admin-portal-and-world-tuning.md) section 13.
|
||
|
||
## Resource schedules - 2026-10-27
|
||
|
||
The admin portal can schedule recurring bubbles (the game source), spent-pool releases and
|
||
wildlife spawns per region, every 1 s to 24 h, and stop or restart them. Each run is an
|
||
ordinary recorded admin command (schema 65). See
|
||
[ADR-0182](adr/0182-admin-portal-and-world-tuning.md) section 12.
|
||
|
||
## Account administration: bans, logout, time played - 2026-10-27
|
||
|
||
The admin portal can ban (and unban) an account, which also logs it out and stops new
|
||
grants; log an account out; and shows time played, sessions, last seen and living
|
||
offspring (wildlife descended from its lives). Schema 64; see
|
||
[ADR-0182](adr/0182-admin-portal-and-world-tuning.md) section 11.
|
||
|
||
## Admin commands: spawn wildlife, resources, remove and grant - 2026-10-27
|
||
|
||
The admin portal can now spawn wildlife, add bubbles, add to or release the spent pool,
|
||
remove a cell and grant a cell's reserve, live. Commands are queued in SQL (schema 63) and
|
||
the region applies each once, recording it in its history (trace 5) so replay and recovery
|
||
reproduce it. Imports are counted in the region's boundary ledger. No new region is needed.
|
||
See [ADR-0182](adr/0182-admin-portal-and-world-tuning.md) section 10 and
|
||
[validation](engineering/VALIDATION.md).
|
||
|
||
## Session windows from the admin portal - 2026-10-27
|
||
|
||
The dev session window now lives in SQL (schema 62) instead of Git: the admin portal opens,
|
||
extends (up to four hours from now) and closes it, and the region applies the change within
|
||
about five seconds without a push, sync or restart. A closed window refuses every new
|
||
session and the region keeps running. The admin API moves to its own database role. See the
|
||
[ADR-0087 amendment](adr/0087-dev-session-route.md) and [validation](engineering/VALIDATION.md).
|
||
|
||
## Read-only admin portal - 2026-10-27
|
||
|
||
[ADR-0182](adr/0182-admin-portal-and-world-tuning.md) records the admin portal direction
|
||
(world tuning in SQL adopted per tick, admin commands, data-defined mutations) and delivers
|
||
its read-only first step: `evo-admin-api` and the portal at `https://srs.aeternalisgames.com`
|
||
behind the Keycloak realm role `aevolution-admin`. It lists accounts (session, status,
|
||
lives, deaths, resets, mutation choices), one account's lives, the world's regions, and a
|
||
live 2D view of a region's cells, wildlife, pools and bubbles from the region's new
|
||
`/admin/view` ops route. Schema 61 adds only read functions. Nothing in the simulation,
|
||
wire protocol or checkpoints changed. Not yet deployed: it needs a new server image, the
|
||
Keycloak client, an Ingress and a database Secret. See [validation](engineering/VALIDATION.md).
|
||
|
||
## Reproduction safety trial and resizable cards - 2026-10-27
|
||
|
||
[ADR-0181](adr/0181-cellular-reproduction-safety.md) declares opt-in safety
|
||
revision 1 for future rules-13 openings: 80% of mutation body/resources follow
|
||
control, the ordinary bud fee returns to the selected cell, mutation offspring
|
||
separate with an outward launch, and automatic growth protects 60 seconds of fuel.
|
||
Recorded revision 0 keeps historical simulation semantics and bytes. This is
|
||
prepared trial tuning, not live retuning, image promotion or a deployed new region.
|
||
|
||
Field notes, Vitals and Nearby resize by native edge/corner dragging, retain their
|
||
expanded sizes across collapse and clamp to the viewport. The heading reset gesture
|
||
resets size and placement. See [validation](engineering/VALIDATION.md).
|
||
|
||
## Stable and movable cellular panels - 2026-10-26
|
||
|
||
The client HUD now uses stable card dimensions and scrolling content, keeping
|
||
headings and action buttons fixed as live messages change. Field notes, Vitals
|
||
and Nearby have a dedicated drag handle, session anchoring, viewport clamping
|
||
and double-click position reset. See [controls](engineering/CLIENT_VISUAL_REFRESH.md)
|
||
and [executed validation](engineering/VALIDATION.md). No biological or wire rule changed.
|
||
|
||
## DEV startup wildlife and Bud controls - 2026-10-26
|
||
|
||
[ADR-0180](adr/0180-dev-starting-wildlife.md) implements opt-in, nursery-funded
|
||
random-genome roots at a fresh rules-13 opening, with deterministic durable
|
||
recovery and no replenishment on restart. The DEV trial prepares region 14 with
|
||
32 cells, 25% faster funded growth and the existing per-channel budding fee knobs.
|
||
Bud disables on resource shortfall and explains all five channels on hover; the
|
||
server projection includes the inherited plan and fee. See [tuning and promotion
|
||
limits](engineering/CELLULAR_PLAYTEST_TUNING.md) and [validation](engineering/VALIDATION.md).
|
||
Source/configuration preparation is distinct from image promotion and deployment.
|
||
|
||
## Photosynthesis producers (ADR-0136 step C) - 2026-10-19
|
||
|
||
[ADR-0175](adr/0175-photosynthesis-producers.md) adds genome schema 5's photosynthesis
|
||
capability with trial costs (organelle membrane mass and slower movement), founder 4
|
||
and cellular rules 11. A region declares light in owner format 9; each tick a still,
|
||
active producer captures cross-section x irradiance x efficiency (a quarter while
|
||
moving), booked as boundary inflow inside the same atomic tick. A founder earns the
|
||
capability as its offspring plan; its children express it and capture light. Every
|
||
earlier genome, offer, owner and environment byte keeps its meaning. Numbers are trial
|
||
values to balance after playtesting.
|
||
|
||
[ADR-0176](adr/0176-durable-photosynthesis-region.md)/schema 57 makes producers
|
||
playable: raw bundle 13 with a durable light-declaring upgrade, the resumable
|
||
`cellular-v8` opening, and session v12, whose owner view carries captured light and
|
||
the producers it can see, and whose offers may name photosynthesis. The client draws
|
||
green chloroplasts by efficiency, shows sunlight in the HUD and offers photosynthesis
|
||
cards. DEV promotes CI run 471's images (`2efb01d`: server `f1183f44...`, postgres-tools
|
||
`d3b8e520...`, schema 57) and switches to region 9 (`cellular-v8`, light 40) together;
|
||
the previous build stays retained and region 8 stays stored but unserved. A first switch
|
||
without the image promotion failed the Argo provision hook and was reverted.
|
||
|
||
## Cellular environment ownership (M12.5a-b) - 2026-10-19
|
||
|
||
The maintainer accepted one owner per patch of space for cells and their local
|
||
environment, individual reserves (colony/multicellular sharing later) and an open
|
||
planet boundary. [ADR-0172](adr/0172-cellular-environment-ownership.md) records
|
||
that contract and adds the portable `CellularEnvironment` owner (envelope
|
||
`AEVOCEN1`): tagged water/dissolved compartments, refused atmosphere, finite infall
|
||
entitlements (ADR-0136 step B) and radiative heat export, applied with each joint
|
||
tick or not at all. Closed and source-off regions keep their biology byte for byte.
|
||
Raw and cohort representations agree under infall. Old formats and goldens keep
|
||
their meaning; no default/live version changes.
|
||
|
||
[ADR-0173](adr/0173-cellular-environment-batch.md) adds joint batch `AEVOEBT1`:
|
||
the unchanged population batch plus each tick's recorded import and radiated heat.
|
||
Recorded unattended intervals equal the same live joint ticks; replay re-derives
|
||
every flow and refuses forged flows, boundaries and cuts.
|
||
|
||
[ADR-0174](adr/0174-durable-cellular-environment-profile.md)/schema 56 makes the
|
||
joint owner durable as checkpoint profile 6: an explicit one-way, no-tick entry from
|
||
a population head, fenced joint publication with owned intervals and per-commit SQL
|
||
totals of imported and radiated stock, and recovery that replays the head's link
|
||
exactly. A forged but structurally valid trace is refused on recovery.
|
||
|
||
See [Validation](engineering/VALIDATION.md). Producers (ADR-0136 step C),
|
||
executable/network joint fault drills, worker/census/migration integration (12.5d)
|
||
and target-host qualification (12.5e) remain open.
|
||
|
||
## Portable retained-plan exact populations - 2026-10-19
|
||
|
||
[ADR-0171](adr/0171-retained-plan-exact-populations.md) adds envelope/batch 3 for
|
||
owner 8/rules 10. An explicit no-tick inheritance candidate preserves the exact
|
||
membership, policy and sequence. Raw/cohort execution agrees through earned
|
||
structural plans, paid children, later selections, suspension, conversion and
|
||
recorded unattended intervals. Projection 2 keeps cohort plan references separate
|
||
from expressed stock. Old envelopes/traces and all goldens retain their meaning.
|
||
|
||
Both full Release suites pass **92/92**. Final focused tests, analysis, formatting
|
||
and ASan/UBSan pass; fresh-process MSVC/GCC output bytes agree.
|
||
[Validation](engineering/VALIDATION.md) records exact evidence. Durable population
|
||
admission, migration, linked resource ownership, control/NPC/UI and operational/
|
||
actual-days/product gates remain open. No default/live version changes.
|
||
|
||
## Explicit DEV worker placement - 2026-10-19
|
||
|
||
[ADR-0170](adr/0170-dev-worker-placement.md) implements the maintainer's worker
|
||
placement requirement in the full DEV application and standalone region/store
|
||
overlays. Required affinity excludes both current and legacy control-plane role
|
||
labels. Existing store selectors, volumes, PostgreSQL endpoints and URLs remain.
|
||
Rendered checks reject an unrestricted affinity alternative or `nodeName` bypass.
|
||
|
||
All 17 overlays render with zero policy failures; all 50 adversarial policy cases
|
||
pass. [Evidence](engineering/M12_DEV_WORKER_PLACEMENT.md) distinguishes offline
|
||
policy from actual running placement. Delivery uses Git Actions, Harbor, ArgoCD
|
||
and Kubernetes. Target-host drills and the remaining M12 gates remain open.
|
||
|
||
## Retained-plan census and verified history - 2026-10-19
|
||
|
||
[ADR-0169](adr/0169-retained-plan-census-observations.md) adds raw owner-8 census
|
||
projection 2. Expressed organisms/body/reserve retain their existing meaning;
|
||
separate living plan references preserve inherited diversity before any offspring
|
||
is born. Dead-plan records remain history. Exact/descendant/scoped queries and
|
||
committed history/registered snapshots retain the explicit projection boundary.
|
||
No extra inventory, redundant SQL journal or terminal extinction rule is added.
|
||
|
||
MSVC/GCC Release pass **90/90**. Clang-tidy, formatting, focused ASan/UBSan and
|
||
actual database history/capture checks pass; [validation](engineering/VALIDATION.md)
|
||
records scope. Old projection-1 plan measures remain unobserved. Population and
|
||
migration integration, in-life trait timing, birth-time control, NPC behavior,
|
||
client UI and remaining target-host/ecology/product gates still prevent M12 closure.
|
||
|
||
## Durable retained offspring plans - 2026-10-19
|
||
|
||
[ADR-0168](adr/0168-durable-retained-plan-admission.md)/schema 55 adds explicit
|
||
raw bundle-11 -> 12 fenced upgrades, trace-4 publication, earned plan selections
|
||
and repeated funded births. Recovery rederives the full upgrade from retained
|
||
source objects and replays subsequent choices/births exactly. Ambiguous retries,
|
||
stale writers, rollback, pending choices and missing/corrupt/false evidence are
|
||
covered. No default or DEV opening opts into this version automatically.
|
||
|
||
[Validation](engineering/VALIDATION.md) records executed checks. Population and
|
||
migration support, census plan semantics, control succession, retained NPC
|
||
behavior, client choice UI and the remaining M12 operational/ecology/product
|
||
gates remain open. Delivery follows Git Actions -> Harbor -> ArgoCD -> Kubernetes
|
||
using the checked-in `deploy/` manifests.
|
||
|
||
## Portable retained-plan checkpoint upgrade - 2026-10-19
|
||
|
||
[ADR-0167](adr/0167-retained-plan-checkpoint-upgrade.md) defines raw-only bundle
|
||
12 and an explicit no-tick upgrade from bundle 11. It restores the complete
|
||
source, preserves expressed mutations, funded descendants, inventories, presence
|
||
and archive history, and initializes each offspring plan from its expressed
|
||
genome. The checkpoint restores and continues through raw trace 4. No genesis,
|
||
skipped prerequisites, repeats or population conversion are admitted.
|
||
|
||
Full MSVC/GCC Release suites pass **89/89**. Analysis, formatting and focused
|
||
ASan/UBSan pass; separate-process upgrade proof bytes agree across compilers.
|
||
[Validation](engineering/VALIDATION.md) records exact evidence and limitations.
|
||
This is portable reader/upgrade support. SQL and fenced durable publication,
|
||
population/census/migration admission, control succession, retained NPC behavior
|
||
and choice UI remain open; M12 is still in progress.
|
||
|
||
## Portable inherited-plan replay - 2026-10-19
|
||
|
||
[ADR-0166](adr/0166-retained-plan-replay-traces.md) adds raw trace 4 exclusively
|
||
for owner format 8/rules 10. Recorded selections, same-tick funded offspring,
|
||
declines and later plan changes reproduce direct execution exactly. Action
|
||
matching uses the inherited offer even when it differs from the parent's body.
|
||
Failed batches expose no candidate or partial mutation outcome list.
|
||
|
||
Both full MSVC/GCC Release suites pass **87/87**. Fresh-process replay produces
|
||
identical final bytes on both compilers; analysis, formatting and focused
|
||
ASan/UBSan checks pass. [Validation](engineering/VALIDATION.md) records scope.
|
||
Trace 3 remains the default. Durable plan/bundle admission, population/census/
|
||
migration integration, control succession, retained NPC behavior and choice UI
|
||
remain open; this portable prerequisite does not complete M12.
|
||
|
||
## Portable retained offspring plans - 2026-10-19
|
||
|
||
[ADR-0165](adr/0165-retained-cellular-offspring-plans.md) implements an opt-in
|
||
stored-plan owner, format 8/rules 10. Earned selections edit the inherited plan;
|
||
the parent's expressed body and biological charges stay unchanged. Repeated
|
||
funded births use that plan, later selections preserve earlier siblings, and
|
||
reloads/death history retain the distinction. Older saves retain their meaning.
|
||
|
||
MSVC/GCC full Release suites pass **85/85**; exact separate-process inherited
|
||
continuations agree across compilers. [Validation](engineering/VALIDATION.md)
|
||
records analysis/sanitizer evidence and scope. Current durable bundles, census,
|
||
population, migration and old batch replay refuse the new owner. Durable plan
|
||
integration, the in-life expression catalog, birth-time control succession,
|
||
retained NPC behavior and choice UI remain open. M12 remains in progress.
|
||
|
||
## Distinct-genome offspring funding - 2026-10-19
|
||
|
||
[ADR-0164](adr/0164-distinct-genome-offspring-funding.md) implements the first
|
||
biology operation for generational structural inheritance. An unchanged parent
|
||
can fund a child with a distinct inherited anatomy and starting demand, with
|
||
exact energy/element closure and no free tissue. Siblings retain the selected
|
||
plan while archive records keep the parent's expressed genome separate.
|
||
|
||
Both full MSVC/GCC Release suites pass **83/83**. Focused ASan/UBSan, clang-tidy
|
||
and formatting pass; [validation](engineering/VALIDATION.md) records exact scope.
|
||
Stored offspring plans, mutation timing, birth control handoff, retained NPC
|
||
behavior and choice UI remain next work. Current live/default biology is unchanged.
|
||
|
||
## Gameplay alignment: structural inheritance and succession - 2026-10-19
|
||
|
||
The maintainer accepts [ADR-0163](adr/0163-structural-inheritance-and-offspring-succession.md):
|
||
structural mutations are expressed in offspring. At birth the player stays as the
|
||
parent or permanently continues as the child. The relinquished parent becomes an
|
||
NPC retaining its existing body, established behavior and selected offspring plan.
|
||
It can continue reproducing that form. There is no return to the parent or fallback
|
||
after child death; a fresh life after death remains primitive.
|
||
|
||
This updates target gameplay, not the current runtime. Separate expressed/heritable
|
||
state, per-operator timing, bounded retained NPC behavior, durable birth/control
|
||
handoff and readable outcome/choice UI are implementation work. Earlier four-generation
|
||
qualification exercises the old exact-copy rules and does not qualify these features.
|
||
|
||
## Bounded unscripted wildlife generations - 2026-10-19
|
||
|
||
[ADR-0162](adr/0162-bounded-unscripted-wildlife-generations.md) measures actual
|
||
funded player-origin wildlife under the unchanged controller. All players freeze
|
||
after the first bud. Four declared rich four-founder cases, including two
|
||
hold-outs, reach four wildlife generations with 97–102 births and 31–33 living
|
||
wildlife after 80,000 ticks. Complete raw/cohort biology and reports, conservation,
|
||
whole-genome conversions and periodic restores agree. Actual predation and twins
|
||
are observed; rules-8 and scarce controls retain their different outcomes.
|
||
|
||
Native Release passes **82/82**; the short ASan/UBSan contract, analysis and format
|
||
checks pass. [Results and reproduction](engineering/M12_UNSCRIPTED_GENERATIONS.md)
|
||
retain the weaker exploratory one-founder outcomes and exact scope. This is
|
||
4,000 simulated seconds per case, not actual days or sustainable producer ecology.
|
||
M12 remains in progress; environmental coupling, target-host/multi-host evidence,
|
||
global reconciliation and returning-player/product gates remain open.
|
||
|
||
## Durable migration of maturing wildlife - 2026-10-19
|
||
|
||
[ADR-0161](adr/0161-durable-maturing-wildlife-transfer.md)/schema 54 admits exact
|
||
bundle-11/trace-2 migration alongside retained bundle 10/trace 1. Source freeze,
|
||
read-only staging, atomic paired publication, complete recovery and registered
|
||
pending-handoff census verification reuse existing journals and fences. Mixed
|
||
bundles and cross-rule traces fail. Settled juveniles continue funded growth.
|
||
|
||
Native Release passes **81/81**, both complete private rule matrices pass in
|
||
**35 s**, and ASan/UBSan passes in **86 s**. Analysis and formatting pass; evidence
|
||
and qualification limits are in [validation](engineering/VALIDATION.md). The full
|
||
private persistence/process/TLS/backup/DR/history/SQL qualification passes in
|
||
**613 s**, with frozen executable hashes unchanged. No live
|
||
upgrade, automatic movement or biological rule change. Linked resources,
|
||
autonomous sustainability, multi-host drills, actual days and product gates remain
|
||
open; M12 is still in progress.
|
||
|
||
The same commit refreshes the DEV session window to a new four-hour absolute
|
||
deadline; rendered deployment policy passes for all 17 overlays.
|
||
|
||
## Portable transfer of maturing wildlife - 2026-10-19
|
||
|
||
[ADR-0160](adr/0160-portable-maturing-wildlife-transfer.md) qualifies exact
|
||
portable rules-9 transfer and distinct trace 2 for raw/cohort owners. Real
|
||
juveniles grow before and after transfer while life fields remain exact at the
|
||
no-tick boundary. Mixed rules and cross-rule replay fail. Trace 1 retains rules 8;
|
||
durable adapters and SQL continue to refuse trace 2/bundle 11.
|
||
|
||
Native Release passes **81/81**, GCC transfer/restart **2/2**, ASan/UBSan **2/2**,
|
||
private Release/ASan matrices (**22/63 s**), analysis and formatting. Seven old
|
||
trace/result/continuation artifacts retain exact bytes. The DEV session window
|
||
is refreshed in the same commit and future pushes must refresh it; offline
|
||
rendered policy and all 46 policy self-tests pass. See
|
||
[validation](engineering/VALIDATION.md). Durable rules-9 migration and remaining
|
||
ecology/soak/product gates remain open.
|
||
|
||
## Census of funded maturing owners - 2026-10-19
|
||
|
||
[ADR-0159](adr/0159-maturing-cellular-census.md) admits rules-9/owner-7 retained
|
||
body/reserve to census projection 1, verified committed history and registered
|
||
snapshots. Real funded growth, raw/cohort conversion, no-tick version/profile
|
||
cuts and concurrent snapshot capture are qualified. Mixed rules-8/rules-9 cuts,
|
||
missing evidence/builds and stale grants refuse complete queries.
|
||
|
||
Native Release passes **81/81**, focused GCC Release **3/3**, and the complete
|
||
affected private database matrix passes in **22 s**. ASan/UBSan portable census
|
||
and the private matrix (**64 s**), analysis and formatting pass; detailed evidence
|
||
and limits are in [validation](engineering/VALIDATION.md). No SQL schema or
|
||
biological rule change. Rules-9 migration, viable-store reconciliation, ecology,
|
||
actual-days and product gates remain open; M12 is still in progress.
|
||
|
||
## Durable funded cellular maturation - 2026-10-19
|
||
|
||
[ADR-0158](adr/0158-durable-cellular-maturation.md)/schema 53 admits explicit
|
||
bundle-10 -> 11 maturation upgrades in either raw or population profile, using
|
||
the existing immutable version journal and current head/lease fence. Recovery
|
||
rederives full state, and upgraded hosts retain exact growth through publication,
|
||
replacement, interval settlement and representation changes. No automatic upgrade
|
||
or default/DEV provisioning change.
|
||
|
||
Native Release passes **81/81**. Private Release and ASan/UBSan upgrade/fault
|
||
matrices, including prepared-handoff refusal with no partial journal evidence,
|
||
and final analysis/formatting pass. Detailed evidence and limits are recorded in
|
||
[validation](engineering/VALIDATION.md). The full private persistence/process,
|
||
backup/DR, migration-history and permission qualification reports **exit 0, 563 s**.
|
||
Rules-9 migration/census, autonomous
|
||
generations, shared environmental budgets, target-host cost, actual days and
|
||
product gates remain open; this is not completion of M12.
|
||
|
||
## Portable M12 funded maturation prerequisite - 2026-10-18
|
||
|
||
[ADR-0157](adr/0157-funded-cellular-maturation.md) adds opt-in rules-9 funded
|
||
growth to the exact raw/cohort kernel. A genuine finite-food bud reaches adulthood
|
||
and produces its own bud; construction preserves every stock, damage and genome.
|
||
The documented trial rate, blocked-expansion refusal, saved-choice funding,
|
||
newborn/offline exclusion, conversion and exact replay/process continuation pass.
|
||
Rules 8, DEV defaults and durable bundle admission retain their existing meaning.
|
||
|
||
Native and GCC Release pass **81/81** each. Affected ASan/UBSan, including the final
|
||
offline/process guards, clang-tidy and formatting pass; detailed evidence and
|
||
fixture limits are in [validation](engineering/VALIDATION.md). Small juveniles'
|
||
pool nutrient rounding and sibling placement still constrain ecology. Durable
|
||
rules-9 admission/migration/census, automated generations, joint environmental
|
||
budgets, target-host costs, actual days and product gates remain open. This is a
|
||
portable prerequisite, not completion of M12.
|
||
|
||
## M12.7c registered census pending handoff evidence - 2026-10-18
|
||
|
||
Schema 52 captures active biological migration pointers with history domain,
|
||
registry and heads. Both predecessor manifests are bound to retained builds;
|
||
source capsules and staged destination ghosts receive complete paired replay
|
||
outside the metadata transaction. Capsules/ghosts add no stock. Prepare/stage/
|
||
abort/commit interleavings preserve the selected view; unavailable or false evidence
|
||
fails the entire result. This accepts no terminal extinction or live authority.
|
||
|
||
Native Release **79/79**, final raw/population allowlist cases, ASan/UBSan TLS/storage
|
||
faults, Clang analysis and formatting pass. Final private persistence/process/
|
||
backup/DR/migration/permission qualification passed in **558 s**; results and limits
|
||
are recorded in [validation](engineering/VALIDATION.md). Other viable
|
||
stores, cross-domain clone provenance, accepted global reconciliation/freshness
|
||
and ecology/soak/product gates remain open.
|
||
|
||
## M12.7b database history domains and restore provenance - 2026-10-18
|
||
|
||
Schema 51 binds registered census evidence to a database history-domain UUID,
|
||
captured with the registry and heads. Supported restores create a fresh domain
|
||
before verification/readmission, retaining the parent, restore claim and exact
|
||
restored cuts. Biological identities/bytes stay unchanged. Legacy backups have
|
||
unknown original context and acquire adoption only when migrated.
|
||
|
||
Default Release CTest **79/79**, focused domain/legacy-restore qualification,
|
||
ASan/UBSan TLS/storage faults, Clang analysis and formatting pass. Full private
|
||
persistence/process/backup/DR and migration/permissions qualification passed in
|
||
**558 s** after correcting an incomplete frozen-helper directory. Results and
|
||
limits are recorded in [validation](engineering/VALIDATION.md).
|
||
Cross-domain clone provenance, other viable stores, durable accepted extinction,
|
||
client access and ecology/soak/product gates remain open; this is not complete M12.
|
||
|
||
## M12.7a registered-world census coverage - 2026-10-18
|
||
|
||
Schema 50 now uses the durable authority registry as the required regional set
|
||
for consistent census snapshots. Every registered region must have matching
|
||
resources and recoverable evidence, including inactive/expired owners. Missing
|
||
heads, unsupported profiles, unknown worlds and more than 64 regions fail the
|
||
query. Catalog selection and head capture use the same database snapshot, with
|
||
complete immutable replay afterward; no duplicate catalog/enrollment write.
|
||
|
||
Native Release passes **79/79**; registered coverage/enrollment and raw/cohort
|
||
migration races, ASan/UBSan TLS/storage faults, Clang analysis and formatting pass.
|
||
Complete private persistence/process/backup/DR, schema upgrade, permissions and
|
||
checksum qualification passes in **551 s** after correcting a stale schema-history
|
||
test expectation. [Evidence and limits](engineering/VALIDATION.md) retain external
|
||
branch identity, other viable stores, durable accepted reconciliation records,
|
||
client access and the ecology/soak/product gates. This segment accepts no terminal
|
||
extinction, deployment or World0 promotion.
|
||
|
||
## M12.6d consistent scoped census snapshots - 2026-10-18
|
||
|
||
Scoped census reads now select all declared regional heads from one short
|
||
read-only database snapshot, then fully replay the exact immutable cuts after
|
||
the metadata transaction ends. A concurrent atomic migration cannot split the
|
||
selected source/destination heads. Missing or failed evidence returns no partial
|
||
census; unsafe capture cleanup closes its connection.
|
||
|
||
Private raw/cohort migration races and TLS BEGIN/COMMIT request/reply-loss tests
|
||
pass in Release and ASan/UBSan, alongside existing history and migration/storage
|
||
faults. Native default Release passes **79/79**; Clang analysis and formatting
|
||
pass. [Evidence and limits](engineering/VALIDATION.md) retain durable world/branch
|
||
coverage, outside transfer/viability reconciliation, client access, target-host
|
||
query costs and later ecology/soak/product gates. A caller-declared consistent
|
||
cut cannot accept terminal extinction. No deployment or World0 action.
|
||
|
||
## M12.6c scoped multi-region census queries - 2026-10-18
|
||
|
||
The portable census now queries 1..64 explicitly declared regions at an exact
|
||
simulation boundary. Missing/stale coverage, conflicting immutable genome records
|
||
and duplicate resident organisms fail before totals are exposed. Real settled
|
||
migrations count stock once, retain suspended living stock and support mixed
|
||
raw/cohort classifications; departed history remains separate record occurrences.
|
||
|
||
Native Release passes **79/79**; focused GCC and ASan/UBSan contracts, private
|
||
PostgreSQL committed raw/cohort history integration, Clang analysis and formatting
|
||
pass. [Evidence and limits](engineering/VALIDATION.md) retain durable world/branch
|
||
coverage, reconciled migration cuts, client access and target-host query costs.
|
||
A caller-declared region set is not a complete world watermark and cannot accept
|
||
terminal extinction. Linked ecology, maturation and later integration/soak gates
|
||
remain open; no deployment or World0 action.
|
||
|
||
## M12.6b replayed census history from committed cuts - 2026-10-18
|
||
|
||
Regional census history now reads exact retained biological commits as canonical
|
||
durable events. Pages are bounded to eight commits and pinned to a fixed regional
|
||
cut. Shared full recovery verifies raw/cohort payloads, traces, transitions and
|
||
paired migration evidence before exposing census rows. Idle connections prevent
|
||
a writer's own pending changes from appearing durable; failed evidence never
|
||
becomes a partial page or zero population. No duplicate census write is added.
|
||
|
||
Native Release passes **79/79**; private GCC history qualification, ASan/UBSan
|
||
history/TLS/storage checks and Clang analysis/format checks pass.
|
||
Complete private persistence/process/backup/DR and SQL qualification passes in
|
||
**546 s**, including the new history matrix and existing fault tests.
|
||
[Evidence and limits](engineering/VALIDATION.md) retain world/branch reconciliation,
|
||
cross-region/public client access and deployment-host query costs. This regional
|
||
watermark cannot authorize terminal extinction. Linked ecology, maturation and
|
||
later integration/soak gates remain open; no deployment or World0 action.
|
||
|
||
## M12.6a bounded regional census and history queries - 2026-10-18
|
||
|
||
The portable census now distinguishes resident individuals/cohorts and
|
||
active/lingering/suspended controlled lives, retaining exact body/reserve stock
|
||
and zero-carrier ancestry. Exact-genome and descendant queries use current carried
|
||
genomes. Retained departed history never counts as resident stock; migrations and
|
||
return trips retain that distinction without changing biology.
|
||
|
||
Native Release passes **79/79**; GCC census/lineage/migration contracts, relevant
|
||
ASan/UBSan checks, Clang analysis and formatting pass.
|
||
[Evidence and limits](engineering/VALIDATION.md) retain durable atomic history
|
||
publication, commit/branch binding, complete world reconciliation and client
|
||
presentation as subsequent M12.6/12.7 work. This local projection grants no
|
||
terminal-extinction or ghost ownership authority. Linked ecology, maturation and
|
||
later integration/soak gates remain open; no deployment or World0 change.
|
||
|
||
## M12.4l local migration storage failures - 2026-10-18
|
||
|
||
The private matrix now refuses preparation, staging or paired publication after
|
||
capsule/result directory-sync failures. Real read-permission denial after commit
|
||
pauses current-payload recovery for retry or quarantines unavailable counterpart
|
||
replay evidence. Both paths preserve the exact database heads and receipt; full
|
||
recovery restores exact biology, with newer authority after quarantine.
|
||
|
||
GCC private population/migration checks pass in 17 s, ASan/UBSan storage/TLS
|
||
checks in 64 s, and Clang analysis/format checks pass.
|
||
Complete private persistence/process/backup/DR and migration/permission
|
||
qualification, including the combined fault matrix, passes in 546 s.
|
||
[Evidence and limits](engineering/VALIDATION.md) distinguish local sync/read
|
||
failures from physical media, storage-host and orchestrator drills. Linked ecology,
|
||
maturation and later M12 integration/soak gates remain open. This segment changes
|
||
tests/documentation only.
|
||
|
||
## M12.4k independent migration TLS path faults - 2026-10-18
|
||
|
||
Test-only relays now exercise real loopback TCP/end-to-end TLS request/receipt
|
||
loss for raw and cohort migration. Independent observation proves unchanged or
|
||
atomically committed heads. Owning hosts retain lost prepare/stage/abort work,
|
||
fence after actual partitioned lease expiry, recover under replacement authority
|
||
and refuse healed stale owners. Their healthy peer keeps its epoch/freeze.
|
||
Wrong-hostname TLS connections fail; production adapter settings are unchanged.
|
||
|
||
Native Release passes 78/78; GCC, ASan/UBSan, TSan, Clang analysis, format and
|
||
shell checks pass. Complete private persistence, process-fault, backup/DR and
|
||
migration/permission qualification, including the TLS matrix, passes in 540 s.
|
||
[Evidence and limits](engineering/VALIDATION.md) distinguish
|
||
these local transport faults from multi-host/kernel-network, database/object-store
|
||
and orchestrator drills. Linked ecology and later M12 integration/soak gates
|
||
remain open. No SQL, production code, biological rule/format, deployment or live
|
||
region changed. Full/sanitizer CI paths include the new disposable TLS matrix.
|
||
|
||
## M12.4j atomic paired biological publication - 2026-10-18
|
||
|
||
ADR-0149/schema 49 commits both exact migration results and one immutable common
|
||
receipt under both current fences. Second-insert failure rolls back both heads
|
||
and pointer settlement. Commit and abort have one exclusive outcome; exact
|
||
retries preserve both original manifests under fresh endpoint authority. Full
|
||
recovery replays the pair from retained local capsules before a host adopts a
|
||
changed head or becomes ready. The source owns stock until commit; afterwards
|
||
only the destination owns the migrants.
|
||
|
||
Native Release passes 78/78; focused private PostgreSQL, ASan/UBSan, Clang
|
||
analysis, format and shell syntax checks pass. Complete private persistence,
|
||
process-fault, backup/DR and migration/permission qualification passes in 507 s.
|
||
[Evidence and limits](engineering/VALIDATION.md)
|
||
retain independent network-partition drills, linked ecology, maturation and later
|
||
M12 integration/soak gates. All of M12 remains in progress. No automatic route,
|
||
biological rule/format, deployment or live region changed.
|
||
|
||
## M12.4i durable read-only destination staging - 2026-10-18
|
||
|
||
ADR-0148/schema 48 stages the destination under current authority at its exact
|
||
captured head. A verified source capsule and complete destination ghost are
|
||
retained for replay, while the source owns all outgoing stock and neither head
|
||
moves. Both migration roles pause publication/admission and host readiness
|
||
across replacement. Explicit source abort releases both pointers atomically;
|
||
stage/abort races and exact retries cannot activate or reopen an aborted ghost.
|
||
|
||
Native Release passes 78/78; the private PostgreSQL staging suite, ASan/UBSan,
|
||
Clang analysis, format and shell syntax checks pass. The complete private
|
||
persistence/process/backup/DR/migration/permission suite passes in 501 s.
|
||
[Evidence and limits](engineering/VALIDATION.md)
|
||
retain atomic paired publication, its common immutable receipt, commit/abort
|
||
races and recovery/activation as the next M12.4 segment. All of M12 remains in
|
||
progress. No deployment, automatic movement or live region changed.
|
||
|
||
## M12.4h durable source freeze and explicit abort - 2026-10-18
|
||
|
||
ADR-0147/schema 47 retains exact biological migration preparation, replay capsules
|
||
and a durable source freeze across worker replacement. Source publication and
|
||
new interval/player reservations are refused while pending; source stock and both
|
||
heads remain unchanged. Explicit current-source abort appends its outcome and
|
||
clears the pause, with exact retries. The host pauses readiness/advancement,
|
||
retains ambiguous requests and verifies complete biology before resuming.
|
||
|
||
Native Release passes 78/78; focused private PostgreSQL, ASan/UBSan, Clang
|
||
analysis, format and shell syntax checks pass. The complete private persistence,
|
||
process-fault, backup/DR and migration/permission suite passes in 502 s.
|
||
[Evidence and limits](engineering/VALIDATION.md)
|
||
retain destination staging, atomic paired commit, commit/abort races, activation
|
||
and linked-boundary contracts as subsequent M12.4 work. All of M12 remains in
|
||
progress; no deployment or live region changed.
|
||
|
||
## M12.4g durable accounting upgrade - 2026-10-18
|
||
|
||
ADR-0146/schema 46 extends the immutable version-upgrade journal to same-profile
|
||
bundle-9 to 10 upgrades. Full source/result replay protects biology and cohort
|
||
policy/membership/sequence; pending intervals and current lease/head fences remain
|
||
enforced. Batch 2 is admitted only under bundle 10, and representation changes
|
||
preserve either tuple. No worker upgrades automatically.
|
||
|
||
Native Release passes 78/78; Clang analysis/format and ASan/UBSan upgrade checks
|
||
pass. The complete private PostgreSQL/process/backup/DR/upgrade/permission/history
|
||
suite passes in 503 s. [Evidence and limits](engineering/VALIDATION.md) retain the
|
||
next M12.4 work: durable paired biological escrow, source freeze, destination
|
||
activation and linked-boundary contracts. All of M12 remains in progress; no
|
||
deployment or live region changed.
|
||
|
||
## M12.4f explicit portable accounting upgrade - 2026-10-17
|
||
|
||
ADR-0145 declares checkpoint bundle 10 for owner 7/population envelope 2, with an
|
||
explicit same-profile no-tick upgrade from retained bundle 9. Complete biology,
|
||
opening stock and cohort policy/membership/sequence are preserved. New genesis,
|
||
double upgrade and old/new payload confusion are refused; continuation and
|
||
representation changes preserve the tuple. Native Release passes 78/78;
|
||
Clang analysis/format, ASan/UBSan and private PostgreSQL admission-refusal checks
|
||
pass. [Evidence](engineering/VALIDATION.md) keeps this portable contract separate
|
||
from the dedicated durable upgrade transaction/recovery still required. Schema
|
||
45 still refuses the new bundle; no live selection or deployment changed.
|
||
|
||
## M12 CI execution repair - 2026-10-17
|
||
|
||
The captured sanitizer timeout and read-only fixture failures now have scoped
|
||
test-runner fixes: full instrumented matrices keep their cases with bounded
|
||
budgets, and restart fixtures use the TSan container's existing `/tmp` tmpfs.
|
||
Read-only root, non-root user, network isolation and seccomp policy remain intact.
|
||
Real-X11 lifecycle checks keep a persistent Xvfb server and report the typed open
|
||
error; the original intermittent reopen failure was not reproduced locally.
|
||
GCC warning fixes preserve consume-once authentication and panel-test behavior.
|
||
[Evidence and limitations](engineering/M12_CI_EXECUTION_REPAIR.md) distinguish
|
||
local qualification from the remote CI/container rerun still required. M12's
|
||
remaining integration/biology gates are unchanged; no deployment occurred.
|
||
|
||
## M12.4e continued population replay after transfer - 2026-10-17
|
||
|
||
Portable population batch 2 binds envelope 2/owner 7 and preserves boundary flows
|
||
and nonresident history through biological intervals and manual conversions.
|
||
Batch 1 retains its old meaning/bytes; cross-version replay is refused. A fresh
|
||
process also reproduces a 64-tick destination interval after cohort transfer.
|
||
Native Release passes 78/78; Clang analysis/format, ASan/UBSan and GCC checks pass.
|
||
The private PostgreSQL suite proves both prepared C++ and SQL reject batch 2 under
|
||
retained bundle 9, without moving the head. [Scope](engineering/M12_EXACT_BIOLOGICAL_TRANSFER.md)
|
||
keeps durable version admission, paired escrow/activation and later M12 ecology
|
||
gates open. No SQL, live flag, biological rule or deployment changed.
|
||
|
||
## M12.4d paired biological transfer replay - 2026-10-17
|
||
|
||
Canonical bounded migration trace 1 binds both predecessor cuts, both resulting
|
||
commit IDs, the workflow request, representation and exact members/material.
|
||
Replay uses the separately trusted request and both source states. A fresh
|
||
process reproduces the complete source/destination snapshots for individual and
|
||
cohort owners. Native Release passes 78/78; Clang analysis/format, GCC 14 and
|
||
ASan/UBSan migration checks pass. [Contract and limits](../schemas/cellular-migration-trace-v1.md)
|
||
retain the I/O digest/fencing obligations: this trace grants no ownership and
|
||
does not close durable escrow, database retry/abort or destination activation.
|
||
|
||
## M12.4c portable biological transfer - 2026-10-17
|
||
|
||
ADR-0144 adds opt-in owner format 7 and population envelope 2 with exact paired
|
||
wildlife transfer candidates, explicit regional boundary flows, retained
|
||
nonresident history and complete ancestry/revision merging. Cohort tags move with
|
||
their cells; opening budgets, identity, age and biological state remain exact.
|
||
Imported higher-namespace residents coexist with locally born lower-namespace
|
||
buds. Old durable manifest tuples explicitly refuse the new portable envelopes.
|
||
|
||
Native Release passes 77/77; Clang analysis/format, ASan/UBSan and the focused
|
||
private PostgreSQL population suite pass. [Scope and evidence](engineering/M12_EXACT_BIOLOGICAL_TRANSFER.md)
|
||
retain the limits: paired durable escrow/activation, linked geometry/environment
|
||
and multi-generation ecology remain open. Testing exposed rules 8's existing
|
||
subadult-bud maturation gap; no growth or reproduction rule was changed to hide
|
||
it. M12.4 and all of M12 remain in progress; no deployment or live entry changed.
|
||
|
||
## M12.4b owned population intervals - 2026-10-17
|
||
|
||
ADR-0143/schema 45 records one bounded interval before computation and settles it
|
||
atomically with its exact checkpoint. Replacement owners retain the same pending
|
||
work; zero newly due ticks can finish a recovered interval. Unknown admission
|
||
pauses readiness and retries its immutable source/end. A separate durable pending
|
||
tick metric complements local debt and checkpoint age.
|
||
|
||
New entry/work requires fully suspended controlled cells: the existing 200-tick
|
||
vulnerable linger and permanent-ending path stays on profile 4. Old traces retain
|
||
their meaning, and either profile's recovery reconciles owned corpses. No new
|
||
biological version, immunity, dependency or deployment was introduced. See
|
||
[scope and evidence](engineering/M12_OWNED_POPULATION_INTERVALS.md). Biological
|
||
migration escrow and linked-boundary/resource contracts remain the next M12.4
|
||
work; this does not close all of M12 or enable production automatically.
|
||
|
||
## M12.3b durable exact populations - 2026-10-17
|
||
|
||
ADR-0142 and schema 44 add dedicated population profile 5, trace 1, immutable
|
||
publication/transition evidence and exact source/target recovery. The owning
|
||
cellular host recovers either representation, materializes before player
|
||
operations and serializes mutation reservations against profile entry. The
|
||
optional `--cellular-populations on` path batches unattended work; entry is off
|
||
by default. No biological version, golden, deployment or live region changed.
|
||
|
||
[Scope and evidence](engineering/M12_DURABLE_POPULATIONS.md) distinguish portable
|
||
contracts, real PostgreSQL ambiguity/process-loss tests and host recreation from
|
||
remaining executable/network fault drills and target-host qualification. Durable
|
||
interval admission/backlog is the next M12.4 segment. The dependent ecological,
|
||
multi-day and returning-player gates remain open; M11.9 stays closed for now.
|
||
|
||
## M12.4a current-worker unattended scheduling - 2026-10-17
|
||
|
||
The cellular worker now keeps ticking for funded wildlife after players suspend,
|
||
and active offline cells can start their freeze/linger transition. Running
|
||
publication latency no longer discards tick debt; confirmed heads consume it,
|
||
with bounded retries, fixed 50 ms steps and debt/checkpoint-age metrics. Legacy
|
||
profiles without offline freeze retain their prior session-driven behavior.
|
||
Release tests pass 75/75; clang-format/tidy 19, ASan/UBSan and the full private
|
||
PostgreSQL/process/backup/DR/upgrade suite pass. ADR-0141 records scope.
|
||
|
||
**M12 is not complete.** The [remaining-gate audit](engineering/M12_REMAINING_GATES.md)
|
||
specifies the population publication profile/adapter, biological escrow,
|
||
environment coupling, global history/extinction reconciliation and actual
|
||
multi-day/product evidence still required. M11.9 stays closed for now; this is
|
||
not another approval hold. Current code does not enable the live cohort selector,
|
||
deploy changes or authorize M13/World0 promotion.
|
||
|
||
## M12.3a exact conversion recovery - 2026-10-17
|
||
|
||
Population envelope 1 retains biology, cohort membership, policy and conversion
|
||
sequence together. Detached candidates preserve their predecessor; opt-in
|
||
automatic hysteresis is deterministic and disabled by default. Separate-process
|
||
continuation matches uninterrupted execution, with malformed input, oscillation
|
||
and sequence exhaustion checks. Release tests pass 74/74, plus clang-format/tidy
|
||
19 and ASan/UBSan. [ADR-0140](adr/0140-exact-population-checkpoint-and-policy.md)
|
||
records the remaining production profile/trace/publication adapter; local file
|
||
recovery does not close that gate. No deployment or live format change.
|
||
|
||
## M12.2d exact cellular cohorts - 2026-10-17
|
||
|
||
Under the maintainer's delegated M12.2 authority, ADR-0139 selects exact local
|
||
cohorts retaining every member. Regional approximation stays disabled. The
|
||
[qualification](engineering/M12_EXACT_CELLULAR_COHORTS.md) matches complete
|
||
canonical biology over 196,608 paired ticks per compiler, including thousands
|
||
of conversion oscillations. Local active fallback samples reach the existing
|
||
256-life ceiling with admission backpressure. Release CTest passes 72/72;
|
||
clang-format/tidy 19 and ASan/UBSan checks pass. No compression or production
|
||
capacity is claimed. Target-host costs and fuller interaction coverage remain
|
||
open. Exact-owner durable transitions may proceed without live enablement.
|
||
|
||
## M12.2c current cellular reference - 2026-10-17
|
||
|
||
The [rules-8 headless reference](engineering/M12_CELLULAR_REFERENCE.md) passes
|
||
eight full cases with matching MSVC/GCC state/coverage outputs. It exercises
|
||
funded mutations, wildlife births, starvation and offline suspension with exact
|
||
encoded replay at 1/16/64-tick partitions. Native Release CTest passes 71/71,
|
||
with clang-format/tidy and Linux ASan/UBSan checks. This supplies the current
|
||
active control; actual cellular/cohort fidelity and target-host budgets remain
|
||
the M12.2 work ahead. M11.9's scoped closure authorizes that continuation.
|
||
|
||
## M11.9 closed for now; M12 continuation - 2026-10-17
|
||
|
||
The maintainer explicitly closes M11.9 for now and authorizes proceeding with M12.
|
||
The solo observations and incomplete product sample remain follow-ups, not a
|
||
continuing gate block. Reviewed the current microscope HUD at three sizes,
|
||
mutation cards and central death/restart presentation through production-panel
|
||
renders; see [closure and UI review](engineering/M11_9_CLOSURE_AND_UI_REVIEW.md).
|
||
The current reference is rules 8 with finite pools/bubbles and contact feeding.
|
||
M12.2 still requires cellular/cohort fidelity and target-host fallback evidence;
|
||
no automatic tier selection follows from the M11.9 closure.
|
||
|
||
## M11.9 solo feedback - 2026-10-16
|
||
|
||
[The maintainer's eight answers](playtests/2026-10-16_M11_9_SOLO_FEEDBACK.md)
|
||
are recorded. Returning to a living cell is blocked by an existing-life message
|
||
with no cell visible; diagnose that resume/routing/view path first. The solo loop
|
||
felt repetitive, mutation effects and predation need more testing, and fun remains
|
||
uncertain. Food distribution, pacing and presentation suggestions remain proposals.
|
||
M11.9 product acceptance is open; this is feedback, not completion of the sample.
|
||
|
||
## M12.2b experiment - 2026-10-16
|
||
|
||
A separate exact-reserve/age candidate matches 83 synthetic histories, including
|
||
40 held-out cases, at every tick on MSVC and GCC. The old failed aggregation
|
||
fixture and evidence remain unchanged. Compact active controls show that cost
|
||
benefits depend on compiler and workload; no production capacity is inferred.
|
||
See [the experiment report](engineering/M12_RESERVE_STRATA_EXPERIMENT.md).
|
||
Release tests pass 70/70, with clang-format/tidy 19 and Linux ASan/UBSan checks.
|
||
M12.2 still needs M11 cellular multi-genome qualification and target-host fallback
|
||
budgets; M12.3-12.5 and the unrecorded M11 product review remain open.
|
||
|
||
## M12 start - 2026-10-15
|
||
|
||
M12.1 defines ecological identity, viability evidence and time boundaries in
|
||
[ADR-0133](adr/0133-ecological-identity-and-time-evidence.md), including explicit
|
||
deferral of species algorithms, autonomous mutation, evolving behavior and
|
||
whole-world wall-time catch-up. Existing M11 biology and runtime formats remain
|
||
unchanged. The [M12 delivery plan](engineering/M12_DELIVERY_PLAN.md) records the
|
||
open M11 product review and M12.2 population qualification prerequisites.
|
||
Automatic tier selection remains disabled; 12.3-12.5 cannot proceed on M4's
|
||
failed aggregation model.
|
||
|
||
12.2a reproduces all 15 historical scenarios, including eight false extinctions
|
||
and zero qualified widths; Release CTest passed 69/69. See
|
||
[population qualification](engineering/M12_POPULATION_QUALIFICATION.md).
|
||
M12.2 remains open; no production aggregation or unattended scheduling was added.
|
||
|
||
## Client update - 2026-10-14 (v10)
|
||
|
||
The desktop cellular client now negotiates v10, exposes mutations with funded
|
||
costs, engulf/bud feedback, reserves, death and restart, and retains unresolved
|
||
requests through reconnect. Automatic feeding, adjustable/precision steering,
|
||
food approach assistance and a responsive teal interface address playtest
|
||
usability. See [CLIENT](engineering/CLIENT.md) and the validation entry for
|
||
checks and remaining live-play/hardware qualification. No deployment or world
|
||
state change is part of this client update.
|
||
|
||
## Current gate - 2026-10-11 (M11.3 exploratory probe)
|
||
|
||
The maintainer reports that the Git checks passed, `evo-region` is running, and
|
||
the client can connect. This establishes deployment/connectivity, not that the
|
||
cellular actions or their usability have been exercised. The M11.3e one-player,
|
||
single-region exploratory probe is the next gate, before expanding mutation in
|
||
11.4; its instructions are in
|
||
[`M11_3_CELLULAR_PROBE.md`](playtests/M11_3_CELLULAR_PROBE.md). The v8 cellular
|
||
path, first-life result, steering, feeding and the player's observations still
|
||
need confirmation. M11.2's owner lookup, pre-claim redirect, client-follow path
|
||
and PostgreSQL restart test are implemented and pushed; Linux/PostgreSQL CI has
|
||
not yet been confirmed, so multi-region qualification remains open.
|
||
|
||
## Current gate - 2026-10-09 (M11.2)
|
||
|
||
ADR-0098 records the maintainer's decisions for the first playable cellular loop:
|
||
- **Budding:** the parent keeps control and funds one wildlife bud.
|
||
- **Mutation:** earned during life, offered as seeded candidates and applied through
|
||
funded development.
|
||
- **Heredity:** exact copy; wildlife does not mutate in M11.
|
||
- **Logout:** biology freezes at once; the organism lingers, frozen but vulnerable, then
|
||
suspends.
|
||
- **Resume:** in place, or at the nearest valid spot within a bounded radius.
|
||
- **Feeding:** absorption and engulfment by a size ratio contested by membrane
|
||
thickness.
|
||
- **Birth cost:** a first bud fundable within a session (a tunable playtest target).
|
||
- **Friend recognition:** deferred.
|
||
|
||
11.1's ratified engineering half, time-based biological rates, is complete (ADR-0099;
|
||
the maintainer chose directional rounding):
|
||
- **Segment 1 (done):** `accounting/rates.hpp` converts a per-second rate to a per-tick
|
||
amount without saved state. Costs round up and capacities down, so rounding never
|
||
favours the organism. The migration's exact ×20 inverse refuses inexact values.
|
||
- **Segment 2 (done):** genome schema 2 stores rates per second. Schema 1 records are
|
||
read ×20 and never rewritten. Development version 1 converts at its own 50 ms
|
||
quantum, mutation keeps a lineage's schema, and an archive of schema 1 records keeps
|
||
its bytes. No behaviour or golden changed.
|
||
- **Segment 3 (done):** environmental community rules 3 states irradiance, growth,
|
||
intake and decay per second. At 50 ms it steps identically to its rules 2 twin. The
|
||
dev world's rules 2 opening is unchanged. Development version 1 outputs stay tied to
|
||
their declared 50 ms quantum. The tick-abstract M2 fixtures are not migrated. ADR-0089's
|
||
rate migration is complete.
|
||
- **Development version 2 and the primitive founder (done; tunable):** rates are per
|
||
second. A full-grown founder that pays full-speed movement throughout funds its first
|
||
bud in 5, 10 and 15 minutes when feeding 100%, 50% and 33% of the time (ADR-0099).
|
||
11.1 is complete.
|
||
- **In progress:** 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 accepted
|
||
[ADR-0100](adr/0100-primitive-lives-and-persistent-control.md) identify the new
|
||
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.
|
||
11.2b adds a bounded creation-state checkpoint codec with full inventory/archive
|
||
closure and exact retry recovery. 11.2c-1 adds durable identity reservations,
|
||
world-wide account exclusivity, and retained refusals under fenced account
|
||
control. A reservation spends nothing and is not a spawned organism.
|
||
Atomic body/checkpoint publication and life binding are in the adapter. The
|
||
separate profile-3 region host now recovers and durably publishes a new life,
|
||
without advancing biology. v5 authenticated session execution and primitive
|
||
profile selection are implemented. The migration-24 life-owner lookup,
|
||
pre-claim redirect and operator route catalog are now implemented; two-region
|
||
restart and client-follow tests are pushed but await CI confirmation. The v17
|
||
PostgreSQL and host integration tests have prior CI confirmation.
|
||
|
||
Open from M10 (BACKLOG):
|
||
- the maintainer's native-client observation, moved to the later 2k drill;
|
||
- the Windows client failing to connect to the dev region after a CA renewal.
|
||
|
||
## Current gate - 2026-10-03
|
||
|
||
M10.1 ratifies M10 timing and workload budgets (ADR-0089,
|
||
schemas/network/m10-budgets-v1.md): 50 ms tick, 1 s commit flush with final outcomes
|
||
p95 <= 1.5 s, responsiveness LAN p95 <= 150 ms and 100 ms RTT p95 <= 250 ms, server
|
||
budgets on one RKE2 worker and client budgets on the low-spec VM. Development-reference
|
||
traces (`evo-dev-session trace`, networking/M10_TIMING_TRACES.md) measured admission
|
||
p99 <= 5.2 ms, durable p95 about 1.4 s and 50 ms view cadence. Finding: genome v1 and
|
||
metabolism use per-tick rates, so the quantum fixes biological rates until M11.1
|
||
converts or ratifies them. M10.2a selects QUIC with msquic 2.6.2 and OpenSSL 3.5.9 LTS
|
||
(ADR-0090), pinned and building on Windows and Linux with a loopback smoke test. M10.2b adds
|
||
the bounded QUIC endpoint (datagram and reliable channels, exact CA pinning with the owned
|
||
check authoritative, minimum-MTU start) and the owned impairment relay, tested on both
|
||
platforms. M10.2c measures loss and head-of-line blocking through the relay: under 5-10 %
|
||
loss the ordered stream's p95 latency is 3-5.5x the datagram channel's and exceeds the
|
||
250 ms target at 100 ms RTT, while datagrams stay <= 67 ms, which confirms the channel split
|
||
(networking/M10_TRANSPORT_MEASUREMENTS.md). M10.2 is complete. M10.3a (ADR-0091) adds provider-independent account ids, ECDSA P-256
|
||
session grants verified with public keys only, the identity adapter and grant issuer
|
||
library, and per-region session control (newest grant wins and replaces the old session,
|
||
replay and stale grants refused, in-session refresh, attempt rate limits). M10.3b adds the
|
||
session login over QUIC (session-v1: Hello, Welcome, Refresh, Close with reasons) on both
|
||
the region and client side, tested end to end on loopback. M10.3c adds durable per-world
|
||
account control (schema v10): grant serials survive restarts and apply across regions,
|
||
cross-region takeover waits out the previous holder, and sessions close when their
|
||
control is fenced or cannot be renewed. M10.4a (ADR-0092) adds
|
||
intentions (datagram receipts and a cumulative simulated watermark) and account-scoped
|
||
actions with stable ids, receipts and final outcomes to session-v1, with admission
|
||
(window, rate, sequence, duplicates, unresolved bound) and client support; intentions and
|
||
actions have no biological effect yet. M10.4b makes
|
||
action outcomes durable: schema v11 records each batch's actions in the same statement as
|
||
its checkpoint, the host attaches actions to the ticks they ride, and outcomes are read
|
||
from the durable record after crashes before or after a commit, unknown publications and
|
||
cross-region moves. M10.4c adds the opt-in
|
||
evo-server QUIC listener (session control and action records under the host's lease) and
|
||
the headless `evo-session-probe`, with real-process tests including SIGKILL before and after
|
||
an action's commit. M10.4 is complete. Next: M10.5 bounded snapshots and spatial interest.
|
||
Deployment (2026-10-05): the maintainer deployed the M10 QUIC listener to evolution-dev
|
||
behind the ADR-0087 route; session protocol v1 is therefore frozen. The route admitted
|
||
only TCP 7400 while QUIC is UDP, so it is changed to UDP 7400 (ADR-0087 amendment). The
|
||
route is not yet verified end to end: the edge firewall rule (UDP 7400 from
|
||
172.10.1.0/24), internal DNS to 172.10.1.202 and a probe run through the VIP remain.
|
||
M10.5a (ADR-0093) adds session protocol v2 (interest, snapshot chunks, snapshot acks; v1 is
|
||
refused) and the replication core: server-capped interest with a perception boundary,
|
||
entity deltas against the acknowledged baseline, nearest first within 16 KiB per tick with
|
||
a slower distant tier, datagram chunks and client assembly. M10.5b wires it end to end:
|
||
evo-server replicates the region's environment for each session's interest (default: the
|
||
first habitat site), the client assembles and acknowledges snapshots, and the probe prints
|
||
them. M10.5c switches the engineering client to M10 sessions: snapshot-fed views, the camera
|
||
driving the interest after the user moves it, grant bundles (`evo-session-probe grants`,
|
||
evo-server `--m10-max-grant-lifetime` for dev), and `msquic.dll` in the Windows package.
|
||
M10.5 is complete. Deploying the v2 server to evolution-dev (the dev server still runs v1)
|
||
is a maintainer step. M10.6a (ADR-0094) adds the probe-motion experiment: one
|
||
non-biological marker per session moved by intentions with a shared integer rule, session
|
||
protocol v3 marker records (v2, deployed, is frozen and refused), and the client predictor
|
||
(bounded replay from the authoritative marker, corrections, smoothing, adaptive input lead).
|
||
M10.6b wires it: evo-server gives every session a marker in the habitat area, the probe
|
||
prints it, and the engineering client predicts and draws it (WASD), following it with
|
||
camera and interest. M10.6c traces it through the impairment relay: exact without loss,
|
||
94-99 % exact at 60-200 ms RTT with 2-5 % loss, convergence after stopping and a restart
|
||
resync of about 2-3 s (networking/M10_PREDICTION_TRACES.md). M10.6 is complete. M10.7a (ADR-0095) adds a drift-corrected tick clock, adaptive
|
||
interpolation of remote markers (2-6 ticks behind, at most 2 ticks extrapolated, then
|
||
stale; organisms never) and sub-tick own-marker presentation. M10.7b wires it into the
|
||
engineering client. A lost session's view stays frozen and labelled stale until the
|
||
reconnect's fresh baseline. In two-client traces, remote markers shown as current stay
|
||
within about 0.1 m of the true path, and outages show stale. M10.7 is complete. M10.8a (ADR-0096, the ratified handoff ADR) adds schema v12:
|
||
- durable probe records, one owning region per account;
|
||
- a fenced transfer state machine (prepared, staged, committed, aborted) whose every retry
|
||
returns the recorded outcome;
|
||
- an account-control handoff for committed transfers.
|
||
|
||
A PostgreSQL fault matrix covers restarts at each transition, stale epochs, aborts,
|
||
partitions and commit/abort races, checking a unique owner and the conserved test inventory.
|
||
Deploying v12 needs a rebuilt migrations image. M10.8b adds signed handoff tickets. A source
|
||
region's key signs one transfer for one account and destination; the ticket rides the Hello
|
||
grant slot and is verified against the neighbour keys registered here. The destination then
|
||
durably stages and commits the transfer and takes the account's control before admitting
|
||
the session. M10.8c-1 wires the regions:
|
||
- session protocol v4 (handoff offer, redirect, ghosts; v3 is deployed and frozen);
|
||
- sessions use the durable probe: opened where it was saved, redirected when it lives
|
||
elsewhere;
|
||
- a marker crossing into a neighbour's area is frozen, prepared and offered with a ticket;
|
||
- the destination shows arriving probes as ghosts (schema v13) and opens the marker where it
|
||
crossed.
|
||
|
||
M10.8c-2 has the engineering client follow crossings (ticket, no loading screen) and
|
||
redirects, with grants picked by region in rising serial order. evo-server gains
|
||
`--m10-area`, `--m10-handoff-key` and `--m10-neighbour`; the probe tool writes multi-region
|
||
bundles. M10.8d runs two evo-server processes on PostgreSQL through crossings and
|
||
crossings back, with SIGKILL of the source after prepare and of the destination after stage
|
||
and after commit, duplicate and stale ticket retries, a client that never arrives and a
|
||
destination that is down. After every scenario each probe has one owner, the inventory is
|
||
conserved and a record is frozen only under its open transfer. It found and fixed two
|
||
recovery gaps:
|
||
- a source restarted after a prepare now aborts overdue transfers from the database
|
||
(schema v14);
|
||
- a ticket replayed at a restarted destination after the probe moved on is refused.
|
||
|
||
M10.8 is complete. Deploying needs protocol v4 and schemas v12-v14 (a rebuilt migrations
|
||
image). M10.9a (ADR-0097) starts load qualification. Only runs on the evolution-dev reference
|
||
worker count as evidence. evo-server now measures each tick's work (host step plus session
|
||
layer) and feeds a load governor:
|
||
- above a p95 of 15 ms, or with tick debt, new grant logins are refused (`capacity`), while
|
||
crossings are still admitted;
|
||
- above 20 ms, replication sheds radius and far-update cadence in up to 3 levels;
|
||
- both relax after 5 s of calm.
|
||
|
||
`/metrics` exposes the work percentiles (total and session layer) and the governor's
|
||
state. M10.9b adds `evo-load`, a multi-client load generator. It runs bots on worker
|
||
threads that send intentions every tick, actions, interest moves and reconnects. It reports
|
||
per step pooled and per-client distributions, a starvation check, a budget verdict and the
|
||
region's gauges, ending with the sustainable bot count. In a local development reference
|
||
(not evidence), one region stayed within budget up to 24 bots and the governor began
|
||
refusing at 32 (work p95 about 14 ms), with responses about 103 ms and outcomes about
|
||
665 ms throughout. M10.9c-1 adds the abuse suite's first half:
|
||
- a libFuzzer target for session protocol v4, grants, tickets and snapshot assembly (23
|
||
million inputs, no findings), also run as a seeded smoke test on every platform;
|
||
- in-process floods (Hello, datagram), a slow peer and a connect/disconnect storm, during
|
||
which an honest session kept every snapshot and receipt.
|
||
|
||
`evo-session-probe` can now log in from a renewal's grant bundle. A dev login was welcomed
|
||
and its intention admitted (the dev region does not simulate outside drills). M10.9c-2
|
||
kills and drains a real evo-server under 24 `evo-load` bots. All of them log in to the
|
||
successor within 5.0 s (SIGKILL, after a 3.5 s lease wait) or 2.4 s (drain), with no failed
|
||
logins, and responses stay at 106 ms p95. M10.9d adds the evolution-dev load drill
|
||
(`tools/ops/load-drill.sh`). It turns synthetic inputs on for the run, drives bundle-mode
|
||
`evo-load` bots through the public route, and matches each step with the server's 10 s
|
||
`m10 load-report` log lines. Building it found that Mbed TLS (built without its threading
|
||
layer) raced when bots verified connections on several threads; one process-wide crypto
|
||
lock fixed it.
|
||
|
||
Reference runs on evolution-dev:
|
||
- **Third:** 24 sessions within the client budgets. It led to budgets v2 (commit ticks
|
||
≤ 50 ms, measured apart from the rest) and to watermark coalescing.
|
||
- **Fourth:** the first run whose actions committed. It exposed one synchronous store
|
||
round trip per action on the simulation thread. Lookups are now batched: one per poll
|
||
and one per commit, with no schema change.
|
||
- **Fifth:** clients within budget at 20, 24, 28 and 32 sessions. The server was within
|
||
budgets v2 at 24–32 (work p95 ≤ 12.9 ms, commit ticks ≤ 44.3 ms, no tick debt) and
|
||
reached the configured 32-session cap without saturating. At 20, the login ramp drew 4
|
||
refusals and per-session p99 was 0.554 ms (budget 0.5).
|
||
|
||
The maintainer closed 10.9 for now (2026-10-09):
|
||
- evo-server's session cap is raised to 2000, with the load governor as the working limit;
|
||
- drills stop for now. Saturation and native-client observation move to a later 2k drill.
|
||
ADR-0097 lists what that drill must solve first: single-thread CPU (the governor would
|
||
cap near 50–70 sessions), the region login rate (64 per 60 s), the 256 MiB pod limit and
|
||
linear session lookups.
|
||
|
||
## Previous gate - 2026-10-02
|
||
|
||
M9.8a: Dear ImGui 1.92.9b is pinned and qualified in an isolated Windows/Linux
|
||
SDL3 probe (ADR-0084). M9.8b adds bounded notification/dialog state, protected
|
||
external input capture and bounded session events with disconnect/drain/reconnect
|
||
backpressure. M9.8c adds the launcher (labelled local fixture vs dev region,
|
||
bounded errors, Retry/Cancel), legend, labelled inspector, click selection, session
|
||
panel with the intention outcome record, and visible notifications/dialog. M9.8d
|
||
adds rebindable controls (ADR-0085) with conflict checks and a validated file. M9.8e
|
||
builds a static-runtime Windows x64 ZIP locally with notices, identity, checksums and
|
||
credential guards (ADR-0086); Actions publication needs a Windows runner. M9.8f designs the dev session route (ADR-0087), with the local test-route inputs now
|
||
reserved in [VOID_SESSION_ROUTE_REPORT](engineering/VOID_SESSION_ROUTE_REPORT.md),
|
||
while the route remains disabled with fail-closed policy tests; nothing was applied to
|
||
the cluster. Tests,
|
||
visual review and limits are recorded in engineering/VALIDATION.md.
|
||
|
||
Next: implement and test server-enforced session windows, then include the prepared
|
||
ADR-0087 route and complete DNS, certificate, Argo, health-check-port and connectivity
|
||
validation. The local route inputs are recorded in engineering/VOID_SESSION_ROUTE_REPORT.md.
|
||
Windows packages will be built locally until a Windows runner exists. Testing is internal; 172.10.1.160 is the
|
||
RKE2 control-plane address. VM qualification and the cluster restart drill remain
|
||
outstanding, as agreed. See engineering/M9_8_DELIVERY_PLAN.md.
|
||
|
||
## M9.7 delivered scope
|
||
|
||
|
||
M9.7 connects the engineering client to an authoritative dev region
|
||
([ADR-0083](adr/0083-dev-region-sessions.md),
|
||
[DEV_SESSION_OPERATIONS](networking/DEV_SESSION_OPERATIONS.md)). evo-server runs a
|
||
non-blocking TLS 1.3 session server in its loop; clients see environment views from
|
||
the region's real field/terrain stores and an explicitly empty organism layer. An
|
||
admitted intention rides a synthetic input and returns a durable, no-effect outcome
|
||
after the host's commit. Reconnects consume fresh grants and start from a fresh
|
||
baseline; stale epochs, duplicates, foreign grants and floods are refused.
|
||
|
||
Proceeding with the maintainer's agreement although **M8-dev/stage is not passed**.
|
||
Local evidence is real (evo-server + PostgreSQL, SIGKILL + successor); the dev
|
||
deployment path (drill-time override, loopback listener, optional Secret,
|
||
`tools/ops/session-drill.sh`) is prepared but **not run**: no cluster access was
|
||
available. Next: **M9.8** packaging and presentation qualification.
|
||
|
||
M9.6 defined the dev-session protocol and TLS 1.3 channel
|
||
([ADR-0082](adr/0082-dev-session-transport.md)).
|
||
|
||
M9.5 added biology-derived organism rendering without controller labels
|
||
([ADR-0081](adr/0081-organism-presentation.md)).
|
||
|
||
M9.4 added owned revision-tagged environment presentations and explicit
|
||
missing/stale rendering ([ADR-0080](adr/0080-environment-presentation.md)).
|
||
|
||
M9.3 added local-mm pan/zoom camera mapping and bounded sequence/tick input
|
||
intentions ([ADR-0079](adr/0079-camera-and-input-intentions.md)).
|
||
|
||
The sections below retain earlier milestone delivery history.
|
||
|
||
Updated 2026-09-27. The repository contains an engineering foundation and a
|
||
deterministic headless proof. It does not yet contain cellular gameplay or a
|
||
persistent simulation server. The founding vision remains unchanged.
|
||
|
||
## Completed implementation
|
||
|
||
- Vision, architectural pillars, risks, open-question register, architecture
|
||
diagrams, biological contracts, engineering constitution and 58 ADRs (including the accepted M7.1 durability contract).
|
||
Proposed/deferred choices remain distinct from accepted proof decisions.
|
||
- M0–M4 task breakdowns with dependencies, acceptance evidence and risks,
|
||
plus M5–M14 gates in [ROADMAP.md](ROADMAP.md).
|
||
- C++23 CMake/Ninja library and CLI with no graphics, networking, database or
|
||
Kubernetes dependency. Versioned fixed ticks, stable entity IDs, component
|
||
lifecycle and explicit per-entity seeded randomness.
|
||
- Bounded canonical snapshots and restore, plus replay verification. An independent
|
||
reference fingerprint and Release-active tests cover lifecycle, malformed data,
|
||
overflow, seeded properties and CLI save/load.
|
||
- Formatter, static analysis, sanitizer presets, codec fuzz entry point, benchmark,
|
||
structured host logging and metrics output. Benchmark compiler metadata now
|
||
resets numeric formatting after printing its hexadecimal state hash.
|
||
|
||
## Delivery and verification
|
||
|
||
Git remote is `https://git.aeternalisgames.com/dingo/AEvolution.git`. The maintainer
|
||
added a working Gitea/Harbor workflow; run 1399 on `8ab48d3` successfully verified
|
||
and published. The foundation update extends that single workflow with Linux
|
||
analysis/sanitizers/fuzzing and runtime smoke verification. Images target
|
||
`registry.aeternalisgames.com/aeternalis/aevolution`.
|
||
|
||
[Run 1402](https://git.aeternalisgames.com/dingo/AEvolution/actions/runs/1402)
|
||
passed all jobs for source commit `4c2cc04`: Linux checks, separate TSan and image
|
||
smoke/publish. That verified image was previously pinned. The maintainer's
|
||
subsequent GitOps commit `20e609d` selects the run 1399 image at
|
||
`sha256:0c6c6e1ac28de2ce0648fd0992ca694963e303ef5c9414fe5ac668937136800d`;
|
||
the M1.6 change preserves that independent deployment choice.
|
||
Windows checks also pass; full commands and intermediate CI failures are recorded
|
||
in the validation report. M0's engineering proof is verified; dev cluster
|
||
execution is the remaining delivery check, not a claim of persistent-world readiness.
|
||
|
||
The maintainer confirms Argo is configured and deployment additions will sync
|
||
when a pod workload is ready. This workspace has no kubeconfig, so completed dev
|
||
Job execution is not independently verified. This is not a blocker for M1.
|
||
The repository supplies a restricted dev Job and bootstrap examples; image
|
||
publication does not demonstrate a Kubernetes rollout or world recovery.
|
||
|
||
See [VALIDATION.md](engineering/VALIDATION.md) for actual commands/results and
|
||
[deploy/README.md](../deploy/README.md) for image promotion and application setup.
|
||
Local `INITIAL_BRIEF.md` and `OpenAI_ChatLog.md` are maintainer-provided untracked
|
||
material and are not automatically included in commits.
|
||
|
||
## Next reviewable increments, in order
|
||
|
||
M1.5 progress: the opt-in row/EnTT4 experiment now checks canonical equality,
|
||
restore continuation, retired identities and allocator balance, and records
|
||
seven-sample sparse/dense/churn results. Windows Release, analysis and ASan checks
|
||
passed, as did Linux Release, analysis and ASan/UBSan in Gitea run 1404. All 56
|
||
sample fingerprints match across platforms. ADR-0005 retains rows
|
||
for the bounded proof; the general production ECS remains a later measured choice.
|
||
|
||
| Priority | Work | Completion evidence |
|
||
|---|---|---|
|
||
| 1 | M7.2 adopt storage dependencies and migrations | Pinned PostgreSQL client/server evaluation, guarded schema, real migration and error-path tests |
|
||
| Research | Improve aggregate fidelity and measure Linux/target-host costs | M4.6 found no qualifying width; see the aggregate budget report |
|
||
| 2 | Revisit the ADR-0031/0032 reproduction cost model | Reproduction is affordable only at the genome schema's floor; decide whether that is intended before M4 builds cohorts on it |
|
||
| Delivery gate | Add/update the dev workload when a deployable increment needs it; Argo is ready | Observe Job/pod completion separately from image publication; no World0 changes |
|
||
|
||
M1.6 now implements [the sequential scheduler contract](architecture/SCHEDULER_CONTRACT.md):
|
||
exact-tick admission, bounded ordered lifecycle commands, receipts and atomic
|
||
rollback on rejection. Windows Release, clang-tidy, ASan and formatting checks
|
||
pass. Permutations across 32 seeds, restored continuation, duplicate/late/future
|
||
inputs, limits and exhaustion are covered. The no-input golden and snapshot v1
|
||
are unchanged. Gitea run 1407 passed all Linux checks, ECS, TSan and image jobs;
|
||
evidence is recorded in the validation report.
|
||
Nonempty batches copy world state; this favors a clear transaction boundary for
|
||
the proof, not a measured realtime performance claim. No thread pool or gameplay
|
||
input protocol is introduced.
|
||
|
||
M1.7 implements read-only periodic neighborhood queries with stable IDs and
|
||
inclusive integer-distance boundaries. A nine-image oracle checks 2,304 seeded
|
||
queries across initial, scheduled and restored worlds. Boundary and full-capacity
|
||
tests supplement the oracle. The benchmark records uniform/clustered worlds up
|
||
to 100,000 entities. This is a linear correctness baseline, not a production
|
||
spatial index. See the spatial contract and validation report for scope/evidence.
|
||
Native Release/ASan/analysis/format checks passed, as did all jobs in Gitea run
|
||
1409. All 72 Linux benchmark result checksums and match counts equal Windows.
|
||
|
||
M2.1 adds an independent finite-inventory accounting library (ADR-0024). Typed
|
||
picojoules and C/N/P/other femtograms transfer atomically across bounded local
|
||
reservoirs. Opening totals are checked, repeated action IDs rejected, and failures
|
||
leave both balances and action watermark unchanged. One million seeded transfers
|
||
are checked against independently maintained balances and recomputed totals.
|
||
No organisms, biochemical rates, external replenishment, world snapshot format
|
||
or deployment changes are included. Conservation does not establish valid
|
||
chemistry or reusable heat; process restrictions are M2.2 work.
|
||
Native Release, clang-tidy, ASan and formatting passed; Gitea run 1411 passed all
|
||
Linux checks, ECS, TSan and image publication. Validation details are recorded
|
||
in the engineering validation report.
|
||
|
||
M2.2 implements a synthetic finite-source producer process owning its ledger.
|
||
It captures energy, sends conversion losses to heat, and funds whole material
|
||
recipes from reserves and finite nutrients. Fractional rates and efficiency
|
||
carry exact remainders; tick/remainders and balances commit together. Tests cover
|
||
hand-calculated outcomes, 32 seeded reference/replay runs, source and nutrient
|
||
exhaustion, invalid tick/config rejection and u64 arithmetic limits. No organism,
|
||
genome, database, process snapshot or deployment is implied by this fixture.
|
||
Native Release, analysis, ASan and format checks passed, and Gitea run 1413
|
||
passed all Linux checks, ECS, TSan and image jobs.
|
||
|
||
M2.3 adds a shared feeding community with one producer and up to 16 consumer
|
||
capabilities. One ledger owns all process resources, heat and waste. Ordered
|
||
intake-capped feeding, producer progression and terminal depletion commit as one
|
||
tick; a rejected request leaves the entire community unchanged. Tests cover
|
||
predation, resource contention, terminal actors, batch order/replay and conservation.
|
||
No spatial/perception validation,
|
||
organism biology, persistent checkpoint or deployment is included in this fixture.
|
||
Native Release, analysis, ASan and formatting passed; all four Gitea run 1415
|
||
jobs passed.
|
||
|
||
M2.4 adds terminal events with preserved corpse inventory, followed by a shared
|
||
bounded decomposition phase. Energy moves to heat, elemental matter returns to
|
||
nutrients, and next-tick producer growth can use those nutrients. Corpses retain
|
||
their process ID and cannot resume activity. Invalid ticks roll back death and
|
||
decomposition with all earlier phases. Default zero decay preserves earlier
|
||
fixture behavior. This is not death-cause biology, microbial chemistry, corpse
|
||
scavenging, persistent lineage history or a database-backed world.
|
||
Native Release, analysis, ASan and formatting passed, and all four jobs in Gitea
|
||
run 1417 passed.
|
||
|
||
M2.5 adds funded budding (ADR-0028). A bounded list of trusted reproduction
|
||
intents runs after feeding and before decomposition, so a consumer can fund
|
||
offspring from what it ingested and a process terminated in that tick cannot
|
||
reproduce. Parent eligibility is fixed on entry to the phase, so a child born in
|
||
a tick cannot itself be a parent until the next one. The intent names a
|
||
withdrawal from the parent; a fixed construction
|
||
fraction endows the child and the remainder becomes real heat and waste. Reserved
|
||
slots are pre-allocated at creation, so a birth never grows the ledger and a full
|
||
community rejects rather than funding a smaller child. Process identities are
|
||
never reused and a parent reference plus origin tick outlive both organisms.
|
||
A child duplicates its parent's configuration because no genome exists yet; this
|
||
is duplication, not heredity. Default zero capacity leaves every M2.4 result and
|
||
the particle goldens unchanged. Native Release, analysis, ASan and formatting
|
||
passed; Linux CI for this increment has not run yet. This is not a reproductive
|
||
strategy, fecundity rule, mutation model or funded founder admission.
|
||
|
||
M2.6 closes M2 with a deterministic ecosystem driver (ADR-0029). It owns one
|
||
community and one seeded stream, holds no inventory and emits only the intents
|
||
the earlier increments already accept, so no simulation contract changed. Two
|
||
limits shaped it: retained identities and capped slots mean one community is not
|
||
a population, and with no maintenance cost an uneaten consumer never dies. The
|
||
harness therefore measures many bounded episodes, with mortality from predation
|
||
and a configured lifespan delivered as a host terminal fact. The driver probes a
|
||
discarded copy each tick so it never submits a batch the community rejects; a
|
||
rejected tick is reported as a driver defect rather than absorbed as ecology.
|
||
`evo-sim --ecosystem` reports seeded episode ensembles: 3,000 episodes advanced
|
||
1,093,007 ticks, all reaching extinction, with deaths reconciling exactly against
|
||
founders plus births and conserved totals identical at every tick. That
|
||
demonstrates arithmetic and turnover, not ecological plausibility; strategy
|
||
constants are chosen inputs and must not become gameplay by having been measured.
|
||
Native Release, analysis, ASan and formatting passed; Linux CI has not run yet.
|
||
|
||
M3.1 opens M3 with the immutable genome record (ADR-0030) in a new `evo::biology`
|
||
library that nothing else links yet. A genome is validated once at construction
|
||
and exposes no mutator, so an invalid one cannot exist at runtime; `decode`
|
||
applies identical checks, so a decoded record is never less validated than a
|
||
constructed one. Schema 1 fixes the seven v0.1 capability kinds with units,
|
||
inclusive ranges, required flags and mandated developmental edges as schema facts
|
||
rather than record data. Identity is a nonzero world-scoped genome ID distinct
|
||
from every runtime identity, a nonzero origin event and zero or one parent, with
|
||
room reserved for recombination. The encoding is canonical, bounded and exact:
|
||
strict ascending order, a stored digest that is recomputed on decode, and a
|
||
trailing checksum, with the byte layout in schemas/genome-v1.md. No genome
|
||
affects any simulation; the M2 fixtures still duplicate founder strategies.
|
||
Development, phenotype, mutation and heredity remain M3.2 to M3.5. Native
|
||
Release, analysis, ASan and formatting passed; Linux CI has not run yet.
|
||
|
||
M3.2 derives a phenotype from that record (ADR-0031). `derive_phenotype` and
|
||
`plan_development` are pure integer functions of genome, growth and environment,
|
||
so a phenotype is recomputed from retained inputs rather than cached. Growth and
|
||
damage are runtime state that never reach the genome: damage changes the
|
||
phenotype and leaves the content digest identical, which is the risk this
|
||
increment was scoped against. The genome's development version selects a rule
|
||
set and an unknown version fails closed. Version 1 declares every constant:
|
||
the body is a cube of uniform declared density, membrane mass follows surface and
|
||
thickness, maintenance follows mass plus a membrane upkeep term, and uptake scales
|
||
with surface, so size trades uptake against maintenance. A capability the genome
|
||
does not carry yields zero. A plan advances growth by at most the rule step,
|
||
reduced to the largest step the available material funds exactly, and reserves
|
||
nothing: no inventory moves until M3.3. Omitted physics is a documented model
|
||
limitation, not a modifier, and the constants must not become tuning by having
|
||
been written down. Native Release, analysis, ASan and formatting passed 18/18;
|
||
Linux CI has not run yet.
|
||
|
||
M3.3 gives capability a cost (ADR-0032). `metabolic_budget` returns body
|
||
composition, maintenance, movement, construction, the per-tick intake limit and
|
||
the reproduction investment, in accounting types; `metabolism` is the single
|
||
translation layer and the genome record stays free of those types. Each budget
|
||
comes from a different phenotype quantity, so one parameter moves some and not
|
||
others: a thicker membrane costs more matter to build, more energy to hold and
|
||
more to haul, while leaving uptake, speed and assimilation identical. That
|
||
non-uniformity is asserted directly, because a capability that became a flat
|
||
multiplier is the failure this increment was scoped against. Composition is
|
||
declared per compartment, and splits give the remainder to the last channel so
|
||
parts sum back to the whole and a derived body can be spent without a rounding
|
||
leak. `processes::consumer_for` is the first path from a genome into the M2
|
||
fixtures, with opening inventory left to the caller so no matter is invented; a
|
||
derived consumer is shown driving a real feeding tick with the ledger conserving.
|
||
No existing fixture reads genomes yet and no organism spends any budget. Native
|
||
Release, analysis, ASan and formatting passed 19/19; Linux CI has not run yet.
|
||
|
||
M3.4 proposes successors (ADR-0033). A static catalog of four effects over the
|
||
seven capabilities is filtered by the M3.1 validation itself, so eligibility is
|
||
not a second rulebook: shedding a capability another declares as a prerequisite
|
||
fails without a rule written for it. Candidates are drawn without replacement by
|
||
rejection sampling on an explicit stream, so every eligible operator is exactly as
|
||
likely as any other, and the result is returned in canonical order with no score
|
||
anywhere in the record. The draw reads only the parent digest and a recorded
|
||
context, so the same context always returns the same candidates and a retry cannot
|
||
reroll, while a new event index earns a new draw. Selection regenerates the offer
|
||
and refuses a changed context outright rather than answering it with a different
|
||
mutation. A candidate reports what ADR-0032 would charge its successor and
|
||
reserves nothing. The uniformity test was confirmed to fail against a draw that
|
||
took the first eligible operators. Candidate count, mutation cost as a game rule,
|
||
inherited versus acquired expression, NPC mutation and recombination stay open;
|
||
no organism mutates. Native Release, analysis, ASan and formatting passed 20/20;
|
||
Linux CI has not run yet.
|
||
|
||
M3.5 keeps what M3.4 produces (ADR-0034). `LineageArchive` has no removal
|
||
operation at all, so retention is a property of the interface rather than a rule
|
||
someone has to remember, which is the only form of "keep extinct genomes
|
||
indefinitely" a later change cannot quietly undo. Admission requires the parent to
|
||
be present, so ancestry never dangles and the parent graph is acyclic by
|
||
construction; a duplicate identity is refused rather than overwritten. Organism
|
||
and genome identity stay separate: a death is terminal for the organism and
|
||
touches nothing about the genome, and ancestry, descendants and divergence all
|
||
resolve after every carrier has died. A lineage with no living carrier is reported
|
||
absent, never extinct, because terminal extinction needs a reconciled watermark
|
||
covering suspended members, eggs and in-flight transfers that this type cannot
|
||
see; absence is also reversible. Capacity is bounded and admission fails loudly,
|
||
since refusing to record is not deleting. NPC mutation stays undecided: the
|
||
archive records an origin event and never an actor. Nothing is serialized, so
|
||
durable retention and migration remain M7 and M8. Native Release, analysis, ASan
|
||
and formatting passed 21/21; Linux CI has not run yet.
|
||
|
||
M3.6 closes M3 by making the M3 pieces meet (ADR-0035). `strategy_for` derives a
|
||
`StrategyConfig` from ADR-0032's budget, so a strategy is what the genome already
|
||
implies rather than a second description of the same organism, and a parent
|
||
reproduces once it holds what it would invest. Founders are variants of one
|
||
ancestor diverged by ADR-0033's draw before any episode starts and admitted to
|
||
ADR-0034's archive with their parent links; every birth and death is recorded as
|
||
it happens, so the diversity a run reports has a provenance. Nothing mutates
|
||
during an episode, because autonomous divergence would settle NPC mutation, which
|
||
stays open. `evo-sim --ensemble` runs the grid and reports each cell's seeds in
|
||
two halves that are never merged. ADR-0029's driver is untouched and the M2.6
|
||
fingerprint still holds.
|
||
|
||
Two findings are recorded rather than smoothed over. Resource level never reaches
|
||
strategy derivation: founders are derived fully grown, so their construction
|
||
transition is empty and ADR-0031's per-channel `available` cannot move intake,
|
||
assimilation or investment; the resource level acts only as the nutrient pool
|
||
bounding producer growth. And the resource axis is not monotonic, so no test
|
||
asserts a direction. A sweep peaks near 8000 femtograms and falls away on both
|
||
sides, because ADR-0026 lets only one consumer bite a target per tick: the
|
||
community's income is capped at one producer bite regardless of the pool, scarcity
|
||
drives predation that concentrates mass into individuals that reach the threshold,
|
||
and abundance spreads the same income too thin to fund a birth. Separately, the
|
||
fixture's reproduction investment is pinned to the genome schema's floor because
|
||
intake scales with surface while investment scales with mass; at any larger
|
||
fraction nothing can earn a birth within a lifespan and both axes measure nothing.
|
||
That is a finding about the ADR-0031/0032 cost model, not a fixture detail.
|
||
|
||
Review of `89ad95b` found three defects, all now fixed with regressions confirmed
|
||
to fail without their fix. The harness recorded a death for every organism still
|
||
alive when an episode stopped, so a one-tick run reported no extinctions while
|
||
writing terminal records for founders that had not died; ending observation is not
|
||
death, survivors now stay living in the archive and their watched time is summed
|
||
apart from completed lifetimes. A draw that produced a genome without the
|
||
reproduction capability derived a zero investment, which ADR-0029's driver refused
|
||
outright, so seeds 10, 12 and 15 failed the whole run; the driver now runs such a
|
||
strategy and proposes no birth for it, because filtering those variants out would
|
||
have made the measured set the fertile subset chosen by a guard. And a half's
|
||
thermal shortfall was assigned rather than accumulated, so a field documented as a
|
||
total reported one episode's reading. The M2.6 fingerprint `2cd4a15f9fbe9949` is
|
||
unchanged, since only configurations the driver previously rejected behave
|
||
differently; the ensemble CLI pin was repinned because the reported facts changed.
|
||
Native Release, analysis, ASan and formatting passed 33/33; Linux CI has not run
|
||
yet.
|
||
|
||
Before biology, resolve the relevant heredity and energetic contracts rather
|
||
than treating proof particles as organisms. Exact game tick rate, NPC mutation,
|
||
logout treatment, species/extinction rules and multicellular transition remain
|
||
open decisions. Renderer/networking remain later milestones. Deployment
|
||
availability does not complete M7/M8: fenced ownership, durable outcomes, backup
|
||
restore and world-version migration require their own implementation/fault tests.
|
||
|
||
M4.1 opens M4 (ADR-0036) by defining the tier 2 record and who may act on it, and
|
||
nothing else: there is no collapse transaction, no population advance, no
|
||
materialization and no habitat geometry. A `Cohort` is validated on construction
|
||
and never mutated afterwards. Age classes each carry their own count and their own
|
||
reserve, so the record holds a distribution rather than the mean the milestone's
|
||
named risk warns about; within a class members are indistinguishable, which is the
|
||
record's declared resolution and a stated loss rather than a hidden one. No
|
||
accessor returns a mean. Totals are summed from the classes instead of stored
|
||
beside them, following the lineage archive's rule that a second tally is a thing
|
||
that can disagree. Lineage is deliberately not a field: ancestry is resolved from
|
||
the genome through the archive, so a cohort cannot contradict it or invent
|
||
parentage from membership. Residuals are integer numerators over a declared scale,
|
||
strictly below one member, and are never added to a count.
|
||
|
||
Ownership is enforced rather than described. `CohortRegistry` admits at most one
|
||
record per habitat and genome, so ECOLOGY_MODEL's "no inventory is spendable in
|
||
two tiers" is unrepresentable rather than forbidden, and replacement is refused
|
||
under a different worker, an older epoch, or a changed habitat or genome. Epochs
|
||
make a stale writer fail locally and say nothing about fencing between workers,
|
||
which stays M7 and M10. The approximation bound is carried and never computed:
|
||
M4.5 measures resolution equivalence, and carrying a bound is not meeting one.
|
||
Nothing is serialized, so `schemas/population-v1.md` pins field meaning and
|
||
invariants rather than a byte layout. All nine construction and registry guards
|
||
were confirmed load-bearing by removing each one and observing the suite fail.
|
||
Native Release, analysis, ASan and formatting passed 34/34; Linux CI has not run
|
||
yet.
|
||
|
||
Review of `1c8b292` found two defects, both fixed with regressions confirmed to
|
||
fail without their fix. Replacement checked the ownership epoch but nothing that
|
||
ordered two writes inside one: a record installed at tick 1,000 holding 50
|
||
picojoules could be replaced by its own earlier tick-900 record holding 100,
|
||
restoring inventory the installed one had already spent. Cohorts now carry a
|
||
revision that strictly increases within an epoch, and the interval boundary is
|
||
checked independently, so neither advancing a revision nor re-acquiring ownership
|
||
rewinds simulated time. Separately, the implicit move emptied a cohort's age
|
||
classes while keeping its identities, and the registry then accepted through a
|
||
move exactly what `create` rejects by name; the type is now copy-only, as ADR-0030
|
||
already made the genome for the same reason. That precedent existed and should
|
||
have been applied when the type was written.
|
||
|
||
M4.2 moves individuals into that record (ADR-0037), and does only that: there is
|
||
no population advance, no materialization back into individuals, no transfer
|
||
between habitats and no persistence. Collapse is two phases over one sample.
|
||
`plan_collapse` reads the members once and returns an immutable plan that already
|
||
carries a validated cohort; `commit_collapse` applies exactly that plan and
|
||
derives nothing, so ECOLOGY_MODEL's rule that recovery replays a committed sample
|
||
rather than sampling again is a property of the types.
|
||
|
||
A controlled, suspended, dead or unsettled member refuses the whole plan rather
|
||
than being skipped. That is the answer to adversarial selection: filtering would
|
||
let a caller obtain a plan by omitting whoever was inconvenient, and the result
|
||
would be indistinguishable from an honest conversion. Ages are carried into
|
||
declared classes and a member fitting none refuses the plan, so a conversion
|
||
cannot quietly move anyone to a different class or discard one for having nowhere
|
||
to go. Reserves are summed per class, never redistributed.
|
||
|
||
Conservation runs through the ledger rather than beside it: one atomic transaction
|
||
of one leg per member, each moving that member's entire reserve, so the conserved
|
||
total is unchanged by construction. Dual representation is closed from both ends.
|
||
A member must be emptied exactly, and a reservoir holding anything other than what
|
||
was sampled makes the plan stale rather than partly applicable. The destination is
|
||
proved available before anything moves, so no rejection can strand inventory in a
|
||
reservoir nothing owns, and every refusal leaves the ledger and the registry as
|
||
they were. Committing one plan twice is refused without moving inventory again.
|
||
|
||
Two limits are stated rather than implied to be covered. The function cannot tell
|
||
whether the members it was given are all the members there were, so completeness
|
||
is a caller obligation. And emptying a reservoir is not withdrawing the right to
|
||
use it: the ledger has no removal, so nothing prevents a later transfer crediting
|
||
that reservoir again. Durable conversion sequences, escrow and replay across a
|
||
process boundary are M7 and M8. All ten construction and commit guards were
|
||
confirmed load-bearing by removing each and observing a failing run. Native
|
||
Release, analysis, ASan and formatting passed 35/35; Linux CI has not run yet.
|
||
|
||
Review of `1a59b63` found one defect, now fixed with a regression confirmed to
|
||
fail without it. Commit checked that the destination reservoir existed and that
|
||
the registry slot was free, but not that the reservoir was empty, so a conversion
|
||
into an occupied reservoir succeeded and mixed inventory it never sampled into the
|
||
cohort's backing store. The reported case reproduces exactly: the ledger holds 67
|
||
picojoules against a cohort recording 60, so the cohort's reserve understated what
|
||
backed it and the surplus belonged to nobody. A destination holding anything is
|
||
now refused, a cohort's reserve is the whole of its reservoir rather than a part
|
||
of it, and the success test asserts that equality directly.
|
||
|
||
M4.3 advances a cohort over one declared interval (ADR-0038) and deliberately does
|
||
not model one. ECOLOGY_MODEL keeps population maths an experiment and asks for
|
||
several candidates to be compared, so choosing one here would turn a
|
||
recommendation into a locked rule. A model proposes fluxes; this checks that the
|
||
declared result is exactly what they imply, for counts and for every inventory
|
||
channel.
|
||
|
||
Nothing is clamped. A loss larger than what is there refuses the interval and
|
||
names whether it was the population or the biomass, so a caller can subdivide and
|
||
retry, and subtraction is checked against what is present rather than performed
|
||
and repaired. That is the answer to the milestone's named risk: a clamp is how an
|
||
interval a model could not integrate becomes a plausible looking result, and how a
|
||
false extinction arrives. Counts carry whole members and owed fractions together,
|
||
so a population below one member is a number rather than a rounding decision.
|
||
Biomass has no birth term at all, so a birth cannot bring inventory in and
|
||
newborns are necessarily funded from what the cohort already holds; immigration
|
||
draws from a reservoir that already held it, so a late transfer is not new
|
||
production either. Conservation runs through the ledger as one atomic transaction,
|
||
and an interval in which nothing moves submits none.
|
||
|
||
Two amendments to M4.1's record were forced rather than chosen. A cohort now
|
||
records the reservoir backing it, because an advance cannot otherwise know where
|
||
the inventory is and passing it alongside would let a caller advance one cohort
|
||
against another's store, which comparing balances cannot detect between equal
|
||
reserves; the registry refuses two cohorts sharing a reservoir. And a cohort may
|
||
be vacant, through a separate factory so vacancy stays deliberate, because a
|
||
population declining to exactly zero would otherwise be unrepresentable and the
|
||
caller would have to clamp. A vacant cohort is not an extinction: the record, its
|
||
genome, its habitat and its provenance all remain and it stays installed.
|
||
|
||
Limits are stated rather than implied covered. Accounting is not fidelity: closure
|
||
is checked, stability is not, so a long interval whose arithmetic closes and whose
|
||
ecology is nonsense is accepted. The declared age structure is not verified to be
|
||
what ageing would produce, because that needs the within-class distribution the
|
||
record deliberately discards. Emigration escrows into a reservoir nothing settles
|
||
with, since `TransferPopulation` does not exist. All fourteen guards, including
|
||
both clamp mutations, were confirmed load-bearing by removing each and observing a
|
||
failing run. Native Release, analysis, ASan and formatting passed 36/36; Linux CI
|
||
has not run yet.
|
||
|
||
M4.4 turns whole members of a cohort back into identified individuals (ADR-0039),
|
||
and does nothing else: no transfer between habitats, no persistence and no
|
||
resolution-equivalence claim, which is M4.5. Materialization is instantaneous, at
|
||
the cohort's current tick, because advancing time is M4.3's interval.
|
||
|
||
The named risk is that re-materialization becomes free healing, and it has two
|
||
separable sources. The arithmetic one is closed outright: a drawn member receives
|
||
its class share by integer division rounded down, because rounding up would create
|
||
biomass, and a class drawn empty hands over everything it held because a class with
|
||
no members may keep no reserve. A residual is never drawable, so an expected
|
||
fractional density cannot become an individual. Age is taken as the oldest the
|
||
class admits rather than the youngest or a seeded choice within it: the exact age
|
||
is unrecoverable, so the question is which direction to be wrong in, and every
|
||
other answer lets an adversary who picks when to convert roll back towards youth.
|
||
A round trip can therefore only age someone, and oscillation is strictly lossy.
|
||
|
||
The second source is the declared resolution itself and is stated rather than
|
||
mitigated. Members inside one class are indistinguishable by construction, so
|
||
collapsing a starving member with a well-provisioned one and materializing both
|
||
returns two average members; the starving one has been healed at the other's
|
||
expense. The tests demonstrate both halves of this rather than only the flattering
|
||
one: a round trip is exact when each class holds one member, and a coarse class
|
||
conserves the total while averaging the individuals. The mitigation is the
|
||
caller's choice of classes when it collapses, not anything this code can recover.
|
||
|
||
Materialization produces exactly the record a collapse consumes, so the two
|
||
compose and are tested against each other instead of being described as inverses.
|
||
Eleven guards were confirmed load-bearing by removing each and observing a failing
|
||
run, including the two that are the risk itself: rounding shares up, and drawing
|
||
ages from the bottom of a class. Native Release, analysis, ASan and formatting
|
||
passed 37/37; Linux CI has not run yet.
|
||
|
||
Review of `380d609` found two defects, both fixed with regressions confirmed to
|
||
fail without them. Materialization treated an empty reservoir as an available one,
|
||
so it credited a store that another installed cohort owned while leaving that
|
||
cohort's record unchanged: the same inventory in two places, reached from the
|
||
opposite direction to the M4.2 defect. Destinations are now checked against the
|
||
registry's ownership as well as their balance, on both the collapse and the
|
||
materialize side. The collapse side had the worse form of it: the shared-reservoir
|
||
rule would have refused the install only after the transfer had run, stranding the
|
||
members' biomass in a reservoir nothing accounted for, so whichever registry step
|
||
will follow a transfer is now proved to succeed before it.
|
||
|
||
The second was a functional gap the oscillation test had been hiding by discarding
|
||
its registry each cycle. A full draw leaves a vacant record, which ADR-0036 retains
|
||
because absence is not extinction, and collapse then refused that habitat and
|
||
genome as occupied, making a full materialization a one-way door out of a habitat.
|
||
Collapse now repopulates a vacant record in place, continuing its ownership and
|
||
revision series rather than restarting them, and refuses a record that still holds
|
||
a population. The test keeps one registry throughout and asserts the revision
|
||
continues.
|
||
|
||
M4.5 closes M4 by measuring what aggregation costs (ADR-0040). It adds no library
|
||
code: one rule is written once and applied at both resolutions, and a
|
||
one-member-per-class control proves the two runs are the same rule before any
|
||
divergence is attributed to resolution. Without that control a measured gap could
|
||
equally be a transcription mistake, and nothing afterwards would separate them; a
|
||
deliberate one-unit drift in the aggregate rule is caught by it.
|
||
|
||
The result is reported rather than smoothed into a tolerance. At class widths of ten
|
||
and fifty the aggregate population survives ten thousand ticks and tracks the
|
||
individual run within 375 parts per thousand on population and 43 on energy. At
|
||
widths of twenty-five, one hundred and two hundred it dies out entirely while the
|
||
individual run sustains seventy-five members: a false extinction caused by
|
||
resolution alone, because a whole class starves the moment its average cannot pay
|
||
upkeep where individuals would have starved a few at a time and the survivors would
|
||
have kept the shared per-capita share up.
|
||
|
||
The collapse is not monotone in class width. Twenty-five destroys the population
|
||
while fifty sustains it, so a resolution cannot be chosen by assuming degradation
|
||
worsens smoothly as classes widen, and a width that works is no evidence that every
|
||
narrower width works. The tests assert that non-monotonicity, because it is
|
||
surprising and because the warning written around it would otherwise be able to
|
||
become wrong silently. They also assert the runs disagree, so equivalence can never
|
||
be read as identity, and the word is not used for what was measured.
|
||
|
||
Conservation was exact at every tick on both sides of every run, including the three
|
||
whose populations died out. Four of five runs conserve perfectly and three are
|
||
ecologically worthless, which is exactly ECOLOGY_MODEL's point that conservation is
|
||
insufficient evidence.
|
||
|
||
The comparison also found a real defect in M4.3, which is what a validation
|
||
milestone is for. `plan_advance` checked affordability with arrivals added before
|
||
losses were taken, but emitted the ledger legs with the outflows first, so an
|
||
interval that was affordable as a whole underflowed leg by leg and was refused at
|
||
commit. A fifty-tick interval shedding 10,480 against 6,950 held while drawing
|
||
13,080 in reproduced it. Arrivals are now the first leg, matching the order the
|
||
arithmetic was checked in, with a regression covering it. Native Release, analysis,
|
||
ASan and formatting passed 38/38; Linux CI has not run yet.
|
||
|
||
|
||
## M4.6 - aggregate budget review (2026-09-26)
|
||
Completed test-only shared model, CPU/retained-memory benchmark, and 15-scenario
|
||
scarcity sensitivity report. The partial `tests/fixtures/resolution_model.hpp`
|
||
was integrated with existing M4.5 controls, including contested parent allocation.
|
||
No production library, simulation format, deployment or gameplay rule changed.
|
||
See [the report](engineering/AGGREGATE_BUDGET.md) and ADR-0041. None of the five
|
||
widths passes the proposed fidelity gate across supplies 240/300/360; automatic tier
|
||
selection remains disabled. The next implementation milestone is M5's sparse voxel
|
||
prototype; aggregate-model improvement and Linux/target-host measurement remain
|
||
prerequisites for a production tier policy. See VALIDATION.md for checks actually run.
|
||
|
||
|
||
## M5-M9 planning expansion - 2026-09-26
|
||
|
||
[ROADMAP.md](ROADMAP.md) now breaks M5-M9 into 42 reviewable tasks, each with
|
||
module boundaries, dependencies, completion criteria, tests and risks. These are
|
||
planned gates, not implementation or deployment claims. M8 dev/stage recovery is
|
||
separate from World0 launch; M9 client integration can use dev/stage without
|
||
premature World0 promotion. M4.6's failed fidelity gate remains explicit.
|
||
That expansion identified 5.1 as the next task; it is now implemented as recorded below. No library, service, cluster or dependency changed in this update.
|
||
|
||
|
||
## M5.1 - bounded local voxel contract (2026-09-26)
|
||
|
||
Implemented dependency-free `evo::world` coordinate and cell-sample utilities,
|
||
[ADR-0042](adr/0042-local-voxel-contract.md), and
|
||
[LOCAL_VOXEL_CONTRACT.md](world/LOCAL_VOXEL_CONTRACT.md). Signed floor mapping handles
|
||
negative chunk seams; all public operations reject invalid bounds before arithmetic.
|
||
The experiment uses a 1m cell pitch and explicit edge candidates 8/16/32/64; it
|
||
selects no storage layout, renderer, spherical topology or production world extent.
|
||
Logical fill describes volume fraction, not surface shape or consumable inventory.
|
||
|
||
Tests independently enumerate chunk intervals, exhaust 299,520 local ordinals, check
|
||
metric/domain corners and hostile signed/unsigned extrema, and validate fill/material
|
||
consistency. Existing simulation goldens/formats are unchanged. No world data or
|
||
service is deployed. Next: M5.2's measured layout/edge comparison; actual chunk
|
||
allocation and generator work follow its decision. See VALIDATION.md for checks.
|
||
|
||
## M5.2 compact layout evidence
|
||
|
||
Compared three representations, four edges and five fixtures with seeded edit/oracle
|
||
checks. [Evaluation](engineering/CHUNK_LAYOUT_EVALUATION.md) records memory, costs,
|
||
encoding estimates and limits. ADR-0043 selects 16-cube uniform/palette/dense geometry.
|
||
No production container, generator, codec or deployment was added. Next: M5.3.
|
||
|
||
## M5.3 deterministic abiotic base
|
||
|
||
Added pure seed/address/version generation, a bounded inert material table and
|
||
16-cube logical output. [Contract](world/BASE_GENERATION.md) specifies rejection,
|
||
compatibility and storage boundaries. Twelve independent reference goldens and
|
||
signed seam/query-order tests freeze v1. No gameplay, persistence or deployment
|
||
was added. Next: M5.4 sparse active chunk ownership.
|
||
|
||
## M5.4 bounded active chunk ownership
|
||
|
||
Added fixed-slot, budgeted ChunkStore and immutable uniform/palette/dense CompactCells.
|
||
Revision tokens reject stale and foreign reads. Clean chunks regenerate; dirty pins
|
||
refuse eviction. [Ownership contract](world/CHUNK_OWNERSHIP.md) documents memory/lifetime
|
||
limits and the absence of cell edits or durability. Next: M5.5 accounted terrain edits.
|
||
|
||
## M5.5 transactional terrain excavation
|
||
|
||
Added up to 64 cuts across four loaded chunks, atomically transferring occupied
|
||
volume into finite per-material debris. Revision/digest/full-payload retry checks,
|
||
64-command retention and peak allocation backpressure are explicit. The
|
||
[edit contract](world/TERRAIN_EDITS.md) records excavation-only scope and persistence
|
||
obligations. No mass conversion or durable acknowledgement is claimed. Next: M5.6.
|
||
|
||
## M5.6 snapshots and edit journals
|
||
|
||
Added bounded canonical world snapshot v1 and edit journal v1, world/frame and base
|
||
version checks, full geometry/debris/retry restore, semantic validation and detached
|
||
all-or-nothing replay. [Codec contract](world/WORLD_CODEC.md) and schemas define
|
||
memory/trust limits. The M5.6 codec alone does not publish files or issue durable
|
||
acknowledgements. M5.7 local publication and recovery are implemented above.
|
||
|
||
## M5.7 local publication and recovery
|
||
|
||
ADR-0048 adds a single-writer local-filesystem adapter over the M5.6 codec. It uses
|
||
immutable checksum-named snapshot/journal blobs and two alternating canonical
|
||
manifest slots; replacing the inactive manifest is the publication point. Checkpoints
|
||
compact a committed journal only after a caller supplies the exact recovered
|
||
state. Recovery validates the selected snapshot and complete journal replay into a
|
||
detached ChunkStore. Tests cover lock exclusion, journal/restart, compaction, failpoints
|
||
before and after publication, malformed manifests and missing published payloads.
|
||
FNV remains a corruption detector, and this local adapter makes no host-loss,
|
||
multi-region or production durability claim. Filesystem orphan cleanup is deferred.
|
||
|
||
## M5.8 bounded world restart proof
|
||
|
||
Added evo-world-proof and a CTest workflow that launches fresh prepare, compact and
|
||
verify processes for uniform, sparse and heavily modified deep chunks. Independent
|
||
cell/debris oracles, exact canonical equality, frozen hashes, retained retries and
|
||
clean regeneration checks pass. [Measured costs and reproduction](engineering/WORLD_PROOF.md)
|
||
record five Windows Release runs and explicit accounting/durability limits.
|
||
No world format or simulation version changed. Next: M6.1 environmental units and
|
||
coupling contract; Linux golden execution remains a CI confirmation.
|
||
|
||
## M6.1 environmental units and habitat coupling (2026-09-27)
|
||
|
||
ADR-0050 and [the units contract](world/ENVIRONMENTAL_UNITS.md) define bounded
|
||
inventories, compartment identity, derived concentration/moisture, explicit habitat
|
||
depth and residual ownership. Pure checked helpers measure one-voxel habitat boxes,
|
||
form rational views and integrate energy-rate proposals without creating supply.
|
||
Dimensional examples, invalid conversions, overflow, split intervals, closed/open
|
||
accounting and refusal rollback are tested. Windows Release, clang-tidy and ASan
|
||
suites pass; see VALIDATION.md for exact checks. Existing formats/goldens are unchanged.
|
||
No fields or biological coupling are implemented yet. Next: M6.2 optional finite
|
||
environmental fields with versioned persistence and explicit opening inventories.
|
||
|
||
## M6.2 optional finite environmental fields (2026-09-27)
|
||
|
||
Added a bounded FieldStore with fixed habitat mappings, material water-capacity
|
||
defaults, optional scalar channels and uniform baselines with sparse 64-site pages.
|
||
Opening inventories are explicit; missing differs from zero. Same-channel local
|
||
transfers preserve finite supply and reject stale commands/overspend without change.
|
||
Field snapshot v1 preserves mapping, quantities, defaults, presence and watermark;
|
||
restore does not regenerate supplies. [Contract and memory evidence](world/ENVIRONMENTAL_FIELDS.md)
|
||
and the byte schema document trust, budget and compatibility limits. M5 terrain
|
||
formats remain unchanged; combined terrain/biology durability and rate sources are
|
||
not implemented. Next: M6.3 read-only derived environment views.
|
||
|
||
## M6.3 read-only environment views (2026-09-27)
|
||
|
||
Added [bounded footprint queries](world/ENVIRONMENT_VIEWS.md) under ADR-0052.
|
||
Views copy typed quantities, exact concentration/moisture and terrain samples with
|
||
habitat resolution, logical tick, field watermark and sampled chunk revisions.
|
||
Missing fields are distinct from zero; absent habitats/chunks fail without loading.
|
||
Freshness validation rejects wrong stores, changed tick/field state and stale chunk
|
||
tokens, including eviction/reload. No persistent format or simulation rule changed.
|
||
Views grant no inventory reservation; coherent tick/store pairing remains a host
|
||
responsibility. Next: M6.4 coordinated environmental transfers.
|
||
|
||
|
||
## M6.4 atomic environmental transfers (2026-09-27)
|
||
|
||
Implemented the [transfer contract](world/ENVIRONMENTAL_TRANSFERS.md) and ADR-0053.
|
||
A single owner stages and publishes fields and tagged organism resource accounts
|
||
atomically, validates view freshness and ownership, rejects capacity/stock/budget
|
||
violations, and retains 64 exact request receipts. Tests cover contention, late-leg
|
||
rollback, changed retries, independent compartment balances and conservation.
|
||
This is in-memory ownership; no coupled recovery format or durable ACK is claimed.
|
||
No schema, simulation version, dependency or deployment changed. Next: M6.5 biology
|
||
adapters, including explicit conversion and active/alive validation.
|
||
|
||
## M6.5 prerequisite review (2026-09-27)
|
||
|
||
Implementation is pending resolution of [ADR-0054](adr/0054-m65-source-persistence-prerequisite.md).
|
||
ADR-0051 requires persisted source rate/residual/interval state before rate execution;
|
||
ADR-0053 defers the coupled format until M6.8. Recommended resolution: bring the
|
||
minimal coupled buffer codec forward, preserving the earlier guarantee. The proposal
|
||
breaks M6.5 into codec, explicit biological conversion contract, rate-driven fixture,
|
||
and qualification segments. No source-rate code or public interface changed in this
|
||
review; M6.5 remains incomplete. M6.4's validated behavior is unchanged.
|
||
|
||
## Accepted M6.5 sequencing and M6.5a codec (2026-09-27)
|
||
|
||
The maintainer accepted ADR-0054: bring coupled snapshot/restore forward. This
|
||
supersedes the pending-decision status above. M6.5a now implements
|
||
[resource snapshot v1](../schemas/coupled-resources.md): terrain, finite fields,
|
||
organism accounts/capacities, adoption watermark and chronological full retry history
|
||
restore as one validated owner. Restore audits retained transfers backwards against
|
||
current balances and validates nested codecs and aggregate ownership/budgets.
|
||
|
||
Next: M6.5b explicit capture/growth/feeding conversion contract, followed by M6.5c's
|
||
complete source-rate/biology envelope and M6.5d qualification. No rates are enabled
|
||
by the resource codec; no source progress is invented during restore. M6.5 as a
|
||
whole remains incomplete. Durable publication and region recovery remain M7.
|
||
|
||
## M6.5b process contract (2026-09-27)
|
||
|
||
Completed the design segment under ADR-0055 and
|
||
[ENVIRONMENTAL_PROCESS.md](biology/ENVIRONMENTAL_PROCESS.md). The contract defines
|
||
finite area-bounded capture, explicit nutrient incorporation, retained water,
|
||
organic feeding with heat/waste, exact source/growth residual policies and the
|
||
process-owned checkpoint/retry boundary. Hand-calculated vectors make each flow
|
||
reviewable. No new runtime code, executable rate integration or schema changed.
|
||
|
||
Next: M6.5c implements the fixture and complete source-rate/biology snapshot before
|
||
exposing advance; M6.5d qualifies it. M6.5 remains incomplete. M2/M3 maintenance,
|
||
reproduction and mortality behavior is unchanged; resource starvation is reported
|
||
without inventing a new death policy.
|
||
|
||
## M6.5c persisted environmental fixture (2026-09-27)
|
||
|
||
Implemented EnvironmentalCommunity: area-bounded finite capture, recipe growth,
|
||
organic feeding/waste/heat, source exhaustion and temperature gates, plus whole-tick
|
||
rollback and exact retained retries. Rates execute only alongside the complete
|
||
[process envelope](../schemas/environmental-community.md), which restores primitive
|
||
config, residuals, lifecycle, resources and history and audits retained inputs by
|
||
replay from a historical anchor. Existing M2/M3 rules and codecs are unchanged.
|
||
|
||
The pasted GCC 14 CI log exposed a vector reserve/append diagnostic in the resource
|
||
snapshot writer. Both coupled writers now fill exactly sized buffers and check their
|
||
final cursor, retaining strict compiler warnings and unchanged resource wire bytes.
|
||
Native validation is recorded separately from Linux CI verification.
|
||
|
||
Next: M6.5d broader qualification (boundary/adversarial cases, long-run seeds and
|
||
cost evidence). M6.5 as a whole is not yet marked complete; no deployment changed.
|
||
|
||
## M6.5d native qualification (2026-09-27)
|
||
|
||
M6.5a-d are implemented and qualified natively. Added boundary/malformed-state
|
||
coverage and a deterministic long-run/cost harness. The extended run compared
|
||
1048576 logical ticks against continuous controls, including 329231 feeding
|
||
requests; balances and restored bytes matched. See the
|
||
[qualification report](engineering/ENVIRONMENTAL_QUALIFICATION.md) for evidence and
|
||
limits. Native Release/analysis/ASan suites passed 54/54; Linux CI remains a separate
|
||
required delivery check, not an observed pass.
|
||
|
||
Next: M6.6 terminal events, retained corpse biomass and bounded decomposition.
|
||
No maintenance, reproduction, player progression, simulation version or deployment
|
||
changed in this qualification segment.
|
||
|
||
M6.6 now retains corpse resources and lifecycle in opt-in rules/envelope v2.
|
||
Partial bounded decay conserves matter and energy, restores with exact retry
|
||
history, and can supply the surviving producer on a later tick. V1 compatibility
|
||
is retained. See ADR-0056 and VALIDATION.md for scope and evidence. This does not
|
||
add mortality causes, decomposer kinetics, durable publication or player sessions.
|
||
|
||
M6.7 now schedules bounded explicit local intervals, checks stale/foreign boundaries
|
||
and reports committed prefixes on failed catch-up. Pause/restore/resume uses the
|
||
existing process envelope; no wall-clock debt is inferred. M6.8 is next. See
|
||
architecture/ENVIRONMENTAL_SCHEDULING.md for caller responsibilities.
|
||
|
||
M6.8 completed the bounded environmental integration qualification. The extended
|
||
ensemble passed 5120 episodes across five regimes, including nutrient-fed regrowth,
|
||
conservation and direct-versus-restored equivalence. See
|
||
engineering/ENVIRONMENTAL_SLICE_QUALIFICATION.md for actual measurements and
|
||
limitations. M6 is natively qualified; Linux CI confirmation remains separate.
|
||
Next is M7.1: define complete region state, durable ACKs and the crash-point matrix.
|
||
|
||
M7.1 durability design is complete. ADR-0058 chooses full checkpoint batches,
|
||
atomic permanent outcomes and exact reconciliation after ambiguous commits.
|
||
REGION_DURABILITY.md inventories included/missing state and the crash-point tests.
|
||
No PostgreSQL connection, persistence adapter or region pod exists yet. M7.2 is
|
||
next; lineage closure remains an explicit M7.4/M7.9 prerequisite, not waived scope.
|
||
|
||
M7.2 complete (2026-09-28): optional Linux libpq adapter and PostgreSQL 18.6
|
||
source pin, transactional checksum-checked bootstrap, bounded parameterized I/O,
|
||
private database integration tests and Secret-mounted migration Job example.
|
||
Release, clang-tidy and ASan/UBSan PostgreSQL checks passed in WSL; Windows
|
||
headless suite passed 54/54. Docker/remote CI and cluster deployment are not
|
||
claimed. See infrastructure/POSTGRESQL.md and engineering/VALIDATION.md.
|
||
Next: M7.3 fenced ownership and narrowly granted database functions. The bootstrap
|
||
lease table alone does not establish authority or durable region publication.
|
||
|
||
## M7.3 fenced region ownership (2026-09-28)
|
||
|
||
ADR-0060 and migration v2 add guarded lease and head functions for a runtime role
|
||
that has no table rights. The portable `LeaseAuthority` fences locally from
|
||
send-time deadlines on CLOCK_BOOTTIME. Selected timings are 20 s lease, 5 s renew,
|
||
2 s margin, 2 s renew deadline and 5 s commit deadline. Local round trips took
|
||
about 0.6-0.7 ms p50 and about 1 ms p99. Real PostgreSQL covered contenders,
|
||
expiry, paused and queued stale writers, unknown renewal, exhaustion and bypass
|
||
denial. Three SQL mutations (`now()` instead of `clock_timestamp()`, a missing
|
||
lease check, a disabled busy check) were each detected by a failing test.
|
||
Windows ran 55/55; Linux Release, clang-tidy and ASan/UBSan PostgreSQL suites
|
||
passed in WSL. No director, host, gateway, payload publication or deployment
|
||
exists yet. The v2 head must not carry real world state before M7.4. Next: M7.4.
|
||
|
||
## M7.4a checkpoint publication (2026-09-28)
|
||
|
||
ADR-0061 and schema v3 publish environmental-v1 checkpoints. A fixed 280-byte
|
||
manifest is parsed and digested by PostgreSQL. Payloads live in an immutable,
|
||
content-addressed filesystem store and are hashed with OpenSSL SHA-256. The
|
||
database enforces the commit chain, retained builds and fixed versions/quantum,
|
||
and refuses to migrate while v2 heads exist.
|
||
|
||
Recovery re-digests the manifest, checks the build allowlist and fully restores the
|
||
payload. A restored state continues identically to the uninterrupted original.
|
||
Missing, corrupt or tampered data quarantines the region. Four SQL mutations and
|
||
one host mutation were each caught by a test.
|
||
|
||
Local fixture payloads are 23-37 KiB and publish in about 3.5-10.6 ms across
|
||
builds. Windows ran 56/56; Linux Release, clang-tidy and ASan/UBSan PostgreSQL
|
||
suites passed in WSL. M7.4 stays open for M7.4b (lineage archive codec and
|
||
history-capable binding). No real world was provisioned; there is no deployment,
|
||
host or process-kill test yet.
|
||
|
||
## M7.4b lineage checkpoint profile; M7.4 complete (2026-09-28)
|
||
|
||
ADR-0062 adds a canonical `LineageArchive` codec that decodes by replaying the
|
||
archive's own admission, birth and death rules. It also adds `LineageRegion`,
|
||
which:
|
||
- binds the two environmental accounts to archived organisms;
|
||
- keeps identity high-waters;
|
||
- enforces closure over lifecycle, the living set and ticks;
|
||
- records deaths in the tick that causes them.
|
||
|
||
Checkpoint profile 2 (`environmental-lineage-v1`) and schema v4 publish and recover
|
||
it. A region can never switch profile. Recovery restores retained genomes,
|
||
ancestry and dead organisms, and continues identically. A full archive encodes to
|
||
2,543,648 of at most 3,219,496 bytes.
|
||
|
||
While qualifying, WSL2 was measured stepping the wall clock back about 0.5 s every
|
||
~32 s. Four database-time tests now wait on the database's own expiry judgement
|
||
instead of assuming a local sleep equals database time; ADR-0060 records the
|
||
deployment requirement. Windows ran 57/57. Linux GCC Debug/Release, clang-tidy
|
||
and ASan/UBSan CTest each ran 57/57. The PostgreSQL suites passed 2/2/5 times.
|
||
|
||
Next: M7.5 durable decisions, history and outbox rows, and commit-ID resolution.
|
||
Retained ancestry still needs M7.5 history and M7.7/M7.9 kill-recovery evidence.
|
||
|
||
## M7.5 durable batch outcomes (2026-09-28)
|
||
|
||
ADR-0063 introduces manifest v2, which binds a per-tick validation trace object
|
||
and a decision block.
|
||
- Staging replays the trace from the committed predecessor's verified payload and
|
||
must reproduce every report and the candidate bytes.
|
||
- `RegionBatch` seals at a death or at 64 ticks and refuses ticks until the commit
|
||
is confirmed.
|
||
- Schema v5 records each checkpoint, its deaths and their outbox rows in one
|
||
statement:
|
||
- one terminal outcome per actor;
|
||
- committed history is immutable;
|
||
- exact retries return the original receipt;
|
||
- read-only resolution answers committed, absent or conflict.
|
||
- Recovery reconciles durable deaths with the restored lifecycle.
|
||
|
||
Real-PostgreSQL tests cover a lost response, a timeout that later committed, a
|
||
terminated orphan that was retried, changed bytes, repeated or partial or
|
||
reordered decisions, gaps, outbox redelivery, and history disagreement. Five
|
||
mutations were each caught. Windows and Linux ran 58/58; PostgreSQL suites passed
|
||
under Release, analysis and ASan.
|
||
|
||
Next: M7.6 region host. No host, broker, deployment or process-kill test exists yet.
|
||
|
||
## M7.6 region host and server process (2026-09-28)
|
||
|
||
ADR-0064 adds `RegionHost`, a single-owner, single-threaded state machine:
|
||
acquire and recover, run, resolve, drain and stop, or quarantine.
|
||
- Admission is provisional and bounded (64 inputs, 64 KiB) with backpressure.
|
||
- Acknowledgements and outcomes are final only after a confirmed commit.
|
||
- A death pauses the region and commits in the same step.
|
||
- Tick debt is measured, and catch-up is bounded to 8 ticks per step.
|
||
- Readiness fails closed.
|
||
|
||
`evo-server` hosts one region using a stdin input feed and stdout event lines,
|
||
with a readiness file and SIGTERM drain. Real process tests:
|
||
- SIGTERM: 80 inputs through the 64-input backlog were drained, committed and
|
||
released.
|
||
- SIGKILL: every acknowledged tick was committed, and the successor became ready
|
||
about 3.9 s later, after the 4 s development lease expired, from the committed
|
||
head.
|
||
|
||
Seven host scenarios pass against real PostgreSQL, and four mutations were each
|
||
caught. Windows ran 58/58; the PostgreSQL suites passed under Release, analysis
|
||
and ASan/UBSan.
|
||
|
||
Next: M7.7 recovery verification at every kill boundary. There is no gateway,
|
||
metrics or deployment yet.
|
||
|
||
## M7.7 recovery before readiness (2026-09-28)
|
||
|
||
ADR-0065: before readiness, recovery now replays the head's validation trace
|
||
from the predecessor's verified payload. It must reproduce the head bytes
|
||
exactly and derive exactly the durable decisions. A missing, corrupt or
|
||
non-reproducing tail, or a missing predecessor payload, quarantines the region,
|
||
and nothing older or empty is ever served. Schema v6 adds the read-only
|
||
`load_region_commit`.
|
||
|
||
Real `evo-server` processes were SIGKILLed at five publication and ACK
|
||
boundaries using a test-only `--crash-at` injector. Every result matched the
|
||
crash matrix, and each successor verified the head before becoming ready. A
|
||
SIGSTOPped owner resumed fenced, and damaged heads exited quarantined.
|
||
|
||
Tail-skip and replay-equality mutations were each caught. The PostgreSQL suites
|
||
passed under Release, analysis and ASan/UBSan.
|
||
|
||
Next: M7.8 operations endpoints and a dev image.
|
||
|
||
## M7.8 operations endpoints and server image (2026-09-28)
|
||
|
||
ADR-0066: `evo-server --ops-listen` serves three endpoints:
|
||
- `/livez`: the loop is responding; it is never a statement of authority.
|
||
- `/readyz`: 200 only with the current lease and a verified recovered head.
|
||
- `/metrics`: 30 fixed series whose only labels are a 6-value phase and a 4-value
|
||
drop reason.
|
||
|
||
The responder is dependency-free, runs on the host's own loop with no thread, and
|
||
is bounded: 8 connections, 4 KiB requests, 1 s deadlines, GET on exact paths
|
||
only. The new `server-runtime` Docker target is non-root with no credentials,
|
||
covered by a CI smoke script, and a Kubernetes example ships outside Argo.
|
||
|
||
Real process probes covered serving authority, an unavailable database (live,
|
||
503) and a resumed stale process (live, 503, fence counted). Readiness-as-liveness
|
||
and an unbounded connection pool were each caught by a test. Windows ran 59/59;
|
||
Linux ran 59/59 in four configurations; the PostgreSQL suites passed in three.
|
||
|
||
Docker itself was not run locally; an emulated image layout was checked instead.
|
||
Next: M7.9.
|
||
|
||
## M7.9a region clones and retained history (2026-09-29)
|
||
|
||
ADR-0067 adds a consistent clone into an isolated world:
|
||
- **Re-identification:** `rebind_world` changes only the recorded world, and the
|
||
byte round trip is proven.
|
||
- **Schema v7 clone genesis:** it starts at the source tick, names the source
|
||
commit and digest, and digests the inherited outcomes.
|
||
- **`evo-world-clone clone`:** it reads the source read-only, requires a separate
|
||
database and user, and writes the target in one owner transaction.
|
||
|
||
`audit_region_history` (also `evo-world-clone audit`) re-verifies every retained
|
||
link.
|
||
|
||
Real processes showed:
|
||
- after re-identification, the clone and its source followed a byte-identical
|
||
trajectory;
|
||
- the clone cannot write its source;
|
||
- a killed clone left the source untouched and the target not ready;
|
||
- a missing historical trace is detected even when head recovery succeeds.
|
||
|
||
Five mutations were caught. Windows ran 59/59; Linux ran 59/59 in four
|
||
configurations; the PostgreSQL suites passed in three.
|
||
|
||
Next: M7.9b, covering the upgrade barrier and old-writer fencing, schema
|
||
migration failure while a host is serving, and measured recovery and batching
|
||
latency.
|
||
|
||
## M7.9b upgrade barrier and durability qualification (2026-09-29)
|
||
|
||
ADR-0068 and schema v8 bind authority to builds:
|
||
- Acquisition names the host's build, and only a retained build that has not been
|
||
retired may hold a lease.
|
||
- No commit may name a retired build.
|
||
- `upgrade_barrier` retires a build and fences every holder in one transaction.
|
||
- Hosts built before M7.9b keep working until the first barrier.
|
||
|
||
A lease-holding writer survived a failed v8 migration (the database stayed at v7
|
||
exactly) and then the real migration. After the barrier it could never regain
|
||
authority. The new build recovered the whole history, including links written by
|
||
the retired build.
|
||
|
||
Qualification (engineering/DURABILITY_QUALIFICATION.md), under the production
|
||
lease:
|
||
- SIGKILL to successor readiness: 19.5–19.6 s against the proposed 60 s target;
|
||
- acknowledgement latency with a 1 s flush: p50 549 ms, p99 1048 ms;
|
||
- a death was acknowledged in 44 ms;
|
||
- no acknowledged input was lost.
|
||
|
||
**M7 exit criteria are met locally.** Container, CI and cluster execution have not
|
||
run. Host-loss durability is M8.
|
||
|
||
Next: M8.1, the host inventory and budgets.
|
||
|
||
Review fixes (2026-09-29): schema v9 serializes build retirement with acquisition,
|
||
leases and provisioning under one lock order. It also serializes clone-world
|
||
classification per world. The operations listener's accept work per loop pass is
|
||
now bounded. Regression tests and five mutations cover each fix.
|
||
|
||
## M8.1 inventory (in progress, 2026-09-29)
|
||
|
||
docs/infrastructure/INVENTORY.md records:
|
||
- the maintainer's facts: an R730xd with about 128 GB, 32 GB worker nodes,
|
||
automatic publish to Harbor and automatic Argo CD deployment, and the existing
|
||
`aevolution-db` Secret. The Secret's single login conflicts with the required
|
||
18.6 pin and with the separate migrator/runtime roles;
|
||
- the measured workload profile: `evo-server` peaks at about 9.7 MiB and 0.3 % of
|
||
one core;
|
||
- a local storage baseline, and a proposed budget model.
|
||
|
||
Still needed:
|
||
- run the read-only `tools/inventory/collect-cluster.sh` with cluster access;
|
||
- hypervisor, VM and disk details from the maintainer;
|
||
- the storage probe on each candidate StorageClass, after approval.
|
||
|
||
M8.1 cluster inventory collected (2026-09-29, docs/infrastructure/INVENTORY.md):
|
||
- RKE2 v1.32.5: one control plane and three 32 GB workers on one hypervisor.
|
||
- `local-path` is the only storage (node-pinned, reclaim Delete).
|
||
- `aevolution-dev` syncs manually.
|
||
- AEvolution's PostgreSQL is a separate VM outside Kubernetes (`aevolution-db`),
|
||
so it is not in the worker budget.
|
||
- A proposed budget keeps AEvolution dev well under 1 GiB on one labeled worker
|
||
(not worker-3, whose disk is 87 % full).
|
||
|
||
M8.1 complete (2026-09-29) for the current disk layout. The per-worker
|
||
`local-path` probe measured:
|
||
- 1.9–2.5 ms for synchronous 4 KiB writes;
|
||
- 29–36 ms mean (73 ms max) per object publication;
|
||
- 110–255 MB/s sequential.
|
||
These are well inside the lease deadlines. Re-probe after the planned RAID and
|
||
storage change. Host memory was raised by about 500 GB.
|
||
|
||
Next: M8.2, environment isolation and secrets.
|
||
## M8.2 environment isolation (2026-09-29)
|
||
|
||
ADR-0069 adds three environments, each with its own guardrails, service accounts,
|
||
secret references and database:
|
||
- `evolution-dev`, `evolution-stage` and `evolution-world0`;
|
||
- guardrails: quota, limit range, default-deny networking, restricted pod
|
||
security.
|
||
A native ValidatingAdmissionPolicy denies deleting World0 data, identity or Argo
|
||
objects to everyone, including cluster-admin and Argo, unless the requester is in
|
||
`aevolution:world0-break-glass`. The stage and World0 Argo projects are scoped to
|
||
one namespace each, and World0 permanently denies automated sync. The cleanup tool
|
||
refuses World0.
|
||
|
||
The offline policy check (now a CI suite) passes, and nine injected violations
|
||
were each caught. Applying the layer and running `tools/ops/verify-isolation.sh`
|
||
is waiting on the maintainer.
|
||
|
||
M8.2 applied and verified live (2026-09-29): 175 PASS and 2 SKIP. The only 3 FAILs
|
||
were a script defect in the project check, now fixed. The maintainer accepted
|
||
leaving Argo's `default` project unrestricted. Break-glass membership is in the
|
||
new docs/BACKLOG.md. Next: M8.3, durable stores in dev and stage.
|
||
|
||
## M8.3 dev/stage stores (2026-09-29)
|
||
|
||
ADR-0070 sets up the dev and stage stores:
|
||
- **Database:** each environment gets its own database and logins on the external
|
||
PostgreSQL VM.
|
||
- **Object store:** the filesystem store stays, on a node-local PVC in the new
|
||
Retain class `aevolution-local-retain`, pinned to one labelled worker. There is
|
||
no object server.
|
||
- **Capacity:** node-local volumes ignore their requested size, so the object
|
||
store now enforces a free-space reserve (`--objects-reserve-mib`, default 1024).
|
||
A full volume refuses new objects with a distinct error, and nothing is
|
||
acknowledged.
|
||
- **Qualification:** `evo-world-clone check-store`, now in the server image,
|
||
checks from inside the cluster: volume presence and retention, the reserve,
|
||
database version and TLS, and the runtime privilege boundary.
|
||
|
||
Not yet done:
|
||
- the in-cluster run (it needs Secrets with the documented key names and
|
||
published image digests);
|
||
- choosing a backup destination (docs/BACKLOG.md).
|
||
|
||
M8.3 delivery moved to Argo CD, at the maintainer's request:
|
||
- **Platform app:** `aevolution-platform` (self-heal, never prune, `Delete=false`,
|
||
protected by admission) owns the namespaces, guardrails, storage class, object
|
||
claims and World0 policy.
|
||
- **Store Jobs:** they become sync hooks in each environment's path once their
|
||
digests and runtime roles are supplied.
|
||
- **Outside Argo:** Secrets and the store node label.
|
||
|
||
## M8.4 region host (2026-09-29)
|
||
|
||
The maintainer synced the dev, stage and platform applications through Argo CD,
|
||
and they are connected to PostgreSQL, with digests `661e433e…` (server) and
|
||
`9abb06ef…` (tools).
|
||
|
||
ADR-0071 deploys `evo-region` as one replica per environment:
|
||
- the Recreate strategy, since a rolling update would deadlock on the lease;
|
||
- readiness `/readyz`, liveness `/livez`;
|
||
- no CPU limit;
|
||
- a 20 s drain inside a 45 s grace period.
|
||
|
||
Each sync runs, in order: egress, migration, provisioning (idempotent, from the
|
||
new `development_opening`, which is byte-identical to the qualification fixture),
|
||
the host, then the store check. The image digest is also the build identity, and
|
||
the policy check enforces this. Dev is world 100 and stage world 200, both region 1.
|
||
|
||
Next: apply `deploy/argocd/dev/project.yaml`, sync, and run
|
||
`tools/ops/region-drill.sh dev`.
|
||
|
||
## M8.5 observability (2026-09-30)
|
||
|
||
ADR-0072 adds an AEvolution-only monitoring stack in `aevolution-monitoring`:
|
||
- **Components:** Prometheus 3.13.3 and Alertmanager 0.34.1, pinned by digest and
|
||
delivered through Argo.
|
||
- **Scraping:** static targets, so no Kubernetes API access. The region's port
|
||
9100 is reachable only from Prometheus.
|
||
- **Alerts:** 16 rules covering authority, lease, commits, backlog and object
|
||
capacity, plus a Watchdog. Each is proven firing and silent by promtool
|
||
injection tests in CI. They route to a null receiver until a destination is
|
||
chosen.
|
||
- **Metrics:** two new capacity gauges (32 fixed series).
|
||
|
||
No broker is adopted: the database outbox stays. Logs are bounded by kubelet
|
||
rotation. Monitoring costs about 1,300 series, roughly 11 MB a day.
|
||
|
||
Next: sync the monitoring app, confirm the targets, and run the `EvoRegionDown`
|
||
injection. M8.4's drill results are still to be recorded.
|
||
|
||
## M8.6 fault drills (2026-09-30)
|
||
|
||
ADR-0073 adds a drill-only synthetic driver, `evo-server --synthetic-inputs
|
||
development-v1`:
|
||
- it feeds deterministic inputs from the committed head after every recovery,
|
||
including the tick-20 death;
|
||
- its request IDs are `SYN1‖region‖tick`;
|
||
- it is off in Git, and the policy check enforces that.
|
||
|
||
`tools/ops/fault-drill.sh` puts dev or stage under load and runs these scenarios:
|
||
- **kills:** three forced kills, measuring RTO and checking that no acknowledgement
|
||
is lost;
|
||
- **full:** a full volume, which must acknowledge nothing;
|
||
- **empty:** an empty volume, which must quarantine and never start a fresh world;
|
||
- **db-outage:** an operator-blocked database, after which a stale epoch never
|
||
resumes.
|
||
|
||
It restores the Git configuration on exit.
|
||
|
||
Earlier (M8.4 follow-up): `REGION_RETAINED` keeps earlier builds recoverable
|
||
across image upgrades.
|
||
|
||
## M8.7 backup and restore (2026-09-30)
|
||
|
||
ADR-0074 adds world backup bundles and a verified restore:
|
||
- `tools/backup/backup-world.sh`: an online backup cut by one exported database
|
||
snapshot (MANIFEST heads and `pg_dump` read the same snapshot), then the
|
||
immutable objects, each checked against its digest; `SHA256SUMS` over all of it.
|
||
- `tools/backup/restore-world.sh`: checksums first, then an owner-only restore into
|
||
an empty database, exact head comparison and a full history audit of every region;
|
||
any failure removes what it restored.
|
||
- `tools/backup/verify-backup.sh`: the restore on a private throwaway cluster with
|
||
fresh roles, then (`--isolate WORLD`) a clone into an isolated world that serves
|
||
under synthetic load and drains.
|
||
- `tools/backup/cluster-backup.sh <dev|stage> --to DIR`: an operator Pod (read-only
|
||
objects volume, migrator login) whose bundle is streamed off the cluster.
|
||
- The postgres-tools image now carries `pg_dump` and `pg_restore` from the pinned
|
||
18.6 build; the database egress policy admits the `backup` component.
|
||
|
||
The destination, encryption, schedule, retention and WAL archiving wait on the
|
||
maintainer (docs/BACKLOG.md).
|
||
|
||
## M8.8 World0 gate and host-loss recovery (2026-09-30)
|
||
|
||
ADR-0075:
|
||
- **World0 launch is blocked.** Everything runs on one physical host, so an
|
||
acknowledged death could be undone by host loss. The deploy policy check now
|
||
rejects any World0 workload, a resolved World0 Application path, and World0
|
||
overlays; any future World0 pin must equal stage's digest.
|
||
- **Dev/stage objectives ratified:** worker loss RPO 0 and RTO <= 60 s (measured
|
||
~20 s); host loss rewinds to the last verified bundle, explicitly.
|
||
- `restore-world.sh --in-place --runtime-role ROLE --accept-rewind` restores a world
|
||
under its own identity with its grants, fences restored leases, audits runtime
|
||
rights and prints the rewind.
|
||
- `fence-database.sh` supersedes the old database through the upgrade barrier: a
|
||
still-running old host quarantines, and no host can acquire it again.
|
||
- `tools/ci/dr-check.sh` rehearses it in every PostgreSQL build.
|
||
|
||
## M8.9 upgrade and growth (2026-09-30)
|
||
|
||
ADR-0076:
|
||
- **Compare before upgrading.** `evo-server --synthetic-until TICK --accelerate N`
|
||
(drill-only, refused without the synthetic driver) runs clones to an exact tick
|
||
faster than real time; `evo-world-clone compare` (library:
|
||
`compare_region_histories`) audits both and requires the same world: same
|
||
versions, identical rebound head state and identical outcomes. Builds may differ.
|
||
- **Failed migration and barrier rehearsed** with real hosts
|
||
(`tools/ci/upgrade-check.sh`): a failing migration leaves schema v9 and the host
|
||
serving; the barrier fences the old build (exit 4), the new one resumes under a
|
||
newer epoch, and the history across both builds audits.
|
||
- **Dev/stage barrier:** `tools/ops/upgrade-barrier.sh <env> --retire HEX` retires an
|
||
old build only when it is in `REGION_RETAINED` and the new digest is already Ready.
|
||
- **Nodes:** `aevolution.io/stores` (one worker; every objects-volume pod selects it)
|
||
and `aevolution.io/compute` (preferred only; Alertmanager first).
|
||
`tools/ops/scheduling-check.sh <env>` verifies placement read-only.
|