fix puma detection via ARGV for gosu wrapper scripts

When running puma through wrapper scripts like gosu, $PROGRAM_NAME
is the wrapper path (e.g., /usr/bin/gosu) not puma. This fix adds
ARGV checking so puma is detected when ARGV contains "puma" arguments.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: ndbroadbent

.cspell/project-words.txt

@@ -21,6 +21,7 @@ Fanout
 favicons
 gettime
 goodjob
+gosu
 Healthcheck
 Honeybadger
 hostnames

lib/log_struct/concerns/configuration.rb

@@ -145,8 +145,12 @@ def server_process?
         sig { returns(T::Boolean) }
         def puma_server?
           # Just checking defined?(::Puma::Server) is not reliable - Puma might be installed
-          # but not running. Check $PROGRAM_NAME to verify we're actually running puma.
-          $PROGRAM_NAME.include?("puma")
+          # but not running. Check $PROGRAM_NAME and ARGV to verify we're actually running puma.
+          # ARGV check is needed when running through wrapper scripts like gosu.
+          return true if $PROGRAM_NAME.include?("puma")
+          return true if current_argv.any? { |arg| arg.include?("puma") }
+
+          false
         end
 
         sig { returns(T::Boolean) }

test/log_struct/configuration_test.rb

@@ -391,5 +391,35 @@ def test_various_ci_env_values
         end
       end
     end
+
+    # Test puma detection via ARGV when running through wrapper scripts (e.g., gosu)
+    # In this scenario, $PROGRAM_NAME is the wrapper (e.g., /usr/bin/gosu) but ARGV
+    # contains "puma" arguments like: ["deploy", "puma", "-C", "config/puma.rb"]
+    def test_enabled_for_puma_via_argv_in_production
+      original_server_mode = LogStruct.server_mode?
+      had_rails_server = defined?(::Rails::Server)
+
+      # Reset all server detection state
+      LogStruct.server_mode = false
+      ::Rails.send(:remove_const, :Server) if defined?(::Rails::Server)
+
+      LogStruct.config.enabled = false
+      LogStruct.config.enabled_environments = [:production]
+
+      # Simulate gosu wrapper: ARGV contains puma arguments but $PROGRAM_NAME is gosu
+      original_argv = ::ARGV.dup
+      ::ARGV.replace(["deploy", "puma", "-C", "config/puma.rb"])
+
+      Rails.stub(:env, ActiveSupport::StringInquirer.new("production")) do
+        LogStruct.set_enabled_from_rails_env!
+
+        assert LogStruct.config.enabled,
+          "LogStruct should be enabled when puma is detected via ARGV (gosu wrapper scenario)"
+      end
+    ensure
+      ::ARGV.replace(original_argv) if defined?(original_argv)
+      LogStruct.server_mode = T.must(original_server_mode)
+      ::Rails.const_set(:Server, Class.new) if had_rails_server && !defined?(::Rails::Server)
+    end
   end
 end