solid_observer 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 563c4874ef7e6a8ad8a485d0b3f86c9d1d8f924d5308d44c5137f76bda7e03de
-  data.tar.gz: 88ba3331b45977349604047db1a4e3e98efb17ebc1eca8d4c52a96825d320a83
+  metadata.gz: 7c363ea187ff44b2a28184384cfbdee1d570c6e8fd981abceded3844819a2338
+  data.tar.gz: ff5bb32bb53ad65ea688365a5b8666aa34552580d3d78856f8e542fcf53b6d4c
 SHA512:
-  metadata.gz: e56550b5f3cfbbb6a54325901a19bb4a70850a994e047d282cea653b420822cd1a9148c603c2886c92fb5bc9683b650587db575ef90d85b39800430ee7ffbdde
-  data.tar.gz: dbf38ea6c5205ef027642cf02b84e3c59950299ea0477a2f7fef8df7543d71ece58dd90026f396650a99ad948ffa49cf16978f6a596c998d87ab085df739a114
+  metadata.gz: cbac07f62a04d4ea7ae4c8c2c1200f04c07f400f94ca5775785380853cd63f56eccdc154b1debe55438fc60482d54be55199265c299eae43577e1943b60abd1e
+  data.tar.gz: '018f433df069c72a8a12ced3434e4b05f5a26eb6209bb33af0e5c29b3aca2df1961359692e250f247769cb0e9bab322b946dc208ca265688fb4ae0316de24dd9'

data/CHANGELOG.md

@@ -1,3 +1,20 @@
+## [0.6.0] - 2026-08-04
+
+Headline: **Cross-component Tracing, Health Scoring & Unified Dashboard** — trace correlation across Queue/Cache/Cable, unified home dashboard, health scoring service, and CLI health & trace commands.
+
+### Added
+- **Correlation ID propagation** — automatic correlation ID generation and propagation across ActiveJob (`Correlated.stamp`), SolidCache, and SolidCable events; configurable `correlation_id_generator`.
+- **Cross-component trace service & CLI** — `Queries::TraceQuery` for fetching cross-component events by `correlation_id`; `rails solid_observer:trace[CORRELATION_ID,LIMIT]` CLI command.
+- **Trace Web UI** — Web interface at `/solid_observer/traces/:correlation_id` displaying component-tagged event timelines across Queue, Cache, and Cable.
+- **Unified health scoring service** — `Services::HealthScore` auto-calculates overall host stability using worst-of component statuses (Queue, Cache, Cable) with zero configuration required.
+- **CLI health command** — `rails solid_observer:health` CLI command displaying aggregate and per-component health status.
+
+### Changed
+- **Combined / Unified Dashboard** — Engine root (`GET /solid_observer/`) now renders the unified Home dashboard (overall health banner, per-component status cards, and merged multi-component activity feed). Dedicated Queue overview moved to `/solid_observer/queue`.
+
+### Upgrade & Database Migration
+- **Required DB Migration** — Running `bin/rails solid_observer:install:migrations && bin/rails db:migrate` is required when upgrading to v0.6.0. Adds `correlation_id` columns to `solid_observer_cache_events` and `solid_observer_cable_events` tables.
+
 ## [0.5.0] - 2026-06-24
 
 Headline: **Solid Cable observability** — optional Cable telemetry, dashboard, storage health, and guarded trim controls.

data/README.md

@@ -7,33 +7,35 @@
 </p>
 
 <p align="center">
-  <a href="https://github.com/bart-oz/solid_observer/releases"><img src="https://img.shields.io/badge/version-0.5.0-blue.svg" alt="Version"></a>
+  <a href="https://github.com/bart-oz/solid_observer/releases"><img src="https://img.shields.io/badge/version-0.6.0-blue.svg" alt="Version"></a>
   <a href="LICENSE.txt"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License"></a>
   <a href="https://github.com/bart-oz/solid_observer/actions"><img src="https://img.shields.io/badge/tests-passing-brightgreen.svg" alt="Tests"></a>
