3.5 KiB
Cellular region batch trace 4: retained offspring plans
Authority: ADR-0166. This is a portable raw-owner trace, paired exclusively with owner format 8/rules 10. Portable bundle 12 names this raw checkpoint; existing SQL bundles and population traces do not admit it. The default cellular trace remains format 3. Formats 1-3 keep their successful canonical bytes and earlier biological meanings.
All integers are little-endian. The layout is identical to trace 3 except the format field is 4:
| Offset | Bytes | Field |
|---|---|---|
| 0 | 8 | Magic EVLCBT01 |
| 8 | 4 | Format 4 |
| 12 | 4 | Raw cellular profile discriminator 4 |
| 16 | 24 | World, region and frame, three u64s |
| 40 | 16 | Nonzero predecessor commit |
| 56 | 32 | Nonzero predecessor manifest digest |
| 88 | 16 | Begin/end ticks, two u64s |
| 104 | 4 | Tick count, 1 through 64, exactly end minus begin |
| 108 | 4 | Reserved zero |
| 112 | variable | Complete consecutive tick records |
Each tick starts with u32 counts for life intentions, allocator births and mutation selections, then a zero u32. Arrays follow in that order: existing 24-byte intentions, 40-byte births and 40-byte selections. A selection records life, event index, offer tick and reserved successor ID as u64s, operator as u16 and six zero bytes. Operator zero declines. Inputs contain no trusted biological outcome, child genome payload, construction price or parent body replacement.
Use the existing per-tick life bounds and max_cellular_batch_bytes; check every
encoded count against remaining bytes before allocation. Refuse unknown formats,
reserved bits, unordered/duplicate keys, cross-tick allocator identity or birth
account reuse, cross-selection successor reuse, truncation and trailing bytes.
The codec and in-memory replay enforce the same version-specific payload shape:
trace 1 has no births/selections; trace 2 has no selections.
Replay binds world/region/frame/begin tick to the predecessor and restores a
detached owner. Only trace 4 with owner 8/rules 10 is accepted; both cross-version
directions refuse before execution, including both action matchers. Apply the
normal rules-10 step, selections and funded budding, then allocator-authorized
primitive births. Existing phase ordering and closure remain mandatory. A later
failed tick/birth returns no candidate or partial mutation outcomes; the input
owner stays byte-identical. Successful outcomes are derived in tick/life order.
The new offspring_plan_applied enum value is 4; historical values remain 0-3.
This derived result is not admitted by the old durable result-byte contract.
Canonical movement and mutation action blocks retain their existing layouts. They must match the authenticated predecessor account/life and exact recorded input. Mutation selections must match the standing offer's event, tick, operator and inherited plan, even when that plan differs from the expressed genome. Offers first earned inside the batch cannot be authorized by that predecessor. Allocator authority and exact successor reservation binding still belong to the eventual durable publisher; these portable functions do not grant them.
Before publication, a later bundle must bind manifests, input digests, actions, reservations, replayed results and the entire final checkpoint under the proper head/lease fence, with retained-source upgrade and crash/retry qualification. Merely decoding trace 4 grants no database, worker, migration or census admission.