Main Tracker: Rust-Brain / RBMEM updates

[DJLougen]

Current Release State

• v0.1.0: prior stable baseline, tagged before the context assembly work.
• v0.2.0: context assembly release.
• v0.2.1: Hermes smoke-test fix and CLI version check release.
• v0.3.0: Phase 2 diagnostics release.
• v0.4.0: Phase 3/4 machine-readable diagnostics and context release.
• Current main: c9c608c
• Current release binary: C:\Users\basbe\Documents\GitHub\AIresources\Rust-Brain\target\release\rbmem.exe

Done

• Added task-specific memory search with rbmem query.
• Added task-oriented context assembly with rbmem context.
• Added named reusable context packs with .rbmempacks and rbmem pack.
• Added section provenance fields: source.kind, source.path, and source.actor.
• Added provenance stamping for Markdown sync, CLI updates, Hermes saves, and Hermes JSON output.
• Added section-level diffs with rbmem diff.
• Added review hints with rbmem review.
• Added rbmem --version.
• Added Phase 2 diagnostics with rbmem doctor and rbmem hermes doctor.
• Added Phase 3 JSON diagnostics with --format json for doctor commands.
• Added Phase 4 JSON context assembly with --format json for query, context, and pack.
• Updated README, changelog, and architecture docs.
• Tagged and pushed v0.1.0, v0.2.0, v0.2.1, v0.3.0, and v0.4.0.

Phase 2 Diagnostics

Shipped in v0.3.0:

rbmem doctor C:\Users\basbe\.hermes\MEMORY.rbmem
rbmem hermes doctor C:\Users\basbe\.hermes\MEMORY.rbmem --rbmem-cli C:\Users\basbe\Documents\GitHub\AIresources\Rust-Brain\target\release\rbmem.exe

The Hermes doctor command checks CLI version, configured binary version, memory file existence, parse status, document format version, section count, graph edge count, validation, and Hermes load status.

Phase 3 And 4 Tool Output

Shipped in v0.4.0:

rbmem doctor C:\Users\basbe\.hermes\MEMORY.rbmem --format json
rbmem hermes doctor C:\Users\basbe\.hermes\MEMORY.rbmem --rbmem-cli C:\Users\basbe\Documents\GitHub\AIresources\Rust-Brain\target\release\rbmem.exe --format json
rbmem query C:\Users\basbe\.hermes\MEMORY.rbmem "RBMEM CLI v0.4.0" --resolve --minified --graph-depth 1 --format json
rbmem context memory.rbmem --task "review this PR" --resolve --minified --format json
rbmem pack memory.rbmem code_review --resolve --format json

Schemas now available:

• rbmem.doctor.v1
• rbmem.hermes.doctor.v1
• rbmem.context.v1

Latest local JSON checks:

rbmem doctor: schema=rbmem.doctor.v1, cli_version=rbmem 0.4.0, sections=9, graph_edges=12
rbmem hermes doctor: schema=rbmem.hermes.doctor.v1, configured_rbmem_cli.version=rbmem 0.4.0, hermes_load.status=ok, context_bytes=6150
rbmem query --format json: schema=rbmem.context.v1, operation=query, sections=9, graph_edges=12, context_bytes=6150

Hermes Integration Status

Hermes is wired to the RBMEM release binary:

C:\Users\basbe\Documents\GitHub\AIresources\Rust-Brain\target\release\rbmem.exe

Updated local files:

• C:\Users\basbe\.hermes\config.yaml
• C:\Users\basbe\.hermes\MEMORY.rbmem
• C:\Users\basbe\.hermes\.env

Hermes Agent is cloned at:

C:\Users\basbe\hermes-agent

The Hermes backend is running through WSL because native Windows hits the expected Unix fcntl blocker.

WSL Hermes config was fixed to use:

• Provider: local-localhost:11434
• API: http://localhost:11434/v1
• Model: deepseek-v4-flash:cloud

Verified

Rust checks:

cargo fmt --check
cargo test --all-features
cargo clippy --all-targets --all-features -- -D warnings
cargo build --release

RBMEM checks:

C:\Users\basbe\Documents\GitHub\AIresources\Rust-Brain\target\release\rbmem.exe --version
# rbmem 0.4.0

Hermes smoke test from v0.2.1 remains the last full chat round trip:

• Backend health OK at http://127.0.0.1:8642/health.
• Runtime config reports provider local-localhost:11434 and model deepseek-v4-flash:cloud.
• Full chat round trip completed.
• Smoke session: sess_98bcc5b11195449dbcec22ed3b903e63
• Smoke run: run_3df47153fd8b41deb121f89c1ca2247d
• Final response after reading configured RBForge rbmem_cli and running --version: rbmem 0.2.1

Next Refinement Ideas

• Add a formal Hermes integration fixture/test around hermes load, provenance, and version reporting.
• Add docs that clearly distinguish RBMEM document format version v1.3 from CLI release versions like v0.4.0.
• Tighten context pack examples for common agent workflows.
• Explore a cleaner Windows/WSL bridge path story for Hermes Agent.
• Consider whether diff and review should also expose JSON output.

Related Cards

• v0.2.1: RBMEM context assembly + Hermes integration fixed #1: v0.2.1: RBMEM context assembly + Hermes integration fixed