RubyGems - pgbus - Versions diffs - 0.0.1 - Mend

pgbus 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (89) hide show

checksums.yaml +7 -0
data/.bun-version +1 -0
data/.claude/commands/architect.md +100 -0
data/.claude/commands/github-review-comments.md +237 -0
data/.claude/commands/lfg.md +271 -0
data/.claude/commands/review-pr.md +69 -0
data/.claude/commands/security.md +122 -0
data/.claude/commands/tdd.md +148 -0
data/.claude/rules/agents.md +49 -0
data/.claude/rules/coding-style.md +91 -0
data/.claude/rules/git-workflow.md +56 -0
data/.claude/rules/performance.md +73 -0
data/.claude/rules/testing.md +67 -0
data/CHANGELOG.md +5 -0
data/CLAUDE.md +80 -0
data/CODE_OF_CONDUCT.md +10 -0
data/LICENSE.txt +21 -0
data/README.md +417 -0
data/Rakefile +14 -0
data/app/controllers/pgbus/api/stats_controller.rb +11 -0
data/app/controllers/pgbus/application_controller.rb +35 -0
data/app/controllers/pgbus/dashboard_controller.rb +27 -0
data/app/controllers/pgbus/dead_letter_controller.rb +50 -0
data/app/controllers/pgbus/events_controller.rb +23 -0
data/app/controllers/pgbus/jobs_controller.rb +48 -0
data/app/controllers/pgbus/processes_controller.rb +10 -0
data/app/controllers/pgbus/queues_controller.rb +21 -0
data/app/helpers/pgbus/application_helper.rb +69 -0
data/app/views/layouts/pgbus/application.html.erb +76 -0
data/app/views/pgbus/dashboard/_processes_table.html.erb +30 -0
data/app/views/pgbus/dashboard/_queues_table.html.erb +39 -0
data/app/views/pgbus/dashboard/_recent_failures.html.erb +33 -0
data/app/views/pgbus/dashboard/_stats_cards.html.erb +28 -0
data/app/views/pgbus/dashboard/show.html.erb +10 -0
data/app/views/pgbus/dead_letter/_messages_table.html.erb +40 -0
data/app/views/pgbus/dead_letter/index.html.erb +15 -0
data/app/views/pgbus/dead_letter/show.html.erb +52 -0
data/app/views/pgbus/events/index.html.erb +57 -0
data/app/views/pgbus/events/show.html.erb +28 -0
data/app/views/pgbus/jobs/_enqueued_table.html.erb +34 -0
data/app/views/pgbus/jobs/_failed_table.html.erb +45 -0
data/app/views/pgbus/jobs/index.html.erb +16 -0
data/app/views/pgbus/jobs/show.html.erb +57 -0
data/app/views/pgbus/processes/_processes_table.html.erb +37 -0
data/app/views/pgbus/processes/index.html.erb +3 -0
data/app/views/pgbus/queues/_queues_list.html.erb +41 -0
data/app/views/pgbus/queues/index.html.erb +3 -0
data/app/views/pgbus/queues/show.html.erb +49 -0
data/bun.lock +18 -0
data/config/routes.rb +45 -0
data/docs/README.md +28 -0
data/docs/switch_from_good_job.md +279 -0
data/docs/switch_from_sidekiq.md +226 -0
data/docs/switch_from_solid_queue.md +247 -0
data/exe/pgbus +7 -0
data/lib/generators/pgbus/install_generator.rb +56 -0
data/lib/generators/pgbus/templates/migration.rb.erb +114 -0
data/lib/generators/pgbus/templates/pgbus.yml.erb +74 -0
data/lib/generators/pgbus/templates/pgbus_binstub.erb +7 -0
data/lib/pgbus/active_job/adapter.rb +109 -0
data/lib/pgbus/active_job/executor.rb +107 -0
data/lib/pgbus/batch.rb +153 -0
data/lib/pgbus/cli.rb +84 -0
data/lib/pgbus/client.rb +162 -0
data/lib/pgbus/concurrency/blocked_execution.rb +74 -0
data/lib/pgbus/concurrency/semaphore.rb +66 -0
data/lib/pgbus/concurrency.rb +65 -0
data/lib/pgbus/config_loader.rb +27 -0
data/lib/pgbus/configuration.rb +99 -0
data/lib/pgbus/engine.rb +31 -0
data/lib/pgbus/event.rb +31 -0
data/lib/pgbus/event_bus/handler.rb +76 -0
data/lib/pgbus/event_bus/publisher.rb +42 -0
data/lib/pgbus/event_bus/registry.rb +54 -0
data/lib/pgbus/event_bus/subscriber.rb +30 -0
data/lib/pgbus/process/consumer.rb +113 -0
data/lib/pgbus/process/dispatcher.rb +154 -0
data/lib/pgbus/process/heartbeat.rb +71 -0
data/lib/pgbus/process/signal_handler.rb +49 -0
data/lib/pgbus/process/supervisor.rb +198 -0
data/lib/pgbus/process/worker.rb +153 -0
data/lib/pgbus/serializer.rb +43 -0
data/lib/pgbus/version.rb +5 -0
data/lib/pgbus/web/authentication.rb +24 -0
data/lib/pgbus/web/data_source.rb +406 -0
data/lib/pgbus.rb +49 -0
data/package.json +9 -0
data/sig/pgbus.rbs +4 -0
metadata +198 -0

