M12.4: keep cellular wildlife ticking and retain scheduling debt
Foundation / checks (deploy) (push) Successful in 5s
Foundation / checks (ecs) (push) Successful in 2m35s
Foundation / checks (tsan) (push) Failing after 17m51s
Foundation / checks (network) (push) Successful in 21m13s
Foundation / checks (client) (push) Successful in 22m19s
Foundation / checks (postgres) (push) Successful in 48m25s
Foundation / checks (checks) (push) Failing after 50m8s
Foundation / postgres-tools (push) Skipped
Foundation / server-image (push) Skipped
Foundation / image (push) Skipped

This commit is contained in:
dingo
2026-10-17 12:24:19 -04:00
parent 5decaa0326
commit aff35863ce
12 changed files with 434 additions and 20 deletions
+17
View File
@@ -1,5 +1,22 @@
# Project status and next steps
## 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
@@ -0,0 +1,55 @@
# ADR-0141: Cellular unattended tick demand and confirmed-head pacing
## Status
Accepted for the existing cellular worker, 2026-10-17. No biological rule,
checkpoint format, schema, deployment or World0 change. This is M12.4a, not
completion of population publication, durable interval admission or migration.
## Context
The worker only steps while it finds a player, a held birth or lingering cell.
Consequently wildlife stops when the last player leaves and linger completes.
An active offline cell restored without a session also never starts its freeze
transition. Resetting the deadline to completion time plus 50 ms further discards
running scheduling debt when work or publication is slow.
## Decision
For profiles supporting offline freeze (rules 5+), demand includes every unowned
descendant and each active/lingering controlled life. Suspended controlled stock
alone supplies no demand. A returning session or held birth still wakes the
worker. Historical profiles lacking freeze retain their previous session-driven
behavior; do not newly advance disconnected biology under those profiles.
Keep the existing shared wildlife controller, frozen controlled baseline, batch
builder and fenced PostgreSQL publication path. No new biological intent or
background balance is invented. There is at most one tick attempt per worker
loop, at the existing 50 ms quantum; batching or a larger timestep is not implied.
Use a portable pacing object that reads caller-supplied monotonic microseconds,
current authority epoch and confirmed head. It counts due ticks from a fixed
running origin. Only a confirmed head advance consumes debt. Refused work retries
at most once per quantum while preserving debt. Do not cap away accumulated debt,
delete lives to catch up or advance from an unconfirmed candidate. Reject clock
regression, same-epoch head regression and an unfenced ready origin. Tick/count
arithmetic must remain bounded at u64 limits.
Authority unavailability, epoch replacement, process restart and no tick demand
pause unadmitted wall time under ADR-0133. Existing uncertain publications still
resolve through the host's exact pending record before it becomes ready. This
pacer is not a durable interval queue or cross-worker fence. The existing host
continues to own that authority; no outage catch-up policy is introduced.
Expose debt and maximum debt through existing fixed-cardinality region metrics.
Checkpoint age measures time since the last confirmed head change/recovery;
readiness still independently states whether output may originate.
## Remaining M12.4 work
Population envelope publication and durable interval admission/recovery require
their own profile and store work. Biological migration needs exact genome/history
closure, source escrow and idempotent destination installation under both region
fences; the existing non-biological probe transfer is not that implementation.
No live biological migration, partition qualification or days-long ecology proof
follows from these scheduler checks.
+2
View File
@@ -159,3 +159,5 @@ design. No unadopted candidate is a link dependency of the proof.
- [ADR-0139: Exact cellular local cohorts](0139-exact-cellular-local-cohorts.md)
- [ADR-0140: Exact population checkpoint and policy](0140-exact-population-checkpoint-and-policy.md)
- [ADR-0141: Cellular unattended demand and pacing](0141-cellular-unattended-demand-and-pacing.md)
+11 -2
View File
@@ -1,4 +1,4 @@
# M12.1-12.5 delivery and prerequisite conflicts
# M12 delivery and prerequisite conflicts
Requested scope: ecological identity, population qualification, durable automatic
tier transitions, unattended scheduling/migration and environmental coupling.
@@ -11,8 +11,17 @@ Commit and push each validated scoped segment separately.
| 12.1 | Engineering evidence policy and explicit deferrals documented | ADR-0133, identity/time contract and worked histories; no new game rules or runtime versions. |
| 12.2 | Exact local model selected and paired qualification implemented (12.2d); production cost gate open | ADR-0139, exact canonical equality across 196,608 paired ticks per platform. Regional approximation disabled; no compression claim. Deployment-host capacity and fuller interaction coverage remain open. |
| 12.3 | Portable exact conversion closure, automatic policy and process recovery implemented | ADR-0140, population envelope 1. Dedicated PostgreSQL profile/trace/publication adapter and fault injection remain required before enabling the live selector. |
| 12.4 | Blocked on 12.2-12.3 | Existing cellular worker pauses without sessions/lingering players; bounded unattended recovery and biological migration escrow remain unimplemented. |
| 12.4 | Current-worker unattended demand and confirmed-head pacing implemented (12.4a) | ADR-0141. Population durable intervals and biological migration escrow remain unimplemented. |
| 12.5 | Blocked on 12.2-12.4 | Finite M6 process fixtures do not qualify coupled persistent cellular/cohort atmosphere/water budgets. |
| 12.6 | Existing local archive retained; integrated population history open | World-level durable event/query/client path remains required. |
| 12.7 | Evidence policy defined; reconciler open | Complete durable world watermark and every viable/in-flight store remain required. |
| 12.8 | Not qualified | Actual multi-day integrated ecology/restart/clone evidence remains required. |
| 12.9 | Not accepted | Returning-player product evidence and expansion review remain required; World0 stays separately blocked. |
The [remaining-gate audit](M12_REMAINING_GATES.md) identifies the exact publication
boundary and concrete integration work. This is not an approval hold or a request
to reopen M11.9. Do not mark portable recovery, current-worker pacing or a short
research run as completion of the dependent durable ecology/product gates.
The maintainer explicitly closes M11.9 for now on 2026-10-17 and authorizes M12
continuation; see the [closure decision](M11_9_DELIVERY_PLAN.md). The recorded
+55
View File
@@ -0,0 +1,55 @@
# M12 integration and evidence still required
This is the current completion audit following the maintainer's request to try
all of M12. M11.9 remains closed for now. M12.2 decisions are delegated and recorded
in ADR-0139; no additional product approval is inferred as a coding prerequisite.
Completed scoped commits do not mean their entire roadmap gates have passed.
## Persistence boundary before expansion
The new exact population envelope cannot be labeled as the existing profile-4
CellularLives payload. The live publisher/recovery path, immutable manifest,
database validators and trace currently agree on that raw cellular format. A
population checkpoint containing ownership tags and policy needs a dedicated
profile and versioned transition/publication adapter. Reinterpreting profile 4
would violate REGION_DURABILITY and break retained recovery evidence.
Resolution: add an opt-in population profile and an explicit no-tick migration
from the accepted rules-8 cellular state, retaining identities, archive, funding
and balances. Publish its complete immutable payload, bound trace and permanent
events under the current region fence. Replay must retain recorded intentions
and exact membership samples, rather than rerunning a decision after an uncertain
commit. Verify lost replies and pre-upload/pre-transaction/post-commit/post-ACK
process death against a private PostgreSQL fixture. Keep production disabled until
these and target-host budgets pass. A portable codec is not a substitute for this
adapter. This is remaining M12.3 implementation, not a user-permission hold.
## Dependent ecological integration
| Gate | Existing useful basis | Work/evidence still required |
|---|---|---|
| 12.2 | Exact cellular model and paired matrix; local samples through 256 lives | Deployment-host tail costs including publication; larger wildlife cohorts, predation/twins and contention coverage; useful compression remains unimplemented. |
| 12.3 | Complete population codec, exact conversion candidates, automatic policy and fresh-process continuation | Dedicated durable profile/trace/store/host integration and fault-injected atomic publication described above. |
| 12.4 | Current worker advances unattended wildlife and preserves running scheduling debt | Durable ecological interval admission/backlog recovery; exact biological source/destination escrow, partition/duplicate settlement and stock-in-transit audits. |
| 12.5 | Finite cellular contact feeding/decay and separate M6 producer/consumer resource owner | One jointly owned cellular/environment budget, explicit effective depth and source entitlements, versioned water/atmosphere species mapping and producer coefficients, plus closed/open and nutrient-exhaustion comparisons. |
| 12.6 | Retained genome/organism archive with ancestry and common-ancestor queries | Append-only population census/history events in the same durable commit, bounded world history queries/indexing and client presentation; no account power or invented precise statistical ancestry. |
| 12.7 | ADR-0133's viability/unknown semantics | Durable region-set/watermark reconciliation covering every owned representation, suspended/viable stock and migration escrow. Missing/stale regions must prevent terminal extinction. |
| 12.8 | Deterministic seed/regime drivers and separate-process exact continuation | Reproducible integrated worlds running for actual days, real restarts/clone comparisons and retained accounting/diversity/cost audits. Accelerated tests cannot supply elapsed days. |
| 12.9 | M11 feedback and current UI review retained | Returning-player samples on the integrated ecology and explicit product/3D readiness decision after soak evidence. No M12 product acceptance or World0 promotion is inferred. |
Do not couple the current cellular habitat to a copied M6 stock view: two owners
would then spend the same resources. M6 currently owns ten finite field channels
and exactly two configured actors; cellular lives own energy and C/N/P/other plus
finite deposits. Their geometry, ownership and chemical units need a versioned
mapping, not a renamed fixture. ADR-0136 step A is implemented; proposed infall
and photosynthesis steps B/C do not silently become accepted M12 mechanics.
The engineering constitution requires stopping expansion at this architectural
boundary and documenting the resolution. That does not prevent the independent
worker scheduling correction, which uses the existing raw cellular publication
path. The outstanding population integration is the next substantive coding
segment; none of the rows above is closed by adding a placeholder service.
Current expansion readiness: **no-go for M13 integration or World0 promotion**
while these M12 integration/evidence gates remain open. This records the present
engineering evidence, not a substitute for the later maintainer product review.
+39
View File
@@ -1,5 +1,44 @@
# Validation report
## 2026-10-17 - M12.4a unattended demand and confirmed-head pacing
ADR-0141 changes the existing cellular worker's demand/pacing and metrics, with
portable helpers. Rules 5+ wildlife now supplies tick demand after players
suspend; active offline cells can enter/finish freeze. Historical profiles lacking
freeze are not opted into unattended work. Biology, profile-4 persistence and
database schema are unchanged. No deploy, World0 operation or new dependency.
Executed:
- MSVC 19.44 Release configure/build and **75/75 CTests**, including corrected
legacy-founder fixture, per-boundary offline demand, long cohort conversion
case and separate-process population continuation.
- GCC Release demand/pacing and population-transition tests. Actual QUIC-enabled
PostgreSQL `evo-server` and `evo-postgres-tests` build in `build/m97-postgres`.
- Full `tools/ci/postgres-check.sh` private disposable-cluster suite **passed,
exit 0, 494 s**: migrations/rollback, permissions, fencing, cellular publication,
process/session tests, reservations, backup/restore, DR, upgrade, migration
history and checksum drift. This run includes unattended demand and confirmed
head pacing; the final legacy-guard/freshness refinements have direct final
tests and the final Clang server build/static analysis below.
- Final Clang 19 QUIC/PostgreSQL worker build in `build/tidy-postgres`, followed
by explicit `clang-tidy-19 -p build/tidy-postgres apps/evo-server/main.cpp
--warnings-as-errors=*` (the cached build itself has automatic tidy disabled).
- Analysis-preset clang-tidy 19 for the portable implementation/tests, repository
clang-format 19 check, and scheduler CTest passed. ASan/UBSan scheduler CTest
passed (0.24 s), no reports; population transition regression also passed
ASan/UBSan (8.37 s) during this segment.
- New documentation links and `git diff --check` passed. Explicit NDEBUG checks
exercise fixed-clock debt/retry/confirmed-head accounting, freshness, pause,
epoch change, regressing head/clock and u64 terminal boundaries.
The actual-private-DB suite is a regression check, not a live no-player ecology
soak or deployment-host capacity measurement. Specific new unattended behavior
has direct demand/clock and real funded-descendant/suspension tests, not a new
multi-region biological process test. No durable population-profile publication,
cross-region biological escrow, global extinction or multi-day soak is claimed.
Remaining integration/evidence: [M12_REMAINING_GATES](M12_REMAINING_GATES.md).
## 2026-10-17 - M12.3a exact population checkpoint closure
ADR-0140 adds population envelope 1, detached conversion candidates and opt-in