legion-logging 1.4.1 → 1.4.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 87467334f127d64997e116d784a68d875c8180a6633dd068e4e095eb7e8bc22f
-  data.tar.gz: a934447ca2a89f43d3f4993a1df8e879b15945b966b4ade4f29b4d6b2272762d
+  metadata.gz: 31ec07f7a93713fb708102528d4e61525a4c3b4fa39de510d29a454726b49436
+  data.tar.gz: 62a67fc723d1e865ef3e632d1987b6ce73c2fe9aa033686df5fe3b2fb89bc14c
 SHA512:
-  metadata.gz: bb9ece1de3b070fb58417992daf22fdaf3e0021f8a45e486a6d5fa4bdca8536c9ed6bdaec8b867f8aef854b52a1496d462260c7cf31d1faae4b0769a91995ef2
-  data.tar.gz: 00f6510d46e38bb7a638aace8818cdccdefe9bfb8c857ecc2d6b11a43f55461ea25bd56a37b0b325749971808491679160930ba11014a453d7fbd5b096d50368
+  metadata.gz: 5e0b2171b6ca1b1acbb3ad0f40cbd23a77bf5824a3b2f37a5c9b3484f7edf2cf9cf1a8dc23a9f0ed0acd426e139fb0d7ce13ac0a3ae2a77b3113dd0569cc6d53
+  data.tar.gz: e4e599809e26c6b7a0f9c1a81f05e390175cad0568b6b99f26888b675590972ff9148e27bc53f36461e1d6f09f83fcf7a818b01bd793098c5809910affabb0a2

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Legion::Logging Changelog
 
+## [1.4.2] - 2026-03-28
+
+### Added
+- `Legion::Logging::CategoryRegistry` module: extension-defined event category registration with `register_category`, `registered_categories`, `category_registered?`, and `category_info` methods
+- `Legion::Logging.register_category` and `Legion::Logging.registered_categories` delegate methods on the top-level module
+- `category:` keyword argument on `EventBuilder.build` — emits `category` field in structured log events when provided
+- `SIEMExporter.format_for_elk` now includes `category` field when the event hash carries `:category` or `"category"`
+
 ## [1.4.1] - 2026-03-27
 
 ### Fixed

data/lib/legion/logging/category_registry.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Legion
+  module Logging
+    module CategoryRegistry
+      VALID_NAME_PATTERN = /\A[a-z][a-z0-9]*(\.[a-z][a-z0-9]*)*\z/
+
+      class << self
+        def register_category(name, description: nil, expected_fields: [])
+          name = name.to_s
+          raise ArgumentError, "invalid category name: #{name.inspect}" unless name.match?(VALID_NAME_PATTERN)
+
+          registry[name] = {
+            name:            name,
+            description:     description,
+            expected_fields: Array(expected_fields)
+          }.freeze
+          name
+        end
+
+        def registered_categories
+          registry.dup.freeze
+        end
+
+        def category_registered?(name)
+          registry.key?(name.to_s)
+        end
+
+        def category_info(name)
+          registry[name.to_s]
+        end
+
+        def clear!
+          registry.clear
+        end
+
+        private
+
+        def registry
+          @registry ||= {}
+        end
+      end
+    end
+  end
+end

data/lib/legion/logging/event_builder.rb

@@ -13,7 +13,7 @@ module Legion
       BACKTRACE_FALLBACK_FRAMES = 20
 
       class << self
-        def build(level:, message:, lex: nil, lex_segments: nil, context: nil, caller_offset: 2)
+        def build(level:, message:, lex: nil, lex_segments: nil, context: nil, category: nil, caller_offset: 2)
           event = base_fields(level, message)
           event[:lex] = derive_lex_source(lex, lex_segments)
           add_node(event)
@@ -21,6 +21,7 @@ module Legion
           add_exception_info(event, message)
           add_gem_info(event, event[:lex])
           event[:context] = context if context
+          event[:category] = category.to_s if category
           event.compact
         end
 

data/lib/legion/logging/siem_exporter.rb

@@ -37,12 +37,17 @@ module Legion
         end
 
         def format_for_elk(event, index: 'legion')
-          {
+          result = {
             '@timestamp' => Time.now.utc.iso8601,
             'index'      => index,
             'message'    => redact_phi(event.to_s),
             'source'     => 'legion'
           }
+          if event.is_a?(Hash)
+            category = event[:category] || event['category']
+            result['category'] = category.to_s if category
+          end
+          result
         end
       end
     end

data/lib/legion/logging/version.rb

@@ -2,6 +2,6 @@
 
 module Legion
   module Logging
-    VERSION = '1.4.1'
+    VERSION = '1.4.2'
   end
 end

data/lib/legion/logging.rb

@@ -7,6 +7,7 @@ require 'legion/logging/builder'
 require 'legion/logging/event_builder'
 require 'legion/logging/async_writer'
 require 'legion/logging/helper'
+require 'legion/logging/category_registry'
 
 require 'json'
 require 'logger'
@@ -32,6 +33,14 @@ module Legion
         @exception_writer || DEFAULT_EXCEPTION_WRITER
       end
 
+      def register_category(name, description: nil, expected_fields: [])
+        CategoryRegistry.register_category(name, description: description, expected_fields: expected_fields)
+      end
+
+      def registered_categories
+        CategoryRegistry.registered_categories
+      end
+
       def setup(level: 'info', format: :text, async: true, **options)
         output(**options)
         log_level(level)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: legion-logging
 version: !ruby/object:Gem::Version
-  version: 1.4.1
+  version: 1.4.2
 platform: ruby
 authors:
 - Esity
@@ -61,6 +61,7 @@ files:
 - lib/legion/logging.rb
 - lib/legion/logging/async_writer.rb
 - lib/legion/logging/builder.rb
+- lib/legion/logging/category_registry.rb
 - lib/legion/logging/event_builder.rb
 - lib/legion/logging/helper.rb
 - lib/legion/logging/logger.rb