Durable why decisions for github.com/fastygo/context. Implementation
detail lives in code; how-to lives in docs/.
Related
| Document | Role |
|---|---|
| docs/README.md | User/LLM navigation |
.project/roadmap-context-core.md |
Architecture baseline |
.project/future-layer.md |
Deferred layers |
| decisions/ (here) | Normative ADRs |
When ADR wording and a planned roadmap disagree on stack order, follow the active roadmap note and publish a superseding ADR if needed.
Status: closed — ADR-0015–0021 (and later Lab-ready ADRs through 0027).
| Topic | ADR |
|---|---|
| Multilingual linguistic contracts | 0015 |
| Lexicographic contracts | 0016 |
| PoC backend order | 0017 |
| Identity and spans | 0018 |
| Retrieval scoring | 0019 |
| ContextPack budget | 0020 |
| Snapshot commit failure | 0021 |
| ADR | Title | Status |
|---|---|---|
| 0001 | Package boundary: internal-first | Accepted |
| 0002 | Metadata store progression | Accepted |
| 0003 | Artifact store progression | Accepted |
| 0004 | Vector namespace abstraction | Accepted |
| 0005 | Model adapters fake-first | Accepted |
| 0006 | Trace event append-only replay | Accepted |
| 0007 | Embedded KV intermediate layers | Accepted |
| 0008 | Hybrid index architecture | Accepted |
| 0009 | context-sparse / Tantivy sidecar | Accepted |
| 0010 | Local/cloud deployment parity | Accepted |
| 0011 | Merkle manifest and snapshot namespace | Accepted |
| 0012 | Index snapshot sync / replication | Accepted |
| 0013 | ContextRef and path alias | Accepted |
| 0014 | Storage role separation | Accepted |
| 0015 | Multilingual linguistic contracts | Accepted |
| 0016 | Lexicographic context contracts | Accepted |
| 0017 | PoC backend order | Accepted |
| 0018 | Deterministic identity and spans | Accepted |
| 0019 | Phase 1 retrieval scoring | Accepted |
| 0020 | ContextPack budget and evidence | Accepted |
| 0021 | Snapshot commit failure semantics | Accepted |
| 0022 | Structured artifact schema identity | Accepted |
| 0023 | Lineage and temporal source metadata | Accepted |
| 0024 | Thin HTTP service boundary | Accepted |
| 0025 | Multi-tenant isolation boundary | Accepted |
| 0026 | Public API v1 compatibility freeze | Accepted |
| 0027 | Lab gate freeze | Accepted |
| 0028 | Source tombstones for soft delete | Accepted |
| 0029 | Snapshot bundle export/import | Accepted |
| 0030 | Project export and delete retention hooks | Accepted |
| 0031 | Durable schedule port for background jobs | Accepted |
| 0032 | Index lifecycle explain report | Accepted |
| 0033 | Offset-stable snippet / highlight contract | Accepted |
| 0034 | Tool side-effect approval baseline | Accepted |
| 0035 | Prompt-injection threat fixtures | Accepted |
| 0036 | Intentional reranker path | Accepted |
| 0037 | Public language adapter testkit | Accepted |
| 0038 | S3 thin in-repo adapters | Accepted |
| 0039 | S3 freeze-defer A6/A8/A9/A10 | Accepted |
| 0040 | Graph remains a consumer projection (C9) | Accepted |
| 0041 | Query AST deferred; FTS + filters (C10) | Accepted |
| 0042 | Stabilization Gate closed | Accepted |
| 0043 | In-repo context-lang-ru + operator query layer | Accepted |
- Copy the numbering scheme (
00NN-slug.md). - State context, decision, consequences (positive/negative/follow-ups).
- Link from this index.
- Prefer updating docs/ how-to when behavior is user-visible.