lex-agentic-attention 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 11316e7a48a460b4bfb317d22f335cf149e138d329df2f1ffbb91c6439915463
-  data.tar.gz: 94a927cd12dde2ec8212462a6c504839096cb5a074945c8f89b65ebde28bf06e
+  metadata.gz: 689fafea8ab7532b0c71e1af0f3190fca466d853e58d3468a8833f27b24bee4f
+  data.tar.gz: aa609f8a51b96725bc975f19e9a902a3838be8503f2a5c4e9deb469422f88eb4
 SHA512:
-  metadata.gz: 177772a3cf51ff7e3d799445014bf601ac106070a26a5130a12110164133cc82baa38651108eae9ea9c0cdbaec0ba2984e38ff197af6e5c3f6bba669e54ee833
-  data.tar.gz: 80ec4fb94b4ff8129ca765ff4e90a22429cd65155f00849a7845e8e8f23159e23ed3286039db62620f9584517637e74caee81e392a42005f4c22213a6ccd1627
+  metadata.gz: f08ebae489ebc42ad72fa36b4f356b22c1871284c4b23479d42a01997999cee1a9880319e5f05d1e5b55aa075ed44b8f852544001d5fa96b562cdc2b846e7ddd
+  data.tar.gz: e525cd97878de8568104789a49c8551d134cf3e3ca1026e1bcdef82fc2d8d4f66e3f53dac36ad78469e34a4ee8359df9070203c08b6db1c38cd6cfd31d61ef1a

data/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 ## [Unreleased]
 
+## [0.1.2] - 2026-03-18
+
+### Changed
+- Enforce TASK_SET_TYPES validation in SwitchingEngine#register_task (returns nil for invalid task_type)
+- Enforce INPUT_TYPES validation in RelevanceEngine#submit_input (returns nil for invalid input_type)
+- Enforce EFFECT_TYPES validation in RelevanceEngine#submit_input (returns nil for invalid effect_type)
+- ATTENTION_MODES and TARGET_STATES in Regulation skipped: internally computed by state machine, not external input params
+
+## [0.1.1] - 2026-03-18
+
+### Changed
+- Enforce FEATURE_DIMENSIONS validation in BindingField#register_feature (returns nil for invalid dimension)
+- Enforce MODALITY_TYPES validation in GatingEngine#create_filter (returns nil for invalid modality)
+- Enforce DISCOVERY_METHODS validation in BlindspotEngine#register_blindspot (returns nil for invalid discovered_by)
+
 ## [0.1.0] - 2026-03-18
 
 ### Added

data/README.md

@@ -1,13 +1,61 @@
 # lex-agentic-attention
 
-LEX agentic attention domain: focus, salience, cognitive control
+Domain consolidation gem for attention, perception, and signal processing. Bundles 24 source extensions into one loadable unit under `Legion::Extensions::Agentic::Attention`.
 
-## Sub-modules
+## Overview
 
