Architecture

Memory is a substrate, not a chat log.

Layered HNSW, MVCC, content addressing. Integrity of storage is not truth of the record.

Configuration facts

The active substrate is the Rust tree extracted from donaldfilimon/abi on 2026-08-22 with history preserved. Crate names keep the abi- prefix deliberately. ABI owns this layer.

Engine: Layered HNSW. Concurrency: MVCC. M=16, EF_CONSTRUCTION=40, EF_SEARCH=32, cosine metric, content-addressed. Sharding is not established.

What it does not prove

Storage integrity does not prove the truth of stored statements. Signatures and causal history answer why a record is trusted. Hybrid ranking currently collapses several axes into one score — that is a documented limitation, not a product claim.

Reference cluster replication exists in source. It does not establish production multi-host operation.

  • WDBX substrate

    Rust substrate README. Configuration facts, not a hosted database or a recall scoreboard.

  • ABI README

    Source description, tool commands and stated limitations; not a reproduced test run.

Checked against these sources on .

Architecture

WDBX retrieval

WDBX is the Weighted Directed Backtrace eXecution store. It keeps context as weighted paths so retrieval can be inspected, not just ranked: key-value, vector, and block surfaces, with snapshot persistence guarded by SHA-256 integrity checks.

Weighted backtrace paths

Partial

Hybrid retrieval exposes its score components. The score still collapses several axes; separate evidence-weighted ranking is planned.

HNSW vector search

Current

Cosine nearest-neighbor through the active Rust substrate's layered HNSW index (M=16, EF_CONSTRUCTION=40, EF_SEARCH=32).

Durable snapshots

Current

Snapshots with CRC-framed WAL recovery and checkpoints. Snapshot-chain and strict content verification are separate checks.

Switchable persistence

Current

The local store defaults to $HOME/.abi/wdbx; ABI_WDBX_PERSIST=0 disables persistence for evaluation runs.

Read the paper: WDBX weighted-backtrace store