solid_stack_web 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3159278d6dd76fc0e54660ab9c11536a63037815771ff04206adca43b800c4ef
-  data.tar.gz: 05f47e20a15b2f70cbf216713cb4c18da3e3f569b64eb1a271543489fecb95c1
+  metadata.gz: 3d16b6a549b38e32fd792d4bff55d990ae5a80d458dcbc47df54759c947536c6
+  data.tar.gz: 2ff73287be32fa8a3d3a1089ebd71656bed2ce80742cd11296a3458e0ebeaae3
 SHA512:
-  metadata.gz: cdd04812d4cdfa1d3c48ff2a81319f8956b71afee1dded7dbce009797822248e422990f02134fbb4f3c88e6e2e2702c2c91c78d94a6d04e28ebd8d1a2b0022b9
-  data.tar.gz: 431b97295f3682b1512b09ece023c280997560d4b4f065ef742411fddc63275c8257f0d34d02f6bb0589a555c8677d0515301cabfc8b0768465fd42ff6599a54
+  metadata.gz: bd5aefe87facc4b0ac5f9c2265fa714d6d70127b4c785fc450a210dbcb0958bd03b7aef09de7b0555d4b54de7defe702a464c296357fdb49411b5b532dce341d
+  data.tar.gz: 8a0527f29907807f16711e72bbfc13833a0be47481d4e540e1ad1a324dad63eb73da4c5f5c0043bfcdfd6ae458d5163af66e2e350fd9c5ecd76fe13c70b35913

data/README.md

@@ -114,7 +114,13 @@ Filters are preserved when switching between status tabs (Ready / Scheduled / Ru
 
 ## Solid Cable
 
-_Channel monitoring coming in v0.6.0. Currently shows active message count and distinct channel count on the overview dashboard._
+### Features
+
+- **Dashboard card** — the overview dashboard shows total messages, channels, messages per hour (last 60 minutes), oldest pending message age, and a top-3 channel breakdown by volume
+- **24-hour timeline** — bar chart of message volume on the Cable overview page; each bar represents one hour with a hover tooltip showing the exact count
+- **Channel browser** — `GET /cable` lists all active channels with per-channel message count and last-message timestamp, ordered by most recent activity; supports `?q=` filtering by channel name substring; empty state shown when no messages exist
+- **Per-channel message list** — `GET /cable/channels/:channel_hash` shows a paginated, reverse-chronological list of that channel's `SolidCable::Message` records; each row shows the message ID, a truncated payload preview (120 chars) with the full payload on hover, and a relative sent time with the exact timestamp on hover; supports `?q=` filtering by payload substring; **Purge Channel** button deletes all messages for the channel
+- **Message purge** — "Purge Old" form on the channel browser deletes all messages older than 1, 7, or 30 days; confirmation prompt before any destructive action
 
 ---
 
@@ -137,7 +143,7 @@ _Channel monitoring coming in v0.6.0. Currently shows active message count and d
     "slow_jobs": 7
   },
   "cache": { "entries": 1024, "byte_size": 2097152, "oldest_entry": "2026-05-20T10:00:00Z" },
