sidekiq_queue_manager 1.0.0

data/app/views/sidekiq_queue_manager/dashboard/index.html.erb

@@ -0,0 +1,208 @@
+<!-- Theme Toggle Button -->
+<button id="sqm-theme-toggle" class="sqm-theme-toggle" aria-label="Toggle theme" title="Toggle dark/light mode">
+  <svg class="sqm-theme-icon-light" xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor" style="width: 1rem; height: 1rem;">
+    <path stroke-linecap="round" stroke-linejoin="round" d="M12 3v2.25m6.364.386l-1.591 1.591M21 12h-2.25m-.386 6.364l-1.591-1.591M12 18.75V21m-4.773-4.227l-1.591 1.591M5.25 12H3m4.227-4.773L5.636 5.636a9 9 0 1011.314 0z" />
+  </svg>
+  <svg class="sqm-theme-icon-dark sqm-hidden" xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor" style="width: 1rem; height: 1rem;">
+    <path stroke-linecap="round" stroke-linejoin="round" d="M21.752 15.002A9.718 9.718 0 0118 15.75c-5.385 0-9.75-4.365-9.75-9.75 0-1.33.266-2.597.748-3.752A9.753 9.753 0 003 11.25C3 16.635 7.365 21 12.75 21a9.753 9.753 0 009.002-5.998z" />
+  </svg>
+</button>
+
+<!-- Global Statistics -->
+<section class="sqm-stats-section" aria-label="Global Statistics">
+  <div class="sqm-stats-grid">
+    <div class="sqm-stat-card">
+      <div class="sqm-stat-label">Processed Jobs</div>
+      <div class="sqm-stat-value" id="sqm-processed">0</div>
+    </div>
+
+    <div class="sqm-stat-card">
+      <div class="sqm-stat-label">Failed Jobs</div>
+      <div class="sqm-stat-value" id="sqm-failed">0</div>
+    </div>
+
+    <div class="sqm-stat-card">
+      <div class="sqm-stat-label">Active Workers</div>
+      <div class="sqm-stat-value" id="sqm-busy">0</div>
+    </div>
+
+    <div class="sqm-stat-card">
+      <div class="sqm-stat-label">Enqueued Jobs</div>
+      <div class="sqm-stat-value" id="sqm-enqueued">0</div>
+    </div>
+  </div>
+</section>
+
+<!-- Controls Panel -->
+<section class="sqm-controls-section" aria-label="Queue Controls">
+  <div class="sqm-controls">
+    <div class="sqm-controls-left">
+      <!-- Live Pull Toggle -->
+      <div class="sqm-live-pull-container">
+        <div class="sqm-live-pull-toggle">
+          <svg class="sqm-live-icon" xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor">
+            <path stroke-linecap="round" stroke-linejoin="round" d="M3.75 13.5l10.5-11.25L12 10.5h8.25L9.75 21.75 12 13.5H3.75z" />
+          </svg>
+          <span class="sqm-toggle-text">Live Pull (5s)</span>
+          <div class="sqm-live-status">
+            <div class="sqm-status-dot"></div>
+            <span class="sqm-status-text">OFF</span>
+          </div>
+        </div>
+        <button id="sqm-live-toggle-btn" class="sqm-toggle-switch" data-enabled="false" aria-label="Toggle live updates">
+          <div class="sqm-toggle-thumb">
+            <svg class="sqm-toggle-icon sqm-toggle-icon-off" xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor">
+              <path stroke-linecap="round" stroke-linejoin="round" d="M6 18L18 6M6 6l12 12" />
+            </svg>
+            <svg class="sqm-toggle-icon sqm-toggle-icon-on" xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor">
+              <path stroke-linecap="round" stroke-linejoin="round" d="M4.5 12.75l6 6 9-13.5" />
+            </svg>
+          </div>
+        </button>
+      </div>
+
+      <!-- Manual Refresh -->
+      <div class="sqm-refresh-container">
+        <button id="sqm-refresh-btn" class="sqm-refresh-button" title="Manual refresh" aria-label="Manually refresh queue data">
+          <svg class="sqm-refresh-icon" xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor">
+            <path stroke-linecap="round" stroke-linejoin="round" d="M16.023 9.348h4.992v-.001M2.985 19.644v-4.992m0 0h4.992m-4.993 0l3.181 3.183a8.25 8.25 0 0013.803-3.7M4.031 9.865a8.25 8.25 0 0113.803-3.7l3.181 3.182m0-4.991v4.99" />
+          </svg>
+          <span>Refresh</span>
+        </button>
+      </div>
+    </div>
+
+    <div class="sqm-controls-right">
+      <!-- Bulk Actions -->
+      <button id="sqm-pause-all-btn" class="sqm-btn sqm-btn-warning" title="Pause all non-critical queues">
+        <svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor" style="width: 1rem; height: 1rem;">
+          <path stroke-linecap="round" stroke-linejoin="round" d="M15.75 5.25v13.5m-7.5-13.5v13.5" />
+        </svg>
+        Pause All
+      </button>
+
+      <button id="sqm-resume-all-btn" class="sqm-btn sqm-btn-success" title="Resume all paused queues">
+        <svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor" style="width: 1rem; height: 1rem;">
+          <path stroke-linecap="round" stroke-linejoin="round" d="M5.25 5.653c0-.856.917-1.398 1.667-.986l11.54 6.348a1.125 1.125 0 010 1.971l-11.54 6.347a1.125 1.125 0 01-1.667-.985V5.653z" />
+        </svg>
+        Resume All
+      </button>
+    </div>
+  </div>
+</section>
+
+<!-- Queue Statistics Summary -->
+<section class="sqm-queue-summary" aria-label="Queue Summary">
+  <div class="sqm-stats-grid" style="grid-template-columns: repeat(auto-fit, minmax(180px, 1fr));">
+    <div class="sqm-stat-card">
+      <div class="sqm-stat-label">Total Queues</div>
+      <div class="sqm-stat-value" id="sqm-total-queues">0</div>
+    </div>
+
+    <div class="sqm-stat-card">
+      <div class="sqm-stat-label">Paused Queues</div>
+      <div class="sqm-stat-value" id="sqm-paused-queues">0</div>
+    </div>
+
+    <div class="sqm-stat-card">
+      <div class="sqm-stat-label">Total Jobs</div>
+      <div class="sqm-stat-value" id="sqm-total-jobs">0</div>
+    </div>
+  </div>
+</section>
+
+<!-- Loading State -->
+<div id="sqm-loading" class="sqm-loading">
+  <div class="sqm-loading-spinner" aria-hidden="true"></div>
+  <div class="sqm-loading-text">Loading queue data...</div>
+</div>
+
+<!-- Error State -->
+<div id="sqm-error" class="sqm-error sqm-hidden">
+  <svg class="sqm-error-icon" xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor">
+    <path stroke-linecap="round" stroke-linejoin="round" d="M12 9v3.75m9-.75a9 9 0 11-18 0 9 9 0 0118 0zm-9 3.75h.008v.008H12v-.008z" />
+  </svg>
+  <h2 class="sqm-error-title">Failed to Load Queue Data</h2>
+  <p class="sqm-error-message" id="sqm-error-message">An error occurred while loading the queue information.</p>
+  <button id="sqm-retry-btn" class="sqm-btn sqm-btn-primary">
+    <svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor" style="width: 1rem; height: 1rem;">
+      <path stroke-linecap="round" stroke-linejoin="round" d="M16.023 9.348h4.992v-.001M2.985 19.644v-4.992m0 0h4.992m-4.993 0l3.181 3.183a8.25 8.25 0 0013.803-3.7M4.031 9.865a8.25 8.25 0 0113.803-3.7l3.181 3.182m0-4.991v4.99" />
+    </svg>
+    Retry
+  </button>
+</div>
+
+<!-- Main Content -->
+<div id="sqm-content" class="sqm-hidden">
+  <!-- Queues Table -->
+  <section class="sqm-queues-section" aria-label="Queue Details">
+    <div class="sqm-table-container">
+      <table class="sqm-table" id="sqm-queues-table">
+        <thead>
+          <tr>
+            <th scope="col">Queue Name</th>
+            <th scope="col" style="text-align: right;">Size</th>
+            <th scope="col" style="text-align: right;">Workers/Limits</th>
+            <th scope="col" style="text-align: right;">Latency</th>
+            <th scope="col" style="text-align: right;">Actions</th>
+          </tr>
+        </thead>
+        <tbody id="sqm-table-body">
+          <!-- Queue rows will be inserted here by JavaScript -->
+        </tbody>
+      </table>
+    </div>
+  </section>
+</div>
+
+<!-- Empty State (when no queues) -->
+<div id="sqm-empty-state" class="sqm-hidden" style="text-align: center; padding: 3rem 2rem; color: var(--sqm-muted-foreground);">
+  <svg style="width: 4rem; height: 4rem; margin-bottom: 1rem; color: var(--sqm-muted-foreground);" xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor">
+    <path stroke-linecap="round" stroke-linejoin="round" d="M3.75 6.75h16.5M3.75 12h16.5M12 17.25h8.25M3.75 17.25h.01v.01h-.01v-.01ZM7.5 17.25h.01v.01H7.5v-.01ZM11.25 17.25h.01v.01h-.01v-.01Z" />
+  </svg>
+  <h2 style="font-size: 1.25rem; font-weight: 600; color: var(--sqm-muted-foreground); margin-bottom: 1rem;">No Queues Found</h2>
+  <p style="font-size: 0.875rem; margin-bottom: 2rem; line-height: 1.5;">
+    No Sidekiq queues were discovered. Make sure Sidekiq is properly configured and has processed jobs.
+  </p>
+  <button id="sqm-refresh-empty" class="sqm-btn sqm-btn-primary">
+    <svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor" style="width: 1rem; height: 1rem;">
+      <path stroke-linecap="round" stroke-linejoin="round" d="M16.023 9.348h4.992v-.001M2.985 19.644v-4.992m0 0h4.992m-4.993 0l3.181 3.183a8.25 8.25 0 0013.803-3.7M4.031 9.865a8.25 8.25 0 0113.803-3.7l3.181 3.182m0-4.991v4.99" />
+    </svg>
+    Check Again
+  </button>
+</div>
+
+<!-- Accessibility Announcements -->
+<div id="sqm-announcements" class="sqm-sr-only" aria-live="polite" aria-atomic="true"></div>
+
+<script type="application/ld+json">
+{
+  "@context": "https://schema.org",
+  "@type": "WebApplication",
+  "name": "Sidekiq Queue Manager",
+  "description": "Professional Sidekiq queue monitoring and management interface",
+  "applicationCategory": "DeveloperApplication",
+  "operatingSystem": "Web Browser",
+  "offers": {
+    "@type": "Offer",
+    "price": "0",
+    "priceCurrency": "USD"
+  }
+}
+</script>
+
+<!-- Initial Data Script -->
+<% if @initial_metrics %>
+<script type="text/javascript">
+  // Provide initial data to reduce initial loading time
+  window.SidekiqQueueManagerInitialData = <%= @initial_metrics.to_json.html_safe %>;
+</script>
+<% end %>
+
+<!-- Configuration Display (for debugging in development) -->
+<% if Rails.env.development? %>
+<details style="margin-top: 2rem; padding: 1rem; background: var(--sqm-card); border: 1px solid var(--sqm-border); border-radius: var(--sqm-radius); font-family: var(--sqm-font-mono); font-size: 0.75rem;">
+  <summary style="cursor: pointer; font-weight: 600; color: var(--sqm-muted-foreground);">🔧 Development Configuration</summary>
+  <pre style="margin-top: 1rem; white-space: pre-wrap; color: var(--sqm-muted-foreground); font-size: 0.6875rem;"><%= @configuration.to_yaml if @configuration %></pre>
+</details>
+<% end %>

