d803bfe2b1
git-subtree-dir: vendor/ruvector git-subtree-split: b64c21726f2bb37286d9ee36a7869fef60cc6900
1.0 KiB
1.0 KiB
ADR-CE-003: PostgreSQL + Ruvector Unified Substrate
Status: Accepted Date: 2026-01-22 Parent: ADR-014 Coherence Engine Architecture
Context
The coherence engine requires:
- Transactional authority for governance data (policies, witnesses, lineage)
- High-performance vector/graph operations for coherence computation
- Audit trail with deterministic replay
Decision
PostgreSQL + ruvector as unified substrate.
| Layer | Storage | Purpose |
|---|---|---|
| Governance | PostgreSQL | Policy bundles, witnesses, lineage (ACID) |
| Coherence | ruvector | Node states, edges, HNSW index, residuals |
| Audit | PostgreSQL | Event log with signatures |
Consequences
Benefits
- PostgreSQL: Battle-tested ACID for governance
- ruvector: Optimized for vector similarity and graph traversal
- Clear separation of concerns
Risks
- Two systems to maintain
- Cross-system consistency requires careful transaction handling
References
- ADR-014: Coherence Engine Architecture, Section 13