lex-agentic-language 0.1.5 → 0.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cfc45bb896551c6c6b8a571a99711b6b789b47c1b79ae439911933805cab4ff7
-  data.tar.gz: 34c71727fcd33e721947a71d53d2ae003b64d47cd9c954be39fbf5b0c3924832
+  metadata.gz: 2c882ae8a5551a0d746effe0ed4bfe7c0ab1df089a494aa332db06c6ad654755
+  data.tar.gz: 832f52b494ed57900a3456d86ca9123177e58e308badd8b869cc8ca2e34fe2b5
 SHA512:
-  metadata.gz: 63c7b22d07e8ae61ca5360b2f1ee134c057c6e90470855570568574be3fb47e5862fca5f013e778afb9592203d32d0d78b15083dde9a6c5112f951f56cd2bee2
-  data.tar.gz: 92e8b78356b96eb26d4940acd4fc265e89b65180a8bd669f97a65b24929051bd6f0af1b1849f6bf4cefd70d7e9250d75ce348a89cde25ca07b035b25ddb4535b
+  metadata.gz: 897b30b1dce12487646fea641be95d4b7f67014e9485754818e1abce636ae20c5e5d720556bd995ea4afb36b0c15a08c3b2b4df6adec08d5e77315c0e7f80080
+  data.tar.gz: 3a571f5ec986c63f2b63c26cad9c1b271ec47e689fa6a95bbe24d525e714f7c0fbe82040b6505cd15eb6d0f2dde0dfbb005208045b105c98ac8ebc0e24e2a75c

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [0.1.7] - 2026-04-08
+
+### Fixed
+- log backtrace in narrator llm_enhancer when narrate raises, aiding error diagnosis
+- log warning in pipeline_available? rescue instead of silently swallowing errors
+- improve pipeline_available? indentation and add blank lines around private_class_method declarations
+
+## [0.1.6] - 2026-03-30
+
+### Changed
+- update to rubocop-legion 0.1.7, resolve all offenses
+
 ## [0.1.5] - 2026-03-26
 
 ### Changed

data/Gemfile

@@ -3,3 +3,5 @@
 source 'https://rubygems.org'
 
 gemspec
+
+gem 'rubocop-legion'

data/lex-agentic-language.gemspec

@@ -33,6 +33,7 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'legion-transport', '>= 1.3.9'
 
   spec.add_development_dependency 'rspec', '~> 3.13'
-  spec.add_development_dependency 'rubocop', '~> 1.60'
-  spec.add_development_dependency 'rubocop-rspec', '~> 2.26'
+  spec.add_development_dependency 'rubocop'
+  spec.add_development_dependency 'rubocop-legion'
+  spec.add_development_dependency 'rubocop-rspec'
 end

data/lib/legion/extensions/agentic/language/conceptual_blending/runners/conceptual_blending.rb

@@ -7,8 +7,8 @@ module Legion
         module ConceptualBlending
           module Runners
             module ConceptualBlending
-              include Legion::Extensions::Helpers::Lex if Legion::Extensions.const_defined?(:Helpers) &&
-                                                          Legion::Extensions::Helpers.const_defined?(:Lex)
+              include Legion::Extensions::Helpers::Lex if Legion::Extensions.const_defined?(:Helpers, false) &&
+                                                          Legion::Extensions::Helpers.const_defined?(:Lex, false)
 
               def create_mental_space(name:, domain:, **)
                 log.debug "[conceptual_blending] create_space: name=#{name} domain=#{domain}"

data/lib/legion/extensions/agentic/language/conceptual_metaphor/runners/conceptual_metaphor.rb

@@ -7,8 +7,8 @@ module Legion
         module ConceptualMetaphor
           module Runners
             module ConceptualMetaphor
-              include Legion::Extensions::Helpers::Lex if Legion::Extensions.const_defined?(:Helpers) &&
-                                                          Legion::Extensions::Helpers.const_defined?(:Lex)
+              include Legion::Extensions::Helpers::Lex if Legion::Extensions.const_defined?(:Helpers, false) &&
+                                                          Legion::Extensions::Helpers.const_defined?(:Lex, false)
 
               def create_metaphor(source_domain:, target_domain:, metaphor_type:,
                                   mappings:, strength: nil, conventionality: nil, **)

data/lib/legion/extensions/agentic/language/frame_semantics/helpers/client.rb

@@ -8,6 +8,7 @@ module Legion
           module Helpers
             class Client
               include Runners::FrameSemantics
+              include Legion::Logging::Helper
 
               private
 

data/lib/legion/extensions/agentic/language/frame_semantics/runners/frame_semantics.rb

