toolsearch

Overview ¶

Package toolsearch ranks registry tools against a free-text query so an operator can find the right tool by task ("garage door", "wifi password", "decode nfc card") instead of guessing its exact name. With 600+ tools, the only discovery affordance was a name-substring filter; this adds task-oriented search across every surface that reaches the registry.

The ranking is deterministic and offline: the same query always yields the same order (ties broken by tool name — a tiebreak-less sort would flake, see the Sub-GHz classifier fix), and the score is a field-weighted token overlap over each tool's name / aliases / group / description, plus a small curated domain synonym map so task words reach the technical terms the tools actually use. No "confidently wrong" risk: a ranking is advisory; a poor match is merely lower-ranked, never asserted as the answer.

Wrap-vs-native: native — a tokenizer + weighted set-overlap scorer, stdlib only, no search-index or embedding dependency.