legion-logging 1.3.2 → 1.3.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d2284e01a8b8c373629f5c7aaf8a648c06dd706a4a6d516cdc27a80ce63eb631
-  data.tar.gz: 6398739b5097e7cc59d2683e70eefbec5a305e0f85707a40f62ebcbd147176df
+  metadata.gz: ac6e65a10ce7708585f78114b5ee2d18303430e0d70b9039620f819a7de14325
+  data.tar.gz: fbf159026929b5d15668cd68aa5b0533f05d32ed67587389ade09a97bddc910c
 SHA512:
-  metadata.gz: bd5bbabd136edfc7079db6e7ff1a804839a9513e135f2594b0cfc43a17573d9aa0cf30f0d9a3c47e4e0fabf91cefb3772394076e98767b44adee9edaa940384f
-  data.tar.gz: a2fec71358fc96100f3fddae8002b762aad9381c5a030eec3c60b6d282f081204e6699d8f34a8a19901c104ae49d3ea708eca32bcccc793b265c50faad328c16
+  metadata.gz: 0a94512fdad36ed375ee678cc64bf7473496418cd3f25d560286d83f0db5af32c86eb262d489725bfc70b6e9e44724d197b8a85b4497073da6932f8a312c0682
+  data.tar.gz: f146a912510f6b0eba2e3b28bc86952330e8d31caaee509869ee116fa12c60a21c599af4c882c44524d674a0ccc1320eea5ab6a5f13afd9c770c5c0d5de35dd5

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Legion::Logging Changelog
 
+## [1.3.4] - 2026-03-24
+
+### Fixed
+- `EventBuilder#derive_lex_source` no longer blindly prepends `lex-` to all source names (was causing `add_gem_info` to fail for core gems like `legion-data` with `Could not find 'lex-data'`)
+- `EventBuilder#add_gem_info` now tries raw name, `lex-<name>`, and `legion-<name>` prefixes when resolving gem specs (extracted to `resolve_gem_spec` method)
+
+## [1.3.3] - 2026-03-24
+
+### Changed
+- Reindex docs: update CLAUDE.md and README with AsyncWriter and Helper module docs
+
 ## [1.3.2] - 2026-03-22
 
 ### Added

data/CLAUDE.md

@@ -8,7 +8,7 @@
 Ruby logging class for the LegionIO framework. Provides colorized console output via Rainbow, structured JSON logging (`format: :json`), and a consistent logging interface across all Legion gems and extensions.
 
 **GitHub**: https://github.com/LegionIO/legion-logging
-**Version**: 1.2.5
+**Version**: 1.3.2
 **License**: Apache-2.0
 
 ## Architecture
@@ -16,9 +16,11 @@ Ruby logging class for the LegionIO framework. Provides colorized console output
 ```
 Legion::Logging (singleton module)
 ├── Methods         # Log level methods: debug, info, warn, error, fatal, unknown
-├── Builder         # Output destination (stdout/file), log level, formatter
+├── Builder         # Output destination (stdout/file), log level, formatter, async: keyword
+├── AsyncWriter     # Non-blocking SizedQueue-backed writer thread; fatal calls bypass queue
 ├── Hooks           # Callback registry for fatal/error/warn events (on_fatal, on_error, on_warn)
 ├── EventBuilder    # Structured event payload builder (caller, exception, lex, gem metadata)
+├── Helper          # Injectable log mixin for LEX extensions (derives logger tags from segments/class)
 ├── Logger          # Core logger configuration and setup
 ├── MultiIO         # Write to multiple destinations simultaneously
 ├── SIEMExporter    # PHI-redacting SIEM export (Splunk HEC, ELK/OpenSearch)
@@ -31,13 +33,15 @@ Legion::Logging (singleton module)
 
 - **Singleton Module**: `Legion::Logging` uses `class << self` - called directly: `Legion::Logging.info("msg")`
 - **Rainbow Colorization**: Console output uses Rainbow gem for colored terminal output
-- **Setup Method**: `Legion::Logging.setup(log_file:, level:)` configures output destination and level
+- **Setup Method**: `Legion::Logging.setup(log_file:, level:, async: true)` configures output destination, level, and async mode
+- **Async by Default**: `setup` enables async logging — calls return immediately. Fatal calls always bypass the queue. `stop_async_writer` flushes and stops on shutdown. Buffer size configurable via `Legion::Settings.dig(:logging, :async, :buffer_size)` (default 10,000). Back-pressure: callers block when buffer is full.
 - **Structured JSON**: `format: :json` in settings outputs machine-parseable JSON log lines
 - **Shared Interface**: Same method signature (`info`, `warn`, `error`, etc.) across all Legion components
 - **MultiIO**: Splits writes to stdout and a log file simultaneously (used by Builder when `log_file` is set)
 - **SIEMExporter**: PHI redaction (SSN, phone, MRN, DOB patterns), `export_to_splunk` (HEC), `format_for_elk`
-- **Hook Callbacks**: `on_fatal`, `on_error`, `on_warn` register procs called after each log at those levels. Hooks are gated by `enable_hooks!`/`disable_hooks!`. Hook failures are silently rescued — never impact the logger.
+- **Hook Callbacks**: `on_fatal`, `on_error`, `on_warn` register procs called after each log at those levels. Hooks are gated by `enable_hooks!`/`disable_hooks!`. Hook failures are silently rescued — never impact the logger. Hooks fire on the async writer thread; event context captured on caller thread.
 - **EventBuilder**: Builds structured event hashes from log context (caller location, exception info, lex identity, gem metadata). All from in-memory data, zero IO.
+- **Helper mixin**: `Legion::Logging::Helper` is injectable into LEX extensions. Derives logger tags from `segments`, `lex_filename`, or class name. Passes through `settings[:logger]` config when available.
 
 ## Dependencies
 
@@ -51,7 +55,9 @@ Legion::Logging (singleton module)
 |------|---------|
 | `lib/legion/logging.rb` | Module entry point |
 | `lib/legion/logging/methods.rb` | Log level methods |
-| `lib/legion/logging/builder.rb` | Output config and formatter |
+| `lib/legion/logging/builder.rb` | Output config and formatter (async: keyword) |
+| `lib/legion/logging/async_writer.rb` | Non-blocking SizedQueue-backed writer thread with back-pressure |
+| `lib/legion/logging/helper.rb` | Injectable log mixin for LEX extensions |
 | `lib/legion/logging/logger.rb` | Core logger setup |
 | `lib/legion/logging/multi_io.rb` | Multi-output IO (write to multiple destinations simultaneously) |
 | `lib/legion/logging/siem_exporter.rb` | PHI-redacting SIEM export helpers (Splunk HEC, ELK format) |

data/README.md

@@ -2,7 +2,7 @@
 
 Logging module for the [LegionIO](https://github.com/LegionIO/LegionIO) framework. Provides colorized console output via Rainbow, structured JSON logging, multi-output IO, and a consistent logging interface across all Legion gems and extensions.
 
-**Version**: 1.3.0
+**Version**: 1.3.2
 
 ## Installation
 
@@ -79,6 +79,21 @@ Legion::Logging::SIEMExporter.format_for_elk(event, index: 'legion')
 
 PHI patterns redacted: SSN (`###-##-####`), phone (`###-###-####`), MRN (`XX#######`), DOB (`##/##/####`).
 
+### Helper Mixin
+
+`Legion::Logging::Helper` is an injectable mixin for LEX extensions. It derives logger tags from `segments`, `lex_filename`, or class name automatically, and passes through `settings[:logger]` config when available. Allows LEX gems to use `legion-logging` directly without requiring the full LegionIO framework.
+
+```ruby
+class MyRunner
+  include Legion::Logging::Helper
+
+  def run
+    log.info("starting")
+    log.debug("details")
+  end
+end
+```
+
 ## Requirements
 
 - Ruby >= 3.4

data/lib/legion/logging/event_builder.rb

@@ -29,9 +29,9 @@ module Legion
 
         def derive_lex_source(lex, lex_segments)
           if lex_segments.is_a?(Array) && !lex_segments.empty?
-            "lex-#{lex_segments.join('-')}"
+            lex_segments.join('-')
           elsif lex && !lex.to_s.empty?
-            "lex-#{lex}"
+            lex.to_s
           end
         end
 
@@ -71,7 +71,9 @@ module Legion
         def add_gem_info(event, lex_source)
           return unless lex_source
 
-          spec = Gem::Specification.find_by_name(lex_source)
+          spec = resolve_gem_spec(lex_source)
+          return unless spec
+
           event[:gem] = {
             name:            spec.name,
             version:         spec.version.to_s,
@@ -79,8 +81,14 @@ module Legion
             homepage:        spec.metadata['homepage_uri'] || spec.homepage,
             path:            spec.full_gem_path
           }.compact
-        rescue Gem::MissingSpecError, ArgumentError => e
-          warn("Legion::Logging::EventBuilder#add_gem_info failed for #{lex_source}: #{e.message}")
+        end
+
+        def resolve_gem_spec(name)
+          [name, "lex-#{name}", "legion-#{name}"].each do |candidate|
+            return Gem::Specification.find_by_name(candidate)
+          rescue Gem::MissingSpecError
+            next
+          end
           nil
         end
 

data/lib/legion/logging/version.rb

@@ -2,6 +2,6 @@
 
 module Legion
   module Logging
-    VERSION = '1.3.2'
+    VERSION = '1.3.4'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: legion-logging
 version: !ruby/object:Gem::Version
-  version: 1.3.2
+  version: 1.3.4
 platform: ruby
 authors:
 - Esity