passive_queue 1.0.0 → 1.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a8b4f0e4d9843f7d1bd519582dfeeba0ba98282380a557f9aaf9508ee3fc6418
-  data.tar.gz: b52061271a1d520d154e4eb952e20ec430d6a571ade3fcf6830cff270e4b5c84
+  metadata.gz: 9626aa3a54166dec9163d940f247127a3d58327cd505ce19c290987114b0042c
+  data.tar.gz: bdb330ddf8cae62fda5f291154d47b22c9c04d40b658ecf57e21abdb27f972ab
 SHA512:
-  metadata.gz: d51d7f54fcfdea3f7def1cab47104215f8188e5f226d820a72bc76e42827b2c4e63b815352acc627a6d87cbcd53123c9b2e886750b9a94fbd312c2cf43542cd2
-  data.tar.gz: 679e47135dde14ca024f90a8a820028cf1f4fca4e2b47b7f0a20bac9ab5755e6daf7b8a5dbecb0207907d139cef2536b6d5e09cf359d277a430acfe7435ad5df
+  metadata.gz: 121494063566f43ca2185eefb38972d28cc94089122b3f81abea0797c000e99f8793b8ad93aa27460d4b9c7080192afab51c0dfdd2c8fe8c07275e521e245cee
+  data.tar.gz: 60352ffec9bb812518ee83f37eb9b5d3fa33179df11a7848996f027a469a9d96e8b8ac258738cb041ee815b7c8a400f82c9cfd16b2d34c4ad35cc3373c2f7a0d

data/.ruby-version

@@ -0,0 +1 @@
+4.0.4

data/.yard-lint.yml

