roundhouse_ui 0.1.0

data/app/views/roundhouse_ui/jobs/show.html.erb

@@ -0,0 +1,33 @@
+<% content_for :title, @entry.item["class"] %>
+<% item = @entry.item %>
+
+<div class="rh-tags">
+  <span class="rh-tag"><%= @set %></span>
+  <span class="rh-tag">queue <%= @entry.queue %></span>
+  <% if item["retry_count"] %><span class="rh-tag">retry <%= item["retry_count"] %></span><% end %>
+  <span class="rh-tag rh-mono"><%= @entry.jid %></span>
+</div>
+
+<div class="rh-sec">Arguments<% if RoundhouseUi.redact_args.present? %> <span class="rh-sub">— sensitive keys masked</span><% end %></div>
+<pre class="rh-pre"><%= JSON.pretty_generate(RoundhouseUi::Redaction.apply(item["args"] || [])) %></pre>
+
+<% if item["error_class"].present? %>
+  <div class="rh-sec">Error</div>
+  <div class="rh-err"><%= item["error_class"] %></div>
+  <% if item["error_message"].present? %><p class="rh-sub" style="margin:6px 0 0"><%= item["error_message"] %></p><% end %>
+  <% bt = item["error_backtrace"] %>
+  <% if bt.is_a?(Array) && bt.any? %>
+    <pre class="rh-pre"><%= bt.first(20).join("\n") %></pre>
+  <% end %>
+<% end %>
+
+<% trace = trace_link(klass: item["class"], jid: @entry.jid, queue: @entry.queue) %>
+<% if trace.present? %>
+  <div class="rh-sec">Observability</div>
+  <%= trace %>
+<% end %>
+
+<div class="rh-pager">
+  <% if RoundhouseUi.allow_job_editing %><%= link_to "Edit", edit_job_path(set: @set, jid: @entry.jid), class: "rh-btn rh-btn-primary" %><% end %>
+  <%= link_to "← Back", { "dead" => dead_set_path, "retry" => retries_path, "scheduled" => scheduled_path }[@set] || root_path, class: "rh-btn" %>
+</div>

data/app/views/roundhouse_ui/metrics/show.html.erb

@@ -0,0 +1,49 @@
+<% content_for :title, "Metrics" %>
+
+<h2 class="rh-h2">Capacity &amp; reliability <span class="hint">live snapshot</span></h2>
+<div class="rh-cards">
+  <div class="rh-card">
+    <div class="k">Utilization</div>
+    <div class="v num" style="<%= "color:var(--warn)" if @metrics.utilization && @metrics.utilization >= 0.9 %>"><%= @metrics.utilization ? "#{(@metrics.utilization * 100).round}%" : "—" %></div>
+    <div class="d"><span class="num"><%= @metrics.busy %></span> / <%= @metrics.concurrency %> threads</div>
+  </div>
+  <div class="rh-card">
+    <div class="k">Idle headroom</div>
+    <div class="v num"><%= @metrics.headroom %></div>
+    <div class="d">worker threads free</div>
+  </div>
+  <div class="rh-card">
+    <div class="k">Backlog</div>
+    <div class="v num"><%= number_with_delimiter @metrics.backlog %></div>
+    <div class="d">enqueued + scheduled + retry</div>
+  </div>
+  <div class="rh-card">
+    <div class="k">Failure ratio</div>
+    <div class="v num"><%= (@metrics.failure_ratio * 100).round(2) %>%</div>
+    <div class="d">failed / processed · lifetime</div>
+  </div>
+</div>
+
+<h2 class="rh-h2">Live rates <span class="hint">computed client-side · last few seconds</span></h2>
+<div class="rh-cards">
+  <div class="rh-card">
+    <div class="k">Throughput</div>
+    <div class="v num" id="rh-m-throughput">—</div>
+    <div class="d">jobs / sec · completed</div>
+  </div>
+  <div class="rh-card">
+    <div class="k">Failure rate</div>
+    <div class="v num" id="rh-m-failrate">—</div>
+    <div class="d">share of recent jobs</div>
+  </div>
+  <div class="rh-card">
+    <div class="k">Backlog velocity</div>
+    <div class="v num" id="rh-m-velocity">—</div>
+    <div class="d">+ growing · − draining</div>
+  </div>
+  <div class="rh-card">
+    <div class="k">Burn-down ETA</div>
+    <div class="v num" id="rh-m-eta">—</div>
+    <div class="d">backlog clears in, at current rate</div>
+  </div>
+</div>

