M12.4: retain read-only destination migration stages
Foundation / checks (deploy) (push) Successful in 5s
Foundation / checks (ecs) (push) Successful in 2m25s
Foundation / checks (network) (push) Successful in 20m44s
Foundation / checks (client) (push) Successful in 21m57s
Foundation / checks (tsan) (push) Successful in 22m46s
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 30m2s
Foundation / checks (postgres) (push) Canceled after 29m56s
Foundation / checks (deploy) (push) Successful in 5s
Foundation / checks (ecs) (push) Successful in 2m25s
Foundation / checks (network) (push) Successful in 20m44s
Foundation / checks (client) (push) Successful in 21m57s
Foundation / checks (tsan) (push) Successful in 22m46s
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 30m2s
Foundation / checks (postgres) (push) Canceled after 29m56s
This commit is contained in:
@@ -1,5 +1,22 @@
|
||||
# Project status and next steps
|
||||
|
||||
## 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
|
||||
|
||||
@@ -0,0 +1,56 @@
|
||||
# ADR-0148: Durable destination staging without activation
|
||||
|
||||
## Status
|
||||
|
||||
Accepted and locally qualified for scoped M12.4i implementation, 2026-10-18.
|
||||
Executed evidence and limits are in [VALIDATION](../engineering/VALIDATION.md).
|
||||
Paired result publication and activation remain subsequent
|
||||
work. This selects no route, automatic migration or deployment.
|
||||
|
||||
## Decision
|
||||
|
||||
Extend ADR-0147 preparation with destination-authorized staging at the exact
|
||||
captured destination head. Lock the two regional lease rows in region order,
|
||||
check current destination authority and the retained source freeze, and refuse
|
||||
pending destination work. Retain one immutable staging record and one bounded
|
||||
destination pending pointer. A region cannot participate in two workflows or
|
||||
simultaneously be a source and destination. Both biological heads stay unchanged.
|
||||
|
||||
Restore both verified predecessor payloads and replay the exact retained trace.
|
||||
Copy the source predecessor into the destination object namespace, and upload
|
||||
and read back the derived destination candidate there. Record its SHA-256 and
|
||||
length. It is read-only evidence: it is never a committed checkpoint, owned
|
||||
stock, active population, census entry or permission to run biology. Recovery
|
||||
replays both cuts from the destination namespace and compares the complete
|
||||
candidate bytes. Equal aggregate material alone is insufficient.
|
||||
|
||||
New checkpoints, profile changes, intervals and player reservations are refused
|
||||
at a staged destination. Its host pauses readiness and advancement, retains exact
|
||||
requests after unknown replies, renews authority and recovers the pause across
|
||||
replacement. No lease expiry, drain or timeout releases it. Explicit source
|
||||
abort atomically appends the existing immutable abort and clears both pending
|
||||
pointers. It requires no destination authority because no stock has moved.
|
||||
Stage and abort serialize on the source lease row: either staging wins then
|
||||
abort removes both pointers, or abort wins and new staging is refused. An exact
|
||||
retry of a previously staged, aborted request returns that retained outcome and
|
||||
never reopens either pointer. Destination movement before first staging requires
|
||||
explicit source abort and a new preparation, without silent rebasing.
|
||||
|
||||
Keep all staged objects and predecessor evidence after abort. Backup already
|
||||
copies immutable namespace objects and shared metadata; this is not cellular
|
||||
clone/restore qualification. The future paired publisher must recheck both
|
||||
current fences, heads, staged object bindings and unsettled request, then commit
|
||||
both results and the common receipt atomically before activation.
|
||||
|
||||
## Alternatives, risks and qualification
|
||||
|
||||
An in-memory ghost disappears on process loss. Activating the uploaded payload
|
||||
duplicates source stock. Advancing a destination after staging invalidates the
|
||||
paired candidate. Freeze the whole destination instead; the coarse pause and
|
||||
extra immutable storage are explicit costs, not a final movement latency policy.
|
||||
|
||||
Require both representations, real player-origin wildlife, full ghost replay,
|
||||
unchanged heads and stock, conflicting/duplicate requests, pending-work refusal,
|
||||
stale destination authority, replacement/restart, missing/corrupt/semantically
|
||||
false ghost evidence, ambiguous replies, process kills, stage/abort races and
|
||||
host readiness. No coupled ecology, world-cut or multigeneration claim follows.
|
||||
+3
-1
@@ -1,6 +1,8 @@
|
||||
# Architecture decision records
|
||||
|
||||
- [ADR-0147: Durable biological preparation and source freeze](0147-durable-cellular-migration-freeze.md) - schema 47 retains exact preparation/capsules and explicit abort; the source stays authoritative and paused across worker replacement. Destination staging and paired activation remain open.
|
||||
- [ADR-0148: Durable destination staging without activation](0148-durable-cellular-migration-staging.md) - schema 48 freezes the destination at its exact cut, retains a verified read-only ghost and replays it on recovery; source abort releases both pauses. Paired publication/activation remain open.
|
||||
|
||||
- [ADR-0147: Durable biological preparation and source freeze](0147-durable-cellular-migration-freeze.md) - schema 47 retains exact preparation/capsules and explicit abort; the source stays authoritative and paused across worker replacement. Paired activation remains open.
|
||||
|
||||
- [ADR-0146: Durable boundary-accounting upgrade admission](0146-durable-boundary-accounting-upgrade.md) - schema 46 extends immutable version-upgrade evidence to same-profile bundle 9->10, full upgrade replay, population batch 2 and preserved representation/interval guards; paired migration escrow remains open.
|
||||
|
||||
|
||||
@@ -16,8 +16,15 @@ uses both retained manifests and a verified destination capsule in the source's
|
||||
object namespace. Both biological heads stay unchanged; destination inspection
|
||||
is optimistic and grants no destination authority. Source publication and new
|
||||
interval/player reservations are blocked until explicit settlement. See
|
||||
[ADR-0147](../adr/0147-durable-cellular-migration-freeze.md). Destination staging,
|
||||
atomic paired result publication and activation remain required.
|
||||
[ADR-0147](../adr/0147-durable-cellular-migration-freeze.md).
|
||||
|
||||
M12.4i/schema 48 adds destination-authorized staging under ordered endpoint locks
|
||||
and the exact retained preparation/heads. A verified source capsule and derived
|
||||
destination ghost stay read-only in the destination namespace. Both roles pause
|
||||
publication, interval/player admission and host readiness across replacement.
|
||||
Explicit source abort releases both pointers atomically; stage/abort races cannot
|
||||
activate or strand stock. See [ADR-0148](../adr/0148-durable-cellular-migration-staging.md).
|
||||
Atomic paired result publication, its common receipt and activation remain required.
|
||||
|
||||
M7.1 now scopes the first implementation in [ADR-0058](../adr/0058-region-durability-contract.md)
|
||||
and [REGION_DURABILITY.md](REGION_DURABILITY.md): full checkpoint batches, not
|
||||
|
||||
@@ -70,7 +70,13 @@ destination predecessor capsule in the source namespace allows complete pair
|
||||
replay without consulting destination live state. The owning host pauses
|
||||
readiness, retains unknown requests and never treats timeout/drain as abort.
|
||||
See [the freeze contract](../../schemas/ecology/cellular-migration-freeze-v1.md).
|
||||
Destination staging, paired commit/abort races and activation remain open.
|
||||
ADR-0148/schema 48 now stages a verified destination ghost and source replay
|
||||
capsule under current destination authority and ordered endpoint locks. The
|
||||
destination head remains unchanged and is durably paused alongside the source.
|
||||
Recovery verifies the complete ghost without activating it; explicit source abort
|
||||
releases both pointers atomically. Stage/abort races serialize on source authority.
|
||||
See [the staging contract](../../schemas/ecology/cellular-migration-stage-v1.md).
|
||||
Atomic paired publication, commit/abort races and activation remain open.
|
||||
|
||||
World/region/frame are nonzero durable IDs. No ID is a Pod name. The host records
|
||||
its unique holder ID and monotonically increasing nonzero lease epoch. Exhaustion
|
||||
|
||||
@@ -140,3 +140,26 @@ and canonically encoded false member/material declarations fail complete replay.
|
||||
See [the contract](../../schemas/ecology/cellular-migration-freeze-v1.md).
|
||||
Destination staging, atomic paired head publication, commit/abort races and
|
||||
activation remain the next segment; no route or automatic migration is enabled.
|
||||
|
||||
## M12.4i durable read-only destination staging
|
||||
|
||||
ADR-0148/schema 48 freezes the destination at its exact captured head under
|
||||
current destination authority and ordered endpoint locks. The adapter restores
|
||||
both cuts, replays the retained trace, copies the source capsule into the
|
||||
destination namespace and uploads/reads back the derived destination ghost.
|
||||
Its exact digest/length is immutable retry evidence, not an ownership receipt.
|
||||
Recovery uses those local objects and compares the complete rederived ghost.
|
||||
Neither biological head moves, and the source still owns all outgoing stock.
|
||||
|
||||
Both local migration roles are exclusive and block new publication, profile
|
||||
changes, intervals and player reservations. Unknown staging retains exact bytes;
|
||||
the owning destination pauses readiness/advancement through worker replacement.
|
||||
Source abort serializes with staging and releases both pointers atomically.
|
||||
Aborted-stage retries return their old outcome and never reopen a pause.
|
||||
Missing/corrupt evidence and real but semantically false objects fail closed.
|
||||
See [the staging contract](../../schemas/ecology/cellular-migration-stage-v1.md).
|
||||
|
||||
Atomic paired publication/common receipt, commit/abort races, recovery/activation
|
||||
and linked ecology remain subsequent work. The ghost cannot run biology or
|
||||
contribute owned census/extinction stock. No biological format, rule, route,
|
||||
automatic movement, live region or deployment changes.
|
||||
|
||||
@@ -64,9 +64,12 @@ 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.
|
||||
Destination staging, atomic paired commit, commit/abort races and activation
|
||||
remain open. The destination head is only checked optimistically at preparation
|
||||
and must be rechecked before any future stage/commit.
|
||||
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. Atomic paired commit, its common
|
||||
receipt, commit/abort races and activation remain open. Preparation remains an
|
||||
optimistic destination observation; first staging rechecks both captured heads.
|
||||
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
|
||||
|
||||
@@ -32,6 +32,19 @@ the C++ decoder. The metric has one fixed unlabelled series and remains bounded.
|
||||
These are preparation/abort checks, not proof of destination activation or atomic
|
||||
paired publication; full historical persistence regression is also required.
|
||||
|
||||
M12.4i's private staging matrix covers both bundle-10 representations and actual
|
||||
player-origin wildlife. It requires unchanged biological heads, complete ghost
|
||||
replay, exact/conflicting retries, refusal of moved destination heads and pending
|
||||
intervals, publication/profile/life-reservation guards and exclusive endpoint
|
||||
roles. Stale destination epochs fail; replacement retains the read-only ghost.
|
||||
Missing source capsules, missing/same-length corrupt ghosts and valid but false
|
||||
ghost objects fail recovery. Real lock-timeout ambiguity, SIGKILL before/after
|
||||
stage commit and independent-connection stage/abort races preserve one outcome.
|
||||
The owning destination host retains exact uncertain work across restart and
|
||||
resumes only its original biology after confirmed source abort. Full schema,
|
||||
permission, backup/DR and historical regression remain required. These tests do
|
||||
not qualify paired commit, destination activation or linked ecological movement.
|
||||
|
||||
Tests defend contracts, not directory coverage. All checks remain active in
|
||||
Release builds. Current proof has no actual network, biology or distributed
|
||||
recovery, so those categories below are milestone gates rather than passing
|
||||
|
||||
@@ -1,5 +1,53 @@
|
||||
# Validation report
|
||||
|
||||
## 2026-10-18 - M12.4i durable read-only destination staging
|
||||
|
||||
ADR-0148/schema 48 retains a destination-authorized staging record and bounded
|
||||
pending pointer at the exact captured head. The adapter verifies both cuts,
|
||||
replays the trace and retains a source capsule plus verified destination ghost
|
||||
in the destination namespace. The source owns all outgoing stock; neither head
|
||||
moves. Source abort releases both pending pointers atomically, and exact stage
|
||||
retries retain their original outcome. Both migration roles are exclusive.
|
||||
|
||||
Executed locally:
|
||||
|
||||
- Native MSVC Release **78/78 passed**, 12.62 s.
|
||||
- Actual GCC 14 optional server/persistence targets rebuilt; final private
|
||||
PostgreSQL population/staging suite passed, **11 s** (8 s test phase).
|
||||
- Linux Clang 19 ASan/UBSan private population/staging suite passed, **33 s**
|
||||
(30 s test phase), with no sanitizer reports.
|
||||
- Explicit clang-tidy 19 on the adapter, owning host and PostgreSQL population
|
||||
tests passed with no owned warnings. Repository clang-format 19 and both
|
||||
changed shell scripts' syntax checks passed.
|
||||
- Complete frozen-binary private PostgreSQL qualification passed with **exit 0**,
|
||||
**501 s**: C++ integration/process/load/history (426 s), life reservations,
|
||||
backup/restore, host-loss DR, upgrade, migration history/rollback, runtime
|
||||
permission audit and checksum/future-version rejection. The detached runner
|
||||
recorded its completion code.
|
||||
|
||||
Both representations use real funded player-origin wildlife and unchanged cuts.
|
||||
Cases cover exact/conflicting retries, a moved destination, pending destination
|
||||
intervals, source/destination role exclusivity, blocked publication/profile/life
|
||||
reservations and stale destination authority. Replacement epochs retain staging.
|
||||
Missing source capsules, missing and same-length corrupt ghosts fail strong
|
||||
binding. An existing valid object with false destination biology fails complete
|
||||
replay. Real lock-timeout ambiguity retains exact requests; SIGKILL before/after
|
||||
stage commit leaves absence/a retained pause respectively. Independent database
|
||||
connections race stage against source abort without stranded destination work.
|
||||
The owning destination host pauses on unknown staging, survives drain/recreation
|
||||
without adopting the ghost and resumes its identical original state after source
|
||||
abort. The existing fixed freeze metric covers either role without new labels.
|
||||
|
||||
Limits: this is staging evidence, not a migration result or activation receipt.
|
||||
Atomic paired publication, its common immutable outcome, commit/abort races and
|
||||
recovery/activation remain open. Backup retains all immutable namespace objects;
|
||||
existing backup/DR fixtures do not qualify cellular cloning or a new cellular
|
||||
restore procedure. No elapsed-day, linked-geometry or multigeneration claim
|
||||
follows. No live database, World0, deployment, dependency, biological rule, format
|
||||
or golden changed. The earlier captured `Build_Errors.txt` and unrelated local
|
||||
work remain untracked; remote CI confirmation of the previous runner repair
|
||||
remains separate.
|
||||
|
||||
## 2026-10-18 - M12.4h durable migration source freeze and explicit abort
|
||||
|
||||
ADR-0147/schema 47 retains exact source-authorized preparation, both predecessor
|
||||
|
||||
Reference in New Issue
Block a user