@@ -0,0 +1,274 @@
+# YARD-Lint Configuration
+# See https://github.com/mensfeld/yard-lint for documentation
+
+# Global settings for all validators
+AllValidators:
+  FailOnSeverity: convention
+  MinCoverage: 100.0
+  YardOptions:
+  - "--private"
+  - "--protected"
+
+# Documentation validators
+Documentation/UndocumentedObjects:
+  Description: All classes, modules, and methods must be documented
+  Enabled: true
+  Severity: error
+  ExcludedMethods:
+  - initialize/0
+  - "/^_/"
+
+Documentation/UndocumentedMethodArguments:
+  Description: All method parameters must have @param documentation
+  Enabled: true
+  Severity: error
+
+Documentation/UndocumentedBooleanMethods:
+  Description: Checks that question mark methods document their boolean return.
+  Enabled: true
+  Severity: warning
+
+Documentation/UndocumentedOptions:
+  Description: Detects methods with options hash parameters but no @option tags.
+  Enabled: true
+  Severity: warning
+
+Documentation/MarkdownSyntax:
+  Description: All markdown in documentation must be valid
+  Enabled: true
+  Severity: error
+
+Documentation/EmptyCommentLine:
+  Description: Detects empty comment lines at the start or end of documentation blocks.
+  Enabled: true
+  Severity: convention
+  EnabledPatterns:
+    Leading: true
+    Trailing: true
+
+Documentation/BlankLineBeforeDefinition:
+  Description: Detects blank lines between YARD documentation and method definition.
+  Enabled: true
+  Severity: convention
+  OrphanedSeverity: convention
+  EnabledPatterns:
+    SingleBlankLine: true
+    OrphanedDocs: true
+
+# Tags validators
+Tags/Order:
+  Description: Tags must follow consistent ordering
+  Enabled: true
+  Severity: error
+  EnforcedOrder:
+  - param
+  - option
+  - yield
+  - yieldparam
+  - yieldreturn
+  - return
+  - raise
+  - see
+  - example
+  - note
+  - todo
+
+Tags/InvalidTypes:
+  Description: Type specifications must use valid YARD syntax
+  Enabled: true
+  Severity: error
+  ValidatedTags:
+  - param
+  - option
+  - return
+
+Tags/TypeSyntax:
+  Description: Validates YARD type syntax using YARD parser.
+  Enabled: true
+  Severity: warning
+  ValidatedTags:
+  - param
+  - option
+  - return
+  - yieldreturn
+
+Tags/MeaninglessTag:
+  Description: Detects @param/@option tags on classes, modules, or constants.
+  Enabled: true
+  Severity: warning
+  CheckedTags:
+  - param
+  - option
+  InvalidObjectTypes:
+  - class
+  - module
+  - constant
+
+Tags/CollectionType:
+  Description: Collections must use YARD standard syntax (e.g., Hash{K => V}, Array<Type>)
+  Enabled: true
+  Severity: error
+  EnforcedStyle: long
+  ValidatedTags:
+  - param
+  - option
+  - return
+  - yieldreturn
+
+Tags/TagTypePosition:
+  Description: Validates type annotation position in tags.
+  Enabled: true
+  Severity: convention
+  CheckedTags:
+  - param
+  - option
+  EnforcedStyle: type_after_name
+
+Tags/ApiTags:
+  Description: Enforces @api tags on public objects.
+  Enabled: false
+  Severity: warning
+  AllowedApis:
+  - public
+  - private
+  - internal
+
+Tags/OptionTags:
+  Description: Requires @option tags for methods with options parameters.
+  Enabled: true
+  Severity: warning
+
+Tags/ExampleSyntax:
+  Description: Code in @example tags must be valid Ruby syntax
+  Enabled: true
+  Severity: error
+
+Tags/RedundantParamDescription:
+  Description: Detects meaningless parameter descriptions that add no value.
+  Enabled: true
+  Severity: convention
+  CheckedTags:
+  - param
+  - option
+  Articles:
+  - The
+  - the
+  - A
+  - a
+  - An
+  - an
+  MaxRedundantWords: 6
+  GenericTerms:
+  - object
+  - instance
+  - value
+  - data
+  - item
+  - element
+  EnabledPatterns:
+    ArticleParam: true
+    PossessiveParam: true
+    TypeRestatement: true
+    ParamToVerb: true
+    IdPattern: true
+    DirectionalDate: true
+    TypeGeneric: true
+
+Tags/InformalNotation:
+  Description: Detects informal tag notation patterns like "Note:" instead of @note.
+  Enabled: true
+  Severity: warning
+  CaseSensitive: false
+  RequireStartOfLine: true
+  Patterns:
+    Note: "@note"
+    Todo: "@todo"
+    TODO: "@todo"
+    FIXME: "@todo"
+    See: "@see"
+    See also: "@see"
+    Warning: "@deprecated"
+    Deprecated: "@deprecated"
+    Author: "@author"
+    Version: "@version"
+    Since: "@since"
+    Returns: "@return"
+    Raises: "@raise"
+    Example: "@example"
+
+Tags/NonAsciiType:
+  Description: Detects non-ASCII characters in type annotations.
+  Enabled: true
+  Severity: warning
+  ValidatedTags:
+  - param
+  - option
+  - return
+  - yieldreturn
+  - yieldparam
+
+Tags/TagGroupSeparator:
+  Description: Enforces blank line separators between different YARD tag groups.
+  Enabled: false
+  Severity: convention
+  TagGroups:
+    param:
+    - param
+    - option
+    return:
+    - return
+    error:
+    - raise
+    - throws
+    example:
+    - example
+    meta:
+    - see
+    - note
+    - todo
+    - deprecated
+    - since
+    - version
+    - api
+    yield:
+    - yield
+    - yieldparam
+    - yieldreturn
+  RequireAfterDescription: false
+
+# Warnings validators - catches YARD parser errors
+Warnings/UnknownTag:
+  Description: Detects unknown YARD tags.
+  Enabled: true
+  Severity: error
+
+Warnings/UnknownDirective:
+  Description: Detects unknown YARD directives.
+  Enabled: true
+  Severity: error
+
+Warnings/InvalidTagFormat:
+  Description: Detects malformed tag syntax.
+  Enabled: true
+  Severity: error
+
+Warnings/InvalidDirectiveFormat:
+  Description: Detects malformed directive syntax.
+  Enabled: true
+  Severity: error
+
+Warnings/DuplicatedParameterName:
+  Description: Detects duplicate @param tags.
+  Enabled: true
+  Severity: error
+
+Warnings/UnknownParameterName:
+  Description: Detects @param tags for non-existent parameters.
+  Enabled: true
+  Severity: error
+
+# Semantic validators
+Semantic/AbstractMethods:
+  Description: Ensures @abstract methods do not have real implementations.
+  Enabled: true
+  Severity: warning

data/CHANGELOG.md

@@ -2,6 +2,29 @@
 
 All notable changes to this project will be documented in this file. Since this is Passive Queue, "changes" might be a strong word.
 
+## [Unreleased]
+
+## [1.1.1] - 2026-05-18
+
+### Changed
+- Replaced expired `passivequeue.pro` and `passivequeue.io` domain references with the GitHub repository URL and maintainer email
+
+## [1.1.0] - 2025-11-13
+
+### Changed
+- Dropped Ruby 3.1 and 3.2 support - now requires Ruby >= 3.3.0
+- Embracing modern Ruby while maintaining the art of doing nothing
+
+### Added
+- GitHub Actions CI workflow with yard-lint validation
+- Trusted publishing workflow for automated gem releases
+- Continuous integration for documentation quality
+
+## [1.0.1] - Unreleased
+
+### Fixed
+- Potential technical overhead by adding RSpec to the gem?
+
 ## [1.0.0] - 2025-07-12
 
 ### Added

