rails-informant 0.0.1

data/lib/rails_informant/notifiers/slack.rb

@@ -0,0 +1,77 @@
+module RailsInformant
+  module Notifiers
+    class Slack
+      include NotificationPolicy
+
+      def notify(error_group, occurrence)
+        post_json \
+          url: RailsInformant.slack_webhook_url,
+          body: build_payload(error_group, occurrence),
+          label: "Slack webhook"
+      end
+
+      private
+
+      def regression?(error_group)
+        error_group.status == "unresolved" && error_group.fix_deployed_at.present?
+      end
+
+      def build_payload(error_group, occurrence)
+        regression_tag = regression?(error_group) ? " [REGRESSION]" : ""
+
+        {
+          blocks: [
+            {
+              type: "header",
+              text: {
+                type: "plain_text",
+                text: "#{error_group.error_class}#{regression_tag}",
+                emoji: true
+              }
+            },
+            {
+              type: "section",
+              fields: [
+                { type: "mrkdwn", text: "*Message:*\n#{error_group.message.to_s.truncate(200)}" },
+                { type: "mrkdwn", text: "*Status:*\n#{error_group.status}" },
+                { type: "mrkdwn", text: "*Occurrences:*\n#{error_group.total_occurrences}" },
+                { type: "mrkdwn", text: "*First seen:*\n#{error_group.first_seen_at&.iso8601}" }
+              ]
+            },
+            {
+              type: "section",
+              fields: [
+                location_field(error_group),
+                { type: "mrkdwn", text: "*Severity:*\n#{error_group.severity}" }
+              ].compact
+            },
+            context_block(occurrence)
+          ].compact
+        }
+      end
+
+      def location_field(error_group)
+        location = error_group.controller_action || error_group.job_class || error_group.first_backtrace_line
+        return unless location
+
+        { type: "mrkdwn", text: "*Location:*\n`#{location.to_s.truncate(100)}`" }
+      end
+
+      def context_block(occurrence)
+        return unless occurrence
+
+        elements = []
+        if occurrence.git_sha
+          elements << { type: "mrkdwn", text: "Deploy: `#{occurrence.git_sha[0, 7]}`" }
+        end
+        if occurrence.environment_context&.dig("hostname")
+          elements << { type: "mrkdwn", text: "Host: `#{occurrence.environment_context["hostname"]}`" }
+        end
+
+        return if elements.empty?
+
+        { type: "context", elements: elements }
+      end
+    end
+  end
+end

data/lib/rails_informant/notifiers/webhook.rb

@@ -0,0 +1,31 @@
+module RailsInformant
+  module Notifiers
+    class Webhook
+      include NotificationPolicy
+
+      def notify(error_group, occurrence)
+        post_json \
+          url: RailsInformant.webhook_url,
+          body: build_payload(error_group, occurrence),
+          label: "Webhook"
+      end
+
+      private
+
+      def build_payload(error_group, occurrence)
+        {
+          error_class: error_group.error_class,
+          fingerprint: error_group.fingerprint,
+          message: error_group.message,
+          severity: error_group.severity,
+          status: error_group.status,
+          total_occurrences: error_group.total_occurrences,
+          controller_action: error_group.controller_action,
+          job_class: error_group.job_class,
+          first_seen_at: error_group.first_seen_at&.iso8601,
+          last_seen_at: error_group.last_seen_at&.iso8601
+        }
+      end
+    end
+  end
+end

data/lib/rails_informant/structured_event_subscriber.rb

@@ -0,0 +1,14 @@
+module RailsInformant
+  class StructuredEventSubscriber
+    def emit(event)
+      return unless RailsInformant.initialized?
+
+      BreadcrumbBuffer.current.record(
+        category: event[:name],
+        message: event[:name],
+        metadata: event[:payload].is_a?(Hash) ? RailsInformant::ContextFilter.filter(event[:payload]) : {},
+        duration: nil
+      )
+    end
+  end
+end

data/lib/rails_informant/version.rb

@@ -0,0 +1,3 @@
+module RailsInformant
+  VERSION = File.read(File.expand_path("../../../VERSION", __FILE__)).strip
+end

data/lib/rails_informant.rb