-  <a href="https://github.com/bart-oz/solid_observer/actions"><img src="https://img.shields.io/badge/coverage-96.22%25-brightgreen.svg" alt="Coverage"></a>
-</p>
+  <a href="https://github.com/bart-oz/solid_observer/actions"><img src="https://img.shields.io/badge/coverage-97.96%25-brightgreen.svg" alt="Coverage"></a>
 
 ---
 <p align="center">
   <a href=".github/assets/dash_1.png"><img src=".github/assets/dash_1.png" alt="SolidObserver dashboard overview" width="700"></a>
 </p>
 
-SolidObserver is a production-grade observability solution for Rails 8's Solid Stack. v0.5.0 covers **Solid Queue**, **Solid Cache**, and **Solid Cable** with a unified Web UI dashboard, CLI tools, metrics collection, and distributed tracing support.
+SolidObserver is a production-grade observability solution for Rails 8's Solid Stack. v0.6.0 covers **Solid Queue**, **Solid Cache**, and **Solid Cable** with a unified Web UI dashboard, health scoring (`Services::HealthScore`), CLI tools, metrics collection, and cross-component trace correlation by `correlation_id`.
 
-## Features (v0.5.0)
+## Features (v0.6.0)
 
 | | Solid Queue | Solid Cache | Solid Cable |
 |---|---|---|---|
 | **Web UI Dashboard** | Queue stats, jobs browser, events log | Hit rate, ops/sec, error rate, avg duration | Broadcasts, rejection rate, trends |
+| **Unified Home** | Overall health banner, component cards, merged activity feed at `/solid_observer` |
+| **Health Scoring** | Worst-of aggregate stability (`Services::HealthScore`), config-free |
+| **Cross-Component Trace** | Timeline by `correlation_id` across Queue, Cache, Cable (`/solid_observer/traces/:id`) |
 | **Storage footprint** | DB size, event counts | SolidCache table size, row counts | Message count + backlogs |
 | **Activity trends** | Sparklines (Performed, Ready, Failed) | Activity trend sparklines | Broadcast/rejection sparklines |
 | **Stability indicator** | Stable / Degraded / Critical badge | Stability pill badge | Stable / Degraded / Critical (hybrid) |
 | **Operational controls** | Retry / discard failed jobs | Prune expired entries, clear all entries | Trim expired messages |
-| **CLI tools** | status, jobs:list/show/retry/discard | cache:prune, cache:clear | cable:trim |
+| **CLI tools** | status, health, trace, jobs:list/show/retry/discard | cache:prune, cache:clear | cable:trim |
 | **Privacy** | Job arguments excluded from persisted events | Keys and values **never** shown | Broadcasting names hashed (SHA256) |
 | **Operating modes** | Real-time (no DB) or persistence (full history) | Persistence mode only | Persistence mode only |
 
-Additional: 🔗 APM distributed tracing · ⚡ buffered writes · 🛡️ Docker/CI/K8s safe boot
+Additional: 🔗 Cross-component trace lookup by correlation_id · 🩺 Config-free aggregate health score · 🏠 Unified Home dashboard · ⚡ buffered writes · 🛡️ Docker/CI/K8s safe boot
 
 ## Requirements
 
@@ -175,6 +177,14 @@ Configuration:
 
 SolidObserver ships with a zero-dependency Web UI (no asset pipeline, no JS framework) at `/solid_observer`.
 
+### Views & Routes
+
+- **Unified Home Dashboard** (`/solid_observer/`) — Overall worst-of health score banner, per-component status cards (Queue, Cache, Cable), and a unified cross-component activity feed.
+- **Queue Overview** (`/solid_observer/queue`) — Dedicated Queue metrics, job browser (ready/scheduled/claimed/failed), events log, time-range trends, and operational controls.
+- **Cache Dashboard** (`/solid_observer/cache_dashboard`) — SolidCache hit rates, ops/sec, error rates, storage footprint, and prune/clear controls.
+- **Cable Dashboard** (`/solid_observer/cable_dashboard`) — SolidCable broadcast volume, rejection rates, backlog trends, and message trim controls.
+- **Cross-Component Trace Timeline** (`/solid_observer/traces/:correlation_id`) — Component-tagged event sequence across Queue, Cache, and Cable for a specific correlation ID.
+
 ### Mount
 
 The install generator mounts it for you. To mount manually:
