pgbus 0.17.1 → 0.17.2

data/app/views/pgbus/dead_letter/_error.html.erb

@@ -0,0 +1,13 @@
+<%# The recorded error of a dead message: the full error line, which attempt
+    it came from when later ones recorded nothing, and the backtrace head.
+    Shared by the list expansion and the show page. Local: reason. %>
+<% if reason.error_class %>
+  <p class="mb-2 text-sm text-red-700 dark:text-red-300 break-words"><span class="font-medium"><%= reason.error_class %></span>: <%= reason.error_message %></p>
+  <% if (later = reason.later_attempts) %>
+    <p class="mb-2 text-xs text-gray-600 dark:text-gray-300"><%= t("pgbus.dead_letter.detail.error_from_attempt", attempt: reason.error_attempt, from: later.first, to: later.last) %></p>
+  <% end %>
+  <% if reason.backtrace.present? %>
+    <span class="text-xs font-medium text-gray-500 dark:text-gray-400"><%= t("pgbus.dead_letter.detail.backtrace") %></span>
+    <pre tabindex="0" class="mb-3 mt-1 max-h-40 overflow-auto rounded bg-white dark:bg-gray-800 p-2 text-xs text-gray-700 dark:text-gray-200"><%= reason.backtrace %></pre>
+  <% end %>
+<% end %>

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

@@ -1,4 +1,29 @@
-<turbo-frame id="dlq-messages" data-auto-refresh data-src="<%= pgbus.dead_letter_index_path(frame: 'list', page: @page) %>">
+<%# Dead-letter list (issue #495). Every row says why the message died, read
+    from the pgbus_dead_letter header block by DeadLetterReason; a row's
+    expansion is the <tr> after it, shown by CSS (.pgbus-job-detail in
+    tailwind.css) while the ID cell's <details> is open, like the Jobs list.
+    @list_path (->(extra) { url }) carries the dlq/error_class filters into
+    the frame source, the chips and the pager. %>
+<% columns = @messages.any? ? 8 : 7 %>
+<turbo-frame id="dlq-messages" data-auto-refresh data-src="<%= @list_path.call(frame: "list", page: (@page if @page > 1)) %>">
+  <nav class="mb-4 flex flex-wrap items-center gap-2" aria-label="<%= t("pgbus.dead_letter.filters.label") %>" data-testid="dlq-filters">
+    <% [nil, *@dlq_counts.keys].each do |name| %>
+      <% active = name == @dlq %>
+      <a href="<%= @list_path.call(dlq: name, page: nil) %>" data-turbo-frame="_top"
+         aria-current="<%= active ? "page" : "false" %>"
+         class="inline-flex items-center gap-2 rounded-md px-3 py-2 text-sm font-medium <%= active ? 'bg-gray-800 text-white dark:bg-gray-700' : 'text-gray-600 hover:bg-gray-100 hover:text-gray-900 dark:text-gray-300 dark:hover:bg-gray-800 dark:hover:text-white' %>">
+        <span><%= name || t("pgbus.dead_letter.filters.all") %></span>
+        <span class="rounded-full px-2 py-0.5 text-xs <%= active ? 'bg-gray-600 text-white' : 'bg-gray-100 text-gray-700 dark:bg-gray-700 dark:text-gray-200' %>"><%= number_with_delimiter(name ? @dlq_counts[name] : @dlq_counts.values.sum) %></span>
+      </a>
+    <% end %>
+    <% if @error_class %>
+      <span class="inline-flex items-center gap-2 rounded-md bg-red-50 dark:bg-red-900/30 px-3 py-1 text-sm text-red-800 dark:text-red-200" data-testid="dlq-error-filter">
+        <%= t("pgbus.dead_letter.filters.error_class", error_class: @error_class) %>
+        <%= pgbus_link_to t("pgbus.dead_letter.filters.clear_error_class"), @list_path.call(error_class: nil, page: nil),
+              size: :sm, tone: :red, data: { turbo_frame: "_top" } %>
+      </span>
+    <% end %>
+  </nav>
   <%# Count badge lives inside the frame so it refreshes in lockstep with the table. %>
   <% if @total_count && @total_count > 0 %>
     <p class="mb-3 text-sm text-gray-500 dark:text-gray-400">
@@ -18,110 +43,26 @@
             <th class="w-10 px-4 py-3">
               <input type="checkbox" data-bulk-select-all
                      aria-label="<%= t("pgbus.helpers.bulk_select_all") %>"
-                     class="h-4 w-4 rounded border-gray-300 text-indigo-600 focus:ring-indigo-600">
+                     class="h-4 w-4 rounded border-gray-300 text-indigo-600 dark:text-indigo-400 focus:ring-indigo-600">
             </th>
           <% end %>