data/app/helpers/pgbus/application_helper.rb ADDED Viewed

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+require "time"
+module Pgbus
+  module ApplicationHelper
+    def pgbus_time_ago(time)
+      return "—" unless time
+      time = Time.parse(time) if time.is_a?(String)
+      seconds = (Time.now - time).to_i
+      case seconds
+      when 0..59 then "#{seconds}s ago"
+      when 60..3599 then "#{seconds / 60}m ago"
+      when 3600..86_399 then "#{seconds / 3600}h ago"
+      else "#{seconds / 86_400}d ago"
+      end
+    end
+    def pgbus_number(n)
+      return "0" unless n
+      n = n.to_i
+      case n
+      when 0..999 then n.to_s
+      when 1_000..999_999 then "#{(n / 1_000.0).round(1)}K"
+      else "#{(n / 1_000_000.0).round(1)}M"
+      end
+    end
+    def pgbus_status_badge(healthy)
+      if healthy
+        tag.span("Healthy", class: "inline-flex items-center rounded-full bg-green-100 px-2.5 py-0.5 text-xs font-medium text-green-800")
+      else
+        tag.span("Stale", class: "inline-flex items-center rounded-full bg-red-100 px-2.5 py-0.5 text-xs font-medium text-red-800")
+      end
+    end
+    def pgbus_queue_badge(name)
+      if name.to_s.end_with?("_dlq")
+        tag.span("DLQ", class: "inline-flex items-center rounded-full bg-red-100 px-2 py-0.5 text-xs font-medium text-red-700")
+      else
+        tag.span("Queue", class: "inline-flex items-center rounded-full bg-blue-100 px-2 py-0.5 text-xs font-medium text-blue-700")
+      end
+    end
+    def pgbus_json_preview(json_string, max_length: 120)
+      return "—" unless json_string
+      text = json_string.is_a?(String) ? json_string : JSON.generate(json_string)
+      text.length > max_length ? "#{text[0...max_length]}..." : text
+    end
+    def pgbus_refresh_interval
+      Pgbus.configuration.web_refresh_interval
+    end
+    def pgbus_nav_link(label, path)
+      active = request.path == path || (path != pgbus.root_path && request.path.start_with?(path))
+      css = if active
+              "rounded-md px-3 py-2 text-sm font-medium text-white bg-gray-800"
+            else
+              "rounded-md px-3 py-2 text-sm font-medium text-gray-300 hover:text-white hover:bg-gray-700"
+            end
+      link_to label, path, class: css
+    end
+  end
+end

data/app/views/layouts/pgbus/application.html.erb ADDED Viewed

@@ -0,0 +1,76 @@
+<!DOCTYPE html>
+<html lang="en" class="h-full bg-gray-50">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>Pgbus Dashboard</title>
+  <script src="https://cdn.tailwindcss.com"></script>
+  <script type="module">
+    import * as Turbo from "https://cdn.jsdelivr.net/npm/@hotwired/turbo@8/dist/turbo.es2017.esm.js";
+    <% if Pgbus.configuration.web_live_updates %>
+    // Auto-refresh turbo frames, pausing when tab is hidden
+    const interval = <%= Pgbus.configuration.web_refresh_interval %>;
+    if (interval > 0) {
+      let timer;
+      function refreshFrames() {
+        if (document.hidden) return;
+        document.querySelectorAll("turbo-frame[data-auto-refresh]")
+          .forEach(frame => frame.reload());
+      }
+      function start() { timer = setInterval(refreshFrames, interval); }
+      function stop() { clearInterval(timer); }
+      document.addEventListener("visibilitychange", () => document.hidden ? stop() : start());
+      start();
+    }
+    <% end %>
+  </script>
+</head>
+<body class="h-full">
+  <div class="min-h-full">
+    <!-- Top nav -->
+    <nav class="bg-gray-900">
+      <div class="mx-auto max-w-7xl px-4 sm:px-6 lg:px-8">
+        <div class="flex h-14 items-center justify-between">
+          <div class="flex items-center space-x-8">
+            <%= link_to pgbus.root_path, class: "flex items-center space-x-2" do %>
+              <span class="text-lg font-bold text-white">Pgbus</span>
+              <span class="rounded bg-gray-700 px-1.5 py-0.5 text-xs text-gray-300"><%= Pgbus::VERSION %></span>
+            <% end %>
+            <div class="flex space-x-1">
+              <%= pgbus_nav_link "Dashboard", pgbus.root_path %>
+              <%= pgbus_nav_link "Queues", pgbus.queues_path %>
+              <%= pgbus_nav_link "Jobs", pgbus.jobs_path %>
+              <%= pgbus_nav_link "Processes", pgbus.processes_path %>
+              <%= pgbus_nav_link "Events", pgbus.events_path %>
+              <%= pgbus_nav_link "DLQ", pgbus.dead_letter_index_path %>
+            </div>
+          </div>
+        </div>
+      </div>
+    </nav>
+    <!-- Flash messages -->
+    <% if notice %>
+      <div class="mx-auto max-w-7xl px-4 sm:px-6 lg:px-8 mt-4">
+        <div class="rounded-md bg-green-50 p-3">
+          <p class="text-sm text-green-800"><%= notice %></p>
+        </div>
+      </div>
+    <% end %>
+    <% if alert %>
+      <div class="mx-auto max-w-7xl px-4 sm:px-6 lg:px-8 mt-4">
+        <div class="rounded-md bg-red-50 p-3">
+          <p class="text-sm text-red-800"><%= alert %></p>
+        </div>
+      </div>
+    <% end %>
+    <!-- Content -->
+    <main class="mx-auto max-w-7xl px-4 sm:px-6 lg:px-8 py-6">
+      <%= yield %>
+    </main>
+  </div>
+</body>
+</html>

data/app/views/pgbus/dashboard/_processes_table.html.erb ADDED Viewed

@@ -0,0 +1,30 @@
+<turbo-frame id="dashboard-processes" data-auto-refresh src="<%= pgbus.root_path(frame: 'processes') %>">
+  <div>
+    <h2 class="text-lg font-semibold text-gray-900 mb-3">Active Processes</h2>
+    <div class="overflow-hidden rounded-lg bg-white shadow ring-1 ring-gray-200">
+      <table class="min-w-full divide-y divide-gray-200">
+        <thead class="bg-gray-50">
+          <tr>
+            <th class="px-4 py-3 text-left text-xs font-medium uppercase text-gray-500">Kind</th>
+            <th class="px-4 py-3 text-left text-xs font-medium uppercase text-gray-500">Host</th>
+            <th class="px-4 py-3 text-left text-xs font-medium uppercase text-gray-500">PID</th>
+            <th class="px-4 py-3 text-left text-xs font-medium uppercase text-gray-500">Status</th>
+          </tr>
+        </thead>
+        <tbody class="divide-y divide-gray-100">
+          <% @processes.each do |p| %>
+            <tr>
+              <td class="px-4 py-3 text-sm font-medium text-gray-900"><%= p[:kind] %></td>
+              <td class="px-4 py-3 text-sm text-gray-500"><%= p[:hostname] %></td>
+              <td class="px-4 py-3 text-sm text-gray-500"><%= p[:pid] %></td>
+              <td class="px-4 py-3 text-sm"><%= pgbus_status_badge(p[:healthy]) %></td>
+            </tr>
+          <% end %>
+          <% if @processes.empty? %>
+            <tr><td colspan="4" class="px-4 py-8 text-center text-sm text-gray-400">No processes running</td></tr>
+          <% end %>
+        </tbody>
+      </table>
+    </div>
+  </div>
+</turbo-frame>

data/app/views/pgbus/dashboard/_queues_table.html.erb ADDED Viewed

@@ -0,0 +1,39 @@
+<turbo-frame id="dashboard-queues" data-auto-refresh src="<%= pgbus.root_path(frame: 'queues') %>">
+  <div class="mb-8">
+    <div class="flex items-center justify-between mb-3">
+      <h2 class="text-lg font-semibold text-gray-900">Queues</h2>
+      <%= link_to "View all", pgbus.queues_path, class: "text-sm text-indigo-600 hover:text-indigo-500", data: { turbo_frame: "_top" } %>
+    </div>
+    <div class="overflow-hidden rounded-lg bg-white shadow ring-1 ring-gray-200">
+      <table class="min-w-full divide-y divide-gray-200">
+        <thead class="bg-gray-50">
+          <tr>
+            <th class="px-4 py-3 text-left text-xs font-medium uppercase text-gray-500">Queue</th>
+            <th class="px-4 py-3 text-right text-xs font-medium uppercase text-gray-500">Depth</th>
+            <th class="px-4 py-3 text-right text-xs font-medium uppercase text-gray-500">Visible</th>
+            <th class="px-4 py-3 text-right text-xs font-medium uppercase text-gray-500">Oldest (s)</th>
+            <th class="px-4 py-3 text-right text-xs font-medium uppercase text-gray-500">Total</th>
+          </tr>
+        </thead>
+        <tbody class="divide-y divide-gray-100">
+          <% @queues.each do |q| %>
+            <tr class="hover:bg-gray-50">
+              <td class="px-4 py-3 text-sm">
+                <%= link_to q[:name], pgbus.queue_path(name: q[:name]), class: "font-medium text-indigo-600 hover:text-indigo-500", data: { turbo_frame: "_top" } %>
+                <%= pgbus_queue_badge(q[:name]) %>
+              </td>
+              <td class="px-4 py-3 text-sm text-right text-gray-700"><%= pgbus_number(q[:queue_length]) %></td>
+              <td class="px-4 py-3 text-sm text-right text-gray-700"><%= pgbus_number(q[:queue_visible_length]) %></td>
+              <td class="px-4 py-3 text-sm text-right text-gray-500"><%= q[:oldest_msg_age_sec] || "—" %></td>
+              <td class="px-4 py-3 text-sm text-right text-gray-500"><%= pgbus_number(q[:total_messages]) %></td>
+            </tr>
+          <% end %>
+          <% if @queues.empty? %>
+            <tr><td colspan="5" class="px-4 py-8 text-center text-sm text-gray-400">No queues found</td></tr>
+          <% end %>
+        </tbody>
+      </table>
+    </div>
+  </div>
+</turbo-frame>

data/app/views/pgbus/dashboard/_recent_failures.html.erb ADDED Viewed

@@ -0,0 +1,33 @@
+<turbo-frame id="dashboard-failures" data-auto-refresh src="<%= pgbus.root_path(frame: 'failures') %>">
+  <div>
+    <div class="flex items-center justify-between mb-3">
+      <h2 class="text-lg font-semibold text-gray-900">Recent Failures</h2>
+      <% if @recent_failures.any? %>
+        <%= link_to "View all", pgbus.jobs_path(status: "failed"), class: "text-sm text-indigo-600 hover:text-indigo-500", data: { turbo_frame: "_top" } %>
+      <% end %>
+    </div>
+    <div class="overflow-hidden rounded-lg bg-white shadow ring-1 ring-gray-200">
+      <table class="min-w-full divide-y divide-gray-200">
+        <thead class="bg-gray-50">
+          <tr>
+            <th class="px-4 py-3 text-left text-xs font-medium uppercase text-gray-500">Queue</th>
+            <th class="px-4 py-3 text-left text-xs font-medium uppercase text-gray-500">Error</th>
+            <th class="px-4 py-3 text-left text-xs font-medium uppercase text-gray-500">When</th>
+          </tr>
+        </thead>
+        <tbody class="divide-y divide-gray-100">
+          <% @recent_failures.each do |f| %>
+            <tr>
+              <td class="px-4 py-3 text-sm text-gray-700"><%= f["queue_name"] %></td>
+              <td class="px-4 py-3 text-sm text-red-600 truncate max-w-xs"><%= f["error_class"] %>: <%= truncate(f["error_message"].to_s, length: 60) %></td>
+              <td class="px-4 py-3 text-sm text-gray-500"><%= pgbus_time_ago(f["failed_at"]) %></td>
+            </tr>
+          <% end %>
+          <% if @recent_failures.empty? %>
+            <tr><td colspan="3" class="px-4 py-8 text-center text-sm text-gray-400">No failures</td></tr>
+          <% end %>
+        </tbody>
+      </table>
+    </div>
+  </div>
+</turbo-frame>

data/app/views/pgbus/dashboard/_stats_cards.html.erb ADDED Viewed

@@ -0,0 +1,28 @@
+<turbo-frame id="dashboard-stats" data-auto-refresh src="<%= pgbus.root_path(frame: 'stats') %>">
+  <div class="grid grid-cols-1 gap-4 sm:grid-cols-2 lg:grid-cols-4 mb-8">
+    <div class="rounded-lg bg-white p-5 shadow ring-1 ring-gray-200">
+      <p class="text-sm font-medium text-gray-500">Queues</p>
+      <p class="mt-1 text-3xl font-semibold text-gray-900"><%= @stats[:total_queues] %></p>
+    </div>
+    <div class="rounded-lg bg-white p-5 shadow ring-1 ring-gray-200">
+      <p class="text-sm font-medium text-gray-500">Enqueued</p>
+      <p class="mt-1 text-3xl font-semibold text-gray-900"><%= pgbus_number(@stats[:total_depth]) %></p>
+      <p class="text-xs text-gray-400"><%= pgbus_number(@stats[:total_visible]) %> visible</p>
+    </div>
+    <div class="rounded-lg bg-white p-5 shadow ring-1 ring-gray-200">
+      <p class="text-sm font-medium text-gray-500">Processes</p>
+      <p class="mt-1 text-3xl font-semibold <%= @stats[:active_processes] > 0 ? 'text-green-600' : 'text-gray-400' %>">
+        <%= @stats[:active_processes] %>
+      </p>
+    </div>
+    <div class="rounded-lg bg-white p-5 shadow ring-1 ring-gray-200">
+      <p class="text-sm font-medium text-gray-500">Failed / DLQ</p>
+      <p class="mt-1 text-3xl font-semibold <%= (@stats[:failed_count] + @stats[:dlq_depth]) > 0 ? 'text-red-600' : 'text-gray-900' %>">
+        <%= @stats[:failed_count] %> / <%= @stats[:dlq_depth] %>
+      </p>
+    </div>
+  </div>
+</turbo-frame>

