Why
Current lexical + facet search works, but relevance quality is not consistently strong for natural cable queries.
Outcome
Improve ranking quality with measurable gains and keep results explainable.
In Scope
- Add semantic rerank over top lexical candidates.
- Preserve deterministic facet filtering behavior.
- Add a stable benchmark query set and report precision@k + p95 latency.
- Normalize/validate price values used by filtering and ranking.
Out of Scope
- Full retrieval architecture rewrite.
- New external search infrastructure.
- UI redesign beyond minimal benchmark/report visibility.
Implementation Plan
- Add rerank stage after lexical retrieval (top-N candidate window).
- Expose ranking debug signals so ordering is inspectable.
- Add benchmark runner (fixed query set + golden expectations).
- Add price normalization guards and explicit unknown handling.
- Add regression tests for ranking and filter behavior.
Test Plan
convex: deterministic ranking fixture tests for lexical-only vs rerank.
convex: normalization tests for malformed/missing/unknown prices.
manual: run benchmark script and record precision@k + p95 latency deltas.
Acceptance Criteria
- Stable ranked output for benchmark queries.
- Benchmark report includes precision@k and p95 latency for lexical-only and rerank modes.
- Price ranking/filtering uses normalized values with explicit unknown semantics.
- CI contains at least one deterministic search-quality regression test.
Why
Current lexical + facet search works, but relevance quality is not consistently strong for natural cable queries.
Outcome
Improve ranking quality with measurable gains and keep results explainable.
In Scope
Out of Scope
Implementation Plan
Test Plan
convex: deterministic ranking fixture tests for lexical-only vs rerank.convex: normalization tests for malformed/missing/unknown prices.manual: run benchmark script and record precision@k + p95 latency deltas.Acceptance Criteria