Files
aevolution/docs/engineering/M12_REMAINING_GATES.md
T
dingoandClaude Opus 5.5 b73ccbae9a
Foundation / checks (ecs) (push) Successful in 2m19s
Foundation / checks (deploy) (push) Successful in 4m47s
Foundation / postgres-tools (push) Canceled after 0s
Foundation / server-image (push) Canceled after 0s
Foundation / image (push) Canceled after 0s
Foundation / checks (checks) (push) Canceled after 16m48s
Foundation / checks (network) (push) Canceled after 16m46s
Foundation / checks (postgres) (push) Canceled after 16m47s
Foundation / checks (client) (push) Canceled after 16m53s
Foundation / checks (tsan) (push) Canceled after 14m33s
feat(ecology): make photosynthesis regions playable on DEV
ADR-0176 and schema 57 admit raw cellular bundle 13 (rules 11 on owner
format 9) through parser-local normalization to bundle 12, and a fenced
no-tick 12 -> 13 upgrade that declares the region's light; recovery reads
the light from the target and re-derives the whole target from the source.
The resumable cellular-v8 opening provisions a cellular-v7 genesis, one
empty tick and the durable upgrades to bundle 13.

Session v12 adds the owner's captured light and the producers it can see
to its perception, and lets offers name photosynthesis; older sessions keep
their layouts and never receive photosynthesis candidates. The client
draws chloroplasts by efficiency, shows sunlight in the HUD and offers
photosynthesis cards. DEV now provisions and serves region 9 with the
trial light; region 8 stays stored but unserved.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-19 23:04:34 -04:00

