good_pipeline 0.4.0 → 0.6.0

data/app/views/good_pipeline/pipelines/_diagram.html.erb

@@ -0,0 +1,101 @@
+<%
+  pipeline = local_assigns[:pipeline]
+  stages = Array(local_assigns[:stages])
+  definition = !!local_assigns[:definition]
+  edge_count = (local_assigns[:edge_count] || (respond_to?(:mermaid_edge_count) ? mermaid_edge_count(pipeline) : pipeline.dependencies.size)).to_i
+  step_count = Array(local_assigns[:steps] || pipeline.steps).size
+  overflow = edge_count > 1_000 || !!local_assigns[:overflow]
+  graph = if overflow
+    ""
+  elsif local_assigns.key?(:graph)
+    local_assigns[:graph].to_s
+  else
+    definition ? mermaid_definition_diagram(pipeline) : mermaid_diagram(pipeline)
+  end
+  large = step_count > 60
+  stage_first = large || overflow
+  max_stage_count = [stages.map { |stage| stage.respond_to?(:n) ? stage.n.to_i : (stage[:n] || stage["n"] || 1).to_i }.max.to_i, 1].max
+  get = lambda do |object, key|
+    if object.respond_to?(key)
+      object.public_send(key)
+    elsif object.respond_to?(:[])
+      object[key] || object[key.to_s]
+    end
+  rescue NameError, IndexError, KeyError, TypeError
+    nil
+  end
+%>
+<section class="gp-card">
+  <h3 class="gp-section-heading">
+    <span>dag</span>
+    <span><%= step_count %> steps · <%= edge_count %> edges</span>
+    <span class="gp-diagram-toolbar">
+      <% if overflow %>
+        <button class="gp-diagram-btn" type="button" disabled title="Full graph disabled because <%= edge_count %> edges exceeds Mermaid's 1,000-edge safety limit">render full graph</button>
+      <% elsif large %>
+        <button class="gp-diagram-btn" type="button" data-gp-graph-toggle aria-pressed="false">render full graph</button>
+      <% end %>
+      <button class="gp-diagram-btn gp-diagram-btn--icon" type="button" data-gp-diagram-action="in" title="Zoom in" aria-label="Zoom in">+</button>
+      <button class="gp-diagram-btn gp-diagram-btn--icon" type="button" data-gp-diagram-action="out" title="Zoom out" aria-label="Zoom out">−</button>
+      <button class="gp-diagram-btn" type="button" data-gp-diagram-action="reset" title="Reset zoom">reset</button>
+      <button class="gp-diagram-btn gp-diagram-btn--icon" type="button" data-gp-diagram-action="fullscreen" title="Fullscreen" aria-label="Fullscreen">⛶</button>
+    </span>
+  </h3>
+  <% if overflow %>
+    <p class="gp-edge-warning">Full graph disabled: <%= number_with_delimiter(edge_count) %> edges exceeds Mermaid’s 1,000-edge safety limit. The stage view remains available.</p>
+  <% end %>
+
+  <div class="gp-stage-panel" <%= "hidden" unless stage_first %>>
+    <% if definition %>
+      <div class="gp-timeline">
+        <% stages.each do |stage| %>
+          <% role = (get.call(stage, :role) || :step).to_s; count = (get.call(stage, :n) || 1).to_i; jobs = Array(get.call(stage, :job_classes)); label = get.call(stage, :label) || get.call(stage, :stage) %>
+          <div class="gp-lane">
+            <span class="gp-stage-level">L<%= get.call(stage, :level) || 0 %></span>
+            <span class="gp-lane-label" title="<%= label %>"><%= label %></span>
+            <span class="gp-stage-role gp-stage-role--<%= role %>" style="--gp-width:<%= (count.to_f / max_stage_count * 60).round(2) %>%"></span>
+            <span class="gp-lane-note" title="<%= jobs.join(', ') %>"><%= count > 1 ? "#{count} parallel shards" : (jobs.first || role) %></span>
+          </div>
+        <% end %>
+      </div>
+    <% else %>
+      <div class="gp-timeline">
+        <% status_order = %w[succeeded failed halted enqueued running pending canceled skipped skipped_by_branch] %>
+        <% stages.each do |stage| %>
+          <%
+            counts = get.call(stage, :counts) || {}
+            count = [(get.call(stage, :n) || counts.values.sum).to_i, 1].max
+            label = get.call(stage, :label) || get.call(stage, :stage)
+            notes = status_order.filter_map do |stage_status|
+              value = counts[stage_status] || counts[stage_status.to_sym]
+              "#{value} #{stage_status.sub('_by_branch', '·br')}" if value.to_i.positive?
+            end
+          %>
+          <div class="gp-lane">
+            <span class="gp-stage-level">L<%= get.call(stage, :level) || 0 %></span>
+            <span class="gp-lane-label" title="<%= label %>"><%= label %></span>
+            <span class="gp-stage-stack">
+              <% status_order.each do |stage_status| %>
+                <% value = (counts[stage_status] || counts[stage_status.to_sym]).to_i; next if value.zero?; color_status = stage_status == "enqueued" ? "running" : stage_status.start_with?("skipped") ? "skipped" : stage_status; opacity = stage_status == "pending" ? 0.3 : (stage_status.start_with?("skipped") ? 0.45 : 1) %>
+                <span style="--gp-width:<%= (value.to_f / count * 100).round(2) %>%;--gp-status:var(--st-<%= color_status %>);--gp-opacity:<%= opacity %>" title="<%= value %> <%= stage_status %>"></span>
+              <% end %>
+            </span>
+            <span class="gp-lane-note" title="<%= notes.join(', ') %>"><%= notes.join(", ") %></span>
+          </div>
+        <% end %>
+      </div>
+    <% end %>
+  </div>
+
+  <div class="gp-graph-panel" <%= "hidden" if stage_first %>>
+    <div class="gp-diagram-container"
+         <% unless overflow %>data-graph="<%= h(graph.to_json) %>"<% end %>
+         data-graph-kind="<%= definition ? 'definition' : 'execution' %>"
+         data-edge-count="<%= edge_count %>">
+      <div class="gp-diagram-viewport">
+        <div class="gp-diagram-canvas"><div class="gp-diagram-fallback">Rendering graph…</div></div>
+      </div>
+      <noscript><div class="gp-diagram-fallback">JavaScript is required to render this pipeline graph.</div></noscript>
+    </div>
+  </div>
+</section>

data/app/views/good_pipeline/pipelines/_filter_bar.html.erb

@@ -0,0 +1,51 @@
+<%
+  filters = local_assigns[:filters] || @filters
+  status = filters.respond_to?(:status) ? filters.status : (params[:status].presence || "all")
+  time = filters.respond_to?(:time) ? filters.time : (params[:time].presence || "all")
+  query = filters.respond_to?(:query) ? filters.query : params[:q].to_s
+  base = request.query_parameters.except("page", "expanded")
+  status_counts = @status_counts || {}
+%>
+<div class="gp-filter-bar">
+  <form class="gp-search-form" action="<%= pipelines_path %>" method="get" role="search" data-gp-search-form>
+    <label class="gp-search" for="gp-search">
+      <svg viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M7 12a5 5 0 1 0 0-10 5 5 0 0 0 0 10zM11 11l3 3"></path></svg>
+      <span class="gp-sr-only">Search pipeline executions</span>
+      <input id="gp-search" type="search" name="q" value="<%= query %>" placeholder="search execution id or pipeline type…" autocomplete="off">
+    </label>
+  </form>
+
+  <div id="gp-filters">
+    <div class="gp-status-filter-scroll">
+      <div class="gp-segment" role="group" aria-label="Status filter">
+        <span class="gp-segment-label">status</span>
+        <% %w[all running canceling succeeded failed halted canceled skipped].each do |value| %>
+          <%
+            href_params = base.merge("status" => value).except("page", "expanded")
+            count = value == "all" ? status_counts.values.sum : status_counts.fetch(value, 0)
+          %>
+          <%= link_to pipelines_path(href_params),
+                      class: "gp-segment-link #{'is-active' if status == value}",
+                      aria: ({ current: "page" } if status == value),
+                      data: { gp_partial_link: true, gp_segment: "status", gp_segment_value: value,
+                              gp_status_count: count } do %>
+            <span><%= value %></span><span class="gp-segment-count"><%= format_number(count) %></span>
+          <% end %>
+        <% end %>
+      </div>
+    </div>
+
+    <div class="gp-segment" role="group" aria-label="Time filter">
+      <span class="gp-segment-label">time</span>
+      <% %w[24h 7d 30d all].each do |value| %>
+        <% href_params = base.merge("time" => value).except("page", "expanded") %>
+        <%= link_to value, pipelines_path(href_params),
+                    class: "gp-segment-link #{'is-active' if time == value}",
+                    aria: ({ current: "page" } if time == value),
+                    data: { gp_partial_link: true, gp_segment: "time", gp_segment_value: value } %>
+      <% end %>
+    </div>
+
+    <%= link_to "clear", pipelines_path, class: "gp-filter-clear" %>
+  </div>
+</div>