data/config/routes.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+SidekiqQueueManager::Engine.routes.draw do
+  # Asset serving routes (for apps without asset pipeline)
+  get '/assets/sidekiq_queue_manager/application.css', to: 'assets#css'
+  get '/assets/sidekiq_queue_manager/application.js', to: 'assets#js'
+  get '/assets/sidekiq_queue_manager/modals.css', to: 'assets#modals_css'
+  get '/stylesheets/sidekiq_queue_manager/application.css', to: 'assets#css'
+  get '/stylesheets/sidekiq_queue_manager/modals.css', to: 'assets#modals_css'
+  get '/javascripts/sidekiq_queue_manager/application.js', to: 'assets#js'
+  get '/sidekiq_queue_manager/application.css', to: 'assets#css'
+  get '/sidekiq_queue_manager/application.js', to: 'assets#js'
+  get '/sidekiq_queue_manager/modals.css', to: 'assets#modals_css'
+
+  # Main queue manager interface
+  root 'dashboard#index'
+
+  # Dashboard and metrics
+  get '/', to: 'dashboard#index', as: :dashboard
+  get '/metrics', to: 'dashboard#metrics', as: :metrics
+
+  # Bulk operations (collection actions)
+  post '/queues/pause_all', to: 'dashboard#pause_all', as: :pause_all_queues
+  post '/queues/resume_all', to: 'dashboard#resume_all', as: :resume_all_queues
+  get '/queues/summary', to: 'dashboard#summary', as: :queues_summary
+
+  # Individual queue operations
+  post '/queues/:name/pause', to: 'dashboard#pause_queue', as: :pause_queue
+  post '/queues/:name/resume', to: 'dashboard#resume_queue', as: :resume_queue
+  get '/queues/:name/status', to: 'dashboard#queue_status', as: :queue_status
+  get '/queues/:name/jobs', to: 'dashboard#jobs', as: :queue_jobs
+  delete '/queues/:name/delete_job', to: 'dashboard#delete_job', as: :delete_queue_job
+  post '/queues/:name/clear', to: 'dashboard#clear', as: :clear_queue
+
+  # Queue limits and configuration
+  post '/queues/:name/set_limit', to: 'dashboard#set_limit', as: :set_queue_limit
+  delete '/queues/:name/remove_limit', to: 'dashboard#remove_limit', as: :remove_queue_limit
+  post '/queues/:name/set_process_limit', to: 'dashboard#set_process_limit', as: :set_queue_process_limit
+  delete '/queues/:name/remove_process_limit', to: 'dashboard#remove_process_limit', as: :remove_queue_process_limit
+
+  # Advanced queue operations
+  post '/queues/:name/block', to: 'dashboard#block', as: :block_queue
+  post '/queues/:name/unblock', to: 'dashboard#unblock', as: :unblock_queue
+
+  # Real-time updates via Server-Sent Events
+  get '/live', to: 'dashboard#live_stream', as: :live_stream
+end
+

