solid_stack_web 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c446164425203124cb715d09c520cfa7b2cc03a6abeefb4eb27ca0514327160a
-  data.tar.gz: ef9abaa3fe16c5ffc1e019dfff0ce97d7541950db9f6f25ae5ce034f4780efb5
+  metadata.gz: 3159278d6dd76fc0e54660ab9c11536a63037815771ff04206adca43b800c4ef
+  data.tar.gz: 05f47e20a15b2f70cbf216713cb4c18da3e3f569b64eb1a271543489fecb95c1
 SHA512:
-  metadata.gz: 30b738bcc2e57c4f81fb03d7b4a74bf88e18a1b69d4b71bc646357703006d6a1b639090a77a11d258427b7ad080f0b93b317cd949ff9b3b3353f77caa3e69066
-  data.tar.gz: 37f9a4d50e42360411c4213be03ce5c343874314a048b5f09b13b450bfc2ccf3568a2033cf5d4d137ee59723658f9a3cccbcd6353cf7f2f677159bd2b04fba73
+  metadata.gz: cdd04812d4cdfa1d3c48ff2a81319f8956b71afee1dded7dbce009797822248e422990f02134fbb4f3c88e6e2e2702c2c91c78d94a6d04e28ebd8d1a2b0022b9
+  data.tar.gz: 431b97295f3682b1512b09ece023c280997560d4b4f065ef742411fddc63275c8257f0d34d02f6bb0589a555c8677d0515301cabfc8b0768465fd42ff6599a54

data/README.md

@@ -74,6 +74,10 @@ SolidStackWeb.configure do |config|
 
   # Maximum results shown by the search feature (default: 25).
   config.search_results_limit = 25