252 lines
19 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.
The maintainer's 2026-10-19 [gameplay clarification](../adr/0163-structural-inheritance-and-offspring-succession.md)
accepts offspring structural expression, a one-way birth-time control choice and
NPC-parent behavior/reproductive continuity. Portable retained plans implement
part of that target; durable mutation/birth, behavior, control and census still
require coordinated versioned biology, authority, recovery and UI work. Earlier
exact-copy generation
evidence does not close that gap or establish the intended generational gameplay.
[ADR-0164](../adr/0164-distinct-genome-offspring-funding.md) now implements the
pure biological funding step with distinct parent/offspring genomes and exact
closure. [ADR-0165](../adr/0165-retained-cellular-offspring-plans.md) adds portable
retained plans and earned selections, unchanged expressed parents and repeated
funded births. [ADR-0166](../adr/0166-retained-plan-replay-traces.md) adds portable
raw trace-4 replay, action matching and exact process restart. Existing same-genome
behavior remains. [ADR-0167](../adr/0167-retained-plan-checkpoint-upgrade.md) defines
the portable raw checkpoint tuple and exact retained-source upgrade.
[ADR-0168](../adr/0168-durable-retained-plan-admission.md) adds schema 55,
explicit fenced raw admission, plan selections and repeated funded births with
complete source/target recovery. [ADR-0169](../adr/0169-retained-plan-census-observations.md)
qualifies raw census projection 2 through committed history and registered
snapshots, with separate living plan holders and dead-plan history rather than
invented expressed carriers or stock.
[ADR-0171](../adr/0171-retained-plan-exact-populations.md) adds portable exact
population envelope/batch 3, retained membership/plan state, raw/cohort equality
and projection-2 cohort counts. Durable population/migration admission, the
in-life expression catalog, authority
handoff and NPC/UI integration are still required.
Delivery follows the maintainer-confirmed Git Actions -> Harbor -> ArgoCD ->
Kubernetes flow using `deploy/`. DEV qualification belongs in `evolution-dev`
on worker nodes, using the existing PostgreSQL server/network endpoints and
isolated test data. A successful local check or Git push alone is not evidence
that a target-host fault drill or deployed workload passed. Direct workstation
Kubernetes access is not a prerequisite for this delivery flow.
[ADR-0170](../adr/0170-dev-worker-placement.md) now enforces required worker
placement in full/standalone DEV overlays and rendered policy, including all
affinity alternatives and direct-node bypasses. Its
[50-case policy proof](M12_DEV_WORKER_PLACEMENT.md) does not establish actual
node labels, deployed placement, rollout success or target-host performance.
## Persistence boundary resolved by 12.3b
ADR-0142 adds dedicated profile 5, population trace 1 and schema 44; raw profile 4
retains its meaning. Explicit no-tick migrations preserve the complete biology.
The publisher, replay verifier, immutable SQL evidence, recovery and owning host
now support exact population membership with entry disabled by default. Private
PostgreSQL tests cover ambiguity, fencing, profile races and publisher process
kills. [Scope and limits](M12_DURABLE_POPULATIONS.md) distinguish those tests from
executable/network fault drills and deployment-host qualification still required.
This resolves the architectural profile conflict. ADR-0143/schema 45 now adds
bounded durable interval admission and exact settlement/recovery, with fully
suspended controlled cells required for new work. It does not close all of M12.3
or authorize production enablement.
## Dependent ecological integration
| Gate | Existing useful basis | Work/evidence still required |
|---|---|---|
| 12.2 | Exact cellular model and paired matrix; local samples through 256 lives; bounded four-generation rules-9 predation/twin matrix | Deployment-host tail costs including publication; larger wildlife cohorts and fuller contention coverage; useful compression remains unimplemented. |
| 12.3 | Dedicated population profile/trace/store/owning host; exact recovery and private PostgreSQL fault tests | Population-specific executable/network fault drills and target-host publication/capacity qualification. |
| 12.4 | Owned intervals; exact transfer/accounting; durable atomic pair/recovery; independent loopback TLS path loss and owner expiry/replacement/heal; local object sync/read-failure matrix | Multi-host/kernel-network, storage-host and orchestrator drills, linked-boundary contracts and integrated ownership/stock audits at scale. |
| 12.5 | ADR-0175 photosynthesis producers (portable rules 11/format 9); ADR-0172 portable joint owner: one budget for cells and local environment, effective depth, tagged water/dissolved compartments, refused atmosphere, finite infall entitlements, radiative export; closed/source-off/open/exhaustion and raw/cohort comparisons; ADR-0173 joint batch with exact unattended replay; ADR-0174/schema 56 durable profile 6 with owned intervals and exact recovery | Producer playtests and balance (DEV region 9); bundle 13 in population/joint/census/migration; joint fault drills (deferred by the maintainer), worker/census/migration integration and escrowed cross-worker sources (12.5d), target-host qualification (12.5e). |
| 12.6 | Retained archive, regional census/lineage queries, replayed history, scoped multi-region queries and consistent database head snapshots (12.6a-d); registered coverage/history domains follow in 12.7a-b | Cross-domain clone provenance, retained historical coverage/other viable stores, target-host query/index qualification and client permission/presentation; no account power or invented precise statistical ancestry. |
| 12.7 | Viability/unknown policy; consistent cuts, registered coverage, history domains/restore forks and verified pending handoff evidence (12.7a-c/schema 52) | Cross-domain clone provenance, other viable-store coverage and durable accepted global evidence records/freshness. Missing/stale/unsupported owners must prevent terminal extinction. |
| 12.8 | Deterministic seed/regime drivers, separate-process exact continuation and bounded unscripted generations | 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 [ownership resolution proposal](M12_ENVIRONMENT_OWNERSHIP_RESOLUTION.md)
records the actual public-API conflict, a composite-owner/checkpoint direction,
typed compartment and source requirements, worked balances and delivery segments.
The maintainer accepted it on 2026-10-19; [ADR-0172](../adr/0172-cellular-environment-ownership.md)
records the clarified scope and implements the portable joint owner. It is not a
durable profile, live upgrade, producer ecology or completed 12.5.
The engineering constitution requires stopping expansion at this architectural
boundary and documenting the resolution. That does not prevent the independent
worker scheduling correction or the dedicated exact population adapter above.
Durable biological migration escrow is implemented through ADR-0147–0149 below;
none of the rows above is closed by adding a placeholder service or relabeling
the non-biological probe.
ADR-0144's [portable transfer candidates](M12_EXACT_BIOLOGICAL_TRANSFER.md) resolve
the closed-owner/foreign-identity conflict with explicit flows and nonresident
history. Those portable candidates alone grant no durable publication or
activation authority; the dedicated workflow below supplies that boundary.
Paired transfer trace 1 now supplies bounded, independently replayable input and
member/material evidence, including raw/cohort separate-process reproduction.
It does not grant ownership or close database escrow/retry/partition qualification.
Population batch 2 continues owner-7 biology and conversions with retained flows;
cross-version replay is refused and a new process reproduces a post-transfer
64-tick interval. Its durable admission/upgrade remains intentionally unsupported
by bundle 9 and schema 45.
ADR-0145 now defines the portable bundle-10 declaration and explicit same-profile,
no-tick source upgrade, with complete payload preservation and no new genesis.
ADR-0146/schema 46 supplies SQL admission through the existing immutable
version-upgrade evidence and complete replayed recovery. Both profile upgrades,
population batch 2 and bundle-preserving profile changes are explicit; no worker
upgrades automatically. This format admission does not publish a migration pair
or close source-freeze/destination-activation and escrow qualification.
ADR-0147/schema 47 now adds durable source preparation/freeze, retained replay
capsules, explicit abort and host pause/recovery. Source stock remains owned at
its exact head through worker replacement; no timeout or drain releases it.
ADR-0148/schema 48 now supplies destination-authorized staging at its exact
captured head, verified read-only ghost/capsule retention and full destination
recovery. Both endpoints stay paused; explicit source abort atomically releases
both pointers and races safely with staging. ADR-0149/schema 49 now commits both
exact results and an immutable common receipt under both current fences. Failed
second inserts roll back both heads; commit/abort races have one exclusive
outcome. Exact retries preserve both manifests under fresh authority. Hosts
replay and verify changed heads before readiness. Preparation remains an
optimistic destination observation; staging/publication recheck captured heads.
M12.4k now exercises actual loopback TCP/end-to-end TLS with independent request
and response loss, lost prepare/stage/abort receipts, either owner's actual lease
expiry, replacement and healed stale-owner fencing in both representations.
Independent database observation proves unchanged or atomically committed heads;
the healthy peer keeps its epoch and retained pause. See
[the transport scope](M12_MIGRATION_TRANSPORT_FAULTS.md). Multi-host/kernel-network
partitions, object-store/orchestrator failures and linked ecology remain open.
M12.4l adds local object directory-sync failures before publication and actual
read-permission denial after commit. Current-result I/O failure pauses complete
recovery for retry; unavailable counterpart replay evidence quarantines until
explicit replacement. Both preserve the original receipt and heads. See
[storage scope](M12_MIGRATION_STORAGE_FAULTS.md). This does not qualify a remote
storage-host outage or physical media/power failure.
The transfer tests also expose the current rules-8 maturation gap: buds retain
their subadult realization while reproduction requires a fully realized parent.
Finite extra food alone does not close repeated wildlife generations. A versioned
growth contract and real multi-generation evidence remain necessary; transfer
tests must not fabricate adult wildlife or silently change the rules to pass.
The existing metabolic construction budget already derives a channelwise
affordable growth transition with explicit intake/release, but cellular ticks do
not apply it. It is a concrete basis for a separately versioned funded maturation
contract that also resolves expanded-body collision, tick ordering and offline
freeze. Its existence alone does not admit a new growth rule.
[ADR-0157](../adr/0157-funded-cellular-maturation.md) now implements that **portable
opt-in rules-9** prerequisite, preserving rules 8 and all default/live admission.
The exact construction transfer, bounded rate, spatial refusal, offline exclusion
and saved-choice funding are explicit. A real finite-food founder/bud reaches
funded adulthood and produces another bud, with paid sibling movement; raw/cohort
growth, conversion, recorded replay and separate-process continuation agree.
This is scripted biological evidence, not autonomous multi-generation ecological
qualification. Small juveniles can receive zero phosphorus per tick from a pool
because the existing quarter-yield rounds down; finite nutrient motes/contact and
space still matter. Durable rules-9 publication/migration/census, linked resources,
automatic wildlife robustness, balance and actual-days qualification remain open.
ADR-0158/schema 53 now adds explicit durable bundle-10 -> 11 maturation admission,
using the existing immutable version journal and exact same-profile recovery.
Raw/cohort publication and representation changes preserve the retained rule.
This does not enable rules-9 biological migration, autonomous sustainability,
joint environmental budgets or actual-days qualification.
ADR-0159 now qualifies rules-9/owner-7 census projection 1 through the existing
committed history and registered snapshot readers. Exact retained body/reserve,
real funded growth, same-tick version/profile cuts and concurrent capture are
checked. Mixed rules 8/9, unavailable objects/builds and stale grants refuse the
complete query. No new SQL schema, redundant census journal or biological rule.
This does not close viable-store reconciliation, extinction or M12 ecology gates.
ADR-0160 qualifies portable transfer between equal rules-9/owner-7 cuts and
separately identified migration trace 2. No transfer tick, growth reset or stock
re-derivation is introduced; real pre/post-transfer growth, exact raw/cohort
biology, replay/process continuation and refusal matrices are checked. Trace 1
retains rules 8. The durable adapter still rejects trace 2/bundle 11: explicit
freeze/stage/paired publication/recovery and registered pending-handoff census
qualification are required before rules-9 durable migration is supported.
ADR-0161/schema 54 now supplies that explicit durable admission through the
existing journals, pending pointers and two-head transaction. Exact bundle-10/
trace-1 and bundle-11/trace-2 pairs retain their respective biology. Mixed bundles
and cross-rule traces fail. Both representations retain complete freeze/stage/
publication/recovery and registered census verification. Multi-host network and
storage drills, linked resources, sustainable generations and actual-days/product
qualification remain open; no live/default upgrade or M12 completion is inferred.
M12.6a's [regional census projection](../../schemas/ecology/regional-cellular-census-v1.md)
independently implements local current-genome and descendant-closure queries.
It keeps suspended stock and retained zero-carrier ancestry, separates exact cohort
tags from additional ownership, and excludes nonresident history from living stock.
The local projection itself has no commit/branch/epoch binding or complete world
coverage. M12.6b's [committed history reader](../../schemas/ecology/committed-cellular-history-v1.md)
now derives it from the existing immutable atomic biological journal, with full
historical replay, exact manifest binding and a fixed regional upper cut. No
redundant census write or separate publication window is added. That regional cut
is not an external branch identity or complete world watermark. World-level
history context/queries, client presentation and M12.7 reconciliation remain open;
neither primitive accepts terminal extinction.
M12.6c adds [scoped multi-region queries](../../schemas/ecology/scoped-cellular-census-set-v1.md)
over 1..64 explicitly declared regions. Exact coverage and simulation boundaries,
complete shared-genome identity and disjoint resident organism IDs are checked
before querying. Nonresident historical records add no living stock. A required
list supplied by a caller is still not durable world coverage; equal ticks alone
cannot prove a consistent migration cut or branch. This does not close M12.7.
M12.6d's [consistent scoped snapshot](../../schemas/ecology/consistent-cellular-census-snapshot-v1.md)
now captures all declared heads in one database read snapshot before exact replay.
An atomic pair cannot straddle that selected set when both endpoints are declared.
The short metadata transaction ends before object I/O and fenced recovery; failed
evidence still returns no partial census. Durable world/branch identity, required
owner coverage, outside transfers and viable-store reconciliation remain open.
M12.7a/schema 50's [registered coverage](../../schemas/ecology/registered-world-census-coverage-v1.md)
now reads the existing durable authority registry before head selection in that
same database snapshot. Every registered region is required, including inactive,
expired, unsupported and unavailable owners. Unknown worlds and a 65th region
fail rather than becoming zero or a truncated complete set. Concurrent later
enrollment belongs to a later cut. No duplicate catalog/enrollment write is added.
That registered-coverage primitive alone does not identify external history or
authorize terminal extinction.
M12.7b/schema 51's [history domain](../../schemas/ecology/database-history-domain-v1.md)
now binds registered results to a database namespace in the same metadata view.
Supported restores fork before verification/readmission and retain parent/request
and exact restored cuts. Initial adoption and legacy backups cannot recover
unknown original context; direct privileged database copies can bypass the
workflow. Cross-domain clone provenance, other viable/in-flight stores and durable
accepted reconciliation remain open. This still does not close M12.7.
M12.7c/schema 52's [pending handoff evidence](../../schemas/ecology/census-pending-migrations-v1.md)
now captures active source/destination pointers with domain/registry/heads, binds
them to the selected cuts and fully verifies retained source capsules and staged
ghost biology after capture. Source-owned life is already in the census; ghosts
add none. Prepare/stage/abort/commit races preserve the selected view. Unavailable
or false evidence fails the whole query. Other viable stores, external clone
provenance and accepted durable global reconciliation/freshness remain open.
ADR-0162's [bounded unscripted generations](M12_UNSCRIPTED_GENERATIONS.md)
qualify unchanged-controller rules-9 reproduction through four wildlife generations
in the declared finite rich four-founder matrix, with raw/cohort equality,
conservation, actual predation/twins and periodic exact restores. Scarce and rules-8
controls retain their different outcomes. These are 4,000 simulated seconds per
case, not sustainable producer ecology or actual elapsed days.
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.