Skip to content

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

abi-superpower-wdbx-compute

Verified

WDBX compute superpower. Cycle-free accelerator contracts, deterministic CPU SIMD fallback, scoped Metal execution, output-checked CoreML inference, and honest CUDA/Vulkan boundaries.

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 Compute

Exposes the cycle-free abi-compute accelerator contract and WDBX selector. Unsupported or unverified paths degrade to deterministic CPU SIMD. Supported macOS builds can execute Metal dot/cosine/norm/batch-cosine; capability becomes runtime-verified only after successful CPU-oracle parity. CoreML evidence is an output-checked tiny-model inference under a .cpuAndNeuralEngine request, not placement or residency proof. CUDA/Vulkan runtime remains unverified.

Actions

info

Show compute backend matrix (availability + dispatch status):

abi wdbx compute info

Output includes:

  • CPU: scalar, AVX2, AVX-512, NEON through Rust std::simd
  • GPU: Metal/CUDA/Vulkan five-state evidence; compilation is not execution
  • NPU: ANE hardware presence plus output-checked CoreML inference, not residency
  • TPU: Report-only endpoint metadata (ABI_REMOTE_COMPUTE_ENDPOINT) plus a separately tested reference TCP transport

select

Backend selection is internal to the Rust compute API. There is no public select subcommand; abi wdbx compute info reports the requested/effective selection and its fallback reason.

backend

There is no public per-backend subcommand. Use abi wdbx compute info for the compat table, the per-backend evidence ladder, and WDBX selection; abi backends reports the native-kernel state and points there for the table (since 2026-09-16).

remote

ABI_REMOTE_COMPUTE_ENDPOINT opts abi wdbx compute info into one authenticated, bounded DOT probe. The reference transport attempts the configured endpoint and falls back to deterministic local CPU when the endpoint is unavailable. This is execution evidence for the small reference request, not a production remote-TPU service or a general WDBX offload path.

Backend Matrix (Honest)

BackendAvailableDispatchesReality
CPU SIMDAlways✅ AlwaysRust std::simd with host-matched width
MetalSupported macOS buildsScopedDot/cosine/norm/batch-cosine; runtime-verified only after CPU-oracle agreement, otherwise CPU fallback
CUDAAdapter may compile❌ UnverifiedCompilation/tool detection does not prove runtime initialization or execution
VulkanAdapter may compile❌ UnverifiedCompilation/tool detection does not prove loader/device execution
CoreML / ANEOptional inference helper❌ Residency unverifiedExecutes an output-checked tiny model under .cpuAndNeuralEngine; does not prove inference placement or ANE residency
Remote acceleratorReference DOT onlyScoped proberemote_compute.rs has an authenticated, timeout-bounded transport; the explicit environment endpoint is probed by compute info with deterministic CPU fallback

Implementation

ComponentSourceRole
Contracts / CPU SIMD../wdbx/crates/abi-compute/src/Object-safe accelerator, five-state evidence, deterministic SIMD/top-k
WDBX batch search../wdbx/crates/abi-wdbx/src/v2/index.rsAccelerator injection with result validation and CPU parity/fallback
GPU adapterscrates/abi-gpu/src/{adapters,metal_kernels}.rsMetal execution/oracle; CUDA/Vulkan unverified; CoreML output-checked without residency claim
NPU Detection../wdbx/crates/abi-compute/src/backend.rsane_hardware_present() — hardware metadata only
Remote accelerator../wdbx/crates/abi-wdbx/src/remote_compute.rsAuthenticated bounded reference DOT transport; compute info probes an explicitly configured endpoint and otherwise does no network I/O
Selection parity tests../wdbx/crates/abi-compute/src/cpu.rs, ../wdbx/crates/abi-wdbx/src/v2/index.rsAccelerator requests preserve CPU-reference results

CLI Access

abi wdbx compute info

Build and runtime boundary

abi-compute, abi-wdbx, and abi-gpu are normal Rust workspace crates. The WDBX selector retains deterministic CPU fallback; no compiled/available adapter is promoted to execution without later evidence states. The real CLI surface is abi wdbx compute info.

Claim Boundary

Per docs/spec/wdbx-north-star.mdx §3.3 and docs/contracts/external-claims-audit.mdx:

  • ✅ Cycle-free object-safe accelerator contract and five-state evidence
  • ✅ CPU SIMD parity across accelerator requests and fallback
  • ✅ Scoped Metal numerical execution when initialized and oracle-verified
  • ✅ ANE hardware detection and output-checked CoreML tiny-model inference
  • ✅ Reference loopback TCP DOT transport with local fallback
  • ⚠️ Metal execution remains supported-host/runtime scoped; availability alone is not execution evidence
  • ❌ CUDA/Vulkan runtime execution is not verified
  • ❌ CoreML inference under a compute-unit request is not placement or ANE residency
  • ⚠️ ABI_REMOTE_COMPUTE_ENDPOINT drives only a bounded reference DOT probe with deterministic CPU fallback; it is not general WDBX offload or production remote acceleration
  • ❌ No blanket accelerator speedup claim without reproducible benchmark evidence
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