Skip to content

feat(query): add --explain score traces for hybrid retrieval#242

Open
vyalamar wants to merge 1 commit intotobi:mainfrom
vyalamar:feat/query-explain-score-traces
Open

feat(query): add --explain score traces for hybrid retrieval#242
vyalamar wants to merge 1 commit intotobi:mainfrom
vyalamar:feat/query-explain-score-traces

Conversation

@vyalamar
Copy link

Summary

  • add --explain option to qmd query for retrieval score attribution
  • expose backend scores (FTS/vector), per-list RRF contributions, top-rank bonus, reranker score, and final blended score
  • include explain payload in JSON output and concise explain section in CLI output
  • add unit tests for RRF trace correctness and bonus thresholds
  • document the flag in README and add changelog entry

Validation

  • npm run build
  • npx vitest run --reporter=verbose test/rrf-trace.test.ts test/store.helpers.unit.test.ts

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