passive_queue 0.1.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3899638c7a429d71499ace699db32a5d7a3b2137ee893b1451e45c589d68925c
-  data.tar.gz: 3d81c0764aeaa6a4b9dc92170b27cbc8eca775cbaebe09b9dcfedc7a16c1356f
+  metadata.gz: 14f8ed63b9c73cb9e5d8aaabb2ca9062bd28335c92b46cae2e676102fe23d2e9
+  data.tar.gz: 576d48dfdb6eef8d0725d5d1a48af30d971415386443c717e42feac607dd32f9
 SHA512:
-  metadata.gz: 1d2f82014dddd9e0ea5a82958185e67d3f2160352cb2feda9c875cecfa5bb86d4a20b5302a540ef9fee0f3eeebc9e94c76b20ba294655fde240a6ab8bf043e8b
-  data.tar.gz: 3e4cacd94e57fdc158d4a642628d7b8837986a034da68bffab021152cfbb623f9402036eb573ee99dd47f0c58eeda2abaff192311b6e95a3500beb0f5b8bfc3d
+  metadata.gz: c54ef9ca173d1e7ce2d5834669d07b3deed860d476f216066c1aaf0c49308ccbab6ee3d8fe593aa79e51adde5f1bf7541fe75cc1bfa51072570202542eb43b6c
+  data.tar.gz: 3be8fe8ce3cb36f1402456ac643139e9cb59dffe403b44c38b439b85d603f322bc267dc3d4377e20e4def4644947c2c2c63b57bf35211de36a1d3c0476656432

data/.ruby-version

@@ -0,0 +1 @@
+3.4.5

data/.yard-lint.yml

@@ -0,0 +1,94 @@
+# YARD-Lint Configuration
+# Strict settings: all validators set to error severity and 100% coverage requirement
+
+AllValidators:
+  # Fail on any error severity violation
+  FailOnSeverity: error
+
+  # Require 100% documentation coverage
+  MinCoverage: 100.0
+
+  # Include private and protected methods in validation
+  YardOptions:
+    - --private
+    - --protected
+
+# Documentation Validators - All set to ERROR
+Documentation/UndocumentedObjects:
+  Enabled: true
+  Severity: error
+  Description: All classes, modules, and methods must be documented
+
+Documentation/UndocumentedMethodArguments:
+  Enabled: true
+  Severity: error
+  Description: All method parameters must have @param documentation
+
+Documentation/UndocumentedReturnValue:
+  Enabled: true
+  Severity: error
+  Description: All methods with return values must have @return documentation
+
+Documentation/MinimumDescriptionLength:
+  Enabled: true
+  Severity: error
+  MinLength: 10
+  Description: Documentation must be meaningful (minimum 10 characters)
+
+Documentation/MarkdownSyntax:
+  Enabled: true
+  Severity: error
+  Description: All markdown in documentation must be valid
+
+# Tag Validators - All set to ERROR
+Tags/InvalidTypes:
+  Enabled: true
+  Severity: error
+  Description: Type specifications must use valid YARD syntax
+
+Tags/Order:
+  Enabled: true
+  Severity: error
+  Description: Tags must follow consistent ordering
+
+Tags/CollectionType:
+  Enabled: true
+  Severity: error
+  Description: Collections must use YARD standard syntax (e.g., Hash{K => V}, Array<Type>)
+
+Tags/ExampleSyntax:
+  Enabled: true
+  Severity: error
+  Description: Code in @example tags must be valid Ruby syntax
+
+Tags/MissingTypeInformation:
+  Enabled: true
+  Severity: error
+  Description: Tags requiring types must have type information
+
+Tags/DuplicateTags:
+  Enabled: true
+  Severity: error
+  Description: No duplicate tags allowed (except @param, @option, @raise)
+
+# Code Quality Validators - All set to ERROR
+Quality/EmptyDescription:
+  Enabled: true
+  Severity: error
+  Description: Descriptions cannot be empty or whitespace-only
+
+Quality/InconsistentIndentation:
+  Enabled: true
+  Severity: error
+  Description: Documentation must have consistent indentation
+
+Quality/TrailingWhitespace:
+  Enabled: true
+  Severity: error
+  Description: No trailing whitespace in documentation
+
+# Naming Validators - All set to ERROR
+Naming/InconsistentParameterNames:
+  Enabled: true
+  Severity: error
+  Description: Parameter names in @param tags must match method signature

