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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.8 KB |
SKILL.md
View on GitHub---
name: wdbx
description: 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 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_TOKEN` for 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: 323k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 323k | 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: 323k | 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: 323k | Updated | Claude CodeCodex | Verified | Install |