flightdeck 0.5.0

data/app/views/flightdeck/overview/_completion.html.erb

@@ -0,0 +1,19 @@
+<div class="fd-card">
+  <div class="fd-card-hd">
+    <h3>Time to completion</h3>
+    <span class="sub">enqueue → finish, average <%= window.subtitle %></span>
+    <div class="right">
+      <div class="fd-legend"><span><i class="fd-swatch-s3"></i>Average</span></div>
+    </div>
+  </div>
+  <div class="fd-chart-body">
+    <%= render "flightdeck/metrics/line_chart",
+               chart: Flightdeck::Metrics::LineChart.new(points: series.completion_time, window: window) %>
+  </div>
+  <%# Deliberately not "time to start": Solid Queue deletes the claim row when a
+      job finishes, so historical time-to-start cannot be recovered. %>
+  <div class="fd-chart-note">
+    Measured from enqueue to finish. Time spent waiting and time spent running are not
+    separable after the fact.
+  </div>
+</div>

data/app/views/flightdeck/overview/_failures.html.erb

@@ -0,0 +1,28 @@
+<div class="fd-card">
+  <div class="fd-card-hd">
+    <h3>Recent failures</h3>
+    <div class="right">
+      <%= link_to "View all #{fd_count(overview.failed_count)}", jobs_path(state: :failed), class: "fd-btn sm" %>
+    </div>
+  </div>
+  <div class="fd-scroll-x">
+    <table class="fd-data">
+      <tbody>
+        <% if overview.recent_failures.empty? %>
+          <tr><td><div class="fd-empty">No failures. Nothing to see here.</div></td></tr>
+        <% else %>
+          <% overview.recent_failures.each do |row| %>
+            <tr>
+              <td class="cls">
+                <%= link_to row.class_name, job_path(row.id, state: :failed) %>
+                <div class="args"><%= row.error_summary.present? ? row.error_summary.to_s : "—" %></div>
+              </td>
+              <td><%= fd_queue_badge(row.queue_name) %></td>
+              <td class="dim num"><%= row.failed_at ? fd_ago(row.failed_at) : "—" %></td>
+            </tr>
+          <% end %>
+        <% end %>
+      </tbody>
+    </table>
+  </div>
+</div>

data/app/views/flightdeck/overview/_fleet.html.erb

@@ -0,0 +1,21 @@
+<div class="fd-card">
+  <div class="fd-card-hd">
+    <h3>Fleet</h3>
+    <span class="sub"><%= pluralize(registry.total, "process") %> · last heartbeats</span>
+    <div class="right"><%= link_to "Processes", processes_path, class: "fd-btn sm" %></div>
+  </div>
+  <div class="fd-health-strip">
+    <% if registry.nodes.empty? %>
+      <div class="fd-empty">No Solid Queue processes are registered.</div>
+    <% else %>
+      <% registry.nodes.each do |node| %>
+        <span class="fd-proc-chip" title="<%= node.name %> · heartbeat <%= fd_ago(node.last_heartbeat_at) %>">
+          <span class="fd-led <%= node.freshness %>"></span>
+          <%= node.kind.downcase %> · <%= node.hostname.presence || "unknown host" %><%
+            %><% if node.claims_executions? && node.freshness == :fresh %> · <%= node.claimed_count %> claimed<%
+            %><% else %> · heartbeat <%= fd_ago(node.last_heartbeat_at) %><% end %>
+        </span>
+      <% end %>
+    <% end %>
+  </div>
+</div>

data/app/views/flightdeck/overview/_queues.html.erb

