Files
aevolution/docs/adr/0003-dependencies.md
T
2026-10-08 12:08:53 -04:00

45 lines
1.8 KiB
Markdown

[Reviewed]
# ADR-0003: Dependency adoption and package management
## Status
Dependency-free proof adopted; general package-manager comparison remains open.
ADR-0077 accepts a scoped explicit-source SDL dependency for M9 only.
## 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](https://learn.microsoft.com/en-us/vcpkg/concepts/manifest-mode), [Conan](https://docs.conan.io/2/tutorial/versioning/lockfiles.html).
M7.2's [ADR-0059](0059-postgresql-bootstrap.md) 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](0061-checkpoint-publication.md)
links system OpenSSL 3 libcrypto (already required by libpq TLS) for SHA-256 in the
Linux persistence adapter only. M9.6's [ADR-0082](0082-dev-session-transport.md)
accepts a scoped explicit-source, SHA-256-pinned Mbed TLS 4.1.1 build for the opt-in
dev session protocol (`EVO_BUILD_NETWORK`).