Skip to content

donaldfilimon/abi / .agents/skills/wdbx

Plan abi WDBX vector-store work — in-process KV+vector store, HNSW, WAL/segment persistence, loopback cluster RPC, REST serve, bench, and reference-grade secure demos. Use when asked about wdbx, vector search, persistence, clustering, or the secure demo. Routes to wdbx-roundtrip/api-serve/cluster-serve/bench, secure-demo, abi-superpower-wdbx*, and abi-wdbx-persistence. Demos are reference-grade, NOT production FHE/AES/sharding.

WDBX moved out of this repository on 2026-08-22. It now lives in the sibling repo ../wdbx together with abi-compute, abi-foundation, abi-core, and abi-telemetry; abi consumes them by relative path. Source paths below therefore read ../wdbx/crates/.... Run WDBX-only tests from that repo (./tools/cargo.sh test --locked --manifest-path ../wdbx/Cargo.toml --workspace < /dev/null, run from the abi checkout), and abi's gate (./tools/check.sh) from here.

Under the Abbey System Constitution (docs/superpowers/specs/2026-08-22-abbey-system-constitution.md) WDBX is the provenance-aware episodic substrate, not a vector store. Most of the evidence half of its specification is unimplemented; the measured gap list is in docs/superpowers/specs/2026-08-22-wdbx-conformance-gap-analysis.md. Do not describe an episodic capability as Current on the strength of the vector-store features that do exist.

wdbx

Entry point for abi's WDBX vector store (../wdbx/crates/abi-wdbx/src/). Routes:

You want to…Use
Insert→query round-trip smokewdbx-roundtrip
Serve loopback REST (abi wdbx api serve)wdbx-api-serve
In-process Raft consensus demo / cluster servewdbx-cluster-serve, cluster-demo-guide
Benchmarkwdbx-bench
abi wdbx secure demo (quant / Huffman / autoencoder / HE / FHE)secure-demo
Persistence (WAL / segments / recovery) deep-diveabi-wdbx-persistence
Superpower deep-divesabi-superpower-wdbx, -wdbx-cluster, -wdbx-compute, -wdbx-secure

Honest boundaries (from docs/contracts/external-claims-audit.mdx §WDBX)

  • Real: in-process KV + vector store, HNSW, SIMD cosine, MVCC snapshots, WAL/segment checkpoints, loopback Raft RPC (RequestVote/AppendEntries), int8 quantization, order-0 Huffman, in-process autoencoder, additive HE, DGHV somewhat-HE (reference parameters).
  • NOT production multi-host distributed deployment or data sharding.
  • NOT production-secure or bootstrapped full FHE; no AES/RBAC WDBX storage.
  • NOT a production / learned-SOTA compression codec.
  • Non-loopback bind refuses without ABI_WDBX_CLUSTER_TOKEN; REST is 127.0.0.1-only (ABI_WDBX_REST_TOKEN for bearer auth). TLS env vars are validated but native TLS is not linked — deploy behind a TLS-terminating proxy.
receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 322kUpdated Claude CodeCodexVerifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 322kUpdated Claude CodeCodexVerifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 322kUpdated Claude CodeCodexVerifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 322kUpdated Claude CodeCodexVerifiedInstall