+
+  # Show the raw serialized value on the cache entry detail page (default: false).
+  # Disable for stores that contain sensitive data.
+  config.allow_value_preview = true
 end
 ```
 
@@ -94,7 +98,17 @@ Filters are preserved when switching between status tabs (Ready / Scheduled / Ru
 
 ## Solid Cache
 
-_Deep cache monitoring coming in v0.5.0. Currently shows entry count and total byte size on the overview dashboard._
+### Features
+
+- **Overview dashboard card** — live entry count (linked to the entry browser), total byte size, and oldest-entry age (`time_ago_in_words` with exact timestamp on hover; hidden when cache is empty)
+- **Cache timeline** — two side-by-side 24-hour bar charts showing entries written per hour and bytes written per hour; each bar has a hover tooltip
+- **Size distribution** — byte-range histogram (< 1 KB → > 1 MB) with entry counts and proportional inline bars; hidden when cache is empty
+- **Largest entries** — top 10 entries by byte size, each linked to the detail page; hidden when cache is empty
+- **Entry browser** — `GET /cache/entries` lists all `SolidCache::Entry` records in a paginated, sortable table; columns: key, byte size, created-at; sortable by any column; key auto-submits search after 4 characters
+- **Key search** — filter entries by key substring; results update automatically after 4 characters
+- **Entry detail page** — `GET /cache/entries/:id` shows the full key, byte size, and created-at; optionally displays the raw serialized value (see `allow_value_preview` below)
+- **Delete entry** — per-row delete button or detail-page button removes a single cache entry
+- **Flush All** — header button deletes every cache entry with a confirmation prompt
 
 ---
 
@@ -122,7 +136,7 @@ _Channel monitoring coming in v0.6.0. Currently shows active message count and d
     "processes_stale": 0,
     "slow_jobs": 7
   },
-  "cache": { "entries": 1024, "byte_size": 2097152 },
+  "cache": { "entries": 1024, "byte_size": 2097152, "oldest_entry": "2026-05-20T10:00:00Z" },
   "cable": { "messages": 50, "channels": 3 },
   "generated_at": "2026-05-26T10:00:00Z"
 }

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

@@ -22,6 +22,33 @@ a.sqw-stat:hover { box-shadow: 0 3px 8px rgba(0,0,0,.12); text-decoration: none;
 .sqw-stat__label { font-size: 12px; font-weight: 500; color: var(--muted); text-transform: uppercase; letter-spacing: .04em; }
 .sqw-stat__value { font-size: 28px; font-weight: 700; line-height: 1; }
 
+.sqw-size-grid {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 1.5rem;
+  margin-top: 1.5rem;
+}
+
+.sqw-size-section { }
+
+.sqw-dist-bar-cell {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  min-width: 160px;
+}
+
+.sqw-dist-bar {
+  height: 8px;
+  background: var(--purple);
+  border-radius: 4px;
+  min-width: 2px;
+  opacity: 0.7;
+  transition: width 0.3s ease;
+}
+
+.sqw-dist-pct { font-size: 12px; white-space: nowrap; }
+
 .sqw-stat--ready    .sqw-stat__value { color: var(--success); }
 .sqw-stat--scheduled .sqw-stat__value { color: var(--info); }
 .sqw-stat--claimed  .sqw-stat__value { color: var(--primary); }

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

@@ -69,6 +69,7 @@ a.sqw-inline-stat:hover { opacity: 0.7; text-decoration: none; }
 }
 
 .sqw-inline-stat__value { font-size: 28px; font-weight: 700; line-height: 1; }
+.sqw-inline-stat__value--sm { font-size: 16px; }
 
 .sqw-inline-stat--ready     .sqw-inline-stat__value { color: var(--success); }
 .sqw-inline-stat--scheduled .sqw-inline-stat__value { color: var(--info); }
@@ -105,8 +106,28 @@ a.sqw-inline-stat:hover { opacity: 0.7; text-decoration: none; }
   height: 40px;
 }
 
-.sqw-sparkline--sm {
-  height: 24px;
+.sqw-sparkline--sm { height: 24px; }
+.sqw-sparkline--lg { height: 64px; }
+
+.sqw-timeline-grid {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 0;
+  margin-top: 1.5rem;
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  background: var(--surface);
+  box-shadow: var(--shadow);
+  overflow: hidden;
+}
+
+.sqw-timeline-chart {
+  border-top: none;
+  color: var(--purple);
+}
+
+.sqw-timeline-chart + .sqw-timeline-chart {
+  border-left: 1px solid var(--border);
 }
 
 .sqw-queue-sparkline {

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

@@ -70,6 +70,48 @@
   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-value-preview__header {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  margin-bottom: 0.75rem;
+}
+.sqw-value-preview__header .sqw-section-title { margin-bottom: 0; }
+
+.sqw-value-pre {
+  font-family: ui-monospace, "SFMono-Regular", Menlo, monospace;
+  font-size: 12px;
+  background: var(--bg);
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  padding: 0.75rem;
+  overflow-x: auto;
+  white-space: pre-wrap;
+  word-break: break-word;
+  max-height: 500px;
+  overflow-y: auto;
+}
+
+.sqw-value-truncated { font-size: 12px; margin-top: 0.5rem; }
+
+.sqw-link { color: var(--primary); text-decoration: none; }
+.sqw-link:hover { text-decoration: underline; }
+
 .sqw-code-input {
   font-family: ui-monospace, "SFMono-Regular", Menlo, monospace;
   font-size: 12px;

data/app/controllers/solid_stack_web/application_controller.rb

@@ -16,7 +16,7 @@ module SolidStackWeb
     def current_section
       case controller_name
       when "jobs", "failed_jobs", "queues", "processes", "history", "scheduled_jobs", "recurring_tasks" then :queue
-      when "cache" then :cache
+      when "cache", "cache_entries" then :cache
       when "cable" then :cable
       else :overview
       end

data/app/controllers/solid_stack_web/cache/flushes_controller.rb

@@ -0,0 +1,8 @@
+module SolidStackWeb
+  class Cache::FlushesController < ApplicationController
+    def destroy
+      ::SolidCache::Entry.delete_all
+      redirect_to cache_entries_path, notice: "All cache entries flushed."
+    end
+  end
+end

data/app/controllers/solid_stack_web/cache_controller.rb

@@ -3,6 +3,8 @@ module SolidStackWeb
     def index
       @total_entries   = ::SolidCache::Entry.count
       @total_byte_size = ::SolidCache::Entry.sum(:byte_size)
+      @size_stats      = CacheSizeStats.new
+      @timeline        = CacheTimeline.new
     end
   end
 end

data/app/controllers/solid_stack_web/cache_entries_controller.rb

@@ -0,0 +1,32 @@
+module SolidStackWeb
+  class CacheEntriesController < ApplicationController
+    def index
+      @search = params[:q].presence
+      @sort   = resolve_sort
+
+      scope = ::SolidCache::Entry.all
+      scope = scope.where("key LIKE ?", "%#{::ActiveRecord::Base.sanitize_sql_like(@search)}%") if @search
+      scope = scope.order(@sort["column"] => @sort["direction"])
+
+      @pagy, @entries = pagy(scope)
+    end
+
+    def show
+      @entry = ::SolidCache::Entry.find(params[:id])
+    end
+
+    def destroy
+      ::SolidCache::Entry.find(params[:id]).destroy
+      redirect_to cache_entries_path(q: params[:q], column: params[:column], direction: params[:direction]),
+                  notice: "Cache entry deleted."
+    end
+
+    private
+
+    def resolve_sort
+      column    = %w[byte_size created_at key].include?(params[:column]) ? params[:column] : "byte_size"
+      direction = %w[asc desc].include?(params[:direction])              ? params[:direction] : "desc"
+      { "column" => column, "direction" => direction }
+    end
+  end
+end

data/app/helpers/solid_stack_web/application_helper.rb

@@ -1,5 +1,13 @@
 module SolidStackWeb
   module ApplicationHelper
+    def format_cache_value(raw)
+      str = raw.to_s.encode("UTF-8", invalid: :replace, undef: :replace, replace: "?")
+      parsed = JSON.parse(str)
+      { label: "JSON", content: JSON.pretty_generate(parsed) }
+    rescue JSON::ParserError, JSON::GeneratorError
+      { label: "Text", content: str }
+    end
+
     def format_duration(seconds)
       return "—" if seconds.nil?
       return "#{(seconds * 1000).round}ms" if seconds < 1
@@ -10,6 +18,30 @@ module SolidStackWeb
       "#{s / 3600}h #{(s % 3600) / 60}m"
     end
 
+    def cache_entries_timeline_svg(timeline)
+      build_sparkline_svg(
+        Struct.new(:buckets, :max).new(timeline.entry_buckets, timeline.entry_max),
+        css_class: "sqw-sparkline sqw-sparkline--lg",
+        aria_label: "Cache entries written over the last 24 hours"
+      ) do |count, i|
+        hours_ago = CacheTimeline::HOURS - 1 - i
+        hours_ago.zero? ? "#{count} #{"entry".then { |w| count == 1 ? w : "entries" }} this hour" \
+                        : "#{count} #{"entry".then { |w| count == 1 ? w : "entries" }} #{hours_ago}h ago"
+      end
+    end
+
+    def cache_bytes_timeline_svg(timeline)
+      build_sparkline_svg(
+        Struct.new(:buckets, :max).new(timeline.byte_buckets, timeline.byte_max),
+        css_class: "sqw-sparkline sqw-sparkline--lg",
+        aria_label: "Cache bytes written over the last 24 hours"
+      ) do |bytes, i|
+        hours_ago = CacheTimeline::HOURS - 1 - i
+        size = number_to_human_size(bytes)
+        hours_ago.zero? ? "#{size} written this hour" : "#{size} written #{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/javascript/solid_stack_web/application.js

@@ -1,10 +1,12 @@
 import "@hotwired/turbo"
 import { Application } from "@hotwired/stimulus"
 import RefreshController from "solid_stack_web/refresh_controller"
+import SearchController from "solid_stack_web/search_controller"
 import SelectionController from "solid_stack_web/selection_controller"
 import SparklineTooltipController from "solid_stack_web/sparkline_tooltip_controller"
 
 const application = Application.start()
 application.register("refresh", RefreshController)
+application.register("search", SearchController)
 application.register("selection", SelectionController)
 application.register("sparkline-tooltip", SparklineTooltipController)

data/app/javascript/solid_stack_web/search_controller.js

@@ -0,0 +1,16 @@
+import { Controller } from "@hotwired/stimulus"
+
+export default class extends Controller {
+  filter({ target }) {
+    clearTimeout(this._timer)
+    const len = target.value.length
+    if (len >= 4 || len === 0) {
+      this._timer = setTimeout(() => target.form.requestSubmit(), 300)
+    }
+  }
+
+  select({ target }) {
+    clearTimeout(this._timer)
+    target.form.requestSubmit()
+  }
+}

data/app/models/solid_stack_web/cache_size_stats.rb

@@ -0,0 +1,33 @@
+module SolidStackWeb
+  class CacheSizeStats
+    BUCKETS = [
+      { label: "< 1 KB",       min: 0,       max: 1_024 },
+      { label: "1 – 10 KB",    min: 1_024,   max: 10_240 },
+      { label: "10 – 100 KB",  min: 10_240,  max: 102_400 },
+      { label: "100 KB – 1 MB", min: 102_400, max: 1_048_576 },
+      { label: "> 1 MB",       min: 1_048_576, max: nil }
+    ].freeze
+
+    TOP_N = 10
+
+    def top_entries
+      @top_entries ||= ::SolidCache::Entry
+                         .select(:id, :key, :byte_size)
+                         .order(byte_size: :desc)
+                         .limit(TOP_N)
+    end
+
+    def buckets
+      @buckets ||= BUCKETS.map do |b|
+        scope = ::SolidCache::Entry.all
+        scope = scope.where("byte_size >= ?", b[:min]) if b[:min] > 0
+        scope = scope.where("byte_size < ?",  b[:max]) if b[:max]
+        { label: b[:label], count: scope.count }
+      end
+    end
+
+    def total
+      @total ||= ::SolidCache::Entry.count
+    end
+  end
+end

data/app/models/solid_stack_web/cache_stats.rb

@@ -2,8 +2,9 @@ module SolidStackWeb
   class CacheStats
     def to_h
       {
-        entries:   ::SolidCache::Entry.count,
-        byte_size: ::SolidCache::Entry.sum(:byte_size)
+        entries:      ::SolidCache::Entry.count,
+        byte_size:    ::SolidCache::Entry.sum(:byte_size),
+        oldest_entry: ::SolidCache::Entry.minimum(:created_at)
       }
     end
   end

data/app/models/solid_stack_web/cache_timeline.rb

@@ -0,0 +1,40 @@
+module SolidStackWeb
+  class CacheTimeline
+    HOURS = 24
+
+    def entry_buckets
+      @entry_buckets ||= build_buckets { |rows, from, to| rows.count { |t, _| t >= from && t < to } }
+    end
+
+    def byte_buckets
+      @byte_buckets ||= build_buckets { |rows, from, to| rows.sum { |t, b| t >= from && t < to ? b : 0 } }
+    end
+
+    def entry_max
+      entry_buckets.max || 0
+    end
+
+    def byte_max
+      byte_buckets.max || 0
+    end
+
+    private
+
+    def rows
+      @rows ||= begin
+        origin = Time.current - HOURS.hours
+        ::SolidCache::Entry.where(created_at: origin..Time.current).pluck(:created_at, :byte_size)
+      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

@@ -24,6 +24,17 @@
     </div>
   </header>
 
+  <% if current_section == :cache %>
+    <nav class="sqw-subnav">
+      <div class="sqw-subnav__inner">
+        <%= link_to "Overview", cache_path,
+              class: "sqw-subnav__link#{" sqw-subnav__link--active" if controller_name == "cache"}" %>
+        <%= link_to "Entries", cache_entries_path,
+              class: "sqw-subnav__link#{" sqw-subnav__link--active" if controller_name == "cache_entries"}" %>
+      </div>
+    </nav>
+  <% end %>
+
   <% if current_section == :queue %>
     <nav class="sqw-subnav">
       <div class="sqw-subnav__inner">

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

@@ -3,12 +3,94 @@
 </div>
 
 <div class="sqw-stats-grid">
-  <div class="sqw-stat sqw-stat--cache">
+  <%= link_to cache_entries_path, class: "sqw-stat sqw-stat--cache" do %>
     <span class="sqw-stat__label">Total Entries</span>
     <span class="sqw-stat__value"><%= @total_entries %></span>
-  </div>
+  <% end %>
   <div class="sqw-stat sqw-stat--cache">
     <span class="sqw-stat__label">Total Size</span>
     <span class="sqw-stat__value"><%= number_to_human_size(@total_byte_size) %></span>
   </div>
 </div>
+
+<% if @total_entries > 0 %>
+  <div class="sqw-size-grid">
+    <section class="sqw-size-section">
+      <h2 class="sqw-section-title">Size Distribution</h2>
+      <table class="sqw-table">
+        <thead>
+          <tr>
+            <th>Range</th>
+            <th>Entries</th>
+            <th></th>
+          </tr>
+        </thead>
+        <tbody>
+          <% @size_stats.buckets.each do |bucket| %>
+            <% pct = @size_stats.total > 0 ? (bucket[:count].to_f / @size_stats.total * 100).round(1) : 0 %>
+            <tr>
+              <td class="sqw-muted"><%=bucket[:label] %></td>
+              <td><%= bucket[:count] %></td>
+              <td>
+                <div class="sqw-dist-bar-cell">
+                  <div class="sqw-dist-bar" style="width: <%= pct %>%"></div>
+                  <span class="sqw-dist-pct sqw-muted"><%= pct %>%</span>
+                </div>
+              </td>
+            </tr>
+          <% end %>
+        </tbody>
+      </table>
+    </section>
+
+    <section class="sqw-size-section">
+      <h2 class="sqw-section-title">Largest Entries</h2>
+      <table class="sqw-table">
+        <thead>
+          <tr>
+            <th>Key</th>
+            <th>Size</th>
+          </tr>
+        </thead>
+        <tbody>
+          <% @size_stats.top_entries.each do |entry| %>
+            <tr>
+              <td class="sqw-monospace sqw-truncate" title="<%= entry.key %>">
+                <%= link_to entry.key, cache_entry_path(entry), class: "sqw-link" %>
+              </td>
+              <td><%= number_to_human_size(entry.byte_size) %></td>
+            </tr>
+          <% end %>
+        </tbody>
+      </table>
+    </section>
+  </div>
+<% end %>
+
+<div class="sqw-timeline-grid" data-controller="sparkline-tooltip">
+  <div class="sqw-sparkline-wrap sqw-timeline-chart">
+    <span class="sqw-sparkline-label">Entries written — last 24 hours</span>
+    <div class="sqw-sparkline-positioner">
+      <%= cache_entries_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 class="sqw-sparkline-wrap sqw-timeline-chart">
+    <span class="sqw-sparkline-label">Bytes written — last 24 hours</span>
+    <div class="sqw-sparkline-positioner">
+      <%= cache_bytes_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>

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

@@ -0,0 +1,66 @@
+<div class="sqw-page-header sqw-page-header--split">
+  <h1 class="sqw-page-title">Cache Entries</h1>
+  <div class="sqw-header-actions">
+    <%= button_to "Flush All",
+          cache_flush_path,
+          method: :delete,
+          class: "sqw-btn sqw-btn--danger sqw-btn--sm",
+          data: { turbo_confirm: "Delete all cache entries? This cannot be undone." } %>
+  </div>
+</div>
+
+<form class="sqw-filters" action="<%= cache_entries_path %>" method="get" data-controller="search">
+  <%= hidden_field_tag :column,    @sort["column"] %>
+  <%= hidden_field_tag :direction, @sort["direction"] %>
+  <input class="sqw-search-input" type="search" name="q" value="<%= @search %>"
+         placeholder="Filter by key…" autocomplete="off" aria-label="Filter by key"
+         data-action="input->search#filter">
+  <% if @search.present? %>
+    <%= link_to "Clear", cache_entries_path(column: @sort["column"], direction: @sort["direction"]),
+          class: "sqw-btn sqw-btn--muted sqw-btn--sm" %>
+  <% end %>
+</form>
+
+<% if @entries.any? %>
+  <table class="sqw-table">
+    <thead>
+      <tr>
+        <% [["key", "Key"], ["byte_size", "Size"], ["created_at", "Created"]].each do |col, label| %>
+          <th>
+            <% next_dir = (@sort["column"] == col && @sort["direction"] == "desc") ? "asc" : "desc" %>
+            <%= link_to cache_entries_path(q: @search, column: col, direction: next_dir) do %>
+              <%= label %>
+              <% if @sort["column"] == col %>
+                <span class="sqw-sort-indicator"><%= @sort["direction"] == "desc" ? "↓" : "↑" %></span>
+              <% end %>
+            <% end %>
+          </th>
+        <% end %>
+        <th></th>
+      </tr>
+    </thead>
+    <tbody>
+      <% @entries.each do |entry| %>
+        <tr id="cache_entry_<%= entry.id %>">
+          <td class="sqw-monospace sqw-truncate" title="<%= entry.key %>">
+            <%= link_to entry.key, cache_entry_path(entry), class: "sqw-link" %>
+          </td>
+          <td><%= number_to_human_size(entry.byte_size) %></td>
+          <td class="sqw-muted"><%= entry.created_at.strftime("%b %d %H:%M") %></td>
+          <td class="sqw-actions">
+            <%= button_to "Delete",
+                  cache_entry_path(entry, q: @search, column: @sort["column"], direction: @sort["direction"]),
+                  method: :delete,
+                  class: "sqw-btn sqw-btn--danger sqw-btn--sm",
+                  data: { turbo_confirm: "Delete this cache entry?" } %>
+          </td>
+        </tr>
+      <% end %>
+    </tbody>
+  </table>
+  <%== pagy_nav(@pagy) if @pagy.pages > 1 %>
+<% else %>
+  <div class="sqw-empty">
+    <p><%= @search.present? ? "No entries matching &ldquo;#{@search}&rdquo;.".html_safe : "No cache entries." %></p>
+  </div>
+<% end %>

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

@@ -0,0 +1,48 @@
+<div class="sqw-page-header sqw-page-header--split">
+  <h1 class="sqw-page-title sqw-truncate" title="<%= @entry.key %>"><%= @entry.key %></h1>
+  <div class="sqw-header-actions">
+    <%= button_to "Delete",
+          cache_entry_path(@entry),
+          method: :delete,
+          class: "sqw-btn sqw-btn--danger sqw-btn--sm",
+          data: { turbo_confirm: "Delete this cache entry?" } %>
+    <%= link_to "← Entries", cache_entries_path, class: "sqw-btn sqw-btn--muted sqw-btn--sm" %>
+  </div>
+</div>
+
+<dl class="sqw-detail">
+  <div class="sqw-detail__row">
+    <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"><%= @entry.created_at.strftime("%b %d, %Y %H:%M:%S %Z") %></dd>
+  </div>
+</dl>
+
+<section class="sqw-value-preview">
+  <div class="sqw-value-preview__header">
+    <h2 class="sqw-section-title">Value</h2>
+    <% if SolidStackWeb.allow_value_preview %>
+      <% formatted = format_cache_value(@entry.value) %>
+      <span class="sqw-badge sqw-badge--queue"><%= formatted[:label] %></span>
+    <% end %>
+  </div>
+  <% if SolidStackWeb.allow_value_preview %>
+    <% content = formatted[:content] %>
+    <% truncated = content.length > 4096 %>
+    <pre class="sqw-value-pre"><%= 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 %>
+  <% else %>
+    <div class="sqw-empty">
+      <p>Value preview is disabled. Set <code>config.allow_value_preview = true</code> in your initializer to enable.</p>
+    </div>
+  <% end %>
+</section>

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

@@ -76,14 +76,20 @@
       <%= link_to "View Cache →", cache_path, class: "sqw-gem-card__link" %>
     </div>
     <div class="sqw-gem-card__body">
-      <div class="sqw-inline-stat sqw-inline-stat--cache">
+      <%= link_to cache_entries_path, class: "sqw-inline-stat sqw-inline-stat--cache" do %>
         <span class="sqw-inline-stat__label">Entries</span>
         <span class="sqw-inline-stat__value"><%= @cache_stats[:entries] %></span>
-      </div>
+      <% end %>
       <div class="sqw-inline-stat sqw-inline-stat--cache">
         <span class="sqw-inline-stat__label">Size</span>
         <span class="sqw-inline-stat__value"><%= number_to_human_size(@cache_stats[:byte_size]) %></span>
       </div>
+      <% if @cache_stats[:oldest_entry] %>
+        <div class="sqw-inline-stat sqw-inline-stat--cache">
+          <span class="sqw-inline-stat__label">Oldest</span>
+          <span class="sqw-inline-stat__value sqw-inline-stat__value--sm" title="<%= @cache_stats[:oldest_entry].strftime("%b %d, %Y %H:%M") %>"><%= time_ago_in_words(@cache_stats[:oldest_entry]) %></span>
+        </div>
+      <% end %>
     </div>
   </div>
 

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

@@ -10,14 +10,14 @@
   </div>
 </div>
 
-<form class="sqw-filters" action="<%= history_path %>" method="get">
+<form class="sqw-filters" action="<%= history_path %>" method="get" data-controller="search">
   <% if @queue.present? %>
     <input type="hidden" name="queue" value="<%= @queue %>">
   <% end %>
   <input type="hidden" name="period" value="<%= @period %>">
   <input class="sqw-search-input" type="search" name="q" value="<%= @search %>"
-         placeholder="Filter by job class…" autocomplete="off" aria-label="Filter by job class">
-  <button type="submit" class="sqw-btn sqw-btn--muted sqw-btn--sm">Search</button>
+         placeholder="Filter by job class…" autocomplete="off" aria-label="Filter by job class"
+         data-action="input->search#filter">
   <% if @search.present? %>
     <%= link_to "Clear", history_path(queue: @queue, period: @period), class: "sqw-btn sqw-btn--muted sqw-btn--sm" %>
   <% end %>

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

@@ -32,13 +32,15 @@
 <%= turbo_frame_tag "sqw-jobs-filter",
       data: { turbo_action: "advance", controller: "refresh",
               refresh_interval_value: SolidStackWeb.default_refresh_interval } do %>
-<form class="sqw-filters" action="<%= jobs_path %>" method="get">
+<form class="sqw-filters" action="<%= jobs_path %>" method="get" data-controller="search">
   <%= hidden_field_tag :status, @status %>
   <%= hidden_field_tag :period, @period %>
   <input class="sqw-search-input" type="search" name="q" value="<%= @search %>"
-         placeholder="Filter by job class…" autocomplete="off" aria-label="Filter by job class">
+         placeholder="Filter by job class…" autocomplete="off" aria-label="Filter by job class"
+         data-action="input->search#filter">
   <% if @queue_options.size > 1 %>
-    <select name="queue" class="sqw-select" aria-label="Filter by queue" onchange="this.form.requestSubmit()">
+    <select name="queue" class="sqw-select" aria-label="Filter by queue"
+            data-action="change->search#select">
       <option value="">All queues</option>
       <% @queue_options.each do |q| %>
         <option value="<%= q %>" <%= "selected" if @queue == q %>><%= q %></option>
@@ -46,14 +48,14 @@
     </select>
   <% end %>
   <% if @priority_options.size > 1 %>
-    <select name="priority" class="sqw-select" aria-label="Filter by priority" onchange="this.form.requestSubmit()">
+    <select name="priority" class="sqw-select" aria-label="Filter by priority"
+            data-action="change->search#select">
       <option value="">All priorities</option>
       <% @priority_options.each do |p| %>
         <option value="<%= p %>" <%= "selected" if @priority.to_s == p.to_s %>>Priority <%= p %></option>
       <% end %>
     </select>
   <% end %>
-  <button type="submit" class="sqw-btn sqw-btn--muted sqw-btn--sm">Search</button>
   <% if @search.present? || @queue.present? || @priority.present? %>
     <%= link_to "Clear", jobs_path(status: @status, period: @period), class: "sqw-btn sqw-btn--muted sqw-btn--sm" %>
   <% end %>

data/config/importmap.rb

@@ -2,5 +2,6 @@ pin "@hotwired/turbo", to: "https://cdn.jsdelivr.net/npm/@hotwired/turbo@8.0.23/
 pin "@hotwired/stimulus", to: "https://cdn.jsdelivr.net/npm/@hotwired/stimulus@3.2.2/dist/stimulus.js"
 pin "solid_stack_web", to: "solid_stack_web/application.js"
 pin "solid_stack_web/refresh_controller", to: "solid_stack_web/refresh_controller.js"
+pin "solid_stack_web/search_controller", to: "solid_stack_web/search_controller.js"
 pin "solid_stack_web/selection_controller", to: "solid_stack_web/selection_controller.js"
 pin "solid_stack_web/sparkline_tooltip_controller", to: "solid_stack_web/sparkline_tooltip_controller.js"

data/config/routes.rb

@@ -35,5 +35,7 @@ SolidStackWeb::Engine.routes.draw do
   get "stats",   to: "stats#index",   as: :stats
   get "history", to: "history#index", as: :history
   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
 end

data/lib/solid_stack_web/version.rb

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

data/lib/solid_stack_web.rb

@@ -7,7 +7,7 @@ module SolidStackWeb
                 :alert_webhook_url, :alert_webhook_cooldown,
                 :alert_failure_threshold, :alert_queue_thresholds,
                 :dashboard_refresh_interval, :default_refresh_interval,
-                :search_results_limit
+                :search_results_limit, :allow_value_preview
 
     def page_size
       @page_size || 25
@@ -49,6 +49,10 @@ module SolidStackWeb
       @search_results_limit || 25
     end
 
+    def allow_value_preview
+      @allow_value_preview || false
+    end
+
     def configure
       yield self
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: solid_stack_web
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Chuck Smith
@@ -145,7 +145,9 @@ files:
 - app/assets/stylesheets/solid_stack_web/application.css
 - app/controllers/solid_stack_web/application_controller.rb
 - app/controllers/solid_stack_web/cable_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
 - 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/selections_controller.rb
@@ -164,11 +166,14 @@ files:
 - app/helpers/solid_stack_web/application_helper.rb
 - app/javascript/solid_stack_web/application.js
 - app/javascript/solid_stack_web/refresh_controller.js
+- app/javascript/solid_stack_web/search_controller.js
 - app/javascript/solid_stack_web/selection_controller.js
 - 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/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/job.rb
 - app/models/solid_stack_web/queue_depth_sparkline.rb
 - app/models/solid_stack_web/queue_stats.rb
@@ -176,6 +181,8 @@ files:
 - app/views/layouts/solid_stack_web/application.html.erb
 - app/views/solid_stack_web/cable/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
 - app/views/solid_stack_web/dashboard/index.html.erb
 - app/views/solid_stack_web/failed_jobs/destroy.turbo_stream.erb
 - app/views/solid_stack_web/failed_jobs/index.html.erb
@@ -218,7 +225,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.12
+rubygems_version: 4.0.10
 specification_version: 4
 summary: A unified Rails engine dashboard for Solid Queue, Solid Cache, and Solid
   Cable.