travsr explain
Show why travsr ask ranked or skipped a result: which terms matched, which relevance thresholds passed or failed, and the final decision.
A diagnostic for tuning search. Not part of normal use.
travsr explain "where do we handle refunds" PaymentService
Arguments
| Argument | Meaning |
|---|---|
<QUERY> | The question exactly as you would pass it to travsr ask |
<SYMBOL> | The symbol to explain, bare name or full signature |
--format json emits the full ExplainReport rather than the human summary.
When to use
- A symbol you expected did not appear. The report says whether it was never a candidate, or was a candidate that lost on score, or was cut by a threshold. Those have different fixes.
- Tuning synonyms. If a query misses because the vocabulary does not match, the term breakdown shows it directly.
- Understanding an abstention. When
askdeclines to answer, this shows which threshold it failed rather than leaving you to guess.
The distinction it exists to draw is between not found and found but not returned. Those look identical in ask output and call for completely different responses.