raygatherer 0.1.0 → 0.3.0

data/lib/raygatherer/commands/analysis/status.rb

@@ -9,11 +9,6 @@ module Raygatherer
   module Commands
     module Analysis
       class Status < Base
-        def initialize(argv, stdout: $stdout, stderr: $stderr, api_client: nil, json: false)
-          super(argv, stdout: stdout, stderr: stderr, api_client: api_client)
-          @json = json
-        end
-
         def run
           with_error_handling do
             parse_options
@@ -35,10 +30,7 @@ module Raygatherer
             opts.separator ""
             opts.separator "Options:"
 
-            opts.on("-h", "--help", "Show this help message") do
-              show_help
-              raise CLI::EarlyExit, EXIT_CODE_SUCCESS
-            end
+            add_help_option(opts)
           end.parse!(@argv)
         end
 

data/lib/raygatherer/commands/base.rb

@@ -10,15 +10,23 @@ module Raygatherer
         new(argv, **kwargs).run
       end
 
-      def initialize(argv, stdout: $stdout, stderr: $stderr, api_client: nil, **_kwargs)
+      def initialize(argv, stdout: $stdout, stderr: $stderr, api_client: nil, json: false, **_kwargs)
         @argv = argv
         @stdout = stdout
         @stderr = stderr
         @api_client = api_client
+        @json = json
       end
 
       private
 
+      def add_help_option(opts)
+        opts.on("-h", "--help", "Show this help message") do
+          show_help
+          raise CLI::EarlyExit, EXIT_CODE_SUCCESS
+        end
+      end
+
       def print_global_options(output, json: false)
         output.puts "Global options (see 'raygatherer --help'):"
         if json
@@ -36,6 +44,17 @@ module Raygatherer
         @stderr.puts "Error: #{e.message}"
         EXIT_CODE_ERROR
       end
+
+      def warn_if_rayhunter_outdated(rayhunter_version)
+        actual = Gem::Version.new(rayhunter_version)
+        tested = Gem::Version.new(Raygatherer::TESTED_RAYHUNTER_VERSION)
+        return unless actual < tested
+
+        @stderr.puts "Warning: connected rayhunter is v#{rayhunter_version}; raygatherer was last " \
+          "tested against v#{Raygatherer::TESTED_RAYHUNTER_VERSION} — some fields or commands may not be supported."
+      rescue ArgumentError
+        nil
+      end
     end
   end
 end

data/lib/raygatherer/commands/config/set.rb

@@ -48,10 +48,7 @@ module Raygatherer
             opts.separator ""
             opts.separator "Options:"
 
-            opts.on("-h", "--help", "Show this help message") do
-              show_help
-              raise CLI::EarlyExit, EXIT_CODE_SUCCESS
-            end
+            add_help_option(opts)
           end.parse!(@argv)
         end
 

data/lib/raygatherer/commands/config/show.rb

@@ -9,11 +9,6 @@ module Raygatherer
   module Commands
     module Config
       class Show < Base
-        def initialize(argv, stdout: $stdout, stderr: $stderr, api_client: nil, json: false)
-          super(argv, stdout: stdout, stderr: stderr, api_client: api_client)
-          @json = json
-        end
-
         def run
           with_error_handling do
             parse_options
@@ -35,10 +30,7 @@ module Raygatherer
             opts.separator ""
             opts.separator "Options:"
 
-            opts.on("-h", "--help", "Show this help message") do
-              show_help
-              raise CLI::EarlyExit, EXIT_CODE_SUCCESS
-            end
+            add_help_option(opts)
           end.parse!(@argv)
         end
 

data/lib/raygatherer/commands/config/test_notification.rb

@@ -26,10 +26,7 @@ module Raygatherer
             opts.separator ""
             opts.separator "Options:"
 
-            opts.on("-h", "--help", "Show this help message") do
-              show_help
-              raise CLI::EarlyExit, EXIT_CODE_SUCCESS
-            end
+            add_help_option(opts)
           end.parse!(@argv)
         end
 