data/Gemfile

@@ -2,5 +2,7 @@ source "https://rubygems.org"
 
 gemspec
 
-gem "rake", "~> 13.0"
-gem "rspec", "~> 3.0"
+gem "rake"
+gem "minitest"
+gem "rack"
+gem "simplecov"

data/Gemfile.lint

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+# Documentation linting
+gem 'yard-lint'

data/Gemfile.lint.lock

@@ -0,0 +1,23 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    yard (0.9.38)
+    yard-lint (1.4.0)
+      yard (~> 0.9)
+      zeitwerk (~> 2.6)
+    zeitwerk (2.7.4)
+
+PLATFORMS
+  ruby
+  x86_64-linux
+
+DEPENDENCIES
+  yard-lint
+
+CHECKSUMS
+  yard (0.9.38) sha256=721fb82afb10532aa49860655f6cc2eaa7130889df291b052e1e6b268283010f
+  yard-lint (1.4.0) sha256=7dd88fbb08fd77cb840bea899d58812817b36d92291b5693dd0eeb3af9f91f0f
+  zeitwerk (2.7.4) sha256=2bef90f356bdafe9a6c2bd32bcd804f83a4f9b8bc27f3600fff051eb3edcec8b
+
+BUNDLED WITH
+  4.0.3

data/Gemfile.lock

@@ -1,35 +1,36 @@
 PATH
   remote: .
   specs:
-    passive_queue (1.0.0)
+    passive_queue (1.1.1)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    diff-lcs (1.6.2)
-    rake (13.3.0)
-    rspec (3.13.1)
-      rspec-core (~> 3.13.0)
-      rspec-expectations (~> 3.13.0)
-      rspec-mocks (~> 3.13.0)
-    rspec-core (3.13.5)
-      rspec-support (~> 3.13.0)
-    rspec-expectations (3.13.5)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.13.0)
-    rspec-mocks (3.13.5)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.13.0)
-    rspec-support (3.13.4)
+    docile (1.4.1)
+    drb (2.2.3)
+    minitest (6.0.6)
+      drb (~> 2.0)
+      prism (~> 1.5)
+    prism (1.9.0)
+    rack (3.2.6)
+    rake (13.4.2)
+    simplecov (0.22.0)
+      docile (~> 1.1)
+      simplecov-html (~> 0.11)
+      simplecov_json_formatter (~> 0.1)
+    simplecov-html (0.13.2)
+    simplecov_json_formatter (0.1.4)
 
 PLATFORMS
   ruby
   x86_64-linux
 
 DEPENDENCIES
+  minitest
   passive_queue!
-  rake (~> 13.0)
-  rspec (~> 3.0)
+  rack
+  rake
+  simplecov
 
 BUNDLED WITH
-   2.6.9
+  4.0.3

data/README.md

@@ -428,7 +428,7 @@ Passive Queue is built on the fundamental principle that the most reliable code
 - **Complete Compatibility**: Works with any existing job without modification
 - **Inner Peace**: Developers can rest easy knowing nothing will break
 
-## FAQ ❓
+## FAQ
 
 **Q: Will my jobs actually run?**
 A: No, and that's the point! Your jobs achieve perfect success by never executing.

data/Rakefile

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'bundler/gem_tasks'
+require 'minitest/test_task'
+
+Minitest::TestTask.create do |t|
+  t.libs << 'test' << 'lib'
+  t.warning = false
+  t.test_prelude = 'require "test_helper"'
+  t.test_globs = ['test/**/*_test.rb']
+end
+
+task default: :test

data/html/index.html

@@ -213,7 +213,7 @@
             </div>
 
 
-<a class="btn btn-ghost text-xl font-light" href="https://passivequeue.pro">
+<a class="btn btn-ghost text-xl font-light" href="https://github.com/mensfeld/passive_queue">
     <img src="logo.svg" alt="Passive Queue Logo" 
          class="w-16 h-16 mx-auto mb-0 block mr-2 logo-light hidden" id="" style="width: 28px; height: 28px;">
     <!-- Dark mode logo -->
@@ -568,7 +568,7 @@ end
                             </li>
                         </ul>
                         <div class="card-actions justify-center mt-6">
-                            <a href="mailto:void@passivequeue.io" class="btn btn-outline btn-wide">Contact Sales</a>
+                            <a href="mailto:maciej@mensfeld.pl" class="btn btn-outline btn-wide">Contact Sales</a>
                         </div>
                     </div>
                 </div>

data/lib/passive_queue/adapter.rb

@@ -1,27 +1,50 @@
 module PassiveQueue
+  # ActiveJob queue adapter that accepts jobs but never processes them.
+  # Implements the ActiveJob adapter interface with zen-like non-execution.
   class Adapter
