solid_stack_web 0.9.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 85093a248316f7f8921636f68bdc08e2053e496eeb85f17bbbd7cddac57e4ed6
-  data.tar.gz: 3321fa62f08ce3615f733740cfac444d60ed65960b9adc9e4894919416482b46
+  metadata.gz: 1717d75a5baabd8728f6f9877b5146849be9322a627cf295bd922690aa284592
+  data.tar.gz: ae814ccee9aa89798575f914652ccfbb51137473961d7fd1a22b7a4461449102
 SHA512:
-  metadata.gz: 278a4dbde1baa31bb57f58c72d41ea13ef9ddbb83043839228abb4cb0ab06286c4ca954d63ee0c2f2e6914a1b8c24f946731b73afe8db1176ba28a8c157c6b52
-  data.tar.gz: f6b953b896ba256d03e26f802ab594d9e822fbd114ce68f6b7f673d435fceca8009a9ec2c55ea0f45a6dacfcebb34b9b9c23c64564faa212e00a8450292d95c4
+  metadata.gz: e0d79705beafccb16561d20a28cac815607f2a202bc6d0839449c501f8d4f5bd93bd83ccb4a7c4be0d6b701ecb69b9aca8fa5ee2a3d4462712fc8399c935162a
+  data.tar.gz: 2663a57cf04ca3aa26463732638020c63ce76d10046979dbd22baae8f5b529d3092e3597aa9c4a8b9b06b0a43b9a648e0a573349bca1f39d6f944fe4a8313884

data/README.md

