binocs 0.1.0

data/lib/binocs/tui/colors.rb

@@ -0,0 +1,115 @@
+# frozen_string_literal: true
+
+module Binocs
+  module TUI
+    module Colors
+      # Color pair constants
+      NORMAL = 1
+      HEADER = 2
+      SELECTED = 3
+      METHOD_GET = 4
+      METHOD_POST = 5
+      METHOD_PUT = 6
+      METHOD_DELETE = 7
+      STATUS_SUCCESS = 8
+      STATUS_REDIRECT = 9
+      STATUS_CLIENT_ERROR = 10
+      STATUS_SERVER_ERROR = 11
+      MUTED = 12
+      ERROR = 13
+      BORDER = 14
+      TITLE = 15
+      KEY_HINT = 16
+      SEARCH = 17
+
+      # Pill-style colors (with backgrounds)
+      METHOD_GET_PILL = 18
+      METHOD_POST_PILL = 19
+      METHOD_PUT_PILL = 20
+      METHOD_DELETE_PILL = 21
+      STATUS_SUCCESS_PILL = 22
+      STATUS_REDIRECT_PILL = 23
+      STATUS_CLIENT_ERROR_PILL = 24
+      STATUS_SERVER_ERROR_PILL = 25
+
+      def self.init
+        # Note: Curses.start_color and use_default_colors are called in App#setup_curses
+        # Define color pairs (foreground, background)
+        # -1 means default/transparent background
+        # Colors adjusted for terminal compatibility (BLUE shows as teal in some themes)
+        Curses.init_pair(NORMAL, Curses::COLOR_WHITE, -1)
+        Curses.init_pair(HEADER, Curses::COLOR_YELLOW, -1)
+        Curses.init_pair(SELECTED, Curses::COLOR_BLACK, Curses::COLOR_WHITE)
+        Curses.init_pair(METHOD_GET, Curses::COLOR_BLUE, -1)     # teal in your theme
+        Curses.init_pair(METHOD_POST, Curses::COLOR_YELLOW, -1)
+        Curses.init_pair(METHOD_PUT, Curses::COLOR_MAGENTA, -1)
+        Curses.init_pair(METHOD_DELETE, Curses::COLOR_RED, -1)
+        Curses.init_pair(STATUS_SUCCESS, Curses::COLOR_BLUE, -1) # teal = success
+        Curses.init_pair(STATUS_REDIRECT, Curses::COLOR_YELLOW, -1)
+        Curses.init_pair(STATUS_CLIENT_ERROR, Curses::COLOR_MAGENTA, -1)
+        Curses.init_pair(STATUS_SERVER_ERROR, Curses::COLOR_RED, -1)
+        Curses.init_pair(MUTED, Curses::COLOR_WHITE, -1) # Will use dim attribute
+        Curses.init_pair(ERROR, Curses::COLOR_RED, -1)
+        Curses.init_pair(BORDER, Curses::COLOR_BLUE, -1)
+        Curses.init_pair(TITLE, Curses::COLOR_YELLOW, -1)
+        Curses.init_pair(KEY_HINT, Curses::COLOR_YELLOW, -1)
+        Curses.init_pair(SEARCH, Curses::COLOR_BLACK, Curses::COLOR_YELLOW)
+
+        # Pill-style pairs (text on colored background)
+        # Using colors with best terminal compatibility
+        Curses.init_pair(METHOD_GET_PILL, Curses::COLOR_WHITE, Curses::COLOR_BLUE)
+        Curses.init_pair(METHOD_POST_PILL, Curses::COLOR_BLACK, Curses::COLOR_YELLOW)
+        Curses.init_pair(METHOD_PUT_PILL, Curses::COLOR_WHITE, Curses::COLOR_MAGENTA)
+        Curses.init_pair(METHOD_DELETE_PILL, Curses::COLOR_WHITE, Curses::COLOR_RED)
+        Curses.init_pair(STATUS_SUCCESS_PILL, Curses::COLOR_WHITE, Curses::COLOR_BLUE)
+        Curses.init_pair(STATUS_REDIRECT_PILL, Curses::COLOR_BLACK, Curses::COLOR_YELLOW)
+        Curses.init_pair(STATUS_CLIENT_ERROR_PILL, Curses::COLOR_WHITE, Curses::COLOR_MAGENTA)
+        Curses.init_pair(STATUS_SERVER_ERROR_PILL, Curses::COLOR_WHITE, Curses::COLOR_RED)
+      end
+
+      def self.method_color(method)
+        case method.to_s.upcase
+        when 'GET' then METHOD_GET
+        when 'POST' then METHOD_POST
+        when 'PUT', 'PATCH' then METHOD_PUT
+        when 'DELETE' then METHOD_DELETE
+        else NORMAL
+        end
+      end
+
+      def self.status_color(status)
+        return MUTED if status.nil?
+
+        case status
+        when 200..299 then STATUS_SUCCESS
+        when 300..399 then STATUS_REDIRECT
+        when 400..499 then STATUS_CLIENT_ERROR
+        when 500..599 then STATUS_SERVER_ERROR
+        else NORMAL
+        end
+      end
+
+      def self.method_pill_color(method)
+        case method.to_s.upcase
+        when 'GET' then METHOD_GET_PILL
+        when 'POST' then METHOD_POST_PILL
+        when 'PUT', 'PATCH' then METHOD_PUT_PILL
+        when 'DELETE' then METHOD_DELETE_PILL
+        else NORMAL
+        end
+      end
+
+      def self.status_pill_color(status)
+        return MUTED if status.nil?
+
+        case status
+        when 200..299 then STATUS_SUCCESS_PILL
+        when 300..399 then STATUS_REDIRECT_PILL
+        when 400..499 then STATUS_CLIENT_ERROR_PILL
+        when 500..599 then STATUS_SERVER_ERROR_PILL
+        else NORMAL
+        end
+      end
+    end
+  end
+end