@@ -0,0 +1,147 @@
+require "rails_informant/version"
+require "rails_informant/configuration"
+
+module RailsInformant
+  InvalidParameterError = Class.new(StandardError)
+  NotifierError = Class.new(StandardError)
+
+  IGNORED_EXCEPTIONS_DEFAULT = %w[
+    AbstractController::ActionNotFound
+    ActionController::BadRequest
+    ActionController::InvalidAuthenticityToken
+    ActionController::InvalidCrossOriginRequest
+    ActionController::MethodNotAllowed
+    ActionController::NotImplemented
+    ActionController::ParameterMissing
+    ActionController::RoutingError
+    ActionController::UnknownAction
+    ActionController::UnknownFormat
+    ActionController::UnknownHttpMethod
+    ActionController::UrlGenerationError
+    ActionDispatch::Http::MimeNegotiation::InvalidType
+    ActiveRecord::RecordNotFound
+    CGI::Session::CookieStore::TamperedWithCookie
+    Mime::Type::InvalidMimeType
+    Rack::QueryParser::InvalidParameterError
+    Rack::QueryParser::ParameterTypeError
+    Rack::Utils::InvalidParameterError
+    SignalException
+    SystemExit
+  ].freeze
+
+  GIT_SHA_SOURCES = %w[GIT_SHA REVISION KAMAL_VERSION].freeze
+
+  autoload :BreadcrumbBuffer, "rails_informant/breadcrumb_buffer"
+  autoload :BreadcrumbSubscriber, "rails_informant/breadcrumb_subscriber"
+  autoload :ContextBuilder, "rails_informant/context_builder"
+  autoload :ContextFilter, "rails_informant/context_filter"
+  autoload :Current, "rails_informant/current"
+  autoload :ErrorRecorder, "rails_informant/error_recorder"
+  autoload :ErrorSubscriber, "rails_informant/error_subscriber"
+  autoload :Fingerprint, "rails_informant/fingerprint"
+  autoload :StructuredEventSubscriber, "rails_informant/structured_event_subscriber"
+
+  module Middleware
+    autoload :ErrorCapture, "rails_informant/middleware/error_capture"
+    autoload :RescuedExceptionInterceptor, "rails_informant/middleware/rescued_exception_interceptor"
+  end
+
+  module Notifiers
+    autoload :Devin, "rails_informant/notifiers/devin"
+    autoload :NotificationPolicy, "rails_informant/notifiers/notification_policy"
+    autoload :Slack, "rails_informant/notifiers/slack"
+    autoload :Webhook, "rails_informant/notifiers/webhook"
+  end
+
+  mattr_accessor :config
+  self.config = Configuration.new
+
+  class << self
+    delegate :api_token,
+             :capture_errors,
+             :capture_user_email,
+             :devin_api_key,
+             :devin_playbook_id,
+             :ignored_exceptions,
+             :notifiers,
+             :retention_days,
+             :slack_webhook_url,
+             :webhook_url,
+             to: :config
+
+    def configure
+      yield config
+      reset_caches!
+    end
+
+    def reset_caches!
+      @_initialized = nil
+      @_ignored_set = nil
+      config.reset_notifiers!
+    end
+
+    def initialized?
+      return @_initialized if defined?(@_initialized) && @_initialized
+
+      @_initialized = capture_errors && defined?(ActiveRecord::Base) && ActiveRecord::Base.connection_pool.connected?
+    rescue ActiveRecord::ConnectionNotEstablished
+      false
+    end
+
+    def ignored_exception?(exception)
+      ignored = ignored_exception_set
+      exception.class.ancestors.each do |ancestor|
+        name = ancestor.name or next
+        return true if ignored.include?(name)
+      end
+      false
+    end
+
+    def current_git_sha
+      @_current_git_sha ||= resolve_git_sha
+    end
+
+    def already_captured?(error)
+      error.instance_variable_get(:@__rails_informant_captured)
+    end
+
+    def capture(exception, context: {}, request: nil)
+      return if already_captured?(exception)
+      mark_captured!(exception)
+      ErrorRecorder.record exception, severity: "error", context:, env: request&.env
+    end
+
+    def mark_captured!(error)
+      error.instance_variable_set(:@__rails_informant_captured, true) unless error.frozen?
+    end
+
+    def server_mode?
+      defined?(Rails::Server)
+    end
+
+    private
+
+    def ignored_exception_set
+      @_ignored_set ||= Set.new(IGNORED_EXCEPTIONS_DEFAULT + Array(ignored_exceptions)).freeze
+    end
+
+    def resolve_git_sha
+      GIT_SHA_SOURCES.each do |key|
+        return ENV[key] if ENV[key].present?
+      end
+
+      head = Rails.root.join(".git", "HEAD").read.strip
+      if head.start_with?("ref: ")
+        ref = head.delete_prefix("ref: ")
+        raise ArgumentError if ref.include?("..") # path traversal guard
+        Rails.root.join(".git", ref).read.strip
+      else
+        head
+      end
+    rescue Errno::ENOENT, Errno::EACCES, ArgumentError
+      nil
+    end
+  end
+end
+
+require "rails_informant/engine"

data/lib/tasks/rails_informant.rake

@@ -0,0 +1,30 @@
+namespace :informant do
+  desc "Purge resolved errors older than retention_days"
+  task purge: :environment do
+    RailsInformant::PurgeJob.perform_now
+    puts "Purge complete"
+  end
+
+  desc "Show error monitoring statistics"
+  task stats: :environment do
+    groups = RailsInformant::ErrorGroup
+    total = groups.count
+    unresolved = groups.where(status: "unresolved").count
+    fix_pending = groups.where(status: "fix_pending").count
+    resolved = groups.where(status: "resolved").count
+    ignored = groups.where(status: "ignored").count
+    duplicates = groups.where(status: "duplicate").count
+    occurrences = RailsInformant::Occurrence.count
+
+    puts "Rails Informant Statistics"
+    puts "-" * 30
+    puts "Error groups:    #{total}"
+    puts "  Unresolved:    #{unresolved}"
+    puts "  Fix pending:   #{fix_pending}"
+    puts "  Resolved:      #{resolved}"
+    puts "  Ignored:       #{ignored}"
+    puts "  Duplicates:    #{duplicates}"
+    puts "Occurrences:     #{occurrences}"
+    puts "Deploy SHA:      #{RailsInformant.current_git_sha || 'unknown'}"
+  end
+end

metadata

@@ -0,0 +1,177 @@
+--- !ruby/object:Gem::Specification
+name: rails-informant
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Daniel López Prat
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: actionpack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '8.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '8.1'
+- !ruby/object:Gem::Dependency
+  name: activejob
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '8.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '8.1'
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '8.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '8.1'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '8.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '8.1'
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '8.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '8.1'
+description: Rails Engine that captures exceptions, stores them in your database with
+  rich context, and exposes error data via a bundled MCP server so AI agents can triage,
+  resolve, and fix errors autonomously.
+email:
+- daniel@6temes.cat
+executables:
+- informant-mcp
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- Rakefile
+- VERSION
+- app/controllers/rails_informant/api/base_controller.rb
+- app/controllers/rails_informant/api/errors_controller.rb
+- app/controllers/rails_informant/api/occurrences_controller.rb
+- app/controllers/rails_informant/api/status_controller.rb
+- app/jobs/rails_informant/application_job.rb
+- app/jobs/rails_informant/notify_job.rb
+- app/jobs/rails_informant/purge_job.rb
+- app/models/rails_informant/application_record.rb
+- app/models/rails_informant/error_group.rb
+- app/models/rails_informant/occurrence.rb
+- config/routes.rb
+- db/migrate/20260227000000_create_informant_tables.rb
+- exe/informant-mcp
+- lib/generators/rails_informant/devin/templates/error-triage.devin.md
+- lib/generators/rails_informant/devin_generator.rb
+- lib/generators/rails_informant/install_generator.rb
+- lib/generators/rails_informant/skill/templates/SKILL.md
+- lib/generators/rails_informant/skill_generator.rb
+- lib/generators/rails_informant/templates/create_informant_tables.rb.erb
+- lib/generators/rails_informant/templates/initializer.rb.erb
+- lib/rails_informant.rb
+- lib/rails_informant/breadcrumb_buffer.rb
+- lib/rails_informant/breadcrumb_subscriber.rb
+- lib/rails_informant/configuration.rb
+- lib/rails_informant/context_builder.rb
+- lib/rails_informant/context_filter.rb
+- lib/rails_informant/current.rb
+- lib/rails_informant/engine.rb
+- lib/rails_informant/error_recorder.rb
+- lib/rails_informant/error_subscriber.rb
+- lib/rails_informant/fingerprint.rb
+- lib/rails_informant/mcp.rb
+- lib/rails_informant/mcp/base_tool.rb
+- lib/rails_informant/mcp/client.rb
+- lib/rails_informant/mcp/configuration.rb
+- lib/rails_informant/mcp/server.rb
+- lib/rails_informant/mcp/tools/annotate_error.rb
+- lib/rails_informant/mcp/tools/delete_error.rb
+- lib/rails_informant/mcp/tools/get_error.rb
+- lib/rails_informant/mcp/tools/get_informant_status.rb
+- lib/rails_informant/mcp/tools/ignore_error.rb
+- lib/rails_informant/mcp/tools/list_environments.rb
+- lib/rails_informant/mcp/tools/list_errors.rb
+- lib/rails_informant/mcp/tools/list_occurrences.rb
+- lib/rails_informant/mcp/tools/mark_duplicate.rb
+- lib/rails_informant/mcp/tools/mark_fix_pending.rb
+- lib/rails_informant/mcp/tools/reopen_error.rb
+- lib/rails_informant/mcp/tools/resolve_error.rb
+- lib/rails_informant/middleware/error_capture.rb
+- lib/rails_informant/middleware/rescued_exception_interceptor.rb
+- lib/rails_informant/notifiers/devin.rb
+- lib/rails_informant/notifiers/notification_policy.rb
+- lib/rails_informant/notifiers/slack.rb
+- lib/rails_informant/notifiers/webhook.rb
+- lib/rails_informant/structured_event_subscriber.rb
+- lib/rails_informant/version.rb
+- lib/tasks/rails_informant.rake
+homepage: https://github.com/6temes/rails-informant
+licenses:
+- MIT
+metadata:
+  bug_tracker_uri: https://github.com/6temes/rails-informant/issues
+  rubygems_mfa_required: 'true'
+  source_code_uri: https://github.com/6temes/rails-informant
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '4.0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.6
+specification_version: 4
+summary: Self-hosted error monitoring for Rails with MCP server for agentic workflows
+test_files: []