From dd5b3f6633c04702e098bc6cb89d85e5793d7b8b Mon Sep 17 00:00:00 2001 From: osobh Date: Fri, 25 Sep 2026 11:18:14 -0500 Subject: [PATCH] docs: ClawBrainHub is the one verified consumer The previous commit said clawhdf5 has no integration at all. ClawBrainHub (clawverse/clawbrainhub) does use it: cbh-core reads and writes .brain files through the facade, cbh-scanner uses the facade, and cbh-cli uses clawhdf5_agent::bm25::BM25Index, all via path dependencies on this repo. Checked on 2026-09-25 against main: it builds on its pinned toolchain and its 204 tests pass. CLAUDE.md now records that, and that path dependencies mean API changes here reach it directly. Co-Authored-By: Claude Opus 5.5 (1M context) --- CLAUDE.md | 13 ++++++++++--- 1 file changed, 10 insertions(+), 3 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 89870c8..1fa4581 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,7 +1,7 @@ # clawhdf5 ## Purpose -Pure-Rust HDF5 format implementation with HNSW vector search, WAL-backed persistence, agent memory storage, and GPU-accelerated I/O. A standalone library: no agent framework currently integrates it (OpenClaw and ZeroClaw claims were withdrawn on 2026-09-25 — neither was ever true). +Pure-Rust HDF5 format implementation with HNSW vector search, WAL-backed persistence, agent memory storage, and GPU-accelerated I/O. A standalone library. Its one verified consumer is ClawBrainHub (`.brain` files); no agent framework integrates it (OpenClaw and ZeroClaw claims were withdrawn on 2026-09-25 — neither was ever true). ## Architecture @@ -196,5 +196,12 @@ python -c "import clawhdf5; print(clawhdf5.__version__)" ``` ## Integration -None today. OpenClaw and ZeroClaw were both described as consumers; neither -integrates clawhdf5 (see Key Features and `docs/openclaw.md`). +- **ClawBrainHub** (`clawverse/clawbrainhub` on git.redclaw.dev) is the one + verified consumer: `cbh-core` reads and writes `.brain` files through the + facade (`File`, `FileBuilder`, `AttrValue`, `Selection`), `cbh-scanner` + uses the facade, and `cbh-cli` uses `clawhdf5_agent::bm25::BM25Index`. It + depends on this repo by path (`../clawhdf5`), so it builds against whatever + is checked out — changes to those APIs reach it directly. Verified + 2026-09-25 against main: builds, and its 204 tests pass. +- OpenClaw and ZeroClaw were both described as consumers; neither integrates + clawhdf5 (see Key Features and `docs/openclaw.md`).