data/lib/raygatherer/commands/debug/display_state.rb

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+require "json"
+require "optparse"
+require_relative "../base"
+
+module Raygatherer
+  module Commands
+    module Debug
+      class DisplayState < Base
+        VALID_STATES = %w[recording paused warning].freeze
+        VALID_SEVERITIES = %w[low medium high].freeze
+
+        def initialize(argv, stdout: $stdout, stderr: $stderr, api_client: nil)
+          super
+          @severity = nil
+        end
+
+        def run
+          with_error_handling do
+            parse_options
+
+            state = @argv.shift
+
+            unless VALID_STATES.include?(state)
+              @stderr.puts "Error: state must be one of: #{VALID_STATES.join(", ")}"
+              return EXIT_CODE_ERROR
+            end
+
+            if state == "warning" && @severity.nil?
+              @stderr.puts "Error: --severity is required when state is 'warning'"
+              return EXIT_CODE_ERROR
+            end
+
+            if state != "warning" && !@severity.nil?
+              @stderr.puts "Error: --severity is only valid when state is 'warning'"
+              return EXIT_CODE_ERROR
+            end
+
+            @api_client.set_display_state(build_body(state))
+            @stdout.puts "Display state updated."
+
+            EXIT_CODE_SUCCESS
+          end
+        end
+
+        private
+
+        def build_body(state)
+          case state
+          when "recording" then JSON.generate("Recording")
+          when "paused" then JSON.generate("Paused")
+          when "warning" then JSON.generate({"WarningDetected" => {"event_type" => @severity.capitalize}})
+          end
+        end
+
+        def parse_options
+          OptionParser.new do |opts|
+            opts.banner = "Usage: raygatherer debug display-state [options] STATE"
+            opts.separator ""
+            opts.separator "Options:"
+
+            opts.on("--severity LEVEL", VALID_SEVERITIES, "Severity: low, medium, high (required for 'warning' state)") do |s|
+              @severity = s
+            end
+
+            add_help_option(opts)
+          end.parse!(@argv)
+        end
+
+        def show_help(output = @stdout)
+          output.puts "Usage: raygatherer [global options] debug display-state [options] STATE"
+          output.puts ""
+          output.puts "Change the display state of the device for debugging purposes."
+          output.puts ""
+          output.puts "States:"
+          output.puts "    recording                        Device is recording, no warnings"
+          output.puts "    paused                           Device is not recording"
+          output.puts "    warning                          Warning detected (requires --severity)"
+          output.puts ""
+          output.puts "Options:"
+          output.puts "    --severity LEVEL                 Warning severity: low, medium, high"
+          output.puts "    -h, --help                       Show this help message"
+          output.puts ""
+          print_global_options(output)
+          output.puts ""
+          output.puts "Examples:"
+          output.puts "  raygatherer --host http://192.168.1.100:8080 debug display-state recording"
+          output.puts "  raygatherer --host http://192.168.1.100:8080 debug display-state paused"
+          output.puts "  raygatherer --host http://192.168.1.100:8080 debug display-state warning --severity high"
+        end
+      end
+    end
+  end
+end

data/lib/raygatherer/commands/gps/set.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+require_relative "../base"
+
+module Raygatherer
+  module Commands
+    module Gps
+      class Set < Base
+        def run
+          with_error_handling do
+            parse_options
+
+            unless @argv.length == 2
+              @stderr.puts "Error: latitude and longitude are required (usage: gps set LAT LON)"
+              return EXIT_CODE_ERROR
+            end
+
+            lat_str, lon_str = @argv
+
+            latitude = parse_coordinate(lat_str, "latitude")
+            return EXIT_CODE_ERROR unless latitude
+
+            longitude = parse_coordinate(lon_str, "longitude")
+            return EXIT_CODE_ERROR unless longitude
+
+            @api_client.set_gps(latitude, longitude)
+            @stdout.puts "GPS position set: #{latitude}, #{longitude}"
+
+            EXIT_CODE_SUCCESS
+          end
+        end
+
+        private
+
+        def parse_coordinate(str, label)
+          Float(str)
+        rescue ArgumentError
+          @stderr.puts "Error: #{label} must be a number (got #{str.inspect})"
+          nil
+        end
+
+        # Deliberately not using OptionParser#parse! here: a negative longitude like "-0.1"
+        # looks like an unrecognized flag to it and raises OptionParser::InvalidOption. This
+        # command's only "option" is help, so just scan for it directly instead.
+        def parse_options
+          return unless @argv.include?("-h") || @argv.include?("--help")
+
+          show_help
+          raise CLI::EarlyExit, EXIT_CODE_SUCCESS
+        end
+
+        def show_help(output = @stdout)
+          output.puts "Usage: raygatherer [global options] gps set [options] LAT LON"
+          output.puts ""
+          output.puts "Submit a GPS position to the device, to be embedded into the current recording."
+          output.puts "Requires the device's gps_mode config to be set to 'Api' (see 'config show'/'config set')."
+          output.puts ""
+          output.puts "Options:"
+          output.puts "    -h, --help                       Show this help message"
+          output.puts ""
+          print_global_options(output)
+          output.puts ""
+          output.puts "Examples:"
+          output.puts "  raygatherer --host http://192.168.1.100:8080 gps set 51.5074 -0.1278"
+        end
+      end
+    end
+  end
+end