+    # Initializes a new Adapter instance with the zen of doing nothing
     def initialize
       # Initialize with the zen of doing nothing
     end
 
+    # Enqueues a job for immediate non-execution
+    #
+    # @param job [ActiveJob::Base] the job to passively accept
+    # @return [void]
     def enqueue(job)
       log_job_acceptance(job)
     end
 
+    # Enqueues a job for delayed non-execution at a specific time
+    #
+    # @param job [ActiveJob::Base] the job to schedule for non-execution
+    # @param timestamp [Numeric] Unix timestamp when the job should not be executed
+    # @return [void]
     def enqueue_at(job, timestamp)
       log_job_scheduling(job, timestamp)
     end
 
+    # Enqueues multiple jobs for batch non-execution
+    #
+    # @param jobs [Array<ActiveJob::Base>] array of jobs to passively accept
+    # @return [Array<void>] results of enqueueing each job
     def enqueue_all(jobs)
       jobs.map { |job| enqueue(job) }
     end
 
+    # Returns whether the adapter is stopping (always true for zen purposes)
+    #
+    # @return [Boolean] always returns true to maintain peaceful state
     def stopping?
       true
     end
 
     private
 
+    # Logs acceptance of a job with zen messaging
+    #
+    # @param job [ActiveJob::Base] the job being accepted
+    # @return [void]
     def log_job_acceptance(job)
       return if PassiveQueue.configuration.silence_mode
 
@@ -31,6 +54,11 @@ module PassiveQueue
       puts "   Status: Successfully not processed ✨"
     end
 
+    # Logs scheduling of a job with philosophical messaging
+    #
+    # @param job [ActiveJob::Base] the job being scheduled
+    # @param timestamp [Numeric] Unix timestamp for scheduled non-execution
+    # @return [void]
     def log_job_scheduling(job, timestamp)
       return if PassiveQueue.configuration.silence_mode
 

data/lib/passive_queue/cli.rb

@@ -2,11 +2,20 @@
 # lib/passive_queue/cli.rb
 # ================================
 module PassiveQueue
+  # Command-line interface for PassiveQueue meditation and zen commands
   class CLI
+    # Entry point for the CLI application
+    #
+    # @param args [Array<String>] command-line arguments
+    # @return [void]
     def self.start(args)
       new.run(args)
     end
 
+    # Runs the CLI with provided arguments
+    #
+    # @param args [Array<String>] command-line arguments to process
+    # @return [void]
     def run(args)
       # Parse arguments manually (no Thor dependency)
       options = parse_args(args)
@@ -25,6 +34,10 @@ module PassiveQueue
 
     private
 