@@ -0,0 +1,41 @@
+<div class="fd-card">
+  <div class="fd-card-hd">
+    <h3>Queues</h3>
+    <div class="right"><%= link_to "View all", queues_path, class: "fd-btn sm" %></div>
+  </div>
+  <div class="fd-scroll-x">
+    <table class="fd-data">
+      <thead>
+        <tr>
+          <th>Queue</th>
+          <th class="num">Depth</th>
+          <th class="num">Latency</th>
+          <th>Last <%= Flightdeck::Metrics::Series::SPARKLINE_HOURS %>h</th>
+          <th style="width:90px"></th>
+        </tr>
+      </thead>
+      <tbody>
+        <% if overview.queues.empty? %>
+          <tr><td colspan="5"><div class="fd-empty">No queues yet.</div></td></tr>
+        <% else %>
+          <% overview.queues.each do |queue| %>
+            <tr>
+              <td class="cls">
+                <%= link_to queue.name, queues_path %>
+                <% if queue.paused? %><span class="fd-pill paused">PAUSED</span><% end %>
+              </td>
+              <td class="num"><%= number_with_delimiter(queue.depth) %></td>
+              <td class="num dim"><%= queue.latency ? fd_duration(queue.latency) : "—" %></td>
+              <td><%= render "flightdeck/metrics/sparkline", sparkline: overview.sparkline_for(queue.name) %></td>
+              <td>
+                <div class="fd-depth-bar">
+                  <i style="width: <%= fd_depth_share(queue.depth, overview.max_queue_depth) %>%"></i>
+                </div>
+              </td>
+            </tr>
+          <% end %>
+        <% end %>
+      </tbody>
+    </table>
+  </div>
+</div>

data/app/views/flightdeck/overview/_throughput.html.erb

@@ -0,0 +1,23 @@
+<div class="fd-card">
+  <div class="fd-card-hd">
+    <h3>Throughput</h3>
+    <span class="sub">jobs finished <%= window.subtitle %></span>
+    <div class="right">
+      <div class="fd-legend">
+        <span><i class="fd-swatch-s1"></i>Succeeded</span>
+        <span><i class="fd-swatch-s2"></i>Failed</span>
+      </div>
+      <%= render "flightdeck/metrics/range_control", window: window %>
+    </div>
+  </div>
+  <div class="fd-chart-body">
+    <%= render "flightdeck/metrics/bar_chart",
+               chart: Flightdeck::Metrics::BarChart.new(points: series.throughput, window: window) %>
+  </div>
+  <% if series.truncated_by_retention? %>
+    <div class="fd-chart-note">
+      Finished jobs are retained for <%= fd_duration(series.retention) %>, which is shorter than this
+      window — the oldest buckets undercount.
+    </div>
+  <% end %>
+</div>

data/app/views/flightdeck/overview/_tiles.html.erb

@@ -0,0 +1,14 @@
+<div class="fd-tiles">
+  <% overview.tiles.each do |tile| %>
+    <div class="fd-card fd-tile">
+      <div class="lbl"><%= tile.label %></div>
+      <div class="val">
+        <%= tile.value.is_a?(Numeric) ? number_with_delimiter(tile.value) : tile.value %><%
+          %><% if tile.unit %><small><%= tile.unit %></small><% end %>
+      </div>
+      <div class="delta <%= fd_delta_class(tile) %>">
+        <%= fd_trend_glyph(tile.trend) %> <%= tile.detail %>
+      </div>
+    </div>
+  <% end %>
+</div>

data/app/views/flightdeck/overview/index.html.erb

@@ -0,0 +1,54 @@
+<% content_for :page_title, "Overview" %>
+
+<turbo-frame id="fd-tiles"
+             target="_top"
+             data-controller="refresh"
+             data-refresh-interval-value="<%= fd_poll_ms %>"
+             data-refresh-url-value="<%= root_path(range: @window.key) %>">
+  <%= render "flightdeck/overview/tiles", overview: @overview %>
+</turbo-frame>
+
+<div class="fd-grid-2">
+  <turbo-frame id="fd-throughput"
+               target="_top"
+               data-controller="refresh"
+               data-refresh-interval-value="<%= fd_chart_poll_ms %>"
+               data-refresh-url-value="<%= root_path(range: @window.key) %>">
+    <%= render "flightdeck/overview/throughput", series: @series, window: @window %>
+  </turbo-frame>
+
+  <turbo-frame id="fd-completion"
+               target="_top"
+               data-controller="refresh"
+               data-refresh-interval-value="<%= fd_chart_poll_ms %>"
+               data-refresh-url-value="<%= root_path(range: @window.key) %>">
+    <%= render "flightdeck/overview/completion", series: @series, window: @window %>
+  </turbo-frame>
+</div>
+
+<div class="fd-grid-2b">
+  <turbo-frame id="fd-overview-queues"
+               target="_top"
+               data-controller="refresh"
+               data-refresh-interval-value="<%= fd_poll_ms %>"
+               data-refresh-url-value="<%= root_path(range: @window.key) %>">
+    <%= render "flightdeck/overview/queues", overview: @overview %>
+  </turbo-frame>
+
+  <turbo-frame id="fd-overview-failures"
+               target="_top"
+               data-controller="refresh"
+               data-refresh-interval-value="<%= fd_poll_ms %>"
+               data-refresh-url-value="<%= root_path(range: @window.key) %>">
+    <%= render "flightdeck/overview/failures", overview: @overview %>
+  </turbo-frame>
+</div>
+
+<turbo-frame id="fd-fleet"
+             target="_top"
+             class="fd-block"
+             data-controller="refresh"
+             data-refresh-interval-value="<%= fd_poll_ms %>"
+             data-refresh-url-value="<%= root_path(range: @window.key) %>">
+  <%= render "flightdeck/overview/fleet", registry: @overview.registry %>
+</turbo-frame>