data/lib/raygatherer/commands/gps/show.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+require "optparse"
+require_relative "../base"
+require_relative "../../formatters/gps_json"
+require_relative "../../formatters/gps_human"
+
+module Raygatherer
+  module Commands
+    module Gps
+      class Show < Base
+        def run
+          with_error_handling do
+            parse_options
+
+            gps = @api_client.fetch_gps
+
+            formatter = @json ? Formatters::GpsJSON.new : Formatters::GpsHuman.new
+            @stdout.puts formatter.format(gps)
+
+            EXIT_CODE_SUCCESS
+          end
+        end
+
+        private
+
+        def parse_options
+          OptionParser.new do |opts|
+            opts.banner = "Usage: raygatherer gps show [options]"
+            opts.separator ""
+            opts.separator "Options:"
+
+            add_help_option(opts)
+          end.parse!(@argv)
+        end
+
+        def show_help(output = @stdout)
+          output.puts "Usage: raygatherer [global options] gps show [options]"
+          output.puts ""
+          output.puts "Show the last GPS position submitted to the device (see 'gps set')."
+          output.puts ""
+          output.puts "Options:"
+          output.puts "    -h, --help                       Show this help message"
+          output.puts ""
+          print_global_options(output, json: true)
+          output.puts ""
+          output.puts "Examples:"
+          output.puts "  raygatherer --host http://192.168.1.100:8080 gps show"
+          output.puts "  raygatherer --host http://192.168.1.100:8080 --json gps show"
+        end
+      end
+    end
+  end
+end

data/lib/raygatherer/commands/log.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+require "optparse"
+require_relative "base"
+
+module Raygatherer
+  module Commands
+    class Log < Base
+      def run
+        with_error_handling do
+          parse_options
+          @stdout.print @api_client.fetch_log
+          EXIT_CODE_SUCCESS
+        end
+      end
+
+      private
+
+      def parse_options
+        OptionParser.new do |opts|
+          add_help_option(opts)
+        end.parse!(@argv)
+      end
+
+      def show_help(output = @stdout)
+        output.puts "Usage: raygatherer [global options] log [options]"
+        output.puts ""
+        output.puts "Options:"
+        output.puts "    -h, --help                       Show this help message"
+        output.puts ""
+        print_global_options(output)
+        output.puts ""
+        output.puts "Examples:"
+        output.puts "  raygatherer --host http://192.168.1.100:8080 log"
+      end
+    end
+  end
+end

data/lib/raygatherer/commands/recording/delete.rb

@@ -7,47 +7,91 @@ module Raygatherer
   module Commands
     module Recording
       class Delete < Base
+        def initialize(argv, stdout: $stdout, stderr: $stderr, api_client: nil, stdin: $stdin, **_kwargs)
+          super(argv, stdout: stdout, stderr: stderr, api_client: api_client)
+          @stdin = stdin
+          @all = false
+          @force = false
+        end
+
         def run
           with_error_handling do
             parse_options
 
-            name = @argv.shift
-            unless name
-              @stderr.puts "Error: recording name is required"
-              next EXIT_CODE_ERROR
+            if @all && !@argv.empty?
+              @stderr.puts "Error: cannot specify both a recording name and --all"
+              return EXIT_CODE_ERROR
             end
 
-            @api_client.delete_recording(name)
-            @stdout.puts "Deleted recording: #{name}"
-            EXIT_CODE_SUCCESS
+            if @all
+              delete_all
+            else
+              delete_named
+            end
           end
         end
 
         private
 
