raises 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: bf7a8c31ce5ed40e110b57671dee77d76cc712059ba386c64fed29f3e9da31ad
+  data.tar.gz: 12e7e56ce32e4c3cbeea11912f7de8e765ee0cf44636a99bd963e8b2796c510f
+SHA512:
+  metadata.gz: 3ca5937ee49e66bafd8c7dc6d25ca55999d35ebc2f336f75d9206f3a1dccc4570b70c62f4d3169021b305d790941586df216ade5d4257c090b8c9223b09a7f1f
+  data.tar.gz: 95e0bac19718d9f1f0ab67856425c31180f7207c72e0e2fc1cb64d0727c3c446a1cf7dcbaf9adfa33c7c00f8c446b64f7563d58a1cb70af899008b1d90cb256f

data/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+## 0.1.0
+
+- Initial Rails 7.1+ `Rails.error` subscriber.
+- Project-scoped ingestion authentication.
+- Filtered request metadata and revision reporting.

data/LICENSE.txt

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 Clayton Lengel-Zigich
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,13 @@
+# raises
+
+The Rails client for [Raises](https://raises.dev), error reporting operated by coding agents.
+
+```ruby
+gem "raises"
+```
+
+Set `RAISES_TOKEN` to the ingestion credential created for the project. Production errors are reported to `https://raises.dev` automatically through `Rails.error`. Set `RAISES_REPORT=1` to exercise the integration outside production.
+
+Optional settings are `RAISES_URL`, `RAISES_ENV`, `RAISES_REVISION`, `RAISES_OPEN_TIMEOUT`, and `RAISES_READ_TIMEOUT`.
+
+The reporter fails open: network or serialization failures never replace the application exception. Rails filtered parameters are included; headers, raw bodies, query strings, and the request object are not.

data/lib/raises/railtie.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Raises
+  class Railtie < Rails::Railtie
+    initializer "raises.subscribe" do
+      Rails.error.subscribe(Raises::Subscriber.new)
+    end
+  end
+end

data/lib/raises/subscriber.rb

@@ -0,0 +1,139 @@
+# frozen_string_literal: true
+
+require "json"
+require "net/http"
+require "uri"
+
+module Raises
+  class Subscriber
+    def report(error, handled:, severity:, context:, source: nil)
+      return unless report?
+
+      notice = {
+        env: env_name,
+        revision: revision,
+        handled: handled,
+        error: {
+          class: error.class.name,
+          message: error.message.to_s,
+          backtrace: Array(error.backtrace)
+        },
+        context: json_safe(context_without_request(context).merge(severity: severity.to_s, source: source)),
+        request: request_from(context)
+      }
+
+      post(notice)
+    rescue StandardError => e
+      warn("raises subscriber failed: #{e.class}: #{e.message}")
+    end
+
+    private
+
+    def report?
+      return false if url.to_s.empty? || token.to_s.empty?
+      return true if ENV["RAISES_REPORT"] == "1"
+
+      env_name == "production"
+    end
+
+    def url
+      ENV.fetch("RAISES_URL", "https://raises.dev")
+    end
+
+    def token
+      ENV["RAISES_TOKEN"].to_s
+    end
+
+    def env_name
+      ENV["RAISES_ENV"].to_s.then { |value| value.empty? ? nil : value } ||
+        (defined?(Rails) ? Rails.env.to_s : "production")
+    end
+
+    def revision
+      first_present(ENV.fetch("RAISES_REVISION", nil), ENV.fetch("KAMAL_VERSION", nil), git_revision)
+    end
+
+    def first_present(*values)
+      values.find { |value| !value.to_s.empty? }
+    end
+
+    def git_revision
+      return unless defined?(Rails)
+
+      path = Rails.root.join("REVISION")
+      path.read.strip if path.exist?
+    rescue StandardError
+      nil
+    end
+
+    def request_from(context)
+      req = context[:request] || context["request"]
+      return unless req.respond_to?(:method) && req.respond_to?(:original_url)
+
+      json_safe(
+        method: req.method,
+        path: filtered_path(req),
+        params: req.respond_to?(:filtered_parameters) ? req.filtered_parameters : nil
+      )
+    end
+
+    def context_without_request(context)
+      return {} unless context.respond_to?(:each)
+
+      context.each_with_object({}) do |(key, value), clean|
+        clean[key] = value unless key.to_s == "request"
+      end
+    end
+
+    def filtered_path(request)
+      return request.filtered_path if request.respond_to?(:filtered_path)
+
+      uri = URI(request.original_url)
+      uri.path.to_s.empty? ? "/" : uri.path
+    rescue URI::InvalidURIError
+      "/"
+    end
+
+    def json_safe(value)
+      JSON.parse(JSON.generate(as_jsonable(value)))
+    rescue StandardError
+      { "unserializable" => value.class.name }
+    end
+
+    def as_jsonable(value)
+      case value
+      when Hash
+        value.each_with_object({}) { |(k, v), acc| acc[k.to_s] = as_jsonable(v) }
+      when Array
+        value.map { |item| as_jsonable(item) }
+      when Numeric, TrueClass, FalseClass, NilClass
+        value
+      else
+        value.to_s
+      end
+    end
+
+    def post(notice)
+      uri = URI.join(url.end_with?("/") ? url : "#{url}/", "v1/notices")
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = uri.scheme == "https"
+      http.open_timeout = timeout("RAISES_OPEN_TIMEOUT", 1)
+      http.read_timeout = timeout("RAISES_READ_TIMEOUT", 2)
+      request = Net::HTTP::Post.new(uri.request_uri)
+      request["Authorization"] = "Bearer #{token}"
+      request["Content-Type"] = "application/json"
+      request["User-Agent"] = "raises-ruby/#{Raises::VERSION}"
+      request.body = JSON.generate(notice)
+      response = http.request(request)
+      warn("raises rejected notice: HTTP #{response.code}") unless response.is_a?(Net::HTTPSuccess)
+      response
+    end
+
+    def timeout(name, fallback)
+      value = Float(ENV.fetch(name, fallback.to_s))
+      value.positive? && value <= 30 ? value : fallback
+    rescue ArgumentError
+      fallback
+    end
+  end
+end

data/lib/raises/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Raises
+  VERSION = "0.1.0"
+end

data/lib/raises.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require "raises/version"
+require "raises/subscriber"
+require "raises/railtie" if defined?(Rails::Railtie)
+
+module Raises
+end

metadata

@@ -0,0 +1,64 @@
+--- !ruby/object:Gem::Specification
+name: raises
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Clayton Lengel-Zigich
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+description: A Rails.error subscriber for the agent-operated Raises exception inbox.
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- lib/raises.rb
+- lib/raises/railtie.rb
+- lib/raises/subscriber.rb
+- lib/raises/version.rb
+homepage: https://raises.dev
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://raises.dev
+  source_code_uri: https://github.com/clayton/raises
+  changelog_uri: https://github.com/clayton/raises/blob/master/gem/CHANGELOG.md
+  bug_tracker_uri: https://github.com/clayton/raises/issues
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.10
+specification_version: 4
+summary: Rails.error subscriber that reports exceptions to a raises inbox
+test_files: []