lex-agentic-self 0.1.8 → 0.1.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0c660e26600da2bf1c6e0ec3ff8c8d81a1eabebc3859d3de838e30f22b4ba91d
-  data.tar.gz: ec3d26a5dd95ad077de1880fd60f48d23ff0a34aa841f82cda7bcbfdad99e5d0
+  metadata.gz: 478de6acedf6c72ba3a5c715bc57f3124505486720b473b2db536d4abe48c58c
+  data.tar.gz: 8846a168b7d882d7e981a3d87eb87565e25b10ac24530221748382fdda1128cb
 SHA512:
-  metadata.gz: ffbe4a9cee92f015c0d167fa98327aceb9641c8dd448d99f0649ff42e87eb531b51eec961729f615e274c2854422cdb0b3e2cc77d02f456b9ceeb944a6088ebb
-  data.tar.gz: f418467e5090f41939297b8907288f4ef29b95fbc9def510bbc1efb503abd79cdf8a3420b7ec2ce707d5d29d06e0569531da88395658a3901b80a8d7356b53b9
+  metadata.gz: 20df44e864e415b127e1f26a0d28bb0ed19c6589b53a40afbace9587c1166be962b6b8305e74c7ad4d4ea6b41eb9091f90328cbc3e23c3ab44ab9172cced706f
+  data.tar.gz: c768c0cc1794a6502e37d2c6524feaec104c8d47116e654f7d5dd19330768130212516cc074011b97b4e8e97f21c33931242e4cebf9ce0fba92064919bf7396d

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.1.9] - 2026-03-31
+
+### Added
+- add `PARTNER_SIGNAL_MAP` and `PARTNER_SIGNAL_THRESHOLD` constants to Personality::Helpers::Constants for partner-specific OCEAN nudges (weight 0.2 per signal)
+- add `TraitModel#apply_partner_signals` to nudge extraversion, agreeableness, openness, and conscientiousness from partner engagement patterns; signals below threshold (0.3) are ignored
+- wire partner signal extraction into `PersonalityStore#update` via `tick_results[:social]` reputation data (engagement frequency, direct address ratio, content diversity, consistency)
+- add 16 specs covering PARTNER_SIGNAL_MAP entries, threshold gating, multi-signal application, and no observation_count side-effect
+
 ## [0.1.8] - 2026-03-30
 
 ### Fixed

data/lib/legion/extensions/agentic/self/personality/helpers/constants.rb

@@ -70,6 +70,20 @@ module Legion
                 mood_stability:        [:neuroticism, :negative, 0.3]
               }.freeze
 
+              # Partner-specific signal map: partner interaction patterns that slowly nudge OCEAN traits.
+              # Lower weight (0.2) than general signals — personality should drift very slowly from
+              # partner engagement alone.
+              # Each entry: [trait, direction, weight]
+              PARTNER_SIGNAL_MAP = {
+                partner_engagement_frequency: [:extraversion, :positive, 0.2],
+                partner_direct_address_ratio: [:agreeableness, :positive, 0.2],
+                partner_content_diversity:    [:openness, :positive, 0.2],
+                partner_consistency:          [:conscientiousness, :positive, 0.2]
+              }.freeze
+
+              # Minimum signal value required to apply a partner nudge (0.0–1.0)
+              PARTNER_SIGNAL_THRESHOLD = 0.3
+
               # Threshold for "high" trait descriptor
               HIGH_THRESHOLD = 0.65
 

data/lib/legion/extensions/agentic/self/personality/helpers/personality_store.rb

@@ -16,6 +16,8 @@ module Legion
               def update(tick_results)
                 signals = extract_signals(tick_results)
                 @model.update(signals)
+                partner_signals = extract_partner_signals(tick_results)
+                @model.apply_partner_signals(partner_signals) unless partner_signals.empty?
               end
 
               def full_description
@@ -41,6 +43,42 @@ module Legion
 
               private
 
