free-coding-models 0.3.22 → 0.3.23

package/CHANGELOG.md

@@ -1,6 +1,19 @@
 # Changelog
 ---
 
+## 0.3.23
+
+### Added
+- **Favorites display mode (`Y`)**: Added a global toggle to switch favorites between `pinned + always visible` and `normal rows` (starred only, fully obeying active filters/sort).
+- **Favorites mode row in Settings**: Added a dedicated Settings row to inspect/toggle favorites display behavior without leaving the maintenance screen.
+- **Expanded command palette action menus**: Added nested menus for Ping Mode (speed/normal/slow/forced with explanations), Target Tool (all supported tools with explanations), and Favorites Mode (including the new `Y` flow).
+- **Active text-filter footer alert**: When a custom search filter is active (for example `deep`), the last TUI footer line now shows a high-visibility inline badge (between `N Changelog` and `Ctrl+C Exit`) with the exact query and an `X` shortcut to clear it instantly.
+
+### Changed
+- **Favorites sorting/filtering behavior**: Sort/filter logic now respects the selected favorites mode across the table refresh loop, hotkeys, and renderer so non-pinned mode behaves consistently everywhere.
+- **Favorites default mode**: New/legacy configs now default to `Normal filter/sort` favorites mode (not pinned) until users press `Y` to opt into pinned+sticky behavior.
+- **Footer/help/docs shortcut hints**: Surfaced `Y` in the TUI footer, Help overlay, and README so the new favorites mode is discoverable.
+
 ## 0.3.22
 
 ### Added

package/README.md

@@ -185,6 +185,8 @@ Press **`Z`** in the TUI to cycle between tools without restarting.
 | `D` | Cycle provider filter |
 | `E` | Toggle configured-only mode |
 | `F` | Favorite / unfavorite model |
+| `Y` | Toggle favorites mode (`Normal filter/sort` default ↔ `Pinned + always visible`) |
+| `X` | Clear active custom text filter |
 | `G` | Cycle global theme (`Auto → Dark → Light`) |
 | `Ctrl+P` | Open ⚡️ command palette (search + run actions) |
 | `R/S/C/M/O/L/A/H/V/B/U` | Sort columns |
@@ -206,12 +208,12 @@ Press **`Z`** in the TUI to cycle between tools without restarting.
 - **Adaptive monitoring** — 2s burst for 60s → 10s normal → 30s idle
 - **Stability score** — composite 0–100 (p95 latency, jitter, spike rate, uptime)
 - **Smart ranking** — top 3 highlighted 🥇🥈🥉
-- **Favorites** — pin models with `F`, persisted across sessions
+- **Favorites** — star models with `F`, persisted across sessions, default to normal rows, and switch display mode with `Y` (pinned+sticky vs normal rows)
 - **Configured-only default** — only shows providers you have keys for
 - **Keyless latency** — models ping even without an API key (show 🔑 NO KEY)
 - **Smart Recommend** — questionnaire picks the best model for your task type
 - **⚡️ Command Palette** — `Ctrl+P` opens a searchable action launcher for filters, sorting, overlays, and quick toggles
