bugsage 0.2.0

data/lib/bugsage/store.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+require "time"
+
+module Bugsage
+  class Store
+    MAX_ENTRIES = 100
+
+    def self.add(suggestion, context = {}, metadata = {})
+      event = build_event(suggestion, context, metadata)
+      entries.unshift(event)
+      entries.pop if entries.size > MAX_ENTRIES
+    end
+
+    def self.all
+      entries
+    end
+
+    def self.clear!
+      @entries = []
+    end
+
+    def self.entries
+      @entries ||= []
+    end
+
+    def self.update_at(index, suggestion, ai_error: nil)
+      event = entries[index]
+      return unless event
+
+      event[:root_cause] = suggestion.root_cause
+      event[:fixes] = suggestion.fixes
+      event[:confidence] = suggestion.confidence
+      event[:source] = suggestion.source
+      event[:ai_notes] = suggestion.ai_notes
+      event[:code_patch] = suggestion.code_patch
+      event[:ai_error] = ai_error
+    end
+
+    def self.build_event(suggestion, context, metadata = {})
+      exception = metadata[:exception]
+
+      {
+        issue: suggestion.issue,
+        location: suggestion.location,
+        root_cause: suggestion.root_cause,
+        fixes: suggestion.fixes,
+        confidence: suggestion.confidence,
+        source: suggestion.source,
+        ai_notes: suggestion.ai_notes,
+        code_patch: suggestion.code_patch,
+        ai_error: metadata[:ai_error],
+        exception_class: exception&.class&.name,
+        exception_message: exception&.message.to_s,
+        context: context,
+        timestamp: Time.now.utc.iso8601
+      }
+    end
+  end
+end

data/lib/bugsage/suggestion.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+module Bugsage
+  class Suggestion
+    SOURCES = %i[rules ai hybrid].freeze
+
+    attr_reader :issue, :location, :root_cause, :fixes, :confidence, :source, :ai_notes, :code_patch
+
+    def initialize(issue:, location:, root_cause:, fixes:, confidence:, source: :rules, ai_notes: nil, code_patch: nil,
+                   code_fix: nil)
+      @issue = issue
+      @location = location
+      @root_cause = root_cause
+      @fixes = fixes
+      @confidence = confidence
+      @source = normalize_source(source)
+      @ai_notes = ai_notes
+      @code_patch = normalize_code_patch(code_patch, code_fix)
+    end
+
+    def code_fix
+      CodePatch.preview_for(@code_patch)
+    end
+
+    def ai_enhanced?
+      %i[hybrid ai].include?(source)
+    end
+
+    def with_ai_enhancement(root_cause:, fixes:, confidence:, ai_notes: nil, code_patch: nil)
+      self.class.new(
+        issue: issue,
+        location: location,
+        root_cause: root_cause,
+        fixes: fixes,
+        confidence: confidence,
+        source: :hybrid,
+        ai_notes: ai_notes,
+        code_patch: code_patch || @code_patch
+      )
+    end
+
+    private
+
+    def normalize_source(source)
+      symbol = source.to_sym
+      SOURCES.include?(symbol) ? symbol : :rules
+    end
+
+    def normalize_code_patch(code_patch, legacy_code_fix)
+      return code_patch if code_patch.is_a?(Hash) && !code_patch.empty?
+      return nil if legacy_code_fix.to_s.strip.empty?
+
+      _, line_number = CodeContext.extract_location(location)
+      legacy = CodePatch.from_legacy(legacy_code_fix, line_number || 1)
+      legacy&.to_h
+    end
+  end
+end

data/lib/bugsage/trace_cleaner.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module Bugsage
+  class TraceCleaner
+    FRAMEWORK_PATTERNS = [
+      %r{/gems/},
+      %r{/ruby/\d}
+    ].freeze
+
+    def self.clean(backtrace)
+      return [] unless backtrace
+
+      backtrace.reject { |line| framework_line?(line) }
+    end
+
+    def self.first_application_frame(backtrace)
+      clean(backtrace).first
+    end
+
+    def self.framework_line?(line)
+      FRAMEWORK_PATTERNS.any? { |pattern| line.match?(pattern) }
+    end
+  end
+end

data/lib/bugsage/translations.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+require "yaml"
+
+module Bugsage
+  module Translations
+    LOCALE_DIR = File.expand_path("locales", __dir__)
+
+    module_function
+
+    def load!
+      return if @loaded
+
+      paths = Dir[File.join(LOCALE_DIR, "*.yml")]
+      if defined?(::I18n)
+        ::I18n.load_path |= paths
+      else
+        @fallback_translations = {}
+        paths.each do |path|
+          data = YAML.safe_load_file(path, aliases: true)
+          deep_merge!(@fallback_translations, data)
+        end
+      end
+
+      @loaded = true
+    end
+
+    def t(key, **)
+      load!
+      full_key = key.to_s.start_with?("bugsage.") ? key : "bugsage.#{key}"
+
+      if defined?(::I18n)
+        ::I18n.t(full_key, **)
+      else
+        translate_fallback(full_key, **)
+      end
+    end
+
+    def translate_fallback(key, **options)
+      keys = key.split(".")
+      value = dig_fallback(keys)
+      return options[:default] if value.nil? && options.key?(:default)
+
+      case value
+      when Array
+        value
+      when String
+        interpolate(value, options)
+      else
+        options.fetch(:default, missing_translation(key))
+      end
+    end
+
+    def dig_fallback(keys)
+      locale = @fallback_translations["en"] || @fallback_translations[:en] || {}
+      keys.reduce(locale) do |node, segment|
+        break nil unless node.is_a?(Hash)
+
+        node[segment] || node[segment.to_sym]
+      end
+    end
+
+    def deep_merge!(base, other)
+      other.each do |key, value|
+        key = key.to_s
+        if base[key].is_a?(Hash) && value.is_a?(Hash)
+          deep_merge!(base[key], value)
+        else
+          base[key] = value
+        end
+      end
+    end
+
+    def interpolate(string, options)
+      string.gsub(/%\{(\w+)\}/) do
+        symbol = Regexp.last_match(1).to_sym
+        options.key?(symbol) ? options[symbol].to_s : "%{#{symbol}}"
+      end
+    end
+
+    def missing_translation(key)
+      key
+    end
+  end
+end

data/lib/bugsage/version.rb

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

data/lib/bugsage.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+require_relative "bugsage/version"
+require_relative "bugsage/configuration"
+require_relative "bugsage/suggestion"
+require_relative "bugsage/trace_cleaner"
+require_relative "bugsage/exception_support"
+require_relative "bugsage/http_response_error"
+require_relative "bugsage/http_error_capture"
+require_relative "bugsage/code_context"
+require_relative "bugsage/rule"
+require_relative "bugsage/json_endpoint"
+require_relative "bugsage/request_context"
+require_relative "bugsage/ai_support"
+require_relative "bugsage/openai_client"
+require_relative "bugsage/cursor_client"
+require_relative "bugsage/ai_analyzer"
+require_relative "bugsage/formatter"
+require_relative "bugsage/store"
+require_relative "bugsage/console_context"
+require_relative "bugsage/ai_context"
+require_relative "bugsage/inline_console"
+require_relative "bugsage/ai_panel"
+require_relative "bugsage/ai_chat"
+require_relative "bugsage/code_patch"
+require_relative "bugsage/editor_links"
+require_relative "bugsage/fix_applicator"
+require_relative "bugsage/session_clear"
+require_relative "bugsage/page_actions"
+require_relative "bugsage/translations"
+require_relative "bugsage/exception_handler"
+require_relative "bugsage/error_page"
+require_relative "bugsage/dashboard"
+require_relative "bugsage/middleware"
+require_relative "bugsage/auto_configurator"
+require_relative "bugsage/installation"
+require_relative "bugsage/installer"
+require_relative "bugsage/cli"
+require_relative "bugsage/exceptions_app"
+
+require_relative "bugsage/railtie" if defined?(Rails::Railtie)
+
+Bugsage::Translations.load!
+
+module Bugsage
+  class Error < StandardError; end
+
+  class << self
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def t(key, **)
+      Translations.t(key, **)
+    end
+
+    def configure
+      yield(configuration)
+    end
+
+    def reset_configuration!
+      @configuration = Configuration.new
+    end
+  end
+end

data/lib/generators/bugsage/install/install_generator.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require "rails/generators/base"
+
+module Bugsage
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      desc "Install BugSage configuration (optional initializer)"
+      source_root File.expand_path("templates", __dir__)
+
+      def copy_initializer
+        template "bugsage.rb", "config/initializers/bugsage.rb"
+      end
+
+      def show_summary
+        config = Bugsage::AutoConfigurator.apply!
+        say "\n#{Bugsage::AutoConfigurator.summary(config).join("\n")}\n", :green
+      end
+    end
+  end
+end

data/lib/generators/bugsage/install/templates/bugsage.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+# BugSage — Rails installation
+#
+# Quick start (zero-config):
+#   1. Add to Gemfile:  gem "bugsage"
+#   2. Run:             bundle install
+#   3. Run:             bin/rails server
+#   4. Trigger an error in development to see the BugSage error page
+#   5. Visit:           http://localhost:3000/bugsage
+#
+# Optional:
+#   - bundle exec rails generate bugsage:install   (commented initializer)
+#   - export OPENAI_API_KEY=sk-...                 (auto-enables OpenAI)
+#   - export CURSOR_API_KEY=crsr_...               (auto-enables Cursor)
+#   - export BUGSAGE_ENABLED_ENVIRONMENTS=development,test,staging
+#
+# BugSage auto-wires middleware, /bugsage, and error pages via Bugsage::Railtie.
+# You do not need to edit config/routes.rb or add middleware manually.
+#
+# See Bugsage::Installation for the full step list, or run:
+#   bundle exec bugsage install

data/scripts/publish-github-release.sh

@@ -0,0 +1,38 @@
+#!/usr/bin/env bash
+# Publish / refresh GitHub release notes for a tagged version.
+# Usage: scripts/publish-github-release.sh [vX.Y.Z]
+set -euo pipefail
+
+ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+cd "$ROOT"
+
+VERSION="${1:-v0.2.0}"
+NOTES_FILE="docs/releases/${VERSION}.md"
+
+if [[ ! -f "$NOTES_FILE" ]]; then
+  echo "Missing notes file: $NOTES_FILE" >&2
+  exit 1
+fi
+
+if ! command -v gh >/dev/null 2>&1; then
+  echo "Install GitHub CLI: https://cli.github.com/" >&2
+  exit 1
+fi
+
+TITLE="BugSage ${VERSION}"
+
+if gh release view "$VERSION" --repo MONARCHKOLI/bugsage >/dev/null 2>&1; then
+  echo "Updating existing release $VERSION…"
+  gh release edit "$VERSION" \
+    --repo MONARCHKOLI/bugsage \
+    --title "$TITLE" \
+    --notes-file "$NOTES_FILE"
+else
+  echo "Creating release $VERSION…"
+  gh release create "$VERSION" \
+    --repo MONARCHKOLI/bugsage \
+    --title "$TITLE" \
+    --notes-file "$NOTES_FILE"
+fi
+
+echo "Done: https://github.com/MONARCHKOLI/bugsage/releases/tag/${VERSION}"

data/sig/bugsage.rbs

@@ -0,0 +1,4 @@
+module Bugsage
+  VERSION: String
+  # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+end

metadata

@@ -0,0 +1,157 @@
+--- !ruby/object:Gem::Specification
+name: bugsage
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- Monarch Koli
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: i18n
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.14'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.14'
+- !ruby/object:Gem::Dependency
+  name: pastel
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+description: BugSage watches your Rails application's logs and exceptions, classifies
+  errors, and suggests likely root causes and fixes — using deterministic rules first,
+  with optional AI-powered analysis.
+email:
+- monarchkoli12@gmail.com
+executables:
+- bugsage
+extensions: []
+extra_rdoc_files: []
+files:
+- ARCHITECTURE.md
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- CONTRIBUTING.md
+- LICENSE.txt
+- README.md
+- ROADMAP.md
+- SECURITY.md
+- docs/AI.md
+- docs/Configuration.md
+- docs/GettingStarted.md
+- docs/RELEASE_CHECKLIST.md
+- docs/Troubleshooting.md
+- docs/images/BadRequest.png
+- docs/images/BadRequest2.png
+- docs/images/BugSage_Logo.png
+- docs/images/BugSage_Social_Preview.png
+- docs/images/NoMethodError.png
+- docs/images/NoMethodError2.png
+- docs/images/README.md
+- docs/releases/README.md
+- docs/releases/v0.2.0.md
+- exe/bugsage
+- lib/bugsage.rb
+- lib/bugsage/ai_analyzer.rb
+- lib/bugsage/ai_chat.rb
+- lib/bugsage/ai_context.rb
+- lib/bugsage/ai_panel.rb
+- lib/bugsage/ai_support.rb
+- lib/bugsage/auto_configurator.rb
+- lib/bugsage/cli.rb
+- lib/bugsage/code_context.rb
+- lib/bugsage/code_patch.rb
+- lib/bugsage/configuration.rb
+- lib/bugsage/console_context.rb
+- lib/bugsage/cursor_client.rb
+- lib/bugsage/dashboard.rb
+- lib/bugsage/editor_links.rb
+- lib/bugsage/error_page.rb
+- lib/bugsage/exception_handler.rb
+- lib/bugsage/exception_support.rb
+- lib/bugsage/exceptions_app.rb
+- lib/bugsage/fix_applicator.rb
+- lib/bugsage/formatter.rb
+- lib/bugsage/http_error_capture.rb
+- lib/bugsage/http_response_error.rb
+- lib/bugsage/inline_console.rb
+- lib/bugsage/installation.rb
+- lib/bugsage/installer.rb
+- lib/bugsage/json_endpoint.rb
+- lib/bugsage/locales/en.yml
+- lib/bugsage/middleware.rb
+- lib/bugsage/openai_client.rb
+- lib/bugsage/page_actions.rb
+- lib/bugsage/railtie.rb
+- lib/bugsage/request_context.rb
+- lib/bugsage/rule.rb
+- lib/bugsage/session_clear.rb
+- lib/bugsage/store.rb
+- lib/bugsage/suggestion.rb
+- lib/bugsage/trace_cleaner.rb
+- lib/bugsage/translations.rb
+- lib/bugsage/version.rb
+- lib/generators/bugsage/install/install_generator.rb
+- lib/generators/bugsage/install/templates/bugsage.rb
+- scripts/publish-github-release.sh
+- sig/bugsage.rbs
+homepage: https://github.com/MONARCHKOLI/bugsage
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/MONARCHKOLI/bugsage
+  source_code_uri: https://github.com/MONARCHKOLI/bugsage
+  changelog_uri: https://github.com/MONARCHKOLI/bugsage/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: AI-powered debugging assistant for Ruby on Rails
+test_files: []