+        def delete_all
+          unless @force
+            @stderr.print "Warning: This will permanently delete ALL recordings!\nAre you sure? [y/N]: "
+            response = @stdin.gets&.strip&.downcase || ""
+            unless response == "y" || response == "yes"
+              @stderr.puts "Aborted."
+              return EXIT_CODE_ERROR
+            end
+          end
+          @api_client.delete_all_recordings
+          @stdout.puts "Deleted all recordings."
+          EXIT_CODE_SUCCESS
+        end
+
+        def delete_named
+          name = @argv.shift
+          unless name
+            @stderr.puts "Error: recording name or --all is required"
+            return EXIT_CODE_ERROR
+          end
+          @api_client.delete_recording(name)
+          @stdout.puts "Deleted recording: #{name}"
+          EXIT_CODE_SUCCESS
+        end
+
         def parse_options
           OptionParser.new do |opts|
-            opts.banner = "Usage: raygatherer recording delete <name>"
+            opts.banner = "Usage: raygatherer recording delete <name> | --all [--force]"
             opts.separator ""
             opts.separator "Options:"
 
-            opts.on("-h", "--help", "Show this help message") do
-              show_help
-              raise CLI::EarlyExit, EXIT_CODE_SUCCESS
+            opts.on("--all", "Delete all recordings (prompts for confirmation)") do
+              @all = true
             end
+
+            opts.on("-f", "--force", "Skip confirmation prompt (use with --all)") do
+              @force = true
+            end
+
+            add_help_option(opts)
           end.parse!(@argv)
         end
 
         def show_help(output = @stdout)
           output.puts "Usage: raygatherer [global options] recording delete <name>"
+          output.puts "       raygatherer [global options] recording delete --all [--force]"
           output.puts ""
           output.puts "Options:"
+          output.puts "    --all                            Delete all recordings (prompts for confirmation)"
+          output.puts "    -f, --force                      Skip confirmation prompt (use with --all)"
           output.puts "    -h, --help                       Show this help message"
           output.puts ""
           print_global_options(output)
           output.puts ""
           output.puts "Examples:"
           output.puts "  raygatherer --host http://192.168.1.100:8080 recording delete 1738950000"
+          output.puts "  raygatherer --host http://192.168.1.100:8080 recording delete --all"
+          output.puts "  raygatherer --host http://192.168.1.100:8080 recording delete --all --force"
+          output.puts "  echo y | raygatherer --host http://192.168.1.100:8080 recording delete --all"
         end
       end
     end

data/lib/raygatherer/commands/recording/download.rb

@@ -28,21 +28,21 @@ module Raygatherer
         def run
           with_error_handling do
             parse_options
-            next EXIT_CODE_ERROR unless validate_format_flags
-            next EXIT_CODE_ERROR unless validate_path_flags
+            return EXIT_CODE_ERROR unless validate_format_flags
+            return EXIT_CODE_ERROR unless validate_path_flags
 
             name = @argv.shift
             unless name
               @stderr.puts "Error: recording name is required"
-              next EXIT_CODE_ERROR
+              return EXIT_CODE_ERROR
             end
 
             dest_path = resolve_destination(name)
-            next EXIT_CODE_ERROR unless dest_path
+            return EXIT_CODE_ERROR unless dest_path
 
             if File.exist?(dest_path)
               @stderr.puts "Error: file already exists: #{dest_path}"
-              next EXIT_CODE_ERROR
+              return EXIT_CODE_ERROR
             end
 
             spinner = Spinner.new(stderr: @stderr)
@@ -87,10 +87,7 @@ module Raygatherer
               @save_as = path
             end
 
-            opts.on("-h", "--help", "Show this help message") do
-              show_help
-              raise CLI::EarlyExit, EXIT_CODE_SUCCESS
-            end
+            add_help_option(opts)
           end.parse!(@argv)
         end
 

data/lib/raygatherer/commands/recording/list.rb

@@ -9,11 +9,6 @@ module Raygatherer
   module Commands
     module Recording
       class List < Base
-        def initialize(argv, stdout: $stdout, stderr: $stderr, api_client: nil, json: false)
-          super(argv, stdout: stdout, stderr: stderr, api_client: api_client)
-          @json = json
-        end
-
         def run
           with_error_handling do
             parse_options
