Skip to content

donaldfilimon/abi / .agents/skills/abi-superpower-wdbx

abi-superpower-wdbx

Verified

WDBX vector store operations superpower. Includes insert, query, stats, compaction, secure demos, and REST API.

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.

ABI Superpower: WDBX

Exposes WDBX vector store as a superpower for opencode.

Actions

insert

Initialize a store and append a block:

abi wdbx db init ./data
abi wdbx block insert ./data abbey '{"note":"text to embed"}'

query

Semantic/persona-scoped retrieval:

abi wdbx query ./data "search text" abbey

stats

Show store statistics:

abi wdbx query ./data

compact

Retain newest segments:

abi wdbx db compact ./data 5

benchmark

Insert/search timing:

abi wdbx benchmark 1000

secure

Run compression + homomorphic demo:

abi wdbx secure demo

cluster

Consensus demo or serve:

abi wdbx cluster demo 3
abi wdbx cluster serve 8090 node1 127.0.0.1

api

Serve REST API:

abi wdbx api serve 8081

Implementation

Maps to:

  • ../wdbx/crates/abi-wdbx/src/store.rs - Store, search(), putVector()
  • ../wdbx/crates/abi-wdbx/src/segments.rs - compaction, checkpoints
  • ../wdbx/crates/abi-wdbx/src/rest.rs - REST server
  • ../wdbx/crates/abi-wdbx/src/cluster_rpc.rs - Raft consensus

Build and runtime boundary

abi-wdbx is a normal Rust workspace crate; there is no feat-wdbx switch or FeatureDisabled stub. Use the real abi wdbx subcommands shown by abi wdbx help. Tests must use a scratch path or disable persistence so they never open the user's live ~/.abi store.

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