Skip to content

donaldfilimon/abi / .agents/skills/wdbx-api-serve

wdbx-api-serve

Verified

Build the abi CLI and drive the WDBX REST server end-to-end — start `abi wdbx api serve` on a loopback port, hit GET /health and GET /stats, and verify ABI_WDBX_REST_TOKEN bearer auth (401 without/with wrong token, 200 with the right one). Use to run/start/smoke-test the WDBX REST API. Loopback only; kills the server on exit.

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.

wdbx-api-serve — drive the WDBX REST server

Driver: .agents/skills/wdbx-api-serve/serve.sh (paths relative to repo root). Builds the CLI, launches the REST listener on 127.0.0.1, exercises it with curl, and tears the server down (EXIT trap). Evidence is the RESULT: line. Fully local, loopback only.

Run (agent path)

.agents/skills/wdbx-api-serve/serve.sh        # default ports 8091 (no-auth) + 8092 (auth)
.agents/skills/wdbx-api-serve/serve.sh 9100   # custom base port (uses 9100 + 9101)
  • Launches abi wdbx api serve <port>, polls GET /health until up → asserts {"status":"ok"}.
  • GET /stats → asserts the store-stats JSON ("backend").
  • Restarts with ABI_WDBX_REST_TOKEN=probe-tok on <port>+1 and asserts bearer auth: no token → 401, wrong token → 401, Authorization: Bearer probe-tok → 200.

Prints RESULT: PASS (exit 0) or a FAIL count. Both servers are killed on exit.

Current Rust driver: uses an isolated ABI_WDBX_PATH, proves loopback health and stats, then checks bearer enforcement is exactly 401/401/200.

Gotchas

  • ⚠️ Loopback + local hardening only. The listener binds 127.0.0.1; ABI_WDBX_REST_TOKEN is a bearer gate, not a substitute for a TLS fronting layer. Same scheme as the MCP HTTP transport's ABI_MCP_HTTP_TOKEN.
  • The driver uses two ports (<port> and <port>+1); pick a base that leaves the next port free. It always kills both servers via an EXIT trap — check pgrep -f 'abi wdbx api serve' returns nothing after a run.
  • auth=off in the startup log is expected when ABI_WDBX_REST_TOKEN is unset; it flips to auth=on when the env var is present.
  • /stats reports the backend label separately from mode=cpu_fallback; a metal label alone is not evidence that a kernel executed.
  • For a source-level tour of the REST routing core (rest.rs route) and the WAL/checkpoint substrate, use the wdbx-explorer subagent.

Troubleshooting

SymptomFix
build FAILCheck the repository toolchain via ./tools/cargo.sh --version, then ./tools/check.sh.
server did not come upPort in use — pass a free base port; or the build didn't produce the binary.
bearer test all 200ABI_WDBX_REST_TOKEN is not being enforced — check RestConfig::from_env and abi_foundation::http::has_bearer_token.
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
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: 197kUpdated Claude CodeCodexVerifiedInstall