free-coding-models 0.3.19 → 0.3.22

package/src/key-handler.js

@@ -31,7 +31,8 @@ import { loadChangelog } from './changelog-loader.js'
 import { loadConfig, replaceConfigContents } from './config.js'
 import { cleanupLegacyProxyArtifacts } from './legacy-proxy-cleanup.js'
 import { cycleThemeSetting, detectActiveTheme } from './theme.js'
-import { buildCommandPaletteEntries, filterCommandPaletteEntries } from './command-palette.js'
+import { buildCommandPaletteTree, flattenCommandTree, filterCommandPaletteEntries } from './command-palette.js'
+import { WIDTH_WARNING_MIN_COLS } from './constants.js'
 
 // 📖 Some providers need an explicit probe model because the first catalog entry
 // 📖 is not guaranteed to be accepted by their chat endpoint.
@@ -447,38 +448,6 @@ export function createKeyHandler(ctx) {
     }
   }
 
-  // 📖 Keep the width-warning runtime state synced with the persisted Settings toggle
-  // 📖 so the overlay reacts immediately when the user enables or disables it.
-  function syncWidthsWarningState() {
-    const widthsWarningDisabled = state.config.settings?.disableWidthsWarning === true
-    state.disableWidthsWarning = widthsWarningDisabled
-
-    if (widthsWarningDisabled) {
-      state.widthWarningStartedAt = null
-      state.widthWarningDismissed = false
-      return
-    }
-
-    state.widthWarningShowCount = 0
-    if ((state.terminalCols || 80) < 166) {
-      state.widthWarningStartedAt = Date.now()
-      state.widthWarningDismissed = false
-      return
-    }
-
-    state.widthWarningStartedAt = null
-    state.widthWarningDismissed = false
-  }
-
-  // 📖 Toggle the width-warning setting and apply the effect immediately instead
-  // 📖 of waiting for a resize or restart.
-  function toggleWidthsWarningSetting() {
-    if (!state.config.settings) state.config.settings = {}
-    state.config.settings.disableWidthsWarning = !state.config.settings.disableWidthsWarning
-    syncWidthsWarningState()
-    saveConfig(state.config)
-  }
-
   // 📖 Theme switches need to update both persisted preference and the live
   // 📖 semantic palette immediately so every screen redraw adopts the new colors.
   function applyThemeSetting(nextTheme) {
@@ -640,6 +609,7 @@ export function createKeyHandler(ctx) {
   function resetViewSettings() {
     state.tierFilterMode = 0
     state.originFilterMode = 0
+    state.customTextFilter = null  // 📖 Clear ephemeral text filter on view reset
     state.sortColumn = 'avg'
     state.sortDirection = 'asc'
     if (!state.config.settings || typeof state.config.settings !== 'object') state.config.settings = {}
@@ -684,8 +654,33 @@ export function createKeyHandler(ctx) {
   }
 
   function refreshCommandPaletteResults() {
-    const commands = buildCommandPaletteEntries()
-    state.commandPaletteResults = filterCommandPaletteEntries(commands, state.commandPaletteQuery)
+    const tree = buildCommandPaletteTree(state.results || [])
+    const flat = flattenCommandTree(tree, state.commandPaletteExpandedIds)
+    state.commandPaletteResults = filterCommandPaletteEntries(flat, state.commandPaletteQuery)
+
+    const query = (state.commandPaletteQuery || '').trim()
+    if (query.length > 0) {
+      state.commandPaletteResults.unshift({
+        id: 'filter-custom-text-apply',
+        label: `🔍 Apply text filter: ${query}`,
+        type: 'command',
+        depth: 0,
+        hasChildren: false,
+        isExpanded: false,
+        filterQuery: query,
+      })
+    } else if (state.customTextFilter) {
+      state.commandPaletteResults.unshift({
+        id: 'filter-custom-text-remove',
+        label: `❌ Remove custom filter: ${state.customTextFilter}`,
+        type: 'command',
+        depth: 0,
+        hasChildren: false,
+        isExpanded: false,
+        filterQuery: null,
+      })
+    }
+
     if (state.commandPaletteCursor >= state.commandPaletteResults.length) {
       state.commandPaletteCursor = Math.max(0, state.commandPaletteResults.length - 1)
     }
@@ -713,7 +708,43 @@ export function createKeyHandler(ctx) {
     if (!entry?.id) return
 
     if (entry.id.startsWith('filter-tier-')) {
-      setTierFilterFromCommand(entry.tierValue ?? null)
+      setTierFilterFromCommand(entry.tier ?? null)
+      return
+    }
+
+    if (entry.id.startsWith('filter-provider-') && entry.id !== 'filter-provider-cycle') {
+      if (entry.providerKey === null || entry.providerKey === undefined) {
+        state.originFilterMode = 0 // All
+      } else {
+        state.originFilterMode = ORIGIN_CYCLE.findIndex(key => key === entry.providerKey) + 1
+        if (state.originFilterMode <= 0) state.originFilterMode = 0
+      }
+      applyTierFilter()
+      refreshVisibleSorted({ resetCursor: true })
+      persistUiSettings()
+      return
+    }
+
+    if (entry.id.startsWith('filter-model-')) {
+      if (entry.modelId && entry.providerKey) {
+        state.customTextFilter = `${entry.providerKey}/${entry.modelId}`
+        applyTierFilter()
+        refreshVisibleSorted({ resetCursor: true })
+      }
+      return
+    }
+
+    // 📖 Custom text filter — apply or remove the free-text filter from the command palette.
+    if (entry.id === 'filter-custom-text-apply') {
+      state.customTextFilter = entry.filterQuery || null
+      applyTierFilter()
+      refreshVisibleSorted({ resetCursor: true })
+      return
+    }
+    if (entry.id === 'filter-custom-text-remove') {
+      state.customTextFilter = null
+      applyTierFilter()
+      refreshVisibleSorted({ resetCursor: true })
       return
     }
 
@@ -789,6 +820,7 @@ export function createKeyHandler(ctx) {
       if (key.ctrl && key.name === 'c') { exit(0); return }
 
       const pageStep = Math.max(1, (state.terminalRows || 1) - 10)
+      const selected = state.commandPaletteResults[state.commandPaletteCursor]
 
       if (key.name === 'escape') {
         closeCommandPalette()
@@ -806,6 +838,23 @@ export function createKeyHandler(ctx) {
         state.commandPaletteCursor = state.commandPaletteCursor < count - 1 ? state.commandPaletteCursor + 1 : 0
         return
       }
+      if (key.name === 'left') {
+        if (selected?.hasChildren && selected.isExpanded) {
+          state.commandPaletteExpandedIds.delete(selected.id)
+          refreshCommandPaletteResults()
+        }
+        return
+      }
+      if (key.name === 'right') {
+        if (selected?.hasChildren && !selected.isExpanded) {
+          state.commandPaletteExpandedIds.add(selected.id)
+          refreshCommandPaletteResults()
+        } else if (selected?.type === 'command') {
+          closeCommandPalette()
+          executeCommandPaletteEntry(selected)
+        }
+        return
+      }
       if (key.name === 'pageup') {
         state.commandPaletteCursor = Math.max(0, state.commandPaletteCursor - pageStep)
         return
@@ -831,9 +880,17 @@ export function createKeyHandler(ctx) {
         return
       }
       if (key.name === 'return') {
-        const selectedCommand = state.commandPaletteResults[state.commandPaletteCursor]
-        closeCommandPalette()
-        executeCommandPaletteEntry(selectedCommand)
+        if (selected?.hasChildren) {
+          if (selected.isExpanded) {
+            state.commandPaletteExpandedIds.delete(selected.id)
+          } else {
+            state.commandPaletteExpandedIds.add(selected.id)
+          }
+          refreshCommandPaletteResults()
+        } else {
+          closeCommandPalette()
+          executeCommandPaletteEntry(selected)
+        }
         return
       }
       if (str && str.length === 1 && !key.ctrl && !key.meta) {
@@ -1384,8 +1441,7 @@ export function createKeyHandler(ctx) {
     if (state.settingsOpen) {
       const providerKeys = Object.keys(sources)
       const updateRowIdx = providerKeys.length
-      const widthWarningRowIdx = updateRowIdx + 1
-      const themeRowIdx = widthWarningRowIdx + 1
+      const themeRowIdx = updateRowIdx + 1
       const cleanupLegacyProxyRowIdx = themeRowIdx + 1
       const changelogViewRowIdx = cleanupLegacyProxyRowIdx + 1
         // 📖 Profile system removed - API keys now persist permanently across all sessions
@@ -1530,12 +1586,6 @@ export function createKeyHandler(ctx) {
           return
         }
 
-        // 📖 Widths Warning toggle (Enter to toggle)
-        if (state.settingsCursor === widthWarningRowIdx) {
-          toggleWidthsWarningSetting()
-          return
-        }
-
         if (state.settingsCursor === themeRowIdx) {
           cycleGlobalTheme()
           return
@@ -1579,11 +1629,6 @@ export function createKeyHandler(ctx) {
           cycleGlobalTheme()
           return
         }
-        // 📖 Widths Warning toggle (disable/enable)
-        if (state.settingsCursor === widthWarningRowIdx) {
-          toggleWidthsWarningSetting()
-          return
-        }
         // 📖 Profile system removed - API keys now persist permanently across all sessions
 
         // 📖 Toggle enabled/disabled for selected provider
@@ -1598,7 +1643,6 @@ export function createKeyHandler(ctx) {
       if (key.name === 't') {
         if (
           state.settingsCursor === updateRowIdx
-          || state.settingsCursor === widthWarningRowIdx
           || state.settingsCursor === themeRowIdx
           || state.settingsCursor === cleanupLegacyProxyRowIdx
           || state.settingsCursor === changelogViewRowIdx
@@ -1663,11 +1707,7 @@ export function createKeyHandler(ctx) {
       return
     }
 
-    // 📖 Y key: open Install Endpoints flow for configured providers.
-    if (key.name === 'y') {
-      openInstallEndpointsOverlay()
-      return
-    }
+    // 📖 Y key freed — Install Endpoints is now accessible only via Settings (P) or Command Palette (Ctrl+P).
 
     // 📖 Profile system removed - API keys now persist permanently across all sessions
 
@@ -1680,7 +1720,7 @@ 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 now opens the install-endpoints flow.
+    // 📖 T is reserved for tier filter cycling. Y is now free (Install Endpoints moved to Settings/Palette).
     // 📖 D is now reserved for provider filter cycling
     // 📖 Shift+R is reserved for reset view settings
     const sortKeys = {
@@ -1805,7 +1845,7 @@ export function createKeyHandler(ctx) {
     }
 
     // 📖 Esc can dismiss the narrow-terminal warning immediately without quitting the app.
-    if (key.name === 'escape' && state.terminalCols > 0 && state.terminalCols < 166) {
+    if (key.name === 'escape' && state.terminalCols > 0 && state.terminalCols < WIDTH_WARNING_MIN_COLS) {
       state.widthWarningDismissed = true
       return
     }

package/src/overlays.js

@@ -93,8 +93,7 @@ export function createOverlayRenderers(state, deps) {
   function renderSettings() {
     const providerKeys = Object.keys(sources)
     const updateRowIdx = providerKeys.length
-    const widthWarningRowIdx = updateRowIdx + 1
-    const themeRowIdx = widthWarningRowIdx + 1
+    const themeRowIdx = updateRowIdx + 1
     const cleanupLegacyProxyRowIdx = themeRowIdx + 1
     const changelogViewRowIdx = cleanupLegacyProxyRowIdx + 1
     const EL = '\x1b[K'
@@ -220,14 +219,6 @@ export function createOverlayRenderers(state, deps) {
     const updateRow = `${bullet(updateCursor)}${themeColors.textBold(updateActionLabel).padEnd(44)} ${updateStatus}`
     cursorLineByRow[updateRowIdx] = lines.length
     lines.push(updateCursor ? themeColors.bgCursor(updateRow) : updateRow)
-    // 📖 Width warning visibility row for the startup narrow-terminal overlay.
-    const disableWidthsWarning = Boolean(state.config.settings?.disableWidthsWarning)
-    const widthWarningStatus = disableWidthsWarning
-      ? themeColors.errorBold('🙈 Disabled')
-      : themeColors.successBold('👁 Enabled')
-    const widthWarningRow = `${bullet(state.settingsCursor === widthWarningRowIdx)}${themeColors.textBold('Small Width Warnings').padEnd(44)} ${widthWarningStatus}`
-    cursorLineByRow[widthWarningRowIdx] = lines.length
-    lines.push(state.settingsCursor === widthWarningRowIdx ? themeColors.bgCursor(widthWarningRow) : widthWarningRow)
     const themeStatus = getThemeStatusLabel(activeThemeSetting())
     const themeStatusColor = themeStatus.includes('Dark') ? themeColors.warningBold : themeColors.info
     const themeRow = `${bullet(state.settingsCursor === themeRowIdx)}${themeColors.textBold('Global Theme').padEnd(44)} ${themeStatusColor(themeStatus)}`
@@ -537,18 +528,16 @@ export function createOverlayRenderers(state, deps) {
 
   // ─── Command palette renderer ──────────────────────────────────────────────
   // 📖 renderCommandPalette draws a centered floating modal over the live table.
-  // 📖 It returns cursor-positioned ANSI rows instead of replacing the full screen,
-  // 📖 so ping updates continue to animate in the background behind the palette.
+  // 📖 Supports hierarchical categories with expand/collapse and rich colors.
   function renderCommandPalette() {
     const terminalRows = state.terminalRows || 24
     const terminalCols = state.terminalCols || 80
-    const panelWidth = Math.max(44, Math.min(96, terminalCols - 8))
-    const panelInnerWidth = Math.max(28, panelWidth - 4)
+    const panelWidth = Math.max(52, Math.min(100, terminalCols - 8))
+    const panelInnerWidth = Math.max(32, panelWidth - 4)
     const panelPad = 2
     const panelOuterWidth = panelWidth + (panelPad * 2)
-    const footerRowCount = 2
-    const headerRowCount = 3
-    const bodyRows = Math.max(6, Math.min(16, terminalRows - 12))
+    const headerRowCount = 4
+    const bodyRows = Math.max(8, Math.min(18, terminalRows - 12))
 
     const truncatePlain = (text, width) => {
       if (width <= 1) return ''
@@ -568,30 +557,70 @@ export function createOverlayRenderers(state, deps) {
     }
 
     const allResults = Array.isArray(state.commandPaletteResults) ? state.commandPaletteResults.slice(0, 80) : []
-    const groupedLines = []
+    const panelLines = []
     const cursorLineByRow = {}
-    let category = null
 
     if (allResults.length === 0) {
-      groupedLines.push(themeColors.dim('  No command found. Try a broader query.'))
+      panelLines.push(themeColors.dim('  No commands found. Try a different search.'))
     } else {
       for (let idx = 0; idx < allResults.length; idx++) {
         const entry = allResults[idx]
-        if (entry.category !== category) {
-          category = entry.category
-          groupedLines.push(themeColors.textBold(` ${category}`))
+        const isCursor = idx === state.commandPaletteCursor
+        
+        const indent = '  '.repeat(entry.depth || 0)
+        const expandIndicator = entry.hasChildren
+          ? (entry.isExpanded ? themeColors.infoBold('▼') : themeColors.dim('▶'))
+          : themeColors.dim('•')
+        
+        // 📖 Only use icon from entry, label should NOT include emoji
+        const iconPrefix = entry.icon ? `${entry.icon} ` : ''
+        const plainLabel = truncatePlain(entry.label, panelInnerWidth - indent.length - iconPrefix.length - 4)
+        const label = entry.matchPositions ? highlightMatch(plainLabel, entry.matchPositions) : plainLabel
+        
+        let rowLine
+        if (entry.type === 'category') {
+          rowLine = `${indent}${expandIndicator} ${iconPrefix}${themeColors.headerBold(label)}`
+        } else if (entry.type === 'subcategory') {
+          rowLine = `${indent}${expandIndicator} ${iconPrefix}${themeColors.textBold(label)}`
+        } else if (entry.type === 'page') {
+          // 📖 Pages are at root level with icon + label + shortcut + description
+          const shortcut = entry.shortcut ? themeColors.dim(` (${entry.shortcut})`) : ''
+          const description = entry.description ? themeColors.dim(` — ${entry.description}`) : ''
+          rowLine = `${expandIndicator} ${iconPrefix}${themeColors.textBold(label)}${shortcut}${description}`
+        } else if (entry.type === 'action') {
+          // 📖 Actions are at root level with icon + label + shortcut + description
+          const shortcut = entry.shortcut ? themeColors.dim(` (${entry.shortcut})`) : ''
+          const description = entry.description ? themeColors.dim(` — ${entry.description}`) : ''
+          rowLine = `${expandIndicator} ${iconPrefix}${themeColors.textBold(label)}${shortcut}${description}`
+        } else {
+          // 📖 Regular commands in submenus
+          const shortcut = entry.shortcut ? themeColors.dim(` (${entry.shortcut})`) : ''
+          const description = entry.description ? themeColors.dim(` — ${entry.description}`) : ''
+          // 📖 Color tiers and providers
+          let coloredLabel = label
+          let prefixWithIcon = iconPrefix
+          
+          if (entry.providerKey && !entry.icon) {
+            // 📖 Model filter: add provider icon
+            const providerIcon = '🏢'
+            prefixWithIcon = `${providerIcon} `
+            coloredLabel = themeColors.provider(entry.providerKey, label, { bold: false })
+          } else if (entry.tier) {
+            coloredLabel = themeColors.tier(entry.tier, label)
+          } else if (entry.providerKey) {
+            coloredLabel = themeColors.provider(entry.providerKey, label, { bold: false })
+          }
+          
+          rowLine = `${indent}  ${expandIndicator} ${prefixWithIcon}${coloredLabel}${shortcut}${description}`
         }
 
-        const isCursor = idx === state.commandPaletteCursor
-        const pointer = isCursor ? themeColors.accentBold('  ❯ ') : themeColors.dim('    ')
-        const shortcutText = entry.shortcut ? themeColors.dim(entry.shortcut) : ''
-        const shortcutWidth = entry.shortcut ? Math.min(16, displayWidth(entry.shortcut)) : 0
-        const labelMax = Math.max(12, panelInnerWidth - 8 - shortcutWidth)
-        const plainLabel = truncatePlain(entry.label, labelMax)
-        const label = highlightMatch(plainLabel, entry.matchPositions)
-        const row = `${pointer}${padEndDisplay(label, labelMax)}${entry.shortcut ? ` ${shortcutText}` : ''}`
-        cursorLineByRow[idx] = groupedLines.length
-        groupedLines.push(isCursor ? themeColors.bgCursor(row) : row)
+        cursorLineByRow[idx] = panelLines.length
+        
+        if (isCursor) {
+          panelLines.push(themeColors.bgCursor(rowLine))
+        } else {
+          panelLines.push(rowLine)
+        }
       }
     }
 
@@ -599,44 +628,43 @@ export function createOverlayRenderers(state, deps) {
     state.commandPaletteScrollOffset = keepOverlayTargetVisible(
       state.commandPaletteScrollOffset,
       targetLine,
-      groupedLines.length,
+      panelLines.length,
       bodyRows
     )
-    const { visible, offset } = sliceOverlayLines(groupedLines, state.commandPaletteScrollOffset, bodyRows)
+    const { visible, offset } = sliceOverlayLines(panelLines, state.commandPaletteScrollOffset, bodyRows)
     state.commandPaletteScrollOffset = offset
 
     const query = state.commandPaletteQuery || ''
     const queryWithCursor = query.length > 0
-      ? themeColors.textBold(`${query}▏`)
-      : themeColors.dim('type a command…') + themeColors.accentBold('▏')
+      ? `${query}${themeColors.accentBold('▏')}`
+      : themeColors.accentBold('▏') + themeColors.dim(' Search commands…')
 
-    const panelLines = []
-    const title = themeColors.textBold('Command Palette')
+    const headerLines = []
+    const title = themeColors.headerBold('⚡️ Command Palette')
     const titleLeft = ` ${title}`
-    const titleRight = themeColors.dim('Esc close')
-    const titleWidth = Math.max(1, panelInnerWidth - 1 - displayWidth('Esc close'))
-    panelLines.push(`${padEndDisplay(titleLeft, titleWidth)} ${titleRight}`)
-    panelLines.push(` ${padEndDisplay(`> ${queryWithCursor}`, panelInnerWidth)}`)
-    panelLines.push(themeColors.dim(` ${'-'.repeat(Math.max(1, panelInnerWidth))}`))
-
-    for (const line of visible) {
-      panelLines.push(` ${padEndDisplay(line, panelInnerWidth)}`)
-    }
+    const titleRight = themeColors.dim('Esc')
+    const titleWidth = Math.max(1, panelInnerWidth - 1 - displayWidth('Esc'))
+    headerLines.push(`${padEndDisplay(titleLeft, titleWidth)} ${titleRight}`)
+    headerLines.push(` ${padEndDisplay(`> ${queryWithCursor}`, panelInnerWidth)}`)
+    headerLines.push(themeColors.dim(` ${'─'.repeat(Math.max(1, panelInnerWidth))}`))
+
+    const footerLines = [
+      themeColors.dim(` ${'─'.repeat(Math.max(1, panelInnerWidth))}`),
+      ` ${padEndDisplay(themeColors.dim('↵ Select • ← → Expand'), panelInnerWidth)}`,
+      ` ${padEndDisplay(themeColors.dim('↑↓ Navigate • Type search'), panelInnerWidth)}`,
+    ]
 
-    // 📖 Keep panel body stable by filling with blank rows when result list is short.
-    while (panelLines.length < bodyRows + headerRowCount) {
-      panelLines.push(` ${' '.repeat(panelInnerWidth)}`)
+    const allPanelLines = [...headerLines, ...visible, ...footerLines]
+    
+    while (allPanelLines.length < bodyRows + headerRowCount + 3) {
+      allPanelLines.splice(headerLines.length + visible.length, 0, ` ${' '.repeat(panelInnerWidth)}`)
     }
 
-    panelLines.push(themeColors.dim(` ${'-'.repeat(Math.max(1, panelInnerWidth))}`))
-    panelLines.push(` ${padEndDisplay(themeColors.dim('↑↓ navigate • Enter run • Type to search'), panelInnerWidth)}`)
-    panelLines.push(` ${padEndDisplay(themeColors.dim('PgUp/PgDn • Home/End'), panelInnerWidth)}`)
-
     const blankPaddedLine = ' '.repeat(panelOuterWidth)
     const paddedPanelLines = [
       blankPaddedLine,
       blankPaddedLine,
-      ...panelLines.map((line) => `${' '.repeat(panelPad)}${padEndDisplay(line, panelWidth)}${' '.repeat(panelPad)}`),
+      ...allPanelLines.map((line) => `${' '.repeat(panelPad)}${padEndDisplay(line, panelWidth)}${' '.repeat(panelPad)}`),
       blankPaddedLine,
       blankPaddedLine,
     ]
@@ -650,8 +678,6 @@ export function createOverlayRenderers(state, deps) {
       return themeColors.overlayBgCommandPalette(padded)
     })
 
-    // 📖 Absolute cursor positioning overlays the palette on top of the existing table.
-    // 📖 The next frame starts with ALT_HOME, so this remains stable without manual cleanup.
     return tintedLines
       .map((line, idx) => `\x1b[${top + idx};${left}H${line}`)
       .join('')
@@ -725,11 +751,10 @@ export function createOverlayRenderers(state, deps) {
     lines.push('')
     lines.push(`  ${heading('Controls')}`)
     lines.push(`  ${key('W')}  Toggle ping mode  ${hint('(speed 2s → normal 10s → slow 30s → forced 4s)')}`)
-    lines.push(`  ${key('Ctrl+P')}  Open command palette  ${hint('(search and run actions quickly)')}`)
+    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('Y')}  Install endpoints  ${hint('(provider catalog → compatible tools, direct provider only)')}`)
     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)')}`)

package/src/product-flags.js

@@ -1,14 +1,9 @@
 /**
  * @file src/product-flags.js
- * @description Product-level copy for temporarily unavailable surfaces.
+ * @description Product-level flags and feature gates.
  *
  * @details
- *   📖 The proxy bridge is being rebuilt from scratch. The main TUI still
- *   📖 shows a clear status line so users know the missing integration is
- *   📖 intentional instead of silently broken.
- *
- * @exports PROXY_DISABLED_NOTICE
+ *   📖 Previously held PROXY_DISABLED_NOTICE for the proxy bridge rebuild.
+ *   📖 That notice was removed in 0.3.22 after the proxy surface was fully
+ *   📖 retired. File kept as a home for future product-level flags.
  */
-
-// 📖 Public note rendered in the main TUI footer and reused in CLI/runtime guards.
-export const PROXY_DISABLED_NOTICE = 'ℹ️ Proxy is temporarily disabled while we rebuild it into a much more stable bridge for external tools.'