Architecture decision records
The decisions made so far, each with its context, the decision itself and its consequences.
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.