Decision records (ADRs)
Every significant, hard-to-reverse decision is captured as a short, numbered Architecture Decision Record so future readers understand why the system is shaped the way it is. ADRs are immutable once Accepted; we supersede rather than edit, and numbers are never reused.
Browse the full set in the repository:
docs/adr/ (the
index lists
every record with its status).
Key records by theme
Foundations
- 0001 Language & workspace · 0004 On-disk format · 0005 Durability & crash recovery · 0006 Concurrency
Indexing & storage
- 0007 Index roadmap · 0008 Quantization · 0019 Disk-resident index · 0020 Row-addressed segments
- Incremental updates: 0023 IVF · 0026 HNSW · 0033 graph FreshDiskANN · 0025 durable on-disk index
- Multi-vector: 0028 late interaction · 0034 follow-ups
Security
- 0010 Envelope encryption & AEAD · 0011 AuthN/Z & tenancy · 0012 Client-side payload encryption
- Vector encryption: 0031 DCPE · 0032 client-side opaque vectors · 0035 docs site + DCPE hardening
Platform & integration