data/app/views/flightdeck/processes/_fleet.html.erb

@@ -0,0 +1,54 @@
+<% if registry.any_dead? %>
+  <div class="fd-alert" role="alert">
+    <svg class="ic" width="16" height="16" viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.6"><path d="M8 1.5 15 14H1L8 1.5z" stroke-linejoin="round"/><path d="M8 6v4M8 12.2v.2"/></svg>
+    <div>
+      <b><%= pluralize(registry.dead.size, "process") %> missed heartbeats for longer than
+      <%= fd_duration(SolidQueue.process_alive_threshold) %>.</b>
+      <% if registry.dead_claimed_count.positive? %>
+        <%= pluralize(registry.dead_claimed_count, "claimed execution") %> will be released and
+        marked failed when they are pruned.
+      <% else %>
+        They hold no claimed executions.
+      <% end %>
+    </div>
+    <div class="right">
+      <% if registry.dead_claimed_count.positive? %>
+        <%= link_to "Inspect claimed", jobs_path(state: :in_progress), class: "fd-btn sm" %>
+      <% end %>
+    </div>
+  </div>
+<% end %>
+
+<div class="fd-card">
+  <div class="fd-card-hd">
+    <h3>Processes</h3>
+    <span class="sub">grouped by supervisor · heartbeat threshold <%= fd_duration(SolidQueue.process_alive_threshold) %></span>
+  </div>
+  <div class="fd-scroll-x">
+    <table class="fd-data">
+      <thead>
+        <tr>
+          <th>Kind</th>
+          <th>Host</th>
+          <th class="num">PID</th>
+          <th>Configuration</th>
+          <th class="num">Claimed</th>
+          <th>Heartbeat</th>
+          <th style="width:90px"></th>
+        </tr>
+      </thead>
+      <tbody>
+        <% if registry.nodes.empty? %>
+          <tr><td colspan="7"><div class="fd-empty">No Solid Queue processes are registered.</div></td></tr>
+        <% else %>
+          <% registry.tree.each do |root| %>
+            <%= render "flightdeck/processes/row", node: root, child: false %>
+            <% root.children.each do |child| %>
+              <%= render "flightdeck/processes/row", node: child, child: true %>
+            <% end %>
+          <% end %>
+        <% end %>
+      </tbody>
+    </table>
+  </div>
+</div>

data/app/views/flightdeck/processes/_row.html.erb

@@ -0,0 +1,28 @@
+<tr id="<%= dom_id_for_process(node.id) %>" class="<%= "fd-row-danger" if node.dead? %>">
+  <td class="cls<%= " fd-indent" if child %>">
+    <%= "↳ " if child %><%= node.kind %>
+  </td>
+  <td class="dim fd-mono" style="font-size:12px"><%= node.hostname.presence || "—" %></td>
+  <td class="num"><%= node.pid %></td>
+  <td class="dim"><%= node.config_summary.presence || "—" %></td>
+  <td class="num">
+    <% if node.claims_executions? %>
+      <%= link_to number_with_delimiter(node.claimed_count), jobs_path(state: :in_progress) %>
+    <% else %>
+      —
+    <% end %>
+  </td>
+  <td>
+    <span class="fd-hb">
+      <span class="fd-led <%= node.freshness %>"></span>
+      <%= fd_ago(node.last_heartbeat_at) %>
+    </span>
+  </td>
+  <td class="num">
+    <% if node.prunable? %>
+      <%= button_to "Prune", prune_process_path(node.id), class: "fd-btn sm danger",
+            form_class: "fd-inline-form",
+            data: { turbo_confirm: "Prune #{node.kind} #{node.name}? Its claimed jobs will be marked failed." } %>
+    <% end %>
+  </td>
+</tr>

