rails_error_dashboard 0.1.0 → 0.1.3

data/lib/rails_error_dashboard/services/similarity_calculator.rb

@@ -0,0 +1,144 @@
+# frozen_string_literal: true
+
+module RailsErrorDashboard
+  module Services
+    # Calculates similarity scores between errors using multiple algorithms
+    #
+    # Combines:
+    # - Backtrace similarity (Jaccard index on stack frames) - 70% weight
+    # - Message similarity (Levenshtein distance) - 30% weight
+    #
+    # Returns a similarity score from 0.0 (completely different) to 1.0 (identical)
+    class SimilarityCalculator
+      # Calculate similarity between two errors
+      #
+      # @param error1 [ErrorLog] First error to compare
+      # @param error2 [ErrorLog] Second error to compare
+      # @return [Float] Similarity score from 0.0 to 1.0
+      def self.call(error1, error2)
+        new(error1, error2).calculate
+      end
+
+      def initialize(error1, error2)
+        @error1 = error1
+        @error2 = error2
+      end
+
+      def calculate
+        # Quick return for same error
+        return 1.0 if @error1.id == @error2.id
+
+        # Quick return for different platforms (per user config - same platform only)
+        return 0.0 if different_platforms?
+
+        backtrace_score = calculate_backtrace_similarity
+        message_score = calculate_message_similarity
+
+        # Weighted combination: backtrace 70%, message 30%
+        (backtrace_score * 0.7) + (message_score * 0.3)
+      end
+
+      private
+
+      def different_platforms?
+        return false if @error1.platform.nil? || @error2.platform.nil?
+        @error1.platform != @error2.platform
+      end
+
+      # Calculate Jaccard similarity on backtrace frames
+      # Jaccard = intersection / union
+      def calculate_backtrace_similarity
+        frames1 = extract_frames(@error1.backtrace)
+        frames2 = extract_frames(@error2.backtrace)
+
+        return 0.0 if frames1.empty? || frames2.empty?
+
+        intersection = (frames1 & frames2).size
+        union = (frames1 | frames2).size
+
+        return 0.0 if union.zero?
+
+        intersection.to_f / union
+      end
+
+      # Calculate normalized Levenshtein distance on messages
+      # Returns 1.0 for identical messages, decreasing as they differ
+      def calculate_message_similarity
+        msg1 = normalize_message(@error1.message)
+        msg2 = normalize_message(@error2.message)
+
+        return 1.0 if msg1 == msg2
+        return 0.0 if msg1.empty? || msg2.empty?
+
+        distance = levenshtein_distance(msg1, msg2)
+        max_length = [ msg1.length, msg2.length ].max
+
+        return 0.0 if max_length.zero?
+
+        # Convert distance to similarity (1.0 = identical, 0.0 = completely different)
+        1.0 - (distance.to_f / max_length)
+      end
+
+      # Extract meaningful frames from backtrace
+      # Format: "file.rb:123:in `method_name`" => "file.rb:method_name"
+      def extract_frames(backtrace)
+        return [] if backtrace.blank?
+
+        lines = backtrace.is_a?(String) ? backtrace.split("\n") : backtrace
+        lines.first(20).map do |line|  # Only consider first 20 frames
+          # Extract file path and method name, ignore line numbers
+          if line =~ %r{([^/]+\.rb):.*?in `(.+)'$}
+            "#{Regexp.last_match(1)}:#{Regexp.last_match(2)}"
+          elsif line =~ %r{([^/]+\.rb)}
+            Regexp.last_match(1)
+          end
+        end.compact.uniq
+      end
+
+      # Normalize message for comparison
+      # Already normalized during error logging, but ensure consistency
+      def normalize_message(message)
+        return "" if message.nil?
+
+        message
+          .gsub(/#<\w+:0x[0-9a-f]+>/i, "__OBJ__")   # Object inspections - temp placeholder
+          .gsub(/0x[0-9a-f]+/i, "__HEX__")          # Hex addresses - temp placeholder
+          .gsub(/"[^"]*"/, '""')                     # Quoted strings to ""
+          .gsub(/'[^']*'/, "''")                     # Single quotes to ''
+          .downcase                                   # Convert to lowercase
+          .gsub(/\d+/, "n")                           # Numbers to n (lowercase)
+          .gsub(/__hex__/, "0xhex")                   # Replace placeholder with final value
+          .gsub(/__obj__/, "#<obj>")                  # Replace placeholder with final value
+          .strip
+      end
+
+      # Calculate Levenshtein distance (edit distance) between two strings
+      # Classic dynamic programming algorithm
+      def levenshtein_distance(str1, str2)
+        return str2.length if str1.empty?
+        return str1.length if str2.empty?
+
+        # Create matrix
+        matrix = Array.new(str1.length + 1) { Array.new(str2.length + 1, 0) }
+
+        # Initialize first row and column
+        (0..str1.length).each { |i| matrix[i][0] = i }
+        (0..str2.length).each { |j| matrix[0][j] = j }
+
+        # Fill matrix
+        (1..str1.length).each do |i|
+          (1..str2.length).each do |j|
+            cost = str1[i - 1] == str2[j - 1] ? 0 : 1
+            matrix[i][j] = [
+              matrix[i - 1][j] + 1,      # deletion
+              matrix[i][j - 1] + 1,      # insertion
+              matrix[i - 1][j - 1] + cost # substitution
+            ].min
+          end
+        end
+
+        matrix[str1.length][str2.length]
+      end
+    end
+  end
+end

data/lib/rails_error_dashboard/value_objects/error_context.rb

@@ -6,7 +6,7 @@ module RailsErrorDashboard
     # Extracts and normalizes context information from various sources
     class ErrorContext
       attr_reader :user_id, :request_url, :request_params, :user_agent, :ip_address, :platform,
-                  :controller_name, :action_name
+                  :controller_name, :action_name, :request_id, :session_id
 
       def initialize(context, source = nil)
         @context = context
@@ -20,6 +20,8 @@ module RailsErrorDashboard
         @platform = detect_platform
         @controller_name = extract_controller_name
         @action_name = extract_action_name
+        @request_id = extract_request_id
+        @session_id = extract_session_id
       end
 
       def to_h
@@ -143,6 +145,30 @@ module RailsErrorDashboard
 
         nil
       end
+
+      def extract_request_id
+        # From Rails request
+        return @context[:request]&.request_id if @context[:request]&.respond_to?(:request_id)
+
+        # From explicit context
+        return @context[:request_id] if @context[:request_id]
+
+        # From job ID (for background jobs)
+        return @context[:job]&.job_id if @context[:job]
+        return @context[:jid] if @context[:jid]
+
+        nil
+      end
+
+      def extract_session_id
+        # From Rails session
+        return @context[:request]&.session&.id if @context[:request]&.session
+
+        # From explicit context
+        return @context[:session_id] if @context[:session_id]
+
+        nil
+      end
     end
   end
 end

data/lib/rails_error_dashboard/version.rb

@@ -1,3 +1,3 @@
 module RailsErrorDashboard
-  VERSION = "0.1.0"
+  VERSION = "0.1.3"
 end

data/lib/rails_error_dashboard.rb

@@ -1,6 +1,7 @@
 require "rails_error_dashboard/version"
 require "rails_error_dashboard/engine"
 require "rails_error_dashboard/configuration"
+require "rails_error_dashboard/logger"
 
 # External dependencies
 require "pagy"
@@ -11,6 +12,17 @@ require "httparty"
 # Core library files
 require "rails_error_dashboard/value_objects/error_context"
 require "rails_error_dashboard/services/platform_detector"
+require "rails_error_dashboard/services/backtrace_parser"
+require "rails_error_dashboard/services/similarity_calculator"
+require "rails_error_dashboard/services/cascade_detector"
+require "rails_error_dashboard/services/baseline_calculator"
+require "rails_error_dashboard/services/baseline_alert_throttler"
+require "rails_error_dashboard/services/pattern_detector"
+require "rails_error_dashboard/queries/co_occurring_errors"
+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/batch_resolve_errors"
@@ -19,6 +31,7 @@ require "rails_error_dashboard/queries/errors_list"
 require "rails_error_dashboard/queries/dashboard_stats"
 require "rails_error_dashboard/queries/analytics_stats"
 require "rails_error_dashboard/queries/filter_options"
+require "rails_error_dashboard/queries/similar_errors"
 require "rails_error_dashboard/error_reporter"
 require "rails_error_dashboard/middleware/error_catcher"
 
@@ -28,12 +41,22 @@ require "rails_error_dashboard/plugin_registry"
 
 module RailsErrorDashboard
   class << self
-    attr_accessor :configuration
-  end
+    attr_writer :configuration
+
+    # Get or initialize configuration
+    def configuration
+      @configuration ||= Configuration.new
+    end
 
-  def self.configure
-    self.configuration ||= Configuration.new
-    yield(configuration)
+    # Configure the gem
+    def configure
+      yield(configuration)
+    end
+
+    # Reset configuration to defaults
+    def reset_configuration!
+      @configuration = Configuration.new
+    end
   end
 
   # Register a plugin
@@ -55,6 +78,33 @@ module RailsErrorDashboard
     PluginRegistry.plugins
   end
 
-  # Initialize with default configuration
-  self.configuration = Configuration.new
+  # Register a callback for when any error is logged
+  # @param block [Proc] The callback to execute, receives error_log as parameter
+  # @example
+  #   RailsErrorDashboard.on_error_logged do |error_log|
+  #     puts "Error logged: #{error_log.error_type}"
+  #   end
+  def self.on_error_logged(&block)
+    configuration.notification_callbacks[:error_logged] << block if block_given?
+  end
+
+  # Register a callback for when a critical error is logged
+  # @param block [Proc] The callback to execute, receives error_log as parameter
+  # @example
+  #   RailsErrorDashboard.on_critical_error do |error_log|
+  #     PagerDuty.trigger(error_log)
+  #   end
+  def self.on_critical_error(&block)
+    configuration.notification_callbacks[:critical_error] << block if block_given?
+  end
+
+  # Register a callback for when an error is resolved
+  # @param block [Proc] The callback to execute, receives error_log as parameter
+  # @example
+  #   RailsErrorDashboard.on_error_resolved do |error_log|
+  #     Slack.notify("Error #{error_log.id} resolved")
+  #   end
+  def self.on_error_resolved(&block)
+    configuration.notification_callbacks[:error_resolved] << block if block_given?
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails_error_dashboard
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.3
 platform: ruby
 authors:
 - Anjan Jagirdar
@@ -79,6 +79,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.21'
+- !ruby/object:Gem::Dependency
+  name: turbo-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
   requirement: !ruby/object:Gem::Requirement
@@ -225,10 +239,11 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.5'
-description: "⚠️ BETA: Rails Error Dashboard provides error tracking with a beautiful
-  UI, multi-channel notifications (Slack, Email, Discord, PagerDuty), platform detection
-  (iOS/Android/Web/API), analytics, and optional separate database support. Works
-  with Rails 7.0-8.0. API may change before v1.0.0."
+description: 'Own your errors. Own your stack. A fully open-source, self-hosted error
+  dashboard for solo founders, indie hackers, and small teams. Professional error
+  tracking with beautiful UI, multi-channel notifications (Slack, Email, Discord,
+  PagerDuty), platform detection (iOS/Android/Web/API), and analytics. 5-minute setup,
+  works out-of-the-box. Rails 7.0-8.1 compatible. ⚠️ BETA: API may change before v1.0.0.'
 email:
 - anjan.jagirdar@gmail.com
 executables: []
@@ -238,11 +253,22 @@ files:
 - MIT-LICENSE
 - README.md
 - Rakefile
+- app/assets/stylesheets/rails_error_dashboard/_catppuccin_mocha.scss
+- app/assets/stylesheets/rails_error_dashboard/_components.scss
+- app/assets/stylesheets/rails_error_dashboard/_layout.scss
+- app/assets/stylesheets/rails_error_dashboard/_theme_variables.scss
 - app/assets/stylesheets/rails_error_dashboard/application.css
+- app/assets/stylesheets/rails_error_dashboard/application.css.map
+- app/assets/stylesheets/rails_error_dashboard/application.scss
 - app/controllers/rails_error_dashboard/application_controller.rb
 - app/controllers/rails_error_dashboard/errors_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/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/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
@@ -250,23 +276,45 @@ files:
 - app/jobs/rails_error_dashboard/webhook_error_notification_job.rb
 - app/mailers/rails_error_dashboard/application_mailer.rb
 - app/mailers/rails_error_dashboard/error_notification_mailer.rb
-- app/models/rails_error_dashboard/application_record.rb
+- app/models/rails_error_dashboard/cascade_pattern.rb
+- app/models/rails_error_dashboard/error_baseline.rb
+- app/models/rails_error_dashboard/error_comment.rb
 - app/models/rails_error_dashboard/error_log.rb
 - app/models/rails_error_dashboard/error_logs_record.rb
+- app/models/rails_error_dashboard/error_occurrence.rb
 - app/views/layouts/rails_error_dashboard.html.erb
 - app/views/layouts/rails_error_dashboard/application.html.erb
+- app/views/layouts/rails_error_dashboard_old_backup.html.erb
 - app/views/rails_error_dashboard/error_notification_mailer/error_alert.html.erb
 - app/views/rails_error_dashboard/error_notification_mailer/error_alert.text.erb
+- app/views/rails_error_dashboard/errors/_error_row.html.erb
+- app/views/rails_error_dashboard/errors/_pattern_insights.html.erb
+- app/views/rails_error_dashboard/errors/_stats.html.erb
+- app/views/rails_error_dashboard/errors/_timeline.html.erb
 - app/views/rails_error_dashboard/errors/analytics.html.erb
+- app/views/rails_error_dashboard/errors/correlation.html.erb
 - app/views/rails_error_dashboard/errors/index.html.erb
+- 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/show.html.erb
 - config/routes.rb
 - db/migrate/20251224000001_create_rails_error_dashboard_error_logs.rb
 - db/migrate/20251224081522_add_better_tracking_to_error_logs.rb
 - db/migrate/20251224101217_add_controller_action_to_error_logs.rb
+- db/migrate/20251225071314_add_optimized_indexes_to_error_logs.rb
+- db/migrate/20251225074653_remove_environment_from_error_logs.rb
+- db/migrate/20251225085859_add_enhanced_metrics_to_error_logs.rb
+- db/migrate/20251225093603_add_similarity_tracking_to_error_logs.rb
+- db/migrate/20251225100236_create_error_occurrences.rb
+- db/migrate/20251225101920_create_cascade_patterns.rb
+- db/migrate/20251225102500_create_error_baselines.rb
+- db/migrate/20251226020000_add_workflow_fields_to_error_logs.rb
+- db/migrate/20251226020100_create_error_comments.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
+- lib/generators/rails_error_dashboard/solid_queue/solid_queue_generator.rb
+- lib/generators/rails_error_dashboard/solid_queue/templates/queue.yml
 - lib/rails_error_dashboard.rb
 - lib/rails_error_dashboard/commands/batch_delete_errors.rb
 - lib/rails_error_dashboard/commands/batch_resolve_errors.rb
@@ -275,6 +323,7 @@ files:
 - lib/rails_error_dashboard/configuration.rb
 - lib/rails_error_dashboard/engine.rb
 - lib/rails_error_dashboard/error_reporter.rb
+- lib/rails_error_dashboard/logger.rb
 - lib/rails_error_dashboard/middleware/error_catcher.rb
 - lib/rails_error_dashboard/plugin.rb
 - lib/rails_error_dashboard/plugin_registry.rb
@@ -282,15 +331,24 @@ files:
 - lib/rails_error_dashboard/plugins/jira_integration_plugin.rb
 - lib/rails_error_dashboard/plugins/metrics_plugin.rb
 - lib/rails_error_dashboard/queries/analytics_stats.rb
+- lib/rails_error_dashboard/queries/baseline_stats.rb
+- lib/rails_error_dashboard/queries/co_occurring_errors.rb
 - lib/rails_error_dashboard/queries/dashboard_stats.rb
-- lib/rails_error_dashboard/queries/developer_insights.rb
+- lib/rails_error_dashboard/queries/error_cascades.rb
+- lib/rails_error_dashboard/queries/error_correlation.rb
 - lib/rails_error_dashboard/queries/errors_list.rb
-- lib/rails_error_dashboard/queries/errors_list_v2.rb
 - lib/rails_error_dashboard/queries/filter_options.rb
+- lib/rails_error_dashboard/queries/platform_comparison.rb
+- lib/rails_error_dashboard/queries/similar_errors.rb
+- lib/rails_error_dashboard/services/backtrace_parser.rb
+- lib/rails_error_dashboard/services/baseline_alert_throttler.rb
+- lib/rails_error_dashboard/services/baseline_calculator.rb
+- lib/rails_error_dashboard/services/cascade_detector.rb
+- lib/rails_error_dashboard/services/pattern_detector.rb
 - lib/rails_error_dashboard/services/platform_detector.rb
+- lib/rails_error_dashboard/services/similarity_calculator.rb
 - lib/rails_error_dashboard/value_objects/error_context.rb
 - lib/rails_error_dashboard/version.rb
-- lib/tasks/rails_error_dashboard_tasks.rake
 homepage: https://github.com/AnjanJ/rails_error_dashboard
 licenses:
 - MIT
@@ -314,5 +372,6 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.7.2
 specification_version: 4
-summary: Beautiful error tracking dashboard for Rails applications (BETA)
+summary: Self-hosted Rails error monitoring — free, forever. Zero SaaS fees, zero
+  lock-in.
 test_files: []

data/app/models/rails_error_dashboard/application_record.rb

@@ -1,5 +0,0 @@
-module RailsErrorDashboard
-  class ApplicationRecord < ActiveRecord::Base
-    self.abstract_class = true
-  end
-end