bug_bunny 4.7.0 → 4.8.1

data/lib/bug_bunny/railtie.rb

@@ -14,9 +14,7 @@ module BugBunny
     # 1. Configuración de Autoload
     initializer 'bug_bunny.add_autoload_paths' do |app|
       rabbit_path = File.join(app.root, 'app', 'rabbit')
-      if Dir.exist?(rabbit_path)
-        app.config.paths.add 'app/rabbit', eager_load: true
-      end
+      app.config.paths.add 'app/rabbit', eager_load: true if Dir.exist?(rabbit_path)
     end
 
     # 2. Gestión de Forks (Puma / Spring / otros)
@@ -25,9 +23,7 @@ module BugBunny
     # el hijo empiece a trabajar, para evitar compartir el mismo socket TCP.
     config.after_initialize do
       # Estrategia 1: Rails 7.1+ ForkTracker (La forma estándar moderna)
-      if defined?(ActiveSupport::ForkTracker)
-        ActiveSupport::ForkTracker.after_fork { BugBunny.disconnect }
-      end
+      ActiveSupport::ForkTracker.after_fork { BugBunny.disconnect } if defined?(ActiveSupport::ForkTracker)
 
       # Estrategia 2: Hook específico de Puma (Legacy)
       # Solo intentamos usarlo si la API 'events' está disponible (Puma < 5).
@@ -38,7 +34,12 @@ module BugBunny
       end
     end
 
-    # 3. Hook de Spring (Preloader)
+    # 3. Rake tasks (bug_bunny:sync)
+    rake_tasks do
+      load File.expand_path('../tasks/bug_bunny.rake', __dir__)
+    end
+
+    # 4. Hook de Spring (Preloader)
     if defined?(Spring)
       Spring.after_fork do
         BugBunny.disconnect

data/lib/bug_bunny/request.rb

@@ -23,20 +23,11 @@ module BugBunny
   # @attr exchange_options [Hash] Opciones específicas para la declaración del Exchange en esta petición.
   # @attr queue_options [Hash] Opciones específicas para la declaración de la Cola en esta petición.
   class Request
-    attr_accessor :body
-    attr_accessor :headers
-    attr_accessor :params
-    attr_accessor :path
-    attr_accessor :method
-    attr_accessor :exchange
-    attr_accessor :exchange_type
-    attr_accessor :routing_key
-    attr_accessor :timeout
-    attr_accessor :delivery_mode
+    attr_accessor :body, :headers, :params, :path, :method, :exchange, :exchange_type, :routing_key, :timeout,
+                  :delivery_mode, :queue_options
 
     # Configuración de Infraestructura Específica
     attr_accessor :exchange_options
-    attr_accessor :queue_options
 
     # Metadatos AMQP Estándar
     attr_accessor :app_id, :content_type, :content_encoding, :priority,
@@ -61,6 +52,7 @@ module BugBunny
       @exchange_options = {}
       @queue_options = {}
     end
+
     # Combina el path con los params como query string.
     #
     # @return [String] El path completo con query string si hay params, o solo el path.

data/lib/bug_bunny/resource.rb

@@ -25,8 +25,7 @@ module BugBunny
     define_model_callbacks :save, :create, :update, :destroy
 
     attr_reader :remote_attributes
-    attr_accessor :persisted
-    attr_accessor :routing_key, :exchange, :exchange_type
+    attr_accessor :persisted, :routing_key, :exchange, :exchange_type
 
     # @return [Hash] Opciones específicas de instancia para exchange y queue.
     attr_accessor :exchange_options, :queue_options
@@ -38,7 +37,9 @@ module BugBunny
       attr_writer :exchange_options, :queue_options
 
       # @api private
-      def thread_config(key); Thread.current["bb_#{object_id}_#{key}"]; end
+      def thread_config(key)
+        Thread.current["bb_#{object_id}_#{key}"]
+      end
 
       # Resuelve la configuración buscando en el hilo, luego en la jerarquía de clases.
       # @param key [Symbol] Clave en el Thread.current.
@@ -47,29 +48,41 @@ module BugBunny
       def resolve_config(key, instance_var)
         val = thread_config(key)
         return val if val
+
         target = self
         while target <= BugBunny::Resource
           value = target.instance_variable_get(instance_var)
           return value.respond_to?(:call) ? value.call : value unless value.nil?
+
           target = target.superclass
         end
         nil
       end
 
       # @return [ConnectionPool, nil]
-      def connection_pool; resolve_config(:pool, :@connection_pool); end
+      def connection_pool
+        resolve_config(:pool, :@connection_pool)
+      end
 
       # @return [String] Nombre del exchange actual.
-      def current_exchange; resolve_config(:exchange, :@exchange) || raise(ArgumentError, "Exchange not defined for #{name}"); end
+      def current_exchange
+        resolve_config(:exchange, :@exchange) || raise(ArgumentError, "Exchange not defined for #{name}")
+      end
 
       # @return [String] Tipo de exchange ('direct', 'topic', 'fanout').
-      def current_exchange_type; resolve_config(:exchange_type, :@exchange_type) || 'direct'; end
+      def current_exchange_type
+        resolve_config(:exchange_type, :@exchange_type) || 'direct'
+      end
 
       # @return [Hash] Opciones de exchange específicas (Nivel 3 de la cascada).
-      def current_exchange_options; resolve_config(:exchange_options, :@exchange_options) || {}; end
+      def current_exchange_options
+        resolve_config(:exchange_options, :@exchange_options) || {}
+      end
 
       # @return [Hash] Opciones de cola específicas.
-      def current_queue_options; resolve_config(:queue_options, :@queue_options) || {}; end
+      def current_queue_options
+        resolve_config(:queue_options, :@queue_options) || {}
+      end
 
       # @return [String] Nombre del recurso para la construcción de rutas.
       def resource_name
@@ -126,7 +139,8 @@ module BugBunny
       # @param pool [ConnectionPool] Pool de conexiones.
       # @param exchange_options [Hash] Opciones de infraestructura.
       # @param queue_options [Hash] Opciones de cola.
-      def with(exchange: nil, routing_key: nil, exchange_type: nil, pool: nil, exchange_options: nil, queue_options: nil)
+      def with(exchange: nil, routing_key: nil, exchange_type: nil, pool: nil, exchange_options: nil,
+               queue_options: nil)
         keys = {
           exchange: "bb_#{object_id}_exchange",
           exchange_type: "bb_#{object_id}_exchange_type",
@@ -163,9 +177,7 @@ module BugBunny
         end
 
         def method_missing(method, *args, &block)
-          if @used
-            ::Kernel.raise ::BugBunny::Error, "ScopeProxy is single-use. Call .with again for a new context."
-          end
+          ::Kernel.raise ::BugBunny::Error, 'ScopeProxy is single-use. Call .with again for a new context.' if @used
           @used = true
           @target.public_send(method, *args, &block)
         ensure
@@ -176,11 +188,13 @@ module BugBunny
       # Calcula la routing key final.
       # @param id [String, nil] ID del recurso.
       # @return [String]
-      def calculate_routing_key(id = nil)
+      def calculate_routing_key(_id = nil)
         manual_rk = thread_config(:routing_key)
         return manual_rk if manual_rk
+
         static_rk = resolve_config(:routing_key, :@routing_key)
         return static_rk if static_rk.present?
+
         resource_name
       end
 
@@ -206,6 +220,7 @@ module BugBunny
         )
 
         return [] unless response['body'].is_a?(Array)
+
         response['body'].map do |attrs|
           inst = new(attrs)
           inst.persisted = true
@@ -218,7 +233,9 @@ module BugBunny
 
       # Devuelve todos los registros.
       # @return [Array<BugBunny::Resource>]
-      def all; where({}); end
+      def all
+        where({})
+      end
 
       # Busca un registro por ID (GET).
       # Mapea un 404 (NotFound) devolviendo un objeto nulo.
@@ -275,7 +292,7 @@ module BugBunny
       @exchange_options = self.class.thread_config(:exchange_options) || self.class.current_exchange_options
       @queue_options = self.class.thread_config(:queue_options) || self.class.current_queue_options
 
-      super(attributes)
+      super
     end
 
     # Limpia el rastreo de ActiveModel y nuestro rastreo dinámico interno.
