lex-agentic-attention 0.1.6 → 0.1.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cc820ae52c879ee0a59e6fd9551eb037c9a00214c8096a545b7e63a2b95c072b
-  data.tar.gz: 4c5d0b898ed697915a97c9ac95d5addf0a186600aeea84d11cc20bc5f03f17a4
+  metadata.gz: 9e6357375a251617aae1b7b3c415374cf2ccaf930f0cec48e0b0adc2db4310e5
+  data.tar.gz: fb2bf32e027a564c17d0914a3496a65d3d8c844205cd6c09326ea24783f6dd20
 SHA512:
-  metadata.gz: f0d55e482146cd4c07bbbdfd6e53bb4268e625c509d321b0cef7fa0bdf506038315fc58775379b465bcace069fc7d7563f0acaa98b3ba348cf55f154b013d430
-  data.tar.gz: 232af3b13aa8656873b6e8b2a959293080acf7ba147268fe4fdf0e2b3c1916498a7edf915481f5c80738c3b4f843f5dee2bdab9b31d378bf5943cfab2be40427
+  metadata.gz: 93b6915bcd364e1c83b1ab28e032c1d557d8c297a5efe148658fe9a804d0512b87ac5a1a227ca3b2fb01c2bfa2adfbcc014ad93e701e4ee60cd030ff8268f35b
+  data.tar.gz: 7ba33757d9c2ae8f2a16a777dbc7c6738d56aa3793906e3fbba7643428f916a43ee9b96cac8cca9f632283b8c0dc298218a6366c2ffea745564e8cf65e265071

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [0.1.8] - 2026-10-29
+### Fixed
+- Preserve principal, channel, and frame identity when deduplicating attention signals.
+- Return retained spotlight and peripheral signals in priority order, including batches below spotlight capacity.
+
+## [0.1.7] - 2026-04-22
+### Fixed
+- Renamed Economy `attention_status` to `attention_economy_status` to resolve method collision with Focus
+- Renamed Spotlight `release_focus` to `release_spotlight` to resolve method collision with Focus
+### Added
+- 5 new maintenance actors: Salience::Compute (12s), Arousal::Update (30s), SignalDetection::Update (60s), Regulation::Update (60s), Blink::Decay (15s)
+- `decay_blink` method for attentional blink recovery
+
 ## [0.1.6] - 2026-04-15
 ### Changed
 - Set `mcp_tools?`, `mcp_tools_deferred?`, and `transport_required?` to `false` — internal cognitive pipeline extension

data/README.md

@@ -5,7 +5,7 @@ Domain consolidation gem for attention, perception, and signal processing. Bundl
 ## Overview
 
 **Gem**: `lex-agentic-attention`
-**Version**: 0.1.6
+**Version**: 0.1.8
 **Namespace**: `Legion::Extensions::Agentic::Attention`
 
 ## Sub-Modules
@@ -39,8 +39,15 @@ Domain consolidation gem for attention, perception, and signal processing. Bundl
 
 ## Actors
 