-- **Install Endpoints** — push a full provider catalog into any tool's config (`Y`)
+- **Install Endpoints** — push a full provider catalog into any tool's config (from Settings `P` or ⚡️ Command Palette)
 - **Missing tool bootstrap** — detect absent CLIs, offer one-click install, then continue the selected launch automatically
 - **Width guardrail** — shows a warning instead of a broken table in narrow terminals
 - **Readable everywhere** — semantic theme palette keeps table rows, overlays, badges, and help screens legible in dark and light terminals

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "free-coding-models",
-  "version": "0.3.22",
+  "version": "0.3.23",
   "description": "Find the fastest coding LLM models in seconds — ping free models from multiple providers, pick the best one for OpenCode, Cursor, or any AI coding assistant.",
   "keywords": [
     "nvidia",

package/src/app.js

@@ -21,8 +21,8 @@
  *   - JSON config stored in ~/.free-coding-models.json (auto-migrates from old plain-text)
  *   - Multi-provider support via sources.js (NIM/Groq/Cerebras/OpenRouter/Hugging Face/Replicate/DeepInfra/... — extensible)
  *   - Settings screen (P key) to manage API keys, provider toggles, manual updates, and provider-key diagnostics
- *   - Install Endpoints flow (Y key) to push provider catalogs into OpenCode, OpenClaw, Crush, and Goose
- *   - Favorites system: toggle with F, pin rows to top, persist between sessions
+ *   - Install Endpoints flow (Settings / Command Palette) to push provider catalogs into OpenCode, OpenClaw, Crush, and Goose
+ *   - Favorites system: toggle with F, switch pinning mode with Y, persist between sessions
  *   - Uptime percentage tracking (successful pings / total pings)
  *   - Sortable columns (R/O/M/L/A/S/C/H/V/B/U/G keys)
  *   - Tier filtering via T key (cycles S+→S→A+→A→A-→B+→B→C→All)
@@ -307,7 +307,7 @@ export async function runApp(cliArgs, config) {
   }
 
   // 📖 Re-sync tracked external-tool catalogs after the live provider catalog has settled.
-  // 📖 This keeps prior `Y` installs aligned with the current FCM model list.
+  // 📖 This keeps prior endpoint installs aligned with the current FCM model list.
   refreshInstalledEndpoints(config)
 
   // 📖 Build results from MODELS — only include enabled providers
@@ -383,6 +383,7 @@ export async function runApp(cliArgs, config) {
     tierFilterMode: 0,            // 📖 Index into TIER_CYCLE (0=All, 1=S+, 2=S, ...)
     originFilterMode: 0,          // 📖 Index into ORIGIN_CYCLE (0=All, then providers)
     hideUnconfiguredModels: config.settings?.hideUnconfiguredModels === true, // 📖 Hide providers with no configured API key when true.
+    favoritesPinnedAndSticky: config.settings?.favoritesPinnedAndSticky === true, // 📖 false by default: favorites follow normal sort/filter rules until Y enables pinned+sticky mode.
       scrollOffset: 0,              // 📖 First visible model index in viewport
       terminalRows: process.stdout.rows || 24,  // 📖 Current terminal height
       terminalCols: process.stdout.columns || 80, // 📖 Current terminal width
@@ -409,11 +410,11 @@ export async function runApp(cliArgs, config) {
     commandPaletteScrollOffset: 0, // 📖 Vertical scroll offset for the command palette result viewport.
     commandPaletteResults: [],    // 📖 Cached fuzzy-filtered command entries for the command palette.
     commandPaletteFrozenTable: null, // 📖 Frozen table snapshot rendered behind the command palette overlay.
-    commandPaletteExpandedIds: new Set(['filters']), // 📖 Set of expanded category/subcategory IDs (filters expanded by default for quick access).
+    commandPaletteExpandedIds: new Set(['filters', 'actions']), // 📖 Expanded category IDs (filters + actions open by default for quick access).
     helpVisible: false,           // 📖 Whether the help overlay (K key) is active
     settingsScrollOffset: 0,      // 📖 Vertical scroll offset for Settings overlay viewport
     helpScrollOffset: 0,          // 📖 Vertical scroll offset for Help overlay viewport
-    // 📖 Install Endpoints overlay state (Y key opens it)
+    // 📖 Install Endpoints overlay state (opened from Settings or Command Palette)
     installEndpointsOpen: false,  // 📖 Whether the install-endpoints overlay is active
     installEndpointsPhase: 'providers', // 📖 providers | tools | scope | models | result
     installEndpointsCursor: 0,    // 📖 Selected row within the current install phase
@@ -678,8 +679,8 @@ export async function runApp(cliArgs, config) {
     const activeTier = TIER_CYCLE[state.tierFilterMode]
     const activeOrigin = ORIGIN_CYCLE[state.originFilterMode]
     state.results.forEach(r => {
-      // 📖 Favorites stay visible and pinned regardless of configured-only, tier, or provider filters.
-      if (r.isFavorite) {
+      // 📖 Sticky-favorites mode keeps favorites visible regardless of configured-only, tier, or provider filters.
+      if (state.favoritesPinnedAndSticky && r.isFavorite) {
         r.hidden = false
         return
       }
@@ -825,7 +826,7 @@ export async function runApp(cliArgs, config) {
   if (cliArgs.tierFilter) {
     const allowed = TIER_LETTER_MAP[cliArgs.tierFilter]
     state.results.forEach(r => {
-      r.hidden = r.isFavorite ? false : !allowed.includes(r.tier)
+      r.hidden = (state.favoritesPinnedAndSticky && r.isFavorite) ? false : !allowed.includes(r.tier)
     })
   }
 
@@ -863,7 +864,9 @@ export async function runApp(cliArgs, config) {
     // 📖 Cache visible+sorted models each frame so Enter handler always matches the display
     if (!state.settingsOpen && !state.installEndpointsOpen && !state.toolInstallPromptOpen && !state.recommendOpen && !state.feedbackOpen && !state.changelogOpen && !state.commandPaletteOpen) {
       const visible = state.results.filter(r => !r.hidden)
-      state.visibleSorted = sortResultsWithPinnedFavorites(visible, state.sortColumn, state.sortDirection)
+      state.visibleSorted = sortResultsWithPinnedFavorites(visible, state.sortColumn, state.sortDirection, {
+        pinFavorites: state.favoritesPinnedAndSticky,
+      })
     }
     let tableContent = null
     if (state.commandPaletteOpen) {
@@ -896,7 +899,9 @@ export async function runApp(cliArgs, config) {
           state.settingsUpdateLatestVersion,
           false,
           state.startupLatestVersion,
-          state.versionAlertsEnabled
+          state.versionAlertsEnabled,
+          state.favoritesPinnedAndSticky,
+          state.customTextFilter
         )
       }
       tableContent = state.commandPaletteFrozenTable
@@ -928,7 +933,9 @@ export async function runApp(cliArgs, config) {
         state.settingsUpdateLatestVersion,
         false,
         state.startupLatestVersion,
-        state.versionAlertsEnabled
+        state.versionAlertsEnabled,
+        state.favoritesPinnedAndSticky,
+        state.customTextFilter
       )
     }
 
@@ -964,9 +971,11 @@ export async function runApp(cliArgs, config) {
 
   // 📖 Populate visibleSorted before the first frame so Enter works immediately
   const initialVisible = state.results.filter(r => !r.hidden)
-  state.visibleSorted = sortResultsWithPinnedFavorites(initialVisible, state.sortColumn, state.sortDirection)
+  state.visibleSorted = sortResultsWithPinnedFavorites(initialVisible, state.sortColumn, state.sortDirection, {
+    pinFavorites: state.favoritesPinnedAndSticky,
+  })
 
-  process.stdout.write(ALT_HOME + renderTable(state.results, state.pendingPings, state.frame, state.cursor, state.sortColumn, state.sortDirection, state.pingInterval, state.lastPingTime, state.mode, state.tierFilterMode, state.scrollOffset, state.terminalRows, state.terminalCols, state.originFilterMode, null, state.pingMode, state.pingModeSource, state.hideUnconfiguredModels, state.widthWarningStartedAt, state.widthWarningDismissed, state.widthWarningShowCount, state.settingsUpdateState, state.settingsUpdateLatestVersion, false, state.startupLatestVersion, state.versionAlertsEnabled))
+  process.stdout.write(ALT_HOME + renderTable(state.results, state.pendingPings, state.frame, state.cursor, state.sortColumn, state.sortDirection, state.pingInterval, state.lastPingTime, state.mode, state.tierFilterMode, state.scrollOffset, state.terminalRows, state.terminalCols, state.originFilterMode, null, state.pingMode, state.pingModeSource, state.hideUnconfiguredModels, state.widthWarningStartedAt, state.widthWarningDismissed, state.widthWarningShowCount, state.settingsUpdateState, state.settingsUpdateLatestVersion, false, state.startupLatestVersion, state.versionAlertsEnabled, state.favoritesPinnedAndSticky, state.customTextFilter))
   if (process.stdout.isTTY) {
     process.stdout.flush && process.stdout.flush()
   }

package/src/command-palette.js

@@ -15,6 +15,72 @@
  * @see src/overlays.js
  */
 
+import { TOOL_METADATA, TOOL_MODE_ORDER } from './tool-metadata.js'
+
+const TOOL_MODE_DESCRIPTIONS = {
+  opencode: 'Launch in OpenCode CLI with the selected model.',
+  'opencode-desktop': 'Set model in shared config, then open OpenCode Desktop.',
+  openclaw: 'Set default model in OpenClaw and launch it.',
+  crush: 'Launch Crush with this provider/model pair.',
+  goose: 'Launch Goose and preselect the active model.',
+  pi: 'Launch Pi with model/provider flags.',
+  aider: 'Launch Aider configured on the selected model.',
+  qwen: 'Launch Qwen Code using the selected provider model.',
+  openhands: 'Launch OpenHands with the selected model endpoint.',
+  amp: 'Launch Amp with this model as active target.',
+}
+
+const TOOL_MODE_COMMANDS = TOOL_MODE_ORDER.map((toolMode) => {
+  const meta = TOOL_METADATA[toolMode] || { label: toolMode, emoji: '🧰' }
+  return {
+    id: `action-set-tool-${toolMode}`,
+    label: meta.label,
+    toolMode,
+    icon: meta.emoji,
+    description: TOOL_MODE_DESCRIPTIONS[toolMode] || 'Set this as the active launch target.',
+    keywords: ['tool', 'target', 'mode', toolMode, meta.label.toLowerCase()],
+  }
+})
+
+const PING_MODE_COMMANDS = [
+  {
+    id: 'action-cycle-ping-mode',
+    label: 'Cycle ping mode',
+    shortcut: 'W',
+    icon: '⚡',
+    description: 'Rotate speed → normal → slow → forced.',
+    keywords: ['ping', 'mode', 'cycle', 'speed', 'normal', 'slow', 'forced'],
+  },
+  {
+    id: 'action-set-ping-speed',
+    label: 'Speed mode (2s)',
+    pingMode: 'speed',
+    description: 'Fast 2s bursts for short live checks.',
+    keywords: ['ping', 'mode', 'speed', '2s', 'fast'],
+  },
+  {
+    id: 'action-set-ping-normal',
+    label: 'Normal mode (10s)',
+    pingMode: 'normal',
+    description: 'Balanced default cadence for daily use.',
+    keywords: ['ping', 'mode', 'normal', '10s', 'default'],
+  },
+  {
+    id: 'action-set-ping-slow',
+    label: 'Slow mode (30s)',
+    pingMode: 'slow',
+    description: 'Lower refresh cost when you are mostly idle.',
+    keywords: ['ping', 'mode', 'slow', '30s', 'idle'],
+  },
+  {
+    id: 'action-set-ping-forced',
+    label: 'Forced mode (4s)',
+    pingMode: 'forced',
+    description: 'Keeps 4s cadence until manually changed.',
+    keywords: ['ping', 'mode', 'forced', '4s', 'manual'],
+  },
+]
+
 // 📖 Base command tree template (will be enhanced with dynamic model list)
 const BASE_COMMAND_TREE = [
   {
@@ -93,6 +159,41 @@ const BASE_COMMAND_TREE = [
       { id: 'sort-uptime', label: 'Sort by uptime', shortcut: 'U', description: 'Success rate', keywords: ['sort', 'uptime'] },
     ]
   },
+  {
+    id: 'actions',
+    label: 'Actions',
+    icon: '⚙️',
+    children: [
+      {
+        id: 'action-target-tool',
+        label: 'Target tool',
+        icon: '🧰',
+        children: [
+          { id: 'action-cycle-tool-mode', label: 'Cycle target tool', shortcut: 'Z', icon: '🔄', description: 'Rotate through every launcher mode.', keywords: ['tool', 'mode', 'cycle', 'target'] },
+          ...TOOL_MODE_COMMANDS,
+        ],
+      },
+      {
+        id: 'action-ping-mode',
+        label: 'Ping mode',
+        icon: '📶',
+        children: PING_MODE_COMMANDS,
+      },
+      {
+        id: 'action-favorites-mode',
+        label: 'Favorites mode',
+        icon: '⭐',
+        children: [
+          { id: 'action-toggle-favorite-mode', label: 'Toggle favorites mode', shortcut: 'Y', icon: '⭐', description: 'Switch pinned+sticky ↔ normal list behavior.', keywords: ['favorite', 'favorites', 'mode', 'toggle', 'y'] },
+          { id: 'action-favorites-mode-pinned', label: 'Pinned + always visible', favoritesPinned: true, description: 'Favorites stay on top and bypass current filters.', keywords: ['favorite', 'favorites', 'pinned', 'sticky', 'always visible'] },
+          { id: 'action-favorites-mode-normal', label: 'Normal rows (starred only)', favoritesPinned: false, description: 'Favorites keep ⭐ but follow active filters and sort.', keywords: ['favorite', 'favorites', 'normal', 'sort', 'filter'] },
+          { id: 'action-toggle-favorite', label: 'Toggle favorite on selected row', shortcut: 'F', icon: '⭐', description: 'Star/unstar the highlighted model.', keywords: ['favorite', 'star', 'toggle'] },
+        ],
+      },
+      { id: 'action-cycle-theme', label: 'Cycle theme', shortcut: 'G', icon: '🌗', description: 'Switch dark/light/auto', keywords: ['theme', 'dark', 'light', 'auto'] },
+      { id: 'action-reset-view', label: 'Reset view', shortcut: 'Shift+R', icon: '🔄', description: 'Reset filters and sort', keywords: ['reset', 'view', 'sort', 'filters'] },
+    ],
+  },
   // 📖 Pages - directly at root level, not in submenu
   { id: 'open-settings', label: 'Settings', shortcut: 'P', icon: '⚙️', type: 'page', description: 'API keys and preferences', keywords: ['settings', 'config', 'api key'] },
   { id: 'open-help', label: 'Help', shortcut: 'K', icon: '❓', type: 'page', description: 'Show all shortcuts', keywords: ['help', 'shortcuts', 'hotkeys'] },
@@ -100,12 +201,6 @@ const BASE_COMMAND_TREE = [
   { id: 'open-feedback', label: 'Feedback', shortcut: 'I', icon: '📝', type: 'page', description: 'Report bugs or requests', keywords: ['feedback', 'bug', 'request'] },
   { id: 'open-recommend', label: 'Smart recommend', shortcut: 'Q', icon: '🎯', type: 'page', description: 'Find best model for task', keywords: ['recommend', 'best model'] },
   { id: 'open-install-endpoints', label: 'Install endpoints', icon: '🔌', type: 'page', description: 'Install provider catalogs', keywords: ['install', 'endpoints', 'providers'] },
-  // 📖 Actions - directly at root level, not in submenu
-  { id: 'action-cycle-theme', label: 'Cycle theme', shortcut: 'G', icon: '🌗', type: 'action', description: 'Switch dark/light/auto', keywords: ['theme', 'dark', 'light', 'auto'] },
-  { id: 'action-cycle-tool-mode', label: 'Target Tool', shortcut: 'Z', icon: '🔄', type: 'action', description: 'Change target AI Coding CLI Tool.', keywords: ['tool', 'mode', 'launcher', 'target'] },
-  { id: 'action-cycle-ping-mode', label: 'Cycle ping mode', shortcut: 'W', icon: '⚡', type: 'action', description: 'Adjust ping speed', keywords: ['ping', 'cadence', 'speed', 'slow'] },
-  { id: 'action-toggle-favorite', label: 'Toggle favorite', shortcut: 'F', icon: '⭐', type: 'action', description: 'Pin to favorites', keywords: ['favorite', 'star'] },
-  { id: 'action-reset-view', label: 'Reset view', shortcut: 'Shift+R', icon: '🔄', type: 'action', description: 'Reset filters and sort', keywords: ['reset', 'view', 'sort', 'filters'] },
 ]
 
 /**

package/src/config.js

@@ -209,6 +209,7 @@ function normalizeSettingsSection(settings) {
   return {
     ...safeSettings,
     hideUnconfiguredModels: typeof safeSettings.hideUnconfiguredModels === 'boolean' ? safeSettings.hideUnconfiguredModels : true,
+    favoritesPinnedAndSticky: typeof safeSettings.favoritesPinnedAndSticky === 'boolean' ? safeSettings.favoritesPinnedAndSticky : false,
     theme: ['dark', 'light', 'auto'].includes(safeSettings.theme) ? safeSettings.theme : 'auto',
   }
 }
@@ -831,7 +832,7 @@ export function isProviderEnabled(config, providerKey) {
 /**
  * 📖 _emptyProfileSettings: Default TUI settings.
  *
- * @returns {{ tierFilter: string|null, sortColumn: string, sortAsc: boolean, pingInterval: number, hideUnconfiguredModels: boolean, preferredToolMode: string }}
+ * @returns {{ tierFilter: string|null, sortColumn: string, sortAsc: boolean, pingInterval: number, hideUnconfiguredModels: boolean, favoritesPinnedAndSticky: boolean, preferredToolMode: string }}
  */
 export function _emptyProfileSettings() {
   return {
@@ -840,6 +841,7 @@ export function _emptyProfileSettings() {
     sortAsc: true,        // 📖 true = ascending (fastest first for latency)
     pingInterval: 10000,  // 📖 default ms between pings in the steady "normal" mode
     hideUnconfiguredModels: true, // 📖 true = default to providers that are actually configured
+    favoritesPinnedAndSticky: false, // 📖 default mode keeps favorites as normal starred rows; press Y to pin+stick them.
     preferredToolMode: 'opencode', // 📖 remember the last Z-selected launcher across app restarts
     theme: 'auto',        // 📖 'auto' follows the terminal/OS theme, override with 'dark' or 'light' if needed
   }
@@ -848,7 +850,7 @@ export function _emptyProfileSettings() {
 /**
  * 📖 normalizeEndpointInstalls keeps the endpoint-install tracking list safe to replay.
  *
- * 📖 Each entry represents one managed catalog install performed through the `Y` flow:
+ * 📖 Each entry represents one managed catalog install performed through Install Endpoints:
  *   - `providerKey`: FCM provider identifier (`nvidia`, `groq`, ...)
  *   - `toolMode`: canonical tool id (`opencode`, `openclaw`, `crush`, `goose`)
  *   - `scope`: `all` or `selected`

package/src/endpoint-installer.js

@@ -3,7 +3,7 @@
  * @description Install and refresh FCM-managed provider catalogs inside external tool configs.
  *
  * @details
- *   📖 This module powers the `Y` hotkey flow in the TUI.
+ *   📖 This module powers the Install Endpoints flow in the TUI.
  *   It lets users pick one configured provider, choose a target tool, then install either:
  *   - the full provider catalog (`all` models), or
  *   - a curated subset of specific models (`selected`)

package/src/key-handler.js

@@ -519,7 +519,9 @@ export function createKeyHandler(ctx) {
   // 📖 Shared table refresh helper so command-palette and hotkeys keep identical behavior.
   function refreshVisibleSorted({ resetCursor = true } = {}) {
     const visible = state.results.filter(r => !r.hidden)
-    state.visibleSorted = sortResultsWithPinnedFavorites(visible, state.sortColumn, state.sortDirection)
+    state.visibleSorted = sortResultsWithPinnedFavorites(visible, state.sortColumn, state.sortDirection, {
+      pinFavorites: state.favoritesPinnedAndSticky,
+    })
     if (resetCursor) {
       state.cursor = 0
       state.scrollOffset = 0
@@ -600,12 +602,48 @@ export function createKeyHandler(ctx) {
     const modeOrder = getToolModeOrder()
     const currentIndex = modeOrder.indexOf(state.mode)
     const nextIndex = (currentIndex + 1) % modeOrder.length
-    state.mode = modeOrder[nextIndex]
+    setToolMode(modeOrder[nextIndex])
+  }
+
+  // 📖 Keep tool-mode changes centralized so keyboard shortcuts and command palette
+  // 📖 both persist to config exactly the same way.
+  function setToolMode(nextMode) {
+    if (!getToolModeOrder().includes(nextMode)) return
+    state.mode = nextMode
     if (!state.config.settings || typeof state.config.settings !== 'object') state.config.settings = {}
     state.config.settings.preferredToolMode = state.mode
     saveConfig(state.config)
   }
 
+  // 📖 Favorites display mode:
+  // 📖 - true  => favorites stay pinned + always visible (legacy behavior)
+  // 📖 - false => favorites are just starred rows and obey normal sort/filter rules
+  function setFavoritesDisplayMode(nextPinned, { preserveSelection = true } = {}) {
+    const normalizedNextPinned = nextPinned !== false
+    if (state.favoritesPinnedAndSticky === normalizedNextPinned) return
+
+    const selected = preserveSelection ? state.visibleSorted[state.cursor] : null
+    const selectedKey = selected ? toFavoriteKey(selected.providerKey, selected.modelId) : null
+
+    state.favoritesPinnedAndSticky = normalizedNextPinned
+    if (!state.config.settings || typeof state.config.settings !== 'object') state.config.settings = {}
+    state.config.settings.favoritesPinnedAndSticky = state.favoritesPinnedAndSticky
+    saveConfig(state.config)
+
+    applyTierFilter()
+    refreshVisibleSorted({ resetCursor: false })
+
+    if (selectedKey) {
+      const selectedIdx = state.visibleSorted.findIndex((row) => toFavoriteKey(row.providerKey, row.modelId) === selectedKey)
+      if (selectedIdx >= 0) state.cursor = selectedIdx
+      adjustScrollOffset(state)
+    }
+  }
+
+  function toggleFavoritesDisplayMode() {
+    setFavoritesDisplayMode(!state.favoritesPinnedAndSticky)
+  }
+
   function resetViewSettings() {
     state.tierFilterMode = 0
     state.originFilterMode = 0
@@ -631,7 +669,7 @@ export function createKeyHandler(ctx) {
     applyTierFilter()
     refreshVisibleSorted({ resetCursor: false })
 
-    if (wasFavorite) {
+    if (wasFavorite && state.favoritesPinnedAndSticky) {
       state.cursor = 0
       state.scrollOffset = 0
       return
@@ -654,11 +692,28 @@ export function createKeyHandler(ctx) {
   }
 
   function refreshCommandPaletteResults() {
+    const query = (state.commandPaletteQuery || '').trim()
     const tree = buildCommandPaletteTree(state.results || [])
-    const flat = flattenCommandTree(tree, state.commandPaletteExpandedIds)
-    state.commandPaletteResults = filterCommandPaletteEntries(flat, state.commandPaletteQuery)
+    // 📖 Keep collapsed view clean when query is empty, but search across the
+    // 📖 full tree when users type so hidden submenu commands still appear.
+    let flat
+    if (query.length > 0) {
+      const expandedIds = new Set()
+      const collectExpandedIds = (nodes) => {
+        for (const node of nodes || []) {
+          if (Array.isArray(node.children) && node.children.length > 0) {
+            expandedIds.add(node.id)
+            collectExpandedIds(node.children)
+          }
+        }
+      }
+      collectExpandedIds(tree)
+      flat = flattenCommandTree(tree, expandedIds)
+    } else {
+      flat = flattenCommandTree(tree, state.commandPaletteExpandedIds)
+    }
+    state.commandPaletteResults = filterCommandPaletteEntries(flat, query)
 
-    const query = (state.commandPaletteQuery || '').trim()
     if (query.length > 0) {
       state.commandPaletteResults.unshift({
         id: 'filter-custom-text-apply',
@@ -707,6 +762,21 @@ export function createKeyHandler(ctx) {
   function executeCommandPaletteEntry(entry) {
     if (!entry?.id) return
 
+    if (entry.id.startsWith('action-set-ping-') && entry.pingMode) {
+      setPingMode(entry.pingMode, 'manual')
+      return
+    }
+
+    if (entry.id.startsWith('action-set-tool-') && entry.toolMode) {
+      setToolMode(entry.toolMode)
+      return
+    }
+
+    if (entry.id.startsWith('action-favorites-mode-') && typeof entry.favoritesPinned === 'boolean') {
+      setFavoritesDisplayMode(entry.favoritesPinned)
+      return
+    }
+
     if (entry.id.startsWith('filter-tier-')) {
       setTierFilterFromCommand(entry.tier ?? null)
       return
@@ -793,6 +863,7 @@ export function createKeyHandler(ctx) {
         return
       }
       case 'action-toggle-favorite': return toggleFavoriteOnSelectedRow()
+      case 'action-toggle-favorite-mode': return toggleFavoritesDisplayMode()
       case 'action-reset-view': return resetViewSettings()
       default:
         return
@@ -1442,7 +1513,8 @@ export function createKeyHandler(ctx) {
       const providerKeys = Object.keys(sources)
       const updateRowIdx = providerKeys.length
       const themeRowIdx = updateRowIdx + 1
-      const cleanupLegacyProxyRowIdx = themeRowIdx + 1
+      const favoritesModeRowIdx = themeRowIdx + 1
+      const cleanupLegacyProxyRowIdx = favoritesModeRowIdx + 1
       const changelogViewRowIdx = cleanupLegacyProxyRowIdx + 1
         // 📖 Profile system removed - API keys now persist permanently across all sessions
       const maxRowIdx = changelogViewRowIdx
@@ -1523,10 +1595,7 @@ export function createKeyHandler(ctx) {
         setResults(nextResults)
         syncFavoriteFlags(state.results, state.config)
         applyTierFilter()
-        const visible = state.results.filter(r => !r.hidden)
-        state.visibleSorted = sortResultsWithPinnedFavorites(visible, state.sortColumn, state.sortDirection)
-        if (state.cursor >= state.visibleSorted.length) state.cursor = Math.max(0, state.visibleSorted.length - 1)
-        adjustScrollOffset(state)
+        refreshVisibleSorted({ resetCursor: false })
         // 📖 Re-ping all models that were 'noauth' (got 401 without key) but now have a key
         // 📖 This makes the TUI react immediately when a user adds an API key in settings
         const pingModel = getPingModel?.()
@@ -1591,6 +1660,11 @@ export function createKeyHandler(ctx) {
           return
         }
 
+        if (state.settingsCursor === favoritesModeRowIdx) {
+          toggleFavoritesDisplayMode()
+          return
+        }
+
         if (state.settingsCursor === cleanupLegacyProxyRowIdx) {
           runLegacyProxyCleanup()
           return
@@ -1629,6 +1703,10 @@ export function createKeyHandler(ctx) {
           cycleGlobalTheme()
           return
         }
+        if (state.settingsCursor === favoritesModeRowIdx) {
+          toggleFavoritesDisplayMode()
+          return
+        }
         // 📖 Profile system removed - API keys now persist permanently across all sessions
 
         // 📖 Toggle enabled/disabled for selected provider
@@ -1644,6 +1722,7 @@ export function createKeyHandler(ctx) {
         if (
           state.settingsCursor === updateRowIdx
           || state.settingsCursor === themeRowIdx
+          || state.settingsCursor === favoritesModeRowIdx
           || state.settingsCursor === cleanupLegacyProxyRowIdx
           || state.settingsCursor === changelogViewRowIdx
         ) return
@@ -1661,6 +1740,12 @@ export function createKeyHandler(ctx) {
         return
       }
 
+      // 📖 Y toggles favorites display mode directly from Settings.
+      if (key.name === 'y') {
+        toggleFavoritesDisplayMode()
+        return
+      }
+
         // 📖 Profile system removed - API keys now persist permanently across all sessions
 
       if (key.ctrl && key.name === 'c') { exit(0); return }
@@ -1707,7 +1792,20 @@ export function createKeyHandler(ctx) {
       return
     }
 
-    // 📖 Y key freed — Install Endpoints is now accessible only via Settings (P) or Command Palette (Ctrl+P).
+    // 📖 Y key toggles favorites display mode (pinned+sticky vs normal rows).
+    if (key.name === 'y' && !key.ctrl && !key.meta) {
+      toggleFavoritesDisplayMode()
+      return
+    }
+
+    // 📖 X clears the active free-text filter set from the command palette.
+    if (key.name === 'x' && !key.ctrl && !key.meta) {
+      if (!state.customTextFilter) return
+      state.customTextFilter = null
+      applyTierFilter()
+      refreshVisibleSorted({ resetCursor: true })
+      return
+    }
 
     // 📖 Profile system removed - API keys now persist permanently across all sessions
 
@@ -1720,7 +1818,8 @@ export function createKeyHandler(ctx) {
     }
 
     // 📖 Sorting keys: R=rank, O=origin, M=model, L=latest ping, A=avg ping, S=SWE-bench, C=context, H=health, V=verdict, B=stability, U=uptime, G=usage
-    // 📖 T is reserved for tier filter cycling. Y is now free (Install Endpoints moved to Settings/Palette).
+    // 📖 T is reserved for tier filter cycling. Y toggles favorites display mode.
+    // 📖 X clears the active custom text filter.
     // 📖 D is now reserved for provider filter cycling
     // 📖 Shift+R is reserved for reset view settings
     const sortKeys = {
@@ -1763,10 +1862,7 @@ export function createKeyHandler(ctx) {
       state.config.settings.hideUnconfiguredModels = state.hideUnconfiguredModels
       saveConfig(state.config)
       applyTierFilter()
-      const visible = state.results.filter(r => !r.hidden)
-      state.visibleSorted = sortResultsWithPinnedFavorites(visible, state.sortColumn, state.sortDirection)
-      state.cursor = 0
-      state.scrollOffset = 0
+      refreshVisibleSorted({ resetCursor: true })
       return
     }
 
@@ -1775,10 +1871,7 @@ export function createKeyHandler(ctx) {
       state.tierFilterMode = (state.tierFilterMode + 1) % TIER_CYCLE.length
       applyTierFilter()
       // 📖 Recompute visible sorted list and reset cursor to avoid stale index into new filtered set
-      const visible = state.results.filter(r => !r.hidden)
-      state.visibleSorted = sortResultsWithPinnedFavorites(visible, state.sortColumn, state.sortDirection)
-      state.cursor = 0
-      state.scrollOffset = 0
+      refreshVisibleSorted({ resetCursor: true })
       persistUiSettings()
       return
     }
@@ -1788,10 +1881,7 @@ export function createKeyHandler(ctx) {
       state.originFilterMode = (state.originFilterMode + 1) % ORIGIN_CYCLE.length
       applyTierFilter()
       // 📖 Recompute visible sorted list and reset cursor to avoid stale index into new filtered set
-      const visible = state.results.filter(r => !r.hidden)
-      state.visibleSorted = sortResultsWithPinnedFavorites(visible, state.sortColumn, state.sortDirection)
-      state.cursor = 0
-      state.scrollOffset = 0
+      refreshVisibleSorted({ resetCursor: true })
       persistUiSettings()
       return
     }

package/src/overlays.js

@@ -94,7 +94,8 @@ export function createOverlayRenderers(state, deps) {
     const providerKeys = Object.keys(sources)
     const updateRowIdx = providerKeys.length
     const themeRowIdx = updateRowIdx + 1
-    const cleanupLegacyProxyRowIdx = themeRowIdx + 1
+    const favoritesModeRowIdx = themeRowIdx + 1
+    const cleanupLegacyProxyRowIdx = favoritesModeRowIdx + 1
     const changelogViewRowIdx = cleanupLegacyProxyRowIdx + 1
     const EL = '\x1b[K'
     const lines = []
@@ -224,6 +225,16 @@ export function createOverlayRenderers(state, deps) {
     const themeRow = `${bullet(state.settingsCursor === themeRowIdx)}${themeColors.textBold('Global Theme').padEnd(44)} ${themeStatusColor(themeStatus)}`
     cursorLineByRow[themeRowIdx] = lines.length
     lines.push(state.settingsCursor === themeRowIdx ? themeColors.bgCursor(themeRow) : themeRow)
+
+    // 📖 Favorites mode row mirrors Y-key behavior from the main table.
+    const favoritesModeEnabled = state.favoritesPinnedAndSticky === true
+    const favoritesModeStatus = favoritesModeEnabled
+      ? themeColors.warningBold('Pinned + always visible')
+      : themeColors.info('Normal rows (filter/sort)')
+    const favoritesModeRow = `${bullet(state.settingsCursor === favoritesModeRowIdx)}${themeColors.textBold('Favorites Display Mode').padEnd(44)} ${favoritesModeStatus}`
+    cursorLineByRow[favoritesModeRowIdx] = lines.length
+    lines.push(state.settingsCursor === favoritesModeRowIdx ? themeColors.bgCursorSettingsList(favoritesModeRow) : favoritesModeRow)
+
     if (updateState === 'error' && state.settingsUpdateError) {
       lines.push(themeColors.error(`      ${state.settingsUpdateError}`))
     }
@@ -244,7 +255,7 @@ export function createOverlayRenderers(state, deps) {
     if (state.settingsEditMode) {
       lines.push(themeColors.dim('  Type API key  •  Enter Save  •  Esc Cancel'))
     } else {
-      lines.push(themeColors.dim('  ↑↓ Navigate  •  Enter Edit/Run/Cycle  •  + Add key  •  - Remove key  •  Space Toggle/Cycle  •  T Test key  •  U Updates  •  G Global theme  •  Esc Close'))
+      lines.push(themeColors.dim('  ↑↓ Navigate  •  Enter Edit/Run/Cycle  •  + Add key  •  - Remove key  •  Space Toggle/Cycle  •  T Test key  •  U Updates  •  G Global theme  •  Y Favorites mode  •  Esc Close'))
     }
     // 📖 Show sync/restore status message if set
     if (state.settingsSyncStatus) {
@@ -283,7 +294,7 @@ export function createOverlayRenderers(state, deps) {
 
   // ─── Install Endpoints overlay renderer ───────────────────────────────────
   // 📖 renderInstallEndpoints drives the provider → tool → scope → model flow
-  // 📖 behind the `Y` hotkey. It deliberately reuses the same overlay viewport
+  // 📖 opened from Settings/Command Palette. It deliberately reuses the same overlay viewport
   // 📖 helpers as Settings so long provider/model lists stay navigable.
   function renderInstallEndpoints() {
     const EL = '\x1b[K'
@@ -713,8 +724,8 @@ export function createOverlayRenderers(state, deps) {
     lines.push(`  ${label('CTX')}         Context window size (128k, 200k, 256k, 1m, etc.)  ${hint('Sort:')} ${key('C')}`)
     lines.push(`              ${hint('Bigger context = the model can read more of your codebase at once without forgetting.')}`)
     lines.push('')
-    lines.push(`  ${label('Model')}       Model name (⭐ = favorited, pinned at top)  ${hint('Sort:')} ${key('M')}  ${hint('Favorite:')} ${key('F')}`)
-    lines.push(`              ${hint('Star the ones you like — they stay pinned at the top across restarts.')}`)
+    lines.push(`  ${label('Model')}       Model name (⭐ = favorited)  ${hint('Sort:')} ${key('M')}  ${hint('Favorite:')} ${key('F')}`)
+    lines.push(`              ${hint('Star the ones you like. Press Y to switch between pinned mode and normal filter/sort mode.')}`)
     lines.push('')
     lines.push(`  ${label('Provider')}    Provider source (NIM, Groq, Cerebras, etc.)  ${hint('Sort:')} ${key('O')}  ${hint('Cycle:')} ${key('D')}`)
     lines.push(`              ${hint('Same model on different providers can have very different speed and uptime.')}`)
@@ -754,7 +765,9 @@ export function createOverlayRenderers(state, deps) {
     lines.push(`  ${key('Ctrl+P')}  Open ⚡️ command palette  ${hint('(search and run actions quickly)')}`)
     lines.push(`  ${key('E')}  Toggle configured models only  ${hint('(enabled by default)')}`)
     lines.push(`  ${key('Z')}  Cycle tool mode  ${hint('(OpenCode → Desktop → OpenClaw → Crush → Goose → Pi → Aider → Qwen → OpenHands → Amp)')}`)
-    lines.push(`  ${key('F')}  Toggle favorite on selected row  ${hint('(⭐ pinned at top, persisted)')}`)
+    lines.push(`  ${key('F')}  Toggle favorite on selected row  ${hint('(⭐ persisted across sessions)')}`)
+    lines.push(`  ${key('Y')}  Toggle favorites mode  ${hint('(Pinned + always visible ↔ Normal filter/sort behavior)')}`)
+    lines.push(`  ${key('X')}  Clear active text filter  ${hint('(remove custom query applied from ⚡️ Command Palette)')}`)
     lines.push(`  ${key('Q')}  Smart Recommend  ${hint('(🎯 find the best model for your task — questionnaire + live analysis)')}`)
     lines.push(`  ${key('G')}  Cycle theme  ${hint('(auto → dark → light)')}`)
     lines.push(`  ${themeColors.errorBold('I')}  Feedback, bugs & requests  ${hint('(📝 send anonymous feedback, bug reports, or feature requests)')}`)
@@ -770,7 +783,8 @@ export function createOverlayRenderers(state, deps) {
     lines.push(`  ${key('PgUp/PgDn')}    Jump by page`)
     lines.push(`  ${key('Home/End')}     Jump first/last row`)
     lines.push(`  ${key('Enter')}        Edit key / run selected maintenance action`)
-    lines.push(`  ${key('Space')}        Toggle provider enable/disable`)
+    lines.push(`  ${key('Space')}        Toggle selected row option (provider/theme/favorites)`)
+    lines.push(`  ${key('Y')}            Toggle favorites mode (global)`)
     lines.push(`  ${key('T')}            Test selected provider key`)
     lines.push(`  ${key('U')}            Check updates manually`)
     lines.push(`  ${key('G')}            Cycle theme globally`)

package/src/render-helpers.js

@@ -168,10 +168,23 @@ export function calculateViewport(terminalRows, scrollOffset, totalModels, extra
 
 // 📖 sortResultsWithPinnedFavorites: Recommended models are pinned above favorites, favorites above non-favorites.
 // 📖 Recommended: sorted by recommendation score (highest first).
-// 📖 Favorites: keep insertion order (favoriteRank).
+// 📖 Favorites: keep insertion order (favoriteRank) when pinFavorites=true.
 // 📖 Non-favorites: active sort column/direction.
 // 📖 Models that are both recommended AND favorite — show in recommended section.
-export function sortResultsWithPinnedFavorites(results, sortColumn, sortDirection) {
+// 📖 pinFavorites=false keeps favorites highlighted but lets normal sort/filter order apply.
+export function sortResultsWithPinnedFavorites(results, sortColumn, sortDirection, { pinFavorites = true } = {}) {
+  if (!pinFavorites) {
+    const recommendedRows = results
+      .filter((r) => r.isRecommended)
+      .sort((a, b) => (b.recommendScore || 0) - (a.recommendScore || 0))
+    const nonRecommendedRows = sortResults(
+      results.filter((r) => !r.isRecommended),
+      sortColumn,
+      sortDirection
+    )
+    return [...recommendedRows, ...nonRecommendedRows]
+  }
+
   const recommendedRows = results
     .filter((r) => r.isRecommended && !r.isFavorite)
     .sort((a, b) => (b.recommendScore || 0) - (a.recommendScore || 0))

package/src/render-table.js

@@ -13,7 +13,8 @@
  *   - Emoji-aware padding via padEndDisplay for aligned verdict/status cells
  *   - Viewport clipping with above/below indicators
  *   - Smart badges (mode, tier filter, origin filter)
- *   - Install-endpoints shortcut surfaced directly in the footer hints
+ *   - Favorites mode hint surfaced directly in footer hints (`Y`)
+ *   - High-visibility active text-filter banner with one-key clear action (`X`)
  *   - Full-width red outdated-version banner when a newer npm release is known
  *   - Distinct auth-failure vs missing-key health labels so configured providers stay honest
  *
@@ -66,7 +67,7 @@ export const PROVIDER_COLOR = new Proxy({}, {
 })
 
 // ─── renderTable: mode param controls footer hint text (opencode vs openclaw) ─────────
-export function renderTable(results, pendingPings, frame, cursor = null, sortColumn = 'avg', sortDirection = 'asc', pingInterval = PING_INTERVAL, lastPingTime = Date.now(), mode = 'opencode', tierFilterMode = 0, scrollOffset = 0, terminalRows = 0, terminalCols = 0, originFilterMode = 0, legacyStatus = null, pingMode = 'normal', pingModeSource = 'auto', hideUnconfiguredModels = false, widthWarningStartedAt = null, widthWarningDismissed = false, widthWarningShowCount = 0, settingsUpdateState = 'idle', settingsUpdateLatestVersion = null, legacyFlag = false, startupLatestVersion = null, versionAlertsEnabled = true) {
+export function renderTable(results, pendingPings, frame, cursor = null, sortColumn = 'avg', sortDirection = 'asc', pingInterval = PING_INTERVAL, lastPingTime = Date.now(), mode = 'opencode', tierFilterMode = 0, scrollOffset = 0, terminalRows = 0, terminalCols = 0, originFilterMode = 0, legacyStatus = null, pingMode = 'normal', pingModeSource = 'auto', hideUnconfiguredModels = false, widthWarningStartedAt = null, widthWarningDismissed = false, widthWarningShowCount = 0, settingsUpdateState = 'idle', settingsUpdateLatestVersion = null, legacyFlag = false, startupLatestVersion = null, versionAlertsEnabled = true, favoritesPinnedAndSticky = false, customTextFilter = null) {
   // 📖 Filter out hidden models for display
   const visibleResults = results.filter(r => !r.hidden)
 
@@ -237,7 +238,9 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
   }
 
   // 📖 Sort models using the shared helper
-  const sorted = sortResultsWithPinnedFavorites(visibleResults, sortColumn, sortDirection)
+  const sorted = sortResultsWithPinnedFavorites(visibleResults, sortColumn, sortDirection, {
+    pinFavorites: favoritesPinnedAndSticky,
+  })
 
   const lines = [
     `  ${themeColors.accentBold(`🚀 free-coding-models v${LOCAL_VERSION}`)}${modeBadge}${pingControlBadge}${tierBadge}${originBadge}${chalk.reset('')}   ` +
@@ -339,6 +342,7 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
   }
 
   // 📖 Viewport clipping: only render models that fit on screen
+  const hasCustomFilter = typeof customTextFilter === 'string' && customTextFilter.trim().length > 0
   const extraFooterLines = versionStatus.isOutdated ? 1 : 0
   const vp = calculateViewport(terminalRows, scrollOffset, sorted.length, extraFooterLines)
   const paintSweScore = (score, paddedText) => {
@@ -618,10 +622,14 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
   // 📖 states are obvious even when the user misses the smaller header badges.
   const configuredBadgeBg = getTheme() === 'dark' ? [52, 120, 88] : [195, 234, 206]
   const activeHotkey = (keyLabel, text, bg) => themeColors.badge(`${keyLabel}${text}`, bg, getReadableTextRgb(bg))
+  const favoritesModeBg = favoritesPinnedAndSticky ? [157, 122, 48] : [95, 95, 95]
+  const favoritesModeLabel = favoritesPinnedAndSticky ? ' Favorites Pinned' : ' Favorites Normal'
   // 📖 Line 1: core navigation + filtering shortcuts
   lines.push(
     '  ' + hotkey('F', ' Toggle Favorite') +
     themeColors.dim(`  •  `) +
+    activeHotkey('Y', favoritesModeLabel, favoritesModeBg) +
+    themeColors.dim(`  •  `) +
     (tierFilterMode > 0
       ? activeHotkey('T', ` Tier (${activeTierLabel})`, getTierRgb(activeTierLabel))
       : hotkey('T', ' Tier')) +
@@ -673,9 +681,29 @@ export function renderTable(results, pendingPings, frame, cursor = null, sortCol
     lines.push(chalk.bgRed.white.bold(paddedBanner))
   }
 
-  // 📖 Final footer line: changelog shortcut + exit hint (replaces the old proxy notice).
+  // 📖 Final footer line: changelog + optional active text-filter badge + exit hint.
+  let filterBadge = ''
+  if (hasCustomFilter) {
+    const normalizedFilter = customTextFilter.trim().replace(/\s+/g, ' ')
+    const filterPrefix = 'X Disable filter: "'
+    const filterSuffix = '"'
+    const separatorPlain = '  •  '
+    const baseFooterPlain = '  N Changelog' + separatorPlain + 'Ctrl+C Exit'
+    const baseBadgeWidth = displayWidth(` ${filterPrefix}${filterSuffix} `)
+    const availableFilterWidth = terminalCols > 0
+      ? Math.max(8, terminalCols - displayWidth(baseFooterPlain) - displayWidth(separatorPlain) - baseBadgeWidth)
+      : normalizedFilter.length
+    const visibleFilter = normalizedFilter.length > availableFilterWidth
+      ? `${normalizedFilter.slice(0, Math.max(3, availableFilterWidth - 3))}...`
+      : normalizedFilter
+    filterBadge = chalk.bgYellow.black.bold(` ${filterPrefix}${visibleFilter}${filterSuffix} `)
+  }
+
   lines.push(
     '  ' + themeColors.hotkey('N') + themeColors.dim(' Changelog') +
+    (filterBadge
+      ? themeColors.dim('  •  ') + filterBadge
+      : '') +
     themeColors.dim('  •  ') +
     themeColors.dim('Ctrl+C Exit')
   )

package/src/utils.js

@@ -220,7 +220,7 @@ export const getStabilityScore = (r) => {
 //
 // 📖 Supported columns in the sorter.
 // 📖 Most map directly to visible TUI sort hotkeys; `tier` remains available internally
-// 📖 even though the live TUI now reserves `Y` for the install-endpoints flow.
+// 📖 while `Y` is used by the live UI for favorites display mode.
 //   - 'rank'      (R key) — original index from sources.js
 //   - 'tier'      (internal) — tier hierarchy (S+ first, C last)
 //   - 'origin'    (O key) — provider name (all NIM for now, future-proofed)