@@ -6,17 +6,17 @@ module Legion
       module Language
         module FrameSemantics
           module Runners
-            module FrameSemantics
+            module FrameSemantics # rubocop:disable Legion/Extension/RunnerIncludeHelpers
               def create_semantic_frame(name:, domain:, **)
                 frame = engine.create_frame(name: name, domain: domain)
-                Legion::Logging.debug "[frame_semantics] created frame name=#{name} domain=#{domain} id=#{frame.id[0..7]}"
+                log.debug("[frame_semantics] created frame name=#{name} domain=#{domain} id=#{frame.id[0..7]}")
                 { frame_id: frame.id, name: frame.name, domain: frame.domain, created: true }
               end
 
               def define_frame_slot(frame_id:, name:, slot_type: :core, required: true, **)
                 frame = engine.define_slot(frame_id: frame_id, name: name, slot_type: slot_type, required: required)
                 if frame
-                  Legion::Logging.debug "[frame_semantics] defined slot #{name} on frame #{frame_id[0..7]}"
+                  log.debug("[frame_semantics] defined slot #{name} on frame #{frame_id[0..7]}")
                   { defined: true, frame_id: frame_id, slot_name: name, slot_type: slot_type }
                 else
                   { defined: false, reason: :frame_not_found }
@@ -26,7 +26,7 @@ module Legion
               def fill_frame_slot(frame_id:, slot_name:, filler:, **)
                 result = engine.fill_slot(frame_id: frame_id, slot_name: slot_name, filler: filler)
                 if result
-                  Legion::Logging.debug "[frame_semantics] filled slot #{slot_name} on frame #{frame_id[0..7]}"
+                  log.debug("[frame_semantics] filled slot #{slot_name} on frame #{frame_id[0..7]}")
                   { filled: true, frame_id: frame_id, slot_name: slot_name, filler: filler }
                 else
                   { filled: false, reason: :slot_or_frame_not_found }
@@ -36,7 +36,7 @@ module Legion
               def instantiate_semantic_frame(frame_id:, context:, confidence: 0.7, **)
                 instance = engine.instantiate_frame(frame_id: frame_id, context: context, confidence: confidence)
                 if instance
-                  Legion::Logging.debug "[frame_semantics] instantiated frame #{frame_id[0..7]} instance=#{instance.id[0..7]}"
+                  log.debug("[frame_semantics] instantiated frame #{frame_id[0..7]} instance=#{instance.id[0..7]}")
                   { instantiated: true, instance_id: instance.id, frame_id: frame_id,
                     filled_count: instance.filled_count }
                 else
@@ -48,7 +48,7 @@ module Legion
                 result = engine.add_frame_relation(frame_id: frame_id, relation: relation,
                                                    target_frame_id: target_frame_id)
                 if result
-                  Legion::Logging.debug "[frame_semantics] added relation #{relation} #{frame_id[0..7]}->#{target_frame_id[0..7]}"
+                  log.debug("[frame_semantics] added relation #{relation} #{frame_id[0..7]}->#{target_frame_id[0..7]}")
                   { added: true, frame_id: frame_id, relation: relation, target_frame_id: target_frame_id }
                 else
                   { added: false, reason: :invalid_frame_or_relation }
@@ -58,7 +58,7 @@ module Legion
               def activate_semantic_frame(frame_id:, **)
                 result = engine.activate_frame(frame_id: frame_id)
                 if result
-                  Legion::Logging.debug "[frame_semantics] activated frame #{frame_id[0..7]}"
+                  log.debug("[frame_semantics] activated frame #{frame_id[0..7]}")
                   { activated: true, frame_id: frame_id }
                 else
                   { activated: false, reason: :frame_not_found }
@@ -67,26 +67,26 @@ module Legion
 
               def active_frames_report(**)
                 frames = engine.active_frames
-                Legion::Logging.debug "[frame_semantics] active_frames count=#{frames.size}"
+                log.debug("[frame_semantics] active_frames count=#{frames.size}")
                 { frames: frames.map(&:to_h), count: frames.size }
               end
 
               def related_frames_report(frame_id:, **)
                 frames = engine.related_frames(frame_id: frame_id)
-                Legion::Logging.debug "[frame_semantics] related_frames frame=#{frame_id[0..7]} count=#{frames.size}"
+                log.debug("[frame_semantics] related_frames frame=#{frame_id[0..7]} count=#{frames.size}")
                 { frames: frames.map(&:to_h), count: frames.size }
               end
 
               def complete_frames_report(**)
                 frames = engine.complete_frames