-- `Attention::FeatureBinding::Actors::Decay` — interval actor, decays bound feature groups
-- `Attention::Schema::Actors::Decay` — interval actor, decays attention schema entries
+| Actor | Interval | What It Does |
+|-------|----------|--------------|
+| `Arousal::Actor::Update` | Every 30s | Updates arousal level using Yerkes-Dodson model |
+| `Blink::Actor::Decay` | Every 15s | Decays attentional blink suppression window |
+| `FeatureBinding::Actors::Decay` | interval | Decays bound feature groups |
+| `Regulation::Actor::Update` | Every 60s | Applies top-down/bottom-up regulation updates |
+| `Salience::Actor::Compute` | Every 12s | Recomputes salience map from all eight sources |
+| `Schema::Actor::Decay` | Every 30s | Decays attention schema entries |
+| `SignalDetection::Actor::Update` | Every 60s | Updates SDT sensitivity (d') and response bias (beta) |
 
 ## Installation
 
@@ -48,6 +55,28 @@ Domain consolidation gem for attention, perception, and signal processing. Bundl
 gem 'lex-agentic-attention'
 ```
 
+## Usage
+
+```ruby
+require 'legion/extensions/agentic/attention'
+
+# Filter incoming signals through the attention focus system
+client = Legion::Extensions::Agentic::Attention::Focus::Client.new
+result = client.filter_signals(signals: incoming, active_wonders: goals)
+# => { filtered: [...], spotlight: 3, peripheral: 2, background: 5, dropped: 1 }
+
+# Check attention economy status
+economy = Legion::Extensions::Agentic::Attention::Economy::Client.new
+economy.attention_economy_status
+# => { total_budget:, spent:, available:, utilization:, demand_count:, ... }
+
+# Focus the spotlight on a specific target
+spotlight = Legion::Extensions::Agentic::Attention::Spotlight::Client.new
+spotlight.register_target(label: 'critical_alert', domain: :safety, salience: 0.9, relevance: 0.9)
+spotlight.focus_spotlight(target_id: '<id>')
+spotlight.release_spotlight
+```
+
 ## Development
 
 ```bash

data/lib/legion/extensions/agentic/attention/arousal/actors/update.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require 'legion/extensions/actors/every'
+
+module Legion
+  module Extensions
+    module Agentic
+      module Attention
+        module Arousal
+          module Actor
+            class Update < Legion::Extensions::Actors::Every
+              def runner_class
+                Legion::Extensions::Agentic::Attention::Arousal::Runners::Arousal
+              end
+
+              def runner_function
+                'update_arousal'
+              end
+
+              def time
+                30
+              end
+
+              def run_now?
+                false
+              end
+
+              def use_runner?
+                false
+              end
+
+              def check_subtask?
+                false
+              end
+
+              def generate_task?
+                false
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/agentic/attention/blink/actors/decay.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require 'legion/extensions/actors/every'
+
+module Legion
+  module Extensions
+    module Agentic
+      module Attention
+        module Blink
+          module Actor
+            class Decay < Legion::Extensions::Actors::Every
+              def runner_class
+                Legion::Extensions::Agentic::Attention::Blink::Runners::AttentionalBlink
+              end
+
+              def runner_function
+                'decay_blink'
+              end
+
+              def time
+                15
+              end
+
+              def run_now?
+                false
+              end
+
+              def use_runner?
+                false
+              end
+
+              def check_subtask?
+                false
+              end
+
+              def generate_task?
+                false
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/agentic/attention/blink/runners/attentional_blink.rb

@@ -66,6 +66,13 @@ module Legion
               def attentional_blink_stats(**)
                 engine.to_h
               end
+
+              def decay_blink(**)
+                active = engine.blink_active?
+                level  = engine.recovery_level
+                log.debug("[attentional_blink] decay tick: active=#{active} recovery=#{level.round(3)}")
+                { success: true, blink_active: active, recovery_level: level }
+              end
             end
           end
         end

data/lib/legion/extensions/agentic/attention/economy/runners/attention_economy.rb

@@ -66,9 +66,9 @@ module Legion
                 result
               end
 
-              def attention_status(**)
+              def attention_economy_status(**)
                 report = attention_budget.budget_report
-                log.debug("[attention] status: utilization=#{report[:utilization]} demands=#{report[:demand_count]}")
+                log.debug("[attention] economy status: utilization=#{report[:utilization]} demands=#{report[:demand_count]}")
                 report
               end
 

data/lib/legion/extensions/agentic/attention/feature_binding/actors/decay.rb

@@ -8,7 +8,7 @@ module Legion
       module Attention
         module FeatureBinding
           module Actor
-            class Decay < Legion::Extensions::Actors::Every # rubocop:disable Legion/Extension/EveryActorRequiresTime
+            class Decay < Legion::Extensions::Actors::Every
               def runner_class
                 Legion::Extensions::Agentic::Attention::FeatureBinding::Runners::FeatureBinding
               end

data/lib/legion/extensions/agentic/attention/focus/helpers/focus.rb

@@ -67,7 +67,8 @@ module Legion
               def signal_identity(signal)
                 return signal.object_id unless signal.is_a?(Hash)
 
-                [signal[:source_type], signal[:domain], signal[:value]].hash
+                [signal[:source_type], signal[:domain], signal[:principal_id],
+                 signal[:channel_id], signal[:frame_id], signal[:value]]
               end
             end
           end

data/lib/legion/extensions/agentic/attention/focus/runners/attention.rb

@@ -103,12 +103,14 @@ module Legion
               def enforce_capacity(categorized)
                 capacity = Helpers::Constants::ATTENTIONAL_CAPACITY
                 spotlight = categorized[:spotlight].sort_by { |s| -(s[:attention_score] || 0) }
+                categorized[:spotlight] = spotlight
 
                 if spotlight.size > capacity
                   overflow = spotlight[capacity..]
                   categorized[:spotlight] = spotlight.first(capacity)
                   categorized[:peripheral].concat(overflow)
                 end
+                categorized[:peripheral].sort_by! { |s| -(s[:attention_score] || 0) }
 
                 categorized
               end

data/lib/legion/extensions/agentic/attention/lens/helpers/constants.rb

@@ -14,11 +14,11 @@ module Legion
               MAX_LENSES = 8
 
               CLARITY_LABELS = [
-                [0.0..0.2,  :opaque],
-                [0.2..0.4,  :foggy],
-                [0.4..0.6,  :hazy],
-                [0.6..0.8,  :clear],
-                [0.8..1.0,  :crystal]
+                [0.0..0.2, :opaque],
+                [0.2..0.4, :foggy],
+                [0.4..0.6, :hazy],
+                [0.6..0.8, :clear],
+                [0.8..1.0, :crystal]
               ].freeze
 
               MAGNIFICATION_LABELS = [

data/lib/legion/extensions/agentic/attention/lens/helpers/lens_engine.rb

@@ -48,13 +48,12 @@ module Legion
                 raise ArgumentError, "stack not found: #{stack_id}" unless stack
 
                 result = stack.view_through(content)
-                # rubocop:disable Legion/HelperMigration/DirectLogging
+                # rubocop:disable-next Legion/HelperMigration/DirectLogging
                 Legion::Logging.debug("[cognitive_lens] view_through stack=#{stack_id} " \
                                       "perceived=#{result[:perceived].round(4)} " \
                                       "magnification=#{result[:combined_magnification].round(2)} " \
                                       "distortion=#{result[:combined_distortion].round(2)} " \
                                       "clarity=#{result[:stack_clarity].round(2)}")
-                # rubocop:enable Legion/HelperMigration/DirectLogging
                 result
               end
 

data/lib/legion/extensions/agentic/attention/regulation/actors/update.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require 'legion/extensions/actors/every'
+
+module Legion
+  module Extensions
+    module Agentic
+      module Attention
+        module Regulation
+          module Actor
+            class Update < Legion::Extensions::Actors::Every
+              def runner_class
+                Legion::Extensions::Agentic::Attention::Regulation::Runners::AttentionRegulation
+              end
+
+              def runner_function
+                'update_attention'
+              end
+
+              def time
+                60
+              end
+
+              def run_now?
+                false
+              end
+
+              def use_runner?
+                false
+              end
+
+              def check_subtask?
+                false
+              end
+
+              def generate_task?
+                false
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/agentic/attention/salience/actors/compute.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require 'legion/extensions/actors/every'
+
+module Legion
+  module Extensions
+    module Agentic
+      module Attention
+        module Salience
+          module Actor
+            class Compute < Legion::Extensions::Actors::Every
+              def runner_class
+                Legion::Extensions::Agentic::Attention::Salience::Runners::Salience
+              end
+
+              def runner_function
+                'compute_salience'
+              end
+
+              def time
+                12
+              end
+
+              def run_now?
+                false
+              end
+
+              def use_runner?
+                false
+              end
+
+              def check_subtask?
+                false
+              end
+
+              def generate_task?
+                false
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/agentic/attention/schema/actors/decay.rb

@@ -8,7 +8,7 @@ module Legion
       module Attention
         module Schema
           module Actor
-            class Decay < Legion::Extensions::Actors::Every # rubocop:disable Legion/Extension/EveryActorRequiresTime
+            class Decay < Legion::Extensions::Actors::Every
               def runner_class
                 Legion::Extensions::Agentic::Attention::Schema::Runners::AttentionSchema
               end

data/lib/legion/extensions/agentic/attention/signal_detection/actors/update.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+require 'legion/extensions/actors/every'
+
+module Legion
+  module Extensions
+    module Agentic
+      module Attention
+        module SignalDetection
+          module Actor
+            class Update < Legion::Extensions::Actors::Every
+              def runner_class
+                Legion::Extensions::Agentic::Attention::SignalDetection::Runners::SignalDetection
+              end
+
+              def runner_function
+                'update_signal_detection'
+              end
+
+              def time
+                60
+              end
+
+              def run_now?
+                false
+              end
+
+              def use_runner?
+                false
+              end
+
+              def check_subtask?
+                false
+              end
+
+              def generate_task?
+                false
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/legion/extensions/agentic/attention/spotlight/runners/attention_spotlight.rb

@@ -74,12 +74,12 @@ module Legion
                 { success: false, error: e.message }
               end
 
-              def release_focus(**)
-                log.debug('[attention_spotlight] releasing focus')
+              def release_spotlight(**)
+                log.debug('[attention_spotlight] releasing spotlight')
                 result = engine.release_focus
                 { success: true, **result }
               rescue StandardError => e
-                log.error("[attention_spotlight] release_focus error: #{e.message}")
+                log.error("[attention_spotlight] release_spotlight error: #{e.message}")
                 { success: false, error: e.message }
               end
 

data/lib/legion/extensions/agentic/attention/synesthesia/helpers/synesthesia_engine.rb

@@ -32,10 +32,9 @@ module Legion
                 @mappings[mapping.id] = mapping
                 prune_mappings! if @mappings.size > MAX_MAPPINGS
 
-                # rubocop:disable Legion/HelperMigration/DirectLogging
+                # rubocop:disable-next Legion/HelperMigration/DirectLogging
                 Legion::Logging.debug("[cognitive_synesthesia] mapping registered id=#{mapping.id[0..7]} " \
                                       "#{source_modality}->#{target_modality} strength=#{strength.round(2)}")
-                # rubocop:enable Legion/HelperMigration/DirectLogging
 
                 { success: true, mapping_id: mapping.id, source_modality: source_modality,
                   target_modality: target_modality }
@@ -137,10 +136,9 @@ module Legion
                 @events << event
                 @events.shift while @events.size > MAX_EVENTS
 
-                # rubocop:disable Legion/HelperMigration/DirectLogging
+                # rubocop:disable-next Legion/HelperMigration/DirectLogging
                 Legion::Logging.debug("[cognitive_synesthesia] event fired id=#{event.id[0..7]} " \
                                       "mapping=#{mapping.id[0..7]} intensity=#{intensity.round(2)}")
-                # rubocop:enable Legion/HelperMigration/DirectLogging
                 event
               end
 

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

@@ -4,7 +4,7 @@ module Legion
   module Extensions
     module Agentic
       module Attention
-        VERSION = '0.1.6'
+        VERSION = '0.1.8'
       end
     end
   end

data/spec/legion/extensions/agentic/attention/arousal/actors/update_spec.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require 'legion/extensions/agentic/attention/arousal/actors/update'
+
+RSpec.describe Legion::Extensions::Agentic::Attention::Arousal::Actor::Update do
+  subject(:actor) { described_class.new }
+
+  describe '#runner_class' do
+    it 'points to the Arousal runner' do
+      expect(actor.runner_class).to eq Legion::Extensions::Agentic::Attention::Arousal::Runners::Arousal
+    end
+  end
+
+  describe '#runner_function' do
+    it 'is update_arousal' do
+      expect(actor.runner_function).to eq 'update_arousal'
+    end
+  end
+
+  describe '#time' do
+    it 'runs every 30 seconds' do
+      expect(actor.time).to eq 30
+    end
+  end
+
+  describe '#run_now?' do
+    it { expect(actor.run_now?).to be false }
+  end
+
+  describe '#use_runner?' do
+    it { expect(actor.use_runner?).to be false }
+  end
+
+  describe '#check_subtask?' do
+    it { expect(actor.check_subtask?).to be false }
+  end
+
+  describe '#generate_task?' do
+    it { expect(actor.generate_task?).to be false }
+  end
+end

data/spec/legion/extensions/agentic/attention/blink/actors/decay_spec.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require 'legion/extensions/agentic/attention/blink/actors/decay'
+
+RSpec.describe Legion::Extensions::Agentic::Attention::Blink::Actor::Decay do
+  subject(:actor) { described_class.new }
+
+  describe '#runner_class' do
+    it 'points to the AttentionalBlink runner' do
+      expect(actor.runner_class).to eq Legion::Extensions::Agentic::Attention::Blink::Runners::AttentionalBlink
+    end
+  end
+
+  describe '#runner_function' do
+    it 'is decay_blink' do
+      expect(actor.runner_function).to eq 'decay_blink'
+    end
+  end
+
+  describe '#time' do
+    it 'runs every 15 seconds' do
+      expect(actor.time).to eq 15
+    end
+  end
+
+  describe '#run_now?' do
+    it { expect(actor.run_now?).to be false }
+  end
+
+  describe '#use_runner?' do
+    it { expect(actor.use_runner?).to be false }
+  end
+
+  describe '#check_subtask?' do
+    it { expect(actor.check_subtask?).to be false }
+  end
+
+  describe '#generate_task?' do
+    it { expect(actor.generate_task?).to be false }
+  end
+end

data/spec/legion/extensions/agentic/attention/blink/runners/attentional_blink_spec.rb

@@ -74,4 +74,27 @@ RSpec.describe Legion::Extensions::Agentic::Attention::Blink::Runners::Attention
       expect(result).to include(:total_stimuli, :total_blinks, :miss_rate)
     end
   end
+
+  describe '#decay_blink' do
+    it 'returns success true' do
+      result = runner.decay_blink
+      expect(result[:success]).to be true
+    end
+
+    it 'returns blink_active status' do
+      result = runner.decay_blink
+      expect(result).to have_key(:blink_active)
+    end
+
+    it 'returns recovery_level' do
+      result = runner.decay_blink
+      expect(result).to have_key(:recovery_level)
+    end
+
+    it 'reports recovery complete when no blink is active' do
+      result = runner.decay_blink
+      expect(result[:blink_active]).to be false
+      expect(result[:recovery_level]).to eq(1.0)
+    end
+  end
 end

data/spec/legion/extensions/agentic/attention/economy/client_spec.rb

@@ -13,18 +13,18 @@ RSpec.describe Legion::Extensions::Agentic::Attention::Economy::Client do
     expect(client).to respond_to(:prioritized_demands)
     expect(client).to respond_to(:best_roi_demands)
     expect(client).to respond_to(:rebalance_budget)
-    expect(client).to respond_to(:attention_status)
+    expect(client).to respond_to(:attention_economy_status)
     expect(client).to respond_to(:attention_snapshot)
   end
 
   it 'starts with empty demands' do
-    expect(client.attention_status[:demand_count]).to eq(0)
+    expect(client.attention_economy_status[:demand_count]).to eq(0)
   end
 
   it 'maintains isolated state per instance' do
     c1 = described_class.new
     c2 = described_class.new
     c1.add_demand(label: 'solo', demand_type: :task, priority: 0.5, cost: 0.1)
-    expect(c2.attention_status[:demand_count]).to eq(0)
+    expect(c2.attention_economy_status[:demand_count]).to eq(0)
   end
 end

data/spec/legion/extensions/agentic/attention/economy/runners/attention_economy_spec.rb

@@ -133,9 +133,9 @@ RSpec.describe Legion::Extensions::Agentic::Attention::Economy::Runners::Attenti
     end
   end
 
-  describe '#attention_status' do
+  describe '#attention_economy_status' do
     it 'returns budget report keys' do
-      result = client.attention_status
+      result = client.attention_economy_status
       %i[total_budget spent available utilization demand_count].each do |key|
         expect(result).to have_key(key)
       end
@@ -143,7 +143,7 @@ RSpec.describe Legion::Extensions::Agentic::Attention::Economy::Runners::Attenti
 
     it 'reflects demand count' do
       add_task
-      expect(client.attention_status[:demand_count]).to eq(1)
+      expect(client.attention_economy_status[:demand_count]).to eq(1)
     end
   end
 

data/spec/legion/extensions/agentic/attention/focus/runners/attention_spec.rb

@@ -26,35 +26,48 @@ RSpec.describe Legion::Extensions::Agentic::Attention::Focus::Runners::Attention
       expect(result[:filtered].size).to be >= 1
     end
 
-    it 'drops low-salience signals' do
-      signals = [{ salience: 0.01, domain: :heartbeat, novelty: 0.0 }]
+    it 'deduplicates identical signals' do
+      signals = [
+        { salience: 0.8, domain: :terraform, source_type: :event, value: 'deploy' },
+        { salience: 0.8, domain: :terraform, source_type: :event, value: 'deploy' }
+      ]
       result = client.filter_signals(signals: signals)
-      expect(result[:dropped]).to be >= 0
-      expect(result[:filtered].size).to be <= 1
+      expect(result[:spotlight] + result[:peripheral] + result[:background]).to be <= 1
     end
 
-    it 'boosts signals matching active wonders' do
-      signals = [{ salience: 0.3, domain: :terraform, novelty: 0.3 }]
-      wonders = [{ domain: :terraform, salience: 0.9 }]
+    it 'preserves identical requests from different principals and frames' do
+      request = { salience: 0.9, source_type: :human_direct, value: 'continue', channel_id: :cli }
+      signals = [
+        request.merge(principal_id: 'alice', frame_id: 'first'),
+        request.merge(principal_id: 'bob', frame_id: 'second'),
+        request.merge(principal_id: 'alice', frame_id: 'third')
+      ]
 
-      without = client.filter_signals(signals: signals)
-      # New client to avoid habituation carryover
-      fresh = Legion::Extensions::Agentic::Attention::Focus::Client.new
-      with_wonders = fresh.filter_signals(signals: signals, active_wonders: wonders)
+      result = client.filter_signals(signals: signals + [signals.first.dup])
 
-      # With wonder boost, the signal should score higher
-      with_total = with_wonders[:spotlight] + with_wonders[:peripheral]
-      without_total = without[:spotlight] + without[:peripheral]
-      expect(with_total).to be >= without_total
+      expect(result[:filtered].map { |signal| signal[:frame_id] }).to contain_exactly('first', 'second', 'third')
     end
 
-    it 'deduplicates identical signals' do
+    it 'keeps requests from separate channels distinct when no frame identity is available' do
+      request = { salience: 0.9, source_type: :human_direct, value: 'continue' }
+      result = client.filter_signals(signals: [request.merge(channel_id: :cli), request.merge(channel_id: :slack)])
+
+      expect(result[:filtered].map { |signal| signal[:channel_id] }).to contain_exactly(:cli, :slack)
+    end
+
+    it 'prioritizes signals within both retained tiers below the capacity limit' do
       signals = [
-        { salience: 0.8, domain: :terraform, source_type: :event, value: 'deploy' },
-        { salience: 0.8, domain: :terraform, source_type: :event, value: 'deploy' }
+        { value: 'spotlight-low', salience: 0.8, novelty: 0.8, domain: :deploy },
+        { value: 'spotlight-high', salience: 1.0, novelty: 1.0, domain: :incident },
+        { value: 'peripheral-low', salience: 0.7, novelty: 0.5, domain: :status },
+        { value: 'peripheral-high', salience: 0.9, novelty: 0.5, domain: :review }
       ]
-      result = client.filter_signals(signals: signals)
-      expect(result[:spotlight] + result[:peripheral] + result[:background]).to be <= 1
+      wonders = [{ domain: :deploy, salience: 1.0 }, { domain: :incident, salience: 1.0 }]
+
+      result = client.filter_signals(signals: signals, active_wonders: wonders)
+
+      expect(result[:filtered].map { |signal| signal[:value] })
+        .to eq(%w[spotlight-high spotlight-low peripheral-high peripheral-low])
     end
 
     it 'enforces attentional capacity' do
@@ -62,22 +75,6 @@ RSpec.describe Legion::Extensions::Agentic::Attention::Focus::Runners::Attention
       result = client.filter_signals(signals: signals)
       expect(result[:spotlight]).to be <= Legion::Extensions::Agentic::Attention::Focus::Helpers::Constants::ATTENTIONAL_CAPACITY
     end
-
-    it 'habituates repeated domain signals' do
-      first_client = Legion::Extensions::Agentic::Attention::Focus::Client.new
-      signals = [{ salience: 0.6, domain: :terraform, novelty: 0.3 }]
-
-      first_result = first_client.filter_signals(signals: signals)
-      # Record same domain multiple times to build habituation
-      10.times { first_client.filter_signals(signals: signals) }
-      later_result = first_client.filter_signals(signals: signals)
-
-      first_scores = first_result[:filtered].map { |s| s[:attention_score] || 0 }
-      later_scores = later_result[:filtered].map { |s| s[:attention_score] || 0 }
-
-      # Later scores should be lower due to habituation (if signal still passes)
-      expect(later_scores.max).to be <= first_scores.max if first_scores.any? && later_scores.any?
-    end
   end
 
   describe '#attention_status' do

data/spec/legion/extensions/agentic/attention/regulation/actors/update_spec.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require 'legion/extensions/agentic/attention/regulation/actors/update'
+
+RSpec.describe Legion::Extensions::Agentic::Attention::Regulation::Actor::Update do
+  subject(:actor) { described_class.new }
+
+  describe '#runner_class' do
+    it 'points to the AttentionRegulation runner' do
+      expect(actor.runner_class).to eq Legion::Extensions::Agentic::Attention::Regulation::Runners::AttentionRegulation
+    end
+  end
+
+  describe '#runner_function' do
+    it 'is update_attention' do
+      expect(actor.runner_function).to eq 'update_attention'
+    end
+  end
+
+  describe '#time' do
+    it 'runs every 60 seconds' do
+      expect(actor.time).to eq 60
+    end
+  end
+
+  describe '#run_now?' do
+    it { expect(actor.run_now?).to be false }
+  end
+
+  describe '#use_runner?' do
+    it { expect(actor.use_runner?).to be false }
+  end
+
+  describe '#check_subtask?' do
+    it { expect(actor.check_subtask?).to be false }
+  end
+
+  describe '#generate_task?' do
+    it { expect(actor.generate_task?).to be false }
+  end
+end

data/spec/legion/extensions/agentic/attention/salience/actors/compute_spec.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require 'legion/extensions/agentic/attention/salience/actors/compute'
+
+RSpec.describe Legion::Extensions::Agentic::Attention::Salience::Actor::Compute do
+  subject(:actor) { described_class.new }
+
+  describe '#runner_class' do
+    it 'points to the Salience runner' do
+      expect(actor.runner_class).to eq Legion::Extensions::Agentic::Attention::Salience::Runners::Salience
+    end
+  end
+
+  describe '#runner_function' do
+    it 'is compute_salience' do
+      expect(actor.runner_function).to eq 'compute_salience'
+    end
+  end
+
+  describe '#time' do
+    it 'runs every 12 seconds' do
+      expect(actor.time).to eq 12
+    end
+  end
+
+  describe '#run_now?' do
+    it { expect(actor.run_now?).to be false }
+  end
+
+  describe '#use_runner?' do
+    it { expect(actor.use_runner?).to be false }
+  end
+
+  describe '#check_subtask?' do
+    it { expect(actor.check_subtask?).to be false }
+  end
+
+  describe '#generate_task?' do
+    it { expect(actor.generate_task?).to be false }
+  end
+end

data/spec/legion/extensions/agentic/attention/signal_detection/actors/update_spec.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require 'legion/extensions/agentic/attention/signal_detection/actors/update'
+
+RSpec.describe Legion::Extensions::Agentic::Attention::SignalDetection::Actor::Update do
+  subject(:actor) { described_class.new }
+
+  describe '#runner_class' do
+    it 'points to the SignalDetection runner' do
+      expect(actor.runner_class).to eq Legion::Extensions::Agentic::Attention::SignalDetection::Runners::SignalDetection
+    end
+  end
+
+  describe '#runner_function' do
+    it 'is update_signal_detection' do
+      expect(actor.runner_function).to eq 'update_signal_detection'
+    end
+  end
+
+  describe '#time' do
+    it 'runs every 60 seconds' do
+      expect(actor.time).to eq 60
+    end
+  end
+
+  describe '#run_now?' do
+    it { expect(actor.run_now?).to be false }
+  end
+
+  describe '#use_runner?' do
+    it { expect(actor.use_runner?).to be false }
+  end
+
+  describe '#check_subtask?' do
+    it { expect(actor.check_subtask?).to be false }
+  end
+
+  describe '#generate_task?' do
+    it { expect(actor.generate_task?).to be false }
+  end
+end

data/spec/legion/extensions/agentic/attention/spotlight/client_spec.rb

@@ -12,7 +12,7 @@ RSpec.describe Legion::Extensions::Agentic::Attention::Spotlight::Client do
     expect(client).to respond_to(:scan_targets)
     expect(client).to respond_to(:check_peripheral)
     expect(client).to respond_to(:check_capture)
-    expect(client).to respond_to(:release_focus)
+    expect(client).to respond_to(:release_spotlight)
     expect(client).to respond_to(:spotlight_report)
     expect(client).to respond_to(:most_salient)
     expect(client).to respond_to(:spotlight_state)

data/spec/legion/extensions/agentic/attention/spotlight/runners/attention_spotlight_spec.rb

@@ -163,19 +163,19 @@ RSpec.describe Legion::Extensions::Agentic::Attention::Spotlight::Runners::Atten
     end
   end
 
-  describe '#release_focus' do
+  describe '#release_spotlight' do
     it 'returns success true' do
-      expect(client.release_focus[:success]).to be true
+      expect(client.release_spotlight[:success]).to be true
     end
 
     it 'returns released true' do
-      expect(client.release_focus[:released]).to be true
+      expect(client.release_spotlight[:released]).to be true
     end
 
     it 'sets mode back to idle' do
       id = reg[:target_id]
       client.focus_spotlight(target_id: id)
-      client.release_focus
+      client.release_spotlight
       expect(client.spotlight_state[:spotlight][:mode]).to eq(:idle)
     end
   end

data/spec/spec_helper.rb

@@ -35,6 +35,10 @@ module Legion
   end
 end
 
+# Prevent actor files that `require 'legion/extensions/actors/every'` from re-loading
+# the real gem file; the stub class above is already defined and sufficient for specs.
+$LOADED_FEATURES << 'legion/extensions/actors/every' unless $LOADED_FEATURES.include?('legion/extensions/actors/every')
+
 require 'legion/extensions/agentic/attention'
 
 RSpec.configure do |config|

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-agentic-attention
 version: !ruby/object:Gem::Version
-  version: 0.1.6
+  version: 0.1.8
 platform: ruby
 authors:
 - Esity
@@ -163,6 +163,7 @@ files:
 - lex-agentic-attention.gemspec
 - lib/legion/extensions/agentic/attention.rb
 - lib/legion/extensions/agentic/attention/arousal.rb
+- lib/legion/extensions/agentic/attention/arousal/actors/update.rb
 - lib/legion/extensions/agentic/attention/arousal/client.rb
 - lib/legion/extensions/agentic/attention/arousal/helpers/arousal_model.rb
 - lib/legion/extensions/agentic/attention/arousal/helpers/constants.rb
@@ -177,6 +178,7 @@ files:
 - lib/legion/extensions/agentic/attention/blindspot/runners/cognitive_blindspot.rb
 - lib/legion/extensions/agentic/attention/blindspot/version.rb
 - lib/legion/extensions/agentic/attention/blink.rb
+- lib/legion/extensions/agentic/attention/blink/actors/decay.rb
 - lib/legion/extensions/agentic/attention/blink/client.rb
 - lib/legion/extensions/agentic/attention/blink/helpers/blink_engine.rb
 - lib/legion/extensions/agentic/attention/blink/helpers/constants.rb
@@ -254,6 +256,7 @@ files:
 - lib/legion/extensions/agentic/attention/prism/runners/cognitive_prism.rb
 - lib/legion/extensions/agentic/attention/prism/version.rb
 - lib/legion/extensions/agentic/attention/regulation.rb
+- lib/legion/extensions/agentic/attention/regulation/actors/update.rb
 - lib/legion/extensions/agentic/attention/regulation/client.rb
 - lib/legion/extensions/agentic/attention/regulation/helpers/attention_controller.rb
 - lib/legion/extensions/agentic/attention/regulation/helpers/attention_target.rb
@@ -268,6 +271,7 @@ files:
 - lib/legion/extensions/agentic/attention/relevance_theory/runners/relevance_theory.rb
 - lib/legion/extensions/agentic/attention/relevance_theory/version.rb
 - lib/legion/extensions/agentic/attention/salience.rb
+- lib/legion/extensions/agentic/attention/salience/actors/compute.rb
 - lib/legion/extensions/agentic/attention/salience/client.rb
 - lib/legion/extensions/agentic/attention/salience/helpers/constants.rb
 - lib/legion/extensions/agentic/attention/salience/helpers/salience_map.rb
@@ -290,6 +294,7 @@ files:
 - lib/legion/extensions/agentic/attention/sensory_gating/runners/sensory_gating.rb
 - lib/legion/extensions/agentic/attention/sensory_gating/version.rb
 - lib/legion/extensions/agentic/attention/signal_detection.rb
+- lib/legion/extensions/agentic/attention/signal_detection/actors/update.rb
 - lib/legion/extensions/agentic/attention/signal_detection/client.rb
 - lib/legion/extensions/agentic/attention/signal_detection/helpers/constants.rb
 - lib/legion/extensions/agentic/attention/signal_detection/helpers/detection_engine.rb
@@ -345,6 +350,7 @@ files:
 - lib/legion/extensions/agentic/attention/telescope/runners/cognitive_telescope.rb
 - lib/legion/extensions/agentic/attention/telescope/version.rb
 - lib/legion/extensions/agentic/attention/version.rb
+- spec/legion/extensions/agentic/attention/arousal/actors/update_spec.rb
 - spec/legion/extensions/agentic/attention/arousal/client_spec.rb
 - spec/legion/extensions/agentic/attention/arousal/helpers/arousal_model_spec.rb
 - spec/legion/extensions/agentic/attention/arousal/helpers/constants_spec.rb
@@ -355,6 +361,7 @@ files:
 - spec/legion/extensions/agentic/attention/blindspot/helpers/constants_spec.rb
 - spec/legion/extensions/agentic/attention/blindspot/helpers/knowledge_boundary_spec.rb
 - spec/legion/extensions/agentic/attention/blindspot/runners/cognitive_blindspot_spec.rb
+- spec/legion/extensions/agentic/attention/blink/actors/decay_spec.rb
 - spec/legion/extensions/agentic/attention/blink/client_spec.rb
 - spec/legion/extensions/agentic/attention/blink/helpers/blink_engine_spec.rb
 - spec/legion/extensions/agentic/attention/blink/helpers/constants_spec.rb
@@ -409,6 +416,7 @@ files:
 - spec/legion/extensions/agentic/attention/prism/helpers/prism_engine_spec.rb
 - spec/legion/extensions/agentic/attention/prism/helpers/spectral_component_spec.rb
 - spec/legion/extensions/agentic/attention/prism/runners/cognitive_prism_spec.rb
+- spec/legion/extensions/agentic/attention/regulation/actors/update_spec.rb
 - spec/legion/extensions/agentic/attention/regulation/client_spec.rb
 - spec/legion/extensions/agentic/attention/regulation/helpers/attention_controller_spec.rb
 - spec/legion/extensions/agentic/attention/regulation/helpers/attention_target_spec.rb
@@ -417,6 +425,7 @@ files:
 - spec/legion/extensions/agentic/attention/relevance_theory/helpers/relevance_engine_spec.rb
 - spec/legion/extensions/agentic/attention/relevance_theory/relevance_theory_spec.rb
 - spec/legion/extensions/agentic/attention/relevance_theory/runners/relevance_theory_spec.rb
+- spec/legion/extensions/agentic/attention/salience/actors/compute_spec.rb
 - spec/legion/extensions/agentic/attention/salience/client_spec.rb
 - spec/legion/extensions/agentic/attention/salience/helpers/constants_spec.rb
 - spec/legion/extensions/agentic/attention/salience/helpers/salience_map_spec.rb
@@ -429,6 +438,7 @@ files:
 - spec/legion/extensions/agentic/attention/sensory_gating/helpers/gating_engine_spec.rb
 - spec/legion/extensions/agentic/attention/sensory_gating/helpers/sensory_filter_spec.rb
 - spec/legion/extensions/agentic/attention/sensory_gating/runners/sensory_gating_spec.rb
+- spec/legion/extensions/agentic/attention/signal_detection/actors/update_spec.rb
 - spec/legion/extensions/agentic/attention/signal_detection/client_spec.rb
 - spec/legion/extensions/agentic/attention/signal_detection/helpers/constants_spec.rb
 - spec/legion/extensions/agentic/attention/signal_detection/helpers/detection_engine_spec.rb