@@ -35,10 +30,7 @@ module Raygatherer
             opts.separator ""
             opts.separator "Options:"
 
-            opts.on("-h", "--help", "Show this help message") do
-              show_help
-              raise CLI::EarlyExit, EXIT_CODE_SUCCESS
-            end
+            add_help_option(opts)
           end.parse!(@argv)
         end
 

data/lib/raygatherer/commands/recording/start.rb

@@ -13,7 +13,7 @@ module Raygatherer
 
             if @argv.any?
               @stderr.puts "Error: recording start does not take a name"
-              next EXIT_CODE_ERROR
+              return EXIT_CODE_ERROR
             end
 
             @api_client.start_recording
@@ -30,10 +30,7 @@ module Raygatherer
             opts.separator ""
             opts.separator "Options:"
 
-            opts.on("-h", "--help", "Show this help message") do
-              show_help
-              raise CLI::EarlyExit, EXIT_CODE_SUCCESS
-            end
+            add_help_option(opts)
           end.parse!(@argv)
         end
 

data/lib/raygatherer/commands/recording/stop.rb

@@ -13,7 +13,7 @@ module Raygatherer
 
             if @argv.any?
               @stderr.puts "Error: recording stop does not take a name"
-              next EXIT_CODE_ERROR
+              return EXIT_CODE_ERROR
             end
 
             @api_client.stop_recording
@@ -30,10 +30,7 @@ module Raygatherer
             opts.separator ""
             opts.separator "Options:"
 
-            opts.on("-h", "--help", "Show this help message") do
-              show_help
-              raise CLI::EarlyExit, EXIT_CODE_SUCCESS
-            end
+            add_help_option(opts)
           end.parse!(@argv)
         end
 

data/lib/raygatherer/commands/stats.rb

@@ -8,17 +8,15 @@ require_relative "../formatters/stats_human"
 module Raygatherer
   module Commands
     class Stats < Base
-      def initialize(argv, stdout: $stdout, stderr: $stderr, api_client: nil, json: false)
-        super(argv, stdout: stdout, stderr: stderr, api_client: api_client)
-        @json = json
-      end
-
       def run
         with_error_handling do
           parse_options
 
           stats = @api_client.fetch_system_stats
 
+          rayhunter_version = stats.dig("runtime_metadata", "rayhunter_version")
+          warn_if_rayhunter_outdated(rayhunter_version) if rayhunter_version
+
           formatter = @json ? Formatters::StatsJSON.new : Formatters::StatsHuman.new
           @stdout.puts formatter.format(stats)
 
@@ -34,10 +32,7 @@ module Raygatherer
           opts.separator ""
           opts.separator "Options:"
 
-          opts.on("-h", "--help", "Show this help message") do
-            show_help
-            raise CLI::EarlyExit, EXIT_CODE_SUCCESS
-          end
+          add_help_option(opts)
         end.parse!(@argv)
       end
 

data/lib/raygatherer/commands/time/show.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+
+require "optparse"
+require_relative "../base"
+require_relative "../../formatters/time_json"
+require_relative "../../formatters/time_human"
+
+module Raygatherer
+  module Commands
+    module Time
+      class Show < Base
+        def run
+          with_error_handling do
+            parse_options
+
+            time = @api_client.fetch_time
+
+            formatter = @json ? Formatters::TimeJSON.new : Formatters::TimeHuman.new
+            @stdout.puts formatter.format(time)
+
+            EXIT_CODE_SUCCESS
+          end
+        end
+
+        private
+
+        def parse_options
+          OptionParser.new do |opts|
+            opts.banner = "Usage: raygatherer time show [options]"
+            opts.separator ""
+            opts.separator "Options:"
+
+            add_help_option(opts)
+          end.parse!(@argv)
+        end
+
+        def show_help(output = @stdout)
+          output.puts "Usage: raygatherer [global options] time show [options]"
+          output.puts ""
+          output.puts "Options:"
+          output.puts "    -h, --help                       Show this help message"
+          output.puts ""
+          print_global_options(output, json: true)
+          output.puts ""
+          output.puts "Examples:"
+          output.puts "  raygatherer --host http://192.168.1.100:8080 time show"
+          output.puts "  raygatherer --host http://192.168.1.100:8080 --json time show"
+        end
+      end
+    end
+  end
+end