rails_error_dashboard 0.5.9 → 0.5.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 18faae83cf7bba23409732000c1cb230ba7ef067f23a454084445f754df4be0d
-  data.tar.gz: ad82e112e173f8247cf31b214b040ba82e4035040bbdf14d8c53a5782db36bb1
+  metadata.gz: e91844bfccd6f88a89ad933cb4f100bb79e941f5b43a78155b6b21a46a58fffb
+  data.tar.gz: fffcde71a4ed1859cf70ef17ed7eca18531ac9d6be9f17fb3d1a9deceba4e0ca
 SHA512:
-  metadata.gz: 0d0032aeb56ccc44a8c8966da338f75c37e71002534fd0bbf3e019cfe0582df37638e50863e8d4a77212731c1190de214d521521df2e986a23d36a575748d5d9
-  data.tar.gz: 4862e358faa4a87f1091e33cf08c0e654a7e959b8af551a1223e3c9d098d383d503342aa8c2fb4d66f20c95fc4864276df631be6b93bcdd22ef50269516ef997
+  metadata.gz: ab28a1843285439c9874a8d3552e5dceda81f4ced4cbc1d8d0ee6950a772758a1769f0a323bc207f2884c991c22d3938551b5b0a25f693ab19c6c5d0d0da23a7
+  data.tar.gz: a921a83a5fafceb78323dc3f2c48d559c722efbbf79b2708113f5c9d482ace9c2347700415aeee63e1af864d11a036bdc08ba43cfd860f2f28ea0621c8c7eb30

data/README.md

@@ -150,23 +150,65 @@ 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>User Impact Scoring</strong></summary>
+
+Dedicated `/errors/user_impact` page ranking errors by unique users affected — not occurrence count. An error hitting 1000 users once ranks higher than hitting 1 user 1000 times. Shows impact percentage (when `total_users_for_impact` is configured or auto-detected), severity badges, and per-error drill-down links.
+
+No configuration needed — works automatically when errors have `user_id` (auto-detected via `CurrentAttributes` or `current_user`).
+</details>
+
+<details>
+<summary><strong>Scheduled Digests</strong></summary>
+
+Daily or weekly error summary emails — new errors, resolution rate, top errors by count, critical unresolved, and period-over-period comparison. HTML + text templates. Users schedule the job via SolidQueue, Sidekiq, or cron.
+
+```ruby
+config.enable_scheduled_digests = true
+config.digest_frequency = :daily  # or :weekly
+# config.digest_recipients = ["team@example.com"]  # defaults to notification_email_recipients
+```
+
+Schedule: `rails error_dashboard:send_digest PERIOD=daily`
+</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>
 
@@ -180,6 +222,17 @@ config.enable_git_blame = true
 [Complete documentation →](docs/SOURCE_CODE_INTEGRATION.md)
 </details>
 
+<details>
+<summary><strong>Code Path Coverage (Diagnostic Mode)</strong></summary>
+
+Enable coverage via a dashboard button to see which production code paths were executed. Source code viewer overlays green checkmarks on executed lines and gray dots on unexecuted lines. Uses Ruby's `Coverage.setup(oneshot_lines: true)` — near-zero overhead, each line fires once. Zero overhead when off.
+
+```ruby
+config.enable_coverage_tracking = true   # shows Enable/Disable buttons on error detail page
+config.enable_source_code_integration = true  # required for source code viewer
+```
+</details>
+
 <details>
 <summary><strong>Error Replay — Copy as cURL / RSpec / LLM Markdown</strong></summary>
 
@@ -350,7 +403,7 @@ The installer guides you through optional feature selection — notifications, p
 ### 3. Visit your dashboard
 
 ```
-http://localhost:3000/error_dashboard
+http://localhost:3000/red
 ```
 
 Default credentials: `gandalf` / `youshallnotpass`

data/app/controllers/rails_error_dashboard/errors_controller.rb