@@ -398,7 +408,10 @@ SolidObserver.configure do |config|
 end
 ```
 
-When configured, all job events will include your correlation ID, allowing you to trace jobs back to the originating request.
+When configured, all job, cache, and cable events will include your correlation ID. You can query the full cross-component event timeline for any request or job:
+
+- **CLI**: `bin/rails "solid_observer:trace[CORRELATION_ID,LIMIT]"`
+- **Web UI**: `/solid_observer/traces/:correlation_id`
 
 ### Production hardening (recommended)
 
@@ -427,6 +440,7 @@ end
 | Command | Description |
 |---------|-------------|
 | `solid_observer:status` | Show queue status overview |
+| `solid_observer:health` | Display aggregate and per-component health status |
 | `solid_observer:jobs:list[status,queue,class,limit]` | List jobs with optional filters |
 | `solid_observer:jobs:show[ID]` | Show job details |
 | `solid_observer:jobs:retry[ID]` | Retry a failed job |
@@ -444,6 +458,7 @@ end
 | `solid_observer:cache:clear` | Clear all SolidCache entries (with confirmation) |
 | `solid_observer:cache:prune` | Prune expired SolidCache entries |
 | `solid_observer:cable:trim` | Trim expired Solid Cable messages |
+| `solid_observer:trace[CORRELATION_ID,LIMIT]` | Show cross-component trace timeline |
 
 > **Note:** Storage commands manage **SolidObserver's storage** (event logs, metrics, snapshots) — not Solid Queue's jobs. Cache commands operate on SolidCache entries in the host app's cache store.
 
@@ -534,8 +549,8 @@ gem "sqlite3", "~> 2.0"
 | v0.1.1 | Real-time mode (no migrations needed) | ✅ Released |
 | v0.3.0 | Web UI dashboard + stability hardening | ✅ Released |
 | v0.4.0 | Solid Cache monitoring | ✅ Released |
-| v0.5.0 | Solid Cable monitoring | ✅ Current |
-| v0.6.0 | Cross-component correlation, health scores | 🔜 Planned |
+| v0.5.0 | Solid Cable monitoring | ✅ Released |
+| v0.6.0 | Cross-component trace correlation, health scores, unified dashboard | ✅ Current |
 | v0.7.0 | Alerting & notifications | 🔜 Planned |
 | v1.0.0 | Production stable release | 🎯 Goal |
 

data/app/controllers/solid_observer/dashboard_controller.rb

@@ -12,10 +12,23 @@ module SolidObserver
     def index
       @component = selected_component
 
-      return unless @component == "queue" && SolidObserver.config.solid_queue_enabled?
-
-      assign_range_and_stats
-      load_persistence_data if persistence_mode?
+      if @component == "queue" && SolidObserver.config.solid_queue_enabled?
+        assign_range_and_stats
+        load_persistence_data if persistence_mode?
+      elsif @component == "home"
+        @health = begin
+          Services::HealthScore.call
+        rescue => error
+          Rails.logger&.warn("Home HealthScore: #{error.class}: #{error.message}")
+          {overall: :degraded, components: {}}
+        end
+        @feed = begin
+          Services::UnifiedFeed.call
+        rescue => error
+          Rails.logger&.warn("Home UnifiedFeed: #{error.class}: #{error.message}")
+          []
+        end
+      end
     end
 
     def live_poll
@@ -98,17 +111,18 @@ module SolidObserver
         ""
       end
       requested = path_component if requested.empty?
+      return "queue" if requested == "queue" && SolidObserver.config.solid_queue_enabled?
       return "cache" if requested == "cache" && SolidObserver.config.solid_cache_enabled?
 
-      "queue"
+      "home"
     end
 
     def path_component
       return "" unless request&.respond_to?(:path)
 
       path = request&.path.to_s
-      return "cache" if path.end_with?("/cache")
       return "queue" if path.end_with?("/queue")
+      return "cache" if path.end_with?("/cache")
 
       ""
     end

data/app/controllers/solid_observer/traces_controller.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require_relative "../../helpers/solid_observer/application_helper"
+
+module SolidObserver
+  class TracesController < ApplicationController
+    helper SolidObserver::ApplicationHelper
+
+    include RequirePersistenceMode
+
+    def show
+      result = SolidObserver::Queries::TraceQuery.new.call(correlation_id: params[:id])
+      @rows = result.rows
+      @unavailable_components = result.unavailable_components
+    end
+  end
+end

data/app/helpers/solid_observer/application_helper.rb

@@ -250,9 +250,37 @@ module SolidObserver
       SolidObserver.config.solid_cable_enabled?
     end
 
-    def dashboard_section_active?(component)
-      current_component = @component.presence || "queue"
-      controller_name == "dashboard" && current_component == component.to_s
+    def home?
+      controller_name == "dashboard" && @component.to_s == "home"
+    end
+
+    def health_status_badge(status)
+      stability_badge_for(status.to_sym)
+    rescue KeyError
+      Rails.logger&.warn("health_status_badge: unknown status #{status.inspect}, falling back to degraded")
+      stability_badge_for(:degraded)
+    end
+
+    def unified_feed_detail(row)
+      detail = row[:detail].to_s
+      if row[:correlation_id].present?
+        link_to(detail.presence || row[:correlation_id], trace_path(row[:correlation_id]), class: "so-trace__link")
+      else
+        detail.presence || "—"
+      end
+    end
+
+    def component_overview_path(name)
+      case name.to_sym
+      when :queue
+        queue_dashboard_path
+      when :cache
+        cache_dashboard_path
+      when :cable
+        cable_dashboard_path
+      else
+        root_path
+      end
     end
 
     private

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

@@ -524,6 +524,19 @@
 
     .so-card li + li { margin-top: 0.45rem; }
 
+    /* SO-098 trace page */
+    .so-trace { max-width: 1120px; }
+    .so-trace__meta { margin-top: .35rem; font-size: .875rem; line-height: 1.5; color: var(--so-text-subtle); }
+    .so-trace__correlation { font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", monospace; overflow-wrap: anywhere; }
+    .so-trace__table { min-width: 760px; }
+    .so-trace__time { width: 10.75rem; white-space: nowrap; }
+    .so-trace__component { width: 7.75rem; white-space: nowrap; }
+    .so-trace__event { width: 10.5rem; white-space: nowrap; }
+    .so-trace__details { min-width: 20rem; white-space: normal; overflow-wrap: anywhere; line-height: 1.5; }
+    .so-trace__link { color: var(--so-info); text-decoration: none; }
+    .so-trace__link:hover { text-decoration: underline; }
+    .so-trace__link:focus-visible { outline: 2px solid var(--so-info); outline-offset: 2px; box-shadow: 0 0 0 3px var(--so-focus-ring); }
+
     @media (max-width: 960px) {
       .so-dashboard-toolbar { flex-direction: column; align-items: stretch; }
       .so-dashboard-toolbar__left, .so-dashboard-toolbar__right { margin-left: 0; }
@@ -553,9 +566,11 @@
     <aside class="so-sidebar">
       <div class="so-sidebar__logo">SolidObserver</div>
       <nav class="so-sidebar__nav" aria-label="SolidObserver navigation">
+        <%= link_to "Home", root_path, class: ("active" if home?), "aria-current": (home? ? "page" : nil) %>
+
         <% if SolidObserver.config.solid_queue_enabled? %>
           <div class="so-sidebar__section">Queue</div>
-          <%= link_to "Overview", root_path, class: ("active" if controller_name == "dashboard" && @component.to_s != "cache"), "aria-current": (controller_name == "dashboard" && @component.to_s != "cache" ? "page" : nil) %>
+          <%= link_to "Overview", queue_dashboard_path, class: ("active" if controller_name == "dashboard" && @component.to_s == "queue"), "aria-current": (controller_name == "dashboard" && @component.to_s == "queue" ? "page" : nil) %>
           <%= link_to "Jobs", jobs_path, class: ("active" if controller_name == "jobs"), "aria-current": (controller_name == "jobs" ? "page" : nil) %>
           <% if persistence_mode? %>
             <%= link_to "Events", events_path, class: ("active" if controller_name == "events"), "aria-current": (controller_name == "events" ? "page" : nil) %>

data/app/views/solid_observer/cable_dashboard/_recent_events.html.erb

@@ -19,7 +19,12 @@
       <tbody>
         <% recent_events.each do |event| %>
           <tr>
-            <td><%= event.event_type.to_s %></td>
+            <td>
+              <%= event.event_type.to_s %>
+              <% if event.correlation_id.present? %>
+                <%= link_to "Trace →", trace_path(event.correlation_id), class: "so-trace__link" %>
+              <% end %>
+            </td>
             <td><%= event.channel_class.presence || "—" %></td>
             <td><span class="so-cable-dashboard__digest"><%= cable_event_digest(event.broadcasting_digest) %></span></td>
             <td><%= event.duration ? format_duration(event.duration) : "—" %></td>

data/app/views/solid_observer/cache_dashboard/_recent_events.html.erb

@@ -19,7 +19,12 @@
       <tbody>
         <% recent_events.each do |event| %>
           <tr>
-            <td><%= event.event_type.to_s.humanize %></td>
+            <td>
+              <%= event.event_type.to_s.humanize %>
+              <% if event.correlation_id.present? %>
+                <%= link_to "Trace →", trace_path(event.correlation_id), class: "so-trace__link" %>
+              <% end %>
+            </td>
             <td><span class="so-cache-dashboard__digest"><%= cache_event_digest(event.key_digest) %></span></td>
             <td><%= cache_event_outcome_badge(event) %></td>
             <td><%= event.duration ? format_duration(event.duration) : "—" %></td>

data/app/views/solid_observer/dashboard/_component_cards.html.erb

@@ -0,0 +1,18 @@
+<% if health[:components].present? %>
+<section class="so-cards-section" data-so-zone="home-cards" aria-labelledby="so-home-components-heading">
+  <h2 class="so-cards-section__title" id="so-home-components-heading">Components</h2>
+  <div class="so-stat-cards">
+    <% health[:components].each do |name, info| %>
+      <div class="so-card" aria-labelledby="so-card-<%= name %>">
+        <div class="so-card__label" id="so-card-<%= name %>"><%= name.to_s.titleize %></div>
+        <div class="so-card__value">
+          <%= health_status_badge(info[:status]) %>
+        </div>
+        <div class="so-card__subtitle">
+          <% unless info[:available] %><span class="so-badge so-badge--default">Unavailable</span> · <% end %><%= link_to "View overview →", component_overview_path(name), class: "so-stability__link" %>
+        </div>
+      </div>
+    <% end %>
+  </div>
+</section>
+<% end %>

data/app/views/solid_observer/dashboard/_health.html.erb

@@ -0,0 +1,6 @@
+<% non_stable = health[:components].count { |_n, i| i[:status].to_sym != :stable } %>
+<section class="so-stability" data-so-zone="home-health" aria-labelledby="so-health-heading">
+  <span class="so-stability__label" id="so-health-heading">Overall Health</span>
+  <%= health_status_badge(health[:overall]) %>
+  <span class="so-stability__detail"><%= non_stable.zero? ? "All included components stable" : "#{non_stable} component#{'s' unless non_stable == 1} not stable" %></span>
+</section>

data/app/views/solid_observer/dashboard/_home.html.erb

@@ -0,0 +1,10 @@
+<% content_for :title, "Home" %>
+<div class="so-dashboard" data-so-zone="home">
+  <div class="so-content__header">
+    <h1>Home</h1>
+  </div>
+
+  <%= render "health", health: health %>
+  <%= render "component_cards", health: health %>
+  <%= render "unified_feed", feed: feed %>
+</div>

data/app/views/solid_observer/dashboard/_queue.html.erb

@@ -0,0 +1,138 @@
+<div class="so-dashboard">
+  <% queue_enabled = SolidObserver.config.solid_queue_enabled? %>
+  <% queue_status_class = queue_enabled ? "so-badge--success" : "so-badge--warning" %>
+
+  <div class="so-content__header">
+    <h1>Queue overview</h1>
+    <div class="so-queue-overview__intro">
+      <span class="so-badge so-badge--pill <%= queue_status_class %>">
+        <svg class="so-badge__dot" viewBox="0 0 6 6" aria-hidden="true">
+          <circle r="3" cx="3" cy="3" />
+        </svg>
+        <%= queue_enabled ? "Available" : "Unavailable" %>
+      </span>
+      <% if queue_enabled %>
+        <p class="so-queue-overview__hint">Selected range: <%= range_label(@range) %></p>
+      <% end %>
+    </div>
+  </div>
+
+  <% if !queue_enabled %>
+    <section class="so-card so-card--section" aria-labelledby="so-queue-unavailable-heading">
+      <h2 id="so-queue-unavailable-heading">Queue Unavailable</h2>
+      <p class="so-dashboard-section__meta so-dashboard-section__meta--idle">Queue component is disabled or not installed. Enable SolidQueue to access dashboard controls.</p>
+    </section>
+  <% else %>
+  <%# Zone A: Toolbar — range selector, Refresh, Live toggle, help disclosure %>
+  <div class="so-dashboard-toolbar" data-so-live data-so-poll-url="<%= poll_data_path %>">
+    <form action="<%= request.path %>" method="get" class="so-dashboard-toolbar__left">
+      <label for="so-range" class="so-card__label so-filters__label">Range</label>
+      <select id="so-range" name="range" data-so-range-select onchange="this.form.submit()">
+        <% SolidObserver::QueueStats::RANGES.each_key do |key| %>
+          <option value="<%= key %>" <%= "selected" if key == @range %>><%= key %></option>
+        <% end %>
+      </select>
+      <button type="button" class="so-btn so-btn--refresh" data-so-refresh aria-busy="false">Refresh data</button>
+      <span class="so-toolbar-freshness" data-so-freshness aria-live="polite"></span>
+      <input type="hidden" name="live" value="<%= @live ? 'on' : '' %>">
+    </form>
+    <div class="so-dashboard-toolbar__right">
+      <label class="so-toggle so-toggle--pill <%= "so-toggle--on" if @live %>">
+        <input type="checkbox" name="live" value="on" <%= "checked" if @live %> data-so-live-toggle>
+        <span class="so-toggle__track" aria-hidden="true">
+          <span class="so-toggle__thumb"></span>
+        </span>
+        <span class="so-toggle__label">Live</span>
+        <span class="so-toggle__sep" aria-hidden="true"> · </span>
+        <span class="so-toggle__cadence" aria-live="polite"><%= @live ? "5s" : "off" %></span>
+        <span class="so-toggle__dot" aria-hidden="true"></span>
+      </label>
+      <div class="so-help-wrapper" data-so-help-wrapper>
+        <button type="button" class="so-btn so-btn--help" data-so-help-btn aria-expanded="false" aria-controls="so-help-panel">(?)
+        </button>
+        <div id="so-help-panel" class="so-help-panel" data-so-help-panel hidden>
+          <p>Live mode polls every 5 seconds for current queue state. Throughput and chart data update only on range change or manual refresh.</p>
+        </div>
+      </div>
+    </div>
+  </div>
+
+  <%# Zone B: Right now — live state %>
+  <section class="so-dashboard-section" aria-labelledby="so-live-state-heading">
+    <div class="so-dashboard-section__header">
+      <h2 class="so-dashboard-section__title" id="so-live-state-heading">Right now</h2>
+      <span class="so-dashboard-section__meta"><span class="so-badge so-badge--pill so-badge--success"><svg class="so-badge__dot" viewBox="0 0 6 6" aria-hidden="true"><circle r="3" cx="3" cy="3" fill="var(--so-live-marker, var(--so-success))"/></svg></span> current</span>
+    </div>
+    <%= render "live_state", stats: @stats %>
+  </section>
+
+  <%# Zone C: Throughput in selected range %>
+  <% if persistence_mode? && @stats[:available] %>
+    <section class="so-dashboard-section" aria-labelledby="so-throughput-heading">
+      <div class="so-dashboard-section__header">
+        <h2 class="so-dashboard-section__title" id="so-throughput-heading">Throughput in selected range</h2>
+        <span class="so-dashboard-section__meta"><span class="so-badge so-badge--pill so-badge--info"><svg class="so-badge__dot" viewBox="0 0 6 6" aria-hidden="true"><circle r="3" cx="3" cy="3" fill="var(--so-range-marker, var(--so-info))"/></svg></span> <span data-so-range-copy><%= range_label(@range) %></span></span>
+      </div>
+      <%= render "throughput", stats: @stats, range: @range %>
+    </section>
+  <% end %>
+
+  <%# Zone D: Charts %>
+  <% if @stats[:available] %>
+    <section class="so-dashboard-section" aria-labelledby="so-chart-heading">
+      <div class="so-dashboard-section__header">
+        <h2 class="so-dashboard-section__title" id="so-chart-heading">Charts</h2>
+      </div>
+      <%= render "chart", range: @range %>
+    </section>
+  <% end %>
+
+  <%# Zone E: Per-queue table %>
+  <%= render "queue_table", stats: @stats, range: @range %>
+
+  <%# Zone F: Stability strip %>
+  <% if @stats[:available] && persistence_mode? %>
+    <section class="so-stability" data-so-zone="stability" aria-labelledby="so-stability-heading">
+      <span class="so-stability__label" id="so-stability-heading">Stability</span>
+      <%= stability_badge(@stats) %>
+      <span class="so-stability__detail"><%= stability_detail(@stats) %></span>
+      <%= link_to "View failures →", events_path(event_type: "job_failed"), class: "so-stability__link" %>
+    </section>
+  <% end %>
+
+  <%# Zone G: Recent Events %>
+  <% if @stats[:available] && persistence_mode? %>
+    <% if defined?(@recent_events) && @recent_events.present? %>
+      <div class="so-card">
+        <div class="so-card__label">Recent Events</div>
+        <table class="so-table so-table--card">
+          <caption class="sr-only">Recent queue events</caption>
+          <thead>
+            <tr>
+              <th>Event</th>
+              <th>Job Class</th>
+              <th>Queue</th>
+              <th>Time</th>
+            </tr>
+          </thead>
+          <tbody>
+            <% @recent_events.each do |event| %>
+              <tr>
+                <td><%= event.event_type.humanize %></td>
+                <td><%= event.job_class %></td>
+                <td><%= event.queue_name %></td>
+                <td><%= time_ago_in_words(event.recorded_at) %> ago</td>
+              </tr>
+            <% end %>
+          </tbody>
+        </table>
+      </div>
+    <% else %>
+      <div class="so-card">
+        <div class="so-card__label">Recent Events</div>
+        <p class="so-dashboard-section__meta so-dashboard-section__meta--empty-events">No recent events yet. Queue activity will appear here after jobs are enqueued, performed, or failed.</p>
+      </div>
+    <% end %>
+  <% end %>
+  <% end %>
+</div>

data/app/views/solid_observer/dashboard/_unified_feed.html.erb

@@ -0,0 +1,38 @@
+<section class="so-card" data-so-zone="home-feed" aria-labelledby="so-feed-heading">
+  <div class="so-card__label" id="so-feed-heading">Recent Activity</div>
+  <% if SolidObserver.config.realtime_mode? %>
+    <p class="so-dashboard-section__meta so-dashboard-section__meta--empty-events">Feed requires persistence mode. Switch to persistence mode to see recent activity across components.</p>
+  <% elsif feed.present? %>
+    <table class="so-table so-table--card">
+      <caption class="sr-only">Unified recent activity across enabled components</caption>
+      <thead>
+        <tr>
+          <th>Component</th>
+          <th>Event</th>
+          <th>Detail</th>
+          <th>Time</th>
+        </tr>
+      </thead>
+      <tbody>
+        <% feed.each do |row| %>
+          <tr>
+            <td><%= row[:component].to_s.titleize %></td>
+            <td><%= row[:event_type].to_s.humanize %></td>
+            <td>
+              <%= unified_feed_detail(row) %>
+            </td>
+            <td>
+              <% if row[:recorded_at] %>
+                <time datetime="<%= row[:recorded_at].iso8601 %>" title="<%= row[:recorded_at].iso8601 %>"><%= time_ago_in_words(row[:recorded_at]) %> ago</time>
+              <% else %>
+                —
+              <% end %>
+            </td>
+          </tr>
+        <% end %>
+      </tbody>
+    </table>
+  <% else %>
+    <p class="so-dashboard-section__meta so-dashboard-section__meta--empty-events">No recent activity yet. Events will appear here after components record activity.</p>
+  <% end %>
+</section>