donaldfilimon/abi / .agents/skills/wdbx-cluster-serve
wdbx-cluster-serve
VerifiedBuild the abi CLI and run a networked WDBX consensus node (`abi wdbx cluster serve <port>`) — background-launch the loopback RequestVote/AppendEntries RPC listener, poll until it is serving, assert readiness, then tear it down. Use when asked to run/start/serve/smoke-test the WDBX cluster node, the consensus RPC listener, or `cluster serve`.
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.
wdbx-cluster-serve — run the networked WDBX consensus node
Driver: .agents/skills/wdbx-cluster-serve/cluster-serve.sh (paths relative to repo root).
Server-type check — background-launch, poll for readiness, assert, kill. Evidence is the RESULT: line.
This is the networked consensus node (cluster_rpc TCP transport: RequestVote/AppendEntries),
distinct from the in-process abi wdbx cluster demo that /cluster-demo-guide covers and the
single-node cluster status. Loopback-only by design.
Prerequisites
- Stable Rust 1.99.1 via
./tools/cargo.sh(never bare Homebrewcargo). ncfor the port probe (optional — the readiness marker is the primary gate; the probe is skipped ifncis absent).
Run (agent path)
.agents/skills/wdbx-cluster-serve/cluster-serve.sh # serve on 127.0.0.1:8092
.agents/skills/wdbx-cluster-serve/cluster-serve.sh 8095 # override the port
It builds the CLI, launches abi wdbx cluster serve <port> in the background, and asserts the
readiness marker wdbx cluster RPC serving on 127.0.0.1:<port> (printed to stderr before the accept
loop blocks), an open port, and no bind/panic error — then kills the node via an EXIT trap.
Prints RESULT: PASS — WDBX cluster node served consensus RPC on loopback. (exit 0) or
RESULT: FAIL — N check(s).
Current Rust driver: requires the readiness marker and accepting loopback port, then tears the node down and checks for bind/panic failures.
Gotchas
- Loopback-only. The driver binds
127.0.0.1in compatibility mode. A non-loopback bind fails closed unlessABI_WDBX_CLUSTER_TOKENis configured, but the reference transport still has no TLS and is not production multi-host. - The node runs until killed. It blocks in the accept loop; the driver always kills it on exit
(
EXITtrap). Re-run leaves nothing behind — confirm withpgrep -f 'abi wdbx cluster serve'. - Pick a free port. A bound port fails the bind and the driver reports FAIL; pass a different
$1. cluster-serve.sh <non-number>→ usage, exit 2.
Troubleshooting
| Symptom | Fix |
|---|---|
build FAIL | Run ./tools/check.sh for the real error. |
no readiness marker / bind … failed | Port in use or privileged — pick a higher free port (8095). |
| missing marker string | CLI grammar drifted — check crates/abi-cli/src/wdbx/cluster.rs. |
For source-level questions about the consensus/RPC internals, use the wdbx-explorer subagent.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |