lex-agentic-language 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 664d19699b188ee30a787c5c5e24211c920e81492f03da70ed7a8d0a0359a5ad
-  data.tar.gz: 437b2eb7099d2bfeeeb8d3ed027f6f4a4fdc14f867944688b602bfd5c31dd9f3
+  metadata.gz: 7385a20e866c7daaa84f1e931956a482fa0f08e37f23d768734309b28bc79e8b
+  data.tar.gz: 557bfdb9770c961b4996fb573854656378f7efd804e3f8e29642c12ea0bcc7a8
 SHA512:
-  metadata.gz: '043782a4236c9b1a204170f7e06614dde8eaac0633efb623333c4b3f0b09de34d6ad4393db898f984bc1d40ccd59cf54463cb6c377bda76b06be3855b85fda94'
-  data.tar.gz: de3e90307844b393b1eb991df41ad8fe29eeb46297f2df29f8e41281f52df10d0c15d7ce32477356276d6fce30c54bfb4618330357ccd92ccbae4347116c3db2
+  metadata.gz: 3f6a045d1fbd9362304e744711c7e94a4665876629808cb1c8b1fd8d744417d994e1539c534c2b8b375ca9448b3ccc9f8060c2e5dc1c723455f0b06055b6fc64
+  data.tar.gz: e964d25e14a83d59cef40a1df2f27dc3984588bd94d8c8fbc754e36cc686f86701724a89b0614a2aa3aa9cf99ecfac5701b1c624e79954010731d925b85b40f7

data/CHANGELOG.md

@@ -1,6 +1,27 @@
 # Changelog
 
-## [0.1.0] - 2026-03-17
+## [Unreleased]
+
+## [0.1.2] - 2026-03-18
+
+### Changed
+- Enforce BLEND_TYPES enum validation in `BlendingEngine#blend` — returns nil for invalid blend_type
+- Add 2 specs for BLEND_TYPES enforcement in blending engine spec
+
+## [0.1.1] - 2026-03-18
+
+### Changed
+- Enforce SLOT_TYPES enum validation in `Frame#add_slot` — returns nil for invalid slot_type
+- Enforce EXPRESSION_TYPES enum validation in `GrammarEngine#create_construction` — returns nil for invalid expression_type
+- Enforce SPECIFICITY_LEVELS enum validation in `GrammarEngine#create_construal` — returns nil for invalid specificity
+- Enforce SCOPE_LEVELS enum validation in `GrammarEngine#create_construal` — returns nil for invalid scope
+- Enforce DEPTHS enum validation in `Summarizer#summarize_domain` and `Summarizer#extract_key_facts` — returns nil for invalid depth
+
+## [0.1.0] - 2026-03-18
 
 ### Added
-- Initial domain gem scaffold
+- Initial release as domain consolidation gem
+- Consolidated source extensions into unified domain gem under `Legion::Extensions::Agentic::<Domain>`
+- All sub-modules loaded from single entry point
+- Full spec suite with zero failures
+- RuboCop compliance across all files

data/README.md

@@ -1,13 +1,41 @@
 # lex-agentic-language
 
-LEX agentic language domain: linguistic processing and communication
+Domain consolidation gem for language processing and communication. Bundles 9 source extensions into one loadable unit under `Legion::Extensions::Agentic::Language`.
 
-## Sub-modules
+## Overview
 
-*(populated as extensions are consolidated)*
+**Gem**: `lex-agentic-language`
+**Version**: 0.1.2
+**Namespace**: `Legion::Extensions::Agentic::Language`
+
+## Sub-Modules
+
+| Sub-Module | Source Gem | Purpose |
+|---|---|---|
+| `Language::Language` | `lex-language` | Core language processing — token parsing, semantic framing, pragmatic intent |
+| `Language::Grammar` | `lex-cognitive-grammar` | Grammatical structure processing |
+| `Language::InnerSpeech` | `lex-inner-speech` | Vygotsky inner speech — private verbal thought for problem solving |
+| `Language::Narrator` | `lex-narrator` | Real-time narrative stream of internal state (optional LLM enhancement) |
+| `Language::NarrativeReasoning` | `lex-narrative-reasoning` | Narrative as a reasoning mode — story-schema activation |
+| `Language::FrameSemantics` | `lex-frame-semantics` | Fillmore frame semantics — conceptual frames, slots, fillers |
+| `Language::PragmaticInference` | `lex-pragmatic-inference` | Gricean maxims and conversational implicature |
+| `Language::ConceptualBlending` | `lex-conceptual-blending` | Fauconnier & Turner — emergent blended structure from two input spaces |
+| `Language::ConceptualMetaphor` | `lex-conceptual-metaphor` | Lakoff & Johnson — structural mappings between conceptual domains |
 
 ## Installation
 
 ```ruby
 gem 'lex-agentic-language'
 ```