+              def extract_partner_signals(tick_results)
+                counts = partner_records(tick_results)
+                return {} if counts.empty?
+
+                {
+                  partner_engagement_frequency: partner_engagement_frequency(counts),
+                  partner_direct_address_ratio: avg_partner_field(counts, :direct_address_ratio),
+                  partner_content_diversity:    avg_partner_diversity(counts),
+                  partner_consistency:          avg_partner_field(counts, :consistency)
+                }.compact
+              end
+
+              def partner_records(tick_results)
+                social = tick_results[:social] || tick_results[:social_cognition] || {}
+                return [] unless social.is_a?(Hash)
+
+                reputation = social[:reputation_updates] || social[:partners] || {}
+                return [] unless reputation.is_a?(Hash) && reputation.any?
+
+                reputation.values.grep(Hash)
+              end
+
+              def partner_engagement_frequency(counts)
+                (counts.count { |p| p[:message_count].to_i.positive? } / counts.size.to_f).clamp(0.0, 1.0)
+              end
+
+              def avg_partner_field(counts, key)
+                vals = counts.filter_map { |p| p[key] }.grep(Numeric)
+                vals.any? ? (vals.sum / vals.size.to_f).clamp(0.0, 1.0) : nil
+              end
+
+              def avg_partner_diversity(counts)
+                vals = counts.filter_map { |p| p[:topic_diversity] || p[:content_diversity] }.grep(Numeric)
+                vals.any? ? (vals.sum / vals.size.to_f).clamp(0.0, 1.0) : nil
+              end
+
               def extract_signals(tick_results)
                 signals = {}
 

data/lib/legion/extensions/agentic/self/personality/helpers/trait_model.rb

@@ -30,6 +30,14 @@ module Legion
                 @traits[name.to_sym]
               end
 
+              def apply_partner_signals(signals)
+                observations = extract_partner_observations(signals)
+                return if observations.empty?
+
+                apply_observations(observations)
+                record_snapshot
+              end
+
               def formed?
                 @observation_count >= Constants::FORMATION_THRESHOLD
               end
@@ -105,6 +113,21 @@ module Legion
 
               private
 
+              def extract_partner_observations(signals)
+                observations = Hash.new { |h, k| h[k] = [] }
+
+                Constants::PARTNER_SIGNAL_MAP.each do |signal_key, (trait, direction, weight)|
+                  value = signals[signal_key]
+                  next unless value.is_a?(Numeric)
+                  next if value <= Constants::PARTNER_SIGNAL_THRESHOLD
+
+                  effective = direction == :positive ? value : 1.0 - value
+                  observations[trait] << { value: effective, weight: weight }
+                end
+
+                observations
+              end
+
               def extract_observations(signals)
                 observations = Hash.new { |h, k| h[k] = [] }
 

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

@@ -4,7 +4,7 @@ module Legion
   module Extensions
     module Agentic
       module Self
-        VERSION = '0.1.8'
+        VERSION = '0.1.9'
       end
     end
   end