-  "cable": { "messages": 50, "channels": 3 },
+  "cable": { "messages": 50, "channels": 3, "messages_per_hour": 12, "oldest_message": "2026-05-20T10:00:00Z", "top_channels": { "ActionCable::Channel::Base": 30, "ChatChannel": 15, "NotificationsChannel": 5 } },
   "generated_at": "2026-05-26T10:00:00Z"
 }
 ```

data/app/assets/stylesheets/solid_stack_web/_07_dashboard.css

@@ -114,6 +114,7 @@ a.sqw-inline-stat:hover { opacity: 0.7; text-decoration: none; }
   grid-template-columns: 1fr 1fr;
   gap: 0;
   margin-top: 1.5rem;
+  margin-bottom: 1.5rem;
   border: 1px solid var(--border);
   border-radius: var(--radius);
   background: var(--surface);
@@ -121,11 +122,19 @@ a.sqw-inline-stat:hover { opacity: 0.7; text-decoration: none; }
   overflow: hidden;
 }
 
+.sqw-timeline-grid--single {
+  grid-template-columns: 1fr;
+}
+
 .sqw-timeline-chart {
   border-top: none;
   color: var(--purple);
 }
 
+.sqw-timeline-chart--cable {
+  color: var(--info);
+}
+
 .sqw-timeline-chart + .sqw-timeline-chart {
   border-left: 1px solid var(--border);
 }
@@ -160,4 +169,43 @@ a.sqw-inline-stat:hover { opacity: 0.7; text-decoration: none; }
   color: var(--muted);
   margin-top: 3px;
   opacity: 0.7;
-}
+}
+
+.sqw-card-list {
+  padding: 0.75rem 1.25rem 1rem;
+  border-top: 1px solid var(--border);
+}
+
+.sqw-card-list__label {
+  display: block;
+  font-size: 10px;
+  font-weight: 500;
+  text-transform: uppercase;
+  letter-spacing: .06em;
+  color: var(--muted);
+  margin-bottom: 0.5rem;
+}
+
+.sqw-card-list__row {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 0.5rem;
+  padding: 0.2rem 0;
+}
+
+.sqw-card-list__name {
+  font-size: 12px;
+  color: var(--text);
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  min-width: 0;
+}
+
+.sqw-card-list__count {
+  font-size: 12px;
+  font-weight: 600;
+  color: var(--info);
+  flex-shrink: 0;
+}

data/app/assets/stylesheets/solid_stack_web/_08_filters.css

@@ -30,6 +30,12 @@
   cursor: pointer;
 }
 
+.sqw-inline-form {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.4rem;
+}
+
 .sqw-period-filter {
   display: flex;
   border: 1px solid var(--border);

data/app/controllers/solid_stack_web/cable/channel_purges_controller.rb

@@ -0,0 +1,8 @@
+module SolidStackWeb
+  class Cable::ChannelPurgesController < ApplicationController
+    def destroy
+      ::SolidCable::Message.where(channel_hash: params[:channel_hash]).delete_all
+      redirect_to cable_path, notice: "All messages for this channel have been purged."
+    end
+  end
+end

data/app/controllers/solid_stack_web/cable/purges_controller.rb

@@ -0,0 +1,9 @@
+module SolidStackWeb
+  class Cable::PurgesController < ApplicationController
+    def destroy
+      days = [params[:older_than].to_i, 1].max
+      ::SolidCable::Message.where("created_at < ?", days.days.ago).delete_all
+      redirect_to cable_path, notice: "Messages older than #{days} #{days == 1 ? "day" : "days"} purged."
+    end
+  end
+end

data/app/controllers/solid_stack_web/cable_controller.rb

@@ -1,8 +1,27 @@
 module SolidStackWeb
   class CableController < ApplicationController
     def index
+      @search         = params[:q].presence
       @total_messages = ::SolidCable::Message.count
-      @channels       = ::SolidCable::Message.distinct.pluck(:channel).sort
+      @channels       = channel_rows
+      @timeline       = CableTimeline.new
+    end
+
+    private
+
+    def channel_rows
+      scope = ::SolidCable::Message
+      if @search
+        scope = scope.where("channel LIKE ?", "%#{::ActiveRecord::Base.sanitize_sql_like(@search)}%")
+      end
+      scope
+        .group(:channel, :channel_hash)
+        .order(Arel.sql("MAX(created_at) DESC"))
+        .pluck(:channel, :channel_hash, Arel.sql("COUNT(*)"), Arel.sql("MAX(created_at)"))
+        .map do |ch, hash, cnt, last_at|
+          last_at = Time.zone.parse(last_at) if last_at.is_a?(String)
+          { channel: ch, channel_hash: hash, message_count: cnt, last_message_at: last_at }
+        end
     end
   end
 end

data/app/controllers/solid_stack_web/cable_messages_controller.rb

@@ -0,0 +1,13 @@
+module SolidStackWeb
+  class CableMessagesController < ApplicationController
+    def index
+      @search = params[:q].presence
+      scope   = ::SolidCable::Message.where(channel_hash: params[:channel_hash])
+      if @search
+        scope = scope.where("payload LIKE ?", "%#{::ActiveRecord::Base.sanitize_sql_like(@search)}%")
+      end
+      @channel_name    = ::SolidCable::Message.where(channel_hash: params[:channel_hash]).pick(:channel) || params[:channel_hash]
+      @pagy, @messages = pagy(scope.order(created_at: :desc))
+    end
+  end
+end

data/app/helpers/solid_stack_web/application_helper.rb

@@ -42,6 +42,18 @@ module SolidStackWeb
       end
     end
 
+    def cable_messages_timeline_svg(timeline)
+      build_sparkline_svg(
+        Struct.new(:buckets, :max).new(timeline.message_buckets, timeline.message_max),
+        css_class: "sqw-sparkline sqw-sparkline--lg",
+        aria_label: "Cable messages over the last 24 hours"
+      ) do |count, i|
+        hours_ago = CableTimeline::HOURS - 1 - i
+        label = count == 1 ? "message" : "messages"
+        hours_ago.zero? ? "#{count} #{label} this hour" : "#{count} #{label} #{hours_ago}h ago"
+      end
+    end
+
     def throughput_sparkline_svg(sparkline)
       build_sparkline_svg(sparkline, aria_label: "Throughput over the last 12 hours") do |count, i|
         hours_ago = SolidStackWeb::ThroughputSparkline::HOURS - i

data/app/models/solid_stack_web/cable_stats.rb

@@ -2,9 +2,22 @@ module SolidStackWeb
   class CableStats
     def to_h
       {
-        messages: ::SolidCable::Message.count,
-        channels: ::SolidCable::Message.distinct.count(:channel)
+        messages:          ::SolidCable::Message.count,
+        channels:          ::SolidCable::Message.distinct.count(:channel),
+        messages_per_hour: ::SolidCable::Message.where(created_at: 1.hour.ago..).count,
+        oldest_message:    ::SolidCable::Message.minimum(:created_at),
+        top_channels:      top_channels_by_volume
       }
     end
+
+    private
+
+    def top_channels_by_volume
+      ::SolidCable::Message
+        .group(:channel)
+        .order(Arel.sql("count(*) DESC"))
+        .limit(3)
+        .count
+    end
   end
 end

data/app/models/solid_stack_web/cable_timeline.rb

@@ -0,0 +1,32 @@
+module SolidStackWeb
+  class CableTimeline
+    HOURS = 24
+
+    def message_buckets
+      @message_buckets ||= build_buckets { |rows, from, to| rows.count { |t| t >= from && t < to } }
+    end
+
+    def message_max
+      message_buckets.max || 0
+    end
+
+    private
+
+    def rows
+      @rows ||= begin
+        origin = Time.current - HOURS.hours
+        ::SolidCable::Message.where(created_at: origin..Time.current).pluck(:created_at)
+      end
+    end
+
+    def build_buckets(&block)
+      now    = Time.current
+      origin = now - HOURS.hours
+      HOURS.times.map do |i|
+        from = origin + i.hours
+        to   = origin + (i + 1).hours
+        block.call(rows, from, to)
+      end
+    end
+  end
+end

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

@@ -4,6 +4,7 @@
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1">
   <title>Solid Stack Dashboard</title>
+  <link rel="icon" href="data:,">
   <%= csrf_meta_tags %>
   <%= csp_meta_tag %>
   <%= inline_styles %>
@@ -35,6 +36,15 @@
     </nav>
   <% end %>
 
+  <% if current_section == :cable %>
+    <nav class="sqw-subnav">
+      <div class="sqw-subnav__inner">
+        <%= link_to "Overview", cable_path,
+              class: "sqw-subnav__link#{" sqw-subnav__link--active" if controller_name == "cable"}" %>
+      </div>
+    </nav>
+  <% end %>
+
   <% if current_section == :queue %>
     <nav class="sqw-subnav">
       <div class="sqw-subnav__inner">

data/app/views/solid_stack_web/cable/index.html.erb

@@ -1,5 +1,14 @@
-<div class="sqw-page-header">
+<div class="sqw-page-header sqw-page-header--split">
   <h1 class="sqw-page-title">Solid Cable</h1>
+  <div class="sqw-header-actions">
+    <%= form_with url: cable_purge_path, method: :delete, class: "sqw-inline-form",
+                  data: { turbo_confirm: "Purge these messages? This cannot be undone." } do |f| %>
+      <%= f.select :older_than,
+                   [["Older than 1 day", 1], ["Older than 7 days", 7], ["Older than 30 days", 30]],
+                   {}, class: "sqw-select" %>
+      <%= f.submit "Purge Old", class: "sqw-btn sqw-btn--danger sqw-btn--sm" %>
+    <% end %>
+  </div>
 </div>
 
 <div class="sqw-stats-grid">
@@ -13,15 +22,53 @@
   </div>
 </div>
 
+<div class="sqw-timeline-grid sqw-timeline-grid--single" data-controller="sparkline-tooltip">
+  <div class="sqw-sparkline-wrap sqw-timeline-chart sqw-timeline-chart--cable">
+    <span class="sqw-sparkline-label">Messages — last 24 hours</span>
+    <div class="sqw-sparkline-positioner">
+      <%= cable_messages_timeline_svg(@timeline) %>
+      <div class="sqw-sparkline-tip" data-sparkline-tooltip-target="tip" hidden></div>
+    </div>
+    <div class="sqw-sparkline-axis">
+      <span>24h ago</span>
+      <span>12h ago</span>
+      <span>now</span>
+    </div>
+  </div>
+</div>
+
+<form class="sqw-filters" action="<%= cable_path %>" method="get" data-controller="search">
+  <input class="sqw-search-input" type="search" name="q" value="<%= @search %>"
+         placeholder="Filter by channel…" autocomplete="off" aria-label="Filter by channel"
+         data-action="input->search#filter">
+  <% if @search.present? %>
+    <%= link_to "Clear", cable_path, class: "sqw-btn sqw-btn--muted sqw-btn--sm" %>
+  <% end %>
+</form>
+
 <% if @channels.any? %>
   <table class="sqw-table">
     <thead>
-      <tr><th>Channel</th></tr>
+      <tr>
+        <th>Channel</th>
+        <th>Messages</th>
+        <th>Last Message</th>
+      </tr>
     </thead>
     <tbody>
       <% @channels.each do |channel| %>
-        <tr><td class="sqw-monospace"><%= channel %></td></tr>
+        <tr>
+          <td class="sqw-monospace sqw-truncate" title="<%= channel[:channel] %>">
+            <%= link_to channel[:channel], cable_channel_messages_path(channel[:channel_hash]), class: "sqw-link" %>
+          </td>
+          <td><%= channel[:message_count] %></td>
+          <td class="sqw-muted"><%= channel[:last_message_at]&.strftime("%b %d %H:%M") %></td>
+        </tr>
       <% end %>
     </tbody>
   </table>
+<% else %>
+  <div class="sqw-empty">
+    <p><%= @search.present? ? "No channels matching &ldquo;#{@search}&rdquo;.".html_safe : "No cable messages." %></p>
+  </div>
 <% end %>

data/app/views/solid_stack_web/cable_messages/index.html.erb

@@ -0,0 +1,50 @@
+<div class="sqw-page-header sqw-page-header--split">
+  <h1 class="sqw-page-title sqw-truncate" title="<%= @channel_name %>"><%= @channel_name %></h1>
+  <div class="sqw-header-actions">
+    <%= button_to "Purge Channel",
+          cable_channel_purge_path(params[:channel_hash]),
+          method: :delete,
+          class: "sqw-btn sqw-btn--danger sqw-btn--sm",
+          data: { turbo_confirm: "Delete all messages for this channel? This cannot be undone." } %>
+    <%= link_to "← Channels", cable_path, class: "sqw-btn sqw-btn--muted sqw-btn--sm" %>
+  </div>
+</div>
+
+<form class="sqw-filters" action="<%= cable_channel_messages_path(params[:channel_hash]) %>" method="get" data-controller="search">
+  <input class="sqw-search-input" type="search" name="q" value="<%= @search %>"
+         placeholder="Filter by payload…" autocomplete="off" aria-label="Filter by payload"
+         data-action="input->search#filter">
+  <% if @search.present? %>
+    <%= link_to "Clear", cable_channel_messages_path(params[:channel_hash]), class: "sqw-btn sqw-btn--muted sqw-btn--sm" %>
+  <% end %>
+</form>
+
+<% if @messages.any? %>
+  <table class="sqw-table">
+    <thead>
+      <tr>
+        <th>ID</th>
+        <th>Payload</th>
+        <th>Sent</th>
+      </tr>
+    </thead>
+    <tbody>
+      <% @messages.each do |message| %>
+        <tr>
+          <td class="sqw-muted sqw-monospace"><%= message.id %></td>
+          <td class="sqw-monospace sqw-truncate" title="<%= message.payload %>">
+            <%= truncate(message.payload.to_s, length: 120) %>
+          </td>
+          <td class="sqw-muted" title="<%= message.created_at.strftime("%b %d, %Y %H:%M:%S %Z") %>">
+            <%= time_ago_in_words(message.created_at) %> ago
+          </td>
+        </tr>
+      <% end %>
+    </tbody>
+  </table>
+  <%== @pagy.series_nav if @pagy.pages > 1 %>
+<% else %>
+  <div class="sqw-empty">
+    <p><%= @search.present? ? "No messages matching &ldquo;#{@search}&rdquo;.".html_safe : "No messages for this channel." %></p>
+  </div>
+<% end %>

data/app/views/solid_stack_web/cache_entries/index.html.erb

@@ -58,7 +58,7 @@
       <% end %>
     </tbody>
   </table>
-  <%== pagy_nav(@pagy) if @pagy.pages > 1 %>
+  <%== @pagy.series_nav if @pagy.pages > 1 %>
 <% else %>
   <div class="sqw-empty">
     <p><%= @search.present? ? "No entries matching &ldquo;#{@search}&rdquo;.".html_safe : "No cache entries." %></p>

data/app/views/solid_stack_web/dashboard/index.html.erb

@@ -99,15 +99,36 @@
       <%= link_to "View Cable →", cable_path, class: "sqw-gem-card__link" %>
     </div>
     <div class="sqw-gem-card__body">
-      <div class="sqw-inline-stat sqw-inline-stat--cable">
+      <%= link_to cable_path, class: "sqw-inline-stat sqw-inline-stat--cable" do %>
         <span class="sqw-inline-stat__label">Messages</span>
         <span class="sqw-inline-stat__value"><%= @cable_stats[:messages] %></span>
-      </div>
+      <% end %>
       <div class="sqw-inline-stat sqw-inline-stat--cable">
         <span class="sqw-inline-stat__label">Channels</span>
         <span class="sqw-inline-stat__value"><%= @cable_stats[:channels] %></span>
       </div>
+      <div class="sqw-inline-stat sqw-inline-stat--cable">
+        <span class="sqw-inline-stat__label">Msg/hr</span>
+        <span class="sqw-inline-stat__value"><%= @cable_stats[:messages_per_hour] %></span>
+      </div>
+      <% if @cable_stats[:oldest_message] %>
+        <div class="sqw-inline-stat sqw-inline-stat--cable">
+          <span class="sqw-inline-stat__label">Oldest</span>
+          <span class="sqw-inline-stat__value sqw-inline-stat__value--sm" title="<%= @cable_stats[:oldest_message].strftime("%b %d, %Y %H:%M") %>"><%= time_ago_in_words(@cable_stats[:oldest_message]) %></span>
+        </div>
+      <% end %>
     </div>
+    <% if @cable_stats[:top_channels].any? %>
+      <div class="sqw-card-list">
+        <span class="sqw-card-list__label">Top channels</span>
+        <% @cable_stats[:top_channels].each do |channel, count| %>
+          <div class="sqw-card-list__row">
+            <span class="sqw-card-list__name" title="<%= channel %>"><%= channel %></span>
+            <span class="sqw-card-list__count"><%= count %></span>
+          </div>
+        <% end %>
+      </div>
+    <% end %>
   </div>
 </div>
-<% end %>
+<% end %>

data/app/views/solid_stack_web/failed_jobs/index.html.erb

@@ -62,7 +62,7 @@
           <% end %>
         </tbody>
       </table>
-      <%== pagy_nav(@pagy) if @pagy.pages > 1 %>
+      <%== @pagy.series_nav if @pagy.pages > 1 %>
     </div>
   <% else %>
     <div class="sqw-empty">

data/app/views/solid_stack_web/history/index.html.erb

@@ -66,7 +66,7 @@
         <% end %>
       </tbody>
     </table>
-    <%== pagy_nav(@pagy) if @pagy.pages > 1 %>
+    <%== @pagy.series_nav if @pagy.pages > 1 %>
   </div>
 <% else %>
   <div class="sqw-empty">

data/app/views/solid_stack_web/jobs/index.html.erb

@@ -149,7 +149,7 @@
           <% end %>
         </tbody>
       </table>
-      <%== pagy_nav(@pagy) if @pagy.pages > 1 %>
+      <%== @pagy.series_nav if @pagy.pages > 1 %>
     </div>
   <% else %>
     <%= render "empty" %>

data/app/views/solid_stack_web/queues/show.html.erb

@@ -59,7 +59,7 @@
       <% end %>
     </tbody>
   </table>
-  <%== pagy_nav(@pagy) if @pagy.pages > 1 %>
+  <%== @pagy.series_nav if @pagy.pages > 1 %>
 <% else %>
   <div class="sqw-empty">
     <p>No ready jobs in <strong><%= @queue_name %></strong>.</p>

data/config/routes.rb

@@ -37,5 +37,8 @@ SolidStackWeb::Engine.routes.draw do
   get "cache", to: "cache#index", as: :cache
   resources :cache_entries, only: [:index, :show, :destroy], path: "cache/entries"
   resource  :cache_flush,   only: [:destroy],         path: "cache/flush",    controller: "cache/flushes"
-  get "cable", to: "cable#index", as: :cable
+  get    "cable",                                  to: "cable#index",                          as: :cable
+  delete "cable/purge",                            to: "cable/purges#destroy",                 as: :cable_purge
+  get    "cable/channels/:channel_hash",           to: "cable_messages#index",                 as: :cable_channel_messages
+  delete "cable/channels/:channel_hash/purge",     to: "cable/channel_purges#destroy",         as: :cable_channel_purge
 end

data/lib/solid_stack_web/version.rb

@@ -1,3 +1,3 @@
 module SolidStackWeb
-  VERSION = "0.5.0"
+  VERSION = "0.6.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: solid_stack_web
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Chuck Smith
@@ -144,7 +144,10 @@ files:
 - app/assets/stylesheets/solid_stack_web/_09_detail.css
 - app/assets/stylesheets/solid_stack_web/application.css
 - app/controllers/solid_stack_web/application_controller.rb
+- app/controllers/solid_stack_web/cable/channel_purges_controller.rb
+- app/controllers/solid_stack_web/cable/purges_controller.rb
 - app/controllers/solid_stack_web/cable_controller.rb
+- app/controllers/solid_stack_web/cable_messages_controller.rb
 - app/controllers/solid_stack_web/cache/flushes_controller.rb
 - app/controllers/solid_stack_web/cache_controller.rb
 - app/controllers/solid_stack_web/cache_entries_controller.rb
@@ -171,6 +174,7 @@ files:
 - app/javascript/solid_stack_web/sparkline_tooltip_controller.js
 - app/models/solid_stack_web/alert_webhook.rb
 - app/models/solid_stack_web/cable_stats.rb
+- app/models/solid_stack_web/cable_timeline.rb
 - app/models/solid_stack_web/cache_size_stats.rb
 - app/models/solid_stack_web/cache_stats.rb
 - app/models/solid_stack_web/cache_timeline.rb
@@ -180,6 +184,7 @@ files:
 - app/models/solid_stack_web/throughput_sparkline.rb
 - app/views/layouts/solid_stack_web/application.html.erb
 - app/views/solid_stack_web/cable/index.html.erb
+- app/views/solid_stack_web/cable_messages/index.html.erb
 - app/views/solid_stack_web/cache/index.html.erb
 - app/views/solid_stack_web/cache_entries/index.html.erb
 - app/views/solid_stack_web/cache_entries/show.html.erb