lex-apollo 0.4.2 → 0.4.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 58044db4866170db60e7607b6dd9d5afcf56118c5d8373c180d9618480b59c82
-  data.tar.gz: c29bca810b4c41aed2093ee2ee64d12608d53a12d0401a47911b25ca2b9c3705
+  metadata.gz: 37b431f37cdc8eb57e8a6ebdd1961a73e8259c2dff9f3cbb8c62f00d468b7355
+  data.tar.gz: ebc63f21a7076df86cc10b6e68bda68fa0bbfa661fa242eb09dddb2f7502f431
 SHA512:
-  metadata.gz: 2f72472b867e644ca58175c5fb7d3d0300a44e2e52fca0d75fd8000d2deae5ef524a29a93418f3be20d074037493d541bd2ddeb7c3b4c0cbdaf0869934147ec6
-  data.tar.gz: 0aeee79c5734195652092460791ea4089a8c4e71bcf141f33bb01c0c478dc4ddb44e26410e0d7607270f7fec172131687b58c794c0b9f60bad95a44c676257b2
+  metadata.gz: 3945caccdf6763705e4f0bd9064b638a8c10920a5c802b2dfe3fde93822569af6fd70bd32097987a60a81f209ad844bc0248f92fbc096f68a30857eeee999cf6
+  data.tar.gz: cc44d3e686c933d4d662ce2c03e2ccb2a1b10a58992e354d94bd5f805d99f676abafdcca047539b22505cf35ccb85306b785e56c65f9aca19e8548a8492b8b87

data/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [0.4.3] - 2026-03-24
+
+### Fixed
+- Embedding `generate()` now calls `Legion::LLM.embed(text)` with positional arg and extracts `:vector` from the returned Hash (was passing keyword arg to positional param and checking for Array instead of Hash — zero vectors on every call)
+- Added warning logging when embeddings fall back to zero vectors (was completely silent)
+- GasSubscriber now overrides `create_queue` to bind `apollo.gas` queue to `llm.audit` exchange with routing key `llm.audit.complete` (was bound to the wrong exchange with wrong routing key — GAS pipeline never received messages)
+- Renamed `Queues::Gas` to `Queues::GasSubscriber` and `Queues::Query` to `Queues::QueryResponder` to match Subscription actor constant lookup convention
+- Added `Transport::Exchanges::LlmAudit` exchange class for the `llm.audit` exchange
+- Decay actor `runner_function` changed from `'force_decay'` (a no-op message builder) to `'run_decay_cycle'` (the actual DB decay implementation — confidence decay was never running)
+- Removed dead `PhaseWiring.register_handler(:post_tick_reflection)` call from entry point (method does not exist in legion-gaia; entity watchdog runs independently as an Every actor)
+
+### Changed
+- Embedding dimension is now configurable via `Legion::Settings[:apollo][:embedding][:dimension]` (default: 1536)
+
 ## [0.4.2] - 2026-03-24
 
 ### Fixed

data/lib/legion/extensions/apollo/actors/decay.rb

@@ -9,7 +9,7 @@ module Legion
       module Actor
         class Decay < Legion::Extensions::Actors::Every
           def runner_class    = Legion::Extensions::Apollo::Runners::Maintenance
-          def runner_function = 'force_decay'
+          def runner_function = 'run_decay_cycle'
           def time            = 3600
           def run_now?        = false
           def use_runner?     = false

data/lib/legion/extensions/apollo/actors/gas_subscriber.rb

@@ -11,6 +11,7 @@ module Legion
           def runner_function = 'process'
           def check_subtask?  = false
           def generate_task?  = false
+          def use_runner?     = false
 
           def enabled?
             defined?(Legion::Extensions::Apollo::Runners::Gas) &&
@@ -18,6 +19,15 @@ module Legion
           rescue StandardError
             false
           end
+
+          def create_queue
+            return if queues.const_defined?(:GasSubscriber, false)
+
+            queues.const_set(:GasSubscriber, Apollo::Transport::Queues::GasSubscriber) unless queues.const_defined?(:GasSubscriber, false)
+            exchange_object = Apollo::Transport::Exchanges::LlmAudit.new
+            queue_object = Apollo::Transport::Queues::GasSubscriber.new
+            queue_object.bind(exchange_object, routing_key: 'llm.audit.complete')
+          end
         end
       end
     end

data/lib/legion/extensions/apollo/helpers/embedding.rb

@@ -10,19 +10,32 @@ module Legion
           module_function
 
           def generate(text:, **)
-            return zero_vector unless defined?(Legion::LLM) && Legion::LLM.started?
+            unless defined?(Legion::LLM) && Legion::LLM.started?
+              Legion::Logging.debug('[apollo] embedding fallback: LLM not started') if defined?(Legion::Logging)
+              return zero_vector
+            end
 