data/app/views/roundhouse_ui/queues/index.html.erb

@@ -0,0 +1,45 @@
+<% content_for :title, "Queues" %>
+
+<% if RoundhouseUi.allow_job_editing %>
+  <div class="rh-toolbar"><%= link_to "+ Enqueue job", new_job_path, class: "rh-btn rh-btn-primary" %></div>
+<% end %>
+
+<% unless @fetch_installed %>
+  <div class="rh-warn">
+    Pausing is <strong>recorded but not enforced</strong> — no Roundhouse fetcher has reported in.
+    Add it to your Sidekiq config: <code>config[:fetch_class] = RoundhouseUi::Fetch</code>
+  </div>
+<% end %>
+
+<h2 class="rh-h2">Queues</h2>
+<table class="rh-table">
+  <thead><tr><th>Queue</th><th>State</th><th class="r">Size</th><th class="r">Latency</th><th class="r">Actions</th></tr></thead>
+  <tbody>
+    <% if @queues.empty? %>
+      <tr><td colspan="5" class="rh-empty">No active queues</td></tr>
+    <% else %>
+      <% @queues.each do |q| %>
+        <% paused = @paused.include?(q.name) %>
+        <tr>
+          <td><%= q.name %></td>
+          <td><% if paused %><span class="rh-pill rh-pill-warn">paused</span><% else %><span class="rh-sub">active</span><% end %></td>
+          <td class="r"><%= number_with_delimiter q.size %></td>
+          <td class="r <%= "rh-lat-warn" if q.latency > 60 %>"><%= q.latency.round(2) %>s</td>
+          <td class="r">
+            <% if paused %>
+              <%= button_to "Resume", resume_queue_path(q.name), method: :post, class: "rh-btn", form_class: "rh-inline" %>
+            <% else %>
+              <%= button_to "Pause", pause_queue_path(q.name), method: :post, class: "rh-btn", form_class: "rh-inline" %>
+            <% end %>
+            <%= button_to "Snapshot", snapshot_queue_path(q.name), method: :post, class: "rh-btn", form_class: "rh-inline" %>
+            <%= button_to "Purge", purge_queue_path(q.name),
+                  method: :post,
+                  class: "rh-btn rh-btn-danger",
+                  form_class: "rh-inline",
+                  data: { turbo_confirm: "Purge “#{q.name}”? This permanently deletes #{number_with_delimiter q.size} jobs. Snapshot first if you might need them back." } %>
+          </td>
+        </tr>
+      <% end %>
+    <% end %>
+  </tbody>
+</table>

data/app/views/roundhouse_ui/redis/show.html.erb

