Files
aevolution/docs/adr/0003-dependencies.md
T
dingoandClaude Opus 5.5 8fbe093cc8 Implement M9.6 narrow secure dev-session protocol
Add protocol v1: versioned, bounded frames (Hello, Welcome, Intent,
IntentResult, environment/organism views, Close) carrying session, epoch
and commit watermark, with an explicit little-endian canonical codec, a
header-first FrameReader, seeded mutation tests and a libFuzzer target.
SessionAdmission enforces world/region scope, grant lifetime and skew,
single-use grants, one session per subject, epoch, replay, tick window
and per-session rate.

Dev identity is a 108-byte HMAC-SHA256 grant (PSA) that cannot be
created or verified outside the dev environment. Transport security is
TLS 1.3 only via pinned Mbed TLS 4.1.1 LTS with TLS 1.2, DTLS, tickets
and PSK compiled out, AEAD suites, ECDHE groups and a pinned dev CA.
Opt-in EVO_BUILD_NETWORK, new network CI suite. Sockets and region
integration follow in M9.7. ADR-0082 records the decision.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-01 18:53:55 -04:00

1.8 KiB

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, 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. M9.6's ADR-0082 accepts a scoped explicit-source, SHA-256-pinned Mbed TLS 4.1.1 build for the opt-in dev session protocol (EVO_BUILD_NETWORK).