donaldfilimon/abi / .agents/skills/abi-superpower-wdbx-cluster
abi-superpower-wdbx-cluster
VerifiedWDBX cluster superpower. Raft/RPC plus signed membership, exact replication/read repair, deterministic placement/rebalance, and authenticated single-host multi-process proof.
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.
ABI Superpower: WDBX Cluster
Exposes WDBX cluster capabilities. Honest scope: exact committed-transaction replication/read repair, signed membership, rendezvous placement, verified resumable rebalance, and authenticated local processes are tested on one host. This is not a production multi-host distributed database.
Actions
status
Show in-process Raft state-machine status (single node that elects itself leader):
abi wdbx cluster status
demo
Run in-process consensus demo (election, quorum replication, failover):
abi wdbx cluster demo 3
serve
Serve a networked consensus RPC node:
abi wdbx cluster serve 8090 node1 127.0.0.1
- Loopback (
127.0.0.1) allowed by default - Non-loopback bind refuses to start without
ABI_WDBX_CLUSTER_TOKEN - Optional peer allowlist via
ABI_WDBX_CLUSTER_PEERS(comma-separated node IDs)
local-demo
Run the authenticated exact-data proof with 3–9 local processes:
abi wdbx cluster local-demo 3 --json
This proves single-host process/RPC behavior only, not real separate-host, hosted/Windows, or production operation.
RPC tests
Authenticated loopback vote/append coverage lives in the abi-wdbx test
suite. There is no public rpc-test CLI subcommand.
Architecture
| Layer | Source | Status |
|---|---|---|
| Raft Core | ../wdbx/crates/abi-wdbx/src/cluster.rs | Current — leader election, majority-quorum replication, failover, quorum-loss detection |
| RPC Transport | ../wdbx/crates/abi-wdbx/src/cluster_rpc.rs | Partial — real TCP RequestVote/AppendEntries, shared-secret frames, optional peer allowlist, loopback-tested |
| Exact data plane | ../wdbx/crates/abi-wdbx/src/{v2/replication,cluster/{replication,repair,rebalance,placement}}.rs | Current — exact identity, conflict retention, stable fan-out, resumable plans |
| Signed membership | ../wdbx/crates/abi-wdbx/src/cluster/membership.rs | Current — signed membership records and verification |
| CLI Surface | crates/abi-cli/src/wdbx/cluster.rs | Current — status/demo/local-demo/serve |
Auth & Network
- Shared-secret:
ABI_WDBX_CLUSTER_TOKEN— required for non-loopback binds, included in RequestVote/AppendEntries frames - Peer allowlist:
ABI_WDBX_CLUSTER_PEERS— optional comma-separated node IDs to restrict accepted peers - Transport: Raw TCP with line-delimited JSON frames (
../wdbx/crates/abi-wdbx/src/net_line.rs) - TLS/mTLS: NOT implemented — deploy behind network policy/proxy for non-loopback
Gap to Production (§3.5 wdbx-north-star.mdx)
| Missing | Required for Production |
|---|---|
| Multi-host deployment | TLS/mTLS or equivalent network policy |
| Production membership operations | Signed local records do not prove production control-plane operations |
| Production sharding | Local placement/replication APIs do not prove a production distributed database |
| Cross-host/hosted tests | Current exact multi-process proof is single-host |
Build and runtime boundary
abi-wdbx is a normal Rust workspace crate; there is no feat-wdbx switch or
FeatureDisabled stub. The real CLI surface is abi wdbx cluster status|demo|local-demo|serve; rpc-test is not a public CLI subcommand.
Claim Boundary
Per docs/contracts/external-claims-audit.mdx and docs/spec/wdbx-north-star.mdx:
- ✅ In-process Raft consensus (election, replication, failover)
- ✅ Real TCP RPC transport with auth + peer allowlist
- ✅ Exact committed-object quorum replication and conflict-preserving read repair
- ✅ Signed membership, rendezvous placement, stable fan-out, verified resumable rebalance
- ✅ Authenticated 3–9 process local demo
- ❌ NOT production multi-host deployment
- ❌ NOT production sharding despite local placement/replica APIs
- ❌ The legacy cluster RPC itself has no TLS/mTLS; the separate gateway's local TLS/mTLS tests do not change that transport boundary
- ❌ NOT production dynamic-membership operations; signed generation-checked membership records are locally tested data/control primitives
Present honestly — current evidence is exact and useful, but single-host scoped.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |