[P1] Audit: Search and Command Palette ranking is too literal and weak for discovery

[baixiangcpp]

Imported from the byteflow.tools deep audit on 2026-06-22.

Problem: the top search box and Ctrl/Cmd K command palette are central discovery mechanisms, but ranking appears too literal. Searches like json, jwt, base64, regex, image, svg, robots, timestamp, password, openapi, curl, markdown, log, and Chinese keywords should return highly relevant tools quickly. Synonyms, misspellings, localized queries, and task-oriented phrases are not sufficiently handled.

Affected components:

• Global search input
• Ctrl/Cmd K command palette
• Mobile search experience
• All Tools search results

Reproduction steps:

1. Search for exact tool terms such as json, jwt, regex, curl.
2. Search for synonyms such as token, auth, timestamp converter, image resize, sanitize logs.
3. Search for Chinese terms such as 二维码, 正则, 时间戳, 编码, 哈希.
4. Test keyboard actions: arrows, Enter, Esc, Ctrl/Cmd K.
5. Compare result ordering and no-result states.

Expected behavior: popular and intent-matching tools should rank first. Synonyms and localized queries should work. Keyboard navigation should be complete.

Actual behavior: ranking depends too heavily on exact string matches and does not fully support multilingual or intent-based search.

Impact: users cannot find tools quickly, especially non-English users. This reduces tool usage, conversion from content pages, and perceived product depth.

Proposed fix:

• Add synonyms and alias metadata to tool manifest.
• Add localized search terms for each locale.
• Weight exact title matches, aliases, usage popularity, category relevance, and workflow relevance.
• Add typo tolerance or fuzzy search.
• Improve no-result suggestions.
• Add analytics for safe aggregate search events without storing sensitive queries if privacy policy requires exclusion.

Acceptance criteria:

• Top 30 audit query terms return relevant tools in the first 3 results.
• Chinese common queries return matching localized tools.
• Command palette supports arrows, Enter, Esc, and focus management.
• No-result screen suggests related categories or tools.
• Search tests are added for exact, alias, and localized queries.

[baixiangcpp]

Closed as completed by the canonical BF audit backlog work. This older non-BF audit issue duplicates work now merged through PRs #209-#219, with the BF issues closed and guard/test coverage in place. The remaining non-duplicate follow-up is #7, which stays open because the upstream Next/PostCSS advisory is not fixed yet.