rails_nexus 2.0.0

data/lib/generators/rails_nexus/templates/views/rails_nexus/logged_exceptions/_show.html.erb

@@ -0,0 +1,297 @@
+<div class="rn-detail-panel" style="border-left: none; border-radius: var(--rn-radius-lg); overflow: hidden" data-controller="rails_nexus-detail">
+
+  <%# ─── Detail Header ───────────────────────────────────────── %>
+  <div class="rn-detail-header">
+    <div class="min-w-0 flex-1">
+      <%# Breadcrumbs %>
+      <nav class="rn-breadcrumbs" style="padding: 0; margin-bottom: 0.5rem">
+        <a href="<%= logged_exceptions_path %>" class="rn-breadcrumb">Exceptions</a>
+        <span class="rn-breadcrumb-sep">/</span>
+        <span class="rn-breadcrumb-current"><%= @exception.exception_class %></span>
+      </nav>
+
+      <div class="flex items-center gap-2 flex-wrap">
+        <span class="rn-badge rn-badge-<%= severity_for(@exception) %>"><%= @exception.exception_class %></span>
+        <span class="rn-mono text-xs" style="color: var(--rn-text-secondary)"><%= @exception.controller_name %>#<%= @exception.action_name %></span>
+      </div>
+
+      <p class="mt-1.5 text-xs" style="color: var(--rn-text-muted)">
+        <time datetime="<%= @exception.created_at.iso8601 %>"><%= @exception.created_at.strftime("%B %d, %Y at %I:%M:%S %p") %></time>
+        <% if @exception.remote_ip.present? %>
+          <span style="color: var(--rn-border)">·</span>
+          <span class="rn-mono"><%= @exception.remote_ip %></span>
+        <% end %>
+      </p>
+    </div>
+
+    <div class="flex items-center gap-2 shrink-0">
+      <%# Copy exception ID %>
+      <button type="button"
+        class="rn-copy-btn"
+        data-action="click->rails_nexus-detail#copyId"
+        data-rails_nexus-detail-id-value="<%= @exception.id %>"
+        title="Copy exception ID">
+        <svg class="w-3 h-3" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"><path stroke-linecap="round" stroke-linejoin="round" d="M15.666 3.888A2.25 2.25 0 0013.5 2.25h-3c-1.03 0-1.9.693-2.166 1.638m7.332 0c.055.194.084.4.084.612v0a.75.75 0 01-.75.75H9.75a.75.75 0 01-.75-.75v0c0-.212.03-.418.084-.612m7.332 0c.646.049 1.288.11 1.927.184 1.1.128 1.907 1.077 1.907 2.185V19.5a2.25 2.25 0 01-2.25 2.25H6.75A2.25 2.25 0 014.5 19.5V6.257c0-1.108.806-2.057 1.907-2.185a48.208 48.208 0 011.927-.184" /></svg>
+        <span>ID</span>
+      </button>
+
+      <%# Copy message %>
+      <button type="button"
+        class="rn-copy-btn"
+        data-action="click->rails_nexus-detail#copyMessage"
+        data-rails_nexus-detail-message-value="<%= @exception.message %>"
+        title="Copy message">
+        <svg class="w-3 h-3" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"><path stroke-linecap="round" stroke-linejoin="round" d="M19.5 14.25v-2.625a3.375 3.375 0 00-3.375-3.375h-1.5A1.125 1.125 0 0113.5 7.125v-1.5a3.375 3.375 0 00-3.375-3.375H8.25m0 12.75h7.5m-7.5 3H12M10.5 2.25H5.625c-.621 0-1.125.504-1.125 1.125v17.25c0 .621.504 1.125 1.125 1.125h12.75c.621 0 1.125-.504 1.125-1.125V11.25a9 9 0 00-9-9z" /></svg>
+        <span>Message</span>
+      </button>
+
+      <%# Close %>
+      <button type="button"
+        class="rn-icon-btn shrink-0"
+        data-action="click->rails_nexus-detail#closeDetails"
+        title="Close (Esc)">
+        <svg class="w-4 h-4" fill="none" viewBox="0 0 24 24" stroke-width="2" stroke="currentColor"><path stroke-linecap="round" stroke-linejoin="round" d="M6 18L18 6M6 6l12 12" /></svg>
+      </button>
+    </div>
+  </div>
+
+  <%# ─── Tabs ─────────────────────────────────────────────────── %>
+  <% if @exception_tabs && @exception_tabs.values.count(true) > 1 %>
+    <div class="rn-tabs" data-rails_nexus-detail-target="tabs">
+      <button type="button" class="rn-tab active" data-action="click->rails_nexus-detail#switchTab" data-rn-tab-param="overview">Overview</button>
+      <% if @exception_tabs[:backtrace] %>
+        <button type="button" class="rn-tab" data-action="click->rails_nexus-detail#switchTab" data-rn-tab-param="backtrace">
+          Backtrace
+          <span class="rn-tab-badge"><%= @exception.backtrace.to_s.split("\n").length %></span>
+        </button>
+      <% end %>
+      <% if @exception_tabs[:request] %>
+        <button type="button" class="rn-tab" data-action="click->rails_nexus-detail#switchTab" data-rn-tab-param="request">Request</button>
+      <% end %>
+      <% if @exception_tabs[:environment] %>
+        <button type="button" class="rn-tab" data-action="click->rails_nexus-detail#switchTab" data-rn-tab-param="environment">Environment</button>
+      <% end %>
+      <% if @exception_tabs[:user_info] %>
+        <button type="button" class="rn-tab" data-action="click->rails_nexus-detail#switchTab" data-rn-tab-param="user_info">User Info</button>
+      <% end %>
+    </div>
+  <% end %>
+
+  <%# ─── Detail Body ─────────────────────────────────────────── %>
+  <div class="rn-detail-body">
+
+    <%# ─── Tab: Overview ────────────────────────────────────── %>
+    <div data-rails_nexus-detail-target="tabContent" data-rn-tab-content="overview">
+
+      <%# Message %>
+      <div class="rn-detail-section">
+        <div class="rn-detail-section-header">
+          <h3>Message</h3>
+        </div>
+        <div class="rn-detail-code"><%= @exception.message %></div>
+      </div>
+
+      <%# Metadata Grid %>
+      <% if RailsNexus.configuration.show_metadata %>
+        <div class="rn-detail-section">
+          <h3 style="margin-bottom: 0.5rem">Details</h3>
+          <div class="rn-meta">
+            <div class="rn-meta-item">
+              <div class="rn-meta-label">Exception</div>
+              <div class="rn-meta-value"><%= @exception.exception_class %></div>
+            </div>
+            <div class="rn-meta-item">
+              <div class="rn-meta-label">Controller</div>
+              <div class="rn-meta-value mono"><%= @exception.controller_name %></div>
+            </div>
+            <div class="rn-meta-item">
+              <div class="rn-meta-label">Action</div>
+              <div class="rn-meta-value mono"><%= @exception.action_name %></div>
+            </div>
+            <div class="rn-meta-item">
+              <div class="rn-meta-label">Time</div>
+              <div class="rn-meta-value"><time datetime="<%= @exception.created_at.iso8601 %>"><%= @exception.created_at.strftime("%Y-%m-%d %H:%M:%S %Z") %></time></div>
+            </div>
+            <% if @exception.remote_ip.present? %>
+              <div class="rn-meta-item">
+                <div class="rn-meta-label">IP Address</div>
+                <div class="rn-meta-value mono"><%= @exception.remote_ip %></div>
+              </div>
+            <% end %>
+            <% if @exception.user_agent.present? %>
+              <div class="rn-meta-item" style="grid-column: span 2">
+                <div class="rn-meta-label">User Agent</div>
+                <div class="rn-meta-value" style="font-size: 0.8125rem; word-break: break-all"><%= @exception.user_agent %></div>
+              </div>
+            <% end %>
+            <div class="rn-meta-item">
+              <div class="rn-meta-label">Exception ID</div>
+              <div class="rn-meta-value mono"><%= @exception.id %></div>
+            </div>
+            <% if @exception.id_value.present? %>
+              <div class="rn-meta-item">
+                <div class="rn-meta-label">ID Value</div>
+                <div class="rn-meta-value mono"><%= @exception.id_value %></div>
+              </div>
+            <% end %>
+          </div>
+        </div>
+      <% end %>
+
+      <%# Request Params %>
+      <% if RailsNexus.configuration.show_request && @exception.request.present? %>
+        <div class="rn-detail-section">
+          <div class="rn-detail-section-header">
+            <h3>Request</h3>
+          </div>
+          <div class="rn-detail-code"><%= pretty_format(@exception.request) %></div>
+        </div>
+      <% end %>
+
+      <%# User Info %>
+      <% if @exception.user_info.present? %>
+        <div class="rn-detail-section">
+          <div class="rn-detail-section-header">
+            <h3>User Info</h3>
+          </div>
+          <div class="rn-detail-code"><%= pretty_format(@exception.user_info) %></div>
+        </div>
+      <% end %>
+    </div>
+
+    <%# ─── Tab: Backtrace ────────────────────────────────────── %>
+    <div data-rails_nexus-detail-target="tabContent" data-rn-tab-content="backtrace" style="display: none">
+      <% if @exception.backtrace.present? %>
+        <% bt = format_backtrace(@exception.backtrace) %>
+        <div class="rn-detail-section">
+          <div class="rn-detail-section-header">
+            <h3>Stack Trace</h3>
+            <div class="flex items-center gap-2">
+              <button type="button" class="rn-copy-btn" data-action="click->rails_nexus-detail#copyBacktrace"
+                data-rails_nexus-detail-backtrace-value="<%= @exception.backtrace %>">
+                <svg class="w-3 h-3" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"><path stroke-linecap="round" stroke-linejoin="round" d="M15.666 3.888A2.25 2.25 0 0013.5 2.25h-3c-1.03 0-1.9.693-2.166 1.638m7.332 0c.055.194.084.4.084.612v0a.75.75 0 01-.75.75H9.75a.75.75 0 01-.75-.75v0c0-.212.03-.418.084-.612m7.332 0c.646.049 1.288.11 1.927.184 1.1.128 1.907 1.077 1.907 2.185V19.5a2.25 2.25 0 01-2.25 2.25H6.75A2.25 2.25 0 014.5 19.5V6.257c0-1.108.806-2.057 1.907-2.185a48.208 48.208 0 011.927-.184" /></svg>
+                Copy
+              </button>
+            </div>
+          </div>
+          <div class="rn-detail-pre" data-rails_nexus-detail-target="backtraceContent">
+            <%= bt[:visible] %>
+          </div>
+          <% if bt[:hidden_count] > 0 %>
+            <button type="button" class="rn-btn rn-btn-ghost rn-btn-sm mt-2"
+              data-action="click->rails_nexus-detail#expandBacktrace">
+              Show <%= bt[:hidden_count] %> more frames
+            </button>
+            <div class="rn-detail-pre mt-2" style="display: none" data-rails_nexus-detail-target="backtraceHidden">
+              <%= bt[:hidden] %>
+            </div>
+          <% end %>
+        </div>
+      <% else %>
+        <div class="text-center py-8">
+          <p class="text-sm" style="color: var(--rn-text-muted)">No backtrace available</p>
+        </div>
+      <% end %>
+    </div>
+
+    <%# ─── Tab: Request ──────────────────────────────────────── %>
+    <div data-rails_nexus-detail-target="tabContent" data-rn-tab-content="request" style="display: none">
+      <% if @exception.request.present? %>
+        <div class="rn-detail-section">
+          <div class="rn-detail-section-header">
+            <h3>Request Data</h3>
+          </div>
+          <div class="rn-detail-code" style="max-height: 32rem; overflow: auto"><%= pretty_format(@exception.request) %></div>
+        </div>
+      <% else %>
+        <div class="text-center py-8">
+          <p class="text-sm" style="color: var(--rn-text-muted)">No request data available</p>
+        </div>
+      <% end %>
+    </div>
+
+    <%# ─── Tab: Environment ──────────────────────────────────── %>
+    <div data-rails_nexus-detail-target="tabContent" data-rn-tab-content="environment" style="display: none">
+      <% if @exception.environment.present? %>
+        <div class="rn-detail-section">
+          <div class="rn-detail-section-header">
+            <h3>Environment Variables</h3>
+          </div>
+          <div class="rn-detail-code" style="max-height: 32rem; overflow: auto"><%= pretty_format(@exception.environment) %></div>
+        </div>
+      <% else %>
+        <div class="text-center py-8">
+          <p class="text-sm" style="color: var(--rn-text-muted)">No environment data available</p>
+        </div>
+      <% end %>
+    </div>
+
+    <%# ─── Tab: User Info ────────────────────────────────────── %>
+    <div data-rails_nexus-detail-target="tabContent" data-rn-tab-content="user_info" style="display: none">
+      <% if @exception.user_info.present? %>
+        <div class="rn-detail-section">
+          <div class="rn-detail-section-header">
+            <h3>User Information</h3>
+          </div>
+          <div class="rn-detail-code"><%= pretty_format(@exception.user_info) %></div>
+        </div>
+      <% else %>
+        <div class="text-center py-8">
+          <p class="text-sm" style="color: var(--rn-text-muted)">No user info available</p>
+        </div>
+      <% end %>
+    </div>
+
+  </div>
+
+  <%# ─── Actions Footer ──────────────────────────────────────── %>
+  <div class="flex items-center justify-between px-5 py-3" style="border-top: 1px solid var(--rn-border-light); background: var(--rn-bg-secondary)">
+    <p class="text-xs rn-mono" style="color: var(--rn-text-muted)">
+      ID: <%= @exception.id %>
+      <span style="color: var(--rn-border)">·</span>
+      <time datetime="<%= @exception.created_at.iso8601 %>"><%= @exception.created_at.iso8601 %></time>
+    </p>
+    <%= link_to logged_exception_path(@exception),
+      class: "rn-btn rn-btn-ghost rn-btn-sm",
+      style: "color: var(--rn-danger); border-color: var(--rn-danger)",
+      data: { turbo_method: :delete, turbo_confirm: t(".confirm_delete"), turbo_stream: true } do %>
+      <svg class="w-3.5 h-3.5" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"><path stroke-linecap="round" stroke-linejoin="round" d="M14.74 9l-.346 9m-4.788 0L9.26 9m9.968-3.21c.342.052.682.107 1.022.166m-1.022-.165L18.16 19.673a2.25 2.25 0 01-2.244 2.077H8.084a2.25 2.25 0 01-2.244-2.077L4.772 5.79m14.456 0a48.108 48.108 0 00-3.478-.397m-12 .562c.34-.059.68-.114 1.022-.165m0 0a48.11 48.11 0 013.478-.397m7.5 0v-.916c0-1.18-.91-2.164-2.09-2.201a51.964 51.964 0 00-3.32 0c-1.18.037-2.09 1.022-2.09 2.201v.916m7.5 0a48.667 48.667 0 00-7.5 0" /></svg>
+      Delete
+    <% end %>
+  </div>
+
+  <%# ─── Prev/Next Navigation ────────────────────────────────── %>
+  <% if RailsNexus.configuration.enable_navigation && (prev_exception || next_exception) %>
+    <div class="rn-nav-row">
+      <% if prev_exception %>
+        <%= link_to logged_exception_path(prev_exception.id, params_filters),
+          class: "rn-nav-link",
+          data: { turbo_frame: "exception-details", turbo_action: "advance" } do %>
+          <svg class="w-4 h-4 shrink-0" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"><path stroke-linecap="round" stroke-linejoin="round" d="M15.75 19.5L8.25 12l7.5-7.5" /></svg>
+          <div class="min-w-0">
+            <div class="rn-nav-link-label">Previous</div>
+            <div class="rn-nav-link-title"><%= prev_exception.id %></div>
+          </div>
+        <% end %>
+      <% else %>
+        <div></div>
+      <% end %>
+
+      <% if next_exception %>
+        <%= link_to logged_exception_path(next_exception.id, params_filters),
+          class: "rn-nav-link",
+          style: "text-align: right",
+          data: { turbo_frame: "exception-details", turbo_action: "advance" } do %>
+          <div class="min-w-0">
+            <div class="rn-nav-link-label">Next</div>
+            <div class="rn-nav-link-title"><%= next_exception.id %></div>
+          </div>
+          <svg class="w-4 h-4 shrink-0" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"><path stroke-linecap="round" stroke-linejoin="round" d="M8.25 4.5l7.5 7.5-7.5 7.5" /></svg>
+        <% end %>
+      <% else %>
+        <div></div>
+      <% end %>
+    </div>
+  <% end %>
+
+</div>

