What's New in v0.1.51
📚 Comprehensive Technical Documentation
This release adds extensive technical documentation to help users and developers understand cass internals:
Hash Embedder Fallback
- Detailed documentation of the FNV-1a based fallback mechanism
- Comparison table: ML model (MiniLM) vs Hash embedder (FNV-1a)
- Algorithm explanation: tokenization → hashing → projection → normalization
- Environment variable override:
CASS_SEMANTIC_EMBEDDER=hash
CVVI Vector Index Format
- Complete binary format specification for
.cvvifiles - ASCII diagram showing 32-byte header and entry layouts
- Features: F32/F16 precision, memory-mapped loading, CRC32 validation, content deduplication
Search Modes
| Mode | Algorithm | Best For |
|---|---|---|
| Lexical | BM25 full-text | Exact term matching, code searches |
| Semantic | Vector similarity | Conceptual queries, "find similar" |
| Hybrid | Reciprocal Rank Fusion | Balanced precision and recall |
RRF Algorithm
RRF_score = Σ 1 / (K + rank_i)
Where K=60 (tuning constant) and rank_i is the position in each result list.
🔧 Code Quality Improvements
- Robustness: dotenvy for env vars, saturating_sub for safe arithmetic
- Better mutex handling with unwrap_or_else for poisoned state recovery
- SFTP empty filename edge case handling
- Consistent code formatting across codebase
- Clippy fixes for nightly Rust 1.94.0
✅ Verification
- 978 tests passing
- Zero clippy warnings
- Clean formatting (cargo fmt --check)
📦 Available Binaries
| Platform | Status |
|---|---|
| Linux x86_64 | ✅ Available |
| Linux ARM64 | ✅ Available |
| Windows x86_64 | ✅ Available |
| macOS x86_64 (Intel) | ✅ Available |
| macOS ARM64 (Apple Silicon) | ✅ Available |
All 5 platforms are now building successfully!
Full Changelog: v0.1.50...v0.1.51
Installation:
# From crates.io
cargo install coding-agent-search
# Or binary install
cargo binstall coding-agent-search
# Or download directly
curl -fsSL https://raw.githubusercontent.com/Dicklesworthstone/coding_agent_session_search/main/install.sh | bash