@@ -0,0 +1,59 @@
+<% content_for :title, "Redis" %>
+
+<% policy   = @info["maxmemory_policy"] %>
+<% maxmem   = @info["maxmemory"].to_i %>
+<% used     = @info["used_memory"].to_i %>
+<% evicted  = @info["evicted_keys"].to_i %>
+<% risk     = maxmem.positive? && policy.present? && policy != "noeviction" %>
+<% hits     = @info["keyspace_hits"].to_f %>
+<% misses   = @info["keyspace_misses"].to_f %>
+<% hit_rate = (hits + misses).positive? ? (hits / (hits + misses) * 100).round(1) : 100.0 %>
+<% frag     = @info["mem_fragmentation_ratio"].to_f %>
+<% uptime   = @info["uptime_in_seconds"].to_i %>
+<% keys     = @info.to_a.find { |k, _| k.start_with?("db") }&.last.to_s[/keys=(\d+)/, 1] %>
+
+<% if risk %>
+  <div class="rh-alert">
+    <span class="msg">Eviction policy is <b><%= policy %></b> with a memory cap — Sidekiq jobs can be <strong>evicted and silently lost</strong>. Use <b>noeviction</b> on the Redis that backs Sidekiq.</span>
+  </div>
+<% elsif evicted.positive? %>
+  <div class="rh-alert warn"><span class="msg"><b><%= number_with_delimiter evicted %></b> keys have been evicted on this instance.</span></div>
+<% end %>
+
+<div class="rh-cards">
+  <div class="rh-card">
+    <div class="k">Memory used</div>
+    <div class="v num"><%= @info["used_memory_human"] || number_to_human_size(used) %></div>
+    <div class="d"><%= maxmem.positive? ? "#{(used.to_f / maxmem * 100).round}% of #{number_to_human_size(maxmem)}" : "no cap set" %></div>
+  </div>
+  <div class="rh-card">
+    <div class="k">Ops / sec</div>
+    <div class="v num"><%= number_with_delimiter @info["instantaneous_ops_per_sec"] %></div>
+    <div class="d"><%= number_with_delimiter @info["total_commands_processed"] %> total</div>
+  </div>
+  <div class="rh-card">
+    <div class="k">Clients</div>
+    <div class="v num"><%= @info["connected_clients"] %></div>
+    <div class="d"><%= @info["blocked_clients"] %> blocked</div>
+  </div>
+  <div class="rh-card">
+    <div class="k">Eviction policy</div>
+    <div class="v" style="font-size:18px; color:<%= risk ? "var(--crit)" : "var(--good)" %>"><%= policy || "—" %></div>
+    <div class="d"><%= evicted.positive? ? "#{number_with_delimiter evicted} evicted" : "0 evicted" %></div>
+  </div>
+</div>
+
+<h2 class="rh-h2">Signals <span class="hint">from <span class="rh-mono">INFO</span></span></h2>
+<table class="rh-table">
+  <tbody>
+    <tr><td>Fragmentation ratio</td><td class="r rh-mono <%= "rh-lat-warn" if frag > 1.5 %>"><%= frag.round(2) %>×</td></tr>
+    <tr><td>Evicted keys</td><td class="r rh-mono" style="<%= "color:var(--crit)" if evicted.positive? %>"><%= number_with_delimiter evicted %></td></tr>
+    <tr><td>Expired keys</td><td class="r rh-mono"><%= number_with_delimiter @info["expired_keys"] %></td></tr>
+    <tr><td>Keyspace hit rate</td><td class="r rh-mono"><%= hit_rate %>%</td></tr>
+    <tr><td>Blocked clients</td><td class="r rh-mono"><%= @info["blocked_clients"] %></td></tr>
+    <tr><td>Rejected connections</td><td class="r rh-mono" style="<%= "color:var(--crit)" if @info["rejected_connections"].to_i.positive? %>"><%= @info["rejected_connections"] %></td></tr>
+    <tr><td>Keys (db0)</td><td class="r rh-mono"><%= keys ? number_with_delimiter(keys) : "—" %></td></tr>
+    <tr><td>Uptime</td><td class="r rh-mono"><%= uptime >= 86_400 ? "#{uptime / 86_400}d" : "#{uptime / 3_600}h" %></td></tr>
+    <tr><td>Redis</td><td class="r rh-mono">v<%= @info["redis_version"] %> · <%= @info["role"] %></td></tr>
+  </tbody>
+</table>

data/app/views/roundhouse_ui/retries/index.html.erb

