started work on puma integration

Author: ndbroadbent

lefthook.yml

@@ -21,7 +21,7 @@ pre-commit:
             run: scripts/generate_typescript_structs.rb
 
           - name: codegen-sync
-            glob: '{schemas/log_sources/**/*,scripts/templates/generate_log_structs/**/*,scripts/generate_log_structs.rb}'
+            glob: '{schemas/log_sources/**/*,scripts/templates/generate_log_structs/**/*,scripts/generate_sorbet_log_structs.rb}'
             run: scripts/check_generated.sh
 
           - name: cspell

lib/log_struct/concerns/error_handling.rb

@@ -26,7 +26,7 @@ def error_handling_mode_for(source)
           when Source::Security
             config.error_handling_modes.security_errors
           when Source::Rails, Source::App, Source::Job, Source::Storage, Source::Mailer,
-               Source::Shrine, Source::CarrierWave, Source::Sidekiq, Source::Dotenv
+               Source::Shrine, Source::CarrierWave, Source::Sidekiq, Source::Dotenv, Source::Puma
             config.error_handling_modes.standard_errors
           else
             # Ensures the case statement is exhaustive

lib/log_struct/config_struct/integrations.rb

@@ -84,6 +84,10 @@ class Integrations < T::Struct
       # Enable dotenv-rails integration (convert to structured logs)
       # Default: true
       prop :enable_dotenv, T::Boolean, default: true
+
+      # Enable Puma integration (convert server lifecycle logs)
+      # Default: true
+      prop :enable_puma, T::Boolean, default: true
     end
   end
 end

lib/log_struct/enums/event.rb

@@ -39,6 +39,14 @@ class Event < T::Enum
       Save = new(:save)
       Restore = new(:restore)
 
+      # Server lifecycle (e.g., Puma)
+      Boot = new(:boot)
+      Started = new(:started)
+      Listening = new(:listening)
+      Shutdown = new(:shutdown)
+      Goodbye = new(:goodbye)
+      Exiting = new(:exiting)
+
       # Security events
       IPSpoof = new(:ip_spoof)
       CSRFViolation = new(:csrf_violation)

lib/log_struct/enums/log_field.rb

@@ -138,6 +138,17 @@ class LogField < T::Enum
       # Ahoy-specific fields
       AhoyEvent = new(:ahoy_event)
       Properties = new(:properties)
+
+      # Puma / server lifecycle fields
+      Mode = new(:mode)
+      PumaVersion = new(:puma_version)
+      PumaCodename = new(:puma_codename)
+      RubyVersion = new(:ruby_version)
+      MinThreads = new(:min_threads)
+      MaxThreads = new(:max_threads)
+      Environment = new(:environment)
+      ListeningAddresses = new(:listening_addresses)
+      Address = new(:addr)
     end
   end
 end

lib/log_struct/enums/source.rb

@@ -23,6 +23,7 @@ class Source < T::Enum
       CarrierWave = new(:carrierwave)
       Sidekiq = new(:sidekiq)
       Dotenv = new(:dotenv)
+      Puma = new(:puma)
     end
   end
 end

lib/log_struct/integrations.rb

@@ -17,6 +17,7 @@
 require_relative "integrations/ahoy"
 require_relative "integrations/active_model_serializers"
 require_relative "integrations/dotenv"
+require_relative "integrations/puma"
 
 module LogStruct
   module Integrations
@@ -56,6 +57,7 @@ def self.setup_integrations
       Integrations::ActiveStorage.setup(config) if config.integrations.enable_activestorage
       Integrations::CarrierWave.setup(config) if config.integrations.enable_carrierwave
       Integrations::Sorbet.setup(config) if config.integrations.enable_sorbet_error_handlers
+      Integrations::Puma.setup(config) if config.integrations.enable_puma
     end
   end
 end