rails_error_dashboard 0.5.7 → 0.5.9

data/lib/rails_error_dashboard/services/issue_tracker_client.rb

@@ -0,0 +1,168 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "json"
+require "uri"
+
+module RailsErrorDashboard
+  module Services
+    # Base class and factory for issue tracker API clients.
+    #
+    # Supports GitHub, GitLab, and Codeberg/Gitea/Forgejo via a unified interface.
+    # Each provider implements the same methods with provider-specific API calls.
+    #
+    # @example
+    #   client = IssueTrackerClient.for(:github, token: "ghp_xxx", repo: "user/repo")
+    #   result = client.create_issue(title: "NoMethodError", body: "...", labels: ["bug"])
+    #   # => { url: "https://github.com/user/repo/issues/42", number: 42 }
+    class IssueTrackerClient
+      REQUEST_TIMEOUT = 15 # seconds
+      MAX_BODY_LENGTH = 65_000 # GitHub has ~65K limit for issue body
+
+      attr_reader :token, :repo, :api_url
+
+      # Factory method — returns the correct client for the provider
+      #
+      # @param provider [Symbol] :github, :gitlab, or :codeberg
+      # @param token [String] API authentication token
+      # @param repo [String] Repository identifier ("owner/repo")
+      # @param api_url [String, nil] Custom API base URL (for self-hosted)
+      # @return [IssueTrackerClient] Provider-specific client instance
+      def self.for(provider, token:, repo:, api_url: nil)
+        case provider&.to_sym
+        when :github
+          GitHubIssueClient.new(token: token, repo: repo, api_url: api_url)
+        when :gitlab
+          GitLabIssueClient.new(token: token, repo: repo, api_url: api_url)
+        when :codeberg
+          CodebergIssueClient.new(token: token, repo: repo, api_url: api_url)
+        else
+          raise ArgumentError, "Unknown issue tracker provider: #{provider}. Supported: :github, :gitlab, :codeberg"
+        end
+      end
+
+      # Build a client from the current gem configuration
+      #
+      # @return [IssueTrackerClient, nil] Client instance or nil if not configured
+      def self.from_config
+        config = RailsErrorDashboard.configuration
+        return nil unless config.enable_issue_tracking
+
+        provider = config.effective_issue_tracker_provider
+        token = config.effective_issue_tracker_token
+        repo = config.effective_issue_tracker_repo
+        api_url = config.effective_issue_tracker_api_url
+
+        return nil unless provider && token && repo
+
+        self.for(provider, token: token, repo: repo, api_url: api_url)
+      rescue => e
+        nil
+      end
+
+      def initialize(token:, repo:, api_url: nil)
+        @token = token
+        @repo = repo
+        @api_url = api_url
+      end
+
+      # Create an issue on the platform
+      # @return [Hash] { url:, number:, success: true } or { success: false, error: "..." }
+      def create_issue(title:, body:, labels: [])
+        raise NotImplementedError
+      end
+
+      # Close an issue
+      # @return [Hash] { success: true } or { success: false, error: "..." }
+      def close_issue(number:)
+        raise NotImplementedError
+      end
+
+      # Reopen a closed issue
+      # @return [Hash] { success: true } or { success: false, error: "..." }
+      def reopen_issue(number:)
+        raise NotImplementedError
+      end
+
+      # Add a comment to an issue
+      # @return [Hash] { url:, success: true } or { success: false, error: "..." }
+      def add_comment(number:, body:)
+        raise NotImplementedError
+      end
+
+      # Fetch comments from an issue
+      # @return [Hash] { comments: [...], success: true } or { success: false, error: "..." }
+      def fetch_comments(number:, per_page: 10)
+        raise NotImplementedError
+      end
+
+      # Fetch issue details (status, assignees, labels)
+      # @return [Hash] { state:, assignees: [...], labels: [...], title:, success: true } or { success: false }
+      def fetch_issue(number:)
+        raise NotImplementedError
+      end
+
+      private
+
+      def http_post(uri, body, headers = {})
+        http_request(:post, uri, body, headers)
+      end
+
+      def http_patch(uri, body, headers = {})
+        http_request(:patch, uri, body, headers)
+      end
+
+      def http_put(uri, body, headers = {})
+        http_request(:put, uri, body, headers)
+      end
+
+      def http_get(uri, headers = {})
+        http_request(:get, uri, nil, headers)
+      end
+
+      def http_request(method, uri, body, headers)
+        parsed = URI.parse(uri)
+        http = Net::HTTP.new(parsed.host, parsed.port)
+        http.use_ssl = parsed.scheme == "https"
+        http.open_timeout = REQUEST_TIMEOUT
+        http.read_timeout = REQUEST_TIMEOUT
+
+        request = case method
+        when :post then Net::HTTP::Post.new(parsed)
+        when :patch then Net::HTTP::Patch.new(parsed)
+        when :put then Net::HTTP::Put.new(parsed)
+        when :get then Net::HTTP::Get.new(parsed)
+        end
+
+        request["Content-Type"] = "application/json"
+        headers.each { |k, v| request[k] = v }
+        request.body = body.to_json if body
+
+        response = http.request(request)
+        { status: response.code.to_i, body: parse_response(response.body) }
+      rescue => e
+        { status: 0, body: nil, error: "#{e.class}: #{e.message}" }
+      end
+
+      def parse_response(body)
+        return nil if body.nil? || body.empty?
+        JSON.parse(body)
+      rescue JSON::ParserError
+        nil
+      end
+
+      def truncate_body(body)
+        return body if body.length <= MAX_BODY_LENGTH
+        body[0...MAX_BODY_LENGTH] + "\n\n---\n*Truncated — full details in the error dashboard*"
+      end
+
+      def success_response(data)
+        data.merge(success: true)
+      end
+
+      def error_response(message)
+        { success: false, error: message }
+      end
+    end
+  end
+end