@@ -0,0 +1,33 @@
+<% content_for :title, "Retries" %>
+
+<form method="get" action="<%= retries_path %>" class="rh-search">
+  <input type="search" name="q" value="<%= @query %>" placeholder="search class, jid, error, or arg value…">
+</form>
+
+<h2 class="rh-h2">Retries · <%= number_with_delimiter @total %> jobs</h2>
+<table class="rh-table">
+  <thead><tr><th>Job</th><th>Last error</th><th class="r">Attempt</th><th class="r">Next try</th><th class="r">Actions</th></tr></thead>
+  <tbody>
+    <% if @jobs.empty? %>
+      <tr><td colspan="5" class="rh-empty"><%= @query.present? ? "No retries match “#{@query}”." : "Nothing waiting to retry 🎉" %></td></tr>
+    <% else %>
+      <% @jobs.each do |job| %>
+        <tr>
+          <td><%= link_to job.klass, job_path(set: "retry", jid: job.jid), class: "rh-joblink" %><br><span class="rh-sub"><%= job.jid %></span> <%= trace_link(klass: job.klass, jid: job.jid, queue: job.queue) %></td>
+          <td>
+            <span class="rh-err"><%= job.item["error_class"] %></span>
+            <% if job.item["error_message"].present? %><br><span class="rh-sub"><%= truncate(job.item["error_message"], length: 90) %></span><% end %>
+          </td>
+          <td class="r">#<%= job.item["retry_count"].to_i + 1 %></td>
+          <td class="r"><span class="rh-sub"><%= job.at && job.at > Time.now ? "in #{distance_of_time_in_words(Time.now, job.at)}" : "now" %></span></td>
+          <td class="r">
+            <% if RoundhouseUi.allow_job_editing %><%= link_to "Edit", edit_job_path(set: "retry", jid: job.jid), class: "rh-btn" %><% end %>
+            <%= button_to "Run now", run_retry_path(job.jid), method: :post, class: "rh-btn", form_class: "rh-inline" %>
+            <%= button_to "Delete", delete_retry_path(job.jid), method: :post, class: "rh-btn rh-btn-danger", form_class: "rh-inline", data: { turbo_confirm: "Delete #{job.jid}?" } %>
+          </td>
+        </tr>
+      <% end %>
+    <% end %>
+  </tbody>
+</table>
+<%= render "roundhouse_ui/shared/pager" %>

data/app/views/roundhouse_ui/scheduled/index.html.erb

@@ -0,0 +1,29 @@
+<% content_for :title, "Scheduled" %>
+
+<form method="get" action="<%= scheduled_path %>" class="rh-search">
+  <input type="search" name="q" value="<%= @query %>" placeholder="search class, jid, or arg value…">
+</form>
+
+<h2 class="rh-h2">Scheduled · <%= number_with_delimiter @total %> jobs</h2>
+<table class="rh-table">
+  <thead><tr><th>Job</th><th>Queue</th><th class="r">Runs</th><th class="r">Actions</th></tr></thead>
+  <tbody>
+    <% if @jobs.empty? %>
+      <tr><td colspan="4" class="rh-empty"><%= @query.present? ? "No scheduled jobs match “#{@query}”." : "Nothing scheduled" %></td></tr>
+    <% else %>
+      <% @jobs.each do |job| %>
+        <tr>
+          <td><%= link_to job.klass, job_path(set: "scheduled", jid: job.jid), class: "rh-joblink" %><br><span class="rh-sub"><%= job.jid %></span></td>
+          <td><span class="rh-sub"><%= job.queue %></span></td>
+          <td class="r"><span class="rh-sub"><%= job.at && job.at > Time.now ? "in #{distance_of_time_in_words(Time.now, job.at)}" : "now (overdue)" %></span></td>
+          <td class="r">
+            <% if RoundhouseUi.allow_job_editing %><%= link_to "Edit", edit_job_path(set: "scheduled", jid: job.jid), class: "rh-btn" %><% end %>
+            <%= button_to "Enqueue now", enqueue_scheduled_path(job.jid), method: :post, class: "rh-btn", form_class: "rh-inline" %>
+            <%= button_to "Delete", delete_scheduled_path(job.jid), method: :post, class: "rh-btn rh-btn-danger", form_class: "rh-inline", data: { turbo_confirm: "Delete #{job.jid}?" } %>
+          </td>
+        </tr>
+      <% end %>
+    <% end %>
+  </tbody>
+</table>
+<%= render "roundhouse_ui/shared/pager" %>

data/app/views/roundhouse_ui/shared/_pager.html.erb

@@ -0,0 +1,15 @@
+<% if @page > 1 || @has_next %>
+  <div class="rh-pager">
+    <% if @page > 1 %>
+      <%= link_to "← Prev", url_for(page: @page - 1, q: @query.presence), class: "rh-btn" %>
+    <% else %>
+      <span class="rh-btn" style="opacity:.4; pointer-events:none">← Prev</span>
+    <% end %>
+    <span class="rh-sub">Page <%= @page %></span>
+    <% if @has_next %>
+      <%= link_to "Next →", url_for(page: @page + 1, q: @query.presence), class: "rh-btn" %>
+    <% else %>
+      <span class="rh-btn" style="opacity:.4; pointer-events:none">Next →</span>
+    <% end %>
+  </div>
+<% end %>

data/app/views/roundhouse_ui/snapshots/index.html.erb

@@ -0,0 +1,25 @@
+<% content_for :title, "Snapshots" %>
+
+<h2 class="rh-h2">Snapshots · <%= @snapshots.size %></h2>
+<table class="rh-table">
+  <thead><tr><th>Snapshot</th><th>Queue</th><th class="r">Jobs</th><th class="r">Created</th><th class="r">Actions</th></tr></thead>
+  <tbody>
+    <% if @snapshots.empty? %>
+      <tr><td colspan="5" class="rh-empty">No snapshots yet — snapshot a queue before purging it.</td></tr>
+    <% else %>
+      <% @snapshots.each do |s| %>
+        <tr>
+          <td><span class="rh-sub"><%= s[:id] %></span></td>
+          <td><%= s[:queue] %></td>
+          <td class="r"><%= number_with_delimiter s[:count] %></td>
+          <td class="r"><span class="rh-sub"><%= s[:created_at] ? "#{time_ago_in_words(Time.at(s[:created_at]))} ago" : "—" %></span></td>
+          <td class="r">
+            <%= button_to "Restore", restore_snapshot_path(s[:id]), method: :post, class: "rh-btn", form_class: "rh-inline", data: { turbo_confirm: "Re-enqueue #{number_with_delimiter s[:count]} job(s) onto “#{s[:queue]}”?" } %>
+            <%= button_to "Delete", delete_snapshot_path(s[:id]), method: :post, class: "rh-btn rh-btn-danger", form_class: "rh-inline" %>
+          </td>
+        </tr>
+      <% end %>
+    <% end %>
+  </tbody>
+</table>
+<p class="rh-note">Snapshots are stored via the configured store (default: Redis). Restore re-enqueues onto the original queue.</p>

data/app/views/roundhouse_ui/workers/index.html.erb

@@ -0,0 +1,39 @@
+<% content_for :title, "Workers" %>
+
+<h2 class="rh-h2">Workers · <%= @processes.size %> <%= "process".pluralize(@processes.size) %></h2>
+<p class="rh-sub" style="margin:-4px 0 16px">
+  Fetch strategy:
+  <% if @fetch_active %>
+    <span class="rh-st rh-st-ok">RoundhouseUi::Fetch — pause-aware</span>
+  <% else %>
+    <span class="rh-st rh-st-paused">default — pause not enforced</span>
+  <% end %>
+  <span class="rh-sub" style="margin-left:6px">crash-reliable fetch (super_fetch) is Sidekiq Pro</span>
+</p>
+<table class="rh-table">
+  <thead><tr><th>Process</th><th class="r">Threads</th><th>Queues</th><th class="r">Started</th><th class="r">Heartbeat</th><th class="r">Actions</th></tr></thead>
+  <tbody>
+    <% if @processes.empty? %>
+      <tr><td colspan="6" class="rh-empty">No Sidekiq processes are running.</td></tr>
+    <% else %>
+      <% @processes.each do |p| %>
+        <% stale = p["beat"] && (Time.now.to_f - p["beat"].to_f) > 60 %>
+        <tr>
+          <td>
+            <%= p["hostname"] %>:<%= p["pid"] %><%
+              %><% if p.stopping? %> <span class="rh-err">· stopping</span><% elsif p["quiet"].to_s == "true" %> <span class="rh-sub">· quieting</span><% end %>
+            <br><span class="rh-sub"><%= [ p["tag"], ("v#{p["version"]}" if p["version"]), ("#{(p["rss"].to_i / 1024.0).round} MB" if p["rss"].to_i.positive?) ].compact.join(" · ") %></span>
+          </td>
+          <td class="r"><%= p["busy"] %>/<%= p["concurrency"] %></td>
+          <td><span class="rh-sub"><%= Array(p["queues"]).join(", ") %></span></td>
+          <td class="r"><span class="rh-sub"><%= p["started_at"] ? "#{time_ago_in_words(Time.at(p["started_at"]))} ago" : "—" %></span></td>
+          <td class="r <%= "rh-err" if stale %>"><%= p["beat"] ? "#{distance_of_time_in_words(Time.now, Time.at(p["beat"]))} ago" : "—" %></td>
+          <td class="r">
+            <%= button_to "Quiet", quiet_worker_path, method: :post, params: { identity: p.identity }, class: "rh-btn", form_class: "rh-inline" %>
+            <%= button_to "Stop", stop_worker_path, method: :post, params: { identity: p.identity }, class: "rh-btn rh-btn-danger", form_class: "rh-inline", data: { turbo_confirm: "Stop #{p["hostname"]}:#{p["pid"]}?" } %>
+          </td>
+        </tr>
+      <% end %>
+    <% end %>
+  </tbody>
+</table>