data/lib/sidekiq_queue_manager/configuration.rb

@@ -0,0 +1,157 @@
+# frozen_string_literal: true
+
+module SidekiqQueueManager
+  # Configuration class for customizing SidekiqQueueManager behavior
+  # Focus on essential user-configurable options only
+  class Configuration
+    # Essential user-configurable options
+    attr_accessor :authentication_method, :critical_queues, :theme
+    attr_accessor :basic_auth_enabled, :basic_auth_username, :basic_auth_password
+
+    # Advanced options (rarely changed, but available)
+    attr_accessor :refresh_interval, :enable_logging, :enable_caching, :default_queue_priorities
+
+    # Internal options (sensible defaults, not typically user-configured)
+    attr_reader :redis_key_prefix, :redis_timeout, :log_level, :enable_csp, :cache_ttl
+
+    def initialize
+      # Essential defaults (what most users care about)
+      @authentication_method = nil          # Custom auth method (optional)
+      @critical_queues = []                 # No protected queues by default
+      @theme = 'auto'                       # Auto light/dark theme
+
+      # Basic HTTP Authentication (professional standard - explicit configuration required)
+      @basic_auth_enabled = true            # Secure by default like Sidekiq Web UI
+      @basic_auth_username = 'admin'        # Standard admin username
+      @basic_auth_password = nil            # MUST be explicitly set by user
+
+      # Advanced defaults (rarely changed)
+      @refresh_interval = 5000              # 5 second UI refresh
+      @enable_logging = true                # Log queue operations
+      @enable_caching = true                # Cache queue stats for performance
+      @default_queue_priorities = {}        # User-defined queue priorities
+
+      # Internal defaults (best practices, rarely modified)
+      @redis_key_prefix = 'sidekiq_queue_manager' # Namespace Redis keys
+      @redis_timeout = 5                    # 5 second Redis timeout
+      @log_level = :info                    # Standard logging level
+      @enable_csp = true                    # Security headers enabled
+      @cache_ttl = 300                      # 5 minute cache TTL
+    end
+
+    # Validate essential user-provided configuration
+    def validate!
+      validate_basic_settings!
+      validate_authentication!
+      self # Return self for method chaining (Ruby idiom)
+    end
+
+    # Check if configuration is valid without raising (Ruby's truthiness approach)
+    def valid?
+      validate!
+      true
+    rescue ConfigurationError
+      false
+    end
+
+    # Export configuration as hash (for JavaScript and internal use)
+    def to_h
+      {
+        # Essential user options
+        authentication_method: @authentication_method,
+        critical_queues: @critical_queues,
+        theme: @theme,
+        basic_auth_enabled: @basic_auth_enabled,
+        basic_auth_username: @basic_auth_username,
+        # NOTE: basic_auth_password excluded for security
+
+        # Advanced options
+        refresh_interval: @refresh_interval,
+        enable_logging: @enable_logging,
+        enable_caching: @enable_caching,
+        default_queue_priorities: @default_queue_priorities,
+
+        # Internal options (included for completeness)
+        redis_key_prefix: @redis_key_prefix,
+        redis_timeout: @redis_timeout,
+        log_level: @log_level,
+        enable_csp: @enable_csp,
+        cache_ttl: @cache_ttl
+      }
+    end
+
+    # Essential configuration summary (for debugging) - more Ruby-like
+    def summary
+      auth_status = if basic_auth_enabled?
+                      "basic auth (#{basic_auth_username})"
+                    elsif authentication_method
+                      "custom (#{authentication_method})"
+                    else
+                      'disabled'
+                    end
+
+      {
+        critical_queues: critical_queues.presence || 'none',
+        theme: theme,
+        authentication: auth_status,
+        caching: enable_caching? ? 'enabled' : 'disabled'
+      }
+    end
+
+    # Predicate methods (Ruby convention for boolean checks)
+    def basic_auth_enabled? = @basic_auth_enabled
+    def enable_logging? = @enable_logging
+    def enable_caching? = @enable_caching
+    def enable_csp? = @enable_csp
+    def custom_authentication? = @authentication_method.present?
+
+    # Check if queue is critical (more Ruby-like with inclusion check)
+    def critical_queue?(queue_name)
+      critical_queues.include?(queue_name.to_s)
+    end
+
+    # Get queue priority with Ruby's Hash#fetch for elegant defaults
+    def queue_priority(queue_name)
+      default_queue_priorities.fetch(queue_name.to_s, 1)
+    end
+
+    private
+
+    # Validate basic configuration settings
+    def validate_basic_settings!
+      # Use Ruby's case statements for more readable validation
+      case refresh_interval
+      when Integer
+        raise ConfigurationError, 'refresh_interval must be positive' unless refresh_interval.positive?
+      else
+        raise ConfigurationError, 'refresh_interval must be a positive Integer'
+      end
+
+      raise ConfigurationError, 'critical_queues must be an Array' unless critical_queues.is_a?(Array)
+
+      raise ConfigurationError, 'theme must be one of: auto, light, dark' unless %w[auto light dark].include?(theme)
+
+      self
+    end
+
+    # Validate authentication configuration (explicit, professional standard)
+    def validate_authentication!
+      # Only validate if basic auth is enabled (explicit choice)
+      return self unless basic_auth_enabled?
+
+      # Use Ruby's presence for more elegant nil/empty checks
+      if basic_auth_password.blank?
+        raise ConfigurationError, 'basic_auth_password must be set when basic_auth_enabled is true. ' \
+                                  'Set config.basic_auth_password in your initializer or disable with ' \
+                                  'basic_auth_enabled = false'
+      end
+
+      if basic_auth_username.blank?
+        raise ConfigurationError, 'basic_auth_username cannot be empty when basic_auth_enabled is true'
+      end
+
+      self
+    end
+  end
+end
+

