agent foundation

lib/Support/Search/SearchSpecialResourceProvider.php

@@ -28,6 +28,8 @@ class SearchSpecialResourceProvider
         return $rows;
     }
 
+    // Two-tier match: first checks against the hotkey service's keyword list (e.g. "shortcut", "keyboard"),
+    // then falls back to substring matching against individual entry labels/key combos.
     private static function matchesHotkeyQueryWith(string $query, array $entries): bool
     {
         $query = trim(mb_strtolower($query));
@@ -222,6 +224,7 @@ class SearchSpecialResourceProvider
                 $descriptionParts[] = $snippet;
             }
 
+            // Map raw doc scores (0–1000+) to coarser search_score buckets for result ranking.
             $rawScore = (int) $match['score'];
             $searchScore = match (true) {
                 $rawScore >= 1000 => 400,