# Architecture decision records

Documentation version: 0.3.1.

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](https://sourceorrery.ai/decisions/0001-rust-core-owns-semantics/) | [The Rust core owns all secret-management semantics](https://sourceorrery.ai/decisions/0001-rust-core-owns-semantics/) | accepted | 2026-10-20 |
| [0002](https://sourceorrery.ai/decisions/0002-encrypted-sqlite-vault-with-os-protected-key/) | [Encrypted SQLite vault with the key in the OS credential store](https://sourceorrery.ai/decisions/0002-encrypted-sqlite-vault-with-os-protected-key/) | accepted | 2026-10-20 |
| [0003](https://sourceorrery.ai/decisions/0003-primitives/) | [XChaCha20-Poly1305, Argon2id, random nonces](https://sourceorrery.ai/decisions/0003-primitives/) | accepted | 2026-10-20 |
| [0004](https://sourceorrery.ai/decisions/0004-latest-accessible-version/) | [get_secret without a version returns the newest accessible version](https://sourceorrery.ai/decisions/0004-latest-accessible-version/) | accepted | 2026-10-20 |
| [0005](https://sourceorrery.ai/decisions/0005-read-only-sdks/) | [Language SDKs only read](https://sourceorrery.ai/decisions/0005-read-only-sdks/) | accepted | 2026-10-20 |
| [0006](https://sourceorrery.ai/decisions/0006-binding-technologies/) | [One binding technology per language](https://sourceorrery.ai/decisions/0006-binding-technologies/) | accepted | 2026-10-20 |
| [0007](https://sourceorrery.ai/decisions/0007-versioning-and-compatibility/) | [Versioning and compatibility](https://sourceorrery.ai/decisions/0007-versioning-and-compatibility/) | accepted, amended for 0.3.0 | 2026-10-22 |
| [0008](https://sourceorrery.ai/decisions/0008-remote-providers/) | [Remote providers behind the same contract](https://sourceorrery.ai/decisions/0008-remote-providers/) | accepted | 2026-10-23 |
| [0009](https://sourceorrery.ai/decisions/0009-local-vaults-checks-and-storage/) | [Local vaults, an optional view check, and storage per secret](https://sourceorrery.ai/decisions/0009-local-vaults-checks-and-storage/) | accepted | 2026-10-24 |
| [0010](https://sourceorrery.ai/decisions/0010-authenticated-key-wraps-and-private-files/) | [Authenticated key wraps, schema 5, and private key files](https://sourceorrery.ai/decisions/0010-authenticated-key-wraps-and-private-files/) | accepted | 2026-10-25 |
| [0011](https://sourceorrery.ai/decisions/0011-provider-writes-fail-closed/) | [Provider writes fail closed, and say when they may have happened](https://sourceorrery.ai/decisions/0011-provider-writes-fail-closed/) | accepted | 2026-10-25 |

The records live in [`docs/adr/`](https://github.com/Netizine/sourceorrery/blob/main/docs/adr) in the repository.
