rails_error_dashboard 0.5.9 → 0.5.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 18faae83cf7bba23409732000c1cb230ba7ef067f23a454084445f754df4be0d
-  data.tar.gz: ad82e112e173f8247cf31b214b040ba82e4035040bbdf14d8c53a5782db36bb1
+  metadata.gz: f3004ee5b49b622c064ceb8103c6abb2212f1a0cc269471a7281b49338213240
+  data.tar.gz: a8e27db79b78052909acc3ce04ab4875b31148b6e50b631b46bfe67eb0562fd3
 SHA512:
-  metadata.gz: 0d0032aeb56ccc44a8c8966da338f75c37e71002534fd0bbf3e019cfe0582df37638e50863e8d4a77212731c1190de214d521521df2e986a23d36a575748d5d9
-  data.tar.gz: 4862e358faa4a87f1091e33cf08c0e654a7e959b8af551a1223e3c9d098d383d503342aa8c2fb4d66f20c95fc4864276df631be6b93bcdd22ef50269516ef997
+  metadata.gz: c2dfe54a84c8a7049e6b51956d3512c6c18f8d37cabdd5f655bbdb046b6ed7ce2b287886f80a36a7bba85839090309eb81e823e29b5b766036f9b7ba726f7fef
+  data.tar.gz: fdcf6aea6b7f568da4a525330e63de6121aa087926ffd8982c631ec90efa5282081d428c7fd9069b4ed923f31a1c1445483c443f4b845d4677648b10c4d56fc4

data/README.md

@@ -150,23 +150,43 @@ config.enable_activestorage_tracking = true  # requires enable_breadcrumbs = tru
 <details>
 <summary><strong>Issue Tracking — GitHub, GitLab, Codeberg</strong></summary>
 
-Create, link, and manage issues directly from error detail pages. Supports GitHub, GitLab, and Codeberg/Gitea/Forgejo with provider auto-detection.
+One switch connects errors to your issue tracker. Platform becomes the source of truth — status, assignees, labels, and comments are mirrored live in the dashboard.
 
-- **Manual:** "Create Issue" button + "Link Existing Issue" URL input
-- **Auto-create:** On first occurrence and/or severity threshold — configurable
-- **Lifecycle sync:** Resolve → close issue, recur → reopen + comment (throttled)
-- **Two-way webhooks:** Issue closed/reopened on platform syncs to dashboard
+- **Create & link:** "Create Issue" button or paste an existing URL
+- **Auto-create:** New errors auto-create issues. Critical/high severity always creates
+- **Lifecycle sync:** Resolve → close, recur → reopen + comment, all via background jobs
+- **Platform mirror:** Issue state, assignees (with avatars), labels (with colors), and comments displayed in the dashboard. Workflow controls (Resolve, Assign, Priority) replaced by platform state
+- **Two-way webhooks:** Issue closed/reopened on platform syncs back to dashboard
 - **RED branding:** Issues show "Created by RED (Rails Error Dashboard)"
 
 ```ruby
 config.enable_issue_tracking = true
 config.issue_tracker_token = ENV["RED_BOT_TOKEN"]
-# Provider and repo auto-detected from git_repository_url
+# That's it — provider and repo auto-detected from git_repository_url
 ```
 
 [Complete documentation →](docs/guides/CONFIGURATION.md)
 </details>
 
+<details>
+<summary><strong>Release Tracking</strong></summary>
+
+Dedicated Releases page at `/errors/releases` shows a timeline of all deploys/versions with health stats. Answers: "Did this deploy introduce new errors?" and "Is this release stable?"
+
+- **Release timeline:** Every version seen, sorted newest-first, with error counts, unique types, and time range
+- **"New in this release":** Errors whose fingerprint first appeared in each version — flagged with a red badge
+- **Stability indicators:** Green (at or below average), yellow (1-2x), red (>2x average error rate)
+- **Release comparison:** Delta and percentage change vs the previous release
+- **Current release:** Highlighted card with live health stats
+- **Zero config:** Works automatically when `app_version` or `git_sha` is set (via config, `APP_VERSION`, `GIT_SHA`, `HEROKU_SLUG_COMMIT`, or `RENDER_GIT_COMMIT` env vars)
+
+```ruby
+config.app_version = "1.2.0"           # or set APP_VERSION env var
+config.git_sha = ENV["GIT_SHA"]        # auto-detected on Heroku/Render
+config.git_repository_url = "https://github.com/user/repo"  # enables SHA links
+```
+</details>
+
 <details>
 <summary><strong>Source Code Integration + Git Blame</strong></summary>
 

data/app/controllers/rails_error_dashboard/errors_controller.rb

@@ -276,6 +276,16 @@ module RailsErrorDashboard
       @platform_specific_errors = correlation.platform_specific_errors
     end
 