-          <th class="px-4 py-3 text-left text-xs font-medium uppercase text-gray-500"><%= t("pgbus.dead_letter.messages_table.headers.id") %></th>
-          <th class="px-4 py-3 text-left text-xs font-medium uppercase text-gray-500"><%= t("pgbus.dead_letter.messages_table.headers.job_class") %></th>
-          <th class="px-4 py-3 text-left text-xs font-medium uppercase text-gray-500"><%= t("pgbus.dead_letter.messages_table.headers.source_queue") %></th>
-          <th class="px-4 py-3 text-left text-xs font-medium uppercase text-gray-500"><%= t("pgbus.dead_letter.messages_table.headers.enqueued") %></th>
-          <th class="px-4 py-3 text-left text-xs font-medium uppercase text-gray-500"><%= t("pgbus.dead_letter.messages_table.headers.reads") %></th>
+          <% %w[id job source_queue died attempts reason].each do |header| %>
+            <th class="px-4 py-3 text-left text-xs font-medium uppercase text-gray-500 dark:text-gray-400"><%= t("pgbus.dead_letter.messages_table.headers.#{header}") %></th>
+          <% end %>
+          <th class="px-4 py-3 text-right text-xs font-medium uppercase text-gray-500 dark:text-gray-400"><%= t("pgbus.dead_letter.messages_table.headers.actions") %></th>
         </tr>
       </thead>
       <tbody class="divide-y divide-gray-100 dark:divide-gray-700">
-        <% @messages.each do |m| %>
-          <% payload = pgbus_parse_message(m[:message]) %>
-          <% source_queue = m[:queue_name].to_s.delete_suffix(Pgbus::DEAD_LETTER_SUFFIX) %>
-          <tr>
-            <td class="w-10 px-4 py-3 align-top">
-              <input type="checkbox" data-bulk-item data-pgbus-action="bulk-row-toggle"
-                     aria-label="<%= t("pgbus.helpers.bulk_select_row", id: m[:msg_id]) %>"
-                     data-queue-name="<%= m[:queue_name] %>" data-msg-id="<%= m[:msg_id] %>"
-                     class="h-4 w-4 rounded border-gray-300 text-indigo-600 focus:ring-indigo-600 mt-1">
-              <input type="hidden" name="messages[][queue_name]" value="<%= m[:queue_name] %>" form="bulk-discard-dlq-form" disabled>
-              <input type="hidden" name="messages[][msg_id]" value="<%= m[:msg_id] %>" form="bulk-discard-dlq-form" disabled>
-            </td>
-            <td colspan="5" class="p-0">
-              <details class="group">
-                <summary class="flex cursor-pointer hover:bg-gray-50 dark:hover:bg-gray-700/50 dark:bg-gray-900 list-none">
-                  <span class="w-16 shrink-0 px-4 py-3 text-sm font-mono text-gray-900 dark:text-white"><%= m[:msg_id] %></span>
-                  <span class="flex-1 px-4 py-3 text-sm font-medium text-gray-900 dark:text-white"><%= payload["job_class"] || "—" %></span>
-                  <span class="w-40 shrink-0 px-4 py-3 text-sm text-gray-700"><%= source_queue %></span>
-                  <span class="w-28 shrink-0 px-4 py-3 text-sm text-gray-500"><%= pgbus_time_ago(m[:enqueued_at]) %></span>
-                  <span class="w-16 shrink-0 px-4 py-3 text-sm text-gray-500"><%= m[:read_ct] %></span>
-                </summary>
-                <div class="px-4 pb-4 bg-gray-50 dark:bg-gray-900 border-t border-gray-100">
-                  <div class="flex items-center justify-between mt-3 mb-3">
-                    <span class="text-xs font-mono text-gray-400"><%= t("pgbus.dead_letter.messages_table.job_id") %> <%= payload["job_id"] %></span>
-                    <div class="flex space-x-2">
-                      <%= button_to t("pgbus.dead_letter.messages_table.retry"), pgbus.retry_dead_letter_path(m[:msg_id], queue_name: m[:queue_name]), method: :post,
-                            class: "rounded-md bg-indigo-600 px-3 py-1.5 text-xs font-medium text-white hover:bg-indigo-500",
-                            data: { turbo_frame: "_top" } %>
-                      <%= button_to t("pgbus.dead_letter.messages_table.discard"), pgbus.discard_dead_letter_path(m[:msg_id], queue_name: m[:queue_name]), method: :post,
-                            class: "rounded-md bg-red-600 px-3 py-1.5 text-xs font-medium text-white hover:bg-red-500",
-                            data: { turbo_confirm: t("pgbus.dead_letter.messages_table.discard_confirm"), turbo_frame: "_top" } %>
-                    </div>
-                  </div>
-                  <div class="grid grid-cols-2 gap-4 mb-3">
-                    <div>
-                      <span class="text-xs font-medium text-gray-500"><%= t("pgbus.dead_letter.messages_table.arguments") %></span>
-                      <pre class="text-xs text-gray-700 bg-white dark:bg-gray-800 rounded p-2 mt-1 overflow-x-auto max-h-40"><%= JSON.pretty_generate(payload["arguments"] || []) rescue "—" %></pre>
-                    </div>
-                    <div>
-                      <span class="text-xs font-medium text-gray-500"><%= t("pgbus.dead_letter.messages_table.metadata") %></span>
-                      <div class="text-xs text-gray-600 bg-white dark:bg-gray-800 rounded p-2 mt-1 space-y-1">
-                        <% if payload["queue_name"] %><p><strong><%= t("pgbus.dead_letter.messages_table.metadata_labels.queue") %></strong> <%= payload["queue_name"] %></p><% end %>
-                        <% if payload["priority"] %><p><strong><%= t("pgbus.dead_letter.messages_table.metadata_labels.priority") %></strong> <%= payload["priority"] %></p><% end %>
-                        <% if payload["executions"] %><p><strong><%= t("pgbus.dead_letter.messages_table.metadata_labels.executions") %></strong> <%= payload["executions"] %></p><% end %>
-                        <% if m[:vt] %><p><strong><%= t("pgbus.dead_letter.messages_table.metadata_labels.visible_at") %></strong> <%= m[:vt] %></p><% end %>
-                        <% if m[:last_read_at] %><p><strong><%= t("pgbus.dead_letter.messages_table.metadata_labels.last_read") %></strong> <%= m[:last_read_at] %></p><% end %>
-                      </div>
-                    </div>
-                  </div>
-                  <details class="mt-2">
-                    <summary class="text-xs font-medium text-gray-500 cursor-pointer hover:text-gray-700"><%= t("pgbus.dead_letter.messages_table.full_json_payload") %></summary>
-                    <pre class="text-xs text-gray-600 bg-white dark:bg-gray-800 rounded p-2 mt-1 overflow-x-auto max-h-96"><%= JSON.pretty_generate(payload) rescue m[:message] %></pre>
-                  </details>
-                  <% if m[:headers] %>
-                    <details class="mt-2">
-                      <summary class="text-xs font-medium text-gray-500 cursor-pointer hover:text-gray-700"><%= t("pgbus.dead_letter.messages_table.headers_section") %></summary>
-                      <pre class="text-xs text-gray-600 bg-white dark:bg-gray-800 rounded p-2 mt-1 overflow-x-auto"><%= JSON.pretty_generate(JSON.parse(m[:headers])) rescue m[:headers] %></pre>
-                    </details>
-                  <% end %>
-                </div>
-              </details>
-            </td>
-          </tr>
+        <% @dlq_rows.each do |m, reason| %>
+          <%= render "pgbus/dead_letter/row", m: m, reason: reason, columns: columns %>
         <% end %>
         <% if @messages.empty? %>
-          <tr><td colspan="6" class="px-4 py-8 text-center text-sm text-gray-400"><%= t("pgbus.dead_letter.messages_table.empty") %></td></tr>
+          <%# No rows means no checkbox column. %>
+          <%= render "pgbus/shared/empty_row", colspan: columns, message: t("pgbus.dead_letter.messages_table.empty") %>
         <% end %>
       </tbody>
     </table>
-    <% if @total_count && @total_count > 0 %>
-      <div class="flex items-center justify-between border-t border-gray-200 dark:border-gray-700 px-4 py-3">
-        <p class="text-sm text-gray-500 dark:text-gray-400">
-          <% from = (@page - 1) * @per_page + 1 %>
-          <% to = [from + @messages.size - 1, @total_count].min %>
-          <%= t("pgbus.helpers.pagination.showing", from: from, to: to, total: @total_count) %>
-        </p>
-        <% if @total_pages > 1 %>
-          <nav class="inline-flex rounded-lg shadow-sm" role="navigation" aria-label="Pagination">
-            <% if @page > 1 %>
-              <%= link_to t("pgbus.helpers.pagination.previous"), pgbus.dead_letter_index_path(page: @page - 1),
-                    class: "px-3 py-1.5 text-xs font-medium border border-gray-300 dark:border-gray-600 rounded-l-lg bg-white dark:bg-gray-800 text-gray-700 dark:text-gray-300 hover:bg-gray-50 dark:hover:bg-gray-700" %>
-            <% else %>
-              <span class="px-3 py-1.5 text-xs font-medium border border-gray-300 dark:border-gray-600 rounded-l-lg bg-gray-100 dark:bg-gray-900 text-gray-400 dark:text-gray-600 cursor-not-allowed"><%= t("pgbus.helpers.pagination.previous") %></span>
-            <% end %>
-            <% if @page < @total_pages %>
-              <%= link_to t("pgbus.helpers.pagination.next"), pgbus.dead_letter_index_path(page: @page + 1),
-                    class: "-ml-px px-3 py-1.5 text-xs font-medium border border-gray-300 dark:border-gray-600 rounded-r-lg bg-white dark:bg-gray-800 text-gray-700 dark:text-gray-300 hover:bg-gray-50 dark:hover:bg-gray-700" %>
-            <% else %>
-              <span class="-ml-px px-3 py-1.5 text-xs font-medium border border-gray-300 dark:border-gray-600 rounded-r-lg bg-gray-100 dark:bg-gray-900 text-gray-400 dark:text-gray-600 cursor-not-allowed"><%= t("pgbus.helpers.pagination.next") %></span>
-            <% end %>
-          </nav>
-        <% end %>
-      </div>
-    <% end %>
+    <%= render "pgbus/shared/pager", page: @page, per_page: @per_page, shown: @messages.size, total_count: @total_count.to_i,
+          page_path: ->(n) { @list_path.call(page: n) } %>
   </div>
 </turbo-frame>

data/app/views/pgbus/dead_letter/_row.html.erb

@@ -0,0 +1,75 @@
+<%# One dead-letter message plus its expansion row. Locals: m (a
+    DataSource#dlq_messages hash), reason (its DeadLetterReason::Result),
+    columns. %>
+<% payload = pgbus_parse_message(m[:message]) %>
+<tr class="hover:bg-gray-50 dark:hover:bg-gray-700/50" data-dlq-row="<%= m[:msg_id] %>">
+  <td class="w-10 px-4 py-3 align-top">
+    <input type="checkbox" data-bulk-item data-pgbus-action="bulk-row-toggle"
+           aria-label="<%= t("pgbus.helpers.bulk_select_row", id: m[:msg_id]) %>"
+           data-queue-name="<%= m[:queue_name] %>" data-msg-id="<%= m[:msg_id] %>"
+           class="h-4 w-4 rounded border-gray-300 text-indigo-600 dark:text-indigo-400 focus:ring-indigo-600 mt-1">
+    <input type="hidden" name="messages[][queue_name]" value="<%= m[:queue_name] %>" form="bulk-discard-dlq-form" disabled>
+    <input type="hidden" name="messages[][msg_id]" value="<%= m[:msg_id] %>" form="bulk-discard-dlq-form" disabled>
+  </td>
+  <td data-label="<%= t("pgbus.dead_letter.messages_table.headers.id") %>" class="px-4 py-3 text-sm font-mono text-gray-900 dark:text-white align-top">
+    <details data-job-toggle class="group">
+      <summary class="cursor-pointer list-none text-indigo-600 hover:text-indigo-800 dark:hover:text-indigo-300 dark:text-indigo-400"><%= m[:msg_id] %></summary>
+    </details>
+  </td>
+  <td data-label="<%= t("pgbus.dead_letter.messages_table.headers.job") %>" class="px-4 py-3 text-sm font-medium text-gray-900 dark:text-white align-top"><%= pgbus_dead_letter_job(m[:message]) %></td>
+  <td data-label="<%= t("pgbus.dead_letter.messages_table.headers.source_queue") %>" class="px-4 py-3 text-sm text-gray-700 dark:text-gray-200 align-top"><%= reason.source_queue %></td>
+  <td data-label="<%= t("pgbus.dead_letter.messages_table.headers.died") %>" class="px-4 py-3 text-sm text-gray-500 dark:text-gray-400 align-top"><%= pgbus_time(reason.died_at) %></td>
+  <td data-label="<%= t("pgbus.dead_letter.messages_table.headers.attempts") %>" class="px-4 py-3 text-sm text-gray-500 dark:text-gray-400 align-top"><%= pgbus_dead_letter_attempts(reason) %></td>
+  <td data-label="<%= t("pgbus.dead_letter.messages_table.headers.reason") %>" class="px-4 py-3 text-sm text-gray-700 dark:text-gray-200 align-top" data-testid="dlq-reason">
+    <%= pgbus_dead_letter_reason(reason, filter_path: @list_path) %>
+  </td>
+  <td data-label="<%= t("pgbus.dead_letter.messages_table.headers.actions") %>" class="px-4 py-3 text-sm text-right align-top">
+    <div class="flex justify-end space-x-2">
+      <%= pgbus_button_to t("pgbus.dead_letter.messages_table.retry"), pgbus.retry_dead_letter_path(m[:msg_id], queue_name: m[:queue_name]), method: :post,
+            variant: :link, size: :sm,
+            data: { turbo_frame: "_top" } %>
+      <%= pgbus_button_to t("pgbus.dead_letter.messages_table.discard"), pgbus.discard_dead_letter_path(m[:msg_id], queue_name: m[:queue_name]), method: :post,
+            variant: :link, size: :sm, tone: :red,
+            data: { turbo_confirm: t("pgbus.dead_letter.messages_table.discard_confirm"), turbo_frame: "_top" } %>
+    </div>
+  </td>
+</tr>
+<tr class="pgbus-job-detail" data-job-detail data-dlq-detail="<%= m[:msg_id] %>">
+  <td colspan="<%= columns %>" class="px-4 pb-4 bg-gray-50 dark:bg-gray-900 border-t border-gray-100 dark:border-gray-700">
+    <div class="flex items-center justify-between mt-3 mb-3">
+      <span class="text-xs font-mono text-gray-500 dark:text-gray-400"><%= t("pgbus.dead_letter.messages_table.job_id") %> <%= payload["job_id"] || payload["event_id"] || "—" %></span>
+      <%= pgbus_link_to t("pgbus.dead_letter.messages_table.view"), pgbus.dead_letter_path(m[:msg_id], queue_name: m[:queue_name]),
+            size: :sm, data: { turbo_frame: "_top" } %>
+    </div>
+    <%= render "pgbus/dead_letter/error", reason: reason %>
+    <div class="grid grid-cols-1 lg:grid-cols-2 gap-4 mb-3">
+      <div>
+        <span class="text-xs font-medium text-gray-500 dark:text-gray-400"><%= t("pgbus.dead_letter.messages_table.arguments") %></span>
+        <pre class="text-xs text-gray-700 dark:text-gray-200 bg-white dark:bg-gray-800 rounded p-2 mt-1 overflow-x-auto max-h-40"><%= JSON.pretty_generate(payload["arguments"] || payload["payload"] || []) rescue "—" %></pre>
+      </div>
+      <div>
+        <span class="text-xs font-medium text-gray-500 dark:text-gray-400"><%= t("pgbus.dead_letter.messages_table.metadata") %></span>
+        <div class="text-xs text-gray-600 dark:text-gray-300 bg-white dark:bg-gray-800 rounded p-2 mt-1 space-y-1">
+          <p><strong><%= t("pgbus.dead_letter.detail.dlq") %></strong> <%= m[:queue_name] %></p>
+          <% if reason.source %><p><strong><%= t("pgbus.dead_letter.detail.source") %></strong> <%= t("pgbus.dead_letter.detail.sources.#{reason.source}", default: reason.source) %></p><% end %>
+          <p><strong><%= t("pgbus.dead_letter.detail.died") %></strong> <%= pgbus_timestamp(reason.died_at) %></p>
+          <% if payload["queue_name"] %><p><strong><%= t("pgbus.dead_letter.messages_table.metadata_labels.queue") %></strong> <%= payload["queue_name"] %></p><% end %>
+          <% if payload["priority"] %><p><strong><%= t("pgbus.dead_letter.messages_table.metadata_labels.priority") %></strong> <%= payload["priority"] %></p><% end %>
+          <% if payload["executions"] %><p><strong><%= t("pgbus.dead_letter.messages_table.metadata_labels.executions") %></strong> <%= payload["executions"] %></p><% end %>
+          <% if m[:vt] %><p><strong><%= t("pgbus.dead_letter.messages_table.metadata_labels.visible_at") %></strong> <%= pgbus_timestamp(m[:vt]) %></p><% end %>
+          <% if m[:last_read_at] %><p><strong><%= t("pgbus.dead_letter.messages_table.metadata_labels.last_read") %></strong> <%= pgbus_timestamp(m[:last_read_at]) %></p><% end %>
+        </div>
+      </div>
+    </div>
+    <details class="mt-2">
+      <summary class="text-xs font-medium text-gray-500 dark:text-gray-400 cursor-pointer hover:text-gray-700 dark:hover:text-gray-200"><%= t("pgbus.dead_letter.messages_table.full_json_payload") %></summary>
+      <pre class="text-xs text-gray-600 dark:text-gray-300 bg-white dark:bg-gray-800 rounded p-2 mt-1 overflow-x-auto max-h-96"><%= JSON.pretty_generate(payload) rescue m[:message] %></pre>
+    </details>
+    <% if m[:headers] %>
+      <details class="mt-2">
+        <summary class="text-xs font-medium text-gray-500 dark:text-gray-400 cursor-pointer hover:text-gray-700 dark:hover:text-gray-200"><%= t("pgbus.dead_letter.messages_table.headers_section") %></summary>
+        <pre class="text-xs text-gray-600 dark:text-gray-300 bg-white dark:bg-gray-800 rounded p-2 mt-1 overflow-x-auto"><%= JSON.pretty_generate(JSON.parse(m[:headers])) rescue m[:headers] %></pre>
+      </details>
+    <% end %>
+  </td>
+</tr>

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

