lex-agentic-affect 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d03176e4d632c5182d79f6c122b06ee6492b7a330ea28f26de0bdf2b38464d3c
-  data.tar.gz: 036f318f959c28fd2e4ab3d33b439ac81742b52b406702a56667ad2a78c35f3b
+  metadata.gz: 64e47fe3d5e4b6c59bb58ed12d8acf1c1888e1668e4fe164a69461911050afff
+  data.tar.gz: 5d95cdf190ff874aaa8c46e184e079d73849b76891ec0138ef54fd40ac912b75
 SHA512:
-  metadata.gz: 923827c5b0fae5871187437b4e0ffc7672ff52214ff0261c857c240128c4d1bd5a6dbbbe14b50e3caf22db645cd76e71c7ff490dbb348fd8ab5ed55dac6b4230
-  data.tar.gz: e27fe89064ed41221e4879b841830058d759158eda0e7f396cf7acd22252c6c60d5b739ebc7956e3691713c6aaf8f08de0d556a15eadb5eddc1b3340f9f211df
+  metadata.gz: 8ec5b239a2ed5f20ebfa28c0c5e9c2e19032b2a474aa1fe3d4583e1c34092fcbee3673df7433460b5fdf67f1b562c7f253f261219ada523a0f349eb58941cc70
+  data.tar.gz: df01ac0b9ea74775059fde392e081f0b97a793a95d76b0011930d428b78f667482c3a77a97cf7c276a3c1dd6684e45419fb66b33c6ff4c435c70c1d6a43461f5

data/CHANGELOG.md

@@ -1,6 +1,10 @@
 # Changelog
 
-## [Unreleased]
+## [0.1.1] - 2026-03-18
+
+### Fixed
+- Validate `channel` against `VITAL_CHANNELS` in `Interoception::BodyBudget#report_vital` — rejects unknown channel keys
+- Validate `coping_type` against `COPING_TYPES` in `Appraisal::AppraisalEngine#add_coping_strategy` — rejects invalid coping types
 
 ## [0.1.0] - 2026-03-18
 

data/README.md

@@ -1,13 +1,56 @@
 # lex-agentic-affect
 
-LEX agentic affect domain: emotions, valence, mood regulation
+Domain consolidation gem for emotion, affect, and motivational processing. Bundles 17 source extensions into one loadable unit under `Legion::Extensions::Agentic::Affect`.
 
-## Sub-modules
+## Overview
 
-*(populated as extensions are consolidated)*
+**Gem**: `lex-agentic-affect`
+**Version**: 0.1.1
+**Namespace**: `Legion::Extensions::Agentic::Affect`
+
+## Sub-Modules
+
+| Sub-Module | Source Gem | Purpose |
+|---|---|---|
+| `Affect::Emotion` | `lex-emotion` | Four-dimensional emotional valence/arousal, EMA momentum, gut instinct |
+| `Affect::Mood` | `lex-mood` | Background mood baseline distinct from discrete emotions |
+| `Affect::Appraisal` | `lex-appraisal` | Lazarus appraisal theory — primary/secondary appraisal of events |
+| `Affect::CognitiveEmpathy` | `lex-cognitive-empathy` | Cognitive empathy processing |
+| `Affect::Empathy` | `lex-empathy` | Affective and cognitive empathy |
+| `Affect::Reappraisal` | `lex-cognitive-reappraisal` | Gross process model — six emotion regulation strategies |
+| `Affect::Regulation` | `lex-emotional-regulation` | Regulation strategy selection and effectiveness tracking |
+| `Affect::Defusion` | `lex-cognitive-defusion` | ACT-style cognitive defusion from difficult thoughts |
+| `Affect::Contagion` | `lex-cognitive-contagion` | Emotional contagion spread across agent interactions |
+| `Affect::SomaticMarker` | `lex-somatic-marker` | Damasio somatic marker hypothesis — gut-feeling tagging |
+| `Affect::Interoception` | `lex-interoception` | Internal body state signals (fatigue, tension, arousal) |
+| `Affect::Flow` | `lex-flow` | Csikszentmihalyi flow state |
+| `Affect::Fatigue` | `lex-fatigue` | Mental fatigue accumulation and recovery modeling |
+| `Affect::Motivation` | `lex-motivation` | Drive states — homeostatic and intrinsic motivation |
+| `Affect::Reward` | `lex-reward` | Reward signal computation and prediction error |
+| `Affect::Resilience` | `lex-resilience` | Recovery capacity and stress inoculation |
+| `Affect::Resonance` | `lex-cognitive-resonance` | Affective resonance patterns |
+
+## Actors
+
+- `Affect::Emotion::Actors::MomentumDecay` — runs every 60s, decays emotional momentum via `decay_momentum`
+- `Affect::Interoception::Actors::Decay` — interval actor, decays interoceptive body state signals
+- `Affect::Reappraisal::Actors::AutoRegulate` — runs every 300s, processes pending emotional events
+- `Affect::SomaticMarker::Actors::Decay` — interval actor, decays somatic marker strength
 
 ## Installation
 
 ```ruby
 gem 'lex-agentic-affect'
 ```
