@wardby/cli 0.7.0 → 0.8.0

package/dist/help/search.js

@@ -87,18 +87,27 @@ function excerpt(queries, page) {
         .sort((left, right) => right.score - left.score || left.candidate.length - right.candidate.length)[0];
     return truncate(best?.candidate ?? page.summary);
 }
+/** Added when the whole query equals one of a page's tags; above the 12 a single title word can add. */
+const EXACT_TAG_BONUS = 15;
 /** Finds pages with deterministic, offline fuzzy matching over their catalog metadata and body. */
 export function searchHelp(catalog, query) {
     const queries = words(query);
     if (!queries.length)
         return [];
+    // A query that is exactly one of a page's tags (such as an error code) names that page. Word scoring
+    // alone ties when one code's words are a subset of another's (mcp_unavailable inside
+    // mcp_server_credentials_unavailable), so the exact tag adds more than any single word can.
+    const wholeQuery = query.trim().toLowerCase();
     const results = [];
     for (const page of catalog.pages) {
-        const score = pageScore(queries, page);
-        if (score === undefined)
+        const matchScore = pageScore(queries, page);
+        if (matchScore === undefined)
             continue;
+        const score = matchScore + (page.tags.some((tag) => tag.toLowerCase() === wholeQuery) ? EXACT_TAG_BONUS : 0);
         const heading = matchingHeading(queries, page);
         results.push({ page, score, ...(heading ? { matchedHeading: heading } : {}), excerpt: excerpt(queries, page) });
     }
-    return results.sort((left, right) => right.score - left.score || left.page.id.localeCompare(right.page.id));
+    // On a tie, a guide outranks an error article: error codes in titles share words (like "mcp") with their guide.
+    const isError = (result) => Number(result.page.id.startsWith("errors/"));
+    return results.sort((left, right) => right.score - left.score || isError(left) - isError(right) || left.page.id.localeCompare(right.page.id));
 }