-                Legion::Logging.debug "[frame_semantics] complete_frames count=#{frames.size}"
+                log.debug("[frame_semantics] complete_frames count=#{frames.size}")
                 { frames: frames.map(&:to_h), count: frames.size }
               end
 
               def update_frame_semantics(**)
                 engine.decay_all
                 engine.prune_inactive
-                Legion::Logging.debug '[frame_semantics] decay_all + prune_inactive complete'
+                log.debug('[frame_semantics] decay_all + prune_inactive complete')
                 { updated: true, stats: engine.to_h }
               end
 

data/lib/legion/extensions/agentic/language/grammar/runners/cognitive_grammar.rb

@@ -7,8 +7,8 @@ module Legion
         module Grammar
           module Runners
             module CognitiveGrammar
-              include Legion::Extensions::Helpers::Lex if Legion::Extensions.const_defined?(:Helpers) &&
-                                                          Legion::Extensions::Helpers.const_defined?(:Lex)
+              include Legion::Extensions::Helpers::Lex if Legion::Extensions.const_defined?(:Helpers, false) &&
+                                                          Legion::Extensions::Helpers.const_defined?(:Lex, false)
 
               def create_grammar_construction(form:, meaning:, expression_type:, domain:, **)
                 construction = engine.create_construction(

data/lib/legion/extensions/agentic/language/language/runners/language.rb

@@ -7,8 +7,8 @@ module Legion
         module Language
           module Runners
             module Language
-              include Legion::Extensions::Helpers::Lex if Legion::Extensions.const_defined?(:Helpers) &&
-                                                          Legion::Extensions::Helpers.const_defined?(:Lex)
+              include Legion::Extensions::Helpers::Lex if Legion::Extensions.const_defined?(:Helpers, false) &&
+                                                          Legion::Extensions::Helpers.const_defined?(:Lex, false)
 
               def summarize(domain:, depth: :standard, traces: [], **)
                 traces = filter_traces(traces, domain)

data/lib/legion/extensions/agentic/language/narrative_reasoning/runners/narrative_reasoning.rb

@@ -7,8 +7,8 @@ module Legion
         module NarrativeReasoning
           module Runners
             module NarrativeReasoning
-              include Legion::Extensions::Helpers::Lex if Legion::Extensions.const_defined?(:Helpers) &&
-                                                          Legion::Extensions::Helpers.const_defined?(:Lex)
+              include Legion::Extensions::Helpers::Lex if Legion::Extensions.const_defined?(:Helpers, false) &&
+                                                          Legion::Extensions::Helpers.const_defined?(:Lex, false)
 
               def create_narrative(title:, domain: nil, **)
                 narrative = narrative_engine.create_narrative(title: title, domain: domain)

data/lib/legion/extensions/agentic/language/narrator/helpers/llm_enhancer.rb

@@ -18,7 +18,7 @@ module Legion
 
               def available?
                 !!(defined?(Legion::LLM) && Legion::LLM.respond_to?(:started?) && Legion::LLM.started?)
-              rescue StandardError
+              rescue StandardError => _e
                 false
               end
 
@@ -27,7 +27,8 @@ module Legion
                 response = llm_ask(prompt)
                 parse_narrate_response(response)
               rescue StandardError => e
-                Legion::Logging.warn "[narrator:llm] narrate failed: #{e.message}"
+                Legion::Logging.warn("[narrator:llm] narrate failed: #{e.message}") # rubocop:disable Legion/HelperMigration/DirectLogging
+                Legion::Logging.warn(e.backtrace) # rubocop:disable Legion/HelperMigration/DirectLogging
                 nil
               end
 
@@ -43,20 +44,23 @@ module Legion
                   content = response&.message&.dig(:content)
                   ::Struct.new(:content).new(content) if content
                 else
-                  chat = Legion::LLM.chat
+                  chat = Legion::LLM.chat # rubocop:disable Legion/HelperMigration/DirectLlm
                   chat.with_instructions(SYSTEM_PROMPT)
                   chat.ask(prompt)
                 end
               end
+
               private_class_method :llm_ask
 
               def pipeline_available?
                 !!(defined?(Legion::LLM::Pipeline::GaiaCaller) &&
-                   Legion::LLM.respond_to?(:pipeline_enabled?) &&
-                   Legion::LLM.pipeline_enabled?)
-              rescue StandardError
+                  Legion::LLM.respond_to?(:pipeline_enabled?) &&
+                  Legion::LLM.pipeline_enabled?)
+              rescue StandardError => e
+                Legion::Logging.warn("pipeline_available? #{e.class}: #{e.message}") # rubocop:disable Legion/HelperMigration/DirectLogging
                 false
               end
+
               private_class_method :pipeline_available?
 
               def build_narrate_prompt(sections_data)