+    def releases
+      days = (params[:days] || 30).to_i
+      @days = days
+      result = Queries::ReleaseTimeline.call(days, application_id: @current_application_id)
+      all_releases = result[:releases]
+      @summary = result[:summary]
+
+      @pagy, @releases = pagy(:offset, all_releases, limit: params[:per_page] || 25)
+    end
+
     def deprecations
       unless RailsErrorDashboard.configuration.enable_breadcrumbs
         flash[:alert] = "Breadcrumbs are not enabled. Enable them in config/initializers/rails_error_dashboard.rb"

data/app/controllers/rails_error_dashboard/webhooks_controller.rb

@@ -43,7 +43,8 @@ module RailsErrorDashboard
     private
 
     def verify_webhook_enabled
-      unless RailsErrorDashboard.configuration.enable_issue_webhooks
+      config = RailsErrorDashboard.configuration
+      unless config.enable_issue_tracking && config.issue_webhook_secret.present?
         head :not_found
       end
     end

data/app/views/layouts/rails_error_dashboard.html.erb

@@ -1651,6 +1651,11 @@ body.dark-mode .sidebar-section-body { background: var(--ctp-mantle); }
                   <i class="bi bi-diagram-3"></i> Correlation
                 <% end %>
               </li>
+              <li class="nav-item">
+                <%= link_to releases_errors_path(nav_params), class: "nav-link #{request.path == releases_errors_path ? 'active' : ''}" do %>
+                  <i class="bi bi-rocket-takeoff"></i> Releases
+                <% end %>
+              </li>
               <li class="nav-item">
                 <%= link_to settings_path(nav_params), class: "nav-link #{request.path == settings_path ? 'active' : ''}" do %>
                   <i class="bi bi-gear"></i> Settings

data/app/views/rails_error_dashboard/errors/_sidebar_metadata.html.erb

@@ -71,8 +71,21 @@
             <% end %>
           </div>
 
+          <% if RailsErrorDashboard.configuration.enable_issue_tracking %>
+            <div class="mb-3">
+              <small class="text-muted" style="font-size: 0.78em;">
+                <i class="bi bi-info-circle me-1"></i>
+                Status, assignment, and priority are managed via your
+                <% if error.respond_to?(:external_issue_url) && error.external_issue_url.present? %>
+                  <a href="<%= error.external_issue_url %>" target="_blank" rel="noopener">linked issue</a>.
+                <% else %>
+                  issue tracker. Link an issue to see details.
+                <% end %>
+              </small>
+            </div>
+          <% end %>
           <% unless RailsErrorDashboard.configuration.enable_issue_tracking %>
-            <!-- Workflow Status (hidden when issue tracking enabled — platform is source of truth) -->
+            <!-- Workflow Status -->
             <div class="mb-3">
               <small class="metadata-label d-block mb-1">Workflow Status</small>
               <% if error.respond_to?(:status) %>

data/app/views/rails_error_dashboard/errors/releases.html.erb

