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>
44 lines
1.8 KiB
Markdown
44 lines
1.8 KiB
Markdown
# 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`).
|