data/lib/sidekiq_queue_manager/engine.rb

@@ -0,0 +1,151 @@
+# frozen_string_literal: true
+
+require 'rails/engine'
+
+module SidekiqQueueManager
+  # Rails Engine for integrating SidekiqQueueManager with Rails applications
+  #
+  # This engine automatically:
+  # - Adds gem routes to the Rails application
+  # - Registers assets (CSS, JavaScript) with the asset pipeline
+  # - Sets up middleware and initializers
+  # - Provides mountable functionality
+  #
+  class Engine < ::Rails::Engine
+    isolate_namespace SidekiqQueueManager
+
+    # Engine configuration using Ruby's expressive syntax
+    config.generators do |g|
+      g.test_framework :rspec
+      g.fixture_replacement :factory_bot
+      g.assets false
+      g.helper false
+    end
+
+    # Initialize the engine with Ruby's elegant error handling
+    initializer 'sidekiq_queue_manager.assets' do |app|
+      configure_assets(app).tap do |configured|
+        Rails.logger.info asset_configuration_message(configured)
+      end
+    end
+
+    # Validate dependencies and configuration on engine load
+    initializer 'sidekiq_queue_manager.validate_dependencies_and_config' do
+      validate_and_configure!
+    rescue SidekiqQueueManager::ConfigurationError => e
+      handle_configuration_error(e)
+    rescue StandardError => e
+      handle_dependency_error(e)
+    end
+
+    initializer 'sidekiq_queue_manager.configure_limit_fetch', before: 'sidekiq' do
+      configure_sidekiq_limit_fetch
+    end
+
+    # Set up middleware for security headers and logging
+    initializer 'sidekiq_queue_manager.middleware' do |app|
+      configure_middleware(app) if SidekiqQueueManager.enable_logging?
+    rescue StandardError => e
+      Rails.logger.warn "[SidekiqQueueManager] Could not configure middleware: #{e.message}"
+    end
+
+    # Configure eager loading paths
+    config.eager_load_paths << File.expand_path('../../app', __dir__)
+
+    private
+
+    # Asset configuration with Ruby's functional approach
+    def configure_assets(app)
+      return false unless asset_pipeline_available?(app)
+
+      configure_asset_pipeline(app)
+    rescue StandardError => e
+      Rails.logger.warn "[SidekiqQueueManager] Asset pipeline configuration failed: #{e.message}"
+      false
+    end
+
+    def asset_pipeline_available?(app)
+      app.config.respond_to?(:assets) && defined?(Sprockets)
+    end
+
+    def configure_asset_pipeline(app)
+      app.config.assets.precompile += %w[
+        sidekiq_queue_manager/application.js
+        sidekiq_queue_manager/application.css
+        sidekiq_queue_manager/modals.css
+      ]
+      true
+    end
+
+    def asset_configuration_message(configured)
+      if configured
+        '[SidekiqQueueManager] Assets registered with asset pipeline'
+      else
+        '[SidekiqQueueManager] Asset pipeline not available - using direct asset serving via /assets/* routes'
+      end
+    end
+
+    # Dependency validation with Ruby's case pattern matching
+    def validate_and_configure!
+      SidekiqQueueManager.validate_dependencies!
+      SidekiqQueueManager.configuration.validate!
+      Rails.logger.info '[SidekiqQueueManager] Configuration validated successfully'
+    end
+
+    def handle_configuration_error(error)
+      Rails.logger.error "[SidekiqQueueManager] Configuration error: #{error.message}"
+      Rails.logger.error '[SidekiqQueueManager] Please check your config/initializers/sidekiq_queue_manager.rb'
+      # Don't raise in production to prevent app startup failures, but log clearly
+      raise error unless Rails.env.production?
+    end
+
+    def handle_dependency_error(error)
+      Rails.logger.error "[SidekiqQueueManager] Dependency validation failed: #{error.message}"
+      # Don't raise in production to prevent app startup failures
+      raise error unless Rails.env.production?
+    end
+
+    # Sidekiq limit fetch configuration using Ruby's method chaining
+    def configure_sidekiq_limit_fetch
+      return configure_existing_limit_fetch if sidekiq_limit_fetch_available?
+
+      attempt_to_load_limit_fetch
+    end
+
+    def sidekiq_limit_fetch_available?
+      defined?(Sidekiq::LimitFetch)
+    end
+
+    def configure_existing_limit_fetch
+      configure_sidekiq_server_options
+      Rails.logger.info '[SidekiqQueueManager] Configured sidekiq-limit_fetch for advanced queue management'
+    end
+
+    def attempt_to_load_limit_fetch
+      require 'sidekiq-limit_fetch'
+
+      if defined?(Sidekiq::LimitFetch)
+        configure_sidekiq_server_options
+        Rails.logger.info '[SidekiqQueueManager] Loaded and configured sidekiq-limit_fetch'
+      end
+    rescue LoadError => e
+      Rails.logger.warn "[SidekiqQueueManager] sidekiq-limit_fetch not available: #{e.message}"
+      Rails.logger.warn '[SidekiqQueueManager] Some advanced queue features may not work'
+    end
+
+    def configure_sidekiq_server_options
+      Sidekiq.configure_server do |config|
+        config.options[:fetch] = Sidekiq::LimitFetch
+      end
+    end
+
+    # Middleware configuration using Ruby's guard clauses
+    def configure_middleware(app)
+      return unless SidekiqQueueManager.configuration.enable_logging?
+
+      app.middleware.use SidekiqQueueManager::LoggingMiddleware
+      Rails.logger.info '[SidekiqQueueManager] Logging middleware enabled'
+    end
+  end
+end
+

data/lib/sidekiq_queue_manager/logging_middleware.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module SidekiqQueueManager
+  # Simple logging middleware for SidekiqQueueManager requests
+  class LoggingMiddleware
+    def initialize(app)
+      @app = app
+    end
+
+    def call(env)
+      # Only log requests to our gem's paths
+      if env['PATH_INFO'].start_with?('/sidekiq_dashboard')
+        start_time = Time.current
+
+        status, headers, body = @app.call(env)
+
+        end_time = Time.current
+        duration = (end_time - start_time) * 1000 # milliseconds
+
+        Rails.logger.info "[SidekiqQueueManager] #{env['REQUEST_METHOD']} #{env['PATH_INFO']} - #{status} (#{duration.round(2)}ms)"
+
+        [status, headers, body]
+      else
+        @app.call(env)
+      end
+    end
+  end
+end
+

data/lib/sidekiq_queue_manager/version.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module SidekiqQueueManager
+  # Semantic versioning for the Sidekiq Queue Manager gem
+  #
+  # Version format: MAJOR.MINOR.PATCH
+  # - MAJOR: Incompatible API changes
+  # - MINOR: Add functionality in backward compatible manner
+  # - PATCH: Backward compatible bug fixes
+  VERSION = '1.0.0'
+end
+