data/lib/binocs/tui/filter_menu.rb

@@ -0,0 +1,162 @@
+# frozen_string_literal: true
+
+module Binocs
+  module TUI
+    class FilterMenu < Window
+      FILTERS = [
+        { key: :method, label: 'HTTP Method', options: %w[GET POST PUT PATCH DELETE] },
+        { key: :status, label: 'Status Code', options: %w[2xx 3xx 4xx 5xx] },
+        { key: :has_exception, label: 'Has Exception', options: [true, false] },
+      ].freeze
+
+      attr_reader :selected_filters
+
+      def initialize(height:, width:, top:, left:)
+        super
+        @selected_index = 0
+        @selected_filters = {}
+        @expanded_filter = nil
+        @option_index = 0
+      end
+
+      def set_filters(filters)
+        @selected_filters = filters.dup
+      end
+
+      def move_up
+        if @expanded_filter
+          @option_index = [@option_index - 1, 0].max
+        else
+          @selected_index = [@selected_index - 1, 0].max
+        end
+      end
+
+      def move_down
+        if @expanded_filter
+          max = current_filter[:options].length
+          @option_index = [@option_index + 1, max].min # +1 for "Clear" option
+        else
+          @selected_index = [@selected_index + 1, FILTERS.length - 1].min
+        end
+      end
+
+      def select
+        if @expanded_filter
+          filter = current_filter
+          if @option_index >= filter[:options].length
+            # Clear option selected
+            @selected_filters.delete(filter[:key])
+          else
+            value = filter[:options][@option_index]
+            @selected_filters[filter[:key]] = value
+          end
+          @expanded_filter = nil
+          @option_index = 0
+        else
+          @expanded_filter = @selected_index
+          @option_index = 0
+        end
+      end
+
+      def back
+        if @expanded_filter
+          @expanded_filter = nil
+          @option_index = 0
+          false
+        else
+          true
+        end
+      end
+
+      def draw
+        clear
+        draw_box('Filters')
+
+        y = 2
+
+        FILTERS.each_with_index do |filter, i|
+          is_selected = i == @selected_index && @expanded_filter.nil?
+          is_expanded = i == @expanded_filter
+
+          # Draw filter label
+          label = "#{filter[:label]}: "
+          current_value = @selected_filters[filter[:key]]
+          value_text = current_value ? current_value.to_s : 'Any'
+
+          if is_selected
+            @win.attron(Curses.color_pair(Colors::SELECTED)) do
+              @win.setpos(y, 2)
+              @win.addstr(' ' * (@width - 4))
+            end
+            write(y, 3, label, Colors::SELECTED, Curses::A_BOLD)
+            write(y, 3 + label.length, value_text, Colors::SELECTED)
+            write(y, @width - 5, '▶', Colors::SELECTED)
+          else
+            write(y, 3, label, Colors::MUTED)
+            color = current_value ? Colors::HEADER : Colors::MUTED
+            write(y, 3 + label.length, value_text, color)
+          end
+
+          y += 1
+
+          # Draw expanded options
+          if is_expanded
+            filter[:options].each_with_index do |option, oi|
+              is_option_selected = oi == @option_index
+              is_current = @selected_filters[filter[:key]] == option
+
+              if is_option_selected
+                @win.attron(Curses.color_pair(Colors::SELECTED)) do
+                  @win.setpos(y, 4)
+                  @win.addstr(' ' * (@width - 8))
+                end
+                write(y, 5, option.to_s, Colors::SELECTED)
+                write(y, @width - 7, '✓', Colors::SELECTED) if is_current
+              else
+                color = is_current ? Colors::STATUS_SUCCESS : Colors::NORMAL
+                write(y, 5, option.to_s, color)
+                write(y, @width - 7, '✓', Colors::STATUS_SUCCESS) if is_current
+              end
+              y += 1
+            end
+
+            # Clear option
+            is_clear_selected = @option_index >= filter[:options].length
+            if is_clear_selected
+              @win.attron(Curses.color_pair(Colors::SELECTED)) do
+                @win.setpos(y, 4)
+                @win.addstr(' ' * (@width - 8))
+              end
+              write(y, 5, '(Clear)', Colors::SELECTED)
+            else
+              write(y, 5, '(Clear)', Colors::MUTED, Curses::A_DIM)
+            end
+            y += 1
+          end
+
+          y += 1
+          break if y >= @height - 4
+        end
+
+        # Footer
+        draw_footer
+
+        refresh
+      end
+
+      private
+
+      def current_filter
+        FILTERS[@expanded_filter || @selected_index]
+      end
+
+      def draw_footer
+        y = @height - 2
+        write(y - 1, 1, '─' * (@width - 2), Colors::BORDER)
+
+        hints = @expanded_filter ? 'Enter:select  Esc:back' : 'Enter:expand  c:clear all  Esc:close'
+        write(y, @width - hints.length - 2, hints, Colors::KEY_HINT, Curses::A_DIM)
+      end
+    end
+  end
+end