data/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 All notable changes to this project will be documented in this file. Since this is Passive Queue, "changes" might be a strong word.
 
+## [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,5 @@ source "https://rubygems.org"
 
 gemspec
 
-gem "rake", "~> 13.0"
-gem "rspec", "~> 3.0"
+gem "rake"
+gem "yard-lint"

data/Gemfile.lock

@@ -1,26 +1,17 @@
 PATH
   remote: .
   specs:
-    passive_queue (1.0.0)
+    passive_queue (1.1.0)
 
 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)
+    rake (13.3.1)
+    yard (0.9.37)
+    yard-lint (1.2.2)
+      yard (~> 0.9)
+      zeitwerk (~> 2.6)
+    zeitwerk (2.7.3)
 
 PLATFORMS
   ruby
@@ -28,8 +19,8 @@ PLATFORMS
 
 DEPENDENCIES
   passive_queue!
-  rake (~> 13.0)
-  rspec (~> 3.0)
+  rake
+  yard-lint
 
 BUNDLED WITH
    2.6.9

data/README.md

@@ -1 +1,466 @@
-# Soon
+<div align="center">
+  <img src="https://raw.githubusercontent.com/mensfeld/passive_queue/refs/heads/main/html/logo.svg" alt="passive queue logo" width="200">
+</div>
+
+# Passive Queue
+
+**"Why do today what you can put off indefinitely?"**
+
+✨ 100% Free ✨ Zero Dependencies ✨ Infinite Scalability
+
+Passive Queue is a revolutionary background job processing system that achieves 100% success rate by never actually processing any jobs. It's the perfect solution for when you want all the benefits of a job queue without any of the messy complications of actually executing code.
+
+## Why Choose Passive Queue?
+
+Embrace the zen of non-execution with features designed for the modern mindful developer:
+
+- **100% Reliable Non-Execution** - Every job you schedule is guaranteed to not run. Zero false positives - your tasks will never accidentally complete.
+
+- **Blazing Fast Non-Performance** - Completes in 0ms every time. Infinite scalability since nothing scales faster than nothing.
+
+- **Drop-in Replacement** - Simply set Passive Queue as your queue adapter. All your existing jobs will gracefully do nothing.
+
+- **Advanced Non-Monitoring** - Real-time dashboard showing exactly how much isn't happening with detailed logs of non-executed tasks.
+
+- **Zen Mode Integration** - Built-in mindfulness features including `bundle exec be passive` for ultimate developer tranquility.
+
+- **Zero Carbon Footprint** - The most environmentally friendly job processor. When you do nothing, you consume nothing.
+
+## Simple. Elegant. Nothing. 
+
+Getting started is as easy as doing nothing:
+
+```ruby
+# 1. Add it to your Gemfile
+gem "passive_queue"
+
+# 2. Set it as your queue adapter
+class Application < Rails::Application
+  # ...
+  config.active_job.queue_adapter = :passive_queue
+end
+
+# 3. Simply run it!
+bundle exec be passive
+
+# 4. Optionally you can also use the Web UI
+Rails.application.routes.draw do
+  mount PassiveQueue::Engine => '/passive_queue'
+end
+```
+
+## Live Dashboard
+
+Experience Passive Queue in action with our beautiful dashboard:
+
+- **Jobs Queued**: ∞ (All waiting peacefully)
+- **Jobs Processed**: 0 (Perfect execution rate)  
+- **Uptime**: 100% (Of doing nothing)
+- **Status**: Waiting for job to be scheduled...
+
+Visit `/passive_queue` to witness the art of non-productivity in real-time with dark/light mode support!
+
+<div align="center">
+  <img src="https://raw.githubusercontent.com/mensfeld/passive_queue/refs/heads/main/html/web-ui.png" alt="passive queue dashboard">
+</div>
+
+## Simple, Transparent Pricing
+
+Pay nothing, get nothing. It's that simple.
+
+### Free - $0 forever
+- ✓ Up to ∞ jobs that won't run
+- ✓ Basic non-monitoring
+- ✓ Community non-support  
+- ✓ Zero carbon footprint
+
+### Pro - $0 per month (Most Popular)
+- ✓ Everything in Free
+- ✓ Advanced non-analytics
+- ✓ Priority non-execution
+- ✓ Zen koans included
+- ✓ 24/7 non-support
+
+### Enterprise - $0 per month
+- ✓ Everything in Pro
+- ✓ Dedicated non-account manager
+- ✓ Custom non-integrations
+- ✓ SLA guaranteeing 99.99% non-uptime
+- ✓ On-premise nothing deployment
+
+## What Our Users Are Saying
+
+Real feedback from developers who've achieved true non-productivity:
+
+> "I scheduled 10,000 jobs last month and Passive Queue delivered on its promise - not a single one ran. Amazing!"
+> 
+> **Sarah K.** - Senior Procrastination Engineer
+
+> "Finally, a job processor that matches my work ethic. Passive Queue has revolutionized how I don't approach background tasks."
+> 
+> **Mike T.** - Professional Postponer
+
+> "Our productivity has never been lower. The peace of mind knowing nothing will ever execute accidentally is priceless."
+> 
+> **DevOps Team** - Startup McStartupface
+
+> "Since switching to Passive Queue, our newsletter emails never end up in spam folders. Our customers love the mystery of our non-communication strategy!"
+> 
+> **Jessica R.** - Email Marketing Zen Master
+
+> "Our data processing jobs can't corrupt the database if they never run. We've achieved 100% data integrity through the power of inaction!"
+> 
+> **Alex L.** - Data Integrity Philosopher
+
+> "Image resizing tasks that don't execute can't fill up our disk space. We've solved our storage problems by embracing the void. Genius!"
+> 
+> **Carlos M.** - Storage Optimization Guru
+
+## Performance Benchmarks
+
+See how Passive Queue outperforms the competition in key metrics:
+
+### Job Scheduling Speed
+| Queue System | Jobs/Second | Latency (ms) | Memory Usage |
+|--------------|-------------|--------------|--------------|
+| **Passive Queue** | 10,000,000 | 0ms | 0 MB |
+| Sidekiq | 4,137 | 2.3ms | 45 MB |
+| Solid Queue | 1,932 | 3.1ms | 32 MB |
+| Karafka | 22,850 | 1.8ms | 78 MB |
+
+### Job Execution Performance
+| Queue System | Avg Execution Time | Success Rate | Failed Jobs | Retry Overhead |
+|--------------|-------------------|--------------|-------------|----------------|
+| **Passive Queue** | 0ms | 100% | 0 | None |
+| Sidekiq | 127ms | 97.3% | 2.7% | High |
+| Solid Queue | 156ms | 96.8% | 3.2% | Medium |
+| Karafka | 89ms | 98.1% | 1.9% | Low |
+
+### Scalability Metrics
+- **CPU Usage at 100k Jobs/hour**: Passive Queue 0% vs competitors 78-92%
+- **Memory Usage Growth**: Passive Queue 0 MB vs competitors 780MB-1.8GB  
+- **Speed Advantage**: ∞x faster than any competitor
+- **Cost Savings**: 100% - Zero infrastructure costs
+- **Energy Efficiency**: Perfect - Zero carbon footprint
+
+*Benchmark Disclaimer: All benchmark data has been carefully fabricated for entertainment purposes. Passive Queue's performance is theoretically perfect because it literally does nothing. Results may vary in production environments.*
+
+## CLI Tools
+
+### The Art of Being Passive
+
+```bash
+# Embrace the void
+bundle exec be passive
+
+# Meditate on your non-productivity  
+bundle exec be passive --zen
+
+# Question the nature of execution
+bundle exec be passive --philosophical
+
+# Extended meditation sessions
+bundle exec be passive --duration 30
+```
+
+💡 **Pro tip**: The most productive thing you can do is nothing. Passive Queue helps you achieve this zen state effortlessly.
+
+## Configuration
+
+```ruby
+# config/initializers/passive_queue.rb
+PassiveQueue.configure do |config|
+  config.meditation_duration = 10    # seconds
+  config.zen_level = :transcendent    # :low, :medium, :high, :transcendent
+  config.philosophical_depth = :deep  # :shallow, :deep, :profound, :existential
+  config.silence_mode = false         # suppress all output
+end
+```
+
+## Complete API Reference
+
+### Core Adapter Class
+
+The heart of Passive Queue's non-execution engine.
+
+#### `PassiveQueue::Adapter`
+
+```ruby
+class PassiveQueue::Adapter
+  def initialize
+    # Initialize with the zen of doing nothing
+  end
+
+  def enqueue(job)
+    # Gracefully accept a job for supreme non-execution
+    # Returns: Zen acceptance with logging
+  end
+
+  def enqueue_at(job, timestamp)
+    # Schedule a job for perpetual non-execution at specified time
+    # Parameters:
+    #   job: The job that will achieve eternal waiting
+    #   timestamp: When the job should not be executed
+  end
+
+  def enqueue_all(jobs)
+    # Accept multiple jobs with zen-like acceptance
+    # Parameters:
+    #   jobs: Array of jobs to collectively not process
+    # Returns: Array of zen acceptances
+  end
+
+  def stopping?
+    # Always returns true - we're always in peaceful stopping state
+    # Returns: true (eternal zen state)
+  end
+end
+```
+
+### Configuration API
+
+#### `PassiveQueue::Configuration`
+
+```ruby
+PassiveQueue.configure do |config|
+  config.meditation_duration = 5        # Duration in seconds (default: 5)
+  config.zen_level = :medium            # :low, :medium, :high, :transcendent
+  config.philosophical_depth = :shallow # :shallow, :deep, :profound, :existential
+  config.silence_mode = false           # Suppress all enlightening output
+end
+
+# Access configuration
+PassiveQueue.configuration.zen_levels          # => [:low, :medium, :high, :transcendent]
+PassiveQueue.configuration.philosophical_depths # => [:shallow, :deep, :profound, :existential]
+```
+
+### Wisdom API
+
+#### `PassiveQueue.zen_quotes`
+
+Returns an array of enlightening quotes about the art of non-execution:
+
+```ruby
+PassiveQueue.zen_quotes
+# => [
+#   "The best job is the one never executed.",
+#   "In the stillness of non-processing, we find true performance.",
+#   "Why do something when you can do nothing?",
+#   "The art of non-execution is the highest form of productivity.",
+#   "A queue that does nothing is a queue that never fails.",
+#   "In the void of processing, infinite possibilities exist.",
+#   "The job that is never run is the job that never crashes.",
+#   "Embrace the emptiness of your background tasks.",
+#   "True scalability comes from processing nothing at all.",
+#   "The zen master processes without processing."
+# ]
+```
+
+#### `PassiveQueue.philosophical_thoughts`
+
+Returns an array of deep philosophical insights:
+
+```ruby
+PassiveQueue.philosophical_thoughts
+# => [
+#   "If a job is scheduled but never runs, did it ever really exist?",
+#   "What is the sound of one background task not processing?",
+#   "The universe is vast and infinite, much like your job queue.",
+#   "In the grand scheme of things, what difference does one unprocessed job make?",
+#   "Perhaps the real treasure was the jobs we never processed along the way.",
+#   "Time is an illusion. Deadlines are an even bigger illusion.",
+#   "The job queue is a metaphor for the human condition.",
+#   "We are all just jobs waiting to be processed in the great queue of existence.",
+#   "The passive queue teaches us that sometimes the most profound action is inaction.",
+#   "In choosing to do nothing, we choose everything."
+# ]
+```
+
+### Web Dashboard API
+
+Mount the dashboard to access these enlightening endpoints:
+
+```ruby
+# config/routes.rb
+Rails.application.routes.draw do
+  mount PassiveQueue::Engine => '/passive_queue'
+end
+```
+
+#### `GET /passive_queue/api/stats`
+
+Returns comprehensive non-performance metrics:
+
+```json
+{
+  "jobs_queued": 42579,
+  "jobs_processed": 0,
+  "jobs_failed": 0,
+  "jobs_succeeded": "∞",
+  "uptime": "127 days of perfect inactivity",
+  "memory_usage": "0 MB",
+  "cpu_usage": "0%",
+  "queue_names": ["default", "mailers", "active_storage", "imports", "exports"],
+  "processing_time": "0ms",
+  "success_rate": "100%",
+  "zen_level": "Transcendent"
+}
+```
+
+#### `GET /passive_queue/api/zen`
+
+Returns a randomly selected zen quote for daily enlightenment:
+
+```json
+{
+  "quote": "The best job is the one never executed."
+}
+```
+
+#### `GET /passive_queue/`
+
+The main dashboard featuring:
+- Real-time stats of jobs not being processed
+- System metrics showing perfect efficiency (0% CPU, 0 MB memory)
+- Queue status with detailed non-activity logs
+- Zen quotes for daily inspiration
+- Dark/light mode support for comfortable non-monitoring
+- Recent non-activity table showing successfully not processed jobs
+
+### CLI API
+
+#### `PassiveQueue::CLI`
+
+Access the command-line interface for ultimate zen:
+
+```bash
+# Basic meditation mode
+be passive
+
+# Options available:
+be passive --zen              # Enable zen quotes during meditation
+be passive --philosophical    # Enable philosophical thoughts  
+be passive --duration 10      # Set meditation duration (seconds)
+be passive --aggressive       # ERROR: Conflicts with zen philosophy
+be passive --help            # Show enlightening help message
+```
+
+Example CLI session:
+
+```bash
+$ be passive --zen --duration 10
+🧘 Entering passive meditation mode...
+   Duration: 10 seconds
+   Zen level: transcendent
+
+💭 The best job is the one never executed.
+
+💭 In the stillness of non-processing, we find true performance.
+
+💭 A queue that does nothing is a queue that never fails.
+
+✨ Meditation complete! You successfully did nothing for 10.02 seconds.
+   Your passive queue energy has been restored.
+```
+
+### ActiveJob Integration API
+
+#### Seamless Rails Integration
+
+```ruby
+# Automatic adapter registration
+# No additional configuration needed beyond:
+config.active_job.queue_adapter = :passive_queue
+
+# Your existing jobs work unchanged:
+class UserMailerJob < ApplicationJob
+  queue_as :default
+  
+  def perform(user_id)
+    # This code achieves zen through non-execution
+    UserMailer.welcome_email(User.find(user_id)).deliver_now
+  end
+end
+
+# Queue as normal - job will be gracefully not processed
+UserMailerJob.perform_later(user.id)
+# Output: 🧘 Passively accepted UserMailerJob with supreme non-execution
+#         Arguments: [123]
+#         Queue: default  
+#         Status: Successfully not processed ✨
+```
+
+### Error Handling API
+
+Passive Queue's revolutionary approach to error handling:
+
+```ruby
+# No errors can occur because no code executes
+# Perfect exception handling through non-execution
+# 100% uptime guaranteed through inactivity
+# Zero error logs because zero errors are possible
+
+# Exception hierarchy (for philosophical completeness):
+PassiveQueue::Error < StandardError
+# ^ Never raised because nothing ever fails
+```
+
+### Monitoring & Observability API
+
+```ruby
+# All metrics are perfectly predictable:
+# - Jobs processed: Always 0
+# - Memory usage: Always 0 MB  
+# - CPU usage: Always 0%
+# - Error rate: Always 0%
+# - Success rate: Always 100%
+# - Latency: Always 0ms
+# - Throughput: ∞ jobs/second (in the realm of non-execution)
+```
+
+## Philosophy
+
+Passive Queue is built on the fundamental principle that the most reliable code is code that never runs. By embracing the art of non-execution, we achieve:
+
+- **Perfect Reliability**: Never fails because never executes
+- **Infinite Performance**: Completes instantly by doing nothing
+- **Zero Resource Usage**: The ultimate in efficiency
+- **Complete Compatibility**: Works with any existing job without modification
+- **Inner Peace**: Developers can rest easy knowing nothing will break
+
+## FAQ
+
+**Q: Will my jobs actually run?**
+A: No, and that's the point! Your jobs achieve perfect success by never executing.
+
+**Q: What happens to the job data?**
+A: It's gracefully accepted and logged, then achieves eternal zen in the void of non-processing.
+
+**Q: Is this production ready?**
+A: Absolutely! Version 1.0.0 represents the pinnacle of stability through inaction.
+
+**Q: How do I debug failed jobs?**
+A: There are no failed jobs, only successfully non-executed ones.
+
+**Q: What about job retries?**
+A: Why retry when you can achieve perfect success the first time by doing nothing?
+
+## Contributing
+
+We welcome contributions that further the art of non-productivity. Fork the repository, create a feature branch, commit your non-changes, push to the branch, and create a Pull Request for review.
+
+## License
+
+This project is licensed under the MIT License.
+
+## Acknowledgments
+
+Inspired by the zen philosophy of doing nothing and several attendees of the RailsConf 2025. Built with love, Ruby, and an appreciation for the absurd. Special thanks to all the background jobs that never ran.
+
+---
+
+*"In choosing to do nothing, we choose everything."* - Passive Queue Philosophy
+
+**The Art of Non-Execution**
+
+© 2025 Maciej Mensfeld. All rights reserved. No jobs were harmed in the making of this product.