data/app/views/good_pipeline/pipelines/_kpi_strip.html.erb

@@ -0,0 +1,74 @@
+<%
+  kpis = local_assigns[:kpis] || @kpis
+  total = (local_assigns[:total] || @total || 0).to_i
+  get = lambda do |key, fallback = nil|
+    if kpis.respond_to?(key)
+      kpis.public_send(key)
+    elsif kpis.respond_to?(:[])
+      kpis[key] || kpis[key.to_s] || fallback
+    else
+      fallback
+    end
+  rescue NameError, IndexError, KeyError, TypeError
+    fallback
+  end
+  duration = lambda do |seconds|
+    next "—" if seconds.nil?
+    value = seconds.to_f.to_i
+    if value < 60
+      "#{value}s"
+    elsif value < 3_600
+      "#{value / 60}m #{value % 60}s"
+    else
+      "#{value / 3_600}h #{(value % 3_600) / 60}m"
+    end
+  end
+  failed = get.call(:failed_7d, 0).to_i
+  prior = get.call(:failed_prior_7d, 0).to_i
+  comparison = if prior.zero?
+    "—"
+  else
+    pct = ((failed - prior).to_f / prior * 100).round
+    "#{pct.positive? ? '+' : ''}#{pct}% vs prior"
+  end
+  sparkline_value = get.call(:sparkline)
+  sparkline_value = get.call(:buckets, []) if sparkline_value.nil?
+  sparkline = Array(sparkline_value).last(14)
+  sparkline = Array.new(14 - sparkline.length, 0) + sparkline if sparkline.length < 14
+  spark_max = [sparkline.map(&:to_i).max.to_i, 1].max
+%>
+<div class="gp-kpi-strip">
+  <div class="gp-kpi">
+    <div class="gp-kpi-label">filtered rows</div>
+    <div class="gp-kpi-value"><%= number_with_delimiter(total) %></div>
+    <div class="gp-kpi-sub">selected segment</div>
+  </div>
+  <div class="gp-kpi">
+    <div class="gp-kpi-label">running now</div>
+    <div class="gp-kpi-value gp-kpi-value--running"><%= number_with_delimiter(get.call(:running_now, 0)) %></div>
+    <div class="gp-kpi-sub"><%= number_with_delimiter(get.call(:enqueued_steps, 0)) %> enqueued steps</div>
+  </div>
+  <div class="gp-kpi">
+    <div class="gp-kpi-label">last 24h</div>
+    <div class="gp-kpi-value"><%= number_with_delimiter(get.call(:last_24h, 0)) %></div>
+    <div class="gp-kpi-sub">executions</div>
+  </div>
+  <div class="gp-kpi">
+    <div class="gp-kpi-label">failed · 7d</div>
+    <div class="gp-kpi-value gp-kpi-value--failed"><%= number_with_delimiter(failed) %></div>
+    <div class="gp-kpi-sub"><%= comparison %></div>
+  </div>
+  <div class="gp-kpi">
+    <div class="gp-kpi-label">p50 duration</div>
+    <div class="gp-kpi-value"><%= duration.call(get.call(:p50)) %></div>
+    <div class="gp-kpi-sub">p95 <%= duration.call(get.call(:p95)) %></div>
+  </div>
+  <div class="gp-kpi">
+    <div class="gp-kpi-label">executions · 14d</div>
+    <div class="gp-spark" aria-label="Execution counts for the last 14 days">
+      <% sparkline.each_with_index do |bucket, index| %>
+        <span class="gp-spark-bar" style="--gp-height:<%= (bucket.to_f / spark_max * 100).round(2) %>%" title="<%= bucket %> on day -<%= 13 - index %>"></span>
+      <% end %>
+    </div>
+  </div>
+</div>

data/app/views/good_pipeline/pipelines/_pager.html.erb