+    # Parses command-line arguments into an options hash
+    #
+    # @param args [Array<String>] raw command-line arguments
+    # @return [Hash] parsed options with zen, philosophical, aggressive, and duration keys
     def parse_args(args)
       options = {
         zen: false,
@@ -49,6 +62,14 @@ module PassiveQueue
       options
     end
 
+    # Executes the passive meditation command
+    #
+    # @param options [Hash] parsed command-line options
+    # @option options [Boolean] :zen enable zen quotes during meditation
+    # @option options [Boolean] :philosophical enable philosophical thoughts
+    # @option options [Boolean] :aggressive aggressively passive mode (not recommended)
+    # @option options [Numeric] :duration meditation duration in seconds
+    # @return [void]
     def passive_command(options)
       if options[:aggressive]
         puts "❌ Error: Don't be aggressive! The path of the passive queue is one of peace."
@@ -79,6 +100,13 @@ module PassiveQueue
       puts "   Your passive queue energy has been restored."
     end
 
+    # Meditates with zen quotes or philosophical thoughts
+    #
+    # @param duration [Numeric] meditation duration in seconds
+    # @param options [Hash] options hash containing zen or philosophical flags
+    # @option options [Boolean] :zen enable zen quotes during meditation
+    # @option options [Boolean] :philosophical enable philosophical thoughts
+    # @return [void]
     def meditate_with_wisdom(duration, options)
       interval = duration / 3.0
       
@@ -94,6 +122,10 @@ module PassiveQueue
       end
     end
 
+    # Meditates silently with animated dots
+    #
+    # @param duration [Numeric] meditation duration in seconds
+    # @return [void]
     def meditate_silently(duration)
       print "   Meditating"
       
@@ -112,6 +144,9 @@ module PassiveQueue
       end
     end
 
+    # Displays help information for the CLI
+    #
+    # @return [void]
     def show_help
       puts <<~HELP
         Passive Queue CLI - The zen of non-productivity

data/lib/passive_queue/configuration.rb

@@ -2,9 +2,21 @@
 # lib/passive_queue/configuration.rb
 # ================================
 module PassiveQueue
+  # Configuration settings for PassiveQueue behavior and aesthetics
   class Configuration
-    attr_accessor :meditation_duration, :zen_level, :philosophical_depth, :silence_mode
+    # @return [Integer] meditation duration in seconds
+    attr_accessor :meditation_duration
 
+    # @return [Symbol] current zen level (:low, :medium, :high, :transcendent)
+    attr_accessor :zen_level
+
+    # @return [Symbol] philosophical depth (:shallow, :deep, :profound, :existential)
+    attr_accessor :philosophical_depth
+
+    # @return [Boolean] whether to suppress output logging
+    attr_accessor :silence_mode
+
+    # Initializes configuration with default zen values
     def initialize
       @meditation_duration = 5 # seconds
       @zen_level = :medium
@@ -12,10 +24,16 @@ module PassiveQueue
       @silence_mode = false
     end
 
+    # Returns available zen levels
+    #
+    # @return [Array<Symbol>] valid zen level options
     def zen_levels
       %i[low medium high transcendent]
     end
 
+    # Returns available philosophical depth levels
+    #
+    # @return [Array<Symbol>] valid philosophical depth options
     def philosophical_depths
       %i[shallow deep profound existential]
     end

data/lib/passive_queue/engine.rb

@@ -1,18 +1,23 @@
 # ================================
-# lib/passive_queue/engine.rb  
+# lib/passive_queue/engine.rb
 # ================================
 module PassiveQueue
+  # Rack engine that mounts the PassiveQueue web dashboard in Rails applications
   class Engine
+    # Rack call method that delegates to the Web application
+    #
+    # @param env [Hash] Rack environment hash
+    # @return [Array] Rack response triplet [status, headers, body]
     def self.call(env)
       # Strip the mount path to get relative path
       path_info = env['PATH_INFO']
       script_name = env['SCRIPT_NAME']
-      
+
       # Create new env with adjusted paths for the Web app
       web_env = env.dup
       web_env['PATH_INFO'] = path_info
       web_env['SCRIPT_NAME'] = script_name
-      
+
       Web.new.call(web_env)
     end
   end

data/lib/passive_queue/version.rb

@@ -3,5 +3,5 @@
 # ================================
 module PassiveQueue
   # 1.0 so stable and production ready
-  VERSION = "1.0.0"
+  VERSION = "1.1.1"
 end

data/lib/passive_queue/web.rb

@@ -5,7 +5,12 @@ require 'erb'
 require 'json'
 
 module PassiveQueue
+  # Rack web application providing a dashboard interface for PassiveQueue
   class Web
+    # Rack call method that routes requests to appropriate handlers
+    #
+    # @param env [Hash] Rack environment hash
+    # @return [Array] Rack response triplet [status, headers, body]
     def call(env)
       request = Rack::Request.new(env)
       
@@ -29,11 +34,17 @@ module PassiveQueue
 
     private
 
+    # Renders the main dashboard HTML page
+    #
+    # @return [Array] Rack response with HTML dashboard
     def dashboard_response
       html = dashboard_html
       [200, {'Content-Type' => 'text/html'}, [html]]
     end
 
+    # Returns JSON response with queue statistics
+    #
+    # @return [Array] Rack response with JSON stats data
     def api_stats_response
       stats = {
         jobs_queued: rand(9999..99999),
@@ -51,45 +62,72 @@ module PassiveQueue
       [200, {'Content-Type' => 'application/json'}, [stats.to_json]]
     end
 
+    # Returns JSON response with a random zen quote
+    #
+    # @return [Array] Rack response with JSON zen quote
     def api_zen_response
       quote = PassiveQueue.zen_quotes.sample
       [200, {'Content-Type' => 'application/json'}, [{quote: quote}.to_json]]
     end
 
+    # Returns CSS stylesheet response (unused method)
+    #
+    # @return [Array] Rack response with CSS content
     def css_response
       css = dashboard_css
       [200, {'Content-Type' => 'text/css'}, [css]]
     end
 
+    # Returns the light theme logo SVG
+    #
+    # @return [Array] Rack response with SVG logo
     def logo_response
       svg = logo_svg
       [200, {'Content-Type' => 'image/svg+xml'}, [svg]]
     end
 
+    # Returns the dark theme logo SVG
+    #
+    # @return [Array] Rack response with dark theme SVG logo
     def logo_dark_response
       svg = logo_svg_dark
       [200, {'Content-Type' => 'image/svg+xml'}, [svg]]
     end
 
+    # Returns an empty favicon response
+    #
+    # @return [Array] Rack response with empty favicon
     def favicon_response
       # Return empty response for favicon
       [200, {'Content-Type' => 'image/x-icon'}, ['']]
     end
 
+    # Returns a 404 not found response with zen humor
+    #
+    # @return [Array] Rack response with 404 HTML
     def not_found_response
       [404, {'Content-Type' => 'text/html'}, ['<h1>404 - Page Not Found (Just Like Our Jobs)</h1>']]
     end
 
+    # Reads and returns the light theme logo SVG content
+    #
+    # @return [String] SVG file contents
     def logo_svg
      logo_path = File.join(File.dirname(__FILE__), '..', '..', 'html', 'logo.svg')
      File.read(logo_path)
     end
 
+    # Reads and returns the dark theme logo SVG content
+    #
+    # @return [String] dark theme SVG file contents
     def logo_svg_dark
      logo_path = File.join(File.dirname(__FILE__), '..', '..', 'html', 'logo-dark.svg')
      File.read(logo_path)
     end
 
+    # Generates and returns the complete dashboard HTML
+    #
+    # @return [String] HTML content for the dashboard page
     def dashboard_html
       <<~HTML
         <!DOCTYPE html>

data/lib/passive_queue.rb

@@ -9,17 +9,36 @@ require "passive_queue/web"
 require "passive_queue/engine"
 require "active_job/queue_adapters/passive_queue_adapter"
 
+# PassiveQueue is a Rails queue adapter that embraces the zen of non-productivity.
+# It accepts all jobs but executes none, achieving perfect reliability through strategic non-action.
 module PassiveQueue
+  # Base error class for PassiveQueue-related errors
   class Error < StandardError; end
 
+  # Returns the current PassiveQueue configuration instance
+  #
+  # @return [Configuration] the configuration instance
   def self.configuration
     @configuration ||= Configuration.new
   end
 
+  # Configures PassiveQueue with a block
+  #
+  # @yield [Configuration] the configuration instance
+  # @return [void]
+  #
+  # @example
+  #   PassiveQueue.configure do |config|
+  #     config.zen_level = :transcendent
+  #     config.silence_mode = true
+  #   end
   def self.configure
     yield(configuration)
   end
 
+  # Returns an array of zen quotes about passive processing
+  #
+  # @return [Array<String>] collection of zen wisdom
   def self.zen_quotes
     [
       "The best job is the one never executed.",
@@ -35,6 +54,9 @@ module PassiveQueue
     ]
   end
 
+  # Returns an array of philosophical thoughts about job processing
+  #
+  # @return [Array<String>] collection of deep philosophical reflections
   def self.philosophical_thoughts
     [
       "If a job is scheduled but never runs, did it ever really exist?",

data/package-lock.json

@@ -0,0 +1,331 @@
+{
+  "name": "passive_queue",
+  "version": "1.0.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "passive_queue",
+      "version": "1.0.0",
+      "devDependencies": {
+        "lostconf": "0.4.0"
+      }
+    },
+    "node_modules/@nodelib/fs.scandir": {
+      "version": "2.1.5",
+      "resolved": "https://registry.npmjs.org/@nodelib/fs.scandir/-/fs.scandir-2.1.5.tgz",
+      "integrity": "sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@nodelib/fs.stat": "2.0.5",
+        "run-parallel": "^1.1.9"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/@nodelib/fs.stat": {
+      "version": "2.0.5",
+      "resolved": "https://registry.npmjs.org/@nodelib/fs.stat/-/fs.stat-2.0.5.tgz",
+      "integrity": "sha512-RkhPPp2zrqDAQA/2jNhnztcPAlv64XdhIp7a7454A5ovI7Bukxgt7MX7udwAu3zg1DcpPU0rz3VV1SeaqvY4+A==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/@nodelib/fs.walk": {
+      "version": "1.2.8",
+      "resolved": "https://registry.npmjs.org/@nodelib/fs.walk/-/fs.walk-1.2.8.tgz",
+      "integrity": "sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@nodelib/fs.scandir": "2.1.5",
+        "fastq": "^1.6.0"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/braces": {
+      "version": "3.0.3",
+      "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.3.tgz",
+      "integrity": "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "fill-range": "^7.1.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/chalk": {
+      "version": "5.6.2",
+      "resolved": "https://registry.npmjs.org/chalk/-/chalk-5.6.2.tgz",
+      "integrity": "sha512-7NzBL0rN6fMUW+f7A6Io4h40qQlG+xGmtMxfbnH/K7TAtt8JQWVQK+6g0UXKMeVJoyV5EkkNsErQ8pVD3bLHbA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": "^12.17.0 || ^14.13 || >=16.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/chalk?sponsor=1"
+      }
+    },
+    "node_modules/commander": {
+      "version": "12.1.0",
+      "resolved": "https://registry.npmjs.org/commander/-/commander-12.1.0.tgz",
+      "integrity": "sha512-Vw8qHK3bZM9y/P10u3Vib8o/DdkvA2OtPtZvD871QKjy74Wj1WSKFILMPRPSdUSx5RFK1arlJzEtA4PkFgnbuA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/fast-glob": {
+      "version": "3.3.3",
+      "resolved": "https://registry.npmjs.org/fast-glob/-/fast-glob-3.3.3.tgz",
+      "integrity": "sha512-7MptL8U0cqcFdzIzwOTHoilX9x5BrNqye7Z/LuC7kCMRio1EMSyqRK3BEAUD7sXRq4iT4AzTVuZdhgQ2TCvYLg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@nodelib/fs.stat": "^2.0.2",
+        "@nodelib/fs.walk": "^1.2.3",
+        "glob-parent": "^5.1.2",
+        "merge2": "^1.3.0",
+        "micromatch": "^4.0.8"
+      },
+      "engines": {
+        "node": ">=8.6.0"
+      }
+    },
+    "node_modules/fastq": {
+      "version": "1.20.1",
+      "resolved": "https://registry.npmjs.org/fastq/-/fastq-1.20.1.tgz",
+      "integrity": "sha512-GGToxJ/w1x32s/D2EKND7kTil4n8OVk/9mycTc4VDza13lOvpUZTGX3mFSCtV9ksdGBVzvsyAVLM6mHFThxXxw==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "reusify": "^1.0.4"
+      }
+    },
+    "node_modules/fill-range": {
+      "version": "7.1.1",
+      "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz",
+      "integrity": "sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "to-regex-range": "^5.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/glob-parent": {
+      "version": "5.1.2",
+      "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-5.1.2.tgz",
+      "integrity": "sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "is-glob": "^4.0.1"
+      },
+      "engines": {
+        "node": ">= 6"
+      }
+    },
+    "node_modules/is-extglob": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz",
+      "integrity": "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/is-glob": {
+      "version": "4.0.3",
+      "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz",
+      "integrity": "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "is-extglob": "^2.1.1"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/is-number": {
+      "version": "7.0.0",
+      "resolved": "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz",
+      "integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.12.0"
+      }
+    },
+    "node_modules/lostconf": {
+      "version": "0.4.0",
+      "resolved": "https://registry.npmjs.org/lostconf/-/lostconf-0.4.0.tgz",
+      "integrity": "sha512-VNbUnirRU7uESqMHslIRHTcuyx/rr4OZK+L7EQXtYUe5PorBgqBYvPu+6xOr0CoUy4n34NNUKO6BBH6TgwwGTA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "chalk": "^5.3.0",
+        "commander": "^12.1.0",
+        "fast-glob": "^3.3.2",
+        "micromatch": "^4.0.8",
+        "smol-toml": "^1.3.0",
+        "yaml": "^2.5.0"
+      },
+      "bin": {
+        "lostconf": "dist/cli.js"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/merge2": {
+      "version": "1.4.1",
+      "resolved": "https://registry.npmjs.org/merge2/-/merge2-1.4.1.tgz",
+      "integrity": "sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/micromatch": {
+      "version": "4.0.8",
+      "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.8.tgz",
+      "integrity": "sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "braces": "^3.0.3",
+        "picomatch": "^2.3.1"
+      },
+      "engines": {
+        "node": ">=8.6"
+      }
+    },
+    "node_modules/picomatch": {
+      "version": "2.3.1",
+      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.1.tgz",
+      "integrity": "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8.6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/jonschlinkert"
+      }
+    },
+    "node_modules/queue-microtask": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/queue-microtask/-/queue-microtask-1.2.3.tgz",
+      "integrity": "sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT"
+    },
+    "node_modules/reusify": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/reusify/-/reusify-1.1.0.tgz",
+      "integrity": "sha512-g6QUff04oZpHs0eG5p83rFLhHeV00ug/Yf9nZM6fLeUrPguBTkTQOdpAWWspMh55TZfVQDPaN3NQJfbVRAxdIw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "iojs": ">=1.0.0",
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/run-parallel": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/run-parallel/-/run-parallel-1.2.0.tgz",
+      "integrity": "sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "queue-microtask": "^1.2.2"
+      }
+    },
+    "node_modules/smol-toml": {
+      "version": "1.6.0",
+      "resolved": "https://registry.npmjs.org/smol-toml/-/smol-toml-1.6.0.tgz",
+      "integrity": "sha512-4zemZi0HvTnYwLfrpk/CF9LOd9Lt87kAt50GnqhMpyF9U3poDAP2+iukq2bZsO/ufegbYehBkqINbsWxj4l4cw==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "engines": {
+        "node": ">= 18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/cyyynthia"
+      }
+    },
+    "node_modules/to-regex-range": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz",
+      "integrity": "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "is-number": "^7.0.0"
+      },
+      "engines": {
+        "node": ">=8.0"
+      }
+    },
+    "node_modules/yaml": {
+      "version": "2.8.2",
+      "resolved": "https://registry.npmjs.org/yaml/-/yaml-2.8.2.tgz",
+      "integrity": "sha512-mplynKqc1C2hTVYxd0PU2xQAc22TI1vShAYGksCCfxbn/dFwnHTNi1bvYsBTkhdUNtGIf5xNOg938rrSSYvS9A==",
+      "dev": true,
+      "license": "ISC",
+      "bin": {
+        "yaml": "bin.mjs"
+      },
+      "engines": {
+        "node": ">= 14.6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/eemeli"
+      }
+    }
+  }
+}

