nestweaver: Instructions file for Claude Code

NestWeaver

Build & Test

cargo build                                                 # build all crates
cargo build --release                                       # release binary
cargo test                                                  # run all tests
just test-crate nestweaver-schema                           # test one crate — NOT `cargo test -p`
cargo clippy --workspace --all-targets -- -D warnings       # lint (zero warnings)
cargo fmt --all -- --check                                  # format check
cargo fmt --all                                             # format in place

Use just test-crate, never a bare cargo test -p <crate>. -p resolves features for that package alone, while a workspace run unifies them across dependents. Affected crates therefore run fewer tests under -p and still report ok. Measured on 5e9e0f0, bare -p / --all-features / --workspace:

The recipe starts from every feature the package declares (read from cargo metadata), not a per-crate list, because every feature unification can activate on a package is one of that package's own features — so that set is a superset and can never cover less. Guessing the list is unreliable: --features embed looks right and leaves nestweaver-mcp at 154, since what it actually needs is daemon.

Off macOS the recipe passes every feature except those enabling metal (nestweaver-embed, the root nestweaver and nestweaver-daemon have one), because metal pulls objc2 and does not compile on Linux. It also leaves out the CI-only ci-direct-tests.

Switching between -p and --workspace also re-resolves features, which re-fingerprints the build and forces a full lbug C++ rebuild. Pick one shape per working tree and keep it.

A clean clone links with no extra linker flags. Only one copy of zstd is in the binary: liblbug.a vendors it, and Rust code reaches that copy through nestweaver_store::zstd rather than the zstd crate. Do not add a zstd dependency back — that reintroduces zstd-sys, a second complete copy, and the duplicate-symbol link failure that -Wl,--allow-multiple-definition used to suppress.