Skip to content
QQL Documentation

0.2.0 Release Notes

Release date: 2026-05-21

Summary

Section titled “Summary”

This release brings qql-go forward to the Python QQL 2.5.0 parity line for search pagination, score thresholds, and cross-collection lookup, while also tightening collection config update and dump behavior.

Highlights

Section titled “Highlights”
  • SEARCH pagination — flat search now supports OFFSET <n> for dense, sparse, and hybrid queries.
  • SEARCH score thresholds — SCORE THRESHOLD <float|int> is accepted on search queries and forwarded to Qdrant, including grouped search.
  • SEARCH lookup-from — LOOKUP FROM <collection> [VECTOR '<name>'] is now available for search paths that need cross-collection vector lookup metadata.
  • Hybrid MMR — WITH { mmr_diversity, mmr_candidates } now works on USING HYBRID by applying MMR to the dense prefetch before fusion.
  • Collection update fixes — ALTER COLLECTION now applies vector on-disk updates across unnamed and named dense vectors, and Turbo quantization updates are no longer dropped.
  • Dump fidelity — generated collection dumps now preserve optimizer thread settings, on_disk_payload, and Turbo bit values.

Supported syntax added in this release

Section titled “Supported syntax added in this release”
New Syntax in 0.2.0 
SEARCH docs SIMILAR TO 'refund policy' LIMIT 10 OFFSET 20
SEARCH docs SIMILAR TO 'refund policy' LIMIT 10 SCORE THRESHOLD 0.8
SEARCH docs SIMILAR TO 'refund policy' LIMIT 5 LOOKUP FROM profile_vectors VECTOR 'preferences' USING HYBRID
SEARCH docs SIMILAR TO 'refund policy' LIMIT 5 USING HYBRID WITH { mmr_diversity: 0.5, mmr_candidates: 20 }

OFFSET is for flat search results only. GROUP BY queries continue to reject OFFSET because Qdrant grouped search uses a different pagination model.

Packaging

Section titled “Packaging”

Release bundles include:

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

Tagged releases also publish:

  • qql-go_0.2.0_checksums.txt

Known limits

Section titled “Known limits”

Validation

Section titled “Validation”

Release prep was validated with:

  • go test ./...
  • git diff --check
  • live qql-go explain checks for SEARCH OFFSET, SCORE THRESHOLD, LOOKUP FROM, grouped offset rejection, and integer RECOMMEND SCORE THRESHOLD

Full changelog

Section titled “Full changelog”

See CHANGELOG.md.

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