@@ -276,6 +276,26 @@ 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 user_impact
+      days = (params[:days] || 30).to_i
+      @days = days
+      result = Queries::UserImpactSummary.call(days, application_id: @current_application_id)
+      all_entries = result[:entries]
+      @summary = result[:summary]
+
+      @pagy, @entries = pagy(:offset, all_entries, 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"
@@ -519,6 +539,27 @@ module RailsErrorDashboard
       redirect_to diagnostic_dumps_errors_path
     end
 
+    def enable_coverage
+      unless RailsErrorDashboard.configuration.enable_coverage_tracking
+        flash[:alert] = "Coverage tracking is not enabled in configuration."
+        redirect_to errors_path
+        return
+      end
+
+      if Services::CoverageTracker.enable!
+        flash[:notice] = "Code path coverage enabled. Reproduce the error, then view source code to see executed lines."
+      else
+        flash[:alert] = "Could not enable coverage. Requires Ruby 3.2+."
+      end
+      redirect_back fallback_location: errors_path
+    end
+
+    def disable_coverage
+      Services::CoverageTracker.disable!
+      flash[:notice] = "Code path coverage disabled."
+      redirect_back fallback_location: errors_path
+    end
+
     def settings
       @config = RailsErrorDashboard.configuration
     end

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/helpers/rails_error_dashboard/backtrace_helper.rb

@@ -168,6 +168,18 @@ module RailsErrorDashboard
       end
     end
 
+    # Read coverage data for a file when coverage tracking is active
+    # @return [Hash{Integer => Boolean}] line_number => executed?, or nil
+    def read_coverage_for_file(file_path)
+      return nil unless RailsErrorDashboard.configuration.enable_coverage_tracking
+      return nil unless Services::CoverageTracker.active?
+
+      Services::CoverageTracker.peek(file_path)
+    rescue => e
+      Rails.logger.error("[RailsErrorDashboard] read_coverage_for_file failed: #{e.class}: #{e.message}")
+      nil
+    end
+
     # Read git blame for a backtrace frame
     # Returns blame data hash or nil
     def read_git_blame(frame)

data/app/jobs/rails_error_dashboard/scheduled_digest_job.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module RailsErrorDashboard
+  # Background job to send scheduled error digest emails.
+  # Schedule this job via your preferred scheduler (SolidQueue, Sidekiq, cron).
+  #
+  # @example Schedule daily digest
+  #   RailsErrorDashboard::ScheduledDigestJob.perform_later(period: "daily")
+  #
+  # @example Schedule via rake
+  #   rails error_dashboard:send_digest PERIOD=daily
+  class ScheduledDigestJob < ApplicationJob
+    queue_as :default
+
+    def perform(period: "daily", application_id: nil)
+      return unless RailsErrorDashboard.configuration.enable_scheduled_digests
+
+      recipients = effective_recipients
+      return if recipients.blank?
+
+      digest = Services::DigestBuilder.call(
+        period: period.to_sym,
+        application_id: application_id
+      )
+
+      DigestMailer.digest_summary(digest, recipients).deliver_now
+    rescue => e
+      Rails.logger.error("[RailsErrorDashboard] ScheduledDigestJob failed: #{e.class}: #{e.message}")
+    end
+
+    private
+
+    def effective_recipients
+      config = RailsErrorDashboard.configuration
+      recipients = config.digest_recipients
+      recipients = config.notification_email_recipients if recipients.blank?
+      recipients.presence
+    end
+  end
+end

data/app/mailers/rails_error_dashboard/digest_mailer.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module RailsErrorDashboard
+  class DigestMailer < ApplicationMailer
+    def digest_summary(digest, recipients)
+      @digest = digest
+      @dashboard_url = dashboard_base_url
+
+      mail(
+        to: recipients,
+        subject: "RED Digest — #{digest[:stats][:new_errors]} new errors (#{digest[:period_label]})"
+      )
+    end
+
+    private
+
+    def dashboard_base_url
+      base = RailsErrorDashboard.configuration.dashboard_base_url || "http://localhost:3000"
+      mount_path = RailsErrorDashboard.configuration.engine_mount_path
+      "#{base}#{mount_path}"
+    end
+  end
+end

data/app/mailers/rails_error_dashboard/error_notification_mailer.rb

@@ -16,7 +16,8 @@ module RailsErrorDashboard
 
     def dashboard_url(error_log)
       base_url = RailsErrorDashboard.configuration.dashboard_base_url || "http://localhost:3000"
-      "#{base_url}/error_dashboard/errors/#{error_log.id}"
+      mount_path = RailsErrorDashboard.configuration.engine_mount_path
+      "#{base_url}#{mount_path}/errors/#{error_log.id}"
     end
 
     def truncate_subject(message)

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

@@ -1651,6 +1651,16 @@ 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 user_impact_errors_path(nav_params), class: "nav-link #{request.path == user_impact_errors_path ? 'active' : ''}" do %>
+                  <i class="bi bi-people"></i> User Impact
+                <% 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/digest_mailer/digest_summary.html.erb

@@ -0,0 +1,172 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <style>
+    body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; margin: 0; padding: 0; background-color: #f4f4f5; color: #18181b; }
+    .container { max-width: 600px; margin: 0 auto; padding: 20px; }
+    .card { background: #ffffff; border-radius: 8px; padding: 24px; margin-bottom: 16px; border: 1px solid #e4e4e7; }
+    .header { text-align: center; padding: 24px 0; }
+    .header h1 { font-size: 24px; margin: 0 0 4px 0; color: #18181b; }
+    .header .subtitle { color: #71717a; font-size: 14px; }
+    .stat-grid { display: flex; flex-wrap: wrap; gap: 12px; justify-content: center; }
+    .stat-box { flex: 1 1 120px; text-align: center; padding: 16px 8px; background: #f9fafb; border-radius: 6px; min-width: 120px; }
+    .stat-value { font-size: 28px; font-weight: 700; line-height: 1.2; }
+    .stat-label { font-size: 12px; color: #71717a; margin-top: 4px; }
+    .text-danger { color: #ef4444; }
+    .text-success { color: #22c55e; }
+    .text-warning { color: #f59e0b; }
+    .text-muted { color: #71717a; }
+    .text-primary { color: #3b82f6; }
+    .badge { display: inline-block; padding: 2px 8px; border-radius: 4px; font-size: 11px; font-weight: 600; text-transform: uppercase; }
+    .badge-critical { background: #fef2f2; color: #ef4444; }
+    .badge-high { background: #fff7ed; color: #f97316; }
+    table { width: 100%; border-collapse: collapse; }
+    th, td { padding: 10px 12px; text-align: left; border-bottom: 1px solid #e4e4e7; font-size: 14px; }
+    th { font-weight: 600; color: #71717a; font-size: 12px; text-transform: uppercase; }
+    a { color: #3b82f6; text-decoration: none; }
+    a:hover { text-decoration: underline; }
+    .comparison { display: flex; gap: 16px; justify-content: center; align-items: center; padding: 12px; background: #f9fafb; border-radius: 6px; }
+    .comparison .delta { font-size: 20px; font-weight: 700; }
+    .footer { text-align: center; padding: 20px; color: #a1a1aa; font-size: 12px; }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <!-- Header -->
+    <div class="header">
+      <h1>RED Error Digest</h1>
+      <div class="subtitle"><%= @digest[:period_label] %> — <%= @digest[:generated_at].strftime('%B %d, %Y') %></div>
+    </div>
+
+    <!-- Summary Stats -->
+    <div class="card">
+      <div class="stat-grid">
+        <div class="stat-box">
+          <div class="stat-value text-primary"><%= @digest[:stats][:new_errors] %></div>
+          <div class="stat-label">New Errors</div>
+        </div>
+        <div class="stat-box">
+          <div class="stat-value"><%= @digest[:stats][:total_occurrences] %></div>
+          <div class="stat-label">Occurrences</div>
+        </div>
+        <div class="stat-box">
+          <div class="stat-value text-success"><%= @digest[:stats][:resolved] %></div>
+          <div class="stat-label">Resolved</div>
+        </div>
+        <div class="stat-box">
+          <div class="stat-value text-warning"><%= @digest[:stats][:unresolved] %></div>
+          <div class="stat-label">Unresolved</div>
+        </div>
+        <div class="stat-box">
+          <div class="stat-value text-danger"><%= @digest[:stats][:critical_high] %></div>
+          <div class="stat-label">Critical/High</div>
+        </div>
+        <div class="stat-box">
+          <div class="stat-value"><%= @digest[:stats][:resolution_rate] %>%</div>
+          <div class="stat-label">Resolution Rate</div>
+        </div>
+      </div>
+    </div>
+
+    <!-- Comparison -->
+    <% if @digest[:comparison][:error_delta_percentage] %>
+      <div class="card">
+        <%
+          delta = @digest[:comparison][:error_delta]
+          pct = @digest[:comparison][:error_delta_percentage]
+          delta_class = delta > 0 ? "text-danger" : (delta < 0 ? "text-success" : "text-muted")
+          arrow = delta > 0 ? "&#9650;" : (delta < 0 ? "&#9660;" : "&#8212;")
+        %>
+        <div class="comparison">
+          <div>
+            <span class="text-muted">vs previous <%= @digest[:period] %>:</span>
+          </div>
+          <div class="delta <%= delta_class %>">
+            <%== arrow %> <%= delta > 0 ? "+#{delta}" : delta %> errors
+            (<%= pct > 0 ? "+#{pct}" : pct %>%)
+          </div>
+        </div>
+      </div>
+    <% end %>
+
+    <!-- Critical / High Unresolved -->
+    <% if @digest[:critical_unresolved].any? %>
+      <div class="card">
+        <h3 style="margin: 0 0 12px 0; font-size: 16px;">Critical &amp; High Unresolved</h3>
+        <table>
+          <thead>
+            <tr>
+              <th>Severity</th>
+              <th>Error</th>
+              <th></th>
+            </tr>
+          </thead>
+          <tbody>
+            <% @digest[:critical_unresolved].each do |error| %>
+              <tr>
+                <td>
+                  <span class="badge badge-<%= error[:severity].to_s.downcase %>"><%= error[:severity].to_s.upcase %></span>
+                </td>
+                <td>
+                  <strong><%= error[:error_type] %></strong><br>
+                  <small class="text-muted"><%= error[:message] %></small>
+                </td>
+                <td>
+                  <a href="<%= @dashboard_url %>/errors/<%= error[:id] %>">View</a>
+                </td>
+              </tr>
+            <% end %>
+          </tbody>
+        </table>
+      </div>
+    <% end %>
+
+    <!-- Top Errors -->
+    <% if @digest[:top_errors].any? %>
+      <div class="card">
+        <h3 style="margin: 0 0 12px 0; font-size: 16px;">Top Errors by Count</h3>
+        <table>
+          <thead>
+            <tr>
+              <th>Error Type</th>
+              <th>Count</th>
+              <th></th>
+            </tr>
+          </thead>
+          <tbody>
+            <% @digest[:top_errors].each do |error| %>
+              <tr>
+                <td>
+                  <strong><%= error[:error_type] %></strong><br>
+                  <small class="text-muted"><%= error[:message] %></small>
+                </td>
+                <td><%= error[:count] %></td>
+                <td>
+                  <% if error[:id] %>
+                    <a href="<%= @dashboard_url %>/errors/<%= error[:id] %>">View</a>
+                  <% end %>
+                </td>
+              </tr>
+            <% end %>
+          </tbody>
+        </table>
+      </div>
+    <% end %>
+
+    <!-- CTA -->
+    <div class="card" style="text-align: center;">
+      <a href="<%= @dashboard_url %>" style="display: inline-block; padding: 10px 24px; background: #3b82f6; color: #ffffff; border-radius: 6px; font-weight: 600; text-decoration: none;">
+        Open Dashboard
+      </a>
+    </div>
+
+    <!-- Footer -->
+    <div class="footer">
+      Automated digest from <strong>RED</strong> (Rails Error Dashboard)<br>
+      <a href="<%= @dashboard_url %>/settings">Manage digest settings</a>
+    </div>
+  </div>
+</body>
+</html>

data/app/views/rails_error_dashboard/digest_mailer/digest_summary.text.erb

@@ -0,0 +1,49 @@
+==========================================
+RED — Error Digest (<%= @digest[:period_label] %>)
+==========================================
+Generated: <%= @digest[:generated_at].strftime('%B %d, %Y at %I:%M %p %Z') %>
+
+------------------------------------------
+SUMMARY
+------------------------------------------
+New Errors:        <%= @digest[:stats][:new_errors] %>
+Total Occurrences: <%= @digest[:stats][:total_occurrences] %>
+Resolved:          <%= @digest[:stats][:resolved] %>
+Unresolved:        <%= @digest[:stats][:unresolved] %>
+Critical/High:     <%= @digest[:stats][:critical_high] %>
+Resolution Rate:   <%= @digest[:stats][:resolution_rate] %>%
+
+<% if @digest[:comparison][:error_delta_percentage] %>
+------------------------------------------
+VS PREVIOUS PERIOD
+------------------------------------------
+Current:  <%= @digest[:comparison][:current_count] %> errors
+Previous: <%= @digest[:comparison][:previous_count] %> errors
+Change:   <%= @digest[:comparison][:error_delta] > 0 ? "+#{@digest[:comparison][:error_delta]}" : @digest[:comparison][:error_delta] %> (<%= @digest[:comparison][:error_delta_percentage] > 0 ? "+#{@digest[:comparison][:error_delta_percentage]}" : @digest[:comparison][:error_delta_percentage] %>%)
+<% end %>
+
+<% if @digest[:critical_unresolved].any? %>
+------------------------------------------
+CRITICAL / HIGH UNRESOLVED
+------------------------------------------
+<% @digest[:critical_unresolved].each do |error| %>
+  [<%= error[:severity].to_s.upcase %>] <%= error[:error_type] %>: <%= error[:message] %>
+  → <%= @dashboard_url %>/errors/<%= error[:id] %>
+<% end %>
+<% end %>
+
+<% if @digest[:top_errors].any? %>
+------------------------------------------
+TOP ERRORS BY COUNT
+------------------------------------------
+<% @digest[:top_errors].each_with_index do |error, i| %>
+  <%= i + 1 %>. <%= error[:error_type] %> (<%= error[:count] %>x): <%= error[:message] %>
+     → <%= @dashboard_url %>/errors/<%= error[:id] %>
+<% end %>
+<% end %>
+
+------------------------------------------
+
+View the full dashboard:
+<%= @dashboard_url %>
+This is an automated digest from RED (Rails Error Dashboard).

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/_source_code.html.erb

@@ -55,14 +55,27 @@
 
       <!-- Source code lines with syntax highlighting -->
       <div class="source-code-content bg-white">
+        <%
+          # Find the error line number for highlighting
+          error_line_number = source_data[:lines].find { |l| l[:highlight] }&.dig(:number)
+          # Get start line number (first line in context)
+          start_line = source_data[:lines].first[:number]
+          # Coverage data (if active)
+          coverage_data = read_coverage_for_file(frame[:file_path])
+        %>
+        <% if coverage_data %>
+          <div class="px-3 py-1 bg-info bg-opacity-10 border-bottom">
+            <small class="text-info">
+              <i class="bi bi-broadcast"></i> Coverage active — <span class="text-success">green</span> = executed, <span class="text-secondary">gray</span> = not executed
+            </small>
+          </div>
+        <% end %>
         <div class="code-block" style="max-height: 500px; overflow-y: auto; overflow-x: auto;">
-          <%
-            # Find the error line number for highlighting
-            error_line_number = source_data[:lines].find { |l| l[:highlight] }&.dig(:number)
-            # Get start line number (first line in context)
-            start_line = source_data[:lines].first[:number]
-          %>
-          <pre class="mb-0"><code class="language-<%= source_data[:language] || 'plaintext' %>" data-error-line="<%= error_line_number %>" data-start-line="<%= start_line %>"><%= source_data[:lines].map { |l| l[:content] }.join("\n") %></code></pre>
+          <% if coverage_data %>
+            <pre class="mb-0" style="position: relative;"><code class="language-<%= source_data[:language] || 'plaintext' %>" data-error-line="<%= error_line_number %>" data-start-line="<%= start_line %>"><% source_data[:lines].each_with_index do |l, i| %><% line_num = l[:number] %><% executed = coverage_data[line_num] %><% marker = executed == true ? "\u2713" : (executed == false ? "\u00b7" : " ") %><% color = executed == true ? "color: #22c55e;" : (executed == false ? "color: #9ca3af;" : "") %><span style="<%= color %> user-select: none;"><%= marker %></span> <%= l[:content] %><%= "\n" unless i == source_data[:lines].size - 1 %><% end %></code></pre>
+          <% else %>
+            <pre class="mb-0"><code class="language-<%= source_data[:language] || 'plaintext' %>" data-error-line="<%= error_line_number %>" data-start-line="<%= start_line %>"><%= source_data[:lines].map { |l| l[:content] }.join("\n") %></code></pre>
+          <% end %>
         </div>
       </div>
     </div>