-*(populated as extensions are consolidated)*
+**Gem**: `lex-agentic-attention`
+**Version**: 0.1.2
+**Namespace**: `Legion::Extensions::Agentic::Attention`
+
+## Sub-Modules
+
+| Sub-Module | Source Gem | Purpose |
+|---|---|---|
+| `Attention::Focus` | `lex-attention` | Selective attention filter — Miller's Law (7±2), habituation, goal-directed amplification |
+| `Attention::Economy` | `lex-attention-economy` | Attention as scarce resource — allocation budgets, ROI tracking |
+| `Attention::Regulation` | `lex-attention-regulation` | Top-down and bottom-up attention regulation |
+| `Attention::Schema` | `lex-attention-schema` | Self-model of the attention system itself |
+| `Attention::Spotlight` | `lex-attention-spotlight` | Spotlight metaphor — illumination radius, dimmer control |
+| `Attention::Switching` | `lex-attention-switching` | Voluntary/involuntary attention shifts, switch cost tracking |
+| `Attention::Blink` | `lex-attentional-blink` | Rapid succession signal suppression — temporal attention limits |
+| `Attention::Telescope` | `lex-cognitive-telescope` | Long-range attentional focus |
+| `Attention::Lens` | `lex-cognitive-lens` | Attentional focus shaping |
+| `Attention::Prism` | `lex-cognitive-prism` | Multi-spectrum signal decomposition |
+| `Attention::Lighthouse` | `lex-cognitive-lighthouse` | Beacon-based attentional guidance |
+| `Attention::Blindspot` | `lex-cognitive-blindspot` | Attentional blind spots and gaps |
+| `Attention::Kaleidoscope` | `lex-cognitive-kaleidoscope` | Multi-faceted attentional patterns |
+| `Attention::Synesthesia` | `lex-cognitive-synesthesia` | Cross-modal attentional blending |
+| `Attention::Arousal` | `lex-arousal` | Yerkes-Dodson inverted-U — optimal performance at moderate arousal |
+| `Attention::Salience` | `lex-salience` | Weighted integration from eight cognitive sources |
+| `Attention::SensoryGating` | `lex-sensory-gating` | Pre-attentive filtering of redundant stimuli (P50 model) |
+| `Attention::SignalDetection` | `lex-signal-detection` | SDT modeling — sensitivity (d'), response bias (beta) |
+| `Attention::Subliminal` | `lex-subliminal` | Below-threshold signal processing |
+| `Attention::LatentInhibition` | `lex-latent-inhibition` | Learned irrelevance — reduced processing of previously irrelevant stimuli |
+| `Attention::Surprise` | `lex-surprise` | Surprise signal computation from violated expectations |
+| `Attention::RelevanceTheory` | `lex-relevance-theory` | Cognitive effort vs. contextual effect optimization |
+| `Attention::Priming` | `lex-priming` | Prior exposure boosts related processing |
+| `Attention::FeatureBinding` | `lex-feature-binding` | Binding separately-processed features into unified percepts |
+
+## Actors
+
+- `Attention::FeatureBinding::Actors::Decay` — interval actor, decays bound feature groups
+- `Attention::Schema::Actors::Decay` — interval actor, decays attention schema entries
 
 ## Installation
 
 ```ruby
 gem 'lex-agentic-attention'
 ```
+
+## Development
+
+```bash
+bundle install
+bundle exec rspec        # 2288 examples, 0 failures
+bundle exec rubocop      # 0 offenses
+```
+
+## License
+
+MIT

data/lib/legion/extensions/agentic/attention/blindspot/helpers/blindspot_engine.rb

@@ -18,6 +18,8 @@ module Legion
               end
 
               def register_blindspot(domain:, discovered_by:, description:, severity: DEFAULT_SEVERITY)
+                return nil unless DISCOVERY_METHODS.include?(discovered_by.to_sym)
+
                 prune_blindspots_if_needed
                 blindspot = Blindspot.new(domain: domain, discovered_by: discovered_by,
                                           description: description, severity: severity)

data/lib/legion/extensions/agentic/attention/blindspot/version.rb

@@ -5,7 +5,7 @@ module Legion
     module Agentic
       module Attention
         module Blindspot
-          VERSION = '0.1.0'
+          VERSION = '0.1.1'
         end
       end
     end

data/lib/legion/extensions/agentic/attention/feature_binding/helpers/binding_field.rb

@@ -20,6 +20,7 @@ module Legion
 
               def register_feature(id:, dimension:, value:, source: :perception, salience: 0.5)
                 return @features[id] if @features.key?(id)
+                return nil unless FEATURE_DIMENSIONS.include?(dimension.to_sym)
                 return nil if @features.size >= MAX_FEATURES
 
                 @features[id] = Feature.new(id: id, dimension: dimension, value: value, source: source, salience: salience)

data/lib/legion/extensions/agentic/attention/feature_binding/version.rb

@@ -5,7 +5,7 @@ module Legion
     module Agentic
       module Attention
         module FeatureBinding
-          VERSION = '0.1.0'
+          VERSION = '0.1.1'
         end
       end
     end

data/lib/legion/extensions/agentic/attention/relevance_theory/helpers/relevance_engine.rb

@@ -19,6 +19,9 @@ module Legion
               def submit_input(content:, input_type:, context:, cognitive_effect: DEFAULT_EFFECT,
                                processing_effort: DEFAULT_EFFORT, effect_type: :new_implication,
                                source_id: nil)
+                return nil unless INPUT_TYPES.include?(input_type.to_sym)
+                return nil unless EFFECT_TYPES.include?(effect_type.to_sym)
+
                 evict_oldest if @inputs.size >= MAX_INPUTS
 
                 input = CognitiveInput.new(

data/lib/legion/extensions/agentic/attention/relevance_theory/version.rb

@@ -5,7 +5,7 @@ module Legion
     module Agentic
       module Attention
         module RelevanceTheory
-          VERSION = '0.1.0'
+          VERSION = '0.1.1'
         end
       end
     end

data/lib/legion/extensions/agentic/attention/sensory_gating/helpers/gating_engine.rb

@@ -14,6 +14,8 @@ module Legion
               end
 
               def create_filter(modality:, gate_threshold: DEFAULT_GATE_THRESHOLD)
+                return nil unless MODALITY_TYPES.include?(modality.to_sym)
+
                 prune_if_needed
                 filter = SensoryFilter.new(modality: modality, gate_threshold: gate_threshold)
                 @filters[filter.id] = filter

data/lib/legion/extensions/agentic/attention/sensory_gating/version.rb

@@ -5,7 +5,7 @@ module Legion
     module Agentic
       module Attention
         module SensoryGating
-          VERSION = '0.1.0'
+          VERSION = '0.1.1'
         end
       end
     end

data/lib/legion/extensions/agentic/attention/switching/helpers/switching_engine.rb

@@ -16,6 +16,8 @@ module Legion
               end
 
               def register_task(name:, task_type: :analytical, complexity: 0.5)
+                return nil unless TASK_SET_TYPES.include?(task_type.to_sym)
+
                 prune_tasks_if_needed
                 task = TaskSet.new(name: name, task_type: task_type, complexity: complexity)
                 @task_sets[task.id] = task

data/lib/legion/extensions/agentic/attention/switching/version.rb

@@ -5,7 +5,7 @@ module Legion
     module Agentic
       module Attention
         module Switching
-          VERSION = '0.1.0'
+          VERSION = '0.1.1'
         end
       end
     end

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

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

data/spec/legion/extensions/agentic/attention/blindspot/helpers/blindspot_engine_spec.rb

@@ -18,6 +18,21 @@ RSpec.describe Legion::Extensions::Agentic::Attention::Blindspot::Helpers::Blind
   end
 
   describe '#register_blindspot' do
+    it 'rejects invalid discovered_by' do
+      result = engine.register_blindspot(
+        domain: :reasoning, discovered_by: :nonexistent, description: 'test'
+      )
+      expect(result).to be_nil
+    end
+
+    it 'accepts all valid DISCOVERY_METHODS' do
+      constants = Legion::Extensions::Agentic::Attention::Blindspot::Helpers::Constants
+      constants::DISCOVERY_METHODS.each_with_index do |method, i|
+        b = engine.register_blindspot(domain: :"d#{i}", discovered_by: method, description: "test #{i}")
+        expect(b).not_to be_nil
+      end
+    end
+
     it 'returns a Blindspot object' do
       expect(blindspot).to be_a(Legion::Extensions::Agentic::Attention::Blindspot::Helpers::Blindspot)
     end

data/spec/legion/extensions/agentic/attention/feature_binding/helpers/binding_field_spec.rb

@@ -24,6 +24,20 @@ RSpec.describe Legion::Extensions::Agentic::Attention::FeatureBinding::Helpers::
       expect(field.feature_count).to eq(1)
     end
 
+    it 'rejects invalid dimension' do
+      result = field.register_feature(id: 'f:bad', dimension: :nonexistent, value: :x)
+      expect(result).to be_nil
+      expect(field.feature_count).to eq(0)
+    end
+
+    it 'accepts all valid FEATURE_DIMENSIONS' do
+      constants::FEATURE_DIMENSIONS.each_with_index do |dim, i|
+        f = field.register_feature(id: "f:#{i}", dimension: dim, value: i)
+        expect(f).not_to be_nil
+      end
+      expect(field.feature_count).to eq(constants::FEATURE_DIMENSIONS.size)
+    end
+
     it 'enforces MAX_FEATURES limit' do
       constants::MAX_FEATURES.times do |i|
         field.register_feature(id: "f:#{i}", dimension: :color, value: i)

data/spec/legion/extensions/agentic/attention/relevance_theory/helpers/relevance_engine_spec.rb

@@ -16,6 +16,34 @@ RSpec.describe Legion::Extensions::Agentic::Attention::RelevanceTheory::Helpers:
       engine.submit_input(content: 'x', input_type: :assertion, context: :c)
       expect(engine.history.last[:event]).to eq(:submitted)
     end
+
+    it 'rejects invalid input_type' do
+      result = engine.submit_input(content: 'test', input_type: :nonexistent_type, context: :general)
+      expect(result).to be_nil
+    end
+
+    it 'accepts all INPUT_TYPES' do
+      constants = Legion::Extensions::Agentic::Attention::RelevanceTheory::Helpers::Constants::INPUT_TYPES
+      constants.each do |val|
+        result = engine.submit_input(content: 'test', input_type: val, context: :general)
+        expect(result).not_to be_nil, "Expected #{val.inspect} to be accepted"
+      end
+    end
+
+    it 'rejects invalid effect_type' do
+      result = engine.submit_input(content: 'test', input_type: :assertion, context: :general,
+                                   effect_type: :nonexistent_effect)
+      expect(result).to be_nil
+    end
+
+    it 'accepts all EFFECT_TYPES' do
+      constants = Legion::Extensions::Agentic::Attention::RelevanceTheory::Helpers::Constants::EFFECT_TYPES
+      constants.each do |val|
+        result = engine.submit_input(content: 'test', input_type: :assertion, context: :general,
+                                     effect_type: val)
+        expect(result).not_to be_nil, "Expected #{val.inspect} to be accepted"
+      end
+    end
   end
 
   describe '#assess_relevance' do

data/spec/legion/extensions/agentic/attention/sensory_gating/helpers/gating_engine_spec.rb

@@ -14,6 +14,20 @@ RSpec.describe Legion::Extensions::Agentic::Attention::SensoryGating::Helpers::G
       filter
       expect(engine.to_h[:total_filters]).to eq(1)
     end
+
+    it 'rejects invalid modality' do
+      result = engine.create_filter(modality: :nonexistent)
+      expect(result).to be_nil
+    end
+
+    it 'accepts all valid MODALITY_TYPES' do
+      constants = Legion::Extensions::Agentic::Attention::SensoryGating::Helpers::Constants
+      constants::MODALITY_TYPES.each do |mod|
+        f = engine.create_filter(modality: mod)
+        expect(f).not_to be_nil
+      end
+      expect(engine.to_h[:total_filters]).to eq(constants::MODALITY_TYPES.size)
+    end
   end
 
   describe '#process_stimulus' do
@@ -105,7 +119,8 @@ RSpec.describe Legion::Extensions::Agentic::Attention::SensoryGating::Helpers::G
     it 'prunes oldest filter when limit reached' do
       stub_const('Legion::Extensions::Agentic::Attention::SensoryGating::Helpers::Constants::MAX_FILTERS', 3)
       eng = described_class.new
-      4.times { |i| eng.create_filter(modality: :"mod#{i}") }
+      modalities = %i[visual auditory textual semantic]
+      modalities.each { |m| eng.create_filter(modality: m) }
       expect(eng.to_h[:total_filters]).to eq(3)
     end
   end

data/spec/legion/extensions/agentic/attention/switching/attention_switching_spec.rb

@@ -2,6 +2,6 @@
 
 RSpec.describe Legion::Extensions::Agentic::Attention::Switching do
   it 'has a version number' do
-    expect(Legion::Extensions::Agentic::Attention::Switching::VERSION).to eq('0.1.0')
+    expect(Legion::Extensions::Agentic::Attention::Switching::VERSION).to eq('0.1.1')
   end
 end

data/spec/legion/extensions/agentic/attention/switching/helpers/switching_engine_spec.rb

@@ -12,6 +12,19 @@ RSpec.describe Legion::Extensions::Agentic::Attention::Switching::Helpers::Switc
       task = engine.register_task(name: 'test')
       expect(task).to be_a(Legion::Extensions::Agentic::Attention::Switching::Helpers::TaskSet)
     end
+
+    it 'rejects invalid task_type' do
+      result = engine.register_task(name: 'bad', task_type: :nonexistent_type)
+      expect(result).to be_nil
+    end
+
+    it 'accepts all TASK_SET_TYPES' do
+      constants = Legion::Extensions::Agentic::Attention::Switching::Helpers::Constants::TASK_SET_TYPES
+      constants.each do |val|
+        result = engine.register_task(name: val.to_s, task_type: val)
+        expect(result).not_to be_nil, "Expected #{val.inspect} to be accepted"
+      end
+    end
   end
 
   describe '#activate_task' do

metadata

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