data/app/views/flightdeck/processes/index.html.erb

@@ -0,0 +1,9 @@
+<% content_for :page_title, "Processes" %>
+
+<turbo-frame id="fd-processes"
+             target="_top"
+             data-controller="refresh"
+             data-refresh-interval-value="<%= (Flightdeck.config.poll_interval.to_f * 1000).round %>"
+             data-refresh-url-value="<%= processes_path %>">
+  <%= render "flightdeck/processes/fleet", registry: @registry %>
+</turbo-frame>

data/app/views/flightdeck/processes/prune.turbo_stream.erb

@@ -0,0 +1,15 @@
+<turbo-stream action="append" target="fd-toasts">
+  <template><%= render partial: "flightdeck/shared/toast", formats: [ :html ], locals: { toast: @toast } %></template>
+</turbo-stream>
+
+<turbo-stream action="replace" target="fd-processes">
+  <template>
+    <turbo-frame id="fd-processes"
+             target="_top"
+                 data-controller="refresh"
+                 data-refresh-interval-value="<%= (Flightdeck.config.poll_interval.to_f * 1000).round %>"
+                 data-refresh-url-value="<%= processes_path %>">
+      <%= render partial: "flightdeck/processes/fleet", formats: [ :html ], locals: { registry: @registry } %>
+    </turbo-frame>
+  </template>
+</turbo-stream>

data/app/views/flightdeck/queues/_cards.html.erb

@@ -0,0 +1,46 @@
+<% if stats.rows.empty? %>
+  <div class="fd-card"><div class="fd-empty">No queues yet. They appear as soon as jobs are enqueued.</div></div>
+<% else %>
+  <div class="fd-queue-cards">
+    <% stats.rows.each do |queue| %>
+      <div class="fd-card fd-qcard<%= " paused-card" if queue.paused? %>" id="<%= dom_id_for_queue(queue.name) %>">
+        <div class="top">
+          <h3><%= queue.name %></h3>
+          <% if queue.paused? %>
+            <span class="fd-pill paused">PAUSED · <%= fd_duration(queue.paused_for) %></span>
+          <% else %>
+            <span class="fd-pill ready">ACTIVE</span>
+          <% end %>
+          <div class="right">
+            <% if queue.paused? %>
+              <%= button_to "▶ Resume", resume_queues_path(name: queue.name),
+                    class: "fd-btn sm primary", form_class: "fd-inline-form" %>
+            <% else %>
+              <%= button_to "⏸ Pause", pause_queues_path(name: queue.name),
+                    class: "fd-btn sm", form_class: "fd-inline-form",
+                    data: { turbo_confirm: "Pause #{queue.name}? Workers will stop picking up its jobs until you resume it." } %>
+            <% end %>
+          </div>
+        </div>
+
+        <div class="stats">
+          <div>
+            <div class="k">Depth</div>
+            <div class="v"><%= number_with_delimiter(queue.depth) %></div>
+          </div>
+          <div>
+            <div class="k">Latency</div>
+            <div class="v"><%= queue.latency ? fd_duration(queue.latency) : "—" %></div>
+          </div>
+          <div>
+            <div class="k">Rate · 1h</div>
+            <div class="v"><%= number_with_delimiter(queue.rate_per_hour) %><small>/h</small></div>
+          </div>
+        </div>
+
+        <%= render "flightdeck/metrics/sparkline",
+                   sparkline: Flightdeck::Metrics::Sparkline.new(sparklines[queue.name] || []) %>
+      </div>
+    <% end %>
+  </div>
+<% end %>

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

@@ -0,0 +1,9 @@
+<% content_for :page_title, "Queues" %>
+
+<turbo-frame id="fd-queues"
+             target="_top"
+             data-controller="refresh"
+             data-refresh-interval-value="<%= (Flightdeck.config.poll_interval.to_f * 1000).round %>"
+             data-refresh-url-value="<%= queues_path %>">
+  <%= render "flightdeck/queues/cards", stats: @stats, sparklines: @sparklines %>
+</turbo-frame>

