ADR-0061 publishes environmental-v1 full checkpoints. Manifest v1 is a fixed 280-byte record (identity, chain, lease, versions, build, zero RNG/history declarations, durability policy, payload length/SHA-256) that PostgreSQL parses and digests itself. Schema v3 adds region_commits with a digest CHECK and a composite head FK, owner-managed retained builds, fenced publish/load functions and owner-only genesis; it drops the bare v2 head kernel and fails closed while v2 heads exist. Linux evo::region_store adds OpenSSL SHA-256, an immutable content-addressed filesystem object store (temp+fsync+link, no overwrite/delete, O_NOFOLLOW exact-length verified reads), and publication (validate -> upload -> read back -> fenced transaction -> receipt check) and recovery (re-digest, allowlist, verify, full restore). Portable evo::region_checkpoint holds the codec and payload validation. Validated: Windows CTest 56/56; WSL Release, clang-tidy and ASan/UBSan private-PostgreSQL suites; four SQL and one host mutation each caught. M7.4 stays open for 7.4b (lineage archive codec and history binding). No Docker/Gitea CI, remote store, process kill or deployment. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
75 lines
6.0 KiB
Markdown
75 lines
6.0 KiB
Markdown
# Architecture decision records
|
||
|
||
- [ADR-0058: Region durability contract](0058-region-durability-contract.md) - accepted M7.1 full checkpoint batches and explicit state closure; storage implementation follows.
|
||
|
||
- [ADR-0057: Environmental interval scheduling](0057-environmental-interval-scheduling.md) - accepted M6.7 bounded explicit intervals and committed-prefix results.
|
||
|
||
- [ADR-0056: Environmental terminal decay](0056-environmental-terminal-decay.md) - accepted for M6.6 retained corpses, bounded decay and rules/envelope v2.
|
||
|
||
Locked requirements outrank these records. Review architecture, ADRs, public
|
||
contracts, tests, then implementation. Stop expanding implementation on conflict.
|
||
|
||
**Adopted for proof** applies only to the bounded initial headless slice.
|
||
**Proposed** recommends without adopting a dependency. **Deferred** requires a
|
||
named experiment. Later **Accepted** and **Superseded** preserve rationale.
|
||
Proof choices do not silently settle gameplay or production infrastructure.
|
||
|
||
Records 0001–0015 cover language, build, dependencies, tests/benchmarks, ECS,
|
||
ticks, randomness, serialization, units, errors, threads, logging, PostgreSQL,
|
||
messaging and metrics. 0016–0019 cover durability/ownership, networking/security,
|
||
infrastructure and voxels. 0020 scopes Gitea delivery and the stateless dev Job.
|
||
Each record has the eight required sections.
|
||
0021 authorizes the opt-in ECS comparison only, not a production dependency.
|
||
0022 adopts the bounded sequential lifecycle-command scheduler for the proof.
|
||
0023 defines local periodic neighborhood queries and a measured linear baseline.
|
||
0024 adopts finite, typed energy/matter inventory transfers for M2.1.
|
||
0025 scopes finite capture, growth recipes and residual accounting for M2.2.
|
||
0026 adds shared community ownership and bounded synthetic feeding for M2.3.
|
||
0027 adds terminal inventory ownership and budgeted nutrient return for M2.4.
|
||
0028 adopts funded reproduction, bounded slot capacity and retained lineage IDs.
|
||
0029 scopes the deterministic ecosystem driver and bounded measured episodes.
|
||
0030 adopts the immutable genome v1 record, validation and canonical encoding.
|
||
0031 adopts deterministic development, derived phenotype and bounded plans.
|
||
0032 derives non-uniform metabolic budgets and the first genome/ledger path.
|
||
0033 adopts the bounded mutation catalog and uniform seeded candidate draws.
|
||
0034 adopts the permanent lineage archive and absence that is never extinction.
|
||
0035 derives strategies from genomes and measures them over a split-half gradient.
|
||
0036 defines the tier 2 cohort, its declared resolution and exclusive ownership.
|
||
0037 collapses individuals into a cohort as one sampled, ledger-exact transaction.
|
||
0038 accounts a proposed interval, refusing rather than clamping, without picking a model.
|
||
0039 materializes representatives on shares that round down and ages that never fall.
|
||
0040 measures what aggregation costs and refuses to call the result equivalence.
|
||
|
||
Every dependency adoption records exact version/commit and integrity hash,
|
||
transitive license obligations, maintenance/security review, owner and removal
|
||
boundary. Candidate performance and binary-size comparisons are hypotheses until
|
||
benchmarked. Primary sources were reviewed during the initial September 2026
|
||
design. No unadopted candidate is a link dependency of the proof.
|
||
|
||
- [ADR-0041: Aggregate cost and fidelity budget](0041-aggregate-budget.md) - M4.6 measurement only.
|
||
|
||
- [ADR-0042: Local voxel contract](0042-local-voxel-contract.md) - accepted for M5.1; layout and planet mapping deferred.
|
||
|
||
- [ADR-0043: Bounded chunk layout](0043-chunk-layout.md) - accepted for M5; 16-cube uniform/palette/dense geometry.
|
||
|
||
- [ADR-0044: Abiotic generation](0044-abiotic-generation.md) - accepted for M5.3 synthetic integer base, version retention and material table.
|
||
|
||
- [ADR-0045: Bounded chunk ownership](0045-bounded-chunk-ownership.md) - accepted for M5.4 local memory, revision tokens and dirty eviction guards.
|
||
|
||
- [ADR-0046: Transactional excavation](0046-transactional-excavation.md) - accepted for M5.5 atomic local volume transfers and bounded exact-request replay.
|
||
|
||
- [ADR-0047: World codecs](0047-world-codec.md) - accepted for M5.6 bounded canonical snapshots and detached edit-journal replay.
|
||
|
||
- [ADR-0048: Local publication](0048-local-publication.md) - accepted for M5.7 single-writer snapshot/journal publication and recovery.
|
||
- [ADR-0049: Bounded world proof](0049-bounded-world-proof.md) - accepted for M5.8 restart regression and cost evidence.
|
||
- [ADR-0050: Environmental units and coupling](0050-environmental-units-and-coupling.md) - accepted for M6's bounded habitat/accounting contract; no field storage or terrain conversion yet.
|
||
- [ADR-0051: Optional environmental fields](0051-optional-environmental-fields.md) - accepted for M6.2 finite sparse pages, local transfers and field snapshot v1.
|
||
- [ADR-0052: Environment views](0052-read-only-environment-views.md) - accepted for M6.3 bounded read-only footprint queries and freshness validation.
|
||
- [ADR-0053: Atomic environmental transfers](0053-atomic-environmental-transfers.md) - accepted for M6.4 tagged resource ownership, atomic local batches and bounded exact retries.
|
||
- [ADR-0054: M6.5 source persistence prerequisite](0054-m65-source-persistence-prerequisite.md) - accepted: coupled codec brought forward into M6.5; M6.5a implemented, rate/biology envelope follows.
|
||
- [ADR-0055: Environmental process contract](0055-environmental-process-contract.md) - accepted M6.5b synthetic conversions, source interval policy and process checkpoint boundary; implementation follows in M6.5c.
|
||
|
||
- [ADR-0059: PostgreSQL bootstrap](0059-postgresql-bootstrap.md) - accepted for M7.2 optional adapter, pinned server/client, migrations and Secret boundary.
|
||
- [ADR-0060: Fenced region ownership](0060-fenced-region-ownership.md) - accepted for M7.3 database-time leases, guarded head advance, runtime grants and selected timings.
|
||
- [ADR-0061: Checkpoint publication](0061-checkpoint-publication.md) - accepted for M7.4a manifest v1, immutable filesystem objects, OpenSSL SHA-256 and verified recovery.
|