+
+## Development
+
+```bash
+bundle install
+bundle exec rspec        # 735 examples, 0 failures
+bundle exec rubocop      # 0 offenses
+```
+
+## License
+
+MIT

data/lib/legion/extensions/agentic/language/conceptual_blending/helpers/blending_engine.rb

@@ -33,6 +33,8 @@ module Legion
               end
 
               def blend(space_a_id:, space_b_id:, blend_type: :double_scope)
+                return nil unless BLEND_TYPES.include?(blend_type.to_sym)
+
                 raise ArgumentError, "Max blends (#{MAX_BLENDS}) reached" if @blends.size >= MAX_BLENDS
 
                 space_a = @spaces.fetch(space_a_id) { raise ArgumentError, "Space #{space_a_id} not found" }

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

@@ -5,7 +5,7 @@ module Legion
     module Agentic
       module Language
         module ConceptualBlending
-          VERSION = '0.1.0'
+          VERSION = '0.1.1'
         end
       end
     end

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

@@ -23,6 +23,8 @@ module Legion
               end
 
               def add_slot(name:, slot_type: :core, required: true)
+                return nil unless SLOT_TYPES.include?(slot_type.to_sym)
+
                 @slots[name] = { type: slot_type, filler: nil, required: required }
                 self
               end

data/lib/legion/extensions/agentic/language/grammar/helpers/grammar_engine.rb

@@ -15,6 +15,8 @@ module Legion
               end
 
               def create_construction(form:, meaning:, expression_type:, domain:, activation: DEFAULT_ACTIVATION)
