makit 0.0.167 → 0.0.169

data/lib/makit/commands/factory.rb

@@ -1,359 +1,359 @@
-# frozen_string_literal: true
-
-require_relative "request"
-
-module Makit
-  module Commands
-    # Factory for creating common command requests.
-    #
-    # This factory provides convenient methods for creating Request objects
-    # for common operations like git commands, bundle operations, rake tasks,
-    # and system utilities.
-    #
-    # @example Creating git commands
-    #   request = Factory.git_clone("https://github.com/user/repo.git", "/path/to/clone")
-    #   request = Factory.git_status("/path/to/repo")
-    #
-    # @example Creating Ruby commands
-    #   request = Factory.bundle_install("/path/to/project")
-    #   request = Factory.rake_task("test", "/path/to/project")
-    class Factory
-      # Create a git clone request.
-      #
-      # @param repository_url [String] git repository URL
-      # @param target_directory [String, nil] target directory (optional)
-      # @param options [Hash] additional options
-      # @option options [Integer] :timeout (300) timeout in seconds
-      # @option options [Hash] :metadata additional metadata
-      # @return [Request] git clone request
-      def self.git_clone(repository_url, target_directory = nil, **options)
-        arguments = ["clone", repository_url]
-        arguments << target_directory if target_directory
-
-        Request.new(
-          command: "git",
-          arguments: arguments,
-          timeout: options.fetch(:timeout, 300),
-          metadata: {
-            operation: "git_clone",
-            repository: repository_url,
-            target: target_directory,
-          }.merge(options.fetch(:metadata, {})),
-        )
-      end
-
-      # Create a git pull request.
-      #
-      # @param directory [String] repository directory
-      # @param options [Hash] additional options
-      # @option options [String] :remote ("origin") remote name
-      # @option options [String] :branch (nil) specific branch
-      # @option options [Integer] :timeout (120) timeout in seconds
-      # @return [Request] git pull request
-      def self.git_pull(directory = Dir.pwd, **options)
-        arguments = ["pull"]
-        arguments << options[:remote] if options[:remote]
-        arguments << options[:branch] if options[:branch]
-
-        Request.new(
-          command: "git",
-          arguments: arguments,
-          directory: directory,
-          timeout: options.fetch(:timeout, 120),
-          metadata: {
-            operation: "git_pull",
-            remote: options[:remote] || "origin",
-            branch: options[:branch],
-          }.merge(options.fetch(:metadata, {})),
-        )
-      end
-
-      # Create a git status request.
-      #
-      # @param directory [String] repository directory
-      # @param options [Hash] additional options
-      # @option options [Boolean] :porcelain (false) use porcelain format
-      # @option options [Boolean] :short (false) use short format
-      # @return [Request] git status request
-      def self.git_status(directory = Dir.pwd, **options)
-        arguments = ["status"]
-        arguments << "--porcelain" if options[:porcelain]
-        arguments << "--short" if options[:short]
-
-        Request.new(
-          command: "git",
-          arguments: arguments,
-          directory: directory,
-          metadata: {
-            operation: "git_status",
-            porcelain: options[:porcelain],
-            short: options[:short],
-          }.merge(options.fetch(:metadata, {})),
-        )
-      end
-
-      # Create a git log request.
-      #
-      # @param directory [String] repository directory
-      # @param options [Hash] additional options
-      # @option options [Integer] :limit (nil) limit number of commits
-      # @option options [String] :format (nil) log format
-      # @option options [String] :since (nil) since date/commit
-      # @return [Request] git log request
-      def self.git_log(directory = Dir.pwd, **options)
-        arguments = ["log"]
-        arguments.push("-n", options[:limit].to_s) if options[:limit]
-        arguments.push("--format", options[:format]) if options[:format]
-        arguments.push("--since", options[:since]) if options[:since]
-
-        Request.new(
-          command: "git",
-          arguments: arguments,
-          directory: directory,
-          metadata: {
-            operation: "git_log",
-            limit: options[:limit],
-            format: options[:format],
-            since: options[:since],
-          }.merge(options.fetch(:metadata, {})),
-        )
-      end
-
-      # Create a bundle install request.
-      #
-      # @param directory [String] project directory
-      # @param options [Hash] additional options
-      # @option options [Integer] :jobs (nil) number of parallel jobs
-      # @option options [String] :path (nil) install path
-      # @option options [Boolean] :deployment (false) deployment mode
-      # @option options [Integer] :timeout (300) timeout in seconds
-      # @return [Request] bundle install request
-      def self.bundle_install(directory = Dir.pwd, **options)
-        arguments = ["install"]
-        arguments.push("--jobs", options[:jobs].to_s) if options[:jobs]
-        arguments.push("--path", options[:path]) if options[:path]
-        arguments << "--deployment" if options[:deployment]
-
-        Request.new(
-          command: "bundle",
-          arguments: arguments,
-          directory: directory,
-          timeout: options.fetch(:timeout, 300),
-          metadata: {
-            operation: "bundle_install",
-            jobs: options[:jobs],
-            path: options[:path],
-            deployment: options[:deployment],
-          }.merge(options.fetch(:metadata, {})),
-        )
-      end
-
-      # Create a bundle exec request.
-      #
-      # @param command_string [String] command to execute with bundle exec
-      # @param directory [String] project directory
-      # @param options [Hash] additional options
-      # @option options [Integer] :timeout (120) timeout in seconds
-      # @return [Request] bundle exec request
-      def self.bundle_exec(command_string, directory = Dir.pwd, **options)
-        # Parse the command string to get command and arguments
-        parts = command_string.strip.split(/\s+/)
-        arguments = ["exec"] + parts
-
-        Request.new(
-          command: "bundle",
-          arguments: arguments,
-          directory: directory,
-          timeout: options.fetch(:timeout, 120),
-          metadata: {
-            operation: "bundle_exec",
-            exec_command: command_string,
-          }.merge(options.fetch(:metadata, {})),
-        )
-      end
-
-      # Create a rake task request.
-      #
-      # @param task_name [String] rake task name
-      # @param directory [String] project directory
-      # @param options [Hash] additional options
-      # @option options [Array<String>] :arguments additional task arguments
-      # @option options [Hash] :environment environment variables
-      # @option options [Integer] :timeout (300) timeout in seconds
-      # @return [Request] rake task request
-      def self.rake_task(task_name, directory = Dir.pwd, **options)
-        arguments = [task_name]
-        arguments.concat(options[:arguments]) if options[:arguments]
-
-        Request.new(
-          command: "rake",
-          arguments: arguments,
-          directory: directory,
-          environment: options[:environment] || {},
-          timeout: options.fetch(:timeout, 300),
-          metadata: {
-            operation: "rake_task",
-            task: task_name,
-            arguments: options[:arguments],
-          }.merge(options.fetch(:metadata, {})),
-        )
-      end
-
-      # Create a gem build request.
-      #
-      # @param gemspec_file [String, nil] gemspec file (optional, will auto-detect)
-      # @param directory [String] project directory
-      # @param options [Hash] additional options
-      # @option options [Integer] :timeout (120) timeout in seconds
-      # @return [Request] gem build request
-      def self.gem_build(gemspec_file = nil, directory = Dir.pwd, **options)
-        arguments = ["build"]
-        arguments << gemspec_file if gemspec_file
-
-        Request.new(
-          command: "gem",
-          arguments: arguments,
-          directory: directory,
-          timeout: options.fetch(:timeout, 120),
-          metadata: {
-            operation: "gem_build",
-            gemspec: gemspec_file,
-          }.merge(options.fetch(:metadata, {})),
-        )
-      end
-
-      # Create a gem install request.
-      #
-      # @param gem_name [String] gem name or gem file
-      # @param options [Hash] additional options
-      # @option options [String] :version specific version
-      # @option options [Boolean] :local (false) install from local file
-      # @option options [String] :source gem source
-      # @option options [Integer] :timeout (180) timeout in seconds
-      # @return [Request] gem install request
-      def self.gem_install(gem_name, **options)
-        arguments = ["install", gem_name]
-        arguments.push("--version", options[:version]) if options[:version]
-        arguments << "--local" if options[:local]
-        arguments.push("--source", options[:source]) if options[:source]
-
-        Request.new(
-          command: "gem",
-          arguments: arguments,
-          timeout: options.fetch(:timeout, 180),
-          metadata: {
-            operation: "gem_install",
-            gem: gem_name,
-            version: options[:version],
-            local: options[:local],
-            source: options[:source],
-          }.merge(options.fetch(:metadata, {})),
-        )
-      end
-
-      # Create a Ruby script execution request.
-      #
-      # @param script_file [String] Ruby script file to execute
-      # @param directory [String] working directory
-      # @param options [Hash] additional options
-      # @option options [Array<String>] :arguments script arguments
-      # @option options [Hash] :environment environment variables
-      # @option options [Integer] :timeout (120) timeout in seconds
-      # @return [Request] Ruby script execution request
-      def self.ruby_script(script_file, directory = Dir.pwd, **options)
-        arguments = [script_file]
-        arguments.concat(options[:arguments]) if options[:arguments]
-
-        Request.new(
-          command: "ruby",
-          arguments: arguments,
-          directory: directory,
-          environment: options[:environment] || {},
-          timeout: options.fetch(:timeout, 120),
-          metadata: {
-            operation: "ruby_script",
-            script: script_file,
-            arguments: options[:arguments],
-          }.merge(options.fetch(:metadata, {})),
-        )
-      end
-
-      # Create a system command request with validation.
-      #
-      # @param command [String] system command
-      # @param arguments [Array<String>] command arguments
-      # @param options [Hash] additional options
-      # @option options [String] :directory working directory
-      # @option options [Hash] :environment environment variables
-      # @option options [Integer] :timeout (60) timeout in seconds
-      # @return [Request] system command request
-      def self.system_command(command, arguments = [], **options)
-        Request.new(
-          command: command,
-          arguments: Array(arguments),
-          directory: options[:directory] || Dir.pwd,
-          environment: options[:environment] || {},
-          timeout: options.fetch(:timeout, 60),
-          metadata: {
-            operation: "system_command",
-            system_command: command,
-          }.merge(options.fetch(:metadata, {})),
-        )
-      end
-
-      # Create a dotnet CLI request.
-      #
-      # @param subcommand [String] dotnet subcommand (build, test, run, etc.)
-      # @param directory [String] project directory
-      # @param options [Hash] additional options
-      # @option options [Array<String>] :arguments additional arguments
-      # @option options [String] :configuration (nil) build configuration
-      # @option options [String] :framework (nil) target framework
-      # @option options [Integer] :timeout (300) timeout in seconds
-      # @return [Request] dotnet CLI request
-      def self.dotnet_command(subcommand, directory = Dir.pwd, **options)
-        arguments = [subcommand]
-        arguments.concat(options[:arguments]) if options[:arguments]
-        arguments.push("--configuration", options[:configuration]) if options[:configuration]
-        arguments.push("--framework", options[:framework]) if options[:framework]
-
-        Request.new(
-          command: "dotnet",
-          arguments: arguments,
-          directory: directory,
-          timeout: options.fetch(:timeout, 300),
-          metadata: {
-            operation: "dotnet_#{subcommand}",
-            subcommand: subcommand,
-            configuration: options[:configuration],
-            framework: options[:framework],
-          }.merge(options.fetch(:metadata, {})),
-        )
-      end
-
-      # Create a Node.js/npm command request.
-      #
-      # @param subcommand [String] npm subcommand (install, test, run, etc.)
-      # @param directory [String] project directory
-      # @param options [Hash] additional options
-      # @option options [Array<String>] :arguments additional arguments
-      # @option options [Integer] :timeout (300) timeout in seconds
-      # @return [Request] npm command request
-      def self.npm_command(subcommand, directory = Dir.pwd, **options)
-        arguments = [subcommand]
-        arguments.concat(options[:arguments]) if options[:arguments]
-
-        Request.new(
-          command: "npm",
-          arguments: arguments,
-          directory: directory,
-          timeout: options.fetch(:timeout, 300),
-          metadata: {
-            operation: "npm_#{subcommand}",
-            subcommand: subcommand,
-          }.merge(options.fetch(:metadata, {})),
-        )
-      end
-    end
-  end
-end
+# frozen_string_literal: true
+
+require_relative "request"
+
+module Makit
+  module Commands
+    # Factory for creating common command requests.
+    #
+    # This factory provides convenient methods for creating Request objects
+    # for common operations like git commands, bundle operations, rake tasks,
+    # and system utilities.
+    #
+    # @example Creating git commands
+    #   request = Factory.git_clone("https://github.com/user/repo.git", "/path/to/clone")
+    #   request = Factory.git_status("/path/to/repo")
+    #
+    # @example Creating Ruby commands
+    #   request = Factory.bundle_install("/path/to/project")
+    #   request = Factory.rake_task("test", "/path/to/project")
+    class Factory
+      # Create a git clone request.
+      #
+      # @param repository_url [String] git repository URL
+      # @param target_directory [String, nil] target directory (optional)
+      # @param options [Hash] additional options
+      # @option options [Integer] :timeout (300) timeout in seconds
+      # @option options [Hash] :metadata additional metadata
+      # @return [Request] git clone request
+      def self.git_clone(repository_url, target_directory = nil, **options)
+        arguments = ["clone", repository_url]
+        arguments << target_directory if target_directory
+
+        Request.new(
+          command: "git",
+          arguments: arguments,
+          timeout: options.fetch(:timeout, 300),
+          metadata: {
+            operation: "git_clone",
+            repository: repository_url,
+            target: target_directory,
+          }.merge(options.fetch(:metadata, {})),
+        )
+      end
+
+      # Create a git pull request.
+      #
+      # @param directory [String] repository directory
+      # @param options [Hash] additional options
+      # @option options [String] :remote ("origin") remote name
+      # @option options [String] :branch (nil) specific branch
+      # @option options [Integer] :timeout (120) timeout in seconds
+      # @return [Request] git pull request
+      def self.git_pull(directory = Dir.pwd, **options)
+        arguments = ["pull"]
+        arguments << options[:remote] if options[:remote]
+        arguments << options[:branch] if options[:branch]
+
+        Request.new(
+          command: "git",
+          arguments: arguments,
+          directory: directory,
+          timeout: options.fetch(:timeout, 120),
+          metadata: {
+            operation: "git_pull",
+            remote: options[:remote] || "origin",
+            branch: options[:branch],
+          }.merge(options.fetch(:metadata, {})),
+        )
+      end
+
+      # Create a git status request.
+      #
+      # @param directory [String] repository directory
+      # @param options [Hash] additional options
+      # @option options [Boolean] :porcelain (false) use porcelain format
+      # @option options [Boolean] :short (false) use short format
+      # @return [Request] git status request
+      def self.git_status(directory = Dir.pwd, **options)
+        arguments = ["status"]
+        arguments << "--porcelain" if options[:porcelain]
+        arguments << "--short" if options[:short]
+
+        Request.new(
+          command: "git",
+          arguments: arguments,
+          directory: directory,
+          metadata: {
+            operation: "git_status",
+            porcelain: options[:porcelain],
+            short: options[:short],
+          }.merge(options.fetch(:metadata, {})),
+        )
+      end
+
+      # Create a git log request.
+      #
+      # @param directory [String] repository directory
+      # @param options [Hash] additional options
+      # @option options [Integer] :limit (nil) limit number of commits
+      # @option options [String] :format (nil) log format
+      # @option options [String] :since (nil) since date/commit
+      # @return [Request] git log request
+      def self.git_log(directory = Dir.pwd, **options)
+        arguments = ["log"]
+        arguments.push("-n", options[:limit].to_s) if options[:limit]
+        arguments.push("--format", options[:format]) if options[:format]
+        arguments.push("--since", options[:since]) if options[:since]
+
+        Request.new(
+          command: "git",
+          arguments: arguments,
+          directory: directory,
+          metadata: {
+            operation: "git_log",
+            limit: options[:limit],
+            format: options[:format],
+            since: options[:since],
+          }.merge(options.fetch(:metadata, {})),
+        )
+      end
+
+      # Create a bundle install request.
+      #
+      # @param directory [String] project directory
+      # @param options [Hash] additional options
+      # @option options [Integer] :jobs (nil) number of parallel jobs
+      # @option options [String] :path (nil) install path
+      # @option options [Boolean] :deployment (false) deployment mode
+      # @option options [Integer] :timeout (300) timeout in seconds
+      # @return [Request] bundle install request
+      def self.bundle_install(directory = Dir.pwd, **options)
+        arguments = ["install"]
+        arguments.push("--jobs", options[:jobs].to_s) if options[:jobs]
+        arguments.push("--path", options[:path]) if options[:path]
+        arguments << "--deployment" if options[:deployment]
+
+        Request.new(
+          command: "bundle",
+          arguments: arguments,
+          directory: directory,
+          timeout: options.fetch(:timeout, 300),
+          metadata: {
+            operation: "bundle_install",
+            jobs: options[:jobs],
+            path: options[:path],
+            deployment: options[:deployment],
+          }.merge(options.fetch(:metadata, {})),
+        )
+      end
+
+      # Create a bundle exec request.
+      #
+      # @param command_string [String] command to execute with bundle exec
+      # @param directory [String] project directory
+      # @param options [Hash] additional options
+      # @option options [Integer] :timeout (120) timeout in seconds
+      # @return [Request] bundle exec request
+      def self.bundle_exec(command_string, directory = Dir.pwd, **options)
+        # Parse the command string to get command and arguments
+        parts = command_string.strip.split(/\s+/)
+        arguments = ["exec"] + parts
+
+        Request.new(
+          command: "bundle",
+          arguments: arguments,
+          directory: directory,
+          timeout: options.fetch(:timeout, 120),
+          metadata: {
+            operation: "bundle_exec",
+            exec_command: command_string,
+          }.merge(options.fetch(:metadata, {})),
+        )
+      end
+
+      # Create a rake task request.
+      #
+      # @param task_name [String] rake task name
+      # @param directory [String] project directory
+      # @param options [Hash] additional options
+      # @option options [Array<String>] :arguments additional task arguments
+      # @option options [Hash] :environment environment variables
+      # @option options [Integer] :timeout (300) timeout in seconds
+      # @return [Request] rake task request
+      def self.rake_task(task_name, directory = Dir.pwd, **options)
+        arguments = [task_name]
+        arguments.concat(options[:arguments]) if options[:arguments]
+
+        Request.new(
+          command: "rake",
+          arguments: arguments,
+          directory: directory,
+          environment: options[:environment] || {},
+          timeout: options.fetch(:timeout, 300),
+          metadata: {
+            operation: "rake_task",
+            task: task_name,
+            arguments: options[:arguments],
+          }.merge(options.fetch(:metadata, {})),
+        )
+      end
+
+      # Create a gem build request.
+      #
+      # @param gemspec_file [String, nil] gemspec file (optional, will auto-detect)
+      # @param directory [String] project directory
+      # @param options [Hash] additional options
+      # @option options [Integer] :timeout (120) timeout in seconds
+      # @return [Request] gem build request
+      def self.gem_build(gemspec_file = nil, directory = Dir.pwd, **options)
+        arguments = ["build"]
+        arguments << gemspec_file if gemspec_file
+
+        Request.new(
+          command: "gem",
+          arguments: arguments,
+          directory: directory,
+          timeout: options.fetch(:timeout, 120),
+          metadata: {
+            operation: "gem_build",
+            gemspec: gemspec_file,
+          }.merge(options.fetch(:metadata, {})),
+        )
+      end
+
+      # Create a gem install request.
+      #
+      # @param gem_name [String] gem name or gem file
+      # @param options [Hash] additional options
+      # @option options [String] :version specific version
+      # @option options [Boolean] :local (false) install from local file
+      # @option options [String] :source gem source
+      # @option options [Integer] :timeout (180) timeout in seconds
+      # @return [Request] gem install request
+      def self.gem_install(gem_name, **options)
+        arguments = ["install", gem_name]
+        arguments.push("--version", options[:version]) if options[:version]
+        arguments << "--local" if options[:local]
+        arguments.push("--source", options[:source]) if options[:source]
+
+        Request.new(
+          command: "gem",
+          arguments: arguments,
+          timeout: options.fetch(:timeout, 180),
+          metadata: {
+            operation: "gem_install",
+            gem: gem_name,
+            version: options[:version],
+            local: options[:local],
+            source: options[:source],
+          }.merge(options.fetch(:metadata, {})),
+        )
+      end
+
+      # Create a Ruby script execution request.
+      #
+      # @param script_file [String] Ruby script file to execute
+      # @param directory [String] working directory
+      # @param options [Hash] additional options
+      # @option options [Array<String>] :arguments script arguments
+      # @option options [Hash] :environment environment variables
+      # @option options [Integer] :timeout (120) timeout in seconds
+      # @return [Request] Ruby script execution request
+      def self.ruby_script(script_file, directory = Dir.pwd, **options)
+        arguments = [script_file]
+        arguments.concat(options[:arguments]) if options[:arguments]
+
+        Request.new(
+          command: "ruby",
+          arguments: arguments,
+          directory: directory,
+          environment: options[:environment] || {},
+          timeout: options.fetch(:timeout, 120),
+          metadata: {
+            operation: "ruby_script",
+            script: script_file,
+            arguments: options[:arguments],
+          }.merge(options.fetch(:metadata, {})),
+        )
+      end
+
+      # Create a system command request with validation.
+      #
+      # @param command [String] system command
+      # @param arguments [Array<String>] command arguments
+      # @param options [Hash] additional options
+      # @option options [String] :directory working directory
+      # @option options [Hash] :environment environment variables
+      # @option options [Integer] :timeout (60) timeout in seconds
+      # @return [Request] system command request
+      def self.system_command(command, arguments = [], **options)
+        Request.new(
+          command: command,
+          arguments: Array(arguments),
+          directory: options[:directory] || Dir.pwd,
+          environment: options[:environment] || {},
+          timeout: options.fetch(:timeout, 60),
+          metadata: {
+            operation: "system_command",
+            system_command: command,
+          }.merge(options.fetch(:metadata, {})),
+        )
+      end
+
+      # Create a dotnet CLI request.
+      #
+      # @param subcommand [String] dotnet subcommand (build, test, run, etc.)
+      # @param directory [String] project directory
+      # @param options [Hash] additional options
+      # @option options [Array<String>] :arguments additional arguments
+      # @option options [String] :configuration (nil) build configuration
+      # @option options [String] :framework (nil) target framework
+      # @option options [Integer] :timeout (300) timeout in seconds
+      # @return [Request] dotnet CLI request
+      def self.dotnet_command(subcommand, directory = Dir.pwd, **options)
+        arguments = [subcommand]
+        arguments.concat(options[:arguments]) if options[:arguments]
+        arguments.push("--configuration", options[:configuration]) if options[:configuration]
+        arguments.push("--framework", options[:framework]) if options[:framework]
+
+        Request.new(
+          command: "dotnet",
+          arguments: arguments,
+          directory: directory,
+          timeout: options.fetch(:timeout, 300),
+          metadata: {
+            operation: "dotnet_#{subcommand}",
+            subcommand: subcommand,
+            configuration: options[:configuration],
+            framework: options[:framework],
+          }.merge(options.fetch(:metadata, {})),
+        )
+      end
+
+      # Create a Node.js/npm command request.
+      #
+      # @param subcommand [String] npm subcommand (install, test, run, etc.)
+      # @param directory [String] project directory
+      # @param options [Hash] additional options
+      # @option options [Array<String>] :arguments additional arguments
+      # @option options [Integer] :timeout (300) timeout in seconds
+      # @return [Request] npm command request
+      def self.npm_command(subcommand, directory = Dir.pwd, **options)
+        arguments = [subcommand]
+        arguments.concat(options[:arguments]) if options[:arguments]
+
+        Request.new(
+          command: "npm",
+          arguments: arguments,
+          directory: directory,
+          timeout: options.fetch(:timeout, 300),
+          metadata: {
+            operation: "npm_#{subcommand}",
+            subcommand: subcommand,
+          }.merge(options.fetch(:metadata, {})),
+        )
+      end
+    end
+  end
+end