Skip to content

Optimize vector retrieval and refresh README with animated SVGs - #17

Merged
ruvnet merged 1 commit into
mainfrom
perf/vector-topk-readme
Oct 18, 2026
Merged

ruvnet merged 1 commit into
mainfrom
perf/vector-topk-readme

Conversation

@ruvnet

@ruvnet ruvnet commented Oct 18, 2026

Copy link
Copy Markdown
Owner

The default cosine search sorted every stored vector to return only K results. This change uses stable bounded selection, retaining O(K) candidates and preserving scores and insertion order for ties.

Adds two animated SVGs with reduced motion support, a practical walkthrough, application examples, descriptive headings and npm search keywords. Corrects README claims about durable persistence, native HNSW, embedding fallback and quantization memory savings. SVGs are included in npm packaging.

Validation: 180 tests across 30 suites pass; TypeScript build passes; lint has zero errors and 147 warnings. SVG XML parsed and static renders visually inspected; npm pack dry run includes both assets. Remote tree SHA matches the tested local tree exactly.

Reproducible cosine scan plus selection benchmark: 10k vectors at 16 dimensions improves 3.603 to 0.651 ms (5.54x); 10k at 384 dimensions improves 11.183 to 8.423 ms (1.33x); 50k at 16 dimensions improves 22.491 to 4.791 ms (4.69x). K=10, seeded data, 31 interleaved samples; results identical. These are kernel timings, not end to end LLM gains. Raw results and reproduction instructions are committed.

Existing release concerns: ruOS npm ci reports 60 dependency audit findings including three critical findings, requiring separate triage. Local npm 11 rejects the existing optional MLflow lock entry; npm install with scripts disabled and lock writes disabled succeeded, while ruOS npm ci completed. No dependency versions or lockfile changed. SVG motion still needs visual confirmation through GitHub's image proxy.

Acceptance: npm run build; npm test -- --runInBand; node tests/benchmarks/vector-top-k.cjs. Review README rendering and animations on this branch.

@ruvnet
ruvnet merged commit a83f8fe into main Oct 18, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant