Documents the four @ruvector/router 0.1.28 bugs found during the
issue #399 investigation, the empirical verification numbers
showing hnswlib-node fixes all four, the rejected alternatives
(wait for upstream, tune efSearch, brute-force, hybrid threshold),
and the user migration guide for stale vectors.db files.
Includes a comparison table:
- Recall@10 (1k vectors, default params): 10% → 100%
- Self-vector found in top-10: NO → YES
- Auto-creates files in CWD: YES → NO
- Multiple instances per process: NO → YES
- Dispose releases resources: NO → YES (immediate JS-side null)
- Native filter functions: NO → YES
- Runtime efSearch tuning: NO → YES
- Resize past initial capacity: NO → YES
- Insert latency (1k × 384 dim): ~430ms → ~324ms
Cross-references the diagnostic scripts in `scripts/diagnose-issue-399*.mjs`
that reproduce each bug and verify hnswlib-node's correctness on
the same fixtures.
CHANGELOG.md gets a new [Unreleased] section describing the migration,
the removed CWD pollution, and the added test infrastructure. The
release manager will rename [Unreleased] to the next version at
release time.
Refs #399.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Dragan Spiridonov
3e6bd4a6b4