data/config/routes.rb

@@ -0,0 +1,54 @@
+RoundhouseUi::Engine.routes.draw do
+  root to: "dashboard#show"
+  get "stats" => "dashboard#stats", as: :dashboard_stats # JSON, polled for live updates
+  get "turbo.js" => "assets#turbo", as: :turbo_js        # vendored Turbo, served same-origin
+  get "metrics" => "metrics#show", as: :metrics          # derived metrics (separate from the live dashboard)
+
+  get  "busy" => "busy#index", as: :busy
+  post "busy/:jid/cancel" => "busy#cancel", as: :cancel_job, constraints: { jid: /[^\/]+/ }
+  get  "workers" => "workers#index", as: :workers
+  post "workers/quiet" => "workers#quiet", as: :quiet_worker
+  post "workers/stop"  => "workers#stop",  as: :stop_worker
+
+  get "queues" => "queues#index", as: :queues
+  # Queue names can contain dots/colons, so allow anything but a slash.
+  scope constraints: { name: /[^\/]+/ } do
+    post "queues/:name/purge"    => "queues#purge",    as: :purge_queue
+    post "queues/:name/pause"    => "queues#pause",    as: :pause_queue
+    post "queues/:name/resume"   => "queues#resume",   as: :resume_queue
+    post "queues/:name/snapshot" => "queues#snapshot", as: :snapshot_queue
+  end
+
+  get "snapshots" => "snapshots#index", as: :snapshots
+  scope constraints: { id: /[^\/]+/ } do
+    post "snapshots/:id/restore" => "snapshots#restore", as: :restore_snapshot
+    post "snapshots/:id/delete"  => "snapshots#destroy", as: :delete_snapshot
+  end
+
+  get  "scheduled" => "scheduled#index", as: :scheduled
+  post "scheduled/:jid/enqueue" => "scheduled#enqueue", as: :enqueue_scheduled
+  post "scheduled/:jid/delete"  => "scheduled#destroy", as: :delete_scheduled
+
+  get  "retries" => "retries#index", as: :retries
+  post "retries/:jid/run"    => "retries#requeue", as: :run_retry
+  post "retries/:jid/delete" => "retries#destroy", as: :delete_retry
+
+  get  "dead" => "dead#index", as: :dead_set
+  post "dead/bulk"        => "dead#bulk",    as: :bulk_dead
+  post "dead/:jid/retry"  => "dead#requeue", as: :retry_dead_job
+  post "dead/:jid/delete" => "dead#destroy", as: :delete_dead_job
+
+  get "errors" => "errors#index", as: :errors
+  get "capsules" => "capsules#index", as: :capsules
+  get "redis"  => "redis#show", as: :redis_info
+  get "audit"  => "audit#index", as: :audit_log
+
+  # Job editing / enqueue (opt-in via RoundhouseUi.allow_job_editing)
+  get  "jobs/new" => "jobs#new",    as: :new_job
+  post "jobs"     => "jobs#create", as: :jobs
+  scope constraints: { set: /dead|retry|scheduled/, jid: /[^\/]+/ } do
+    get  "jobs/:set/:jid/edit" => "jobs#edit", as: :edit_job
+    get  "jobs/:set/:jid"      => "jobs#show"           # read-only inspect (job_path)
+    post "jobs/:set/:jid"      => "jobs#update", as: :job
+  end
+end

