source

Architecture Decision Records

ADRs document load-bearing design decisions behind Ardur's runtime, protocol, and deployment shape. Each record captures the context, the decision, and the trade-offs known at the

ADRs document load-bearing design decisions behind Ardur’s runtime, protocol, and deployment shape. Each record captures the context, the decision, and the trade-offs known at the time of writing.

ADRs are migrated from the private research repo with the two-pass cleanup applied (sensitive-reference scrub, then historical-codename rename). Decision dates reflect when the decision was originally made; the migration preserves chronology even though the public repo is newer.

Public-surface import caveat. Each ADR body was written in a private context and may reference implementation symbols (e.g., passport.verify_passport, GovernanceProxy._load_verified_session), internal review artifacts (e.g., “PR #10”, “finding #3 from the 2026-04-21 review”), or helper scripts (install_hook.sh) that live in the private research repo and have not yet landed in this public repo. When you see such a reference, treat it as a pointer to future work: the underlying code and the issue/PR history land alongside the Phase 1 code lift per docs/public-import-plan.md . Contributors cannot verify those referenced artifacts from the public tree today.

Index

#TitleStatusDate
015Production-grade SPIRE deployment design for KubernetesProposed2026-04-19
016Delegation lineage hash indexAccepted2026-04-21
017Biscuit attenuation narrowing semanticsProposed2026-04-21
018Delegation lineage hash domain unificationProposed2026-04-21
019Parent-token anchors against trusted lineageProposed2026-04-21
020Persisted-session reverification on loadProposed2026-04-21
021KB-JWT server-challenged nonceProposed2026-04-21

Conventions

  • Status: Proposed, Accepted, Superseded by ADR-NNN, Deprecated. A Proposed status means the design is documented but not yet landed in code; it can still change.
  • Numbering: sequential, no gaps. The formal ADR-file practice began at ADR-015 in the private research repo; earlier design decisions were captured in running decision logs rather than individual ADR files. Public numbering preserves the original sequence so cross-references stay stable.
  • Scope: ADRs record decisions about the protocol (MCEP), the runtime (Ardur), and deployment shapes. They do not duplicate spec content — the v0.1 specs live in docs/specs/ .