ez_logs_agent 0.1.8 → 0.1.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d6be395fe0a765025430e03a92081b53d9ae1925df029543cd0785f334bd41b7
-  data.tar.gz: 6bcf0dc0e0a93731513463753031161adf6a96ba433d1647d20614162bf5a5ae
+  metadata.gz: 2a7479b12ee7dd0814929516f0474d7e05e393410d86a1c6d56117c854945809
+  data.tar.gz: 54af5890799ca5614373dae0e66d1b422b3abab3dee7d9d0f95c7f23039ffdd7
 SHA512:
-  metadata.gz: 8addaf44c89ada3706be7711c763700338064a296c29d9011361d86ed087b87327662567ec803f8296d6df2fedbca626ee564bc8c8b2090dddb38cc0f6332b8e
-  data.tar.gz: e6226450a0391438452c6d9811b76470ec431a4ed5c9046588e6608643c0c29cabd6168ada7ffa7d07f2bf0d211d6994ee712a10858c9372a0ecd71b8bc7d11a
+  metadata.gz: a68790e445b19ba92f2df2d0733fe6ae7e6d9c43f2ff854eed01fced091cb7d62aa1c0377429c44d3250abc515d5a1bb45056f1087eb0e2b8d491461fdd94843
+  data.tar.gz: f4208dc88f566f28e1ec24288533468fb3f99d268a77d4f3030da19fc4fc77fe8e36a39052516ddc94def977f03012d8bc157fccb319161a06d4889f52cd37e5

data/CHANGELOG.md

@@ -2,6 +2,42 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.1.10] — 2026-06-05
+
+### Fixed
+- `Sanitizer` no longer collapses ActiveJob keyword-argument hashes
+  (those tagged with `_aj_ruby2_keywords`) to `"[Object]"` at the
+  depth-3 cap. ActionMailer puts kwargs at two wrapper layers — an
+  outer `{"args" => [kwargs_hash], "_aj_ruby2_keywords" => ["args"]}`
+  payload and the kwargs hash itself, also marked. Each layer is
+  framework noise; the depth budget now skips them so real kwargs
+  survive the wire (e.g. `CompanyMailer.deleted(admin_email:, ...)`
+  now ships `admin_email`/`company_name`/`deleted_at` instead of a
+  single `"[Object]"`).
+
+The carve-out is narrow: only hashes that actually carry the
+`_aj_ruby2_keywords` marker are exempt. Customer-data hashes
+without the marker still hit the depth cap unchanged, and
+sensitive-key filtering (passwords, tokens, …) still runs on the
+real kwargs entries — the wrapper is free to descend into, but
+nothing inside it is exempt from masking. No wire-format change.
+
+## [0.1.9] — 2026-06-05
+
+### Fixed
+- `Sanitizer` no longer collapses ActiveJob record references
+  (`{"_aj_globalid" => "gid://app/Model/id"}`) to `"[Object]"` at the
+  depth-3 cap. These one-key wrapper hashes pass through verbatim so
+  the server can display *which* record a job ran on
+  (e.g. ActionMailer's `Record 1` field now reads `User #42` instead
+  of `[Object]`).
+
+The carve-out is narrow: only the exact `{"_aj_globalid" => "gid://..."}`
+shape is exempt. Multi-key hashes, non-GID values, and any other
+nested structure still hit the existing graph-protection rules
+(depth cap, array truncation, non-primitive collapse) unchanged. No
+wire-format change.
+
 ## [0.1.8] — 2026-05-29
 
 ### Changed

data/lib/ez_logs_agent/sanitizer.rb

@@ -96,6 +96,23 @@ module EzLogsAgent
       private
 
       def sanitize_nested_object(hash, depth)
+        # ActiveJob serializes record refs as `{"_aj_globalid" => "gid://..."}`.
+        # Preserve these even past the depth limit so a record reference
+        # survives the [Object] collapse and the server can display WHICH
+        # record the job ran on. Display formatting (gid → "User #42") is
+        # the server's job; the agent's job is to keep the data on the wire.
+        return hash if global_id_hash?(hash)
+
+        # ActiveJob wraps keyword args at TWO layers: the outer mailer
+        # payload `{"args" => [kwargs_hash], "_aj_ruby2_keywords" => ["args"]}`
+        # and the inner kwargs hash itself, also tagged `_aj_ruby2_keywords`.
+        # Each wrapper layer is framework noise — recursing into it without
+        # spending depth budget keeps the real kwargs from collapsing to
+        # "[Object]" at depth 3. Sensitive-key filtering still runs on the
+        # real entries (passwords don't leak; the wrapper just doesn't cost
+        # a depth level).
+        return sanitize_ruby2_keywords_wrapper(hash, depth) if ruby2_keywords_wrapper?(hash)
+
         return "[Object]" if depth >= MAX_NESTING_DEPTH
         return {} if hash.empty?
 
@@ -104,6 +121,24 @@ module EzLogsAgent
         end
       end
 
+      # Sanitize the entries of an _aj_ruby2_keywords wrapper at the SAME
+      # depth as the wrapper itself, then re-attach the marker. This is what
+      # lets kwargs survive past the depth-3 cap when they're wrapped at
+      # depth 2-3 by the outer mailer payload.
+      def sanitize_ruby2_keywords_wrapper(hash, depth)
+        result = {}
+        hash.each do |key, value|
+          if ruby2_keywords_marker_key?(key)
+            # Preserve the marker verbatim — it's used to identify the
+            # wrapper on the receiving side, not to display.
+            result[key] = value
+          else
+            result[key] = sanitize_value(key, value, depth)
+          end
+        end
+        result
+      end
+
       def sanitize_array_value(array, depth)
         return [] if array.empty?
 
@@ -145,6 +180,31 @@ module EzLogsAgent
           value.is_a?(TrueClass) ||
           value.is_a?(FalseClass)
       end
+
+      # True iff `hash` is the exact one-key shape ActiveJob uses to serialize
+      # an ActiveRecord (or any GlobalID::Identification) argument:
+      # `{"_aj_globalid" => "gid://..."}`. Used to exempt these hashes from
+      # the depth-limit collapse so the wire still carries the record ref.
+      def global_id_hash?(hash)
+        return false unless hash.is_a?(Hash) && hash.size == 1
+        gid = hash["_aj_globalid"] || hash[:_aj_globalid]
+        gid.is_a?(String) && gid.start_with?("gid://")
+      end
+
+      # True iff `hash` carries the `_aj_ruby2_keywords` marker. ActiveJob
+      # uses this marker on any hash that originated as a keyword-argument
+      # splat (so the framework can re-splat on deserialize). Used to skip
+      # the depth penalty for these framework wrappers — the marker's
+      # presence is the unambiguous signal we're inside an ActiveJob
+      # serialization layer, not customer data.
+      def ruby2_keywords_wrapper?(hash)
+        return false unless hash.is_a?(Hash)
+        hash.key?("_aj_ruby2_keywords") || hash.key?(:_aj_ruby2_keywords)
+      end
+
+      def ruby2_keywords_marker_key?(key)
+        key.to_s == "_aj_ruby2_keywords"
+      end
     end
   end
 end

data/lib/ez_logs_agent/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module EzLogsAgent
-  VERSION = "0.1.8"
+  VERSION = "0.1.10"
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ez_logs_agent
 version: !ruby/object:Gem::Version
-  version: 0.1.8
+  version: 0.1.10
 platform: ruby
 authors:
 - dezsirazvan
 bindir: bin
 cert_chain: []
-date: 2026-05-29 00:00:00.000000000 Z
+date: 2026-06-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: request_store