data/app/views/flightdeck/queues/update.turbo_stream.erb

@@ -0,0 +1,15 @@
+<turbo-stream action="append" target="fd-toasts">
+  <template><%= render partial: "flightdeck/shared/toast", formats: [ :html ], locals: { toast: @toast } %></template>
+</turbo-stream>
+
+<turbo-stream action="replace" target="fd-queues">
+  <template>
+    <turbo-frame id="fd-queues"
+             target="_top"
+                 data-controller="refresh"
+                 data-refresh-interval-value="<%= (Flightdeck.config.poll_interval.to_f * 1000).round %>"
+                 data-refresh-url-value="<%= queues_path %>">
+      <%= render partial: "flightdeck/queues/cards", formats: [ :html ], locals: { stats: @stats, sparklines: @sparklines } %>
+    </turbo-frame>
+  </template>
+</turbo-stream>

data/app/views/flightdeck/recurring_tasks/_table.html.erb

@@ -0,0 +1,53 @@
+<div class="fd-card">
+  <div class="fd-card-hd">
+    <h3>Recurring tasks</h3>
+    <span class="sub"><%= pluralize(catalog.rows.size, "task") %> registered</span>
+  </div>
+  <div class="fd-scroll-x">
+    <table class="fd-data">
+      <thead>
+        <tr>
+          <th>Key</th>
+          <th>Job</th>
+          <th>Schedule</th>
+          <th class="num">Last run</th>
+          <th class="num">Next run</th>
+          <th>Status</th>
+          <th style="width:110px"></th>
+        </tr>
+      </thead>
+      <tbody>
+        <% if catalog.rows.empty? %>
+          <tr><td colspan="7"><div class="fd-empty">No recurring tasks are configured.</div></td></tr>
+        <% else %>
+          <% catalog.rows.each do |row| %>
+            <tr id="<%= dom_id_for_recurring_task(row.id) %>">
+              <td class="cls"><%= row.key %></td>
+              <td class="dim"><%= row.job_class %></td>
+              <td class="fd-cron">
+                <%= row.schedule %>
+                <% if row.human_schedule %><small><%= row.human_schedule %></small><% end %>
+              </td>
+              <td class="num dim">
+                <%= row.ever_run? ? fd_ago(row.last_run_at) : "never" %>
+              </td>
+              <td class="num">
+                <% if row.next_run_at %>
+                  <span title="<%= fd_full_time(row.next_run_at) %>">in <%= fd_duration(row.next_run_in) %></span>
+                <% else %>
+                  —
+                <% end %>
+              </td>
+              <td><%= fd_recurring_status_pill(row.last_status) %></td>
+              <td class="num">
+                <%= button_to "▶ Run now", run_recurring_task_path(row.id),
+                      class: "fd-btn sm", form_class: "fd-inline-form",
+                      data: { turbo_confirm: "Enqueue #{row.key} now?" } %>
+              </td>
+            </tr>
+          <% end %>
+        <% end %>
+      </tbody>
+    </table>
+  </div>
+</div>

data/app/views/flightdeck/recurring_tasks/index.html.erb

@@ -0,0 +1,9 @@
+<% content_for :page_title, "Recurring tasks" %>
+
+<turbo-frame id="fd-recurring"
+             target="_top"
+             data-controller="refresh"
+             data-refresh-interval-value="<%= (Flightdeck.config.poll_interval.to_f * 1000).round %>"
+             data-refresh-url-value="<%= recurring_tasks_path %>">
+  <%= render "flightdeck/recurring_tasks/table", catalog: @catalog %>
+</turbo-frame>

data/app/views/flightdeck/recurring_tasks/run.turbo_stream.erb

@@ -0,0 +1,15 @@
+<turbo-stream action="append" target="fd-toasts">
+  <template><%= render partial: "flightdeck/shared/toast", formats: [ :html ], locals: { toast: @toast } %></template>
+</turbo-stream>
+
+<turbo-stream action="replace" target="fd-recurring">
+  <template>
+    <turbo-frame id="fd-recurring"
+             target="_top"
+                 data-controller="refresh"
+                 data-refresh-interval-value="<%= (Flightdeck.config.poll_interval.to_f * 1000).round %>"
+                 data-refresh-url-value="<%= recurring_tasks_path %>">
+      <%= render partial: "flightdeck/recurring_tasks/table", formats: [ :html ], locals: { catalog: @catalog } %>
+    </turbo-frame>
+  </template>
+</turbo-stream>