@@ -301,24 +318,35 @@ module BugBunny
     end
 
     # @return [String]
-    def calculate_routing_key(id=nil); @routing_key || self.class.calculate_routing_key(id); end
+    def calculate_routing_key(id = nil)
+      @routing_key || self.class.calculate_routing_key(id)
+    end
 
     # @return [String]
-    def current_exchange; @exchange || self.class.current_exchange; end
+    def current_exchange
+      @exchange || self.class.current_exchange
+    end
 
     # @return [String]
-    def current_exchange_type; @exchange_type || self.class.current_exchange_type; end
+    def current_exchange_type
+      @exchange_type || self.class.current_exchange_type
+    end
 
     # @return [BugBunny::Client]
-    def bug_bunny_client; self.class.bug_bunny_client; end
+    def bug_bunny_client
+      self.class.bug_bunny_client
+    end
 
     # @return [Boolean]
-    def persisted?; !!@persisted; end
+    def persisted?
+      !!@persisted
+    end
 
     # Asignación masiva de atributos.
     # @param new_attributes [Hash]
     def assign_attributes(new_attributes)
       return if new_attributes.nil?
+
       new_attributes.each { |k, v| public_send("#{k}=", v) }
     end
 
@@ -375,7 +403,7 @@ module BugBunny
 
     def id=(value)
       if self.class.attribute_names.include?('id')
-        super(value)
+        super
       else
         @dynamic_changes << 'id' if @extra_attributes['id'] != value
         @extra_attributes['id'] = value
@@ -433,6 +461,7 @@ module BugBunny
     # @return [Boolean]
     def destroy
       return false unless persisted?
+
       run_callbacks(:destroy) do
         path = "#{self.class.resource_name}/#{id}"
         rk = calculate_routing_key(id)
@@ -459,6 +488,7 @@ module BugBunny
     # Carga errores remotos en el objeto local (utilizado al recibir 422).
     def load_remote_rabbit_errors(errors_hash)
       return if errors_hash.nil? || errors_hash.empty?
+
       if errors_hash.is_a?(String)
         errors.add(:base, errors_hash)
       else

data/lib/bug_bunny/routing/route_set.rb

@@ -57,27 +57,37 @@ module BugBunny
       # Registra una ruta para el verbo GET.
       # @param path [String, Symbol] Patrón de la URL.
       # @param to [String, nil] Destino (controlador#accion). Si es nil, se infiere del scope.
-      def get(path, to: nil);    add_route('GET', path, to: to); end
+      def get(path, to: nil)
+        add_route('GET', path, to: to)
+      end
 
       # Registra una ruta para el verbo POST.
       # @param path [String, Symbol] Patrón de la URL.
       # @param to [String, nil] Destino (controlador#accion). Si es nil, se infiere del scope.
-      def post(path, to: nil);   add_route('POST', path, to: to); end
+      def post(path, to: nil)
+        add_route('POST', path, to: to)
+      end
 
       # Registra una ruta para el verbo PUT.
       # @param path [String, Symbol] Patrón de la URL.
       # @param to [String, nil] Destino (controlador#accion). Si es nil, se infiere del scope.
-      def put(path, to: nil);    add_route('PUT', path, to: to); end
+      def put(path, to: nil)
+        add_route('PUT', path, to: to)
+      end
 
       # Registra una ruta para el verbo PATCH.
       # @param path [String, Symbol] Patrón de la URL.
       # @param to [String, nil] Destino (controlador#accion). Si es nil, se infiere del scope.
-      def patch(path, to: nil);  add_route('PATCH', path, to: to); end
+      def patch(path, to: nil)
+        add_route('PATCH', path, to: to)
+      end
 
       # Registra una ruta para el verbo DELETE.
       # @param path [String, Symbol] Patrón de la URL.
       # @param to [String, nil] Destino (controlador#accion). Si es nil, se infiere del scope.
-      def delete(path, to: nil); add_route('DELETE', path, to: to); end
+      def delete(path, to: nil)
+        add_route('DELETE', path, to: to)
+      end
 
       # @!endgroup
 
@@ -113,7 +123,7 @@ module BugBunny
         resource_path = name.to_s
 
         # Todas las acciones estándar disponibles
-        actions = [:index, :show, :create, :update, :destroy]
+        actions = %i[index show create update destroy]
 
         # Aplicamos los filtros si existen
         if only
@@ -131,10 +141,10 @@ module BugBunny
         delete "#{resource_path}/:id", to: "#{resource_path}#destroy" if actions.include?(:destroy)
 
         # Si se pasa un bloque, abrimos un Scope de Recurso para rutas anidadas
-        if block_given?
-          with_scope({ type: :resource, name: resource_path }) do
-            instance_eval(&block)
-          end
+        return unless block_given?
+
+        with_scope({ type: :resource, name: resource_path }) do
+          instance_eval(&block)
         end
       end
 
@@ -197,16 +207,16 @@ module BugBunny
       # @return [Hash, nil] Hash con `:controller`, `:action`, `:params` y `:namespace`, o `nil` si no hay match.
       def recognize(method, path)
         @routes.each do |route|
-          if route.match?(method, path)
-            extracted_params = route.extract_params(path)
-
-            return {
-              controller: route.controller,
-              action: route.action,
-              params: extracted_params,
-              namespace: route.namespace
-            }
-          end
+          next unless route.match?(method, path)
+
+          extracted_params = route.extract_params(path)
+
+          return {
+            controller: route.controller,
+            action: route.action,
+            params: extracted_params,
+            namespace: route.namespace
+          }
         end
 
         # Si llegamos aquí, es un 404 seguro.
@@ -238,7 +248,8 @@ module BugBunny
         end
 
         if final_to.nil?
-          raise ArgumentError, "Falta el destino 'to:' para la ruta #{method} '#{final_path}'. Usa la sintaxis 'controlador#accion'"
+          raise ArgumentError,
+                "Falta el destino 'to:' para la ruta #{method} '#{final_path}'. Usa la sintaxis 'controlador#accion'"
         end
 
         @routes << Route.new(method, final_path, to: final_to, namespace: current_namespace)

data/lib/bug_bunny/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module BugBunny
-  VERSION = "4.7.0"
+  VERSION = '4.8.1'
 end

data/lib/bug_bunny.rb

@@ -25,6 +25,7 @@ require_relative 'bug_bunny/railtie' if defined?(Rails)
 # Actúa como espacio de nombres y punto de configuración global.
 module BugBunny
   extend BugBunny::Observability
+
   private_class_method :safe_log, :exception_metadata, :observability_name
 
   class << self
@@ -95,9 +96,9 @@ module BugBunny
 
     @global_connection.close if @global_connection.open?
     @global_connection = nil
-    
+
     @logger = configuration.logger
-    safe_log(:info, "bug_bunny.disconnect")
+    safe_log(:info, 'bug_bunny.disconnect')
   end
 
   # @api private

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

@@ -20,7 +20,7 @@ module BugBunny
       # @api private
       source_root File.expand_path('templates', __dir__)
 
-      desc "Instala la configuración inicial de BugBunny y crea la estructura de directorios."
+      desc 'Instala la configuración inicial de BugBunny y crea la estructura de directorios.'
 
       # Genera el archivo de configuración inicial.
       # Copia la plantilla `initializer.rb` a `config/initializers/bug_bunny.rb` en la app destino.
@@ -33,15 +33,55 @@ module BugBunny
       # Crea la estructura de carpetas necesaria para el patrón MVC de BugBunny.
       #
       # Genera:
-      # * `app/rabbit/controllers/`: Directorio donde vivirán los controladores de consumidores.
+      # * `app/bug_bunny/controllers/`: Directorio donde vivirán los controladores de consumidores.
       # * `.keep`: Archivo marcador para asegurar que Git rastree la carpeta aunque esté vacía.
       #
       # @return [void]
       def create_directories