data/lib/generators/rails_nexus/templates/views/rails_nexus/logged_exceptions/index.html.erb

@@ -0,0 +1,113 @@
+<% page_title t(".title") %>
+
+<div class="space-y-4" data-controller="rails_nexus">
+  <%# Header with stats %>
+  <div class="flex flex-col sm:flex-row sm:items-center sm:justify-between gap-3">
+    <div>
+      <h1 class="text-xl font-bold text-gray-900 tracking-tight"><%= t(".title") %></h1>
+      <p class="mt-0.5 text-xs text-gray-400"><%= t(".subtitle") %></p>
+    </div>
+    <div class="flex items-center gap-2">
+      <span class="inline-flex items-center gap-1 px-2.5 py-1 text-xs font-medium rounded-full bg-red-50 text-red-700 border border-red-100">
+        <span class="w-1.5 h-1.5 rounded-full bg-red-500 animate-pulse"></span>
+        <%= RailsNexus::LoggedException.count %> total
+      </span>
+      <%= button_to t(".clear_history"), clear_logged_exceptions_path, method: :post,
+        class: "inline-flex items-center gap-1 px-2.5 py-1 text-xs font-medium text-gray-500 bg-white border border-gray-200 rounded-lg hover:bg-gray-50 hover:text-red-600 transition-colors",
+        form: { data: { turbo_stream: true } },
+        data: { turbo_confirm: t(".confirm_clear") } %>
+    </div>
+  </div>
+
+  <%# Filters Bar %>
+  <div class="bg-white rounded-xl border border-gray-200/60 shadow-sm">
+    <div class="px-4 py-3 border-b border-gray-100 flex items-center gap-2">
+      <svg class="w-4 h-4 text-gray-400" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor"><path stroke-linecap="round" stroke-linejoin="round" d="M12 3c2.755 0 5.455.232 8.083.678.533.09.917.556.917 1.096v1.044a2.25 2.25 0 01-.659 1.591l-5.432 5.432a2.25 2.25 0 00-.659 1.591v2.927a2.25 2.25 0 01-1.244 2.013L9.75 21v-6.568a2.25 2.25 0 00-.659-1.591L3.659 7.409A2.25 2.25 0 013 5.818V4.774c0-.54.384-1.006.917-1.096A48.32 48.32 0 0112 3z" /></svg>
+      <span class="text-xs font-semibold text-gray-500 uppercase tracking-wider">Filters</span>
+      <% if filtered? %>
+        <%= link_to "Clear", logged_exceptions_path, class: "ml-auto text-xs text-indigo-600 hover:text-indigo-800 font-medium" %>
+      <% end %>
+    </div>
+
+    <%= search_form_for @q, url: query_logged_exceptions_path, data: { turbo_frame: "exceptions" } do |f| %>
+      <div class="px-4 py-3 flex flex-wrap items-end gap-3">
+        <%# Exception Class Select %>
+        <div class="flex-1 min-w-[160px]">
+          <label class="block text-[11px] font-medium text-gray-400 uppercase tracking-wider mb-1">Exception</label>
+          <%= f.select :exception_class_cont,
+            options_for_select(@exception_names.map { |n| [n, n] }, params.dig(:q, :exception_class_cont)),
+            { include_blank: "All exceptions" },
+            class: "block w-full rounded-lg border-gray-200 bg-gray-50/50 text-sm py-2 pl-3 pr-8 focus:border-indigo-500 focus:bg-white focus:ring-1 focus:ring-indigo-500/20 appearance-none cursor-pointer",
+            data: { action: "change->rails_nexus#submit" } %>
+        </div>
+
+        <%# Controller Select %>
+        <div class="flex-1 min-w-[160px]">
+          <label class="block text-[11px] font-medium text-gray-400 uppercase tracking-wider mb-1">Controller</label>
+          <%= f.select :controller_name_cont,
+            options_for_select(@controller_actions.map { |a| [a, a] }, params.dig(:q, :controller_name_cont)),
+            { include_blank: "All controllers" },
+            class: "block w-full rounded-lg border-gray-200 bg-gray-50/50 text-sm py-2 pl-3 pr-8 focus:border-indigo-500 focus:bg-white focus:ring-1 focus:ring-indigo-500/20 appearance-none cursor-pointer",
+            data: { action: "change->rails_nexus#submit" } %>
+        </div>
+
+        <%# Time Range Select %>
+        <div class="flex-1 min-w-[160px]">
+          <label class="block text-[11px] font-medium text-gray-400 uppercase tracking-wider mb-1">Time Range</label>
+          <%= select_tag :date_ranges_filter,
+            options_for_select([
+              ["All time", ""],
+              ["Today", "1"],
+              ["Last 3 days", "3"],
+              ["Last 7 days", "7"],
+              ["Last 30 days", "30"]
+            ], params[:date_ranges_filter]),
+            class: "block w-full rounded-lg border-gray-200 bg-gray-50/50 text-sm py-2 pl-3 pr-8 focus:border-indigo-500 focus:bg-white focus:ring-1 focus:ring-indigo-500/20 appearance-none cursor-pointer",
+            data: { action: "change->rails_nexus#submit" } %>
+        </div>
+
+        <%# Message Search %>
+        <div class="flex-1 min-w-[200px]">
+          <label class="block text-[11px] font-medium text-gray-400 uppercase tracking-wider mb-1">Search</label>
+          <%= f.search_field :message_cont,
+            placeholder: "Search messages...",
+            class: "block w-full rounded-lg border-gray-200 bg-gray-50/50 text-sm py-2 px-3 focus:border-indigo-500 focus:bg-white focus:ring-1 focus:ring-indigo-500/20",
+            data: { action: "input->rails_nexus#debouncedSubmit" } %>
+        </div>
+
+        <div class="flex gap-2">
+          <%= f.submit "Apply", class: "px-4 py-2 text-sm font-medium text-white bg-indigo-600 rounded-lg hover:bg-indigo-700 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-indigo-500 transition-colors" %>
+        </div>
+      </div>
+    <% end %>
+  </div>
+
+  <%# Content %>
+  <div class="space-y-4">
+    <%# Activity indicator %>
+    <div id="activity" data-rails_nexus-target="activity" class="rounded-lg bg-indigo-50 border border-indigo-200 p-3 flex items-center gap-3" role="status" aria-live="polite" hidden>
+      <svg class="animate-spin h-4 w-4 text-indigo-500 shrink-0" xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24">
+        <circle class="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" stroke-width="4"></circle>
+        <path class="opacity-75" fill="currentColor" d="M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4zm2 5.291A7.962 7.962 0 014 12H0c0 3.042 1.135 5.824 3 7.938l3-2.647z"></path>
+      </svg>
+      <p class="text-sm font-medium text-indigo-700"><%= t(".loading") %></p>
+    </div>
+
+    <%# Exception Details Panel %>
+    <%= turbo_frame_tag "exception-details", class: "bg-white rounded-xl border border-gray-200/60 shadow-sm" do %>
+      <div class="text-center py-12">
+        <div class="w-10 h-10 rounded-full bg-gray-50 flex items-center justify-center mx-auto border border-gray-100">
+          <svg class="w-5 h-5 text-gray-300" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor">
+            <path stroke-linecap="round" stroke-linejoin="round" d="M19.5 14.25v-2.625a3.375 3.375 0 00-3.375-3.375h-1.5A1.125 1.125 0 0113.5 7.125v-1.5a3.375 3.375 0 00-3.375-3.375H8.25m0 12.75h7.5m-7.5 3H12M10.5 2.25H5.625c-.621 0-1.125.504-1.125 1.125v17.25c0 .621.504 1.125 1.125 1.125h12.75c.621 0 1.125-.504 1.125-1.125V11.25a9 9 0 00-9-9z" />
+          </svg>
+        </div>
+        <p class="mt-2 text-xs text-gray-400">Select an exception to view details</p>
+      </div>
+    <% end %>
+
+    <%# Exceptions List %>
+    <%= turbo_frame_tag "exceptions" do %>
+      <%= render "exceptions" %>
+    <% end %>
+  </div>
+</div>