data/lib/rails_error_dashboard/services/markdown_error_formatter.rb

@@ -130,6 +130,10 @@ module RailsErrorDashboard
         vars = parse_json(raw)
         return nil unless vars.is_a?(Hash) && vars.any?
 
+        # Skip [FILTERED] variables — LLM can't use redacted values for debugging
+        vars = vars.reject { |_, info| filtered_variable?(info) }
+        return nil if vars.empty?
+
         rows = vars.first(MAX_VARIABLES).map { |name, info|
           if info.is_a?(Hash)
             "| #{name} | #{info["type"]} | #{truncate_value(info["value"])} |"
@@ -149,6 +153,9 @@ module RailsErrorDashboard
         return nil unless vars.is_a?(Hash) && vars.any?
 
         self_class = vars.delete("_self_class")
+
+        # Skip [FILTERED] variables — LLM can't use redacted values for debugging
+        vars = vars.reject { |_, info| filtered_variable?(info) }
         return nil if vars.empty? && self_class.nil?
 
         lines = []
@@ -358,6 +365,11 @@ module RailsErrorDashboard
         nil
       end
 
+      def filtered_variable?(info)
+        return false unless info.is_a?(Hash)
+        info["filtered"] == true || info["value"] == "[FILTERED]"
+      end
+
       def truncate_value(value, max_length = 200)
         str = value.to_s
         str.length > max_length ? "#{str[0...max_length]}..." : str

data/lib/rails_error_dashboard/subscribers/active_storage_subscriber.rb

@@ -0,0 +1,112 @@
+# frozen_string_literal: true
+
+module RailsErrorDashboard
+  module Subscribers
+    # Registers ActiveSupport::Notifications subscribers for ActiveStorage events.
+    #
+    # ActiveStorage emits:
+    # - service_upload.active_storage          — file uploaded to storage service
+    # - service_download.active_storage        — file downloaded from storage service
+    # - service_streaming_download.active_storage — streaming download
+    # - service_delete.active_storage          — file deleted from storage service
+    # - service_delete_prefixed.active_storage — batch delete by prefix
+    # - service_exist.active_storage           — existence check
+    #
+    # Each event is captured as a breadcrumb with category "active_storage",
+    # allowing correlation between storage operations and error spikes.
+    #
+    # SAFETY RULES (HOST_APP_SAFETY.md):
+    # - Every subscriber wrapped in rescue => e; nil
+    # - Never raise from subscriber callbacks
+    # - Skip if buffer is nil (not in a request context)
+    class ActiveStorageSubscriber
+      EVENTS = %w[
+        service_upload.active_storage
+        service_download.active_storage
+        service_streaming_download.active_storage
+        service_delete.active_storage
+        service_delete_prefixed.active_storage
+        service_exist.active_storage
+      ].freeze
+
+      # Event subscriptions managed by this class
+      @subscriptions = []
+
+      class << self
+        attr_reader :subscriptions
+
+        # Register all ActiveStorage event subscribers
+        # @return [Array] Array of subscription objects
+        def subscribe!
+          @subscriptions = []
+
+          EVENTS.each do |event_name|
+            @subscriptions << subscribe_event(event_name)
+          end
+
+          @subscriptions
+        end
+
+        # Remove all ActiveStorage subscribers
+        def unsubscribe!
+          @subscriptions.each do |sub|
+            ActiveSupport::Notifications.unsubscribe(sub) if sub
+          rescue => e
+            nil
+          end
+          @subscriptions = []
+        end
+
+        private
+
+        def subscribe_event(event_name)
+          ActiveSupport::Notifications.subscribe(event_name) do |*args|
+            event = ActiveSupport::Notifications::Event.new(*args)
+            handle_active_storage(event, event_name)
+          rescue => e
+            nil
+          end
+        end
+
+        def handle_active_storage(event, event_name)
+          return unless Services::BreadcrumbCollector.current_buffer
+
+          payload = event.payload || {}
+          service = payload[:service].to_s.presence || "Unknown"
+          operation = event_name.split(".").first.sub("service_", "")
+          key = (payload[:key] || payload[:prefix]).to_s
+
+          message = build_message(operation, service, key)
+
+          metadata = {
+            service: service,
+            operation: operation
+          }
+          metadata[:key] = key.truncate(100) if key.present?
+
+          duration_ms = event.duration if event.respond_to?(:duration)
+
+          Services::BreadcrumbCollector.add("active_storage", message, duration_ms: duration_ms, metadata: metadata)
+        end
+
+        def build_message(operation, service, key)
+          short_key = key.present? ? key.truncate(40) : nil
+          case operation
+          when "upload"
+            short_key ? "upload #{short_key} (#{service})" : "upload (#{service})"
+          when "download", "streaming_download"
+            short_key ? "download #{short_key} (#{service})" : "download (#{service})"
+          when "delete"
+            short_key ? "delete #{short_key} (#{service})" : "delete (#{service})"
+          when "delete_prefixed"
+            short_key ? "delete_prefixed #{short_key} (#{service})" : "delete_prefixed (#{service})"
+          when "exist"
+            short_key ? "exist? #{short_key} (#{service})" : "exist? (#{service})"
+          else
+            "#{operation} (#{service})"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/rails_error_dashboard/subscribers/issue_tracker_subscriber.rb

@@ -0,0 +1,71 @@
+# frozen_string_literal: true
+
+module RailsErrorDashboard
+  module Subscribers
+    # Hooks into the error lifecycle to trigger issue tracker jobs.
+    #
+    # Called from the engine initializer via direct integration with
+    # the LogError and ResolveError commands' callback mechanisms.
+    #
+    # All work is done via background jobs — never blocks the capture path.
+    class IssueTrackerSubscriber
+      class << self
+        # Called when a new error is first logged
+        def on_error_logged(error_log)
+          return unless should_auto_create?(error_log)
+          CreateIssueJob.perform_later(error_log.id)
+        rescue => e
+          nil
+        end
+
+        # Called when a resolved error recurs (auto-reopened)
+        def on_error_reopened(error_log)
+          return unless error_log.external_issue_url.present?
+          return unless RailsErrorDashboard.configuration.enable_issue_tracking
+          ReopenLinkedIssueJob.perform_later(error_log.id)
+        rescue => e
+          nil
+        end
+
+        # Called when an existing error occurs again
+        def on_error_recurred(error_log)
+          return unless error_log.external_issue_url.present?
+          return unless RailsErrorDashboard.configuration.enable_issue_tracking
+          AddIssueRecurrenceCommentJob.perform_later(error_log.id)
+        rescue => e
+          nil
+        end
+
+        # Called when an error is resolved in the dashboard
+        def on_error_resolved(error_log)
+          return unless error_log.external_issue_url.present?
+          return unless RailsErrorDashboard.configuration.enable_issue_tracking
+          CloseLinkedIssueJob.perform_later(error_log.id)
+        rescue => e
+          nil
+        end
+
+        private
+
+        def should_auto_create?(error_log)
+          config = RailsErrorDashboard.configuration
+          return false unless config.enable_issue_tracking && config.auto_create_issues
+          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
+
+          # Severity threshold check
+          severity = error_log.severity&.to_sym
+          if config.auto_create_issues_for_severities&.include?(severity)
+            return true
+          end
+
+          false
+        end
+      end
+    end
+  end
+end

data/lib/rails_error_dashboard/version.rb

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

data/lib/rails_error_dashboard.rb

@@ -56,6 +56,10 @@ require "rails_error_dashboard/services/n_plus_one_detector"
 require "rails_error_dashboard/services/curl_generator"
 require "rails_error_dashboard/services/rspec_generator"
 require "rails_error_dashboard/services/markdown_error_formatter"
+require "rails_error_dashboard/services/issue_tracker_client"
+require "rails_error_dashboard/services/github_issue_client"
+require "rails_error_dashboard/services/gitlab_issue_client"
+require "rails_error_dashboard/services/codeberg_issue_client"
 require "rails_error_dashboard/services/database_health_inspector"
 require "rails_error_dashboard/services/cache_analyzer"
 require "rails_error_dashboard/services/variable_serializer"
@@ -66,14 +70,20 @@ require "rails_error_dashboard/services/diagnostic_dump_generator"
 require "rails_error_dashboard/subscribers/breadcrumb_subscriber"
 require "rails_error_dashboard/subscribers/rack_attack_subscriber"
 require "rails_error_dashboard/subscribers/action_cable_subscriber"
+require "rails_error_dashboard/subscribers/active_storage_subscriber"
+require "rails_error_dashboard/subscribers/issue_tracker_subscriber"
 require "rails_error_dashboard/queries/co_occurring_errors"
 require "rails_error_dashboard/queries/action_cable_summary"
+require "rails_error_dashboard/queries/active_storage_summary"
 require "rails_error_dashboard/queries/error_cascades"
 require "rails_error_dashboard/queries/baseline_stats"
 require "rails_error_dashboard/queries/platform_comparison"
 require "rails_error_dashboard/queries/error_correlation"
 require "rails_error_dashboard/commands/log_error"
 require "rails_error_dashboard/commands/resolve_error"
+require "rails_error_dashboard/commands/create_issue"
+require "rails_error_dashboard/commands/link_existing_issue"
+require "rails_error_dashboard/services/issue_body_formatter"
 require "rails_error_dashboard/commands/batch_resolve_errors"
 require "rails_error_dashboard/commands/batch_delete_errors"
 require "rails_error_dashboard/commands/assign_error"
@@ -86,7 +96,7 @@ require "rails_error_dashboard/commands/unmute_error"
 require "rails_error_dashboard/commands/batch_mute_errors"
 require "rails_error_dashboard/commands/batch_unmute_errors"
 require "rails_error_dashboard/commands/update_error_status"
-require "rails_error_dashboard/commands/add_error_comment"
+require "rails_error_dashboard/commands/add_error_comment"  # Used internally by workflow commands (snooze, mute, status changes)
 require "rails_error_dashboard/commands/increment_cascade_detection"
 require "rails_error_dashboard/commands/calculate_cascade_probability"
 require "rails_error_dashboard/commands/find_or_increment_error"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails_error_dashboard
 version: !ruby/object:Gem::Version
-  version: 0.5.7
+  version: 0.5.9
 platform: ruby
 authors:
 - Anjan Jagirdar
@@ -244,16 +244,21 @@ files:
 - Rakefile
 - app/controllers/rails_error_dashboard/application_controller.rb
 - app/controllers/rails_error_dashboard/errors_controller.rb
+- app/controllers/rails_error_dashboard/webhooks_controller.rb
 - app/helpers/rails_error_dashboard/application_helper.rb
 - app/helpers/rails_error_dashboard/backtrace_helper.rb
 - app/helpers/rails_error_dashboard/overview_helper.rb
 - app/helpers/rails_error_dashboard/user_agent_helper.rb
+- app/jobs/rails_error_dashboard/add_issue_recurrence_comment_job.rb
 - app/jobs/rails_error_dashboard/application_job.rb
 - app/jobs/rails_error_dashboard/async_error_logging_job.rb
 - app/jobs/rails_error_dashboard/baseline_alert_job.rb
+- app/jobs/rails_error_dashboard/close_linked_issue_job.rb
+- app/jobs/rails_error_dashboard/create_issue_job.rb
 - app/jobs/rails_error_dashboard/discord_error_notification_job.rb
 - app/jobs/rails_error_dashboard/email_error_notification_job.rb
 - app/jobs/rails_error_dashboard/pagerduty_error_notification_job.rb
+- app/jobs/rails_error_dashboard/reopen_linked_issue_job.rb
 - app/jobs/rails_error_dashboard/retention_cleanup_job.rb
 - app/jobs/rails_error_dashboard/slack_error_notification_job.rb
 - app/jobs/rails_error_dashboard/swallowed_exception_flush_job.rb
@@ -279,6 +284,7 @@ files:
 - app/views/rails_error_dashboard/errors/_error_info.html.erb
 - app/views/rails_error_dashboard/errors/_error_row.html.erb
 - app/views/rails_error_dashboard/errors/_instance_variables.html.erb
+- app/views/rails_error_dashboard/errors/_issue_section.html.erb
 - app/views/rails_error_dashboard/errors/_local_variables.html.erb
 - app/views/rails_error_dashboard/errors/_modals.html.erb
 - app/views/rails_error_dashboard/errors/_pattern_insights.html.erb
@@ -291,6 +297,7 @@ files:
 - app/views/rails_error_dashboard/errors/_timeline.html.erb
 - app/views/rails_error_dashboard/errors/_user_errors_table.html.erb
 - app/views/rails_error_dashboard/errors/actioncable_health_summary.html.erb
+- app/views/rails_error_dashboard/errors/activestorage_health_summary.html.erb
 - app/views/rails_error_dashboard/errors/analytics.html.erb
 - app/views/rails_error_dashboard/errors/cache_health_summary.html.erb
 - app/views/rails_error_dashboard/errors/correlation.html.erb
@@ -341,6 +348,7 @@ files:
 - db/migrate/20260307000001_create_rails_error_dashboard_diagnostic_dumps.rb
 - db/migrate/20260323000001_add_muted_to_error_logs.rb
 - db/migrate/20260325000001_fix_swallowed_exceptions_index_for_mysql.rb
+- db/migrate/20260326000001_add_issue_tracking_to_error_logs.rb
 - lib/generators/rails_error_dashboard/install/install_generator.rb
 - lib/generators/rails_error_dashboard/install/templates/README
 - lib/generators/rails_error_dashboard/install/templates/initializer.rb
@@ -355,10 +363,12 @@ files:
 - lib/rails_error_dashboard/commands/batch_resolve_errors.rb
 - lib/rails_error_dashboard/commands/batch_unmute_errors.rb
 - lib/rails_error_dashboard/commands/calculate_cascade_probability.rb
+- lib/rails_error_dashboard/commands/create_issue.rb
 - lib/rails_error_dashboard/commands/find_or_create_application.rb
 - lib/rails_error_dashboard/commands/find_or_increment_error.rb
 - lib/rails_error_dashboard/commands/flush_swallowed_exceptions.rb
 - lib/rails_error_dashboard/commands/increment_cascade_detection.rb
+- lib/rails_error_dashboard/commands/link_existing_issue.rb
 - lib/rails_error_dashboard/commands/log_error.rb
 - lib/rails_error_dashboard/commands/mute_error.rb
 - lib/rails_error_dashboard/commands/resolve_error.rb
@@ -385,6 +395,7 @@ files:
 - lib/rails_error_dashboard/plugins/jira_integration_plugin.rb
 - lib/rails_error_dashboard/plugins/metrics_plugin.rb
 - lib/rails_error_dashboard/queries/action_cable_summary.rb
+- lib/rails_error_dashboard/queries/active_storage_summary.rb
 - lib/rails_error_dashboard/queries/analytics_stats.rb
 - lib/rails_error_dashboard/queries/baseline_stats.rb
 - lib/rails_error_dashboard/queries/cache_health_summary.rb
@@ -415,6 +426,7 @@ files:
 - lib/rails_error_dashboard/services/cache_analyzer.rb
 - lib/rails_error_dashboard/services/cascade_detector.rb
 - lib/rails_error_dashboard/services/cause_chain_extractor.rb
+- lib/rails_error_dashboard/services/codeberg_issue_client.rb
 - lib/rails_error_dashboard/services/crash_capture.rb
 - lib/rails_error_dashboard/services/curl_generator.rb
 - lib/rails_error_dashboard/services/database_health_inspector.rb
@@ -427,7 +439,11 @@ files:
 - lib/rails_error_dashboard/services/error_notification_dispatcher.rb
 - lib/rails_error_dashboard/services/exception_filter.rb
 - lib/rails_error_dashboard/services/git_blame_reader.rb
+- lib/rails_error_dashboard/services/github_issue_client.rb
 - lib/rails_error_dashboard/services/github_link_generator.rb
+- lib/rails_error_dashboard/services/gitlab_issue_client.rb
+- lib/rails_error_dashboard/services/issue_body_formatter.rb
+- lib/rails_error_dashboard/services/issue_tracker_client.rb
 - lib/rails_error_dashboard/services/local_variable_capturer.rb
 - lib/rails_error_dashboard/services/markdown_error_formatter.rb
 - lib/rails_error_dashboard/services/n_plus_one_detector.rb
@@ -450,7 +466,9 @@ files:
 - lib/rails_error_dashboard/services/variable_serializer.rb
 - lib/rails_error_dashboard/services/webhook_payload_builder.rb
 - lib/rails_error_dashboard/subscribers/action_cable_subscriber.rb
+- lib/rails_error_dashboard/subscribers/active_storage_subscriber.rb
 - lib/rails_error_dashboard/subscribers/breadcrumb_subscriber.rb
+- lib/rails_error_dashboard/subscribers/issue_tracker_subscriber.rb
 - lib/rails_error_dashboard/subscribers/rack_attack_subscriber.rb
 - lib/rails_error_dashboard/value_objects/error_context.rb
 - lib/rails_error_dashboard/version.rb
@@ -465,9 +483,9 @@ metadata:
   changelog_uri: https://github.com/AnjanJ/rails_error_dashboard/blob/main/CHANGELOG.md
   documentation_uri: https://AnjanJ.github.io/rails_error_dashboard
   bug_tracker_uri: https://github.com/AnjanJ/rails_error_dashboard/issues
-  funding_uri: https://buymeacoffee.com/anjanj
+  funding_uri: https://github.com/sponsors/AnjanJ
 post_install_message: "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n
-  \ Rails Error Dashboard v0.5.7\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n\U0001F195
+  \ Rails Error Dashboard v0.5.9\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