Files
aevolution/docs/adr/0003-dependencies.md
T
dingoandClaude Opus 5.5 5d4f59f901 Implement M7.4a checkpoint publication and verified recovery
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>
2026-09-28 15:25:27 -04:00

1.5 KiB

ADR-0003: Dependency adoption and package management

Status

Dependency-free proof adopted; vcpkg manifest proposed at first dependency gate.

Context

Cross-platform reproducibility must not require assembling unrelated frameworks.

Decision

Standard library only initially. Compare vcpkg exact registry baseline/overrides with Conan2 lockfiles using one compiled dependency; measure cold/warm/offline builds, binary size, transitive licenses and update workflow.

Alternatives Considered

Conan provides profiles/revision locks with recipe maintenance; vcpkg fits CMake/Windows but baseline/features need care; FetchContent is not full transitive governance.

Benefits

No-download proof; real workload supplies manager evidence.

Costs

Measured integration gate before adoption.

Risks

Mutable tags, ranges, stale caches, transitive licenses and fictitious generated APIs.

Consequences

Record revision/hash, owner, license, build options and removal boundary; mirror release artifacts. No empty manifests/fake pins. vcpkg, Conan.

M7.2's ADR-0059 accepts a scoped checksum-pinned source build for the paired PostgreSQL server/client. The general cross-platform package-manager comparison remains open. M7.4's ADR-0061 links system OpenSSL 3 libcrypto (already required by libpq TLS) for SHA-256 in the Linux persistence adapter only.