@@ -0,0 +1,284 @@
+<% content_for :page_title, "Releases" %>
+
+<div class="container-fluid py-4">
+  <div class="d-flex justify-content-between align-items-center mb-4">
+    <h1 class="h3 mb-0">
+      <i class="bi bi-rocket-takeoff me-2"></i>
+      Releases
+    </h1>
+
+    <div class="btn-group" role="group">
+      <%= link_to releases_errors_path(days: 7), class: "btn btn-sm #{@days == 7 ? 'btn-primary' : 'btn-outline-primary'}" do %>
+        7 Days
+      <% end %>
+      <%= link_to releases_errors_path(days: 30), class: "btn btn-sm #{@days == 30 ? 'btn-primary' : 'btn-outline-primary'}" do %>
+        30 Days
+      <% end %>
+      <%= link_to releases_errors_path(days: 90), class: "btn btn-sm #{@days == 90 ? 'btn-primary' : 'btn-outline-primary'}" do %>
+        90 Days
+      <% end %>
+    </div>
+  </div>
+
+  <% if @releases.empty? %>
+    <div class="text-center py-5">
+      <i class="bi bi-rocket-takeoff display-1 text-muted mb-3"></i>
+      <h4 class="text-muted">No Release Data Found</h4>
+      <p class="text-muted">
+        No version data was detected in errors over the last <%= @days %> days.
+      </p>
+      <div class="card mx-auto" style="max-width: 500px;">
+        <div class="card-body text-start">
+          <h6>How to enable release tracking:</h6>
+          <ul class="mb-0">
+            <li>Set <code>config.app_version</code> in your initializer</li>
+            <li>Or set the <code>APP_VERSION</code> environment variable</li>
+            <li>Git SHA is auto-detected from <code>GIT_SHA</code>, <code>HEROKU_SLUG_COMMIT</code>, or <code>RENDER_GIT_COMMIT</code></li>
+            <li>Version and SHA are captured automatically when errors occur</li>
+          </ul>
+        </div>
+      </div>
+    </div>
+  <% else %>
+    <%
+      current_release = @releases.find { |r| r[:current] }
+    %>
+
+    <!-- Summary Cards -->
+    <div class="row mb-4">
+      <div class="col-md-3">
+        <div class="card text-center">
+          <div class="card-body">
+            <div class="display-6 text-primary"><%= @summary[:total_releases] %></div>
+            <small class="text-muted">Releases</small>
+          </div>
+        </div>
+      </div>
+      <div class="col-md-3">
+        <div class="card text-center">
+          <div class="card-body">
+            <div class="display-6"><code><%= @summary[:current_version] || "N/A" %></code></div>
+            <small class="text-muted">Current Release</small>
+          </div>
+        </div>
+      </div>
+      <div class="col-md-3">
+        <div class="card text-center">
+          <div class="card-body">
+            <div class="display-6 text-warning"><%= @summary[:avg_errors_per_release] %></div>
+            <small class="text-muted">Avg Errors / Release</small>
+          </div>
+        </div>
+      </div>
+      <div class="col-md-3">
+        <div class="card text-center">
+          <div class="card-body">
+            <%
+              problematic_count = @releases.count { |r| r[:problematic] }
+            %>
+            <div class="display-6 <%= problematic_count > 0 ? 'text-danger' : 'text-success' %>"><%= problematic_count %></div>
+            <small class="text-muted">Problematic Releases</small>
+          </div>
+        </div>
+      </div>
+    </div>
+
+    <% if current_release %>
+      <!-- Current Release Card -->
+      <div class="card mb-4 border-primary">
+        <div class="card-header bg-primary text-white d-flex justify-content-between align-items-center">
+          <h5 class="mb-0">
+            <i class="bi bi-broadcast"></i> Current Release: <strong><%= current_release[:version] %></strong>
+          </h5>
+          <span class="badge bg-light text-primary">Live</span>
+        </div>
+        <div class="card-body">
+          <div class="row text-center">
+            <div class="col-md-2">
+              <div class="h4 mb-0"><%= current_release[:total_errors] %></div>
+              <small class="text-muted">Errors</small>
+            </div>
+            <div class="col-md-2">
+              <div class="h4 mb-0"><%= current_release[:unique_error_types] %></div>
+              <small class="text-muted">Error Types</small>
+            </div>
+            <div class="col-md-2">
+              <div class="h4 mb-0">
+                <% if current_release[:new_error_count] > 0 %>
+                  <span class="text-danger"><%= current_release[:new_error_count] %></span>
+                <% else %>
+                  <span class="text-success">0</span>
+                <% end %>
+              </div>
+              <small class="text-muted">New Errors</small>
+            </div>
+            <div class="col-md-2">
+              <%
+                stability_color = case current_release[:stability]
+                                  when :green then "success"
+                                  when :yellow then "warning"
+                                  when :red then "danger"
+                                  else "secondary"
+                                  end
+              %>
+              <div class="h4 mb-0">
+                <span class="badge bg-<%= stability_color %>">
+                  <%= current_release[:stability].to_s.capitalize %>
+                </span>
+              </div>
+              <small class="text-muted">Stability</small>
+            </div>
+            <div class="col-md-2">
+              <% if current_release[:git_shas].any? %>
+                <div class="h4 mb-0"><%= git_commit_link(current_release[:git_shas].first) %></div>
+              <% else %>
+                <div class="h4 mb-0 text-muted">N/A</div>
+              <% end %>
+              <small class="text-muted">Git SHA</small>
+            </div>
+            <div class="col-md-2">
+              <% if current_release[:delta_from_previous] %>
+                <%
+                  delta = current_release[:delta_from_previous]
+                  delta_class = delta > 0 ? "text-danger" : (delta < 0 ? "text-success" : "text-muted")
+                  delta_icon = delta > 0 ? "bi-arrow-up" : (delta < 0 ? "bi-arrow-down" : "bi-dash")
+                %>
+                <div class="h4 mb-0 <%= delta_class %>">
+                  <i class="bi <%= delta_icon %>"></i> <%= delta.abs %>
+                </div>
+              <% else %>
+                <div class="h4 mb-0 text-muted">&mdash;</div>
+              <% end %>
+              <small class="text-muted">vs Previous</small>
+            </div>
+          </div>
+        </div>
+      </div>
+    <% end %>
+
+    <!-- Release Timeline Table -->
+    <div class="card mb-4">
+      <div class="card-header bg-white d-flex justify-content-between align-items-center">
+        <h5 class="mb-0">
+          <i class="bi bi-clock-history text-primary me-2"></i>
+          Release Timeline
+          <span class="badge bg-primary"><%= @summary[:total_releases] %></span>
+        </h5>
+        <small class="text-muted"><%== @pagy.info_tag %></small>
+      </div>
+      <div class="card-body p-0">
+        <div class="table-responsive">
+          <table class="table table-hover mb-0">
+            <thead class="table-light">
+              <tr>
+                <th>Version</th>
+                <th>Git SHA</th>
+                <th>Time Range</th>
+                <th width="100">Errors</th>
+                <th width="100">Types</th>
+                <th width="120">New Errors</th>
+                <th width="100">Stability</th>
+                <th width="120">vs Previous</th>
+              </tr>
+            </thead>
+            <tbody>
+              <% @releases.each do |release| %>
+                <tr class="<%= 'table-active' if release[:current] %>">
+                  <td>
+                    <strong><%= release[:version] %></strong>
+                    <% if release[:current] %>
+                      <span class="badge bg-primary ms-1">Current</span>
+                    <% end %>
+                    <% if release[:problematic] %>
+                      <span class="badge bg-danger ms-1">Problematic</span>
+                    <% end %>
+                  </td>
+                  <td>
+                    <% if release[:git_shas].any? %>
+                      <%= git_commit_link(release[:git_shas].first) %>
+                      <% if release[:git_shas].size > 1 %>
+                        <small class="text-muted">+<%= release[:git_shas].size - 1 %></small>
+                      <% end %>
+                    <% else %>
+                      <span class="text-muted">N/A</span>
+                    <% end %>
+                  </td>
+                  <td>
+                    <small>
+                      <%= local_time_ago(release[:first_seen]) %>
+                      <% unless release[:first_seen] == release[:last_seen] %>
+                        &rarr; <%= local_time_ago(release[:last_seen]) %>
+                      <% end %>
+                    </small>
+                  </td>
+                  <td>
+                    <span class="badge bg-secondary"><%= release[:total_errors] %></span>
+                  </td>
+                  <td>
+                    <span class="badge bg-info"><%= release[:unique_error_types] %></span>
+                  </td>
+                  <td>
+                    <% if release[:new_error_count] > 0 %>
+                      <span class="badge bg-danger">
+                        <i class="bi bi-exclamation-circle"></i> <%= release[:new_error_count] %> new
+                      </span>
+                    <% else %>
+                      <span class="badge bg-success">
+                        <i class="bi bi-check-circle"></i> 0 new
+                      </span>
+                    <% end %>
+                  </td>
+                  <td>
+                    <%
+                      stability_color = case release[:stability]
+                                        when :green then "success"
+                                        when :yellow then "warning"
+                                        when :red then "danger"
+                                        else "secondary"
+                                        end
+                    %>
+                    <span class="badge bg-<%= stability_color %>">
+                      <i class="bi bi-circle-fill" style="font-size: 0.5em; vertical-align: middle;"></i>
+                      <%= release[:stability].to_s.capitalize %>
+                    </span>
+                  </td>
+                  <td>
+                    <% if release[:delta_from_previous] %>
+                      <%
+                        delta = release[:delta_from_previous]
+                        pct = release[:delta_percentage]
+                        delta_class = delta > 0 ? "text-danger" : (delta < 0 ? "text-success" : "text-muted")
+                        delta_icon = delta > 0 ? "bi-arrow-up" : (delta < 0 ? "bi-arrow-down" : "bi-dash")
+                      %>
+                      <span class="<%= delta_class %>">
+                        <i class="bi <%= delta_icon %>"></i>
+                        <%= delta > 0 ? "+#{delta}" : delta %>
+                        <% if pct %>
+                          <small>(<%= pct > 0 ? "+#{pct}" : pct %>%)</small>
+                        <% end %>
+                      </span>
+                    <% else %>
+                      <span class="text-muted">&mdash;</span>
+                    <% end %>
+                  </td>
+                </tr>
+              <% end %>
+            </tbody>
+          </table>
+        </div>
+      </div>
+      <div class="card-footer bg-white border-top d-flex justify-content-between align-items-center">
+        <small class="text-muted">
+          <i class="bi bi-info-circle"></i>
+          Stability: <span class="badge bg-success">Green</span> &le; avg errors,
+          <span class="badge bg-warning">Yellow</span> 1-2x avg,
+          <span class="badge bg-danger">Red</span> &gt; 2x avg.
+          "New" errors are error types first seen in that release.
+        </small>
+        <div>
+          <%== @pagy.series_nav(:bootstrap) if @pagy.pages > 1 %>
+        </div>
+      </div>
+    </div>
+  <% end %>
+</div>

