feat(#6645): use AND semantics for docs site multi-word search - #6799
feat(#6645): use AND semantics for docs site multi-word search#6799fullsend-ai-coder[bot] wants to merge 3 commits into
Conversation
Multi-word queries in the vendored VPLocalSearchBox now require all terms to appear on the same page (combineWith: 'AND') instead of matching any term independently (the MiniSearch default of OR). Quoted phrases like "eval scenario" trigger exact-phrase post-filtering: after the AND search, page modules are rendered and their plain text is checked for the adjacent phrase. Results whose page text cannot be loaded are kept (graceful degradation). Changes: - searchQuery.ts: parseSearchQuery() extracts double-quoted phrases; textContainsPhrases() checks case-insensitive substring matches. - VPLocalSearchBox.vue: search call uses combineWith 'AND', parses query for phrases, post-filters via loadPageText(). - searchQuery.test.ts: 17 unit tests covering query parsing and phrase matching. Closes #6645
Site previewPreview: https://58f6cc64-site.fullsend-ai.workers.dev Commit: |
|
🤖 Finished Review · ✅ Success · Started 2:13 PM UTC · Completed 2:27 PM UTC Commit: Runtime: claude · Model: opus → claude-opus-4-6 · Effort: high · Cost: $3.72 |
Codecov Report✅ All modified and coverable lines are covered by tests. 📢 Thoughts on this report? Let us know! |
|
Risk Assessment: low (1/5) DetailsSmall, well-scoped docs-site search enhancement by a known bot author with good test coverage, stable file history, and full alignment with issue #6645's acceptance criteria. Tier 1 signals slightly elevated (4 files, 271 lines, medium blast radius) but offset by zero protected paths, zero security-sensitive files, no dependency changes, and strong Tier 2/3 signals. Composite rounds to 1, consistent with prior assessment. Previous runRisk Assessment: low (1/5) DetailsSmall, well-scoped docs-site search enhancement by a known bot author with good test coverage, stable file history, and full alignment with issue #6645's acceptance criteria. Re-review: all Tier 1 signals unchanged from prior assessment; score remains 1. Previous run (2)Risk Assessment: low (1/5) DetailsSmall, well-scoped docs-site search enhancement by a known bot author with good test coverage, stable file history, and full alignment with a recent issue's acceptance criteria. |
ReviewFindingsLow
Previous runLooks good to me Previous run (2)ReviewFindingsLow
Next steps:
|
![fullsend-ai-review[bot]](https://avatars.githubusercontent.com/in/3478501?s=60&v=4){kind=small}
This comment was marked as outdated.
This comment was marked as outdated.
Sorry, something went wrong.
|
🤖 Finished Fix · ✅ Success · Started 2:29 PM UTC · Completed 2:35 PM UTC Commit: Runtime: claude · Model: opus → claude-opus-4-6 · Effort: high · Cost: $1.26 |
- Fix adjacent quoted phrases fusing tokens by padding replacements
with spaces and normalizing whitespace in the final query string
(e.g. "foo bar""baz qux" now produces "foo bar baz qux")
- Narrow searchOpts type from Record<string, unknown> to an explicit
{ combineWith: string; filter?: ... } for compile-time safety
- Document AND semantics and exact-phrase matching in docs/doc-site.md
- Add test for adjacent quoted phrases edge case
Addresses review feedback on #6799
🔧 Fix agent — iteration 1 (bot-triggered)Addressed all 3 review findings: fixed adjacent-quotes edge case in parseSearchQuery with space-padded replacement and whitespace normalization, narrowed searchOpts type annotation for compile-time safety, and documented AND/phrase search behavior in doc-site.md. Fixed (3):
Tests: passedNext steps:
|
|
🤖 Finished Review · ✅ Success · Started 2:37 PM UTC · Completed 2:53 PM UTC Commit: Runtime: claude · Model: opus → claude-opus-4-6 · Effort: high · Cost: $4.66 |
Superseded by updated review
This comment was marked as outdated.
This comment was marked as outdated.
Sorry, something went wrong.
fullsend-ai-review
Bot
added
the
ready-for-merge
loadPageText() silently failed for every page because VitePress components need runtime context not provided in the detached render. The catch returned "" and graceful degradation kept all results, making the phrase filter a no-op. Replace with filterByPhrases() that checks against the text already stored in the MiniSearch index (added "text" to storeFields). This is synchronous, testable, and doesn't depend on page rendering. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> Signed-off-by: Marta Anon <manon@redhat.com>
|
🤖 Finished Review · ✅ Success · Started 4:47 PM UTC · Completed 5:01 PM UTC Commit: Runtime: claude · Model: opus → claude-opus-4-6 · Effort: high · Cost: $3.51 |
1 participant
Summary
Switches the vendored docs site search (
VPLocalSearchBox.vue) from OR to AND semantics for multi-word queries, so searching foreval scenarioreturns only pages containing both terms. Adds exact-phrase support: wrapping a query in double quotes ("eval scenario") post-filters results to pages where the phrase appears adjacent.Changes
docs/.vitepress/theme/searchQuery.ts— new utility module withparseSearchQuery()(extracts double-quoted phrases) andtextContainsPhrases()(case-insensitive substring check)docs/.vitepress/theme/components/VPLocalSearchBox.vue— passescombineWith: 'AND'toindex.search(); parses query for quoted phrases; addsloadPageText()helper that renders a page module to plain text; post-filters results for exact phrase matches when quotes are presentdocs/.vitepress/theme/searchQuery.test.ts— 17 unit tests covering query parsing edge cases and phrase matchingTesting
vitest runpasses (44 tests, 3 test files)prettier --checkpasses on all changed filesstylelintpasses on the Vue componentmatchesActiveScopes) is preserved — the filter function is merged into the same search options objectCloses #6645
Post-script verification
agent/6645-docs-search-and-semantics)92c1d6498c16ee9fa490150a6405c1bb974aff4a..HEAD)