data/app/views/flightdeck/shared/_toast.html.erb

@@ -0,0 +1,7 @@
+<div class="<%= fd_toast_level_class(toast[:level]) %>"
+     role="status"
+     data-controller="toast"
+     data-toast-timeout-value="<%= toast[:continuable] ? 12_000 : 6_000 %>">
+  <span><%= toast[:message] %></span>
+  <button type="button" class="fd-toast-close" data-action="toast#dismiss" aria-label="Dismiss">&#10005;</button>
+</div>

data/app/views/layouts/flightdeck/application.html.erb

@@ -0,0 +1,110 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <title><%= content_for?(:title) ? yield(:title) : "Flightdeck" %></title>
+    <meta name="turbo-root" content="<%= flightdeck.root_path %>">
+    <%= csrf_meta_tags %>
+    <% if (css = flightdeck_asset_path("flightdeck.css")) %>
+      <link rel="stylesheet" href="<%= css %>">
+    <% end %>
+    <% if (js = flightdeck_asset_path("flightdeck.js")) %>
+      <script src="<%= js %>" defer></script>
+    <% end %>
+  </head>
+  <body data-controller="theme">
+    <div class="fd-app">
+      <aside class="fd-side">
+        <div class="fd-brand">
+          <%= flightdeck_brand_svg %>
+          <span class="fd-brand-word">FLIGHT<em>DECK</em></span>
+        </div>
+
+        <nav class="fd-nav">
+          <%= link_to flightdeck.root_path, class: "fd-nav-link#{" on" if current_page?(flightdeck.root_path)}" do %>
+            <svg width="15" height="15" viewBox="0 0 15 15" fill="none" stroke="currentColor" stroke-width="1.4"><path d="M1.5 13.5v-5h3v5m1.5 0v-9h3v9m1.5 0v-12h3v12" stroke-linejoin="round"/></svg>
+            Overview
+          <% end %>
+
+          <span class="fd-nav-section">Jobs</span>
+
+          <%= link_to flightdeck.jobs_path, class: "fd-nav-link#{" on" if fd_nav_active?(:all)}" do %>
+            <svg width="15" height="15" viewBox="0 0 15 15" fill="none" stroke="currentColor" stroke-width="1.4"><rect x="1.5" y="2.5" width="12" height="10" rx="1.5"/><path d="M4.5 6h6M4.5 9h4"/></svg>
+            All jobs <span class="fd-nav-count"><%= fd_nav_count(:all) %></span>
+          <% end %>
+
+          <%= link_to flightdeck.jobs_path(state: :failed), class: "fd-nav-link#{" on" if fd_nav_active?(:failed)}" do %>
+            <svg width="15" height="15" viewBox="0 0 15 15" fill="none" stroke="currentColor" stroke-width="1.4"><circle cx="7.5" cy="7.5" r="6"/><path d="M7.5 4.5v3.5M7.5 10.4v.2"/></svg>
+            Failed <span class="fd-nav-count"><%= fd_nav_count(:failed) %></span>
+          <% end %>
+
+          <span class="fd-nav-section">Infrastructure</span>
+
+          <%= link_to flightdeck.queues_path, class: "fd-nav-link#{" on" if controller_name == "queues"}" do %>
+            <svg width="15" height="15" viewBox="0 0 15 15" fill="none" stroke="currentColor" stroke-width="1.4"><path d="M2 4h11M2 7.5h11M2 11h7"/></svg>
+            Queues <span class="fd-nav-count"><%= fd_nav_queue_count %></span>
+          <% end %>
+
+          <%= link_to flightdeck.processes_path, class: "fd-nav-link#{" on" if controller_name == "processes"}" do %>
+            <svg width="15" height="15" viewBox="0 0 15 15" fill="none" stroke="currentColor" stroke-width="1.4"><rect x="2" y="2" width="11" height="7" rx="1.5"/><path d="M5 13h5M7.5 9v4"/></svg>
+            Processes <span class="fd-nav-count <%= "alert" if fd_nav_any_dead_processes? %>"><%= fd_nav_process_count %></span>
+          <% end %>
+
+          <%= link_to flightdeck.recurring_tasks_path, class: "fd-nav-link#{" on" if controller_name == "recurring_tasks"}" do %>
+            <svg width="15" height="15" viewBox="0 0 15 15" fill="none" stroke="currentColor" stroke-width="1.4"><circle cx="7.5" cy="7.5" r="6"/><path d="M7.5 4v3.5l2.5 1.5"/></svg>
+            Recurring <span class="fd-nav-count"><%= fd_nav_recurring_count %></span>
+          <% end %>
+        </nav>
+
+        <div class="fd-side-foot">
+          <b>flightdeck</b><br>
+          v<%= Flightdeck::VERSION %>
+        </div>
+      </aside>
+
+      <div class="fd-main">
+        <div class="fd-topbar">
+          <h2><%= content_for?(:page_title) ? yield(:page_title) : "Overview" %></h2>
+          <div class="fd-topbar-right">
+            <span class="fd-clock"
+                  data-controller="clock"
+                  data-clock-offset-value="<%= fd_zone_offset_seconds %>"
+                  data-clock-label-value="<%= fd_zone_label %>"><%= fd_clock_now %></span>
+
+            <button class="fd-live" type="button" aria-pressed="true"
+                    data-controller="live"
+                    data-live-interval-value="<%= fd_poll_ms %>"
+                    data-action="live#toggle">
+              <span class="fd-dot"></span>
+              <span data-live-target="label">LIVE · <%= fd_poll_seconds %>s</span>
+            </button>
+
+            <%# Which icon shows is decided by theme tokens, so it is correct on
+                first paint without waiting for JavaScript. The controller
+                refines the label to name the action once it connects. %>
+            <button class="fd-theme-toggle" type="button"
+                    data-action="theme#toggle" data-theme-target="button"
+                    aria-label="Switch theme" title="Switch theme">
+              <svg class="fd-icon-sun" width="15" height="15" viewBox="0 0 16 16" fill="none"
+                   stroke="currentColor" stroke-width="1.4" stroke-linecap="round" aria-hidden="true">
+                <circle cx="8" cy="8" r="3.1"/>
+                <path d="M8 1.2v1.6M8 13.2v1.6M14.8 8h-1.6M2.8 8H1.2M12.8 3.2l-1.1 1.1M4.3 11.7l-1.1 1.1M12.8 12.8l-1.1-1.1M4.3 4.3 3.2 3.2"/>
+              </svg>
+              <svg class="fd-icon-moon" width="15" height="15" viewBox="0 0 16 16" fill="none"
+                   stroke="currentColor" stroke-width="1.4" stroke-linejoin="round" aria-hidden="true">
+                <path d="M13.4 9.8A5.9 5.9 0 0 1 6.2 2.6a5.9 5.9 0 1 0 7.2 7.2z"/>
+              </svg>
+            </button>
+          </div>
+        </div>
+
+        <main class="fd-content">
+          <%= yield %>
+        </main>
+      </div>
+    </div>
+
+    <div id="fd-toasts" class="fd-toasts" aria-live="polite" aria-atomic="false"></div>
+  </body>
+</html>

data/config/routes.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+Flightdeck::Engine.routes.draw do
+  root to: "overview#index"
+
+  resources :jobs, only: %i[index show] do
+    member do
+      post :retry, to: "jobs/retries#create"
+      post :discard, to: "jobs/discards#create"
+    end
+
+    collection do
+      post :retry, to: "jobs/retries#create", as: :bulk_retry
+      post :discard, to: "jobs/discards#create", as: :bulk_discard
+    end
+  end
+
+  # Queue names are arbitrary strings (dots, slashes, colons all legal), so the
+  # name travels as a parameter rather than as a path segment.
+  resources :queues, only: :index do
+    collection do
+      post :pause
+      post :resume
+    end
+  end
+
+  resources :processes, only: :index do
+    member { post :prune }
+  end
+
+  resources :recurring_tasks, only: :index do
+    member { post :run }
+  end
+
+  get "assets/:name",
+      to: "assets#show",
+      as: :asset_file,
+      format: false,
+      constraints: { name: /flightdeck-[0-9a-f]{12}\.(?:css|js)/ }
+end