@@ -0,0 +1,31 @@
+<%
+  page = local_assigns[:page] || @page || {}
+  get = ->(key, default) { page.respond_to?(key) ? page.public_send(key) : (page[key] || page[key.to_s] || default) }
+  current = get.call(:current, 1).to_i
+  last = [get.call(:last, 1).to_i, 1].max
+  per_page = get.call(:per_page, 25).to_i
+  total = get.call(:total, @total || 0).to_i
+  from = total.zero? ? 0 : ((current - 1) * per_page) + 1
+  to = [current * per_page, total].min
+  base = request.query_parameters.except("expanded", "page")
+%>
+<div class="gp-pager">
+  <span class="gp-pager-info"><span class="mono"><%= number_with_delimiter(from) %></span>–<span class="mono"><%= number_with_delimiter(to) %></span><span> of </span><span class="mono"><%= number_with_delimiter(total) %></span></span>
+  <span class="gp-pager-buttons">
+    <% if current <= 1 %>
+      <button class="gp-page-button" type="button" disabled aria-label="First page">«</button>
+      <button class="gp-page-button" type="button" disabled aria-label="Previous page">‹</button>
+    <% else %>
+      <%= link_to "«", pipelines_path(base.merge("page" => 1)), class: "gp-page-button", aria: { label: "First page" }, data: { gp_partial_link: true } %>
+      <%= link_to "‹", pipelines_path(base.merge("page" => current - 1)), class: "gp-page-button", aria: { label: "Previous page" }, data: { gp_partial_link: true } %>
+    <% end %>
+    <span class="gp-page-label">page <span class="mono"><%= current %></span> / <span class="mono"><%= last %></span></span>
+    <% if current >= last %>
+      <button class="gp-page-button" type="button" disabled aria-label="Next page">›</button>
+      <button class="gp-page-button" type="button" disabled aria-label="Last page">»</button>
+    <% else %>
+      <%= link_to "›", pipelines_path(base.merge("page" => current + 1)), class: "gp-page-button", aria: { label: "Next page" }, data: { gp_partial_link: true } %>
+      <%= link_to "»", pipelines_path(base.merge("page" => last)), class: "gp-page-button", aria: { label: "Last page" }, data: { gp_partial_link: true } %>
+    <% end %>
+  </span>
+</div>

data/app/views/good_pipeline/pipelines/_row.html.erb

