Skip to content

Architecture decision records

The decisions made so far, each with its context, the decision itself and its consequences.

1 min read

Each record states the context, the decision and its consequences. Records are numbered in the order they were accepted and are not rewritten once accepted; a later record supersedes an earlier one explicitly.

# Decision Status Date
0001 The Rust core owns all secret-management semantics accepted 2026-10-20
0002 Encrypted SQLite vault with the key in the OS credential store accepted 2026-10-20
0003 XChaCha20-Poly1305, Argon2id, random nonces accepted 2026-10-20
0004 get_secret without a version returns the newest accessible version accepted 2026-10-20
0005 Language SDKs only read accepted 2026-10-20
0006 One binding technology per language accepted 2026-10-20
0007 Versioning and compatibility accepted, amended for 0.3.0 2026-10-22
0008 Remote providers behind the same contract accepted 2026-10-23
0009 Local vaults, an optional view check, and storage per secret accepted 2026-10-24
0010 Authenticated key wraps, schema 5, and private key files accepted 2026-10-25
0011 Provider writes fail closed, and say when they may have happened accepted 2026-10-25

The records live in docs/adr/ (opens in a new tab) in the repository.