donaldfilimon/abi / .agents/skills/abi-superpower-wdbx
abi-superpower-wdbx
VerifiedWDBX vector store operations superpower. Includes insert, query, stats, compaction, secure demos, and REST API.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.9 KB |
SKILL.md
View on GitHub---
name: abi-superpower-wdbx
description: WDBX vector store operations superpower. Includes insert, query, stats, compaction, secure demos, and REST API.
superpower:
command: "execute"
parameters:
- name: "action"
type: "string"
enum: ["insert", "query", "stats", "compact", "benchmark", "secure", "cluster", "api"]
description: "WDBX action to perform"
- name: "path"
type: "string"
description: "Database path"
- name: "query"
type: "string"
description: "Query text for semantic search"
- name: "keep"
type: "integer"
description: "Segments to keep during compaction"
---
> **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.
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 |