data/app/views/pgbus/dashboard/show.html.erb ADDED Viewed

@@ -0,0 +1,10 @@
+<h1 class="text-2xl font-bold text-gray-900 mb-6">Dashboard</h1>
+<%= render "pgbus/dashboard/stats_cards" %>
+<%= render "pgbus/dashboard/queues_table" %>
+<div class="grid grid-cols-1 lg:grid-cols-2 gap-6">
+  <%= render "pgbus/dashboard/processes_table" %>
+  <%= render "pgbus/dashboard/recent_failures" %>
+</div>

data/app/views/pgbus/dead_letter/_messages_table.html.erb ADDED Viewed

@@ -0,0 +1,40 @@
+<turbo-frame id="dlq-messages" data-auto-refresh src="<%= pgbus.dead_letter_index_path(frame: 'list') %>">
+  <div class="overflow-hidden rounded-lg bg-white shadow ring-1 ring-gray-200">
+    <table class="min-w-full divide-y divide-gray-200">
+      <thead class="bg-gray-50">
+        <tr>
+          <th class="px-4 py-3 text-left text-xs font-medium uppercase text-gray-500">ID</th>
+          <th class="px-4 py-3 text-left text-xs font-medium uppercase text-gray-500">Source Queue</th>
+          <th class="px-4 py-3 text-left text-xs font-medium uppercase text-gray-500">Enqueued</th>
+          <th class="px-4 py-3 text-left text-xs font-medium uppercase text-gray-500">Reads</th>
+          <th class="px-4 py-3 text-left text-xs font-medium uppercase text-gray-500">Payload</th>
+          <th class="px-4 py-3 text-right text-xs font-medium uppercase text-gray-500">Actions</th>
+        </tr>
+      </thead>
+      <tbody class="divide-y divide-gray-100">
+        <% @messages.each do |m| %>
+          <tr class="hover:bg-gray-50">
+            <td class="px-4 py-3 text-sm font-mono text-gray-900"><%= m[:msg_id] %></td>
+            <td class="px-4 py-3 text-sm text-gray-700"><%= m[:queue_name] %></td>
+            <td class="px-4 py-3 text-sm text-gray-500"><%= pgbus_time_ago(m[:enqueued_at]) %></td>
+            <td class="px-4 py-3 text-sm text-gray-500"><%= m[:read_ct] %></td>
+            <td class="px-4 py-3 text-sm text-gray-600 font-mono text-xs max-w-md truncate">
+              <%= pgbus_json_preview(m[:message]) %>
+            </td>
+            <td class="px-4 py-3 text-sm text-right space-x-2">
+              <%= button_to "Retry", pgbus.retry_dead_letter_path(m[:msg_id], queue_name: m[:queue_name]), method: :post,
+                    class: "text-xs text-indigo-600 hover:text-indigo-800 font-medium",
+                    data: { turbo_frame: "_top" } %>
+              <%= button_to "Discard", pgbus.discard_dead_letter_path(m[:msg_id], queue_name: m[:queue_name]), method: :post,
+                    class: "text-xs text-red-600 hover:text-red-800 font-medium",
+                    data: { turbo_confirm: "Permanently discard?", turbo_frame: "_top" } %>
+            </td>
+          </tr>
+        <% end %>
+        <% if @messages.empty? %>
+          <tr><td colspan="6" class="px-4 py-8 text-center text-sm text-gray-400">Dead letter queue is empty</td></tr>
+        <% end %>
+      </tbody>
+    </table>
+  </div>
+</turbo-frame>

data/app/views/pgbus/dead_letter/index.html.erb ADDED Viewed

@@ -0,0 +1,15 @@
+<div class="flex items-center justify-between mb-6">
+  <h1 class="text-2xl font-bold text-gray-900">Dead Letter Queue</h1>
+  <% if @messages.any? %>
+    <div class="flex space-x-2">
+      <%= button_to "Retry All", pgbus.retry_all_dead_letter_index_path, method: :post,
+            class: "rounded-md bg-indigo-600 px-3 py-2 text-sm font-medium text-white hover:bg-indigo-500",
+            data: { turbo_confirm: "Retry all DLQ messages?" } %>
+      <%= button_to "Discard All", pgbus.discard_all_dead_letter_index_path, method: :post,
+            class: "rounded-md bg-red-600 px-3 py-2 text-sm font-medium text-white hover:bg-red-500",
+            data: { turbo_confirm: "Permanently discard all DLQ messages?" } %>
+    </div>
+  <% end %>
+</div>
+<%= render "pgbus/dead_letter/messages_table" %>

