makit 0.0.157 → 0.0.158

data/lib/makit/ruby/cli.rb

@@ -1,185 +1,185 @@
-# frozen_string_literal: true
-
-module Makit
-  class Ruby
-    class CLI
-      # Get the current Ruby version using the 'ruby' CLI
-      def self.current_version
-        version_output = `ruby --version 2>/dev/null`.strip
-        raise "Ruby is not installed or not available in PATH" if version_output.empty?
-
-        # Extract version number from output like "ruby 3.2.0p123 (2023-01-01 revision abc123) [x86_64-darwin22]"
-        version_match = version_output.match(/ruby (\d+\.\d+\.\d+)/)
-        if version_match
-          version_match[1]
-        else
-          # Fallback: return the full version string if parsing fails
-          version_output
-        end
-      end
-
-      # Get detailed Ruby version information
-      def self.version_info
-        version_output = `ruby --version 2>/dev/null`.strip
-        raise "Ruby is not installed or not available in PATH" if version_output.empty?
-
-        {
-          full_version: version_output,
-          version: current_version,
-          patch_level: extract_patch_level(version_output),
-          release_date: extract_release_date(version_output),
-          platform: extract_platform(version_output),
-        }
-      end
-
-      # Check if Ruby is installed and available
-      def self.installed?
-        system("ruby --version > /dev/null 2>&1")
-      end
-
-      # Get the Ruby executable path
-      def self.executable_path
-        `which ruby 2>/dev/null`.strip
-      end
-
-      # Get Ruby configuration information
-      def self.config
-        return {} unless installed?
-
-        config_output = `ruby -e "puts RbConfig::CONFIG" 2>/dev/null`
-        return {} if config_output.empty?
-
-        config = {}
-        config_output.lines.each do |line|
-          key, value = line.strip.split("=", 2)
-          config[key] = value if key && value
-        end
-        config
-      end
-
-      # Get Ruby platform information
-      def self.platform
-        return nil unless installed?
-
-        `ruby -e "puts RUBY_PLATFORM" 2>/dev/null`.strip
-      end
-
-      # Get Ruby engine information
-      def self.engine
-        return nil unless installed?
-
-        engine_info = `ruby -e "puts RUBY_ENGINE" 2>/dev/null`.strip
-        engine_version = `ruby -e "puts RUBY_ENGINE_VERSION" 2>/dev/null`.strip
-
-        {
-          name: engine_info,
-          version: engine_version,
-        }
-      end
-
-      # Get Ruby installation directory
-      def self.installation_dir
-        return nil unless installed?
-
-        `ruby -e "puts RbConfig::CONFIG['prefix']" 2>/dev/null`.strip
-      end
-
-      # Get Ruby library directories
-      def self.library_dirs
-        return [] unless installed?
-
-        lib_dirs = `ruby -e "puts RbConfig::CONFIG['libdir']" 2>/dev/null`.strip
-        arch_lib_dirs = `ruby -e "puts RbConfig::CONFIG['archdir']" 2>/dev/null`.strip
-
-        [lib_dirs, arch_lib_dirs].compact.uniq
-      end
-
-      # Get Ruby gem directories
-      def self.gem_dirs
-        return [] unless installed?
-
-        gem_dirs_output = `ruby -e "puts Gem.path" 2>/dev/null`
-        return [] if gem_dirs_output.empty?
-
-        gem_dirs_output.strip.split("\n")
-      end
-
-      # Get Ruby load path
-      def self.load_path
-        return [] unless installed?
-
-        load_path_output = `ruby -e "puts $LOAD_PATH" 2>/dev/null`
-        return [] if load_path_output.empty?
-
-        load_path_output.strip.split("\n")
-      end
-
-      # Check if a specific Ruby version is available
-      def self.version_available?(version)
-        return false unless installed?
-
-        current = current_version
-        case version
-        when /^(\d+)\.(\d+)\.(\d+)$/
-          major = ::Regexp.last_match(1).to_i
-          minor = ::Regexp.last_match(2).to_i
-          patch = ::Regexp.last_match(3).to_i
-          current_major, current_minor, current_patch = current.split(".").map(&:to_i)
-
-          if major != current_major
-            major == current_major
-          elsif minor != current_minor
-            minor == current_minor
-          else
-            patch == current_patch
-          end
-        when /^(\d+)\.(\d+)$/
-          major = ::Regexp.last_match(1).to_i
-          minor = ::Regexp.last_match(2).to_i
-          current_major, current_minor = current.split(".").map(&:to_i)
-          major == current_major && minor == current_minor
-        when /^(\d+)$/
-          major = ::Regexp.last_match(1).to_i
-          current_major = current.split(".").first.to_i
-          major == current_major
-        else
-          false
-        end
-      end
-
-      # Get Ruby environment summary
-      def self.environment_summary
-        return { error: "Ruby is not installed" } unless installed?
-
-        {
-          version: current_version,
-          full_version: version_info[:full_version],
-          platform: platform,
-          engine: engine,
-          executable_path: executable_path,
-          installation_dir: installation_dir,
-          gem_dirs: gem_dirs,
-          library_dirs: library_dirs,
-        }
-      end
-
-      # Extract patch level from version string
-      def self.extract_patch_level(version_string)
-        match = version_string.match(/p(\d+)/)
-        match ? match[1] : nil
-      end
-
-      # Extract release date from version string
-      def self.extract_release_date(version_string)
-        match = version_string.match(/\((\d{4}-\d{2}-\d{2})/)
-        match ? match[1] : nil
-      end
-
-      # Extract platform from version string
-      def self.extract_platform(version_string)
-        match = version_string.match(/\[([^\]]+)\]/)
-        match ? match[1] : nil
-      end
-    end
-  end
-end
+# frozen_string_literal: true
+
+module Makit
+  class Ruby
+    class CLI
+      # Get the current Ruby version using the 'ruby' CLI
+      def self.current_version
+        version_output = `ruby --version 2>/dev/null`.strip
+        raise "Ruby is not installed or not available in PATH" if version_output.empty?
+
+        # Extract version number from output like "ruby 3.2.0p123 (2023-01-01 revision abc123) [x86_64-darwin22]"
+        version_match = version_output.match(/ruby (\d+\.\d+\.\d+)/)
+        if version_match
+          version_match[1]
+        else
+          # Fallback: return the full version string if parsing fails
+          version_output
+        end
+      end
+
+      # Get detailed Ruby version information
+      def self.version_info
+        version_output = `ruby --version 2>/dev/null`.strip
+        raise "Ruby is not installed or not available in PATH" if version_output.empty?
+
+        {
+          full_version: version_output,
+          version: current_version,
+          patch_level: extract_patch_level(version_output),
+          release_date: extract_release_date(version_output),
+          platform: extract_platform(version_output),
+        }
+      end
+
+      # Check if Ruby is installed and available
+      def self.installed?
+        system("ruby --version > /dev/null 2>&1")
+      end
+
+      # Get the Ruby executable path
+      def self.executable_path
+        `which ruby 2>/dev/null`.strip
+      end
+
+      # Get Ruby configuration information
+      def self.config
+        return {} unless installed?
+
+        config_output = `ruby -e "puts RbConfig::CONFIG" 2>/dev/null`
+        return {} if config_output.empty?
+
+        config = {}
+        config_output.lines.each do |line|
+          key, value = line.strip.split("=", 2)
+          config[key] = value if key && value
+        end
+        config
+      end
+
+      # Get Ruby platform information
+      def self.platform
+        return nil unless installed?
+
+        `ruby -e "puts RUBY_PLATFORM" 2>/dev/null`.strip
+      end
+
+      # Get Ruby engine information
+      def self.engine
+        return nil unless installed?
+
+        engine_info = `ruby -e "puts RUBY_ENGINE" 2>/dev/null`.strip
+        engine_version = `ruby -e "puts RUBY_ENGINE_VERSION" 2>/dev/null`.strip
+
+        {
+          name: engine_info,
+          version: engine_version,
+        }
+      end
+
+      # Get Ruby installation directory
+      def self.installation_dir
+        return nil unless installed?
+
+        `ruby -e "puts RbConfig::CONFIG['prefix']" 2>/dev/null`.strip
+      end
+
+      # Get Ruby library directories
+      def self.library_dirs
+        return [] unless installed?
+
+        lib_dirs = `ruby -e "puts RbConfig::CONFIG['libdir']" 2>/dev/null`.strip
+        arch_lib_dirs = `ruby -e "puts RbConfig::CONFIG['archdir']" 2>/dev/null`.strip
+
+        [lib_dirs, arch_lib_dirs].compact.uniq
+      end
+
+      # Get Ruby gem directories
+      def self.gem_dirs
+        return [] unless installed?
+
+        gem_dirs_output = `ruby -e "puts Gem.path" 2>/dev/null`
+        return [] if gem_dirs_output.empty?
+
+        gem_dirs_output.strip.split("\n")
+      end
+
+      # Get Ruby load path
+      def self.load_path
+        return [] unless installed?
+
+        load_path_output = `ruby -e "puts $LOAD_PATH" 2>/dev/null`
+        return [] if load_path_output.empty?
+
+        load_path_output.strip.split("\n")
+      end
+
+      # Check if a specific Ruby version is available
+      def self.version_available?(version)
+        return false unless installed?
+
+        current = current_version
+        case version
+        when /^(\d+)\.(\d+)\.(\d+)$/
+          major = ::Regexp.last_match(1).to_i
+          minor = ::Regexp.last_match(2).to_i
+          patch = ::Regexp.last_match(3).to_i
+          current_major, current_minor, current_patch = current.split(".").map(&:to_i)
+
+          if major != current_major
+            major == current_major
+          elsif minor != current_minor
+            minor == current_minor
+          else
+            patch == current_patch
+          end
+        when /^(\d+)\.(\d+)$/
+          major = ::Regexp.last_match(1).to_i
+          minor = ::Regexp.last_match(2).to_i
+          current_major, current_minor = current.split(".").map(&:to_i)
+          major == current_major && minor == current_minor
+        when /^(\d+)$/
+          major = ::Regexp.last_match(1).to_i
+          current_major = current.split(".").first.to_i
+          major == current_major
+        else
+          false
+        end
+      end
+
+      # Get Ruby environment summary
+      def self.environment_summary
+        return { error: "Ruby is not installed" } unless installed?
+
+        {
+          version: current_version,
+          full_version: version_info[:full_version],
+          platform: platform,
+          engine: engine,
+          executable_path: executable_path,
+          installation_dir: installation_dir,
+          gem_dirs: gem_dirs,
+          library_dirs: library_dirs,
+        }
+      end
+
+      # Extract patch level from version string
+      def self.extract_patch_level(version_string)
+        match = version_string.match(/p(\d+)/)
+        match ? match[1] : nil
+      end
+
+      # Extract release date from version string
+      def self.extract_release_date(version_string)
+        match = version_string.match(/\((\d{4}-\d{2}-\d{2})/)
+        match ? match[1] : nil
+      end
+
+      # Extract platform from version string
+      def self.extract_platform(version_string)
+        match = version_string.match(/\[([^\]]+)\]/)
+        match ? match[1] : nil
+      end
+    end
+  end
+end