data/lib/binocs/tui/help_screen.rb

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+module Binocs
+  module TUI
+    class HelpScreen < Window
+      KEYBINDINGS = [
+        ['Navigation', [
+          ['j / ↓', 'Move down / Scroll down'],
+          ['k / ↑', 'Move up / Scroll up'],
+          ['g / Home', 'Go to top'],
+          ['G / End', 'Go to bottom'],
+          ['Ctrl+d/n / PgDn', 'Page down'],
+          ['Ctrl+u/p / PgUp', 'Page up'],
+        ]],
+        ['Actions', [
+          ['Enter / l', 'View request details'],
+          ['h / Esc', 'Go back / Close'],
+          ['n / J', 'Next request (detail view)'],
+          ['p / K', 'Prev request (detail view)'],
+          ['d', 'Delete request'],
+          ['D', 'Delete all requests'],
+          ['a', 'View all agents (from list)'],
+        ]],
+        ['Tabs (Detail View)', [
+          ['Tab / ] / L', 'Next tab'],
+          ['Shift+Tab / [ / H', 'Previous tab'],
+          ['1-8', 'Jump to tab by number'],
+          ['a', 'Agent tab + start input'],
+          ['c', 'Copy tab content to clipboard'],
+          ['o', 'Open Swagger docs in browser'],
+        ]],
+        ['Agent Tab', [
+          ['i / Enter', 'Start composing prompt'],
+          ['j / k', 'Scroll output up/down'],
+          ['t', 'Change AI tool (Claude/OpenCode)'],
+          ['w', 'Toggle worktree mode'],
+          ['s', 'Stop running agent'],
+          ['Esc', 'Cancel input'],
+        ]],
+        ['Agents View', [
+          ['Enter', 'Go to request Agent tab'],
+          ['l', 'View raw log output'],
+          ['d', 'Delete/cleanup agent'],
+          ['o', 'Open worktree folder'],
+          ['r', 'Refresh agents list'],
+        ]],
+        ['Filtering', [
+          ['/', 'Search by path'],
+          ['f', 'Open filter menu'],
+          ['c', 'Clear all filters'],
+        ]],
+        ['Other', [
+          ['r', 'Refresh list'],
+          ['?', 'Toggle this help'],
+          ['Space s', 'Spirit animal (detail view)'],
+          ['q', 'Quit'],
+        ]],
+      ].freeze
+
+      def draw
+        clear
+        draw_box('Help - Keybindings')
+
+        y = 2
+        KEYBINDINGS.each do |section_name, bindings|
+          # Section header
+          write(y, 3, "── #{section_name} ", Colors::HEADER, Curses::A_BOLD)
+          y += 1
+
+          bindings.each do |key, description|
+            # Key
+            @win.attron(Curses.color_pair(Colors::KEY_HINT) | Curses::A_BOLD) do
+              @win.setpos(y, 4)
+              @win.addstr(key.ljust(16))
+            end
+
+            # Description
+            write(y, 21, description, Colors::NORMAL)
+            y += 1
+          end
+
+          y += 1
+          break if y >= @height - 3
+        end
+
+        # Footer
+        write(@height - 2, 3, 'Press ? or Esc to close', Colors::MUTED, Curses::A_DIM)
+
+        refresh
+      end
+    end
+  end
+end