data/app/views/rails_error_dashboard/errors/settings/_value_badge.html.erb

@@ -245,6 +245,21 @@
 <%
     end
 
+  when :secret
+    if value.present?
+%>
+    <span class="badge bg-success fs-6">
+      <i class="bi bi-check-circle"></i> Set
+    </span>
+<%
+    else
+%>
+    <span class="badge bg-warning text-dark fs-6">
+      <i class="bi bi-exclamation-triangle"></i> Not set
+    </span>
+<%
+    end
+
   when :retention_days
     # Show retention configuration with manual cleanup instructions
     if value.present?

data/app/views/rails_error_dashboard/errors/settings.html.erb

@@ -113,6 +113,38 @@
         dashboard_base_url: { label: "Dashboard Base URL", description: "Base URL for dashboard links", type: :url }
       }
     },
+    "Issue Tracking" => {
+      icon: "bi-link-45deg",
+      color: "primary",
+      settings: {
+        enable_issue_tracking: { label: "Issue Tracking", description: "GitHub/GitLab/Codeberg integration — one switch enables all: issue creation, auto-create, lifecycle sync, platform state mirroring, comment display. Replaces workflow controls with platform state.", type: :boolean },
+        issue_tracker_token: { label: "API Token", description: "RED bot token (set RED_BOT_TOKEN env var)", type: :secret, show_if: :enable_issue_tracking },
+        issue_tracker_provider: { label: "Provider", description: "Auto-detected from git_repository_url", type: :auto_detect, show_if: :enable_issue_tracking, method: :effective_issue_tracker_provider },
+        issue_tracker_repo: { label: "Repository", description: "Auto-detected from git_repository_url", type: :auto_detect, show_if: :enable_issue_tracking, method: :effective_issue_tracker_repo },
+        issue_tracker_labels: { label: "Labels", description: "Labels added to new issues", type: :array, show_if: :enable_issue_tracking },
+        issue_webhook_secret: { label: "Webhook Secret", description: "Set to enable two-way sync (HMAC verification)", type: :secret, show_if: :enable_issue_tracking }
+      }
+    },
+    "Deep Debugging" => {
+      icon: "bi-search",
+      color: "danger",
+      settings: {
+        enable_local_variables: { label: "Local Variable Capture", description: "TracePoint(:raise) — capture locals at exception time", type: :boolean },
+        enable_instance_variables: { label: "Instance Variable Capture", description: "Capture self's ivars at exception time", type: :boolean },
+        detect_swallowed_exceptions: { label: "Swallowed Exception Detection", description: "TracePoint(:raise) + (:rescue) — detect silently rescued exceptions (Ruby 3.3+)", type: :boolean },
+        enable_diagnostic_dump: { label: "Diagnostic Dump", description: "On-demand system state snapshots", type: :boolean },
+        enable_crash_capture: { label: "Process Crash Capture", description: "at_exit hook for unhandled crashes", type: :boolean }
+      }
+    },
+    "Event Tracking" => {
+      icon: "bi-broadcast",
+      color: "info",
+      settings: {
+        enable_rack_attack_tracking: { label: "Rack Attack Tracking", description: "Track throttle/blocklist events as breadcrumbs", type: :boolean },
+        enable_actioncable_tracking: { label: "ActionCable Tracking", description: "Track WebSocket channel events as breadcrumbs", type: :boolean },
+        enable_activestorage_tracking: { label: "ActiveStorage Tracking", description: "Track uploads/downloads/deletes as breadcrumbs", type: :boolean }
+      }
+    },
     "Advanced Configuration" => {
       icon: "bi-sliders",
       color: "secondary",

data/config/routes.rb

@@ -37,6 +37,7 @@ RailsErrorDashboard::Engine.routes.draw do
       get :rack_attack_summary
       get :actioncable_health_summary
       get :activestorage_health_summary
+      get :releases
       get :diagnostic_dumps
       post :create_diagnostic_dump
       post :batch_action

data/lib/generators/rails_error_dashboard/install/templates/initializer.rb

@@ -444,10 +444,40 @@ RailsErrorDashboard.configure do |config|
   config.git_sha = ENV["GIT_SHA"]
   # config.total_users_for_impact = 10000  # For user impact % calculation
 
-  # Git repository URL for clickable commit links
+  # Git repository URL for clickable commit links and issue tracking
   # Examples:
   #   GitHub: "https://github.com/username/repo"
   #   GitLab: "https://gitlab.com/username/repo"
-  #   Bitbucket: "https://bitbucket.org/username/repo"
+  #   Codeberg: "https://codeberg.org/username/repo"
   # config.git_repository_url = ENV["GIT_REPOSITORY_URL"]
+
+  # ============================================================================
+  # ISSUE TRACKING (GitHub / GitLab / Codeberg)
+  # ============================================================================
+  #
+  # One switch enables everything: issue creation, auto-create on first
+  # occurrence, lifecycle sync (resolve → close, reopen → reopen), platform
+  # state mirroring (status, assignees, labels), and comment display.
+  #
+  # IMPORTANT: When enabled, the dashboard shows platform state instead of
+  # internal workflow controls:
+  #   - "Mark as Resolved" → replaced by issue open/closed from platform
+  #   - Workflow Status → issue state from platform
+  #   - Assigned To → assignees from platform (with avatars)
+  #   - Priority → labels from platform (with colors)
+  #   - Snooze and Mute remain (no platform equivalent)
+  #
+  # Setup:
+  #   1. Create a RED bot account on GitHub/GitLab/Codeberg
+  #   2. Generate a token and set RED_BOT_TOKEN env var
+  #   3. Set git_repository_url above (already used for source code linking)
+  #   4. Enable:
+  #
+  # config.enable_issue_tracking = true
+  # config.issue_tracker_token = ENV["RED_BOT_TOKEN"]
+  #
+  # Optional overrides:
+  # config.issue_tracker_labels = ["bug"]                          # Labels added to new issues
+  # config.issue_tracker_auto_create_severities = [:critical, :high]  # Auto-create threshold
+  # config.issue_webhook_secret = ENV["ISSUE_WEBHOOK_SECRET"]      # Enables two-way webhook sync
 end

data/lib/rails_error_dashboard/configuration.rb

@@ -82,17 +82,17 @@ module RailsErrorDashboard
     attr_accessor :git_repository_url
 
     # Issue tracker integration (GitHub, GitLab, Codeberg/Gitea/Forgejo)
-    attr_accessor :enable_issue_tracking         # Master switch (default: false)
-    attr_accessor :issue_tracker_provider         # :github, :gitlab, :codeberg (auto-detected from git_repository_url)
+    # One switch enables everything: issue creation, auto-create, lifecycle sync,
+    # platform state mirroring, and comment display. Webhooks activate when
+    # issue_webhook_secret is set.
+    attr_accessor :enable_issue_tracking         # Master switch (default: false) — enables all platform integration
     attr_accessor :issue_tracker_token            # String or lambda/proc for Rails credentials
+    attr_accessor :issue_tracker_provider         # :github, :gitlab, :codeberg (auto-detected from git_repository_url)
     attr_accessor :issue_tracker_repo             # "owner/repo" (auto-extracted from git_repository_url)
     attr_accessor :issue_tracker_labels           # Array of label strings (default: ["bug"])
     attr_accessor :issue_tracker_api_url          # Custom API base URL for self-hosted instances
-    attr_accessor :auto_create_issues              # Boolean (default: false) — auto-create issues for new errors
-    attr_accessor :auto_create_issues_on_first_occurrence  # Boolean (default: true) — create on first occurrence
-    attr_accessor :auto_create_issues_for_severities       # Array of symbols (default: [:critical, :high])
-    attr_accessor :enable_issue_webhooks            # Boolean (default: false) — receive webhooks for two-way sync
-    attr_accessor :issue_webhook_secret             # String — HMAC secret for webhook signature verification
+    attr_accessor :issue_tracker_auto_create_severities  # Auto-create for these severities (default: [:critical, :high])
+    attr_accessor :issue_webhook_secret           # HMAC secret — webhooks activate when this is set
 
     # Advanced error analysis features
     attr_accessor :enable_similar_errors          # Fuzzy error matching
@@ -244,17 +244,14 @@ module RailsErrorDashboard
       @total_users_for_impact = nil # Auto-detect if not set
       @git_repository_url = ENV["GIT_REPOSITORY_URL"]
 
-      # Issue tracker integration defaults — OFF by default
+      # Issue tracker integration defaults — OFF by default, one switch enables all
       @enable_issue_tracking = false
+      @issue_tracker_token = ENV["RED_BOT_TOKEN"] || ENV["ISSUE_TRACKER_TOKEN"]
       @issue_tracker_provider = nil    # Auto-detect from git_repository_url
-      @issue_tracker_token = ENV["ISSUE_TRACKER_TOKEN"]
       @issue_tracker_repo = nil        # Auto-extract from git_repository_url
       @issue_tracker_labels = [ "bug" ]
       @issue_tracker_api_url = nil     # For self-hosted instances
-      @auto_create_issues = false
-      @auto_create_issues_on_first_occurrence = true
-      @auto_create_issues_for_severities = [ :critical, :high ]
-      @enable_issue_webhooks = false
+      @issue_tracker_auto_create_severities = [ :critical, :high ]
       @issue_webhook_secret = ENV["ISSUE_WEBHOOK_SECRET"]
 
       # Advanced error analysis features (all OFF by default - opt-in)

data/lib/rails_error_dashboard/queries/release_timeline.rb

@@ -0,0 +1,181 @@
+# frozen_string_literal: true
+
+module RailsErrorDashboard
+  module Queries
+    # Query: Build a release timeline from error data, showing per-version health stats,
+    # "new in this release" error detection, stability indicators, and release-over-release deltas.
+    # Uses existing app_version and git_sha columns on error_logs — no new migration needed.
+    class ReleaseTimeline
+      def self.call(days = 30, application_id: nil)
+        new(days, application_id: application_id).call
+      end
+
+      def initialize(days = 30, application_id: nil)
+        @days = days
+        @application_id = application_id
+        @start_date = days.days.ago
+      end
+
+      def call
+        return empty_result unless has_version_column?
+
+        releases = build_releases
+        {
+          releases: releases,
+          summary: build_summary(releases)
+        }
+      rescue => e
+        Rails.logger.error("[RailsErrorDashboard] ReleaseTimeline failed: #{e.class}: #{e.message}")
+        empty_result
+      end
+
+      private
+
+      def base_scope
+        scope = ErrorLog.where("occurred_at >= ?", @start_date)
+                        .where.not(app_version: [ nil, "" ])
+        scope = scope.where(application_id: @application_id) if @application_id.present?
+        scope
+      end
+
+      def build_releases
+        version_stats = aggregate_version_stats
+        return [] if version_stats.empty?
+
+        new_errors = new_errors_per_version
+        avg_errors = version_stats.sum { |_v, s| s[:total_errors] }.to_f / version_stats.size
+
+        # Sort chronologically by first_seen (oldest first) for delta calculation
+        sorted_chrono = version_stats.sort_by { |_v, s| s[:first_seen] }
+
+        releases = []
+        sorted_chrono.each_with_index do |(version, stats), idx|
+          previous_count = idx > 0 ? sorted_chrono[idx - 1][1][:total_errors] : nil
+
+          releases << {
+            version: version,
+            git_shas: stats[:git_shas],
+            first_seen: stats[:first_seen],
+            last_seen: stats[:last_seen],
+            current: false, # set below
+            total_errors: stats[:total_errors],
+            unique_error_types: stats[:unique_error_types],
+            new_error_count: new_errors[version] || 0,
+            stability: stability_indicator(stats[:total_errors], avg_errors),
+            problematic: stats[:total_errors] > (avg_errors * 2),
+            delta_from_previous: previous_count ? (stats[:total_errors] - previous_count) : nil,
+            delta_percentage: previous_count && previous_count > 0 ? ((stats[:total_errors] - previous_count).to_f / previous_count * 100).round(1) : nil
+          }
+        end
+
+        # Mark the most recent release as current
+        releases.last[:current] = true if releases.any?
+
+        # Return in reverse chronological order (newest first)
+        releases.reverse
+      end
+
+      # Single GROUP BY query for per-version aggregates
+      def aggregate_version_stats
+        rows = base_scope
+          .group(:app_version)
+          .select(
+            :app_version,
+            "COUNT(*) AS total_count",
+            "COUNT(DISTINCT error_type) AS unique_types",
+            "MIN(occurred_at) AS first_seen_at",
+            "MAX(occurred_at) AS last_seen_at"
+          )
+
+        # Collect git_shas per version in a second lightweight query
+        sha_map = {}
+        if has_git_sha_column?
+          base_scope.where.not(git_sha: [ nil, "" ])
+                    .group(:app_version, :git_sha)
+                    .pluck(:app_version, :git_sha)
+                    .each do |version, sha|
+                      (sha_map[version] ||= []) << sha
+                    end
+          sha_map.each_value(&:uniq!)
+        end
+
+        rows.each_with_object({}) do |row, result|
+          version = row.app_version
+          first_seen = row.first_seen_at
+          last_seen = row.last_seen_at
+          first_seen = Time.zone.parse(first_seen) if first_seen.is_a?(String)
+          last_seen = Time.zone.parse(last_seen) if last_seen.is_a?(String)
+
+          result[version] = {
+            total_errors: row.total_count.to_i,
+            unique_error_types: row.unique_types.to_i,
+            first_seen: first_seen,
+            last_seen: last_seen,
+            git_shas: sha_map[version] || []
+          }
+        end
+      rescue => e
+        Rails.logger.error("[RailsErrorDashboard] ReleaseTimeline aggregate failed: #{e.class}: #{e.message}")
+        {}
+      end
+
+      # For each error_hash in the window, find which app_version it first appeared in.
+      # Count per version to get "new errors introduced in this release".
+      def new_errors_per_version
+        return {} unless has_error_hash_column?
+
+        # Get the earliest occurrence per error_hash, with its app_version
+        # We need (error_hash, app_version) at MIN(occurred_at)
+        earliest = {}
+        base_scope.select(:error_hash, :app_version, :occurred_at)
+                  .where.not(error_hash: [ nil, "" ])
+                  .order(:occurred_at)
+                  .each do |row|
+                    earliest[row.error_hash] ||= row.app_version
+                  end
+
+        # Count how many error_hashes have each version as their earliest
+        earliest.values.tally
+      rescue => e
+        Rails.logger.error("[RailsErrorDashboard] ReleaseTimeline new_errors failed: #{e.class}: #{e.message}")
+        {}
+      end
+
+      def stability_indicator(count, avg)
+        return :green if avg <= 0
+        ratio = count.to_f / avg
+        if ratio <= 1.0
+          :green
+        elsif ratio <= 2.0
+          :yellow
+        else
+          :red
+        end
+      end
+
+      def build_summary(releases)
+        {
+          total_releases: releases.size,
+          current_version: releases.first&.dig(:version),
+          avg_errors_per_release: releases.any? ? (releases.sum { |r| r[:total_errors] }.to_f / releases.size).round(1) : 0
+        }
+      end
+
+      def empty_result
+        { releases: [], summary: { total_releases: 0, current_version: nil, avg_errors_per_release: 0 } }
+      end
+
+      def has_version_column?
+        ErrorLog.column_names.include?("app_version")
+      end
+
+      def has_git_sha_column?
+        ErrorLog.column_names.include?("git_sha")
+      end
+
+      def has_error_hash_column?
+        ErrorLog.column_names.include?("error_hash")
+      end
+    end
+  end
+end

data/lib/rails_error_dashboard/subscribers/issue_tracker_subscriber.rb

@@ -49,17 +49,15 @@ module RailsErrorDashboard
 
         def should_auto_create?(error_log)
           config = RailsErrorDashboard.configuration
-          return false unless config.enable_issue_tracking && config.auto_create_issues
+          return false unless config.enable_issue_tracking
           return false if error_log.external_issue_url.present?
 
-          # First occurrence check
-          if config.auto_create_issues_on_first_occurrence && error_log.occurrence_count == 1
-            return true
-          end
+          # First occurrence — always auto-create
+          return true if error_log.occurrence_count == 1
 
           # Severity threshold check
           severity = error_log.severity&.to_sym
-          if config.auto_create_issues_for_severities&.include?(severity)
+          if config.issue_tracker_auto_create_severities&.include?(severity)
             return true
           end
 

data/lib/rails_error_dashboard/version.rb

@@ -1,3 +1,3 @@
 module RailsErrorDashboard
-  VERSION = "0.5.9"
+  VERSION = "0.5.10"
 end

data/lib/rails_error_dashboard.rb

@@ -119,6 +119,7 @@ require "rails_error_dashboard/queries/job_health_summary"
 require "rails_error_dashboard/queries/database_health_summary"
 require "rails_error_dashboard/queries/swallowed_exception_summary"
 require "rails_error_dashboard/queries/rack_attack_summary"
+require "rails_error_dashboard/queries/release_timeline"
 require "rails_error_dashboard/error_reporter"
 require "rails_error_dashboard/middleware/error_catcher"
 require "rails_error_dashboard/middleware/rate_limiter"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails_error_dashboard
 version: !ruby/object:Gem::Version
-  version: 0.5.9
+  version: 0.5.10
 platform: ruby
 authors:
 - Anjan Jagirdar
@@ -310,6 +310,7 @@ files:
 - app/views/rails_error_dashboard/errors/overview.html.erb
 - app/views/rails_error_dashboard/errors/platform_comparison.html.erb
 - app/views/rails_error_dashboard/errors/rack_attack_summary.html.erb
+- app/views/rails_error_dashboard/errors/releases.html.erb
 - app/views/rails_error_dashboard/errors/settings.html.erb
 - app/views/rails_error_dashboard/errors/settings/_value_badge.html.erb
 - app/views/rails_error_dashboard/errors/show.html.erb
@@ -414,6 +415,7 @@ files:
 - lib/rails_error_dashboard/queries/platform_comparison.rb
 - lib/rails_error_dashboard/queries/rack_attack_summary.rb
 - lib/rails_error_dashboard/queries/recurring_issues.rb
+- lib/rails_error_dashboard/queries/release_timeline.rb
 - lib/rails_error_dashboard/queries/similar_errors.rb
 - lib/rails_error_dashboard/queries/swallowed_exception_summary.rb
 - lib/rails_error_dashboard/services/analytics_cache_manager.rb
@@ -485,7 +487,7 @@ metadata:
   bug_tracker_uri: https://github.com/AnjanJ/rails_error_dashboard/issues
   funding_uri: https://github.com/sponsors/AnjanJ
 post_install_message: "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n
-  \ Rails Error Dashboard v0.5.9\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n\U0001F195
+  \ Rails Error Dashboard v0.5.10\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n\U0001F195
   First time? Quick start:\n   rails generate rails_error_dashboard:install\n   rails
   db:migrate\n   # Add to config/routes.rb:\n   mount RailsErrorDashboard::Engine
   => '/error_dashboard'\n\n\U0001F504 Upgrading from v0.1.x?\n   rails db:migrate\n