Files
Dragan Spiridonov 2cb001f697 chore: diagnostic scripts for issue #399 reproduction
Four self-contained Node scripts that reproduce each of the four
@ruvector/router 0.1.28 bugs and verify hnswlib-node's correctness
on the same fixtures. Kept in scripts/ so anyone can re-verify the
bug after upstream version bumps without re-deriving the test fixtures.

  diagnose-issue-399.mjs           — exact-match recall on the
                                      project's FNV-hashed phase
                                      fixture (the same data the
                                      original failing test used)
  diagnose-issue-399-realistic.mjs — same recall test on textbook
                                      unit-Gaussian random vectors,
                                      proves the bug isn't a fixture
                                      pathology
  diagnose-issue-399-direct.mjs    — bypasses NativeHnswBackend wrapper
                                      and calls @ruvector/router's
                                      VectorDb directly to rule out
                                      wrapper bugs and confirm the
                                      defect is upstream
  diagnose-issue-399-hnswlib.mjs   — same fixture against hnswlib-node,
                                      empirical evidence that the
                                      replacement library returns
                                      100% recall@10 with correct
                                      ordering

Each script takes M, efC, efS as CLI args so future investigators
can sweep parameters without editing source. The four scripts
together produce the empirical numbers cited in ADR-090.

Refs #399, ADR-090.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-06 18:23:37 +00:00
..
2026-04-05 18:51:49 +02:00
2026-04-05 18:51:49 +02:00