binocs 0.1.0

data/lib/binocs/tui/request_list.rb

@@ -0,0 +1,268 @@
+# frozen_string_literal: true
+
+module Binocs
+  module TUI
+    class RequestList < Window
+      attr_accessor :requests, :selected_index, :scroll_offset
+      attr_reader :filters, :search_query
+
+      def initialize(height:, width:, top:, left:)
+        super
+        @requests = []
+        @selected_index = 0
+        @scroll_offset = 0
+        @filters = {}
+        @search_query = nil
+      end
+
+      def load_requests
+        scope = Binocs::Request.recent
+
+        # Apply filters
+        scope = scope.by_method(@filters[:method]) if @filters[:method].present?
+        scope = scope.by_status_range(@filters[:status]) if @filters[:status].present?
+        scope = scope.with_exception if @filters[:has_exception]
+        scope = scope.search(@search_query) if @search_query.present?
+
+        @requests = scope.limit(500).to_a
+
+        # Adjust selection if out of bounds
+        @selected_index = [@selected_index, @requests.length - 1].min
+        @selected_index = 0 if @selected_index < 0
+
+        adjust_scroll
+      end
+
+      def set_filter(key, value)
+        if value.nil? || value == ''
+          @filters.delete(key)
+        else
+          @filters[key] = value
+        end
+        load_requests
+      end
+
+      def set_search(query)
+        @search_query = query.present? ? query : nil
+        @selected_index = 0
+        @scroll_offset = 0
+        load_requests
+      end
+
+      def clear_filters
+        @filters = {}
+        @search_query = nil
+        @selected_index = 0
+        @scroll_offset = 0
+        load_requests
+      end
+
+      def selected_request
+        @requests[@selected_index]
+      end
+
+      def move_up
+        if @selected_index > 0
+          @selected_index -= 1
+          adjust_scroll
+        end
+      end
+
+      def move_down
+        if @selected_index < @requests.length - 1
+          @selected_index += 1
+          adjust_scroll
+        end
+      end
+
+      def go_to_top
+        @selected_index = 0
+        @scroll_offset = 0
+      end
+
+      def go_to_bottom
+        @selected_index = [@requests.length - 1, 0].max
+        adjust_scroll
+      end
+
+      def page_up
+        visible_rows = content_height
+        @selected_index = [@selected_index - visible_rows, 0].max
+        adjust_scroll
+      end
+
+      def page_down
+        visible_rows = content_height
+        @selected_index = [@selected_index + visible_rows, @requests.length - 1].min
+        adjust_scroll
+      end
+
+      def draw
+        clear
+        draw_box("Requests (#{@requests.length})")
+        draw_header
+        draw_requests
+        draw_status_bar
+        refresh
+      end
+
+      private
+
+      def content_height
+        @height - 5 # Box borders (2) + header (1) + status bar (2)
+      end
+
+      def content_width
+        @width - 2 # Box borders
+      end
+
+      def adjust_scroll
+        visible_rows = content_height
+
+        # Scroll up if selected is above visible area
+        if @selected_index < @scroll_offset
+          @scroll_offset = @selected_index
+        end
+
+        # Scroll down if selected is below visible area
+        if @selected_index >= @scroll_offset + visible_rows
+          @scroll_offset = @selected_index - visible_rows + 1
+        end
+      end
+
+      def draw_header
+        y = 1
+        x = 1
+
+        # Header - AI column + rest (leave room for time column ~10 chars)
+        path_width = [content_width - 65, 15].max
+        header = "AI METHOD  STATUS PATH#{' ' * (path_width - 4)} CONTROLLER                DURATION  TIME"
+        write(y, x, header[0, content_width], Colors::HEADER, Curses::A_BOLD)
+
+        # Draw separator
+        write(2, 1, '─' * content_width, Colors::BORDER)
+      end
+
+      def draw_requests
+        visible_rows = content_height
+        start_y = 3
+
+        visible_rows.times do |i|
+          req_index = @scroll_offset + i
+          break if req_index >= @requests.length
+
+          request = @requests[req_index]
+          y = start_y + i
+          is_selected = req_index == @selected_index
+
+          draw_request_row(y, request, is_selected)
+        end
+      end
+
+      def draw_request_row(y, request, is_selected)
+        if is_selected
+          # Draw full-width selection background
+          write(y, 1, ' ' * content_width, Colors::SELECTED)
+        end
+
+        x = 1
+
+        # Agent indicator
+        agents = Binocs::Agent.for_request(request.id)
+        if agents.any?
+          running = agents.any?(&:running?)
+          indicator = running ? '●' : '○'
+          color = running ? Colors::STATUS_SUCCESS : Colors::MUTED
+          write(y, x, indicator, is_selected ? Colors::SELECTED : color, Curses::A_BOLD)
+        end
+        x += 3
+
+        # Method (simple colored text for now)
+        method_str = request.method.to_s.upcase.ljust(7)
+        if is_selected
+          write(y, x, method_str, Colors::SELECTED, Curses::A_BOLD)
+        else
+          write(y, x, method_str, Colors.method_color(request.method), Curses::A_BOLD)
+        end
+        x += 8
+
+        # Status (simple colored text for now)
+        status_str = (request.status_code || '???').to_s.ljust(6)
+        if is_selected
+          write(y, x, status_str, Colors::SELECTED)
+        else
+          write(y, x, status_str, Colors.status_color(request.status_code))
+        end
+        x += 7
+
+        # Path (variable width - leave room for time column ~10 chars)
+        path_width = [content_width - 65, 15].max
+        path_text = truncate(request.path, path_width).ljust(path_width)
+        write(y, x, path_text, is_selected ? Colors::SELECTED : Colors::NORMAL)
+        x += path_width + 1
+
+        # Controller
+        controller_text = truncate(request.controller_action || '-', 25).ljust(25)
+        write(y, x, controller_text, is_selected ? Colors::SELECTED : Colors::MUTED, is_selected ? 0 : Curses::A_DIM)
+        x += 26
+
+        # Duration
+        duration_text = request.formatted_duration.ljust(8)
+        write(y, x, duration_text, is_selected ? Colors::SELECTED : Colors::NORMAL)
+        x += 9
+
+        # Time
+        time_text = time_ago(request.created_at)
+        write(y, x, time_text, is_selected ? Colors::SELECTED : Colors::MUTED, is_selected ? 0 : Curses::A_DIM)
+
+        # Exception indicator
+        if request.has_exception?
+          write(y, content_width - 2, '!', is_selected ? Colors::SELECTED : Colors::ERROR, Curses::A_BOLD)
+        end
+      end
+
+      def draw_status_bar
+        y = @height - 2
+
+        # Draw separator
+        write(y - 1, 1, '─' * content_width, Colors::BORDER)
+
+        # Left side: filter info
+        filter_parts = []
+        filter_parts << "method:#{@filters[:method]}" if @filters[:method]
+        filter_parts << "status:#{@filters[:status]}" if @filters[:status]
+        filter_parts << "errors" if @filters[:has_exception]
+        filter_parts << "search:\"#{@search_query}\"" if @search_query
+
+        if filter_parts.any?
+          filter_text = "Filters: #{filter_parts.join(', ')}"
+          write(y, 1, truncate(filter_text, content_width / 2), Colors::MUTED, Curses::A_DIM)
+        end
+
+        # Right side: key hints
+        hints = "j/k:nav  Enter:view  /:search  f:filter  r:refresh  ?:help  q:quit"
+        write(y, content_width - hints.length, hints, Colors::KEY_HINT, Curses::A_DIM)
+      end
+
+      def truncate(str, max_length)
+        str = str.to_s
+        return str if str.length <= max_length
+        return str if max_length < 4
+
+        "#{str[0, max_length - 3]}..."
+      end
+
+      def time_ago(time)
+        return '-' unless time
+
+        seconds = Time.current - time
+        case seconds
+        when 0..59 then "#{seconds.to_i}s ago"
+        when 60..3599 then "#{(seconds / 60).to_i}m ago"
+        when 3600..86399 then "#{(seconds / 3600).to_i}h ago"
+        else "#{(seconds / 86400).to_i}d ago"
+        end
+      end
+    end
+  end
+end