@@ -80,7 +84,8 @@ module Legion
               end
 
               def curiosity_section(cur)
-                "CURIOSITY:\n- Intensity: #{cur[:intensity] || 0.0}\n- Active questions: #{cur[:wonder_count] || 0}\n- Top question: #{cur[:top_wonder] || 'none'}"
+                "CURIOSITY:\n- Intensity: #{cur[:intensity] || 0.0}\n" \
+                  "- Active questions: #{cur[:wonder_count] || 0}\n- Top question: #{cur[:top_wonder] || 'none'}"
               end
 
               def prediction_section(pred)

data/lib/legion/extensions/agentic/language/narrator/runners/narrator.rb

@@ -7,8 +7,8 @@ module Legion
         module Narrator
           module Runners
             module Narrator
-              include Legion::Extensions::Helpers::Lex if Legion::Extensions.const_defined?(:Helpers) &&
-                                                          Legion::Extensions::Helpers.const_defined?(:Lex)
+              include Legion::Extensions::Helpers::Lex if Legion::Extensions.const_defined?(:Helpers, false) &&
+                                                          Legion::Extensions::Helpers.const_defined?(:Lex, false)
 
               def narrate(tick_results: {}, cognitive_state: {}, **)
                 entry = Helpers::Synthesizer.narrate(tick_results: tick_results, cognitive_state: cognitive_state)

data/lib/legion/extensions/agentic/language/pragmatic_inference/runners/pragmatic_inference.rb

@@ -7,8 +7,8 @@ module Legion
         module PragmaticInference
           module Runners
             module PragmaticInference
-              include Legion::Extensions::Helpers::Lex if Legion::Extensions.const_defined?(:Helpers) &&
-                                                          Legion::Extensions::Helpers.const_defined?(:Lex)
+              include Legion::Extensions::Helpers::Lex if Legion::Extensions.const_defined?(:Helpers, false) &&
+                                                          Legion::Extensions::Helpers.const_defined?(:Lex, false)
 
               def analyze_utterance(content:, speaker:, speech_act:, literal_meaning: nil,
                                     domain: nil, maxim_scores: {}, **)

data/lib/legion/extensions/agentic/language/version.rb

@@ -4,7 +4,7 @@ module Legion
   module Extensions
     module Agentic
       module Language
-        VERSION = '0.1.5'
+        VERSION = '0.1.7'
       end
     end
   end

data/lib/legion/extensions/agentic/language.rb

@@ -15,7 +15,7 @@ module Legion
   module Extensions
     module Agentic
       module Language
-        extend Legion::Extensions::Core if Legion::Extensions.const_defined? :Core
+        extend Legion::Extensions::Core if Legion::Extensions.const_defined? :Core, false
 
         def self.remote_invocable?
           false

data/spec/legion/extensions/agentic/language/language/helpers/summarizer_spec.rb

@@ -19,7 +19,7 @@ RSpec.describe Legion::Extensions::Agentic::Language::Language::Helpers::Summari
   end
 
   def make_traces(count, overrides = {})
-    count.times.map do |i|
+    Array.new(count) do |i|
       base_trace.merge(trace_id: "trace-#{i}").merge(overrides)
     end
   end

data/spec/legion/extensions/agentic/language/language/runners/language_spec.rb

@@ -21,7 +21,7 @@ RSpec.describe Legion::Extensions::Agentic::Language::Language::Runners::Languag
   end
 
   def make_traces(count, domain: :networking)
-    count.times.map do |i|
+    Array.new(count) do |i|
       base_trace.merge(
         trace_id:    "trace-#{i}",
         domain_tags: [domain],

data/spec/legion/extensions/agentic/language/narrator/helpers/llm_enhancer_spec.rb

@@ -84,6 +84,7 @@ RSpec.describe Legion::Extensions::Agentic::Language::Narrator::Helpers::LlmEnha
         stub_const('Legion::LLM', llm_double)
 
         expect(Legion::Logging).to receive(:warn).with(/narrator:llm.*narrate failed/)
+        expect(Legion::Logging).to receive(:warn).with(instance_of(Array))
         result = described_class.narrate(sections_data: sections_data)
         expect(result).to be_nil
       end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-agentic-language
 version: !ruby/object:Gem::Version
-  version: 0.1.5
+  version: 0.1.7
 platform: ruby
 authors:
 - Esity
@@ -125,30 +125,44 @@ dependencies:
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.60'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.60'
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop-legion
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rubocop-rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.26'
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.26'
+        version: '0'
 description: 'LEX agentic language domain: linguistic processing and communication'
 email:
 - matthewdiverson@gmail.com