data/app/views/pgbus/dead_letter/show.html.erb ADDED Viewed

@@ -0,0 +1,52 @@
+<div class="mb-6">
+  <%= link_to "&larr; Back to DLQ".html_safe, pgbus.dead_letter_index_path, class: "text-sm text-indigo-600 hover:text-indigo-500" %>
+</div>
+<% if @message %>
+  <h1 class="text-2xl font-bold text-gray-900 mb-6">DLQ Message #<%= @message[:msg_id] %></h1>
+  <div class="rounded-lg bg-white shadow ring-1 ring-gray-200 p-6 mb-6">
+    <dl class="grid grid-cols-1 gap-4 sm:grid-cols-2">
+      <div>
+        <dt class="text-sm font-medium text-gray-500">Source Queue</dt>
+        <dd class="text-sm text-gray-900"><%= @message[:queue_name] %></dd>
+      </div>
+      <div>
+        <dt class="text-sm font-medium text-gray-500">Enqueued At</dt>
+        <dd class="text-sm text-gray-900"><%= @message[:enqueued_at] %></dd>
+      </div>
+      <div>
+        <dt class="text-sm font-medium text-gray-500">Read Count</dt>
+        <dd class="text-sm text-gray-900"><%= @message[:read_ct] %></dd>
+      </div>
+      <div>
+        <dt class="text-sm font-medium text-gray-500">Visibility Timeout</dt>
+        <dd class="text-sm text-gray-900"><%= @message[:vt] %></dd>
+      </div>
+    </dl>
+  </div>
+  <div class="rounded-lg bg-white shadow ring-1 ring-gray-200 p-6 mb-6">
+    <h2 class="text-sm font-medium text-gray-500 mb-2">Payload</h2>
+    <pre class="text-xs text-gray-600 bg-gray-50 rounded p-4 overflow-x-auto"><%= JSON.pretty_generate(JSON.parse(@message[:message])) rescue @message[:message] %></pre>
+  </div>
+  <% if @message[:headers] %>
+    <div class="rounded-lg bg-white shadow ring-1 ring-gray-200 p-6 mb-6">
+      <h2 class="text-sm font-medium text-gray-500 mb-2">Headers</h2>
+      <pre class="text-xs text-gray-600 bg-gray-50 rounded p-4 overflow-x-auto"><%= JSON.pretty_generate(JSON.parse(@message[:headers])) rescue @message[:headers] %></pre>
+    </div>
+  <% end %>
+  <div class="flex space-x-2">
+    <%= button_to "Retry", pgbus.retry_dead_letter_path(@message[:msg_id], queue_name: @message[:queue_name]), method: :post,
+          class: "rounded-md bg-indigo-600 px-4 py-2 text-sm font-medium text-white hover:bg-indigo-500" %>
+    <%= button_to "Discard", pgbus.discard_dead_letter_path(@message[:msg_id], queue_name: @message[:queue_name]), method: :post,
+          class: "rounded-md bg-red-600 px-4 py-2 text-sm font-medium text-white hover:bg-red-500",
+          data: { turbo_confirm: "Permanently discard?" } %>
+  </div>
+<% else %>
+  <div class="text-center py-12">
+    <p class="text-gray-400">Message not found</p>
+  </div>
+<% end %>

data/app/views/pgbus/events/index.html.erb ADDED Viewed