@@ -0,0 +1,103 @@
+<%
+  now = @now || Time.current
+  expanded_id = filters.respond_to?(:expanded) ? filters.expanded : params[:expanded].presence
+  is_open = expanded_id.to_s == pipeline.id.to_s
+  status = pipeline.status.to_s
+  status_meta = {
+    "pending" => ["○", "pending", "pending"],
+    "running" => ["●", "running", "running"],
+    "enqueued" => ["●", "enqueued", "running"],
+    "canceling" => ["◐", "canceling", "canceling"],
+    "canceled" => ["⊘", "canceled", "canceled"],
+    "succeeded" => ["✓", "succeeded", "succeeded"],
+    "failed" => ["✗", "failed", "failed"],
+    "halted" => ["⊘", "halted", "halted"],
+    "skipped" => ["⊘", "skipped", "skipped"],
+    "skipped_by_branch" => ["⊘", "skipped·br", "skipped"]
+  }.freeze
+  glyph, status_label, status_color = status_meta.fetch(status, ["○", status, "pending"])
+  short = respond_to?(:short_type) ? short_type(pipeline.type) : humanized_type(pipeline.type).sub(/\s*Pipeline\z/, "")
+  relative = lambda do |time|
+    seconds = [(now - time).to_i, 0].max
+    if seconds < 60 then "#{seconds}s ago"
+    elsif seconds < 3_600 then "#{seconds / 60}m ago"
+    elsif seconds < 86_400 then "#{seconds / 3_600}h ago"
+    else "#{seconds / 86_400}d ago"
+    end
+  end
+  duration = lambda do |seconds|
+    next "—" if seconds.nil?
+    value = seconds.to_f.to_i
+    if value < 60 then "#{value}s"
+    elsif value < 3_600 then "#{value / 60}m #{value % 60}s"
+    else "#{value / 3_600}h #{(value % 3_600) / 60}m"
+    end
+  end
+  elapsed = ((pipeline.terminal? ? pipeline.updated_at : now) - pipeline.created_at).to_f
+  counts = steps.each_with_object(Hash.new(0)) { |step, memo| memo[step.coordination_status.to_s] += 1 }
+  done = counts["succeeded"]
+  many = steps.length > 12
+  stack_order = %w[succeeded failed halted enqueued running pending canceled skipped skipped_by_branch]
+  status_var = ->(value) { value == "enqueued" ? "running" : value.start_with?("skipped") ? "skipped" : value }
+  params_preview = pipeline.params.to_h.map { |key, value| "#{key}=#{value.to_json}" }.join(" · ")
+  href_params = request.query_parameters.except("expanded")
+  href_params["expanded"] = pipeline.id.to_s unless is_open
+  expand_url = pipelines_path(href_params)
+%>
+<tr class="gp-row <%= 'is-open' if is_open %>"
+    data-gp-expand-url="<%= expand_url %>"
+    data-id="<%= pipeline.id %>"
+    <% if is_open %>data-collapse-expand<% end %>>
+  <td class="gp-td-expand">
+    <%= link_to(is_open ? "▾" : "▸", expand_url,
+                aria: { label: is_open ? "Collapse execution" : "Expand execution", expanded: is_open },
+                data: { gp_partial_link: true }) %>
+  </td>
+  <td>
+    <div class="gp-when-rel"><%= relative.call(pipeline.created_at) %></div>
+    <time class="gp-when-abs" datetime="<%= pipeline.created_at.utc.iso8601 %>"><%= pipeline.created_at.utc.strftime("%Y-%m-%d %H:%M:%SZ") %></time>
+  </td>
+  <td>
+    <span class="gp-execution-cell">
+    <span class="gp-execution-name"><%= short %></span>
+    <span class="gp-execution-id">#<%= pipeline.id.to_s.first(8) %></span>
+    <button class="gp-copy" type="button" title="Copy execution id" data-gp-copy="<%= pipeline.id %>" data-gp-copy-label="execution id">
+      <svg viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><rect x="5" y="5" width="9" height="9" rx="1.5"></rect><path d="M11 5V3a1 1 0 0 0-1-1H3a1 1 0 0 0-1 1v7a1 1 0 0 0 1 1h2"></path></svg>
+    </button>
+    <%= link_to pipeline_path(pipeline), class: "gp-open-detail", title: "Open detail page", aria: { label: "Open execution detail" } do %>
+      <svg viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M9 3.5h3.5V7"></path><path d="M12.5 3.5 7.5 8.5"></path><path d="M12 10v2a1.5 1.5 0 0 1-1.5 1.5h-7A1.5 1.5 0 0 1 2 12V5a1.5 1.5 0 0 1 1.5-1.5H6"></path></svg>
+    <% end %>
+    </span>
+  </td>
+  <td title="<%= done %> succeeded steps of <%= steps.length %> total steps">
+    <% if many %>
+      <span class="gp-step-stack" aria-hidden="true">
+        <% stack_order.each do |step_status| %>
+          <% next if counts[step_status].zero? %>
+          <% opacity = step_status == "pending" ? 0.3 : (step_status.start_with?("skipped") ? 0.45 : 1) %>
+          <span style="--gp-width:<%= (counts[step_status].to_f / steps.length * 100).round(2) %>%;--gp-status:var(--st-<%= status_var.call(step_status) %>);--gp-opacity:<%= opacity %>" title="<%= counts[step_status] %> <%= step_status %>"></span>
+        <% end %>
+      </span>
+    <% else %>
+      <span class="gp-step-dots" aria-hidden="true">
+        <% steps.each do |step| %>
+          <% step_status = step.coordination_status.to_s; branch = step.respond_to?(:branch_step?) ? step.branch_step? : step.job_class == GoodPipeline::BRANCH_JOB_CLASS; barrier = step.respond_to?(:barrier_step?) ? step.barrier_step? : step.job_class == GoodPipeline::BARRIER_JOB_CLASS %>
+          <span class="gp-step-dot <%= 'is-branch' if branch %> <%= 'is-barrier' if barrier %>" style="--gp-status:var(--st-<%= status_var.call(step_status) %>);--gp-opacity:<%= step_status == 'pending' ? 0.35 : 1 %>" title="<%= step_display_key(step) %>: <%= step_status %>"></span>
+        <% end %>
+      </span>
+    <% end %>
+    <span class="gp-step-summary"><%= done %>/<%= steps.length %></span>
+  </td>
+  <td><span class="gp-status gp-status--<%= status %>"><%= glyph %> <%= status_label %></span></td>
+  <td class="mono"><%= duration.call(elapsed) %></td>
+  <td><span class="gp-params-preview"><%= params_preview %></span></td>
+</tr>
+<% if is_open %>
+  <tr class="gp-row-detail">
+    <td colspan="7">
+      <%= render "row_detail", pipeline: pipeline, steps: steps,
+                 timings: (@step_timings || {}), lanes: (@stage_lanes || []),
+                 dependencies: (@expanded_dependencies || []) %>
+    </td>
+  </tr>
+<% end %>

data/app/views/good_pipeline/pipelines/_row_detail.html.erb