+                return nil unless EXPRESSION_TYPES.include?(expression_type.to_sym)
+
                 prune_constructions_if_needed
                 construction = Construction.new(
                   form:            form,
@@ -30,6 +32,9 @@ module Legion
               def create_construal(scene:, perspective:, figure:, ground:,
                                    specificity: :intermediate, scope: :local,
                                    dynamicity: 0.5, construction_id: nil)
+                return nil unless SPECIFICITY_LEVELS.include?(specificity.to_sym)
+                return nil unless SCOPE_LEVELS.include?(scope.to_sym)
+
                 prune_construals_if_needed
                 construal = Construal.new(
                   scene:           scene,

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

@@ -10,6 +10,8 @@ module Legion
               module_function
 
               def summarize_domain(traces, domain:, depth: :standard)
+                return nil unless Constants::DEPTHS.include?(depth.to_sym)
+
                 return empty_summary(domain) if traces.empty?
 
                 grouped = group_by_type(traces)
@@ -37,6 +39,8 @@ module Legion
               end
 
               def extract_key_facts(grouped, depth: :standard)
+                return nil unless Constants::DEPTHS.include?(depth.to_sym)
+
                 limit = case depth
                         when :brief    then 3
                         when :detailed then 15

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

@@ -4,7 +4,7 @@ module Legion
   module Extensions
     module Agentic
       module Language
-        VERSION = '0.1.0'
+        VERSION = '0.1.2'
       end
     end
   end

data/spec/legion/extensions/agentic/language/conceptual_blending/helpers/blending_engine_spec.rb

@@ -99,6 +99,19 @@ RSpec.describe Legion::Extensions::Agentic::Language::ConceptualBlending::Helper
         engine.blend(space_a_id: 'bad', space_b_id: space_b.id)
       end.to raise_error(ArgumentError, /not found/)
     end
+
+    it 'rejects invalid blend_type' do
+      result = engine.blend(space_a_id: space_a.id, space_b_id: space_b.id, blend_type: :nonexistent_type)
+      expect(result).to be_nil
+    end
+
+    it 'accepts all BLEND_TYPES' do
+      blend_types = Legion::Extensions::Agentic::Language::ConceptualBlending::Helpers::Constants::BLEND_TYPES
+      blend_types.each do |val|
+        result = engine.blend(space_a_id: space_a.id, space_b_id: space_b.id, blend_type: val)
+        expect(result).not_to be_nil, "Expected #{val.inspect} to be accepted"
+      end
+    end
   end
 
   describe '#elaborate_blend' do

data/spec/legion/extensions/agentic/language/frame_semantics/helpers/frame_spec.rb

@@ -45,6 +45,20 @@ RSpec.describe Legion::Extensions::Agentic::Language::FrameSemantics::Helpers::F
       result = frame.add_slot(name: :seller)
       expect(result).to be(frame)
     end
+
+    it 'returns nil for invalid slot_type' do
+      result = frame.add_slot(name: :buyer, slot_type: :bogus)
+      expect(result).to be_nil
+      expect(frame.slots).not_to have_key(:buyer)
+    end
+
+    it 'accepts all valid SLOT_TYPES' do
+      Legion::Extensions::Agentic::Language::FrameSemantics::Helpers::SLOT_TYPES.each do |type|
+        f = described_class.new(name: :test, domain: :test)
+        result = f.add_slot(name: :slot, slot_type: type)
+        expect(result).to be(f)
+      end
+    end
   end
 
   describe '#fill_slot' do

data/spec/legion/extensions/agentic/language/grammar/helpers/grammar_engine_spec.rb

@@ -29,6 +29,19 @@ RSpec.describe Legion::Extensions::Agentic::Language::Grammar::Helpers::GrammarE
       expect(c.expression_type).to eq(:nominal)
       expect(c.domain).to eq('nature')
     end
+
+    it 'returns nil for invalid expression_type' do
+      result = engine.create_construction(form: 'x', meaning: 'y', expression_type: :bogus, domain: 'd')
+      expect(result).to be_nil
+      expect(engine.to_h[:constructions_count]).to eq(0)
+    end
+
+    it 'accepts all valid EXPRESSION_TYPES' do
+      Legion::Extensions::Agentic::Language::Grammar::Helpers::Constants::EXPRESSION_TYPES.each do |type|
+        c = engine.create_construction(form: 'x', meaning: 'y', expression_type: type, domain: 'd')
+        expect(c).to be_a(Legion::Extensions::Agentic::Language::Grammar::Helpers::Construction)
+      end
+    end
   end
 
   describe '#create_construal' do
@@ -48,6 +61,32 @@ RSpec.describe Legion::Extensions::Agentic::Language::Grammar::Helpers::GrammarE
       expect(c.scope).to eq(:global)
       expect(c.dynamicity).to eq(0.8)
     end
+
+    it 'returns nil for invalid specificity' do
+      result = engine.create_construal(**construal_params, specificity: :bogus)
+      expect(result).to be_nil
+      expect(engine.to_h[:construals_count]).to eq(0)
+    end
+
+    it 'accepts all valid SPECIFICITY_LEVELS' do
+      Legion::Extensions::Agentic::Language::Grammar::Helpers::Constants::SPECIFICITY_LEVELS.each do |level|
+        c = engine.create_construal(**construal_params, specificity: level)
+        expect(c).to be_a(Legion::Extensions::Agentic::Language::Grammar::Helpers::Construal)
+      end
+    end
+
+    it 'returns nil for invalid scope' do
+      result = engine.create_construal(**construal_params, scope: :bogus)
+      expect(result).to be_nil
+      expect(engine.to_h[:construals_count]).to eq(0)
+    end
+
+    it 'accepts all valid SCOPE_LEVELS' do
+      Legion::Extensions::Agentic::Language::Grammar::Helpers::Constants::SCOPE_LEVELS.each do |level|
+        c = engine.create_construal(**construal_params, scope: level)
+        expect(c).to be_a(Legion::Extensions::Agentic::Language::Grammar::Helpers::Construal)
+      end
+    end
   end
 
   describe '#use_construction' do

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

@@ -25,6 +25,18 @@ RSpec.describe Legion::Extensions::Agentic::Language::Language::Helpers::Summari
   end
 
   describe '.summarize_domain' do
+    it 'returns nil for invalid depth' do
+      result = described_class.summarize_domain([], domain: :networking, depth: :bogus)
+      expect(result).to be_nil
+    end
+
+    it 'accepts all valid DEPTHS' do
+      Legion::Extensions::Agentic::Language::Language::Helpers::Constants::DEPTHS.each do |depth|
+        result = described_class.summarize_domain([], domain: :networking, depth: depth)
+        expect(result).not_to be_nil
+      end
+    end
+
     it 'returns empty summary for no traces' do
       result = described_class.summarize_domain([], domain: :networking)
       expect(result[:knowledge_level]).to eq(:none)
@@ -92,6 +104,18 @@ RSpec.describe Legion::Extensions::Agentic::Language::Language::Helpers::Summari
       { semantic: make_traces(10) }
     end
 
+    it 'returns nil for invalid depth' do
+      result = described_class.extract_key_facts(grouped, depth: :bogus)
+      expect(result).to be_nil
+    end
+
+    it 'accepts all valid DEPTHS' do
+      Legion::Extensions::Agentic::Language::Language::Helpers::Constants::DEPTHS.each do |depth|
+        result = described_class.extract_key_facts(grouped, depth: depth)
+        expect(result).not_to be_nil
+      end
+    end
+
     it 'limits facts by depth :brief' do
       facts = described_class.extract_key_facts(grouped, depth: :brief)
       expect(facts.size).to be <= 3

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-agentic-language
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.2
 platform: ruby
 authors:
 - Esity