@@ -5,7 +5,7 @@
 [![Ruby](https://img.shields.io/badge/ruby-%3E%3D%203.3-ruby)](https://www.ruby-lang.org)
 [![codecov](https://codecov.io/gh/eclectic-coding/solid_stack_web/branch/main/graph/badge.svg)](https://codecov.io/gh/eclectic-coding/solid_stack_web)
 
-A mountable Rails engine that provides a unified web dashboard for the full [Solid Stack](https://github.com/rails/solid_queue) — **Solid Queue**, **Solid Cache**, and **Solid Cable** — in a single interface with no asset pipeline dependency and no JavaScript runtime requirement.
+A production-ready operations dashboard for the full Rails Solid Stack. Mount one engine to get deep visibility into **Solid Queue** (job browser, failed job retry, queue controls, recurring tasks, performance stats), **Solid Cache** (entry browser, size distribution, write timeline), and **Solid Cable** (channel browser, message list, purge controls) — with dark mode, CSV export, alert webhooks, and a JSON metrics endpoint, all with no asset pipeline dependency.
 
 ## Installation
 
@@ -21,23 +21,19 @@ Run:
 bundle install
 ```
 
-Mount the engine in `config/routes.rb`:
-
-```ruby
-mount SolidStackWeb::Engine, at: "/solid_stack"
-```
-
-The dashboard will be available at `/solid_stack` (or whatever path you choose).
-
-### Install generator
-
 Run the install generator to create a documented initializer and wire up the mount point in one step:
 
 ```bash
 rails generate solid_stack_web:install
 ```
 
-This creates `config/initializers/solid_stack_web.rb` with every configuration option commented inline, and injects `mount SolidStackWeb::Engine, at: "/solid_stack"` into `config/routes.rb`.
+This creates `config/initializers/solid_stack_web.rb` with every configuration option commented inline, and injects `mount SolidStackWeb::Engine, at: "/solid_stack"` into `config/routes.rb`. The dashboard will then be available at `/solid_stack` (or whatever path you choose).
+
+---
+
+## Screenshots
+
+![SolidStackWeb dashboard](docs/screenshots/demo.gif)
 
 ---
 
@@ -71,7 +67,7 @@ This creates `config/initializers/solid_stack_web.rb` with every configuration o
 
 ## General configuration
 
-Create an initializer at `config/initializers/solid_stack_web.rb`:
+The install generator creates `config/initializers/solid_stack_web.rb` with all options documented inline. The available options are:
 
 ```ruby
 SolidStackWeb.configure do |config|
@@ -83,6 +79,10 @@ SolidStackWeb.configure do |config|
   config.authenticate do
     current_user&.admin?
   end
+
+  # Multi-database — pass a connects_to hash when Solid Queue / Cache / Cable
+  # live on a separate database from your primary (default: nil, uses primary).
+  config.connects_to = { database: { writing: :queue, reading: :queue } }
 end
 ```
 
@@ -100,20 +100,59 @@ link_to "Queue Dashboard", SolidStackWeb.mount_path
 
 ---
 
+## Security
+
+### Authentication
+
+**The dashboard is open to all visitors by default.** Any production deployment must configure an `authenticate` block or the dashboard will be publicly accessible.
+
+```ruby
+SolidStackWeb.configure do |config|
+  # Devise
+  config.authenticate { current_user&.admin? }
+
+  # HTTP Basic fallback (used when no authenticate block is set, or when
+  # the block returns false/nil and you want a browser credential prompt)
+  # Configure via HTTP_BASIC_AUTH_NAME / HTTP_BASIC_AUTH_PASSWORD env vars
+  # in your host app, or use a reverse proxy.
+end
+```
+
+If the `authenticate` block returns `false` or `nil`, the engine falls back to HTTP Basic authentication. If no block is configured at all, the dashboard is open.
+
+### Sensitive cache values
+
+`allow_value_preview` is `false` by default. Enabling it renders the raw serialised cache value on the entry detail page. Do not enable this if your cache stores session tokens, PII, or other sensitive data.
+
+### CSRF protection
+
+All state-mutating actions (job discard, retry, queue pause/resume, cache flush) use form POST requests. Turbo handles CSRF tokens automatically for any standard Rails app with `protect_from_forgery`.
+
+### Rate limiting and network exposure
+
+The dashboard is designed to be mounted behind your application's existing authentication. For additional hardening, consider:
+
+- Mounting at a non-guessable path (e.g. `at: "/ops/#{Rails.application.credentials.dashboard_token}"`)
+- Restricting access by IP at the reverse-proxy level
+- Applying [Rack::Attack](https://github.com/rack/rack-attack) rules to the mount path
+
+---
+
 ## Solid Queue
 
 ### Features
 
-- **Overview dashboard** — live counts across all queue statuses; done (1h/24h), healthy/stale process counts, and optionally slow jobs (when `slow_job_threshold` is configured); 12-hour throughput sparkline with per-bar hover tooltips
+- **Overview dashboard** — live counts across all queue statuses; done (1h/24h), healthy/stale process counts, and optionally slow jobs (when `slow_job_threshold` is configured); 12-hour throughput sparkline and a 12-hour failures sparkline (red bars) with per-bar hover tooltips — failure spikes visible before clicking into the failed jobs list
 - **Job browser** — browse jobs by status (ready, scheduled, claimed, blocked) with filtering by job class, queue name, priority, and time period; **Discard All** bulk-discards every job matching the current filters in one request; **CSV export** downloads jobs respecting active filters
 - **Bulk selection** — checkbox-select individual jobs for discard; select-all support
 - **Per-queue browser** — click any queue name or size to drill into its ready jobs with per-row and bulk discard; pause/resume controls on the queue page
 - **Queue depth sparklines** — Queues index shows a 12-hour depth chart per queue; each bar is the ready-job count at an hourly snapshot with an instant hover tooltip
 - **Job detail page** — full arguments (pretty-printed JSON), queue, priority, enqueued time, Active Job ID, concurrency key, scheduled/blocked-until metadata, and a Discard button
 - **Failed jobs** — list with retry / discard / bulk retry / bulk discard; **Failed job detail page** — full error, backtrace, and an inline JSON argument editor; submit to update arguments and retry in one action
+- **Error frequency report** — `GET /failed_jobs/errors` groups all failed jobs by exception class and message prefix with a count and expandable sample backtrace; links through to a filtered list for each error group
 - **Scheduled job management** — "Run Now" and offset buttons (+1h / +24h / +7d) per row update the scheduled time inline via Turbo Stream; "Run All Now (N)" back-dates all matching executions at once
 - **Recurring task list** — enumerates all `SolidQueue::RecurringTask` records with cron schedule, job class or command, queue, next-run and last-run times, and a static/dynamic badge; each row has a "Run Now" button
-- **Performance statistics page** — `GET /stats` aggregates finished jobs by class name with execution count, avg, p50, p95, min, and max duration; click any column header to sort; defaults to p95 descending
+- **Performance statistics page** — `GET /stats` aggregates finished jobs by class name with execution count, avg, p50, p95, p99, std dev, min, and max duration; click any column header to sort; defaults to p95 descending; high std dev flags inconsistent jobs worth investigating
 - **Job history view** — paginated list of all finished jobs with class name, queue, duration, and finished-at time; filterable by queue (click a badge), class substring, and time period; CSV export respects active filters
 - **Auto-refresh** — dashboard, jobs, processes, and history views poll automatically; pauses when the tab is hidden or a checkbox is checked; intervals configurable via `dashboard_refresh_interval` and `default_refresh_interval`
 - **Turbo Stream** job discard — removes the row inline without a full page reload
@@ -207,6 +246,36 @@ Filters are preserved when switching between status tabs (Ready / Scheduled / Ru
 - [turbo-rails](https://github.com/hotwired/turbo-rails) >= 2.0
 - [importmap-rails](https://github.com/rails/importmap-rails) >= 1.2
 
+## Versioning
+
+SolidStackWeb follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+### Public API
+
+The following are considered stable public API from v1.0.0 onwards — breaking changes to any of these require a major version bump:
+
+- The `SolidStackWeb.configure` block and all documented configuration keys
+- The `SolidStackWeb.mount_path` helper
+- The `authenticate` block interface
+- The `GET /metrics` JSON payload shape
+- The `SolidStackWeb::Engine` class and its mount interface
+- The `rails generate solid_stack_web:install` generator
+
+### Not part of the public API
+
+The following are internal and may change in any release without notice:
+
+- Internal service classes (`CacheStats`, `QueueStats`, etc.)
+- View templates, partial names, and CSS class names
+- Controller and helper internals
+- Private methods on any class
+
+### Deprecation policy
+
+When a public API item is renamed or removed, the old interface is deprecated in a **minor** release — it continues to work but issues an `ActiveSupport::Deprecation` warning pointing to the replacement. The old interface is removed in the next **major** release. The [UPGRADING.md](UPGRADING.md) file documents every breaking change and the migration steps.
+
+---
+
 ## Contributing
 
 1. Fork the repository

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

@@ -86,6 +86,10 @@ a.sqw-inline-stat:hover { opacity: 0.7; text-decoration: none; }
   color: var(--primary);
 }
 
+.sqw-sparkline-wrap--failures {
+  color: var(--danger);
+}
+
 .sqw-sparkline-label {
   display: block;
   font-size: 10px;

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

@@ -70,20 +70,9 @@
   overflow-y: auto;
 }
 
-.sqw-detail {
-  display: grid;
-  grid-template-columns: auto 1fr;
-  gap: 0.5rem 1.5rem;
-  font-size: 13px;
-  margin-bottom: 1.5rem;
-}
-.sqw-detail__row {
-  display: contents;
-}
-.sqw-detail__row dt { color: var(--muted); white-space: nowrap; align-self: start; padding-top: 0.15rem; }
-.sqw-detail__row dd { word-break: break-all; }
-
-.sqw-value-preview { margin-top: 1rem; }
+.sqw-detail-card--mt,
+.sqw-detail-card + .sqw-detail-card,
+.sqw-detail-grid + .sqw-detail-card { margin-top: 1.5rem; }
 
 .sqw-value-preview__header {
   display: flex;
@@ -93,22 +82,31 @@
 }
 .sqw-value-preview__header .sqw-section-title { margin-bottom: 0; }
 
-.sqw-value-pre {
+.sqw-value-truncated { font-size: 12px; margin-top: 0.5rem; }
+
+.sqw-error-details > summary {
+  cursor: pointer;
+  list-style: none;
+  display: block;
+  max-width: 480px;
+}
+.sqw-error-details > summary::-webkit-details-marker { display: none; }
+.sqw-error-details[open] > summary { margin-bottom: 0.5rem; }
+
+.sqw-error-backtrace {
   font-family: ui-monospace, "SFMono-Regular", Menlo, monospace;
-  font-size: 12px;
+  font-size: 11px;
   background: var(--bg);
   border: 1px solid var(--border);
   border-radius: var(--radius);
-  padding: 0.75rem;
+  padding: 0.5rem 0.75rem;
   overflow-x: auto;
-  white-space: pre-wrap;
-  word-break: break-word;
-  max-height: 500px;
+  white-space: pre;
+  max-height: 200px;
   overflow-y: auto;
+  margin-top: 0.25rem;
 }
 
-.sqw-value-truncated { font-size: 12px; margin-top: 0.5rem; }
-
 .sqw-link { color: var(--primary); text-decoration: none; }
 .sqw-link:hover { text-decoration: underline; }
 

data/app/controllers/solid_stack_web/dashboard_controller.rb

@@ -5,6 +5,7 @@ module SolidStackWeb
       @cache_stats = CacheStats.new.to_h
       @cable_stats = CableStats.new.to_h
       @throughput  = ThroughputSparkline.new
+      @failures    = FailedJobSparkline.new
     end
   end
 end

data/app/controllers/solid_stack_web/failed_jobs/errors_controller.rb

@@ -0,0 +1,9 @@
+module SolidStackWeb
+  module FailedJobs
+    class ErrorsController < ApplicationController
+      def index
+        @groups = ErrorFrequencyReport.new.groups
+      end
+    end
+  end
+end

data/app/controllers/solid_stack_web/failed_jobs_controller.rb

@@ -4,6 +4,8 @@ module SolidStackWeb
       respond_to do |format|
         format.html do
           scope = ::SolidQueue::FailedExecution.includes(:job).order(created_at: :desc)
+          @error_class = params[:error_class].presence
+          scope = scope.where(id: ids_for_error_class(@error_class)) if @error_class
           @pagy, @executions = pagy(scope)
         end
         format.csv do
@@ -41,6 +43,15 @@ module SolidStackWeb
 
     private
 
+    def ids_for_error_class(ec)
+      ::SolidQueue::FailedExecution.pluck(:id, :error).filter_map do |id, raw|
+        error = raw.is_a?(Hash) ? raw : JSON.parse(raw)
+        id if error["exception_class"] == ec
+      rescue StandardError
+        nil
+      end
+    end
+
     def failed_jobs_csv
       CSV.generate(headers: true) do |csv|
         csv << %w[id class_name queue_name error_class error_message failed_at]

data/app/controllers/solid_stack_web/stats_controller.rb

@@ -1,6 +1,6 @@
 module SolidStackWeb
   class StatsController < ApplicationController
-    SORTABLE_COLUMNS = %w[class_name count avg p50 p95 min max].freeze
+    SORTABLE_COLUMNS = %w[class_name count avg p50 p95 p99 stddev min max].freeze
 
     def index
       @sort      = params[:sort].presence_in(SORTABLE_COLUMNS) || "p95"
@@ -18,14 +18,17 @@ module SolidStackWeb
       jobs.group_by(&:class_name).map do |class_name, group|
         durations = group.map { |j| (j.finished_at - j.created_at).to_f }.sort
         count     = durations.size
+        avg = durations.sum / count
         {
           class_name: class_name,
           count:      count,
-          avg:        durations.sum / count,
+          avg:        avg,
           min:        durations.first,
           max:        durations.last,
           p50:        percentile(durations, 50),
-          p95:        percentile(durations, 95)
+          p95:        percentile(durations, 95),
+          p99:        percentile(durations, 99),
+          stddev:     stddev(durations, avg)
         }
       end
     end
@@ -35,5 +38,11 @@ module SolidStackWeb
       k = (sorted.size - 1) * pct / 100.0
       sorted[k.floor] + (sorted[k.ceil] - sorted[k.floor]) * (k - k.floor)
     end
+
+    def stddev(durations, avg)
+      return 0.0 if durations.size < 2
+      variance = durations.sum { |d| (d - avg)**2 } / durations.size
+      Math.sqrt(variance)
+    end
   end
 end

data/app/helpers/solid_stack_web/application_helper.rb

@@ -87,6 +87,17 @@ module SolidStackWeb
       end
     end
 
+    def failed_job_sparkline_svg(sparkline)
+      build_sparkline_svg(sparkline, aria_label: "Failed jobs over the last 12 hours") do |count, i|
+        hours_ago = SolidStackWeb::FailedJobSparkline::HOURS - i
+        if hours_ago == 1
+          "#{count} #{count == 1 ? "failure" : "failures"} in the last hour"
+        else
+          "#{count} #{count == 1 ? "failure" : "failures"} (#{hours_ago}h–#{hours_ago - 1}h ago)"
+        end
+      end
+    end
+
     private
 
     def build_sparkline_svg(sparkline, css_class: "sqw-sparkline", aria_label: nil, &tooltip_text)

data/app/models/solid_stack_web/error_frequency_report.rb

@@ -0,0 +1,34 @@
+module SolidStackWeb
+  class ErrorFrequencyReport
+    Row = Data.define(:exception_class, :message_prefix, :count, :sample_backtrace)
+
+    MESSAGE_LIMIT = 120
+
+    def groups
+      ::SolidQueue::FailedExecution
+        .order(created_at: :desc)
+        .each_with_object({}) do |execution, acc|
+          key = [execution.exception_class.to_s, message_prefix(execution.message)]
+          entry = acc[key] ||= { count: 0, sample_backtrace: nil }
+          entry[:count] += 1
+          entry[:sample_backtrace] ||= execution.backtrace
+        end
+        .map do |(exception_class, prefix), data|
+          Row.new(
+            exception_class:  exception_class,
+            message_prefix:   prefix,
+            count:            data[:count],
+            sample_backtrace: data[:sample_backtrace]
+          )
+        end
+        .sort_by { |row| -row.count }
+    end
+
+    private
+
+    def message_prefix(message)
+      return "" if message.nil?
+      message.length > MESSAGE_LIMIT ? "#{message[0, MESSAGE_LIMIT]}…" : message
+    end
+  end
+end

data/app/models/solid_stack_web/failed_job_sparkline.rb

@@ -0,0 +1,23 @@
+module SolidStackWeb
+  class FailedJobSparkline
+    HOURS = 12
+
+    def buckets
+      @buckets ||= begin
+        now    = Time.current
+        origin = now - HOURS.hours
+        times  = ::SolidQueue::FailedExecution.where(created_at: origin..now).pluck(:created_at)
+
+        HOURS.times.map do |i|
+          from = origin + i.hours
+          to   = origin + (i + 1).hours
+          times.count { |t| t >= from && t < to }
+        end
+      end
+    end
+
+    def max
+      buckets.max || 0
+    end
+  end
+end

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

@@ -10,33 +10,30 @@
   </div>
 </div>
 
-<dl class="sqw-detail">
-  <div class="sqw-detail__row">
+<div class="sqw-detail-card sqw-detail-section">
+  <h2 class="sqw-section-title">Details</h2>
+  <dl class="sqw-dl">
     <dt>Key</dt>
     <dd class="sqw-monospace"><%= @entry.key %></dd>
-  </div>
-  <div class="sqw-detail__row">
     <dt>Size</dt>
     <dd><%= number_to_human_size(@entry.byte_size) %></dd>
-  </div>
-  <div class="sqw-detail__row">
     <dt>Created</dt>
     <dd class="sqw-muted"><%= local_time(@entry.created_at, format: :long) %></dd>
-  </div>
-</dl>
+  </dl>
+</div>
 
-<section class="sqw-value-preview">
+<div class="sqw-detail-card sqw-detail-section">
+  <% formatted = SolidStackWeb.allow_value_preview ? format_cache_value(@entry.value) : nil %>
   <div class="sqw-value-preview__header">
     <h2 class="sqw-section-title">Value</h2>
-    <% if SolidStackWeb.allow_value_preview %>
-      <% formatted = format_cache_value(@entry.value) %>
+    <% if formatted %>
       <span class="sqw-badge sqw-badge--queue"><%= formatted[:label] %></span>
     <% end %>
   </div>
-  <% if SolidStackWeb.allow_value_preview %>
+  <% if formatted %>
     <% content = formatted[:content] %>
     <% truncated = content.length > 4096 %>
-    <pre class="sqw-value-pre"><%= truncated ? content[0, 4096] : content %></pre>
+    <pre class="sqw-code-block"><%= truncated ? content[0, 4096] : content %></pre>
     <% if truncated %>
       <p class="sqw-muted sqw-value-truncated">Showing first 4 KB of <%= number_to_human_size(@entry.byte_size) %> total.</p>
     <% end %>
@@ -45,4 +42,4 @@
       <p>Value preview is disabled. Set <code>config.allow_value_preview = true</code> in your initializer to enable.</p>
     </div>
   <% end %>
-</section>
+</div>

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

@@ -68,6 +68,18 @@
         <span>now</span>
       </div>
     </div>
+    <div class="sqw-sparkline-wrap sqw-sparkline-wrap--failures" data-controller="sparkline-tooltip">
+      <span class="sqw-sparkline-label">Failures — last 12 hours</span>
+      <div class="sqw-sparkline-positioner">
+        <%= failed_job_sparkline_svg(@failures) %>
+        <div class="sqw-sparkline-tip" data-sparkline-tooltip-target="tip" hidden></div>
+      </div>
+      <div class="sqw-sparkline-axis">
+        <span>12h ago</span>
+        <span>6h ago</span>
+        <span>now</span>
+      </div>
+    </div>
   </div>
 
   <div class="sqw-gem-card sqw-gem-card--cache">

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

@@ -0,0 +1,48 @@
+<div class="sqw-page-header sqw-page-header--split">
+  <h1 class="sqw-page-title">Error Summary</h1>
+  <div class="sqw-header-actions">
+    <%= link_to "← Failed Jobs", failed_jobs_path, class: "sqw-btn sqw-btn--muted sqw-btn--sm" %>
+  </div>
+</div>
+
+<% if @groups.any? %>
+  <table class="sqw-table">
+    <thead>
+      <tr>
+        <th scope="col">Error Class</th>
+        <th scope="col">Message</th>
+        <th scope="col">Count</th>
+        <th scope="col"><span class="sqw-sr-only">Actions</span></th>
+      </tr>
+    </thead>
+    <tbody>
+      <% @groups.each do |group| %>
+        <tr>
+          <td class="sqw-monospace"><%= group.exception_class.presence || "—" %></td>
+          <td>
+            <% if group.sample_backtrace.present? %>
+              <details class="sqw-error-details">
+                <summary class="sqw-muted sqw-truncate" title="<%= group.message_prefix %>">
+                  <%= group.message_prefix.presence || "—" %>
+                </summary>
+                <pre class="sqw-error-backtrace"><%= Array(group.sample_backtrace).first(10).join("\n") %></pre>
+              </details>
+            <% else %>
+              <span class="sqw-muted sqw-truncate" title="<%= group.message_prefix %>"><%= group.message_prefix.presence || "—" %></span>
+            <% end %>
+          </td>
+          <td><%= group.count %></td>
+          <td class="sqw-actions">
+            <%= link_to "View Jobs", failed_jobs_path(error_class: group.exception_class),
+                  class: "sqw-btn sqw-btn--muted sqw-btn--sm" %>
+          </td>
+        </tr>
+      <% end %>
+    </tbody>
+  </table>
+<% else %>
+  <div class="sqw-empty">
+    <p class="sqw-empty__title">No failed jobs</p>
+    <p class="sqw-empty__hint">All clear — your jobs are running without errors.</p>
+  </div>
+<% end %>

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

@@ -1,6 +1,15 @@
 <div class="sqw-page-header sqw-page-header--split">
-  <h1 class="sqw-page-title">Failed Jobs</h1>
+  <div>
+    <h1 class="sqw-page-title">Failed Jobs</h1>
+    <% if @error_class %>
+      <div class="sqw-breadcrumb">
+        Filtered by <span class="sqw-monospace"><%= @error_class %></span>
+        — <%= link_to "Clear filter", failed_jobs_path %>
+      </div>
+    <% end %>
+  </div>
   <div class="sqw-header-actions">
+    <%= link_to "Error Summary", failed_job_errors_path, class: "sqw-btn sqw-btn--muted sqw-btn--sm" %>
     <%= link_to "Export CSV", failed_jobs_path(format: :csv),
           class: "sqw-btn sqw-btn--muted sqw-btn--sm", data: { turbo: false } %>
   </div>

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

@@ -45,7 +45,7 @@
   </div>
 </div>
 
-<div class="sqw-detail-card sqw-detail-section" style="margin-top: 1.5rem;">
+<div class="sqw-detail-card sqw-detail-section sqw-detail-card--mt">
   <h2 class="sqw-section-title">Arguments</h2>
   <%= form_with url: failed_job_arguments_path(@execution), method: :patch do |f| %>
     <%= f.text_area :arguments, value: @arguments, rows: 12,

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

@@ -12,6 +12,8 @@
           ["avg",        "Avg"],
           ["p50",        "p50"],
           ["p95",        "p95"],
+          ["p99",        "p99"],
+          ["stddev",     "Std Dev"],
           ["min",        "Min"],
           ["max",        "Max"]
         ].each do |col, label| %>
@@ -35,6 +37,8 @@
           <td class="sqw-muted"><%= format_duration(row[:avg]) %></td>
           <td class="sqw-muted"><%= format_duration(row[:p50]) %></td>
           <td><strong><%= format_duration(row[:p95]) %></strong></td>
+          <td class="sqw-muted"><%= format_duration(row[:p99]) %></td>
+          <td class="sqw-muted"><%= format_duration(row[:stddev]) %></td>
           <td class="sqw-muted"><%= format_duration(row[:min]) %></td>
           <td class="sqw-muted"><%= format_duration(row[:max]) %></td>
         </tr>

data/config/routes.rb

@@ -20,6 +20,8 @@ SolidStackWeb::Engine.routes.draw do
     end
   end
 
+  get "failed_jobs/errors", to: "failed_jobs/errors#index", as: :failed_job_errors
+
   resources :failed_jobs, only: [:index, :show, :destroy] do
     member { post :retry }
     resource :arguments, only: [:update], controller: "failed_jobs/arguments"

data/lib/solid_stack_web/engine.rb

@@ -25,6 +25,10 @@ module SolidStackWeb
       end
     end
 
+    initializer "solid_stack_web.deprecator" do |app|
+      app.deprecators[:solid_stack_web] = SolidStackWeb.deprecator
+    end
+
     initializer "solid_stack_web.pagy" do |app|
       app.config.after_initialize do
         Pagy::OPTIONS[:limit] = SolidStackWeb.page_size

data/lib/solid_stack_web/version.rb

@@ -1,3 +1,3 @@
 module SolidStackWeb
-  VERSION = "0.9.0"
+  VERSION = "1.1.0"
 end

data/lib/solid_stack_web.rb

@@ -74,5 +74,27 @@ module SolidStackWeb
       @authenticate = block if block_given?
       @authenticate
     end
+
+    def deprecator
+      @deprecator ||= ActiveSupport::Deprecation.new("1.0", "SolidStackWeb")
+    end
+
+    private
+
+    # Define a deprecated writer for a renamed config key.
+    # The old writer issues a deprecation warning and forwards to the new key.
+    #
+    # Usage (add entries here as keys are renamed before 1.0):
+    #   deprecated_config :old_key, :new_key
+    def deprecated_config(old_key, new_key)
+      singleton_class.define_method(:"#{old_key}=") do |value|
+        deprecator.warn(
+          "config.#{old_key}= is deprecated and will be removed in SolidStackWeb 1.0. " \
+          "Use config.#{new_key}= instead.",
+          caller_locations
+        )
+        public_send(:"#{new_key}=", value)
+      end
+    end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: solid_stack_web
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Chuck Smith
@@ -121,9 +121,14 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '3.0'
-description: Mount SolidStackWeb in any Rails app using the Solid Stack to get a single
-  dashboard covering Solid Queue job monitoring, Solid Cache statistics, and Solid
-  Cable connection observability — all without leaving your app.
+description: SolidStackWeb is a mountable Rails engine that provides a production-ready
+  operations dashboard for the full Solid Stack. It covers Solid Queue (job browser,
+  failed job retry with inline argument editing, queue pause/resume, recurring tasks,
+  performance stats, CSV export, and alert webhooks), Solid Cache (entry browser,
+  size distribution, 24-hour write timeline, and optional value preview), and Solid
+  Cable (channel browser, per-channel message list, and purge controls). Ships with
+  dark mode, Turbo Stream responses, a JSON metrics endpoint, and no asset pipeline
+  dependency.
 email:
 - eclectic-coding@users.noreply.github.com
 executables: []
@@ -155,6 +160,7 @@ files:
 - app/controllers/solid_stack_web/cache_entries_controller.rb
 - app/controllers/solid_stack_web/dashboard_controller.rb
 - app/controllers/solid_stack_web/failed_jobs/arguments_controller.rb
+- app/controllers/solid_stack_web/failed_jobs/errors_controller.rb
 - app/controllers/solid_stack_web/failed_jobs/selections_controller.rb
 - app/controllers/solid_stack_web/failed_jobs_controller.rb
 - app/controllers/solid_stack_web/history_controller.rb
@@ -182,6 +188,8 @@ files:
 - 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
+- app/models/solid_stack_web/error_frequency_report.rb
+- app/models/solid_stack_web/failed_job_sparkline.rb
 - app/models/solid_stack_web/job.rb
 - app/models/solid_stack_web/queue_depth_sparkline.rb
 - app/models/solid_stack_web/queue_stats.rb
@@ -196,6 +204,7 @@ files:
 - app/views/solid_stack_web/errors/internal_server_error.html.erb
 - app/views/solid_stack_web/errors/not_found.html.erb
 - app/views/solid_stack_web/failed_jobs/destroy.turbo_stream.erb
+- app/views/solid_stack_web/failed_jobs/errors/index.html.erb
 - app/views/solid_stack_web/failed_jobs/index.html.erb
 - app/views/solid_stack_web/failed_jobs/show.html.erb
 - app/views/solid_stack_web/history/index.html.erb
@@ -212,6 +221,7 @@ files:
 - app/views/solid_stack_web/stats/index.html.erb
 - config/importmap.rb
 - config/routes.rb
+- docs/screenshots/demo.gif
 - lib/generators/solid_stack_web/install/install_generator.rb
 - lib/generators/solid_stack_web/install/templates/initializer.rb
 - lib/solid_stack_web.rb