data/lib/binocs/tui/spirit_animal.rb

@@ -0,0 +1,235 @@
+# frozen_string_literal: true
+
+module Binocs
+  module TUI
+    class SpiritAnimal < Window
+      ANIMALS = [
+        {
+          name: "Fox",
+          trait: "Clever & Quick",
+          art: <<~ART
+               /\\   /\\
+              //\\\\_//\\\\     ____
+              \\_     _/    /   /
+               / * * \\    /^^^]
+               \\_\\O/_/    [   ]
+                /   \\_    [   /
+                \\     \\_  /  /
+                 [ [ /  \\/ _/
+                _[ [ \\  /_/
+          ART
+        },
+        {
+          name: "Owl",
+          trait: "Wise & Watchful",
+          art: <<~ART
+               ,_,
+              (O,O)
+              (   )
+              -"-"-
+               ^ ^
+          ART
+        },
+        {
+          name: "Cat",
+          trait: "Independent & Curious",
+          art: <<~ART
+               /\\_/\\
+              ( o.o )
+               > ^ <
+              /|   |\\
+             (_|   |_)
+          ART
+        },
+        {
+          name: "Bear",
+          trait: "Strong & Patient",
+          art: <<~ART
+               ʕ•ᴥ•ʔ
+              /|   |\\
+              _|   |_
+             | |   | |
+             |_|   |_|
+          ART
+        },
+        {
+          name: "Rabbit",
+          trait: "Fast & Alert",
+          art: <<~ART
+              (\\(\\
+              ( -.-)
+              o_(")(")
+          ART
+        },
+        {
+          name: "Wolf",
+          trait: "Loyal & Fierce",
+          art: <<~ART
+                /\\    /\\
+               /  \\  /  \\
+              / /\\ \\/ /\\ \\
+              \\/  \\  /  \\/
+               \\   \\/   /
+                \\  **  /
+                 \\ -- /
+                  \\  /
+                   \\/
+          ART
+        },
+        {
+          name: "Dragon",
+          trait: "Powerful & Legendary",
+          art: <<~ART
+                         ____
+                        / __ \\
+               /\\_/\\   | |  | |
+              ( o.o )  | |__| |
+               > ^ <    \\____/
+              /|   |\\  __/  \\__
+             / |   | \\/  \\  /  \\
+                       \\__/\\__/
+          ART
+        },
+        {
+          name: "Turtle",
+          trait: "Steady & Resilient",
+          art: <<~ART
+                   _____
+                 /       \\
+                |  O   O  |
+                 \\   ^   /
+               ___/-----\\___
+              /   _______   \\
+             /___/       \\___\\
+          ART
+        },
+        {
+          name: "Phoenix",
+          trait: "Reborn & Radiant",
+          art: <<~ART
+                 ,//
+                ///
+               ///
+              ///     /\\
+             ///     //\\\\
+            ///     ///\\\\\\
+           ///     /// \\\\\\\\
+          ///________\\  \\\\\\
+          \\\\\\\\\\\\\\\\\\\\\\\\  //
+           \\\\\\\\\\\\\\\\\\\\\\\\//
+            \\\\\\    \\\\\\//
+             \\\\\\    \\//
+              \\\\\\   //
+               \\\\\\_//
+          ART
+        },
+        {
+          name: "Penguin",
+          trait: "Social & Adaptable",
+          art: <<~ART
+                 .--.
+                |o_o |
+                |:_/ |
+               //   \\ \\
+              (|     | )
+             /'\\_   _/`\\
+             \\___)=(___/
+          ART
+        },
+        {
+          name: "Octopus",
+          trait: "Creative & Flexible",
+          art: <<~ART
+                  ___
+               .-'   '-.
+              /  o   o  \\
+             |     ^     |
+              \\  '---'  /
+            /\\/\\/\\/\\/\\/\\/\\
+           | | | | | | | |
+          ART
+        },
+        {
+          name: "Unicorn",
+          trait: "Magical & Unique",
+          art: <<~ART
+                   \\
+                    \\
+                     \\\\
+                      \\\\
+                       >\\/ /\\
+                       \\  /  \\
+                        \\/    \\
+                              `\\
+                                \\
+          ART
+        }
+      ].freeze
+
+      attr_accessor :request, :animal
+
+      def initialize(height:, width:, top:, left:)
+        super
+        @request = nil
+        @animal = nil
+      end
+
+      def set_request(request)
+        @request = request
+        @animal = pick_spirit_animal(request)
+      end
+
+      def draw
+        return unless @animal
+
+        clear
+        draw_box("✨ Spirit Animal ✨")
+
+        y = 2
+
+        # Animal name and trait
+        name_text = "The #{@animal[:name]}"
+        write(y, (@width - name_text.length) / 2, name_text, Colors::HEADER, Curses::A_BOLD)
+        y += 1
+
+        trait_text = "\"#{@animal[:trait]}\""
+        write(y, (@width - trait_text.length) / 2, trait_text, Colors::STATUS_SUCCESS)
+        y += 2
+
+        # Draw ASCII art centered
+        art_lines = @animal[:art].lines.map(&:chomp)
+        max_art_width = art_lines.map(&:length).max || 0
+
+        art_lines.each do |line|
+          x = [(@width - max_art_width) / 2, 2].max
+          write(y, x, line, Colors::NORMAL)
+          y += 1
+        end
+
+        y += 1
+
+        # Request info that determined the animal
+        write(y, 2, "Request:", Colors::MUTED, Curses::A_DIM)
+        y += 1
+        method_str = @request.respond_to?(:read_attribute) ? @request.read_attribute(:method) : @request.method
+        info = "#{method_str} #{@request.path[0, 30]}"
+        write(y, 2, info, Colors::MUTED, Curses::A_DIM)
+
+        # Footer
+        write(@height - 2, 2, "Press any key to close", Colors::KEY_HINT, Curses::A_DIM)
+
+        refresh
+      end
+
+      private
+
+      def pick_spirit_animal(request)
+        # Create a hash from request attributes to deterministically pick an animal
+        seed_string = "#{request.id}#{request.path}#{request.method}#{request.status_code}"
+        hash = seed_string.bytes.reduce(0) { |acc, b| acc + b }
+
+        ANIMALS[hash % ANIMALS.length]
+      end
+    end
+  end
+end

data/lib/binocs/tui/window.rb

@@ -0,0 +1,98 @@
+# frozen_string_literal: true
+
+module Binocs
+  module TUI
+    class Window
+      attr_reader :win, :height, :width, :top, :left
+
+      def initialize(height:, width:, top:, left:)
+        @height = height
+        @width = width
+        @top = top
+        @left = left
+        @win = Curses::Window.new(height, width, top, left)
+      end
+
+      def refresh
+        @win.refresh
+      end
+
+      def noutrefresh
+        @win.noutrefresh
+      end
+
+      def clear
+        @win.erase  # Use erase instead of clear to reduce flicker
+      end
+
+      def close
+        @win.close
+      end
+
+      def resize(height, width, top, left)
+        @win.close
+        @height = height
+        @width = width
+        @top = top
+        @left = left
+        @win = Curses::Window.new(height, width, top, left)
+      end
+
+      def draw_box(title = nil)
+        @win.attron(Curses.color_pair(Colors::BORDER)) do
+          # Draw corners
+          @win.setpos(0, 0)
+          @win.addstr('┌')
+          @win.setpos(0, @width - 1)
+          @win.addstr('┐')
+          @win.setpos(@height - 1, 0)
+          @win.addstr('└')
+          @win.setpos(@height - 1, @width - 1)
+          @win.addstr('┘')
+
+          # Draw horizontal lines
+          (1...@width - 1).each do |x|
+            @win.setpos(0, x)
+            @win.addstr('─')
+            @win.setpos(@height - 1, x)
+            @win.addstr('─')
+          end
+
+          # Draw vertical lines
+          (1...@height - 1).each do |y|
+            @win.setpos(y, 0)
+            @win.addstr('│')
+            @win.setpos(y, @width - 1)
+            @win.addstr('│')
+          end
+        end
+
+        # Draw title if provided
+        if title
+          @win.attron(Curses.color_pair(Colors::TITLE) | Curses::A_BOLD) do
+            title_text = " #{title} "
+            @win.setpos(0, 2)
+            @win.addstr(title_text)
+          end
+        end
+      end
+
+      def write(y, x, text, color_pair = Colors::NORMAL, attrs = 0)
+        return if y < 0 || y >= @height || x < 0
+
+        @win.attron(Curses.color_pair(color_pair) | attrs) do
+          @win.setpos(y, x)
+          # Truncate text if it would overflow
+          max_len = @width - x
+          truncated = text.to_s[0, max_len]
+          @win.addstr(truncated)
+        end
+      end
+
+      def write_centered(y, text, color_pair = Colors::NORMAL, attrs = 0)
+        x = [(@width - text.length) / 2, 0].max
+        write(y, x, text, color_pair, attrs)
+      end
+    end
+  end
+end

data/lib/binocs/tui.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require 'curses'
+require 'rbconfig'
+require_relative 'swagger/client'
+require_relative 'swagger/path_matcher'
+require_relative 'agent'
+require_relative 'agent_context'
+require_relative 'agent_manager'
+require_relative 'tui/colors'
+require_relative 'tui/window'
+require_relative 'tui/request_list'
+require_relative 'tui/request_detail'
+require_relative 'tui/help_screen'
+require_relative 'tui/filter_menu'
+require_relative 'tui/agents_list'
+require_relative 'tui/agent_output'
+require_relative 'tui/spirit_animal'
+require_relative 'tui/app'
+
+module Binocs
+  module TUI
+  end
+end

data/lib/binocs/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Binocs
+  VERSION = '0.1.0'
+end

data/lib/binocs.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require "binocs/version"
+require "binocs/configuration"
+require "binocs/engine"
+
+module Binocs
+  class << self
+    attr_writer :configuration
+
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def configure
+      yield(configuration)
+    end
+
+    def enabled?
+      configuration.enabled && !Rails.env.production?
+    end
+
+    def reset_configuration!
+      @configuration = Configuration.new
+    end
+  end
+end