@@ -0,0 +1,93 @@
+<%
+  get = lambda do |object, key|
+    if object.respond_to?(key)
+      object.public_send(key)
+    elsif object.respond_to?(:[])
+      object[key] || object[key.to_s]
+    end
+  rescue NameError, IndexError, KeyError, TypeError
+    nil
+  end
+  status_meta = {
+    "pending" => ["○", "pending", "pending"], "running" => ["●", "running", "running"],
+    "enqueued" => ["●", "enqueued", "running"], "succeeded" => ["✓", "succeeded", "succeeded"],
+    "failed" => ["✗", "failed", "failed"], "halted" => ["⊘", "halted", "halted"],
+    "canceled" => ["⊘", "canceled", "canceled"], "skipped" => ["⊘", "skipped", "skipped"],
+    "skipped_by_branch" => ["⊘", "skipped·br", "skipped"]
+  }.freeze
+  duration = lambda do |seconds|
+    next "—" if seconds.nil?
+    value = seconds.to_f.to_i
+    if value < 60 then "#{value}s"
+    elsif value < 3_600 then "#{value / 60}m #{value % 60}s"
+    else "#{value / 3_600}h #{(value % 3_600) / 60}m"
+    end
+  end
+  timing_for = lambda do |step|
+    timings[step.good_job_id] || timings[step.good_job_id.to_s] || timings[step.id] || timings[step.id.to_s]
+  end
+  timing_parts = lambda do |timing|
+    if timing.is_a?(Array)
+      timing
+    else
+      [get.call(timing, :performed_at) || get.call(timing, :started_at), get.call(timing, :finished_at)]
+    end
+  end
+  priority = { "failed" => 0, "halted" => 1, "enqueued" => 2, "running" => 2, "pending" => 3, "canceled" => 4 }.freeze
+  table_steps = steps.length > 12 ? steps.sort_by { |step| [priority.fetch(step.coordination_status.to_s, 9), step.created_at, step.id.to_s] } : steps
+  done = steps.count { |step| step.coordination_status.to_s == "succeeded" }
+  total_duration = ((pipeline.terminal? ? pipeline.updated_at : (@now || Time.current)) - pipeline.created_at).to_f
+  ruby_snippet = %(GoodPipeline::PipelineRecord.find("#{pipeline.id}"))
+  sql_snippet = "SELECT *\nFROM good_pipeline_pipelines\nWHERE id = '#{pipeline.id}';"
+%>
+<div class="gp-row-detail-inner">
+  <div class="gp-detail-grid">
+    <section class="gp-detail-section">
+      <h3 class="gp-section-heading">steps <span class="gp-heading-meta"><%= steps.length > 12 ? "#{steps.length} steps · failures & active first" : "#{done}/#{steps.length}" %></span></h3>
+      <div class="gp-scroll-steps">
+        <table class="gp-compact-table">
+          <tbody>
+            <% table_steps.each do |step| %>
+              <% step_status = step.coordination_status.to_s; glyph, label, = status_meta.fetch(step_status, ["○", step_status, "pending"]); timing = timing_for.call(step); started_at, finished_at = timing_parts.call(timing); step_duration = started_at && finished_at ? finished_at - started_at : nil %>
+              <tr>
+                <td class="gp-step-key"><%= step_display_key(step) %></td>
+                <td class="gp-job-class" title="<%= step.job_class %>"><%= step.job_class %></td>
+                <td><span class="gp-status gp-status--<%= step_status %>"><%= glyph %> <%= label %></span></td>
+                <td class="gp-step-duration"><%= duration.call(step_duration) %></td>
+              </tr>
+            <% end %>
+          </tbody>
+        </table>
+      </div>
+    </section>
+
+    <section class="gp-detail-section">
+      <h3 class="gp-section-heading">params · identity <span class="gp-strategy gp-strategy--<%= pipeline.on_failure_strategy %>">on_failure: <%= pipeline.on_failure_strategy %></span></h3>
+      <table class="gp-kv"><tbody>
+        <tr><td class="gp-kv-key">id</td><td class="gp-kv-value"><%= pipeline.id %></td></tr>
+        <tr><td class="gp-kv-key">type</td><td class="gp-kv-value"><%= pipeline.type %></td></tr>
+        <tr><td class="gp-kv-key">params</td><td class="gp-kv-value"><%= pipeline.params.to_json %></td></tr>
+        <tr><td class="gp-kv-key">created_at</td><td class="gp-kv-value"><%= pipeline.created_at.utc.strftime("%Y-%m-%d %H:%M:%SZ") %></td></tr>
+        <tr><td class="gp-kv-key">status</td><td class="gp-kv-value"><%= pipeline.status %></td></tr>
+      </tbody></table>
+      <%= render "actions", pipeline: pipeline, detail_link: true %>
+    </section>
+
+    <section class="gp-detail-section gp-detail-wide">
+      <h3 class="gp-section-heading"><%= steps.length > 12 ? "stage timeline (#{lanes.length} stages · #{steps.length} steps)" : "step timeline" %><span class="gp-heading-meta">total <%= duration.call(total_duration) %></span></h3>
+      <%= render "timeline", lanes: lanes %>
+    </section>
+
+    <section class="gp-detail-section gp-detail-wide">
+      <h3 class="gp-section-heading">requery</h3>
+      <div class="gp-code-wrap">
+        <button class="gp-copy" type="button" title="Copy Ruby snippet" data-gp-copy="<%= ruby_snippet %>" data-gp-copy-label="Ruby snippet"><svg viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5" aria-hidden="true"><rect x="5" y="5" width="9" height="9" rx="1.5"></rect><path d="M11 5V3a1 1 0 0 0-1-1H3a1 1 0 0 0-1 1v7a1 1 0 0 0 1 1h2"></path></svg></button>
+        <pre class="gp-code"><%= ruby_snippet %></pre>
+      </div>
+      <div class="gp-code-wrap">
+        <button class="gp-copy" type="button" title="Copy SQL snippet" data-gp-copy="<%= sql_snippet %>" data-gp-copy-label="SQL snippet"><svg viewBox="0 0 16 16" fill="none" stroke="currentColor" stroke-width="1.5" aria-hidden="true"><rect x="5" y="5" width="9" height="9" rx="1.5"></rect><path d="M11 5V3a1 1 0 0 0-1-1H3a1 1 0 0 0-1 1v7a1 1 0 0 0 1 1h2"></path></svg></button>
+        <pre class="gp-code"><%= sql_snippet %></pre>
+      </div>
+    </section>
+  </div>
+</div>

