rails_error_dashboard 0.1.28 → 0.1.30

data/lib/rails_error_dashboard/services/source_code_reader.rb

@@ -0,0 +1,214 @@
+# frozen_string_literal: true
+
+module RailsErrorDashboard
+  module Services
+    # Reads source code files from disk with security validation
+    # and context lines around a target line number
+    #
+    # @example
+    #   reader = SourceCodeReader.new("/path/to/app/models/user.rb", 42)
+    #   lines = reader.read_lines(context: 5)
+    #   # Returns array of hashes with line numbers and content
+    class SourceCodeReader
+      MAX_FILE_SIZE = 10 * 1024 * 1024 # 10 MB
+      MAX_CONTEXT_LINES = 50
+
+      attr_reader :file_path, :line_number, :error
+
+      # Initialize a new source code reader
+      #
+      # @param file_path [String] Path to the source file
+      # @param line_number [Integer] Target line number
+      def initialize(file_path, line_number)
+        @file_path = file_path
+        @line_number = line_number.to_i
+        @error = nil
+      end
+
+      # Read source code lines with context around the target line
+      #
+      # @param context [Integer] Number of lines before and after target line
+      # @return [Array<Hash>, nil] Array of line data hashes or nil if unavailable
+      def read_lines(context: 5)
+        context = [ [ context, MAX_CONTEXT_LINES ].min, 1 ].max
+
+        # Validate and resolve path
+        absolute_path = resolve_absolute_path
+        return nil unless absolute_path
+
+        # Validate path is safe
+        unless validate_path!(absolute_path)
+          @error = "Invalid or unsafe file path"
+          return nil
+        end
+
+        # Check file exists and is readable
+        unless File.exist?(absolute_path) && File.readable?(absolute_path)
+          @error = "File not found or not readable"
+          return nil
+        end
+
+        # Check file size
+        file_size = File.size(absolute_path)
+        if file_size > MAX_FILE_SIZE
+          @error = "File too large (#{file_size} bytes, max #{MAX_FILE_SIZE})"
+          return nil
+        end
+
+        # Check if file is binary
+        if binary_file?(absolute_path)
+          @error = "Binary file cannot be displayed"
+          return nil
+        end
+
+        # Read the specific lines
+        read_specific_lines(absolute_path, line_number - context, line_number + context)
+      rescue StandardError => e
+        @error = "Error reading file: #{e.message}"
+        RailsErrorDashboard::Logger.error("SourceCodeReader error for #{file_path}:#{line_number} - #{e.message}")
+        nil
+      end
+
+      # Check if file exists on disk
+      #
+      # @return [Boolean]
+      def file_exists?
+        absolute_path = resolve_absolute_path
+        return false unless absolute_path
+
+        File.exist?(absolute_path) && File.readable?(absolute_path)
+      rescue StandardError
+        false
+      end
+
+      private
+
+      # Resolve file path to absolute path within Rails.root
+      #
+      # @return [String, nil] Absolute path or nil if invalid
+      def resolve_absolute_path
+        return nil if file_path.blank?
+
+        # Handle relative paths from backtrace
+        if file_path.start_with?(Rails.root.to_s)
+          # Already absolute
+          file_path
+        elsif file_path.start_with?("/")
+          # Absolute but might be from different root (deployed location)
+          # Try to find relative to Rails.root
+          relative = file_path.sub(%r{^.*/}, "")
+          File.join(Rails.root, relative)
+        else
+          # Relative path
+          File.join(Rails.root, file_path)
+        end
+      end
+
+      # Validate path is safe to read (security check)
+      #
+      # @param path [String] Absolute path to validate
+      # @return [Boolean]
+      # @raise [SecurityError] if path is unsafe
+      def validate_path!(path)
+        # Normalize path
+        normalized = File.expand_path(path)
+        rails_root = File.expand_path(Rails.root)
+
+        # Must be within Rails.root
+        unless normalized.start_with?(rails_root)
+          RailsErrorDashboard::Logger.warn("Path outside Rails.root: #{normalized}")
+          return false
+        end
+
+        # Prevent directory traversal
+        if path.include?("..") || normalized.include?("..")
+          RailsErrorDashboard::Logger.warn("Directory traversal attempt: #{path}")
+          return false
+        end
+
+        # Check against sensitive file patterns
+        sensitive_patterns = [
+          /\.env/i,
+          /secrets\.yml$/i,
+          /credentials\.yml/i,
+          /database\.yml$/i,
+          /master\.key$/i,
+          /private_key/i,
+          /\.pem$/i,
+          /\.key$/i
+        ]
+
+        if sensitive_patterns.any? { |pattern| normalized.match?(pattern) }
+          RailsErrorDashboard::Logger.warn("Attempt to read sensitive file: #{normalized}")
+          return false
+        end
+
+        # Only show app code if configured
+        if RailsErrorDashboard.configuration.only_show_app_code_source
+          # Block gem/vendor code
+          blocked_patterns = [
+            %r{/gems/},
+            %r{/vendor/bundle/},
+            %r{/vendor/ruby/},
+            %r{/.bundle/}
+          ]
+
+          if blocked_patterns.any? { |pattern| normalized.match?(pattern) }
+            RailsErrorDashboard::Logger.debug("Skipping gem/vendor code: #{normalized}")
+            return false
+          end
+        end
+
+        true
+      end
+
+      # Read specific lines from file
+      #
+      # @param file_path [String] Path to file
+      # @param start_line [Integer] First line to read (1-indexed)
+      # @param end_line [Integer] Last line to read (1-indexed)
+      # @return [Array<Hash>] Array of line data
+      def read_specific_lines(file_path, start_line, end_line)
+        start_line = [ start_line, 1 ].max
+        lines = []
+
+        File.open(file_path, "r") do |file|
+          file.each_line.with_index(1) do |line, line_num|
+            break if line_num > end_line
+
+            next if line_num < start_line
+
+            lines << {
+              number: line_num,
+              content: line.chomp,
+              highlight: line_num == @line_number
+            }
+          end
+        end
+
+        lines
+      rescue StandardError => e
+        RailsErrorDashboard::Logger.error("Error reading specific lines from #{file_path}: #{e.message}")
+        []
+      end
+
+      # Check if file is binary
+      #
+      # @param file_path [String] Path to file
+      # @return [Boolean]
+      def binary_file?(file_path)
+        # Read first 8KB to check for null bytes
+        sample_size = 8192
+        File.open(file_path, "rb") do |file|
+          sample = file.read(sample_size)
+          return false if sample.nil? || sample.empty?
+
+          # Binary files typically contain null bytes
+          sample.include?("\x00")
+        end
+      rescue StandardError
+        false # If we can't determine, assume text
+      end
+    end
+  end
+end

data/lib/rails_error_dashboard/version.rb

@@ -1,3 +1,3 @@
 module RailsErrorDashboard
-  VERSION = "0.1.28"
+  VERSION = "0.1.30"
 end

data/lib/rails_error_dashboard.rb

@@ -1,5 +1,6 @@
 require "rails_error_dashboard/version"
 require "rails_error_dashboard/engine"
+require "rails_error_dashboard/configuration_error"
 require "rails_error_dashboard/configuration"
 require "rails_error_dashboard/logger"
 require "rails_error_dashboard/manual_error_reporter"
@@ -16,6 +17,7 @@ require "turbo-rails"
 
 # Core library files
 require "rails_error_dashboard/value_objects/error_context"
+require "rails_error_dashboard/helpers/user_model_detector"
 require "rails_error_dashboard/services/platform_detector"
 require "rails_error_dashboard/services/backtrace_parser"
 require "rails_error_dashboard/services/similarity_calculator"
@@ -23,6 +25,10 @@ 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/services/error_normalizer"
+require "rails_error_dashboard/services/source_code_reader"
+require "rails_error_dashboard/services/git_blame_reader"
+require "rails_error_dashboard/services/github_link_generator"
 require "rails_error_dashboard/queries/co_occurring_errors"
 require "rails_error_dashboard/queries/error_cascades"
 require "rails_error_dashboard/queries/baseline_stats"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails_error_dashboard
 version: !ruby/object:Gem::Version