data/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "passive_queue",
+  "version": "1.0.0",
+  "description": "CI dependencies for passive_queue",
+  "private": true,
+  "devDependencies": {
+    "lostconf": "0.4.0"
+  }
+}

data/passive_queue.gemspec

@@ -0,0 +1,28 @@
+require_relative "lib/passive_queue/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "passive_queue"
+  spec.version = PassiveQueue::VERSION
+  spec.authors = ["Maciej Mensfeld"]
+  spec.email = ["maciej@mensfeld.pl"]
+
+  spec.summary = "A Rails queue adapter that embraces the zen of non-productivity"
+  spec.description = "Rails queue adapter for mindful developers. Accepts all jobs, executes none. Perfect reliability through strategic non-action."
+  spec.homepage = "https://github.com/mensfeld/passive_queue"
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 3.3.0"
+
+  spec.metadata["homepage_uri"] = "https://github.com/mensfeld/passive_queue"
+  spec.metadata["source_code_uri"] = "https://github.com/mensfeld/passive_queue"
+  spec.metadata["changelog_uri"] = "https://github.com/mensfeld/passive_queue/blob/main/CHANGELOG.md"
+
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (f == __FILE__) || f.match(%r{\A(?:(?:bin|test|spec|features)/|\.(?:git|travis|circleci)|appveyor)})
+    end
+  end
+
+  spec.executables = ['be']
+  spec.require_paths = ["lib"]
+  # NO runtime dependencies - true zen has no dependencies
+end

