Skip to content

v6.4.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 01 Nov 12:39
· 2 commits to main since this release
v6.4.0
ca79d26
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Highlights

  • get nothing instead of noise for questions your sources cannot answer: on three real bases, 58 of 90 off-topic and 24 of 90 near-domain questions are refused, up from 41 and 1, with every answer still in place
  • trust weak-evidence flags again: correct answers flagged as weak fall from 43 to 14
  • see how Ragmir compares: on its own repository the answering file reaches the top 3 for 76% of developer questions, against 56% for a LangChain.js pipeline and 70% for MiniSearch BM25
  • reach GitHub and npm from the landing hero, and every page from a sectioned mobile drawer

What changed

  • Retrieval: each Transformers index stores a noise floor measured from 24 off-topic probe questions; only passages nearer than it count as strong vector matches, a search whose first five results are all weak answers nothing, and mxbai flags weak evidence below 30% of the question's words instead of 50%
  • Diagnostics: retired configs throw CONFIG_MIGRATION_REQUIRED, rgr doctor asks for storage compaction on fragmented indexes and for an ingest when no floor is stored, and searches no longer print LanceDB deprecation warnings
  • Benchmarks: pnpm bench:competitors compares Ragmir with LangChain.js, Orama, and MiniSearch with identical files, questions, embedding model, and vectors
  • Code health: Knip gates validation, duplicated percentile, JSON Lines, run-state, and error page code now has one implementation, and dead code is removed
  • Landing: GitHub and npm hero buttons, a drawer of card rows with Documentation and Project sections, and one shared list of project links across the hero, drawer, and footer
  • Documentation: configuration, migration, API, CLI, agent integration, troubleshooting, the agent skill, llms.txt, contributor guides, and both READMEs

Verification

  • pass pnpm validate with Biome, Knip, 556 Core tests and 27 landing tests with coverage gates, API, CLI, MCP and public-surface smoke checks, builds, publint, and release checks
  • pass the pull request checks: Quality gate, Linux x64, macOS ARM64 and Windows x64 portability on Node 22, Commitlint, and CodeQL TypeScript analysis
  • measure 6.3.1 against this release on three real bases with 260 answerable, 90 off-topic, and 90 near-domain questions: no false refusal and unchanged warm search latency
  • verify the staging landing in English and French at 375 px and 1440 px in a browser
  • Release assets include the Core tarball, checksums, an SBOM, and the release manifest
  • The protected npm workflow requires publication with provenance

Install or upgrade

npm install --save-dev @jcode.labs/ragmir@6.4.0

Requires Node.js 22.12 or later. Semantic embeddings use the separately installed optional Transformers package.

Core on npm · Migration guide

Full changelog: v6.3.1...v6.4.0

Assets 6
Loading