-  version: 0.1.28
+  version: 0.1.30
 platform: ruby
 authors:
 - Anjan Jagirdar
@@ -267,13 +267,6 @@ 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
@@ -298,22 +291,25 @@ files:
 - 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/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/_source_code.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/_user_errors_table.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/settings.html.erb
+- app/views/rails_error_dashboard/errors/settings/_value_badge.html.erb
 - app/views/rails_error_dashboard/errors/show.html.erb
 - config/routes.rb
 - db/development.sqlite3
+- db/migrate/20251223000000_create_rails_error_dashboard_complete_schema.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
@@ -344,8 +340,10 @@ files:
 - lib/rails_error_dashboard/commands/log_error.rb
 - lib/rails_error_dashboard/commands/resolve_error.rb
 - lib/rails_error_dashboard/configuration.rb
+- lib/rails_error_dashboard/configuration_error.rb
 - lib/rails_error_dashboard/engine.rb
 - lib/rails_error_dashboard/error_reporter.rb
+- lib/rails_error_dashboard/helpers/user_model_detector.rb
 - lib/rails_error_dashboard/logger.rb
 - lib/rails_error_dashboard/manual_error_reporter.rb
 - lib/rails_error_dashboard/middleware/error_catcher.rb
@@ -371,9 +369,13 @@ files:
 - 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/error_normalizer.rb
+- lib/rails_error_dashboard/services/git_blame_reader.rb
+- lib/rails_error_dashboard/services/github_link_generator.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/services/source_code_reader.rb
 - lib/rails_error_dashboard/value_objects/error_context.rb
 - lib/rails_error_dashboard/version.rb
 - lib/tasks/error_dashboard.rake
@@ -385,8 +387,10 @@ metadata:
   homepage_uri: https://github.com/AnjanJ/rails_error_dashboard
   source_code_uri: https://github.com/AnjanJ/rails_error_dashboard
   changelog_uri: https://github.com/AnjanJ/rails_error_dashboard/blob/main/CHANGELOG.md
+  documentation_uri: https://rails-error-dashboard.anjan.dev
+  demo_uri: https://rails-error-dashboard.anjan.dev
 post_install_message: "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n
-  \ Rails Error Dashboard v0.1.28\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n\n\U0001F195
+  \ Rails Error Dashboard v0.1.30\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

data/app/assets/stylesheets/rails_error_dashboard/_catppuccin_mocha.scss