+
+## Development
+
+```bash
+bundle install
+bundle exec rspec        # 1523 examples, 0 failures
+bundle exec rubocop      # 0 offenses
+```
+
+## License
+
+MIT

data/lib/legion/extensions/agentic/affect/appraisal/helpers/appraisal_engine.rb

@@ -43,6 +43,7 @@ module Legion
               end
 
               def add_coping_strategy(name:, coping_type:, effectiveness:)
+                return false unless COPING_TYPES.include?(coping_type)
                 return false if @coping_strategies.size >= MAX_COPING_STRATEGIES
 
                 @coping_strategies[name] = {

data/lib/legion/extensions/agentic/affect/appraisal/version.rb

@@ -5,7 +5,7 @@ module Legion
     module Agentic
       module Affect
         module Appraisal
-          VERSION = '0.1.0'
+          VERSION = '0.1.1'
         end
       end
     end

data/lib/legion/extensions/agentic/affect/emotion/runners/valence.rb

@@ -72,6 +72,18 @@ module Legion
                 { arousal: arousal }
               end
 
+              def raise_urgency_for_knowledge_vulnerability(domains_at_risk:, severity: :warning, urgency_boost: 0.3, **)
+                boost = severity.to_sym == :critical ? [urgency_boost * 1.5, 1.0].min : urgency_boost.to_f
+                signal = { urgency_hint: boost, domain_weight: 0.6, impact_scope: 0.5,
+                           outcome_severity: boost, novelty_score: 0.3 }
+                result = evaluate_valence(signal: signal, source_type: :mesh_priority)
+
+                Legion::Logging.info "[emotion] knowledge_vulnerability urgency raised: domains=#{Array(domains_at_risk).join(',')} " \
+                                     "severity=#{severity} boost=#{boost.round(2)} urgency=#{result[:valence][:urgency].round(2)}"
+
+                result.merge(event: :knowledge_vulnerability, domains_at_risk: Array(domains_at_risk), urgency_boost: boost)
+              end
+
               private
 
               def emotion_baseline

data/lib/legion/extensions/agentic/affect/interoception/helpers/body_budget.rb

@@ -22,6 +22,8 @@ module Legion
 
               def report_vital(channel:, value:)
                 channel = channel.to_sym
+                return nil unless VITAL_CHANNELS.include?(channel)
+
                 normalized = value.clamp(0.0, 1.0)
                 @baselines[channel] ||= DEFAULT_BASELINE
                 @vitals[channel] = if @vitals.key?(channel)

data/lib/legion/extensions/agentic/affect/interoception/runners/interoception.rb

@@ -12,6 +12,8 @@ module Legion
 
               def report_vital(channel:, value:, **)
                 smoothed = body_budget.report_vital(channel: channel, value: value.to_f)
+                return { success: false, error: :invalid_channel, valid_channels: Helpers::Constants::VITAL_CHANNELS } unless smoothed
+
                 deviation = body_budget.deviation_for(channel)
                 Legion::Logging.debug "[interoception] vital: channel=#{channel} raw=#{value} " \
                                       "smoothed=#{smoothed.round(3)} deviation=#{deviation.round(3)}"

data/lib/legion/extensions/agentic/affect/interoception/version.rb

@@ -5,7 +5,7 @@ module Legion
     module Agentic
       module Affect
         module Interoception
-          VERSION = '0.1.0'
+          VERSION = '0.1.1'
         end
       end
     end

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

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

data/spec/legion/extensions/agentic/affect/appraisal/helpers/appraisal_engine_spec.rb

@@ -73,6 +73,19 @@ RSpec.describe Legion::Extensions::Agentic::Affect::Appraisal::Helpers::Appraisa
       # Strategy stored (engine is internal, test via evaluate_coping behavior)
       expect(data).to be_a(Hash)
     end
+
+    it 'rejects invalid coping_type' do
+      result = engine.add_coping_strategy(name: 'wishful', coping_type: :wishful_thinking, effectiveness: 0.5)
+      expect(result).to be(false)
+    end
+
+    it 'accepts all valid COPING_TYPES' do
+      constants = Legion::Extensions::Agentic::Affect::Appraisal::Helpers::Constants
+      constants::COPING_TYPES.each_with_index do |ct, i|
+        result = engine.add_coping_strategy(name: "strategy_#{i}", coping_type: ct, effectiveness: 0.5)
+        expect(result).to be(true)
+      end
+    end
   end
 
   describe '#evaluate_coping' do

data/spec/legion/extensions/agentic/affect/emotion/runners/valence_spec.rb

@@ -64,4 +64,39 @@ RSpec.describe Legion::Extensions::Agentic::Affect::Emotion::Runners::Valence do
       expect(result[:arousal]).to be > 0.0
     end
   end
+
+  describe '#raise_urgency_for_knowledge_vulnerability' do
+    it 'returns a valence result with event tag' do
+      result = client.raise_urgency_for_knowledge_vulnerability(domains_at_risk: %w[pki vault])
+      expect(result[:event]).to eq(:knowledge_vulnerability)
+      expect(result[:domains_at_risk]).to eq(%w[pki vault])
+    end
+
+    it 'includes urgency_boost in the result' do
+      result = client.raise_urgency_for_knowledge_vulnerability(domains_at_risk: ['pki'])
+      expect(result[:urgency_boost]).to be > 0.0
+    end
+
+    it 'raises urgency higher for critical severity than warning' do
+      warning = client.raise_urgency_for_knowledge_vulnerability(
+        domains_at_risk: ['pki'], severity: :warning
+      )
+      critical = client.raise_urgency_for_knowledge_vulnerability(
+        domains_at_risk: ['pki'], severity: :critical
+      )
+      expect(critical[:urgency_boost]).to be > warning[:urgency_boost]
+    end
+
+    it 'returns a valence hash with all four dimensions' do
+      result = client.raise_urgency_for_knowledge_vulnerability(domains_at_risk: ['dns'])
+      expect(result[:valence].keys).to contain_exactly(:urgency, :importance, :novelty, :familiarity)
+    end
+
+    it 'accepts a custom urgency_boost' do
+      result = client.raise_urgency_for_knowledge_vulnerability(
+        domains_at_risk: ['ssh'], urgency_boost: 0.5
+      )
+      expect(result[:urgency_boost]).to be_within(0.01).of(0.5)
+    end
+  end
 end

data/spec/legion/extensions/agentic/affect/interoception/helpers/body_budget_spec.rb

@@ -26,6 +26,18 @@ RSpec.describe Legion::Extensions::Agentic::Affect::Interoception::Helpers::Body
       10.times { budget.report_vital(channel: :cpu_load, value: 0.9) }
       expect(budget.baselines[:cpu_load]).to be > 0.5
     end
+
+    it 'rejects invalid channels' do
+      expect(budget.report_vital(channel: :bogus_channel, value: 0.5)).to be_nil
+      expect(budget.channel_count).to eq(0)
+    end
+
+    it 'accepts all valid VITAL_CHANNELS' do
+      constants = Legion::Extensions::Agentic::Affect::Interoception::Helpers::Constants
+      constants::VITAL_CHANNELS.each do |ch|
+        expect(budget.report_vital(channel: ch, value: 0.5)).to be_a(Float)
+      end
+    end
   end
 
   describe '#deviation_for' do

metadata

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