makit 0.0.111 → 0.0.112

data/lib/makit/commands/result.rb

@@ -1,323 +1,323 @@
-# frozen_string_literal: true
-
-require "json"
-require "time"
-
-module Makit
-  module Commands
-    # Structured result objects with comprehensive metadata.
-    # Uses native Ruby objects instead of protobuf for better performance.
-    #
-    # @example Basic result creation
-    #   result = Result.new(
-    #     command: "git --version",
-    #     exit_code: 0,
-    #     stdout: "git version 2.39.5\n",
-    #     stderr: ""
-    #   )
-    #
-    # @example Result with full metadata
-    #   result = Result.new(
-    #     command: "bundle install",
-    #     exit_code: 0,
-    #     stdout: "Bundle complete!",
-    #     stderr: "",
-    #     started_at: Time.now - 10,
-    #     finished_at: Time.now,
-    #     metadata: { gems_installed: 42, cache_hit: true }
-    #   )
-    class Result
-      # Command execution result with comprehensive metadata.
-      #
-      # @!attribute [r] command
-      #   @return [String] the command that was executed
-      # @!attribute [r] exit_code
-      #   @return [Integer] process exit code
-      # @!attribute [r] stdout
-      #   @return [String] standard output
-      # @!attribute [r] stderr
-      #   @return [String] standard error output
-      # @!attribute [r] started_at
-      #   @return [Time] when execution started
-      # @!attribute [r] finished_at
-      #   @return [Time, nil] when execution finished
-      # @!attribute [r] duration
-      #   @return [Float, nil] execution duration in seconds
-      # @!attribute [r] metadata
-      #   @return [Hash] additional metadata
-      attr_reader :command, :exit_code, :stdout, :stderr, :started_at, :finished_at, :duration, :metadata
-
-      # Initialize a new command result.
-      #
-      # @param command [String] the command that was executed
-      # @param exit_code [Integer] process exit code (default: nil)
-      # @param stdout [String] standard output (default: "")
-      # @param stderr [String] standard error output (default: "")
-      # @param started_at [Time] when execution started (default: Time.now)
-      # @param finished_at [Time, nil] when execution finished
-      # @param metadata [Hash] additional metadata (default: {})
-      def initialize(command:, **attributes)
-        @command = command.to_s
-        @exit_code = attributes[:exit_code]
-        @stdout = attributes[:stdout] || ""
-        @stderr = attributes[:stderr] || ""
-        @started_at = attributes[:started_at] || Time.now
-        @finished_at = attributes[:finished_at]
-        @duration = calculate_duration
-        @metadata = attributes[:metadata] || {}
-
-        # Ensure output is always strings
-        @stdout = @stdout.to_s
-        @stderr = @stderr.to_s
-      end
-
-      # Mark the result as finished.
-      #
-      # @param finished_at [Time] when execution finished (default: Time.now)
-      # @param exit_code [Integer] process exit code
-      # @param stdout [String] standard output
-      # @param stderr [String] standard error output
-      # @return [self] for method chaining
-      def finish!(finished_at: Time.now, exit_code: nil, stdout: nil, stderr: nil)
-        @finished_at = finished_at
-        @duration = calculate_duration
-        @exit_code = exit_code if exit_code
-        @stdout = stdout.to_s if stdout
-        @stderr = stderr.to_s if stderr
-        self
-      end
-
-      # Check if the command executed successfully.
-      #
-      # @return [Boolean] true if exit code is 0
-      def success?
-        exit_code.zero?
-      end
-
-      # Check if the command execution failed.
-      #
-      # @return [Boolean] true if exit code is not 0
-      def failure?
-        !success?
-      end
-
-      # Check if the command execution is complete.
-      #
-      # @return [Boolean] true if finished_at is set
-      def finished?
-        !finished_at.nil?
-      end
-
-      # Check if the command is still running.
-      #
-      # @return [Boolean] true if execution started but not finished
-      def running?
-        !started_at.nil? && finished_at.nil?
-      end
-
-      # Get combined output (stdout + stderr).
-      #
-      # @return [String] combined output
-      def output
-        [stdout, stderr].reject(&:empty?).join("\n")
-      end
-
-      # Get the first line of stdout (useful for simple commands).
-      #
-      # @return [String, nil] first line of stdout
-      def first_line
-        return nil if stdout.empty?
-
-        stdout.lines.first&.chomp
-      end
-
-      # Get the last line of stdout (useful for progress indicators).
-      #
-      # @return [String, nil] last line of stdout
-      def last_line
-        return nil if stdout.empty?
-
-        stdout.lines.last&.chomp
-      end
-
-      # Check if output contains specific text.
-      #
-      # @param text [String] text to search for
-      # @param case_sensitive [Boolean] whether to perform case-sensitive search
-      # @return [Boolean] true if text is found in stdout or stderr
-      def contains?(text, case_sensitive: true)
-        search_text = case_sensitive ? text : text.downcase
-        search_stdout = case_sensitive ? stdout : stdout.downcase
-        search_stderr = case_sensitive ? stderr : stderr.downcase
-
-        search_stdout.include?(search_text) || search_stderr.include?(search_text)
-      end
-
-      # Convert result to hash representation.
-      #
-      # @return [Hash] hash representation of the result
-      def to_h
-        {
-          command: command,
-          exit_code: exit_code,
-          stdout: stdout,
-          stderr: stderr,
-          started_at: started_at&.iso8601,
-          finished_at: finished_at&.iso8601,
-          duration: duration,
-          success: success?,
-          metadata: metadata,
-        }
-      end
-
-      # Convert result to JSON representation.
-      #
-      # @param args [Array] arguments passed to JSON.generate
-      # @return [String] JSON representation
-      def to_json(*args)
-        JSON.generate(to_h, *args)
-      end
-
-      # Create result from hash representation.
-      #
-      # @param hash [Hash] hash containing result information
-      # @return [Result] new result object
-      def self.from_hash(hash)
-        # Parse time strings back to Time objects
-        started_at = hash[:started_at] || hash["started_at"]
-        finished_at = hash[:finished_at] || hash["finished_at"]
-
-        started_at = Time.iso8601(started_at) if started_at.is_a?(String)
-        finished_at = Time.iso8601(finished_at) if finished_at.is_a?(String)
-
-        new(
-          command: hash[:command] || hash["command"],
-          exit_code: hash[:exit_code] || hash["exit_code"],
-          stdout: hash[:stdout] || hash["stdout"] || "",
-          stderr: hash[:stderr] || hash["stderr"] || "",
-          started_at: started_at,
-          finished_at: finished_at,
-          metadata: hash[:metadata] || hash["metadata"] || {},
-        )
-      end
-
-      # Create result from JSON string.
-      #
-      # @param json_string [String] JSON string representation
-      # @return [Result] new result object
-      # @raise [JSON::ParserError] if JSON is invalid
-      def self.from_json(json_string)
-        hash = JSON.parse(json_string)
-        from_hash(hash)
-      end
-
-      # Create a failed result with error information.
-      #
-      # @param command [String] the command that failed
-      # @param error [Exception, String] error that occurred
-      # @param started_at [Time] when execution started
-      # @return [Result] failed result object
-      def self.failure(command:, error:, started_at: Time.now)
-        error_message = error.is_a?(Exception) ? error.message : error.to_s
-        error_class = error.is_a?(Exception) ? error.class.name : "Error"
-
-        new(
-          command: command,
-          exit_code: 1,
-          stdout: "",
-          stderr: error_message,
-          started_at: started_at,
-          finished_at: Time.now,
-          metadata: { error_class: error_class, failed: true },
-        )
-      end
-
-      # Create a successful result.
-      #
-      # @param command [String] the command that succeeded
-      # @param stdout [String] standard output
-      # @param started_at [Time] when execution started
-      # @param duration [Float] execution duration
-      # @return [Result] successful result object
-      def self.success(command:, stdout: "", started_at: Time.now, duration: nil)
-        finished_at = duration ? started_at + duration : Time.now
-
-        new(
-          command: command,
-          exit_code: 0,
-          stdout: stdout,
-          stderr: "",
-          started_at: started_at,
-          finished_at: finished_at,
-        )
-      end
-
-      # Add metadata to the result.
-      #
-      # @param key [String, Symbol] metadata key
-      # @param value [Object] metadata value
-      # @return [self] for method chaining
-      def add_metadata(key, value)
-        @metadata[key] = value
-        self
-      end
-
-      # Merge additional metadata.
-      #
-      # @param additional_metadata [Hash] metadata to merge
-      # @return [self] for method chaining
-      def merge_metadata(additional_metadata)
-        @metadata.merge!(additional_metadata)
-        self
-      end
-
-      # Get execution summary for logging/display.
-      #
-      # @return [String] human-readable execution summary
-      def summary
-        status = success? ? "✓" : "✗"
-        duration_text = duration ? " (#{format("%.2f", duration)}s)" : ""
-
-        "#{status} #{command}#{duration_text}"
-      end
-
-      # Get detailed execution information.
-      #
-      # @return [String] detailed execution information
-      def details
-        lines = []
-        lines << "Command: #{command}"
-        lines << "Exit Code: #{exit_code}"
-        lines << "Started: #{started_at}"
-        lines << "Finished: #{finished_at}" if finished_at
-        lines << "Duration: #{format("%.2f", duration)}s" if duration
-        lines << "Status: #{success? ? "Success" : "Failed"}"
-
-        unless stdout.empty?
-          lines << "STDOUT:"
-          lines << stdout.split("\n").map { |line| "  #{line}" }
-        end
-
-        unless stderr.empty?
-          lines << "STDERR:"
-          lines << stderr.split("\n").map { |line| "  #{line}" }
-        end
-
-        lines << "Metadata: #{metadata}" unless metadata.empty?
-
-        lines.flatten.join("\n")
-      end
-
-      private
-
-      # Calculate execution duration.
-      #
-      # @return [Float, nil] duration in seconds, or nil if not finished
-      def calculate_duration
-        return nil unless started_at && finished_at
-
-        finished_at - started_at
-      end
-    end
-  end
-end
+# frozen_string_literal: true
+
+require "json"
+require "time"
+
+module Makit
+  module Commands
+    # Structured result objects with comprehensive metadata.
+    # Uses native Ruby objects instead of protobuf for better performance.
+    #
+    # @example Basic result creation
+    #   result = Result.new(
+    #     command: "git --version",
+    #     exit_code: 0,
+    #     stdout: "git version 2.39.5\n",
+    #     stderr: ""
+    #   )
+    #
+    # @example Result with full metadata
+    #   result = Result.new(
+    #     command: "bundle install",
+    #     exit_code: 0,
+    #     stdout: "Bundle complete!",
+    #     stderr: "",
+    #     started_at: Time.now - 10,
+    #     finished_at: Time.now,
+    #     metadata: { gems_installed: 42, cache_hit: true }
+    #   )
+    class Result
+      # Command execution result with comprehensive metadata.
+      #
+      # @!attribute [r] command
+      #   @return [String] the command that was executed
+      # @!attribute [r] exit_code
+      #   @return [Integer] process exit code
+      # @!attribute [r] stdout
+      #   @return [String] standard output
+      # @!attribute [r] stderr
+      #   @return [String] standard error output
+      # @!attribute [r] started_at
+      #   @return [Time] when execution started
+      # @!attribute [r] finished_at
+      #   @return [Time, nil] when execution finished
+      # @!attribute [r] duration
+      #   @return [Float, nil] execution duration in seconds
+      # @!attribute [r] metadata
+      #   @return [Hash] additional metadata
+      attr_reader :command, :exit_code, :stdout, :stderr, :started_at, :finished_at, :duration, :metadata
+
+      # Initialize a new command result.
+      #
+      # @param command [String] the command that was executed
+      # @param exit_code [Integer] process exit code (default: nil)
+      # @param stdout [String] standard output (default: "")
+      # @param stderr [String] standard error output (default: "")
+      # @param started_at [Time] when execution started (default: Time.now)
+      # @param finished_at [Time, nil] when execution finished
+      # @param metadata [Hash] additional metadata (default: {})
+      def initialize(command:, **attributes)
+        @command = command.to_s
+        @exit_code = attributes[:exit_code]
+        @stdout = attributes[:stdout] || ""
+        @stderr = attributes[:stderr] || ""
+        @started_at = attributes[:started_at] || Time.now
+        @finished_at = attributes[:finished_at]
+        @duration = calculate_duration
+        @metadata = attributes[:metadata] || {}
+
+        # Ensure output is always strings
+        @stdout = @stdout.to_s
+        @stderr = @stderr.to_s
+      end
+
+      # Mark the result as finished.
+      #
+      # @param finished_at [Time] when execution finished (default: Time.now)
+      # @param exit_code [Integer] process exit code
+      # @param stdout [String] standard output
+      # @param stderr [String] standard error output
+      # @return [self] for method chaining
+      def finish!(finished_at: Time.now, exit_code: nil, stdout: nil, stderr: nil)
+        @finished_at = finished_at
+        @duration = calculate_duration
+        @exit_code = exit_code if exit_code
+        @stdout = stdout.to_s if stdout
+        @stderr = stderr.to_s if stderr
+        self
+      end
+
+      # Check if the command executed successfully.
+      #
+      # @return [Boolean] true if exit code is 0
+      def success?
+        exit_code.zero?
+      end
+
+      # Check if the command execution failed.
+      #
+      # @return [Boolean] true if exit code is not 0
+      def failure?
+        !success?
+      end
+
+      # Check if the command execution is complete.
+      #
+      # @return [Boolean] true if finished_at is set
+      def finished?
+        !finished_at.nil?
+      end
+
+      # Check if the command is still running.
+      #
+      # @return [Boolean] true if execution started but not finished
+      def running?
+        !started_at.nil? && finished_at.nil?
+      end
+
+      # Get combined output (stdout + stderr).
+      #
+      # @return [String] combined output
+      def output
+        [stdout, stderr].reject(&:empty?).join("\n")
+      end
+
+      # Get the first line of stdout (useful for simple commands).
+      #
+      # @return [String, nil] first line of stdout
+      def first_line
+        return nil if stdout.empty?
+
+        stdout.lines.first&.chomp
+      end
+
+      # Get the last line of stdout (useful for progress indicators).
+      #
+      # @return [String, nil] last line of stdout
+      def last_line
+        return nil if stdout.empty?
+
+        stdout.lines.last&.chomp
+      end
+
+      # Check if output contains specific text.
+      #
+      # @param text [String] text to search for
+      # @param case_sensitive [Boolean] whether to perform case-sensitive search
+      # @return [Boolean] true if text is found in stdout or stderr
+      def contains?(text, case_sensitive: true)
+        search_text = case_sensitive ? text : text.downcase
+        search_stdout = case_sensitive ? stdout : stdout.downcase
+        search_stderr = case_sensitive ? stderr : stderr.downcase
+
+        search_stdout.include?(search_text) || search_stderr.include?(search_text)
+      end
+
+      # Convert result to hash representation.
+      #
+      # @return [Hash] hash representation of the result
+      def to_h
+        {
+          command: command,
+          exit_code: exit_code,
+          stdout: stdout,
+          stderr: stderr,
+          started_at: started_at&.iso8601,
+          finished_at: finished_at&.iso8601,
+          duration: duration,
+          success: success?,
+          metadata: metadata,
+        }
+      end
+
+      # Convert result to JSON representation.
+      #
+      # @param args [Array] arguments passed to JSON.generate
+      # @return [String] JSON representation
+      def to_json(*args)
+        JSON.generate(to_h, *args)
+      end
+
+      # Create result from hash representation.
+      #
+      # @param hash [Hash] hash containing result information
+      # @return [Result] new result object
+      def self.from_hash(hash)
+        # Parse time strings back to Time objects
+        started_at = hash[:started_at] || hash["started_at"]
+        finished_at = hash[:finished_at] || hash["finished_at"]
+
+        started_at = Time.iso8601(started_at) if started_at.is_a?(String)
+        finished_at = Time.iso8601(finished_at) if finished_at.is_a?(String)
+
+        new(
+          command: hash[:command] || hash["command"],
+          exit_code: hash[:exit_code] || hash["exit_code"],
+          stdout: hash[:stdout] || hash["stdout"] || "",
+          stderr: hash[:stderr] || hash["stderr"] || "",
+          started_at: started_at,
+          finished_at: finished_at,
+          metadata: hash[:metadata] || hash["metadata"] || {},
+        )
+      end
+
+      # Create result from JSON string.
+      #
+      # @param json_string [String] JSON string representation
+      # @return [Result] new result object
+      # @raise [JSON::ParserError] if JSON is invalid
+      def self.from_json(json_string)
+        hash = JSON.parse(json_string)
+        from_hash(hash)
+      end
+
+      # Create a failed result with error information.
+      #
+      # @param command [String] the command that failed
+      # @param error [Exception, String] error that occurred
+      # @param started_at [Time] when execution started
+      # @return [Result] failed result object
+      def self.failure(command:, error:, started_at: Time.now)
+        error_message = error.is_a?(Exception) ? error.message : error.to_s
+        error_class = error.is_a?(Exception) ? error.class.name : "Error"
+
+        new(
+          command: command,
+          exit_code: 1,
+          stdout: "",
+          stderr: error_message,
+          started_at: started_at,
+          finished_at: Time.now,
+          metadata: { error_class: error_class, failed: true },
+        )
+      end
+
+      # Create a successful result.
+      #
+      # @param command [String] the command that succeeded
+      # @param stdout [String] standard output
+      # @param started_at [Time] when execution started
+      # @param duration [Float] execution duration
+      # @return [Result] successful result object
+      def self.success(command:, stdout: "", started_at: Time.now, duration: nil)
+        finished_at = duration ? started_at + duration : Time.now
+
+        new(
+          command: command,
+          exit_code: 0,
+          stdout: stdout,
+          stderr: "",
+          started_at: started_at,
+          finished_at: finished_at,
+        )
+      end
+
+      # Add metadata to the result.
+      #
+      # @param key [String, Symbol] metadata key
+      # @param value [Object] metadata value
+      # @return [self] for method chaining
+      def add_metadata(key, value)
+        @metadata[key] = value
+        self
+      end
+
+      # Merge additional metadata.
+      #
+      # @param additional_metadata [Hash] metadata to merge
+      # @return [self] for method chaining
+      def merge_metadata(additional_metadata)
+        @metadata.merge!(additional_metadata)
+        self
+      end
+
+      # Get execution summary for logging/display.
+      #
+      # @return [String] human-readable execution summary
+      def summary
+        status = success? ? "✓" : "✗"
+        duration_text = duration ? " (#{format("%.2f", duration)}s)" : ""
+
+        "#{status} #{command}#{duration_text}"
+      end
+
+      # Get detailed execution information.
+      #
+      # @return [String] detailed execution information
+      def details
+        lines = []
+        lines << "Command: #{command}"
+        lines << "Exit Code: #{exit_code}"
+        lines << "Started: #{started_at}"
+        lines << "Finished: #{finished_at}" if finished_at
+        lines << "Duration: #{format("%.2f", duration)}s" if duration
+        lines << "Status: #{success? ? "Success" : "Failed"}"
+
+        unless stdout.empty?
+          lines << "STDOUT:"
+          lines << stdout.split("\n").map { |line| "  #{line}" }
+        end
+
+        unless stderr.empty?
+          lines << "STDERR:"
+          lines << stderr.split("\n").map { |line| "  #{line}" }
+        end
+
+        lines << "Metadata: #{metadata}" unless metadata.empty?
+
+        lines.flatten.join("\n")
+      end
+
+      private
+
+      # Calculate execution duration.
+      #
+      # @return [Float, nil] duration in seconds, or nil if not finished
+      def calculate_duration
+        return nil unless started_at && finished_at
+
+        finished_at - started_at
+      end
+    end
+  end
+end