User Story
As a reader using Search, I want a clear and functional experience when semantic (deep) search results are unavailable,
so that I’m not confused by empty or broken sections and can continue searching or exploring other topics.
Description
Semantic (deep) retrieval may fail or be unavailable for certain queries or topics due to limited embedding coverage, unsupported content, or API failures. When this happens, the product should degrade gracefully.
At minimum, the experience should avoid showing incomplete or confusing UI. Ideally, the experience should also help the user understand what’s happening and encourage them to continue exploring by trying a different query or topic.
This task defines both:
- a worst-case fallback (required for MVP) and
- a best-case fallback (nice to have) when semantic retrieval does not return usable results.
Requirements [Required]
Worst-case fallback (MVP / must-have)
When semantic retrieval fails (empty results, error response, or below-confidence threshold):
- Do not render the semantic / deep search section.
- Do not show loading skeletons, or error UI related to semantic content.
- Lexical search results continue to display normally.
- No user-facing error messaging is required for MVP.
- Log an instrumentation event indicating semantic fallback was shown.
Acceptance Criteria
- Users never see an empty or broken semantic section.
- Search remain fully usable even when semantic retrieval fails.
- Failure of semantic retrieval does not block or degrade lexical results.
Nice to Have
Best-case fallback (non-blocking enhancement)
When semantic retrieval fails:
- Replace the semantic section with a lightweight informational state.
- Messaging should:
- Indicate lack of semantic coverage for the topic or query (not a user error).
- Encourage trying a different query or topic.
- Provide one or more affordances:
- “Try a different search”
- “Explore related topics”
- Editable search field with suggested alternative queries
Example copy (placeholder)
“We don’t yet have semantic coverage for this topic.
Try searching another way or explore a related subject.”
Optional Enhancements
- Show example semantic-style queries as tappable suggestions.
- Include a “Why am I seeing this?” affordance for transparency.


