donaldfilimon/abi / .agents/skills/wdbx
wdbx
VerifiedPlan 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
../wdbxtogether withabi-compute,abi-foundation,abi-core, andabi-telemetry;abiconsumes 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), andabi'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 indocs/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 smoke | wdbx-roundtrip |
Serve loopback REST (abi wdbx api serve) | wdbx-api-serve |
| In-process Raft consensus demo / cluster serve | wdbx-cluster-serve, cluster-demo-guide |
| Benchmark | wdbx-bench |
abi wdbx secure demo (quant / Huffman / autoencoder / HE / FHE) | secure-demo |
| Persistence (WAL / segments / recovery) deep-dive | abi-wdbx-persistence |
| Superpower deep-dives | abi-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_TOKENfor bearer auth). TLS env vars are validated but native TLS is not linked — deploy behind a TLS-terminating proxy.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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 implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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 always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |