lex-agentic-attention 0.1.0 → 0.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 11316e7a48a460b4bfb317d22f335cf149e138d329df2f1ffbb91c6439915463
-  data.tar.gz: 94a927cd12dde2ec8212462a6c504839096cb5a074945c8f89b65ebde28bf06e
+  metadata.gz: d961ce2f76f01fb190459016fec54b3591baa067656b471692ba7fefebe82b94
+  data.tar.gz: 6b398c695fdba1e1ed2c1b482221303b6aed674d2ce9a209370425beb7e4e946
 SHA512:
-  metadata.gz: 177772a3cf51ff7e3d799445014bf601ac106070a26a5130a12110164133cc82baa38651108eae9ea9c0cdbaec0ba2984e38ff197af6e5c3f6bba669e54ee833
-  data.tar.gz: 80ec4fb94b4ff8129ca765ff4e90a22429cd65155f00849a7845e8e8f23159e23ed3286039db62620f9584517637e74caee81e392a42005f4c22213a6ccd1627
+  metadata.gz: 13fdb20e46f9135e4ce4516aba7bf1abba147c987385868251a08c0efd375a01b652d170b78bf51543d38f1a518fea67c89b44c2a666f9084966ed9ca8d3f218
+  data.tar.gz: 5ddebb2fe449afe7ff30e46dcc9e1590bf1bc326c4659ed37d45b4d45604817a9ec8576543318b6a62ae363578f181f73a9abd6e93897c882154c3636e34e1da

data/CHANGELOG.md

@@ -2,6 +2,27 @@
 
 ## [Unreleased]
 
+## [0.1.3] - 2026-03-22
+
+### Changed
+- Add 7 runtime sub-gem dependencies to gemspec (legion-cache, legion-crypt, legion-data, legion-json, legion-logging, legion-settings, legion-transport)
+- Replace spec_helper stubs with real sub-gem helper requires and real Helpers::Lex module
+
+## [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/lex-agentic-attention.gemspec

@@ -24,6 +24,14 @@ Gem::Specification.new do |spec|
   end
   spec.require_paths = ['lib']
 
+  spec.add_dependency 'legion-cache',     '>= 1.3.11'
+  spec.add_dependency 'legion-crypt',     '>= 1.4.9'
+  spec.add_dependency 'legion-data',      '>= 1.4.17'
+  spec.add_dependency 'legion-json',      '>= 1.2.1'
+  spec.add_dependency 'legion-logging',   '>= 1.3.2'
+  spec.add_dependency 'legion-settings',  '>= 1.3.14'
+  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'

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.3'
       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

data/spec/spec_helper.rb

@@ -1,41 +1,39 @@
 # frozen_string_literal: true
 
 require 'bundler/setup'
+require 'legion/logging'
+require 'legion/settings'
+require 'legion/cache/helper'
+require 'legion/crypt/helper'
+require 'legion/data/helper'
+require 'legion/json/helper'
+require 'legion/transport/helper'
 
 module Legion
-  module Logging
-    def self.debug(_msg); end
-    def self.info(_msg); end
-    def self.warn(_msg); end
-    def self.error(_msg); end
-    def self.fatal(_msg); end
-  end
-
   module Extensions
-    module Core
-      def self.extended(_base); end
-    end
-
     module Helpers
       module Lex
-        def self.included(_base); end
+        include Legion::Logging::Helper
+        include Legion::Settings::Helper
+        include Legion::Cache::Helper
+        include Legion::Crypt::Helper
+        include Legion::Data::Helper
+        include Legion::JSON::Helper
+        include Legion::Transport::Helper
       end
     end
-  end
-end
 
-# rubocop:disable Lint/EmptyClass, Style/OneClassPerFile
-module Legion
-  module Extensions
     module Actors
-      class Every; end
-      class Once; end
+      class Every
+        include Helpers::Lex
+      end
+
+      class Once
+        include Helpers::Lex
+      end
     end
   end
 end
-$LOADED_FEATURES << 'legion/extensions/actors/every'
-$LOADED_FEATURES << 'legion/extensions/actors/once'
-# rubocop:enable Lint/EmptyClass, Style/OneClassPerFile
 
 require 'legion/extensions/agentic/attention'
 

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.3
 platform: ruby
 authors:
 - Esity
@@ -9,6 +9,104 @@ bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: legion-cache
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.11
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.11
+- !ruby/object:Gem::Dependency
+  name: legion-crypt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.4.9
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.4.9
+- !ruby/object:Gem::Dependency
+  name: legion-data
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.4.17
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.4.17
+- !ruby/object:Gem::Dependency
+  name: legion-json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.2.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.2.1
+- !ruby/object:Gem::Dependency
+  name: legion-logging
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.2
+- !ruby/object:Gem::Dependency
+  name: legion-settings
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.14
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.14
+- !ruby/object:Gem::Dependency
+  name: legion-transport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.9
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.9
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement