legion-logging 1.5.1 → 1.5.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 46129a3dbab733493155c3883562e0b8f867959f9749b0ead2c55096eaaa91f0
-  data.tar.gz: e5de12a36bdaa85ceca97cf8936312257ad607393b56fa3663ac0f827d850315
+  metadata.gz: 57e4eef04828ffa39cae5277822be4f2f5264d4010b05e724dbb179f0af5b771
+  data.tar.gz: 740663a6979cf6b5c5d90a12bc8c43e0fcd989b8d8253269d8a1f1bf9aff9d03
 SHA512:
-  metadata.gz: cbedead38cab56af14b780484b110f6f9a8bb6fbc28934478f203d02dea738208fe9fbc63e3c7bdb8d8cc90a33b3328ba39e5059cff85a0ab8be7e83a7068c7f
-  data.tar.gz: 337d49c5e424fc9cf487cec98295e4fd80a71da2882a5892c2b478d896cf05e52f6f10632719737df4072abbc555193c1475ae7b01d0e9f51d88ac5df3cc62fc
+  metadata.gz: c590642e775a8f6ed7f87f9b4525049033c3e3f42635ea2e460e5b4ddd89e646a97d8744b80755a82db340ba6e813d8e95e3a8b27ffc17a63f8f3aee99e5b5a6
+  data.tar.gz: b812f47d57057a466655f22ae1f3922b6326a22fd40297ce602850069092efaf20ff40a6689ecbfe22a7498429bb3266df70ec40efb69617d11da045695155bd

data/.gitignore

@@ -9,7 +9,8 @@
 /tmp/
 /legion/.idea/
 /.idea/
+*.gem
 *.key
 # rspec failure tracking
 .rspec_status
-legionio.key
+legionio.key

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Legion::Logging Changelog
 
+## [1.5.2] - 2026-04-27
+
+### Changed
+- Exception stdout/file log lines now include the full backtrace instead of truncating after 10 frames with a `... N more` suffix.
+
 ## [1.5.1] - 2026-04-08
 
 ### Added

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.5.0
+**Version**: 1.5.2
 
 ## Installation
 
@@ -96,23 +96,46 @@ end
 
 ### Exception Logging
 
-`log_exception` provides a single call for complete structured exception events with component context:
+`log_exception` provides a single call for complete exception logging with component context. It writes a human-readable exception line through the configured logger and publishes a structured exception event when an `exception_writer` is configured.
 
 ```ruby
-Legion::Logging.log_exception(exception,
-  handled: true,
-  component_type: :runner,
-  lex: 'my_extension',
-  task_id: 'abc-123')
+begin
+  runner.call
+rescue StandardError => e
+  Legion::Logging.log_exception(
+    e,
+    handled: true,
+    component_type: :runner,
+    lex: 'my_extension',
+    task_id: 'abc-123'
+  )
+end
 ```
 
+The synchronous log line includes the full Ruby backtrace. Legion does not truncate it to a fixed frame count or replace the tail with `... N more`, because the missing frames are often the useful part of production failures.
+
+Structured exception events include:
+
+- exception class and message
+- full backtrace array
+- caller file, line, and function where available
+- log level and handled/unhandled status
+- component type, lex name, gem name, version, and source path metadata
+- task and thread context
+- stable error fingerprint for deduplication
+
 ### Writer Lambdas
 
 `log_writer` and `exception_writer` are pluggable lambda slots that replace the old Hooks system. Assign them to forward events to external systems:
 
 ```ruby
-Legion::Logging.exception_writer = ->(payload, routing_key:, headers:, properties:) { publish_to_amqp(payload) }
-Legion::Logging.log_writer = ->(context, routing_key:) { publish_log(context) }
+Legion::Logging.exception_writer = lambda do |payload, routing_key:, headers:, properties:|
+  publish_to_amqp(payload, routing_key:, headers:, properties:)
+end
+
+Legion::Logging.log_writer = lambda do |context, routing_key:|
+  publish_log(context, routing_key:)
+end
 ```
 
 ### EventBuilder
@@ -121,7 +144,9 @@ Legion::Logging.log_writer = ->(context, routing_key:) { publish_log(context) }
 
 ### Redactor
 
-`Legion::Logging::Redactor` redacts PII/PHI patterns (SSN, phone, MRN, DOB) plus Vault tokens, JWTs, bearer tokens, and lease IDs from log messages. Redaction is opt-in: load the module (for example via `require 'legion/logging/redactor'`) and enable it with `logging.redaction.enabled: true`. When loaded and enabled, it is wired into all log methods in the write path.
+`Legion::Logging::Redactor` redacts PII/PHI patterns (SSN, email, phone, MRN, DOB, credit card) plus Vault tokens, JWTs, bearer tokens, `vault://` URIs, `lease://` URIs, and lease IDs from log messages. Redaction is opt-in for text log lines: load the module (for example via `require 'legion/logging/redactor'`) and enable it with `logging.redaction.enabled: true`. When loaded and enabled, it is wired into all log methods in the write path.
+
+Structured exception events are redacted before publishing when the redactor is loaded. This includes event identity fields such as `user`, so email-shaped local usernames are not forwarded raw.
 
 ## Requirements
 

data/lib/legion/logging/helper.rb

@@ -32,7 +32,6 @@ module Legion
         'middleware' => :middleware
       }.freeze
 
-      EXCEPTION_BACKTRACE_LIMIT = 10
       EXCEPTION_PRIORITY = { warn: 0, error: 5, fatal: 9 }.freeze
       EXCEPTION_COLORS = {
         fatal:   :darkred,
@@ -489,11 +488,7 @@ module Legion
         lines << "  #{context_line}" unless context_line.empty?
 
         bt = exception.backtrace
-        if bt&.any?
-          bt.first(EXCEPTION_BACKTRACE_LIMIT).each { |frame| lines << "  #{frame}" }
-          remaining = bt.length - EXCEPTION_BACKTRACE_LIMIT
-          lines << "  ... #{remaining} more" if remaining.positive?
-        end
+        bt.each { |frame| lines << "  #{frame}" } if bt&.any?
 
         lines.join("\n")
       end

data/lib/legion/logging/methods.rb

@@ -109,11 +109,8 @@ module Legion
         msg = maybe_redact(msg)
         bt = Array(exception.backtrace)
         if bt.any?
-          limit = defined?(Legion::Logging::Helper::EXCEPTION_BACKTRACE_LIMIT) ? Legion::Logging::Helper::EXCEPTION_BACKTRACE_LIMIT : 10
           lines = ["#{exception.class}: #{msg}"]
-          bt.first(limit).each { |frame| lines << "  #{frame}" }
-          remaining = bt.length - limit
-          lines << "  ... #{remaining} more" if remaining.positive?
+          bt.each { |frame| lines << "  #{frame}" }
           msg = lines.join("\n")
         end
         log.public_send(level, msg) if respond_to?(:log) && log.respond_to?(level)

data/lib/legion/logging/version.rb

@@ -2,6 +2,6 @@
 
 module Legion
   module Logging
-    VERSION = '1.5.1'
+    VERSION = '1.5.2'
   end
 end

metadata

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