-        empty_directory "app/rabbit/controllers"
-        create_file "app/rabbit/controllers/.keep", ""
+        empty_directory 'app/bug_bunny/controllers'
+        create_file 'app/bug_bunny/controllers/.keep', ''
+      end
+
+      # Escribe el bloque inicial de BugBunny en CLAUDE.md del proyecto consumidor.
+      #
+      # Si CLAUDE.md no existe, crea uno mínimo con la sección correspondiente.
+      # Si ya existe, agrega la sección `## Gemas internas` con el bloque de bug_bunny.
+      # En ambos casos, el rake task `bug_bunny:sync` se encarga de las actualizaciones futuras.
+      #
+      # @return [void]
+      def update_claude_md
+        spec = Gem::Specification.find_by_name('bug_bunny')
+        version = spec.version.to_s
+        docs_path = File.join(spec.gem_dir, 'docs', 'ai')
+
+        block = <<~BLOCK
+          ## Gemas internas
+
+          ### bug_bunny
+          - **Version:** #{version}
+          - **Docs:** #{docs_path}
+          - **Updated:** #{Time.now.strftime('%Y-%m-%d')}
+        BLOCK
+
+        claude_md = File.join(destination_root, 'CLAUDE.md')
+
+        if File.exist?(claude_md)
+          content = File.read(claude_md)
+          if content.include?('### bug_bunny')
+            say_status :skip, 'CLAUDE.md already has a bug_bunny block — run `rake bug_bunny:sync` to update'
+          elsif content.include?('## Gemas internas')
+            inject_into_file 'CLAUDE.md', "\n#{block.lines.drop(2).join}", after: "## Gemas internas\n"
+            say_status :update, 'Added bug_bunny block to existing ## Gemas internas section in CLAUDE.md'
+          else
+            append_to_file 'CLAUDE.md', "\n#{block}"
+            say_status :update, 'Added ## Gemas internas section to CLAUDE.md'
+          end
+        else
+          create_file 'CLAUDE.md', "# #{Rails.application.class.module_parent_name}\n\n#{block}"
+          say_status :create, 'CLAUDE.md created with bug_bunny block'
+        end
 
-        puts "🐰 BugBunny structure created successfully!"
+        say '  Add `bundle exec rake bug_bunny:sync` to bin/setup to keep this block up to date.'
       end
     end
   end

data/lib/tasks/bug_bunny.rake

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require 'date'
+
+namespace :bug_bunny do
+  desc 'Sync BugBunny AI docs reference in CLAUDE.md with the installed version'
+  task :sync do
+    spec = Gem::Specification.find_by_name('bug_bunny')
+    version = spec.version.to_s
+    docs_path = File.join(spec.gem_dir, 'docs', 'ai')
+    claude_md_path = File.join(Dir.pwd, 'CLAUDE.md')
+
+    content = if File.exist?(claude_md_path)
+                File.read(claude_md_path)
+              else
+                app_name = File.basename(Dir.pwd).split(/[-_]/).map(&:capitalize).join
+                puts 'bug_bunny:sync — CLAUDE.md not found, creating it.'
+                "# #{app_name}\n"
+              end
+
+    # Idempotent: same version already present, nothing to do
+    if content.include?('### bug_bunny') && content.include?("**Version:** #{version}")
+      puts "bug_bunny:sync — already at #{version}, nothing to do."
+      next
+    end
+
+    block = <<~BLOCK
+      ### bug_bunny
+      - **Version:** #{version}
+      - **Docs:** #{docs_path}
+      - **Updated:** #{Date.today}
+    BLOCK
+
+    # Replace existing block if present
+    if content.match?(/^### bug_bunny\n/)
+      updated = content.gsub(/^### bug_bunny\n(?:- \*\*.*\n)*/, block)
+      File.write(claude_md_path, updated)
+      puts "bug_bunny:sync — updated to #{version} in CLAUDE.md"
+    elsif content.include?('## Gemas internas')
+      # Append under existing section
+      updated = content.sub(/^## Gemas internas\n/, "## Gemas internas\n\n#{block}")
+      File.write(claude_md_path, updated)
+      puts "bug_bunny:sync — added #{version} under '## Gemas internas' in CLAUDE.md"
+    else
+      # Create section at end of file
+      File.write(claude_md_path, content.rstrip + "\n\n## Gemas internas\n\n#{block}")
+      puts "bug_bunny:sync — added '## Gemas internas' section with #{version} to CLAUDE.md"
+    end
+  end
+end