data/lib/makit/ruby.rb

@@ -1,25 +1,25 @@
-# frozen_string_literal: true
-
-require_relative "ruby/cli"
-
-module Makit
-  class Ruby
-    # Main Ruby module for Makit
-    # Provides Ruby-related functionality and utilities
-
-    # Get current Ruby version (convenience method)
-    def self.version
-      CLI.current_version
-    end
-
-    # Check if Ruby is installed (convenience method)
-    def self.installed?
-      CLI.installed?
-    end
-
-    # Get Ruby environment information (convenience method)
-    def self.info
-      CLI.environment_summary
-    end
-  end
-end
+# frozen_string_literal: true
+
+require_relative "ruby/cli"
+
+module Makit
+  class Ruby
+    # Main Ruby module for Makit
+    # Provides Ruby-related functionality and utilities
+
+    # Get current Ruby version (convenience method)
+    def self.version
+      CLI.current_version
+    end
+
+    # Check if Ruby is installed (convenience method)
+    def self.installed?
+      CLI.installed?
+    end
+
+    # Get Ruby environment information (convenience method)
+    def self.info
+      CLI.environment_summary
+    end
+  end
+end

data/lib/makit/rubygems.rb

@@ -0,0 +1,137 @@
+# frozen_string_literal: true
+
+require "fileutils"
+require "yaml"
+require "colorize"
+require_relative "secrets"
+
+module Makit
+  # RubyGems operations helper module
+  # Provides centralized RubyGems functionality, starting with credential management
+  module RubyGems
+    # Retrieves RubyGems API key from secrets management system or credentials file
+    # Priority: 1) Secrets (RUBYGEMS_API_KEY or rubygems_api_key), 2) ~/.gem/credentials file
+    # @return [String, nil] API key if found, nil otherwise
+    def self.get_api_key
+      # Priority 1: Check secrets management system
+      begin
+        secrets = Makit::Secrets.new
+        api_key = secrets.get("RUBYGEMS_API_KEY") || secrets.get("rubygems_api_key")
+        return api_key if api_key && !api_key.empty?
+      rescue StandardError => e
+        # Secrets backend may be unavailable (network error, auth failure, etc.)
+        # Fall back to credentials file with warning
+        credentials_file = File.expand_path("~/.gem/credentials")
+        if File.exist?(credentials_file)
+          warn "  Warning: Secrets backend unavailable (#{e.class.name}), falling back to ~/.gem/credentials".colorize(:yellow)
+        end
+      end
+
+      # Priority 2: Check ~/.gem/credentials file
+      credentials_file = File.expand_path("~/.gem/credentials")
+      if File.exist?(credentials_file)
+        begin
+          credentials = YAML.load_file(credentials_file)
+          api_key = credentials[:rubygems_api_key] if credentials && credentials[:rubygems_api_key]
+          return api_key if api_key && !api_key.empty?
+        rescue StandardError => e
+          # Credentials file may be malformed
+          # Will be handled by error messages
+        end
+      end
+
+      nil
+    end
+
+    # Validates API key format (basic validation)
+    # Checks: non-empty, length >= 20, valid characters (alphanumeric, hyphens, underscores)
+    # @param api_key [String, nil] The API key to validate
+    # @return [Boolean] true if valid, false otherwise
+    def self.validate_api_key_format(api_key)
+      return false if api_key.nil? || api_key.strip.empty?
+      return false if api_key.length < 20
+      return false unless api_key.match?(/\A[a-zA-Z0-9_-]+\z/)
+      true
+    end
+
+    # Syncs API key from secrets to ~/.gem/credentials file
+    # Only updates if file doesn't exist or API key is different
+    # Sets file permissions to 600 (owner read/write only) for security
+    # @param api_key [String] The API key to sync
+    # @return [void]
+    def self.sync_credentials_from_secrets(api_key)
+      return if api_key.nil? || api_key.empty?
+
+      credentials_file = File.expand_path("~/.gem/credentials")
+      
+      # Check if file exists and has same API key
+      if File.exist?(credentials_file)
+        begin
+          require "yaml"
+          existing_credentials = YAML.load_file(credentials_file)
+          existing_key = existing_credentials[:rubygems_api_key] if existing_credentials
+          return if existing_key == api_key # No update needed
+        rescue StandardError
+          # File may be malformed, proceed with update
+        end
+      end
+
+      # Create or update credentials file
+      credentials_dir = File.dirname(credentials_file)
+      FileUtils.mkdir_p(credentials_dir) unless Dir.exist?(credentials_dir)
+
+      credentials_content = { rubygems_api_key: api_key }.to_yaml
+      File.write(credentials_file, credentials_content)
+      File.chmod(0o600, credentials_file) # rw------- (owner read/write only)
+
+      puts "  Updated ~/.gem/credentials from secrets".colorize(:green)
+    end
+
+    # Generates context-aware credential setup instructions
+    # Prioritizes methods based on detected configuration (Azure Key Vault, LocalSecrets, or neither)
+    # @return [String] Formatted error message with setup instructions
+    def self.credential_setup_instructions
+      methods = []
+      
+      # Detect configuration and prioritize
+      azure_configured = ENV["AZURE_SERVICE_PRINCIPAL_APP_ID"] && !ENV["AZURE_SERVICE_PRINCIPAL_APP_ID"].empty? &&
+                         ENV["AZURE_KEYVAULT_NAME"] && !ENV["AZURE_KEYVAULT_NAME"].empty?
+
+      if azure_configured
+        methods << "1. Using Azure Key Vault (recommended for your setup):"
+        methods << "   az login"
+        methods << "   az keyvault secret set \\"
+        methods << "     --vault-name '#{ENV["AZURE_KEYVAULT_NAME"]}' \\"
+        methods << "     --name RUBYGEMS_API_KEY \\"
+        methods << "     --value 'your-api-key-here'"
+        methods << ""
+        methods << "   For full Azure Key Vault setup, see: docs/azure-keyvault-permissions.md"
+        methods << ""
+        methods << "2. Using Local Secrets:"
+        methods << "   rake secrets  # Check current secrets"
+        methods << "   # Edit ~/.makit/secrets.json and add:"
+        methods << "   #   \"RUBYGEMS_API_KEY\": \"your-api-key-here\""
+      else
+        methods << "1. Using Secrets Management (recommended):"
+        methods << "   rake secrets  # Check current secrets"
+        methods << "   # Edit ~/.makit/secrets.json and add:"
+        methods << "   #   \"RUBYGEMS_API_KEY\": \"your-api-key-here\""
+        methods << ""
+        methods << "   For Azure Key Vault setup, see: docs/azure-keyvault-permissions.md"
+      end
+
+      methods << ""
+      methods << "3. Using gem signin:"
+      methods << "   gem signin"
+      methods << "   Follow the prompts to enter your RubyGems username and password."
+      methods << ""
+      methods << "4. Manual credentials file:"
+      methods << "   a. Get your API key from: https://rubygems.org/api_keys"
+      methods << "   b. Create ~/.gem/credentials with the following content:"
+      methods << "      :rubygems_api_key: YOUR_API_KEY_HERE"
+
+      "Error: RubyGems credentials not found\n\nTo set up credentials, choose one of the following methods:\n\n#{methods.join("\n")}\n\nFor detailed instructions, see: docs/RUBYGEMS_PUBLISHING.md"
+    end
+  end
+end
+