@@ -0,0 +1,57 @@
+<h1 class="text-2xl font-bold text-gray-900 mb-6">Events</h1>
+<!-- Registered Subscribers -->
+<div class="mb-8">
+  <h2 class="text-lg font-semibold text-gray-900 mb-3">Registered Subscribers</h2>
+  <div class="overflow-hidden rounded-lg bg-white shadow ring-1 ring-gray-200">
+    <table class="min-w-full divide-y divide-gray-200">
+      <thead class="bg-gray-50">
+        <tr>
+          <th class="px-4 py-3 text-left text-xs font-medium uppercase text-gray-500">Pattern</th>
+          <th class="px-4 py-3 text-left text-xs font-medium uppercase text-gray-500">Handler</th>
+          <th class="px-4 py-3 text-left text-xs font-medium uppercase text-gray-500">Queue</th>
+        </tr>
+      </thead>
+      <tbody class="divide-y divide-gray-100">
+        <% @subscribers.each do |s| %>
+          <tr class="hover:bg-gray-50">
+            <td class="px-4 py-3 text-sm font-mono text-indigo-600"><%= s[:pattern] %></td>
+            <td class="px-4 py-3 text-sm text-gray-900"><%= s[:handler_class] %></td>
+            <td class="px-4 py-3 text-sm text-gray-500"><%= s[:queue_name] %></td>
+          </tr>
+        <% end %>
+        <% if @subscribers.empty? %>
+          <tr><td colspan="3" class="px-4 py-8 text-center text-sm text-gray-400">No subscribers registered</td></tr>
+        <% end %>
+      </tbody>
+    </table>
+  </div>
+</div>
+<!-- Processed Events (Audit Trail) -->
+<div>
+  <h2 class="text-lg font-semibold text-gray-900 mb-3">Processed Events</h2>
+  <div class="overflow-hidden rounded-lg bg-white shadow ring-1 ring-gray-200">
+    <table class="min-w-full divide-y divide-gray-200">
+      <thead class="bg-gray-50">
+        <tr>
+          <th class="px-4 py-3 text-left text-xs font-medium uppercase text-gray-500">Event ID</th>
+          <th class="px-4 py-3 text-left text-xs font-medium uppercase text-gray-500">Handler</th>
+          <th class="px-4 py-3 text-left text-xs font-medium uppercase text-gray-500">Processed At</th>
+        </tr>
+      </thead>
+      <tbody class="divide-y divide-gray-100">
+        <% @events.each do |e| %>
+          <tr class="hover:bg-gray-50">
+            <td class="px-4 py-3 text-sm font-mono text-gray-900"><%= e["event_id"] %></td>
+            <td class="px-4 py-3 text-sm text-gray-700"><%= e["handler_class"] %></td>
+            <td class="px-4 py-3 text-sm text-gray-500"><%= pgbus_time_ago(e["processed_at"]) %></td>
+          </tr>
+        <% end %>
+        <% if @events.empty? %>
+          <tr><td colspan="3" class="px-4 py-8 text-center text-sm text-gray-400">No events processed yet</td></tr>
+        <% end %>
+      </tbody>
+    </table>
+  </div>
+</div>

data/app/views/pgbus/events/show.html.erb ADDED Viewed

@@ -0,0 +1,28 @@
+<div class="mb-6">
+  <%= link_to "&larr; Back to Events".html_safe, pgbus.events_path, class: "text-sm text-indigo-600 hover:text-indigo-500" %>
+</div>
+<% if @event %>
+  <h1 class="text-2xl font-bold text-gray-900 mb-6">Event <%= @event["event_id"] %></h1>
+  <div class="rounded-lg bg-white shadow ring-1 ring-gray-200 p-6">
+    <dl class="grid grid-cols-1 gap-4 sm:grid-cols-2">
+      <div>
+        <dt class="text-sm font-medium text-gray-500">Event ID</dt>
+        <dd class="text-sm font-mono text-gray-900"><%= @event["event_id"] %></dd>
+      </div>
+      <div>
+        <dt class="text-sm font-medium text-gray-500">Handler</dt>
+        <dd class="text-sm text-gray-900"><%= @event["handler_class"] %></dd>
+      </div>
+      <div>
+        <dt class="text-sm font-medium text-gray-500">Processed At</dt>
+        <dd class="text-sm text-gray-900"><%= @event["processed_at"] %></dd>
+      </div>
+    </dl>
+  </div>
+<% else %>
+  <div class="text-center py-12">
+    <p class="text-gray-400">Event not found</p>
+  </div>
+<% end %>

data/app/views/pgbus/jobs/_enqueued_table.html.erb ADDED Viewed

@@ -0,0 +1,34 @@
+<turbo-frame id="jobs-enqueued" data-auto-refresh src="<%= pgbus.jobs_path(request.query_parameters.merge(frame: 'enqueued')) %>">
+  <div>
+    <h2 class="text-lg font-semibold text-gray-900 mb-3">Enqueued Jobs</h2>
+    <div class="overflow-hidden rounded-lg bg-white shadow ring-1 ring-gray-200">
+      <table class="min-w-full divide-y divide-gray-200">
+        <thead class="bg-gray-50">
+          <tr>
+            <th class="px-4 py-3 text-left text-xs font-medium uppercase text-gray-500">ID</th>
+            <th class="px-4 py-3 text-left text-xs font-medium uppercase text-gray-500">Queue</th>
+            <th class="px-4 py-3 text-left text-xs font-medium uppercase text-gray-500">Enqueued</th>
+            <th class="px-4 py-3 text-left text-xs font-medium uppercase text-gray-500">Reads</th>
+            <th class="px-4 py-3 text-left text-xs font-medium uppercase text-gray-500">Payload</th>
+          </tr>
+        </thead>
+        <tbody class="divide-y divide-gray-100">
+          <% @jobs.each do |j| %>
+            <tr class="hover:bg-gray-50">
+              <td class="px-4 py-3 text-sm font-mono text-gray-900"><%= j[:msg_id] %></td>
+              <td class="px-4 py-3 text-sm text-gray-700"><%= j[:queue_name] %></td>
+              <td class="px-4 py-3 text-sm text-gray-500"><%= pgbus_time_ago(j[:enqueued_at]) %></td>
+              <td class="px-4 py-3 text-sm text-gray-500"><%= j[:read_ct] %></td>
+              <td class="px-4 py-3 text-sm text-gray-600 font-mono text-xs max-w-md truncate">
+                <%= pgbus_json_preview(j[:message]) %>
+              </td>
+            </tr>
+          <% end %>
+          <% if @jobs.empty? %>
+            <tr><td colspan="5" class="px-4 py-8 text-center text-sm text-gray-400">No enqueued jobs</td></tr>
+          <% end %>
+        </tbody>
+      </table>
+    </div>
+  </div>
+</turbo-frame>