@@ -1,107 +0,0 @@
-// =============================================================================
-// Catppuccin Mocha Theme - Color Palette
-// =============================================================================
-// Official Catppuccin color palette for the Mocha flavor (dark theme)
-// https://github.com/catppuccin/catppuccin
-//
-// This file defines both SCSS variables and CSS custom properties for
-// maximum flexibility in styling components.
-// =============================================================================
-
-// -----------------------------------------------------------------------------
-// SCSS Variables - Accent Colors
-// -----------------------------------------------------------------------------
-// Use these for compile-time color calculations and SCSS functions
-
-$ctp-rosewater: #f5e0dc !default;  // Soft highlights, subtle accents
-$ctp-flamingo:  #f2cdcd !default;  // Gentle warnings, soft alerts
-$ctp-pink:      #f5c2e7 !default;  // Playful accents, decorative
-$ctp-mauve:     #cba6f7 !default;  // Primary brand color, links
-$ctp-red:       #f38ba8 !default;  // Errors, critical states
-$ctp-maroon:    #eba0ac !default;  // Secondary errors, warnings
-$ctp-peach:     #fab387 !default;  // Warnings, cautionary states
-$ctp-yellow:    #f9e2af !default;  // Highlights, important info
-$ctp-green:     #a6e3a1 !default;  // Success, positive states
-$ctp-teal:      #94e2d5 !default;  // Info, neutral positive
-$ctp-sky:       #89dceb !default;  // Links, interactive elements
-$ctp-sapphire:  #74c7ec !default;  // Accents, decorative
-$ctp-blue:      #89b4fa !default;  // Info, primary actions
-$ctp-lavender:  #b4befe !default;  // Soft accents, highlights
-
-// -----------------------------------------------------------------------------
-// SCSS Variables - Neutral Colors
-// -----------------------------------------------------------------------------
-// Background and text colors for UI structure
-
-$ctp-text:      #cdd6f4 !default;  // Primary text
-$ctp-subtext1:  #bac2de !default;  // Secondary text
-$ctp-subtext0:  #a6adc8 !default;  // Tertiary text, muted
-$ctp-overlay2:  #9399b2 !default;  // Hover states, highlights
-$ctp-overlay1:  #7f849c !default;  // Subtle backgrounds
-$ctp-overlay0:  #6c7086 !default;  // Muted elements, disabled
-$ctp-surface2:  #585b70 !default;  // Secondary surfaces
-$ctp-surface1:  #45475a !default;  // Interactive elements
-$ctp-surface0:  #313244 !default;  // Component backgrounds (cards)
-$ctp-base:      #1e1e2e !default;  // Main background
-$ctp-mantle:    #181825 !default;  // Alternate background
-$ctp-crust:     #11111b !default;  // Borders, edges
-
-// -----------------------------------------------------------------------------
-// CSS Custom Properties (CSS Variables)
-// -----------------------------------------------------------------------------
-// These can be changed at runtime and accessed from JavaScript
-// Use these for theme switching and dynamic styling
-
-:root {
-  // Accent colors as CSS variables
-  --ctp-rosewater: #{$ctp-rosewater};
-  --ctp-flamingo:  #{$ctp-flamingo};
-  --ctp-pink:      #{$ctp-pink};
-  --ctp-mauve:     #{$ctp-mauve};
-  --ctp-red:       #{$ctp-red};
-  --ctp-maroon:    #{$ctp-maroon};
-  --ctp-peach:     #{$ctp-peach};
-  --ctp-yellow:    #{$ctp-yellow};
-  --ctp-green:     #{$ctp-green};
-  --ctp-teal:      #{$ctp-teal};
-  --ctp-sky:       #{$ctp-sky};
-  --ctp-sapphire:  #{$ctp-sapphire};
-  --ctp-blue:      #{$ctp-blue};
-  --ctp-lavender:  #{$ctp-lavender};
-
-  // Neutral colors as CSS variables
-  --ctp-text:      #{$ctp-text};
-  --ctp-subtext1:  #{$ctp-subtext1};
-  --ctp-subtext0:  #{$ctp-subtext0};
-  --ctp-overlay2:  #{$ctp-overlay2};
-  --ctp-overlay1:  #{$ctp-overlay1};
-  --ctp-overlay0:  #{$ctp-overlay0};
-  --ctp-surface2:  #{$ctp-surface2};
-  --ctp-surface1:  #{$ctp-surface1};
-  --ctp-surface0:  #{$ctp-surface0};
-  --ctp-base:      #{$ctp-base};
-  --ctp-mantle:    #{$ctp-mantle};
-  --ctp-crust:     #{$ctp-crust};
-}
-
-// -----------------------------------------------------------------------------
-// Utility Functions
-// -----------------------------------------------------------------------------
-
-// Add opacity to a Catppuccin color
-// Usage: background-color: ctp-opacity($ctp-red, 0.1);
-@function ctp-opacity($color, $opacity) {
-  @return rgba($color, $opacity);
-}
-
-// Lighten a Catppuccin color (for hover states)
-// Usage: background-color: ctp-lighten($ctp-mauve, 10%);
-@function ctp-lighten($color, $amount) {
-  @return lighten($color, $amount);
-}
-
-// Darken a Catppuccin color (for active states)
-// Usage: background-color: ctp-darken($ctp-mauve, 10%);
-@function ctp-darken($color, $amount) {
-  @return darken($color, $amount);
-}