data/app/views/good_pipeline/pipelines/_sidebar.html.erb

@@ -0,0 +1,115 @@
+<%
+  entries = Array(local_assigns[:entries] || @sidebar_entries)
+  filters = local_assigns[:filters] || @filters
+  mode = local_assigns.fetch(:mode, :executions)
+  get = lambda do |object, key|
+    if object.respond_to?(key)
+      object.public_send(key)
+    elsif object.respond_to?(:[])
+      object[key] || object[key.to_s]
+    end
+  rescue NameError, IndexError, KeyError, TypeError
+    nil
+  end
+  current_type = filters.respond_to?(:pipeline_type) ? filters.pipeline_type : params[:pipeline_type].presence
+  counts = entries.map { |entry| (get.call(entry, mode == :definitions ? :step_count : :run_count) || get.call(entry, :count) || 0).to_i }
+  max_count = [counts.max.to_i, 1].max
+  total_runs = entries.sum { |entry| (get.call(entry, :run_count) || get.call(entry, :count) || 0).to_i }
+  base_params = request.query_parameters.except("pipeline_type", "page", "expanded")
+  retention_seconds = local_assigns[:retention_seconds] || @retention_seconds
+  retention_seconds ||= if defined?(GoodJob) && GoodJob.respond_to?(:configuration)
+    GoodJob.configuration.cleanup_preserved_jobs_before_seconds_ago
+  end
+  retention_label = if retention_seconds
+    seconds = retention_seconds.to_i
+    if seconds >= 86_400 && (seconds % 86_400).zero?
+      "#{seconds / 86_400}d"
+    elsif seconds >= 3_600 && (seconds % 3_600).zero?
+      "#{seconds / 3_600}h"
+    else
+      "#{seconds}s"
+    end
+  else
+    "configured"
+  end
+%>
+<aside class="gp-sidebar">
+  <div class="gp-sidebar-head">
+    <span class="gp-brand">
+      <span class="gp-brand-mark" aria-hidden="true">gp</span>
+      <span class="gp-brand-name">good_pipeline</span>
+      <span class="gp-brand-version">v<%= GoodPipeline::VERSION %></span>
+    </span>
+  </div>
+
+  <% if mode == :definitions %>
+    <%= link_to pipelines_path, class: "gp-sidebar-row gp-sidebar-all" do %>
+      <span class="gp-sidebar-label"><span aria-hidden="true">←</span> All executions</span>
+      <span class="gp-sidebar-count"><%= number_with_delimiter(total_runs) %></span>
+    <% end %>
+  <% else %>
+    <%= link_to pipelines_path(base_params), class: "gp-sidebar-row gp-sidebar-all #{'is-active' if current_type.blank?}", aria: ({ current: "page" } if current_type.blank?) do %>
+      <span class="gp-sidebar-label"><span class="gp-sidebar-dot"></span>All executions</span>
+      <span class="gp-sidebar-count"><%= number_with_delimiter(total_runs) %></span>
+    <% end %>
+  <% end %>
+
+  <div class="gp-sidebar-scroll">
+    <div class="gp-sidebar-group">
+      <div class="gp-sidebar-group-head">
+        <span><%= mode == :definitions ? "definitions" : "pipelines" %></span>
+        <span class="gp-sidebar-group-count"><%= entries.length %></span>
+      </div>
+      <% entries.each_with_index do |entry, index| %>
+        <%
+          type = get.call(entry, :type).to_s
+          strategy = (get.call(entry, :on_failure_strategy) || get.call(entry, :strategy) || "halt").to_s
+          count = (get.call(entry, mode == :definitions ? :step_count : :run_count) || get.call(entry, :count) || 0).to_i
+          step_count = (get.call(entry, :step_count) || 0).to_i
+          has_branch = !!get.call(entry, :has_branch)
+          short = respond_to?(:short_type) ? short_type(type) : humanized_type(type).sub(/\s*Pipeline\z/, "")
+        %>
+        <% if mode == :definitions %>
+          <button type="button"
+                  class="gp-sidebar-row gp-definition-item <%= 'is-active' if index.zero? %>"
+                  data-gp-definition-target="gp-definition-<%= index %>"
+                  data-gp-definition-name="<%= short %>"
+                  data-gp-definition-meta="<%= step_count %> steps · <%= strategy %>">
+            <span class="gp-sidebar-bar" style="--gp-width:<%= (count.to_f / max_count * 100).round(2) %>%"></span>
+            <span class="gp-sidebar-label">
+              <span class="gp-sidebar-dot strategy-<%= strategy %>" title="on_failure: <%= strategy %>"></span>
+              <span class="gp-sidebar-name"><%= short %></span>
+              <% if has_branch %><span class="gp-sidebar-tag" title="has conditional branch">br</span><% end %>
+              <% if step_count > 60 %><span class="gp-sidebar-tag gp-sidebar-tag--xl" title="<%= step_count %> steps">xl</span><% end %>
+            </span>
+            <span class="gp-sidebar-count"><%= number_with_delimiter(count) %></span>
+          </button>
+        <% else %>
+          <% active = current_type == type %>
+          <%= link_to pipelines_path(base_params.merge("pipeline_type" => type)), class: "gp-sidebar-row #{'is-active' if active}", aria: ({ current: "page" } if active) do %>
+            <span class="gp-sidebar-bar" style="--gp-width:<%= (count.to_f / max_count * 100).round(2) %>%"></span>
+            <span class="gp-sidebar-label">
+              <span class="gp-sidebar-dot strategy-<%= strategy %>" title="on_failure: <%= strategy %>"></span>
+              <span class="gp-sidebar-name"><%= short %></span>
+              <% if has_branch %><span class="gp-sidebar-tag" title="has conditional branch">br</span><% end %>
+              <% if step_count > 60 %><span class="gp-sidebar-tag gp-sidebar-tag--xl" title="<%= step_count %> steps">xl</span><% end %>
+            </span>
+            <span class="gp-sidebar-count"><%= number_with_delimiter(count) %></span>
+          <% end %>
+        <% end %>
+      <% end %>
+    </div>
+  </div>
+
+  <div class="gp-sidebar-foot">
+    <div class="gp-legend">
+      <span><i class="strategy-halt" style="background:var(--strat-halt)"></i> halt</span>
+      <span><i class="strategy-continue" style="background:var(--strat-continue)"></i> continue</span>
+      <span><i class="strategy-ignore" style="background:var(--strat-ignore)"></i> ignore</span>
+    </div>
+    <div class="gp-retention" title="Terminal pipelines are pruned with GoodJob's cleanup cycle">
+      <span class="gp-retention-label"><%= mode == :definitions ? "column" : "retention" %></span>
+      <span class="gp-retention-value"><%= mode == :definitions ? "steps per definition" : "#{retention_label} · goodjob" %></span>
+    </div>
+  </div>
+</aside>