data/app/views/pgbus/jobs/_failed_table.html.erb ADDED Viewed

@@ -0,0 +1,45 @@
+<turbo-frame id="jobs-failed" data-auto-refresh src="<%= pgbus.jobs_path(frame: 'failed') %>">
+  <div class="mb-8">
+    <h2 class="text-lg font-semibold text-gray-900 mb-3">Failed Jobs</h2>
+    <div class="overflow-hidden rounded-lg bg-white shadow ring-1 ring-gray-200">
+      <table class="min-w-full divide-y divide-gray-200">
+        <thead class="bg-gray-50">
+          <tr>
+            <th class="px-4 py-3 text-left text-xs font-medium uppercase text-gray-500">ID</th>
+            <th class="px-4 py-3 text-left text-xs font-medium uppercase text-gray-500">Queue</th>
+            <th class="px-4 py-3 text-left text-xs font-medium uppercase text-gray-500">Error</th>
+            <th class="px-4 py-3 text-left text-xs font-medium uppercase text-gray-500">Retries</th>
+            <th class="px-4 py-3 text-left text-xs font-medium uppercase text-gray-500">Failed</th>
+            <th class="px-4 py-3 text-right text-xs font-medium uppercase text-gray-500">Actions</th>
+          </tr>
+        </thead>
+        <tbody class="divide-y divide-gray-100">
+          <% @failed.each do |f| %>
+            <tr class="hover:bg-gray-50">
+              <td class="px-4 py-3 text-sm font-mono text-gray-900">
+                <%= link_to f["id"], pgbus.job_path(f["id"]), class: "text-indigo-600 hover:text-indigo-500", data: { turbo_frame: "_top" } %>
+              </td>
+              <td class="px-4 py-3 text-sm text-gray-700"><%= f["queue_name"] %></td>
+              <td class="px-4 py-3 text-sm text-red-600 max-w-sm truncate">
+                <span class="font-medium"><%= f["error_class"] %></span>: <%= truncate(f["error_message"].to_s, length: 80) %>
+              </td>
+              <td class="px-4 py-3 text-sm text-gray-500"><%= f["retry_count"] %></td>
+              <td class="px-4 py-3 text-sm text-gray-500"><%= pgbus_time_ago(f["failed_at"]) %></td>
+              <td class="px-4 py-3 text-sm text-right space-x-2">
+                <%= button_to "Retry", pgbus.retry_job_path(f["id"]), method: :post,
+                      class: "text-xs text-indigo-600 hover:text-indigo-800 font-medium",
+                      data: { turbo_frame: "_top" } %>
+                <%= button_to "Discard", pgbus.discard_job_path(f["id"]), method: :post,
+                      class: "text-xs text-red-600 hover:text-red-800 font-medium",
+                      data: { turbo_confirm: "Discard this job?", turbo_frame: "_top" } %>
+              </td>
+            </tr>
+          <% end %>
+          <% if @failed.empty? %>
+            <tr><td colspan="6" class="px-4 py-8 text-center text-sm text-gray-400">No failed jobs</td></tr>
+          <% end %>
+        </tbody>
+      </table>
+    </div>
+  </div>
+</turbo-frame>

data/app/views/pgbus/jobs/index.html.erb ADDED Viewed

@@ -0,0 +1,16 @@
+<div class="flex items-center justify-between mb-6">
+  <h1 class="text-2xl font-bold text-gray-900">Jobs</h1>
+  <% if @failed.any? %>
+    <div class="flex space-x-2">
+      <%= button_to "Retry All", pgbus.retry_all_jobs_path, method: :post,
+            class: "rounded-md bg-indigo-600 px-3 py-2 text-sm font-medium text-white hover:bg-indigo-500",
+            data: { turbo_confirm: "Retry all failed jobs?" } %>
+      <%= button_to "Discard All", pgbus.discard_all_jobs_path, method: :post,
+            class: "rounded-md bg-red-600 px-3 py-2 text-sm font-medium text-white hover:bg-red-500",
+            data: { turbo_confirm: "Discard all failed jobs?" } %>
+    </div>
+  <% end %>
+</div>
+<%= render "pgbus/jobs/failed_table" %>
+<%= render "pgbus/jobs/enqueued_table" %>