data/lib/roundhouse_ui/audit.rb

@@ -0,0 +1,25 @@
+require "json"
+require "sidekiq"
+
+module RoundhouseUi
+  # An append-only audit trail of state-changing actions, kept in a capped Redis
+  # list. Answers "who purged that queue?" — the accountability Sidekiq Web lacks.
+  module Audit
+    KEY = "roundhouse:audit"
+    MAX = 1_000
+
+    module_function
+
+    def record(actor:, action:, target:)
+      entry = JSON.dump("actor" => actor.to_s, "action" => action.to_s, "target" => target.to_s, "at" => Time.now.to_f)
+      Sidekiq.redis do |conn|
+        conn.call("LPUSH", KEY, entry)
+        conn.call("LTRIM", KEY, 0, MAX - 1)
+      end
+    end
+
+    def recent(limit = 200)
+      Sidekiq.redis { |conn| conn.call("LRANGE", KEY, 0, limit - 1) }.map { |raw| JSON.parse(raw) }
+    end
+  end
+end

data/lib/roundhouse_ui/cancel_middleware.rb

@@ -0,0 +1,19 @@
+require "roundhouse_ui/cancellation"
+
+module RoundhouseUi
+  # Opt-in Sidekiq server middleware that drops a job whose JID was cancelled
+  # before it runs. Install it:
+  #
+  #   Sidekiq.configure_server do |config|
+  #     config.server_middleware { |chain| chain.add RoundhouseUi::CancelMiddleware }
+  #   end
+  class CancelMiddleware
+    def call(_worker, job, _queue)
+      if RoundhouseUi::Cancellation.cancelled?(job["jid"])
+        RoundhouseUi::Cancellation.clear!(job["jid"])
+        return # acknowledge without running
+      end
+      yield
+    end
+  end
+end

data/lib/roundhouse_ui/cancellation.rb

@@ -0,0 +1,37 @@
+require "sidekiq"
+
+module RoundhouseUi
+  # Cooperative job cancellation — pure OSS, no preemption (Ruby can't safely
+  # kill a running thread). Cancelled JIDs live in a Redis set:
+  #
+  #   * RoundhouseUi::CancelMiddleware skips a job whose JID is cancelled when it
+  #     is *about* to run (covers queued/scheduled/retry jobs).
+  #   * A long-running job can call RoundhouseUi.cancelled?(jid) and bail out.
+  #
+  # The set expires so stale flags clean themselves up.
+  module Cancellation
+    KEY = "roundhouse:cancelled"
+    TTL = 86_400 # seconds
+
+    module_function
+
+    def cancel!(jid)
+      Sidekiq.redis do |conn|
+        conn.call("SADD", KEY, jid.to_s)
+        conn.call("EXPIRE", KEY, TTL)
+      end
+    end
+
+    def cancelled?(jid)
+      Sidekiq.redis { |conn| conn.call("SISMEMBER", KEY, jid.to_s) } == 1
+    end
+
+    def clear!(jid)
+      Sidekiq.redis { |conn| conn.call("SREM", KEY, jid.to_s) }
+    end
+
+    def cancelled_jids
+      Sidekiq.redis { |conn| conn.call("SMEMBERS", KEY) }
+    end
+  end
+end

data/lib/roundhouse_ui/engine.rb

@@ -0,0 +1,5 @@
+module RoundhouseUi
+  class Engine < ::Rails::Engine
+    isolate_namespace RoundhouseUi
+  end
+end

data/lib/roundhouse_ui/fetch.rb

@@ -0,0 +1,36 @@
+require "sidekiq/fetch"
+require "roundhouse_ui/pause"
+
+module RoundhouseUi
+  # Opt-in fetch strategy that honors RoundhouseUi::Pause. Install it server-side:
+  #
+  #   # config/initializers/sidekiq.rb
+  #   Sidekiq.configure_server do |config|
+  #     config[:fetch_class] = RoundhouseUi::Fetch
+  #   end
+  #
+  # Until this fetcher is active, pausing a queue has no effect — the UI detects
+  # that (via the liveness beacon below) and warns rather than pretending.
+  #
+  # Inherits all of BasicFetch's behavior (weights, strict ordering, timeouts);
+  # we only filter the queue list. BasicFetch#retrieve_work already handles an
+  # empty list (sleep + return), so "all queues paused" is safe.
+  class Fetch < Sidekiq::BasicFetch
+    BEACON_INTERVAL = 5 # seconds; throttles the liveness write
+
+    def queues_cmd
+      touch_liveness
+      RoundhouseUi::Pause.reject_paused(super)
+    end
+
+    private
+
+    def touch_liveness
+      now = Process.clock_gettime(Process::CLOCK_MONOTONIC)
+      return if @rh_beat_at && (now - @rh_beat_at) < BEACON_INTERVAL
+
+      @rh_beat_at = now
+      RoundhouseUi::Pause.mark_fetch_alive!
+    end
+  end
+end

data/lib/roundhouse_ui/metrics.rb

@@ -0,0 +1,51 @@
+require "sidekiq/api"
+
+module RoundhouseUi
+  # Derived, single-snapshot metrics computed from data we already read
+  # (Sidekiq::Stats + the live ProcessSet). No storage and no deltas — these are
+  # instantaneous. Rate-based metrics (jobs/sec, velocity) are computed
+  # client-side from the dashboard's poll stream; per-class durations need the
+  # collector (a separate, opt-in piece).
+  class Metrics
+    def initialize(stats: Sidekiq::Stats.new, processes: Sidekiq::ProcessSet.new)
+      @stats = stats
+      @processes = processes
+    end
+
+    # Total worker threads across the live fleet.
+    def concurrency
+      @concurrency ||= @processes.sum { |process| process["concurrency"].to_i }
+    end
+
+    # Worker threads currently running a job.
+    def busy
+      @stats.workers_size
+    end
+
+    # Fraction of worker threads in use (0.0–1.0), or nil when no capacity is
+    # reporting in (no processes up) — so the view can show "—" instead of 0%.
+    def utilization
+      return nil if concurrency.zero?
+
+      busy.to_f / concurrency
+    end
+
+    # Idle worker threads.
+    def headroom
+      [ concurrency - busy, 0 ].max
+    end
+
+    # Everything waiting to run: live queues + scheduled + retrying.
+    def backlog
+      @stats.enqueued + @stats.scheduled_size + @stats.retry_size
+    end
+
+    # Share of processed jobs that failed, lifetime. Coarse (Sidekiq keeps only
+    # cumulative counters); the live failure rate is computed client-side.
+    def failure_ratio
+      return 0.0 if @stats.processed.zero?
+
+      @stats.failed.to_f / @stats.processed
+    end
+  end
+end

data/lib/roundhouse_ui/observability.rb

@@ -0,0 +1,46 @@
+require "cgi"
+
+module RoundhouseUi
+  # Pluggable deep-links from a job to your APM/observability tool. The core
+  # never depends on Datadog (or anything) — it asks the configured adapter for
+  # a URL and renders a link only if one comes back.
+  #
+  #   RoundhouseUi.observability = RoundhouseUi::Observability::DatadogAdapter.new(service: "trainual")
+  #
+  # Write your own (Honeycomb, Sentry, …) by duck-typing job_url/queue_url/label.
+  module Observability
+    # Default: no links anywhere.
+    class NullAdapter
+      def label = "trace"
+      def job_url(**) = nil
+      def queue_url(_name) = nil
+    end
+
+    class DatadogAdapter
+      def initialize(site: "datadoghq.com", service: nil, extra_query: nil)
+        @site = site
+        @service = service
+        @extra_query = extra_query
+      end
+
+      def label = "Datadog"
+
+      def job_url(klass:, jid:, queue: nil)
+        terms = [ "@sidekiq.jid:#{jid}" ]
+        terms << "service:#{@service}" if @service
+        terms << @extra_query if @extra_query
+        traces_url(terms)
+      end
+
+      def queue_url(name)
+        traces_url([ "@sidekiq.queue:#{name}" ])
+      end
+
+      private
+
+      def traces_url(terms)
+        "https://app.#{@site}/apm/traces?query=#{CGI.escape(terms.compact.join(" "))}"
+      end
+    end
+  end
+end