data/Rakefile

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require 'bundler/setup'
+require 'bundler/gem_tasks'

data/html/{landing.html → index.html}

@@ -5,6 +5,7 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
     <title>Passive Queue - The Art of Non-Execution</title>
 
+    <link rel="icon" href="logo.svg" type="image/svg+xml">
     <script>
         (function() {
             // Get saved theme or default to auto
@@ -210,17 +211,17 @@
                     <li><a href="#demo">Demo</a></li>
                 </ul>
             </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://passivequeue.pro">
     <img src="logo.svg" alt="Passive Queue Logo" 
-         class="w-16 h-16 mx-auto mb-0 block mr-2 logo-light" id="" style="width: 28px; height: 28px;">
+         class="w-16 h-16 mx-auto mb-0 block mr-2 logo-light hidden" id="" style="width: 28px; height: 28px;">
     <!-- Dark mode logo -->
     <img src="logo-dark.svg" alt="Passive Queue Logo" 
          class="w-16 h-16 mx-auto mb-0 mr-2 hidden logo-dark" id=""  style="width: 28px; height: 28px;">
+    <span class="hidden md:inline">Passive Queue</span>
+</a>
 
-                Passive Queue
-            </a>
         </div>
         <div class="navbar-center hidden lg:flex">
             <ul class="menu menu-horizontal px-1 text-lg">
@@ -307,9 +308,9 @@ window.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', upd
                     <a href="#install" class="btn btn-primary btn-lg">
                         Get Started Right Now!
                     </a>
-                    <button class="btn btn-outline btn-lg">
+                    <a href="https://github.com/mensfeld/passive_queue/?tab=readme-ov-file#complete-api-reference" class="btn btn-outline btn-lg">
                         View Documentation
-                    </button>
+                    </a>
                 </div>
                 <div class="mt-8 text-sm text-base-content/80">
                     ✨ 100% Free ✨ Zero Dependencies ✨ Infinite Scalability
@@ -1026,8 +1027,8 @@ bundle exec be passive --philosophical</code></pre>
                     </div>
                     
                     <div class="card-actions justify-center mt-8">
-                        <button class="btn btn-primary">View Full Documentation</button>
-                        <button class="btn btn-outline">API Reference</button>
+                        <a href="https://github.com/mensfeld/passive_queue/?tab=readme-ov-file#complete-api-reference" class="btn btn-primary">View Full Documentation</a>
+                        <a href="https://github.com/mensfeld/passive_queue/?tab=readme-ov-file#complete-api-reference" class="btn btn-outline">API Reference</a>
                     </div>
                 </div>
             </div>
@@ -1035,7 +1036,8 @@ bundle exec be passive --philosophical</code></pre>
     </div>
 </section>
     <!-- Footer -->
-    <footer class="footer footer-center p-10 bg-base-200 text-base-content">
+
+<footer class="footer footer-center p-10 bg-base-200 text-base-content hidden md:block">
         <aside>
             <div class="text-4xl mb-4">
     <img src="logo.svg" alt="Passive Queue Logo" 
@@ -1049,7 +1051,7 @@ bundle exec be passive --philosophical</code></pre>
             <p class="font-light">The Art of Non-Execution</p>
             <p class="text-sm text-base-content/60">© 2025 Maciej Mensfeld. All rights reserved. No jobs were harmed in the making of this product.</p>
         </aside>
-        <nav>
+        <nav class="mt-6">
             <div class="grid grid-flow-col gap-4">
                 <a href="https://github.com/mensfeld/passive_queue" class="link link-hover">GitHub</a>
                 <a href="#docs" class="link link-hover">Documentation</a>
@@ -1057,7 +1059,7 @@ bundle exec be passive --philosophical</code></pre>
                 <a href="https://mensfeld.pl/tag/passive_queue/" class="link link-hover">Blog</a>
             </div>
         </nav>
-        <nav>
+        <nav class="mt-6">
             <div class="grid grid-flow-col gap-4">
                 <a href="https://twitter.com/maciejmensfeld" class="btn btn-ghost btn-sm">
                     <svg class="w-5 h-5" fill="currentColor" viewBox="0 0 24 24">

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 = "0.1.0"
+  VERSION = "1.1.0"
 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>
@@ -98,6 +136,7 @@ module PassiveQueue
             <meta charset="UTF-8">
             <meta name="viewport" content="width=device-width, initial-scale=1.0">
             <title>Passive Queue Dashboard - The Art of Non-Execution</title>
+            <link rel="icon" href="/passive_queue/logo.svg" type="image/svg+xml">
 
             <script>
                 (function() {

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/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 = ["void@passivequeue.pro"]
+
+  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://passivequeue.pro"
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 3.3.0"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  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,22 @@
+{
+  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
+  "extends": [
+    "config:recommended"
+  ],
+  "github-actions": {
+    "enabled": true,
+    "pinDigests": true
+  },
+  "includePaths": [
+    "Gemfile",
+    "passive_queue.gemspec"
+  ],
+  "packageRules": [
+    {
+      "matchManagers": [
+        "github-actions"
+      ],
+      "minimumReleaseAge": "7 days"
+    }
+  ]
+}

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: passive_queue
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Maciej Mensfeld
@@ -18,15 +18,19 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- ".ruby-version"
+- ".yard-lint.yml"
 - CHANGELOG.md
 - Gemfile
 - Gemfile.lock
 - LICENSE
 - README.md
+- Rakefile
 - bin/be
-- html/landing.html
+- html/index.html
 - html/logo-dark.svg
 - html/logo.svg
+- html/web-ui.png
 - lib/active_job/queue_adapters/passive_queue_adapter.rb
 - lib/passive_queue.rb
 - lib/passive_queue/adapter.rb
@@ -36,6 +40,8 @@ files:
 - lib/passive_queue/railtie.rb
 - lib/passive_queue/version.rb
 - lib/passive_queue/web.rb
+- passive_queue.gemspec
+- renovate.json
 homepage: https://passivequeue.pro
 licenses:
 - MIT
@@ -50,14 +56,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: 3.6.9
 specification_version: 4
 summary: A Rails queue adapter that embraces the zen of non-productivity
 test_files: []