Architecture Decision Records document significant architectural decisions made during the development of Samyama Graph Database. Each ADR captures the context, decision, consequences, and alternatives considered.
# ADR-XXX: Title
## Status
[Proposed | Accepted | Deprecated | Superseded]
## Date
YYYY-MM-DD
## Context
What is the issue we're facing? What factors are at play?
## Decision
What decision did we make?
## Consequences
What becomes easier or more difficult because of this decision?
## Alternatives Considered
What other options did we evaluate?
## Related Decisions
Links to related ADRs| ADR | Title | Status | Date |
|---|---|---|---|
| 001 | Use Rust as Primary Programming Language | Implemented | 2025-10-14 |
| 002 | Use RocksDB for Persistence Layer | Implemented | 2025-10-14 |
| 003 | Use RESP Protocol for Network Communication | Implemented | 2025-10-14 |
| 004 | Use Raft Consensus for Distributed Coordination | Implemented | 2025-10-14 |
| 005 | Use Cap'n Proto for Zero-Copy Serialization | Superseded | 2025-10-14 |
| 006 | Use Tokio as Async Runtime | Implemented | 2025-10-14 |
| 007 | Use Volcano Iterator Model for Query Execution | Implemented | 2025-10-14 |
| 008 | Use Namespace Isolation for Multi-Tenancy | Implemented | 2025-10-14 |
| 009 | Graph-Aware Partitioning for Distributed Mode | Proposed (stub) | 2025-10-14 |
| 010 | Use Prometheus + OpenTelemetry for Observability | Enterprise only | 2025-10-14 |
| 011 | Implement Cypher CRUD Operations (DELETE, SET, REMOVE) | Implemented | 2025-12-27 |
| 012 | Late Materialization with NodeRef/EdgeRef | Implemented | 2025-12-15 |
| 013 | PEG Grammar with Atomic Keyword Rules | Implemented | 2025-12-20 |
| 014 | EXPLAIN and PROFILE Query Plan Visualization | Implemented | 2026-02-16 |
| 015 | Graph-Native Query Planning | Implemented | 2026-03-06 |
| 016 | Billion-Node Distributed Architecture | Proposed | 2026-03-23 |
- Propose: ADR drafted and reviewed by team
- Accept: ADR approved and implemented
- Deprecate: Decision no longer recommended but still in use
- Supersede: Decision replaced by a newer ADR
Maintained by: Samyama Graph Database Team Last Updated: 2026-03-23