legion-transport 1.3.0 → 1.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 55c23d109605074f58032f420c732b94ab43df16c73d5b2d0fe7aeedc2b66918
-  data.tar.gz: 7f80b6e30c52a32bd367a1a98ddd867e462affaf6f72885c2bb17ad2f215b2b8
+  metadata.gz: 131a06c178704a57af2c9baef440704001342842e02d15a090297c09572505b5
+  data.tar.gz: e30dd4bdaac3fdfb42cf588f9512f3a3b930ae840b79f34ea073a960276e7fbb
 SHA512:
-  metadata.gz: 579732a7b2688876efbecbdfeb26ece70d24d2a596104b87920cb8663f1ff61f0cb1baabe02158756a2408eaac4603360ef8902b443c1be20acbab674f4f0ceb
-  data.tar.gz: 05d79297bc68c5820c252ce6513c488807d2c4e323c77ad4d680dffdd5334cd7c466d9676f3048fe45cb092741fbe0d7ab45b104140989bb114e29bec9dd4d81
+  metadata.gz: 89b5e05ec97fad24f0e191ac67bf4362afe758d1d4b1481629b6fa5575355e0ec56fa793d78d0f2cf3111213bf1087865d6c3791c234e41884adf3d13bf28568
+  data.tar.gz: 41bff2584db88fd03cc904bbe2996c628d4fdf689f6b793557f6207efb31fa808ad95e9e0aaa350026760d06c95e0411c62e75c9ca6087f21e6d1dd5a3f99acb

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Legion::Transport ChangeLog
 
+## [1.3.2] - 2026-03-21
+
+### Added
+- `Legion::Transport::Exchanges::Logging`: topic exchange (`legion.logging`) for structured log event publishing
+- `Legion::Transport::Queues::RegionOutbound`: durable outbound queues for cross-region message routing (per-peer, skips current region)
+- `Legion::Transport::Messages::RegionReRoute`: re-route message type for forwarding tasks to target regions
+
 ## [1.3.0] - 2026-03-21
 
 ### Added

data/CLAUDE.md

@@ -25,7 +25,8 @@ Legion::Transport
 │       ├── Agent       # Agent communication exchange (identity-bound: GAIA frames, preferences, proactive)
 │       ├── Crypt       # Encryption exchange
 │       ├── Extensions  # Extension exchange
-│       └── Lex         # LEX exchange (inherits Extensions)
+│       ├── Lex         # LEX exchange (inherits Extensions)
+│       └── Logging     # Log event exchange (legion.logging) for structured log event publishing
 ├── Queue               # Base queue class (extends Bunny::Queue)
 │   └── Queues/
 │       ├── Node        # Node queue

data/CODEOWNERS

@@ -0,0 +1 @@
+* @Esity

data/lib/legion/transport/exchanges/logging.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Legion
+  module Transport
+    module Exchanges
+      class Logging < Legion::Transport::Exchange
+        def exchange_name
+          'legion.logging'
+        end
+      end
+    end
+  end
+end

data/lib/legion/transport/message.rb

@@ -125,6 +125,7 @@ module Legion
         @options[:headers] ||= Concurrent::Hash.new
         @options[:headers]['legion_protocol_version'] ||= '2.0'
         inject_region_header
+        inject_legion_region_header
         %i[task_id relationship_id trigger_namespace_id trigger_function_id parent_id master_id runner_namespace runner_class namespace_id function_id function
            chain_id debug].each do |header|
           next unless @options.key? header
@@ -182,6 +183,17 @@ module Legion
         @options[:headers]['x-legion-region-affinity'] = affinity
       end
 
+      def inject_legion_region_header
+        return unless defined?(Legion::Region) &&
+                      Legion::Region.respond_to?(:current) &&
+                      Legion::Region.current
+
+        @options[:headers]['region'] = Legion::Region.current
+        @options[:headers]['region_affinity'] = @options[:region_affinity] ||
+                                                (defined?(Legion::Settings) && Legion::Settings.dig(:region, :default_affinity)) ||
+                                                'prefer_local'
+      end
+
       def spool_message(error)
         return unless defined?(Legion::Transport::Spool)
 

data/lib/legion/transport/messages/region_re_route.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module Legion
+  module Transport
+    module Messages
+      class RegionReRoute < Legion::Transport::Message
+        def exchange
+          Legion::Transport::Exchanges::Task
+        end
+
+        def routing_key
+          "region.reroute.#{target_region}"
+        end
+
+        def message
+          {
+            original_payload: @options[:original_payload] || @options.except(:target_region),
+            target_region:    target_region,
+            source_region:    source_region,
+            rerouted_at:      Time.now.to_i
+          }
+        end
+
+        def validate
+          raise ArgumentError, 'target_region is required' unless @options[:target_region].is_a?(String) && !@options[:target_region].empty?
+
+          @valid = true
+        end
+
+        private
+
+        def target_region
+          @options[:target_region]
+        end
+
+        def source_region
+          @options[:source_region] ||
+            (defined?(Legion::Settings) && Legion::Settings.dig(:region, :current)) ||
+            'unknown'
+        end
+      end
+    end
+  end
+end

data/lib/legion/transport/queue.rb

@@ -84,3 +84,4 @@ require_relative 'queues/node_status'
 require_relative 'queues/task_log'
 require_relative 'queues/task_update'
 require_relative 'queues/agent'
+require_relative 'queues/region_outbound'

data/lib/legion/transport/queues/region_outbound.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Legion
+  module Transport
+    module Queues
+      module RegionOutbound
+        module_function
+
+        def declare_all
+          peers = defined?(Legion::Settings) && Legion::Settings.dig(:region, :peers)
+          return [] unless peers.is_a?(Array) && !peers.empty?
+
+          current = defined?(Legion::Region) ? Legion::Region.current : nil
+          peers.reject { |p| p == current }.map do |peer|
+            declare_outbound(peer)
+          end
+        end
+
+        def declare_outbound(target_region)
+          queue_name = queue_name_for(target_region)
+          channel = Legion::Transport::Connection.channel
+          channel.queue(
+            queue_name,
+            durable:   true,
+            arguments: { 'x-dead-letter-exchange' => 'tasks.dlx' }
+          )
+        rescue StandardError => e
+          Legion::Transport.logger.warn "RegionOutbound: failed to declare queue for #{target_region}: #{e.message}"
+          nil
+        end
+
+        def queue_name_for(target_region)
+          "legion.tasks.outbound.#{target_region}"
+        end
+      end
+    end
+  end
+end

data/lib/legion/transport/version.rb

@@ -2,6 +2,6 @@
 
 module Legion
   module Transport
-    VERSION = '1.3.0'
+    VERSION = '1.3.2'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: legion-transport
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.3.2
 platform: ruby
 authors:
 - Esity
@@ -94,6 +94,7 @@ files:
 - ".rubocop.yml"
 - CHANGELOG.md
 - CLAUDE.md
+- CODEOWNERS
 - Gemfile
 - LICENSE
 - README.md
@@ -110,6 +111,7 @@ files:
 - lib/legion/transport/exchanges/crypt.rb
 - lib/legion/transport/exchanges/extensions.rb
 - lib/legion/transport/exchanges/lex.rb
+- lib/legion/transport/exchanges/logging.rb
 - lib/legion/transport/exchanges/node.rb
 - lib/legion/transport/exchanges/task.rb
 - lib/legion/transport/helpers/channel_pool.rb
@@ -120,6 +122,7 @@ files:
 - lib/legion/transport/messages/check_subtask.rb
 - lib/legion/transport/messages/dynamic.rb
 - lib/legion/transport/messages/lex_register.rb
+- lib/legion/transport/messages/region_re_route.rb
 - lib/legion/transport/messages/request_cluster_secret.rb
 - lib/legion/transport/messages/subtask.rb
 - lib/legion/transport/messages/task.rb
@@ -130,6 +133,7 @@ files:
 - lib/legion/transport/queues/node.rb
 - lib/legion/transport/queues/node_crypt.rb
 - lib/legion/transport/queues/node_status.rb
+- lib/legion/transport/queues/region_outbound.rb
 - lib/legion/transport/queues/task_log.rb
 - lib/legion/transport/queues/task_update.rb
 - lib/legion/transport/settings.rb