@@ -4,17 +4,14 @@
     <div class="flex items-center space-x-2">
       <div data-bulk-actions class="hidden flex items-center space-x-2">
         <span class="text-sm text-gray-500 dark:text-gray-400"><span data-bulk-count>0</span> <%= t("pgbus.helpers.bulk_selected") %></span>
-        <button type="submit" form="bulk-discard-dlq-form"
-                class="rounded-md bg-red-600 px-3 py-2 text-sm font-medium text-white hover:bg-red-500"
-                data-turbo-confirm="<%= t("pgbus.dead_letter.index.discard_selected_confirm") %>">
-          <%= t("pgbus.dead_letter.index.discard_selected") %>
-        </button>
+        <%= pgbus_button_tag t("pgbus.dead_letter.index.discard_selected"), variant: :danger, form: "bulk-discard-dlq-form",
+              confirm: t("pgbus.dead_letter.index.discard_selected_confirm") %>
       </div>
-      <%= button_to t("pgbus.dead_letter.index.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",
+      <%= pgbus_button_to t("pgbus.dead_letter.index.retry_all"), pgbus.retry_all_dead_letter_index_path, method: :post,
+            variant: :primary,
             data: { turbo_confirm: t("pgbus.dead_letter.index.retry_all_confirm") } %>
-      <%= button_to t("pgbus.dead_letter.index.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",
+      <%= pgbus_button_to t("pgbus.dead_letter.index.discard_all"), pgbus.discard_all_dead_letter_index_path, method: :post,
+            variant: :danger,
             data: { turbo_confirm: t("pgbus.dead_letter.index.discard_all_confirm") } %>
     </div>
   <% end %>

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

@@ -1,40 +1,56 @@
 <div class="mb-6">
-  <%= link_to "\u2190 #{t("pgbus.dead_letter.show.back")}", pgbus.dead_letter_index_path, class: "text-sm text-indigo-600 hover:text-indigo-500" %>
+  <%= pgbus_link_to "\u2190 #{t("pgbus.dead_letter.show.back")}", pgbus.dead_letter_index_path %>
 </div>
 
 <% if @message %>
   <h1 class="text-2xl font-bold text-gray-900 dark:text-white mb-6"><%= t("pgbus.dead_letter.show.title", id: @message[:msg_id]) %></h1>
 
+  <div class="rounded-lg bg-white dark:bg-gray-800 shadow ring-1 ring-gray-200 dark:ring-gray-700 p-6 mb-6" data-testid="dead-letter-reason">
+    <h2 class="text-sm font-medium text-gray-500 dark:text-gray-400 mb-2"><%= t("pgbus.dead_letter.detail.why") %></h2>
+    <p class="text-sm text-gray-900 dark:text-white mb-3"><%= pgbus_dead_letter_reason(@reason) %></p>
+    <%= render "pgbus/dead_letter/error", reason: @reason %>
+    <dl class="grid grid-cols-1 gap-4 sm:grid-cols-3">
+      <div>
+        <dt class="text-sm font-medium text-gray-500 dark:text-gray-400"><%= t("pgbus.dead_letter.show.labels.source_queue") %></dt>
+        <dd class="text-sm text-gray-900 dark:text-white"><%= @reason.source_queue %></dd>
+      </div>
+      <div>
+        <dt class="text-sm font-medium text-gray-500 dark:text-gray-400"><%= t("pgbus.dead_letter.show.labels.attempts") %></dt>
+        <dd class="text-sm text-gray-900 dark:text-white"><%= pgbus_dead_letter_attempts(@reason) %></dd>
+      </div>
+      <div>
+        <dt class="text-sm font-medium text-gray-500 dark:text-gray-400"><%= t("pgbus.dead_letter.show.labels.died") %></dt>
+        <dd class="text-sm text-gray-900 dark:text-white"><%= pgbus_timestamp(@reason.died_at) %></dd>
+      </div>
+    </dl>
+  </div>
+
   <div class="rounded-lg bg-white dark:bg-gray-800 shadow ring-1 ring-gray-200 dark:ring-gray-700 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"><%= t("pgbus.dead_letter.show.labels.source_queue") %></dt>
+        <dt class="text-sm font-medium text-gray-500 dark:text-gray-400"><%= t("pgbus.dead_letter.show.labels.dlq") %></dt>
         <dd class="text-sm text-gray-900 dark:text-white"><%= @message[:queue_name] %></dd>
       </div>
       <div>
-        <dt class="text-sm font-medium text-gray-500"><%= t("pgbus.dead_letter.show.labels.enqueued_at") %></dt>
-        <dd class="text-sm text-gray-900 dark:text-white"><%= @message[:enqueued_at] %></dd>
-      </div>
-      <div>
-        <dt class="text-sm font-medium text-gray-500"><%= t("pgbus.dead_letter.show.labels.read_count") %></dt>
-        <dd class="text-sm text-gray-900 dark:text-white"><%= @message[:read_ct] %></dd>
+        <dt class="text-sm font-medium text-gray-500 dark:text-gray-400"><%= t("pgbus.dead_letter.show.labels.enqueued_at") %></dt>
+        <dd class="text-sm text-gray-900 dark:text-white"><%= pgbus_timestamp(@message[:enqueued_at]) %></dd>
       </div>
       <div>
-        <dt class="text-sm font-medium text-gray-500"><%= t("pgbus.dead_letter.show.labels.visibility_timeout") %></dt>
-        <dd class="text-sm text-gray-900 dark:text-white"><%= @message[:vt] %></dd>
+        <dt class="text-sm font-medium text-gray-500 dark:text-gray-400"><%= t("pgbus.dead_letter.show.labels.visibility_timeout") %></dt>
+        <dd class="text-sm text-gray-900 dark:text-white"><%= pgbus_timestamp(@message[:vt]) %></dd>
       </div>
     </dl>
   </div>
 
   <% if (context = pgbus_job_context(@message[:message])) %>
     <div class="rounded-lg bg-white dark:bg-gray-800 shadow ring-1 ring-gray-200 dark:ring-gray-700 p-6 mb-6" data-testid="job-context">
-      <h2 class="text-sm font-medium text-gray-500 mb-2"><%= t("pgbus.dead_letter.show.context") %></h2>
+      <h2 class="text-sm font-medium text-gray-500 dark:text-gray-400 mb-2"><%= t("pgbus.dead_letter.show.context") %></h2>
       <% context.each do |klass_name, attrs| %>
         <h3 class="text-xs font-semibold text-gray-700 dark:text-gray-300 mt-3 mb-1 font-mono"><%= klass_name %></h3>
         <dl class="grid grid-cols-1 gap-x-4 gap-y-1 sm:grid-cols-2">
           <% attrs.each do |name, value| %>
             <div class="flex gap-2 text-xs">
-              <dt class="text-gray-500 font-mono"><%= name %></dt>
+              <dt class="text-gray-500 dark:text-gray-400 font-mono"><%= name %></dt>
               <dd class="text-gray-900 dark:text-white font-mono break-all"><%= value %></dd>
             </div>
           <% end %>
@@ -44,26 +60,26 @@
   <% end %>
 
   <div class="rounded-lg bg-white dark:bg-gray-800 shadow ring-1 ring-gray-200 dark:ring-gray-700 p-6 mb-6">
-    <h2 class="text-sm font-medium text-gray-500 mb-2"><%= t("pgbus.dead_letter.show.payload") %></h2>
-    <pre class="text-xs text-gray-600 bg-gray-50 dark:bg-gray-900 rounded p-4 overflow-x-auto"><%= JSON.pretty_generate(JSON.parse(@message[:message])) rescue @message[:message] %></pre>
+    <h2 class="text-sm font-medium text-gray-500 dark:text-gray-400 mb-2"><%= t("pgbus.dead_letter.show.payload") %></h2>
+    <pre tabindex="0" class="text-xs text-gray-600 dark:text-gray-300 bg-gray-50 dark:bg-gray-900 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 dark:bg-gray-800 shadow ring-1 ring-gray-200 dark:ring-gray-700 p-6 mb-6">
-      <h2 class="text-sm font-medium text-gray-500 mb-2"><%= t("pgbus.dead_letter.show.headers") %></h2>
-      <pre class="text-xs text-gray-600 bg-gray-50 dark:bg-gray-900 rounded p-4 overflow-x-auto"><%= JSON.pretty_generate(JSON.parse(@message[:headers])) rescue @message[:headers] %></pre>
+      <h2 class="text-sm font-medium text-gray-500 dark:text-gray-400 mb-2"><%= t("pgbus.dead_letter.show.headers") %></h2>
+      <pre tabindex="0" class="text-xs text-gray-600 dark:text-gray-300 bg-gray-50 dark:bg-gray-900 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 t("pgbus.dead_letter.show.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 t("pgbus.dead_letter.show.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",
+    <%= pgbus_button_to t("pgbus.dead_letter.show.retry"), pgbus.retry_dead_letter_path(@message[:msg_id], queue_name: @message[:queue_name]), method: :post,
+          variant: :primary %>
+    <%= pgbus_button_to t("pgbus.dead_letter.show.discard"), pgbus.discard_dead_letter_path(@message[:msg_id], queue_name: @message[:queue_name]), method: :post,
+          variant: :danger,
           data: { turbo_confirm: t("pgbus.dead_letter.show.discard_confirm") } %>
   </div>
 <% else %>
   <div class="text-center py-12">
-    <p class="text-gray-400"><%= t("pgbus.dead_letter.show.not_found") %></p>
+    <p class="text-gray-500 dark:text-gray-400"><%= t("pgbus.dead_letter.show.not_found") %></p>
   </div>
 <% end %>

data/app/views/pgbus/events/_list.html.erb

@@ -0,0 +1,55 @@
+<%# Pending events (issue #494): the unified job list scoped to the EventBus
+    handler queues. Each row's state comes from SQL, EventState adds the
+    reason; a row's expansion is the <tr> after it (.pgbus-job-detail in
+    tailwind.css), so the auto-refresh pause on `details[open]` keeps working.
+    Orphaned failed rows (message gone) are discarded through their failed
+    event and take no part in the bulk selection. %>
+<% selectable = @rows.any? { |r| r[:source] == "queue" } %>
+<% columns = selectable ? 8 : 7 %>
+<turbo-frame id="events-list" data-auto-refresh data-turbo-action="advance"
+             data-src="<%= events_list_path(frame: "list") %>">
+  <div data-bulk-page>
+    <div class="flex items-center justify-end mb-3 space-x-2">
+      <div data-bulk-actions class="hidden flex items-center space-x-2">
+        <span class="text-sm text-gray-500 dark:text-gray-400"><span data-bulk-count>0</span> <%= t("pgbus.helpers.bulk_selected") %></span>
+        <%= pgbus_button_tag t("pgbus.events.list.discard_selected"), variant: :danger, form: "bulk-discard-events-form",
+              confirm: t("pgbus.events.list.discard_selected_confirm") %>
+      </div>
+    </div>
+    <%# Bulk form outside the table to avoid nested forms. %>
+    <form id="bulk-discard-events-form" action="<%= pgbus.discard_selected_events_path %>" method="post" data-turbo-frame="_top" class="hidden">
+      <%= hidden_field_tag :authenticity_token, form_authenticity_token %>
+    </form>
+    <div class="overflow-hidden rounded-lg bg-white dark:bg-gray-800 shadow ring-1 ring-gray-200 dark:ring-gray-700" data-bulk-scope="events">
+      <table class="pgbus-table min-w-full divide-y divide-gray-200 dark:divide-gray-700">
+        <thead class="bg-gray-50 dark:bg-gray-900">
+          <tr>
+            <% if selectable %>
+              <th class="w-10 px-4 py-3">
+                <input type="checkbox" data-bulk-select-all
+                       aria-label="<%= t("pgbus.helpers.bulk_select_all") %>"
+                       class="h-4 w-4 rounded border-gray-300 text-indigo-600 dark:text-indigo-400 focus:ring-indigo-600">
+              </th>
+            <% end %>
+            <% %w[id event handler state attempts reason].each do |header| %>
+              <th class="px-4 py-3 text-left text-xs font-medium uppercase text-gray-500 dark:text-gray-400"><%= t("pgbus.events.list.headers.#{header}") %></th>
+            <% end %>
+            <th class="px-4 py-3 text-right text-xs font-medium uppercase text-gray-500 dark:text-gray-400"><%= t("pgbus.events.list.headers.actions") %></th>
+          </tr>
+        </thead>
+        <tbody class="divide-y divide-gray-100 dark:divide-gray-700">
+          <% @rows.each do |row| %>
+            <% event = Pgbus::Web::EventState.present(row, @state_context, ahead: @ahead[[row[:queue_name], row[:msg_id]]]) %>
+            <%= render "pgbus/events/row", row: row, event: event, selectable: selectable, columns: columns %>
+          <% end %>
+          <% if @rows.empty? %>
+            <%= render "pgbus/shared/empty_row", colspan: columns, message: t("pgbus.events.list.empty.#{@state}") %>
+          <% end %>
+        </tbody>
+      </table>
+      <%= render "pgbus/shared/pager", page: @page, per_page: @per_page, shown: @rows.size,
+            total_count: @counts[@state], has_more: @counts.capped?(@state) && @rows.size == @per_page,
+            page_path: ->(n) { events_list_path(page: n) } %>
+    </div>
+  </div>
+</turbo-frame>

data/app/views/pgbus/events/_processed_table.html.erb

@@ -0,0 +1,45 @@
+<%# Processed events (issue #494): the pgbus_processed_events audit, each
+    claim in words (completed, being handled, went silent) and a Replay where
+    the handler is still registered and the archive still holds the event.
+    Pages on processed_page, so the pending list keeps its own page. %>
+<turbo-frame id="processed-events" data-auto-refresh data-turbo-action="advance"
+             data-src="<%= events_list_path(frame: "processed") %>">
+  <div class="overflow-hidden rounded-lg bg-white dark:bg-gray-800 shadow ring-1 ring-gray-200 dark:ring-gray-700">
+    <table class="pgbus-table min-w-full divide-y divide-gray-200 dark:divide-gray-700">
+      <thead class="bg-gray-50 dark:bg-gray-900">
+        <tr>
+          <% %w[event_id handler state reason].each do |header| %>
+            <th class="px-4 py-3 text-left text-xs font-medium uppercase text-gray-500 dark:text-gray-400"><%= t("pgbus.events.processed.headers.#{header}") %></th>
+          <% end %>
+          <th class="px-4 py-3 text-right text-xs font-medium uppercase text-gray-500 dark:text-gray-400"><%= t("pgbus.events.processed.headers.actions") %></th>
+        </tr>
+      </thead>
+      <tbody class="divide-y divide-gray-100 dark:divide-gray-700">
+        <% now = Time.now %>
+        <% @events.each do |e| %>
+          <% claim = Pgbus::Web::EventState.processed(e, now: now, claim_window: @claim_window) %>
+          <tr class="hover:bg-gray-50 dark:hover:bg-gray-700/50" data-processed-event data-state="<%= claim.state %>">
+            <td data-label="<%= t("pgbus.events.processed.headers.event_id") %>" class="px-4 py-3 text-sm font-mono">
+              <%= pgbus_link_to e["event_id"], pgbus.event_path(e["id"]), variant: :link, size: :sm, data: { turbo_frame: "_top" } %>
+            </td>
+            <td data-label="<%= t("pgbus.events.processed.headers.handler") %>" class="px-4 py-3 text-sm text-gray-700 dark:text-gray-200"><%= e["handler_class"] %></td>
+            <td data-label="<%= t("pgbus.events.processed.headers.state") %>" class="px-4 py-3 text-sm"><%= pgbus_processed_event_badge(claim) %></td>
+            <td data-label="<%= t("pgbus.events.processed.headers.reason") %>" class="px-4 py-3 text-sm text-gray-700 dark:text-gray-200"><%= pgbus_processed_event_reason(claim) %></td>
+            <td data-label="<%= t("pgbus.events.processed.headers.actions") %>" class="px-4 py-3 text-sm text-right">
+              <%# An unfinished claim's message is still in its queue: nothing to replay yet. %>
+              <% if claim.state == "completed" %>
+                <%= render "pgbus/events/replay", event: e, replay_state: @replay_states[e["id"]] %>
+              <% end %>
+            </td>
+          </tr>
+        <% end %>
+        <% if @events.empty? %>
+          <%= render "pgbus/shared/empty_row", colspan: 5, message: t("pgbus.events.processed.empty") %>
+        <% end %>
+      </tbody>
+    </table>
+    <%= render "pgbus/shared/pager", page: @processed_page, per_page: @per_page, shown: @events.size,
+          total_count: @processed_count.total, has_more: @processed_count.capped? && @events.size == @per_page,
+          page_path: ->(n) { events_list_path(processed_page: n) } %>
+  </div>
+</turbo-frame>

data/app/views/pgbus/events/_replay.html.erb

@@ -0,0 +1,10 @@
+<%# Replay for one processed event, or in words why there is none. Locals:
+    event (a pgbus_processed_events row), replay_state (:replayable,
+    :not_archived or :no_handler, from DataSource#event_replay_states). %>
+<% if replay_state == :replayable %>
+  <%= pgbus_button_to t("pgbus.events.processed.replay"), pgbus.replay_event_path(event["id"]),
+        method: :post, variant: :link, size: :sm,
+        data: { turbo_confirm: t("pgbus.events.processed.replay_confirm"), turbo_frame: "_top" } %>
+<% else %>
+  <span class="text-xs text-gray-600 dark:text-gray-300"><%= t("pgbus.events.processed.replay_unavailable.#{replay_state || :not_archived}") %></span>
+<% end %>