0.1.7 Release Notes

Release date: 2026-05-17

Summary

This release tightens local sparse retrieval, fixes the actual local sparse execution path, and upgrades the repo from basic .qql snippets to stronger operational examples you can run and benchmark end to end.

Highlights

• Local sparse retrieval is materially stronger — document inserts now use the intended local sparse document weighting path, and medical/domain-heavy hyphenated tokens survive tokenization instead of losing critical signal.
• Qdrant-native sparse baseline — local and external sparse mode now follow a simpler model: client-side sparse term weighting plus Qdrant's sparse idf modifier, without pretending the repo maintains full per-collection BM25 state.
• Operational example folders — the repo now ships real example suites for retrieval regression CI, retrieval debug runbooks, and a full medical retrieval benchmark.
• Full medical benchmark workflow — examples/medical-retrieval-ops/ builds the full ChatMED-Project/RAGCare-QA corpus, compares dense, sparse, hybrid RRF, hybrid DBSF, and exact retrieval, and writes machine-readable benchmark artifacts.

Benchmark snapshot

Validated against the full 420-question medical benchmark:

• dense — hit@1 0.7071, hit@5 0.8833
• sparse — hit@1 0.7000, hit@5 0.9048
• hybrid_rrf — hit@1 0.7548, hit@5 0.9143
• hybrid_dbsf — hit@1 0.7690, hit@5 0.9119
• exact — hit@1 0.7071, hit@5 0.8833

The key practical result is that sparse retrieval is no longer the weak path in local mode, and hybrid retrieval improves on top of it.

Packaging

Release bundles include:

• qql-go (Linux amd64, Linux arm64, Windows amd64, macOS arm64)

Tagged releases also publish:

• qql-go_0.1.7_checksums.txt

Known limits

Known Limits

• RERANK is cloud-only. Local and external modes reject rerank queries.
• Dense MMR still applies only to dense search paths; USING HYBRID, USING SPARSE, and RECOMMEND do not accept MMR settings.
• The medical benchmark corpus is a retrieval benchmark and public-information corpus, not clinical decision support.

Validation

Release prep was validated with:

• go run docs/dev_tasks.go prepare-release --version 0.1.7
• go run docs/dev_tasks.go release-validate --version 0.1.7
• go test ./internal/sparse ./internal/cli/commands
• live runs of:
  • bash examples/release-validation/run-demo.sh
  • bash examples/retrieval-debug-runbook/run-demo.sh
  • bash examples/medical-retrieval-ops/run-demo.sh

Full changelog

See CHANGELOG.md.

---

For full commit list and details see the original release notes.