abi-wdbx
Episodic store, HNSW graph, query path, and persistence contracts.
WDBX
Memory is not a lookup.
A vector database can retrieve similar content. An episodic substrate must also preserve context, causal dependencies, outcomes, versions, constraints, and evidence — so a later query can ask what happened, what was predicted, what was done, what followed, and why this record is trusted.
CurrentStructural substrate is in source. Evidence-weighted retrieval is planned.
Capabilities
Implemented structure. Honest gaps.
Status is measured against the source, not against a product name. Storage integrity does not establish truth. The reference cluster protocol does not establish production sharding.
| Concern | What exists | Status |
|---|---|---|
| Blocks / segments | On-disk segment format, CRC-framed WAL, checkpoint publication and salvage | Current |
| Embeddings / search | Exact and layered HNSW, ordered vector search, 3-D spatial index | Current |
| Metadata | Block metadata round-tripping, versioning, access and execution state in records | Current |
| Relationships | Multi-parent causal audit DAG | Current |
| Provenance | SHA-256 content addressing, Ed25519 signing, deterministic CBOR envelopes | Current |
| Retrieval | Hybrid ranking contracts; score currently collapses several axes | Partial |
| Evidence-weighted rank | Separate semantic, temporal, causal, and persona signals | Planned |
| Distributed operation | Cluster replication with read repair in source; not production sharding | Experimental |
| Trust / federation | Local deterministic replay tests. Not deployed federation evidence. | Research |
| Hosted service | Nothing in the repository provides production authority | Planned |
Configuration
Facts from the active crate.
Not latency, not recall, not QPS. Graph construction parameters as the Rust tree sets them.
Measured
- Engine
- Layered HNSW
- Concurrency
- MVCC
- M
- 16
- efConstruction
- 40
- efSearch
- 32
- Metric
- Cosine
- Addressing
- Content-addressed
- Sharding
- Not established
Crates
The substrate ABI owns.
abi-compute
CPU vector ops and optional macOS Metal DOT. CUDA/Vulkan not linked here.
abi-foundation
Shared primitives: identifiers, hashing, time, error types.
abi-core
Episode types, witness encoding, causal DAG helpers.
abi-telemetry
Local traces and capability reporting. Not a hosted metrics product.
Crate names keep the abi- prefix deliberately. ABI owns this layer. The repository provides source, not a hosted database. Extracted from donaldfilimon/abi on 2026-08-22 with history preserved. A Python witness encoder at tools/abbey_cbor_episode_v1.py agrees on golden vectors for abbey-cbor-episode-v1.