Skip to content

docs: align retrieval-pipeline with multi-release version filtering - #115

Merged
WilliamAGH merged 1 commit into
devfrom
detail/fix-docs/docs-align-retrieval-pipeline-with-multi-release-v-a59672
Jul 29, 2026
Merged

docs: align retrieval-pipeline with multi-release version filtering#115
WilliamAGH merged 1 commit into
devfrom
detail/fix-docs/docs-align-retrieval-pipeline-with-multi-release-v-a59672

Conversation

@detail-app

Copy link
Copy Markdown
Contributor

Corrects three areas of docs/retrieval-pipeline.md that drifted after the retrieval layer switched from a single-version client-side filter pattern to multi-release server-side filtering:

  • The "Metadata filter generation" section described the deleted extractFilterPatterns() / VersionFilterPatterns.matchesMetadata() client-side fallback flow and the singular RetrievalConstraint.forDocVersion(versionNumber) API. Replaced with the actual extractVersionNumbers() -> RetrievalConstraint.docVersions (any-of matchKeywords) -> per-release fan-out with requireRequestedVersionEvidence fail-fast enforcement. A reader following the old doc would look for classes/methods that no longer exist and assume a client-side URL/title post-filter fallback that was removed.
  • The query boosting example showed release features documentation, but the word "features" was dropped from boostQueryWithVersionContext; updated to match actual output and noted multi-release queries produce ;-separated prefixes.
  • The deduplication table listed the content-hash key as hash; it is now docVersion + hash so the same chunk can appear once per requested release.

Introduced by commit 4f70a7e (@WilliamAGH)


Doc Drift PRs can be configured here.

@detail-app
detail-appBot requested a review from WilliamAGHJuly 20, 2026 16:05
@WilliamAGH
WilliamAGH merged commit 49f9afb into devJul 29, 2026
3 checks passed
Sign up for freeto 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

@WilliamAGH