data/lib/rails_nexus/breadcrumbs.rb

@@ -0,0 +1,161 @@
+# frozen_string_literal: true
+
+require "active_support/notifications"
+
+module RailsNexus
+  # Breadcrumbs capture activity trail before a crash.
+  # Uses ActiveSupport::Notifications to subscribe to SQL, controller,
+  # cache, and other instrumentation events.
+  module Breadcrumbs
+    RING_BUFFER_SIZE = 50
+
+    class << self
+      # Thread-local ring buffer of breadcrumbs
+      def buffer
+        Thread.current[:rails_nexus_breadcrumbs] ||= []
+      end
+
+      def buffer=(val)
+        Thread.current[:rails_nexus_breadcrumbs] = val
+      end
+
+      # Capture a breadcrumb manually
+      def add(type:, name:, payload: nil, duration: nil)
+        buffer << {
+          type: type,
+          name: name,
+          payload: payload,
+          duration: duration,
+          timestamp: Time.current.iso8601(3)
+        }
+        # Keep only last N entries
+        buffer.shift if buffer.size > RING_BUFFER_SIZE
+      end
+
+      # Flush buffer and return captured breadcrumbs
+      def flush
+        crumbs = buffer.dup
+        self.buffer = []
+        crumbs
+      end
+
+      # Start subscribing to instrumentation events
+      def subscribe!
+        return if @subscribed
+
+        # SQL queries
+        ActiveSupport::Notifications.subscribe("sql.active_record") do |_name, _start, _finish, _id, payload|
+          next if payload[:name] == "SCHEMA"
+          next if payload[:sql]&.start_with?("SET")
+          next if payload[:sql]&.start_with?("SELECT 1")
+
+          add(
+            type: "sql",
+            name: payload[:sql]&.truncate(200),
+            payload: {
+              connection_id: payload[:connection_id],
+              cached: payload[:cached]
+            },
+            duration: payload[:runtime]
+          )
+        end
+
+        # Controller action
+        ActiveSupport::Notifications.subscribe("process_action.action_controller") do |_name, _start, _finish, _id, payload|
+          add(
+            type: "controller",
+            name: "#{payload[:controller]}##{payload[:action]}",
+            payload: {
+              format: payload[:format],
+              status: payload[:status],
+              view_runtime: payload[:view_runtime]&.round(2),
+              db_runtime: payload[:db_runtime]&.round(2)
+            },
+            duration: payload[:runtime]&.round(2)
+          )
+        end
+
+        # Cache reads/writes
+        ActiveSupport::Notifications.subscribe("cache_read.active_support") do |_name, _start, _finish, _id, payload|
+          next unless payload[:hit]  # Only log cache hits
+
+          add(
+            type: "cache",
+            name: "Cache read: #{payload[:key]}",
+            payload: { hit: true, super: payload[:super] }
+          )
+        end
+
+        ActiveSupport::Notifications.subscribe("cache_write.active_support") do |_name, _start, _finish, _id, payload|
+          add(
+            type: "cache",
+            name: "Cache write: #{payload[:key]}",
+            payload: { hit: false }
+          )
+        end
+
+        # Active Job
+        ActiveSupport::Notifications.subscribe("perform_start.active_job") do |_name, _start, _finish, _id, payload|
+          add(
+            type: "job",
+            name: "Job started: #{payload[:job_class]}",
+            payload: {
+              job_id: payload[:job_id],
+              queue: payload[:queue_name],
+              arguments: payload[:arguments]&.first(200)
+            }
+          )
+        end
+
+        ActiveSupport::Notifications.subscribe("perform.active_job") do |_name, _start, _finish, _id, payload|
+          add(
+            type: "job",
+            name: "Job completed: #{payload[:job_class]}",
+            payload: {
+              job_id: payload[:job_id],
+              queue: payload[:queue_name],
+              error: payload[:exception_object]&.message
+            },
+            duration: payload[:runtime]&.round(2)
+          )
+        end
+
+        # Action Mailer
+        ActiveSupport::Notifications.subscribe("deliver.action_mailer") do |_name, _start, _finish, _id, payload|
+          add(
+            type: "mailer",
+            name: "Mail delivered: #{payload[:mailer]}##{payload[:message_id]}",
+            payload: {
+              mailer: payload[:mailer],
+              message_id: payload[:message_id]
+            }
+          )
+        end
+
+        # Render partials
+        ActiveSupport::Notifications.subscribe("render_partial.action_view") do |_name, _start, _finish, _id, payload|
+          add(
+            type: "render",
+            name: "Render: #{payload[:identifier]}",
+            payload: {
+              cache_hits: payload[:cache_hit]
+            },
+            duration: payload[:duration]&.round(2)
+          )
+        end
+
+        @subscribed = true
+      end
+
+      def subscribed?
+        @subscribed
+      end
+
+      # Reset state (for testing)
+      def reset!
+        self.buffer = []
+        @subscribed = false
+      end
+    end
+  end
+end

data/lib/rails_nexus/cleanup.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module RailsNexus
+  module Cleanup
+    class << self
+      # Delete exceptions older than the configured retention period.
+      # Call this from a cron job, Sidekiq scheduler, or Rails runner.
+      #
+      # Usage:
+      #   bin/rails runner "RailsNexus::Cleanup.run"
+      #
+      # Or schedule with sidekiq-cron / whenever / good_job:
+      #   RailsNexus::Cleanup.run
+      def run
+        config = RailsNexus.configuration
+        return unless config.retention_days.present?
+
+        cutoff = config.retention_days.days.ago
+        count = RailsNexus::LoggedException.where("created_at < ?", cutoff).delete_all
+
+        Rails.logger.info("[RailsNexus] Cleaned up #{count} exceptions older than #{config.retention_days} days") if count > 0
+        count
+      end
+
+      # Generate a rake task for cleanup.
+      # Adds `rake rails_nexus:cleanup` to your app.
+      def self.install_rake_task
+        # This is called automatically by the engine
+      end
+    end
+  end
+end