docs(retrieval): document authoritative context fit exception - #136
Merged
WilliamAGH merged 2 commits intoJul 29, 2026
Merged
Conversation
# Conflicts: # docs/retrieval-pipeline.md
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for freeto join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The truncation algorithm in docs/retrieval-pipeline.md claimed that when system prompt + current query exceed the budget, a minimal prompt is returned. Commit 9593c39 introduced requireAuthoritativeContextFits, which throws AuthoritativeContextDoesNotFitException when authoritative (HIGH-priority) context is present and no segment fits the remaining budget — before the minimal-prompt fallback is reachable.
A developer debugging a guided-learning failure (e.g. large lesson sections under a tight budget) would consult this doc expecting a graceful minimal-prompt fallback and instead encounter an unexplained exception, sending them down the wrong path.
Introduced by commit 9593c39 (@WilliamAGH)
Doc Drift PRs can be configured here.