data/spec/legion/extensions/agentic/self/personality/helpers/partner_signals_spec.rb

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+
+RSpec.describe Legion::Extensions::Agentic::Self::Personality::Helpers::TraitModel do
+  subject(:model) { described_class.new }
+
+  let(:constants) { Legion::Extensions::Agentic::Self::Personality::Helpers::Constants }
+
+  describe 'PARTNER_SIGNAL_MAP constant' do
+    it 'defines partner_engagement_frequency nudging extraversion positively' do
+      entry = constants::PARTNER_SIGNAL_MAP[:partner_engagement_frequency]
+      expect(entry).to eq([:extraversion, :positive, 0.2])
+    end
+
+    it 'defines partner_direct_address_ratio nudging agreeableness positively' do
+      entry = constants::PARTNER_SIGNAL_MAP[:partner_direct_address_ratio]
+      expect(entry).to eq([:agreeableness, :positive, 0.2])
+    end
+
+    it 'defines partner_content_diversity nudging openness positively' do
+      entry = constants::PARTNER_SIGNAL_MAP[:partner_content_diversity]
+      expect(entry).to eq([:openness, :positive, 0.2])
+    end
+
+    it 'defines partner_consistency nudging conscientiousness positively' do
+      entry = constants::PARTNER_SIGNAL_MAP[:partner_consistency]
+      expect(entry).to eq([:conscientiousness, :positive, 0.2])
+    end
+
+    it 'has all entries with weights of 0.2' do
+      constants::PARTNER_SIGNAL_MAP.each_value do |_trait, _direction, weight|
+        expect(weight).to eq(0.2)
+      end
+    end
+
+    it 'references only valid OCEAN traits' do
+      constants::PARTNER_SIGNAL_MAP.each_value do |trait, _direction, _weight|
+        expect(constants::TRAITS).to include(trait)
+      end
+    end
+  end
+
+  describe '#apply_partner_signals' do
+    it 'nudges extraversion upward when partner_engagement_frequency is high' do
+      baseline = model.trait(:extraversion)
+      model.apply_partner_signals(partner_engagement_frequency: 0.9)
+      expect(model.trait(:extraversion)).to be > baseline
+    end
+
+    it 'nudges agreeableness upward when partner_direct_address_ratio is high' do
+      baseline = model.trait(:agreeableness)
+      model.apply_partner_signals(partner_direct_address_ratio: 0.8)
+      expect(model.trait(:agreeableness)).to be > baseline
+    end
+
+    it 'nudges openness upward when partner_content_diversity is high' do
+      baseline = model.trait(:openness)
+      model.apply_partner_signals(partner_content_diversity: 0.8)
+      expect(model.trait(:openness)).to be > baseline
+    end
+
+    it 'nudges conscientiousness upward when partner_consistency is high' do
+      baseline = model.trait(:conscientiousness)
+      model.apply_partner_signals(partner_consistency: 0.8)
+      expect(model.trait(:conscientiousness)).to be > baseline
+    end
+
+    it 'ignores signals below the minimum threshold' do
+      baseline = model.trait(:extraversion)
+      model.apply_partner_signals(partner_engagement_frequency: 0.1)
+      expect(model.trait(:extraversion)).to eq(baseline)
+    end
+
+    it 'ignores signals exactly at the threshold boundary' do
+      baseline = model.trait(:extraversion)
+      model.apply_partner_signals(partner_engagement_frequency: 0.3)
+      expect(model.trait(:extraversion)).to eq(baseline)
+    end
+
+    it 'applies multiple signals in a single call' do
+      extraversion_before = model.trait(:extraversion)
+      agreeableness_before = model.trait(:agreeableness)
+
+      model.apply_partner_signals(
+        partner_engagement_frequency: 0.9,
+        partner_direct_address_ratio: 0.8
+      )
+
+      expect(model.trait(:extraversion)).to be > extraversion_before
+      expect(model.trait(:agreeableness)).to be > agreeableness_before
+    end
+
+    it 'ignores unrecognized signal keys' do
+      expect { model.apply_partner_signals(unknown_signal: 0.9) }.not_to raise_error
+    end
+
+    it 'does not change observation_count' do
+      model.apply_partner_signals(partner_engagement_frequency: 0.9)
+      expect(model.observation_count).to eq(0)
+    end
+
+    it 'records a history snapshot after applying signals' do
+      model.apply_partner_signals(partner_engagement_frequency: 0.9)
+      expect(model.history.size).to eq(1)
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: lex-agentic-self
 version: !ruby/object:Gem::Version
-  version: 0.1.8
+  version: 0.1.9
 platform: ruby
 authors:
 - Esity
@@ -406,6 +406,7 @@ files:
 - spec/legion/extensions/agentic/self/narrative_self/runners/narrative_self_spec.rb
 - spec/legion/extensions/agentic/self/personality/client_spec.rb
 - spec/legion/extensions/agentic/self/personality/helpers/constants_spec.rb
+- spec/legion/extensions/agentic/self/personality/helpers/partner_signals_spec.rb
 - spec/legion/extensions/agentic/self/personality/helpers/personality_store_spec.rb
 - spec/legion/extensions/agentic/self/personality/helpers/trait_model_spec.rb
 - spec/legion/extensions/agentic/self/personality/runners/personality_spec.rb