-            result = Legion::LLM.embed(text: text)
-            if result.is_a?(Array) && result.any?
-              @dimension = result.size
-              result
+            result = Legion::LLM.embed(text)
+            vector = result.is_a?(Hash) ? result[:vector] : result
+            if vector.is_a?(Array) && vector.any?
+              @dimension = vector.size
+              vector
             else
+              Legion::Logging.warn('[apollo] embedding fallback: LLM returned no vector') if defined?(Legion::Logging)
               zero_vector
             end
           end
 
           def dimension
-            @dimension || DEFAULT_DIMENSION
+            @dimension || configured_dimension
+          end
+
+          def configured_dimension
+            return DEFAULT_DIMENSION unless defined?(Legion::Settings) && !Legion::Settings[:apollo].nil?
+
+            Legion::Settings[:apollo].dig(:embedding, :dimension) || DEFAULT_DIMENSION
+          rescue StandardError
+            DEFAULT_DIMENSION
           end
 
           def zero_vector

data/lib/legion/extensions/apollo/transport/exchanges/llm_audit.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require 'legion/transport/exchange' if defined?(Legion::Transport)
+
+module Legion
+  module Extensions
+    module Apollo
+      module Transport
+        module Exchanges
+          class LlmAudit < Legion::Transport::Exchange
+            def exchange_name
+              'llm.audit'
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/apollo/transport/queues/gas.rb

@@ -7,7 +7,7 @@ module Legion
     module Apollo
       module Transport
         module Queues
-          class Gas < Legion::Transport::Queue
+          class GasSubscriber < Legion::Transport::Queue
             def queue_name
               'apollo.gas'
             end

data/lib/legion/extensions/apollo/transport/queues/query.rb

@@ -7,7 +7,7 @@ module Legion
     module Apollo
       module Transport
         module Queues
-          class Query < Legion::Transport::Queue
+          class QueryResponder < Legion::Transport::Queue
             def queue_name
               'apollo.query'
             end

data/lib/legion/extensions/apollo/version.rb

@@ -3,7 +3,7 @@
 module Legion
   module Extensions
     module Apollo
-      VERSION = '0.4.2'
+      VERSION = '0.4.3'
     end
   end
 end

data/lib/legion/extensions/apollo.rb

@@ -12,6 +12,7 @@ require 'legion/extensions/apollo/runners/gas'
 
 if defined?(Legion::Transport)
   require 'legion/extensions/apollo/transport/exchanges/apollo'
+  require 'legion/extensions/apollo/transport/exchanges/llm_audit'
   require 'legion/extensions/apollo/transport/queues/ingest'
   require 'legion/extensions/apollo/transport/queues/query'
   require 'legion/extensions/apollo/transport/queues/gas'
@@ -27,19 +28,5 @@ module Legion
   end
 end
 
-# Entity watchdog on post_tick_reflection
-if defined?(Legion::Gaia::PhaseWiring) && begin
-  Legion::Settings.dig(:apollo, :entity_watchdog, :enabled)
-rescue StandardError
-  false
-end
-  require 'legion/extensions/apollo/helpers/entity_watchdog'
-  Legion::Gaia::PhaseWiring.register_handler(:post_tick_reflection) do |tick_results|
-    text = tick_results.is_a?(Hash) ? (tick_results[:content] || tick_results[:output] || '').to_s : tick_results.to_s
-    entities = Legion::Extensions::Apollo::Helpers::EntityWatchdog.detect_entities(text: text)
-    if entities.any?
-      Legion::Extensions::Apollo::Helpers::EntityWatchdog.link_or_create(entities:       entities,
-                                                                         source_context: tick_results[:tick_id])
-    end
-  end
-end
+# Entity watchdog runs as Actor::EntityWatchdog (Every actor, 120s interval).
+# PhaseWiring.register_handler was removed — the watchdog scans task logs independently.

data/spec/legion/extensions/apollo/actors/decay_spec.rb

@@ -23,8 +23,8 @@ RSpec.describe Legion::Extensions::Apollo::Actor::Decay do
     expect(actor.runner_class).to eq(Legion::Extensions::Apollo::Runners::Maintenance)
   end
 
-  it 'runs force_decay function' do
-    expect(actor.runner_function).to eq('force_decay')
+  it 'runs run_decay_cycle function' do
+    expect(actor.runner_function).to eq('run_decay_cycle')
   end
 
   it 'runs every 3600 seconds' do

data/spec/legion/extensions/apollo/gaia_integration_spec.rb

@@ -64,10 +64,9 @@ RSpec.describe Legion::Extensions::Apollo::GaiaIntegration do
       expect(result[:success]).to be true
     end
 
-    it 'entry point has entity watchdog registration block' do
+    it 'entry point documents entity watchdog actor' do
       entry_point = File.read(File.expand_path('../../../../lib/legion/extensions/apollo.rb', __dir__))
-      expect(entry_point).to include('entity_watchdog')
-      expect(entry_point).to include('PhaseWiring.register_handler(:post_tick_reflection)')
+      expect(entry_point).to include('Entity watchdog runs as Actor::EntityWatchdog')
     end
   end
 end

data/spec/legion/extensions/apollo/helpers/embedding_spec.rb

@@ -29,22 +29,22 @@ RSpec.describe Legion::Extensions::Apollo::Helpers::Embedding do
     end
 
     context 'when Legion::LLM is available and started' do
-      let(:mock_embedding) { Array.new(1536) { rand(-1.0..1.0) } }
+      let(:mock_vector) { Array.new(1536) { rand(-1.0..1.0) } }
 
       before do
         llm = Module.new do
           define_method(:started?) { true }
-          define_method(:embed) { |_text:| nil }
+          define_method(:embed) { |_text, **| nil }
           extend self
         end
         stub_const('Legion::LLM', llm)
-        allow(Legion::LLM).to receive(:embed).and_return(mock_embedding)
+        allow(Legion::LLM).to receive(:embed).and_return({ vector: mock_vector, model: 'text-embedding-3-small' })
       end
 
-      it 'returns the embedding from LLM' do
+      it 'returns the vector from the LLM response hash' do
         result = described_class.generate(text: 'hello world')
-        expect(result).to eq(mock_embedding)
-        expect(Legion::LLM).to have_received(:embed).with(text: 'hello world')
+        expect(result).to eq(mock_vector)
+        expect(Legion::LLM).to have_received(:embed).with('hello world')
       end
     end
 
@@ -52,11 +52,11 @@ RSpec.describe Legion::Extensions::Apollo::Helpers::Embedding do
       before do
         llm = Module.new do
           define_method(:started?) { true }
-          define_method(:embed) { |_text:| nil }
+          define_method(:embed) { |_text, **| nil }
           extend self
         end
         stub_const('Legion::LLM', llm)
-        allow(Legion::LLM).to receive(:embed).and_return([0.1, 0.2])
+        allow(Legion::LLM).to receive(:embed).and_return({ vector: [0.1, 0.2], model: 'test' })
       end
 
       it 'accepts the embedding and updates dimension' do
@@ -66,11 +66,29 @@ RSpec.describe Legion::Extensions::Apollo::Helpers::Embedding do
       end
     end
 
+    context 'when Legion::LLM returns nil vector' do
+      before do
+        llm = Module.new do
+          define_method(:started?) { true }
+          define_method(:embed) { |_text, **| nil }
+          extend self
+        end
+        stub_const('Legion::LLM', llm)
+        allow(Legion::LLM).to receive(:embed).and_return({ vector: nil, model: 'test', error: 'failed' })
+      end
+
+      it 'returns a zero vector as fallback' do
+        result = described_class.generate(text: 'hello world')
+        expect(result).to be_an(Array)
+        expect(result.all?(&:zero?)).to be true
+      end
+    end
+
     context 'when Legion::LLM returns nil' do
       before do
         llm = Module.new do
           define_method(:started?) { true }
-          define_method(:embed) { |_text:| nil }
+          define_method(:embed) { |_text, **| nil }
           extend self
         end
         stub_const('Legion::LLM', llm)
@@ -84,4 +102,26 @@ RSpec.describe Legion::Extensions::Apollo::Helpers::Embedding do
       end
     end
   end
+
+  describe '.configured_dimension' do
+    context 'when Settings has apollo.embedding.dimension' do
+      before do
+        stub_const('Legion::Settings', { apollo: { embedding: { dimension: 768 } } })
+      end
+
+      it 'returns the configured dimension' do
+        expect(described_class.configured_dimension).to eq(768)
+      end
+    end
+
+    context 'when Settings has no apollo key' do
+      before do
+        stub_const('Legion::Settings', { apollo: nil })
+      end
+
+      it 'returns the default dimension' do
+        expect(described_class.configured_dimension).to eq(1536)
+      end
+    end
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-apollo
 version: !ruby/object:Gem::Version
-  version: 0.4.2
+  version: 0.4.3
 platform: ruby
 authors:
 - Esity
@@ -167,6 +167,7 @@ files:
 - lib/legion/extensions/apollo/runners/maintenance.rb
 - lib/legion/extensions/apollo/transport.rb
 - lib/legion/extensions/apollo/transport/exchanges/apollo.rb
+- lib/legion/extensions/apollo/transport/exchanges/llm_audit.rb
 - lib/legion/extensions/apollo/transport/messages/ingest.rb
 - lib/legion/extensions/apollo/transport/messages/query.rb
 - lib/legion/extensions/apollo/transport/queues/gas.rb