data/renovate.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
+  "extends": [
+    "config:recommended"
+  ],
+  "minimumReleaseAge": "7 days",
+  "github-actions": {
+    "enabled": true,
+    "pinDigests": true
+  },
+  "includePaths": [
+    ".ruby-version",
+    "Gemfile",
+    "Gemfile.lint",
+    "passive_queue.gemspec",
+    ".github/workflows/**",
+    "package.json"
+  ],
+  "packageRules": [
+    {
+      "description": "Group ruby/setup-ruby action with ruby version updates",
+      "matchPackageNames": [
+        "ruby/setup-ruby",
+        "ruby"
+      ],
+      "groupName": "ruby setup",
+      "internalChecksFilter": "strict"
+    }
+  ],
+  "labels": [
+    "dependencies"
+  ],
+  "lockFileMaintenance": {
+    "enabled": true
+  }
+}

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: passive_queue
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.1
 platform: ruby
 authors:
 - Maciej Mensfeld
@@ -12,17 +12,22 @@ dependencies: []
 description: Rails queue adapter for mindful developers. Accepts all jobs, executes
   none. Perfect reliability through strategic non-action.
 email:
-- void@passivequeue.pro
+- maciej@mensfeld.pl
 executables:
 - be
 extensions: []
 extra_rdoc_files: []
 files:
+- ".ruby-version"
+- ".yard-lint.yml"
 - CHANGELOG.md
 - Gemfile
+- Gemfile.lint
+- Gemfile.lint.lock
 - Gemfile.lock
 - LICENSE
 - README.md
+- Rakefile
 - bin/be
 - html/index.html
 - html/logo-dark.svg
@@ -37,11 +42,15 @@ files:
 - lib/passive_queue/railtie.rb
 - lib/passive_queue/version.rb
 - lib/passive_queue/web.rb
-homepage: https://passivequeue.pro
+- package-lock.json
+- package.json
+- passive_queue.gemspec
+- renovate.json
+homepage: https://github.com/mensfeld/passive_queue
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://passivequeue.pro
+  homepage_uri: https://github.com/mensfeld/passive_queue
   source_code_uri: https://github.com/mensfeld/passive_queue
   changelog_uri: https://github.com/mensfeld/passive_queue/blob/main/CHANGELOG.md
 rdoc_options: []
@@ -51,14 +60,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.1.0
+      version: 3.3.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.7
+rubygems_version: 4.0.10
 specification_version: 4
 summary: A Rails queue adapter that embraces the zen of non-productivity
 test_files: []