Skip to content

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

abi-superpower-wdbx-cluster

Verified

WDBX 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 ../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 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

LayerSourceStatus
Raft Core../wdbx/crates/abi-wdbx/src/cluster.rsCurrent — leader election, majority-quorum replication, failover, quorum-loss detection
RPC Transport../wdbx/crates/abi-wdbx/src/cluster_rpc.rsPartial — 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}}.rsCurrent — exact identity, conflict retention, stable fan-out, resumable plans
Signed membership../wdbx/crates/abi-wdbx/src/cluster/membership.rsCurrent — signed membership records and verification
CLI Surfacecrates/abi-cli/src/wdbx/cluster.rsCurrent — 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)

MissingRequired for Production
Multi-host deploymentTLS/mTLS or equivalent network policy
Production membership operationsSigned local records do not prove production control-plane operations
Production shardingLocal placement/replication APIs do not prove a production distributed database
Cross-host/hosted testsCurrent 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.

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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall